Commit Graph

77 Commits

Author SHA1 Message Date
Bernt 05ed037fe8 pilot.landvex.com: HTTPS + Full Stack Verified
- DNS: pilot.landvex.com -> 16.170.83.169
- TLS: Let's Encrypt certificate (expires 2026-09-30)
- Nginx: reverse proxy with SSL termination
- API: https://pilot.landvex.com/api/v1/missions
- UI: https://pilot.landvex.com/
- Upload: POST /api/v1/missions/import (multipart/form-data)

Verified:
 https://pilot.landvex.com/health
 https://pilot.landvex.com/version
 https://pilot.landvex.com/api/v1/missions (list)
 https://pilot.landvex.com/api/v1/missions/:id (get)
 POST /api/v1/missions/import (video upload)
 UI loads with title 'LandveX Intelligence Lab'

Next: Pilot 001 — Break the system!
2026-07-02 17:34:19 +00:00
Bernt bfc2c937b3 pilot.landvex.com: Configure for public access
- DNS: pilot.landvex.com -> 16.170.83.169
- Nginx: reverse proxy to API (3002) and UI (3003)
- Vite: allow pilot.landvex.com host
- Proxy: /api, /version, /health to API

Verified:
- http://pilot.landvex.com/health -> OK
- http://pilot.landvex.com/version -> version info
- http://pilot.landvex.com/ -> UI loads

Next: TLS/HTTPS with Let's Encrypt
2026-07-02 17:28:29 +00:00
Bernt e3db0d2367 Memory: Update 2026-07-02 with complete session log
- Engineering Standard v1.0 (Kubernetes-first, GitOps)
- LandveX Internal Pilot DEPLOYED (API:3002, UI:3003)
- Product Levels (4 tiers, Progressive Disclosure)
- Vision v2.0 (Living Operational Model, 5 levels)
- Spatial Intelligence (3 dimensions, 4 precision steps)
- OR-001 Operational Readiness (factory mindset)
- 14 commits total
- Sprint 0 goal defined

Next: Pilot 001 — Break the system!
2026-07-02 17:23:27 +00:00
Bernt 7ceb2b2433 OR-001: Operational Readiness
- Every pilot creates assets (Session, Mission, Artifacts, Metadata, Timeline, Report)
- Every failure is a Field Discovery (FD-XXXX), not a bug
- Every upload becomes permanent knowledge (Asset -> Metadata -> Knowledge -> Decision -> Learning)
- Measure the factory: Reality, Knowledge, Decisions, Learning, Economy
- Verified Decision Library: the biggest asset (2M observations, 400K cases, 150K verified)
- Sprint planning starts with real pilot observations, not backlog
- After 20-50 missions: workshop sorting into Bugs, Friction, Product Ideas

This is not a new ADR or architecture.
This is how we work every day.

Next: Pilot 001 — Break the system!
2026-07-02 17:22:23 +00:00
Bernt 9883b2c787 Spatial Intelligence: Three dimensions for every observation
- Semantic: What is the object?
- Spatial: Exactly where?
- Temporal: When observed and how changed?

Rich geometry support from start:
- SpatialContext: facade, floor, zone, height, lane, direction
- Geometry: point, polygon, line with coordinates
- CameraPose: position, heading, pitch, roll

Precision in 4 steps: GPS -> triangulation -> 3D -> history

Stronger Decision Cases with exact location

Vision: Continuously updated georeferenced knowledge model

Next: Pilot 001
2026-07-02 17:21:31 +00:00
Bernt 167def5a61 LandveX Vision v2.0: Living Operational Model
- Five levels: Reality → Digital Representation → Current State → Intelligence → Prediction
- Unique value: Every object gets a life history
- Not a digital twin focused on visualization
- Focus: verified observations, changes over time, decision support, business value
- Living operational model that improves with each verified observation

Vision:
LandveX is a continuously updated operational model of the customer's
infrastructure that combines verified observations, history, and decision
support to help organizations prioritize the right actions at the right time.

Complements Product Levels, Platform Architecture, Engineering Standard.

Next: Pilot 001 — break the system!
2026-07-02 17:20:15 +00:00
Bernt 1b16e422cf LandveX Product Levels: 4 tiers with Progressive Disclosure
- Level 0: Public (free) — open map, trends, heatmaps
- Level 1: Professional — own areas, dashboard, reports
- Level 2: Enterprise — AI rules, Mission Engine, Hotspots, Credits
- Level 3: Platform — multi-org, custom models, white-label, federation

Design Principle: Progressive Disclosure
- Default: very simple
- Advanced: more detail on same page
- Same Decision Case, different detail levels

Core Principle:
All users work in same LandveX platform.
License determines intelligence depth, not objects.

Complements Platform Architecture v2.0 and Engineering Standard v1.0.

Next: Pilot 001 — break the system!
2026-07-02 17:19:30 +00:00
Bernt 6e1aa1b0f6 LandveX Internal Pilot: DEPLOYED
- API running on port 3002
- UI running on port 3003
- Version endpoint: /version
- Health check: /health
- Platform Readiness: Mission Import , Artifact Registry ,
  Storage , Operations , Developer Mode 

Go Live Checklist updated with current status.
Docker Compose configured (ports adjusted for existing services).

Next: Pilot 001 — Break the system!
Test: bad coverage, large videos, interrupted upload,
multiple phones, bad GPS, darkness, rain, poor lighting.
2026-07-02 17:18:30 +00:00
Bernt ddfe99f9f2 Go Live Checklist + Version Endpoint
- Go Live Checklist for LandveX Internal Pilot deployment
- Version endpoint: /version returns environment, version, commit, build
- Ready for Internal Pilot deployment

Next: Deploy with Docker Compose
2026-07-02 17:10:09 +00:00
Bernt 740da921fe Engineering Standard v1.0: Kubernetes-first + GitOps + Observability
- Kubernetes-first for platform architecture
- GitOps: never manual cluster changes
- Local-first for dev experience, K8s-first for platform
- All infrastructure as code, same Git flow as app code
- Standardized service contract: /health, /ready, /live, /metrics, /version
- OpenTelemetry tracing, structured JSON logging
- Correlation ID follows entire pipeline: Session → Mission → Artifact → Observation → Evidence → Decision
- Intelligence Lab integrated in same platform, not separate cluster
- Platform principle: no new service introduces new deploy/log/config/observability pattern

Binding for all developers and AI agents.
Complements E-001, EP-1.0, Architecture Principles.

Next: Deploy pilot environment
2026-07-02 17:07:49 +00:00
Bernt 7b7660b056 Engineering Standard v1.0: Binding rules for all developers and AI agents
- Domain owns the truth
- Technical stack defined
- Code standards: TypeScript strict, no any, no console.log in prod
- Git flow: Issue → Branch → Code → Tests → Commit → PR → Review → Merge → Deploy
- Commit format: feat/fix/refactor/test/docs(scope): message
- PR rules: purpose, changes, tests, migrations, risks, screenshots
- Tests: unit (domain), integration (API), e2e (critical flows)
- Definition of Done: versioned, tested, reviewed, documented, flagged, pilot-ready
- AI agent rules: work in Git only, never production, suggest migrations, write tests
- Deployment flow: Local → Git → PR → Review → Merge → CI → Integration → Pilot → Production

Binding for all developers and AI agents.
Complements E-001 and EP-1.0.
2026-07-02 17:06:49 +00:00
Bernt 207185e5fb Minimal RBAC + Feature Flags + Developer Mode
- 4 roles: SuperAdmin, Operator, Reviewer, PilotUser
- Capabilities (not pages): mission.create, artifact.view, decision.approve, etc.
- Feature flags: ENABLE_REPLAY, ENABLE_MODEL_TRAINING, etc.
- Developer Mode toggle in UI (activated by permission)
- New rule: All features must link to module, capability, and role

Next: Deploy pilot environment
2026-07-02 16:59:00 +00:00
Bernt c5a42506c1 Readiness Dashboard: System status before external pilots
- Shows all systems: API, Database, Storage, Upload, Mission, Map,
  Replay, AI Processing, Decision Pipeline
- Color-coded status: Green/Ready, Yellow/Partial, Red/Not Ready
- Version info: Environment, Version, Commit, Build time
- Exit criteria checklist for external pilots

Next: Deploy pilot environment
2026-07-02 16:57:20 +00:00
Bernt 8a8fb0a4f4 Platform Architecture v2.0: One Platform, Multiple Roles
- LandveX is one platform, not two
- Same backend, database, API, map
- Intelligence Lab = Developer Mode (not separate product)
- Same Artifact Viewer, different detail by role
- Same map, different layers by role
- Role-based access: Erik, Johan, Pilot Customer, Municipality

Architecture Principle:
One platform. One API. One data model. One map.
One Artifact system. Multiple roles.

Next: Implement RBAC and Developer Mode toggle
2026-07-02 16:55:46 +00:00
Bernt 6c2b5ee340 Deployment Strategy: 4 environments + Docker setup
- Development: localhost (API:3002, UI:3003)
- Integration: AI model validation
- Pilot: pilot.landvex.com (Docker Compose)
- Production: app.landvex.com
- Intelligence Lab: lab.landvex.internal

Docker Compose:
- API (Node.js)
- UI (Nginx)
- PostgreSQL
- MinIO (object storage)

Next: Deploy pilot environment
2026-07-02 16:53:10 +00:00
Bernt 4edc1d89a7 Pilot 001: Operativ checklista — inte dokument, arbetsverktyg
- Fältfas: område, varför, infrastruktur, förväntade objekt, tid, problem
- Teknisk fas: session, mission, artifacts, upload, metadata, explorer, viewer
- Beslutsfas: rätt observation, evidens, beslut, varför inte
- Utvärdering: tid, osäkerhet, automation, värde, nästa steg
- Golden Mission-knapp för att markera #0001

Mål: Kan vi gå från verklighet till verifierat Decision Case utan
manuella genvägar?

Stoppregel: Ingen ny arkitektur förrän Pilot 001 genomfört.

Next: Starta Pilot 001 — film, upload, verifiera
2026-07-02 16:34:49 +00:00
Bernt e2e3d00936 MASTER PROMPT: Intelligence Lab Development Mode v1.0
- Verkliga data först
- Pipeline före modell
- Decision Case är målet
- Träna kontinuerligt
- STOP-regel: ingen funktion utan validering på pilotmaterial
- Sista princip: ingen modellförbättring färdig utan mätbar förbättring

Stoppregel: Ingen ny arkitektur förrän MVP-0 genomfört med verkligt uppdrag.

Next: Pilot 001 — First real field upload
2026-07-02 16:23:26 +00:00
Bernt e669155bc9 MVP-0: Field Console + Health Dashboard
- Field Console: 4 tabs (Upload, Queue, Artifact Viewer, Timeline)
- Health Dashboard: system pulse for 6 engines
- No more ADR documents until MVP-0 proven with real mission

Stoppregel: Ingen ny arkitektur förrän första verkliga uppdraget.

Next: Pilot 001 — First real field upload
2026-07-02 16:22:21 +00:00
Bernt a2b3c922f7 MVP-0: First Field Upload — UI with Dataset Explorer, Artifact Viewer, Mission Upload
- Dataset Explorer: list missions with processing status
- Artifact Viewer: mission details, metadata, processing status
- Mission Upload: simple video upload form
- React + Vite + React Router
- Proxy to API at localhost:3000

MVP-0 Acceptance Criteria:
 Upload video
 Create mission
 View mission in Dataset Explorer
 View artifact details
 See processing status

No AI. Just file transfer, storage, metadata, registry.

Next: Pilot 001 — First real field upload
2026-07-02 16:15:25 +00:00
Bernt eae6c58d66 ADR-013: Engine Architecture v1.0 — Six Engines + Orchestrator
- Reality Engine: capture reality → observations
- Knowledge Engine: understand meaning → evidence, findings
- Decision Engine: make actionable → decisions, recommendations
- Mission Engine: determine what to collect → missions, gaps
- Economic Engine: manage budgets → credits, ROI
- Learning Engine: continuously improve → better models
- Platform Orchestrator: coordinates via events

Key principles:
- Each engine independently versioned
- Engines never call each other directly
- All communication via events
- Dashboard shows results, not engines
- Intelligence Lab tests engines, not platform

Next: PR-005A — Mission Import UI for MVP-0
2026-07-02 16:11:58 +00:00
Bernt 5891bd849a ADR-012: Five Engines Platform Architecture + Economic Engine
- LANDVEX_PLATFORM_ARCHITECTURE.md: Five Engines (Reality, Knowledge,
  Decision, Mission, Economic)
- Credit: first-class economic object with types (mission, validation,
  training, priority, emergency)
- IntelligenceLedger: tracks value creation separate from financial accounting
- KnowledgeGap: missing information that drives missions
- Hotspot: composite score for mission generation
- Contradiction: conflicting information as opportunity

Key principle: Every component answers 'What value is created here?
Who pays for it?'

Next: PR-005A — Minimal Mission Import UI for MVP-0
2026-07-02 16:09:29 +00:00
Bernt c6e14c5928 ADR-012: Five Engines Platform Architecture + Economic Engine
- LANDVEX_PLATFORM_ARCHITECTURE.md: Five Engines (Reality, Knowledge,
  Decision, Mission, Economic)
- Credit: first-class economic object with types (mission, validation,
  training, priority, emergency)
- IntelligenceLedger: tracks value creation separate from financial accounting
- KnowledgeGap: missing information that drives missions
- Hotspot: composite score for mission generation
- Contradiction: conflicting information as opportunity

Key principle: Every component answers 'What value is created here?
Who pays for it?'

Next: PR-005A — Minimal Mission Import UI for MVP-0
2026-07-02 16:05:56 +00:00
Bernt 754c89506b ADR-011: Four-Layer Data Architecture — Raw Archive → Knowledge → Ontology → Decision
- Layer 1: ArchiveArtifact — immutable original with retention policy
- Layer 2: KnowledgeArtifact — extracted knowledge (observations,
  segmentations, feature vectors, relations)
- Layer 3: Knowledge Graph / Ontology (documented, not implemented)
- Layer 4: Decision Intelligence (existing DecisionCase)
- DataLifecycle: tracks every step with artifact lineage
- Key principle: AI models trained on curated datasets, not whole archive
- Ontology answers 'what does it mean in our domain?'

Long-term goal: Every observation converted once to structured
knowledge, reused infinitely for analysis, decisions, training.

Next: PR-005A — Minimal Mission Import UI for MVP-0
2026-07-02 16:03:39 +00:00
Bernt 13780baeb8 PR-004A: Mission Import API — MVP-0 First Field Upload
- POST /api/v1/missions/import — multipart upload with video
- GET /api/v1/missions/:id — retrieve mission
- GET /api/v1/missions — list active missions
- Express + multer for file handling
- Uses application layer handlers (PR-002.5)
- In-memory repositories (swap for PostgreSQL in PR-003B)

Acceptance Tests (5/5 passing):
 Import mission with video
 Reject upload without video
 Retrieve mission by ID
 404 for non-existent mission
 Health check

MVP-0 Definition of Done:
 Phone → Upload → Store → Retrieve
 No AI required
 First real artifact produced

Next: PR-005A — Minimal Mission Import UI
2026-07-02 16:01:29 +00:00
Bernt 2f0ab18e81 PR-003A: PostgreSQL Repository Adapters + Persistence Independence Test
- 4 PostgreSQL adapter stubs (Session, Mission, DecisionCase, Artifact)
- Migration 001: Initial schema (sessions, missions, artifacts, decision_cases)
- Persistence Independence Test: 6 tests verifying same behavior
  across InMemory and PostgreSQL implementations
- ADR-008: PostgreSQL Adapters for Production
- ADR-009: Persistence Independence

Architecture Quality Gates:
- Domain unchanged
- Application unchanged
- Only adapter implementation changes
- Same test suite runs against both implementations

Next: PR-003B — Schema & Migrations, PR-003C — Integration Tests,
PR-003D — Unit of Work / Transactions
2026-07-02 15:57:23 +00:00
Bernt eab9da0100 PR-002.5: Application Layer — Command/Result pattern, end-to-end flow
- 8 commands (CreateFieldSession, CreateMission, RegisterArtifact,
  CreateObservation, CreateDecisionCase, ApproveDecision, StartReview,
  CompleteReview)
- 4 handlers with validation and orchestration
- Result<T, E> pattern — explicit success/failure, no exceptions
- End-to-end test: Session → Mission → DecisionCase → Approval
- 3 tests proving full flow works in memory
- ADR-007: Command/Result Pattern

Acceptance Criteria:
 CreateFieldSession → CreateMission → CreateDecisionCase → ApproveDecision
 Without PostgreSQL, Redis, S3, API, HTTP, UI
 Business logic verified before infrastructure attached

Next: PR-003 — PostgreSQL adapters (swap InMemory → Postgres)
2026-07-02 15:06:59 +00:00
Bernt 02b51d7814 PR-002: Persistence Adapters — in-memory, zero external dependencies
- Repository interfaces defined by domain (@landvex/domain)
- 6 in-memory adapters: Session, Mission, DecisionCase, Artifact, EventStore, UnitOfWork
- 9 tests verifying adapter contracts
- Domain unchanged — infrastructure depends on domain, never reverse
- ADR-006: In-Memory Adapters for Testing

Definition of Done met:
- All adapters compile against domain interfaces
- Unit tests pass (9/9)
- No PostgreSQL, S3, Express, AI in this PR
- Ready for PR-003: PostgreSQL adapters
2026-07-02 14:59:37 +00:00
Bernt fa0dbf5127 PR-001: Domain Model v1.0 — compile-only, zero dependencies
- @landvex/domain package with TypeScript strict mode
- 3 Aggregate Roots: FieldSession, Mission, DecisionCase
- Branded IDs, Value Objects, Domain Events, Invariants
- 19 unit tests for IDs, FieldSession, DecisionCase
- Zero runtime dependencies (only TypeScript + jest for tests)
- Separates Entity / Value Object / Aggregate Root
- README documents Three Rules of the domain

Definition of Done met:
- Compiles without errors
- Exports all domain types
- Unit tests for invariants and value objects
- No PostgreSQL, S3, Express, AI models, queues
2026-07-02 14:26:29 +00:00
Bernt 118180e7ff docs: PR-001 Domain Model v1.2 — Three Rules + Experience Intelligence + Capability Tags
- Added Three Rules to README:
  1. Domain knows nothing about AI (no AIObservation, YOLODetection, etc.)
  2. Everything is an Artifact (common contract for all produced objects)
  3. All decisions are reproducible (answer: which observations, evidence,
     model, version, rules, reviewer, when, approved version)

- Renamed Human Intelligence → Experience Intelligence
  - Broader scope: citizen surveys, customer satisfaction, field technician
    feedback, contractor experience, service desk data
  - More future-proof than 'Human Intelligence'

- Added Capability Tags for developers:
  - Observation: [Detection, Vision, GPS, Image]
  - Decision: [Decision, Recommendation, Business]
  - Artifact: [Storage, Versioning, Lineage]
  - Makes dependencies clear as platform grows

- Updated Domain Invariants:
  - DecisionCase: must have at least one Review before Approved
  - Review: must belong to exactly one Decision, must have reviewer

- Added Merge Criteria:
  - All stakeholders (developer, AI engineer, product owner, domain expert)
    can read model and understand same terms
  - No AI objects, all Artifacts, reproducible decisions

Rationale: Lock domain language before implementation. Shared vocabulary
for code, docs, APIs, tests, and product discussions.
2026-07-02 14:09:45 +00:00
Bernt b4391f9600 docs: PR-001 Domain Model v1.1 — Human Intelligence as future module
- Added Human Intelligence as separate external module (not in core domain)
- Positioning: External Intelligence Module, not part of Epic-001
- Architecture: Reality Intelligence with four branches:
  - Infrastructure Intelligence (core, Epic-001)
  - Operational Intelligence (future)
  - Human Intelligence (future module)
  - External Intelligence (future)

- Human Insight Artifact: Source, Geography, Period, Metrics, Confidence
- Usage: Linked to Area or Decision Case, never mixed with raw observations
- Example: Decision Case enriched with 'Many complaints last 30 days'
- When: After Epic-001 stable and 20+ Decision Cases exist

Rationale: Keep core domain clean. Human data is context, not observation.
Add after basic pipeline is proven.
2026-07-02 13:50:38 +00:00
Bernt a08e897f96 docs: PR-001 Domain Model — Core language for LandveX Intelligence Lab
- Package: @landvex/domain
- Zero dependencies on Express, PostgreSQL, S3, or AI frameworks
- Four package structure: domain, contracts, shared, infrastructure
- Domain never depends on infrastructure

- Aggregate Roots: FieldSession, Mission, DecisionCase
- Entities: MissionAsset, Artifact, Observation, Evidence, Finding,
  Decision, Review, Action, Outcome
- Value Objects: MissionId, ArtifactId, SessionId, ObservationId,
  DecisionId, GeoLocation, GpsAccuracy, Confidence, Severity, Priority,
  Hash, StorageUri, Version

- Enums: ArtifactType, ReviewStatus, DecisionVerb, MissionStatus, SessionStatus
- Event Contracts: FieldSessionCreated, MissionCreated, MissionImported,
  ArtifactUploaded, ArtifactValidated, ObservationCreated, EvidenceCreated,
  FindingCreated, DecisionCreated, DecisionReviewed, DecisionApproved

- Domain Invariants:
  - FieldSession: must have location, date, can have zero missions
  - Mission: must belong to one Session, must have at least one Artifact
  - DecisionCase: must have at least one Observation, one Evidence,
    exactly one Decision, cannot be Approved without Review
  - Artifact: must have unique hash, storage URI, versioned

- TypeScript interfaces for all domain objects
- Branded ID types for type safety
- Strict rule: No new feature may introduce new domain concepts without
  approved change to domain model

- README: 'This package describes LandveX domain model. Contains no
  dependencies to database, HTTP, cloud storage, or AI frameworks.'

- Next: PR-002 Persistence Adapter (Repository Interface → PostgreSQL/S3/Event Store)

Rationale: Lock the language before writing infrastructure code.
Shared vocabulary for code, docs, APIs, tests, and product discussions.
2026-07-02 13:49:19 +00:00
Bernt 7075cf9ab9 docs: Epic-001 v1.3 — 12 architectural adjustments before first line of code
- Session is root (not Mission): Field Session → Mission → Asset → Observation...
- Event Sourcing: never overwrite status, status is projection of history
- Artifact Registry: first-class object with id, type, version, hash, lineage
- Decision Case immutability: Review → Revision → Approved Version (like Git)
- Review Task: Assigned → Reviewed → Approved → Closed
- Processing Graph: nodes not hardcoded chain, swap models without changing rest
- Data Quality as domain: Blur, Duplicate, Bad GPS, Low Resolution, etc.
- Decision Case comparison: show exactly what changed, which evidence, model, human
- Golden Missions + Golden Datasets: two levels
- Domain Event Viewer: timeline (09:42 Mission Created, 09:43 Video Uploaded...)
- KPI: Verified Decision Throughput (verified decisions per day)
- Architecture Principle: 'Produces verified Decision Cases through reproducible
  and traceable pipeline'

Updated PR-001 Domain Model:
- Added FieldSession (root)
- Added Artifact interface
- Added Event sourcing types
- Session ID format: session_YYYYMMDD_NNNNNN
- Updated API to include /sessions endpoints

Rationale: Three fundamental objects (Session, Artifact, Event) make the rest
natural. Scalable, auditable, well-suited for public sector traceability requirements.
2026-07-02 13:45:41 +00:00
Bernt 37ef2f4526 docs: Epic-001 v1.2 — Implementation plan + Development rules
- Added Vision: 'LandveX Intelligence Lab is the internal factory where
  raw reality is refined into verified Control Intelligence'
- Added Architecture Goal: Every artifact traceable backward to source
  and forward to decision
- Added Development Rule: No Story starts with UI. Order: Domain model →
  API → Storage → Tests → UI
- Added Story 1 implementation plan with 5 PRs:
  PR-001: Domain Model (Mission, MissionAsset, Upload, types)
  PR-002: Storage (S3/R2 bucket, PostgreSQL metadata, checksums, EXIF, GPS)
  PR-003: API (POST /missions, POST /missions/{id}/assets, GET /missions)
  PR-004: Events (MissionCreated, AssetUploaded, RawDatasetReady)
  PR-005: UI (simple drag-and-drop upload with progress)
- Added Definition of Done for Story 1:
  Phone → Video → Upload → Bucket → Metadata → Mission visible in Dataset Explorer
- Added ID Convention: mission_YYYYMMDD_NNNNNN, asset_NNNNNN, obs_NNNNNN,
  decision_NNNNNN. Never UUID in UI.
- Added Artifact Viewer: show raw asset metadata, hash, GPS, EXIF,
  storage location, version for debugging

Rationale: Clean architecture, testable without UI, traceable artifacts.
2026-07-02 13:41:16 +00:00
Bernt 9e4ebeea1a docs: Epic-001 v1.1 — Reordered stories + Golden Mission + Review + Dashboard
- Reordered stories to reach First Verified Decision faster:
  1. Mission Import (was 2) — proves we can receive real data
  2. Dataset Explorer (was 3) — makes data visible
  3. Annotation Workspace (was 4) — first human-in-the-loop
  4. Decision Case (was 5) — first verified decision
  5. Replay (was 6) — proves chain is reproducible
  6. Session Management (was 1) — organizes when core works

- Added Golden Mission concept:
  - Real mission that never changes, used as regression test
  - Every new model runs against same mission
  - See immediately if something got better or worse

- Added Review as first-class object:
  - Observation → AI → Human Review → Approved/Rejected/Needs More Evidence
  - Makes entire quality flow traceable

- Added Dashboard v1:
  - Sessions, Missions, Decision Cases, Pending Reviews, Verified Decisions
  - Big button: [Continue Reviewing]
  - Work tool, not BI system

- Added vertical user journey (demo script):
  - quiXzoom → photo → import → save → explore → AI observation →
    correction → Decision Case → full chain viewer
  - If this works, core is proven

- Added definition of 'First Verified Decision':
  - Built on real observation data
  - Reviewed by human
  - Complete evidence chain
  - Fully reproducible from raw data to recommendation

Rationale: Reach core proof faster, add organization later.
Golden Mission enables regression testing from day one.
Review object makes quality flow traceable.
2026-07-02 13:38:09 +00:00
Bernt c47a58f76b docs: Epic-001 — First Verified Decision specification
- STOP Rule: No new pipeline until 20 real Decision Cases exist
- Field Readiness Gate: 5 questions before building any feature
- Sprint Goal: Every sprint must produce more verified Decision Cases

- Six stories:
  1. Session Management — organize missions by location/date
  2. Mission Import — upload video/images/GPS/EXIF, store immutably
  3. Dataset Explorer — browse, filter, search, map view
  4. Annotation Workspace — review/correct AI, version history
  5. Decision Case — full chain: Observation→Evidence→Finding→Decision→Business Impact
  6. Replay — step through mission chain (V1: simple playback)

- Not in first release (intentionally postponed):
  GPU Queue, Hyperparameter Search, Distributed Training,
  Benchmark, Canary Deployment, Auto Retraining,
  Bias Dashboard, Drift Detection

- Definition of Done: Complete vertical slice from reality to verified decision
- Definition of Ready for Epic-002: 20 real Decision Cases + Field Readiness Gate

- Technical stack: React+TypeScript, Node.js+Express, PostgreSQL, S3/R2, Bull, Python AI service
- Quality gates: TypeScript strict ≥80% coverage, no secrets, OAuth 2.0, immutable audit log, GitOps

Rationale: Prove the system works end-to-end before scaling.
Focus on learning from reality, not building everything upfront.
2026-07-02 13:34:05 +00:00
Bernt 67ca05f2b2 docs: LandveX Intelligence Lab v1.3 — Government Quality Standards added
- Added comprehensive quality standards for public sector:
  - Code Quality: TypeScript/Rust strict, ≥80% test coverage, static analysis,
    mandatory code review, API documentation
  - Security: OAuth 2.0 + MFA, RBAC + audit, AES-256/TLS 1.3,
    HashiCorp Vault, weekly vulnerability scans
  - Audit & Compliance: Immutable signed logs, configurable retention,
    full export, WCAG 2.1 AA, Swedish + English
  - Infrastructure: GitOps, OpenTelemetry, 3-2-1 backup, RPO<1h RTO<4h,
    horizontal scaling
  - AI/ML: MLflow versioning, full data lineage, bias testing,
    SHAP/LIME explainability, model cards
  - Development: Git workflow, CI/CD, IaC, dependency management,
    incident response runbooks

Rationale: LandveX serves municipalities and government agencies.
Intelligence Lab must satisfy public sector procurement, audit,
and compliance requirements from day one.
2026-07-02 13:08:22 +00:00
Bernt 8e9871f209 docs: LandveX Intelligence Lab — Government Quality Standards
- Added comprehensive quality standards for public sector:
  - Code Quality: TypeScript/Rust strict, ≥80% test coverage, static analysis,
    mandatory code review, API documentation
  - Security: OAuth 2.0 + MFA, RBAC + audit, AES-256/TLS 1.3,
    HashiCorp Vault, weekly vulnerability scans
  - Audit & Compliance: Immutable signed logs, configurable retention,
    full export, WCAG 2.1 AA, Swedish + English
  - Infrastructure: GitOps, OpenTelemetry, 3-2-1 backup, RPO<1h RTO<4h,
    horizontal scaling
  - AI/ML: MLflow versioning, full data lineage, bias testing,
    SHAP/LIME explainability, model cards
  - Development: Git workflow, CI/CD, IaC, dependency management,
    incident response runbooks

Rationale: LandveX serves municipalities and government agencies.
Intelligence Lab must satisfy public sector procurement, audit,
and compliance requirements from day one.
2026-07-02 12:49:26 +00:00
Bernt df5e2b3e78 docs: LandveX Intelligence Lab v1.2 — MVP + Phases + Data Quality + Decision Analytics
- MVP Milestone: 'First Verified Decision'
  - Developer films with quiXzoom, imports to Lab, corrects AI,
    creates Decision Case, follows chain with full traceability
  - When this works = first complete verifiable Control Intelligence pipeline

- Three development phases:
  Phase 1 (Essential): Ingestion, Dataset Explorer, Annotation, Decision Case Viewer
  Phase 2 (Scale): Replay, Benchmark, Evaluation
  Phase 3 (Advanced): GPU Jobs, Hyperparameter Runs, Model Promotion, Canary

- Product Architecture: quiXzoom → Observations → Intelligence Lab →
  Improved Models → LandveX → Better Decisions → Feedback → Intelligence Lab
  - Two products: quiXzoom (observations), LandveX (decisions)
  - Intelligence Lab = the factory that improves both

- New areas:
  - Data Quality: Healthy/Blurred/Duplicate/Wrong GPS/Night/Rain/Occluded
    + Coverage (Roads, Buildings, Signs, Drainage, Vegetation)
  - Decision Analytics: Acceptance Rate, Ignore Rate, Accuracy,
    Insufficient Evidence, Data Collection Value
    - Business value metrics, not traditional AI metrics

Rationale: Build MVP first, prove first real workflow, then scale.
Decision Cases are the heart. Data Quality explains model performance.
Decision Analytics measure business value.
2026-07-02 12:27:16 +00:00
Bernt 9a817ac82a docs: LandveX Intelligence Lab v1.1 — Architecture + Pipelines + Immutability
- Added architecture diagram:
  - Developer UI / Training API / Experiment API
  - Event Bus / Queue
  - Storage Layer (S3/R2 + PostgreSQL + Neo4j)
  - Processing Pipelines

- Seven separate pipelines (not one big AI loop):
  1. Ingestion — raw images/video/GPS/EXIF → Raw Dataset
  2. Dataset — sort, deduplicate, quality control → Validated Dataset
  3. Annotation — AI suggestions, manual correction → Verified Dataset
  4. Training — hyperparameters, checkpoints, GPU → Model Artifact
  5. Evaluation — precision, recall, F1, decision accuracy → Report
  6. Replay — compare model versions → Regression Report
  7. Decision Validation — full chain → Validation Report

- Bucket structure: raw-images, raw-video, missions, datasets,
  annotations, training, models, replays, evaluation,
  decision-cases, field-trials, exports, archives

- AI Job Queue: all jobs asynchronous (Upload → Queue → Worker → GPU → Storage → Notification)

- Core principles updated:
  - All artifacts immutable and versioned
  - Every change traceable to experiment, model, dataset, decision

- Dashboard shows: Datasets (Healthy/Needs Review/Corrupted),
  Training Jobs, Decision Cases, Replay Jobs

- Decision Cases emphasized as most important asset

Rationale: Separate pipelines make system easier to debug, improve,
and swap components. Immutability aligns with E-001 Git/traceability
principles. Decision Cases become the unique asset over time.
2026-07-02 12:26:00 +00:00
Bernt f6119e7bb6 docs: LandveX Intelligence Lab specification v1.0
- Internal development environment for Control Intelligence
- Core principle: 'Produces verified Control Intelligence, not AI models'
- Separate repo: landvex-intelligence-lab
- Navigation: Dashboard, Models, Datasets, Annotations, Training,
  Evaluation, Decision Cases, Replay, Validation, Deploy, Settings

- Key features:
  - Dashboard: AI status (models, datasets, jobs, cases)
  - Mission Replay: click through entire chain
  - Annotation: video + AI suggestion + manual correction
  - Decision Cases: first-class objects, all playable
  - Benchmark: compare YOLO, Grounding DINO, SAM, custom models
  - Replay: find regressions between model versions
  - Validation: field trials, scenario tests, decision tests
  - Deploy: 'Promote Model' not 'Deploy' (dev → validation → pilot → prod)
  - Experiments: link EP-1.0, DS-001, etc. to real data

- Target: New AI engineer understands in minutes:
  'This is where we build, test, and verify LandveX Control Intelligence
   before anything reaches production.'

Rationale: Single internal tool for all AI development. Centralizes
model training, annotation, validation, replay, decision chains,
regression tests, experiments, and model promotion.
2026-07-02 12:24:18 +00:00
Bernt b934797e65 docs: Field Trial Log v1.1 — Pilot phases + filming protocol
- Added four pilot phases (product research, not marketing):
  1. Collection — what can actually be detected?
  2. Analysis — are decisions understandable?
  3. Verification — was recommendation correct?
  4. Reflection — what needs to change?

- Measurement principle:
  - Not: Did AI find a crack?
  - But: Did this become a decision a real person could act on?

- Document 'non-decisions' — equally valuable as clear decisions
- Film workflow, not just infrastructure:
  - How you find area, choose mission, document
  - What feels unclear, when you become uncertain
  - When system saves time

- Observer mindset: document first, change model later
  - Build model from real workflows, not assumptions

Rationale: First 20-50 real missions teach more than months of modeling.
2026-07-02 12:21:20 +00:00
Bernt 1c4158c373 docs: Field Trial Log + Decision KPIs + MEMORY update
- Created FIELD_TRIAL_LOG.md — observation protocol for real customer cases
  - Log entry template with 10 fields
  - Two example entries (accepted and rejected decisions)
  - Questions the log answers: adoption, accuracy, calibration, rejection analysis
  - Future KPIs: Decision Adoption Rate, Decision Accuracy, Time to Decision

- Updated MEMORY.md with Control Intelligence & Decision Model section
  - Decision Pipeline v1.0 summary
  - Decision Object v1.0 (STRUCTURE FROZEN)
  - Status: VALIDATED FOR FIELD TRIALS
  - Three target customer cases
  - Future KPIs
  - Key principle: No more modeling until first real customer case

- Added Decision Adoption Rate and Decision Accuracy as future product KPIs
  - Not implemented yet — start collecting data now, calculate later
  - Decision Adoption = accepted / total recommendations
  - Decision Accuracy = correct / total decisions

Rationale: Stop modeling, start observing. First real customer case
will teach more than the last twenty documents combined.
2026-07-02 12:19:10 +00:00
Bernt c8819109db docs: Decision Model v1.0 — STRUCTURE FROZEN + All Tests PASS
- Status: STRUCTURE FROZEN (not LOCKED/FINAL)
  - Frozen: field names, semantics, relationships
  - Not frozen: implementation, algorithms, confidence calculation

- Three tests executed and PASSED:
  1. Decision Invariance Test — all 8 scenarios use same 7-field structure
  2. Evidence Variation Test — Decision Object identical regardless of evidence type
  3. Explainability Invariance Test — chain Reality→Observation→Evidence→Finding→Decision
    works for all actionable decisions

- Results summary:
  - Manual Review: 6 PASS, 2 OBSERVATION, 0 FAIL
  - Decision Invariance: PASS
  - Evidence Variation: PASS
  - Explainability Invariance: PASS
  - Decision Quality Gate: PASS
  - Verb Rule: PASS

- Overall: VALIDATED FOR FIELD TRIALS
  - Internal validation complete
  - Ready for real customer testing
  - Not production truth yet

- Open questions documented (not added as fields):
  - Observation A: Cost estimate for investment decisions
  - Observation B: Explicit low confidence communication

- Next: Three real customer cases (municipality, property owner, contractor)

Rationale: Freeze structure before testing, run tests against locked model,
mark as 'Field Trial Ready' not 'Final'. Model changes when real data
contradicts it, not before.
2026-07-02 12:17:50 +00:00
Bernt 656f3bf1c2 docs: Decision Model v1.0 — LOCKED for Field Trials
- Decision Object Contract v1.0 frozen:
  - 7 fields: Decision, Why, Evidence, Confidence, Consequence, Action, Business Impact
  - Changes require v1.1 + migration note + revalidation
  - Implementation/presentation not frozen

- Status: LOCKED — Validated for Field Trials
  - Not 'Final' — signals internal validation complete, real-world proof pending

- Three pending tests defined:
  1. Decision Invariance Test (same structure across all scenarios)
  2. Evidence Variation Test (same object regardless of evidence type)
  3. Explainability Invariance Test (Decision → Finding → Evidence → Observation → Reality)

- Freeze date: 2026-07-02
- Next: Run tests, then move to 3 real customer cases

Rationale: Freeze contract before testing so tests validate a locked model,
not a moving target. 'Field Trial Ready' signals proven internally but
awaiting real-world validation.
2026-07-02 12:16:04 +00:00
Bernt f05fded74e docs: Decision Pipeline v1.0 + Learning Loop + Control Intelligence + 3 Customer Cases
- Added Step 7: Learning (feedback loop from Business Impact to Intelligence)
- Control Intelligence definition: LandveX produces Control Intelligence, not AI
- Three target customer cases defined:
  1. Municipality — Inspect or wait? (Maintenance prioritization)
  2. Property Owner — Repair now or plan later? (Cost vs risk)
  3. Contractor/Operations — Which action first? (Operational planning)
- Validation requirements: Run each case through full pipeline, document breaks,
  revise only after data contradicts model
- Communication principle: Observation → Analysis → Recommendation
  (AI is implementation, recommendation is product)

Rationale: Stop modeling, start observing. Model changes when data contradicts
it, not before. Three real customer cases before freezing.
2026-07-02 12:13:25 +00:00
Bernt e3e70c52d4 docs: Decision Model v1.0 — 7 validation scenarios + invariance tests
- Added 7 validation scenarios covering diverse decision types:
  1. Road Crack (Maintenance) — repair now or later?
  2. Damaged Facade (Safety) — act immediately?
  3. Broken Road Sign (Compliance) — violates requirements?
  4. Vegetation Blocking Sight (Risk Reduction) — gradual deterioration
  5. Parking Area Wear (Investment Priority) — multiple small → big decision
  6. Cosmetic Scratch (No Action) — conscious decision to wait
  7. Mixed Evidence Sources — photo + sensor + weather API

- Decision Invariance Test:
  - Same Decision Object structure across all scenarios?
  - No fields added/removed?
  - No field meaning changes?
  - Fail = model needs revision

- Evidence Variation Test:
  - Single image, multiple images, video+GPS, historical, external data, mixed
  - Decision Object structure unchanged regardless of evidence type

- Decision Quality Gate:
  - Verifiable evidence chain
  - Motivated confidence
  - Action or conscious 'no action'
  - Explainability chain works

- Pass criteria: All 7 scenarios valid + invariance + evidence + quality gate

Rationale: Validate model against diverse decision types before freezing.
No action scenario is as important as action scenarios. Mixed evidence
sources test robustness. Invariance test ensures generality.
2026-07-02 12:01:38 +00:00
Bernt ff136e8aae docs: Decision Model v1.0 — Evidence-backed decisions + explainability + validation scenarios
- Six layers (added Evidence between Observation and Finding):
  1. Reality
  2. Observation
  3. Evidence (linked observations with context)
  4. Finding
  5. Decision
  6. Business Impact

- Decision Object restructured:
  1. Decision — what should user decide?
  2. Why — why system recommends this
  3. Evidence — what observations support this
  4. Confidence — how certain (3 dimensions)
  5. Consequence — what if nothing done
  6. Action — next step
  7. Business Impact — economic/operational meaning

- Confidence Model (3 dimensions):
  - Observation Confidence: how certain is detection?
  - Evidence Strength: how strongly supported?
  - Recommendation Confidence: how certain is recommendation?

- Explainability Principle:
  - Every Decision Card must be explorable
  - User can click: Decision → Finding → Evidence → Observations → Reality
  - Competitive advantage: traceability to source material

- Business Impact Model (4 dimensions):
  - Risk, Cost, Time, Opportunity

- Three validation scenarios:
  1. Road Crack — simple, common
  2. Damaged Facade — complex, critical
  3. Broken Road Sign — simple, regulatory

- Pass criteria: Same Decision Object works for all three

Rationale: Decision Intelligence, not BI. Evidence-backed decisions
are the core product. Explainability is competitive advantage.
Validation against real scenarios before freezing.
2026-07-02 11:59:33 +00:00
Bernt 1a20d41e7e docs: Dashboard Audit Protocol — stress test for Foundation v1.0
- DASHBOARD_AUDIT_PROTOCOL.md (v1.0, LOCKED):
  - Five criteria: 3-Second Rule, Journey Principle, Reality→Decision,
    Dashboard Principle, Decision Density
  - Blink Test: 3-second exposure, consistent answers = pass
  - Information-to-Decision Ratio: measure objects needed per decision
  - Audit form with pass/fail for each criterion
  - Decision matrix: all pass = proceed, some fail = adjust Dashboard,
    most fail = review Foundation

Rationale: Dashboard is the stress test for Foundation v1.0. If Dashboard
passes without Foundation changes, the base is robust enough to scale.
If Dashboard fails, adjust Dashboard first — not Foundation.
2026-07-02 11:47:32 +00:00
Bernt 8e79e4b006 docs: Dashboard Principle + Landvex Dashboard audit prep
- DASHBOARD_PRINCIPLE.md (v1.0, LOCKED):

  - Four questions: What, Where, How serious, What now

  - Information hierarchy: Score -> Observations -> Map -> History -> Details

  - Decision Density: Dashboard = 1-3 decisions max

  - Not BI: helps user make decision, not consume statistics

  - Verification checklist

- EXPERIENCE_AUDIT_QA.md updated:

  - Screen 4: Landvex Dashboard (Phase: Manage)

  - Dashboard-specific questions: 3-second understanding, today's decision,

    80% ignorable, primary CTA

  - Dashboard Principle check: What/Where/How serious/What now

  - Decision Density target: 1-3 decisions

  - One-Sentence Test: understand area performance and what to act on

- Ready for Landvex Dashboard screen (stresstest for Foundation v1.0)
2026-07-02 11:45:07 +00:00
Bernt 70a625510b docs: Journey Principle + Mission Marketplace naming + Dashboard prep
- JOURNEY_PRINCIPLE.md (v1.0, LOCKED):

  - Five phases: Discover, Capture, Process, Outcome, Manage

  - Maps to both quiXzoom and Landvex

  - Screen mapping table

  - Balance check reveals Capture/Process/Outcome are empty

  - Verification: every screen must belong to a phase

- EXPERIENCE_AUDIT_QA.md updated:

  - Screen 3 renamed: Public Map -> Mission Marketplace

  - Added Phase column: Discover

  - One-Sentence Test updated: which missions not how much

  - Added Journey Principle reference

  - Screen 4: Dashboard (Landvex) - awaiting screen

  - Screen 5: Results/Decision View (Landvex) - awaiting screen

- Next: Landvex Dashboard audit (stresstest for Foundation v1.0)

Rationale: Journey Principle prevents screens from floating without

context. Mission Marketplace better reflects the page's purpose.

Dashboard is the most complex screen - best stresstest for principles.
2026-07-02 11:42:32 +00:00