@open-agent-toolkit/cli 0.1.4 → 0.1.6

package/dist/commands/project/split/evaluate-signals.js

@@ -0,0 +1,47 @@
+import { buildCommandContext, } from '../../../app/command-context.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { Command } from 'commander';
+import { evaluateSignals } from '../../../projects/split/signals.js';
+const SIGNALS = [
+    'independently-shippable',
+    'no-shared-design-surface',
+    'expect-separate-prs',
+    'distinct-subsystems',
+];
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+};
+function parseFiredSignals(value) {
+    if (value.trim().length === 0) {
+        return [];
+    }
+    const validSignals = new Set(SIGNALS);
+    return value.split(',').map((raw) => {
+        const signal = raw.trim();
+        if (!validSignals.has(signal)) {
+            throw new Error(`Invalid signal: ${signal}`);
+        }
+        return signal;
+    });
+}
+export function createEvaluateSignalsCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('evaluate-signals')
+        .description('Evaluate oat-project-split trigger signals')
+        .requiredOption('--fired <comma-list>', 'Comma-separated fired signals')
+        .action((options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        try {
+            context.logger.json(evaluateSignals({ fired: parseFiredSignals(options.fired) }));
+            process.exitCode = 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            context.logger.error(message);
+            process.exitCode = 1;
+        }
+    });
+}

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

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createProjectSplitCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/split/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,yBAAyB,IAAI,OAAO,CAMnD"}

package/dist/commands/project/split/index.js

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import { createEvaluateSignalsCommand } from './evaluate-signals.js';
+import { createProjectSplitRunCommand } from './run.js';
+import { createValidateSplitPlanCommand } from './validate-plan.js';
+export function createProjectSplitCommand() {
+    return new Command('split')
+        .description('Evaluate, validate, and run oat-project-split payloads')
+        .addCommand(createEvaluateSignalsCommand())
+        .addCommand(createValidateSplitPlanCommand())
+        .addCommand(createProjectSplitRunCommand());
+}

package/dist/commands/project/split/run.d.ts

@@ -0,0 +1,21 @@
+import { appendFile, readFile, readdir, stat } from 'node:fs/promises';
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { confirmAction } from '../../shared/shared.prompts.js';
+import { Command } from 'commander';
+interface RunSplitDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
+    readFile: typeof readFile;
+    readdir: typeof readdir;
+    stat: typeof stat;
+    appendFile: typeof appendFile;
+    refreshDashboard: (options: {
+        repoRoot: string;
+    }) => Promise<void>;
+    confirmAction: typeof confirmAction;
+    processEnv: NodeJS.ProcessEnv;
+}
+export declare function createProjectSplitRunCommand(overrides?: Partial<RunSplitDependencies>): Command;
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/project/split/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/split/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGvE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAKhE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,UAAU,oBAAoB;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,gBAAgB,EAAE,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAsLD,wBAAgB,4BAA4B,CAC1C,SAAS,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAC5C,OAAO,CAkJT"}

package/dist/commands/project/split/run.js

@@ -0,0 +1,231 @@
+import { appendFile, readFile, readdir, stat } from 'node:fs/promises';
+import { isAbsolute, join, relative } from 'node:path';
+import { buildCommandContext, } from '../../../app/command-context.js';
+import { resolveProjectsRoot } from '../../shared/oat-paths.js';
+import { confirmAction } from '../../shared/shared.prompts.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { generateStateDashboard } from '../../state/generate.js';
+import { readOatLocalConfig } from '../../../config/oat-config.js';
+import { resolveProjectRoot } from '../../../fs/paths.js';
+import { Command } from 'commander';
+import { validateSplitPlanDocumentShape } from '../../../projects/split/document-validation.js';
+import { finalizeSplit } from '../../../projects/split/finalize.js';
+import { continueSplitResume, detectPartialSplit, SplitResumeError, } from '../../../projects/split/resume.js';
+import { seedChildren } from '../../../projects/split/seed-children.js';
+import { validateChildPlan } from '../../../projects/split/validation.js';
+import { writeCoordinationParent } from '../../../projects/split/write-parent.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveProjectsRoot,
+    readFile,
+    readdir,
+    stat,
+    appendFile,
+    refreshDashboard: async (options) => {
+        await generateStateDashboard(options);
+    },
+    confirmAction,
+    processEnv: process.env,
+};
+async function exists(path, dependencies) {
+    try {
+        await dependencies.stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function existingProjectSlugs(repoRoot, projectsRoot, dependencies) {
+    const absoluteProjectsRoot = isAbsolute(projectsRoot)
+        ? projectsRoot
+        : join(repoRoot, projectsRoot);
+    try {
+        const entries = await dependencies.readdir(absoluteProjectsRoot, {
+            withFileTypes: true,
+        });
+        return new Set(entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name));
+    }
+    catch {
+        return new Set();
+    }
+}
+async function recordDetectedRecommendation(repoRoot, document, dependencies) {
+    const localConfig = await readOatLocalConfig(repoRoot);
+    if (!localConfig.activeProject) {
+        throw new Error('Cannot record detected split recommendation without an active project');
+    }
+    const discoveryPath = join(repoRoot, localConfig.activeProject, 'discovery.md');
+    await dependencies.appendFile(discoveryPath, [
+        '',
+        '## Detected Split Recommendation',
+        '',
+        `Origin: ${document.origin}`,
+        `Proposed parent: ${document.plan.parentSlug}`,
+        `Proposed children: ${document.plan.children
+            .map((child) => child.slug)
+            .join(', ')}`,
+        '',
+    ].join('\n'), 'utf8');
+}
+function isEffectivelyNonInteractive(options, context, processEnv) {
+    return (options.nonInteractive === true ||
+        context.interactive === false ||
+        processEnv.OAT_NON_INTERACTIVE === '1');
+}
+function formatResumePreview(partial) {
+    return [
+        'Recovered partial split plan:',
+        `Parent: ${partial.parentProjectPath}`,
+        `Children: ${partial.plan.children.map((child) => child.slug).join(', ')}`,
+        `Missing children: ${partial.missingChildren.length > 0 ? partial.missingChildren.join(', ') : 'none'}`,
+        `Dependencies: ${partial.plan.children
+            .map((child) => {
+            const dependencies = child.knownDependencies.length > 0
+                ? child.knownDependencies.join(', ')
+                : 'none';
+            return `${child.slug} -> ${dependencies}`;
+        })
+            .join('; ')}`,
+        `Active child: ${partial.plan.initialActiveChild}`,
+    ];
+}
+function isDetectedOrigin(document) {
+    return (document.origin === 'detected-mid-stream' ||
+        document.origin === 'detected-convergence');
+}
+function normalizeProjectPath(path) {
+    return path.split('\\').join('/');
+}
+function toRepoRelativeProjectPath(repoRoot, projectPath) {
+    const absoluteProjectPath = isAbsolute(projectPath)
+        ? projectPath
+        : join(repoRoot, projectPath);
+    return normalizeProjectPath(relative(repoRoot, absoluteProjectPath));
+}
+async function isActiveDetectedParentProject(repoRoot, parentPath, document) {
+    if (!isDetectedOrigin(document)) {
+        return false;
+    }
+    const localConfig = await readOatLocalConfig(repoRoot);
+    if (!localConfig.activeProject) {
+        return false;
+    }
+    return (toRepoRelativeProjectPath(repoRoot, localConfig.activeProject) ===
+        toRepoRelativeProjectPath(repoRoot, parentPath));
+}
+async function runFreshSplit(document, repoRoot, projectsRoot, dependencies, options = {}) {
+    const slugs = await existingProjectSlugs(repoRoot, projectsRoot, dependencies);
+    if (options.allowExistingParent) {
+        slugs.delete(document.plan.parentSlug);
+    }
+    const validation = validateChildPlan(document.plan, slugs);
+    if (!validation.ok) {
+        throw new Error(`Split plan validation failed: ${validation.errors
+            .map((error) => error.message)
+            .join('; ')}`);
+    }
+    await writeCoordinationParent(document, { repoRoot, projectsRoot });
+    await seedChildren(document.plan, { repoRoot, projectsRoot });
+    await finalizeSplit(document.plan, { repoRoot, projectsRoot });
+}
+export function createProjectSplitRunCommand(overrides = {}) {
+    const dependencies = { ...DEFAULT_DEPENDENCIES, ...overrides };
+    return new Command('run')
+        .description('Run an oat-project-split SplitPlanDocument end to end')
+        .requiredOption('--plan-file <path>', 'Path to split-plan.json')
+        .option('--non-interactive', 'Fail fast for detected split origins instead of writing projects')
+        .option('--resume', 'Confirm resuming an existing partial split without prompting')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        try {
+            const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+            const projectsRoot = await dependencies.resolveProjectsRoot(repoRoot, dependencies.processEnv);
+            const raw = await dependencies.readFile(options.planFile, 'utf8');
+            const parsed = JSON.parse(raw);
+            const documentShape = validateSplitPlanDocumentShape(parsed);
+            if (!documentShape.ok) {
+                throw new Error(`Invalid SplitPlanDocument: ${documentShape.errors
+                    .map((error) => error.message)
+                    .join('; ')}`);
+            }
+            const document = documentShape.document;
+            if (isEffectivelyNonInteractive(options, context, dependencies.processEnv) &&
+                (document.origin === 'detected-mid-stream' ||
+                    document.origin === 'detected-convergence')) {
+                await recordDetectedRecommendation(repoRoot, document, dependencies);
+                context.logger.error('Detected split requires interactive confirmation; recommendation recorded.');
+                process.exitCode = 1;
+                return;
+            }
+            const parentPath = join(projectsRoot, document.plan.parentSlug)
+                .split('\\')
+                .join('/');
+            const absoluteParentPath = isAbsolute(parentPath)
+                ? parentPath
+                : join(repoRoot, parentPath);
+            if (await exists(absoluteParentPath, dependencies)) {
+                let partial = null;
+                let convertActiveDetectedParent = false;
+                try {
+                    partial = await detectPartialSplit(parentPath, {
+                        repoRoot,
+                        projectsRoot,
+                    });
+                }
+                catch (error) {
+                    if (error instanceof SplitResumeError &&
+                        error.message === 'Split resume requires a coordination parent' &&
+                        (await isActiveDetectedParentProject(repoRoot, parentPath, document))) {
+                        convertActiveDetectedParent = true;
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                if (convertActiveDetectedParent) {
+                    await runFreshSplit(document, repoRoot, projectsRoot, dependencies, {
+                        allowExistingParent: true,
+                    });
+                    await dependencies.refreshDashboard({ repoRoot });
+                    context.logger.info('Split completed.');
+                    process.exitCode = 0;
+                    return;
+                }
+                if (!partial) {
+                    throw new SplitResumeError('Cannot resume split without recovered partial state.');
+                }
+                for (const line of formatResumePreview(partial)) {
+                    context.logger.info(line);
+                }
+                const effectiveNonInteractive = isEffectivelyNonInteractive(options, context, dependencies.processEnv);
+                if (!options.resume) {
+                    if (effectiveNonInteractive) {
+                        throw new SplitResumeError('Partial split detected. Re-run with --resume to confirm resuming without an interactive prompt.');
+                    }
+                    const confirmed = await dependencies.confirmAction('Resume this split from the recovered plan?', { interactive: context.interactive });
+                    if (!confirmed) {
+                        throw new SplitResumeError('Split resume cancelled.');
+                    }
+                }
+                await continueSplitResume(partial, { repoRoot, projectsRoot });
+            }
+            else {
+                await runFreshSplit(document, repoRoot, projectsRoot, dependencies);
+            }
+            await dependencies.refreshDashboard({ repoRoot });
+            context.logger.info('Split completed.');
+            process.exitCode = 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            context.logger.error(message);
+            if (error instanceof SplitResumeError) {
+                process.exitCode = 1;
+                return;
+            }
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/commands/project/split/validate-plan.d.ts

@@ -0,0 +1,14 @@
+import { readdir as defaultReaddir, readFile as defaultReadFile } from 'node:fs/promises';
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { Command } from 'commander';
+interface ValidatePlanDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
+    readFile: typeof defaultReadFile;
+    readdir: typeof defaultReaddir;
+    processEnv: NodeJS.ProcessEnv;
+}
+export declare function createValidateSplitPlanCommand(overrides?: Partial<ValidatePlanDependencies>): Command;
+export {};
+//# sourceMappingURL=validate-plan.d.ts.map

package/dist/commands/project/split/validate-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-plan.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/split/validate-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,IAAI,cAAc,EACzB,QAAQ,IAAI,eAAe,EAC5B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,UAAU,wBAAwB;IAChC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,OAAO,EAAE,OAAO,cAAc,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAgCD,wBAAgB,8BAA8B,CAC5C,SAAS,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAChD,OAAO,CAwCT"}

package/dist/commands/project/split/validate-plan.js

@@ -0,0 +1,62 @@
+import { readdir as defaultReaddir, readFile as defaultReadFile, } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { buildCommandContext, } from '../../../app/command-context.js';
+import { resolveProjectsRoot } from '../../shared/oat-paths.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { resolveProjectRoot } from '../../../fs/paths.js';
+import { Command } from 'commander';
+import { validateSplitPlanDocumentShape } from '../../../projects/split/document-validation.js';
+import { validateChildPlan } from '../../../projects/split/validation.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveProjectsRoot,
+    readFile: defaultReadFile,
+    readdir: defaultReaddir,
+    processEnv: process.env,
+};
+async function readExistingProjectSlugs(context, dependencies) {
+    const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+    const projectsRoot = await dependencies.resolveProjectsRoot(repoRoot, dependencies.processEnv);
+    const absoluteProjectsRoot = isAbsolute(projectsRoot)
+        ? projectsRoot
+        : join(repoRoot, projectsRoot);
+    const entries = await dependencies.readdir(absoluteProjectsRoot, {
+        withFileTypes: true,
+    });
+    return new Set(entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name));
+}
+export function createValidateSplitPlanCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('validate-plan')
+        .description('Validate a persisted oat-project-split SplitPlanDocument')
+        .requiredOption('--plan-file <path>', 'Path to split-plan.json')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        try {
+            const raw = await dependencies.readFile(options.planFile, 'utf8');
+            const parsed = JSON.parse(raw);
+            const shape = validateSplitPlanDocumentShape(parsed);
+            if (!shape.ok) {
+                context.logger.json({ ok: false, errors: shape.errors });
+                process.exitCode = 1;
+                return;
+            }
+            const existingSlugs = await readExistingProjectSlugs(context, dependencies);
+            const result = validateChildPlan(shape.document.plan, existingSlugs);
+            context.logger.json(result);
+            process.exitCode = result.ok ? 0 : 1;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            context.logger.json({
+                ok: false,
+                errors: [{ code: 'read-or-parse-failed', message }],
+            });
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/commands/shared/frontmatter.d.ts

@@ -1,3 +1,12 @@
+export declare const PROJECT_STATE_KINDS: readonly ["implementation", "coordination"];
+export declare const PROJECT_STATE_PHASES: readonly ["discovery", "spec", "design", "plan", "implement", "decomposition"];
+export declare const PROJECT_STATE_FRONTMATTER_FIELDS: readonly ["oat_kind", "oat_parent", "oat_siblings", "oat_depends_on", "oat_children", "oat_inherited_context_revalidated", "oat_phase", "oat_phase_status", "oat_status", "oat_workflow_mode", "oat_lifecycle", "oat_current_task", "oat_last_commit", "oat_blockers", "oat_hill_checkpoints", "oat_hill_completed", "oat_parallel_execution", "oat_pr_status", "oat_pr_url", "oat_project_created", "oat_project_completed", "oat_project_state_updated", "oat_docs_updated", "oat_generated", "oat_template", "oat_template_name"];
+export type ProjectStateKind = (typeof PROJECT_STATE_KINDS)[number];
+export type ProjectStatePhase = (typeof PROJECT_STATE_PHASES)[number];
+export type ProjectStateFrontmatterField = (typeof PROJECT_STATE_FRONTMATTER_FIELDS)[number];
+export declare function isProjectStateKind(value: string): value is ProjectStateKind;
+export declare function isProjectStatePhase(value: string): value is ProjectStatePhase;
+export declare function isProjectStateFrontmatterField(value: string): value is ProjectStateFrontmatterField;
 export declare function getFrontmatterBlock(content: string): string | null;
 export declare function getFrontmatterField(frontmatter: string, field: string): string | null;
 export declare function parseFrontmatterField(filePath: string, field: string): Promise<string>;

package/dist/commands/shared/frontmatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/frontmatter.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAKf;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/frontmatter.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,6CAA8C,CAAC;AAE/E,eAAO,MAAM,oBAAoB,gFAOvB,CAAC;AAEX,eAAO,MAAM,gCAAgC,sgBA2BnC,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AACtE,MAAM,MAAM,4BAA4B,GACtC,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,4BAA4B,CAIvC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAKf;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}

package/dist/commands/shared/frontmatter.js

@@ -1,5 +1,51 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
+export const PROJECT_STATE_KINDS = ['implementation', 'coordination'];
+export const PROJECT_STATE_PHASES = [
+    'discovery',
+    'spec',
+    'design',
+    'plan',
+    'implement',
+    'decomposition',
+];
+export const PROJECT_STATE_FRONTMATTER_FIELDS = [
+    'oat_kind',
+    'oat_parent',
+    'oat_siblings',
+    'oat_depends_on',
+    'oat_children',
+    'oat_inherited_context_revalidated',
+    'oat_phase',
+    'oat_phase_status',
+    'oat_status',
+    'oat_workflow_mode',
+    'oat_lifecycle',
+    'oat_current_task',
+    'oat_last_commit',
+    'oat_blockers',
+    'oat_hill_checkpoints',
+    'oat_hill_completed',
+    'oat_parallel_execution',
+    'oat_pr_status',
+    'oat_pr_url',
+    'oat_project_created',
+    'oat_project_completed',
+    'oat_project_state_updated',
+    'oat_docs_updated',
+    'oat_generated',
+    'oat_template',
+    'oat_template_name',
+];
+export function isProjectStateKind(value) {
+    return PROJECT_STATE_KINDS.includes(value);
+}
+export function isProjectStatePhase(value) {
+    return PROJECT_STATE_PHASES.includes(value);
+}
+export function isProjectStateFrontmatterField(value) {
+    return PROJECT_STATE_FRONTMATTER_FIELDS.includes(value);
+}
 export function getFrontmatterBlock(content) {
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     return match?.[1] ?? null;

package/dist/commands/state/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/state/generate.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA4GD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvE;AA8aD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA2C9B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/state/generate.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAiHD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvE;AAydD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA2C9B"}

package/dist/commands/state/generate.js

@@ -305,25 +305,53 @@ function computeNextStep(project, hasProjects, state) {
     }
     return { step: 'oat-project-progress', reason: 'Check current progress' };
 }
+function isTerminalCoordinationProject(kind, phase, phaseStatus) {
+    return (kind === 'coordination' &&
+        phase === 'decomposition' &&
+        phaseStatus === 'complete');
+}
 async function listAvailableProjects(repoRoot, projectsRoot) {
     const fullRoot = join(repoRoot, projectsRoot);
     try {
         const entries = await readdir(fullRoot, { withFileTypes: true });
         const dirs = entries.filter((e) => e.isDirectory());
-        if (dirs.length === 0)
-            return '*(No projects found)*';
+        if (dirs.length === 0) {
+            return {
+                active: '*(No projects found)*',
+                decompositions: '*(No decompositions found)*',
+            };
+        }
         const lines = [];
+        const decompositions = [];
         for (const dir of dirs) {
             const stateFile = join(fullRoot, dir.name, 'state.md');
             if (await fileExists(stateFile)) {
                 const phase = (await parseFrontmatterField(stateFile, 'oat_phase')) || 'unknown';
-                lines.push(`- **${dir.name}** - ${phase}`);
+                const phaseStatus = (await parseFrontmatterField(stateFile, 'oat_phase_status')) ||
+                    'in_progress';
+                const kind = (await parseFrontmatterField(stateFile, 'oat_kind')) ||
+                    'implementation';
+                const line = `- **${dir.name}** - ${phase}`;
+                if (isTerminalCoordinationProject(kind, phase, phaseStatus)) {
+                    decompositions.push(line);
+                }
+                else {
+                    lines.push(line);
+                }
             }
         }
-        return lines.length > 0 ? lines.join('\n') : '*(No projects found)*';
+        return {
+            active: lines.length > 0 ? lines.join('\n') : '*(No projects found)*',
+            decompositions: decompositions.length > 0
+                ? decompositions.join('\n')
+                : '*(No decompositions found)*',
+        };
     }
     catch {
-        return '*(No projects directory found)*';
+        return {
+            active: '*(No projects directory found)*',
+            decompositions: '*(No decompositions found)*',
+        };
     }
 }
 function buildDashboardMarkdown(project, state, knowledge, staleness, nextStep, projectsList, generatedDate) {
@@ -412,7 +440,11 @@ function buildDashboardMarkdown(project, state, knowledge, staleness, nextStep,
     lines.push('');
     lines.push('## Available Projects');
     lines.push('');
-    lines.push(projectsList);
+    lines.push(projectsList.active);
+    lines.push('');
+    lines.push('## Decompositions');
+    lines.push('');
+    lines.push(projectsList.decompositions);
     lines.push('');
     return lines.join('\n');
 }

package/dist/projects/split/child-plan.d.ts

@@ -0,0 +1,46 @@
+export type SplitOrigin = 'declared' | 'detected-mid-stream' | 'detected-convergence' | 'brainstorm-picker';
+export interface SplitChildInput {
+    slug: string;
+    description?: string;
+    inheritedContext?: string;
+    knownDependencies?: string[];
+    foundation?: boolean;
+}
+export interface SplitPayload {
+    origin: SplitOrigin;
+    parentSlug?: string;
+    declaredChildren?: SplitChildInput[];
+    inferredChildren?: SplitChildInput[];
+    priorDiscovery?: {
+        path: string;
+        brainstormSessionId?: string;
+        parentSlug?: string;
+        children?: SplitChildInput[];
+        inheritedContext?: string;
+        integrationSketch?: string;
+    };
+    interactive: boolean;
+    foundationChild?: string;
+    integrationSketch?: string;
+    initialActiveChild?: string;
+}
+export interface ChildPlan {
+    parentSlug: string;
+    children: Array<{
+        slug: string;
+        description?: string;
+        inheritedContext: string;
+        knownDependencies: string[];
+        order: number;
+    }>;
+    foundationChild?: string;
+    integrationSketch?: string;
+    initialActiveChild: string;
+}
+export interface SplitPlanDocument {
+    origin: SplitOrigin;
+    interactive: boolean;
+    plan: ChildPlan;
+}
+export declare function buildSplitPlanDocument(payload: SplitPayload): SplitPlanDocument;
+//# sourceMappingURL=child-plan.d.ts.map

package/dist/projects/split/child-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-plan.d.ts","sourceRoot":"","sources":["../../../src/projects/split/child-plan.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,CAAC;AAExB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;QAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;CACjB;AA0GD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,YAAY,GACpB,iBAAiB,CAiCnB"}