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:
2026-11-16 14:53:05 +00:00
parent bc9fe8152c
commit 8f6cfa5d86
74 changed files with 3663 additions and 78 deletions
+16 -5
View File
@@ -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.