From bc9fe8152c983bb076a17a5ef453f6d802a2fa22 Mon Sep 17 00:00:00 2001 From: bQUARKz Date: Mon, 16 Nov 2026 12:35:06 +0000 Subject: [PATCH] feat: promote draft decisions when creating plans Promote referenced drafts deterministically with system provenance, causal Plan links, supersession history and recovery from publication failures. Preserve direct human approval and historical records. Add JVM and native regression coverage and update the portable protocol. Record the WRK-0007 importer decision and six-step plan, and complete WRK-0008 with verification evidence. --- .ai-engineering/README.md | 15 ++ .ai-engineering/protocol.json | 2 +- .ai-engineering/works/.sequence.yaml | 2 +- .../artifacts/evidence/ART-0001/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0001/payload | 86 ++++++++ .../artifacts/evidence/ART-0002/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0002/payload | 138 ++++++++++++ .../artifacts/evidence/ART-0003/artifact.yaml | 11 + .../artifacts/evidence/ART-0003/payload | 45 ++++ .../artifacts/evidence/ART-0004/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0004/payload | 93 +++++++++ .../artifacts/evidence/ART-0005/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0005/payload | 23 ++ .../artifacts/evidence/ART-0006/artifact.yaml | 13 ++ .../artifacts/evidence/ART-0006/payload | 30 +++ .../decisions/.history/DEC-0001/r0001.md | 115 ++++++++++ .../decisions/DEC-0001.md | 124 +++++++++++ .../discussions/DSC-0001.md | 13 ++ .../discussions/DSC-0002.md | 13 ++ .../discussions/DSC-0003.md | 13 ++ .../discussions/DSC-0004.md | 13 ++ .../discussions/DSC-0005.md | 13 ++ .../discussions/DSC-0006.md | 13 ++ .../discussions/DSC-0007.md | 13 ++ .../discussions/DSC-0008.md | 13 ++ .../discussions/DSC-0009.md | 13 ++ .../discussions/DSC-0010.md | 13 ++ .../discussions/DSC-0011.md | 13 ++ .../plans/.history/PLN-0001/r0001.md | 20 ++ .../plans/.history/PLN-0001/r0002.md | 38 ++++ .../plans/.history/PLN-0001/r0003.md | 57 +++++ .../plans/.history/PLN-0001/r0004.md | 75 +++++++ .../plans/.history/PLN-0001/r0005.md | 94 +++++++++ .../plans/.history/PLN-0001/r0006.md | 113 ++++++++++ .../plans/PLN-0001.md | 132 ++++++++++++ .../surveys/.history/SVY-0001/r0001.md | 18 ++ .../surveys/.history/SVY-0001/r0002.md | 33 +++ .../surveys/.history/SVY-0001/r0003.md | 47 +++++ .../surveys/.history/SVY-0001/r0004.md | 62 ++++++ .../surveys/.history/SVY-0001/r0005.md | 76 +++++++ .../surveys/.history/SVY-0001/r0006.md | 92 ++++++++ .../surveys/.history/SVY-0001/r0007.md | 105 ++++++++++ .../surveys/.history/SVY-0001/r0008.md | 113 ++++++++++ .../surveys/.history/SVY-0001/r0009.md | 121 +++++++++++ .../surveys/.history/SVY-0001/r0010.md | 129 ++++++++++++ .../surveys/.history/SVY-0001/r0011.md | 137 ++++++++++++ .../surveys/.history/SVY-0001/r0012.md | 146 +++++++++++++ .../surveys/.history/SVY-0001/r0013.md | 154 ++++++++++++++ .../surveys/.history/SVY-0001/r0014.md | 164 +++++++++++++++ .../surveys/.history/SVY-0001/r0015.md | 174 ++++++++++++++++ .../surveys/.history/SVY-0001/r0016.md | 181 ++++++++++++++++ .../surveys/.history/SVY-0001/r0017.md | 189 +++++++++++++++++ .../surveys/SVY-0001.md | 197 ++++++++++++++++++ .../work.md | 69 ++++++ .../artifacts/evidence/ART-0001/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0001/payload | 18 ++ .../artifacts/evidence/ART-0002/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0002/payload | 26 +++ .../artifacts/evidence/ART-0003/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0003/payload | 46 ++++ .../artifacts/evidence/ART-0004/artifact.yaml | 13 ++ .../artifacts/evidence/ART-0004/payload | 49 +++++ .../artifacts/evidence/ART-0005/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0005/payload | 109 ++++++++++ .../artifacts/evidence/ART-0006/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0006/payload | 8 + .../artifacts/evidence/ART-0007/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0007/payload | 29 +++ .../artifacts/evidence/ART-0008/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0008/payload | 40 ++++ .../artifacts/evidence/ART-0009/artifact.yaml | 12 ++ .../artifacts/evidence/ART-0009/payload | 10 + .../decisions/.history/DEC-0001/r0001.md | 33 +++ .../decisions/DEC-0001.md | 42 ++++ .../discussions/DSC-0001.md | 13 ++ .../discussions/DSC-0002.md | 13 ++ .../plans/.history/PLN-0001/r0001.md | 20 ++ .../plans/.history/PLN-0001/r0002.md | 35 ++++ .../plans/.history/PLN-0001/r0003.md | 49 +++++ .../plans/.history/PLN-0001/r0004.md | 64 ++++++ .../plans/.history/PLN-0001/r0005.md | 66 ++++++ .../plans/.history/PLN-0001/r0006.md | 70 +++++++ .../plans/.history/PLN-0001/r0007.md | 70 +++++++ .../plans/.history/PLN-0001/r0008.md | 74 +++++++ .../plans/.history/PLN-0001/r0009.md | 75 +++++++ .../plans/.history/PLN-0001/r0010.md | 80 +++++++ .../plans/PLN-0001.md | 78 +++++++ .../work.md | 89 ++++++++ README.md | 4 + docs/architecture.md | 9 + docs/protocol.md | 24 ++- scripts/native-smoke.sh | 26 +++ .../intrepid/aiengineering/NativeHints.java | 2 +- .../aiengineering/cli/EngineeringCli.java | 2 +- .../aiengineering/decision/Decision.java | 40 +++- .../decision/DecisionService.java | 63 ++++++ .../aiengineering/planning/PlanService.java | 27 ++- .../verification/VerificationService.java | 8 +- src/main/resources/protocol/README.md | 15 ++ src/main/resources/protocol/protocol.json | 2 +- .../PlanDecisionPromotionTest.java | 175 ++++++++++++++++ 101 files changed, 5322 insertions(+), 14 deletions(-) create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0001/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0001/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0002/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0002/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0003/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0003/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0004/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0004/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0005/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0005/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0006/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0006/payload create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/decisions/.history/DEC-0001/r0001.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/decisions/DEC-0001.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0001.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0002.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0003.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0004.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0005.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0006.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0007.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0008.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0009.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0010.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0011.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0001.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0002.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0003.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0004.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0005.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0006.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/PLN-0001.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0001.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0002.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0003.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0004.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0005.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0006.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0007.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0008.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0009.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0010.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0011.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0012.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0013.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0014.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0015.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0016.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0017.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/SVY-0001.md create mode 100644 .ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/work.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0001/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0001/payload create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0002/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0002/payload create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0003/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0003/payload create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0004/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0004/payload create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0005/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0005/payload create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0006/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0006/payload create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0007/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0007/payload create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0008/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0008/payload create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0009/artifact.yaml create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0009/payload create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/decisions/.history/DEC-0001/r0001.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/decisions/DEC-0001.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/discussions/DSC-0001.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/discussions/DSC-0002.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0001.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0002.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0003.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0004.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0005.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0006.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0007.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0008.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0009.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0010.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/PLN-0001.md create mode 100644 .ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/work.md create mode 100644 src/test/java/net/intrepid/aiengineering/PlanDecisionPromotionTest.java diff --git a/.ai-engineering/README.md b/.ai-engineering/README.md index 501e4d1..a5b66fc 100644 --- a/.ai-engineering/README.md +++ b/.ai-engineering/README.md @@ -183,6 +183,13 @@ in history. Use `decision revise` for a new draft based on a prior accepted/reje decision; acceptance supersedes the prior accepted decision while retaining history. Accepted decisions cannot be silently edited. Use `--by` and `--reason` on changes. +Creating a Plan from a DRAFT decision promotes it automatically. This deterministic +framework action needs no LLM or preceding `decision accept` command. It records +`origin: SYSTEM_PLAN`, the causal `planId`, actor `system:planning` and +`humanApproved: false`, preserving history and any supersession. It is distinct +from the explicit human-attestation route above. Drafts still need nonblank context, +approach and rationale; rejected/superseded decisions remain invalid Plan inputs. + ## Planning and adaptive execution Use `plan create WRK --title TEXT [--decision DEC]`, then `plan step add` for a @@ -191,6 +198,14 @@ records OPEN, ACTIVE, BLOCKED, COMPLETED or CANCELLED. Dependencies must be comp before starting dependent steps. Completed steps require a result (`--reason`) and owned `--evidence ART`. Plan decisions must be accepted for execution. +`plan create --decision DEC` promotes its referenced drafts before returning the +new Plan. Already accepted decisions are unchanged. Inputs are validated together +under the project lock; ordinary publication failures roll back promotions. +Crash-interrupted publication may still need deliberate repair; use `work validate` +to inspect causal Plan links and revision history. `plan update` does not promote +drafts. Historical human approvals remain readable and are never rewritten into +system approvals. New system-promotion records require a CLI with this capability. + The CLI records work and can apply validated fixture proposals; it does not execute repository commands. Observe results, reconsider hypotheses and replan explicitly when evidence changes. OODA is adaptive, not a mandatory four-stage pipeline. No autonomous repository executor, orchestrator, diff --git a/.ai-engineering/protocol.json b/.ai-engineering/protocol.json index bf188e1..b704f6a 100644 --- a/.ai-engineering/protocol.json +++ b/.ai-engineering/protocol.json @@ -9,7 +9,7 @@ "command": "ai-engineering", "aliases": ["aie"], "startup": ["status --format json", "next-actions --format json", "work context --format markdown"], - "capabilities": ["protocol-compatibility", "work", "discussion", "topics", "surveys", "answer-history", "proposal-dispositions", "fixture-adapters", "local-cli-adapters", "guided-agent-setup", "agent-doctor", "agent-routing", "run-provenance", "epic", "epic-policy-authorization", "epic-propagation", "epic-reconciliation", "decision-approval", "decision-history", "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", "planning", "step-dependencies", "evidence", "completion", "plan-consolidation", "cancelled-scope-review", "work-reconciliation", "archive", "reopen"], "humanApproval": "explicit-attestation", "execution": "external-human-or-agent", "legacyImport": false diff --git a/.ai-engineering/works/.sequence.yaml b/.ai-engineering/works/.sequence.yaml index a8e4683..4b9c6b1 100644 --- a/.ai-engineering/works/.sequence.yaml +++ b/.ai-engineering/works/.sequence.yaml @@ -1,3 +1,3 @@ --- schemaVersion: 2 -lastWork: "0006" +lastWork: "0008" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0001/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0001/artifact.yaml new file mode 100644 index 0000000..0f865c6 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0001/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0001" +workId: "WRK-0007" +origin: "DF master 658d58e864f3f990e3e2e9b42ebd1a083a1b2221; inspeção local 2026-11-16" +purpose: "Levantamento do contrato DF: origem, umbrella, layout, estados, conteúdo,\ + \ vínculos, limites e esclarecimentos humanos." +path: "artifacts/evidence/ART-0001/payload" +sha256: "e26e922846811e6f02a756f85bea6c0d1c0ba8e919a67fb3246ce01ed1426400" +size: 8226 +author: "codex" +createdAt: "2026-11-16T11:17:58.865085Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0001/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0001/payload new file mode 100644 index 0000000..d8fd171 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0001/payload @@ -0,0 +1,86 @@ +# WRK-0007 — levantamento do Discussion Framework + +Coleta realizada em 2026-11-16. O importer ainda não foi implementado nem executado. + +## Origem e escopo verificados + +- Repositório: `/Users/niltonconstantino/personal/workspace.personal/intrepid/discussion-framework`, equivalente a `../../intrepid/discussion-framework` a partir do workspace AIE atual. O caminho informado com apenas `../` não existe nesse workspace. +- Branch local: `master`; commit: `658d58e864f3f990e3e2e9b42ebd1a083a1b2221`. +- Distribuição Python `discussion-framework`, versão declarada `0.1.0`, Python >=3.11, sem dependência externa de execução declarada. +- Inspecionados README, pyproject.toml, todos os módulos de `src/discussion_framework` e `tests/test_cli.py`. +- Apenas o checkout local foi inspecionado; não houve fetch nem consulta remota. +- A origem já tinha `.DS_Store` e `src/.DS_Store` não rastreados. Todos os arquivos-fonte selecionados permaneceram com os mesmos SHA-256 antes/depois. Nenhum comando de mutação foi executado contra a origem. + +## Esclarecimento humano sobre a umbrella + +O usuário esclareceu: “nao existe multiprojeto no DF, o lance eh que o AIE pode ter varios projetos usando o DF (cada um com o seu) debaixo de sua umbrella.” + +Portanto, não se procura um esquema multiprojeto dentro do DF. Cada projeto-fonte tem seu índice e sua árvore `discussion/`. A umbrella AIE reúne essas origens. Conforme ANS-0003, o Work deve descrever os targets da tarefa. Não está autorizado inventar uma configuração multiprojeto no DF ou criar automaticamente projetos AIE separados por origem. + +## Contrato de armazenamento + +`model.py:34` e `model.py:107`: + +```text +/discussion/index.ndjson +/discussion/workflow/agendas/AGD-....md +/discussion/workflow/decisions/DEC-....md +/discussion/workflow/plans/PLN-....md +/discussion/lessons/... +``` + +O índice UTF-8 contém um objeto JSON por linha; linhas vazias são ignoradas. O primeiro registro exige `type=meta` e contém `next_id` para DSC, AGD, DEC, PLN, LSN e CLSN. Os demais registros exigem `type=discussion`. Não há versão explícita de esquema no índice inicial. + +Cada discussão tem `id`, `ticket`, `title`, `status`, datas, `tags` e arrays `agendas`, `decisions`, `plans`, `lessons`. Uma DEC indexada tem `id`, `file`, `status`, datas e `ref_agenda`. Um plano referencia decisões em `ref_decisions`. As referências ligam as DECs à discussão e aos planos relevantes; não basta varrer nomes de arquivos. + +IDs e contadores são locais a cada árvore DF. Assim, duas origens podem ambas conter `DSC-0001` e `DEC-0001`: a identidade de importação precisa distinguir a origem, e a geração de IDs AIE deve seguir suas regras próprias. Esta é uma consequência do modelo, não uma política nova já aprovada. + +`cli.py:173` aceita como raiz tanto o projeto quanto seu diretório `discussion/`, quando o índice existe. Não há descoberta recursiva de vários projetos nem registro de targets de projetos na CLI deste checkout. + +## Conteúdo das DECs e targets + +`commands.py:608` gera front matter com `id`, `ticket`, `title`, `status`, `created`, `ref_agenda`, `tags`; o corpo contém Context, Decision, Rationale, Implications, Propagation Targets e References. + +Propagation Targets é prosa com categorias `specs`, `plans`, `code`, `tests`, `docs`. Isso não é um cadastro tipado de projetos/repositórios. O importer deve preservar o texto original. A descrição dos targets dos Works da umbrella precisa partir da origem e dos dados efetivamente fornecidos, preservando o requisito humano sem interpretar essas categorias como nomes de projetos. + +O JSON de `inspect`/`context` é uma projeção dos metadados: não contém o corpo das DECs e não preserva campos arbitrários adicionais. Para preservar conteúdo e proveniência, é necessário ler os arquivos referenciados, além do índice. O template não é garantia de que documentos humanos usem somente aquelas seções. + +## Estados: observados em código e reprodução temporária + +| Etapa | Discussão | DEC | Plano | +|---|---|---|---| +| Agenda criada | open | ausente | ausente | +| DEC criada | in_progress | open | ausente | +| DEC aceita | in_progress | accepted | ausente | +| Plano criado | in_progress | accepted | open | +| Plano iniciado | in_progress | accepted | in_progress | +| Plano concluído | in_progress | accepted | done | +| Housekeeping | done | removida do índice | removido do índice | + +Fontes: `commands.py:128` (add_decision), `:171` (accept_decision), `:188` (add_plan), `:231` (mark_plan), `:430` (housekeep). A tabela foi reproduzida pela CLI em dados sintéticos; o JSON da coleta registra cada etapa. + +Os estados permitidos de plano são `open`, `review`, `accepted`, `in_progress`, `done`, `abandoned`. `completed` não é o literal usado por esta CLI; a conclusão usa `done`. A DEC não passa automaticamente para done quando seu plano termina. O estado in_progress da discussão começa antes da execução de um plano. + +Consequência: filtrar apenas a discussão por open elimina DECs recém-criadas; filtrar apenas a DEC por accepted não distingue trabalho ainda não iniciado de trabalho concluído. + +O usuário resolveu explicitamente a interpretação: “Não: importar exclusivamente DECs com status open, verificando também se a tarefa já começou ou terminou.” Portanto, accepted fica fora mesmo sem execução. O levantamento dos planos/referências serve para excluir tarefas iniciadas ou concluídas; não amplia o escopo para importar planos. Como in_progress da discussão é atribuído automaticamente na criação da DEC, esse valor isolado não prova execução de uma tarefa. A regra de leitura dos planos vinculados deve ser explicitada no desenho, incluindo vínculos ausentes ou contraditórios, sem presumir elegibilidade em dados ambíguos. + +## Validação e preservação + +`validation.py:16` verifica estrutura básica do índice, duplicação global de IDs dentro da origem, contadores, existência de arquivos exigidos e arquivos de workflow órfãos. Discussões done podem referenciar arquivos já removidos; housekeeping remove arquivos e esvazia os arrays de workflow. + +Dois probes sintéticos mostraram que o validador retorna zero erros tanto quando o status no front matter diverge do índice quanto quando `ref_agenda` aponta para AGD inexistente. Logo, passar no validate do DF não prova consistência entre o conteúdo e o índice nem integridade dos vínculos. + +Pontos técnicos a cobrir no desenho do importer, sujeitos à decisão de implementação: validar caminhos dentro da origem, campos/estados conhecidos, vínculos e divergências; preservar conteúdo e identificação de origem; distinguir colisões entre origens; associar reimportação à origem e ao conteúdo; verificar mudanças entre prévia e aplicação. Bloquear lotes inválidos e não sobrescrever em reimportações seguem as respostas humanas registradas. Preservar a origem é uma recomendação de desenho e foi respeitado nesta coleta. + +## Verificações executadas + +- Copiados somente arquivos selecionados do repositório para diretório temporário. +- Executado na cópia: `python3 -B -m unittest discover -s tests -v` — 9 testes passaram, incluindo concorrência na alocação de planos. +- Exercitado fluxo completo init → agenda → DEC open → DEC accepted → plano open → in_progress → done → housekeeping, somente em dados descartáveis. +- Reproduzidos os dois limites de validação descritos acima. +- Manifesto SHA-256 dos arquivos selecionados e estados coletados em `inspection.json`; log da suíte em `upstream-tests.log`; script de reprodução em `wrk7-inspect-discussion.py`. + +## Próximo refinamento + +Com os esclarecimentos sobre umbrella e filtro, o layout das origens e a seleção de produto estão identificados. Próximo passo: preparar o contrato de importação com fixtures de duas origens independentes, IDs coincidentes e casos de execução vinculada. Não foi feita importação em projeto consumidor real. Nada neste relatório aprova escolhas adicionais de implementação ou conclui o WRK-0007. diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0002/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0002/artifact.yaml new file mode 100644 index 0000000..e21ffbd --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0002/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0002" +workId: "WRK-0007" +origin: "DF master 658d58e864f3f990e3e2e9b42ebd1a083a1b2221; inspeção local 2026-11-16" +purpose: "Resultados dos probes sintéticos, estados por etapa, exemplo de DEC e manifesto\ + \ SHA-256 da origem." +path: "artifacts/evidence/ART-0002/payload" +sha256: "51fcc95808aa427f38eb10167c2f85e29e37123b29eb1d14373592b201526209" +size: 4818 +author: "codex" +createdAt: "2026-11-16T11:17:59.241388Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0002/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0002/payload new file mode 100644 index 0000000..6099512 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0002/payload @@ -0,0 +1,138 @@ +{ + "source": "/Users/niltonconstantino/personal/workspace.personal/intrepid/discussion-framework", + "commit": "658d58e864f3f990e3e2e9b42ebd1a083a1b2221", + "trackedSourceSha256": { + "README.md": "fb66b88f7f972a2de83fcc6e2e029eefc2e342c33e9a8ff87d4f70cf5b6170ce", + "pyproject.toml": "4154cdbe1163df8b57aa08f730aa1bc90ab72f8ccf12789d6ec2420dfbcb993b", + "src/discussion_framework/__init__.py": "a5a10693dbec2c1fa5a3102ca7836e137354de1c21928eed916dcc0aa23a9725", + "src/discussion_framework/__main__.py": "307299fda7b77d22c64cb51430ec75e5f59d78e9c948786afb3b2544fe45e4b7", + "src/discussion_framework/__pycache__/__init__.cpython-313.pyc": "9af27048583827f6804074d381d7af6463420e726482cca29a4e4d3a66ad521a", + "src/discussion_framework/__pycache__/cli.cpython-313.pyc": "852e36d65aa0ff31cef4234b509a9f6d569ace1bc5204e40003efa10b500d6e7", + "src/discussion_framework/__pycache__/commands.cpython-313.pyc": "81faef7fc2280df453238fe12a7a59231da5f019886534478693ef91a2fd6051", + "src/discussion_framework/__pycache__/model.cpython-313.pyc": "92c48ab480627e660fce925576626c93695f6ee0041ac870a7696cc8d3c85557", + "src/discussion_framework/__pycache__/validation.cpython-313.pyc": "1b3b33ec7e9321e9e61144cf364a5623470ad31ebac94b8e259c683a0417e8fc", + "src/discussion_framework/cli.py": "e8efad1486171a99f381008e2dc1550ff9c6ca3930acf85006945d37ffcd5f0a", + "src/discussion_framework/commands.py": "c2d2cfbf05a58a390ba38d1b4e1663b5fb4a067fd9b5969d7fbc21717f770562", + "src/discussion_framework/model.py": "862e557713a87ce5672ee5df9d14921f43db6fe01912cd0913d3f74a7cada2a7", + "src/discussion_framework/validation.py": "7983c31938a90dbf413f8006439079ad3b62c38099b3a7e334356315b4873331", + "tests/test_cli.py": "15d75e7b05524168ed52d137df1cd8fe499056420fe8bc66f2db98b4e66e71f6" + }, + "sourceFilesUnchanged": true, + "upstreamTestCommand": "python3 -B -m unittest discover -s tests -v (temporary source copy)", + "upstreamTestExit": 0, + "stages": [ + { + "stage": "agenda-open", + "discussion": "open", + "decisions": [], + "plans": [], + "validationErrors": [] + }, + { + "stage": "decision-open", + "discussion": "in_progress", + "decisions": [ + { + "id": "DEC-0001", + "status": "open", + "ref_agenda": "AGD-0001" + } + ], + "plans": [], + "validationErrors": [] + }, + { + "stage": "decision-accepted", + "discussion": "in_progress", + "decisions": [ + { + "id": "DEC-0001", + "status": "accepted", + "ref_agenda": "AGD-0001" + } + ], + "plans": [], + "validationErrors": [] + }, + { + "stage": "plan-open", + "discussion": "in_progress", + "decisions": [ + { + "id": "DEC-0001", + "status": "accepted", + "ref_agenda": "AGD-0001" + } + ], + "plans": [ + { + "id": "PLN-0001", + "status": "open", + "ref_decisions": [ + "DEC-0001" + ] + } + ], + "validationErrors": [] + }, + { + "stage": "plan-in-progress", + "discussion": "in_progress", + "decisions": [ + { + "id": "DEC-0001", + "status": "accepted", + "ref_agenda": "AGD-0001" + } + ], + "plans": [ + { + "id": "PLN-0001", + "status": "in_progress", + "ref_decisions": [ + "DEC-0001" + ] + } + ], + "validationErrors": [] + }, + { + "stage": "plan-done", + "discussion": "in_progress", + "decisions": [ + { + "id": "DEC-0001", + "status": "accepted", + "ref_agenda": "AGD-0001" + } + ], + "plans": [ + { + "id": "PLN-0001", + "status": "done", + "ref_decisions": [ + "DEC-0001" + ] + } + ], + "validationErrors": [] + }, + { + "stage": "housekept", + "discussion": "done", + "decisions": [], + "plans": [], + "validationErrors": [] + } + ], + "generatedOpenDecisionMarkdown": "---\nid: DEC-0001\nticket: importer-fixture\ntitle: Fixture decision\nstatus: open\ncreated: 2026-11-16\nref_agenda: AGD-0001\ntags: []\n---\n\n## Context\n\nTBD.\n\n## Decision\n\nTBD.\n\n## Rationale\n\nTBD.\n\n## Implications\n\nTBD.\n\n## Propagation Targets\n\n- specs: TBD.\n- plans: TBD.\n- code: TBD.\n- tests: TBD.\n- docs: TBD.\n\n## References\n\n- Agenda: AGD-0001\n", + "validationGaps": { + "indexVsFrontMatterStatusMismatchErrors": [], + "nonexistentRefAgendaErrors": [] + }, + "limitations": [ + "Synthetic fixtures; no live consumer project was imported.", + "No explicit multiproject/targets format was found in this checkout.", + "No importer implementation or migration was executed." + ] +} diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0003/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0003/artifact.yaml new file mode 100644 index 0000000..80f90c4 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0003/artifact.yaml @@ -0,0 +1,11 @@ +--- +schemaVersion: 1 +id: "ART-0003" +workId: "WRK-0007" +origin: "DF master 658d58e864f3f990e3e2e9b42ebd1a083a1b2221; inspeção local 2026-11-16" +purpose: "Log dos nove testes upstream executados na cópia temporária do DF." +path: "artifacts/evidence/ART-0003/payload" +sha256: "5d39f9c33d6c5d8a41e881ebc7babcd43898fb2cad4f28e632e26274bf740699" +size: 2903 +author: "codex" +createdAt: "2026-11-16T11:17:59.585669Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0003/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0003/payload new file mode 100644 index 0000000..5a890e3 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0003/payload @@ -0,0 +1,45 @@ +initialized: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmpvr4ikxlr/discussion +housekept DSC-0001 +removed workflow artifacts: 3 +registered lesson: LSN-0001 +initialized: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmpz2xs7rjq/discussion +initialized: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmp9p56c0oz/discussion +initialized: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmpd_m7yeog/discussion +started DSC-0001 with AGD-0001 +agenda: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmpd_m7yeog/discussion/workflow/agendas/AGD-0001-parallel-demo.md +accepted agenda AGD-0001 for DSC-0001 +created decision DEC-0001 for DSC-0001 +decision: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmpd_m7yeog/discussion/workflow/decisions/DEC-0001-parallel-decision.md +accepted decision DEC-0001 for DSC-0001 +initialized: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmpmy_mivhj/discussion +initialized: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmp0k_ib8mb/discussion +started DSC-0001 with AGD-0001 +agenda: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmp0k_ib8mb/discussion/workflow/agendas/AGD-0001-demo-flow.md +accepted agenda AGD-0001 for DSC-0001 +created decision DEC-0001 for DSC-0001 +decision: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmp0k_ib8mb/discussion/workflow/decisions/DEC-0001-demo-decision.md +accepted decision DEC-0001 for DSC-0001 +created plan PLN-0001 for DSC-0001 +plan: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmp0k_ib8mb/discussion/workflow/plans/PLN-0001-demo-plan.md +marked plan PLN-0001 in_progress for DSC-0001 +marked plan PLN-0001 done for DSC-0001 +initialized: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmpn6p7q7va/discussion +initialized: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmptycwilwk/discussion +initialized: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmp1qv84e41/discussion +started DSC-0001 with AGD-0001 +agenda: /private/var/folders/0t/tfsqc14j5wbgh9h4s4dytwb00000gq/T/tmp1qv84e41/discussion/workflow/agendas/AGD-0001-orphan-demo.md + +test_housekeep_with_lesson_removes_workflow_artifacts (test_cli.CliTest) ... ok +test_init_validate_and_status (test_cli.CliTest) ... ok +test_inspect_context_next_actions_and_backup (test_cli.CliTest) ... ok +test_parallel_add_plan_allocates_unique_ids (test_cli.CliTest) ... ok +test_root_auto_detects_existing_discussion_directory (test_cli.CliTest) ... ok +test_semantic_decision_and_plan_commands (test_cli.CliTest) ... ok +test_start_creates_discussion_and_agenda (test_cli.CliTest) ... ok +test_validate_allows_done_discussion_with_historical_workflow_entries (test_cli.CliTest) ... ok +test_validate_rejects_orphan_workflow_artifact (test_cli.CliTest) ... ok + +---------------------------------------------------------------------- +Ran 9 tests in 0.518s + +OK diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0004/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0004/artifact.yaml new file mode 100644 index 0000000..c07c7ad --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0004/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0004" +workId: "WRK-0007" +origin: "DF master 658d58e864f3f990e3e2e9b42ebd1a083a1b2221; inspeção local 2026-11-16" +purpose: "Script da coleta para reproduzir cópia temporária, testes e probes sem mutar\ + \ a origem." +path: "artifacts/evidence/ART-0004/payload" +sha256: "9e4a79868069e6a44c1216299d4ce76062483cb636cca09afcc9c79200437767" +size: 4530 +author: "codex" +createdAt: "2026-11-16T11:17:59.880918Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0004/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0004/payload new file mode 100644 index 0000000..e69bd27 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0004/payload @@ -0,0 +1,93 @@ +import contextlib +import hashlib +import io +import json +import os +from pathlib import Path +import shutil +import subprocess +import sys +import tempfile + +source = Path('/Users/niltonconstantino/personal/workspace.personal/intrepid/discussion-framework') +out = Path(tempfile.mkdtemp(prefix='wrk7-discussion-research-')) +snapshot = out / 'source-copy' +snapshot.mkdir() +tracked = subprocess.check_output(['git', '-C', str(source), 'ls-files'], text=True).splitlines() +selected = [p for p in tracked if p.startswith(('src/', 'tests/')) or p in ('README.md', 'pyproject.toml')] +def manifest(): + return {p: hashlib.sha256((source / p).read_bytes()).hexdigest() for p in selected} +before = manifest() +for relative in selected: + target = snapshot / relative + target.parent.mkdir(parents=True, exist_ok=True) + shutil.copyfile(source / relative, target) +env = dict(os.environ, PYTHONPATH=str(snapshot / 'src'), PYTHONDONTWRITEBYTECODE='1') +tests = subprocess.run([sys.executable, '-B', '-m', 'unittest', 'discover', '-s', 'tests', '-v'], cwd=snapshot, env=env, capture_output=True, text=True, timeout=60) +(out / 'upstream-tests.log').write_text(tests.stdout + '\n' + tests.stderr) +sys.dont_write_bytecode = True +sys.path.insert(0, str(snapshot / 'src')) +from discussion_framework.cli import main +from discussion_framework.model import DiscussionIndex +from discussion_framework.validation import validate + +fixture = out / 'fixture' +fixture.mkdir() +stages = [] +def run(*args): + output, error = io.StringIO(), io.StringIO() + with contextlib.redirect_stdout(output), contextlib.redirect_stderr(error): + code = main(['--root', str(fixture), *args]) + if code: + raise RuntimeError((args, code, output.getvalue(), error.getvalue())) +def capture(label): + index = DiscussionIndex.load(fixture) + item = index.discussions[0] + stages.append({'stage': label, 'discussion': item['status'], 'decisions': [{k: x.get(k) for k in ('id', 'status', 'ref_agenda')} for x in item['decisions']], 'plans': [{k: x.get(k) for k in ('id', 'status', 'ref_decisions')} for x in item['plans']], 'validationErrors': validate(fixture)}) + target = out / 'examples' / label + target.mkdir(parents=True) + shutil.copyfile(fixture / 'discussion/index.ndjson', target / 'index.ndjson') + for path in (fixture / 'discussion/workflow/decisions').glob('*.md'): + shutil.copyfile(path, target / path.name) +run('init') +run('start', 'importer-fixture', 'Importer fixture') +capture('agenda-open') +run('accept-agenda', 'DSC-0001') +run('add-decision', 'DSC-0001', '--title', 'Fixture decision') +capture('decision-open') +decision = fixture / 'discussion/workflow/decisions/DEC-0001-fixture-decision.md' +decision_text = decision.read_text() +decision.write_text(decision_text.replace('status: open', 'status: done')) +status_mismatch = validate(fixture) +decision.write_text(decision_text) +index = DiscussionIndex.load(fixture) +index.discussions[0]['decisions'][0]['ref_agenda'] = 'AGD-9999' +index.save() +broken_reference = validate(fixture) +index.discussions[0]['decisions'][0]['ref_agenda'] = 'AGD-0001' +index.save() +run('accept-decision', 'DSC-0001') +capture('decision-accepted') +run('add-plan', 'DSC-0001', '--title', 'Fixture plan') +capture('plan-open') +run('mark-plan', 'PLN-0001', 'in_progress') +capture('plan-in-progress') +run('mark-plan', 'PLN-0001', 'done') +capture('plan-done') +run('housekeep', 'DSC-0001', '--no-lesson') +capture('housekept') +results = { + 'source': str(source), + 'commit': subprocess.check_output(['git', '-C', str(source), 'rev-parse', 'HEAD'], text=True).strip(), + 'trackedSourceSha256': before, + 'sourceFilesUnchanged': before == manifest(), + 'upstreamTestCommand': 'python3 -B -m unittest discover -s tests -v (temporary source copy)', + 'upstreamTestExit': tests.returncode, + 'stages': stages, + 'generatedOpenDecisionMarkdown': decision_text, + 'validationGaps': {'indexVsFrontMatterStatusMismatchErrors': status_mismatch, 'nonexistentRefAgendaErrors': broken_reference}, + 'limitations': ['Synthetic fixtures; no live consumer project was imported.', 'No explicit multiproject/targets format was found in this checkout.', 'No importer implementation or migration was executed.'], +} +(out / 'inspection.json').write_text(json.dumps(results, ensure_ascii=False, indent=2) + '\n') +print(json.dumps({'directory': str(out), 'testsExit': tests.returncode, 'sourceFilesUnchanged': results['sourceFilesUnchanged'], 'stages': stages}, ensure_ascii=False, indent=2)) +print(tests.stderr) diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0005/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0005/artifact.yaml new file mode 100644 index 0000000..50f13ec --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0005/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0005" +workId: "WRK-0007" +origin: "Precisão explícita do usuário em 2026-11-16; código DF master 658d58e864f3f990e3e2e9b42ebd1a083a1b2221." +purpose: "Adendo à coleta: o filtro open se aplica à AGD referenciada pela DEC; registra\ + \ efeito sobre o fluxo padrão e preserva evidência histórica." +path: "artifacts/evidence/ART-0005/payload" +sha256: "ffc0706f07775f491077a3b0aa59056f98e22395af0a5a9d85b996e5d942606c" +size: 2247 +author: "codex" +createdAt: "2026-11-16T11:19:41.799135Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0005/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0005/payload new file mode 100644 index 0000000..69707d9 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0005/payload @@ -0,0 +1,23 @@ +# WRK-0007 — correção do filtro de elegibilidade + +Em 2026-11-16, após o levantamento ART-0001, o usuário precisou a regra: “para ser mais preciso, a AGD da dec deve estar open”. + +## Regra atual + +Para cada DEC candidata, resolver sua AGD de origem por `ref_agenda` e exigir que essa AGD tenha `status: open`. A condição open se aplica à AGD, substituindo a interpretação anterior de que o próprio status da DEC deveria ser open. Mantém-se a exclusão de tarefas já iniciadas ou concluídas, conforme as respostas anteriores. + +Assim, o status accepted da DEC, isoladamente, não é mais motivo de exclusão. AGDs accepted, review, done ou abandoned não atendem à condição open. Referência ausente, ambígua ou inválida deve ser reportada na prévia e tratada pela política já acordada de bloqueio de lotes inválidos; não se deve adivinhar a AGD pelo nome do arquivo. + +O índice e o front matter podem divergir, como demonstrado no ART-0002. O contrato de implementação ainda deve explicitar o diagnóstico dessas inconsistências, preservando a exigência de AGD open sem escolher silenciosamente a representação mais permissiva. + +## Fato observado na origem + +No commit DF `658d58e864f3f990e3e2e9b42ebd1a083a1b2221`, `src/discussion_framework/commands.py:128` (`add_decision`) exige AGD accepted antes de criar uma DEC e não reabre a AGD. `accept_agenda`, em :111, atualiza tanto o índice quanto o front matter para accepted. + +Portanto, o fluxo padrão de criação dessa CLI não produz uma DEC associada a AGD open. Dados alterados por outros meios podem ter essa combinação, mas sua existência não foi verificada em um projeto consumidor real. A prévia deverá refletir os dados encontrados e poderá não selecionar nenhuma DEC; não se deve afrouxar o filtro para compensar o comportamento da origem. + +## Efeito sobre a coleta anterior + +Este adendo substitui exclusivamente a interpretação do filtro descrita no ART-0001 e na DSC-0006. Os fatos técnicos, hashes, testes e exemplos ART-0002 a ART-0004 continuam válidos como evidência histórica; nenhum payload anterior foi reescrito. + +Não houve implementação do importer, execução de migração ou mudança nos arquivos do DF nesta correção. diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0006/artifact.yaml b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0006/artifact.yaml new file mode 100644 index 0000000..b7094d6 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0006/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0006" +workId: "WRK-0007" +origin: "Correção explícita do usuário em 2026-11-16: importar DSCs e somente agendas\ + \ abertas." +purpose: "Escopo corrente do importer: DSCs com AGDs open; substitui regras anteriores\ + \ de importação de DECs, preservando histórico." +path: "artifacts/evidence/ART-0006/payload" +sha256: "ee71a04be92ab29c951552c06d2972e3d567affa08abb259888ac2acd1166b65" +size: 2693 +author: "codex" +createdAt: "2026-11-16T11:22:31.242021Z" diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0006/payload b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0006/payload new file mode 100644 index 0000000..6f9422c --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/artifacts/evidence/ART-0006/payload @@ -0,0 +1,30 @@ +# WRK-0007 — escopo corrigido: DSCs e agendas abertas + +O usuário corrigiu explicitamente o objeto da importação em 2026-11-16: + +> na verdade nao vamos importar DECs vamos importar DSCs, agendas em aberto somente + +## Escopo atual + +- A unidade de origem é a discussão DSC do Discussion Framework. +- Selecionar DSCs que tenham pelo menos uma AGD com `status: open`. +- Importar somente as agendas abertas dessas DSCs, preservando seu conteúdo e vínculo com a discussão de origem. +- Criar um Work por DSC de origem. Uma DSC com várias AGDs abertas continua correspondendo a um único Work. +- Uma DSC sem AGD aberta não gera Work importado. AGDs em outros estados ficam fora. +- DECs e planos não são objetos de importação neste escopo. A regra de criar DECs em draft e tratar suas aprovações deixa de se aplicar. + +Continuam aplicáveis as escolhas anteriores: uma origem DF simples ou várias origens independentes sob a umbrella AIE; descrição dos targets no Work; ignorar conteúdo idêntico e apresentar alterações/colisões para revisão; prévia e bloqueio de lotes inválidos. + +## Consequência para a leitura da origem + +Usar `discussion/index.ndjson` para encontrar cada registro `type=discussion`, ler seu array `agendas` e resolver os arquivos em `discussion/workflow/agendas/`. A seleção open é aplicada à AGD. Não se procura uma DEC nem se exige `ref_agenda` de uma DEC para selecionar a discussão. + +O estado agregado da DSC não substitui o estado da AGD. No caso de estados contraditórios entre índice, arquivos e ciclo da discussão, a prévia precisa mostrar o problema; a política já acordada bloqueia lotes com erros em vez de presumir elegibilidade. + +O DF usa IDs locais por origem, portanto DSCs de projetos diferentes podem repetir o mesmo identificador. Os fatos coletados sobre identidade de origem, layout, conteúdo Markdown e limites de validação continuam úteis ao novo escopo. Os templates de AGD incluem front matter e seções de problema, contexto, perguntas, opções, discussão e resolução; seu conteúdo deve ser preservado sem criar decisões artificiais. + +## Histórico e evidência + +Este adendo substitui as partes de seleção/importação de DECs dos ART-0001 e ART-0005 e das conclusões anteriores. As evidências históricas não foram reescritas. A exigência de AGD accepted para criar DEC no fluxo padrão do DF deixa de ser um impedimento para a seleção, pois nenhuma DEC é necessária. + +O Work e a resposta corrente do survey devem refletir o novo escopo; a antiga resposta sobre DECs em draft passa a não se aplicar. Nenhuma implementação, migração ou conclusão do Work foi realizada por esta correção. diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/decisions/.history/DEC-0001/r0001.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/decisions/.history/DEC-0001/r0001.md new file mode 100644 index 0000000..01a3960 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/decisions/.history/DEC-0001/r0001.md @@ -0,0 +1,115 @@ +--- +schemaVersion: 1 +id: "DEC-0001" +workId: "WRK-0007" +title: "Importar DSCs com agendas abertas preservando conteúdo e proveniência" +context: "Migrar discussões com AGDs open de uma ou várias origens DF independentes\ + \ sob a umbrella AIE, com um Work por DSC. Escopo e recomendações explicitamente\ + \ refinados com o usuário." +approach: "Importação determinística sem LLM, preservação integral e originais como\ + \ evidência, identidade origem + DSC, targets no Work, prévia explicada e reimportaç\ + ão sem sobrescrita." +alternatives: [] +rationale: "Preservar a unidade e o conteúdo das discussões, distinguir IDs locais\ + \ entre projetos e permitir seleção e reimportação verificáveis." +risks: [] +acceptanceCriteria: [] +approvalStatus: "DRAFT" +author: "codex" +createdAt: "2026-11-16T11:36:24.986836Z" +evidence: +- "ART-0001" +- "ART-0002" +- "ART-0003" +- "ART-0004" +- "ART-0006" +revision: 1 +previousHash: null +updatedAt: "2026-11-16T11:36:24.986836Z" +updatedBy: "codex" +changeReason: "Draft created" +approvals: [] +revises: null +supersededBy: null +documentVersion: 2 +--- + +# Importar DSCs com agendas abertas do Discussion Framework + +## Contexto + +O AI Engineering precisa receber discussões ainda abertas de projetos que usam o Discussion Framework (DF). Uma umbrella AIE pode abranger vários projetos, cada um com sua própria árvore `discussion/` e seus próprios IDs locais. + +O objeto de importação é a DSC, com somente suas agendas AGD em estado `open`. A correção explícita do usuário substitui o escopo inicial de importar DECs. A coleta local identificou o índice NDJSON, os arquivos Markdown e os limites do validador DF; ART-0001 a ART-0006 preservam os fatos e a evolução do escopo. + +O usuário aprovou seguir as recomendações de preservar conteúdo integral, identificar origem + DSC, explicar a seleção na prévia, validar duas origens com IDs repetidos e manter a primeira versão determinística, sem LLM. Esta DEC consolida essas escolhas para orientar a implementação. + +## Decisão + +### 1. Seleção de DSCs e agendas + +Ler `discussion/index.ndjson` de cada projeto-fonte e selecionar registros `type=discussion` com pelo menos uma entrada no array `agendas` cujo estado seja `open`. Importar somente as AGDs abertas dessa discussão, lendo seus arquivos em `discussion/workflow/agendas/`. + +Uma DSC sem agenda aberta não gera Work. A condição `open` aplica-se à AGD; o estado agregado da DSC não substitui essa condição. Não é necessário existir DEC nem seguir `ref_agenda` de uma DEC para localizar as agendas. + +Criar um Work AIE em estado OPEN por DSC de origem, agrupando nele todas as suas agendas abertas. Não importar DECs, planos ou conclusões históricas como novos artefatos de decisão, execução ou entrega. + +### 2. Preservação de conteúdo e proveniência + +Preservar integralmente o conteúdo das agendas selecionadas no espaço de refinamento do Work, incluindo contexto, perguntas, opções e discussão. Manter os originais como evidência do Work, com identificação da origem, IDs e caminhos de origem e hashes dos conteúdos coletados. + +A importação não resume nem reinterpreta as agendas. A presença de perguntas, recomendações ou campos de resolução na origem não cria automaticamente respostas humanas, aprovações ou decisões AIE. O refinamento poderá ocorrer depois, dentro do Work. + +Manter os arquivos dos projetos-fonte intactos. + +### 3. Umbrella, identidade e targets + +Tratar cada árvore DF como uma origem independente sob a umbrella AIE. Identificar a discussão importada pela combinação da identidade do projeto-fonte com o ID da DSC, preservando também a identificação de cada AGD dentro dessa origem. + +IDs como `DSC-0001` e `AGD-0001` podem repetir entre origens. A importação deve distingui-los e gerar IDs AIE pelo mecanismo normal do destino. + +Descrever no Work os targets da tarefa, preservando os dados e referências efetivamente disponíveis na origem e na associação do projeto-fonte à umbrella. Não inventar um esquema multiprojeto no DF nem criar automaticamente um projeto AIE separado para cada origem. + +### 4. Prévia e validação + +Antes de aplicar a importação, apresentar quais origens foram lidas, quais DSCs gerarão Works, quais AGDs serão incluídas e quais itens foram ignorados, com seus motivos. Apresentar erros, colisões e divergências de forma associada aos IDs e arquivos afetados. + +Verificar os arquivos referenciados e a consistência entre índice, front matter e vínculos relevantes. Uma divergência entre índice e Markdown deve ser diagnosticada; não se escolhe silenciosamente a representação que permita importar o item. + +Lotes com dados inválidos ou referências não resolvidas ficam bloqueados até a resolução dos erros. A validação do DF, isoladamente, não substitui essas verificações: os probes da coleta demonstraram divergências e referências quebradas que ela não detecta. + +### 5. Reimportação + +Usar identidade de origem + DSC e os registros de proveniência para reconhecer importações anteriores. Conteúdo idêntico não cria Works duplicados nem duplica agendas ou evidências no Work existente. + +Alterações ou colisões devem ser apresentadas para revisão. Não sobrescrever conteúdo importado ou refinado no AIE, não criar revisões silenciosas e não excluir conteúdo previamente importado porque a origem mudou de estado. + +### 6. Implementação determinística + +A primeira versão usa leitura, seleção, validação, identificação e publicação determinísticas, sem chamadas a LLM. O conteúdo é preservado na importação e refinado posteriormente pelos mecanismos normais do AIE. + +## Justificativa + +Um Work por DSC preserva a unidade da discussão e evita fragmentação quando há várias agendas abertas. A identidade composta permite reunir projetos com contadores locais iguais. Preservar os originais e o conteúdo integral mantém rastreabilidade e evita perder perguntas ou alternativas durante a migração. + +A prévia torna a seleção verificável antes de gravar os Works. O comportamento conservador na reimportação protege o refinamento feito no destino. A execução determinística permite reproduzir e testar os resultados sem interpretação de modelo. + +## Critérios de verificação da implementação + +- Uma origem simples importa apenas DSCs com AGDs open e preserva integralmente cada agenda selecionada e sua evidência original. +- Duas origens independentes sob a umbrella, com IDs DSC/AGD coincidentes, geram Works distintos e targets de origem identificáveis. +- Uma DSC com várias agendas gera um Work contendo somente as AGDs open; agendas review, accepted, done ou abandoned ficam fora. Uma DSC sem AGD open não gera Work. +- A seleção não exige DEC e não usa o estado da DSC como substituto do estado das agendas. +- A prévia explica itens incluídos e ignorados. Arquivos ausentes, referências inválidas e divergências entre índice e Markdown bloqueiam o lote. +- Uma segunda importação idêntica não altera ou duplica o conteúdo anterior. Mudanças e colisões são reportadas sem sobrescrita. +- Arquivos-fonte permanecem intactos e nenhuma chamada a LLM é necessária para importar. + +## Referências + +- WRK-0007: objetivo, restrições e critérios atuais. +- SVY-0001: respostas humanas e histórico de refinamento; interpretar conforme a correção de escopo da DSC-0008. +- DSC-0008 e ART-0006: escopo corrente de DSCs com agendas abertas. +- DSC-0009: solicitação humana de seguir as recomendações e gerar esta DEC. +- ART-0001 a ART-0005: levantamento técnico e correções históricas; regras antigas sobre importar DECs foram substituídas. +- Aprovação explícita das recomendações pelo usuário nesta sessão: “vamos seguir as recomendacoes, podemos gerar uma DEC?” + diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/decisions/DEC-0001.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/decisions/DEC-0001.md new file mode 100644 index 0000000..1567add --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/decisions/DEC-0001.md @@ -0,0 +1,124 @@ +--- +schemaVersion: 1 +id: "DEC-0001" +workId: "WRK-0007" +title: "Importar DSCs com agendas abertas preservando conteúdo e proveniência" +context: "Migrar discussões com AGDs open de uma ou várias origens DF independentes\ + \ sob a umbrella AIE, com um Work por DSC. Escopo e recomendações explicitamente\ + \ refinados com o usuário." +approach: "Importação determinística sem LLM, preservação integral e originais como\ + \ evidência, identidade origem + DSC, targets no Work, prévia explicada e reimportaç\ + ão sem sobrescrita." +alternatives: [] +rationale: "Preservar a unidade e o conteúdo das discussões, distinguir IDs locais\ + \ entre projetos e permitir seleção e reimportação verificáveis." +risks: [] +acceptanceCriteria: [] +approvalStatus: "ACCEPTED" +author: "codex" +createdAt: "2026-11-16T11:36:24.986836Z" +evidence: +- "ART-0001" +- "ART-0002" +- "ART-0003" +- "ART-0004" +- "ART-0006" +revision: 2 +previousHash: "985cf64780706a0dcd286e8093912a49f34d033b6339f91b218e473e471673d1" +updatedAt: "2026-11-16T11:41:26.102091Z" +updatedBy: "user" +changeReason: "O usuário pediu gerar o Plan a partir da DEC-0001 e esclareceu explicitamente\ + \ que esse pedido aprova a DEC, que não deve continuar DRAFT. Aprovação registrada\ + \ antes da criação do Plan vinculado." +approvals: +- status: "ACCEPTED" + by: "user" + reason: "O usuário pediu gerar o Plan a partir da DEC-0001 e esclareceu explicitamente\ + \ que esse pedido aprova a DEC, que não deve continuar DRAFT. Aprovação registrada\ + \ antes da criação do Plan vinculado." + at: "2026-11-16T11:41:26.102086Z" + humanApproved: true +revises: null +supersededBy: null +documentVersion: 2 +--- + +# Importar DSCs com agendas abertas do Discussion Framework + +## Contexto + +O AI Engineering precisa receber discussões ainda abertas de projetos que usam o Discussion Framework (DF). Uma umbrella AIE pode abranger vários projetos, cada um com sua própria árvore `discussion/` e seus próprios IDs locais. + +O objeto de importação é a DSC, com somente suas agendas AGD em estado `open`. A correção explícita do usuário substitui o escopo inicial de importar DECs. A coleta local identificou o índice NDJSON, os arquivos Markdown e os limites do validador DF; ART-0001 a ART-0006 preservam os fatos e a evolução do escopo. + +O usuário aprovou seguir as recomendações de preservar conteúdo integral, identificar origem + DSC, explicar a seleção na prévia, validar duas origens com IDs repetidos e manter a primeira versão determinística, sem LLM. Esta DEC consolida essas escolhas para orientar a implementação. + +## Decisão + +### 1. Seleção de DSCs e agendas + +Ler `discussion/index.ndjson` de cada projeto-fonte e selecionar registros `type=discussion` com pelo menos uma entrada no array `agendas` cujo estado seja `open`. Importar somente as AGDs abertas dessa discussão, lendo seus arquivos em `discussion/workflow/agendas/`. + +Uma DSC sem agenda aberta não gera Work. A condição `open` aplica-se à AGD; o estado agregado da DSC não substitui essa condição. Não é necessário existir DEC nem seguir `ref_agenda` de uma DEC para localizar as agendas. + +Criar um Work AIE em estado OPEN por DSC de origem, agrupando nele todas as suas agendas abertas. Não importar DECs, planos ou conclusões históricas como novos artefatos de decisão, execução ou entrega. + +### 2. Preservação de conteúdo e proveniência + +Preservar integralmente o conteúdo das agendas selecionadas no espaço de refinamento do Work, incluindo contexto, perguntas, opções e discussão. Manter os originais como evidência do Work, com identificação da origem, IDs e caminhos de origem e hashes dos conteúdos coletados. + +A importação não resume nem reinterpreta as agendas. A presença de perguntas, recomendações ou campos de resolução na origem não cria automaticamente respostas humanas, aprovações ou decisões AIE. O refinamento poderá ocorrer depois, dentro do Work. + +Manter os arquivos dos projetos-fonte intactos. + +### 3. Umbrella, identidade e targets + +Tratar cada árvore DF como uma origem independente sob a umbrella AIE. Identificar a discussão importada pela combinação da identidade do projeto-fonte com o ID da DSC, preservando também a identificação de cada AGD dentro dessa origem. + +IDs como `DSC-0001` e `AGD-0001` podem repetir entre origens. A importação deve distingui-los e gerar IDs AIE pelo mecanismo normal do destino. + +Descrever no Work os targets da tarefa, preservando os dados e referências efetivamente disponíveis na origem e na associação do projeto-fonte à umbrella. Não inventar um esquema multiprojeto no DF nem criar automaticamente um projeto AIE separado para cada origem. + +### 4. Prévia e validação + +Antes de aplicar a importação, apresentar quais origens foram lidas, quais DSCs gerarão Works, quais AGDs serão incluídas e quais itens foram ignorados, com seus motivos. Apresentar erros, colisões e divergências de forma associada aos IDs e arquivos afetados. + +Verificar os arquivos referenciados e a consistência entre índice, front matter e vínculos relevantes. Uma divergência entre índice e Markdown deve ser diagnosticada; não se escolhe silenciosamente a representação que permita importar o item. + +Lotes com dados inválidos ou referências não resolvidas ficam bloqueados até a resolução dos erros. A validação do DF, isoladamente, não substitui essas verificações: os probes da coleta demonstraram divergências e referências quebradas que ela não detecta. + +### 5. Reimportação + +Usar identidade de origem + DSC e os registros de proveniência para reconhecer importações anteriores. Conteúdo idêntico não cria Works duplicados nem duplica agendas ou evidências no Work existente. + +Alterações ou colisões devem ser apresentadas para revisão. Não sobrescrever conteúdo importado ou refinado no AIE, não criar revisões silenciosas e não excluir conteúdo previamente importado porque a origem mudou de estado. + +### 6. Implementação determinística + +A primeira versão usa leitura, seleção, validação, identificação e publicação determinísticas, sem chamadas a LLM. O conteúdo é preservado na importação e refinado posteriormente pelos mecanismos normais do AIE. + +## Justificativa + +Um Work por DSC preserva a unidade da discussão e evita fragmentação quando há várias agendas abertas. A identidade composta permite reunir projetos com contadores locais iguais. Preservar os originais e o conteúdo integral mantém rastreabilidade e evita perder perguntas ou alternativas durante a migração. + +A prévia torna a seleção verificável antes de gravar os Works. O comportamento conservador na reimportação protege o refinamento feito no destino. A execução determinística permite reproduzir e testar os resultados sem interpretação de modelo. + +## Critérios de verificação da implementação + +- Uma origem simples importa apenas DSCs com AGDs open e preserva integralmente cada agenda selecionada e sua evidência original. +- Duas origens independentes sob a umbrella, com IDs DSC/AGD coincidentes, geram Works distintos e targets de origem identificáveis. +- Uma DSC com várias agendas gera um Work contendo somente as AGDs open; agendas review, accepted, done ou abandoned ficam fora. Uma DSC sem AGD open não gera Work. +- A seleção não exige DEC e não usa o estado da DSC como substituto do estado das agendas. +- A prévia explica itens incluídos e ignorados. Arquivos ausentes, referências inválidas e divergências entre índice e Markdown bloqueiam o lote. +- Uma segunda importação idêntica não altera ou duplica o conteúdo anterior. Mudanças e colisões são reportadas sem sobrescrita. +- Arquivos-fonte permanecem intactos e nenhuma chamada a LLM é necessária para importar. + +## Referências + +- WRK-0007: objetivo, restrições e critérios atuais. +- SVY-0001: respostas humanas e histórico de refinamento; interpretar conforme a correção de escopo da DSC-0008. +- DSC-0008 e ART-0006: escopo corrente de DSCs com agendas abertas. +- DSC-0009: solicitação humana de seguir as recomendações e gerar esta DEC. +- ART-0001 a ART-0005: levantamento técnico e correções históricas; regras antigas sobre importar DECs foram substituídas. +- Aprovação explícita das recomendações pelo usuário nesta sessão: “vamos seguir as recomendacoes, podemos gerar uma DEC?” + diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0001.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0001.md new file mode 100644 index 0000000..32bc34f --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0001.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0001" +workId: "WRK-0007" +discussionId: "main" +kind: "NOTE" +author: "user" +createdAt: "2026-11-16T11:01:22.513435Z" +respondsTo: null +documentVersion: 2 +--- + +vamos abrir um work para criar o importer do discussion framework, o importer deve importar as decs do seja do projeto simples ou do projeto multi \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0002.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0002.md new file mode 100644 index 0000000..6192358 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0002.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0002" +workId: "WRK-0007" +discussionId: "main" +kind: "SUGGESTION" +author: "codex" +createdAt: "2026-11-16T11:01:22.731131Z" +respondsTo: null +documentVersion: 2 +--- + +Pontos propostos para refinamento antes da implementação: inspecionar os layouts e formatos reais de DECs nos modos simples e multiprojeto; definir a unidade de mapeamento para Works de destino; definir preservação de conteúdo, identidade e referências de origem; definir tratamento dos estados e aprovações históricas sem inventar aprovação humana; definir colisões de IDs, reimportação e diagnóstico de arquivos inválidos. Recomenda-se preservar os arquivos de origem e validar os dois layouts com fixtures. São propostas em aberto, não decisões aceitas. O pedido atual abre o Work para importar DECs; outros tipos de artefato não foram incluídos. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0003.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0003.md new file mode 100644 index 0000000..ab122c1 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0003.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0003" +workId: "WRK-0007" +discussionId: "main" +kind: "CONCLUSION" +author: "codex" +createdAt: "2026-11-16T11:12:20.412854Z" +respondsTo: "DSC-0002" +documentVersion: 2 +--- + +Consolidação das respostas explícitas do usuário às seis questões do SVY-0001 (ANS-0001 a ANS-0006): 1. Importar somente as DECs ainda em aberto, excluindo o que estiver em andamento ou completed; esta resposta substitui a recomendação genérica de seleção por estado. 2. Criar um Work por discussão de origem, agrupando suas DECs elegíveis. 3. No modo multiprojeto, o próprio Work deve descrever os targets da tarefa, preservando o padrão da origem; não foi aprovada a recomendação de mapear cada projeto de origem para destinos AIE separados. 4. Criar DECs em draft e preservar o estado legado como proveniência. 5. Ignorar itens idênticos e relatar alterações ou colisões para revisão, sem sobrescrever. 6. Mostrar prévia e bloquear a aplicação do lote selecionado enquanto houver erros. Estas escolhas refinam o escopo do importer; não representam entrega do Work nem aprovação de código ainda inexistente. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0004.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0004.md new file mode 100644 index 0000000..e5db43b --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0004.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0004" +workId: "WRK-0007" +discussionId: "main" +kind: "INVESTIGATION" +author: "codex" +createdAt: "2026-11-16T11:12:31.673151Z" +respondsTo: null +documentVersion: 2 +--- + +Observação verificada nesta sessão, sem alteração na origem: em /Users/niltonconstantino/personal/workspace.personal/intrepid/discussion-framework/src/discussion_framework/commands.py, a função add_decision cria a DEC com status open e muda a discussão para in_progress imediatamente. Os estados do artefato e da discussão representam coisas distintas. Antes de implementar o filtro definido na ANS-0001, verificar o estado da DEC e os sinais de execução da tarefa nos layouts reais simples e multiprojeto. A inspeção inicial dos dois repositórios históricos não confirmou a representação dos targets multiprojeto; obter essa evidência antes de escolher campos ou formato de persistência. As seis respostas de produto estão registradas; este levantamento técnico não as substitui. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0005.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0005.md new file mode 100644 index 0000000..834b48c --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0005.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0005" +workId: "WRK-0007" +discussionId: "main" +kind: "NOTE" +author: "user" +createdAt: "2026-11-16T11:17:03.187407Z" +respondsTo: null +documentVersion: 2 +--- + +Origem indicada: o projeto do discussion framework fica em: ../intrepid/discussion-framework; colete o que precisar de info lah. Esclarecimento posterior: nao existe multiprojeto no DF, o lance eh que o AIE pode ter varios projetos usando o DF (cada um com o seu) debaixo de sua umbrella. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0006.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0006.md new file mode 100644 index 0000000..8581d5c --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0006.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0006" +workId: "WRK-0007" +discussionId: "main" +kind: "CONCLUSION" +author: "codex" +createdAt: "2026-11-16T11:18:16.629499Z" +respondsTo: "DSC-0004" +documentVersion: 2 +--- + +Coleta concluída no DF Python em ../../intrepid/discussion-framework, master 658d58e864f3f990e3e2e9b42ebd1a083a1b2221. ART-0001 contém o relatório; ART-0002 os estados reproduzidos, exemplo de DEC e hashes; ART-0003 o log dos nove testes upstream aprovados; ART-0004 o script de reprodução. Todos os comandos mutantes do DF rodaram apenas em cópia temporária e fixtures descartáveis; hashes das fontes permaneceram iguais. O usuário esclareceu na ANS-0007 que multiprojeto significa umbrella AIE com origens DF independentes, e na ANS-0008 que somente DECs com status open são elegíveis, verificando também se a tarefa já começou ou terminou; accepted fica fora mesmo com plano não iniciado. Estes esclarecimentos atualizam a interpretação anterior da DSC-0003 e resolvem as dúvidas de produto da DSC-0004. Identificados índice NDJSON, caminhos, front matter e corpo Markdown, vínculos agenda/DEC/planos, IDs locais a cada origem e limites do validate upstream. O estado in_progress da discussão começa automaticamente ao criar uma DEC e não prova isoladamente execução. O desenho do importer deve usar esses fatos ao especificar o filtro e a identidade por origem. Coleta não implementa o importer nem conclui o Work. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0007.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0007.md new file mode 100644 index 0000000..d48d14e --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0007.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0007" +workId: "WRK-0007" +discussionId: "main" +kind: "CONCLUSION" +author: "codex" +createdAt: "2026-11-16T11:19:54.210001Z" +respondsTo: "DSC-0006" +documentVersion: 2 +--- + +A precisão explícita ANS-0009 substitui a interpretação anterior do filtro na ANS-0008/DSC-0006: open aplica-se à AGD referenciada pela DEC, resolvida por ref_agenda. O status da DEC deixa de ser a condição open; mantêm-se a exclusão de tarefas já iniciadas ou concluídas e as demais escolhas do survey. Objetivo, descrição, restrições e critérios do Work foram atualizados. ART-0005 registra o adendo sem reescrever evidências anteriores. Fato técnico verificado: no fluxo padrão deste DF, add_decision exige AGD accepted e não a reabre; logo esse fluxo não produz naturalmente a combinação exigida pelo filtro. Registrar fielmente o estado da origem e permitir prévia sem elegíveis, sem relaxar a regra nem presumir que existem dados reais com AGD open associada a DEC. Nenhuma implementação ou importação foi executada. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0008.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0008.md new file mode 100644 index 0000000..450b1dd --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0008.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0008" +workId: "WRK-0007" +discussionId: "main" +kind: "CONCLUSION" +author: "codex" +createdAt: "2026-11-16T11:22:44.831362Z" +respondsTo: "DSC-0007" +documentVersion: 2 +--- + +Correção explícita do usuário: importar DSCs, agendas em aberto somente. O objeto de importação passa a ser a discussão de origem: selecionar DSCs com pelo menos uma AGD open e criar um Work por DSC, preservando somente suas agendas abertas. Não é necessário existir DEC nem resolver ref_agenda de DEC para selecionar a discussão. A condição anterior sobre AGD da DEC e as regras de importação/aprovação de DECs ficam substituídas; QST-0001 e QST-0004 receberam a correção explícita no survey. Mantêm-se umbrella AIE com origens independentes e targets descritos no Work, reimportação sem sobrescrita, prévia e bloqueio de lotes inválidos. Título, objetivo, descrição, motivação, restrições e critérios foram atualizados. ART-0006 registra o escopo corrente e o efeito sobre a evidência histórica. A restrição da CLI DF de criar DEC somente após AGD accepted não impede este escopo, pois o importer parte diretamente de DSCs/agendas. Nenhuma implementação ou importação foi executada. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0009.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0009.md new file mode 100644 index 0000000..d962986 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0009.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0009" +workId: "WRK-0007" +discussionId: "main" +kind: "NOTE" +author: "user" +createdAt: "2026-11-16T11:36:24.664533Z" +respondsTo: null +documentVersion: 2 +--- + +vamos seguir as recomendacoes, podemos gerar uma DEC? \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0010.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0010.md new file mode 100644 index 0000000..85f72d1 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0010.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0010" +workId: "WRK-0007" +discussionId: "main" +kind: "NOTE" +author: "user" +createdAt: "2026-11-16T11:41:25.426239Z" +respondsTo: null +documentVersion: 2 +--- + +vamos gerar um plan a partir dessa dec. Esclarecimento: calma, a partir do momento que geramos um plan, a DEC foi aprovada - ela nao deve seguir como DRAFT depois disso, concorda? \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0011.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0011.md new file mode 100644 index 0000000..0e8ff78 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/discussions/DSC-0011.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0011" +workId: "WRK-0007" +discussionId: "main" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-16T12:29:40.730037Z" +respondsTo: null +documentVersion: 2 +--- + +PLN-0001 criado a partir da DEC-0001 aceita, com seis etapas, dependências e critérios cobrindo o importer. A correção de fluxo solicitada pelo usuário foi implementada separadamente no WRK-0008: novas criações de Plan promovem suas DECs DRAFT deterministicamente, sem LLM, com proveniência SYSTEM_PLAN. Esta DEC já havia recebido a aprovação humana explícita e seu histórico não foi reescrito. O importer continua planejado; nenhuma etapa dele foi executada nesta automação. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0001.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0001.md new file mode 100644 index 0000000..fc2692f --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0001.md @@ -0,0 +1,20 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: [] +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-16T11:44:34.857533Z" +updatedBy: "codex" +changeReason: "Plan created" +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0002.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0002.md new file mode 100644 index 0000000..d769bd3 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0002.md @@ -0,0 +1,38 @@ +--- +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" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 2 +previousHash: "7d9d414334f6b621da7421cba9b652b99e198b7e19a9410c018efd9759734c5c" +updatedAt: "2026-11-16T11:44:40.803729Z" +updatedBy: "codex" +changeReason: "Decomposição da DEC-0001 aceita pelo usuário." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0003.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0003.md new file mode 100644 index 0000000..53a2982 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0003.md @@ -0,0 +1,57 @@ +--- +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" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 3 +previousHash: "c55d5465ee95aebb5b743d1f66543ce653ad0d3887c9d9c7ccc4f02cc1617fc4" +updatedAt: "2026-11-16T11:44:45.347318Z" +updatedBy: "codex" +changeReason: "Decomposição da DEC-0001 aceita pelo usuário." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0004.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0004.md new file mode 100644 index 0000000..7a7cdd4 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0004.md @@ -0,0 +1,75 @@ +--- +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" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 4 +previousHash: "1212b3472166d192eb64a21402dc9c3f572291dfc6ebfe66bce43db367234dca" +updatedAt: "2026-11-16T11:44:51.505558Z" +updatedBy: "codex" +changeReason: "Decomposição da DEC-0001 aceita pelo usuário." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0005.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0005.md new file mode 100644 index 0000000..64caf4e --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0005.md @@ -0,0 +1,94 @@ +--- +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" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 5 +previousHash: "4c01f4e2f53b4e9dc23b7b2f4e692a21f489fdeb703aaa3f446e1e00ce46b0d4" +updatedAt: "2026-11-16T11:44:57.703234Z" +updatedBy: "codex" +changeReason: "Decomposição da DEC-0001 aceita pelo usuário." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0006.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0006.md new file mode 100644 index 0000000..1775ca5 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/.history/PLN-0001/r0006.md @@ -0,0 +1,113 @@ +--- +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" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 6 +previousHash: "26062ec216d34d61cff10a7ca08049b2dbc4c1d74ce3957d8eda2937c5fa649c" +updatedAt: "2026-11-16T11:45:04.463625Z" +updatedBy: "codex" +changeReason: "Decomposição da DEC-0001 aceita pelo usuário." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/PLN-0001.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/PLN-0001.md new file mode 100644 index 0000000..840d5e3 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/plans/PLN-0001.md @@ -0,0 +1,132 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0007" +title: "Implementar importer determinístico de DSCs com agendas abertas" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Definir contrato de entrada, proveniência e fixtures" + description: "Especificar interface de prévia/aplicação, identidade estável de cada\ + \ origem e associação aos targets, usando uma origem DF por projeto. Definir como\ + \ persistir o vínculo origem+DSC e hashes, preservando compatibilidade dos registros\ + \ existentes. Montar fixtures com duas origens de IDs coincidentes, várias AGDs\ + \ e estados mistos. Referências: DEC-0001 e ART-0001/2/4/6." + acceptanceCriteria: + - "Contrato descreve entradas, saídas, erros, limites de tamanho existentes e reimportaç\ + ão." + - "Fixtures cobrem origem simples, umbrella, múltiplas AGDs por DSC e DSC sem AGD\ + \ open." + - "Nenhuma mudança em Works históricos ou em repositórios-fonte." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:40.803688Z" +- id: "TSK-0002" + title: "Implementar leitura DF e prévia sem gravações" + description: "Adicionar componente de importação que lê índice NDJSON e agendas\ + \ Markdown, selecionando somente AGDs open. Validar IDs, caminhos, arquivos, UTF-8\ + \ e divergências índice/front matter. Gerar relatório determinístico de incluí\ + dos, ignorados, colisões e erros. Não exigir DEC nem confundir estado agregado\ + \ da DSC com o da agenda." + acceptanceCriteria: + - "Prévia deixa o destino e as origens intactos." + - "DSCs sem agenda aberta são ignoradas com motivo; erros de itens selecionados\ + \ bloqueiam o lote." + - "Conteúdo e hashes das AGDs selecionadas são preservados, incluindo Unicode e\ + \ quebras de linha." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:45.347282Z" +- id: "TSK-0003" + title: "Publicar Works e preservar agendas e evidências" + description: "Criar um Work OPEN por origem+DSC, usando os serviços e limites normais\ + \ do AIE. Registrar targets e conteúdo integral das agendas no refinamento e anexar\ + \ originais como evidência. Persistir proveniência suficiente para reconhecer\ + \ nova importação. Revalidar dados entre prévia e aplicação e coordenar a gravaç\ + ão com o lock do destino." + acceptanceCriteria: + - "Origem simples e umbrella geram Works distintos para IDs DF iguais." + - "Nenhuma DEC, plano, aprovação ou conclusão é inventada a partir das agendas." + - "Conteúdo importado fica disponível no contexto e evidência original passa na\ + \ validação SHA-256." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:51.505506Z" +- id: "TSK-0004" + title: "Integrar CLI e reimportação determinística" + description: "Expor prévia e aplicação pela CLI, com help e formatos legíveis/JSON\ + \ coerentes. Identificar importações anteriores pela origem+DSC; itens iguais\ + \ são no-op e itens alterados/colisões pedem revisão, sem sobrescrita ou exclusã\ + o do conteúdo refinado. Integrar validação e registrar tipos serializáveis em\ + \ NativeHints quando necessário." + acceptanceCriteria: + - "Uma segunda importação idêntica não cria Works, discussões ou evidências duplicadas." + - "Alterações na origem ou no destino não sobrescrevem refinamento nem geram revisõ\ + es silenciosas." + - "Comandos funcionam de outro cwd e com --project; erros mantêm códigos e diagnó\ + sticos coerentes." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:44:57.703190Z" +- id: "TSK-0005" + title: "Validar integração, concorrência e recuperação" + description: "Adicionar testes de integração CLI/JVM com fixtures descartáveis e\ + \ subprocessos quando necessário. Cobrir dois projetos, IDs repetidos, estado\ + \ por AGD, inconsistências, arquivos ausentes e caminhos inválidos. Verificar\ + \ falhas/interrupção, retomada e concorrência sob o lock, sem duplicações. Verificar\ + \ hashes de origem antes/depois." + acceptanceCriteria: + - "Todos os critérios da DEC-0001 têm cenário reproduzível e resultado registrado." + - "Lote inválido não publica importações; falhas de publicação ficam diagnosticá\ + veis e retomada não duplica o já publicado." + - "Executar testes focados e ./gradlew check com logs anexados; preservar fixtures\ + \ de compatibilidade histórica." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:04.463544Z" +- id: "TSK-0006" + title: "Documentar e verificar distribuição JVM/nativa" + description: "Atualizar README, docs/protocol.md, docs/architecture.md, roadmap\ + \ e recursos portáteis para refletir apenas capacidades entregues. Estender scripts/native-smoke.sh\ + \ com prévia/aplicação, umbrella e reimportação. Rodar processAot/bootJar, nativeCompile\ + \ e smoke na plataforma disponível; registrar limites reais e evidências para\ + \ conclusão." + acceptanceCriteria: + - "Documentação explica origem+DSC, AGDs open, targets, erros e reimportação sem\ + \ LLM." + - "JAR e executável nativo apresentam resultados equivalentes nos cenários do importer." + - "Evidências registram comandos, revisões e resultados; nenhuma capacidade de outra\ + \ plataforma é alegada sem teste." + dependsOn: + - "TSK-0005" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:45:11.634846Z" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:44:34.857533Z" +revision: 7 +previousHash: "cddadab736f1f0991adc0984175a69b0df5c5341cc76b2d3771238436bce2ac6" +updatedAt: "2026-11-16T11:45:11.634905Z" +updatedBy: "codex" +changeReason: "Decomposição da DEC-0001 aceita pelo usuário." +documentVersion: 2 +--- + +Implementar DEC-0001: importar DSCs com AGDs open de uma origem simples ou várias origens independentes sob a umbrella AIE. Um Work OPEN por DSC; agendas integrais no refinamento e originais como evidência. Identidade composta origem + DSC, targets descritos no Work, prévia explicada e reimportação sem sobrescrita. Implementação determinística sem LLM. Referências: ART-0001 a ART-0004 (contrato DF e probes) e ART-0006 (escopo corrigido). Integrar com EngineeringCli, WorkService, DiscussionService, ArtifactService, Filespace, validação e contexto existentes. Preservar Works históricos sem migração implícita. Dados de teste sempre descartáveis; não importar em projetos reais durante a verificação. Evidência de cada etapa deve registrar fontes, comandos, resultados e limites. Publicação segue o contrato existente de locks e escrita atômica por arquivo; testar falhas e retomada sem duplicação, sem prometer transação global. Fechamento exige todos os critérios da DEC cobertos, documentação e smoke JVM/nativo na plataforma disponível. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0001.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0001.md new file mode 100644 index 0000000..bfd617a --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0001.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: [] +answers: [] +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-16T11:02:36.890280Z" +updatedBy: "codex" +changeReason: "Survey created" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0002.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0002.md new file mode 100644 index 0000000..95cddac --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0002.md @@ -0,0 +1,33 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: [] +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 2 +previousHash: "544d9e33612d7ab9e9affa5342213c449a5bfaa7151d2f6e27db10345c606899" +updatedAt: "2026-11-16T11:02:50.269733Z" +updatedBy: "codex" +changeReason: "Question added" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0003.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0003.md new file mode 100644 index 0000000..b439613 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0003.md @@ -0,0 +1,47 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: [] +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 3 +previousHash: "4566ca250967649c26ab1d54ba4c42e81e1c7241ae7ee5d1a632caaa4fd3cb8a" +updatedAt: "2026-11-16T11:02:50.634464Z" +updatedBy: "codex" +changeReason: "Question added" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0004.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0004.md new file mode 100644 index 0000000..9a87b90 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0004.md @@ -0,0 +1,62 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: [] +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 4 +previousHash: "3396da7754d898991f88d9b1bb7e7971d0f4a5503ccdf576721eb841a567dbf3" +updatedAt: "2026-11-16T11:02:51.009798Z" +updatedBy: "codex" +changeReason: "Question added" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0005.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0005.md new file mode 100644 index 0000000..4c7d304 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0005.md @@ -0,0 +1,76 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: [] +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 5 +previousHash: "7841b91594b119358e8f8750df4e667383e6588e238efd5d96c516b12634a3c5" +updatedAt: "2026-11-16T11:02:51.413223Z" +updatedBy: "codex" +changeReason: "Question added" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0006.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0006.md new file mode 100644 index 0000000..51d9f41 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0006.md @@ -0,0 +1,92 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: [] +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 6 +previousHash: "9c32a930f6bd6b464912b7af0695d8df3413cbebe8a4951f08a7f1abd53282df" +updatedAt: "2026-11-16T11:02:51.832178Z" +updatedBy: "codex" +changeReason: "Question added" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0007.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0007.md new file mode 100644 index 0000000..42ec518 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0007.md @@ -0,0 +1,105 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: [] +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 7 +previousHash: "e6be53cb799b3e027a6d0fc9b8e6f7a892533ea1b4ffccec523a28bbe399ac7c" +updatedAt: "2026-11-16T11:02:52.282804Z" +updatedBy: "codex" +changeReason: "Question added" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0008.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0008.md new file mode 100644 index 0000000..3f5dfc4 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0008.md @@ -0,0 +1,113 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 8 +previousHash: "3344b99234da833389aa765aebdf1fbcd97371edbad767c60faa9cf4deb9b530" +updatedAt: "2026-11-16T11:11:29.587340Z" +updatedBy: "user" +changeReason: "Answer recorded" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0009.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0009.md new file mode 100644 index 0000000..2840529 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0009.md @@ -0,0 +1,121 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 9 +previousHash: "7d6e8410876c7483b34e6d935599986030a73d6d1d6c7316b07c15954287fa2f" +updatedAt: "2026-11-16T11:11:33.261964Z" +updatedBy: "user" +changeReason: "Answer recorded" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0010.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0010.md new file mode 100644 index 0000000..950d6f4 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0010.md @@ -0,0 +1,129 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +- id: "ANS-0003" + questionId: "QST-0003" + choices: [] + text: "no multiprojeto, o work deveria descrever quais os targets daquela tarefa,\ + \ entao, vamos manter esse padrao" + author: "user" + at: "2026-11-16T11:11:36.170913Z" + supersedes: null +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 10 +previousHash: "a4c7c0dbe8cc82dd96bd9356f94a56eb3bfd20f04b82ce51764bfda5d9085eba" +updatedAt: "2026-11-16T11:11:36.174561Z" +updatedBy: "user" +changeReason: "Answer recorded" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0011.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0011.md new file mode 100644 index 0000000..2306d8a --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0011.md @@ -0,0 +1,137 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +- id: "ANS-0003" + questionId: "QST-0003" + choices: [] + text: "no multiprojeto, o work deveria descrever quais os targets daquela tarefa,\ + \ entao, vamos manter esse padrao" + author: "user" + at: "2026-11-16T11:11:36.170913Z" + supersedes: null +- id: "ANS-0004" + questionId: "QST-0004" + choices: + - "1" + text: "sim — importar como draft, preservando o estado legado como proveniência." + author: "user" + at: "2026-11-16T11:11:39.795538Z" + supersedes: null +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 11 +previousHash: "49d83421c4761f50ad03736cf7b0933b98097a3528ca0d89f6fa642df79bba4e" +updatedAt: "2026-11-16T11:11:39.799060Z" +updatedBy: "user" +changeReason: "Answer recorded" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0012.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0012.md new file mode 100644 index 0000000..81bb0f6 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0012.md @@ -0,0 +1,146 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +- id: "ANS-0003" + questionId: "QST-0003" + choices: [] + text: "no multiprojeto, o work deveria descrever quais os targets daquela tarefa,\ + \ entao, vamos manter esse padrao" + author: "user" + at: "2026-11-16T11:11:36.170913Z" + supersedes: null +- id: "ANS-0004" + questionId: "QST-0004" + choices: + - "1" + text: "sim — importar como draft, preservando o estado legado como proveniência." + author: "user" + at: "2026-11-16T11:11:39.795538Z" + supersedes: null +- id: "ANS-0005" + questionId: "QST-0005" + choices: + - "1" + text: "sim — ignorar conteúdo idêntico e apresentar alterações para revisão, sem\ + \ sobrescrever." + author: "user" + at: "2026-11-16T11:11:44.260841Z" + supersedes: null +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 12 +previousHash: "31c27035016cd616f5700ecdf02b4980fbc4a37a8c2e02a7a72ef935263ab06a" +updatedAt: "2026-11-16T11:11:44.267401Z" +updatedBy: "user" +changeReason: "Answer recorded" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0013.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0013.md new file mode 100644 index 0000000..d131228 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0013.md @@ -0,0 +1,154 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +- id: "ANS-0003" + questionId: "QST-0003" + choices: [] + text: "no multiprojeto, o work deveria descrever quais os targets daquela tarefa,\ + \ entao, vamos manter esse padrao" + author: "user" + at: "2026-11-16T11:11:36.170913Z" + supersedes: null +- id: "ANS-0004" + questionId: "QST-0004" + choices: + - "1" + text: "sim — importar como draft, preservando o estado legado como proveniência." + author: "user" + at: "2026-11-16T11:11:39.795538Z" + supersedes: null +- id: "ANS-0005" + questionId: "QST-0005" + choices: + - "1" + text: "sim — ignorar conteúdo idêntico e apresentar alterações para revisão, sem\ + \ sobrescrever." + author: "user" + at: "2026-11-16T11:11:44.260841Z" + supersedes: null +- id: "ANS-0006" + questionId: "QST-0006" + choices: + - "1" + text: "sim — mostrar prévia e bloquear o lote até resolver os erros." + author: "user" + at: "2026-11-16T11:11:49.716758Z" + supersedes: null +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 13 +previousHash: "992f2bc8866a6638c32399abb75c0f15a054f37fca61a8e2439d0fbd4fac1de7" +updatedAt: "2026-11-16T11:11:49.723417Z" +updatedBy: "user" +changeReason: "Answer recorded" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0014.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0014.md new file mode 100644 index 0000000..06c29f1 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0014.md @@ -0,0 +1,164 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +- id: "ANS-0003" + questionId: "QST-0003" + choices: [] + text: "no multiprojeto, o work deveria descrever quais os targets daquela tarefa,\ + \ entao, vamos manter esse padrao" + author: "user" + at: "2026-11-16T11:11:36.170913Z" + supersedes: null +- id: "ANS-0004" + questionId: "QST-0004" + choices: + - "1" + text: "sim — importar como draft, preservando o estado legado como proveniência." + author: "user" + at: "2026-11-16T11:11:39.795538Z" + supersedes: null +- id: "ANS-0005" + questionId: "QST-0005" + choices: + - "1" + text: "sim — ignorar conteúdo idêntico e apresentar alterações para revisão, sem\ + \ sobrescrever." + author: "user" + at: "2026-11-16T11:11:44.260841Z" + supersedes: null +- id: "ANS-0006" + questionId: "QST-0006" + choices: + - "1" + text: "sim — mostrar prévia e bloquear o lote até resolver os erros." + author: "user" + at: "2026-11-16T11:11:49.716758Z" + supersedes: null +- id: "ANS-0007" + questionId: "QST-0003" + choices: [] + text: "Esclarecimento do usuário: nao existe multiprojeto no DF, o lance eh que\ + \ o AIE pode ter varios projetos usando o DF (cada um com o seu) debaixo de sua\ + \ umbrella. Mantém a resposta anterior: no multiprojeto, o work deveria descrever\ + \ quais os targets daquela tarefa, entao, vamos manter esse padrao." + author: "user" + at: "2026-11-16T11:17:00.197091Z" + supersedes: "ANS-0003" +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 14 +previousHash: "cfcf59166008a62af5b07c25bb8f569a053cd98c0275b8625e928ac1508b20f4" +updatedAt: "2026-11-16T11:17:00.201386Z" +updatedBy: "user" +changeReason: "Answer revised; related conclusions may need review" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0015.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0015.md new file mode 100644 index 0000000..69e7577 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0015.md @@ -0,0 +1,174 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +- id: "ANS-0003" + questionId: "QST-0003" + choices: [] + text: "no multiprojeto, o work deveria descrever quais os targets daquela tarefa,\ + \ entao, vamos manter esse padrao" + author: "user" + at: "2026-11-16T11:11:36.170913Z" + supersedes: null +- id: "ANS-0004" + questionId: "QST-0004" + choices: + - "1" + text: "sim — importar como draft, preservando o estado legado como proveniência." + author: "user" + at: "2026-11-16T11:11:39.795538Z" + supersedes: null +- id: "ANS-0005" + questionId: "QST-0005" + choices: + - "1" + text: "sim — ignorar conteúdo idêntico e apresentar alterações para revisão, sem\ + \ sobrescrever." + author: "user" + at: "2026-11-16T11:11:44.260841Z" + supersedes: null +- id: "ANS-0006" + questionId: "QST-0006" + choices: + - "1" + text: "sim — mostrar prévia e bloquear o lote até resolver os erros." + author: "user" + at: "2026-11-16T11:11:49.716758Z" + supersedes: null +- id: "ANS-0007" + questionId: "QST-0003" + choices: [] + text: "Esclarecimento do usuário: nao existe multiprojeto no DF, o lance eh que\ + \ o AIE pode ter varios projetos usando o DF (cada um com o seu) debaixo de sua\ + \ umbrella. Mantém a resposta anterior: no multiprojeto, o work deveria descrever\ + \ quais os targets daquela tarefa, entao, vamos manter esse padrao." + author: "user" + at: "2026-11-16T11:17:00.197091Z" + supersedes: "ANS-0003" +- id: "ANS-0008" + questionId: "QST-0001" + choices: [] + text: "Esclarecimento explícito após inspeção dos estados reais: Não: importar exclusivamente\ + \ DECs com status open, verificando também se a tarefa já começou ou terminou.\ + \ DECs accepted ficam fora mesmo quando o plano ainda não começou. Mantém a exclusã\ + o de tarefas em andamento ou completed." + author: "user" + at: "2026-11-16T11:17:43.384586Z" + supersedes: "ANS-0001" +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 15 +previousHash: "b623f4bf8c69b4416a4fd1a2c0ed79391304f54357854f22f004ce327ab6f666" +updatedAt: "2026-11-16T11:17:43.388793Z" +updatedBy: "user" +changeReason: "Answer revised; related conclusions may need review" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0016.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0016.md new file mode 100644 index 0000000..f060d58 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0016.md @@ -0,0 +1,181 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +- id: "ANS-0003" + questionId: "QST-0003" + choices: [] + text: "no multiprojeto, o work deveria descrever quais os targets daquela tarefa,\ + \ entao, vamos manter esse padrao" + author: "user" + at: "2026-11-16T11:11:36.170913Z" + supersedes: null +- id: "ANS-0004" + questionId: "QST-0004" + choices: + - "1" + text: "sim — importar como draft, preservando o estado legado como proveniência." + author: "user" + at: "2026-11-16T11:11:39.795538Z" + supersedes: null +- id: "ANS-0005" + questionId: "QST-0005" + choices: + - "1" + text: "sim — ignorar conteúdo idêntico e apresentar alterações para revisão, sem\ + \ sobrescrever." + author: "user" + at: "2026-11-16T11:11:44.260841Z" + supersedes: null +- id: "ANS-0006" + questionId: "QST-0006" + choices: + - "1" + text: "sim — mostrar prévia e bloquear o lote até resolver os erros." + author: "user" + at: "2026-11-16T11:11:49.716758Z" + supersedes: null +- id: "ANS-0007" + questionId: "QST-0003" + choices: [] + text: "Esclarecimento do usuário: nao existe multiprojeto no DF, o lance eh que\ + \ o AIE pode ter varios projetos usando o DF (cada um com o seu) debaixo de sua\ + \ umbrella. Mantém a resposta anterior: no multiprojeto, o work deveria descrever\ + \ quais os targets daquela tarefa, entao, vamos manter esse padrao." + author: "user" + at: "2026-11-16T11:17:00.197091Z" + supersedes: "ANS-0003" +- id: "ANS-0008" + questionId: "QST-0001" + choices: [] + text: "Esclarecimento explícito após inspeção dos estados reais: Não: importar exclusivamente\ + \ DECs com status open, verificando também se a tarefa já começou ou terminou.\ + \ DECs accepted ficam fora mesmo quando o plano ainda não começou. Mantém a exclusã\ + o de tarefas em andamento ou completed." + author: "user" + at: "2026-11-16T11:17:43.384586Z" + supersedes: "ANS-0001" +- id: "ANS-0009" + questionId: "QST-0001" + choices: [] + text: "para ser mais preciso, a AGD da dec deve estar open" + author: "user" + at: "2026-11-16T11:19:34.540831Z" + supersedes: "ANS-0008" +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 16 +previousHash: "3b8c6c20945c8bceac194c1eb338ec700227edce905caab8e712e73589b13fd3" +updatedAt: "2026-11-16T11:19:34.545257Z" +updatedBy: "user" +changeReason: "Answer revised; related conclusions may need review" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0017.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0017.md new file mode 100644 index 0000000..da848be --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/.history/SVY-0001/r0017.md @@ -0,0 +1,189 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +- id: "ANS-0003" + questionId: "QST-0003" + choices: [] + text: "no multiprojeto, o work deveria descrever quais os targets daquela tarefa,\ + \ entao, vamos manter esse padrao" + author: "user" + at: "2026-11-16T11:11:36.170913Z" + supersedes: null +- id: "ANS-0004" + questionId: "QST-0004" + choices: + - "1" + text: "sim — importar como draft, preservando o estado legado como proveniência." + author: "user" + at: "2026-11-16T11:11:39.795538Z" + supersedes: null +- id: "ANS-0005" + questionId: "QST-0005" + choices: + - "1" + text: "sim — ignorar conteúdo idêntico e apresentar alterações para revisão, sem\ + \ sobrescrever." + author: "user" + at: "2026-11-16T11:11:44.260841Z" + supersedes: null +- id: "ANS-0006" + questionId: "QST-0006" + choices: + - "1" + text: "sim — mostrar prévia e bloquear o lote até resolver os erros." + author: "user" + at: "2026-11-16T11:11:49.716758Z" + supersedes: null +- id: "ANS-0007" + questionId: "QST-0003" + choices: [] + text: "Esclarecimento do usuário: nao existe multiprojeto no DF, o lance eh que\ + \ o AIE pode ter varios projetos usando o DF (cada um com o seu) debaixo de sua\ + \ umbrella. Mantém a resposta anterior: no multiprojeto, o work deveria descrever\ + \ quais os targets daquela tarefa, entao, vamos manter esse padrao." + author: "user" + at: "2026-11-16T11:17:00.197091Z" + supersedes: "ANS-0003" +- id: "ANS-0008" + questionId: "QST-0001" + choices: [] + text: "Esclarecimento explícito após inspeção dos estados reais: Não: importar exclusivamente\ + \ DECs com status open, verificando também se a tarefa já começou ou terminou.\ + \ DECs accepted ficam fora mesmo quando o plano ainda não começou. Mantém a exclusã\ + o de tarefas em andamento ou completed." + author: "user" + at: "2026-11-16T11:17:43.384586Z" + supersedes: "ANS-0001" +- id: "ANS-0009" + questionId: "QST-0001" + choices: [] + text: "para ser mais preciso, a AGD da dec deve estar open" + author: "user" + at: "2026-11-16T11:19:34.540831Z" + supersedes: "ANS-0008" +- id: "ANS-0010" + questionId: "QST-0001" + choices: [] + text: "na verdade nao vamos importar DECs vamos importar DSCs, agendas em aberto\ + \ somente" + author: "user" + at: "2026-11-16T11:22:20.924180Z" + supersedes: "ANS-0009" +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 17 +previousHash: "dc0af60bc582bbbb6fed3b36dc64153d6471af12a252f2de374c63e9b2d8a671" +updatedAt: "2026-11-16T11:22:20.928449Z" +updatedBy: "user" +changeReason: "Answer revised; related conclusions may need review" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/SVY-0001.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/SVY-0001.md new file mode 100644 index 0000000..ba39fc6 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/surveys/SVY-0001.md @@ -0,0 +1,197 @@ +--- +schemaVersion: 1 +id: "SVY-0001" +workId: "WRK-0007" +title: "Questões em aberto do importer de DECs" +questions: +- id: "QST-0001" + topicId: "main" + text: "Quais DECs devem entrar na importação?" + options: + - id: "1" + text: "Permitir selecionar DECs e filtrar por estado, com seleção explícita na\ + \ prévia." + - id: "2" + text: "Importar somente DECs aceitas." + - id: "3" + text: "Importar todas as DECs encontradas." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0002" + topicId: "main" + text: "Como agrupar as DECs em Works de destino?" + options: + - id: "1" + text: "Criar um Work por discussão de origem, agrupando suas DECs." + - id: "2" + text: "Criar um Work para cada DEC." + - id: "3" + text: "Adicionar as DECs a um Work existente indicado pelo usuário." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0003" + topicId: "main" + text: "Como tratar os projetos de uma origem multiprojeto?" + options: + - id: "1" + text: "Exigir um mapeamento explícito de cada projeto de origem para um projeto\ + \ AIE de destino, permitindo destinos iguais ou separados." + - id: "2" + text: "Concentrar todos no projeto AIE atual, mantendo a identificação de origem." + - id: "3" + text: "Criar automaticamente um projeto AIE separado para cada projeto de origem." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0004" + topicId: "main" + text: "Como tratar o estado e a aprovação das DECs legadas?" + options: + - id: "1" + text: "Preservar o estado legado como proveniência e criar DECs em draft para\ + \ revisão no AIE." + - id: "2" + text: "Preservar o estado normativo quando houver registro verificável na origem,\ + \ distinguindo aprovação histórica de aprovação nova." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0005" + topicId: "main" + text: "O que deve acontecer ao importar novamente a mesma origem?" + options: + - id: "1" + text: "Ignorar itens idênticos e relatar alterações ou colisões para revisão,\ + \ sem sobrescrever." + - id: "2" + text: "Criar revisões automaticamente para itens alterados, preservando o histó\ + rico." + - id: "3" + text: "Recusar toda reimportação." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +- id: "QST-0006" + topicId: "main" + text: "Como proceder com DECs inválidas ou referências não resolvidas?" + options: + - id: "1" + text: "Mostrar prévia e bloquear a aplicação do lote selecionado até resolver\ + \ os erros." + - id: "2" + text: "Importar os itens válidos e relatar os itens ignorados." + multiple: false + recommendedOption: "1" + sources: + - "DSC-0002" +answers: +- id: "ANS-0001" + questionId: "QST-0001" + choices: [] + text: "eu gostaria de importar somente as em aberto ainda, nada em andamento ou\ + \ completed" + author: "user" + at: "2026-11-16T11:11:29.582331Z" + supersedes: null +- id: "ANS-0002" + questionId: "QST-0002" + choices: + - "1" + text: "sim — um Work por discussão de origem, agrupando suas DECs." + author: "user" + at: "2026-11-16T11:11:33.255803Z" + supersedes: null +- id: "ANS-0003" + questionId: "QST-0003" + choices: [] + text: "no multiprojeto, o work deveria descrever quais os targets daquela tarefa,\ + \ entao, vamos manter esse padrao" + author: "user" + at: "2026-11-16T11:11:36.170913Z" + supersedes: null +- id: "ANS-0004" + questionId: "QST-0004" + choices: + - "1" + text: "sim — importar como draft, preservando o estado legado como proveniência." + author: "user" + at: "2026-11-16T11:11:39.795538Z" + supersedes: null +- id: "ANS-0005" + questionId: "QST-0005" + choices: + - "1" + text: "sim — ignorar conteúdo idêntico e apresentar alterações para revisão, sem\ + \ sobrescrever." + author: "user" + at: "2026-11-16T11:11:44.260841Z" + supersedes: null +- id: "ANS-0006" + questionId: "QST-0006" + choices: + - "1" + text: "sim — mostrar prévia e bloquear o lote até resolver os erros." + author: "user" + at: "2026-11-16T11:11:49.716758Z" + supersedes: null +- id: "ANS-0007" + questionId: "QST-0003" + choices: [] + text: "Esclarecimento do usuário: nao existe multiprojeto no DF, o lance eh que\ + \ o AIE pode ter varios projetos usando o DF (cada um com o seu) debaixo de sua\ + \ umbrella. Mantém a resposta anterior: no multiprojeto, o work deveria descrever\ + \ quais os targets daquela tarefa, entao, vamos manter esse padrao." + author: "user" + at: "2026-11-16T11:17:00.197091Z" + supersedes: "ANS-0003" +- id: "ANS-0008" + questionId: "QST-0001" + choices: [] + text: "Esclarecimento explícito após inspeção dos estados reais: Não: importar exclusivamente\ + \ DECs com status open, verificando também se a tarefa já começou ou terminou.\ + \ DECs accepted ficam fora mesmo quando o plano ainda não começou. Mantém a exclusã\ + o de tarefas em andamento ou completed." + author: "user" + at: "2026-11-16T11:17:43.384586Z" + supersedes: "ANS-0001" +- id: "ANS-0009" + questionId: "QST-0001" + choices: [] + text: "para ser mais preciso, a AGD da dec deve estar open" + author: "user" + at: "2026-11-16T11:19:34.540831Z" + supersedes: "ANS-0008" +- id: "ANS-0010" + questionId: "QST-0001" + choices: [] + text: "na verdade nao vamos importar DECs vamos importar DSCs, agendas em aberto\ + \ somente" + author: "user" + at: "2026-11-16T11:22:20.924180Z" + supersedes: "ANS-0009" +- id: "ANS-0011" + questionId: "QST-0004" + choices: [] + text: "na verdade nao vamos importar DECs vamos importar DSCs, agendas em aberto\ + \ somente" + author: "user" + at: "2026-11-16T11:22:25.139583Z" + supersedes: "ANS-0004" +author: "codex" +createdAt: "2026-11-16T11:02:36.890280Z" +revision: 18 +previousHash: "2ba14bbe960f013274af112a006f35516844dec5213c651ddf67a7236fd028d1" +updatedAt: "2026-11-16T11:22:25.144942Z" +updatedBy: "user" +changeReason: "Answer revised; related conclusions may need review" +documentVersion: 2 +--- + +Refinamento da DSC-0002. Alternativas e recomendações são propostas; nenhuma resposta ou aprovação foi presumida. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/work.md b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/work.md new file mode 100644 index 0000000..857b7f7 --- /dev/null +++ b/.ai-engineering/works/WRK-0007-importar-decs-do-discussion-framework-em-projetos-simples-e/work.md @@ -0,0 +1,69 @@ +--- +schemaVersion: 1 +id: "WRK-0007" +title: "Importar DSCs com agendas abertas do Discussion Framework" +description: "Criar o importer de discussões (DSCs) do Discussion Framework que tenham\ + \ agendas com status open, trazendo somente o conteúdo dessas AGDs abertas para\ + \ um Work por discussão. Atender uma origem simples ou várias origens DF independentes\ + \ sob a umbrella AIE e descrever os targets da tarefa no Work." +goal: "Importar DSCs com agendas abertas para Works AIE, preservando somente as AGDs\ + \ open e seus vínculos de origem." +motivation: "Permitir continuar no AI Engineering as discussões com agendas ainda\ + \ abertas, tanto de uma origem DF quanto de vários projetos sob a umbrella AIE." +constraints: +- "Selecionar DSCs com pelo menos uma AGD de status open e importar somente suas agendas\ + \ abertas. Não importar DECs ou planos." +- "Na umbrella AIE, cada projeto pode ter sua própria árvore DF independente; o Work\ + \ deve descrever os targets da tarefa, preservando o padrão de origem." +acceptanceCriteria: +- "Importar DSCs com AGDs open de uma origem simples do Discussion Framework." +- "Importar DSCs de várias origens DF independentes sob a umbrella AIE e descrever\ + \ no Work os targets da tarefa." +- "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." +- "Criar um Work por DSC de origem, agrupando suas agendas abertas e preservando integralmente\ + \ o conteúdo e os vínculos de origem." +- "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." +- "Em reimportações, ignorar itens idênticos e apresentar alterações ou colisões para\ + \ 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" +createdAt: "2026-11-16T11:01:09.026342Z" +updatedAt: "2026-11-16T12:29:40.753798Z" +author: "user" +repositories: [] +discussions: +- "DSC-0001" +- "DSC-0002" +- "DSC-0003" +- "DSC-0004" +- "DSC-0005" +- "DSC-0006" +- "DSC-0007" +- "DSC-0008" +- "DSC-0009" +- "DSC-0010" +- "DSC-0011" +decisions: +- "DEC-0001" +artifacts: +- "ART-0001" +- "ART-0002" +- "ART-0003" +- "ART-0004" +- "ART-0005" +- "ART-0006" +plans: +- "PLN-0001" +completions: [] +events: [] +archived: false +topics: [] +surveys: +- "SVY-0001" +dispositions: [] +agentRuns: [] +epic: false +--- diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0001/artifact.yaml b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0001/artifact.yaml new file mode 100644 index 0000000..33f392e --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0001/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0001" +workId: "WRK-0008" +origin: "Execução local WRK-0008 em 2026-11-16" +purpose: "Revisão Git e SHA-256 dos treze arquivos de implementação, documentação\ + \ e testes da promoção automática." +path: "artifacts/evidence/ART-0001/payload" +sha256: "dfe90d60639b2b28a0890cc0c8b8770836434a4ef82596ec69b487da8b6d0f49" +size: 1677 +author: "codex" +createdAt: "2026-11-16T12:07:10.894926Z" diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0001/payload b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0001/payload new file mode 100644 index 0000000..f8cf877 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0001/payload @@ -0,0 +1,18 @@ +{ + "head": "95c28e2e792762990af3bba377327d9472a63e96", + "files": { + "README.md": "9ad8bdb328fcd48af33479c03de6d5bc2209b68339ae3dbccb0c947029c03804", + "docs/architecture.md": "ca19fed4f1142b76c57fcdde57c7c1f01610a82bf3b4900a78d5ba6f89163f07", + "docs/protocol.md": "8b232f0e85b48400f2d3cd0c5a9bcd0e1858c1f2e625f5e280b19b811efbe2eb", + "scripts/native-smoke.sh": "049beab6a9e63a8722b34a10965d466ca396b458c7f44cf229d800bf94a87ed1", + "src/main/java/net/intrepid/aiengineering/NativeHints.java": "2526764a4f4bfb127f0b261fb5c416c39df8c73c35a036b76c5bd08f679378b2", + "src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java": "d133da7fa83d122cd8eea1ff0cba4cad13ee25317ec6526281ab203fb58ac76d", + "src/main/java/net/intrepid/aiengineering/decision/Decision.java": "717c51964fb61dd0dbaed46c8f939c3d794883e552addd722637466e6d8112c2", + "src/main/java/net/intrepid/aiengineering/decision/DecisionService.java": "e138c4d5d16e7a09e8711ffb7bcb9b144007705fb6511d8cef675c0ed503d6b9", + "src/main/java/net/intrepid/aiengineering/planning/PlanService.java": "a0416a256dc21966db481e343f01436be9d72971a677f3b8089c75457187cfa5", + "src/main/java/net/intrepid/aiengineering/verification/VerificationService.java": "2109b3dee1a23950f007c88c5e19ad04c250c4bbe79c9f10e28acc4039b93a02", + "src/main/resources/protocol/README.md": "7e7048326a46fa8627cf808ccaa4b79da40ce7c41b22bab29ee5980d8c490071", + "src/main/resources/protocol/protocol.json": "f335cc5578ec505db65a6eee9289654682a4193c110ef6856a9e9c22faf03d72", + "src/test/java/net/intrepid/aiengineering/PlanDecisionPromotionTest.java": "3fc7d8bdec01a8f912e2da35cf87b5f66ccb751c43eec234e3ee5737f59c0108" + } +} diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0002/artifact.yaml b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0002/artifact.yaml new file mode 100644 index 0000000..3456455 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0002/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0002" +workId: "WRK-0008" +origin: "Execução local WRK-0008 em 2026-11-16" +purpose: "Verificação focada inicial: promoção, fluxo operacional, segurança e compatibilidade\ + \ histórica." +path: "artifacts/evidence/ART-0002/payload" +sha256: "362ef092e9f9282947c5df35e981b796abc527c6de34e0844170ac649a64f523" +size: 1113 +author: "codex" +createdAt: "2026-11-16T12:07:11.340769Z" diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0002/payload b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0002/payload new file mode 100644 index 0000000..dfa825a --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0002/payload @@ -0,0 +1,26 @@ +> Task :compileJava +> Task :processResources UP-TO-DATE +> 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 :compileTestJava +> Task :processTestResources UP-TO-DATE +> Task :testClasses + +> Task :processTestAot +11:52:07.934 [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 44s +15 actionable tasks: 8 executed, 7 up-to-date +Consider enabling configuration cache to speed up this build: https://docs.gradle.org/9.3.1/userguide/configuration_cache_enabling.html diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0003/artifact.yaml b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0003/artifact.yaml new file mode 100644 index 0000000..a482417 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0003/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0003" +workId: "WRK-0008" +origin: "Execução local WRK-0008 em 2026-11-16" +purpose: "Primeira verificação ampla: 135 de 136 testes passaram; falha na expectativa\ + \ do código de erro de um teste novo, posteriormente corrigida." +path: "artifacts/evidence/ART-0003/payload" +sha256: "ec17e76053564938ce64db4d3a0dd0119cf9468aa975e201c0a05db09b2c2c9e" +size: 1642 +author: "codex" +createdAt: "2026-11-16T12:07:11.629809Z" diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0003/payload b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0003/payload new file mode 100644 index 0000000..e579e65 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0003/payload @@ -0,0 +1,46 @@ + +> 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 +> Task :processAotResources +> Task :aotClasses +> Task :collectReachabilityMetadata UP-TO-DATE +> Task :bootJar +> Task :jar +> Task :compileTestJava +> Task :processTestResources UP-TO-DATE +> Task :testClasses + +> Task :processTestAot +11:57:07.204 [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 + +PlanDecisionPromotionTest > occupiedPlanOutputDoesNotPromoteItsDecision() FAILED + org.opentest4j.AssertionFailedError at PlanDecisionPromotionTest.java:152 + +136 tests completed, 1 failed + +> Task :test FAILED +> Task :jacocoTestReport + +FAILURE: Build failed with an exception. + +* What went wrong: +Execution failed for task ':test'. +> There were failing tests. See the report at: file:///Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/reports/tests/test/index.html + +* Try: +> Run with --scan to get full insights from a Build Scan (powered by Develocity). + +BUILD FAILED in 5m 21s +17 actionable tasks: 13 executed, 4 up-to-date diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0004/artifact.yaml b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0004/artifact.yaml new file mode 100644 index 0000000..21e024d --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0004/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0004" +workId: "WRK-0008" +origin: "Execução local final JVM em 2026-11-16" +purpose: "Gradle check concluído: 136 testes JVM sem falhas; tentativa nativa subsequente\ + \ recusada por falta de native-image no Java padrão, retomada separadamente com\ + \ GraalVM." +path: "artifacts/evidence/ART-0004/payload" +sha256: "9399b7b9e9f8b6168aec91d7095965be3f08e5e0fb00d0a726832bad86d351e3" +size: 2090 +author: "codex" +createdAt: "2026-11-16T12:18:04.948283Z" diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0004/payload b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0004/payload new file mode 100644 index 0000000..71224ae --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0004/payload @@ -0,0 +1,49 @@ + +> Task :jenkinsPipelineTest +Jenkins pipeline fixture passed: 11 success/failure scenarios (no controller or plugins invoked). + +> Task :compileJava +> Task :processResources UP-TO-DATE +> 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 +12:02:59.623 [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 :nativeCompile FAILED +> Task :jacocoTestReport + +FAILURE: Build failed with an exception. + +* What went wrong: +Execution failed for task ':nativeCompile'. +> /Users/niltonconstantino/.sdkman/candidates/java/current/bin/native-image wasn't found. This probably means that JDK isn't a GraalVM distribution. + Make sure to declare the GRAALVM_HOME or JAVA_HOME environment variable or install GraalVM withnative-image in a standard location recognized by Gradle Java toolchain support + +* Try: +> Run with --stacktrace option to get the stack trace. +> Run with --info or --debug option to get more log output. +> Run with --scan to get full insights from a Build Scan (powered by Develocity). +> Get more help at https://help.gradle.org. + +BUILD FAILED in 5m 20s +19 actionable tasks: 12 executed, 7 up-to-date diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0005/artifact.yaml b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0005/artifact.yaml new file mode 100644 index 0000000..d6e5e81 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0005/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0005" +workId: "WRK-0008" +origin: "Execução local GraalVM em 2026-11-16" +purpose: "GraalVM macOS ARM64: nativeCompile, nativeDistZip e nativeDistTar aprovados;\ + \ log completo da compilação com JAVA_HOME/GRAALVM_HOME instalados." +path: "artifacts/evidence/ART-0005/payload" +sha256: "b3373e61a47606710193c2b21dd11d39103878f45424bc6dfce1df32551e95b3" +size: 9574 +author: "codex" +createdAt: "2026-11-16T12:27:33.362744Z" diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0005/payload b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0005/payload new file mode 100644 index 0000000..f22cf07 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0005/payload @@ -0,0 +1,109 @@ +> 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 :jar UP-TO-DATE +> Task :generateResourcesConfigFile UP-TO-DATE + +> 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 +Warning: Using a deprecated option --no-fallback from 'META-INF/native-image/net.intrepid/ai-engineering/native-image.properties' in 'file:///Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/resources/aot/'. No effect, no replacement available +Warning: Using a deprecated option --no-fallback from command line. No effect, no replacement available +Warning: Using a deprecated option --no-fallback from command line. No effect, no replacement available +Warning: Option 'DynamicProxyConfigurationResources' is deprecated and might be removed in a future release: This can be caused by a proxy-config.json file in your META-INF directory. Consider including proxy configuration in the reflection section of reachability-metadata.json instead.. Please refer to the GraalVM release notes. +Warning: Option 'FallbackThreshold' is deprecated and might be removed in a future release: It no longer has any effect, and no replacement is available. Please refer to the GraalVM release notes. +Warning: Option 'FallbackThreshold' is deprecated and might be removed in a future release: It no longer has any effect, and no replacement is available. Please refer to the GraalVM release notes. +Warning: Option 'FallbackThreshold' is deprecated and might be removed in a future release: It no longer has any effect, and no replacement is available. Please refer to the GraalVM release notes. +======================================================================================================================== +GraalVM Native Image: Generating 'ai-engineering' (executable)... +======================================================================================================================== +For detailed information and explanations on the build output, visit: +https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/BuildOutput.md +------------------------------------------------------------------------------------------------------------------------ +[1/8] Initializing... (10.1s @ 0.21GiB) + Builder configuration: + - Java version: 25.0.5.0.3+1, vendor version: GraalVM CE 25.5.5.0.3+1.1 + - Graal compiler: optimization level: 1, target machine: armv8.1-a + - C compiler: cc (apple, arm64, 21.0.0) + - Assertions: disabled, system assertions: disabled + - 1 user-specific feature(s): + - org.springframework.aot.nativex.feature.PreComputeFieldFeature + Image configuration: + - Garbage collector: Serial GC (max heap size: 80% of RAM) + - Assertions: disabled (class-specific config may apply), system assertions: disabled +------------------------------------------------------------------------------------------------------------------------ +Build resources: + - 8.32GiB of memory (52.0% of system memory, using all available memory) + - 10 thread(s) (100.0% of 10 available processor(s), determined at start) +SLF4J(W): No SLF4J providers were found. +SLF4J(W): Defaulting to no-operation (NOP) logger implementation +SLF4J(W): See https://www.slf4j.org/codes.html#noProviders for further details. +[2/8] Performing analysis... [******] (15.9s @ 1.26GiB) + 14,388 types, 20,091 fields, and 67,152 methods found reachable + 870 types, 196 fields, and 3,020 methods registered for reflection + 62 types, 62 fields, and 56 methods registered for JNI access + 202 resource accesses registered with 299.58KiB total size + 5 native libraries: -framework CoreServices, -framework Foundation, dl, pthread, z +[3/8] Building universe... (2.7s @ 1.45GiB) +[4/8] Parsing methods... [*] (1.9s @ 1.58GiB) +[5/8] Inlining methods... [***] (1.2s @ 1.71GiB) +[6/8] Compiling methods... [*****] (21.7s @ 1.38GiB) +[7/8] Laying out methods... [**] (4.0s @ 1.71GiB) +[8/8] Creating image... [**] (3.7s @ 1.95GiB) + 21.05MiB (48.75%) for code area: 43,129 compilation units + 21.50MiB (49.79%) for image heap: 308,918 objects and 45 resources + 643.91KiB ( 1.46%) for other data + 43.18MiB in total image size, 43.18MiB in total file size +------------------------------------------------------------------------------------------------------------------------ +Top 10 origins of code area: Top 10 object types in image heap: + 972.69KiB java.base/java.util 5.56MiB byte[] for code metadata + 795.06KiB java.base/java.lang.invoke 3.99MiB byte[] for string data + 543.53KiB picocli 2.16MiB java.base/java.lang.String + 533.17KiB java.base/java.lang 1.81MiB java.base/java.lang.Class + 514.72KiB java.base/jdk.internal.classfile.impl 1.54MiB o.g.n.runtime/c.o.s.core.hub.DynamicHubCompanion + 477.06KiB o.g.n.runtime/com.oracle.svm.core.code 1.12MiB byte[] for general heap data + 440.84KiB java.base/java.util.concurrent 844.88KiB byte[] for reflection metadata + 390.97KiB java.base/com.sun.crypto.provider 401.65KiB java.base/java.lang.Object[] + 348.91KiB java.base/java.io 308.57KiB heap alignment + 319.18KiB java.base/sun.security.provider 302.86KiB java.base/java.lang.String[] + 15.84MiB for 585 more packages 3.51MiB for 3092 more object types +------------------------------------------------------------------------------------------------------------------------ +Recommendations: + FUTR: Use '--future-defaults=all' to prepare for future releases. + AWT: Use the tracing agent to collect metadata for AWT. + HEAP: Set max heap for improved and more predictable memory usage. + CPU: Enable more CPU features with '-march=native' for improved performance. +------------------------------------------------------------------------------------------------------------------------ + 5.5s (8.7% of total time) in 1460 GCs | Peak RSS: 2.51GiB | CPU load: 6.02 +------------------------------------------------------------------------------------------------------------------------ +Build artifacts: + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/ai-engineering (executable, 43.18MiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/libawt.dylib (jdk_library, 517.84KiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/libawt_lwawt.dylib (jdk_library, 1.14MiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/libfontmanager.dylib (jdk_library, 1.04MiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/libfreetype.dylib (jdk_library, 625.45KiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/libjava.dylib (jdk_library_shim, 34.66KiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/libjavajpeg.dylib (jdk_library, 239.59KiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/libjvm.dylib (jdk_library_shim, 33.33KiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/liblcms.dylib (jdk_library, 289.66KiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/libmlib_image.dylib (jdk_library, 474.77KiB) + /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/libosxapp.dylib (jdk_library, 183.00KiB) +======================================================================================================================== +Finished generating 'ai-engineering' in 1m 2s. + +The build process encountered 7 warnings. + +[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 1m 8s +11 actionable tasks: 3 executed, 8 up-to-date +Consider enabling configuration cache to speed up this build: https://docs.gradle.org/9.3.1/userguide/configuration_cache_enabling.html diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0006/artifact.yaml b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0006/artifact.yaml new file mode 100644 index 0000000..5a90e1f --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0006/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0006" +workId: "WRK-0008" +origin: "Verificação local final em 2026-11-16" +purpose: "Smoke nativo completo aprovado, incluindo promoção de DEC sem LLM/JVM e\ + \ os fluxos existentes." +path: "artifacts/evidence/ART-0006/payload" +sha256: "0122529165fd5c0c480fde998793a0c3190f2d25be58673d1f5e30e331f23896" +size: 888 +author: "codex" +createdAt: "2026-11-16T12:29:03.912755Z" diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0006/payload b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0006/payload new file mode 100644 index 0000000..4752588 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0006/payload @@ -0,0 +1,8 @@ +Native simple-project continuity smoke passed (without Git and with one root repository). +Native hexadecimal Work identifiers and legacy reservations smoke passed. +Native refinement smoke passed (topics, surveys, revised answers, two fixtures, dispositions, draft DEC, idempotency and staleness). +Native local-CLI transport smoke passed (controlled subprocess fixtures, guided setup, routing, provenance, replay and reload without JVM/models). +Native EPIC smoke passed (delegation, important/cancelled/optional children, system receipts, reopen, replay, decomposition and nested context). +Native multi-repository continuity smoke passed. +Native operational-cycle smoke passed (discovery, approval, plan, evidence, completion, archive and reopening). +Native Plan consolidation smoke passed (multiple Plans, reviewed cancellation, system completion and fresh-process replay; no model/JVM). diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0007/artifact.yaml b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0007/artifact.yaml new file mode 100644 index 0000000..ad7e3d6 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0007/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0007" +workId: "WRK-0008" +origin: "Verificação local final em 2026-11-16" +purpose: "Resultados consolidados: 136 testes, dez novos casos, onze cenários Jenkins,\ + \ hashes de binários e preservação de 328 arquivos históricos." +path: "artifacts/evidence/ART-0007/payload" +sha256: "738d8a3fc864859160d11d6cd0783f172a69278dadd94a955c37b8996b7095fa" +size: 1255 +author: "codex" +createdAt: "2026-11-16T12:29:04.191096Z" diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0007/payload b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0007/payload new file mode 100644 index 0000000..693e0dd --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0007/payload @@ -0,0 +1,29 @@ +{ + "tests": { + "tests": 136, + "failures": 0, + "errors": 0, + "skipped": 0 + }, + "newPromotionTests": 10, + "jenkinsFixtureScenarios": 11, + "sourceFilesVerified": 13, + "historicalFilesByteIdentical": 328, + "nativeBuildExit": 0, + "nativeSmokeExit": 0, + "testedPlatform": "macOS ARM64", + "binaries": { + "build/native/nativeCompile/ai-engineering": "a436d72cce661919c1bf738121cd5c350d2e2fbe1667381537e07704542eb6bd", + "build/libs/ai-engineering-0.1.0.jar": "4f68d12400f2eb231c5656702d1f5ac9e6af0268e1b8fc4754efa7635a1a767b", + "build/distributions/ai-engineering-0.1.0-mac-os-x-aarch64.tar.gz": "fec9a20b38ad7107b21cb4a02ee62aac8471fe3a5ce65e259516211552111f56", + "build/distributions/ai-engineering-0.1.0-mac-os-x-aarch64.zip": "8befcbd7cf531ba66faae70d908b75d471ed1eac122ab72bec090ab4766b2c46" + }, + "projectValidation": { + "valid": true, + "issues": [] + }, + "environmentNotes": [ + "The combined check/native invocation completed check but nativeCompile could not find native-image in the default Java installation. Native tasks then passed with the already installed GraalVM.", + "Native smoke was rerun outside the sandbox after an installed CLI doctor check was denied sysctl; the complete rerun passed." + ] +} diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0008/artifact.yaml b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0008/artifact.yaml new file mode 100644 index 0000000..0384b07 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0008/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0008" +workId: "WRK-0008" +origin: "Verificação local final em 2026-11-16" +purpose: "Relatório final: comportamento, proveniência, verificações, limites e integraç\ + ão dos Works 7 e 8." +path: "artifacts/evidence/ART-0008/payload" +sha256: "3540b093eb9c8274474f449c86279a2c6c55c93ab25c724e61df79479429ef5c" +size: 5139 +author: "codex" +createdAt: "2026-11-16T12:29:04.457506Z" diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0008/payload b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0008/payload new file mode 100644 index 0000000..2426784 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0008/payload @@ -0,0 +1,40 @@ +# WRK-0008 — promoção determinística de decisões na criação de Plans + +## Comportamento entregue + +Criar um Plan com referências a DECs DRAFT válidas promove essas DECs para ACCEPTED no próprio serviço de planejamento. Não é necessário executar `decision accept` antes e não há chamada a adaptador, classificador ou LLM. + +A transição registra ator `system:planning`, origem `SYSTEM_PLAN`, `planId` causador e `humanApproved: false`. Aprovação direta continua exigindo o atestado humano explícito. Campos novos de proveniência são opcionais e omitidos em registros antigos; aprovações e hashes históricos não foram reescritos. + +DECs já aceitas permanecem intactas. Rejeitadas, substituídas, incompletas, referências inexistentes e substituições conflitantes são recusadas. Referências e revisões são verificadas em conjunto antes de publicar promoções. Criar Plan de uma revisão de DEC aceita também substitui a DEC anterior, preservando ambas e a cadeia de revisões. + +A verificação de proveniência confere as referências da primeira revisão do Plan. Edições posteriores nas referências não apagam o vínculo original nem inventam uma promoção que não ocorreu na criação. + +## Publicação e limites + +A operação usa o lock do projeto e a infraestrutura existente de revisões e escrita atômica por arquivo. Falhas ordinárias durante a publicação tentam restaurar as decisões, os snapshots criados e o Plan dessa operação. Conflitos inesperados na recuperação são reportados para inspeção, sem sobrescrever silenciosamente um arquivo de decisão divergente. + +Não há promessa de transação global resistente a encerramento abrupto do processo. `work validate` diagnostica referências de promoção sem Plan válido. `plan update` não promove drafts: a automação solicitada se aplica à criação de um Plan. + +## Verificação + +- Gradle `check`: 136 testes JVM, zero falhas/erros/skips, incluindo os dez casos novos. Fixture Jenkins: onze cenários aprovados. +- O comando combinado de check/native concluiu a tarefa check, mas a etapa nativa não encontrou native-image no Java padrão. Retomadas somente as tarefas nativas com o GraalVM já instalado: nativeCompile, nativeDistZip e nativeDistTar passaram. +- `bash scripts/native-smoke.sh `: smoke completo aprovado. Inclui a promoção de draft, proveniência, histórico e segundo Plan sem nova promoção, além dos fluxos existentes de projeto simples, hexadecimal, refinamento, transportes controlados, EPIC, vários repositórios, ciclo operacional e consolidação de Plans. +- A primeira tentativa de smoke encontrou uma restrição sysctl do sandbox numa checagem de CLI instalada. A execução completa fora do sandbox passou; isso não exigiu mudança no código. +- JAR atualizado validou WRK-0007 e WRK-0008; a CLI nativa validou o projeto. O protocolo portátil foi atualizado por onboard, depois de diagnóstico de compatibilidade CURRENT, sem migração. +- Os 328 arquivos dos Works históricos WRK-0001 a WRK-0006 permanecem byte a byte idênticos. Treze arquivos de implementação/documentação/testes conferem com o manifesto SHA-256 da entrega. +- Testada distribuição macOS ARM64. Não foram testadas outras plataformas. Hashes do executável, JAR, ZIP e TAR estão no resumo JSON de verificação. +- `git diff --check` passou. + +Os casos novos cobrem promoção sem configuração de modelo; histórico e proveniência; múltiplas DECs; preservação byte a byte de decisões já aceitas; entradas inválidas; falha da segunda publicação com recuperação da primeira; substituição de revisão; conflitos; Plan causador incorreto; arquivo órfão; e duas JVMs concorrentes criando Plans para o mesmo draft, com uma única promoção. + +A primeira execução ampla encontrou uma expectativa incorreta de código de erro em um teste novo: arquivo de Plan não referenciado é recusado com código 4 pela validação prévia do Work, antes da criação. A expectativa foi corrigida para respeitar o contrato existente; o log inicial foi preservado separadamente. A verificação final também inclui o reforço do vínculo de proveniência com a primeira revisão do Plan. + +## Integração e escopo + +Atualizados Decision/DecisionService, PlanService, VerificationService, help de criação de Plan, NativeHints, README, docs de protocolo/arquitetura, instruções portáteis e capability `plan-decision-promotion`. O script native-smoke inclui o novo fluxo. + +O Plan do importer, WRK-0007/PLN-0001, foi criado com seis etapas e referência à sua DEC-0001 aceita. Esse Plan permanece OPEN; a implementação do importer não foi executada neste Work de automação. As aprovações humanas já registradas em WRK-0007 e WRK-0008 permanecem como ocorreram, sem reclassificação retroativa para origem de sistema. + +O comando instalado `aie` é um symlink para `build/native/nativeCompile/ai-engineering` deste projeto. A compilação atualiza esse executável; nenhuma instalação em outro diretório ou alteração de symlink foi necessária. Não houve commit ou push nesta tarefa. diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0009/artifact.yaml b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0009/artifact.yaml new file mode 100644 index 0000000..6914f81 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0009/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0009" +workId: "WRK-0008" +origin: "ai-engineering:plans:c2349247e443b51dedda7bbe73e1b94f50773138d9cdf90b84e6d71cf8e6596b" +purpose: "Deterministic aggregation of completed Plans and reviewed cancellations;\ + \ not semantic verification of prose criteria" +path: "artifacts/evidence/ART-0009/payload" +sha256: "c2349247e443b51dedda7bbe73e1b94f50773138d9cdf90b84e6d71cf8e6596b" +size: 284 +author: "system:plans" +createdAt: "2026-11-16T12:29:53.820419Z" diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0009/payload b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0009/payload new file mode 100644 index 0000000..876dcb0 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/artifacts/evidence/ART-0009/payload @@ -0,0 +1,10 @@ +{ + "schemaVersion" : 1, + "workId" : "WRK-0008", + "inputHash" : "44c864d5a7ae2945f17c700b8adabce29ce22c599b652d6ec6f917880293d857", + "plans" : [ { + "id" : "PLN-0001", + "revision" : 11, + "sha256" : "e3288965d22a0e31525d93328952f9abf3bd6fc5aa44bb13a16c7c2cd52906f0" + } ] +} diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/decisions/.history/DEC-0001/r0001.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/decisions/.history/DEC-0001/r0001.md new file mode 100644 index 0000000..4ddcbd8 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/decisions/.history/DEC-0001/r0001.md @@ -0,0 +1,33 @@ +--- +schemaVersion: 1 +id: "DEC-0001" +workId: "WRK-0008" +title: "Promover drafts referenciados na criação de Plans, com proveniência de sistema" +context: "Hoje PlanService.create exige DECs já aceitas. O usuário determinou que\ + \ criar um Plan a partir de uma DEC draft deve promovê-la automaticamente, sem LLM." +approach: "Na criação de Plan, validar integralmente entradas e referências, promover\ + \ somente DECs DRAFT com contexto/abordagem/justificativa válidos, preservar supersessã\ + o e histórico, registrar origem SYSTEM_PLAN e Plan causador com humanApproved=false.\ + \ DECs já aceitas são no-op; rejeitadas/substituídas continuam inválidas. Aceitaç\ + ão direta permanece com atestado humano explícito." +alternatives: [] +rationale: "A promoção pertence ao fluxo determinístico de planejamento e não exige\ + \ uma operação manual ou um modelo. Proveniência explícita evita confundir essa\ + \ automação com aprovação humana direta." +risks: [] +acceptanceCriteria: [] +approvalStatus: "DRAFT" +author: "codex" +createdAt: "2026-11-16T11:45:31.807402Z" +evidence: [] +revision: 1 +previousHash: null +updatedAt: "2026-11-16T11:45:31.807402Z" +updatedBy: "codex" +changeReason: "Draft created" +approvals: [] +revises: null +supersededBy: null +documentVersion: 2 +--- + diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/decisions/DEC-0001.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/decisions/DEC-0001.md new file mode 100644 index 0000000..09f00b5 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/decisions/DEC-0001.md @@ -0,0 +1,42 @@ +--- +schemaVersion: 1 +id: "DEC-0001" +workId: "WRK-0008" +title: "Promover drafts referenciados na criação de Plans, com proveniência de sistema" +context: "Hoje PlanService.create exige DECs já aceitas. O usuário determinou que\ + \ criar um Plan a partir de uma DEC draft deve promovê-la automaticamente, sem LLM." +approach: "Na criação de Plan, validar integralmente entradas e referências, promover\ + \ somente DECs DRAFT com contexto/abordagem/justificativa válidos, preservar supersessã\ + o e histórico, registrar origem SYSTEM_PLAN e Plan causador com humanApproved=false.\ + \ DECs já aceitas são no-op; rejeitadas/substituídas continuam inválidas. Aceitaç\ + ão direta permanece com atestado humano explícito." +alternatives: [] +rationale: "A promoção pertence ao fluxo determinístico de planejamento e não exige\ + \ uma operação manual ou um modelo. Proveniência explícita evita confundir essa\ + \ automação com aprovação humana direta." +risks: [] +acceptanceCriteria: [] +approvalStatus: "ACCEPTED" +author: "codex" +createdAt: "2026-11-16T11:45:31.807402Z" +evidence: [] +revision: 2 +previousHash: "a77f828fc46653a551236335a8518e6e827ae2032bdedeebe0ac6c40344f11d9" +updatedAt: "2026-11-16T11:45:32.262416Z" +updatedBy: "user" +changeReason: "Instrução explícita do usuário nesta sessão: ao gerar um Plan de uma\ + \ DEC ainda não promovida, o sistema deve promovê-la automaticamente, sem LLM. Esta\ + \ DEC formaliza essa automação e sua proveniência." +approvals: +- status: "ACCEPTED" + by: "user" + reason: "Instrução explícita do usuário nesta sessão: ao gerar um Plan de uma DEC\ + \ ainda não promovida, o sistema deve promovê-la automaticamente, sem LLM. Esta\ + \ DEC formaliza essa automação e sua proveniência." + at: "2026-11-16T11:45:32.262411Z" + humanApproved: true +revises: null +supersededBy: null +documentVersion: 2 +--- + diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/discussions/DSC-0001.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/discussions/DSC-0001.md new file mode 100644 index 0000000..f588b44 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/discussions/DSC-0001.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0001" +workId: "WRK-0008" +discussionId: "main" +kind: "NOTE" +author: "user" +createdAt: "2026-11-16T11:45:31.574581Z" +respondsTo: null +documentVersion: 2 +--- + +isso deve ser mais uma automacao do sistema, ao gerar um plan de uma DEC que ainda nao foi promovida ela deve ser, isso sem usar uma LLM para mudar \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/discussions/DSC-0002.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/discussions/DSC-0002.md new file mode 100644 index 0000000..fde732e --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/discussions/DSC-0002.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0002" +workId: "WRK-0008" +discussionId: "main" +kind: "CONCLUSION" +author: "codex" +createdAt: "2026-11-16T12:29:45.533045Z" +respondsTo: null +documentVersion: 2 +--- + +Automação implementada no serviço de criação de Plans: drafts válidos passam a ACCEPTED sem LLM, com SYSTEM_PLAN/planId e humanApproved=false. Aprovação direta permanece explícita; supersessão e históricos são preservados. A validação verifica o Plan causador na revisão inicial; erros e falhas ordinárias não deixam promoções parciais silenciosas. ART-0001 a ART-0008 registram fontes, testes, execução inicial corrigida, compilação/smoke nativos e relatório. Verificação final: 136 testes JVM, dez novos cenários, onze fixtures Jenkins, JAR/AOT e distribuição/smoke macOS ARM64 aprovados; 328 arquivos históricos intactos. Protocolo local atualizado por onboard e CLI aie atualizada pelo build nativo. O Plan do importer está criado no WRK-0007, com seis etapas pendentes. Esta conclusão cobre apenas a automação do WRK-0008. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0001.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0001.md new file mode 100644 index 0000000..3b8f3c8 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0001.md @@ -0,0 +1,20 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: [] +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-16T11:52:04.328409Z" +updatedBy: "codex" +changeReason: "Plan created" +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0002.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0002.md new file mode 100644 index 0000000..bb44038 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0002.md @@ -0,0 +1,35 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:15.075425Z" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 2 +previousHash: "61e59b3186b4076e003a3d0b06bab0e7c0ecf6c8fffa5f369372a6069a590978" +updatedAt: "2026-11-16T11:54:15.075445Z" +updatedBy: "codex" +changeReason: "Executar a automação explicitamente solicitada e DEC aceita." +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0003.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0003.md new file mode 100644 index 0000000..faa0e7b --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0003.md @@ -0,0 +1,49 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:15.075425Z" +- id: "TSK-0002" + title: "Validar regressões e executável nativo" + description: "Executar testes de promoção, conflitos, falhas, duas JVMs concorrentes,\ + \ fixtures históricas e suíte Gradle check; compilar distribuição nativa e executar\ + \ smoke ampliado." + acceptanceCriteria: + - "Testes JVM e compatibilidade passam sem reescrever históricos." + - "NativeCompile, distribuição e smoke disponíveis passam com logs e limites registrados." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:17.134464Z" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 3 +previousHash: "436bbbb81f48a64e6ead12c5e67f3633d8107430206e9975310a46043f566c3a" +updatedAt: "2026-11-16T11:54:17.134503Z" +updatedBy: "codex" +changeReason: "Executar a automação explicitamente solicitada e DEC aceita." +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0004.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0004.md new file mode 100644 index 0000000..e14b98f --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0004.md @@ -0,0 +1,64 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:15.075425Z" +- id: "TSK-0002" + title: "Validar regressões e executável nativo" + description: "Executar testes de promoção, conflitos, falhas, duas JVMs concorrentes,\ + \ fixtures históricas e suíte Gradle check; compilar distribuição nativa e executar\ + \ smoke ampliado." + acceptanceCriteria: + - "Testes JVM e compatibilidade passam sem reescrever históricos." + - "NativeCompile, distribuição e smoke disponíveis passam com logs e limites registrados." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:17.134464Z" +- id: "TSK-0003" + title: "Publicar documentação e evidências da automação" + description: "Atualizar CLI help, README, protocolo portátil, capacidades e arquitetura;\ + \ registrar fontes, comandos, resultados e verificações dos Works 7 e 8." + acceptanceCriteria: + - "Documentos explicam promoção na criação de Plan, proveniência e limites de publicaç\ + ão." + - "Work e Plan do importer permanecem íntegros; evidências permitem revisão e conclusã\ + o." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:18.977813Z" +status: "OPEN" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 4 +previousHash: "f935de9bca601e66c8f0fd415eefe27039f8937af1223e3baca481cf79a5cfff" +updatedAt: "2026-11-16T11:54:18.977843Z" +updatedBy: "codex" +changeReason: "Executar a automação explicitamente solicitada e DEC aceita." +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0005.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0005.md new file mode 100644 index 0000000..a5ea417 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0005.md @@ -0,0 +1,66 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "ACTIVE" + result: "Implementação e testes focados em andamento; automação solicitada pelo\ + \ usuário." + evidence: [] + updatedAt: "2026-11-16T11:54:21.593590Z" +- id: "TSK-0002" + title: "Validar regressões e executável nativo" + description: "Executar testes de promoção, conflitos, falhas, duas JVMs concorrentes,\ + \ fixtures históricas e suíte Gradle check; compilar distribuição nativa e executar\ + \ smoke ampliado." + acceptanceCriteria: + - "Testes JVM e compatibilidade passam sem reescrever históricos." + - "NativeCompile, distribuição e smoke disponíveis passam com logs e limites registrados." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:17.134464Z" +- id: "TSK-0003" + title: "Publicar documentação e evidências da automação" + description: "Atualizar CLI help, README, protocolo portátil, capacidades e arquitetura;\ + \ registrar fontes, comandos, resultados e verificações dos Works 7 e 8." + acceptanceCriteria: + - "Documentos explicam promoção na criação de Plan, proveniência e limites de publicaç\ + ão." + - "Work e Plan do importer permanecem íntegros; evidências permitem revisão e conclusã\ + o." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:18.977813Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 5 +previousHash: "28c0d0c506b66989312e1ce551ca9fcdf9b0c7993c27e01ac70bb134a9b56a11" +updatedAt: "2026-11-16T11:54:21.593627Z" +updatedBy: "codex" +changeReason: "Implementação e testes focados em andamento; automação solicitada pelo\ + \ usuário." +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0006.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0006.md new file mode 100644 index 0000000..9939062 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0006.md @@ -0,0 +1,70 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "COMPLETED" + result: "Promoção determinística, proveniência, supersessão, validação e recuperaç\ + ão implementadas; 136 testes passaram, incluindo dez novos cenários e fixtures\ + \ históricas." + evidence: + - "ART-0001" + - "ART-0004" + updatedAt: "2026-11-16T12:18:12.673259Z" +- id: "TSK-0002" + title: "Validar regressões e executável nativo" + description: "Executar testes de promoção, conflitos, falhas, duas JVMs concorrentes,\ + \ fixtures históricas e suíte Gradle check; compilar distribuição nativa e executar\ + \ smoke ampliado." + acceptanceCriteria: + - "Testes JVM e compatibilidade passam sem reescrever históricos." + - "NativeCompile, distribuição e smoke disponíveis passam com logs e limites registrados." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:17.134464Z" +- id: "TSK-0003" + title: "Publicar documentação e evidências da automação" + description: "Atualizar CLI help, README, protocolo portátil, capacidades e arquitetura;\ + \ registrar fontes, comandos, resultados e verificações dos Works 7 e 8." + acceptanceCriteria: + - "Documentos explicam promoção na criação de Plan, proveniência e limites de publicaç\ + ão." + - "Work e Plan do importer permanecem íntegros; evidências permitem revisão e conclusã\ + o." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:18.977813Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 6 +previousHash: "36a6d70766208f99024d9f5c7f5cf9fd6f0792430b767ecb6deb42fef31c39b7" +updatedAt: "2026-11-16T12:18:12.676167Z" +updatedBy: "codex" +changeReason: "Promoção determinística, proveniência, supersessão, validação e recuperaç\ + ão implementadas; 136 testes passaram, incluindo dez novos cenários e fixtures histó\ + ricas." +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0007.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0007.md new file mode 100644 index 0000000..86e6a07 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0007.md @@ -0,0 +1,70 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "COMPLETED" + result: "Promoção determinística, proveniência, supersessão, validação e recuperaç\ + ão implementadas; 136 testes passaram, incluindo dez novos cenários e fixtures\ + \ históricas." + evidence: + - "ART-0001" + - "ART-0004" + updatedAt: "2026-11-16T12:18:12.673259Z" +- id: "TSK-0002" + title: "Validar regressões e executável nativo" + description: "Executar testes de promoção, conflitos, falhas, duas JVMs concorrentes,\ + \ fixtures históricas e suíte Gradle check; compilar distribuição nativa e executar\ + \ smoke ampliado." + acceptanceCriteria: + - "Testes JVM e compatibilidade passam sem reescrever históricos." + - "NativeCompile, distribuição e smoke disponíveis passam com logs e limites registrados." + dependsOn: + - "TSK-0001" + status: "ACTIVE" + result: "Gradle check e 136 testes passaram; distribuição nativa compilando com\ + \ GraalVM instalado para smoke final." + evidence: [] + updatedAt: "2026-11-16T12:18:39.722412Z" +- id: "TSK-0003" + title: "Publicar documentação e evidências da automação" + description: "Atualizar CLI help, README, protocolo portátil, capacidades e arquitetura;\ + \ registrar fontes, comandos, resultados e verificações dos Works 7 e 8." + acceptanceCriteria: + - "Documentos explicam promoção na criação de Plan, proveniência e limites de publicaç\ + ão." + - "Work e Plan do importer permanecem íntegros; evidências permitem revisão e conclusã\ + o." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:18.977813Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 7 +previousHash: "86a8dd4f86436bf6bdfac76620dd8d4bbd68a14ec269ebacee5f298d56a786e4" +updatedAt: "2026-11-16T12:18:39.723544Z" +updatedBy: "codex" +changeReason: "Gradle check e 136 testes passaram; distribuição nativa compilando\ + \ com GraalVM instalado para smoke final." +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0008.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0008.md new file mode 100644 index 0000000..23581fa --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0008.md @@ -0,0 +1,74 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "COMPLETED" + result: "Promoção determinística, proveniência, supersessão, validação e recuperaç\ + ão implementadas; 136 testes passaram, incluindo dez novos cenários e fixtures\ + \ históricas." + evidence: + - "ART-0001" + - "ART-0004" + updatedAt: "2026-11-16T12:18:12.673259Z" +- id: "TSK-0002" + title: "Validar regressões e executável nativo" + description: "Executar testes de promoção, conflitos, falhas, duas JVMs concorrentes,\ + \ fixtures históricas e suíte Gradle check; compilar distribuição nativa e executar\ + \ smoke ampliado." + acceptanceCriteria: + - "Testes JVM e compatibilidade passam sem reescrever históricos." + - "NativeCompile, distribuição e smoke disponíveis passam com logs e limites registrados." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "136 testes JVM e dez novos cenários passaram; GraalVM compilou executá\ + vel/ZIP/TAR macOS ARM64 e smoke nativo completo passou. Logs e hashes anexados." + evidence: + - "ART-0004" + - "ART-0005" + - "ART-0006" + - "ART-0007" + updatedAt: "2026-11-16T12:29:05.137568Z" +- id: "TSK-0003" + title: "Publicar documentação e evidências da automação" + description: "Atualizar CLI help, README, protocolo portátil, capacidades e arquitetura;\ + \ registrar fontes, comandos, resultados e verificações dos Works 7 e 8." + acceptanceCriteria: + - "Documentos explicam promoção na criação de Plan, proveniência e limites de publicaç\ + ão." + - "Work e Plan do importer permanecem íntegros; evidências permitem revisão e conclusã\ + o." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-16T11:54:18.977813Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 8 +previousHash: "fa50bc90edd71fd6887a9633a0b52e4c98f56e4ae663e082055a54d4bbc0b002" +updatedAt: "2026-11-16T12:29:05.137602Z" +updatedBy: "codex" +changeReason: "136 testes JVM e dez novos cenários passaram; GraalVM compilou executá\ + vel/ZIP/TAR macOS ARM64 e smoke nativo completo passou. Logs e hashes anexados." +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0009.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0009.md new file mode 100644 index 0000000..dd2f44a --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0009.md @@ -0,0 +1,75 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "COMPLETED" + result: "Promoção determinística, proveniência, supersessão, validação e recuperaç\ + ão implementadas; 136 testes passaram, incluindo dez novos cenários e fixtures\ + \ históricas." + evidence: + - "ART-0001" + - "ART-0004" + updatedAt: "2026-11-16T12:18:12.673259Z" +- id: "TSK-0002" + title: "Validar regressões e executável nativo" + description: "Executar testes de promoção, conflitos, falhas, duas JVMs concorrentes,\ + \ fixtures históricas e suíte Gradle check; compilar distribuição nativa e executar\ + \ smoke ampliado." + acceptanceCriteria: + - "Testes JVM e compatibilidade passam sem reescrever históricos." + - "NativeCompile, distribuição e smoke disponíveis passam com logs e limites registrados." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "136 testes JVM e dez novos cenários passaram; GraalVM compilou executá\ + vel/ZIP/TAR macOS ARM64 e smoke nativo completo passou. Logs e hashes anexados." + evidence: + - "ART-0004" + - "ART-0005" + - "ART-0006" + - "ART-0007" + updatedAt: "2026-11-16T12:29:05.137568Z" +- id: "TSK-0003" + title: "Publicar documentação e evidências da automação" + description: "Atualizar CLI help, README, protocolo portátil, capacidades e arquitetura;\ + \ registrar fontes, comandos, resultados e verificações dos Works 7 e 8." + acceptanceCriteria: + - "Documentos explicam promoção na criação de Plan, proveniência e limites de publicaç\ + ão." + - "Work e Plan do importer permanecem íntegros; evidências permitem revisão e conclusã\ + o." + dependsOn: + - "TSK-0002" + status: "ACTIVE" + result: "Documentação, help, protocolo portátil e evidências integrados; verificaç\ + ões finais de entrega." + evidence: [] + updatedAt: "2026-11-16T12:29:47.919653Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 9 +previousHash: "57ce89fe344ec7c133d3fa9e0a28307690e9a0dcea4e3b72231f13cd1b94799b" +updatedAt: "2026-11-16T12:29:47.919692Z" +updatedBy: "codex" +changeReason: "Documentação, help, protocolo portátil e evidências integrados; verificaç\ + ões finais de entrega." +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0010.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0010.md new file mode 100644 index 0000000..dd9e1a9 --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/.history/PLN-0001/r0010.md @@ -0,0 +1,80 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "COMPLETED" + result: "Promoção determinística, proveniência, supersessão, validação e recuperaç\ + ão implementadas; 136 testes passaram, incluindo dez novos cenários e fixtures\ + \ históricas." + evidence: + - "ART-0001" + - "ART-0004" + updatedAt: "2026-11-16T12:18:12.673259Z" +- id: "TSK-0002" + title: "Validar regressões e executável nativo" + description: "Executar testes de promoção, conflitos, falhas, duas JVMs concorrentes,\ + \ fixtures históricas e suíte Gradle check; compilar distribuição nativa e executar\ + \ smoke ampliado." + acceptanceCriteria: + - "Testes JVM e compatibilidade passam sem reescrever históricos." + - "NativeCompile, distribuição e smoke disponíveis passam com logs e limites registrados." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "136 testes JVM e dez novos cenários passaram; GraalVM compilou executá\ + vel/ZIP/TAR macOS ARM64 e smoke nativo completo passou. Logs e hashes anexados." + evidence: + - "ART-0004" + - "ART-0005" + - "ART-0006" + - "ART-0007" + updatedAt: "2026-11-16T12:29:05.137568Z" +- id: "TSK-0003" + title: "Publicar documentação e evidências da automação" + description: "Atualizar CLI help, README, protocolo portátil, capacidades e arquitetura;\ + \ registrar fontes, comandos, resultados e verificações dos Works 7 e 8." + acceptanceCriteria: + - "Documentos explicam promoção na criação de Plan, proveniência e limites de publicaç\ + ão." + - "Work e Plan do importer permanecem íntegros; evidências permitem revisão e conclusã\ + o." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "CLI e protocolo documentam a promoção; evidências de fontes, 136 testes,\ + \ build/smoke nativos e preservação histórica anexadas. Plan do importer permanece\ + \ aberto e íntegro; git diff --check passou." + evidence: + - "ART-0001" + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:29:50.871686Z" +status: "ACTIVE" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 10 +previousHash: "a1c45f1ec65f7beea65756e02dbca97be02e480449323d59d898bc3a3bedae93" +updatedAt: "2026-11-16T12:29:50.871723Z" +updatedBy: "codex" +changeReason: "CLI e protocolo documentam a promoção; evidências de fontes, 136 testes,\ + \ build/smoke nativos e preservação histórica anexadas. Plan do importer permanece\ + \ aberto e íntegro; git diff --check passou." +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/PLN-0001.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/PLN-0001.md new file mode 100644 index 0000000..acf475c --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/plans/PLN-0001.md @@ -0,0 +1,78 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0008" +title: "Implementar promoção automática de DECs na criação de Plans" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Implementar promoção e proveniência determinísticas" + description: "Alterar Decision/DecisionService e PlanService.create para preparar,\ + \ validar e promover drafts; preservar supersessão e revisões, registrar SYSTEM_PLAN/planId/humanApproved=false,\ + \ manter aceitação direta explícita e recuperar falhas ordinárias." + acceptanceCriteria: + - "Criar Plan promove drafts válidos sem LLM; aceitos são no-op e inválidos não\ + \ mudam." + - "Proveniência e histórico distinguem promoção de sistema; validação confere Plan\ + \ causador." + dependsOn: [] + status: "COMPLETED" + result: "Promoção determinística, proveniência, supersessão, validação e recuperaç\ + ão implementadas; 136 testes passaram, incluindo dez novos cenários e fixtures\ + \ históricas." + evidence: + - "ART-0001" + - "ART-0004" + updatedAt: "2026-11-16T12:18:12.673259Z" +- id: "TSK-0002" + title: "Validar regressões e executável nativo" + description: "Executar testes de promoção, conflitos, falhas, duas JVMs concorrentes,\ + \ fixtures históricas e suíte Gradle check; compilar distribuição nativa e executar\ + \ smoke ampliado." + acceptanceCriteria: + - "Testes JVM e compatibilidade passam sem reescrever históricos." + - "NativeCompile, distribuição e smoke disponíveis passam com logs e limites registrados." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "136 testes JVM e dez novos cenários passaram; GraalVM compilou executá\ + vel/ZIP/TAR macOS ARM64 e smoke nativo completo passou. Logs e hashes anexados." + evidence: + - "ART-0004" + - "ART-0005" + - "ART-0006" + - "ART-0007" + updatedAt: "2026-11-16T12:29:05.137568Z" +- id: "TSK-0003" + title: "Publicar documentação e evidências da automação" + description: "Atualizar CLI help, README, protocolo portátil, capacidades e arquitetura;\ + \ registrar fontes, comandos, resultados e verificações dos Works 7 e 8." + acceptanceCriteria: + - "Documentos explicam promoção na criação de Plan, proveniência e limites de publicaç\ + ão." + - "Work e Plan do importer permanecem íntegros; evidências permitem revisão e conclusã\ + o." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "CLI e protocolo documentam a promoção; evidências de fontes, 136 testes,\ + \ build/smoke nativos e preservação histórica anexadas. Plan do importer permanece\ + \ aberto e íntegro; git diff --check passou." + evidence: + - "ART-0001" + - "ART-0007" + - "ART-0008" + updatedAt: "2026-11-16T12:29:50.871686Z" +status: "COMPLETED" +author: "codex" +createdAt: "2026-11-16T11:52:04.328409Z" +revision: 11 +previousHash: "68af36edd3d286fdd547e721b7b235d35ca4c8b9788596bc504abf7579b1d68b" +updatedAt: "2026-11-16T12:29:52.242381Z" +updatedBy: "system:plans" +changeReason: "All required steps completed; reviewed cancellations retained" +documentVersion: 2 +--- + +Implementar promoção DRAFT para ACCEPTED em PlanService.create, com origem SYSTEM_PLAN e humanApproved=false; preservar aprovação direta, supersessão, compatibilidade e histórico. Validar entradas antes de gravar, recuperar falhas ordinárias e diagnosticar interrupções. Verificar testes JVM, documentação e smoke nativo. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/work.md b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/work.md new file mode 100644 index 0000000..2cfa10f --- /dev/null +++ b/.ai-engineering/works/WRK-0008-promover-decs-automaticamente-ao-criar-plans-vinculados/work.md @@ -0,0 +1,89 @@ +--- +schemaVersion: 1 +id: "WRK-0008" +title: "Promover DECs automaticamente ao criar Plans vinculados" +description: "" +goal: "Criar um Plan a partir de uma DEC draft deve promovê-la deterministicamente,\ + \ sem LLM, com histórico de sistema." +motivation: "" +constraints: [] +acceptanceCriteria: +- "plan create promove DECs DRAFT referenciadas e cria o Plan sem etapa manual de\ + \ aprovação." +- "Proveniência distingue promoção automática de aprovação humana direta e preserva\ + \ revisões históricas." +- "Estados REJECTED/SUPERSEDED, referências inválidas e entradas inválidas são recusados\ + \ sem promoção parcial previsível." +- "Testes JVM, compatibilidade, documentação e verificação nativa confirmam o fluxo\ + \ sem modelo." +status: "COMPLETED" +createdAt: "2026-11-16T11:45:16.608375Z" +updatedAt: "2026-11-16T12:29:53.882214Z" +author: "user" +repositories: [] +discussions: +- "DSC-0001" +- "DSC-0002" +decisions: +- "DEC-0001" +artifacts: +- "ART-0001" +- "ART-0002" +- "ART-0003" +- "ART-0004" +- "ART-0005" +- "ART-0006" +- "ART-0007" +- "ART-0008" +- "ART-0009" +plans: +- "PLN-0001" +completions: +- at: "2026-11-16T12:29:53.882214Z" + by: "system:plans" + summary: "All required Plans completed; requester=codex" + humanApproved: false + scopeHash: "c59aecb6384f472486c22634df0fc371078ec0f5e6734f8db5e559163093bfa0" + criteria: + - criterion: 1 + text: "plan create promove DECs DRAFT referenciadas e cria o Plan sem etapa manual\ + \ de aprovação." + evidence: + - "ART-0009" + - criterion: 2 + text: "Proveniência distingue promoção automática de aprovação humana direta e\ + \ preserva revisões históricas." + evidence: + - "ART-0009" + - criterion: 3 + text: "Estados REJECTED/SUPERSEDED, referências inválidas e entradas inválidas\ + \ são recusados sem promoção parcial previsível." + evidence: + - "ART-0009" + - criterion: 4 + text: "Testes JVM, compatibilidade, documentação e verificação nativa confirmam\ + \ o fluxo sem modelo." + evidence: + - "ART-0009" + integrations: [] + noIntegrationReason: "Canonical changes and execution results are recorded in the\ + \ Plan step evidence" + origin: "SYSTEM_PLANS" + delegation: null + aggregation: + receipt: "ART-0009" + inputHash: "44c864d5a7ae2945f17c700b8adabce29ce22c599b652d6ec6f917880293d857" + requester: "codex" + requestId: "4fa36dfb-b468-4cc2-b430-c3f96398c0cc" +events: +- action: "COMPLETE" + by: "system:plans" + reason: "All required Plans completed; requester=codex" + at: "2026-11-16T12:29:53.882214Z" +archived: false +topics: [] +surveys: [] +dispositions: [] +agentRuns: [] +epic: false +--- diff --git a/README.md b/README.md index d19a352..9b0ca2a 100644 --- a/README.md +++ b/README.md @@ -131,6 +131,10 @@ projects that only need engineering records. ## How work is recorded +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`. + | Record | Purpose | |---|---| | Work | Goal, constraints, acceptance criteria, and lifecycle | diff --git a/docs/architecture.md b/docs/architecture.md index 4944566..40b6a65 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -106,6 +106,15 @@ workflow before introducing intelligent adapters or a legacy importer. Planning a concrete ninth module, not a custom workflow engine. A plan records editable scope, dependencies and externally executed results. Starting/completing steps checks their dependencies and accepted decisions. No repository command is executed by Planning. + +Plan creation prepares deterministic draft-decision promotions through Decision, +validates every reference before publication and records SYSTEM_PLAN provenance +with the causal Plan ID and no fabricated human attestation. Existing accepted +decisions are unchanged. Decision exposes prepared promotion/recovery operations; +Planning coordinates them under the existing project lock. Ordinary failures roll +back the attempted writes; crash interruption remains subject to per-file atomicity +and structural validation. Verification checks promotion links against Plan history. +No adapter is invoked, and the Decision module has no dependency on Planning. Plans/steps can be reopened and revised when observations change. DEC approval is an explicit human-attestation command, with actor, reason and time. diff --git a/docs/protocol.md b/docs/protocol.md index 69b9f15..6be3207 100644 --- a/docs/protocol.md +++ b/docs/protocol.md @@ -263,7 +263,7 @@ empty narrative. Narrative uses document version 2; the JSON `text` field remain Statuses: DRAFT, ACCEPTED, REJECTED, SUPERSEDED. `decision update` changes only drafts, recording actor/reason and a snapshot. Lists replace entire lists; explicit `--clear-*` -options clear them. `--text`/`--text-file` supplies narrative. Acceptance requires +options clear them. `--text`/`--text-file` supplies narrative. Direct acceptance requires nonblank context/approach/rationale, actor/reason and `--human-approved`. This flag is an attestation that approval occurred, not authenticated identity or OS permission. An agent cannot infer approval from a proposal or a prior status. Rejection retains @@ -271,6 +271,18 @@ the proposal. `decision revise` creates a new draft linked to an accepted/reject DEC. Accepting that draft supersedes the prior accepted DEC, preserving both records. Operational choices during execution remain distinct from these formal commitments. +Creating a Plan from a draft DEC is a separate deterministic acceptance route. +The framework records `origin: SYSTEM_PLAN`, the causal `planId`, actor +`system:planning` and `humanApproved: false`; it does not invent a direct human +attestation. Context, approach and rationale must still be nonblank. Referenced +drafts are promoted and their accepted predecessors are superseded with the same +Plan provenance. Already accepted DECs stay byte-identical; rejected/superseded +DECs and conflicting replacements cannot be used to create the Plan. Optional +approval `origin`/`planId` fields are absent on historical direct approvals, whose +meaning and serialization remain unchanged. Readers predating this capability +cannot read new system-promotion records; use the updated CLI, without rewriting +historical approvals. + ## Topics, surveys and adapter runs [Discussion refinement contracts](discussion-slice.md) specify TOP/SVY/DSP/RUN records, @@ -355,6 +367,16 @@ timestamps and revision metadata. Each step (`TSK-0001`, decimal and plan-local) records title/description, acceptance criteria, dependencies, status, result, evidence and modification time. Statuses match Work's five values but describe external work. +`plan create --decision DEC` promotes referenced DRAFT decisions automatically, +without an adapter or LLM. Input, decision and revision-history validation runs +before promotion, under the project lock. Ordinary publication failures roll back +the attempted Plan and promotions. Publication is atomic per file, not a crash-proof +multi-file transaction: interrupted writes or failed recovery remain inspectable +with `work validate`. Validation checks the causal Plan's first revision, so later +Plan reference edits retain the original promotion provenance and cannot invent it. +Creating another Plan from an already accepted DEC does not add an approval. +`plan update` does not promote drafts; review its references before changing them. + Step dependencies must exist in that plan and be acyclic. Starting or completing a step requires completed dependencies and accepted referenced decisions. Completion requires result text (`--reason`) and owned evidence. `plan status COMPLETED` requires diff --git a/scripts/native-smoke.sh b/scripts/native-smoke.sh index 963455e..4b0ea34 100755 --- a/scripts/native-smoke.sh +++ b/scripts/native-smoke.sh @@ -92,6 +92,32 @@ grep -q '"valid" : true' validation.json test ! -e .git cd "$aie_fixture" +# Creating a Plan promotes a draft without a model or direct human attestation. +mkdir plan-promotion +cd plan-promotion +aie_without_git init --name 'Plan Promotion' > init.yaml +aie_without_git work create 'Promote decision' > work.yaml +aie_without_git decision draft WRK-0001 --title 'Chosen approach' --context 'Problem' \ + --approach 'Small implementation' --rationale 'Bounded scope' > draft.yaml +aie_without_git plan create WRK-0001 --title 'Delivery' --decision DEC-0001 --author requester > plan.yaml +aie_without_git decision show WRK-0001 DEC-0001 --format json > promoted.json +grep -q '"approvalStatus" : "ACCEPTED"' promoted.json +grep -q '"origin" : "SYSTEM_PLAN"' promoted.json +grep -q '"humanApproved" : false' promoted.json +grep -q '"planId" : "PLN-0001"' promoted.json +aie_without_git decision history WRK-0001 DEC-0001 --format json > history.json +grep -q '"approvalStatus" : "DRAFT"' history.json +grep -q '"approvalStatus" : "ACCEPTED"' history.json +cp .ai-engineering/works/WRK-0001-promote-decision/decisions/DEC-0001.md before-second-plan.md +aie_without_git plan create WRK-0001 --title 'More delivery' --decision DEC-0001 > second-plan.yaml +cmp before-second-plan.md .ai-engineering/works/WRK-0001-promote-decision/decisions/DEC-0001.md +aie_without_git work context WRK-0001 --format markdown > context.md +grep -q 'SYSTEM_PLAN' context.md +aie_without_git project validate > validation.yaml +aie_without_git project compatibility --format json > compatibility.json +grep -q '"state" : "CURRENT"' compatibility.json +cd "$aie_fixture" + # A single Git repository can contain both the source and protocol workspace. git init -q single cd single diff --git a/src/main/java/net/intrepid/aiengineering/NativeHints.java b/src/main/java/net/intrepid/aiengineering/NativeHints.java index d5c4ee4..bef4ed2 100644 --- a/src/main/java/net/intrepid/aiengineering/NativeHints.java +++ b/src/main/java/net/intrepid/aiengineering/NativeHints.java @@ -15,7 +15,7 @@ public final class NativeHints implements RuntimeHintsRegistrar { @Override public void registerHints(RuntimeHints hints, ClassLoader loader) { for (Class type : new Class[]{ProjectConfig.class, ProjectConfig.Identity.class, ProjectConfig.Repository.class, ProjectConfig.Access.class, ProjectService.Revision.class, Work.class, WorkService.Sequence.class, DiscussionEntry.class, - Decision.class, Decision.Approval.class, Plan.class, Plan.Step.class, Plan.Exclusion.class, + Decision.class, Decision.Approval.class, Decision.ApprovalOrigin.class, Plan.class, Plan.Step.class, Plan.Exclusion.class, PlanCoordinator.PlanSource.class, PlanCoordinator.Receipt.class, PlanCoordinator.Evaluation.class, PlanCoordinator.Result.class, PlanCoordinator.Mutation.class, Work.Aggregation.class, Work.Event.class, Work.Completion.class, Work.CriterionResult.class, Work.Integration.class, diff --git a/src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java b/src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java index 94a540d..16ebc7d 100644 --- a/src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java +++ b/src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java @@ -330,7 +330,7 @@ public final class EngineeringCli implements Runnable { } @Command(name = "plan", mixinStandardHelpOptions = true, description = "Maintain proportional implementation plans; execution remains external.") public class PlanCommands { - @Command(name = "create", mixinStandardHelpOptions = true) + @Command(name = "create", mixinStandardHelpOptions = true, description = "Create a Plan and automatically promote referenced draft decisions without a model call.") int create(@Parameters(index = "0") String work, @Option(names = "--title", required = true) String title, @Option(names = "--description", defaultValue = "") String description, @Option(names = "--decision") List decisions, @Option(names = "--author", defaultValue = "human") String author) { diff --git a/src/main/java/net/intrepid/aiengineering/decision/Decision.java b/src/main/java/net/intrepid/aiengineering/decision/Decision.java index 18200d2..8ac1e17 100644 --- a/src/main/java/net/intrepid/aiengineering/decision/Decision.java +++ b/src/main/java/net/intrepid/aiengineering/decision/Decision.java @@ -4,6 +4,7 @@ import net.intrepid.aiengineering.filesystem.ProtocolException; import net.intrepid.aiengineering.work.Work; import java.time.Instant; import java.util.*; +import com.fasterxml.jackson.annotation.JsonInclude; public record Decision(int schemaVersion, String id, String workId, String title, String context, String approach, List alternatives, String rationale, List risks, List acceptanceCriteria, @@ -11,10 +12,24 @@ public record Decision(int schemaVersion, String id, String workId, String title Integer revision, String previousHash, String updatedAt, String updatedBy, String changeReason, List approvals, String revises, String supersededBy) { public enum Status { DRAFT, ACCEPTED, REJECTED, SUPERSEDED } - public record Approval(Status status, String by, String reason, String at, boolean humanApproved) { + public enum ApprovalOrigin { DIRECT, SYSTEM_PLAN } + public record Approval(Status status, String by, String reason, String at, boolean humanApproved, + @JsonInclude(JsonInclude.Include.NON_NULL) ApprovalOrigin origin, + @JsonInclude(JsonInclude.Include.NON_NULL) String planId) { + public Approval(Status status, String by, String reason, String at, boolean humanApproved) { + this(status, by, reason, at, humanApproved, null, null); + } public Approval { Objects.requireNonNull(status); ProtocolException.text(by, "approval actor"); ProtocolException.text(reason, "approval reason"); Instant.parse(at); - if ((status == Status.ACCEPTED || status == Status.SUPERSEDED) && !humanApproved) throw ProtocolException.validation("Missing human approval attestation"); + if (origin == ApprovalOrigin.SYSTEM_PLAN) { + Work.identifier(planId, "PLN"); + if (humanApproved || !by.equals("system:planning") || (status != Status.ACCEPTED && status != Status.SUPERSEDED)) + throw ProtocolException.validation("Invalid system Plan promotion provenance"); + } else { + if (planId != null) throw ProtocolException.validation("Plan promotion requires SYSTEM_PLAN origin"); + if ((status == Status.ACCEPTED || status == Status.SUPERSEDED) && !humanApproved) + throw ProtocolException.validation("Missing human approval attestation"); + } } } public Decision { @@ -57,9 +72,17 @@ public record Decision(int schemaVersion, String id, String workId, String title } public Decision accept(String by, String reason, boolean humanApproved, String hash) { if (!humanApproved) throw ProtocolException.invalid("--human-approved is required to record an explicit human approval"); + requireAcceptable(); + return transition(Status.ACCEPTED, by, reason, true, hash, null); + } + private void requireAcceptable() { if (approvalStatus != Status.DRAFT) throw ProtocolException.invalid("Only a draft decision can be accepted"); if (context.isBlank() || approach.isBlank() || rationale.isBlank()) throw ProtocolException.validation("Acceptance needs context, approach and rationale"); - return transition(Status.ACCEPTED, by, reason, true, hash, null); + } + public Decision acceptForPlan(String plan, String requester, String hash) { + requireAcceptable(); ProtocolException.text(requester, "Plan requester"); + return transition(Status.ACCEPTED, "system:planning", "Creation of " + plan + " by " + requester + " promotes its draft decision", + false, hash, null, ApprovalOrigin.SYSTEM_PLAN, plan); } public Decision reject(String by, String reason, String hash) { if (approvalStatus != Status.DRAFT) throw ProtocolException.invalid("Only a draft decision can be rejected"); @@ -69,8 +92,17 @@ public record Decision(int schemaVersion, String id, String workId, String title if (approvalStatus != Status.ACCEPTED) throw ProtocolException.invalid("The revised decision is no longer accepted; review the current decision"); return transition(Status.SUPERSEDED, by, reason, true, hash, replacement); } + public Decision supersedeForPlan(String replacement, String plan, String requester, String hash) { + if (approvalStatus != Status.ACCEPTED) throw ProtocolException.invalid("The revised decision is no longer accepted; review the current decision"); + return transition(Status.SUPERSEDED, "system:planning", "Creation of " + plan + " by " + requester + " promotes replacement " + replacement, + false, hash, replacement, ApprovalOrigin.SYSTEM_PLAN, plan); + } private Decision transition(Status target, String by, String reason, boolean humanApproved, String hash, String replacement) { - var history = new ArrayList<>(approvals); history.add(new Approval(target, by, reason, Instant.now().toString(), humanApproved)); + return transition(target, by, reason, humanApproved, hash, replacement, null, null); + } + private Decision transition(Status target, String by, String reason, boolean humanApproved, String hash, String replacement, + ApprovalOrigin origin, String plan) { + var history = new ArrayList<>(approvals); history.add(new Approval(target, by, reason, Instant.now().toString(), humanApproved, origin, plan)); return snapshot(target, by, reason, hash, history, replacement); } private Decision snapshot(Status target, String by, String reason, String hash, List history, String replacement) { diff --git a/src/main/java/net/intrepid/aiengineering/decision/DecisionService.java b/src/main/java/net/intrepid/aiengineering/decision/DecisionService.java index 0cbb14d..ed7973c 100644 --- a/src/main/java/net/intrepid/aiengineering/decision/DecisionService.java +++ b/src/main/java/net/intrepid/aiengineering/decision/DecisionService.java @@ -77,6 +77,69 @@ public final class DecisionService { return accepted; }); } + private record PlanChange(Decision old, Decision changed, String original, String replacement, Path current, Path history, boolean historyExisted) {} + /** Prepared under the caller's project lock. No decisions change during validation. */ + public static final class PlanAcceptance { + private final List changes; + private final List attempted = new ArrayList<>(); + private PlanAcceptance(List changes) { this.changes = List.copyOf(changes); } + public void publish(Path folder) { + for (var change : changes) { + attempted.add(change); + Revisions.replace(folder, "decisions", change.old().id(), change.old().revision(), change.original(), change.replacement()); + } + } + public void rollback() { + for (var change : attempted.reversed()) { + String current = Filespace.read(change.current()); + if (!current.equals(change.original()) && !current.equals(change.replacement())) + throw ProtocolException.validation("Concurrent edit during Plan promotion recovery: " + change.current()); + if (!current.equals(change.original())) Filespace.write(change.current(), change.original(), true); + if (!change.historyExisted() && Files.exists(change.history())) { + if (!Filespace.read(change.history()).equals(change.original())) + throw ProtocolException.validation("Conflicting history during Plan promotion recovery: " + change.history()); + Filespace.io(() -> { Files.delete(change.history()); return null; }); + } + } + } + } + public PlanAcceptance preparePlanAcceptance(Path root, String workId, List refs, String plan, String requester) { + var work = works.editable(root, workId); Work.identifier(plan, "PLN"); + var selected = new LinkedHashMap(); + for (String id : refs) selected.put(id, get(root, workId, id)); + var proposed = new LinkedHashMap(); + var originals = new HashMap(); + for (var old : selected.values()) { + if (old.approvalStatus() == Decision.Status.ACCEPTED) continue; + if (old.approvalStatus() != Decision.Status.DRAFT) + throw ProtocolException.invalid("Plan creation requires a draft or accepted decision: " + old.id()); + evidence(work, old.evidence()); + String original = Filespace.read(path(root, workId, old.id())); originals.put(old.id(), original); + proposed.put(old.id(), old.acceptForPlan(plan, requester, Revisions.hash(original))); + if (old.revises() != null) { + var parent = get(root, workId, old.revises()); + if (parent.approvalStatus() != Decision.Status.ACCEPTED && parent.approvalStatus() != Decision.Status.REJECTED) + throw ProtocolException.invalid("The revised decision has already been superseded"); + if (parent.approvalStatus() == Decision.Status.ACCEPTED) { + if (proposed.containsKey(parent.id())) throw ProtocolException.invalid("Conflicting decision replacements in Plan: " + parent.id()); + String parentOriginal = Filespace.read(path(root, workId, parent.id())); originals.put(parent.id(), parentOriginal); + proposed.put(parent.id(), parent.supersedeForPlan(old.id(), plan, requester, Revisions.hash(parentOriginal))); + } + } + } + for (var old : selected.values()) + if (proposed.getOrDefault(old.id(), old).approvalStatus() != Decision.Status.ACCEPTED) + throw ProtocolException.invalid("Plan cannot reference a decision superseded by its own creation: " + old.id()); + var changes = new ArrayList(); Path folder = works.folder(root, workId); + for (var next : proposed.values()) { + var old = get(root, workId, next.id()); String original = originals.get(next.id()); + Path current = path(root, workId, old.id()), history = Revisions.history(folder, "decisions", old.id(), old.revision()); + boolean exists = Files.exists(history); + if (exists && !Filespace.read(history).equals(original)) throw ProtocolException.validation("Conflicting revision history: " + history); + changes.add(new PlanChange(old, next, original, Documents.markdownDocument(next, "text"), current, history, exists)); + } + return new PlanAcceptance(changes); + } public Decision reject(Path root, String workId, String id, String by, String reason) { return Filespace.locked(root, () -> { works.editable(root, workId); var old = get(root, workId, id); String original = Filespace.read(path(root, workId, id)); diff --git a/src/main/java/net/intrepid/aiengineering/planning/PlanService.java b/src/main/java/net/intrepid/aiengineering/planning/PlanService.java index 3049f14..cde2cf0 100644 --- a/src/main/java/net/intrepid/aiengineering/planning/PlanService.java +++ b/src/main/java/net/intrepid/aiengineering/planning/PlanService.java @@ -44,10 +44,31 @@ public final class PlanService { } public Plan create(Path root, String workId, String title, String description, List refs, String author) { return Filespace.locked(root, () -> { - var work = works.editable(root, workId); accepted(root, workId, refs); String id = works.nextReference(work.plans(), "PLN"), now = Instant.now().toString(); + var work = works.editable(root, workId); String id = works.nextReference(work.plans(), "PLN"), now = Instant.now().toString(); var plan = new Plan(1, id, workId, title, description, refs, List.of(), Plan.Status.OPEN, author, now, 1, null, now, author, "Plan created"); - Path path = path(root, workId, id); Filespace.directory(path.getParent()); Documents.writeMarkdownDocument(path, plan, "description", false); - works.addReference(root, workId, "plans", id); return plan; + Path path = path(root, workId, id), folder = works.folder(root, workId), workPath = Filespace.resolve(folder, "work.md"); + if (Files.exists(path)) throw ProtocolException.invalid("Already exists: " + path); + String originalWork = Filespace.read(workPath), document = Documents.markdownDocument(plan, "description"); + var promotions = decisions.preparePlanAcceptance(root, workId, refs, id, author); + Filespace.directory(path.getParent()); + try { + promotions.publish(folder); + Filespace.write(path, document, false); + works.addReference(root, workId, "plans", id); return plan; + } catch (RuntimeException failure) { + try { + if (Files.exists(path)) { + if (!Filespace.read(path).equals(document)) throw ProtocolException.validation("Concurrent edit during Plan recovery: " + path); + Filespace.io(() -> { Files.delete(path); return null; }); + } + promotions.rollback(); + if (!Filespace.read(workPath).equals(originalWork)) Filespace.write(workPath, originalWork, true); + } catch (RuntimeException recovery) { + failure.addSuppressed(recovery); + throw new ProtocolException(4, "Plan creation interrupted; inspect " + workId + ": " + failure.getMessage() + "; recovery: " + recovery.getMessage()); + } + throw failure; + } }); } private Plan mutate(Path root, String work, String id, String by, String reason, Function mutation) { diff --git a/src/main/java/net/intrepid/aiengineering/verification/VerificationService.java b/src/main/java/net/intrepid/aiengineering/verification/VerificationService.java index 7dfb0f5..7ce83c6 100644 --- a/src/main/java/net/intrepid/aiengineering/verification/VerificationService.java +++ b/src/main/java/net/intrepid/aiengineering/verification/VerificationService.java @@ -66,6 +66,12 @@ public final class VerificationService { var byId = new HashMap(); all.forEach(d -> byId.put(d.id(), d)); for (var d : all) { if (!work.artifacts().containsAll(d.evidence())) issues.add("Missing decision evidence: " + d.id()); + for (var approval : d.approvals()) if (approval.origin() == Decision.ApprovalOrigin.SYSTEM_PLAN) { + String target = approval.status() == Decision.Status.SUPERSEDED ? d.supersededBy() : d.id(); + if (!work.plans().contains(approval.planId())) issues.add("Missing promoting Plan for " + d.id() + ": " + approval.planId()); + else if (!plans.history(root, id, approval.planId()).getFirst().decisions().contains(target)) + issues.add("Promoting Plan does not reference its decision: " + d.id() + "/" + approval.planId()); + } if (d.revises() != null) { var parent = byId.get(d.revises()); if (parent == null) issues.add("Missing revised decision: " + d.revises()); @@ -295,7 +301,7 @@ public final class VerificationService { for (var survey : new SurveyService().list(root, id)) if (survey.questions().isEmpty()) actions.add(new Action("ADD_QUESTION", id, "Add questions with suggestions to " + survey.id(), "aie survey question " + id + " " + survey.id() + " --help")); for (var decision : decisions.list(root, id)) if (decision.approvalStatus() == Decision.Status.DRAFT) - actions.add(new Action("REVIEW_DECISION", id, "Discuss and obtain human approval for " + decision.id(), "aie decision show " + id + " " + decision.id())); + actions.add(new Action("REVIEW_DECISION", id, "Review " + decision.id() + "; accept explicitly or create a Plan from it", "aie decision show " + id + " " + decision.id())); for (var plan : plans.list(root, id)) { if (plan.status() == Plan.Status.COMPLETED || plan.status() == Plan.Status.CANCELLED) continue; if (plan.steps().isEmpty()) actions.add(new Action("ADD_STEP", id, "Add explicit steps to " + plan.id(), "aie plan step add " + id + " " + plan.id() + " --help")); diff --git a/src/main/resources/protocol/README.md b/src/main/resources/protocol/README.md index 501e4d1..a5b66fc 100644 --- a/src/main/resources/protocol/README.md +++ b/src/main/resources/protocol/README.md @@ -183,6 +183,13 @@ in history. Use `decision revise` for a new draft based on a prior accepted/reje decision; acceptance supersedes the prior accepted decision while retaining history. Accepted decisions cannot be silently edited. Use `--by` and `--reason` on changes. +Creating a Plan from a DRAFT decision promotes it automatically. This deterministic +framework action needs no LLM or preceding `decision accept` command. It records +`origin: SYSTEM_PLAN`, the causal `planId`, actor `system:planning` and +`humanApproved: false`, preserving history and any supersession. It is distinct +from the explicit human-attestation route above. Drafts still need nonblank context, +approach and rationale; rejected/superseded decisions remain invalid Plan inputs. + ## Planning and adaptive execution Use `plan create WRK --title TEXT [--decision DEC]`, then `plan step add` for a @@ -191,6 +198,14 @@ records OPEN, ACTIVE, BLOCKED, COMPLETED or CANCELLED. Dependencies must be comp before starting dependent steps. Completed steps require a result (`--reason`) and owned `--evidence ART`. Plan decisions must be accepted for execution. +`plan create --decision DEC` promotes its referenced drafts before returning the +new Plan. Already accepted decisions are unchanged. Inputs are validated together +under the project lock; ordinary publication failures roll back promotions. +Crash-interrupted publication may still need deliberate repair; use `work validate` +to inspect causal Plan links and revision history. `plan update` does not promote +drafts. Historical human approvals remain readable and are never rewritten into +system approvals. New system-promotion records require a CLI with this capability. + The CLI records work and can apply validated fixture proposals; it does not execute repository commands. Observe results, reconsider hypotheses and replan explicitly when evidence changes. OODA is adaptive, not a mandatory four-stage pipeline. No autonomous repository executor, orchestrator, diff --git a/src/main/resources/protocol/protocol.json b/src/main/resources/protocol/protocol.json index bf188e1..b704f6a 100644 --- a/src/main/resources/protocol/protocol.json +++ b/src/main/resources/protocol/protocol.json @@ -9,7 +9,7 @@ "command": "ai-engineering", "aliases": ["aie"], "startup": ["status --format json", "next-actions --format json", "work context --format markdown"], - "capabilities": ["protocol-compatibility", "work", "discussion", "topics", "surveys", "answer-history", "proposal-dispositions", "fixture-adapters", "local-cli-adapters", "guided-agent-setup", "agent-doctor", "agent-routing", "run-provenance", "epic", "epic-policy-authorization", "epic-propagation", "epic-reconciliation", "decision-approval", "decision-history", "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", "planning", "step-dependencies", "evidence", "completion", "plan-consolidation", "cancelled-scope-review", "work-reconciliation", "archive", "reopen"], "humanApproval": "explicit-attestation", "execution": "external-human-or-agent", "legacyImport": false diff --git a/src/test/java/net/intrepid/aiengineering/PlanDecisionPromotionTest.java b/src/test/java/net/intrepid/aiengineering/PlanDecisionPromotionTest.java new file mode 100644 index 0000000..f53aadd --- /dev/null +++ b/src/test/java/net/intrepid/aiengineering/PlanDecisionPromotionTest.java @@ -0,0 +1,175 @@ +package net.intrepid.aiengineering; + +import net.intrepid.aiengineering.cli.EngineeringCli; +import net.intrepid.aiengineering.decision.*; +import net.intrepid.aiengineering.filesystem.*; +import net.intrepid.aiengineering.planning.PlanService; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; +import java.io.*; +import java.nio.file.*; +import java.util.*; +import static org.assertj.core.api.Assertions.*; + +class PlanDecisionPromotionTest { + @TempDir Path root; + private String output; + private int cli(String... args) { + var out = new StringWriter(); var err = new StringWriter(); + int code = new EngineeringCli(root).execute(new PrintWriter(out), new PrintWriter(err), args); + output = out + err.toString(); return code; + } + private void ok(String... args) { assertThat(cli(args)).as(output).isZero(); } + private void init() { ok("init", "--name", "Promotion"); ok("work", "create", "One"); } + private void draft(String title) { + ok("decision", "draft", "WRK-0001", "--title", title, "--context", "Problem", "--approach", "Approach", "--rationale", "Reason"); + } + private void accept(String id) { + ok("decision", "accept", "WRK-0001", id, "--by", "owner", "--reason", "Explicit approval", "--human-approved"); + } + private Decision decision(String id) { return new DecisionService().get(root, "WRK-0001", id); } + private Path folder() { return root.resolve(".ai-engineering/works/WRK-0001-one"); } + private Map snapshot() throws IOException { + var result = new TreeMap(); + try (var files = Files.walk(folder())) { + for (var path : files.filter(Files::isRegularFile).toList()) result.put(folder().relativize(path).toString(), Files.readString(path)); + } + return result; + } + @Test void creationPromotesDraftWithoutHumanAttestationOrConfiguredModelAndRetainsHistory() { + init(); draft("Chosen approach"); + ok("plan", "create", "WRK-0001", "--title", "Delivery", "--decision", "DEC-0001", "--author", "requester"); + var promoted = decision("DEC-0001"); var approval = promoted.approvals().getLast(); + assertThat(promoted.approvalStatus()).isEqualTo(Decision.Status.ACCEPTED); + assertThat(promoted.revision()).isEqualTo(2); + assertThat(approval.origin()).isEqualTo(Decision.ApprovalOrigin.SYSTEM_PLAN); + assertThat(approval.planId()).isEqualTo("PLN-0001"); + assertThat(approval.by()).isEqualTo("system:planning"); + assertThat(approval.reason()).contains("requester"); + assertThat(approval.humanApproved()).isFalse(); + assertThat(new DecisionService().history(root, "WRK-0001", "DEC-0001")).extracting(Decision::approvalStatus) + .containsExactly(Decision.Status.DRAFT, Decision.Status.ACCEPTED); + ok("work", "context", "WRK-0001", "--format", "json"); + assertThat(output).contains("SYSTEM_PLAN", "PLN-0001", "system:planning", "\"humanApproved\" : false"); + ok("project", "validate"); ok("project", "compatibility"); + // Another Plan from the same decision does not duplicate its promotion. + ok("plan", "create", "WRK-0001", "--title", "More delivery", "--decision", "DEC-0001"); + assertThat(decision("DEC-0001")).isEqualTo(promoted); + } + @Test void multipleDraftsPromoteTogetherAndAlreadyAcceptedDecisionsStayByteIdentical() throws Exception { + init(); draft("One"); accept("DEC-0001"); draft("Two"); draft("Three"); + String accepted = Files.readString(folder().resolve("decisions/DEC-0001.md")); + ok("plan", "create", "WRK-0001", "--title", "Delivery", "--decision", "DEC-0001", "--decision", "DEC-0002", "--decision", "DEC-0003"); + assertThat(Files.readString(folder().resolve("decisions/DEC-0001.md"))).isEqualTo(accepted); + for (String id : List.of("DEC-0002", "DEC-0003")) assertThat(decision(id).approvals().getLast().planId()).isEqualTo("PLN-0001"); + ok("project", "validate"); + } + @Test void invalidReferencesOrInputsNeverPromoteEarlierDrafts() throws Exception { + init(); draft("Eligible"); draft("Rejected"); + ok("decision", "reject", "WRK-0001", "DEC-0002", "--by", "reviewer", "--reason", "Rejected"); + var before = snapshot(); + for (String id : List.of("DEC-9999", "DEC-0002")) { + assertThat(cli("plan", "create", "WRK-0001", "--title", "Delivery", "--decision", "DEC-0001", "--decision", id)).isNotZero(); + assertThat(snapshot()).isEqualTo(before); + } + assertThat(cli("plan", "create", "WRK-0001", "--title", " ", "--decision", "DEC-0001")).isNotZero(); + assertThat(snapshot()).isEqualTo(before); + assertThat(cli("plan", "create", "WRK-0001", "--title", "Delivery", "--author", " ", "--decision", "DEC-0001")).isNotZero(); + assertThat(snapshot()).isEqualTo(before); + } + @Test void incompleteDraftAndConflictingHistoryLeaveNoPromotion() throws Exception { + init(); draft("Eligible"); ok("decision", "draft", "WRK-0001", "--title", "Incomplete"); + var before = snapshot(); + assertThat(cli("plan", "create", "WRK-0001", "--title", "Delivery", "--decision", "DEC-0001", "--decision", "DEC-0002")).isEqualTo(4); + assertThat(output).contains("context, approach and rationale"); assertThat(snapshot()).isEqualTo(before); + Path history = folder().resolve("decisions/.history/DEC-0001/r0001.md"); + Files.createDirectories(history.getParent()); Files.writeString(history, "Conflicting history"); before = snapshot(); + assertThat(cli("plan", "create", "WRK-0001", "--title", "Delivery", "--decision", "DEC-0001")).isEqualTo(4); + assertThat(output).contains("Conflicting revision history"); assertThat(snapshot()).isEqualTo(before); + } + @Test void ordinaryPublicationFailureRollsBackEarlierPromotions() throws Exception { + init(); draft("One"); draft("Two"); + // Force the second revision publication to fail after the first draft was promoted. + Path blocked = folder().resolve("decisions/.history/DEC-0002"); + Files.createDirectories(blocked.getParent()); Files.writeString(blocked, "Directory occupied by a file"); + var before = snapshot(); + assertThat(cli("plan", "create", "WRK-0001", "--title", "Delivery", "--decision", "DEC-0001", "--decision", "DEC-0002")).isNotZero(); + assertThat(snapshot()).isEqualTo(before); + assertThat(decision("DEC-0001").approvalStatus()).isEqualTo(Decision.Status.DRAFT); + assertThat(new PlanService().list(root, "WRK-0001")).isEmpty(); + } + @Test void revisedDraftSupersedesParentWithTheSamePlanProvenance() { + init(); draft("Original"); accept("DEC-0001"); + ok("decision", "revise", "WRK-0001", "DEC-0001", "--by", "editor", "--reason", "New information"); + ok("plan", "create", "WRK-0001", "--title", "Revised delivery", "--decision", "DEC-0002"); + assertThat(decision("DEC-0001").approvalStatus()).isEqualTo(Decision.Status.SUPERSEDED); + assertThat(decision("DEC-0001").supersededBy()).isEqualTo("DEC-0002"); + assertThat(decision("DEC-0001").approvals().getLast().origin()).isEqualTo(Decision.ApprovalOrigin.SYSTEM_PLAN); + assertThat(decision("DEC-0001").approvals().getLast().humanApproved()).isFalse(); + assertThat(decision("DEC-0002").approvalStatus()).isEqualTo(Decision.Status.ACCEPTED); + ok("project", "validate"); + // The causal link remains valid after the Plan's current references are changed. + ok("plan", "update", "WRK-0001", "PLN-0001", "--clear-decisions", "--by", "owner", "--reason", "Scope changed"); + ok("project", "validate"); + } + @Test void conflictingRevisionsAndSupersededReferencesAreRejectedWithoutChanges() throws Exception { + init(); draft("Original"); accept("DEC-0001"); + ok("decision", "revise", "WRK-0001", "DEC-0001", "--by", "editor", "--reason", "Alternative one"); + ok("decision", "revise", "WRK-0001", "DEC-0001", "--by", "editor", "--reason", "Alternative two"); + var before = snapshot(); + assertThat(cli("plan", "create", "WRK-0001", "--title", "Conflict", "--decision", "DEC-0002", "--decision", "DEC-0003")).isEqualTo(2); + assertThat(snapshot()).isEqualTo(before); + assertThat(cli("plan", "create", "WRK-0001", "--title", "Conflict", "--decision", "DEC-0001", "--decision", "DEC-0002")).isEqualTo(2); + assertThat(snapshot()).isEqualTo(before); + ok("plan", "create", "WRK-0001", "--title", "Chosen", "--decision", "DEC-0002"); before = snapshot(); + assertThat(cli("plan", "create", "WRK-0001", "--title", "Stale", "--decision", "DEC-0001")).isEqualTo(2); + assertThat(snapshot()).isEqualTo(before); + assertThat(cli("plan", "create", "WRK-0001", "--title", "Stale revision", "--decision", "DEC-0003")).isEqualTo(2); + assertThat(snapshot()).isEqualTo(before); + } + @Test void directAcceptanceStillNeedsHumanApprovalAndBrokenPromotionLinksAreDiagnosed() throws Exception { + init(); draft("Chosen"); + assertThat(cli("decision", "accept", "WRK-0001", "DEC-0001", "--by", "agent", "--reason", "Not attested")).isEqualTo(2); + ok("plan", "create", "WRK-0001", "--title", "Delivery", "--decision", "DEC-0001"); + ok("plan", "create", "WRK-0001", "--title", "Unrelated"); + ok("plan", "update", "WRK-0001", "PLN-0002", "--decision", "DEC-0001", "--by", "owner", "--reason", "Later reference is not creation provenance"); + Path promoted = folder().resolve("decisions/DEC-0001.md"); String original = Files.readString(promoted); + assertThat(original).contains("planId: \"PLN-0001\""); + Files.writeString(promoted, original.replace("planId: \"PLN-0001\"", "planId: \"PLN-0002\"")); + assertThat(cli("work", "validate", "WRK-0001")).isEqualTo(4); + assertThat(output).contains("Promoting Plan does not reference"); Files.writeString(promoted, original); + Path plan = folder().resolve("plans/PLN-0001.md"); Files.delete(plan); + assertThat(cli("work", "validate", "WRK-0001")).isEqualTo(4); + assertThat(output).contains("PLN-0001"); + assertThatThrownBy(() -> new Decision.Approval(Decision.Status.ACCEPTED, "agent", "Forged", java.time.Instant.now().toString(), false)) + .isInstanceOf(ProtocolException.class).hasMessageContaining("human approval"); + assertThatThrownBy(() -> new Decision.Approval(Decision.Status.ACCEPTED, "system:planning", "Forged", java.time.Instant.now().toString(), true, + Decision.ApprovalOrigin.SYSTEM_PLAN, "PLN-0001")).isInstanceOf(ProtocolException.class).hasMessageContaining("provenance"); + } + @Test void occupiedPlanOutputDoesNotPromoteItsDecision() throws Exception { + init(); draft("Chosen"); + Path occupied = folder().resolve("plans/PLN-0001.md"); Files.writeString(occupied, "Existing unindexed Plan"); + var before = snapshot(); + assertThat(cli("plan", "create", "WRK-0001", "--title", "Delivery", "--decision", "DEC-0001")).isEqualTo(4); + assertThat(output).contains("Unreferenced protocol file", "PLN-0001"); assertThat(snapshot()).isEqualTo(before); + } + @Test void separateCliProcessesCreatePlansButPromoteSharedDraftOnlyOnce() throws Exception { + init(); draft("Shared"); + var command = List.of(Path.of(System.getProperty("java.home"), "bin", "java").toString(), "-jar", System.getProperty("cli.jar"), + "--project", root.toString(), "plan", "create", "WRK-0001", "--title", "Concurrent delivery", "--decision", "DEC-0001"); + var first = new ProcessBuilder(command).redirectErrorStream(true).start(); + var second = new ProcessBuilder(command).redirectErrorStream(true).start(); + try { + for (var process : List.of(first, second)) { + assertThat(process.waitFor(30, java.util.concurrent.TimeUnit.SECONDS)).isTrue(); + assertThat(process.exitValue()).as(new String(process.getInputStream().readAllBytes(), java.nio.charset.StandardCharsets.UTF_8)).isZero(); + } + } finally { first.destroyForcibly(); second.destroyForcibly(); } + var plans = new PlanService().list(root, "WRK-0001"); + assertThat(plans).extracting(net.intrepid.aiengineering.planning.Plan::id).containsExactly("PLN-0001", "PLN-0002"); + var promoted = decision("DEC-0001"); assertThat(promoted.revision()).isEqualTo(2); + assertThat(promoted.approvals()).hasSize(1); + assertThat(promoted.approvals().getFirst().planId()).isEqualTo("PLN-0001"); + ok("project", "validate"); + } +}