M10 LENS — Composable View Projections

[flyingrobots]

M10: LENS — Composable View Projections

Goal: Lenses post-process view results. ViewResult → ViewResult, composed via colon syntax (git mind view roadmap:incomplete:frontier).

Key decisions: Left-to-right composition order. Lenses receive filtered ViewResult + full nodeProps map (not raw graph). needsProperties propagates if any lens in chain needs it.

Tasks

• [M10/LNS-001] Extract DAG utilities into src/dag.js #230 LNS-001 Extract DAG utilities into src/dag.js
• [M10/LNS-002] Define lens type + registry in src/lens.js #231 LNS-002 Define lens type + registry in src/lens.js
• [M10/LNS-003] Implement lens composition engine #232 LNS-003 Implement lens composition engine
• [M10/LNS-004] Implement 5 core lenses #233 LNS-004 Implement 5 core lenses (incomplete, frontier, critical-path, blocked, parallel)
• [M10/LNS-005] Wire CLI colon syntax for view:lens chaining #234 LNS-005 Wire CLI colon syntax + JSON output
• [M10/LNS-006] JSON Schema contract for view-lens output #235 LNS-006 JSON Schema contract for view-lens
• [M10/LNS-007] Export lens API from src/index.js #236 LNS-007 Export lens API from src/index.js

Dependency DAG

LNS-001 (#230) ──┐
                  ├──→ LNS-004 (#233) ──→ LNS-005 (#234) ──→ LNS-006 (#235)
LNS-002 (#231) ──┤                             ↑
                  └──→ LNS-003 (#232) ──────────┘
LNS-002 (#231) ──→ LNS-007 (#236)
LNS-003 (#232) ──→ LNS-007 (#236)

Done Criteria

• All 412+ existing tests still pass
• New tests for all lens functionality
• git mind view roadmap:incomplete works end-to-end
• JSON Schema contract validated in test/contracts.test.js
• Lens API exported from src/index.js

References

• Vision: docs/VISION_NORTH_STAR.md
• Architecture: docs/ARCHITECTURE.md
• Key files: src/views.js, bin/git-mind.js, src/cli/commands.js, src/cli/format.js