@open-agent-toolkit/cli 0.2.29 → 0.2.31

package/assets/templates/project-retro.md

@@ -0,0 +1,236 @@
+---
+oat_retro_project: null
+oat_retro_generated: null
+oat_retro_evidence_sources:
+  - source: project-log
+    status: unavailable
+  - source: oat-execution-learnings
+    status: unavailable
+  - source: lifecycle-artifacts
+    status: unavailable
+  - source: session-transcript
+    status: unavailable
+oat_retro_promotions: none
+oat_retro_filing: none
+oat_generated: false
+oat_template: true
+oat_template_name: project-retro
+---
+
+# Project Retrospective: {Project Name}
+
+<!-- Rendered artifacts must replace oat_retro_project with a non-null project
+     slug and oat_retro_generated with a UTC YYYY-MM-DDTHH:MM:SSZ timestamp,
+     set oat_template: false, and remove oat_template_name. Record every
+     inspected evidence source above with status: used | unavailable. When an
+     evidence family is partial, split it into truthful source entries, such as
+     archived-review-markdown: unavailable and gate-receipts: used. Do not add
+     a `partial` evidence status. Derivative current-run reconnaissance
+     transcripts are not original project-run evidence. Remove all
+     brace-delimited placeholders and scaffold RP/UP item examples. -->
+
+<!-- Keep output concise by default. Every section must add distinct
+     information. Prefer references to evidence over repeated chronology. For
+     a small project, keep core sections brief. Use subsections and tables only
+     for evidence-rich projects where they improve decisions. Make each
+     material incident understandable without opening another artifact. Use
+     stable evidence anchors such as project-log event IDs, artifact headings,
+     review paths, decision IDs, and commit IDs. Anchors supplement but never
+     replace explanation. -->
+
+## Executive Summary
+
+{Summarize how the run went, the most important outcome, and what should change next.}
+
+## Evidence and Review Method
+
+{List the durable project artifacts and session/run evidence reviewed. State
+unavailable sources explicitly. Distinguish confirmed causes, hypotheses, and
+inconclusive mechanisms.}
+
+## Outcome Snapshot
+
+{Summarize delivered scope, verification, lifecycle outcome, and material
+boundaries in a concise table or list.}
+
+## Current State
+
+<!-- This is the only mutable freeform status surface. Derive it from register
+     fields and frontmatter rollups after generation and after every apply/file
+     writeback. Consumers may replace only the contents of this section, not
+     this heading or any other narrative. Keep it concise and include
+     promotions, filing, and unsettled-item state. -->
+
+- **Promotions:** {Current promotion rollup and item state.}
+- **Filing:** {Current filing rollup and item state.}
+- **Unsettled items:** {Current IDs and next actions, or `None`.}
+
+## What Went Well
+
+{Describe successful technical and workflow practices, grounded in evidence.}
+
+## Challenges and Struggles
+
+{Own the complete incident narrative here: what happened, impact, response, and
+result. Describe blockers, failed approaches, and orchestration friction.
+Classify rather than blame.}
+
+<!-- CONDITIONAL: Include both sections below when load-bearing decisions or
+     rejected/superseded alternatives shaped the outcome. Otherwise delete
+     both headings and their placeholders. -->
+
+## Decision Register
+
+{Record decisions, rationale, consequences, and existing durable records.
+Identify any justified missing decision records.}
+
+## Rejected or Superseded Alternatives
+
+{Record alternatives that materially shaped the outcome and why they were
+rejected or superseded.}
+
+## Where We Changed Course
+
+{Record only the trigger, changed direction, and outcome. Do not repeat the
+complete incident chronology from Challenges and Struggles.}
+
+<!-- CONDITIONAL: Include when the project introduced reusable architecture
+     patterns or materially new approaches. Otherwise delete this section. -->
+
+## New Architecture Patterns and Approaches
+
+{Describe reusable patterns, their boundaries, and why they worked.}
+
+<!-- CONDITIONAL: Include when the run produced project-domain knowledge worth
+     preserving. Rename subsections for the domain as needed. Otherwise delete
+     this section. -->
+
+## Domain Learnings
+
+{Abstract reusable lessons without replaying chronology. Capture domain failure
+classes and correct responses.}
+
+<!-- CONDITIONAL: Include when the evidence supports actionable guidance for
+     humans. Otherwise delete this section. -->
+
+## Gotchas for Humans
+
+{Write future-facing instructions rather than incident summaries. List concrete
+operator or contributor gotchas.}
+
+<!-- CONDITIONAL: Include when the evidence supports actionable guidance for
+     autonomous agents. Otherwise delete this section. -->
+
+## Gotchas for Autonomous Agents
+
+{Write future-facing instructions rather than incident summaries. List concrete
+execution, evidence, monitoring, and escalation gotchas.}
+
+## Repo Improvements (Promotion Register)
+
+<!-- Stable IDs: RP-NN. Type defaults: docs, agents-instruction, rule, and
+     decision default to Disposition: apply; code-follow-up defaults to
+     Disposition: file. The recorded Disposition is authoritative.
+
+     Apply item fields:
+       Status: proposed | approved | applied | rejected
+       Target: repository path
+       Applied-ref: commit/path after application
+       Disposition-note: rejection, recovery, or outcome detail
+
+     File item fields:
+       Status: proposed | filed | rejected | no-destination
+       Destination: issue URL or backlog item ID/path
+       Destination-receipt: full commit SHA for a local backlog destination
+       Remote-visibility: pushed | unpushed for a local backlog destination
+       Disposition-note: rejection, recovery, or outcome detail
+
+     Schema by destination type:
+       Local backlog + filed: Destination-receipt is a verified full commit SHA
+         and Remote-visibility is pushed | unpushed.
+       GitHub + filed: Destination is a validated issue URL,
+         Destination-receipt: —, and Remote-visibility: —.
+       Unsettled local or GitHub item: receipt fields remain —.
+
+     Consumers may mutate only Status, Applied-ref or Destination, and
+     Destination-receipt, Remote-visibility, Sanitized, Disposition-note, plus
+     the corresponding frontmatter rollup and Current State contents. IDs,
+     Type, Disposition, titles, proposal bodies, and all other narrative are
+     stable. -->
+
+### RP-01: {Actionable repo improvement}
+
+- **Type:** docs
+- **Disposition:** apply
+- **Status:** proposed
+- **Target:** {repository path}
+- **Applied-ref:** —
+- **Disposition-note:** —
+
+{Rationale, evidence summary, and concrete proposed change.}
+
+### RP-02: {Tracker-ready repo follow-up}
+
+- **Type:** code-follow-up
+- **Disposition:** file
+- **Status:** proposed
+- **Destination:** —
+- **Destination-receipt:** —
+- **Remote-visibility:** —
+- **Sanitized:** no
+- **Disposition-note:** —
+
+{Problem, evidence summary, and suggested direction.}
+
+## OAT Upstream Feedback (Upstream Register)
+
+<!-- Stable IDs: UP-NN. Status: proposed | filed | rejected | no-destination.
+     Destination records the issue URL or backlog item ID/path. Sanitized
+     records whether the public-destination verification passed. Consumers may
+     mutate only Status, Destination, Destination-receipt, Remote-visibility,
+     Sanitized, Disposition-note, the filing rollup, and Current State
+     contents. IDs, titles, proposal bodies, and all other narrative are
+     stable. Local filed items require a verified full commit receipt and
+     pushed | unpushed visibility. GitHub filed items require a validated URL
+     with Destination-receipt: — and Remote-visibility: —. -->
+
+No upstream feedback identified.
+
+<!-- Replace the empty-state line above with items in this form:
+
+### UP-01: {Tracker-ready upstream feedback}
+
+- **Status:** proposed
+- **Destination:** —
+- **Destination-receipt:** —
+- **Remote-visibility:** —
+- **Sanitized:** no
+- **Disposition-note:** —
+
+{Problem, evidence summary, and suggested direction.}
+-->
+
+<!-- Rollup derivation:
+     oat_retro_promotions derives only from RP items with Disposition: apply.
+       `none`: no apply items exist.
+       `proposed`: apply items exist and none are settled.
+       `partial`: a mix of settled and unsettled apply items exists.
+       `complete`: all apply items are settled.
+       `proposed` and `approved` are unsettled; `applied` and `rejected` are settled.
+     oat_retro_filing derives from all UP items plus RP items with
+     Disposition: file.
+     Each rollup is none | proposed | partial | complete and must be
+     computable from register fields alone. -->
+
+<!-- CONDITIONAL: Include when unresolved work or explicit ownership boundaries
+     remain. Otherwise delete this section. -->
+
+## Remaining Boundaries and Follow-Ups
+
+{Record unresolved boundaries, owners, and next steps without disguising them
+as completed work.}
+
+## Reflections
+
+{End with run-specific reflections about what the project taught, what made the
+result trustworthy, and what future work should do differently.}

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;AAmBzC,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;AAE1C,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC3B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoGpC,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;AA46ED,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;AAmBzC,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;AAE1C,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC3B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyGpC,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;AAgiFD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAsKT"}

package/dist/commands/config/index.js

@@ -46,6 +46,7 @@ const KEY_ORDER = [
     'explainers.publish.s3Uri',
     'explainers.publish.publicBaseUrl',
     'explainers.publish.awsRegion',
+    'explainers.publish.publicAccess',
     'explainers.publish.awsProfile',
     'git.defaultBranch',
     'projects.root',
@@ -62,6 +63,10 @@ const KEY_ORDER = [
     'workflow.archiveOnComplete',
     'workflow.createPrOnComplete',
     'workflow.postImplementSequence',
+    'workflow.retro.filing.repo',
+    'workflow.retro.filing.upstream',
+    'workflow.retro.apply',
+    'workflow.retro.upstreamRepo',
     'workflow.reviewExecutionModel',
     'workflow.autoReviewAtHillCheckpoints',
     'workflow.autoNarrowReReviewScope',
@@ -412,6 +417,17 @@ const CONFIG_CATALOG = [
         owningCommand: 'oat config set explainers.publish.awsRegion <region> --shared',
         description: 'AWS region used for explainer publishing.',
     },
+    {
+        key: 'explainers.publish.publicAccess',
+        group: 'Explainer Publish (shared)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 'public | protected',
+        defaultValue: 'public',
+        mutability: 'read/write',
+        owningCommand: 'oat config set explainers.publish.publicAccess <public|protected> --shared',
+        description: 'Declares whether published explainer URLs support anonymous access; it does not authorize publication.',
+    },
     {
         key: 'explainers.publish.awsProfile',
         group: 'Explainer Publish Credentials (local > user)',
@@ -544,6 +560,50 @@ const CONFIG_CATALOG = [
         owningCommand: "oat config set workflow.postImplementSequence '<legacy-or-json>'",
         description: 'Default post-implementation chaining. Legacy strings remain supported unchanged. Structured JSON uses {"preApproval":[...],"postApproval":[...]} with the canonical sequence steps. Plain get/list/dump output serializes structured values as compact JSON; get --json preserves the object value. When unset, the skill prompts. Resolution: local > shared > user > default.',
     },
+    {
+        key: 'workflow.retro.filing.repo',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'issues | backlog | none',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.retro.filing.repo <issues|backlog|none>',
+        description: 'Default filing destination for host-repository retro items. Resolution: local > shared > user > default.',
+    },
+    {
+        key: 'workflow.retro.filing.upstream',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'issues | none',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.retro.filing.upstream <issues|none>',
+        description: 'Default filing destination for upstream retro items. Resolution: local > shared > user > default.',
+    },
+    {
+        key: 'workflow.retro.apply',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'auto | ask',
+        defaultValue: 'ask',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.retro.apply <auto|ask>',
+        description: 'Controls whether non-interactive retro runs apply approved repo promotions automatically or remain propose-only. Resolution: local > shared > user > default.',
+    },
+    {
+        key: 'workflow.retro.upstreamRepo',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'owner/name repository slug',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.retro.upstreamRepo <owner/name>',
+        description: 'Repository that receives upstream retro feedback; the workflow skill supplies its ecosystem default. Resolution: local > shared > user > default.',
+    },
     {
         key: 'workflow.reviewExecutionModel',
         group: 'Workflow Preferences (3-layer: local > shared > user)',
@@ -884,6 +944,12 @@ function parseExplainerValue(key, rawValue, surface) {
         }
         return value.replace(/\/+$/, '');
     }
+    if (key === 'explainers.publish.publicAccess') {
+        if (value !== 'public' && value !== 'protected') {
+            throw new Error(`Invalid value for ${key}: expected 'public' or 'protected', got '${rawValue}'.`);
+        }
+        return value;
+    }
     return value;
 }
 const WORKFLOW_ENUM_VALUES = {
@@ -909,6 +975,9 @@ const WORKFLOW_ENUM_VALUES = {
     ],
     'workflow.explainers.projectExplainer': ['always', 'ask', 'never'],
     'workflow.explainers.projectRecap': ['always', 'ask', 'never'],
+    'workflow.retro.filing.repo': ['issues', 'backlog', 'none'],
+    'workflow.retro.filing.upstream': ['issues', 'none'],
+    'workflow.retro.apply': ['auto', 'ask'],
 };
 function closedDispatchProviderValues(provider) {
     if (provider === 'codex') {
@@ -1059,6 +1128,13 @@ function parseWorkflowValue(key, rawValue) {
             return sequence;
         }
     }
+    if (key === 'workflow.retro.upstreamRepo') {
+        const normalized = rawValue.trim();
+        if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(normalized)) {
+            throw new Error(`Invalid value for ${key}: expected an owner/name repository slug, got '${rawValue}'`);
+        }
+        return normalized;
+    }
     if (key === 'workflow.gateTimeouts.code' ||
         key === 'workflow.gateTimeouts.artifact') {
         const value = Number(rawValue);
@@ -1293,6 +1369,29 @@ function applyWorkflowValue(workflow, key, value) {
             },
         };
     }
+    if (subKey.startsWith('retro.filing.')) {
+        const filingKey = subKey.slice('retro.filing.'.length);
+        return {
+            ...workflow,
+            retro: {
+                ...workflow.retro,
+                filing: {
+                    ...workflow.retro?.filing,
+                    [filingKey]: value,
+                },
+            },
+        };
+    }
+    if (subKey.startsWith('retro.')) {
+        const retroKey = subKey.slice('retro.'.length);
+        return {
+            ...workflow,
+            retro: {
+                ...workflow.retro,
+                [retroKey]: value,
+            },
+        };
+    }
     return {
         ...workflow,
         [subKey]: value,

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

@@ -11,9 +11,9 @@ 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-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_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-retro', 'oat-project-retro-file', '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_TEMPLATES: readonly ['state.md', 'discovery.md', 'spec.md', 'design.md', 'plan.md', 'implementation.md', 'summary.md', 'project-log.md', 'project-retro.md'];
 export declare const WORKFLOW_SCRIPTS: readonly ['generate-oat-state.sh', 'generate-thin-index.sh', 'resolve-tracking.sh'];
 export declare const IDEA_SKILLS: readonly ['oat-idea-new', 'oat-idea-ideate', 'oat-idea-summarize', 'oat-idea-scratchpad'];
 export declare const CORE_SKILLS: readonly ['oat-docs', 'oat-doctor'];

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,YAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,oBAAoB,EACpB,gCAAgC,EAChC,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,iCAAiC,EACjC,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,4BAA4B,EAC5B,mCAAmC,EACnC,4BAA4B,EAC5B,mCAAmC,EACnC,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,CACL,CAAC;AAEX,eAAO,MAAM,eAAe,YAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,iBAAiB,CACT,CAAC;AAEX,eAAO,MAAM,kBAAkB,YAC7B,UAAU,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,CACR,CAAC;AAEX,eAAO,MAAM,gBAAgB,YAC3B,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,CACb,CAAC;AAIX,eAAO,MAAM,WAAW,YACtB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,CACb,CAAC;AAIX,eAAO,MAAM,WAAW,YAAI,UAAU,EAAE,YAAY,CAAU,CAAC;AAI/D,eAAO,MAAM,WAAW,YACtB,gBAAgB,EAChB,gCAAgC,EAChC,8BAA8B,EAC9B,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,CACZ,CAAC;AAEX,eAAO,MAAM,YAAY,YAAI,qBAAqB,CAAU,CAAC;AAI7D,eAAO,MAAM,cAAc,YACzB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,iCAAiC,EACjC,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EACpB,2BAA2B,CACnB,CAAC;AAIX,eAAO,MAAM,yBAAyB,YACpC,0BAA0B,EAC1B,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,CAChB,CAAC;AAEX,eAAO,MAAM,4BAA4B,YACvC,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,qBAAqB,CACb,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,YAAI,gBAAgB,CAAU,CAAC;AAI7D,eAAO,MAAM,eAAe,YAC1B,SAAS,EACT,SAAS,EACT,eAAe,EACf,SAAS,EACT,YAAY,CACJ,CAAC;AAEX,eAAO,MAAM,eAAe,YAAI,wBAAwB,CAAU,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,YAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,oBAAoB,EACpB,gCAAgC,EAChC,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,iCAAiC,EACjC,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,mCAAmC,EACnC,4BAA4B,EAC5B,mCAAmC,EACnC,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,CACL,CAAC;AAEX,eAAO,MAAM,eAAe,YAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,iBAAiB,CACT,CAAC;AAEX,eAAO,MAAM,kBAAkB,YAC7B,UAAU,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,CACV,CAAC;AAEX,eAAO,MAAM,gBAAgB,YAC3B,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,CACb,CAAC;AAIX,eAAO,MAAM,WAAW,YACtB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,CACb,CAAC;AAIX,eAAO,MAAM,WAAW,YAAI,UAAU,EAAE,YAAY,CAAU,CAAC;AAI/D,eAAO,MAAM,WAAW,YACtB,gBAAgB,EAChB,gCAAgC,EAChC,8BAA8B,EAC9B,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,CACZ,CAAC;AAEX,eAAO,MAAM,YAAY,YAAI,qBAAqB,CAAU,CAAC;AAI7D,eAAO,MAAM,cAAc,YACzB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,iCAAiC,EACjC,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EACpB,2BAA2B,CACnB,CAAC;AAIX,eAAO,MAAM,yBAAyB,YACpC,0BAA0B,EAC1B,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,CAChB,CAAC;AAEX,eAAO,MAAM,4BAA4B,YACvC,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,qBAAqB,CACb,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,YAAI,gBAAgB,CAAU,CAAC;AAI7D,eAAO,MAAM,eAAe,YAC1B,SAAS,EACT,SAAS,EACT,eAAe,EACf,SAAS,EACT,YAAY,CACJ,CAAC;AAEX,eAAO,MAAM,eAAe,YAAI,wBAAwB,CAAU,CAAC"}

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

@@ -39,6 +39,8 @@ export const WORKFLOW_SKILLS = [
     'oat-project-promote-spec-driven',
     'oat-project-quick-start',
     'oat-project-reconcile',
+    'oat-project-retro',
+    'oat-project-retro-file',
     'oat-project-revise',
     'oat-project-review-provide',
     'oat-project-review-provide-remote',
@@ -68,6 +70,7 @@ export const WORKFLOW_TEMPLATES = [
     'implementation.md',
     'summary.md',
     'project-log.md',
+    'project-retro.md',
 ];
 export const WORKFLOW_SCRIPTS = [
     'generate-oat-state.sh',

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":"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"}
+{"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/archive-utils.ts"],"names":[],"mappings":"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"}

package/dist/commands/project/archive/archive-utils.js

@@ -7,6 +7,7 @@ import { CliError } from '../../../errors/cli-error.js';
 import { copyDirectory, copySingleFile, dirExists, ensureDir, fileExists, } from '../../../fs/io.js';
 import { loadExplainerPackageCoverage } from './explainer-package-coverage.js';
 import { loadExplainerSourceBacklinks, } from './explainer-source-backlinks.js';
+import { loadExplainerTerminalEvidence } from './explainer-terminal-evidence.js';
 const execFileAsync = promisify(execFileCallback);
 export const ARCHIVE_SNAPSHOT_METADATA_FILENAME = '.oat-archive-source.json';
 /**
@@ -564,6 +565,25 @@ async function readVerifiedRunMode(runRoot) {
     }
     return request.mode;
 }
+async function verifyProjectRecapTerminalEvidence(runRoot, manifest, expected) {
+    if (!['built-needs-review', 'failed'].includes(manifest.outcome)) {
+        return null;
+    }
+    try {
+        const terminalEvidence = await loadExplainerTerminalEvidence();
+        const verified = await terminalEvidence.readTerminalEvidenceFile(runRoot, {
+            manifest,
+            ...(expected && {
+                expectedBytes: expected.bytes,
+                expectedHash: expected.hash,
+            }),
+        });
+        return { bytes: verified.bytes, hash: verified.hash };
+    }
+    catch {
+        throw new CliError('Selected project recap requires valid confined terminal evidence before archival.');
+    }
+}
 async function loadVerifiedProjectRecap(projectPath, projectRecapRun) {
     const sourceRunRoot = await resolveSelectedProjectRecapRun(projectPath, projectRecapRun);
     const manifestContents = await readFile(join(sourceRunRoot, 'manifest.json'), 'utf8');
@@ -571,9 +591,6 @@ async function loadVerifiedProjectRecap(projectPath, projectRecapRun) {
     if (manifest.recipe.id !== 'project-recap') {
         throw new CliError('Selected project recap manifest recipe must be exactly `project-recap`.');
     }
-    if (manifest.outcome === 'built-needs-review') {
-        throw new CliError('Selected project recap is built-needs-review and requires a passing visual review before archival.');
-    }
     const verifiedArtifactCount = await verifyProjectRecapImmutableHashes(sourceRunRoot, manifest);
     const runMode = await readVerifiedRunMode(sourceRunRoot);
     const packageCoverage = await loadExplainerPackageCoverage();
@@ -605,11 +622,29 @@ async function loadVerifiedProjectRecap(projectPath, projectRecapRun) {
         artifact.hash !== manifest.immutableHashes[artifact.renderedPath])) {
         throw new CliError('Selected project recap artifact hashes do not match the immutable package.');
     }
+    const terminalEvidence = await verifyProjectRecapTerminalEvidence(sourceRunRoot, manifest);
+    const exactCoverage = packageCoverage;
+    if (typeof exactCoverage.permissibleRunPackagePaths !== 'function' ||
+        typeof exactCoverage.enforceRunPackageInventory !== 'function') {
+        throw new CliError('Bundled explainer package coverage does not provide the exact run inventory.');
+    }
+    try {
+        await exactCoverage.enforceRunPackageInventory(sourceRunRoot, manifest, {
+            includeTerminalEvidence: terminalEvidence !== null,
+        });
+    }
+    catch {
+        throw new CliError('Selected project recap package inventory is invalid.');
+    }
     return {
         sourceRunRoot,
         manifestContents,
         manifest,
         verifiedArtifactCount,
+        terminalEvidence,
+        packagePaths: exactCoverage.permissibleRunPackagePaths(manifest, {
+            includeTerminalEvidence: terminalEvidence !== null,
+        }),
     };
 }
 export async function verifySelectedProjectRecapForArchive(projectPath, projectRecapRun) {
@@ -621,25 +656,40 @@ async function exportSelectedProjectRecap(options, snapshotName, dependencies) {
         return null;
     }
     const verified = await loadVerifiedProjectRecap(options.projectPath, selectedRun);
-    const { sourceRunRoot, manifestContents: sourceManifestContents, manifest: sourceManifest, } = verified;
+    const { sourceRunRoot, manifestContents: sourceManifestContents, terminalEvidence: sourceTerminalEvidence, packagePaths, } = verified;
     const exportRoot = join(options.repoRoot, '.oat', 'repo', 'reference', 'project-recaps', snapshotName);
     if (await pathExists(exportRoot)) {
         throw new CliError(`Project recap export destination \`${exportRoot}\` already exists; refusing to overwrite it.`);
     }
     const temporaryRoot = `${exportRoot}.tmp-${randomUUID()}`;
     const makeDir = dependencies.ensureDir ?? ensureDir;
-    const copyProjectDirectory = dependencies.copyDirectory ?? copyDirectory;
+    const copyFile = dependencies.copySingleFile ?? copySingleFile;
     const removePath = dependencies.removePath ??
         (async (target, removeOptions) => rm(target, removeOptions));
     const renamePath = dependencies.renamePath ?? rename;
     await makeDir(dirname(exportRoot));
     try {
-        await copyProjectDirectory(sourceRunRoot, temporaryRoot);
+        for (const relativePath of packagePaths) {
+            const destination = join(temporaryRoot, relativePath);
+            await makeDir(dirname(destination));
+            await copyFile(join(sourceRunRoot, relativePath), destination);
+        }
         const stagedManifestContents = await readFile(join(temporaryRoot, 'manifest.json'), 'utf8');
         if (stagedManifestContents !== sourceManifestContents) {
             throw new CliError('Selected project recap manifest changed while staging the export.');
         }
-        const verifiedArtifactCount = await verifyProjectRecapImmutableHashes(temporaryRoot, sourceManifest);
+        const stagedManifest = await parseProjectRecapManifest(stagedManifestContents);
+        const verifiedArtifactCount = await verifyProjectRecapImmutableHashes(temporaryRoot, stagedManifest);
+        const stagedTerminalEvidence = await verifyProjectRecapTerminalEvidence(temporaryRoot, stagedManifest, sourceTerminalEvidence ?? undefined);
+        const exactCoverage = (await loadExplainerPackageCoverage());
+        try {
+            await exactCoverage.enforceRunPackageInventory(temporaryRoot, stagedManifest, {
+                includeTerminalEvidence: stagedTerminalEvidence !== null,
+            });
+        }
+        catch {
+            throw new CliError('Staged project recap package inventory is invalid.');
+        }
         await renamePath(temporaryRoot, exportRoot);
         return {
             sourceRunRoot,

package/dist/commands/project/archive/explainer-terminal-evidence.d.ts

@@ -0,0 +1,29 @@
+declare const TERMINAL_EVIDENCE_VERSION = "explainer-kit.terminal-evidence/v1";
+export interface ExplainerTerminalEvidence {
+    TERMINAL_EVIDENCE_VERSION: typeof TERMINAL_EVIDENCE_VERSION;
+    assertTerminalEvidence: (evidence: unknown, context: {
+        manifest: unknown;
+    }) => unknown;
+    readTerminalEvidenceFile: (runRoot: string, context: {
+        manifest: unknown;
+        expectedBytes?: Uint8Array;
+        expectedHash?: string;
+    }) => Promise<{
+        evidence: unknown;
+        bytes: Buffer;
+        hash: string;
+    }>;
+    writeTerminalEvidence: (run: {
+        runId: string;
+        slug: string;
+        runRoot: string;
+    }, input: {
+        outcome: string;
+        manifest: unknown;
+        reasons: unknown[];
+        evidenceDisposition: string;
+    }) => Promise<string>;
+}
+export declare function loadExplainerTerminalEvidence(): Promise<ExplainerTerminalEvidence>;
+export {};
+//# sourceMappingURL=explainer-terminal-evidence.d.ts.map

package/dist/commands/project/archive/explainer-terminal-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainer-terminal-evidence.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/explainer-terminal-evidence.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,yBAAyB,uCAAuC,CAAC;AAEvE,MAAM,WAAW,yBAAyB;IACxC,yBAAyB,EAAE,OAAO,yBAAyB,CAAC;IAC5D,sBAAsB,EAAE,CACtB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,KAC3B,OAAO,CAAC;IACb,wBAAwB,EAAE,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,CAAC,EAAE,UAAU,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,KACE,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,qBAAqB,EAAE,CACrB,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACrD,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,CAAC;QACnB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,KACE,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAID,wBAAgB,6BAA6B,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAGlF"}

package/dist/commands/project/archive/explainer-terminal-evidence.js

@@ -0,0 +1,37 @@
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { CliError } from '../../../errors/cli-error.js';
+import { resolveAssetsRoot } from '../../../fs/assets.js';
+const TERMINAL_EVIDENCE_VERSION = 'explainer-kit.terminal-evidence/v1';
+let cachedTerminalEvidence;
+export function loadExplainerTerminalEvidence() {
+    cachedTerminalEvidence ??= loadGeneratedTerminalEvidence();
+    return cachedTerminalEvidence;
+}
+async function loadGeneratedTerminalEvidence() {
+    const assetsRoot = await resolveAssetsRoot();
+    const skillRoot = join(assetsRoot, 'skills', 'explainer-kit');
+    let contract;
+    let records;
+    try {
+        [contract, records] = await Promise.all([
+            import(pathToFileURL(join(skillRoot, 'scripts', 'lib', 'terminal-evidence.mjs')).href),
+            import(pathToFileURL(join(skillRoot, 'scripts', 'lib', 'records.mjs')).href),
+        ]);
+    }
+    catch {
+        throw new CliError('Bundled explainer terminal evidence could not be loaded.', 2);
+    }
+    if (contract.TERMINAL_EVIDENCE_VERSION !== TERMINAL_EVIDENCE_VERSION ||
+        typeof contract.assertTerminalEvidence !== 'function' ||
+        typeof contract.readTerminalEvidenceFile !== 'function' ||
+        typeof records.writeTerminalEvidence !== 'function') {
+        throw new CliError(`Bundled assets must provide ${TERMINAL_EVIDENCE_VERSION} validation and writing.`, 2);
+    }
+    return {
+        TERMINAL_EVIDENCE_VERSION,
+        assertTerminalEvidence: contract.assertTerminalEvidence,
+        readTerminalEvidenceFile: contract.readTerminalEvidenceFile,
+        writeTerminalEvidence: records.writeTerminalEvidence,
+    };
+}