npm - @open-agent-toolkit/cli - Versions diffs - 0.2.4 → 0.2.6 - Mend

@open-agent-toolkit/cli 0.2.4 → 0.2.6

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.

Files changed (106) hide show

package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md CHANGED Viewed

@@ -142,6 +142,7 @@ remains.
 | PLAN-09          | `oat-project-plan`               | Plan artifact-review findings                 | Accept offered Medium/Minor fixes                         | Apply unambiguous artifact-local fixes and re-review; unresolved Critical or material ambiguity stops                                                                                                                                                                        | `auto-resolve` / `boundary:unresolved-critical-findings`                        | Plan review row and residuals                                        |
 | PLAN-10          | `oat-project-plan`               | Parallel-group proposal                       | Confirm a candidate group                                 | Accept only when write-set and dependency evidence proves independence; otherwise keep sequential and record why                                                                                                                                                             | `auto-resolve`                                                                  | Plan Parallelism section                                             |
 | PLAN-11          | `oat-project-plan`               | Configured exit gate                          | `block`, `prompt`, or `warn` after failure                | Apply configured failure semantics; `prompt` becomes a reported boundary                                                                                                                                                                                                     | `auto-resolve` / `boundary:repository-policy-approval`                          | Structured gate result and disposition                               |
+| PLAN-12          | `oat-project-plan`               | Project-explainer intent                      | Generate or skip the project explainer                    | Preserve explicit or persisted intent; in autonomy generate only when kickoff explicitly requested it and never prompt                                                                                                                                                       | `auto-resolve`                                                                  | Persisted project-explainer intent                                   |
 | IMPORT-01        | `oat-project-import-plan`        | Inherited dirty tree                          | Commit, proceed, or abort                                 | Proceed without staging unrelated files; destructive cleanup stops                                                                                                                                                                                                           | `auto-resolve` / `boundary:destructive-change-risk`                             | Import preflight note                                                |
 | IMPORT-02        | `oat-project-import-plan`        | Missing project                               | Ask for project identity                                  | Use explicit invocation context; otherwise stop rather than guess                                                                                                                                                                                                            | `boundary:product-judgment`                                                     | Resolved project path                                                |
 | IMPORT-03        | `oat-project-import-plan`        | Source plan selection or extension exception  | Choose a candidate/path or confirm nonstandard Markdown   | Use an explicit unique source; ambiguity or nonstandard content stops                                                                                                                                                                                                        | `auto-resolve` / `boundary:product-judgment`                                    | Import reference metadata                                            |
@@ -169,6 +170,7 @@ remains.
 | IMPLEMENT-16     | `oat-project-implement`          | Final HiLL approval                           | Approve, decline, or defer between pre/post steps         | After passing auto-review and successful pre-approval steps, record approval and continue post-approval steps; otherwise stop                                                                                                                                                | `auto-resolve` / `boundary:unresolved-critical-findings`                        | Sequence snapshot, review artifact, dispatch record                  |
 | IMPLEMENT-17     | `oat-project-implement`          | Next-step prompt                              | Choose lifecycle tail actions                             | Unreachable when the autonomous sequence snapshot exists; never present the prompt                                                                                                                                                                                           | `auto-resolve`                                                                  | Completed sequence snapshot                                          |
 | IMPLEMENT-18     | `oat-project-implement`          | Configured exit gate                          | `block`, `prompt`, or `warn` after validated findings     | Apply configured failure semantics only to a validated, receive-eligible `blocked` envelope after durable receive; all operational, validation, correlation, malformed/contradictory-envelope, launch, and receive failures stop regardless of `onFailure`, including `warn` | `auto-resolve` / `boundary:repository-policy-approval`                          | Validated structured gate result, completed receive, and disposition |
+| IMPLEMENT-19     | `oat-project-implement`          | Implementation-tail project recap             | Generate or skip the final project recap                  | In autonomy attempt one recap when no fresh recap exists; preserve resolved interactive intent otherwise, and never block completion on recap outcome                                                                                                                        | `auto-resolve`                                                                  | Recap manifest and outcome record                                    |
 | DOCUMENT-01      | `oat-project-document`           | Missing project path                          | Ask for a path                                            | Use explicit/active project only; otherwise stop                                                                                                                                                                                                                             | `boundary:product-judgment`                                                     | Resolved project path                                                |
 | DOCUMENT-02      | `oat-project-document`           | Documentation delta approval                  | Apply all, individual, or skip                            | Invoke the existing `--auto` path and apply all non-destructive recommendations                                                                                                                                                                                              | `auto-resolve`                                                                  | Documentation delta and state update                                 |
 | DOCUMENT-03      | `oat-project-document`           | Delete or restructure docs                    | Require explicit approval                                 | Stop before destructive or broad restructuring not already authorized by the plan                                                                                                                                                                                            | `boundary:destructive-change-risk`                                              | Documentation blocker                                                |
@@ -256,7 +258,9 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-dispatch-subagents/references/provider-cursor.md`         | `ca11e28923eb -> NG`; `be0a84c48fc0 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | `oat-dispatch-subagents/references/record-schema.md`           | `78f8069274a8 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | `oat-project-dispatch-subagents/SKILL.md`                      | `eca03ad1ca12 -> PDISPATCH-01`; `59fbcdc79cea -> PDISPATCH-01`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `oat-project-complete/SKILL.md`                                | `b4934a85feee -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `oat-project-plan/SKILL.md`                                    | `f99e44b39932 -> PLAN-12`; `7e6a9854504b -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `oat-project-implement/references/completion-and-closeout.md`  | `6909a5a5a1fa -> IMPLEMENT-19`; `a7c02ef670fd -> IMPLEMENT-19`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `oat-project-complete/SKILL.md`                                | `ffad9f909dba -> COMPLETE-01`; `ffe636f736e8 -> COMPLETE-01`; `ea2dced337be -> COMPLETE-01`; `93d3e4ee3355 -> COMPLETE-01`; `2407ebed0921 -> NG`; `0177956707aa -> NG`; `8305b5bb65ef -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 ## Prompt-scan comparison

package/assets/skills/oat-project-next/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-project-next
-version: 1.0.10
+version: 1.0.11
 description: Use when continuing work on the active OAT project. Reads project state, determines the next lifecycle action, and invokes the appropriate skill automatically.
 disable-model-invocation: true
 user-invocable: true
@@ -270,9 +270,13 @@ Before every other post-implementation route, inspect
 or not fresh, route to `oat-project-implement`.
 This override applies even when `oat_phase_status` is `complete` or `pr_open`,
-and before the summary, document, PR, or `oat-project-complete` routes. Announce
-exactly: "Implementation exit gate unresolved or stale — resume with
-`oat-project-implement` before post-implementation routing."
+and before the summary, document, PR, or `oat-project-complete` routes. When a
+qualified allowed result matches but its rolling checkpoint trails HEAD,
+announce exactly: "Implementation exit gate freshness checkpoint pending —
+resume with `oat-project-implement` before post-implementation routing." For all
+other unresolved or stale cases, announce exactly: "Implementation exit gate
+unresolved or stale — resume with `oat-project-implement` before
+post-implementation routing."
 Only an `allowed` and fresh exit-gate disposition falls through to the normal
 post-implementation checks.
@@ -282,11 +286,13 @@ alone:
 - `allowed/no_gate` is valid only with `disposition: no_gate`, null gate-run and
   artifact provenance, and current `reviewed_head` and implementation
-  fingerprint fields.
+  fingerprint fields. Qualified state also requires `implementation_base_ref`,
+  `freshness_head`, and `freshness_fingerprint`.
 - `allowed/configured` is valid only with `disposition: passed`, `warned`, or
   `prompt_approved`; matching `config_fingerprint`, `reviewed_head`,
-  `implementation_fingerprint`, and configured gate-run provenance; and any
-  eligible receive durably completed.
+  `implementation_fingerprint`, configured gate-run provenance, and any eligible
+  receive durably completed. Qualified state also requires the complete rolling
+  freshness fields.
 - `pending`, `blocked`, malformed, contradictory, or legacy-absent state never
   falls through. Pending and blocked generations resume their persisted
   configuration; configuration-fingerprint mismatch fails closed.
@@ -294,10 +300,24 @@ alone:
   paths and substantive changes route as stale. The recognized set is limited
   to configured gate artifacts and receipts, project tracking and
   `project-log.md` appends, summary/documentation/PR sequence outputs, final
-  HiLL bookkeeping, and completion bookkeeping.
-- Any implementation, test, skill, template, workflow configuration, or other
-  unrecognized change after `reviewed_head` invalidates the implementation
-  fingerprint and routes to `oat-project-implement`.
+  HiLL bookkeeping, and completion bookkeeping. A category match without its
+  persisted transition boundary is unknown, not closeout-only.
+- For qualified state, require `implementation_base_ref`, `freshness_head`, and
+  a valid `freshness_fingerprint`. Exactly one merge base and 64-character
+  lowercase hexadecimal implementation/freshness digests are mandatory.
+  Missing or malformed inputs route as stale. When HEAD differs from
+  `freshness_head`, use the full raw Git byte algorithm from
+  `oat-project-implement` with only its literal state-carrier exclusion. Verify
+  and ignore state-only checkpoint commits before classification. An unchanged
+  qualified fingerprint preserves freshness across a merge, rebase, or base
+  update but routes to `oat-project-implement` to persist the advanced rolling
+  checkpoint; a mismatch routes as stale. This read-only router never advances
+  state or invents another fingerprint algorithm.
+- Legacy unqualified fingerprints retain the closeout-only descendant-path
+  check. Any implementation, test, skill, template, workflow configuration, or
+  other unrecognized change after `reviewed_head` invalidates the implementation
+  fingerprint and routes to `oat-project-implement`. Do not reinterpret or
+  migrate legacy state while routing.
 Routing is read-only: announce stale or malformed state, but leave transition
 repair, gate execution, receive, and persistence to `oat-project-implement`.

package/assets/skills/oat-project-plan/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-project-plan
-version: 1.4.2
+version: 1.4.3
 description: Use when design.md is complete and executable implementation tasks are needed. Breaks design into bite-sized TDD tasks in canonical plan.md format.
 oat_gateable: true
 disable-model-invocation: true
@@ -155,6 +155,20 @@ Read for implementation context:
 - `.oat/repo/knowledge/testing.md` - Testing patterns
 - `.oat/repo/knowledge/stack.md` - Available tools and dependencies
+### Step 4.5: Resolve Project-Explainer Intent
+Resolve `projectExplainer` intent before drafting the plan. Use the
+`oat-explainer-kit` lifecycle intent resolver with interactive mode, the current
+`oat_project_explainer` state value, and the source-aware
+`workflow.explainers.projectExplainer` preference.
+When resolution returns `needsPrompt: true`, ask exactly once whether to generate the project explainer, then resolve again with the answer and persist the returned `interactive` record.
+A valid persisted `oat_project_explainer` decision prevents another prompt.
+Persist through the adapter's optimistic-concurrency helper; on a stale write,
+re-read state and resolve precedence again instead of retrying the old record.
+Do not persist decisions derived only from `always` or `never` workflow
+preferences.
 ### Step 4.9: Snapshot Explicit Phase-Review Setting Before Plan Overwrite
 Before Step 5 can replace an existing `plan.md`, inspect the source text and
@@ -636,6 +650,21 @@ Total: {N} tasks
 Ready for implementation"
 ```
+### Step 15.5: Generate the Project Explainer When Selected
+Generate only after plan artifact review, the configured plan gate, and the plan commit have completed successfully.
+When the resolved project-explainer decision is `generate`, invoke
+`oat-explainer-kit` for the `project-explainer` recipe using the approved
+project artifacts and report its outcome and run path. A `skip` decision ends
+this step without invoking the adapter.
+Supply the provider-neutral critic callback (or validated critic module entry point for JSON/CLI invocation) on every federated adapter run.
+Explainer failure must not roll back, amend, or invalidate the valid committed plan.
+Preserve the adapter's failure outcome and recovery guidance, warn the user,
+and continue to the planning summary. This post-plan product does not replace
+or reorder plan artifact review, dispatch resolution, the configured plan gate,
+or HiLL handling.
 ### Step 16: Output Summary
 ```

package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md CHANGED Viewed

@@ -142,6 +142,7 @@ remains.
 | PLAN-09          | `oat-project-plan`               | Plan artifact-review findings                 | Accept offered Medium/Minor fixes                         | Apply unambiguous artifact-local fixes and re-review; unresolved Critical or material ambiguity stops                                                                                                                                                                        | `auto-resolve` / `boundary:unresolved-critical-findings`                        | Plan review row and residuals                                        |
 | PLAN-10          | `oat-project-plan`               | Parallel-group proposal                       | Confirm a candidate group                                 | Accept only when write-set and dependency evidence proves independence; otherwise keep sequential and record why                                                                                                                                                             | `auto-resolve`                                                                  | Plan Parallelism section                                             |
 | PLAN-11          | `oat-project-plan`               | Configured exit gate                          | `block`, `prompt`, or `warn` after failure                | Apply configured failure semantics; `prompt` becomes a reported boundary                                                                                                                                                                                                     | `auto-resolve` / `boundary:repository-policy-approval`                          | Structured gate result and disposition                               |
+| PLAN-12          | `oat-project-plan`               | Project-explainer intent                      | Generate or skip the project explainer                    | Preserve explicit or persisted intent; in autonomy generate only when kickoff explicitly requested it and never prompt                                                                                                                                                       | `auto-resolve`                                                                  | Persisted project-explainer intent                                   |
 | IMPORT-01        | `oat-project-import-plan`        | Inherited dirty tree                          | Commit, proceed, or abort                                 | Proceed without staging unrelated files; destructive cleanup stops                                                                                                                                                                                                           | `auto-resolve` / `boundary:destructive-change-risk`                             | Import preflight note                                                |
 | IMPORT-02        | `oat-project-import-plan`        | Missing project                               | Ask for project identity                                  | Use explicit invocation context; otherwise stop rather than guess                                                                                                                                                                                                            | `boundary:product-judgment`                                                     | Resolved project path                                                |
 | IMPORT-03        | `oat-project-import-plan`        | Source plan selection or extension exception  | Choose a candidate/path or confirm nonstandard Markdown   | Use an explicit unique source; ambiguity or nonstandard content stops                                                                                                                                                                                                        | `auto-resolve` / `boundary:product-judgment`                                    | Import reference metadata                                            |
@@ -169,6 +170,7 @@ remains.
 | IMPLEMENT-16     | `oat-project-implement`          | Final HiLL approval                           | Approve, decline, or defer between pre/post steps         | After passing auto-review and successful pre-approval steps, record approval and continue post-approval steps; otherwise stop                                                                                                                                                | `auto-resolve` / `boundary:unresolved-critical-findings`                        | Sequence snapshot, review artifact, dispatch record                  |
 | IMPLEMENT-17     | `oat-project-implement`          | Next-step prompt                              | Choose lifecycle tail actions                             | Unreachable when the autonomous sequence snapshot exists; never present the prompt                                                                                                                                                                                           | `auto-resolve`                                                                  | Completed sequence snapshot                                          |
 | IMPLEMENT-18     | `oat-project-implement`          | Configured exit gate                          | `block`, `prompt`, or `warn` after validated findings     | Apply configured failure semantics only to a validated, receive-eligible `blocked` envelope after durable receive; all operational, validation, correlation, malformed/contradictory-envelope, launch, and receive failures stop regardless of `onFailure`, including `warn` | `auto-resolve` / `boundary:repository-policy-approval`                          | Validated structured gate result, completed receive, and disposition |
+| IMPLEMENT-19     | `oat-project-implement`          | Implementation-tail project recap             | Generate or skip the final project recap                  | In autonomy attempt one recap when no fresh recap exists; preserve resolved interactive intent otherwise, and never block completion on recap outcome                                                                                                                        | `auto-resolve`                                                                  | Recap manifest and outcome record                                    |
 | DOCUMENT-01      | `oat-project-document`           | Missing project path                          | Ask for a path                                            | Use explicit/active project only; otherwise stop                                                                                                                                                                                                                             | `boundary:product-judgment`                                                     | Resolved project path                                                |
 | DOCUMENT-02      | `oat-project-document`           | Documentation delta approval                  | Apply all, individual, or skip                            | Invoke the existing `--auto` path and apply all non-destructive recommendations                                                                                                                                                                                              | `auto-resolve`                                                                  | Documentation delta and state update                                 |
 | DOCUMENT-03      | `oat-project-document`           | Delete or restructure docs                    | Require explicit approval                                 | Stop before destructive or broad restructuring not already authorized by the plan                                                                                                                                                                                            | `boundary:destructive-change-risk`                                              | Documentation blocker                                                |
@@ -256,7 +258,9 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-dispatch-subagents/references/provider-cursor.md`         | `ca11e28923eb -> NG`; `be0a84c48fc0 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | `oat-dispatch-subagents/references/record-schema.md`           | `78f8069274a8 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | `oat-project-dispatch-subagents/SKILL.md`                      | `eca03ad1ca12 -> PDISPATCH-01`; `59fbcdc79cea -> PDISPATCH-01`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `oat-project-complete/SKILL.md`                                | `b4934a85feee -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `oat-project-plan/SKILL.md`                                    | `f99e44b39932 -> PLAN-12`; `7e6a9854504b -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `oat-project-implement/references/completion-and-closeout.md`  | `6909a5a5a1fa -> IMPLEMENT-19`; `a7c02ef670fd -> IMPLEMENT-19`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `oat-project-complete/SKILL.md`                                | `ffad9f909dba -> COMPLETE-01`; `ffe636f736e8 -> COMPLETE-01`; `ea2dced337be -> COMPLETE-01`; `93d3e4ee3355 -> COMPLETE-01`; `2407ebed0921 -> NG`; `0177956707aa -> NG`; `8305b5bb65ef -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 ## Prompt-scan comparison

package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md CHANGED Viewed

@@ -142,6 +142,7 @@ remains.
 | PLAN-09          | `oat-project-plan`               | Plan artifact-review findings                 | Accept offered Medium/Minor fixes                         | Apply unambiguous artifact-local fixes and re-review; unresolved Critical or material ambiguity stops                                                                                                                                                                        | `auto-resolve` / `boundary:unresolved-critical-findings`                        | Plan review row and residuals                                        |
 | PLAN-10          | `oat-project-plan`               | Parallel-group proposal                       | Confirm a candidate group                                 | Accept only when write-set and dependency evidence proves independence; otherwise keep sequential and record why                                                                                                                                                             | `auto-resolve`                                                                  | Plan Parallelism section                                             |
 | PLAN-11          | `oat-project-plan`               | Configured exit gate                          | `block`, `prompt`, or `warn` after failure                | Apply configured failure semantics; `prompt` becomes a reported boundary                                                                                                                                                                                                     | `auto-resolve` / `boundary:repository-policy-approval`                          | Structured gate result and disposition                               |
+| PLAN-12          | `oat-project-plan`               | Project-explainer intent                      | Generate or skip the project explainer                    | Preserve explicit or persisted intent; in autonomy generate only when kickoff explicitly requested it and never prompt                                                                                                                                                       | `auto-resolve`                                                                  | Persisted project-explainer intent                                   |
 | IMPORT-01        | `oat-project-import-plan`        | Inherited dirty tree                          | Commit, proceed, or abort                                 | Proceed without staging unrelated files; destructive cleanup stops                                                                                                                                                                                                           | `auto-resolve` / `boundary:destructive-change-risk`                             | Import preflight note                                                |
 | IMPORT-02        | `oat-project-import-plan`        | Missing project                               | Ask for project identity                                  | Use explicit invocation context; otherwise stop rather than guess                                                                                                                                                                                                            | `boundary:product-judgment`                                                     | Resolved project path                                                |
 | IMPORT-03        | `oat-project-import-plan`        | Source plan selection or extension exception  | Choose a candidate/path or confirm nonstandard Markdown   | Use an explicit unique source; ambiguity or nonstandard content stops                                                                                                                                                                                                        | `auto-resolve` / `boundary:product-judgment`                                    | Import reference metadata                                            |
@@ -169,6 +170,7 @@ remains.
 | IMPLEMENT-16     | `oat-project-implement`          | Final HiLL approval                           | Approve, decline, or defer between pre/post steps         | After passing auto-review and successful pre-approval steps, record approval and continue post-approval steps; otherwise stop                                                                                                                                                | `auto-resolve` / `boundary:unresolved-critical-findings`                        | Sequence snapshot, review artifact, dispatch record                  |
 | IMPLEMENT-17     | `oat-project-implement`          | Next-step prompt                              | Choose lifecycle tail actions                             | Unreachable when the autonomous sequence snapshot exists; never present the prompt                                                                                                                                                                                           | `auto-resolve`                                                                  | Completed sequence snapshot                                          |
 | IMPLEMENT-18     | `oat-project-implement`          | Configured exit gate                          | `block`, `prompt`, or `warn` after validated findings     | Apply configured failure semantics only to a validated, receive-eligible `blocked` envelope after durable receive; all operational, validation, correlation, malformed/contradictory-envelope, launch, and receive failures stop regardless of `onFailure`, including `warn` | `auto-resolve` / `boundary:repository-policy-approval`                          | Validated structured gate result, completed receive, and disposition |
+| IMPLEMENT-19     | `oat-project-implement`          | Implementation-tail project recap             | Generate or skip the final project recap                  | In autonomy attempt one recap when no fresh recap exists; preserve resolved interactive intent otherwise, and never block completion on recap outcome                                                                                                                        | `auto-resolve`                                                                  | Recap manifest and outcome record                                    |
 | DOCUMENT-01      | `oat-project-document`           | Missing project path                          | Ask for a path                                            | Use explicit/active project only; otherwise stop                                                                                                                                                                                                                             | `boundary:product-judgment`                                                     | Resolved project path                                                |
 | DOCUMENT-02      | `oat-project-document`           | Documentation delta approval                  | Apply all, individual, or skip                            | Invoke the existing `--auto` path and apply all non-destructive recommendations                                                                                                                                                                                              | `auto-resolve`                                                                  | Documentation delta and state update                                 |
 | DOCUMENT-03      | `oat-project-document`           | Delete or restructure docs                    | Require explicit approval                                 | Stop before destructive or broad restructuring not already authorized by the plan                                                                                                                                                                                            | `boundary:destructive-change-risk`                                              | Documentation blocker                                                |
@@ -256,7 +258,9 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-dispatch-subagents/references/provider-cursor.md`         | `ca11e28923eb -> NG`; `be0a84c48fc0 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | `oat-dispatch-subagents/references/record-schema.md`           | `78f8069274a8 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | `oat-project-dispatch-subagents/SKILL.md`                      | `eca03ad1ca12 -> PDISPATCH-01`; `59fbcdc79cea -> PDISPATCH-01`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `oat-project-complete/SKILL.md`                                | `b4934a85feee -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `oat-project-plan/SKILL.md`                                    | `f99e44b39932 -> PLAN-12`; `7e6a9854504b -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `oat-project-implement/references/completion-and-closeout.md`  | `6909a5a5a1fa -> IMPLEMENT-19`; `a7c02ef670fd -> IMPLEMENT-19`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `oat-project-complete/SKILL.md`                                | `ffad9f909dba -> COMPLETE-01`; `ffe636f736e8 -> COMPLETE-01`; `ea2dced337be -> COMPLETE-01`; `93d3e4ee3355 -> COMPLETE-01`; `2407ebed0921 -> NG`; `0177956707aa -> NG`; `8305b5bb65ef -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 ## Prompt-scan comparison

package/assets/skills/oat-project-summary/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-project-summary
-version: 1.3.3
+version: 1.3.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.
 disable-model-invocation: false
 user-invocable: true
@@ -229,6 +229,23 @@ For each section, synthesize content from the relevant artifacts. Apply these ru
 | Associated Issues              | state.md `associated_issues` field                                     |
 | Workflow Observations          | project-log.md via `oat project log rollup` only                       |
 | Autonomous Execution Learnings | oat-execution-learnings.md dated entries                               |
+| Explainer Outcome              | project-recap `manifest.json` and `build-record.json`                  |
+**Explainer Outcome (conditional):**
+When a project-recap attempt exists, render this section:
+```markdown
+## Explainer Outcome
+- **project-recap:** {outcome} — `{run path}`{optional warning or recovery note}
+```
+When a project-recap attempt exists, include exactly one concise outcome item with its recipe, outcome (`built-durable`, `built-not-durable`, or `failed`), run path, and warning or recovery note when applicable.
+Use `manifest.json` and `build-record.json` as the source of truth; refresh the existing item instead of appending a duplicate.
+Omit `Explainer Outcome` when no project-recap attempt exists. A failed or non-durable recap remains visible as its product outcome; do not reinterpret it as project implementation failure.
 **Autonomous Execution Learnings (conditional):**
@@ -466,3 +483,5 @@ Summary tracks: last task {task_id}, {N} revision phases
   ledger graduation
 - 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
 - When the PJM tool pack is not installed, decision promotion is skipped silently with no prompt
+- A project-recap attempt appears once in a concise Explainer Outcome section
+  sourced from its manifest and build record

package/assets/templates/state.md CHANGED Viewed

@@ -40,7 +40,10 @@ oat_workflow_origin: native # native | imported
 #   max_attempts: 2
 #   attempts_completed: 0
 #   reviewed_head: null
-#   implementation_fingerprint: null
+#   implementation_base_ref: null # exact logical base ref for effective-delta-v1
+#   implementation_fingerprint: null # new generations use sha256:effective-delta-v1:<digest>
+#   freshness_head: null # rolling accepted tree checkpoint
+#   freshness_fingerprint: null # full effective delta at freshness_head
 #   launch_state: not_started # not_started | intent_persisted | accepted | result_persisted | not_accepted
 #   launch_attempt_id: null
 #   launch_started_at: null

package/dist/commands/config/index.d.ts.map CHANGED Viewed

	@@ -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,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;~~AA6kED~~,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAsKT"}
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;AAmGpC,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;AA61ED,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAsKT"}