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:
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
}
|
||||
|
||||
+12
@@ -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"
|
||||
+89
@@ -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.
|
||||
+12
@@ -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"
|
||||
+12
@@ -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"
|
||||
}
|
||||
}
|
||||
+13
@@ -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"
|
||||
+26
@@ -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
|
||||
+12
@@ -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"
|
||||
+34
@@ -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"
|
||||
}
|
||||
}
|
||||
+12
@@ -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"
|
||||
+45
@@ -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
|
||||
+12
@@ -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"
|
||||
+38
@@ -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"
|
||||
}
|
||||
}
|
||||
+12
@@ -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"
|
||||
+13
@@ -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"
|
||||
}
|
||||
+12
@@ -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"
|
||||
+9
@@ -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).
|
||||
+12
@@ -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"
|
||||
+43
@@ -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
|
||||
]
|
||||
}
|
||||
+12
@@ -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"
|
||||
+94
@@ -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.
|
||||
+12
@@ -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"
|
||||
+10
@@ -0,0 +1,10 @@
|
||||
{
|
||||
"schemaVersion" : 1,
|
||||
"workId" : "WRK-0007",
|
||||
"inputHash" : "5d44de8fb24111ba741d65ab7d5ab5ae8e7dccee4d7d65c42e3dffb9c5db748c",
|
||||
"plans" : [ {
|
||||
"id" : "PLN-0001",
|
||||
"revision" : 20,
|
||||
"sha256" : "8361eca97aa7c107e3ccda8e71d473e9fa670aa9c7e99e5b69628ef31fa6424f"
|
||||
} ]
|
||||
}
|
||||
+13
@@ -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
|
||||
+13
@@ -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.
|
||||
+132
@@ -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.
|
||||
+134
@@ -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.
|
||||
+138
@@ -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.
|
||||
+138
@@ -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.
|
||||
+140
@@ -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.
|
||||
+141
@@ -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.
|
||||
+145
@@ -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.
|
||||
+145
@@ -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.
|
||||
+149
@@ -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.
|
||||
+149
@@ -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.
|
||||
+156
@@ -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.
|
||||
+155
@@ -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.
|
||||
+165
@@ -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.
|
||||
+60
-30
@@ -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
|
||||
---
|
||||
|
||||
|
||||
+71
-4
@@ -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:
|
||||
|
||||
@@ -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
@@ -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.
|
||||
|
||||
@@ -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 |
|
||||
|
||||
@@ -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
@@ -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
@@ -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
@@ -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) {
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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();
|
||||
}
|
||||
}
|
||||
+46
@@ -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":[]}
|
||||
+28
@@ -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.
|
||||
+6
@@ -0,0 +1,6 @@
|
||||
---
|
||||
id: AGD-0002
|
||||
status: accepted
|
||||
---
|
||||
|
||||
Esta agenda não deve ser importada.
|
||||
+14
@@ -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":[]}
|
||||
+14
@@ -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?
|
||||
Reference in New Issue
Block a user