@open-agent-toolkit/cli 0.1.5 → 0.1.7

package/assets/skills/oat-project-split/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: oat-project-split
+version: 1.0.0
+description: Use when a discovery or brainstorm should split one broad scope into coordinated OAT child projects.
+argument-hint: '--plan-file <path>'
+disable-model-invocation: true
+user-invocable: true
+allowed-tools: Read, Write, Bash(oat:*), Bash(pnpm:*), Glob, Grep, AskUserQuestion
+---
+
+# Split OAT Project
+
+Decompose a confirmed multi-project discovery or brainstorm into a coordination-only parent and flat child projects.
+
+## Mode Assertion
+
+Use this skill only after one of these split triggers is present:
+
+- The user explicitly declared the work is multiple projects.
+- Discovery signals crossed the split threshold and the user confirmed.
+- End-of-discovery convergence confirmed that the scope should split.
+- The brainstorm destination picker selected a split into projects.
+
+Detected split recommendations in non-interactive mode must fail fast through the CLI run command; do not silently split or silently continue as one project.
+
+## Progress Indicators (User-Facing)
+
+Print a banner once at start:
+
+```text
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+OAT ▸ PROJECT SPLIT
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Before multi-step work, print step indicators:
+
+- `[1/5] Writing coordination parent...`
+- `[2/5] Scaffolding and seeding children...`
+- `[3/5] Marking parent terminal...`
+- `[4/5] Selecting active child...`
+- `[5/5] Refreshing dashboard...`
+
+## Process
+
+### Step 1: Resolve Split Plan
+
+Require a persisted `SplitPlanDocument` JSON file. If `$ARGUMENTS` does not include `--plan-file <path>`, ask for the plan file path before proceeding.
+
+### Step 2: Run Split Orchestrator
+
+Invoke the CLI as the single execution entry point:
+
+```bash
+oat project split run --plan-file "{plan-file}"
+```
+
+Use `--non-interactive` only when the caller is running without a human confirmation path.
+
+### Step 3: Write Coordination Parent
+
+The run command writes the parent project as `oat_kind: coordination`, persists `references/split-plan.json`, records ordered children in `state.md`, writes the broad `discovery.md` with any integration sketch, and removes executable phase files.
+
+### Step 4: Scaffold + Seed Children
+
+The run command scaffolds each child in plan order and writes split-specific child discovery content from scratch with the required inherited-context revalidation gate.
+
+### Step 5: Mark Parent Terminal + Select Active Child
+
+The run command marks the parent `oat_phase: decomposition` and `oat_phase_status: complete`, then activates the initial child using the repo-relative project path.
+
+### Step 6: Resume From Partial State
+
+If a previous split wrote a coordination parent but did not finish all children, the run command resumes from `references/split-plan.json`. Do not reconstruct missing child seed data from slugs alone.
+
+## Success Criteria
+
+- Coordination parent exists and has no `spec.md`, `design.md`, `plan.md`, or `implementation.md`.
+- Parent `state.md` records `oat_kind: coordination`, ordered `oat_children`, and terminal decomposition status.
+- `references/split-plan.json` contains the full `SplitPlanDocument`.
+- Every child has seeded discovery content, parent/sibling/dependency links, and `oat_inherited_context_revalidated: false`.
+- `.oat/config.local.json.activeProject` points at the repo-relative initial child path.

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

@@ -1,6 +1,6 @@
 ---
 name: oat-project-summary
-version: 1.1.1
+version: 1.1.2
 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
@@ -149,6 +149,8 @@ For each section, synthesize content from the relevant artifacts. Apply these ru
 
 **Grounding rule:** Prefer implementation.md outcomes over design.md plans. If the implementation diverged from the design, reflect what actually happened.
 
+**Design delta rule:** Populate `Design Deltas` from both direct implementation deviations and review-received design drift decisions recorded in `implementation.md`. A review finding may decide that shipped implementation is defensible and the artifact is stale; when `implementation.md` records that acceptance, carry it forward as a design delta with the rationale and follow-up artifact disposition.
+
 **Section omission rule:** If a section would have no meaningful content, omit it entirely (remove the heading). Do not leave empty sections or "N/A" placeholders.
 
 **Conciseness constraint (NFR3):** Target under 200 lines total. If a draft exceeds this, trim narrative sections (What Was Implemented, Notable Challenges) to essential points. Revision History entries: 2-3 sentences per round max.
@@ -157,18 +159,18 @@ For each section, synthesize content from the relevant artifacts. Apply these ru
 
 **Section sources:**
 
-| Section              | Primary Sources                                             |
-| -------------------- | ----------------------------------------------------------- |
-| Overview             | discovery.md initial request, spec.md problem statement     |
-| What Was Implemented | implementation.md task outcomes, plan.md phase structure    |
-| Key Decisions        | design.md decisions, implementation.md notes/decisions      |
-| Design Deltas        | implementation.md deviations table                          |
-| Notable Challenges   | implementation.md issues/blockers in task notes             |
-| Tradeoffs Made       | implementation.md decisions, design.md tradeoff sections    |
-| Integration Notes    | implementation.md notes about cross-cutting concerns        |
-| Revision History     | plan.md p-revN phases, implementation.md revision notes     |
-| Follow-up Items      | implementation.md deferred findings, plan.md deferred items |
-| Associated Issues    | state.md `associated_issues` field                          |
+| Section              | Primary Sources                                                        |
+| -------------------- | ---------------------------------------------------------------------- |
+| Overview             | discovery.md initial request, spec.md problem statement                |
+| What Was Implemented | implementation.md task outcomes, plan.md phase structure               |
+| Key Decisions        | design.md decisions, implementation.md notes/decisions                 |
+| Design Deltas        | implementation.md deviations table; review-received design drift notes |
+| Notable Challenges   | implementation.md issues/blockers in task notes                        |
+| Tradeoffs Made       | implementation.md decisions, design.md tradeoff sections               |
+| Integration Notes    | implementation.md notes about cross-cutting concerns                   |
+| Revision History     | plan.md p-revN phases, implementation.md revision notes                |
+| Follow-up Items      | implementation.md deferred findings, plan.md deferred items            |
+| Associated Issues    | state.md `associated_issues` field                                     |
 
 **For incremental updates (re-run):**
 

package/assets/templates/implementation.md

@@ -165,13 +165,13 @@ Chronological log of implementation progress.
 
 ---
 
-## Deviations from Plan
+## Deviations from Plan / Design
 
-Document any deviations from the original plan.
+Document any intentional deviations from the original plan, spec, or design. Include accepted review findings where the shipped implementation is source of truth and a lifecycle artifact needs alignment.
 
-| Task | Planned | Actual | Reason |
-| ---- | ------- | ------ | ------ |
-| -    | -       | -      | -      |
+| Task / Review | Source Artifact | Planned / Documented | Actual / Accepted | Reason | Source of Truth | Follow-up |
+| ------------- | --------------- | -------------------- | ----------------- | ------ | --------------- | --------- |
+| -             | -               | -                    | -                 | -      | -               | -         |
 
 ## Test Results
 

package/assets/templates/state.md

@@ -3,10 +3,15 @@ oat_current_task: null
 oat_last_commit: null
 oat_blockers: []
 associated_issues: [] # [{type: backlog|project|jira|linear, ref: "identifier"}]
+oat_kind: implementation # implementation | coordination; coordination parents may use oat_phase: decomposition
+oat_parent: null # optional child-only coordination parent slug
+oat_siblings: [] # optional child-only sibling slugs
+oat_depends_on: [] # optional child-only sibling dependencies
+oat_children: [] # optional coordination-parent child slugs
 oat_hill_checkpoints: { OAT_HILL_CHECKPOINTS } # Configured: which phases require human-in-the-loop lifecycle approval
 oat_hill_completed: [] # Progress: which HiLL checkpoints have been completed
 oat_parallel_execution: false
-oat_phase: { OAT_PHASE } # Current phase: discovery | spec | design | plan | implement
+oat_phase: { OAT_PHASE } # Current phase: discovery | spec | design | plan | implement | decomposition
 oat_phase_status: in_progress # Status: in_progress | complete | pr_open
 # oat_orchestration_retry_limit: 2  # optional; override fix-loop retry limit (range 0-5)
 oat_workflow_mode: { OAT_WORKFLOW_MODE } # spec-driven | quick | import

package/assets/templates/summary.md

@@ -37,7 +37,8 @@ where decisions were made or changed during implementation.}
 <!-- Omit this section if there were no deviations from the original design. -->
 
 {Where the final result diverged from the original design and why.
-Pull from implementation.md deviations table.}
+Pull from implementation.md deviations table and review-received design drift notes.
+Include accepted cases where shipped implementation became source of truth and a stale lifecycle artifact needs alignment or was explicitly deferred.}
 
 ## Notable Challenges
 

package/dist/__tests__/skills/split-flow-fixtures.d.ts

@@ -0,0 +1,50 @@
+import { type SplitChildInput, type SplitPayload, type SplitPlanDocument } from '../../projects/split/child-plan.js';
+import { type Signal } from '../../projects/split/signals.js';
+export type TranscriptSpeaker = 'assistant' | 'user';
+export interface TranscriptTurn {
+    speaker: TranscriptSpeaker;
+    text: string;
+}
+export type StubbedUserChoice = 'broad-first' | 'children-known' | 'decompose-children' | 'inline-only' | 'keep-one-project' | 'promote-n-projects' | 'split-now';
+export interface StubbedQuestion {
+    id: string;
+    prompt: string;
+    options: string[];
+    response: StubbedUserChoice;
+}
+export interface TranscriptFixture {
+    transcript: TranscriptTurn[];
+    parentSlug: string;
+    children: SplitChildInput[];
+    discoveryPath?: string;
+    inheritedContext?: string;
+    integrationSketch?: string;
+}
+export declare const SPLIT_HANDOFF_TARGET: {
+    readonly skill: "oat-project-split";
+    readonly hookCreatesProjects: false;
+    readonly responsibilities: readonly ["normalize-split-plan", "write-coordination-parent", "scaffold-children", "activate-initial-child"];
+};
+export declare function inferSplitSignals(transcript: TranscriptTurn[]): Signal[];
+export declare function runDiscoverDetectionFixture(fixture: TranscriptFixture, responses: Record<string, StubbedUserChoice>): {
+    asked: StubbedQuestion[];
+    confidence: 'below' | 'high' | 'soft';
+    decision?: StubbedUserChoice;
+    document?: SplitPlanDocument;
+    payload?: SplitPayload;
+    triggered: boolean;
+};
+export declare function runDeclaredBrainstormFixture(fixture: TranscriptFixture, responses: Record<string, StubbedUserChoice>): {
+    asked: StubbedQuestion[];
+    document?: SplitPlanDocument;
+    handoffTarget: typeof SPLIT_HANDOFF_TARGET;
+    payload?: SplitPayload;
+};
+export declare function runBrainstormPickerFixture(fixture: TranscriptFixture, responses: Record<string, StubbedUserChoice>): {
+    asked: StubbedQuestion[];
+    document?: SplitPlanDocument;
+    handoffTarget: typeof SPLIT_HANDOFF_TARGET;
+    options: string[];
+    payload?: SplitPayload;
+};
+//# sourceMappingURL=split-flow-fixtures.d.ts.map

package/dist/__tests__/skills/split-flow-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-flow-fixtures.d.ts","sourceRoot":"","sources":["../../../src/__tests__/skills/split-flow-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAmB,KAAK,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,gBAAgB,GAChB,oBAAoB,GACpB,aAAa,GACb,kBAAkB,GAClB,oBAAoB,GACpB,WAAW,CAAC;AAEhB,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,oBAAoB;;;;CASvB,CAAC;AAsBX,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CA+BxE;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC3C;IACD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB,CAqDA;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC3C;IACD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,aAAa,EAAE,OAAO,oBAAoB,CAAC;IAC3C,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,CAmCA;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC3C;IACD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,aAAa,EAAE,OAAO,oBAAoB,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,CA4CA"}

package/dist/__tests__/skills/split-flow-fixtures.js

@@ -0,0 +1,161 @@
+import { buildSplitPlanDocument, } from '../../projects/split/child-plan.js';
+import { evaluateSignals } from '../../projects/split/signals.js';
+export const SPLIT_HANDOFF_TARGET = {
+    skill: 'oat-project-split',
+    hookCreatesProjects: false,
+    responsibilities: [
+        'normalize-split-plan',
+        'write-coordination-parent',
+        'scaffold-children',
+        'activate-initial-child',
+    ],
+};
+class AskUserQuestionStub {
+    responses;
+    asked = [];
+    constructor(responses) {
+        this.responses = responses;
+    }
+    ask(id, prompt, options) {
+        const response = this.responses[id];
+        if (!response) {
+            throw new Error(`Missing stubbed response for AskUserQuestion ${id}`);
+        }
+        this.asked.push({ id, prompt, options, response });
+        return response;
+    }
+}
+function transcriptText(transcript) {
+    return transcript.map((turn) => `${turn.speaker}: ${turn.text}`).join('\n');
+}
+export function inferSplitSignals(transcript) {
+    const text = transcriptText(transcript).toLowerCase();
+    const signals = new Set();
+    if (text.includes('independently shippable') ||
+        text.includes('ship independently')) {
+        signals.add('independently-shippable');
+    }
+    if (text.includes('no shared design surface') ||
+        text.includes('separate design surfaces')) {
+        signals.add('no-shared-design-surface');
+    }
+    if (text.includes('separate pr') || text.includes('separate pull request')) {
+        signals.add('expect-separate-prs');
+    }
+    if (text.includes('distinct subsystem') ||
+        text.includes('different package') ||
+        text.includes('different packages')) {
+        signals.add('distinct-subsystems');
+    }
+    return [...signals];
+}
+export function runDiscoverDetectionFixture(fixture, responses) {
+    const evaluation = evaluateSignals({
+        fired: inferSplitSignals(fixture.transcript),
+    });
+    const askUser = new AskUserQuestionStub(responses);
+    if (!evaluation.triggered) {
+        return {
+            asked: askUser.asked,
+            confidence: evaluation.confidence,
+            triggered: false,
+        };
+    }
+    const prompt = evaluation.confidence === 'high'
+        ? 'This looks like multiple independent projects. Split now, do one round of broad cross-cutting discovery first, or keep this as one project?'
+        : 'This may be multiple projects. Split, do one round of broad cross-cutting discovery first, or keep it as one project?';
+    const decision = askUser.ask('discover-split-offer', prompt, [
+        'split-now',
+        'broad-first',
+        'keep-one-project',
+    ]);
+    if (decision !== 'split-now') {
+        return {
+            asked: askUser.asked,
+            confidence: evaluation.confidence,
+            decision,
+            triggered: true,
+        };
+    }
+    const payload = {
+        origin: 'detected-mid-stream',
+        interactive: true,
+        inferredChildren: fixture.children,
+        priorDiscovery: {
+            path: fixture.discoveryPath ?? `.oat/projects/shared/${fixture.parentSlug}`,
+            inheritedContext: fixture.inheritedContext,
+            integrationSketch: fixture.integrationSketch,
+        },
+    };
+    return {
+        asked: askUser.asked,
+        confidence: evaluation.confidence,
+        decision,
+        document: buildSplitPlanDocument(payload),
+        payload,
+        triggered: true,
+    };
+}
+export function runDeclaredBrainstormFixture(fixture, responses) {
+    const text = transcriptText(fixture.transcript).toLowerCase();
+    const declared = text.includes('multiple projects') ||
+        text.includes('umbrella project') ||
+        text.includes('several sub-projects');
+    if (!declared) {
+        return { asked: [], handoffTarget: SPLIT_HANDOFF_TARGET };
+    }
+    const askUser = new AskUserQuestionStub(responses);
+    const decision = askUser.ask('declared-brainstorm-boundary', 'Do you already know the child projects, or should we decompose the scope together?', ['children-known', 'decompose-children']);
+    if (decision !== 'children-known') {
+        return { asked: askUser.asked, handoffTarget: SPLIT_HANDOFF_TARGET };
+    }
+    const payload = {
+        origin: 'declared',
+        parentSlug: fixture.parentSlug,
+        declaredChildren: fixture.children,
+        interactive: true,
+        integrationSketch: fixture.integrationSketch,
+    };
+    return {
+        asked: askUser.asked,
+        document: buildSplitPlanDocument(payload),
+        handoffTarget: SPLIT_HANDOFF_TARGET,
+        payload,
+    };
+}
+export function runBrainstormPickerFixture(fixture, responses) {
+    const evaluation = evaluateSignals({
+        fired: inferSplitSignals(fixture.transcript),
+    });
+    const options = ['inline-only', 'doc-to-path', 'promote-to-new-oat-project'];
+    if (evaluation.triggered) {
+        options.push('promote-n-projects');
+    }
+    const askUser = new AskUserQuestionStub(responses);
+    const decision = askUser.ask('brainstorm-terminal-state', 'Where should this brainstorm land?', options);
+    if (decision !== 'promote-n-projects' || !evaluation.triggered) {
+        return {
+            asked: askUser.asked,
+            handoffTarget: SPLIT_HANDOFF_TARGET,
+            options,
+        };
+    }
+    const payload = {
+        origin: 'brainstorm-picker',
+        parentSlug: fixture.parentSlug,
+        inferredChildren: fixture.children,
+        interactive: true,
+        priorDiscovery: {
+            path: `brainstorm/${fixture.parentSlug}`,
+            inheritedContext: fixture.inheritedContext,
+            integrationSketch: fixture.integrationSketch,
+        },
+    };
+    return {
+        asked: askUser.asked,
+        document: buildSplitPlanDocument(payload),
+        handoffTarget: SPLIT_HANDOFF_TARGET,
+        options,
+        payload,
+    };
+}

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-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "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-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
+export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "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-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-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"];
 export declare const WORKFLOW_SCRIPTS: readonly ["generate-oat-state.sh", "generate-thin-index.sh", "resolve-tracking.sh"];

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,muBA8BlB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,yIAMd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,gJAMjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4CAG/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,wvBA+BlB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,yIAMd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,gJAMjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4CAG/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

@@ -40,6 +40,7 @@ export const WORKFLOW_SKILLS = [
     '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',

package/dist/commands/project/complete-discovery/index.d.ts

@@ -0,0 +1,16 @@
+import { readFile as defaultReadFile, writeFile as defaultWriteFile } from 'node:fs/promises';
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { dirExists, fileExists } from '../../../fs/io.js';
+import { Command } from 'commander';
+interface ProjectCompleteDiscoveryDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    readFile: typeof defaultReadFile;
+    writeFile: typeof defaultWriteFile;
+    dirExists: typeof dirExists;
+    fileExists: typeof fileExists;
+    now: () => Date;
+}
+export declare function createProjectCompleteDiscoveryCommand(overrides?: Partial<ProjectCompleteDiscoveryDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/project/complete-discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/complete-discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,eAAe,EAC3B,SAAS,IAAI,gBAAgB,EAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,UAAU,oCAAoC;IAC5C,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAkJD,wBAAgB,qCAAqC,CACnD,SAAS,GAAE,OAAO,CAAC,oCAAoC,CAAM,GAC5D,OAAO,CA+BT"}

package/dist/commands/project/complete-discovery/index.js

@@ -0,0 +1,123 @@
+import { readFile as defaultReadFile, writeFile as defaultWriteFile, } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { buildCommandContext, } from '../../../app/command-context.js';
+import { getFrontmatterBlock } from '../../shared/frontmatter.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { CliError } from '../../../errors/cli-error.js';
+import { dirExists, fileExists } from '../../../fs/io.js';
+import { resolveProjectRoot } from '../../../fs/paths.js';
+import { assertValidProjectStateFilesystemContent } from '../../../validation/project-state.js';
+import { Command } from 'commander';
+import YAML from 'yaml';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    readFile: defaultReadFile,
+    writeFile: defaultWriteFile,
+    dirExists,
+    fileExists,
+    now: () => new Date(),
+};
+function resolveTargetProjectPath(repoRoot, projectPath) {
+    return isAbsolute(projectPath) ? projectPath : join(repoRoot, projectPath);
+}
+function parseFrontmatterObject(content, filePath) {
+    const frontmatter = getFrontmatterBlock(content);
+    if (!frontmatter) {
+        throw new CliError(`${filePath} is missing frontmatter`, 1);
+    }
+    const parsed = YAML.parse(frontmatter);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new CliError(`${filePath} frontmatter must be a YAML object`, 1);
+    }
+    return parsed;
+}
+function renderDiscoveryComplete(content, filePath, options) {
+    const frontmatter = parseFrontmatterObject(content, filePath);
+    frontmatter['oat_status'] = 'complete';
+    frontmatter['oat_ready_for'] = options.readyFor;
+    frontmatter['oat_last_updated'] = options.today;
+    const renderedFrontmatter = YAML.stringify(frontmatter).trimEnd();
+    return content.replace(/^---\n[\s\S]*?\n---/, `---\n${renderedFrontmatter}\n---`);
+}
+function renderFrontmatterDocument(frontmatter) {
+    return `---\n${YAML.stringify(frontmatter).trimEnd()}\n---\n`;
+}
+async function buildDiscoveryValidationContent(content, options) {
+    const discoveryFrontmatter = parseFrontmatterObject(content, options.discoveryPath);
+    const statePath = join(options.projectPath, 'state.md');
+    if (!(await options.dependencies.fileExists(statePath))) {
+        return content;
+    }
+    const stateContent = await options.dependencies.readFile(statePath, 'utf8');
+    const stateFrontmatter = parseFrontmatterObject(stateContent, statePath);
+    return renderFrontmatterDocument({
+        ...stateFrontmatter,
+        ...discoveryFrontmatter,
+    });
+}
+async function runProjectCompleteDiscovery(projectPath, options, context, dependencies) {
+    try {
+        const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+        const targetProjectPath = resolveTargetProjectPath(repoRoot, projectPath);
+        if (!(await dependencies.dirExists(targetProjectPath))) {
+            throw new CliError(`Project not found: ${projectPath}`, 1);
+        }
+        const discoveryPath = join(targetProjectPath, 'discovery.md');
+        if (!(await dependencies.fileExists(discoveryPath))) {
+            throw new CliError(`Project discovery.md not found: ${discoveryPath}`, 1);
+        }
+        const now = dependencies.now();
+        const content = await dependencies.readFile(discoveryPath, 'utf8');
+        const updatedContent = renderDiscoveryComplete(content, discoveryPath, {
+            readyFor: options.readyFor ?? 'oat-project-design',
+            today: now.toISOString().slice(0, 10),
+        });
+        const validationContent = await buildDiscoveryValidationContent(updatedContent, {
+            discoveryPath,
+            projectPath: targetProjectPath,
+            dependencies,
+        });
+        await assertValidProjectStateFilesystemContent(validationContent, {
+            filePath: discoveryPath,
+            projectPath: targetProjectPath,
+        });
+        await dependencies.writeFile(discoveryPath, updatedContent, 'utf8');
+        if (context.json) {
+            context.logger.json({
+                status: 'ok',
+                projectPath,
+                discoveryPath,
+                readyFor: options.readyFor ?? 'oat-project-design',
+            });
+        }
+        else {
+            context.logger.info(`Completed project discovery: ${projectPath}`);
+        }
+        process.exitCode = 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (context.json) {
+            context.logger.json({ status: 'error', message });
+        }
+        else {
+            context.logger.error(message);
+        }
+        process.exitCode = error instanceof CliError ? error.exitCode : 1;
+    }
+}
+export function createProjectCompleteDiscoveryCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('complete-discovery')
+        .description('Validate and mark a project discovery.md complete')
+        .argument('<project-path>', 'Project path to update')
+        .option('--ready-for <skill>', 'Value to write to discovery.md oat_ready_for', 'oat-project-design')
+        .action(async (projectPath, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runProjectCompleteDiscovery(projectPath, options, context, dependencies);
+    });
+}

package/dist/commands/project/complete-state/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/complete-state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,eAAe,EAC3B,SAAS,IAAI,gBAAgB,EAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,UAAU,gCAAgC;IACxC,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,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAsED,wBAAgB,iCAAiC,CAC/C,SAAS,GAAE,OAAO,CAAC,gCAAgC,CAAM,GACxD,OAAO,CA2BT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/complete-state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,eAAe,EAC3B,SAAS,IAAI,gBAAgB,EAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,UAAU,gCAAgC;IACxC,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,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AA0ED,wBAAgB,iCAAiC,CAC/C,SAAS,GAAE,OAAO,CAAC,gCAAgC,CAAM,GACxD,OAAO,CA2BT"}

package/dist/commands/project/complete-state/index.js

@@ -5,6 +5,7 @@ import { readGlobalOptions } from '../../shared/shared.utils.js';
 import { CliError } from '../../../errors/cli-error.js';
 import { dirExists, fileExists } from '../../../fs/io.js';
 import { resolveProjectRoot } from '../../../fs/paths.js';
+import { assertValidProjectStateFilesystemContent } from '../../../validation/project-state.js';
 import { Command } from 'commander';
 import { renderCompletedProjectState } from './state-utils.js';
 const DEFAULT_DEPENDENCIES = {
@@ -37,6 +38,10 @@ async function runProjectCompleteState(projectPath, options, context, dependenci
             nowUtc: now.toISOString(),
             today: now.toISOString().slice(0, 10),
         });
+        await assertValidProjectStateFilesystemContent(updatedContent, {
+            filePath: statePath,
+            projectPath: targetProjectPath,
+        });
         await dependencies.writeFile(statePath, updatedContent, 'utf8');
         if (context.json) {
             context.logger.json({

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,oBAAoB,IAAI,OAAO,CAY9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,wBAAgB,oBAAoB,IAAI,OAAO,CAc9C"}

package/dist/commands/project/index.js

@@ -1,23 +1,27 @@
 import { Command } from 'commander';
 import { createProjectArchiveCommand } from './archive/index.js';
+import { createProjectCompleteDiscoveryCommand } from './complete-discovery/index.js';
 import { createProjectCompleteStateCommand } from './complete-state/index.js';
 import { createProjectListCommand } from './list.js';
 import { createProjectNewCommand } from './new/index.js';
 import { createProjectOpenCommand } from './open/index.js';
 import { createProjectPauseCommand } from './pause/index.js';
 import { createProjectSetModeCommand } from './set-mode/index.js';
+import { createProjectSplitCommand } from './split/index.js';
 import { createProjectStatusCommand } from './status.js';
 import { createProjectValidatePlanCommand } from './validate-plan/index.js';
 export function createProjectCommand() {
     return new Command('project')
         .description('Manage OAT project workflows')
         .addCommand(createProjectArchiveCommand())
+        .addCommand(createProjectCompleteDiscoveryCommand())
         .addCommand(createProjectCompleteStateCommand())
         .addCommand(createProjectListCommand())
         .addCommand(createProjectNewCommand())
         .addCommand(createProjectOpenCommand())
         .addCommand(createProjectPauseCommand())
         .addCommand(createProjectSetModeCommand())
+        .addCommand(createProjectSplitCommand())
         .addCommand(createProjectStatusCommand())
         .addCommand(createProjectValidatePlanCommand());
 }

package/dist/commands/project/list.d.ts

@@ -6,8 +6,14 @@ interface ProjectListDependencies {
     resolveProjectRoot: (cwd: string) => Promise<string>;
     resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
     listProjects: (projectsRoot: string) => Promise<ProjectSummary[]>;
+    readProjectMetadata: (projectPath: string) => Promise<ProjectListMetadata>;
     processEnv: NodeJS.ProcessEnv;
 }
+interface ProjectListMetadata {
+    kind: string;
+    phase: string;
+    phaseStatus: string;
+}
 export declare function createProjectListCommand(overrides?: Partial<ProjectListDependencies>): Command;
 export {};
 //# sourceMappingURL=list.d.ts.map