@open-agent-toolkit/cli 0.1.5 → 0.1.7

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/project/list.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,uBAAuB;IAC/B,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,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAClE,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAgGD,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAcT"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/project/list.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,uBAAuB;IAC/B,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,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAClE,mBAAmB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC3E,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAwJD,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAkBT"}

package/dist/commands/project/list.js

@@ -1,5 +1,6 @@
 import { isAbsolute, join } from 'node:path';
 import { buildCommandContext, } from '../../app/command-context.js';
+import { parseFrontmatterField } from '../shared/frontmatter.js';
 import { resolveProjectsRoot } from '../shared/oat-paths.js';
 import { readGlobalOptions } from '../shared/shared.utils.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
@@ -10,8 +11,39 @@ const DEFAULT_DEPENDENCIES = {
     resolveProjectRoot,
     resolveProjectsRoot,
     listProjects,
+    readProjectMetadata,
     processEnv: process.env,
 };
+async function readProjectMetadata(projectPath) {
+    const stateFile = join(projectPath, 'state.md');
+    const [kind, phase, phaseStatus] = await Promise.all([
+        parseFrontmatterField(stateFile, 'oat_kind'),
+        parseFrontmatterField(stateFile, 'oat_phase'),
+        parseFrontmatterField(stateFile, 'oat_phase_status'),
+    ]);
+    return {
+        kind: kind || 'implementation',
+        phase: phase || 'discovery',
+        phaseStatus: phaseStatus || 'in_progress',
+    };
+}
+function isTerminalCoordinationProject(metadata) {
+    return (metadata.kind === 'coordination' &&
+        metadata.phase === 'decomposition' &&
+        metadata.phaseStatus === 'complete');
+}
+async function filterProjectsForList(projects, projectsRoot, includeCoordination, dependencies) {
+    if (includeCoordination)
+        return projects;
+    const filtered = [];
+    for (const project of projects) {
+        const metadata = await dependencies.readProjectMetadata(join(projectsRoot, project.name));
+        if (!isTerminalCoordinationProject(metadata)) {
+            filtered.push(project);
+        }
+    }
+    return filtered;
+}
 function formatProjectTable(projects) {
     if (projects.length === 0) {
         return ['No tracked projects found.'];
@@ -48,14 +80,14 @@ function formatProjectTable(projects) {
     ].join('  '));
     return [header, divider, ...lines];
 }
-async function runProjectList(context, dependencies) {
+async function runProjectList(context, dependencies, options) {
     try {
         const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
         const projectsRoot = await dependencies.resolveProjectsRoot(repoRoot, dependencies.processEnv);
         const absoluteProjectsRoot = isAbsolute(projectsRoot)
             ? projectsRoot
             : join(repoRoot, projectsRoot);
-        const projects = await dependencies.listProjects(absoluteProjectsRoot);
+        const projects = await filterProjectsForList(await dependencies.listProjects(absoluteProjectsRoot), absoluteProjectsRoot, options.includeCoordination ?? false, dependencies);
         if (context.json) {
             context.logger.json({ status: 'ok', projects });
         }
@@ -84,8 +116,9 @@ export function createProjectListCommand(overrides = {}) {
     };
     return new Command('list')
         .description('List tracked OAT projects')
-        .action(async (_options, command) => {
+        .option('--include-coordination', 'Include completed coordination parent projects')
+        .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
-        await runProjectList(context, dependencies);
+        await runProjectList(context, dependencies, options);
     });
 }

package/dist/commands/project/new/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/new/scaffold.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAqMD,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAqDhC"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/new/scaffold.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAwMD,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAqDhC"}

package/dist/commands/project/new/scaffold.js

@@ -4,6 +4,7 @@ import { resolveProjectsRoot } from '../../shared/oat-paths.js';
 import { generateStateDashboard } from '../../state/generate.js';
 import { setActiveProject } from '../../../config/oat-config.js';
 import { fileExists } from '../../../fs/io.js';
+import { assertValidProjectStateContent } from '../../../validation/project-state.js';
 const TEMPLATES_BY_MODE = {
     'spec-driven': [
         'state.md',
@@ -117,6 +118,9 @@ async function scaffoldModeTemplates(repoRoot, projectPath, projectName, mode, t
         }
         const template = await readFile(src, 'utf8');
         const rendered = applyTemplateReplacements(template, projectName, today, nowUtc, mode);
+        if (templateFile === 'state.md') {
+            assertValidProjectStateContent(rendered, { filePath: dest });
+        }
         await writeFile(dest, rendered, 'utf8');
         createdFiles.push(templateFile);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/open/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;AAYhF,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,UAAU,uBAAuB;IAC/B,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,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,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,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,sBAAsB,EAAE,CAAC,OAAO,EAAE;QAChC,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnC,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AA+JD,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAkBT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/open/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;AAYhF,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,UAAU,uBAAuB;IAC/B,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,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,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,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,sBAAsB,EAAE,CAAC,OAAO,EAAE;QAChC,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnC,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAkKD,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAkBT"}

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

@@ -9,6 +9,7 @@ import { generateStateDashboard as defaultGenerateStateDashboard, } from '../../
 import { readOatLocalConfig, setActiveProject, writeOatLocalConfig, } from '../../../config/oat-config.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';
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
@@ -25,7 +26,7 @@ const DEFAULT_DEPENDENCIES = {
     processEnv: process.env,
     now: () => new Date(),
 };
-async function maybeResumePausedProject(statePath, dependencies) {
+async function maybeResumePausedProject(statePath, projectPath, dependencies) {
     const stateContent = await dependencies.readFile(statePath, 'utf8');
     const frontmatter = getFrontmatterBlock(stateContent);
     if (!frontmatter) {
@@ -39,7 +40,12 @@ async function maybeResumePausedProject(statePath, dependencies) {
     nextBlock = removeFrontmatterField(nextBlock, 'oat_pause_reason');
     nextBlock = upsertFrontmatterField(nextBlock, 'oat_project_state_updated', dependencies.now().toISOString(), true).nextBlock;
     if (nextBlock !== frontmatter) {
-        await dependencies.writeFile(statePath, replaceFrontmatter(stateContent, nextBlock), 'utf8');
+        const nextContent = replaceFrontmatter(stateContent, nextBlock);
+        await assertValidProjectStateFilesystemContent(nextContent, {
+            filePath: statePath,
+            projectPath,
+        });
+        await dependencies.writeFile(statePath, nextContent, 'utf8');
     }
     return true;
 }
@@ -76,7 +82,7 @@ async function runProjectOpen(projectName, options, context, dependencies) {
             process.exitCode = 0;
             return;
         }
-        const resumedFromPaused = await maybeResumePausedProject(statePath, dependencies);
+        const resumedFromPaused = await maybeResumePausedProject(statePath, fullProjectPath, dependencies);
         await dependencies.setActiveProject(repoRoot, projectPath);
         if (localConfig.lastPausedProject === projectPath) {
             const updatedConfig = await dependencies.readOatLocalConfig(repoRoot);

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/pause/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;AAShF,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,UAAU,wBAAwB;IAChC,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,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,kBAAkB,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,sBAAsB,EAAE,CAAC,OAAO,EAAE;QAChC,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnC,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAyID,wBAAgB,yBAAyB,CACvC,SAAS,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAChD,OAAO,CAsBT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/pause/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;AAShF,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,UAAU,wBAAwB;IAChC,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,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,kBAAkB,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,sBAAsB,EAAE,CAAC,OAAO,EAAE;QAChC,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnC,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AA0ID,wBAAgB,yBAAyB,CACvC,SAAS,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAChD,OAAO,CAsBT"}

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

@@ -9,6 +9,7 @@ import { generateStateDashboard as defaultGenerateStateDashboard, } from '../../
 import { clearActiveProject, readOatLocalConfig, } from '../../../config/oat-config.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';
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
@@ -67,7 +68,12 @@ async function runProjectPause(projectName, options, context, dependencies) {
             nextBlock = removeFrontmatterField(nextBlock, 'oat_pause_reason');
         }
         if (nextBlock !== frontmatter) {
-            await dependencies.writeFile(statePath, replaceFrontmatter(content, nextBlock), 'utf8');
+            const nextContent = replaceFrontmatter(content, nextBlock);
+            await assertValidProjectStateFilesystemContent(nextContent, {
+                filePath: statePath,
+                projectPath: fullProjectPath,
+            });
+            await dependencies.writeFile(statePath, nextContent, 'utf8');
         }
         const pointerCleared = activeProject === projectPath;
         if (pointerCleared) {

package/dist/commands/project/split/evaluate-signals.d.ts

@@ -0,0 +1,8 @@
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { Command } from 'commander';
+interface EvaluateSignalsDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+}
+export declare function createEvaluateSignalsCommand(overrides?: Partial<EvaluateSignalsDependencies>): Command;
+export {};
+//# sourceMappingURL=evaluate-signals.d.ts.map

package/dist/commands/project/split/evaluate-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-signals.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/split/evaluate-signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,UAAU,2BAA2B;IACnC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;CACjE;AAqBD,wBAAgB,4BAA4B,CAC1C,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CAyBT"}

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"}