SPEC-EVO-010 — Evolution Roadmap¶
Purpose¶
The roadmap sequences implementation so that derived capabilities never outrun canonical integrity.
Phase 0 — Specification lock¶
Deliver this specification family, identify unresolved decisions, and map every requirement to tests or future work items. No breaking repository migration is permitted in this phase.
Phase 1 — Research Space and registry¶
Add explicit space membership, deterministic registries, migration tooling, stale-index detection, and compatibility tests. Existing repositories MUST remain readable.
Phase 2 — Graph and structural queries¶
Implement typed edges, reverse indexes, path traversal, orphan and impact queries, and machine-readable QLQ output.
Phase 3 — Reasoning integrity¶
Add support-chain validation, competing hypothesis views, contradiction reports, and meaning-verification gates.
Phase 4 — NUR 2 read-only workspace¶
Release graph, timeline, evidence, and reasoning views without direct canonical editing. Preserve static rendering and the locked visual baseline.
Phase 5 — Governed write workflows¶
Introduce transactional edits, review bundles, patch approval, plugin write boundaries, and AI proposal workflows.
Phase 6 — Publishing and portable packs¶
Deliver publication manifests, multi-format exporters, redaction tests, and independently validatable knowledge packages.
Release gates¶
Each phase MUST satisfy:
- schema and contract compatibility review
- migration and rollback plan
- automated acceptance tests
- documentation and examples
- repository doctor checks
- no silent loss of history or provenance
Deferred decisions¶
Server synchronization, collaborative locking, access control, semantic embeddings, and hosted services remain outside the core roadmap until local repository behavior is stable.
Success condition¶
QLens succeeds when a researcher can inspect not only the current conclusion, but also the evidence, reasoning, alternatives, revisions, and repository state that produced it—without depending on a proprietary service.
Implementation status — QLens 4.0¶
| Phase | Status | Delivered capability |
|---|---|---|
| 0 | Complete | Normative specification family and compatibility boundary |
| 1 | Complete | Explicit Research Spaces, deterministic registries, stale detection |
| 2 | Complete | Typed graph, reverse traversal, shortest paths, impact and orphan analysis |
| 3 | Complete | Reasoning gates, hypothesis and contradiction reports |
| 4 | Complete | Read-only NUR 2 graph, timeline, backlink, health and contradiction views |
| 5 | Local-first complete | Staged proposals, reviewer decisions, atomic validated patches, transaction bundles |
| 6 | Local-first complete | Deterministic JSON/Markdown export, portable packs and package verification |
The deferred decisions remain deferred: server synchronization, collaborative locking, access control, semantic embeddings, and hosted services are not required for a trustworthy local repository.