@open-agent-toolkit/cli 0.1.69 → 0.1.73
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/assets/docs/cli-utilities/configuration.md +34 -0
- package/assets/docs/cli-utilities/index.md +2 -1
- package/assets/docs/cli-utilities/project-log.md +183 -0
- package/assets/docs/cli-utilities/workflow-gates.md +126 -3
- package/assets/docs/reference/cli-reference.md +6 -1
- package/assets/docs/workflows/projects/dispatch-ceiling.md +14 -5
- package/assets/docs/workflows/projects/orchestration-model.md +21 -0
- package/assets/docs/workflows/projects/review-flavors.md +9 -0
- package/assets/public-package-versions.json +4 -4
- package/assets/skills/oat-dispatch-subagents/SKILL.md +21 -1
- package/assets/skills/oat-dispatch-subagents/references/provider-claude.md +21 -0
- package/assets/skills/oat-dispatch-subagents/references/provider-codex.md +16 -0
- package/assets/skills/oat-dispatch-subagents/references/provider-cursor.md +21 -0
- package/assets/skills/oat-project-autonomous/references/gate-inventory.md +6 -2
- package/assets/skills/oat-project-complete/SKILL.md +60 -1
- package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +6 -2
- package/assets/skills/oat-project-implement/SKILL.md +18 -2
- package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +6 -2
- package/assets/skills/oat-project-plan-writing/SKILL.md +23 -33
- package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +6 -2
- package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +6 -2
- package/assets/skills/oat-project-review-provide/SKILL.md +62 -1
- package/assets/skills/oat-project-summary/SKILL.md +122 -18
- package/assets/templates/project-log.md +47 -0
- package/dist/commands/config/index.d.ts.map +1 -1
- package/dist/commands/config/index.js +106 -1
- package/dist/commands/gate/__fixtures__/fake-runtime.d.mts +3 -0
- package/dist/commands/gate/__fixtures__/fake-runtime.d.mts.map +1 -0
- package/dist/commands/gate/__fixtures__/fake-runtime.mjs +167 -0
- package/dist/commands/gate/activity-probes.d.ts +35 -0
- package/dist/commands/gate/activity-probes.d.ts.map +1 -0
- package/dist/commands/gate/activity-probes.js +135 -0
- package/dist/commands/gate/branch-local-cli.d.ts +31 -0
- package/dist/commands/gate/branch-local-cli.d.ts.map +1 -0
- package/dist/commands/gate/branch-local-cli.js +116 -0
- package/dist/commands/gate/index.d.ts +31 -0
- package/dist/commands/gate/index.d.ts.map +1 -1
- package/dist/commands/gate/index.js +533 -32
- package/dist/commands/gate/route.d.ts +22 -0
- package/dist/commands/gate/route.d.ts.map +1 -0
- package/dist/commands/gate/route.js +109 -0
- package/dist/commands/init/tools/shared/skill-manifest.d.ts +1 -1
- package/dist/commands/init/tools/shared/skill-manifest.d.ts.map +1 -1
- package/dist/commands/init/tools/shared/skill-manifest.js +1 -0
- package/dist/commands/project/dispatch-ceiling/index.d.ts.map +1 -1
- package/dist/commands/project/dispatch-ceiling/index.js +100 -16
- package/dist/commands/project/index.d.ts.map +1 -1
- package/dist/commands/project/index.js +2 -0
- package/dist/commands/project/log/append.d.ts +41 -0
- package/dist/commands/project/log/append.d.ts.map +1 -0
- package/dist/commands/project/log/append.js +241 -0
- package/dist/commands/project/log/check.d.ts +66 -0
- package/dist/commands/project/log/check.d.ts.map +1 -0
- package/dist/commands/project/log/check.js +194 -0
- package/dist/commands/project/log/grammar.d.ts +28 -0
- package/dist/commands/project/log/grammar.d.ts.map +1 -0
- package/dist/commands/project/log/grammar.js +31 -0
- package/dist/commands/project/log/index.d.ts +9 -0
- package/dist/commands/project/log/index.d.ts.map +1 -0
- package/dist/commands/project/log/index.js +13 -0
- package/dist/commands/project/log/rollup.d.ts +40 -0
- package/dist/commands/project/log/rollup.d.ts.map +1 -0
- package/dist/commands/project/log/rollup.js +203 -0
- package/dist/commands/project/log/synthesize.d.ts +23 -0
- package/dist/commands/project/log/synthesize.d.ts.map +1 -0
- package/dist/commands/project/log/synthesize.js +112 -0
- package/dist/commands/project/new/index.d.ts +1 -0
- package/dist/commands/project/new/index.d.ts.map +1 -1
- package/dist/commands/project/new/index.js +7 -0
- package/dist/commands/project/new/scaffold.d.ts +1 -0
- package/dist/commands/project/new/scaffold.d.ts.map +1 -1
- package/dist/commands/project/new/scaffold.js +24 -0
- package/dist/config/oat-config.d.ts +12 -0
- package/dist/config/oat-config.d.ts.map +1 -1
- package/dist/config/oat-config.js +30 -0
- package/dist/config/resolve.d.ts.map +1 -1
- package/dist/config/resolve.js +9 -0
- package/package.json +2 -2
|
@@ -225,7 +225,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
|
|
|
225
225
|
| `oat-project-design/references/selective-review-pass.md` | `d4956192b82e -> DES-06`; `7d6e1f926ecb -> DES-06`; `04f918a5fcac -> DES-07` |
|
|
226
226
|
| `oat-project-plan/SKILL.md` | `5eb3949f32e1 -> NG`; `64a08153bb9e -> NG`; `655d61df0a8f -> NG`; `56b37486f09d -> PLAN-01`; `cf317c17c586 -> PLAN-02`; `781643b0f2c3 -> NG`; `01fd7cca8253 -> PLAN-04`; `7bc7fa3f2cbb -> NG`; `da28ce0a5f2e -> NG`; `e334f94c4d35 -> NG`; `1fa55762c038 -> NG`; `c0935b5484a2 -> NG`; `6008163054f8 -> PLAN-05`; `571271f4d71b -> PLAN-06`; `746b760289e4 -> PLAN-06`; `de195590ff83 -> NG`; `49640510829a -> PLAN-07`; `4bef7afa7a71 -> PLAN-08`; `e5886632533e -> PLAN-08`; `4cfe1df14372 -> NG`; `d116c97a500c -> PLAN-10`; `aa62facff547 -> PLAN-10`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> PLAN-11`; `1734b2c85c5d -> NG`; `b4af2220eb91 -> PLAN-11` |
|
|
227
227
|
| `oat-project-import-plan/SKILL.md` | `f7ca8635452f -> NG`; `c2e5fa410069 -> NG`; `655d61df0a8f -> NG`; `b137f73db20c -> IMPORT-01`; `45b699c1c0b5 -> IMPORT-01`; `ba6d120791c1 -> IMPORT-01`; `070ebc5259af -> IMPORT-03`; `c11552696e2e -> IMPORT-03`; `cfe661966baf -> IMPORT-04`; `baa91c0a0bf8 -> NG`; `e364e84b2702 -> NG`; `39031985a945 -> IMPORT-06`; `f106aa29a217 -> IMPORT-07`; `65038450aee3 -> IMPORT-07`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPORT-09` |
|
|
228
|
-
| `oat-project-implement/SKILL.md` | `
|
|
228
|
+
| `oat-project-implement/SKILL.md` | `853d44621b72 -> NG`; `ffb3af0ba8ef -> NG`; `e0355c7a05e9 -> IMPLEMENT-11+IMPLEMENT-13+IMPLEMENT-16`; `6296f41ae11c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> IMPLEMENT-01`; `8ce8a09feca4 -> NG` |
|
|
229
229
|
| `oat-project-implement/references/completion-and-closeout.md` | `105600fbd045 -> IMPLEMENT-11`; `3e6055aede6c -> IMPLEMENT-11`; `0705f7533039 -> IMPLEMENT-11`; `0c39746f3cb5 -> IMPLEMENT-11`; `14d89fe39c8c -> IMPLEMENT-11`; `378a75543a72 -> IMPLEMENT-11`; `c7b25627e674 -> IMPLEMENT-11`; `51ef9a453323 -> IMPLEMENT-11`; `c67145e3fb00 -> IMPLEMENT-11`; `64fbeac64811 -> IMPLEMENT-11`; `19b13c17bddb -> NG`; `f7dab9c1f96c -> IMPLEMENT-12`; `c69c17a069a8 -> IMPLEMENT-14`; `a97fa5634a68 -> IMPLEMENT-14`; `3af58881811c -> IMPLEMENT-14`; `4203e1f49d0f -> IMPLEMENT-14`; `c3bd2458a3d3 -> IMPLEMENT-13`; `95b5eafc070d -> IMPLEMENT-13`; `25ecbe9c998b -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f6f24fd71da4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f18283bc1cf9 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `2c1ffc4a82dd -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `3454a07aa843 -> IMPLEMENT-16`; `0d86e2098cfb -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d5fe597d266f -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `55a152e944c1 -> IMPLEMENT-16`; `effac7cbd573 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d2a34d8b148 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d27462aaed26 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d52ecb17268 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `5b91aabe3757 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `fd0ad919f702 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `63bf28df1474 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a4ed471dbc78 -> IMPLEMENT-16`; `6b7a64cec6e5 -> IMPLEMENT-16`; `0a4fdba0ebc0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a5033c2aada5 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `e77609eddba0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `351156e8dde4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `51d45bd2bbd1 -> IMPLEMENT-16`; `f7796ffcc804 -> IMPLEMENT-16`; `990d730cb494 -> IMPLEMENT-16`; `6ed28bb7d384 -> IMPLEMENT-16`; `8b7d4b5bcf1b -> IMPLEMENT-16`; `88aad500e6e9 -> IMPLEMENT-16`; `877e3e3f9eda -> IMPLEMENT-16`; `fc03c97f834e -> IMPLEMENT-16`; `12939a3da5e0 -> IMPLEMENT-16`; `bdb418335a88 -> IMPLEMENT-16`; `fba97e596ebd -> IMPLEMENT-16`; `3d0b5e2f14f0 -> IMPLEMENT-17`; `f56a9ce88461 -> IMPLEMENT-17`; `9ba67b50d0ba -> IMPLEMENT-17`; `39ff911760af -> IMPLEMENT-17`; `5b560b5bd6e3 -> IMPLEMENT-17`; `fa21df5e5e01 -> IMPLEMENT-17`; `0fed77bec55e -> IMPLEMENT-17`; `6d81cfb0483f -> IMPLEMENT-17`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPLEMENT-18` |
|
|
230
230
|
| `oat-project-implement/references/dispatch-and-dry-run.md` | `21b85f5e4daa -> IMPLEMENT-08`; `74c92b32bb2a -> IMPLEMENT-08`; `8efd2d0517ab -> IMPLEMENT-09`; `461ed9b3e495 -> IMPLEMENT-09`; `b5ad64fd744d -> NG`; `14ce436cfffa -> NG`; `043ca36da3e2 -> NG`; `a23e45c1dc8d -> NG`; `498143bb41a7 -> NG`; `4fe3eb179023 -> NG`; `7f75485e5a33 -> NG`; `8ec3a96df029 -> NG`; `16c3f96e758d -> NG`; `5915c41fe058 -> NG`; `f51e43eeac56 -> NG`; `fd41c25623cb -> NG`; `58a932ed6453 -> NG`; `4718bd3ce12d -> NG`; `58c444a2126b -> NG`; `2df3adae4120 -> NG`; `e75df892b55c -> NG` |
|
|
231
231
|
| `oat-project-implement/references/docs/autonomy-contract.md` | `* -> NG` |
|
|
@@ -233,18 +233,22 @@ remains immutable baseline evidence for the original p01-t01 verification.
|
|
|
233
233
|
| `oat-project-implement/references/plan-and-resume.md` | `413829d31e32 -> IMPLEMENT-02`; `c7706cd8ad09 -> IMPLEMENT-03`; `a80a948df658 -> IMPLEMENT-03`; `b7ea139780ec -> IMPLEMENT-03+IMPLEMENT-04`; `8d438f2180ba -> IMPLEMENT-03`; `9e72e0518cda -> IMPLEMENT-03`; `3e177a1021e6 -> IMPLEMENT-03+IMPLEMENT-04`; `b59fc9eb9ce3 -> IMPLEMENT-03`; `a2b1d6855283 -> IMPLEMENT-03`; `44351a32e52a -> IMPLEMENT-03`; `b98b022f5523 -> IMPLEMENT-03`; `e9f5b949e214 -> IMPLEMENT-03`; `316fb6d9e980 -> IMPLEMENT-03`; `8b25a2c5c548 -> IMPLEMENT-03`; `1a59b1c0e705 -> IMPLEMENT-03`; `466cd562fc52 -> IMPLEMENT-03`; `083d896978d5 -> IMPLEMENT-03`; `f4ab11c13ae9 -> IMPLEMENT-03`; `7dc17ffcc1c4 -> IMPLEMENT-03`; `f731a90adabd -> IMPLEMENT-04`; `886ac01e7aa9 -> IMPLEMENT-04`; `b715db67df0c -> IMPLEMENT-04`; `2d9f26a539f3 -> IMPLEMENT-10`; `28384dee114f -> IMPLEMENT-05`; `f2591a4978b4 -> NG`; `8290823080b5 -> IMPLEMENT-06`; `f75789bf6c8e -> IMPLEMENT-07` |
|
|
234
234
|
| `oat-project-document/SKILL.md` | `4fc2d8618208 -> NG`; `173a1c48e53c -> NG`; `40f8be47affa -> NG`; `3a3c390528f3 -> DOCUMENT-03`; `2a7ba093b315 -> DOCUMENT-02`; `252aabe44db2 -> DOCUMENT-02`; `3751172de299 -> DOCUMENT-02`; `b987a0697ba9 -> DOCUMENT-01`; `a06ff3ca7926 -> NG`; `0d04714ca9fc -> NG`; `f79af01d94c6 -> DOCUMENT-02`; `71634113c348 -> DOCUMENT-02`; `cdb707f5081e -> NG` |
|
|
235
235
|
| `oat-project-document/references/docs/autonomy-contract.md` | `* -> NG` |
|
|
236
|
-
| `oat-project-summary/SKILL.md` | `68c197c44c18 -> NG`; `
|
|
236
|
+
| `oat-project-summary/SKILL.md` | `68c197c44c18 -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> SUMMARY-01`; `696bb6045b6a -> NG`; `bcb503aaefb5 -> NG`; `f3e49b727752 -> NG`; `f583e86359ae -> NG`; `e73bd88837ea -> NG`; `83257ff6cb68 -> NG`; `c8fced47ef8e -> NG`; `d7ea1e2a4f5f -> NG` |
|
|
237
237
|
| `oat-project-pr-final/SKILL.md` | `601ac2b890f2 -> NG`; `5eb3949f32e1 -> NG`; `9efcbcee42ea -> NG`; `655d61df0a8f -> NG`; `cf317c17c586 -> PRFINAL-01`; `2de348a391c0 -> PRFINAL-03` |
|
|
238
238
|
| `oat-project-pr-final/references/docs/autonomy-contract.md` | `* -> NG` |
|
|
239
239
|
| `oat-project-complete/SKILL.md` | `6ed459f9e462 -> NG`; `a167d03559fa -> NG`; `79c2eeed668c -> COMPLETE-01`; `2c1514b9d9af -> COMPLETE-01`; `31c750b4fea7 -> COMPLETE-01`; `cfba413b1293 -> COMPLETE-01`; `ffcdc9d576c0 -> COMPLETE-01`; `7fcfce0423ac -> COMPLETE-01`; `9497d9f94eed -> COMPLETE-01`; `7b59c728d3fb -> COMPLETE-01`; `48e10a9636fe -> COMPLETE-01`; `c0dad37fc166 -> COMPLETE-01`; `aa9a36243ec1 -> COMPLETE-01`; `7bcbf58b54e9 -> NG`; `4c7f88a7f942 -> COMPLETE-02`; `6a1a95acc8cc -> COMPLETE-02`; `3b559956b3eb -> COMPLETE-03`; `14d161cdf99b -> COMPLETE-03`; `12f7c30a54c8 -> NG`; `fffe5eea5ebd -> NG` |
|
|
240
240
|
| `oat-project-review-provide/SKILL.md` | `1f4b981cac8b -> NG`; `adaeca152bb2 -> NG`; `2f7c201c3c06 -> NG`; `88f79700afdc -> NG`; `655d61df0a8f -> NG`; `efafde9ef5a0 -> NG`; `d2a3861d6323 -> REVIEWPROVIDE-02`; `65f5b9cf49cd -> REVIEWPROVIDE-04`; `962cb38d246a -> REVIEWPROVIDE-04`; `1a568483ba0b -> REVIEWPROVIDE-04`; `610e27edfe85 -> REVIEWPROVIDE-04`; `fab62c510bd0 -> REVIEWPROVIDE-05`; `a9f30853c867 -> REVIEWPROVIDE-05`; `0929c916fc20 -> REVIEWPROVIDE-05`; `f9a37c63afab -> REVIEWPROVIDE-05`; `687bb9368f92 -> REVIEWPROVIDE-05`; `bb0096e95c47 -> REVIEWPROVIDE-06`; `55f6357a987d -> REVIEWPROVIDE-06`; `1bee61f8531c -> REVIEWPROVIDE-07`; `3d35091607a1 -> REVIEWPROVIDE-08`; `fb40c4341c4c -> NG`; `b22d16885150 -> NG`; `d2b25906242e -> REVIEWPROVIDE-08`; `fd8ebf72b3c4 -> NG`; `fcb9de611ff3 -> NG`; `d2a838dfb18d -> NG`; `c3d50ea7cf69 -> NG`; `09b1b8dd445c -> NG`; `7acc8f3718d2 -> REVIEWPROVIDE-09`; `b2fa883fc4a2 -> NG`; `fe4421531b4c -> NG` |
|
|
241
241
|
| `oat-project-review-receive/SKILL.md` | `9b8a3743d626 -> NG`; `df49c8c6f192 -> NG`; `4ee8730382d3 -> NG`; `655d61df0a8f -> NG`; `765f897d67ac -> NG`; `53b58d16dd32 -> NG`; `fb8755a3bdf4 -> NG`; `c8ab5dd90075 -> NG`; `1f7dd98dff2f -> NG`; `56f78c6740e6 -> NG`; `76f5fb5a88cd -> NG`; `085abfa3599f -> REVIEWRECEIVE-01`; `3ad3aadb8c60 -> NG`; `a7d114059bb6 -> NG`; `ac88cfaa83d9 -> NG`; `3f758313fedb -> REVIEWRECEIVE-08`; `f31f07284718 -> REVIEWRECEIVE-02`; `aba178a21441 -> REVIEWRECEIVE-04`; `a37e601cd731 -> REVIEWRECEIVE-05`; `20e05e1a4381 -> REVIEWRECEIVE-06`; `90001dadf75f -> REVIEWRECEIVE-07`; `f8fd58180ecf -> NG`; `c3abcdc02d9f -> NG`; `f2ebdd6abb9b -> NG` |
|
|
242
|
+
| `oat-project-review-provide/SKILL.md` | `2e794bf4fc4a -> REVIEWPROVIDE-08`; `5441ab977b46 -> REVIEWPROVIDE-08` |
|
|
243
|
+
| `oat-dispatch-subagents/SKILL.md` | `49987359dc09 -> NG` |
|
|
244
|
+
| `oat-dispatch-subagents/references/provider-claude.md` | `06f64bd01ba6 -> NG` |
|
|
242
245
|
| `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01` |
|
|
243
246
|
| `oat-dispatch-subagents/references/provider-claude.md` | `fbe3a21e9533 -> NG` |
|
|
244
247
|
| `oat-dispatch-subagents/references/provider-codex.md` | `95b0f82018c7 -> NG` |
|
|
245
248
|
| `oat-dispatch-subagents/references/provider-cursor.md` | `ca11e28923eb -> NG`; `be0a84c48fc0 -> NG` |
|
|
246
249
|
| `oat-dispatch-subagents/references/record-schema.md` | `78f8069274a8 -> NG` |
|
|
247
250
|
| `oat-project-dispatch-subagents/SKILL.md` | `eca03ad1ca12 -> PDISPATCH-01`; `59fbcdc79cea -> PDISPATCH-01` |
|
|
251
|
+
| `oat-project-complete/SKILL.md` | `b4934a85feee -> NG` |
|
|
248
252
|
|
|
249
253
|
## Prompt-scan comparison
|
|
250
254
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: oat-project-review-provide
|
|
3
|
-
version: 1.3.
|
|
3
|
+
version: 1.3.20
|
|
4
4
|
description: Use when the user explicitly asks to review an OAT project — e.g. "review project", "review the project", "run project review", or confirms a previously offered review. Do NOT auto-invoke on completed work alone. Resolves a project review scope and offers before running.
|
|
5
5
|
disable-model-invocation: false
|
|
6
6
|
user-invocable: true
|
|
@@ -584,6 +584,17 @@ candidate ladder, fail closed before review. Route interactive repair through
|
|
|
584
584
|
the planning workflow's `Complete Dispatch Ladder Adoption Contract`; do not
|
|
585
585
|
invent a reviewer target.
|
|
586
586
|
|
|
587
|
+
**Pre-plan policy inheritance:** When the resolver returns
|
|
588
|
+
`unresolvedReason: 'policy'`, and only then, an `artifact` review whose scope is
|
|
589
|
+
`discovery`, `design`, or `spec` does not block or prompt. Review by deliberate
|
|
590
|
+
inheritance in the current context and record
|
|
591
|
+
`selection_reason: inherit (pre-plan; no project policy)`. An explicitly set
|
|
592
|
+
project policy is always honored, including for pre-plan artifacts. Code
|
|
593
|
+
reviews and `artifact plan` reviews still hard-require a resolved policy.
|
|
594
|
+
Missing or incomplete ladder results (`unresolvedReason: 'ladder' | 'both'`)
|
|
595
|
+
still fail closed. Gate exec-target selection is unaffected by this
|
|
596
|
+
inheritance rule because gates resolve their target independently.
|
|
597
|
+
|
|
587
598
|
After constructing the complete provider payload, record the launcher-owned
|
|
588
599
|
`target`, `model_axis`, and `effort_axis` with
|
|
589
600
|
`launcher-selected/config-declared` provenance. These fields are immutable:
|
|
@@ -609,6 +620,56 @@ managed base role is forbidden except for
|
|
|
609
620
|
explicit inherit/default behavior or the documented managed-uncapped reviewer
|
|
610
621
|
fallback.
|
|
611
622
|
|
|
623
|
+
**Step 6.1: Headless gate route (overrides normal tier selection)**
|
|
624
|
+
|
|
625
|
+
When either prompt frontmatter has `oat_gate_headless: true` or the environment
|
|
626
|
+
has `OAT_GATE_HEADLESS=1`, copy the expected runtime and model from
|
|
627
|
+
`oat_gate_runtime` and `oat_invocation_model`, determine whether this host has
|
|
628
|
+
an awaited-child capability, and use the gate-provided branch-local CLI path.
|
|
629
|
+
Fail closed with `OAT_GATE_REFUSAL` if `OAT_GATE_CLI_PATH` is absent or not
|
|
630
|
+
executable. Run the route command and validate its JSON before using it:
|
|
631
|
+
|
|
632
|
+
```bash
|
|
633
|
+
ROUTE_JSON="$("$OAT_GATE_CLI_PATH" gate route --json \
|
|
634
|
+
--expect-runtime "$OAT_GATE_RUNTIME" \
|
|
635
|
+
--expect-model "$OAT_INVOCATION_MODEL" \
|
|
636
|
+
--can-await true)"
|
|
637
|
+
|
|
638
|
+
OAT_GATE_ROUTE_JSON="$ROUTE_JSON" node -e '
|
|
639
|
+
const value = JSON.parse(process.env.OAT_GATE_ROUTE_JSON);
|
|
640
|
+
if (!["inline", "delegate-sync", "refuse"].includes(value.route) ||
|
|
641
|
+
typeof value.reason !== "string") process.exit(1);
|
|
642
|
+
if (value.cliRoot !== process.env.OAT_GATE_CLI_ROOT) process.exit(1);
|
|
643
|
+
process.stdout.write(JSON.stringify(value));
|
|
644
|
+
'
|
|
645
|
+
```
|
|
646
|
+
|
|
647
|
+
Pass `--can-await false` when this host cannot synchronously await delegated
|
|
648
|
+
review completion. An absent command, command failure, help/non-JSON output,
|
|
649
|
+
invalid envelope, or `cliRoot` different from `OAT_GATE_CLI_ROOT` is a
|
|
650
|
+
structured refusal; never retry with bare `oat` or another installed CLI. Do
|
|
651
|
+
not make a separate runtime/model identity judgment in skill prose; follow the
|
|
652
|
+
validated helper route:
|
|
653
|
+
|
|
654
|
+
In the terminal headless response, report
|
|
655
|
+
`Gate route: <route> (runtime=<expected-runtime>, cliRoot=<validated-cliRoot>)`
|
|
656
|
+
so the parent can retain branch-local route evidence.
|
|
657
|
+
|
|
658
|
+
- `inline`: execute the complete `oat-reviewer` role contract in the current
|
|
659
|
+
context, write the artifact, and finish bookkeeping before returning.
|
|
660
|
+
- `delegate-sync`: dispatch through an awaited handle, then verify the expected
|
|
661
|
+
artifact exists and carries the matching `oat_gate_run_id` before returning.
|
|
662
|
+
A terminal `BLOCKED`, interruption, timeout, or missing/mismatched artifact
|
|
663
|
+
remains terminal and must not trigger a second launch.
|
|
664
|
+
- `refuse`: print `OAT_GATE_REFUSAL: <reason from route output>` on its own
|
|
665
|
+
line. Exit nonzero where the host permits; the gate classifies this line
|
|
666
|
+
independently of exit code.
|
|
667
|
+
|
|
668
|
+
Headless gate mode overrides the Tier 1 background-dispatch preference:
|
|
669
|
+
NEVER use fire-and-forget background dispatch in this mode. The review and its
|
|
670
|
+
artifact/bookkeeping completion must be inline or synchronously awaited before
|
|
671
|
+
the gate child exits.
|
|
672
|
+
|
|
612
673
|
**Step 6a: Probe Subagent Availability**
|
|
613
674
|
|
|
614
675
|
Before selecting a tier, announce the probe and its result so the user can see what's happening:
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: oat-project-summary
|
|
3
|
-
version: 1.3.
|
|
3
|
+
version: 1.3.3
|
|
4
4
|
description: Use when the user requests or confirms summarizing an active OAT project — e.g. "summarize the project", "generate the summary", "run oat-project-summary", or confirms a previously offered summary run. Do NOT auto-invoke when implementation completes. Generates summary.md from project artifacts as institutional memory.
|
|
5
5
|
disable-model-invocation: false
|
|
6
6
|
user-invocable: true
|
|
7
|
-
allowed-tools: Read, Write, Bash(git:*), Bash(oat config:*), Bash(oat decision:*), Glob, Grep, AskUserQuestion
|
|
7
|
+
allowed-tools: Read, Write, Bash(git:*), Bash(oat config:*), Bash(oat decision:*), Bash(oat project log:*), Glob, Grep, AskUserQuestion
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
# Project Summary
|
|
@@ -36,16 +36,17 @@ When executing this skill, provide lightweight progress feedback so the user can
|
|
|
36
36
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
37
37
|
|
|
38
38
|
- Before multi-step work, print step indicators, e.g.:
|
|
39
|
-
- `[1/
|
|
40
|
-
- `[2/
|
|
41
|
-
- `[3/
|
|
42
|
-
- `[4/
|
|
43
|
-
- `[5/
|
|
39
|
+
- `[1/6] Resolving project + reading artifacts…`
|
|
40
|
+
- `[2/6] Checking project log + existing summary…`
|
|
41
|
+
- `[3/6] Generating / updating summary sections…`
|
|
42
|
+
- `[4/6] Rolling up project observations…`
|
|
43
|
+
- `[5/6] Promoting key decisions to reference/decisions/ (if PJM installed)…`
|
|
44
|
+
- `[6/6] Committing…`
|
|
44
45
|
|
|
45
46
|
**BLOCKED Activities:**
|
|
46
47
|
|
|
47
48
|
- ❌ No implementation work
|
|
48
|
-
- ❌ No
|
|
49
|
+
- ❌ No hand-editing project artifacts (other than summary.md)
|
|
49
50
|
- ❌ No creating tasks or modifying plan
|
|
50
51
|
- ❌ No hand-authoring decision files or editing `reference/decisions/index.md` inside its managed markers
|
|
51
52
|
|
|
@@ -53,6 +54,10 @@ When executing this skill, provide lightweight progress feedback so the user can
|
|
|
53
54
|
|
|
54
55
|
- ✅ Reading all project artifacts
|
|
55
56
|
- ✅ Creating or updating summary.md
|
|
57
|
+
- ✅ Using `oat project log append` and `oat project log rollup` as the only
|
|
58
|
+
writers for project-log promotion and roll-up
|
|
59
|
+
- ✅ Offering follow-up-marked project-log entries to
|
|
60
|
+
`oat-pjm-add-backlog-item`
|
|
56
61
|
- ✅ Committing summary.md changes
|
|
57
62
|
- ✅ Promoting the summary's Key Decisions into canonical `reference/decisions/` records via `oat decision new` (Step 7), gated on the PJM tool pack being installed
|
|
58
63
|
|
|
@@ -120,6 +125,8 @@ Read all available artifacts for synthesis:
|
|
|
120
125
|
- `"$PROJECT_PATH/plan.md"` — phases, tasks, reviews, deferred items
|
|
121
126
|
- `"$PROJECT_PATH/implementation.md"` — task outcomes, deviations, challenges, review notes
|
|
122
127
|
- `"$PROJECT_PATH/state.md"` — associated issues, workflow mode
|
|
128
|
+
- `"$PROJECT_PATH/project-log.md"` — optional append-only workflow
|
|
129
|
+
observations; never hand-edit
|
|
123
130
|
- `"$PROJECT_PATH/oat-execution-learnings.md"` — optional append-only
|
|
124
131
|
autonomous-run observations and recommendations
|
|
125
132
|
|
|
@@ -128,6 +135,34 @@ Read all available artifacts for synthesis:
|
|
|
128
135
|
If `oat-execution-learnings.md` is absent, do not infer autonomous learnings
|
|
129
136
|
from other artifacts and do not add an Autonomous Execution Learnings section.
|
|
130
137
|
|
|
138
|
+
### Step 2.5: Check Project Log and Offer Ledger Graduation
|
|
139
|
+
|
|
140
|
+
Run the read-only status probe before authoring or refreshing `summary.md`:
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
PROJECT_LOG_CHECK=$(oat project log check --project "$PROJECT_PATH" --json)
|
|
144
|
+
PROJECT_LOG_PROMOTION_APPENDED="false"
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
Route on the structured result. `status: "absent"` is inert. When the entry
|
|
148
|
+
counts show one or more entries, keep the log in the summary flow even if task,
|
|
149
|
+
revision, and autonomous-learning tracking fields are otherwise current.
|
|
150
|
+
|
|
151
|
+
Before roll-up, inspect `project`-scoped judgments for observations that are
|
|
152
|
+
reusable across projects and offer ledger graduation. For every observation the
|
|
153
|
+
user selects, invoke `oat project log append` with the original judgment type
|
|
154
|
+
and area, `--scope general`, and a body that references the original entry's
|
|
155
|
+
exact heading. The new body may explain why the observation is reusable, but it
|
|
156
|
+
must not copy the full original entry. Request the append result as structured
|
|
157
|
+
JSON; whenever it reports `status: "appended"`, set
|
|
158
|
+
`PROJECT_LOG_PROMOTION_APPENDED="true"` so the commit step includes the mutated
|
|
159
|
+
project log.
|
|
160
|
+
|
|
161
|
+
Ledger graduation is append-only: never edit, annotate, strike through, or add
|
|
162
|
+
side metadata to the original entry. The newly appended `general` judgment is
|
|
163
|
+
the promotion, and the later `rollup` command naturally selects it for the
|
|
164
|
+
ledger.
|
|
165
|
+
|
|
131
166
|
### Step 3: Check for Existing Summary
|
|
132
167
|
|
|
133
168
|
```bash
|
|
@@ -154,7 +189,7 @@ test -f "$PROJECT_PATH/summary.md"
|
|
|
154
189
|
identifiers (timestamp, category, and title) with the source pointers in
|
|
155
190
|
the existing `## Autonomous Execution Learnings` section. Treat missing,
|
|
156
191
|
added, or changed recommendations as `learnings_changed`.
|
|
157
|
-
- If `oat_summary_last_task == current_last_task` AND `oat_summary_revision_count == current_rev_count` AND learnings are absent or unchanged: **No changes detected. Skip update.** Report: "Summary is current. No updates needed."
|
|
192
|
+
- If `oat_summary_last_task == current_last_task` AND `oat_summary_revision_count == current_rev_count` AND learnings are absent or unchanged AND the project-log check reports no entries: **No changes detected. Skip update.** Report: "Summary is current. No updates needed."
|
|
158
193
|
- If `current_rev_count > oat_summary_revision_count`: New revision phases exist. Update: Revision History, What Was Implemented, Follow-up Items.
|
|
159
194
|
- If `current_last_task > oat_summary_last_task`: New tasks completed. Update: What Was Implemented, Notable Challenges, Tradeoffs Made.
|
|
160
195
|
- If `learnings_changed`: update Autonomous Execution Learnings even when
|
|
@@ -192,6 +227,7 @@ For each section, synthesize content from the relevant artifacts. Apply these ru
|
|
|
192
227
|
| Revision History | plan.md p-revN phases, implementation.md revision notes |
|
|
193
228
|
| Follow-up Items | implementation.md deferred findings, plan.md deferred items |
|
|
194
229
|
| Associated Issues | state.md `associated_issues` field |
|
|
230
|
+
| Workflow Observations | project-log.md via `oat project log rollup` only |
|
|
195
231
|
| Autonomous Execution Learnings | oat-execution-learnings.md dated entries |
|
|
196
232
|
|
|
197
233
|
**Autonomous Execution Learnings (conditional):**
|
|
@@ -232,6 +268,17 @@ entries, omit the entire section. If the file is absent, this behavior is inert:
|
|
|
232
268
|
remove the template placeholder during a first render and make no
|
|
233
269
|
learnings-driven update on a re-run.
|
|
234
270
|
|
|
271
|
+
**Workflow Observations coexistence contract:**
|
|
272
|
+
|
|
273
|
+
Keep `## Workflow Observations` and `## Autonomous Execution Learnings` as
|
|
274
|
+
distinct summary sections. Author the autonomous-execution section first, then
|
|
275
|
+
perform the project-log roll-up in Step 6. Because the roll-up command writes
|
|
276
|
+
every project-log entry, keep the project-log observation in Workflow
|
|
277
|
+
Observations and represent any overlap from Autonomous Execution Learnings with
|
|
278
|
+
a one-line cross-reference instead of copying it there. The roll-up command
|
|
279
|
+
remains the only writer of Workflow Observations—never hand-implement its
|
|
280
|
+
section or ledger writes.
|
|
281
|
+
|
|
235
282
|
**For incremental updates (re-run):**
|
|
236
283
|
|
|
237
284
|
Only update sections affected by the new content. Do not rewrite the entire summary. Preserve existing section content and append/modify as needed.
|
|
@@ -253,11 +300,50 @@ oat_summary_includes_revisions: [{ list of p-revN IDs reflected }]
|
|
|
253
300
|
---
|
|
254
301
|
```
|
|
255
302
|
|
|
256
|
-
### Step 6:
|
|
303
|
+
### Step 6: Roll Up Project Observations and Offer Backlog Graduation
|
|
304
|
+
|
|
305
|
+
Run this step after `summary.md` has been authored or refreshed, including the
|
|
306
|
+
distinct `## Autonomous Execution Learnings` section when its source artifact
|
|
307
|
+
exists.
|
|
308
|
+
|
|
309
|
+
When Step 2.5 found entries, run:
|
|
310
|
+
|
|
311
|
+
```bash
|
|
312
|
+
PROJECT_LOG_LEDGER_PATH=$(oat config get workflow.projectLogLedgerPath)
|
|
313
|
+
PROJECT_LOG_LEDGER_APPENDED="false"
|
|
314
|
+
PROJECT_LOG_ROLLUP=$(oat project log rollup --project "$PROJECT_PATH" --json)
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
`PROJECT_LOG_LEDGER_PATH` must be the effective resolved path, including the
|
|
318
|
+
default when no override exists. If it cannot be resolved, stop before roll-up
|
|
319
|
+
because a later `ledgerOutcome: "appended"` could not be staged safely.
|
|
320
|
+
|
|
321
|
+
Route only on the structured `ProjectLogRollupResult`:
|
|
322
|
+
|
|
323
|
+
- `status: "ok"` with `ledgerOutcome: "appended"`: set
|
|
324
|
+
`PROJECT_LOG_LEDGER_APPENDED="true"` and proceed.
|
|
325
|
+
- `status: "ok"` with `ledgerOutcome: "deduplicated"`: proceed without staging
|
|
326
|
+
the unchanged ledger.
|
|
327
|
+
- `status: "ok"` with `ledgerOutcome: "skipped_permitted"`: proceed and report
|
|
328
|
+
that the ledger was permissibly skipped because the default reference layer
|
|
329
|
+
is absent.
|
|
330
|
+
- `status: "failed"` or `ledgerOutcome: "failed"`: surface the failure to the
|
|
331
|
+
user and stop before commit. Do not describe the summary as fully rolled up.
|
|
332
|
+
|
|
333
|
+
The command mechanically writes or updates `## Workflow Observations` and
|
|
334
|
+
appends/deduplicates eligible `general` judgments in the configured ledger. Do
|
|
335
|
+
not reproduce either write by hand.
|
|
336
|
+
|
|
337
|
+
Separately inspect follow-up-marked project-log entries and offer backlog
|
|
338
|
+
graduation through `oat-pjm-add-backlog-item`. Backlog graduation creates a
|
|
339
|
+
tracked work item; it is not ledger graduation and must not replace the
|
|
340
|
+
append-based `project` → `general` promotion in Step 2.5.
|
|
341
|
+
|
|
342
|
+
### Step 7: Promote Key Decisions to Canonical Decision Records
|
|
257
343
|
|
|
258
344
|
Run this step **after** `summary.md` (including its `## Key Decisions` section) has been written/refreshed and its frontmatter updated. It promotes the project's Key Decisions out of per-project prose and into the canonical, repo-wide `reference/decisions/` log so they stop being siloed in `summary.md`. This step is **additive and non-interactive** — it never prompts.
|
|
259
345
|
|
|
260
|
-
**
|
|
346
|
+
**7.1 — PJM gate (auto, no prompt).** Check whether the PJM tool pack is installed:
|
|
261
347
|
|
|
262
348
|
```bash
|
|
263
349
|
PJM_ENABLED=$(oat config get tools.project-management 2>/dev/null || echo "")
|
|
@@ -266,9 +352,9 @@ PJM_ENABLED=$(oat config get tools.project-management 2>/dev/null || echo "")
|
|
|
266
352
|
- If `PJM_ENABLED` is `true` → perform the promotion automatically. Do NOT ask the user.
|
|
267
353
|
- Otherwise (any other value, empty, or unset) → **skip this entire step silently.** Do not print a warning or prompt.
|
|
268
354
|
|
|
269
|
-
**
|
|
355
|
+
**7.2 — Skip if nothing to promote.** If `summary.md` has no `## Key Decisions` section, or that section has no decision content, skip the step. There is nothing to promote.
|
|
270
356
|
|
|
271
|
-
**
|
|
357
|
+
**7.3 — Ensure the decisions surface exists.** The canonical decisions root is `.oat/repo/reference/decisions` (the `oat decision` default; pass `--decisions-root <path>` only for an explicit override). If its managed index is missing — i.e. `.oat/repo/reference/decisions/index.md` does not exist — initialize it first so `oat decision new` can succeed:
|
|
272
358
|
|
|
273
359
|
```bash
|
|
274
360
|
test -f .oat/repo/reference/decisions/index.md || oat decision init
|
|
@@ -276,7 +362,7 @@ test -f .oat/repo/reference/decisions/index.md || oat decision init
|
|
|
276
362
|
|
|
277
363
|
`oat decision init` is idempotent; running it when the scaffold already exists is harmless.
|
|
278
364
|
|
|
279
|
-
**
|
|
365
|
+
**7.4 — Idempotent, date-independent promotion (critical).** For each decision in `## Key Decisions`:
|
|
280
366
|
|
|
281
367
|
1. **Derive title + complete sections.** Ground every value in the Key Decision and its project artifacts:
|
|
282
368
|
- The bold lead-in / first clause becomes the **title** (a short noun phrase).
|
|
@@ -308,7 +394,7 @@ Because of the date-independent slug dedup, this step is **safe to run every tim
|
|
|
308
394
|
|
|
309
395
|
**Status value:** use `--status accepted`. The decision template's status field (`.oat/templates/decision.md`) is free-form, and the canonical accepted/decided value in the decision vocabulary (`proposed` → `accepted` → `superseded`) is `accepted`. A Key Decision in a completed project's summary represents a decision that was made and shipped, so `accepted` is the correct status.
|
|
310
396
|
|
|
311
|
-
**
|
|
397
|
+
**7.5 — Report, don't prompt.** After processing all Key Decisions, print a short informational summary, e.g.:
|
|
312
398
|
|
|
313
399
|
```
|
|
314
400
|
Promoted N key decision(s) to reference/decisions/:
|
|
@@ -318,14 +404,25 @@ Promoted N key decision(s) to reference/decisions/:
|
|
|
318
404
|
|
|
319
405
|
This is informational only. There is no interactive prompt anywhere in this step.
|
|
320
406
|
|
|
321
|
-
### Step
|
|
407
|
+
### Step 8: Commit
|
|
322
408
|
|
|
323
409
|
```bash
|
|
324
410
|
git add "$PROJECT_PATH/summary.md"
|
|
411
|
+
if [ "$PROJECT_LOG_PROMOTION_APPENDED" = "true" ]; then
|
|
412
|
+
git add "$PROJECT_PATH/project-log.md"
|
|
413
|
+
fi
|
|
414
|
+
if [ "$PROJECT_LOG_LEDGER_APPENDED" = "true" ]; then
|
|
415
|
+
git add "$PROJECT_LOG_LEDGER_PATH"
|
|
416
|
+
fi
|
|
325
417
|
git commit -m "docs: generate summary for {project-name}"
|
|
326
418
|
```
|
|
327
419
|
|
|
328
|
-
|
|
420
|
+
These conditional paths are required: append-based promotion mutates
|
|
421
|
+
`project-log.md`, while `ledgerOutcome: "appended"` mutates the effective
|
|
422
|
+
repository ledger. A permitted skip or deduplicated ledger does not add a
|
|
423
|
+
ledger staging path.
|
|
424
|
+
|
|
425
|
+
If decision records were promoted in Step 7, also stage `.oat/repo/reference/decisions/` so the new `DR-*.md` records and the regenerated `index.md` land with the summary.
|
|
329
426
|
|
|
330
427
|
If this is a re-run (incremental update):
|
|
331
428
|
|
|
@@ -333,7 +430,7 @@ If this is a re-run (incremental update):
|
|
|
333
430
|
git commit -m "docs: update summary for {project-name}"
|
|
334
431
|
```
|
|
335
432
|
|
|
336
|
-
### Step
|
|
433
|
+
### Step 9: Output Summary
|
|
337
434
|
|
|
338
435
|
```
|
|
339
436
|
Summary generated for {project-name}.
|
|
@@ -360,5 +457,12 @@ Summary tracks: last task {task_id}, {N} revision phases
|
|
|
360
457
|
follow-ups, and Workflow issues with source-entry pointers
|
|
361
458
|
- When `oat-execution-learnings.md` is absent, no Autonomous Execution
|
|
362
459
|
Learnings section is rendered and normal summary behavior is unchanged
|
|
460
|
+
- Project-log ledger graduation appends a new referencing `general` judgment
|
|
461
|
+
before roll-up and never mutates the original `project` judgment
|
|
462
|
+
- `oat project log rollup --json` owns the distinct Workflow Observations
|
|
463
|
+
section and ledger writes; `failed` stops the summary flow while
|
|
464
|
+
`skipped_permitted` proceeds with a note
|
|
465
|
+
- Follow-up-marked project-log entries use backlog graduation separately from
|
|
466
|
+
ledger graduation
|
|
363
467
|
- When the PJM tool pack is installed, each Key Decision is promoted to a canonical `reference/decisions/DR-YYMMDD-slug` record via `oat decision new` (status `accepted`), deduped on the date-independent slug so re-runs never create duplicate records
|
|
364
468
|
- When the PJM tool pack is not installed, decision promotion is skipped silently with no prompt
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
---
|
|
2
|
+
oat_generated: false
|
|
3
|
+
oat_template: true
|
|
4
|
+
oat_template_name: project-log
|
|
5
|
+
purpose: project-observations
|
|
6
|
+
oat_last_updated: YYYY-MM-DD
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Project Log: {Project Name}
|
|
10
|
+
|
|
11
|
+
This append-only log serves two audiences: the project team learning from this project's execution, and maintainers improving the general OAT workflow and tooling.
|
|
12
|
+
|
|
13
|
+
## Logging contract
|
|
14
|
+
|
|
15
|
+
Append when something breaks, surprises you, requires a workaround, or works notably well enough to preserve as do-not-regress evidence. Record evidence, not a running narrative. Prior entries are never edited or struck through; append corrections as a new judgment entry that references the original entry and explains the correction. Add a version note to tool-related observations. Create entries only with `oat project log append`; run `oat project log append --help` for the complete entry contract. Reference supporting artifacts by path instead of inlining them. Never record secret values such as tokens, keys, signed URLs, or credentials because this log rolls up into tracked surfaces; reference secrets by name or source, never by value.
|
|
16
|
+
|
|
17
|
+
Judgment entries default to 1–3 sentences covering what happened, the impact or workaround, and any follow-up. High-value entries may instead use this structured body:
|
|
18
|
+
|
|
19
|
+
```text
|
|
20
|
+
Observation: What happened and the supporting evidence.
|
|
21
|
+
Impact: Why it mattered or what workaround was required.
|
|
22
|
+
Recommendation: What should change or be preserved.
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Shared tracked surfaces must be written only from the root checkout, never from parallel worktrees.
|
|
26
|
+
|
|
27
|
+
## Entry format
|
|
28
|
+
|
|
29
|
+
Judgment entries:
|
|
30
|
+
|
|
31
|
+
```text
|
|
32
|
+
### YYYY-MM-DD · <project|general> · <bug|friction|worked-well|feedback> · <area>
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Structural entries:
|
|
36
|
+
|
|
37
|
+
```text
|
|
38
|
+
### YYYY-MM-DD · structural · <producer> · <ref>
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## Entries
|
|
42
|
+
|
|
43
|
+
Entries are chronological and append-only.
|
|
44
|
+
|
|
45
|
+
## End-of-run synthesis (pending — do not skip at project completion)
|
|
46
|
+
|
|
47
|
+
Summarize the overall verdict, adopted adjustments, and entries graduated to the repo ledger or backlog. Roll up durable observations into tracked surfaces before archiving this project log.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAezC,OAAO,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAezC,OAAO,EAML,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAehB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAGL,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC3B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyFpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,kBAAkB,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7C,mCAAmC,EAAE,OAAO,mCAAmC,CAAC;IAChF,0BAA0B,EAAE,OAAO,0BAA0B,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAkhED,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAsKT"}
|