@open-agent-toolkit/cli 0.2.5 → 0.2.7

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

@@ -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

@@ -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

@@ -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/skills/oat-wave-execute/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-wave-execute
-version: 1.6.1
+version: 1.6.2
 description: Use when executing a wave of external implementation plans as a wrapper OAT project — scaffolding, drift refresh, parallel worktree groups, briefs, gates, merge choreography, and closeout.
 argument-hint: '<wave-id> [plan-names...] (e.g. wave-2 http-listener-before-indexing ...)'
 disable-model-invocation: false

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

@@ -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"}
+{"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"}

package/dist/commands/config/index.js

@@ -1,5 +1,5 @@
 import { readFile as readFileDefault } from 'node:fs/promises';
-import { join } from 'node:path';
+import { isAbsolute, join } from 'node:path';
 import { buildCommandContext } from '../../app/command-context.js';
 import { resolveProjectsRoot } from '../shared/oat-paths.js';
 import { confirmAction, } from '../shared/shared.prompts.js';
@@ -37,6 +37,14 @@ const KEY_ORDER = [
     'documentation.tooling',
     'documentation.config',
     'documentation.requireForProjectCompletion',
+    'explainers.defaults.palette',
+    'explainers.defaults.visualProfile',
+    'explainers.defaults.themeBundlePath',
+    'explainers.publish.provider',
+    'explainers.publish.s3Uri',
+    'explainers.publish.publicBaseUrl',
+    'explainers.publish.awsRegion',
+    'explainers.publish.awsProfile',
     'git.defaultBranch',
     'projects.root',
     'tools.brainstorm',
@@ -65,6 +73,8 @@ const KEY_ORDER = [
     'workflow.dispatchCeiling.preset',
     'workflow.dispatchCeiling.providers.codex',
     'workflow.dispatchCeiling.providers.claude',
+    'workflow.explainers.projectExplainer',
+    'workflow.explainers.projectRecap',
     'workflow.gateTimeouts.code',
     'workflow.gateTimeouts.artifact',
     'worktrees.root',
@@ -312,6 +322,116 @@ const CONFIG_CATALOG = [
         owningCommand: 'oat tools install / oat tools update',
         description: 'Whether the workflows tool pack is installed.',
     },
+    {
+        key: 'explainers.defaults.palette',
+        group: 'Explainer Defaults (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'local, shared, or user',
+        type: 'non-empty string',
+        defaultValue: 'neutral',
+        mutability: 'read/write',
+        owningCommand: 'oat config set explainers.defaults.palette <value> [--local|--shared|--user]',
+        description: 'Named default color palette for explainer builds.',
+    },
+    {
+        key: 'explainers.defaults.visualProfile',
+        group: 'Explainer Defaults (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'local, shared, or user',
+        type: 'non-empty string',
+        defaultValue: 'clean',
+        mutability: 'read/write',
+        owningCommand: 'oat config set explainers.defaults.visualProfile <value> [--local|--shared|--user]',
+        description: 'Named default visual profile for explainer builds.',
+    },
+    {
+        key: 'explainers.defaults.themeBundlePath',
+        group: 'Explainer Defaults (local > shared)',
+        file: '.oat/config.local.json | .oat/config.json',
+        scope: 'local or shared',
+        type: 'path',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set explainers.defaults.themeBundlePath <path> [--local|--shared]',
+        description: 'Theme bundle path; shared values must be repository-relative and local values may be absolute.',
+    },
+    {
+        key: 'explainers.publish.provider',
+        group: 'Explainer Publish (shared)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 's3-static',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set explainers.publish.provider s3-static --shared',
+        description: 'Static publishing provider for explainer artifacts.',
+    },
+    {
+        key: 'explainers.publish.s3Uri',
+        group: 'Explainer Publish (shared)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 's3:// URI',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set explainers.publish.s3Uri <s3://bucket/prefix> --shared',
+        description: 'Shared S3 destination root for explainer publishing.',
+    },
+    {
+        key: 'explainers.publish.publicBaseUrl',
+        group: 'Explainer Publish (shared)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 'https:// URL',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set explainers.publish.publicBaseUrl <https://url> --shared',
+        description: 'Shared public URL root for published explainer artifacts.',
+    },
+    {
+        key: 'explainers.publish.awsRegion',
+        group: 'Explainer Publish (shared)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 'non-empty string',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set explainers.publish.awsRegion <region> --shared',
+        description: 'AWS region used for explainer publishing.',
+    },
+    {
+        key: 'explainers.publish.awsProfile',
+        group: 'Explainer Publish Credentials (local > user)',
+        file: '.oat/config.local.json | ~/.oat/config.json',
+        scope: 'local or user',
+        type: 'non-empty string',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set explainers.publish.awsProfile <profile> [--local|--user]',
+        description: 'Checkout- or user-specific AWS profile used for explainer publishing.',
+    },
+    {
+        key: 'workflow.explainers.projectExplainer',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'always | ask | never',
+        defaultValue: 'ask',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.explainers.projectExplainer <always|ask|never>',
+        description: 'Controls project-explainer lifecycle invocation.',
+    },
+    {
+        key: 'workflow.explainers.projectRecap',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'always | ask | never',
+        defaultValue: 'ask',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.explainers.projectRecap <always|ask|never>',
+        description: 'Controls project-recap lifecycle invocation.',
+    },
     {
         key: 'activeProject',
         group: 'Repo Local (.oat/config.local.json)',
@@ -709,6 +829,38 @@ function normalizeSharedRoot(value) {
     }
     return trimmed.replace(/\/+$/, '');
 }
+function parseExplainerValue(key, rawValue, surface) {
+    const value = rawValue.trim();
+    if (!value) {
+        throw new Error(`Invalid value for ${key}: value cannot be empty.`);
+    }
+    if (key === 'explainers.defaults.themeBundlePath') {
+        if (surface === 'shared' &&
+            (isAbsolute(value) || value === '..' || value.startsWith('../'))) {
+            throw new Error(`Invalid value for ${key}: shared theme bundle paths must be repository-relative.`);
+        }
+        return value;
+    }
+    if (key === 'explainers.publish.provider') {
+        if (value !== 's3-static') {
+            throw new Error(`Invalid value for ${key}: expected 's3-static', got '${rawValue}'.`);
+        }
+        return value;
+    }
+    if (key === 'explainers.publish.s3Uri') {
+        if (!/^s3:\/\/[^/\s]+(?:\/.*)?$/.test(value)) {
+            throw new Error(`Invalid value for ${key}: expected an s3:// URI, got '${rawValue}'.`);
+        }
+        return value.replace(/\/+$/, '');
+    }
+    if (key === 'explainers.publish.publicBaseUrl') {
+        if (!/^https:\/\/[^/\s]+(?:\/.*)?$/.test(value)) {
+            throw new Error(`Invalid value for ${key}: expected an https:// URL, got '${rawValue}'.`);
+        }
+        return value.replace(/\/+$/, '');
+    }
+    return value;
+}
 const WORKFLOW_ENUM_VALUES = {
     'workflow.hillCheckpointDefault': ['every', 'final'],
     'workflow.postImplementSequence': ['wait', 'summary', 'pr', 'docs-pr'],
@@ -730,6 +882,8 @@ const WORKFLOW_ENUM_VALUES = {
         'opus',
         'fable',
     ],
+    'workflow.explainers.projectExplainer': ['always', 'ask', 'never'],
+    'workflow.explainers.projectRecap': ['always', 'ask', 'never'],
 };
 function closedDispatchProviderValues(provider) {
     if (provider === 'codex') {
@@ -774,6 +928,20 @@ function validateSurfaceForKey(key, surface) {
         }
         return;
     }
+    if (key.startsWith('explainers.')) {
+        const allowed = key === 'explainers.defaults.palette' ||
+            key === 'explainers.defaults.visualProfile'
+            ? ['shared', 'local', 'user']
+            : key === 'explainers.defaults.themeBundlePath'
+                ? ['shared', 'local']
+                : key === 'explainers.publish.awsProfile'
+                    ? ['local', 'user']
+                    : ['shared'];
+        if (!allowed.includes(surface)) {
+            throw new Error(`Cannot set '${key}' at '${surface}' scope. Allowed scopes: ${allowed.join(', ')}.`);
+        }
+        return;
+    }
     if (isStructuralKey(key)) {
         if (surface !== 'shared') {
             throw new Error(`Cannot set structural key '${key}' at '${surface}' scope. Structural keys (projects.root, worktrees.root, git.*, documentation.*, archive.*, tools.*) can only be set at shared scope (.oat/config.json).`);
@@ -808,6 +976,12 @@ function defaultSurfaceForKey(key) {
     if (key === 'updateNotifications') {
         return 'user';
     }
+    if (key === 'explainers.defaults.palette' ||
+        key === 'explainers.defaults.visualProfile' ||
+        key === 'explainers.defaults.themeBundlePath' ||
+        key === 'explainers.publish.awsProfile') {
+        return 'local';
+    }
     if (isWorkflowKey(key) || isStateKey(key)) {
         return 'local';
     }
@@ -1082,6 +1256,16 @@ function applyWorkflowValue(workflow, key, value) {
             },
         };
     }
+    if (subKey.startsWith('explainers.')) {
+        const explainerKey = subKey.slice('explainers.'.length);
+        return {
+            ...workflow,
+            explainers: {
+                ...workflow.explainers,
+                [explainerKey]: value,
+            },
+        };
+    }
     return {
         ...workflow,
         [subKey]: value,
@@ -1248,6 +1432,53 @@ async function setConfigValue(repoRoot, userConfigDir, key, rawValue, surface, d
             source: 'user',
         };
     }
+    if (key.startsWith('explainers.')) {
+        const nextValue = parseExplainerValue(key, rawValue, effectiveSurface);
+        const section = key.startsWith('explainers.defaults.')
+            ? 'defaults'
+            : 'publish';
+        const field = key.slice(`explainers.${section}.`.length);
+        if (effectiveSurface === 'user') {
+            const userConfig = await dependencies.readUserConfig(userConfigDir);
+            await dependencies.writeUserConfig(userConfigDir, {
+                ...userConfig,
+                explainers: {
+                    ...userConfig.explainers,
+                    [section]: {
+                        ...userConfig.explainers?.[section],
+                        [field]: nextValue,
+                    },
+                },
+            });
+            return { key, value: nextValue, source: 'user' };
+        }
+        if (effectiveSurface === 'local') {
+            const localConfig = await dependencies.readOatLocalConfig(repoRoot);
+            await dependencies.writeOatLocalConfig(repoRoot, {
+                ...localConfig,
+                explainers: {
+                    ...localConfig.explainers,
+                    [section]: {
+                        ...localConfig.explainers?.[section],
+                        [field]: nextValue,
+                    },
+                },
+            });
+            return { key, value: nextValue, source: 'local' };
+        }
+        const sharedConfig = await dependencies.readOatConfig(repoRoot);
+        await dependencies.writeOatConfig(repoRoot, {
+            ...sharedConfig,
+            explainers: {
+                ...sharedConfig.explainers,
+                [section]: {
+                    ...sharedConfig.explainers?.[section],
+                    [field]: nextValue,
+                },
+            },
+        });
+        return { key, value: nextValue, source: 'shared' };
+    }
     const config = await dependencies.readOatConfig(repoRoot);
     if (key.startsWith('documentation.')) {
         const doc = { ...config.documentation };

package/dist/commands/init/tools/shared/skill-manifest.d.ts

@@ -11,7 +11,7 @@ export interface PackMetadata {
 }
 export declare const PACK_METADATA: Record<string, PackMetadata>;
 export declare function resolvePackDefaultScope(packName: string): 'user' | 'project';
-export declare const WORKFLOW_SKILLS: readonly ["oat-cursor-cloud-projects", "oat-project-autonomous", "oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-dispatch-subagents", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-provide-remote", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-split", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wave-execute", "oat-wave-program", "oat-wrap-up"];
+export declare const WORKFLOW_SKILLS: readonly ["oat-cursor-cloud-projects", "oat-explainer-kit", "oat-project-autonomous", "oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-dispatch-subagents", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-provide-remote", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-split", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wave-execute", "oat-wave-program", "oat-wrap-up"];
 export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-phase-implementer.md", "oat-reviewer.md"];
 export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md", "project-log.md"];
 export declare const WORKFLOW_SCRIPTS: readonly ["generate-oat-state.sh", "generate-thin-index.sh", "resolve-tracking.sh"];
@@ -19,7 +19,7 @@ export declare const IDEA_SKILLS: readonly ["oat-idea-new", "oat-idea-ideate", "
 export declare const CORE_SKILLS: readonly ["oat-docs", "oat-doctor"];
 export declare const DOCS_SKILLS: readonly ["authoring-docs", "oat-agent-instructions-analyze", "oat-agent-instructions-apply", "oat-docs-analyze", "oat-docs-apply", "oat-docs-authoring", "oat-docs-bootstrap"];
 export declare const DOCS_SCRIPTS: readonly ["resolve-tracking.sh"];
-export declare const UTILITY_SKILLS: readonly ["create-agnostic-skill", "oat-dispatch-subagents", "oat-repo-improve", "oat-repo-maintainability-review", "oat-review-provide", "oat-review-provide-remote", "oat-review-receive", "oat-review-receive-remote"];
+export declare const UTILITY_SKILLS: readonly ["create-agnostic-skill", "explainer-kit", "oat-dispatch-subagents", "oat-repo-improve", "oat-repo-maintainability-review", "oat-review-provide", "oat-review-provide-remote", "oat-review-receive", "oat-review-receive-remote"];
 export declare const PROJECT_MANAGEMENT_SKILLS: readonly ["oat-pjm-add-backlog-item", "oat-pjm-decision", "oat-pjm-update-repo-reference", "oat-pjm-review-backlog"];
 export declare const PROJECT_MANAGEMENT_TEMPLATES: readonly ["backlog-item.md", "roadmap.md", "current-state.md", "decision.md", "repo-agents.md", "pjm-agents.md", "reference-agents.md"];
 export declare const PROJECT_MANAGEMENT_SCRIPTS: readonly [];

package/dist/commands/init/tools/shared/skill-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKtD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,eAAO,MAAM,eAAe,85BAqClB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,+HASrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,iLAQd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,2NASjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,sHAK5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,yIAQ/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAI7D,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKtD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,eAAO,MAAM,eAAe,m7BAsClB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,+HASrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,iLAQd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,4OAUjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,sHAK5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,yIAQ/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAI7D,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}

package/dist/commands/init/tools/shared/skill-manifest.js

@@ -17,6 +17,7 @@ export function resolvePackDefaultScope(packName) {
 // ── Workflow pack ──────────────────────────────────────────────────
 export const WORKFLOW_SKILLS = [
     'oat-cursor-cloud-projects',
+    'oat-explainer-kit',
     'oat-project-autonomous',
     'oat-project-capture',
     'oat-project-clear-active',
@@ -96,6 +97,7 @@ export const DOCS_SCRIPTS = ['resolve-tracking.sh'];
 // ── Utility pack ───────────────────────────────────────────────────
 export const UTILITY_SKILLS = [
     'create-agnostic-skill',
+    'explainer-kit',
     'oat-dispatch-subagents',
     'oat-repo-improve',
     'oat-repo-maintainability-review',

package/dist/commands/project/archive/archive-utils.d.ts

@@ -1,3 +1,4 @@
+import { rename } from 'node:fs/promises';
 import { copyDirectory, copySingleFile, dirExists, ensureDir, fileExists } from '../../../fs/io.js';
 export type ExecFileResult = {
     stdout: string;
@@ -42,6 +43,7 @@ export interface ArchiveProjectOnCompletionOptions {
     s3Uri?: string | null;
     s3SyncOnComplete: boolean;
     summaryExportPath?: string | null;
+    projectRecapRun?: string | null;
     /**
      * Config-only AWS profile (`archive.awsProfile`). The completion path has no
      * flag override. When non-empty, this value clobbers any parent-env
@@ -88,12 +90,22 @@ interface ArchiveProjectOnCompletionDependencies extends EnsureS3ArchiveAccessDe
     }) => Promise<void>;
     copySingleFile?: typeof copySingleFile;
     fileExists?: typeof fileExists;
+    renamePath?: typeof rename;
     timestamp?: () => string;
 }
+export interface ArchiveProjectRecapExportV1 {
+    sourceRunRoot: string;
+    exportRoot: string;
+    manifest: {
+        relativePath: 'manifest.json';
+        verifiedArtifactCount: number;
+    };
+}
 export interface ArchiveProjectOnCompletionResult {
     archivePath: string;
     s3Path: string | null;
     summaryExportFile: string | null;
+    projectRecapExport: ArchiveProjectRecapExportV1 | null;
     warnings: string[];
 }
 export declare const ARCHIVE_SNAPSHOT_METADATA_FILENAME = ".oat-archive-source.json";

package/dist/commands/project/archive/archive-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/archive-utils.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EACT,SAAS,EACT,UAAU,EACX,MAAM,QAAQ,CAAC;AAIhB,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAChD,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,UAAU,iCAAiC;IACzC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,kCAAkC;IACjD,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uCAAwC,SAAQ,kCAAkC;IACjG,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,EAAE,OAAO,CAAC;IACjC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,UAAU,sCACR,SACE,iCAAiC,EACjC,kCAAkC;IACpC,qBAAqB,CAAC,EAAE,OAAO,qBAAqB,CAAC;IACrD,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,UAAU,CAAC,EAAE,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,SAAS,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,KACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,cAAc,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gCAAgC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,wBAAwB,UAAwB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,CAAC,UAAU,EAC5B,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9D,MAAM,CAAC,UAAU,CAgBnB;AA0BD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAmBD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CA4BA;AAED,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,MAAM,CAIR;AA2ID,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,kCAAuC,GACpD,OAAO,CAAC,MAAM,CAAC,CAMjB;AA2BD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kCAAkC,EAC3C,YAAY,GAAE,uCAA4C,GACzD,OAAO,CAAC,oBAAoB,CAAC,CA2D/B;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CAIN;AAgCD,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,iCAAiC,EAC1C,YAAY,GAAE,sCAA2C,GACxD,OAAO,CAAC,gCAAgC,CAAC,CAwG3C;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,EACrC,YAAY,GAAE,iCAAsC,GACnD,OAAO,CAAC,2BAA2B,CAAC,CA+CtC"}
+{"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/archive-utils.ts"],"names":[],"mappings":"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"}