feat: import open Discussion Framework agendas into Works

Add deterministic preview and fingerprint-bound application for independent
DF sources under an AIE umbrella. Preserve complete agendas and original
evidence with source-scoped identities, validated receipts and safe retries.

Publish prepared Works atomically, require review for changed imports and
retain existing refinement without source edits or model calls.

Advertise protocol contract 2 while continuing to read contract-1 projects. Add JVM,
concurrency, recovery and native coverage; document usage and complete
WRK-0007 with verification evidence.
This commit is contained in:
2026-11-16 14:53:05 +00:00
parent bc9fe8152c
commit 8f6cfa5d86
74 changed files with 3663 additions and 78 deletions
+15 -1
View File
@@ -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
+3 -3
View File
@@ -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 <WRK> --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
}
@@ -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"
@@ -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 <preview-fingerprint> --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.
@@ -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"
@@ -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"
}
}
@@ -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"
@@ -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
@@ -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"
@@ -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"
}
}
@@ -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"
@@ -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
@@ -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"
@@ -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"
}
}
@@ -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"
@@ -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"
}
@@ -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"
@@ -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).
@@ -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"
@@ -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
]
}
@@ -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"
@@ -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 <fingerprint-da-previa> --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.
@@ -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"
@@ -0,0 +1,10 @@
{
"schemaVersion" : 1,
"workId" : "WRK-0007",
"inputHash" : "5d44de8fb24111ba741d65ab7d5ab5ae8e7dccee4d7d65c42e3dffb9c5db748c",
"plans" : [ {
"id" : "PLN-0001",
"revision" : 20,
"sha256" : "8361eca97aa7c107e3ccda8e71d473e9fa670aa9c7e99e5b69628ef31fa6424f"
} ]
}
@@ -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
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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
---
@@ -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:
+12
View File
@@ -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 <preview-fingerprint>
```
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`.
+16 -5
View File
@@ -45,6 +45,7 @@ its explicit public API; implementation-only Git adapters live in `project.inter
| discussion | Entries, topics, surveys, answer history and proposal dispositions | work, project, artifact, filesystem |
| decision | Draft, approval, revision and supersession records | work, filesystem |
| planning | Lightweight plans, dependencies, step results and revision history | work, decision, artifact, filesystem |
| legacyimport | DF preview, original agenda evidence, provenance and prepared Work publication | filesystem, project, work, discussion, artifact |
| artifact | Small evidence payloads and integrity metadata | work, filesystem |
| agent | Adapter contract, deterministic fixtures, routing and proposal application | project, work, discussion, decision, planning, artifact, filesystem |
| verification | Structural conformance, context, reviewed closure and deterministic EPIC coordination | all protocol modules |
@@ -261,8 +262,18 @@ No legacy HTTP adapter, NDJSON global index, accepted-agenda gate, automatic hou
deletion or Lesson model was retained. Work is the project-scoped aggregate; Discussion
is refinement within a Work. Source repositories were not changed.
There is no automated legacy importer. Migration is deferred until the operational
replacement is established. A future importer should create
one Work per coherent agenda, retain original discussion/decision text with origin
references, and verify identifiers and links before publication. Legacy Lessons should
be reviewed for integration into canonical docs, not recreated as a required entity.
The deterministic DF importer reads each independent source's NDJSON index and open
AGDs. It creates one Work per source+DSC, retaining agenda Markdown as refinement
NOTEs and original bytes as evidence. A versioned owned receipt links source IDs,
DSCs, AGDs, target descriptions and generated AIE references; existing Work schemas
and historical data remain unchanged. Receipt validation is available without the
source directory and compatibility inspection recognizes the receipt format.
Work, Discussion and Artifact expose prepared publication helpers using their normal
formats. The importer seeds a complete hidden Work folder before the normal atomic
directory publication and monotonic ID reservation. Revalidation under the destination
lock binds application to the preview fingerprint; immutable receipts make retry
recognize already published Works. A multi-Work batch is deliberately not a global
transaction. No legacy decision/Plan/Lesson is imported, source files are untouched
and no agent adapter is involved. See [the import contract](discussion-import.md).
Legacy Lessons remain candidates for manual integration into canonical docs.
+7
View File
@@ -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 |
+94
View File
@@ -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 <preview-fingerprint> --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.
+9 -1
View File
@@ -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
+7 -4
View File
@@ -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
+39 -2
View File
@@ -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
@@ -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);
}
@@ -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());
@@ -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<Integer> {
@Option(names = "--source", required = true, description = "Stable source ID=PATH; repeat for independent DF projects. Paths are caller-relative.") List<String> sources;
@Option(names = "--target", description = "SOURCE=TEXT target description; repeat for multiple targets.") List<String> 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<String, String>(); var targetMap = new java.util.HashMap<String, List<String>>();
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;
}
@@ -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;
@@ -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<String> backups) {
public MigrationReport { backups = List.copyOf(backups); }
}
@@ -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);
@@ -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<String> 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<String> 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<AgendaView> 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<SourceView> sources, List<Entry> discussions, List<String> errors, Map<String, String> 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<String> targets, String contentHash, String dscSha256, String dscArtifactId, List<ImportedAgenda> 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");
}
}
@@ -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<Work> afterPublication;
public DiscussionImportService() { this(work -> {}); }
/** Fault injection at the batch publication boundary; not exposed by the CLI. */
DiscussionImportService(java.util.function.Consumer<Work> 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<Original> agendas, String hash) {}
private record Existing(Receipt receipt, String workId, String fingerprint) {}
private record Snapshot(Report report, List<Candidate> candidates, Map<Path, byte[]> watched) {}
public Report preview(Path root, List<Source> sources) { return capture(root, sources).report(); }
public Report apply(Path root, List<Source> 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<String, String>();
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<ImportedAgenda>();
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<Source> requested) {
var sources = normalize(requested); var config = new ProjectService().load(root);
var errors = new ArrayList<String>(); var entries = new ArrayList<Entry>(); var candidates = new ArrayList<Candidate>();
var views = new ArrayList<SourceView>(); var watched = new LinkedHashMap<Path, byte[]>();
Map<String, Existing> 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<String>(); var seenAgendas = new HashSet<String>(); 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<String, String>(); 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<String> seen, Set<String> seenAgendas,
Map<String, Existing> existing, Map<Path, byte[]> watched, List<Entry> entries, List<Candidate> candidates, List<String> 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<AgendaView>(); var originals = new ArrayList<Original>(); 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<String> targets, String recordHash, List<List<String>> 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<Source> normalize(List<Source> requested) {
if (requested == null || requested.isEmpty()) throw ProtocolException.invalid("Supply at least one --source ID=PATH");
var ids = new HashSet<String>(); var roots = new HashSet<Path>(); var result = new ArrayList<Source>();
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<Path, byte[]> 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<Path, byte[]> 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<String, Existing> existing(Path root) {
var result = new TreeMap<String, Existing>();
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<Receipt> 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<String, Artifact>(); all.forEach(a -> byArtifact.put(a.id(), a));
var byDiscussion = new HashMap<String, DiscussionEntry>(); discussions.list(root, workId).forEach(d -> byDiscussion.put(d.id(), d));
var result = new ArrayList<Receipt>();
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<String, String>(); 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<String, Artifact> 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();
}
}
@@ -0,0 +1,2 @@
@org.springframework.modulith.ApplicationModule(allowedDependencies = {"filesystem", "project", "work", "discussion", "artifact"})
package net.intrepid.aiengineering.legacyimport;
@@ -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<Integer> READABLE = List.of(1);
public static final int CURRENT = 2;
public static final List<Integer> 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) {
@@ -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);
@@ -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<String, String>(); var missing = new ArrayList<String>();
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");
@@ -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));
@@ -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;
@@ -33,6 +33,12 @@ public final class WorkService {
}
public Work create(Path root, String title, String description, String goal, String motivation,
List<String> constraints, List<String> criteria, List<String> 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<String> constraints, List<String> criteria, List<String> repositories, String author,
java.util.function.BiFunction<Path, Work, Work> 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) {
+15 -1
View File
@@ -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
+3 -3
View File
@@ -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 <WRK> --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
}
@@ -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\"");
@@ -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<Source> sources() { return List.of(new Source("alpha", alpha.toString(), List.of("runtime", "docs")), new Source("beta", beta.toString(), List.of("studio"))); }
List<Source> betaOnly() { return List.of(new Source("beta", beta.toString(), null)); }
static Map<String, String> snapshot(Path path) throws Exception {
var values = new TreeMap<String, String>();
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<Source> sources) { return importer.preview(root, sources); }
Report apply(List<Source> 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<Source>();
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<Integer>();
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();
}
}
@@ -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<Source>();
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<String, String>();
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();
}
}
@@ -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":[]}
@@ -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.
@@ -0,0 +1,6 @@
---
id: AGD-0002
status: accepted
---
Esta agenda não deve ser importada.
@@ -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?
@@ -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":[]}
@@ -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?