feat: import open Discussion Framework agendas into Works
Add deterministic preview and fingerprint-bound application for independent DF sources under an AIE umbrella. Preserve complete agendas and original evidence with source-scoped identities, validated receipts and safe retries. Publish prepared Works atomically, require review for changed imports and retain existing refinement without source edits or model calls. Advertise protocol contract 2 while continuing to read contract-1 projects. Add JVM, concurrency, recovery and native coverage; document usage and complete WRK-0007 with verification evidence.
This commit is contained in:
+16
-5
@@ -45,6 +45,7 @@ its explicit public API; implementation-only Git adapters live in `project.inter
|
||||
| discussion | Entries, topics, surveys, answer history and proposal dispositions | work, project, artifact, filesystem |
|
||||
| decision | Draft, approval, revision and supersession records | work, filesystem |
|
||||
| planning | Lightweight plans, dependencies, step results and revision history | work, decision, artifact, filesystem |
|
||||
| legacyimport | DF preview, original agenda evidence, provenance and prepared Work publication | filesystem, project, work, discussion, artifact |
|
||||
| artifact | Small evidence payloads and integrity metadata | work, filesystem |
|
||||
| agent | Adapter contract, deterministic fixtures, routing and proposal application | project, work, discussion, decision, planning, artifact, filesystem |
|
||||
| verification | Structural conformance, context, reviewed closure and deterministic EPIC coordination | all protocol modules |
|
||||
@@ -261,8 +262,18 @@ No legacy HTTP adapter, NDJSON global index, accepted-agenda gate, automatic hou
|
||||
deletion or Lesson model was retained. Work is the project-scoped aggregate; Discussion
|
||||
is refinement within a Work. Source repositories were not changed.
|
||||
|
||||
There is no automated legacy importer. Migration is deferred until the operational
|
||||
replacement is established. A future importer should create
|
||||
one Work per coherent agenda, retain original discussion/decision text with origin
|
||||
references, and verify identifiers and links before publication. Legacy Lessons should
|
||||
be reviewed for integration into canonical docs, not recreated as a required entity.
|
||||
The deterministic DF importer reads each independent source's NDJSON index and open
|
||||
AGDs. It creates one Work per source+DSC, retaining agenda Markdown as refinement
|
||||
NOTEs and original bytes as evidence. A versioned owned receipt links source IDs,
|
||||
DSCs, AGDs, target descriptions and generated AIE references; existing Work schemas
|
||||
and historical data remain unchanged. Receipt validation is available without the
|
||||
source directory and compatibility inspection recognizes the receipt format.
|
||||
|
||||
Work, Discussion and Artifact expose prepared publication helpers using their normal
|
||||
formats. The importer seeds a complete hidden Work folder before the normal atomic
|
||||
directory publication and monotonic ID reservation. Revalidation under the destination
|
||||
lock binds application to the preview fingerprint; immutable receipts make retry
|
||||
recognize already published Works. A multi-Work batch is deliberately not a global
|
||||
transaction. No legacy decision/Plan/Lesson is imported, source files are untouched
|
||||
and no agent adapter is involved. See [the import contract](discussion-import.md).
|
||||
Legacy Lessons remain candidates for manual integration into canonical docs.
|
||||
|
||||
Reference in New Issue
Block a user