From 8f6cfa5d861fb0cb0c532091fabf49ade961c4e7 Mon Sep 17 00:00:00 2001 From: bQUARKz Date: Mon, 16 Nov 2026 14:53:05 +0000 Subject: [PATCH] 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. --- .ai-engineering/README.md | 16 +- .ai-engineering/protocol.json | 6 +- .../artifacts/evidence/ART-0007/artifact.yaml | 12 + .../artifacts/evidence/ART-0007/payload | 89 +++++ .../artifacts/evidence/ART-0008/artifact.yaml | 12 + .../artifacts/evidence/ART-0008/payload | 12 + .../artifacts/evidence/ART-0009/artifact.yaml | 13 + .../artifacts/evidence/ART-0009/payload | 26 ++ .../artifacts/evidence/ART-0010/artifact.yaml | 12 + .../artifacts/evidence/ART-0010/payload | 34 ++ .../artifacts/evidence/ART-0011/artifact.yaml | 12 + .../artifacts/evidence/ART-0011/payload | 45 +++ .../artifacts/evidence/ART-0012/artifact.yaml | 12 + .../artifacts/evidence/ART-0012/payload | 38 +++ .../artifacts/evidence/ART-0013/artifact.yaml | 12 + .../artifacts/evidence/ART-0013/payload | 13 + .../artifacts/evidence/ART-0014/artifact.yaml | 12 + .../artifacts/evidence/ART-0014/payload | 9 + .../artifacts/evidence/ART-0015/artifact.yaml | 12 + .../artifacts/evidence/ART-0015/payload | 43 +++ .../artifacts/evidence/ART-0016/artifact.yaml | 12 + .../artifacts/evidence/ART-0016/payload | 94 ++++++ .../artifacts/evidence/ART-0017/artifact.yaml | 12 + .../artifacts/evidence/ART-0017/payload | 10 + .../discussions/DSC-0012.md | 13 + .../discussions/DSC-0013.md | 13 + .../plans/.history/PLN-0001/r0007.md | 132 ++++++++ .../plans/.history/PLN-0001/r0008.md | 134 ++++++++ .../plans/.history/PLN-0001/r0009.md | 138 ++++++++ .../plans/.history/PLN-0001/r0010.md | 138 ++++++++ .../plans/.history/PLN-0001/r0011.md | 140 ++++++++ .../plans/.history/PLN-0001/r0012.md | 141 ++++++++ .../plans/.history/PLN-0001/r0013.md | 145 +++++++++ .../plans/.history/PLN-0001/r0014.md | 145 +++++++++ .../plans/.history/PLN-0001/r0015.md | 149 +++++++++ .../plans/.history/PLN-0001/r0016.md | 149 +++++++++ .../plans/.history/PLN-0001/r0017.md | 156 +++++++++ .../plans/.history/PLN-0001/r0018.md | 155 +++++++++ .../plans/.history/PLN-0001/r0019.md | 165 ++++++++++ .../plans/PLN-0001.md | 90 +++-- .../work.md | 75 ++++- README.md | 12 + docs/architecture.md | 21 +- docs/compatibility.md | 7 + docs/discussion-import.md | 94 ++++++ docs/protocol.md | 10 +- docs/roadmap.md | 11 +- scripts/native-smoke.sh | 41 ++- .../intrepid/aiengineering/NativeHints.java | 4 + .../artifact/ArtifactService.java | 20 +- .../aiengineering/cli/EngineeringCli.java | 44 +++ .../aiengineering/cli/package-info.java | 2 +- .../discussion/DiscussionService.java | 9 +- .../aiengineering/filesystem/Documents.java | 13 +- .../legacyimport/DiscussionImport.java | 59 ++++ .../legacyimport/DiscussionImportService.java | 307 ++++++++++++++++++ .../legacyimport/package-info.java | 2 + .../project/ProtocolContract.java | 4 +- .../aiengineering/project/ProtocolGuide.java | 3 +- .../verification/CompatibilityService.java | 10 +- .../verification/VerificationService.java | 1 + .../verification/package-info.java | 2 +- .../aiengineering/work/WorkService.java | 13 +- src/main/resources/protocol/README.md | 16 +- src/main/resources/protocol/protocol.json | 6 +- .../aiengineering/CompatibilityTest.java | 2 +- .../aiengineering/DiscussionImportTest.java | 269 +++++++++++++++ .../DiscussionImportRecoveryTest.java | 46 +++ .../alpha/discussion/index.ndjson | 3 + .../workflow/agendas/AGD-0001-transport.md | 28 ++ .../workflow/agendas/AGD-0002-accepted.md | 6 + .../workflow/agendas/AGD-0003-docs.md | 14 + .../beta/discussion/index.ndjson | 2 + .../workflow/agendas/AGD-0001-studio.md | 14 + 74 files changed, 3663 insertions(+), 78 deletions(-) create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0007/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0007/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0008/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0008/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0009/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0009/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0010/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0010/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0011/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0011/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0012/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0012/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0013/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0013/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0014/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0014/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0015/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0015/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0016/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0016/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0017/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0017/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0012.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0013.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0007.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0008.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0009.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0010.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0011.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0012.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0013.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0014.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0015.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0016.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0017.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0018.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0019.md create mode 100644 docs/discussion-import.md create mode 100644 src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImport.java create mode 100644 src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImportService.java create mode 100644 src/main/java/net/intrepid/aiengineering/legacyimport/package-info.java create mode 100644 src/test/java/net/intrepid/aiengineering/DiscussionImportTest.java create mode 100644 src/test/java/net/intrepid/aiengineering/legacyimport/DiscussionImportRecoveryTest.java create mode 100644 src/test/resources/discussion-import/alpha/discussion/index.ndjson create mode 100644 src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0001-transport.md create mode 100644 src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0002-accepted.md create mode 100644 src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0003-docs.md create mode 100644 src/test/resources/discussion-import/beta/discussion/index.ndjson create mode 100644 src/test/resources/discussion-import/beta/discussion/workflow/agendas/AGD-0001-studio.md diff --git a/.ai-engineering/README.md b/.ai-engineering/README.md index a5b66fc..4329947 100644 --- a/.ai-engineering/README.md +++ b/.ai-engineering/README.md @@ -58,6 +58,12 @@ public command, scope, preview, backups and repeatable execution. Do not invent migration or inspect AIE source code to discover consumer update procedures; report public-interface gaps with evidence instead. +The current entry contract is 2 and advertises DF open-agenda import. Contract 1 +projects remain readable without Work migration. An import-enabled manifest needs +contract 2 and the `discussion-import` capability; older CLIs must be updated before +reading it. Refresh entry files with `onboard` after compatibility inspection, +preserving historical Works and their approvals. + ## Topics, surveys and refinement Discussion remains the refinement space: receive ideas, organize topics, investigate, @@ -248,7 +254,15 @@ never confuse a historical report with a test run performed now. Update canonical code, tests, specs and documentation. There is no mandatory Lesson entity. `work archive` retains all files/history; `work reopen --by NAME --reason TEXT` allows new evidence and reorientation while retaining earlier completion records. -Never delete history as housekeeping. Importing legacy agendas/lessons is deferred. +Never delete history as housekeeping. `import discussion --source ID=PATH` previews +DF DSCs with AGDs open; repeat sources for a multi-project umbrella and use +`--target SOURCE=TEXT` for target descriptions. Apply only with `--apply --expect` +using the returned preview fingerprint. Source paths are caller-relative; source +IDs remain stable for reimport. Whole agenda text and original evidence are kept +in one OPEN Work per source+DSC, without LLM calls or source edits. Identical imports +are skipped and changed inputs require review without overwriting. Prepared Works +publish individually; after partial publication, preview again to resume without +duplicates. Closed agendas, DECs, Plans and Lessons are not imported. ## Portable files and errors diff --git a/.ai-engineering/protocol.json b/.ai-engineering/protocol.json index b704f6a..af949d9 100644 --- a/.ai-engineering/protocol.json +++ b/.ai-engineering/protocol.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "protocolVersion": 1, + "protocolVersion": 2, "protocol": "ai-engineering", "entrypoint": "README.md", "instructions": "AGENTS.md", @@ -9,8 +9,8 @@ "command": "ai-engineering", "aliases": ["aie"], "startup": ["status --format json", "next-actions --format json", "work context --format markdown"], - "capabilities": ["protocol-compatibility", "work", "discussion", "topics", "surveys", "answer-history", "proposal-dispositions", "fixture-adapters", "local-cli-adapters", "guided-agent-setup", "agent-doctor", "agent-routing", "run-provenance", "epic", "epic-policy-authorization", "epic-propagation", "epic-reconciliation", "decision-approval", "decision-history", "plan-decision-promotion", "planning", "step-dependencies", "evidence", "completion", "plan-consolidation", "cancelled-scope-review", "work-reconciliation", "archive", "reopen"], + "capabilities": ["protocol-compatibility", "work", "discussion", "topics", "surveys", "answer-history", "proposal-dispositions", "fixture-adapters", "local-cli-adapters", "guided-agent-setup", "agent-doctor", "agent-routing", "run-provenance", "epic", "epic-policy-authorization", "epic-propagation", "epic-reconciliation", "decision-approval", "decision-history", "plan-decision-promotion", "discussion-import", "import-preview", "import-provenance", "planning", "step-dependencies", "evidence", "completion", "plan-consolidation", "cancelled-scope-review", "work-reconciliation", "archive", "reopen"], "humanApproval": "explicit-attestation", "execution": "external-human-or-agent", - "legacyImport": false + "legacyImport": true } diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0007/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0007/artifact.yaml new file mode 100644 index 0000000..5559c2f --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0007/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0007" +workId: "WRK-0007" +origin: "Execução TSK-0001 em 2026-11-16" +purpose: "Contrato da implementação: interface, prévia/aplicação, identidade origem+DSC,\ + \ limites e retomada." +path: "artifacts/evidence/ART-0007/payload" +sha256: "e40103038b3acb6cfffa34363a4e77168344c2def2f2cf7b625b48591e074049" +size: 5335 +author: "codex" +createdAt: "2026-11-16T12:44:02.290554Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0007/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0007/payload new file mode 100644 index 0000000..270efcc --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0007/payload @@ -0,0 +1,89 @@ +# Discussion Framework import + +Import DSC discussions with open AGD agendas into the current AIE project. Each +source is an independent DF tree; the destination may be a plain project or an +umbrella containing several such projects. No model, source mutation, repository +registration, imported decision or imported execution plan is involved. + +## Commands + +```sh +aie import discussion --source runtime=../runtime --source studio=../studio \ + --target runtime=runtime --target runtime=docs --target studio=studio --format json +aie import discussion --source runtime=../runtime --source studio=../studio \ + --target runtime=runtime --target runtime=docs --target studio=studio \ + --apply --expect --author owner --format json +``` + +`--source ID=PATH` is repeatable and required. IDs follow AIE project identifier +rules and must remain stable across imports; paths resolve relative to the caller, +including when `--project` selects a different destination. A path may name the +source project or its existing `discussion/` directory. Duplicate IDs or roots in +one request are rejected. Source locations may move while keeping their identity. + +`--target SOURCE=TEXT` is repeatable. Targets are authored descriptions recorded +in the imported Work; they do not register or authorize repository edits. Without +an explicit target, the caller-supplied source ID identifies the project target. + +Without `--apply`, the command is read-only, including no destination locks or +backups. It reports each DSC, selected/ignored agendas, source paths and hashes, +existing Work, and an action: CREATE, UNCHANGED, REVIEW or SKIP. Invalid inputs +are diagnosed in the report. REVIEW and errors block the selected batch. + +`--apply` requires `--expect` from a valid preview. The sources and destination +import identities are read again under the destination lock; a changed preview +fingerprint is refused before allocation or publication. Publication rechecks the +captured source bytes before writing any Works. There is no automatic override +of REVIEW items; refine the inputs or review the existing Work explicitly. + +## Selection and preservation + +Read `discussion/index.ndjson`: first record `type=meta`, subsequent records +`type=discussion`. Select each DSC with at least one indexed AGD whose exact +status is `open`. Other nonblank states are ignored with a reason. The DSC's +aggregate status is not a substitute for the agenda status. An absent DEC is +normal. Historical closed agendas need not have files when they are not selected. + +Selected agenda files must have front matter whose ID and status agree with the +index. Missing/ambiguous references, duplicate DSC/AGD identities in one source, +invalid UTF-8, escaping paths, symlinked descendants or inconsistent selected data +block application. Unknown source metadata is retained in the original DSC record, +not inferred into new AIE semantics. The DF validator alone is not sufficient. + +One OPEN Work is created per source ID + DSC ID. Each selected AGD becomes a NOTE +in refinement with its complete original Markdown text, not a summary or parsed +set of human answers. Original agenda bytes and the original DSC index record +are owned ART evidence. A versioned import receipt, also owned evidence, links +source identity, DSC and AGD IDs, source hashes, targets, discussion IDs and ART IDs. +The source directory is an audit location, not the sole import identity. + +Limits: an index is at most 8 MiB, individual selected agendas and evidence are at +most 1 MiB, and captured source data per request is at most 32 MiB. Oversized data +is reported before publication. These are explicit limits, never truncation. + +## Reimport and failure recovery + +The same source ID + DSC with identical content and targets is UNCHANGED. It does +not add or rewrite Works, notes or evidence, including when the Work has since +been refined, completed or archived. New or changed source content for an existing +identity is REVIEW. No destination content is overwritten or deleted; a changed +agenda state never removes previously imported context. + +A Work and all its initial records are built in the existing hidden Work staging +area and published by one directory move using the normal Work ID sequence. +Readers do not see a half-seeded Work. A batch is not a global transaction: +an I/O failure or process interruption after one Work is published may leave that +Work imported. The error identifies published Works; a fresh preview recognizes +them as UNCHANGED and can continue the remaining items without duplication. +Unpublished hidden staging folders and reserved ID gaps may remain for deliberate +inspection; neither is interpreted as an imported discussion. + +Preview, apply and validation verify owned receipt integrity and references. +Refinement prose may evolve in the destination while the original evidence remains +intact. Conflicting import identities or corrupted receipts must be repaired +explicitly; no receipt, original evidence or historical Work is silently rewritten. + +Exit codes follow AIE: 0 for a valid preview/application, 2 for invalid command +arguments, 3 for a missing project/root, 4 for invalid/stale/review-required data, +and 1 for unexpected I/O failures. Diagnostics after partial publication retain +the normal failure code and identify the Work IDs already published. diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0008/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0008/artifact.yaml new file mode 100644 index 0000000..3ddc9a1 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0008/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0008" +workId: "WRK-0007" +origin: "Execução TSK-0001 em 2026-11-16" +purpose: "Fixtures alpha/beta válidas no validador DF original, com IDs coincidentes,\ + \ estados mistos e seis arquivos identificados por SHA-256." +path: "artifacts/evidence/ART-0008/payload" +sha256: "0b07a44575e09fcbe117100ac744f7313c5e10780fea840e398a13499ed340a9" +size: 1081 +author: "codex" +createdAt: "2026-11-16T12:44:02.580850Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0008/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0008/payload new file mode 100644 index 0000000..1e05f97 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0008/payload @@ -0,0 +1,12 @@ +{ + "sourceCommit": "658d58e864f3f990e3e2e9b42ebd1a083a1b2221", + "dfFixtureValidation": "passed for alpha and beta", + "files": { + "src/test/resources/discussion-import/alpha/discussion/index.ndjson": "9d02f9dbaacdba3002749adfdba080f03a94a6de1d547daf6526e1db075e7179", + "src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0001-transport.md": "c5dc5fd12387e96d3d1b6268ceffd981c84bd0502154f095dfa88df370fb2a54", + "src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0002-accepted.md": "11b9aa18a5596f556998072c865a5c551a4698115a15b2c4b6ffdbef01628854", + "src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0003-docs.md": "93fef233737f76e342f137771ba672eae9b0cc91ddddee76db64e3b31d13d685", + "src/test/resources/discussion-import/beta/discussion/index.ndjson": "52c92fc8e7607a66df5c15a67b0af8c6cf7816892bf44d80a3abd9d5a1f5504b", + "src/test/resources/discussion-import/beta/discussion/workflow/agendas/AGD-0001-studio.md": "4f050eebf3f772e20a27518ca27b004aa2143ba13b268e9cefac29ca5e102eb5" + } +} diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0009/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0009/artifact.yaml new file mode 100644 index 0000000..fb46311 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0009/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0009" +workId: "WRK-0007" +origin: "Implementação e testes focados WRK-0007 em 2026-11-16" +purpose: "Testes focados aprovados: importer, recuperação, compatibilidade e limites\ + \ de módulos, incluindo preservação Unicode/CRLF, byte budget, destino arquivado\ + \ e concorrência entre JVMs." +path: "artifacts/evidence/ART-0009/payload" +sha256: "a9340bd92a3f3b28f4f115deabd407b95e038ab9823f850f6175f40ae851985f" +size: 1169 +author: "codex" +createdAt: "2026-11-16T14:21:12.660286Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0009/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0009/payload new file mode 100644 index 0000000..48fc160 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0009/payload @@ -0,0 +1,26 @@ +> Task :compileJava UP-TO-DATE +> Task :processResources UP-TO-DATE +> Task :classes UP-TO-DATE +> Task :resolveMainClassName UP-TO-DATE +> Task :processAot UP-TO-DATE +> Task :compileAotJava UP-TO-DATE +> Task :processAotResources UP-TO-DATE +> Task :aotClasses UP-TO-DATE +> Task :collectReachabilityMetadata UP-TO-DATE +> Task :bootJar UP-TO-DATE +> Task :compileTestJava +> Task :processTestResources UP-TO-DATE +> Task :testClasses + +> Task :processTestAot +14:10:53.485 [main] INFO org.springframework.test.context.aot.TestClassScanner -- Scanning for Spring test classes in all packages in classpath roots [/Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/resources/test, /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/classes/java/test] + +> Task :compileAotTestJava UP-TO-DATE +> Task :processAotTestResources UP-TO-DATE +> Task :aotTestClasses UP-TO-DATE +> Task :test +> Task :jacocoTestReport + +BUILD SUCCESSFUL in 17s +15 actionable tasks: 4 executed, 11 up-to-date +Consider enabling configuration cache to speed up this build: https://docs.gradle.org/9.3.1/userguide/configuration_cache_enabling.html diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0010/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0010/artifact.yaml new file mode 100644 index 0000000..d77d4f7 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0010/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0010" +workId: "WRK-0007" +origin: "Implementação e testes focados WRK-0007 em 2026-11-16" +purpose: "Revisão Git e hashes SHA-256 dos arquivos de implementação, fixtures e documentaç\ + ão do importer." +path: "artifacts/evidence/ART-0010/payload" +sha256: "4bba41fc0715b170868956fae61be92f2d66c41432d5ff7799e8ee1d97405007" +size: 4017 +author: "codex" +createdAt: "2026-11-16T14:21:13.172988Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0010/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0010/payload new file mode 100644 index 0000000..43a5387 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0010/payload @@ -0,0 +1,34 @@ +{ + "head": "3d2abb487fc2b58c33fc96118f34f4d991701d0c", + "files": { + "README.md": "7fcc62503cc2c6bdf4d808f12163ce8d1dda65c8012afdcabc73bac376046700", + "docs/architecture.md": "d59eae0fbf789e00e99552631438cc5d9acdfeba29aa7cfc494e78fd9ce1020f", + "docs/discussion-import.md": "e40103038b3acb6cfffa34363a4e77168344c2def2f2cf7b625b48591e074049", + "docs/protocol.md": "4e2372bb1ed617daf52620e5599fbd507f72ab922a621339e16a54d00b9742e5", + "docs/roadmap.md": "dfc1f747156e77a835e9d59c976c542eb642261a2632d93b939b8774083822f2", + "scripts/native-smoke.sh": "4b2272b3f5acec47ddb10dc4f61bc1dc26509a8bb195a98eb0c37037ad73cb09", + "src/main/java/net/intrepid/aiengineering/NativeHints.java": "ccfed90adcbbf03ec6efe0353a09a05ebcf3f05521b14799dbe193edfd254d98", + "src/main/java/net/intrepid/aiengineering/artifact/ArtifactService.java": "d957ca514724a5f5484677b4f554ede0444efc03ac5cfb2bb8e5f85d0b0f8237", + "src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java": "b3ae530f2b0fdfd05b73079ae88f646a4f5f09e469bee188d17f9e2119351f0e", + "src/main/java/net/intrepid/aiengineering/cli/package-info.java": "0b107f165b772d3f6636b9f2d2e16f05058175d1fea88b6577b339d1467a9f91", + "src/main/java/net/intrepid/aiengineering/discussion/DiscussionService.java": "caec7e2e3cd41da60114a3d87bb072bb7d2339bbe381e688e04f9ffc9612fbc1", + "src/main/java/net/intrepid/aiengineering/filesystem/Documents.java": "670cc9bcb1b64c12603a650fe45c792efc338ef35a3c6527b252e62e6663c715", + "src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImport.java": "5c80897ab540fdfd7c72ab1de5222486d13d1aba6b94a2a072daafd6f853e5cd", + "src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImportService.java": "a8fd691fb801144a852e0e0e42eb425b520a100aaa66ee20331004511790845c", + "src/main/java/net/intrepid/aiengineering/legacyimport/package-info.java": "beeeeb33698d9f0abcddeb40ef2756537aed86cce689245bf68f55d95c582a10", + "src/main/java/net/intrepid/aiengineering/verification/CompatibilityService.java": "1c39ed6d9d8369d53aa917f2389fd9aec3c1330c9470eff5ecd871612b697187", + "src/main/java/net/intrepid/aiengineering/verification/VerificationService.java": "85f325a366745398a1544faab01620e33825e2b1df5ea8cf8edfefa0d77c81e2", + "src/main/java/net/intrepid/aiengineering/verification/package-info.java": "43eda7157d9bc4bcdc7926c1a161fde4e4ce90271b77270bf86307ec52d37bff", + "src/main/java/net/intrepid/aiengineering/work/WorkService.java": "c3a783df521b4dce3a3517036c78075e7f6735cd97ced56aa3adb72bbf31f6e0", + "src/main/resources/protocol/README.md": "9688c6549a399a0f0d24e21bea612f5bbb6f9a47d76e9e2be7f26fe10bfcee5a", + "src/main/resources/protocol/protocol.json": "bd1c8985d92ab819f5478bbd475ca7cbeadaf6544ff4f8cfd9aedaf83e0b024c", + "src/test/java/net/intrepid/aiengineering/DiscussionImportTest.java": "18fd8a79bc8ba78ecd74d5bbb579dd2a729a04f51b76935977d210153061f9b7", + "src/test/java/net/intrepid/aiengineering/legacyimport/DiscussionImportRecoveryTest.java": "6121dbb8b3b5b5bcc3d083322d9c61679557146c8c68763f0743356607070fc0", + "src/test/resources/discussion-import/alpha/discussion/index.ndjson": "9d02f9dbaacdba3002749adfdba080f03a94a6de1d547daf6526e1db075e7179", + "src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0001-transport.md": "c5dc5fd12387e96d3d1b6268ceffd981c84bd0502154f095dfa88df370fb2a54", + "src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0002-accepted.md": "11b9aa18a5596f556998072c865a5c551a4698115a15b2c4b6ffdbef01628854", + "src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0003-docs.md": "93fef233737f76e342f137771ba672eae9b0cc91ddddee76db64e3b31d13d685", + "src/test/resources/discussion-import/beta/discussion/index.ndjson": "52c92fc8e7607a66df5c15a67b0af8c6cf7816892bf44d80a3abd9d5a1f5504b", + "src/test/resources/discussion-import/beta/discussion/workflow/agendas/AGD-0001-studio.md": "4f050eebf3f772e20a27518ca27b004aa2143ba13b268e9cefac29ca5e102eb5" + } +} diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0011/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0011/artifact.yaml new file mode 100644 index 0000000..f9e7b85 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0011/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0011" +workId: "WRK-0007" +origin: "Entrega final WRK-0007 em 2026-11-16" +purpose: "Verificação final com contrato 2: Gradle check, 151 testes, AOT/JAR e distribuiç\ + ão nativa macOS ARM64 ZIP/TAR aprovados." +path: "artifacts/evidence/ART-0011/payload" +sha256: "e58d106ad4c4caab418e66b405c5f5a20c5666215e1e66c8d7ab551a0c20bc1c" +size: 2022 +author: "codex" +createdAt: "2026-11-16T14:45:28.901277Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0011/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0011/payload new file mode 100644 index 0000000..b4ce147 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0011/payload @@ -0,0 +1,45 @@ + +> Task :jenkinsPipelineTest +Jenkins pipeline fixture passed: 11 success/failure scenarios (no controller or plugins invoked). + +> Task :compileJava +> Task :processResources +> Task :classes +> Task :resolveMainClassName +> Task :processAot +> Task :compileAotJava UP-TO-DATE +> Task :processAotResources UP-TO-DATE +> Task :aotClasses UP-TO-DATE +> Task :collectReachabilityMetadata UP-TO-DATE +> Task :bootJar +> Task :jar +> Task :compileTestJava +> Task :processTestResources UP-TO-DATE +> Task :testClasses + +> Task :processTestAot +14:33:48.639 [main] INFO org.springframework.test.context.aot.TestClassScanner -- Scanning for Spring test classes in all packages in classpath roots [/Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/resources/test, /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/classes/java/test] + +> Task :compileAotTestJava UP-TO-DATE +> Task :processAotTestResources UP-TO-DATE +> Task :aotTestClasses UP-TO-DATE +> Task :test +> Task :check + +> Task :generateResourcesConfigFile +[native-image-plugin] Resources configuration written into /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/generated/generateResourcesConfigFile/resource-config.json + +> Task :jacocoTestReport + +> Task :nativeCompile +[native-image-plugin] GraalVM Toolchain detection is disabled +[native-image-plugin] GraalVM location read from environment variable: GRAALVM_HOME +[native-image-plugin] Native Image executable path: /Users/niltonconstantino/.sdkman/candidates/java/25.5.5.0+3-graalce/lib/svm/bin/native-image +[native-image-plugin] Native Image written to: /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile + +> Task :nativeDistZip +> Task :nativeDistTar + +BUILD SUCCESSFUL in 6m 24s +21 actionable tasks: 15 executed, 6 up-to-date +Consider enabling configuration cache to speed up this build: https://docs.gradle.org/9.3.1/userguide/configuration_cache_enabling.html diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0012/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0012/artifact.yaml new file mode 100644 index 0000000..a831e76 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0012/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0012" +workId: "WRK-0007" +origin: "Entrega final WRK-0007 em 2026-11-16" +purpose: "Hashes finais de 33 arquivos de código, fixtures, documentação e contrato\ + \ que compõem a versão verificada." +path: "artifacts/evidence/ART-0012/payload" +sha256: "a0454cc3123f1d9f1a9ef61c9f2f1d24fca56700663fa65a03c07470f33faf75" +size: 4542 +author: "codex" +createdAt: "2026-11-16T14:45:29.160298Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0012/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0012/payload new file mode 100644 index 0000000..c2dd391 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0012/payload @@ -0,0 +1,38 @@ +{ + "head": "3d2abb487fc2b58c33fc96118f34f4d991701d0c", + "files": { + "README.md": "7fcc62503cc2c6bdf4d808f12163ce8d1dda65c8012afdcabc73bac376046700", + "docs/architecture.md": "d59eae0fbf789e00e99552631438cc5d9acdfeba29aa7cfc494e78fd9ce1020f", + "docs/compatibility.md": "3a081f9b47dfc114dc5262a432d5211df4ff1581e7bd1896e3771d58f6acbc5f", + "docs/discussion-import.md": "6c057e517951978533f22b5dd90e8062a84391b1266ee4f885909878655b06a8", + "docs/protocol.md": "4e2372bb1ed617daf52620e5599fbd507f72ab922a621339e16a54d00b9742e5", + "docs/roadmap.md": "dfc1f747156e77a835e9d59c976c542eb642261a2632d93b939b8774083822f2", + "scripts/native-smoke.sh": "45633360f7ff6c15e38c72f7d6eead286823e2746bf19c36cf3657dfeb5abc0a", + "src/main/java/net/intrepid/aiengineering/NativeHints.java": "ccfed90adcbbf03ec6efe0353a09a05ebcf3f05521b14799dbe193edfd254d98", + "src/main/java/net/intrepid/aiengineering/artifact/ArtifactService.java": "d957ca514724a5f5484677b4f554ede0444efc03ac5cfb2bb8e5f85d0b0f8237", + "src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java": "b3ae530f2b0fdfd05b73079ae88f646a4f5f09e469bee188d17f9e2119351f0e", + "src/main/java/net/intrepid/aiengineering/cli/package-info.java": "0b107f165b772d3f6636b9f2d2e16f05058175d1fea88b6577b339d1467a9f91", + "src/main/java/net/intrepid/aiengineering/discussion/DiscussionService.java": "caec7e2e3cd41da60114a3d87bb072bb7d2339bbe381e688e04f9ffc9612fbc1", + "src/main/java/net/intrepid/aiengineering/filesystem/Documents.java": "670cc9bcb1b64c12603a650fe45c792efc338ef35a3c6527b252e62e6663c715", + "src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImport.java": "5c80897ab540fdfd7c72ab1de5222486d13d1aba6b94a2a072daafd6f853e5cd", + "src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImportService.java": "a8fd691fb801144a852e0e0e42eb425b520a100aaa66ee20331004511790845c", + "src/main/java/net/intrepid/aiengineering/legacyimport/package-info.java": "beeeeb33698d9f0abcddeb40ef2756537aed86cce689245bf68f55d95c582a10", + "src/main/java/net/intrepid/aiengineering/project/ProtocolContract.java": "98253a17f97ef96163ea3ae9c333515da8031969629d083a80cadd5d9bec3f22", + "src/main/java/net/intrepid/aiengineering/project/ProtocolGuide.java": "de6962cb7516c95ee5164d9d28e22b2d28fb3414ede8efad443f67ec59eafbdd", + "src/main/java/net/intrepid/aiengineering/verification/CompatibilityService.java": "1c39ed6d9d8369d53aa917f2389fd9aec3c1330c9470eff5ecd871612b697187", + "src/main/java/net/intrepid/aiengineering/verification/VerificationService.java": "85f325a366745398a1544faab01620e33825e2b1df5ea8cf8edfefa0d77c81e2", + "src/main/java/net/intrepid/aiengineering/verification/package-info.java": "43eda7157d9bc4bcdc7926c1a161fde4e4ce90271b77270bf86307ec52d37bff", + "src/main/java/net/intrepid/aiengineering/work/WorkService.java": "c3a783df521b4dce3a3517036c78075e7f6735cd97ced56aa3adb72bbf31f6e0", + "src/main/resources/protocol/README.md": "18a877a5a9337a45d2c3398fc89f464135b6f98921f68634b247bd66d98dd387", + "src/main/resources/protocol/protocol.json": "e1bfda06b6a52f285e72daddbe854ac21a82aee3a3c189b448e654ecca94ff0a", + "src/test/java/net/intrepid/aiengineering/CompatibilityTest.java": "0c6c7adf4f30eb9463be271f5bd99451ce7edab0110bf280711502e12bece983", + "src/test/java/net/intrepid/aiengineering/DiscussionImportTest.java": "f3179d805459354655bbbba6af168fe29a91d711cc36f2b3ddf1d1d078d99a12", + "src/test/java/net/intrepid/aiengineering/legacyimport/DiscussionImportRecoveryTest.java": "6121dbb8b3b5b5bcc3d083322d9c61679557146c8c68763f0743356607070fc0", + "src/test/resources/discussion-import/alpha/discussion/index.ndjson": "9d02f9dbaacdba3002749adfdba080f03a94a6de1d547daf6526e1db075e7179", + "src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0001-transport.md": "c5dc5fd12387e96d3d1b6268ceffd981c84bd0502154f095dfa88df370fb2a54", + "src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0002-accepted.md": "11b9aa18a5596f556998072c865a5c551a4698115a15b2c4b6ffdbef01628854", + "src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0003-docs.md": "93fef233737f76e342f137771ba672eae9b0cc91ddddee76db64e3b31d13d685", + "src/test/resources/discussion-import/beta/discussion/index.ndjson": "52c92fc8e7607a66df5c15a67b0af8c6cf7816892bf44d80a3abd9d5a1f5504b", + "src/test/resources/discussion-import/beta/discussion/workflow/agendas/AGD-0001-studio.md": "4f050eebf3f772e20a27518ca27b004aa2143ba13b268e9cefac29ca5e102eb5" + } +} diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0013/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0013/artifact.yaml new file mode 100644 index 0000000..742315f --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0013/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0013" +workId: "WRK-0007" +origin: "Entrega final WRK-0007 em 2026-11-16" +purpose: "Paridade byte a byte de JSON JVM/nativo, prévia sem alterações, publicaç\ + ão/retentativa nativa, fontes intactas e recusa de contrato 2 por leitor 1 sem sobrescrita." +path: "artifacts/evidence/ART-0013/payload" +sha256: "a387b7cb627b77266f3aa3d85c50248784ca4bc5072127048ec88ff32e536907" +size: 412 +author: "codex" +createdAt: "2026-11-16T14:45:29.429997Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0013/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0013/payload new file mode 100644 index 0000000..5de5436 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0013/payload @@ -0,0 +1,13 @@ +{ + "previewJsonByteIdentical": true, + "reimportJsonByteIdentical": true, + "previewReadOnly": true, + "publishedWorks": { + "alpha:DSC-0001": "WRK-0001", + "beta:DSC-0001": "WRK-0002" + }, + "nativeRetryByteIdentical": true, + "sourcesUnchanged": true, + "oldReaderRefusesContract2WithoutWrites": true, + "fixtureDirectory": "/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/wrk7-import-parity-dxgbyaay" +} diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0014/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0014/artifact.yaml new file mode 100644 index 0000000..418d5c9 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0014/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0014" +workId: "WRK-0007" +origin: "Verificação final WRK-0007 em 2026-11-16" +purpose: "Smoke nativo completo aprovado: importer e todos os fluxos anteriores, incluindo\ + \ o cenário de umbrella sem Git/JVM/modelos." +path: "artifacts/evidence/ART-0014/payload" +sha256: "8eda7a55c457f8d0ec0df4096c0f965237970e1ec88690636e38f51ef6ff33a8" +size: 1021 +author: "codex" +createdAt: "2026-11-16T14:48:45.557621Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0014/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0014/payload new file mode 100644 index 0000000..b26f569 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0014/payload @@ -0,0 +1,9 @@ +Native DF import smoke passed (umbrella, open agendas, original content, preview, provenance and no-op reimport; no Git/JVM/models). +Native simple-project continuity smoke passed (without Git and with one root repository). +Native hexadecimal Work identifiers and legacy reservations smoke passed. +Native refinement smoke passed (topics, surveys, revised answers, two fixtures, dispositions, draft DEC, idempotency and staleness). +Native local-CLI transport smoke passed (controlled subprocess fixtures, guided setup, routing, provenance, replay and reload without JVM/models). +Native EPIC smoke passed (delegation, important/cancelled/optional children, system receipts, reopen, replay, decomposition and nested context). +Native multi-repository continuity smoke passed. +Native operational-cycle smoke passed (discovery, approval, plan, evidence, completion, archive and reopening). +Native Plan consolidation smoke passed (multiple Plans, reviewed cancellation, system completion and fresh-process replay; no model/JVM). diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0015/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0015/artifact.yaml new file mode 100644 index 0000000..2967479 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0015/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0015" +workId: "WRK-0007" +origin: "Verificação final WRK-0007 em 2026-11-16" +purpose: "Resumo final: 151 testes, quinze novos casos, hashes de binários, paridade\ + \ JVM/nativo, recusa pelo leitor antigo e 362 arquivos históricos preservados." +path: "artifacts/evidence/ART-0015/payload" +sha256: "755fb479039ae897fa96d3d716faa96ce10a5326010773004e290e8140e02371" +size: 1400 +author: "codex" +createdAt: "2026-11-16T14:48:45.828350Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0015/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0015/payload new file mode 100644 index 0000000..a4c8e6c --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0015/payload @@ -0,0 +1,43 @@ +{ + "tests": { + "tests": 151, + "failures": 0, + "errors": 0, + "skipped": 0 + }, + "newImporterTests": 15, + "jenkinsFixtureScenarios": 11, + "testedPlatform": "macOS ARM64", + "sourceFilesVerified": 33, + "otherWorkFilesUnchanged": 362, + "nativeSmokeExit": 0, + "fullBuildExit": 0, + "parity": { + "previewJsonByteIdentical": true, + "reimportJsonByteIdentical": true, + "previewReadOnly": true, + "publishedWorks": { + "alpha:DSC-0001": "WRK-0001", + "beta:DSC-0001": "WRK-0002" + }, + "nativeRetryByteIdentical": true, + "sourcesUnchanged": true, + "oldReaderRefusesContract2WithoutWrites": true, + "fixtureDirectory": "/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/wrk7-import-parity-dxgbyaay" + }, + "binaries": { + "build/native/nativeCompile/ai-engineering": "11598f57a332571caa95c44d8808742a793f80f4cb95bd25a37045bee8f2d596", + "build/libs/ai-engineering-0.1.0.jar": "bdbca3912a976ecf6d7bdcaed1bcb93ffb490c87cf1b5b9a8ea2a43bfa4a9724", + "build/distributions/ai-engineering-0.1.0-mac-os-x-aarch64.tar.gz": "2f6f2fdbcc5a0098f0e10900db6aaf5b86e131a41a508a892675f4180f413bdb", + "build/distributions/ai-engineering-0.1.0-mac-os-x-aarch64.zip": "ea00f0c32efd816ee744ab256a0f66095fbf21232a8184dced186d6b77ca2c18" + }, + "projectValidation": { + "valid": true, + "issues": [] + }, + "entryContract": 2, + "readableContracts": [ + 1, + 2 + ] +} diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0016/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0016/artifact.yaml new file mode 100644 index 0000000..842b6e1 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0016/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0016" +workId: "WRK-0007" +origin: "Verificação final WRK-0007 em 2026-11-16" +purpose: "Relatório final do importer: uso, comportamento entregue, integridade, contrato\ + \ 2, verificações e limites reais." +path: "artifacts/evidence/ART-0016/payload" +sha256: "788c35642013a0536e63854b1945b1490f413bfa4c5566164aff4eef2843cf3e" +size: 5898 +author: "codex" +createdAt: "2026-11-16T14:48:46.097861Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0016/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0016/payload new file mode 100644 index 0000000..6372041 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0016/payload @@ -0,0 +1,94 @@ +# WRK-0007 — importer de DSCs com agendas abertas + +## Entrega + +Implementado `aie import discussion`: uma origem DF simples ou várias árvores +independentes sob uma umbrella AIE. A seleção usa o estado open das AGDs. Cada +origem+DSC com agendas abertas gera um Work OPEN; agendas em outros estados e +DSCs sem agendas abertas ficam fora, com motivos apresentados na prévia. + +Cada agenda selecionada mantém seu Markdown integral como NOTE no refinamento e +seus bytes originais como evidência. O registro JSON original da DSC também é +preservado, incluindo metadados desconhecidos. Targets são descritos no Work a +partir da associação explícita de origens/targets. Não são importados DECs, +Plans, aprovações, respostas humanas, conclusões de entrega ou Lessons. + +Um recibo versionado, como evidência de propriedade do Work, liga origem, DSC, +AGDs, hashes, targets, entradas e evidências AIE. A identidade independe do caminho +físico atual da origem. Registros Work existentes mantêm o mesmo schema. + +## Uso + +```sh +aie import discussion --source runtime=../runtime --source studio=../studio \ + --target runtime=runtime --target runtime=docs --target studio=studio --format json +aie import discussion --source runtime=../runtime --source studio=../studio \ + --target runtime=runtime --target runtime=docs --target studio=studio \ + --apply --expect --format json +``` + +A prévia não grava arquivos nem obtém locks. A aplicação exige o fingerprint e +revalida os dados sob o lock do destino antes de publicar. Importações idênticas +são no-op, inclusive após refinamento, conclusão ou arquivo no AIE. Mudanças na +origem ou nos targets são reportadas para revisão sem sobrescrita ou exclusão. + +## Publicação, integridade e limites + +O Work completo é montado em staging usando os formatos normais de Work, +Discussion e Artifact e então publicado por movimento atômico de diretório. +Um lote não é uma transação global: a interrupção após o primeiro Work pode +manter esse Work publicado. Uma nova prévia identifica o publicado como UNCHANGED +e continua os itens restantes sem duplicação. Staging oculto não publicado e +lacunas na sequência podem permanecer para inspeção; dados canônicos anteriores +não são removidos na retomada. + +A validação cobre recibos, referências, hashes, metadados índice/Markdown, +duplicatas, caminhos, symlinks descendentes, UTF-8 e limites de tamanho. Os limites +explícitos são 8 MiB por índice, 1 MiB por agenda/evidência e 32 MiB capturados por +requisição, sem truncamento. O estado agregado da DSC não substitui o estado da +agenda; uma DSC terminal contradizendo AGD open é reportada como erro. + +## Compatibilidade + +O contrato de entrada 2 anuncia a capability; a CLI continua lendo o contrato 1. +Manifestos com import habilitado exigem contrato 2 e `discussion-import`. Isso +permite a uma CLI antiga recusar a versão antes de `onboard` sobrescrever a entrada. +A atualização do contrato não migra Works históricos, suas aprovações ou payloads. + +Durante a verificação ampla foi identificada e corrigida a restrição antiga do +leitor que recusava qualquer legacyImport=true. A versão final inclui regressão +para anúncios suportados, contrato 1 legível e anúncio inconsistente inválido. + +## Evidências de execução + +- Gradle check: 151 testes sem falhas/erros/skips, incluindo quinze casos novos do importer e onze cenários da fixture Jenkins. +- GraalVM instalado: processAot/bootJar, nativeCompile, nativeDistZip e nativeDistTar aprovados. +- Smoke nativo completo aprovado, incluindo umbrella DF, agendas abertas, originais, prévia e reimportação, sem Git/JVM/modelos nos cenários apropriados. +- JSON de prévia e reimportação idêntico byte a byte em JVM e nativo; prévia sem alterações e retentativa nativa sem modificar Works existentes. +- Leitor do contrato 1 diagnostica UNSUPPORTED e recusa onboard do contrato 2 sem alterar o projeto descartável. +- Após diagnóstico LEGACY_COMPATIBLE, onboard atualizou as instruções do workspace para contrato 2 com backups; validação de projeto aprovada. Os 362 arquivos de outros Works permaneceram byte a byte idênticos. +- Os 33 arquivos finais de fonte, fixtures e documentação continuam idênticos aos hashes da versão compilada. Binário/JAR/ZIP/TAR identificados por SHA-256 no resumo JSON. +- git diff --check passou. Distribuição testada apenas em macOS ARM64. + +As verificações usam exclusivamente fixtures descartáveis. A fixture alpha contém +agendas abertas e aceitas na mesma DSC e uma DSC encerrada com arquivo já removido; +beta repete IDs locais em uma origem independente. As duas foram validadas com o +validador DF original sem alterar o repositório de origem. + +Os testes novos incluem prévia sem lock, Unicode/CRLF, originais e contexto, +mudanças e reimportação, origem movida, destino concluído/arquivado, preview obsoleto, +lote inválido sem alocação, paths/symlinks, recibo inválido e versão futura, +limites agregados, política de leitura, cwd externo/--project, duas JVMs concorrentes +e interrupção depois da publicação do primeiro Work com retomada sem reescrita. + +## Integração e limites da entrega + +Atualizados CLI/help, leitor/publicador, publicação preparada dos serviços, +validação/compatibilidade, NativeHints, README, contrato do importer, arquitetura, +roadmap, instruções portáteis e smoke nativo. Os hashes finais das fontes e binários +permitem conferir o estado verificado sem depender de um commit inexistente. + +Não foi realizada importação em nenhum projeto consumidor real. Nenhum código +Python ou dependência do DF foi copiado. Não há chamada a LLM, alteração em arquivos +DF de origem ou migração implícita de Works históricos. Não houve commit ou push +nesta implementação; o estado fica pronto para revisão do usuário. diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0017/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0017/artifact.yaml new file mode 100644 index 0000000..4c61926 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0017/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0017" +workId: "WRK-0007" +origin: "ai-engineering:plans:657c2bdf56d508c302bf1a2e19e94de8e511b82aed33383d8cb0a57df8f06ed4" +purpose: "Deterministic aggregation of completed Plans and reviewed cancellations;\ + \ not semantic verification of prose criteria" +path: "artifacts/evidence/ART-0017/payload" +sha256: "657c2bdf56d508c302bf1a2e19e94de8e511b82aed33383d8cb0a57df8f06ed4" +size: 284 +author: "system:plans" +createdAt: "2026-11-16T14:48:58.837303Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0017/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0017/payload new file mode 100644 index 0000000..be46a5f --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0017/payload @@ -0,0 +1,10 @@ +{ + "schemaVersion" : 1, + "workId" : "WRK-0007", + "inputHash" : "5d44de8fb24111ba741d65ab7d5ab5ae8e7dccee4d7d65c42e3dffb9c5db748c", + "plans" : [ { + "id" : "PLN-0001", + "revision" : 20, + "sha256" : "8361eca97aa7c107e3ccda8e71d473e9fa670aa9c7e99e5b69628ef31fa6424f" + } ] +} diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0012.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0012.md new file mode 100644 index 0000000..3c7290b --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0012.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0012" +workId: "WRK-0007" +discussionId: "main" +kind: "NOTE" +author: "user" +createdAt: "2026-11-16T12:43:12.914916Z" +respondsTo: null +documentVersion: 2 +--- + +vamos impl o plan do w7 \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0013.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0013.md new file mode 100644 index 0000000..16ffaff --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0013.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0013" +workId: "WRK-0007" +discussionId: "main" +kind: "CONCLUSION" +author: "codex" +createdAt: "2026-11-16T14:48:46.366331Z" +respondsTo: null +documentVersion: 2 +--- + +DEC-0001 e PLN-0001 implementados. CLI import discussion seleciona DSCs com AGDs open, preserva Markdown integral como NOTE, originais e registro DSC como evidência e um recibo de identidade/proveniência. Prévia é somente leitura; aplicação exige fingerprint e lock; reimportação idêntica é no-op e mudanças exigem revisão sem sobrescrever. Work completo publica por staging; interrupção entre Works retoma sem duplicação. Contrato 2 anuncia a capability e mantém leitura do contrato 1, sem migração histórica. ART-0011 a ART-0016 preservam build, fontes finais, paridade, smoke e relatório. Resultado: 151 testes, quinze cenários novos, onze fixtures Jenkins, JAR/AOT, binário e ZIP/TAR macOS ARM64, smoke completo e paridade JSON JVM/nativo aprovados. Leitor contrato 1 recusa contrato 2 sem writes. Onboard atualizou somente a entrada com backups e preservou 362 arquivos de outros Works. Nenhum consumidor real foi importado; fonte DF original não foi alterada; não há chamadas a LLM nem commit/push nesta implementação. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0007.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0007.md new file mode 100644 index 0000000..840d5e3 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0007.md @@ -0,0 +1,132 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:40.803688Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:45.347282Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:51.505506Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:57.703190Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 7 +previousHash: "cddadab736f1f0991adc0984175a69b0df5c5341cc76b2d3771238436bce2ac6" +updatedAt: "2026-11-16T11:45:11.634905Z" +updatedBy: "codex" +changeReason: "Decomposição da DEC-0001 aceita pelo usuário." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0008.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0008.md new file mode 100644 index 0000000..b93e8b9 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0008.md @@ -0,0 +1,134 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "ACTIVE" + result: "Iniciar implementação autorizada: contrato público, proveniência e fixtures\ + \ de uma origem e umbrella." + evidence: [] + updatedAt: "2026-11-16T12:43:16.952562Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:45.347282Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:51.505506Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:57.703190Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 8 +previousHash: "2ba7f5a00928d67a25c57cfee076f72811442aecf37428c5dd3d048dcc421bad" +updatedAt: "2026-11-16T12:43:16.952652Z" +updatedBy: "codex" +changeReason: "Iniciar implementação autorizada: contrato público, proveniência e\ + \ fixtures de uma origem e umbrella." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0009.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0009.md new file mode 100644 index 0000000..96fdd74 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0009.md @@ -0,0 +1,138 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:45.347282Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:51.505506Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:57.703190Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 9 +previousHash: "8a1492acce57762a7f38eae5c0c06b594c248878c2e6d16a4901fb3cfbae0b99" +updatedAt: "2026-11-16T12:44:03.673481Z" +updatedBy: "codex" +changeReason: "Contrato de entrada/proveniência/erros/retomada definido; fixtures\ + \ simples e umbrella com estados mistos e IDs coincidentes passaram no validador\ + \ DF original, sem alterar a origem ou Works históricos." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0010.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0010.md new file mode 100644 index 0000000..19ca52f --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0010.md @@ -0,0 +1,138 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "ACTIVE" + result: "Implementar leitura limitada, seleção por AGD e relatório determinístico\ + \ sem gravações." + evidence: [] + updatedAt: "2026-11-16T12:44:10.603737Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:51.505506Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:57.703190Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 10 +previousHash: "a23c59b12b5bdd235391ca5b43f6421cae0509659b018369d0b80815ca2d3d23" +updatedAt: "2026-11-16T12:44:10.603806Z" +updatedBy: "codex" +changeReason: "Implementar leitura limitada, seleção por AGD e relatório determiní\ + stico sem gravações." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0011.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0011.md new file mode 100644 index 0000000..9e2f162 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0011.md @@ -0,0 +1,140 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:51.505506Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:57.703190Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 11 +previousHash: "593fb1d07bfe57b3b2c00ffd92d86fd44bca31fb4efa2c512a8ca64249023baa" +updatedAt: "2026-11-16T14:21:14.454619Z" +updatedBy: "codex" +changeReason: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0012.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0012.md new file mode 100644 index 0000000..9043cc8 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0012.md @@ -0,0 +1,141 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "ACTIVE" + result: "Validar publicação preparada, evidência original e proveniência com as\ + \ fixtures executadas." + evidence: [] + updatedAt: "2026-11-16T14:21:22.303211Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:57.703190Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 12 +previousHash: "33f04c919d7a6e51a91eb09459a5c753101afec50374ad9fcc43a91e361379ac" +updatedAt: "2026-11-16T14:21:22.303269Z" +updatedBy: "codex" +changeReason: "Validar publicação preparada, evidência original e proveniência com\ + \ as fixtures executadas." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0013.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0013.md new file mode 100644 index 0000000..2afbb82 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0013.md @@ -0,0 +1,145 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Publicação atômica por Work montado em staging implementada com serviç\ + os normais; conteúdo integral, targets e originais passam em testes e validaçã\ + o de recibos." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:28.331992Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:57.703190Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 13 +previousHash: "8e9dd2cc5a4b426e94bbb35309a7488418a8ba9fb0ac9b5b69e0604661246d53" +updatedAt: "2026-11-16T14:21:28.332065Z" +updatedBy: "codex" +changeReason: "Publicação atômica por Work montado em staging implementada com serviç\ + os normais; conteúdo integral, targets e originais passam em testes e validação\ + \ de recibos." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0014.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0014.md new file mode 100644 index 0000000..1c79bb0 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0014.md @@ -0,0 +1,145 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Publicação atômica por Work montado em staging implementada com serviç\ + os normais; conteúdo integral, targets e originais passam em testes e validaçã\ + o de recibos." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:28.331992Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "ACTIVE" + result: "Validar comandos públicos, identidade de origem e reimportação com os cená\ + rios de CLI executados." + evidence: [] + updatedAt: "2026-11-16T14:21:33.542373Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 14 +previousHash: "32b67c0dfc96eb47529158643373a124a40db70fd7b053412e37ece5b237c49a" +updatedAt: "2026-11-16T14:21:33.542432Z" +updatedBy: "codex" +changeReason: "Validar comandos públicos, identidade de origem e reimportação com\ + \ os cenários de CLI executados." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0015.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0015.md new file mode 100644 index 0000000..690cdc3 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0015.md @@ -0,0 +1,149 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Publicação atômica por Work montado em staging implementada com serviç\ + os normais; conteúdo integral, targets e originais passam em testes e validaçã\ + o de recibos." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:28.331992Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "COMPLETED" + result: "CLI com prévia/aplicação e hash esperado implementada. Reimportação idê\ + ntica é no-op mesmo após refinamento/arquivo; mudanças exigem revisão; cwd externo,\ + \ --project e NativeHints integrados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:41.243854Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 15 +previousHash: "0bb1733010e4f6779ba6a60f1b492c8f3b34949fbe966a39c0bbef4bb089dace" +updatedAt: "2026-11-16T14:21:41.243914Z" +updatedBy: "codex" +changeReason: "CLI com prévia/aplicação e hash esperado implementada. Reimportaçã\ + o idêntica é no-op mesmo após refinamento/arquivo; mudanças exigem revisão; cwd\ + \ externo, --project e NativeHints integrados." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0016.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0016.md new file mode 100644 index 0000000..e7574e2 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0016.md @@ -0,0 +1,149 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Publicação atômica por Work montado em staging implementada com serviç\ + os normais; conteúdo integral, targets e originais passam em testes e validaçã\ + o de recibos." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:28.331992Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "COMPLETED" + result: "CLI com prévia/aplicação e hash esperado implementada. Reimportação idê\ + ntica é no-op mesmo após refinamento/arquivo; mudanças exigem revisão; cwd externo,\ + \ --project e NativeHints integrados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:41.243854Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "ACTIVE" + result: "Testes focados de integração, concorrência e recuperação passaram; suí\ + te completa e distribuição nativa em execução." + evidence: [] + updatedAt: "2026-11-16T14:21:49.524186Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 16 +previousHash: "412965998630a799a8cb222ff4ca67e8467d512ad6575abd72cdeed80d06b3b2" +updatedAt: "2026-11-16T14:21:49.524278Z" +updatedBy: "codex" +changeReason: "Testes focados de integração, concorrência e recuperação passaram;\ + \ suíte completa e distribuição nativa em execução." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0017.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0017.md new file mode 100644 index 0000000..5e3ad0c --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0017.md @@ -0,0 +1,156 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Publicação atômica por Work montado em staging implementada com serviç\ + os normais; conteúdo integral, targets e originais passam em testes e validaçã\ + o de recibos." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:28.331992Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "COMPLETED" + result: "CLI com prévia/aplicação e hash esperado implementada. Reimportação idê\ + ntica é no-op mesmo após refinamento/arquivo; mudanças exigem revisão; cwd externo,\ + \ --project e NativeHints integrados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:41.243854Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "COMPLETED" + result: "151 testes completos e onze cenários Jenkins passaram. Concorrência entre\ + \ JVMs, falha/retomada, origem intacta, recibos e compatibilidade cobertos; JSON\ + \ JVM/nativo idêntico e leitor contrato 1 recusa contrato 2 sem alterar os dados." + evidence: + - "ART-0009" + - "ART-0011" + - "ART-0012" + - "ART-0013" + updatedAt: "2026-11-16T14:45:30.543554Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 17 +previousHash: "0b34d871415710e6c3afc64e33b4e7ef82e1d9e705a351bac54f23e7073e9543" +updatedAt: "2026-11-16T14:45:30.543633Z" +updatedBy: "codex" +changeReason: "151 testes completos e onze cenários Jenkins passaram. Concorrência\ + \ entre JVMs, falha/retomada, origem intacta, recibos e compatibilidade cobertos;\ + \ JSON JVM/nativo idêntico e leitor contrato 1 recusa contrato 2 sem alterar os\ + \ dados." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0018.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0018.md new file mode 100644 index 0000000..516caaa --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0018.md @@ -0,0 +1,155 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Publicação atômica por Work montado em staging implementada com serviç\ + os normais; conteúdo integral, targets e originais passam em testes e validaçã\ + o de recibos." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:28.331992Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "COMPLETED" + result: "CLI com prévia/aplicação e hash esperado implementada. Reimportação idê\ + ntica é no-op mesmo após refinamento/arquivo; mudanças exigem revisão; cwd externo,\ + \ --project e NativeHints integrados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:41.243854Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "COMPLETED" + result: "151 testes completos e onze cenários Jenkins passaram. Concorrência entre\ + \ JVMs, falha/retomada, origem intacta, recibos e compatibilidade cobertos; JSON\ + \ JVM/nativo idêntico e leitor contrato 1 recusa contrato 2 sem alterar os dados." + evidence: + - "ART-0009" + - "ART-0011" + - "ART-0012" + - "ART-0013" + updatedAt: "2026-11-16T14:45:30.543554Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "ACTIVE" + result: "Distribuição nativa compilada; concluir smoke completo, instruções portá\ + teis e evidências de entrega." + evidence: [] + updatedAt: "2026-11-16T14:45:38.057077Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 18 +previousHash: "7b923d835a0ee338ab659cd3c7417a2cc29b34b15bf7ec16ec393e3bdf5f30f5" +updatedAt: "2026-11-16T14:45:38.057154Z" +updatedBy: "codex" +changeReason: "Distribuição nativa compilada; concluir smoke completo, instruções\ + \ portáteis e evidências de entrega." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0019.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0019.md new file mode 100644 index 0000000..7dab58d --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0019.md @@ -0,0 +1,165 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Publicação atômica por Work montado em staging implementada com serviç\ + os normais; conteúdo integral, targets e originais passam em testes e validaçã\ + o de recibos." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:28.331992Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "COMPLETED" + result: "CLI com prévia/aplicação e hash esperado implementada. Reimportação idê\ + ntica é no-op mesmo após refinamento/arquivo; mudanças exigem revisão; cwd externo,\ + \ --project e NativeHints integrados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:41.243854Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "COMPLETED" + result: "151 testes completos e onze cenários Jenkins passaram. Concorrência entre\ + \ JVMs, falha/retomada, origem intacta, recibos e compatibilidade cobertos; JSON\ + \ JVM/nativo idêntico e leitor contrato 1 recusa contrato 2 sem alterar os dados." + evidence: + - "ART-0009" + - "ART-0011" + - "ART-0012" + - "ART-0013" + updatedAt: "2026-11-16T14:45:30.543554Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "COMPLETED" + result: "Documentação, contrato 2 e instruções portáteis integrados; 151 testes\ + \ e distribuição/smoke nativos aprovados, JSON JVM/nativo byte idêntico e 362\ + \ arquivos de outros Works intactos. Uso e limites documentados; nenhuma migraç\ + ão de consumidor real." + evidence: + - "ART-0011" + - "ART-0012" + - "ART-0013" + - "ART-0014" + - "ART-0015" + - "ART-0016" + updatedAt: "2026-11-16T14:48:51.556319Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 19 +previousHash: "1540a2b1a5f5834ecda268064bdd59d8c270bd352e53e64a4d28bd3807a3e586" +updatedAt: "2026-11-16T14:48:51.556397Z" +updatedBy: "codex" +changeReason: "Documentação, contrato 2 e instruções portáteis integrados; 151 testes\ + \ e distribuição/smoke nativos aprovados, JSON JVM/nativo byte idêntico e 362 arquivos\ + \ de outros Works intactos. Uso e limites documentados; nenhuma migração de consumidor\ + \ real." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/PLN-0001.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/PLN-0001.md index 840d5e3..4989c33 100644 --- a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/PLN-0001.md +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/PLN-0001.md @@ -20,10 +20,14 @@ steps: \ open." - "Nenhuma mudança em Works históricos ou em repositórios-fonte." dependsOn: [] - status: "OPEN" - result: "" - evidence: [] - updatedAt: "2026-11-16T11:44:40.803688Z" + status: "COMPLETED" + result: "Contrato de entrada/proveniência/erros/retomada definido; fixtures simples\ + \ e umbrella com estados mistos e IDs coincidentes passaram no validador DF original,\ + \ sem alterar a origem ou Works históricos." + evidence: + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:44:03.673387Z" - id: "TSK-0002" title: "Implementar leitura DF e prévia sem gravações" description: "Adicionar componente de importação que lê índice NDJSON e agendas\ @@ -39,10 +43,13 @@ steps: \ quebras de linha." dependsOn: - "TSK-0001" - status: "OPEN" - result: "" - evidence: [] - updatedAt: "2026-11-16T11:44:45.347282Z" + status: "COMPLETED" + result: "Leitor limitado, seleção por AGD open e prévia sem gravações implementados;\ + \ testes comprovam determinismo, Unicode/CRLF, erros e limites de dados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:14.454464Z" - id: "TSK-0003" title: "Publicar Works e preservar agendas e evidências" description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ @@ -57,10 +64,14 @@ steps: \ validação SHA-256." dependsOn: - "TSK-0002" - status: "OPEN" - result: "" - evidence: [] - updatedAt: "2026-11-16T11:44:51.505506Z" + status: "COMPLETED" + result: "Publicação atômica por Work montado em staging implementada com serviç\ + os normais; conteúdo integral, targets e originais passam em testes e validaçã\ + o de recibos." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:28.331992Z" - id: "TSK-0004" title: "Integrar CLI e reimportação determinística" description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ @@ -76,10 +87,14 @@ steps: sticos coerentes." dependsOn: - "TSK-0003" - status: "OPEN" - result: "" - evidence: [] - updatedAt: "2026-11-16T11:44:57.703190Z" + status: "COMPLETED" + result: "CLI com prévia/aplicação e hash esperado implementada. Reimportação idê\ + ntica é no-op mesmo após refinamento/arquivo; mudanças exigem revisão; cwd externo,\ + \ --project e NativeHints integrados." + evidence: + - "ART-0009" + - "ART-0010" + updatedAt: "2026-11-16T14:21:41.243854Z" - id: "TSK-0005" title: "Validar integração, concorrência e recuperação" description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ @@ -95,10 +110,16 @@ steps: \ de compatibilidade histórica." dependsOn: - "TSK-0004" - status: "OPEN" - result: "" - evidence: [] - updatedAt: "2026-11-16T11:45:04.463544Z" + status: "COMPLETED" + result: "151 testes completos e onze cenários Jenkins passaram. Concorrência entre\ + \ JVMs, falha/retomada, origem intacta, recibos e compatibilidade cobertos; JSON\ + \ JVM/nativo idêntico e leitor contrato 1 recusa contrato 2 sem alterar os dados." + evidence: + - "ART-0009" + - "ART-0011" + - "ART-0012" + - "ART-0013" + updatedAt: "2026-11-16T14:45:30.543554Z" - id: "TSK-0006" title: "Documentar e verificar distribuição JVM/nativa" description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ @@ -114,18 +135,27 @@ steps: \ plataforma é alegada sem teste." dependsOn: - "TSK-0005" - status: "OPEN" - result: "" - evidence: [] - updatedAt: "2026-11-16T11:45:11.634846Z" -status: "OPEN" + status: "COMPLETED" + result: "Documentação, contrato 2 e instruções portáteis integrados; 151 testes\ + \ e distribuição/smoke nativos aprovados, JSON JVM/nativo byte idêntico e 362\ + \ arquivos de outros Works intactos. Uso e limites documentados; nenhuma migraç\ + ão de consumidor real." + evidence: + - "ART-0011" + - "ART-0012" + - "ART-0013" + - "ART-0014" + - "ART-0015" + - "ART-0016" + updatedAt: "2026-11-16T14:48:51.556319Z" +status: "COMPLETED" author: "codex" createdAt: "2026-11-16T11:44:34.857533Z" -revision: 7 -previousHash: "cddadab736f1f0991adc0984175a69b0df5c5341cc76b2d3771238436bce2ac6" -updatedAt: "2026-11-16T11:45:11.634905Z" -updatedBy: "codex" -changeReason: "Decomposição da DEC-0001 aceita pelo usuário." +revision: 20 +previousHash: "21c48f3ae33f9e1657b68a211d78cd34810d05dcec530ce37ddb887868354818" +updatedAt: "2026-11-16T14:48:54.362237Z" +updatedBy: "system:plans" +changeReason: "All required steps completed; reviewed cancellations retained" documentVersion: 2 --- diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/work.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/work.md index 857b7f7..601cc22 100644 --- a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/work.md +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/work.md @@ -29,9 +29,9 @@ acceptanceCriteria: \ revisão, sem sobrescrever." - "Apresentar prévia da importação e bloquear a aplicação do lote selecionado enquanto\ \ houver DSCs ou AGDs inválidas ou referências não resolvidas." -status: "OPEN" +status: "COMPLETED" createdAt: "2026-11-16T11:01:09.026342Z" -updatedAt: "2026-11-16T12:29:40.753798Z" +updatedAt: "2026-11-16T14:48:58.899123Z" author: "user" repositories: [] discussions: @@ -46,6 +46,8 @@ discussions: - "DSC-0009" - "DSC-0010" - "DSC-0011" +- "DSC-0012" +- "DSC-0013" decisions: - "DEC-0001" artifacts: @@ -55,10 +57,75 @@ artifacts: - "ART-0004" - "ART-0005" - "ART-0006" +- "ART-0007" +- "ART-0008" +- "ART-0009" +- "ART-0010" +- "ART-0011" +- "ART-0012" +- "ART-0013" +- "ART-0014" +- "ART-0015" +- "ART-0016" +- "ART-0017" plans: - "PLN-0001" -completions: [] -events: [] +completions: +- at: "2026-11-16T14:48:58.899123Z" + by: "system:plans" + summary: "All required Plans completed; requester=codex" + humanApproved: false + scopeHash: "b60635e325255fcec7df477509363a22378c5906799433f6ee5f244012ccb7ce" + criteria: + - criterion: 1 + text: "Importar DSCs com AGDs open de uma origem simples do Discussion Framework." + evidence: + - "ART-0017" + - criterion: 2 + text: "Importar DSCs de várias origens DF independentes sob a umbrella AIE e descrever\ + \ no Work os targets da tarefa." + evidence: + - "ART-0017" + - criterion: 3 + text: "Selecionar DSCs pelo estado de suas AGDs no array agendas do índice; DSCs\ + \ sem AGD open não geram Work e agendas com outros estados ficam fora." + evidence: + - "ART-0017" + - criterion: 4 + text: "Criar um Work por DSC de origem, agrupando suas agendas abertas e preservando\ + \ integralmente o conteúdo e os vínculos de origem." + evidence: + - "ART-0017" + - criterion: 5 + text: "Não criar DECs ou planos como parte da importação; o tratamento anterior\ + \ de DECs em draft e aprovações deixa de se aplicar." + evidence: + - "ART-0017" + - criterion: 6 + text: "Em reimportações, ignorar itens idênticos e apresentar alterações ou colisõ\ + es para revisão, sem sobrescrever." + evidence: + - "ART-0017" + - criterion: 7 + text: "Apresentar prévia da importação e bloquear a aplicação do lote selecionado\ + \ enquanto houver DSCs ou AGDs inválidas ou referências não resolvidas." + evidence: + - "ART-0017" + integrations: [] + noIntegrationReason: "Canonical changes and execution results are recorded in the\ + \ Plan step evidence" + origin: "SYSTEM_PLANS" + delegation: null + aggregation: + receipt: "ART-0017" + inputHash: "5d44de8fb24111ba741d65ab7d5ab5ae8e7dccee4d7d65c42e3dffb9c5db748c" + requester: "codex" + requestId: "39033811-be2f-430f-b4e1-5df70426c03d" +events: +- action: "COMPLETE" + by: "system:plans" + reason: "All required Plans completed; requester=codex" + at: "2026-11-16T14:48:58.899123Z" archived: false topics: [] surveys: diff --git a/README.md b/README.md index 9b0ca2a..d905fc8 100644 --- a/README.md +++ b/README.md @@ -131,6 +131,18 @@ projects that only need engineering records. ## How work is recorded +Open Discussion Framework agendas can be imported with a read-only preview: + +```sh +aie import discussion --source app=../app --format json +aie import discussion --source app=../app --apply --expect +``` + +One Work receives each DSC's open agendas in full. Repeat `--source` for an +umbrella, and use `--target SOURCE=TEXT` to describe its targets. Identical imports +are skipped; changes require review without overwriting. See +[Discussion Framework import](docs/discussion-import.md) for the contract and limits. + Creating a Plan from a draft decision automatically promotes that decision to ACCEPTED. The framework records the causal Plan and system provenance without a model call. Direct human approval remains available through `decision accept`. diff --git a/docs/architecture.md b/docs/architecture.md index 40b6a65..2fdaddb 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -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. diff --git a/docs/compatibility.md b/docs/compatibility.md index 3d0f8de..dc7be9d 100644 --- a/docs/compatibility.md +++ b/docs/compatibility.md @@ -48,6 +48,13 @@ for either. Unsupported declared manifest/contract versions prevent ordinary CLI operations and onboarding from overwriting a newer contract. Compatibility inspection remains available to explain the mismatch. +Contract 2 advertises deterministic DF open-agenda import. The CLI reads contracts +1 and 2, and existing contract-1 projects remain legacy compatible without any +Work migration. An import-enabled manifest requires contract 2 and the +`discussion-import` capability. This makes old contract-1 CLIs refuse the new +manifest before onboarding could overwrite its feature declaration. `onboard` +refreshes the entry files with backups; completed Works and history are unchanged. + The format catalog is deliberately small: | Format | Current writer | Supported readers | diff --git a/docs/discussion-import.md b/docs/discussion-import.md new file mode 100644 index 0000000..9534649 --- /dev/null +++ b/docs/discussion-import.md @@ -0,0 +1,94 @@ +# Discussion Framework import + +Import DSC discussions with open AGD agendas into the current AIE project. Each +source is an independent DF tree; the destination may be a plain project or an +umbrella containing several such projects. No model, source mutation, repository +registration, imported decision or imported execution plan is involved. + +## Commands + +This capability is advertised by protocol contract 2. The updated CLI also reads +contract 1 projects and historical Work formats; no Work conversion is required. +`onboard` refreshes entry instructions with backups after compatibility inspection. +Older contract-1 CLIs refuse a contract-2 manifest instead of overwriting it. + +```sh +aie import discussion --source runtime=../runtime --source studio=../studio \ + --target runtime=runtime --target runtime=docs --target studio=studio --format json +aie import discussion --source runtime=../runtime --source studio=../studio \ + --target runtime=runtime --target runtime=docs --target studio=studio \ + --apply --expect --author owner --format json +``` + +`--source ID=PATH` is repeatable and required. IDs follow AIE project identifier +rules and must remain stable across imports; paths resolve relative to the caller, +including when `--project` selects a different destination. A path may name the +source project or its existing `discussion/` directory. Duplicate IDs or roots in +one request are rejected. Source locations may move while keeping their identity. + +`--target SOURCE=TEXT` is repeatable. Targets are authored descriptions recorded +in the imported Work; they do not register or authorize repository edits. Without +an explicit target, the caller-supplied source ID identifies the project target. + +Without `--apply`, the command is read-only, including no destination locks or +backups. It reports each DSC, selected/ignored agendas, source paths and hashes, +existing Work, and an action: CREATE, UNCHANGED, REVIEW or SKIP. Invalid inputs +are diagnosed in the report. REVIEW and errors block the selected batch. + +`--apply` requires `--expect` from a valid preview. The sources and destination +import identities are read again under the destination lock; a changed preview +fingerprint is refused before allocation or publication. Publication rechecks the +captured source bytes before writing any Works. There is no automatic override +of REVIEW items; refine the inputs or review the existing Work explicitly. + +## Selection and preservation + +Read `discussion/index.ndjson`: first record `type=meta`, subsequent records +`type=discussion`. Select each DSC with at least one indexed AGD whose exact +status is `open`. Other nonblank states are ignored with a reason. The DSC's +aggregate status is not a substitute for the agenda status. An absent DEC is +normal. Historical closed agendas need not have files when they are not selected. + +Selected agenda files must have front matter whose ID and status agree with the +index. Missing/ambiguous references, duplicate DSC/AGD identities in one source, +invalid UTF-8, escaping paths, symlinked descendants or inconsistent selected data +block application. Unknown source metadata is retained in the original DSC record, +not inferred into new AIE semantics. The DF validator alone is not sufficient. + +One OPEN Work is created per source ID + DSC ID. Each selected AGD becomes a NOTE +in refinement with its complete original Markdown text, not a summary or parsed +set of human answers. Original agenda bytes and the original DSC index record +are owned ART evidence. A versioned import receipt, also owned evidence, links +source identity, DSC and AGD IDs, source hashes, targets, discussion IDs and ART IDs. +The source directory is an audit location, not the sole import identity. + +Limits: an index is at most 8 MiB, individual selected agendas and evidence are at +most 1 MiB, and captured source data per request is at most 32 MiB. Oversized data +is reported before publication. These are explicit limits, never truncation. + +## Reimport and failure recovery + +The same source ID + DSC with identical content and targets is UNCHANGED. It does +not add or rewrite Works, notes or evidence, including when the Work has since +been refined, completed or archived. New or changed source content for an existing +identity is REVIEW. No destination content is overwritten or deleted; a changed +agenda state never removes previously imported context. + +A Work and all its initial records are built in the existing hidden Work staging +area and published by one directory move using the normal Work ID sequence. +Readers do not see a half-seeded Work. A batch is not a global transaction: +an I/O failure or process interruption after one Work is published may leave that +Work imported. The error identifies published Works; a fresh preview recognizes +them as UNCHANGED and can continue the remaining items without duplication. +Unpublished hidden staging folders and reserved ID gaps may remain for deliberate +inspection; neither is interpreted as an imported discussion. + +Preview, apply and validation verify owned receipt integrity and references. +Refinement prose may evolve in the destination while the original evidence remains +intact. Conflicting import identities or corrupted receipts must be repaired +explicitly; no receipt, original evidence or historical Work is silently rewritten. + +Exit codes follow AIE: 0 for a valid preview/application, 2 for invalid command +arguments, 3 for a missing project/root, 4 for invalid/stale/review-required data, +and 1 for unexpected I/O failures. Diagnostics after partial publication retain +the normal failure code and identify the Work IDs already published. diff --git a/docs/protocol.md b/docs/protocol.md index 6be3207..d33d5cd 100644 --- a/docs/protocol.md +++ b/docs/protocol.md @@ -436,7 +436,15 @@ Canonical code/spec/test/docs hold integrated knowledge; no Lesson entity is req `work archive --by NAME --reason TEXT` marks a verified completed or cancelled Work archived. It retains all files and prior approvals/results. `work reopen` clears archive, returns to ACTIVE and appends a reasoned event. There is no automatic deletion. -Importing legacy agendas and Lessons is deferred to a later, separately tested importer. +`import discussion` imports DF DSCs with open AGDs using a read-only preview and +an explicit `--apply --expect` fingerprint. Independent `--source ID=PATH` origins +share one AIE destination; targets are described in their Works. Only open agendas +are imported as complete refinement notes and original evidence. Owned versioned +receipts preserve source+DSC identity, source hashes and references without changing +the Work schema. Identical reimports are no-ops; changes are reported for review. +Work publication is atomic per prepared directory, while a batch may be resumed +after partial publication. Closed agendas, DECs, Plans and Lessons are not imported. +See [the import contract](discussion-import.md) for limits, diagnostics and recovery. ## EPIC policy and system completion diff --git a/docs/roadmap.md b/docs/roadmap.md index ea7caf1..ea66591 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -56,9 +56,11 @@ The test suite verifies mechanics, not an arbitrary external AI's compliance. Continue piloting the installed entry files and CLI in an existing real project, with an external agent continuing a Work through human-reviewed closure. The first -Discussion refinement slice is described below. A separate future importer must -preserve origins/history for open agendas and valuable legacy Lessons, integrating -knowledge into canonical docs instead of requiring Lesson artifacts. +Discussion refinement slice is described below. The separate DF importer now +previews and imports DSCs with open agendas, preserving originals, source identity +and targets across independent projects under an umbrella. Reimport is deterministic +and does not overwrite refinement. See [the import contract](discussion-import.md). +Legacy Lessons still require deliberate integration into canonical docs. ## Milestone 2 — Discussion refinement (first contract slice) @@ -93,7 +95,8 @@ important/optional/cancelled children and native standalone execution. Actual ob results are recorded in [experiments](experiments.md). The EPIC slice itself does not choose providers or execute child repository changes. -Agent-generated decomposition and the agenda/Lesson importer remain separate work. +Agent-generated decomposition and Lesson integration remain separate work. The +open-agenda importer is delivered independently of EPIC coordination. ## Local Codex/Claude adapters — third approved slice diff --git a/scripts/native-smoke.sh b/scripts/native-smoke.sh index 4b0ea34..23cde31 100755 --- a/scripts/native-smoke.sh +++ b/scripts/native-smoke.sh @@ -3,6 +3,7 @@ set -euo pipefail # Run from any directory. The executable argument must be an absolute native path. aie_binary=${1:?Usage: native-smoke.sh /absolute/path/to/ai-engineering} +aie_source_root=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P) aie_fixture=$(mktemp -d "${TMPDIR:-/tmp}/ai-engineering-smoke.XXXXXX") if [[ "${AIE_KEEP_FIXTURE:-0}" != 1 ]]; then trap 'rm -rf "$aie_fixture"' EXIT; fi cd "$aie_fixture" @@ -30,9 +31,9 @@ aie_without_git work create 'Continue application' --goal 'Preserve local contex aie_without_git project compatibility --format json > compatibility.json grep -q '"state" : "CURRENT"' compatibility.json grep -q '"migrationRequired" : false' compatibility.json -grep -q '"protocolVersion": 1' .ai-engineering/protocol.json +grep -q '"protocolVersion": 2' .ai-engineering/protocol.json cp .ai-engineering/protocol.json baseline-protocol.json -sed 's/"protocolVersion": 1/"protocolVersion": 99/' baseline-protocol.json > .ai-engineering/protocol.json +sed 's/"protocolVersion": 2/"protocolVersion": 99/' baseline-protocol.json > .ai-engineering/protocol.json cp .ai-engineering/protocol.json future-protocol.json if aie_without_git project compatibility --format json > future-compatibility.json; then echo 'Unsupported contract unexpectedly succeeded' >&2 @@ -118,6 +119,42 @@ aie_without_git project compatibility --format json > compatibility.json grep -q '"state" : "CURRENT"' compatibility.json cd "$aie_fixture" +# DF import: independent sources, repeated IDs, reviewed preview and no-op retry. +cp -R "$aie_source_root/src/test/resources/discussion-import/alpha" "$aie_fixture/df-alpha" +cp -R "$aie_source_root/src/test/resources/discussion-import/beta" "$aie_fixture/df-beta" +cp -R "$aie_fixture/df-alpha" "$aie_fixture/df-alpha-before" +cp -R "$aie_fixture/df-beta" "$aie_fixture/df-beta-before" +mkdir "$aie_fixture/df-import" +cd "$aie_fixture/df-import" +aie_without_git init --name 'DF import destination' > init.yaml +aie_df_args=(--source "alpha=$aie_fixture/df-alpha" --source "beta=$aie_fixture/df-beta" + --target alpha=runtime --target alpha=docs --target beta=studio --format json) +aie_without_git import discussion "${aie_df_args[@]}" > preview.json +grep -q '"action" : "CREATE"' preview.json +grep -q '"action" : "SKIP"' preview.json +aie_df_sha=$(sed -n 's/.*"fingerprint" : "\([a-f0-9]*\)".*/\1/p' preview.json) +test "${#aie_df_sha}" -eq 64 +aie_without_git import discussion "${aie_df_args[@]}" --apply --expect "$aie_df_sha" > applied.json +grep -q '"applied" : true' applied.json +aie_without_git work list --format json > imported-works.json +test "$(grep -c '"id" : "WRK-' imported-works.json)" -eq 2 +aie_without_git work context WRK-0001 --format json > imported-context.json +grep -q 'café' imported-context.json +grep -q 'runtime' imported-context.json +cp -R .ai-engineering/works works-before +aie_without_git import discussion "${aie_df_args[@]}" > repeat-preview.json +aie_df_sha=$(sed -n 's/.*"fingerprint" : "\([a-f0-9]*\)".*/\1/p' repeat-preview.json) +grep -q '"action" : "UNCHANGED"' repeat-preview.json +aie_without_git import discussion "${aie_df_args[@]}" --apply --expect "$aie_df_sha" > repeated.json +diff -r works-before .ai-engineering/works +diff -r "$aie_fixture/df-alpha-before" "$aie_fixture/df-alpha" +diff -r "$aie_fixture/df-beta-before" "$aie_fixture/df-beta" +aie_without_git project validate > import-validation.yaml +aie_without_git project compatibility --format json > import-compatibility.json +grep -q '"state" : "CURRENT"' import-compatibility.json +echo 'Native DF import smoke passed (umbrella, open agendas, original content, preview, provenance and no-op reimport; no Git/JVM/models).' +cd "$aie_fixture" + # A single Git repository can contain both the source and protocol workspace. git init -q single cd single diff --git a/src/main/java/net/intrepid/aiengineering/NativeHints.java b/src/main/java/net/intrepid/aiengineering/NativeHints.java index bef4ed2..81efefc 100644 --- a/src/main/java/net/intrepid/aiengineering/NativeHints.java +++ b/src/main/java/net/intrepid/aiengineering/NativeHints.java @@ -9,6 +9,7 @@ import net.intrepid.aiengineering.artifact.*; import net.intrepid.aiengineering.planning.*; import net.intrepid.aiengineering.agent.*; import net.intrepid.aiengineering.verification.*; +import net.intrepid.aiengineering.legacyimport.DiscussionImport; import org.springframework.aot.hint.*; public final class NativeHints implements RuntimeHintsRegistrar { @@ -32,6 +33,9 @@ public final class NativeHints implements RuntimeHintsRegistrar { AgentRun.class, AgentRun.Applied.class, AgentService.Available.class, AgentService.View.class, AgentAdapter.Selection.class, AgentAdapter.Result.class, AgentAdapter.Invocation.class, AgentRun.Provenance.class, CliAgentAdapter.Doctor.class, CliAgentAdapter.Classification.class, CliAgentAdapter.WireProposal.class, + DiscussionImport.Source.class, DiscussionImport.SourceView.class, DiscussionImport.AgendaView.class, + DiscussionImport.Entry.class, DiscussionImport.Report.class, DiscussionImport.ImportedAgenda.class, + DiscussionImport.Receipt.class, DiscussionImport.Action.class, Artifact.class, ValidationReport.class, VerificationService.Context.class, DiscussionService.MigrationReport.class}) { hints.reflection().registerType(type, MemberCategory.INVOKE_DECLARED_CONSTRUCTORS, MemberCategory.INVOKE_PUBLIC_METHODS); } diff --git a/src/main/java/net/intrepid/aiengineering/artifact/ArtifactService.java b/src/main/java/net/intrepid/aiengineering/artifact/ArtifactService.java index cd8d63d..fad120f 100644 --- a/src/main/java/net/intrepid/aiengineering/artifact/ArtifactService.java +++ b/src/main/java/net/intrepid/aiengineering/artifact/ArtifactService.java @@ -35,16 +35,22 @@ public final class ArtifactService { return Filespace.locked(root, () -> { var work = works.editable(root, workId); String id = works.nextReference(work.artifacts(), "ART"); Path folder = works.folder(root, workId); - Path parent = Filespace.resolve(folder, "artifacts/evidence"); - Path stage = Filespace.resolve(parent, "." + id + "-" + UUID.randomUUID() + ".tmp"); Filespace.directory(stage); - var artifact = new Artifact(1, id, workId, origin, purpose, - "artifacts/evidence/" + id + "/payload", hash(bytes), bytes.length, author, Instant.now().toString()); - Filespace.writeBytes(stage.resolve("payload"), bytes, false); - Filespace.write(stage.resolve("artifact.yaml"), Documents.yaml(artifact), false); - Filespace.moveDirectory(stage, Filespace.resolve(parent, id)); + var artifact = writePrepared(folder, workId, id, bytes, purpose, origin, author); works.addReference(root, workId, "artifacts", id); return artifact; }); } + /** Normal evidence format in an unpublished Work folder; caller publishes its Work references. */ + public Artifact writePrepared(Path folder, String workId, String id, byte[] content, String purpose, String origin, String author) { + Work.identifier(workId, "WRK"); Work.identifier(id, "ART"); byte[] bytes = content.clone(); + if (bytes.length > MAX_BYTES) throw ProtocolException.invalid("Evidence exceeds 1 MiB"); + Path parent = Filespace.resolve(folder, "artifacts/evidence"); + Path stage = Filespace.resolve(parent, "." + id + "-" + UUID.randomUUID() + ".tmp"); Filespace.directory(stage); + var artifact = new Artifact(1, id, workId, origin, purpose, + "artifacts/evidence/" + id + "/payload", hash(bytes), bytes.length, author, Instant.now().toString()); + Filespace.writeBytes(stage.resolve("payload"), bytes, false); + Filespace.write(stage.resolve("artifact.yaml"), Documents.yaml(artifact), false); + Filespace.moveDirectory(stage, Filespace.resolve(parent, id)); return artifact; + } public void validate(Path root, String id) { for (var artifact : list(root, id)) { Path path = Filespace.resolve(works.folder(root, id), artifact.path()); diff --git a/src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java b/src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java index 16ebc7d..b0250f4 100644 --- a/src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java +++ b/src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java @@ -42,6 +42,7 @@ public final class EngineeringCli implements Runnable { .addSubcommand("plan", new CommandLine(new PlanCommands()).addSubcommand("step", new StepCommands())) .addSubcommand("topic", new TopicCommands()).addSubcommand("survey", new SurveyCommands()).addSubcommand("agent", new AgentCommands()) .addSubcommand("epic", new EpicCommands()); + commandLine.addSubcommand("import", new CommandLine(new ImportCommands()).addSubcommand("discussion", new DiscussionImportCommand())); configure(commandLine, out, err); commandLine.setExecutionExceptionHandler((exception, command, parse) -> { if (exception instanceof ProtocolException problem) { err.println(problem.getMessage()); return problem.exitCode(); } @@ -61,6 +62,49 @@ public final class EngineeringCli implements Runnable { } private Path resolve(Path path) { return path.isAbsolute() ? path : cwd.resolve(path); } enum Format { markdown, json } + @Command(name = "import", mixinStandardHelpOptions = true, description = "Import supported legacy context with explicit preview and application.") + public class ImportCommands implements Runnable { + @Override public void run() { commandLine.getSubcommands().get("import").usage(output); } + } + @Command(name = "discussion", mixinStandardHelpOptions = true, description = "Preview or import DF DSCs with open AGD agendas, without a model call.") + public class DiscussionImportCommand implements java.util.concurrent.Callable { + @Option(names = "--source", required = true, description = "Stable source ID=PATH; repeat for independent DF projects. Paths are caller-relative.") List sources; + @Option(names = "--target", description = "SOURCE=TEXT target description; repeat for multiple targets.") List targets; + @Option(names = "--apply", description = "Publish the reviewed import; requires --expect.") boolean apply; + @Option(names = "--expect", description = "Fingerprint returned by a valid preview.") String expected; + @Option(names = "--author", defaultValue = "human") String author; + @Option(names = "--format", defaultValue = "markdown") Format format; + private String[] pair(String value, String option) { + int at = value.indexOf('='); + if (at < 1 || at == value.length() - 1) throw ProtocolException.invalid(option + " requires ID=VALUE"); + return new String[]{value.substring(0, at), value.substring(at + 1)}; + } + @Override public Integer call() { + if (apply && expected == null) throw ProtocolException.invalid("--apply requires --expect from a preview"); + if (!apply && expected != null) throw ProtocolException.invalid("--expect requires --apply"); + var roots = new java.util.LinkedHashMap(); var targetMap = new java.util.HashMap>(); + for (String raw : sources) { + var pair = pair(raw, "--source"); + if (roots.putIfAbsent(pair[0], resolve(Path.of(pair[1])).normalize().toString()) != null) + throw ProtocolException.invalid("Duplicate source ID: " + pair[0]); + } + for (String raw : safe(targets)) { + var pair = pair(raw, "--target"); + if (!roots.containsKey(pair[0])) throw ProtocolException.invalid("Unknown target source: " + pair[0]); + targetMap.computeIfAbsent(pair[0], k -> new java.util.ArrayList<>()).add(pair[1]); + } + var inputs = roots.entrySet().stream().map(e -> new net.intrepid.aiengineering.legacyimport.DiscussionImport.Source(e.getKey(), e.getValue(), targetMap.get(e.getKey()))).toList(); + var importer = new net.intrepid.aiengineering.legacyimport.DiscussionImportService(); Path destination = root(); + if (apply) { + var validity = verification.project(destination); + if (!validity.valid()) throw ProtocolException.validation(String.join("; ", validity.issues())); + } + var result = apply ? importer.apply(destination, inputs, expected, author) : importer.preview(destination, inputs); + if (format == Format.json) output.print(Documents.json(result)); + else output.print(net.intrepid.aiengineering.legacyimport.DiscussionImportService.markdown(result)); + return result.valid() ? 0 : 4; + } + } private int emit(Object value, Format format) { output.print(format == Format.json ? Documents.json(value) : Documents.yaml(value)); return 0; } diff --git a/src/main/java/net/intrepid/aiengineering/cli/package-info.java b/src/main/java/net/intrepid/aiengineering/cli/package-info.java index cf0232e..a13cfc1 100644 --- a/src/main/java/net/intrepid/aiengineering/cli/package-info.java +++ b/src/main/java/net/intrepid/aiengineering/cli/package-info.java @@ -1,2 +1,2 @@ -@org.springframework.modulith.ApplicationModule(allowedDependencies = {"filesystem", "project", "work", "discussion", "decision", "artifact", "verification", "planning", "agent"}) +@org.springframework.modulith.ApplicationModule(allowedDependencies = {"filesystem", "project", "work", "discussion", "decision", "artifact", "verification", "planning", "agent", "legacyimport"}) package net.intrepid.aiengineering.cli; diff --git a/src/main/java/net/intrepid/aiengineering/discussion/DiscussionService.java b/src/main/java/net/intrepid/aiengineering/discussion/DiscussionService.java index fc22d2f..64a070f 100644 --- a/src/main/java/net/intrepid/aiengineering/discussion/DiscussionService.java +++ b/src/main/java/net/intrepid/aiengineering/discussion/DiscussionService.java @@ -23,11 +23,16 @@ public final class DiscussionService { if (respondsTo != null && list(root, workId).stream().noneMatch(e -> e.id().equals(respondsTo))) throw ProtocolException.invalid("Response target not found in Work: " + respondsTo); String id = works.nextReference(work.discussions(), "DSC"); - var entry = new DiscussionEntry(1, id, workId, discussionId, kind, author, Instant.now().toString(), respondsTo, text); - Documents.writeMarkdownDocument(Filespace.resolve(works.folder(root, workId), "discussions/" + id + ".md"), entry, "text", false); + var entry = writePrepared(works.folder(root, workId), workId, id, text, kind, author, discussionId, respondsTo); works.addReference(root, workId, "discussions", id); return entry; }); } + /** Normal discussion format in an unpublished Work folder; caller publishes its Work references. */ + public DiscussionEntry writePrepared(Path folder, String workId, String id, String text, DiscussionEntry.Kind kind, + String author, String discussionId, String respondsTo) { + var entry = new DiscussionEntry(1, id, workId, discussionId, kind, author, Instant.now().toString(), respondsTo, text); + Documents.writeMarkdownDocument(Filespace.resolve(folder, "discussions/" + id + ".md"), entry, "text", false); return entry; + } public record MigrationReport(int schemaVersion, int converted, int unchanged, List backups) { public MigrationReport { backups = List.copyOf(backups); } } diff --git a/src/main/java/net/intrepid/aiengineering/filesystem/Documents.java b/src/main/java/net/intrepid/aiengineering/filesystem/Documents.java index 2dcd5ac..0e702f8 100644 --- a/src/main/java/net/intrepid/aiengineering/filesystem/Documents.java +++ b/src/main/java/net/intrepid/aiengineering/filesystem/Documents.java @@ -57,6 +57,8 @@ public final class Documents { public static int documentVersion(Path path) { return version(parts(path).metadata(), path); } /** Raw persisted metadata for read-only diagnostics, without materializing defaults. */ public static ObjectNode metadata(Path path) { return parts(path).metadata(); } + /** Parse an already captured legacy document without rereading a concurrently edited source. */ + public static ObjectNode metadataText(String text) { return parts(text, "captured Markdown").metadata(); } private static int version(ObjectNode metadata, Path path) { var value = metadata.get("documentVersion"); if (value == null) return 1; @@ -65,14 +67,17 @@ public final class Documents { } private record Parts(ObjectNode metadata, String body) {} private static Parts parts(Path path) { - String text = Filespace.read(path); var match = FRONT_MATTER.matcher(text); - if (!match.find()) throw ProtocolException.validation("Missing or unclosed YAML front matter: " + path); + return parts(Filespace.read(path), path.toString()); + } + private static Parts parts(String text, String location) { + var match = FRONT_MATTER.matcher(text); + if (!match.find()) throw ProtocolException.validation("Missing or unclosed YAML front matter: " + location); try { if (!(YAML.readTree(match.group(1)) instanceof ObjectNode metadata)) - throw ProtocolException.validation("Front matter must be an object: " + path); + throw ProtocolException.validation("Front matter must be an object: " + location); return new Parts(metadata, text.substring(match.end())); } catch (ProtocolException e) { throw e; } - catch (RuntimeException e) { throw ProtocolException.validation("Invalid front matter at " + path + ": " + e.getMessage()); } + catch (RuntimeException e) { throw ProtocolException.validation("Invalid front matter at " + location + ": " + e.getMessage()); } } public static String markdownDocument(Object value, String bodyField) { ObjectNode metadata = YAML.valueToTree(value); diff --git a/src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImport.java b/src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImport.java new file mode 100644 index 0000000..72b3fcf --- /dev/null +++ b/src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImport.java @@ -0,0 +1,59 @@ +package net.intrepid.aiengineering.legacyimport; + +import net.intrepid.aiengineering.filesystem.ProtocolException; +import net.intrepid.aiengineering.project.ProjectConfig; +import net.intrepid.aiengineering.work.Work; +import java.util.*; + +/** Public CLI reports and owned provenance; source content itself stays in normal evidence payloads. */ +public final class DiscussionImport { + private DiscussionImport() {} + public static final String RECEIPT_ORIGIN = "ai-engineering:discussion-import:"; + public enum Action { CREATE, UNCHANGED, REVIEW, SKIP, ERROR } + public record Source(String id, String path, List targets) { + public Source { + ProjectConfig.identifier(id); ProtocolException.text(path, "DF source path"); + targets = targets == null || targets.isEmpty() ? List.of(id) : targets.stream().distinct().sorted().toList(); + targets.forEach(t -> ProtocolException.text(t, "source target")); + } + } + public record SourceView(String id, String path, List targets, String indexSha256) { + public SourceView { targets = List.copyOf(targets); } + } + public record AgendaView(String id, String file, String status, boolean selected, String sha256, String reason) {} + public record Entry(String sourceId, String dscId, String title, List agendas, + Action action, String workId, String contentHash, String reason) { + public Entry { agendas = List.copyOf(agendas); } + } + public record Report(int schemaVersion, boolean valid, boolean applied, String fingerprint, + List sources, List discussions, List errors, Map publishedWorks) { + public Report { + sources = List.copyOf(sources); discussions = List.copyOf(discussions); errors = List.copyOf(errors); + publishedWorks = Collections.unmodifiableMap(new TreeMap<>(publishedWorks)); + } + } + public record ImportedAgenda(String id, String file, String sha256, String discussionId, String artifactId) { + public ImportedAgenda { + Work.identifier(id, "AGD"); ProtocolException.text(file, "original agenda path"); hash(sha256); + Work.identifier(discussionId, "DSC"); Work.identifier(artifactId, "ART"); + } + } + public record Receipt(int schemaVersion, String workId, String sourceId, String sourceRoot, String dscId, + List targets, String contentHash, String dscSha256, String dscArtifactId, List agendas) { + public Receipt { + ProtocolException.schema(schemaVersion); Work.identifier(workId, "WRK"); ProjectConfig.identifier(sourceId); + ProtocolException.text(sourceRoot, "DF source location"); Work.identifier(dscId, "DSC"); + targets = List.copyOf(targets); targets.forEach(t -> ProtocolException.text(t, "source target")); + if (targets.isEmpty() || targets.stream().distinct().count() != targets.size()) throw ProtocolException.validation("Invalid import targets"); + hash(contentHash); hash(dscSha256); Work.identifier(dscArtifactId, "ART"); agendas = List.copyOf(agendas); + if (agendas.isEmpty() || agendas.stream().map(ImportedAgenda::id).distinct().count() != agendas.size() + || agendas.stream().map(ImportedAgenda::discussionId).distinct().count() != agendas.size() + || agendas.stream().map(ImportedAgenda::artifactId).distinct().count() != agendas.size() + || agendas.stream().anyMatch(a -> a.artifactId().equals(dscArtifactId))) + throw ProtocolException.validation("Invalid imported agenda identities"); + } + } + public static void hash(String value) { + if (value == null || !value.matches("[a-f0-9]{64}")) throw ProtocolException.validation("Invalid import SHA-256"); + } +} diff --git a/src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImportService.java b/src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImportService.java new file mode 100644 index 0000000..bc4ab00 --- /dev/null +++ b/src/main/java/net/intrepid/aiengineering/legacyimport/DiscussionImportService.java @@ -0,0 +1,307 @@ +package net.intrepid.aiengineering.legacyimport; + +import net.intrepid.aiengineering.artifact.*; +import net.intrepid.aiengineering.discussion.*; +import net.intrepid.aiengineering.filesystem.*; +import net.intrepid.aiengineering.project.*; +import net.intrepid.aiengineering.work.*; +import tools.jackson.databind.JsonNode; +import tools.jackson.databind.node.ObjectNode; +import java.nio.*; +import java.nio.charset.*; +import java.nio.file.*; +import java.util.*; +import static net.intrepid.aiengineering.legacyimport.DiscussionImport.*; + +/** Deterministic DF reader and publisher. No adapter, source command or source write is used. */ +public final class DiscussionImportService { + public static final int MAX_INDEX_BYTES = 8 * 1024 * 1024; + public static final int MAX_BATCH_BYTES = 32 * 1024 * 1024; + private final WorkService works = new WorkService(); + private final ArtifactService artifacts = new ArtifactService(); + private final DiscussionService discussions = new DiscussionService(); + private final java.util.function.Consumer afterPublication; + public DiscussionImportService() { this(work -> {}); } + /** Fault injection at the batch publication boundary; not exposed by the CLI. */ + DiscussionImportService(java.util.function.Consumer afterPublication) { this.afterPublication = afterPublication; } + private record Original(String id, String file, Path path, byte[] bytes) {} + private record Candidate(Source source, String dscId, String title, byte[] record, List agendas, String hash) {} + private record Existing(Receipt receipt, String workId, String fingerprint) {} + private record Snapshot(Report report, List candidates, Map watched) {} + + public Report preview(Path root, List sources) { return capture(root, sources).report(); } + + public Report apply(Path root, List sources, String expected, String author) { + if (expected == null || !expected.matches("[a-f0-9]{64}")) throw ProtocolException.invalid("--apply requires --expect with a preview fingerprint"); + ProtocolException.text(author, "import author"); + return Filespace.locked(root, () -> { + var snapshot = capture(root, sources); var report = snapshot.report(); + if (!report.valid()) return report; + if (!report.fingerprint().equals(expected)) return error(report, "Preview changed; run preview again before applying"); + verify(snapshot.watched()); + var published = new TreeMap(); + try { + for (var candidate : snapshot.candidates()) { + var entry = report.discussions().stream().filter(e -> key(e.sourceId(), e.dscId()).equals(key(candidate.source().id(), candidate.dscId()))).findFirst().orElseThrow(); + if (entry.action() != Action.CREATE) continue; + var source = candidate.source(); + String description = "Imported Discussion Framework discussion " + candidate.dscId() + " from " + source.id() + + " (" + source.path() + ").\n\nTargets:\n" + String.join("\n", source.targets().stream().map(t -> "- " + t).toList()); + var work = works.createPrepared(root, source.id() + ": " + candidate.title(), description, candidate.title(), + "Continue the open agendas of " + source.id() + "/" + candidate.dscId(), List.of(), List.of(), List.of(), author, + (folder, seed) -> { + var prepared = seed(folder, seed, candidate, author); + // Source changes during staging cannot publish a stale Work. + verify(snapshot.watched()); return prepared; + }); + published.put(key(source.id(), candidate.dscId()), work.id()); + afterPublication.accept(work); + } + } catch (RuntimeException failure) { + int code = failure instanceof ProtocolException p ? p.exitCode() : 1; + throw new ProtocolException(code, "DF import failed: " + failure.getMessage() + "; published Works: " + published + + ". Run preview again to resume; unpublished staging may remain for inspection."); + } + return new Report(1, true, true, report.fingerprint(), report.sources(), report.discussions(), List.of(), published); + }); + } + + private Work seed(Path folder, Work work, Candidate candidate, String author) { + var imported = new ArrayList(); + String source = candidate.source().id(); + for (var original : candidate.agendas()) { + String discussionId = works.nextReference(work.discussions(), "DSC"), artifactId = works.nextReference(work.artifacts(), "ART"); + discussions.writePrepared(folder, work.id(), discussionId, utf8(original.bytes()), DiscussionEntry.Kind.NOTE, + "discussion-import:" + source, "df:" + source + ":" + original.id(), null); + artifacts.writePrepared(folder, work.id(), artifactId, original.bytes(), "Original DF agenda " + original.id(), + "discussion-framework:" + source + ":" + original.id() + ":" + original.file(), author); + imported.add(new ImportedAgenda(original.id(), original.file(), Revisions.hash(original.bytes()), discussionId, artifactId)); + work = work.reference("discussions", discussionId).reference("artifacts", artifactId); + } + String recordArtifact = works.nextReference(work.artifacts(), "ART"); + artifacts.writePrepared(folder, work.id(), recordArtifact, candidate.record(), "Original DF discussion index record " + candidate.dscId(), + "discussion-framework:" + source + ":" + candidate.dscId() + ":index-record", author); + work = work.reference("artifacts", recordArtifact); + var receipt = new Receipt(1, work.id(), source, candidate.source().path(), candidate.dscId(), candidate.source().targets(), + candidate.hash(), Revisions.hash(candidate.record()), recordArtifact, imported); + String receiptId = works.nextReference(work.artifacts(), "ART"); + artifacts.writePrepared(folder, work.id(), receiptId, Documents.json(receipt).getBytes(StandardCharsets.UTF_8), + "DF import identity and provenance", RECEIPT_ORIGIN + key(source, candidate.dscId()), author); + return work.reference("artifacts", receiptId); + } + + private Snapshot capture(Path root, List requested) { + var sources = normalize(requested); var config = new ProjectService().load(root); + var errors = new ArrayList(); var entries = new ArrayList(); var candidates = new ArrayList(); + var views = new ArrayList(); var watched = new LinkedHashMap(); + Map existing; + try { existing = existing(root); } + catch (RuntimeException e) { errors.add("Destination: " + e.getMessage()); existing = Map.of(); } + for (var source : sources) { + Path sourceRoot = Path.of(source.path()); String indexHash = null; + try { + for (var repo : config.repositories()) if (!repo.access().read() + && new ProjectService().repositoryPath(root, repo).toAbsolutePath().normalize().equals(sourceRoot)) + throw ProtocolException.validation("Source repository is not readable by project policy: " + repo.id()); + Path index = Filespace.resolve(sourceRoot, "discussion/index.ndjson"); + byte[] bytes = read(index, MAX_INDEX_BYTES); watch(watched, index, bytes); indexHash = Revisions.hash(bytes); + boolean meta = false; var seen = new HashSet(); var seenAgendas = new HashSet(); int lineNumber = 0; + for (String line : utf8(bytes).split("\n", -1)) { + lineNumber++; if (line.isBlank()) continue; + try { + var record = Documents.parseJson(line, ObjectNode.class); + if (record == null) throw ProtocolException.validation("Expected a JSON object"); + if (!meta) { + if (!text(record, "type").equals("meta") || record.get("next_id") == null || !record.get("next_id").isObject()) + throw ProtocolException.validation("First DF record must be meta with next_id"); + if (record.has("schemaVersion") && (!record.get("schemaVersion").isIntegralNumber() || record.get("schemaVersion").intValue() != 1)) + throw ProtocolException.validation("Unsupported DF schemaVersion"); + meta = true; continue; + } + if (!text(record, "type").equals("discussion")) throw ProtocolException.validation("Expected a discussion record after meta"); + readDiscussion(source, record, line.getBytes(StandardCharsets.UTF_8), seen, seenAgendas, existing, watched, entries, candidates, errors); + } catch (RuntimeException e) { errors.add(source.id() + "/index.ndjson:" + lineNumber + ": " + e.getMessage()); } + } + if (!meta) errors.add(source.id() + ": missing DF meta record"); + } catch (RuntimeException e) { errors.add(source.id() + ": " + e.getMessage()); } + views.add(new SourceView(source.id(), source.path(), source.targets(), indexHash)); + } + entries.sort(Comparator.comparing(Entry::sourceId).thenComparing(Entry::dscId)); + var destination = new TreeMap(); existing.forEach((key, value) -> destination.put(key, value.fingerprint())); + String fingerprint = Revisions.hash(Documents.json(List.of(root.toAbsolutePath().normalize().toString(), views, entries, errors, destination))); + boolean valid = errors.isEmpty() && entries.stream().noneMatch(e -> e.action() == Action.REVIEW || e.action() == Action.ERROR); + return new Snapshot(new Report(1, valid, false, fingerprint, views, entries, errors, Map.of()), List.copyOf(candidates), watched); + } + + private void readDiscussion(Source source, ObjectNode record, byte[] raw, Set seen, Set seenAgendas, + Map existing, Map watched, List entries, List candidates, List errors) { + String id = text(record, "id"); Work.identifier(id, "DSC"); + if (!seen.add(id)) throw ProtocolException.validation("Duplicate DSC ID: " + id); + String state = text(record, "status"), title = optional(record, "title", optional(record, "ticket", id)); + var agendaViews = new ArrayList(); var originals = new ArrayList(); boolean invalid = false; + JsonNode agendas = record.get("agendas"); + if (agendas != null && !agendas.isArray()) throw ProtocolException.validation("agendas must be an array: " + id); + if (agendas != null) for (int n = 0; n < agendas.size(); n++) { + JsonNode agenda = agendas.get(n); String agendaId = "entry-" + (n + 1), file = "", status = ""; + try { + agendaId = text(agenda, "id"); Work.identifier(agendaId, "AGD"); + if (!seenAgendas.add(agendaId)) throw ProtocolException.validation("Duplicate AGD ID: " + agendaId); + file = text(agenda, "file"); status = text(agenda, "status"); + Path directory = Filespace.resolve(Path.of(source.path()), "discussion/workflow/agendas"); + Path path = Filespace.resolve(directory, file); + if (!status.equals("open")) { + agendaViews.add(new AgendaView(agendaId, file, status, false, null, "Agenda status is " + status)); continue; + } + if (List.of("done", "completed", "abandoned").contains(state)) + throw ProtocolException.validation("Open agenda contradicts terminal DSC status " + state); + byte[] bytes = read(path, (int) ArtifactService.MAX_BYTES); watch(watched, path, bytes); + var metadata = Documents.metadataText(utf8(bytes)); + if (!agendaId.equals(text(metadata, "id")) || !status.equals(text(metadata, "status"))) + throw ProtocolException.validation("Agenda ID/status differs between index and Markdown"); + agendaViews.add(new AgendaView(agendaId, file, status, true, Revisions.hash(bytes), "Open agenda selected")); + originals.add(new Original(agendaId, file, path, bytes)); + } catch (RuntimeException e) { + invalid = true; errors.add(source.id() + "/" + id + "/" + agendaId + ": " + e.getMessage()); + agendaViews.add(new AgendaView(agendaId, file, status, false, null, e.getMessage())); + } + } + var prior = existing.get(key(source.id(), id)); + if (originals.isEmpty() || invalid) { + entries.add(new Entry(source.id(), id, title, agendaViews, invalid ? Action.ERROR : Action.SKIP, + prior == null ? null : prior.workId(), null, invalid ? "Invalid agenda data" : "No open agendas; any existing Work is retained")); return; + } + if (raw.length > ArtifactService.MAX_BYTES) throw ProtocolException.validation("DF discussion record exceeds the 1 MiB evidence limit"); + String hash = contentHash(source.id(), source.targets(), Revisions.hash(raw), originals.stream() + .map(a -> List.of(a.id(), a.file(), Revisions.hash(a.bytes()))).toList()); + Action action = prior == null ? Action.CREATE : prior.receipt().contentHash().equals(hash) ? Action.UNCHANGED : Action.REVIEW; + entries.add(new Entry(source.id(), id, title, agendaViews, action, prior == null ? null : prior.workId(), hash, + action == Action.CREATE ? "New source discussion" : action == Action.UNCHANGED ? "Identical import; destination refinements retained" : "Source content or targets changed; review without overwriting")); + candidates.add(new Candidate(source, id, title, raw, List.copyOf(originals), hash)); + } + + private static String contentHash(String source, List targets, String recordHash, List> agendas) { + return Revisions.hash(Documents.json(List.of(source, targets, recordHash, agendas))); + } + private static String key(String source, String dsc) { return source + ":" + dsc; } + private static String text(JsonNode node, String field) { + var value = node == null ? null : node.get(field); + if (value == null || !value.isString() || value.stringValue().isBlank()) throw ProtocolException.validation("Missing or invalid " + field); + return value.stringValue(); + } + private static String optional(JsonNode node, String field, String fallback) { + var value = node.get(field); return value != null && value.isString() && !value.stringValue().isBlank() ? value.stringValue() : fallback; + } + private static List normalize(List requested) { + if (requested == null || requested.isEmpty()) throw ProtocolException.invalid("Supply at least one --source ID=PATH"); + var ids = new HashSet(); var roots = new HashSet(); var result = new ArrayList(); + for (var source : requested) { + if (!ids.add(source.id())) throw ProtocolException.invalid("Duplicate source ID: " + source.id()); + Path path = Filespace.io(() -> Path.of(source.path()).toAbsolutePath().normalize().toRealPath()); + if (!Files.isDirectory(path, LinkOption.NOFOLLOW_LINKS)) throw ProtocolException.invalid("DF source root is not a directory: " + path); + if (path.getFileName().toString().equals("discussion") && !Files.exists(Filespace.resolve(path, "discussion/index.ndjson")) + && Files.exists(Filespace.resolve(path, "index.ndjson"))) path = path.getParent(); + if (!roots.add(path)) throw ProtocolException.invalid("Duplicate DF source root: " + path); + result.add(new Source(source.id(), path.toString(), source.targets())); + } + return result.stream().sorted(Comparator.comparing(Source::id)).toList(); + } + private static byte[] read(Path path, int limit) { + if (!Files.isRegularFile(path, LinkOption.NOFOLLOW_LINKS)) throw ProtocolException.validation("DF source is not a regular file: " + path); + return Filespace.io(() -> { + try (var input = Files.newInputStream(path, LinkOption.NOFOLLOW_LINKS)) { + byte[] bytes = input.readNBytes(limit + 1); + if (bytes.length > limit) throw ProtocolException.validation("Source exceeds " + limit + " byte limit: " + path); + return bytes; + } + }); + } + private static String utf8(byte[] bytes) { + try { return StandardCharsets.UTF_8.newDecoder().onMalformedInput(CodingErrorAction.REPORT).onUnmappableCharacter(CodingErrorAction.REPORT).decode(ByteBuffer.wrap(bytes)).toString(); } + catch (CharacterCodingException e) { throw ProtocolException.validation("Source is not valid UTF-8"); } + } + private static void watch(Map watched, Path path, byte[] bytes) { + long size = watched.values().stream().mapToLong(b -> b.length).sum() + bytes.length - (watched.containsKey(path) ? watched.get(path).length : 0); + if (size > MAX_BATCH_BYTES) throw ProtocolException.validation("DF request exceeds the 32 MiB captured-source limit"); + watched.put(path, bytes); + } + private static void verify(Map watched) { + for (var entry : watched.entrySet()) + if (!Arrays.equals(entry.getValue(), read(entry.getKey(), entry.getValue().length))) + throw ProtocolException.validation("DF source changed since preview: " + entry.getKey()); + } + private static Report error(Report report, String error) { + var errors = new ArrayList<>(report.errors()); errors.add(error); + return new Report(1, false, false, report.fingerprint(), report.sources(), report.discussions(), errors, Map.of()); + } + + private Map existing(Path root) { + var result = new TreeMap(); + for (var work : works.list(root)) for (var receipt : receipts(root, work.id())) { + String key = key(receipt.sourceId(), receipt.dscId()); + String fingerprint = Revisions.hash(Documents.json(List.of(work, discussions.list(root, work.id()), artifacts.list(root, work.id())))); + if (result.putIfAbsent(key, new Existing(receipt, work.id(), fingerprint)) != null) + throw ProtocolException.validation("Duplicate imported discussion identity: " + key); + } + return result; + } + /** Owned receipts are validated without consulting or requiring the original source directory. */ + public List receipts(Path root, String workId) { + var work = works.load(root, workId); var all = artifacts.list(root, workId); + var imports = all.stream().filter(a -> a.origin().startsWith(RECEIPT_ORIGIN)).toList(); + if (imports.isEmpty()) return List.of(); + if (imports.size() != 1) throw ProtocolException.validation("A Work must have exactly one DF import identity: " + workId); + artifacts.validate(root, workId); Path folder = works.folder(root, workId); + var byArtifact = new HashMap(); all.forEach(a -> byArtifact.put(a.id(), a)); + var byDiscussion = new HashMap(); discussions.list(root, workId).forEach(d -> byDiscussion.put(d.id(), d)); + var result = new ArrayList(); + for (var manifest : imports) { + var receipt = Documents.readJson(Filespace.resolve(folder, manifest.path()), Receipt.class); + if (!receipt.workId().equals(workId) || !manifest.origin().equals(RECEIPT_ORIGIN + key(receipt.sourceId(), receipt.dscId()))) + throw ProtocolException.validation("Invalid DF import receipt identity: " + workId); + var dsc = require(byArtifact, receipt.dscArtifactId()); + if (!dsc.sha256().equals(receipt.dscSha256())) throw ProtocolException.validation("DF discussion snapshot hash mismatch"); + var original = Documents.readJson(Filespace.resolve(folder, dsc.path()), ObjectNode.class); + if (!text(original, "id").equals(receipt.dscId())) throw ProtocolException.validation("DF discussion snapshot ID mismatch"); + var indexed = new LinkedHashMap(); JsonNode agendas = original.get("agendas"); + if (agendas == null || !agendas.isArray()) throw ProtocolException.validation("Missing original DF agendas"); + for (int n = 0; n < agendas.size(); n++) if (text(agendas.get(n), "status").equals("open")) { + String id = text(agendas.get(n), "id"); + if (indexed.putIfAbsent(id, text(agendas.get(n), "file")) != null) throw ProtocolException.validation("Duplicate original DF agenda"); + } + if (!indexed.keySet().equals(new LinkedHashSet<>(receipt.agendas().stream().map(ImportedAgenda::id).toList()))) + throw ProtocolException.validation("DF receipt does not preserve all original open agendas"); + for (var agenda : receipt.agendas()) { + var artifact = require(byArtifact, agenda.artifactId()); + var entry = byDiscussion.get(agenda.discussionId()); + if (!artifact.sha256().equals(agenda.sha256()) || !Objects.equals(indexed.get(agenda.id()), agenda.file()) || entry == null + || !entry.discussionId().equals("df:" + receipt.sourceId() + ":" + agenda.id())) + throw ProtocolException.validation("Invalid DF agenda provenance: " + agenda.id()); + var header = Documents.metadata(Filespace.resolve(folder, artifact.path())); + if (!text(header, "id").equals(agenda.id()) || !text(header, "status").equals("open")) + throw ProtocolException.validation("Invalid original agenda evidence: " + agenda.id()); + } + String hash = contentHash(receipt.sourceId(), receipt.targets(), receipt.dscSha256(), receipt.agendas().stream() + .map(a -> List.of(a.id(), a.file(), a.sha256())).toList()); + if (!hash.equals(receipt.contentHash())) throw ProtocolException.validation("DF import content hash mismatch"); + result.add(receipt); + } + return List.copyOf(result); + } + private static Artifact require(Map artifacts, String id) { + var artifact = artifacts.get(id); if (artifact == null) throw ProtocolException.validation("Missing DF original evidence: " + id); return artifact; + } + public static String markdown(Report report) { + var out = new StringBuilder("# Discussion Framework import\n\n"); + out.append("Valid: ").append(report.valid()).append("\n\nApplied: ").append(report.applied()).append("\n\nFingerprint: ").append(report.fingerprint()).append('\n'); + for (var source : report.sources()) out.append("\nSource ").append(source.id()).append(": ").append(source.path()).append("\nTargets: ").append(source.targets()).append('\n'); + for (var entry : report.discussions()) { + out.append("\n- ").append(entry.sourceId()).append('/').append(entry.dscId()).append(": ").append(entry.action()).append(" — ").append(entry.reason()); + if (entry.workId() != null) out.append(" (").append(entry.workId()).append(')'); + out.append('\n'); + for (var agenda : entry.agendas()) out.append(" - ").append(agenda.id()).append(" [").append(agenda.status()).append("] ").append(agenda.file()).append(": ").append(agenda.reason()).append('\n'); + } + for (String error : report.errors()) out.append("\nError: ").append(error).append('\n'); + if (!report.publishedWorks().isEmpty()) out.append("\nPublished Works: ").append(report.publishedWorks()).append('\n'); + return out.toString(); + } +} diff --git a/src/main/java/net/intrepid/aiengineering/legacyimport/package-info.java b/src/main/java/net/intrepid/aiengineering/legacyimport/package-info.java new file mode 100644 index 0000000..8c19267 --- /dev/null +++ b/src/main/java/net/intrepid/aiengineering/legacyimport/package-info.java @@ -0,0 +1,2 @@ +@org.springframework.modulith.ApplicationModule(allowedDependencies = {"filesystem", "project", "work", "discussion", "artifact"}) +package net.intrepid.aiengineering.legacyimport; diff --git a/src/main/java/net/intrepid/aiengineering/project/ProtocolContract.java b/src/main/java/net/intrepid/aiengineering/project/ProtocolContract.java index 742e00c..c685baa 100644 --- a/src/main/java/net/intrepid/aiengineering/project/ProtocolContract.java +++ b/src/main/java/net/intrepid/aiengineering/project/ProtocolContract.java @@ -7,8 +7,8 @@ import java.util.List; public final class ProtocolContract { private ProtocolContract() {} public static final String CLI_VERSION = "0.1.0"; - public static final int CURRENT = 1; - public static final List READABLE = List.of(1); + public static final int CURRENT = 2; + public static final List READABLE = List.of(1, 2); /** Pre-versioned manifests describe the supported baseline contract, without rewriting them. */ public static int effective(Integer declared) { return declared == null ? 1 : declared; } public static void require(Integer declared) { diff --git a/src/main/java/net/intrepid/aiengineering/project/ProtocolGuide.java b/src/main/java/net/intrepid/aiengineering/project/ProtocolGuide.java index d69777b..34ec78d 100644 --- a/src/main/java/net/intrepid/aiengineering/project/ProtocolGuide.java +++ b/src/main/java/net/intrepid/aiengineering/project/ProtocolGuide.java @@ -46,7 +46,8 @@ public final class ProtocolGuide { if (!"ai-engineering".equals(protocol) || !"ai-engineering".equals(command) || !"README.md".equals(entrypoint) || !"AGENTS.md".equals(instructions) || !"ai-engineering.yaml".equals(configuration) || !"works".equals(works) - || !"explicit-attestation".equals(humanApproval) || !"external-human-or-agent".equals(execution) || legacyImport) + || !"explicit-attestation".equals(humanApproval) || !"external-human-or-agent".equals(execution) + || (legacyImport && (ProtocolContract.effective(protocolVersion) < 2 || capabilities == null || !capabilities.contains("discussion-import")))) throw ProtocolException.validation("Unsupported protocol discovery manifest"); for (String value : List.of(entrypoint, instructions, configuration, works)) ProtocolException.text(value, "manifest path"); aliases = List.copyOf(aliases); startup = List.copyOf(startup); capabilities = List.copyOf(capabilities); diff --git a/src/main/java/net/intrepid/aiengineering/verification/CompatibilityService.java b/src/main/java/net/intrepid/aiengineering/verification/CompatibilityService.java index 5dd6f79..046b46c 100644 --- a/src/main/java/net/intrepid/aiengineering/verification/CompatibilityService.java +++ b/src/main/java/net/intrepid/aiengineering/verification/CompatibilityService.java @@ -71,8 +71,11 @@ public final class CompatibilityService { if (findings.getLast().state() == State.INVALID || findings.getLast().state() == State.UNSUPPORTED) return; var record = Documents.read(manifestPath, Artifact.class); Class receipt = record.origin().startsWith(PlanCoordinator.RECEIPT_ORIGIN) ? PlanCoordinator.Receipt.class - : record.origin().startsWith(EpicCoordinator.RECEIPT_ORIGIN) ? EpicCoordinator.Receipt.class : null; - if (receipt != null) inspect(root, relative(root, Filespace.resolve(folder, record.path())), "completion-receipt", receipt, null, false, findings); + : record.origin().startsWith(EpicCoordinator.RECEIPT_ORIGIN) ? EpicCoordinator.Receipt.class + : record.origin().startsWith(net.intrepid.aiengineering.legacyimport.DiscussionImport.RECEIPT_ORIGIN) + ? net.intrepid.aiengineering.legacyimport.DiscussionImport.Receipt.class : null; + if (receipt != null) inspect(root, relative(root, Filespace.resolve(folder, record.path())), + receipt == net.intrepid.aiengineering.legacyimport.DiscussionImport.Receipt.class ? "discussion-import-receipt" : "completion-receipt", receipt, null, false, findings); }); // Missing referenced records are not evidence of a readable historical format. try { @@ -140,7 +143,8 @@ public final class CompatibilityService { var versions = new LinkedHashMap(); var missing = new ArrayList(); try { Path path = Filespace.resolve(root, relative); - boolean json = type == ProtocolGuide.Manifest.class || type == PlanCoordinator.Receipt.class || type == EpicCoordinator.Receipt.class; + boolean json = type == ProtocolGuide.Manifest.class || type == PlanCoordinator.Receipt.class || type == EpicCoordinator.Receipt.class + || type == net.intrepid.aiengineering.legacyimport.DiscussionImport.Receipt.class; ObjectNode metadata = markdown ? Documents.metadata(path) : json ? Documents.readJson(path, ObjectNode.class) : Documents.read(path, ObjectNode.class); if (metadata == null) throw ProtocolException.validation("Expected record object"); diff --git a/src/main/java/net/intrepid/aiengineering/verification/VerificationService.java b/src/main/java/net/intrepid/aiengineering/verification/VerificationService.java index 7ce83c6..638ac63 100644 --- a/src/main/java/net/intrepid/aiengineering/verification/VerificationService.java +++ b/src/main/java/net/intrepid/aiengineering/verification/VerificationService.java @@ -91,6 +91,7 @@ public final class VerificationService { for (var step : plan.steps()) if (!work.artifacts().containsAll(step.evidence())) issues.add("Missing step evidence: " + step.id()); })); check(issues, () -> artifacts.validate(root, id)); + check(issues, () -> new net.intrepid.aiengineering.legacyimport.DiscussionImportService().receipts(root, id)); check(issues, () -> new TopicService().views(root, id)); check(issues, () -> new SurveyService().list(root, id)); check(issues, () -> new DispositionService().list(root, id)); diff --git a/src/main/java/net/intrepid/aiengineering/verification/package-info.java b/src/main/java/net/intrepid/aiengineering/verification/package-info.java index 8d2174a..08f7496 100644 --- a/src/main/java/net/intrepid/aiengineering/verification/package-info.java +++ b/src/main/java/net/intrepid/aiengineering/verification/package-info.java @@ -1,2 +1,2 @@ -@org.springframework.modulith.ApplicationModule(allowedDependencies = {"filesystem", "project", "work", "discussion", "decision", "artifact", "planning", "agent"}) +@org.springframework.modulith.ApplicationModule(allowedDependencies = {"filesystem", "project", "work", "discussion", "decision", "artifact", "planning", "agent", "legacyimport"}) package net.intrepid.aiengineering.verification; diff --git a/src/main/java/net/intrepid/aiengineering/work/WorkService.java b/src/main/java/net/intrepid/aiengineering/work/WorkService.java index e069a81..0b2c04b 100644 --- a/src/main/java/net/intrepid/aiengineering/work/WorkService.java +++ b/src/main/java/net/intrepid/aiengineering/work/WorkService.java @@ -33,6 +33,12 @@ public final class WorkService { } public Work create(Path root, String title, String description, String goal, String motivation, List constraints, List criteria, List repositories, String author) { + return createPrepared(root, title, description, goal, motivation, constraints, criteria, repositories, author, (folder, work) -> work); + } + /** Build initial child records before the Work becomes visible to readers. Caller shares the project lock. */ + public Work createPrepared(Path root, String title, String description, String goal, String motivation, + List constraints, List criteria, List repositories, String author, + java.util.function.BiFunction prepare) { return Filespace.locked(root, () -> { list(root); // Refuse to allocate an ID in a corrupt project. // The sequence is canonical; a crash may leave gaps, but identities are never reused. @@ -51,10 +57,13 @@ public final class WorkService { Filespace.directory(staging); for (String dir : List.of("discussions", "decisions", "plans", "artifacts/references", "artifacts/experiments", "artifacts/evidence", "artifacts/outputs", "runs")) Filespace.directory(Filespace.resolve(staging, dir)); - Documents.writeDocument(staging.resolve("work.md"), work, false); + var prepared = prepare.apply(staging, work); + if (!prepared.id().equals(work.id()) || !prepared.createdAt().equals(work.createdAt()) || prepared.status() != Work.Status.OPEN) + throw ProtocolException.validation("Prepared Work changed its identity or initial state"); + Documents.writeDocument(staging.resolve("work.md"), prepared, false); // Reserve before publishing. A crash can leave a gap, never reuse a reserved identity. Filespace.write(counter, Documents.yaml(new Sequence(2, "%04X".formatted(next))), Files.exists(counter)); - Filespace.moveDirectory(staging, target); return work; + Filespace.moveDirectory(staging, target); return prepared; }); } public record Sequence(int schemaVersion, String lastWork) { diff --git a/src/main/resources/protocol/README.md b/src/main/resources/protocol/README.md index a5b66fc..4329947 100644 --- a/src/main/resources/protocol/README.md +++ b/src/main/resources/protocol/README.md @@ -58,6 +58,12 @@ public command, scope, preview, backups and repeatable execution. Do not invent migration or inspect AIE source code to discover consumer update procedures; report public-interface gaps with evidence instead. +The current entry contract is 2 and advertises DF open-agenda import. Contract 1 +projects remain readable without Work migration. An import-enabled manifest needs +contract 2 and the `discussion-import` capability; older CLIs must be updated before +reading it. Refresh entry files with `onboard` after compatibility inspection, +preserving historical Works and their approvals. + ## Topics, surveys and refinement Discussion remains the refinement space: receive ideas, organize topics, investigate, @@ -248,7 +254,15 @@ never confuse a historical report with a test run performed now. Update canonical code, tests, specs and documentation. There is no mandatory Lesson entity. `work archive` retains all files/history; `work reopen --by NAME --reason TEXT` allows new evidence and reorientation while retaining earlier completion records. -Never delete history as housekeeping. Importing legacy agendas/lessons is deferred. +Never delete history as housekeeping. `import discussion --source ID=PATH` previews +DF DSCs with AGDs open; repeat sources for a multi-project umbrella and use +`--target SOURCE=TEXT` for target descriptions. Apply only with `--apply --expect` +using the returned preview fingerprint. Source paths are caller-relative; source +IDs remain stable for reimport. Whole agenda text and original evidence are kept +in one OPEN Work per source+DSC, without LLM calls or source edits. Identical imports +are skipped and changed inputs require review without overwriting. Prepared Works +publish individually; after partial publication, preview again to resume without +duplicates. Closed agendas, DECs, Plans and Lessons are not imported. ## Portable files and errors diff --git a/src/main/resources/protocol/protocol.json b/src/main/resources/protocol/protocol.json index b704f6a..af949d9 100644 --- a/src/main/resources/protocol/protocol.json +++ b/src/main/resources/protocol/protocol.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "protocolVersion": 1, + "protocolVersion": 2, "protocol": "ai-engineering", "entrypoint": "README.md", "instructions": "AGENTS.md", @@ -9,8 +9,8 @@ "command": "ai-engineering", "aliases": ["aie"], "startup": ["status --format json", "next-actions --format json", "work context --format markdown"], - "capabilities": ["protocol-compatibility", "work", "discussion", "topics", "surveys", "answer-history", "proposal-dispositions", "fixture-adapters", "local-cli-adapters", "guided-agent-setup", "agent-doctor", "agent-routing", "run-provenance", "epic", "epic-policy-authorization", "epic-propagation", "epic-reconciliation", "decision-approval", "decision-history", "plan-decision-promotion", "planning", "step-dependencies", "evidence", "completion", "plan-consolidation", "cancelled-scope-review", "work-reconciliation", "archive", "reopen"], + "capabilities": ["protocol-compatibility", "work", "discussion", "topics", "surveys", "answer-history", "proposal-dispositions", "fixture-adapters", "local-cli-adapters", "guided-agent-setup", "agent-doctor", "agent-routing", "run-provenance", "epic", "epic-policy-authorization", "epic-propagation", "epic-reconciliation", "decision-approval", "decision-history", "plan-decision-promotion", "discussion-import", "import-preview", "import-provenance", "planning", "step-dependencies", "evidence", "completion", "plan-consolidation", "cancelled-scope-review", "work-reconciliation", "archive", "reopen"], "humanApproval": "explicit-attestation", "execution": "external-human-or-agent", - "legacyImport": false + "legacyImport": true } diff --git a/src/test/java/net/intrepid/aiengineering/CompatibilityTest.java b/src/test/java/net/intrepid/aiengineering/CompatibilityTest.java index c69c802..3fb82f0 100644 --- a/src/test/java/net/intrepid/aiengineering/CompatibilityTest.java +++ b/src/test/java/net/intrepid/aiengineering/CompatibilityTest.java @@ -52,7 +52,7 @@ class CompatibilityTest { var report = inspect(); assertThat(report.state()).isEqualTo(CURRENT); assertThat(report.readable()).isTrue(); assertThat(report.migrationRequired()).isFalse(); - assertThat(report.currentProtocolVersion()).isEqualTo(1); + assertThat(report.currentProtocolVersion()).isEqualTo(2); assertThat(report.formats()).contains(FormatVersions.SEQUENCE, FormatVersions.DOCUMENT); assertThat(ok("project", "compatibility", "--format", "json")).contains("\"cliVersion\"", "\"readableVersions\"", "\"migrationRequired\" : false"); assertThat(ok("status", "--format", "json")).contains("\"compatibility\"", "\"state\" : \"CURRENT\""); diff --git a/src/test/java/net/intrepid/aiengineering/DiscussionImportTest.java b/src/test/java/net/intrepid/aiengineering/DiscussionImportTest.java new file mode 100644 index 0000000..95a2d17 --- /dev/null +++ b/src/test/java/net/intrepid/aiengineering/DiscussionImportTest.java @@ -0,0 +1,269 @@ +package net.intrepid.aiengineering; + +import net.intrepid.aiengineering.artifact.*; +import net.intrepid.aiengineering.cli.EngineeringCli; +import net.intrepid.aiengineering.discussion.*; +import net.intrepid.aiengineering.filesystem.*; +import net.intrepid.aiengineering.legacyimport.*; +import net.intrepid.aiengineering.project.*; +import net.intrepid.aiengineering.verification.*; +import net.intrepid.aiengineering.work.*; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; +import java.io.*; +import java.nio.charset.StandardCharsets; +import java.nio.file.*; +import java.util.*; +import static net.intrepid.aiengineering.legacyimport.DiscussionImport.*; +import static org.assertj.core.api.Assertions.*; + +class DiscussionImportTest { + @TempDir Path temp; + Path root, alpha, beta; + String output; + final DiscussionImportService importer = new DiscussionImportService(); + final WorkService works = new WorkService(); + void init() throws Exception { + root = Files.createDirectory(temp.resolve("destination")).toRealPath(); + new ProjectService().initialize(root, "Import destination"); + alpha = copyFixture("alpha", Files.createDirectory(temp.resolve("alpha"))); + beta = copyFixture("beta", Files.createDirectory(temp.resolve("beta"))); + } + static Path copyFixture(String name, Path target) throws Exception { + Path fixture = Path.of(Objects.requireNonNull(DiscussionImportTest.class.getResource("/discussion-import/" + name)).toURI()); + try (var files = Files.walk(fixture)) { + for (var source : files.toList()) { + Path next = target.resolve(fixture.relativize(source).toString()); + if (Files.isDirectory(source)) Files.createDirectories(next); else Files.copy(source, next); + } + } + return target.toRealPath(); + } + List sources() { return List.of(new Source("alpha", alpha.toString(), List.of("runtime", "docs")), new Source("beta", beta.toString(), List.of("studio"))); } + List betaOnly() { return List.of(new Source("beta", beta.toString(), null)); } + static Map snapshot(Path path) throws Exception { + var values = new TreeMap(); + try (var files = Files.walk(path)) { + for (var file : files.filter(Files::isRegularFile).toList()) values.put(path.relativize(file).toString(), Revisions.hash(Files.readAllBytes(file))); + } + return values; + } + int cli(Path cwd, String... args) { + var out = new StringWriter(); var err = new StringWriter(); + int code = new EngineeringCli(cwd).execute(new PrintWriter(out), new PrintWriter(err), args); + output = out + err.toString(); return code; + } + Report preview(List sources) { return importer.preview(root, sources); } + Report apply(List sources) { + var preview = preview(sources); assertThat(preview.valid()).as(preview.toString()).isTrue(); + return importer.apply(root, sources, preview.fingerprint(), "fixture-owner"); + } + Path betaAgenda() { return beta.resolve("discussion/workflow/agendas/AGD-0001-studio.md"); } + + @Test void previewIsDeterministicReadOnlyAndSelectsAgendaStateAcrossIndependentRoots() throws Exception { + init(); Files.deleteIfExists(root.resolve(".ai-engineering/.local/write.lock")); + var before = snapshot(temp); var report = preview(sources()); + assertThat(report.valid()).as(report.toString()).isTrue(); assertThat(report.applied()).isFalse(); + assertThat(report.discussions()).extracting(Entry::action).containsExactly(Action.CREATE, Action.SKIP, Action.CREATE); + assertThat(report.discussions().getFirst().agendas()).extracting(AgendaView::selected).containsExactly(true, false, true); + assertThat(report.fingerprint()).isEqualTo(preview(sources().reversed()).fingerprint()); + assertThat(snapshot(temp)).isEqualTo(before); + assertThat(Files.exists(root.resolve(".ai-engineering/.local/write.lock"))).isFalse(); + } + @Test void applyPreservesRawAgendasEvidenceTargetsAndCreatesOneOpenWorkPerSourceDsc() throws Exception { + init(); + Path original = alpha.resolve("discussion/workflow/agendas/AGD-0001-transport.md"); + Files.write(original, Files.readString(original).replace("\n", "\r\n").getBytes(StandardCharsets.UTF_8)); + var beforeAlpha = snapshot(alpha); var beforeBeta = snapshot(beta); + var report = apply(sources()); assertThat(report.publishedWorks()).hasSize(2); + var imported = works.list(root); assertThat(imported).hasSize(2); + for (var work : imported) { + assertThat(work.status()).isEqualTo(Work.Status.OPEN); + assertThat(work.decisions()).isEmpty(); assertThat(work.plans()).isEmpty(); assertThat(work.surveys()).isEmpty(); + assertThat(work.completions()).isEmpty(); assertThat(work.agentRuns()).isEmpty(); + assertThat(new VerificationService().work(root, work.id()).valid()).isTrue(); + } + var runtime = works.load(root, report.publishedWorks().get("alpha:DSC-0001")); + assertThat(runtime.description()).contains("runtime", "docs", "alpha"); assertThat(runtime.discussions()).hasSize(2); + var notes = new DiscussionService().list(root, runtime.id()); + assertThat(notes).allSatisfy(note -> assertThat(note.kind()).isEqualTo(DiscussionEntry.Kind.NOTE)); + assertThat(notes.getFirst().text()).isEqualTo(Files.readString(original)); + var receipt = importer.receipts(root, runtime.id()).getFirst(); + assertThat(receipt.agendas()).hasSize(2); assertThat(receipt.targets()).containsExactly("docs", "runtime"); + var evidence = new ArtifactService().list(root, runtime.id()); assertThat(evidence).hasSize(4); + var originalArtifact = evidence.stream().filter(a -> a.id().equals(receipt.agendas().getFirst().artifactId())).findFirst().orElseThrow(); + assertThat(Files.readAllBytes(works.folder(root, runtime.id()).resolve(originalArtifact.path()))).isEqualTo(Files.readAllBytes(original)); + var dsc = evidence.stream().filter(a -> a.id().equals(receipt.dscArtifactId())).findFirst().orElseThrow(); + assertThat(Files.readString(works.folder(root, runtime.id()).resolve(dsc.path()))).contains("custom_context", "original metadata"); + assertThat(new VerificationService().context(root, runtime.id()).discussionHistory().getFirst().text()).contains("café, λ", "Qual opção usar?"); + assertThat(snapshot(alpha)).isEqualTo(beforeAlpha); assertThat(snapshot(beta)).isEqualTo(beforeBeta); + assertThat(new CompatibilityService().inspect(root).state()).isEqualTo(CompatibilityService.State.CURRENT); + } + @Test void identicalReimportIsNoOpAfterDestinationRefinementAndSourceRelocation() throws Exception { + init(); var initial = apply(betaOnly()); String id = initial.publishedWorks().get("beta:DSC-0001"); + new DiscussionService().add(root, id, "Human refinement after migration", DiscussionEntry.Kind.NOTE, "owner", "main", null); + var before = snapshot(root); var report = preview(betaOnly()); + assertThat(report.discussions().getFirst().action()).isEqualTo(Action.UNCHANGED); + assertThat(importer.apply(root, betaOnly(), report.fingerprint(), "owner").publishedWorks()).isEmpty(); + assertThat(snapshot(root)).isEqualTo(before); + beta = Files.move(beta, temp.resolve("relocated-beta")).toRealPath(); + var relocated = preview(betaOnly()); assertThat(relocated.discussions().getFirst().action()).isEqualTo(Action.UNCHANGED); + assertThat(importer.apply(root, betaOnly(), relocated.fingerprint(), "owner").publishedWorks()).isEmpty(); + assertThat(snapshot(root)).isEqualTo(before); + } + @Test void changesRequireReviewAndNeverOverwriteOrRemoveImportedContext() throws Exception { + init(); apply(betaOnly()); var before = snapshot(root); + Files.writeString(betaAgenda(), Files.readString(betaAgenda()) + "\nNew source discussion\n"); + var report = preview(betaOnly()); assertThat(report.valid()).isFalse(); + assertThat(report.discussions().getFirst().action()).isEqualTo(Action.REVIEW); + assertThat(importer.apply(root, betaOnly(), report.fingerprint(), "owner").valid()).isFalse(); + assertThat(snapshot(root)).isEqualTo(before); + Path index = beta.resolve("discussion/index.ndjson"); + Files.writeString(index, Files.readString(index).replace("\"status\":\"open\"", "\"status\":\"accepted\"")); + Files.writeString(betaAgenda(), Files.readString(betaAgenda()).replace("status: open", "status: accepted")); + var closed = preview(betaOnly()); assertThat(closed.valid()).isTrue(); + assertThat(closed.discussions().getFirst().action()).isEqualTo(Action.SKIP); + assertThat(importer.apply(root, betaOnly(), closed.fingerprint(), "owner").publishedWorks()).isEmpty(); + assertThat(snapshot(root)).isEqualTo(before); + } + @Test void stalePreviewAndInvalidBatchAllocateNoWorks() throws Exception { + init(); var valid = preview(sources()); + Files.writeString(betaAgenda(), Files.readString(betaAgenda()) + "\nChanged after preview\n"); + var stale = importer.apply(root, sources(), valid.fingerprint(), "owner"); + assertThat(stale.valid()).isFalse(); assertThat(stale.errors()).anySatisfy(e -> assertThat(e).contains("Preview changed")); + assertThat(works.list(root)).isEmpty(); assertThat(Files.exists(root.resolve(".ai-engineering/works/.sequence.yaml"))).isFalse(); + Files.delete(betaAgenda()); var invalid = preview(sources()); assertThat(invalid.valid()).isFalse(); + assertThat(importer.apply(root, sources(), invalid.fingerprint(), "owner").valid()).isFalse(); + assertThat(works.list(root)).isEmpty(); + } + @Test void selectedIndexMarkdownMismatchTerminalDscAndDuplicatesAreDiagnosed() throws Exception { + init(); String original = Files.readString(betaAgenda()); + Files.writeString(betaAgenda(), original.replace("status: open", "status: accepted")); + assertThat(preview(betaOnly()).errors()).anySatisfy(e -> assertThat(e).contains("differs between index and Markdown")); + Files.writeString(betaAgenda(), original); + Path index = beta.resolve("discussion/index.ndjson"); String data = Files.readString(index); + Files.writeString(index, data.replace("\"id\":\"DSC-0001\",\"status\":\"open\"", "\"id\":\"DSC-0001\",\"status\":\"done\"")); + assertThat(preview(betaOnly()).errors()).anySatisfy(e -> assertThat(e).contains("terminal DSC")); + Files.writeString(index, data + data.lines().skip(1).findFirst().orElseThrow() + "\n"); + assertThat(preview(betaOnly()).errors()).anySatisfy(e -> assertThat(e).contains("Duplicate DSC")); + assertThat(works.list(root)).isEmpty(); + } + @Test void unsafePathsSymlinksAndInvalidUtf8AreBlockedWithoutReadingExternalContent() throws Exception { + init(); Path index = beta.resolve("discussion/index.ndjson"); String data = Files.readString(index); + Files.writeString(index, data.replace("AGD-0001-studio.md", "../../../../outside.md")); + assertThat(preview(betaOnly()).errors()).anySatisfy(e -> assertThat(e).contains("Path traversal")); + Files.writeString(index, data); + Path outside = temp.resolve("outside.md"); Files.writeString(outside, "External private fixture"); + Files.delete(betaAgenda()); Files.createSymbolicLink(betaAgenda(), outside); + var linked = preview(betaOnly()); assertThat(linked.valid()).isFalse(); + assertThat(linked.errors().toString()).contains("Symlink rejected").doesNotContain("External private fixture"); + Files.delete(betaAgenda()); Files.write(betaAgenda(), new byte[]{(byte)0xc3, (byte)0x28}); + assertThat(preview(betaOnly()).errors()).anySatisfy(e -> assertThat(e).contains("UTF-8")); + assertThat(works.list(root)).isEmpty(); + } + @Test void oversizedAgendaAndBrokenReceiptBlockImportAndCompatibilityInspectsReceiptVersions() throws Exception { + init(); byte[] original = Files.readAllBytes(betaAgenda()); + Files.write(betaAgenda(), new byte[(int)ArtifactService.MAX_BYTES + 1]); + assertThat(preview(betaOnly()).errors()).anySatisfy(e -> assertThat(e).contains("byte limit")); + Files.write(betaAgenda(), original); var applied = apply(betaOnly()); + String work = applied.publishedWorks().get("beta:DSC-0001"); Path folder = works.folder(root, work); + var manifest = new ArtifactService().list(root, work).stream().filter(a -> a.origin().startsWith(RECEIPT_ORIGIN)).findFirst().orElseThrow(); + Path payload = folder.resolve(manifest.path()); byte[] future = Files.readString(payload).replace("\"schemaVersion\" : 1", "\"schemaVersion\" : 99").getBytes(StandardCharsets.UTF_8); + Files.write(payload, future); + var metadata = new Artifact(1, manifest.id(), manifest.workId(), manifest.origin(), manifest.purpose(), manifest.path(), Revisions.hash(future), future.length, manifest.author(), manifest.createdAt()); + Files.writeString(payload.getParent().resolve("artifact.yaml"), Documents.yaml(metadata)); + var before = snapshot(root); + assertThat(preview(betaOnly()).valid()).isFalse(); + assertThat(new VerificationService().work(root, work).valid()).isFalse(); + assertThat(new CompatibilityService().inspect(root).state()).isEqualTo(CompatibilityService.State.UNSUPPORTED); + assertThat(snapshot(root)).isEqualTo(before); + } + @Test void cliSupportsCallerRelativeRootsDiscussionDirectoryAndExplicitProject() throws Exception { + init(); var before = snapshot(root); + String[] preview = {"--project", root.toString(), "import", "discussion", "--source", "studio=beta/discussion", "--target", "studio=editor", "--format", "json"}; + assertThat(cli(temp, preview)).as(output).isZero(); + var report = Documents.parseJson(output, Report.class); assertThat(report.valid()).isTrue(); + assertThat(snapshot(root)).isEqualTo(before); + var apply = new ArrayList<>(List.of(preview)); apply.addAll(List.of("--apply", "--expect", report.fingerprint(), "--author", "owner")); + assertThat(cli(temp, apply.toArray(String[]::new))).as(output).isZero(); + assertThat(Documents.parseJson(output, Report.class).publishedWorks()).hasSize(1); + assertThat(cli(root, "import", "discussion", "--source", "beta=" + beta, "--apply")).isEqualTo(2); + assertThat(cli(root, "import", "discussion", "--source", "beta=" + beta, "--target", "unknown=x")).isEqualTo(2); + assertThat(cli(root, "import", "discussion", "--source", "beta=" + beta, "--source", "beta=" + alpha)).isEqualTo(2); + assertThat(cli(root, "import", "discussion", "--source", "beta=" + beta, "--source", "other=" + beta)).isEqualTo(2); + } + @Test void projectReadPolicyAndChangedTargetsAreRespected() throws Exception { + init(); apply(betaOnly()); var changed = preview(List.of(new Source("beta", beta.toString(), List.of("new-target")))); + assertThat(changed.valid()).isFalse(); assertThat(changed.discussions().getFirst().action()).isEqualTo(Action.REVIEW); + Path restricted = Files.createDirectory(root.resolve("restricted")); copyFixture("beta", restricted); + var config = new ProjectService().load(root); + var updated = new ProjectConfig(1, config.project(), List.of(new ProjectConfig.Repository("restricted", "restricted", "linked-git", null, new ProjectConfig.Access(false, false), List.of())), null); + Files.writeString(root.resolve(".ai-engineering/ai-engineering.yaml"), Documents.yaml(updated)); + var denied = preview(List.of(new Source("restricted", restricted.toString(), null))); + assertThat(denied.valid()).isFalse(); assertThat(denied.errors()).anySatisfy(e -> assertThat(e).contains("not readable by project policy")); + assertThat(denied.sources().getFirst().indexSha256()).isNull(); + } + @Test void completedArchivedImportsRemainUnchanged() throws Exception { + init(); String id = apply(betaOnly()).publishedWorks().get("beta:DSC-0001"); + assertThat(cli(root, "work", "update", id, "--acceptance", "Original agenda remains available")).as(output).isZero(); + assertThat(cli(root, "work", "complete", id, "--by", "fixture-owner", "--summary", "Fixture original verified", "--human-approved", + "--criterion", "1=ART-0001", "--no-integration-needed", "Disposable import fixture")).as(output).isZero(); + assertThat(cli(root, "work", "archive", id, "--by", "fixture-owner", "--reason", "Fixture retained")).as(output).isZero(); + var before = snapshot(root); var report = preview(betaOnly()); + assertThat(report.discussions().getFirst().action()).isEqualTo(Action.UNCHANGED); + assertThat(importer.apply(root, betaOnly(), report.fingerprint(), "owner").publishedWorks()).isEmpty(); + assertThat(snapshot(root)).isEqualTo(before); assertThat(new VerificationService().project(root).valid()).isTrue(); + } + @Test void malformedIndexesDuplicateAgendasAndAggregateByteLimitAreRejected() throws Exception { + init(); Path index = beta.resolve("discussion/index.ndjson"); String original = Files.readString(index); + Files.writeString(index, original + "{broken\n"); + assertThat(preview(betaOnly()).valid()).isFalse(); + Files.writeString(index, original.replace("\"type\":\"meta\"", "\"type\":\"meta\",\"schemaVersion\":99")); + assertThat(preview(betaOnly()).errors()).anySatisfy(e -> assertThat(e).contains("Unsupported DF schemaVersion")); + String agenda = "{\"id\":\"AGD-0001\",\"file\":\"AGD-0001-studio.md\",\"status\":\"open\"}"; + Files.writeString(index, original.replace(agenda, agenda + "," + agenda)); + assertThat(preview(betaOnly()).errors()).anySatisfy(e -> assertThat(e).contains("Duplicate AGD")); + var large = new ArrayList(); + byte[] meta = "{\"type\":\"meta\",\"next_id\":{}}\n".getBytes(StandardCharsets.UTF_8); + for (int n = 0; n < 5; n++) { + Path source = Files.createDirectories(temp.resolve("large-" + n).resolve("discussion")); + byte[] bytes = new byte[DiscussionImportService.MAX_INDEX_BYTES]; Arrays.fill(bytes, (byte)' '); System.arraycopy(meta, 0, bytes, 0, meta.length); + Files.write(source.resolve("index.ndjson"), bytes); large.add(new Source("large-" + n, source.getParent().toString(), null)); + } + var oversized = preview(large); assertThat(oversized.valid()).isFalse(); + assertThat(oversized.errors()).anySatisfy(e -> assertThat(e).contains("32 MiB")); + assertThat(works.list(root)).isEmpty(); + } + @Test void discoveryManifestAdvertisesOnlySupportedImportAndLegacyFalseRemainsReadable() throws Exception { + init(); Path manifest = root.resolve(".ai-engineering/protocol.json"); + String advertised = Files.readString(manifest); + assertThat(advertised).contains("\"legacyImport\": true", "discussion-import"); + assertThat(new VerificationService().project(root).valid()).isTrue(); + Files.writeString(manifest, advertised.replace("\"legacyImport\": true", "\"legacyImport\": false").replace("\"protocolVersion\": 2", "\"protocolVersion\": 1")); + assertThat(new VerificationService().project(root).valid()).isTrue(); + assertThat(new CompatibilityService().inspect(root).state()).isEqualTo(CompatibilityService.State.LEGACY_COMPATIBLE); + Files.writeString(manifest, advertised.replace("\"protocolVersion\": 2", "\"protocolVersion\": 1")); + assertThat(new VerificationService().project(root).valid()).isFalse(); + Files.writeString(manifest, advertised.replace("discussion-import", "unsupported-import")); + assertThat(new CompatibilityService().inspect(root).readable()).isFalse(); + assertThat(new VerificationService().project(root).valid()).isFalse(); + } + @Test void concurrentJvmApplicationsDoNotDuplicateSourceIdentities() throws Exception { + init(); var preview = preview(sources()); + var command = List.of(Path.of(System.getProperty("java.home"), "bin", "java").toString(), "-jar", System.getProperty("cli.jar"), + "--project", root.toString(), "import", "discussion", "--source", "alpha=" + alpha, "--source", "beta=" + beta, + "--target", "alpha=runtime", "--target", "alpha=docs", "--target", "beta=studio", "--apply", "--expect", preview.fingerprint(), "--format", "json"); + var first = new ProcessBuilder(command).redirectErrorStream(true).start(); var second = new ProcessBuilder(command).redirectErrorStream(true).start(); + var codes = new ArrayList(); + try { + for (var process : List.of(first, second)) { + assertThat(process.waitFor(45, java.util.concurrent.TimeUnit.SECONDS)).isTrue(); + String result = new String(process.getInputStream().readAllBytes(), StandardCharsets.UTF_8); + assertThat(process.exitValue()).as(result).isIn(0, 4); codes.add(process.exitValue()); + } + } finally { first.destroyForcibly(); second.destroyForcibly(); } + assertThat(codes).containsExactlyInAnyOrder(0, 4); assertThat(works.list(root)).hasSize(2); + assertThat(preview(sources()).discussions()).filteredOn(e -> e.action() != Action.SKIP).allSatisfy(e -> assertThat(e.action()).isEqualTo(Action.UNCHANGED)); + assertThat(new VerificationService().project(root).valid()).isTrue(); + } +} diff --git a/src/test/java/net/intrepid/aiengineering/legacyimport/DiscussionImportRecoveryTest.java b/src/test/java/net/intrepid/aiengineering/legacyimport/DiscussionImportRecoveryTest.java new file mode 100644 index 0000000..0a8a9a5 --- /dev/null +++ b/src/test/java/net/intrepid/aiengineering/legacyimport/DiscussionImportRecoveryTest.java @@ -0,0 +1,46 @@ +package net.intrepid.aiengineering.legacyimport; + +import net.intrepid.aiengineering.filesystem.*; +import net.intrepid.aiengineering.project.ProjectService; +import net.intrepid.aiengineering.verification.VerificationService; +import net.intrepid.aiengineering.work.WorkService; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; +import java.nio.file.*; +import java.util.*; +import static net.intrepid.aiengineering.legacyimport.DiscussionImport.*; +import static org.assertj.core.api.Assertions.*; + +class DiscussionImportRecoveryTest { + @TempDir Path temp; + @Test void interruptionBetweenPublishedWorksResumesWithoutDuplicationOrRewriting() throws Exception { + Path root = Files.createDirectory(temp.resolve("target")).toRealPath(); new ProjectService().initialize(root, "Target"); + var sources = new ArrayList(); + for (String id : List.of("alpha", "beta")) { + Path from = Path.of(Objects.requireNonNull(getClass().getResource("/discussion-import/" + id)).toURI()); + Path to = Files.createDirectory(temp.resolve(id)); + try (var files = Files.walk(from)) { + for (var file : files.toList()) { + Path target = to.resolve(from.relativize(file).toString()); + if (Files.isDirectory(file)) Files.createDirectories(target); else Files.copy(file, target); + } + } + sources.add(new Source(id, to.toRealPath().toString(), null)); + } + var faulty = new DiscussionImportService(work -> { throw new ProtocolException(1, "Simulated interruption after directory publication"); }); + var preview = faulty.preview(root, sources); + assertThatThrownBy(() -> faulty.apply(root, sources, preview.fingerprint(), "tester")) + .isInstanceOf(ProtocolException.class).hasMessageContaining("published Works: {alpha:DSC-0001=WRK-0001}"); + var works = new WorkService(); assertThat(works.list(root)).hasSize(1); + assertThat(new VerificationService().project(root).valid()).isTrue(); + Path first = works.folder(root, "WRK-0001"); var snapshot = new TreeMap(); + try (var files = Files.walk(first)) { for (var p : files.filter(Files::isRegularFile).toList()) snapshot.put(p.toString(), Files.readString(p)); } + var recovered = new DiscussionImportService(); var remaining = recovered.preview(root, sources); + assertThat(remaining.discussions()).extracting(Entry::action).containsExactly(Action.UNCHANGED, Action.SKIP, Action.CREATE); + var applied = recovered.apply(root, sources, remaining.fingerprint(), "tester"); + assertThat(applied.publishedWorks()).containsExactlyEntriesOf(Map.of("beta:DSC-0001", "WRK-0002")); + assertThat(works.list(root)).hasSize(2); + for (var entry : snapshot.entrySet()) assertThat(Files.readString(Path.of(entry.getKey()))).isEqualTo(entry.getValue()); + assertThat(new VerificationService().project(root).valid()).isTrue(); + } +} diff --git a/src/test/resources/discussion-import/alpha/discussion/index.ndjson b/src/test/resources/discussion-import/alpha/discussion/index.ndjson new file mode 100644 index 0000000..735e5ce --- /dev/null +++ b/src/test/resources/discussion-import/alpha/discussion/index.ndjson @@ -0,0 +1,3 @@ +{"type":"meta","next_id":{"DSC":3,"AGD":5,"DEC":1,"PLN":1,"LSN":1,"CLSN":1}} +{"type":"discussion","id":"DSC-0001","status":"in_progress","ticket":"transport","title":"Transportes e documentação","tags":["runtime"],"agendas":[{"id":"AGD-0001","file":"AGD-0001-transport.md","status":"open"},{"id":"AGD-0002","file":"AGD-0002-accepted.md","status":"accepted"},{"id":"AGD-0003","file":"AGD-0003-docs.md","status":"open"}],"decisions":[],"plans":[],"lessons":[],"custom_context":{"retain":"original metadata"}} +{"type":"discussion","id":"DSC-0002","status":"done","ticket":"delivered","title":"Já entregue","agendas":[{"id":"AGD-0004","file":"AGD-0004-removed.md","status":"done"}],"decisions":[],"plans":[],"lessons":[]} diff --git a/src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0001-transport.md b/src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0001-transport.md new file mode 100644 index 0000000..2fc5ad9 --- /dev/null +++ b/src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0001-transport.md @@ -0,0 +1,28 @@ +--- +id: AGD-0001 +ticket: transport +title: "Transporte: opções e limites" +status: open +created: 2026-11-16 +resolved: +decision: +tags: [runtime] +--- + +## Context + +Preservar café, λ e dados sem sumarização. + +## Open Questions + +- [ ] Qual opção usar? + +## Options + +### A + +Texto completo, incluindo alternativas. + +## Discussion + +Ainda não há resposta humana. diff --git a/src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0002-accepted.md b/src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0002-accepted.md new file mode 100644 index 0000000..c48a74e --- /dev/null +++ b/src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0002-accepted.md @@ -0,0 +1,6 @@ +--- +id: AGD-0002 +status: accepted +--- + +Esta agenda não deve ser importada. diff --git a/src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0003-docs.md b/src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0003-docs.md new file mode 100644 index 0000000..c5cdcf7 --- /dev/null +++ b/src/test/resources/discussion-import/alpha/discussion/workflow/agendas/AGD-0003-docs.md @@ -0,0 +1,14 @@ +--- +id: AGD-0003 +ticket: transport +title: Documentação +status: open +--- + +## Pain + +Documentar os targets sem inventar decisões. + +## Open Questions + +- [ ] Qual formato deixa o contexto claro? diff --git a/src/test/resources/discussion-import/beta/discussion/index.ndjson b/src/test/resources/discussion-import/beta/discussion/index.ndjson new file mode 100644 index 0000000..6aeec42 --- /dev/null +++ b/src/test/resources/discussion-import/beta/discussion/index.ndjson @@ -0,0 +1,2 @@ +{"type":"meta","next_id":{"DSC":2,"AGD":2,"DEC":1,"PLN":1,"LSN":1,"CLSN":1}} +{"type":"discussion","id":"DSC-0001","status":"open","ticket":"studio","title":"Studio tools","tags":[],"agendas":[{"id":"AGD-0001","file":"AGD-0001-studio.md","status":"open"}],"decisions":[],"plans":[],"lessons":[]} diff --git a/src/test/resources/discussion-import/beta/discussion/workflow/agendas/AGD-0001-studio.md b/src/test/resources/discussion-import/beta/discussion/workflow/agendas/AGD-0001-studio.md new file mode 100644 index 0000000..72a18bf --- /dev/null +++ b/src/test/resources/discussion-import/beta/discussion/workflow/agendas/AGD-0001-studio.md @@ -0,0 +1,14 @@ +--- +id: AGD-0001 +ticket: studio +title: Studio tools +status: open +--- + +## Context + +Outro projeto com os mesmos IDs locais. + +## Open Questions + +- [ ] Como organizar as ferramentas?