@open-agent-toolkit/cli 0.3.19 → 0.3.21

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

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

@@ -15,7 +15,7 @@ import { resolveEffectiveConfig } from '../../../config/resolve.js';
 import { CliError } from '../../../errors/cli-error.js';
 import { resolveAssetsRoot } from '../../../fs/assets.js';
 import { dirExists, fileExists } from '../../../fs/io.js';
-import { isBriefMode, } from '@open-agent-toolkit/control-plane';
+import { isBriefMode, MILESTONES_TABLE_HEADER, } from '@open-agent-toolkit/control-plane';
 import { assertValidProjectStateContent } from '../../../validation/project-state.js';
 const DEFAULT_DEPENDENCIES = {
     resolveDefaultScope,
@@ -49,6 +49,13 @@ const TEMPLATES_BY_MODE = {
         { source: 'plan-brief.md', target: 'plan.md' },
         { source: 'implementation-brief.md', target: 'implementation.md' },
     ],
+    // Goal shares the brief templates; scaffold renders its plan source and the
+    // canonical Milestones table header (see renderGoalBrief).
+    goal: [
+        'state.md',
+        { source: 'plan-brief.md', target: 'plan.md' },
+        { source: 'implementation-brief.md', target: 'implementation.md' },
+    ],
 };
 function normalizeTemplateEntry(entry) {
     return typeof entry === 'string' ? { source: entry, target: entry } : entry;
@@ -145,6 +152,23 @@ const STATE_TEMPLATE_BY_MODE = {
         ],
         nextMilestone: 'Run `oat-project-brief` to author and approve the brief',
     },
+    goal: {
+        hillCheckpoints: '[]',
+        phase: 'plan',
+        status: 'Plan',
+        currentPhase: 'Plan - Authoring the goal Project Brief and its milestones',
+        artifacts: [
+            '- **Plan:** `plan.md` (scaffolded goal Project Brief template — not started)',
+            '- **Implementation:** `implementation.md` (scaffolded brief journal template — not started)',
+            '- **Research:** `references/research/` (empty)',
+        ],
+        progress: [
+            '- ✓ Goal project scaffolded',
+            '- ✓ Brief and implementation artifacts scaffolded',
+            '- ⧗ Awaiting goal interview, milestones and brief authoring',
+        ],
+        nextMilestone: 'Run `oat-project-goal` to author the brief and its milestones and approve the first milestone',
+    },
 };
 function replaceOatPlaceholders(template, replacements) {
     return template.replace(OAT_PLACEHOLDER_PATTERN, (placeholder, token) => replacements[token] ?? placeholder);
@@ -245,6 +269,9 @@ async function scaffoldModeTemplates(home, repoRoot, absoluteProjectPath, projec
         if ((mode === 'lite' || isBriefMode(mode)) && target === 'plan.md') {
             rendered = rendered.replace(/^---\n/, '---\noat_template: true\n');
         }
+        if (mode === 'goal' && target === 'plan.md') {
+            rendered = renderGoalBrief(rendered);
+        }
         assertNoUnresolvedOatPlaceholders(rendered, source);
         if (target === 'state.md') {
             assertValidProjectStateContent(rendered, { filePath: dest });
@@ -254,6 +281,25 @@ async function scaffoldModeTemplates(home, repoRoot, absoluteProjectPath, projec
     }
     return { createdFiles, skippedFiles };
 }
+const BRIEF_PLAN_SOURCE_PATTERN = /^oat_plan_source:[ \t]*brief\b[^\n]*$/m;
+const BRIEF_MILESTONES_PLACEHOLDER_PATTERN = /^<!-- Reserved for goal mode\.[^\n]*-->[ \t]*$/m;
+const MILESTONES_HEADING_LINE_PATTERN = /^## Milestones[ \t]*$/m;
+const GOAL_MILESTONES_GUIDANCE = '<!-- One row per milestone: its id (m01, m02, …) and its ordered, comma-separated phase ids. Every phase, including revision phases, belongs to exactly one milestone. -->';
+/**
+ * Goal shares the brief template: render `oat_plan_source: goal` (the
+ * template hardcodes `brief`) and replace the brief-only Milestones
+ * placeholder with the canonical table header the shared Milestones reader
+ * parses. A template without the placeholder still gets the header under its
+ * `## Milestones` heading.
+ */
+function renderGoalBrief(rendered) {
+    const withSource = rendered.replace(BRIEF_PLAN_SOURCE_PATTERN, 'oat_plan_source: goal');
+    const milestonesBlock = `${GOAL_MILESTONES_GUIDANCE}\n\n${MILESTONES_TABLE_HEADER}`;
+    if (BRIEF_MILESTONES_PLACEHOLDER_PATTERN.test(withSource)) {
+        return withSource.replace(BRIEF_MILESTONES_PLACEHOLDER_PATTERN, milestonesBlock);
+    }
+    return withSource.replace(MILESTONES_HEADING_LINE_PATTERN, `## Milestones\n\n${milestonesBlock}`);
+}
 async function scaffoldProjectLog(home, repoRoot, absoluteProjectPath, projectName, today) {
     const templateFile = 'project-log.md';
     const dest = join(absoluteProjectPath, templateFile);

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

@@ -15,7 +15,7 @@ export interface LitePlanSections {
     productBehavior?: string;
     technicalDesign?: string;
 }
-type PromotionReason = 'promoted' | 'unsupported-target' | 'not-lite' | 'lite-plan-reference-exists' | 'invalid-lite-plan' | 'brief-archive-exists' | 'extracted-phases' | 'invalid-brief-plan' | 'missing-phase-head' | 'scope-unresolved' | 'project-unreadable' | 'template-unreadable' | 'write-failed' | 'persistence-failed';
+type PromotionReason = 'promoted' | 'unsupported-target' | 'not-lite' | 'lite-plan-reference-exists' | 'invalid-lite-plan' | 'brief-archive-exists' | 'goal-milestone-active' | 'goal-delivery-unsettled' | 'goal-recovery-pending' | 'extracted-phases' | 'invalid-brief-plan' | 'missing-phase-head' | 'scope-unresolved' | 'project-unreadable' | 'template-unreadable' | 'write-failed' | 'persistence-failed';
 interface PromotionRecovery extends ExactPathCommitResult {
     identity: string;
     message: string;
@@ -31,6 +31,8 @@ export type PromotionResult = {
     reason: Exclude<PromotionReason, 'promoted'>;
     files: string[];
     phases?: string[];
+    /** Goal: the registry entries that are not yet settled. */
+    deliveries?: string[];
     recovery?: PromotionRecovery;
 };
 export interface ProjectPromoteDependencies {
@@ -51,7 +53,17 @@ export interface ProjectPromoteDependencies {
     now: () => Date;
 }
 export declare function parseLitePlanSections(planContent: string, liteTemplateContent?: string): LitePlanSections | null;
+/**
+ * A goal promotes only at a settled delivery boundary: the active milestone
+ * is `delivered`, every registry entry is `at_endpoint` or `superseded` (none
+ * `registering` or `open`; an empty registry is not settled), and no recovery
+ * is pending. Extracted phases are
+ * refused by the shared migration. Returns the refusal, or null when settled.
+ */
+export declare function goalPromotionRefusal(stateFrontmatter: Record<string, unknown>): PromotionResult | null;
 export type BriefPhaseState = 'accepted' | 'active' | 'pending' | 'provisional';
+/** The brief-family mode a promotion starts from. */
+export type BriefSourceMode = 'brief' | 'goal';
 export interface BriefMigration {
     plan: string;
     implementation: string;
@@ -80,6 +92,8 @@ export declare function migrateBriefToQuick(input: {
     implementationContent: string;
     projectName: string;
     today: string;
+    /** The actual source mode, named in provenance; defaults to `brief`. */
+    sourceMode?: BriefSourceMode;
 }): BriefMigrationResult;
 export declare function createProjectPromoteCommand(overrides?: Partial<ProjectPromoteDependencies>): Command;
 export {};

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

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

package/dist/commands/project/promote/promote.js

@@ -245,7 +245,13 @@ async function promoteProject(projectPath, options, context, dependencies) {
     catch {
         return { status: 'refused', reason: 'project-unreadable', files: [] };
     }
-    if (stateFrontmatter['oat_workflow_mode'] === 'brief') {
+    const mode = stateFrontmatter['oat_workflow_mode'];
+    if (mode === 'brief' || mode === 'goal') {
+        if (mode === 'goal') {
+            const unsettled = goalPromotionRefusal(stateFrontmatter);
+            if (unsettled !== null)
+                return unsettled;
+        }
         return promoteBriefProject({
             repoRoot,
             projectRoot,
@@ -254,6 +260,8 @@ async function promoteProject(projectPath, options, context, dependencies) {
             planPath,
             stateContent,
             planContent,
+            sourceMode: mode,
+            stateFrontmatter,
         }, context, dependencies);
     }
     if (stateFrontmatter['oat_workflow_mode'] !== 'lite') {
@@ -346,6 +354,77 @@ async function promoteProject(projectPath, options, context, dependencies) {
     };
 }
 // ---------------------------------------------------------------------------
+// goal → quick: the settled delivery boundary (B3)
+// ---------------------------------------------------------------------------
+/** Registry statuses at which a delivery no longer needs goal machinery. */
+const SETTLED_DELIVERY_STATUSES = new Set(['at_endpoint', 'superseded']);
+/** The goal state carried verbatim into the promoted state and the archive. */
+const GOAL_HISTORY_KEYS = [
+    'oat_deliveries',
+    'oat_milestone_gates',
+    'oat_goal_outcome_audit',
+];
+/**
+ * A goal promotes only at a settled delivery boundary: the active milestone
+ * is `delivered`, every registry entry is `at_endpoint` or `superseded` (none
+ * `registering` or `open`; an empty registry is not settled), and no recovery
+ * is pending. Extracted phases are
+ * refused by the shared migration. Returns the refusal, or null when settled.
+ */
+export function goalPromotionRefusal(stateFrontmatter) {
+    if (stateFrontmatter['oat_milestone_status'] !== 'delivered') {
+        return { status: 'refused', reason: 'goal-milestone-active', files: [] };
+    }
+    const recovery = stateFrontmatter['oat_goal_recovery'];
+    if (recovery !== null && recovery !== undefined) {
+        return { status: 'refused', reason: 'goal-recovery-pending', files: [] };
+    }
+    const registry = stateFrontmatter['oat_deliveries'];
+    const entries = Array.isArray(registry) ? registry : [];
+    const unsettled = entries
+        .filter((entry) => typeof entry !== 'object' ||
+        entry === null ||
+        !SETTLED_DELIVERY_STATUSES.has(String(entry['status'])))
+        .map((entry) => typeof entry === 'object' && entry !== null
+        ? String(entry['delivery_id'] ?? '?')
+        : '?');
+    // `delivered` means registered, open and review-ready (B4): a delivered
+    // milestone with no registry entry is contradictory, never vacuously settled.
+    if (!Array.isArray(registry) ||
+        entries.length === 0 ||
+        unsettled.length > 0) {
+        return {
+            status: 'refused',
+            reason: 'goal-delivery-unsettled',
+            files: [],
+            deliveries: unsettled,
+        };
+    }
+    return null;
+}
+/**
+ * The goal archive: the original brief followed by its delivery history, so
+ * the registry, milestone gates and outcome audit survive under the archive
+ * as well as in the promoted `state.md`.
+ */
+function renderGoalArchive(planContent, stateFrontmatter) {
+    const history = {};
+    for (const key of GOAL_HISTORY_KEYS) {
+        history[key] = stateFrontmatter[key] ?? null;
+    }
+    return `${planContent.trimEnd()}
+
+## Delivery History (archived at promotion)
+
+The goal's delivery registry, milestone gate carriers and outcome audit as
+recorded in \`state.md\` when the project was promoted to quick.
+
+\`\`\`yaml
+${YAML.stringify(history).trimEnd()}
+\`\`\`
+`;
+}
+// ---------------------------------------------------------------------------
 // brief → quick
 // ---------------------------------------------------------------------------
 const BRIEF_ARCHIVE_FILE = 'references/brief-archive.md';
@@ -509,21 +588,21 @@ function trimBlank(lines) {
  * Type and Artifact are review-event identity) and one provenance line under
  * the heading marking the rows recorded before promotion.
  */
-function reviewsWithProvenance(section, today) {
+function reviewsWithProvenance(section, today, sourceMode) {
     return [
         section.lines[0],
         '',
-        `Rows dated on or before ${today} were recorded pre-promotion under workflow mode brief.`,
+        `Rows dated on or before ${today} were recorded pre-promotion under workflow mode ${sourceMode}.`,
         '',
         ...trimBlank(section.lines.slice(1)),
     ];
 }
-function renderPlanTask(record) {
+function renderPlanTask(record, sourceMode) {
     const commit = record.commit && record.commit !== '-' ? record.commit : null;
     return [
         `### Task ${record.taskId}: ${record.title}`,
         '',
-        `> Accepted before promotion (brief). Execution record: \`implementation.md\`${commit ? ` (commit \`${commit}\`)` : ''}.`,
+        `> Accepted before promotion (${sourceMode}). Execution record: \`implementation.md\`${commit ? ` (commit \`${commit}\`)` : ''}.`,
         ...(trimBlank(record.body).length > 0
             ? ['', ...trimBlank(record.body)]
             : []),
@@ -537,6 +616,7 @@ function renderPlanTask(record) {
  */
 export function migrateBriefToQuick(input) {
     const { planContent, implementationContent, projectName, today } = input;
+    const sourceMode = input.sourceMode ?? 'brief';
     const markers = parsePhaseMarkers(implementationContent);
     if ([...markers.values()].some((marker) => marker.status === 'extracted')) {
         return { ok: false, reason: 'extracted-phases' };
@@ -584,7 +664,7 @@ export function migrateBriefToQuick(input) {
     const output = [
         `# Implementation Plan: ${projectName}`,
         '',
-        `> Promoted from a brief on ${today}. The original brief is archived at \`${BRIEF_ARCHIVE_FILE}\`; its outcomes, decisions, known unknowns and delivery authority are carried into \`discovery.md\`.`,
+        `> Promoted from a ${sourceMode === 'goal' ? 'goal brief' : 'brief'} on ${today}. The original brief is archived at \`${BRIEF_ARCHIVE_FILE}\`; its outcomes, decisions, known unknowns and delivery authority are carried into \`discovery.md\`.`,
         '',
         `**Goal:** ${goal ? goal.split('\n\n')[0].replace(/\n/g, ' ') : '{Author from discovery}'}`,
         '',
@@ -625,8 +705,9 @@ export function migrateBriefToQuick(input) {
                         .map((r) => `${r.taskId} (${r.status})`)
                         .join(', ')}`, '');
                 }
-                for (const record of completed)
-                    lines.push(...renderPlanTask(record));
+                for (const record of completed) {
+                    lines.push(...renderPlanTask(record, sourceMode));
+                }
                 if (state === 'accepted' && completed.length === 0) {
                     const next = Math.max(0, ...phaseRecords.map((r) => r.ordinal)) + 1;
                     const taskId = `${taskPrefixForPhase(phaseId)}-t${String(next).padStart(2, '0')}`;
@@ -656,7 +737,7 @@ export function migrateBriefToQuick(input) {
         if (/^delivery\b/i.test(title))
             continue;
         if (title.toLowerCase() === 'reviews') {
-            output.push(...reviewsWithProvenance(section, today), '');
+            output.push(...reviewsWithProvenance(section, today, sourceMode), '');
             continue;
         }
         if (title.toLowerCase() === 'references') {
@@ -675,7 +756,7 @@ export function migrateBriefToQuick(input) {
     frontmatter['oat_template'] = true;
     frontmatter['oat_template_name'] = 'plan';
     frontmatter['oat_plan_source'] = 'quick';
-    frontmatter['oat_promoted_from'] = 'brief';
+    frontmatter['oat_promoted_from'] = sourceMode;
     frontmatter['oat_promotion_pending_phases'] = pendingPhases;
     const plan = `---\n${YAML.stringify(frontmatter)}---\n\n${output
         .join('\n')
@@ -809,6 +890,7 @@ async function promoteBriefProject(input, context, dependencies) {
             implementationContent,
             projectName,
             today,
+            sourceMode: input.sourceMode,
         });
     }
     catch {
@@ -852,7 +934,7 @@ async function promoteBriefProject(input, context, dependencies) {
         'plan.md',
         'state.md',
     ];
-    const identity = `promote:${projectRoot}:brief-to-quick:${randomUUID()}`;
+    const identity = `promote:${projectRoot}:${input.sourceMode}-to-quick:${randomUUID()}`;
     const writtenFiles = [];
     try {
         await dependencies.mkdir(join(projectRoot, 'references'), {
@@ -860,7 +942,9 @@ async function promoteBriefProject(input, context, dependencies) {
         });
         await dependencies.writeFile(join(projectRoot, 'discovery.md'), discoveryContent, 'utf8');
         writtenFiles.push('discovery.md');
-        await dependencies.writeFile(archivePath, input.planContent, 'utf8');
+        await dependencies.writeFile(archivePath, input.sourceMode === 'goal'
+            ? renderGoalArchive(input.planContent, input.stateFrontmatter)
+            : input.planContent, 'utf8');
         writtenFiles.push(BRIEF_ARCHIVE_FILE);
         if (migration.implementationChanged) {
             await dependencies.writeFile(implementationPath, migration.implementation, 'utf8');
@@ -892,8 +976,8 @@ async function promoteBriefProject(input, context, dependencies) {
 export function createProjectPromoteCommand(overrides = {}) {
     const dependencies = { ...DEFAULT_DEPENDENCIES, ...overrides };
     return new Command('promote')
-        .description('Promote an authored lite or brief project to the quick workflow')
-        .argument('<project-path>', 'Lite or brief project path to promote')
+        .description('Promote an authored lite, brief or settled goal project to the quick workflow')
+        .argument('<project-path>', 'Lite, brief or goal project path to promote')
         .requiredOption('--to <mode>', 'Target workflow mode')
         .action(async (projectPath, options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
@@ -905,7 +989,7 @@ export function createProjectPromoteCommand(overrides = {}) {
             context.logger.info(`Promoted ${projectPath} to quick.`);
         }
         else {
-            context.logger.error(`Promotion refused: ${result.reason}${result.phases ? ` (${result.phases.join(', ')})` : ''}.${result.recovery ? ` Exact-path persistence ${result.recovery.outcome}; attempts ${result.recovery.attempts}; lock ${result.recovery.lockClass ?? 'none'}; identity ${result.recovery.identity}; receipt ${result.recovery.receipt ?? 'unavailable'}. ${result.recovery.error ?? ''} Recover existing Quick artifacts with: ${result.recovery.command}` : ''}`);
+            context.logger.error(`Promotion refused: ${result.reason}${result.phases ? ` (${result.phases.join(', ')})` : ''}${result.deliveries ? ` (${result.deliveries.join(', ')})` : ''}.${result.recovery ? ` Exact-path persistence ${result.recovery.outcome}; attempts ${result.recovery.attempts}; lock ${result.recovery.lockClass ?? 'none'}; identity ${result.recovery.identity}; receipt ${result.recovery.receipt ?? 'unavailable'}. ${result.recovery.error ?? ''} Recover existing Quick artifacts with: ${result.recovery.command}` : ''}`);
         }
         process.exitCode = result.status === 'promoted' ? 0 : 1;
     });

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/validate-plan/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,UAAU,+BAA+B;IACvC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;CACjE;AAMD,wBAAgB,gCAAgC,CAC9C,SAAS,GAAE,OAAO,CAAC,+BAA+B,CAAM,GACvD,OAAO,CAmIT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/validate-plan/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,UAAU,+BAA+B;IACvC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;CACjE;AAMD,wBAAgB,gCAAgC,CAC9C,SAAS,GAAE,OAAO,CAAC,+BAA+B,CAAM,GACvD,OAAO,CAgJT"}

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

@@ -67,10 +67,20 @@ export function createProjectValidatePlanCommand(overrides = {}) {
         const workflowMode = toWorkflowMode(stateFrontmatter?.['oat_workflow_mode']);
         const profile = resolvePlanProfile(workflowMode);
         const phaseIds = extractPhaseIds(content, profile);
+        let implementationContent = null;
+        if (profile === 'goal') {
+            try {
+                implementationContent = readFileSync(join(projectPath, 'implementation.md'), 'utf-8');
+            }
+            catch {
+                implementationContent = null;
+            }
+        }
         const issues = validatePlanForProfile(content, {
             profile,
             workflowMode,
             stateFrontmatter,
+            implementationContent,
         });
         const profileErrors = issues
             .filter((issue) => issue.severity === 'error')

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

@@ -1,4 +1,4 @@
-import { type WorkflowMode } from '@open-agent-toolkit/control-plane';
+import { type MilestoneMembershipErrorCode, type WorkflowMode } from '@open-agent-toolkit/control-plane';
 /**
  * Plan validation profiles. Each workflow mode validates `plan.md` against
  * one profile:
@@ -8,21 +8,30 @@ import { type WorkflowMode } from '@open-agent-toolkit/control-plane';
  * - `lite`: the lite single-phase rules.
  * - `brief`: taskless phase blocks (`**Intent:**`, `**Exit evidence:**`,
  *   optional `**Provisional:**`). Phase ids come from `## Phase` headings.
- * - `goal`: reserved for the goal mode; until its milestone rules land it
- *   validates exactly like `brief`.
+ * - `goal`: every `brief` rule plus the goal milestone rules: membership
+ *   read through the control-plane Milestones reader (its error codes map
+ *   onto `goal-*` codes), frozen delivery scopes from `oat_deliveries`,
+ *   parallel groups inside one milestone, `oat_plan_source: goal`, and
+ *   canonical phase ids in persisted registry lists.
  */
 export type PlanProfile = 'task' | 'lite' | 'brief' | 'goal';
 export interface ValidationContext {
     profile: PlanProfile;
     workflowMode: WorkflowMode | null;
     stateFrontmatter: Record<string, unknown> | null;
+    /**
+     * The journal (`implementation.md`), when readable. Goal membership reads it
+     * so a phase the journal marks extracted need not belong to a milestone.
+     */
+    implementationContent?: string | null;
 }
 export type BriefValidationErrorCode = 'brief-no-phases' | 'brief-duplicate-phase' | 'brief-phase-missing-intent' | 'brief-phase-missing-exit-evidence' | 'brief-provisional-invalid' | 'brief-first-phase-provisional' | 'brief-malformed-phase-heading';
 export type BriefValidationWarningCode = 'brief-task-headings-ignored';
+export type GoalValidationErrorCode = 'goal-milestones-missing' | 'goal-milestones-malformed' | 'goal-duplicate-milestone' | 'goal-milestone-empty' | 'goal-milestone-unknown-phase' | 'goal-phase-in-multiple-milestones' | 'goal-phase-without-milestone' | 'goal-shipped-milestone-changed' | 'goal-delivered-scope-changed' | 'goal-group-crosses-milestone' | 'goal-plan-source' | 'goal-noncanonical-phase-id';
 export type LiteValidationErrorCode = 'lite-multi-phase' | 'lite-parallel-groups' | 'lite-criterion-without-command';
 export type ValidationIssue = {
     severity: 'error';
-    code: BriefValidationErrorCode | LiteValidationErrorCode;
+    code: BriefValidationErrorCode | GoalValidationErrorCode | LiteValidationErrorCode;
     message: string;
 } | {
     severity: 'warning';
@@ -51,4 +60,10 @@ export declare function parsePhaseHeadingLine(line: string): {
 } | null;
 export declare function extractPhaseIds(content: string, profile: PlanProfile): string[];
 export declare function validatePlanForProfile(content: string, ctx: ValidationContext): ValidationIssue[];
+/**
+ * Each Milestones reader error code maps onto exactly one goal rule code, so
+ * the reader stays the one membership predicate and validation never
+ * re-parses the table.
+ */
+export declare const GOAL_MEMBERSHIP_RULE_CODES: Readonly<Record<MilestoneMembershipErrorCode, GoalValidationErrorCode>>;
 //# sourceMappingURL=profiles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/validate-plan/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,mCAAmC,CAAC;AAI3C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,uBAAuB,GACvB,4BAA4B,GAC5B,mCAAmC,GACnC,2BAA2B,GAC3B,+BAA+B,GAC/B,+BAA+B,CAAC;AAEpC,MAAM,MAAM,0BAA0B,GAAG,6BAA6B,CAAC;AAEvE,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAClB,sBAAsB,GACtB,gCAAgC,CAAC;AAErC,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,wBAAwB,GAAG,uBAAuB,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,0BAA0B,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,WAAW,CAIzE;AAMD,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EACA,kBAAkB,GAClB,sBAAsB,GACtB,gCAAgC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAeN,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,wBAAwB,CA8C1B;AAeD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG1C;AAiBD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,GACnB,MAAM,EAAE,CAIV;AA0LD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,iBAAiB,GACrB,eAAe,EAAE,CAcnB"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/validate-plan/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,4BAA4B,EACjC,KAAK,YAAY,EAClB,MAAM,mCAAmC,CAAC;AAI3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,uBAAuB,GACvB,4BAA4B,GAC5B,mCAAmC,GACnC,2BAA2B,GAC3B,+BAA+B,GAC/B,+BAA+B,CAAC;AAEpC,MAAM,MAAM,0BAA0B,GAAG,6BAA6B,CAAC;AAEvE,MAAM,MAAM,uBAAuB,GAC/B,yBAAyB,GACzB,2BAA2B,GAC3B,0BAA0B,GAC1B,sBAAsB,GACtB,8BAA8B,GAC9B,mCAAmC,GACnC,8BAA8B,GAC9B,gCAAgC,GAChC,8BAA8B,GAC9B,8BAA8B,GAC9B,kBAAkB,GAClB,4BAA4B,CAAC;AAEjC,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAClB,sBAAsB,GACtB,gCAAgC,CAAC;AAErC,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EACA,wBAAwB,GACxB,uBAAuB,GACvB,uBAAuB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,0BAA0B,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,WAAW,CAIzE;AAMD,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EACA,kBAAkB,GAClB,sBAAsB,GACtB,gCAAgC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAeN,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,wBAAwB,CA8C1B;AAeD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG1C;AAiBD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,GACnB,MAAM,EAAE,CAIV;AA0LD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,iBAAiB,GACrB,eAAe,EAAE,CAenB;AAMD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAC/C,MAAM,CAAC,4BAA4B,EAAE,uBAAuB,CAAC,CAS9D,CAAC"}

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

@@ -1,4 +1,4 @@
-import { isBriefMode, parseProvisionalPhaseIds, parseTaskProgress, recordLineMask, } from '@open-agent-toolkit/control-plane';
+import { isBriefMode, normalizeMilestoneId, normalizePhaseId, parseProvisionalPhaseIds, parseTaskProgress, readMilestoneMembership, recordLineMask, } from '@open-agent-toolkit/control-plane';
 import { parseFrontmatterFromContent } from './frontmatter.js';
 export function resolvePlanProfile(mode) {
     if (mode === 'lite')
@@ -261,9 +261,160 @@ export function validatePlanForProfile(content, ctx) {
                 : [{ severity: 'error', code: result.code, message: result.message }];
         }
         case 'brief':
-        case 'goal':
             return validateBriefPlan(content);
+        case 'goal':
+            return [...validateBriefPlan(content), ...validateGoalPlan(content, ctx)];
         case 'task':
             return [];
     }
 }
+// ---------------------------------------------------------------------------
+// goal profile
+// ---------------------------------------------------------------------------
+/**
+ * Each Milestones reader error code maps onto exactly one goal rule code, so
+ * the reader stays the one membership predicate and validation never
+ * re-parses the table.
+ */
+export const GOAL_MEMBERSHIP_RULE_CODES = {
+    'milestones-missing': 'goal-milestones-missing',
+    'milestones-malformed': 'goal-milestones-malformed',
+    'milestone-duplicate': 'goal-duplicate-milestone',
+    'milestone-empty': 'goal-milestone-empty',
+    'milestone-unknown-phase': 'goal-milestone-unknown-phase',
+    'phase-in-multiple-milestones': 'goal-phase-in-multiple-milestones',
+    'phase-without-milestone': 'goal-phase-without-milestone',
+};
+function goalError(code, message) {
+    return { severity: 'error', code, message: `${code}: ${message}` };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function rawList(value) {
+    return Array.isArray(value) ? value : [];
+}
+function readRawDeliveries(state) {
+    return rawList(state?.['oat_deliveries'])
+        .filter(isRecord)
+        .map((entry, index) => ({
+        label: typeof entry['delivery_id'] === 'string'
+            ? entry['delivery_id']
+            : `oat_deliveries[${index}]`,
+        milestone: normalizeMilestoneId(entry['milestone']),
+        scope: rawList(entry['scope'])
+            .map((token) => normalizePhaseId(String(token)))
+            .filter((token) => token !== null),
+    }));
+}
+/**
+ * Persisted phase-id lists in the goal registry. The state reader normalizes
+ * these and drops tokens that are not phase ids; validation reports every
+ * token that is not already canonical so the drift is repaired at its source.
+ */
+function persistedPhaseIdLists(state) {
+    if (state === null)
+        return [];
+    const lists = [];
+    const carrierLists = (prefix, carrier) => {
+        if (isRecord(carrier) && isRecord(carrier['subject'])) {
+            lists.push({
+                field: `${prefix}.subject.scope`,
+                values: rawList(carrier['subject']['scope']),
+            });
+        }
+    };
+    const recovery = state['oat_goal_recovery'];
+    if (isRecord(recovery)) {
+        lists.push({
+            field: 'oat_goal_recovery.phase_ids',
+            values: rawList(recovery['phase_ids']),
+        });
+    }
+    for (const [index, entry] of rawList(state['oat_deliveries']).entries()) {
+        if (!isRecord(entry))
+            continue;
+        const prefix = `oat_deliveries[${index}]`;
+        lists.push({ field: `${prefix}.scope`, values: rawList(entry['scope']) });
+        if (isRecord(entry['integrated_review'])) {
+            lists.push({
+                field: `${prefix}.integrated_review.scope`,
+                values: rawList(entry['integrated_review']['scope']),
+            });
+        }
+        carrierLists(`${prefix}.exit_gate`, entry['exit_gate']);
+    }
+    const gates = state['oat_milestone_gates'];
+    if (isRecord(gates)) {
+        for (const [milestone, carriers] of Object.entries(gates)) {
+            if (!isRecord(carriers))
+                continue;
+            carrierLists(`oat_milestone_gates.${milestone}.plan`, carriers['plan']);
+            carrierLists(`oat_milestone_gates.${milestone}.exit`, carriers['exit']);
+        }
+    }
+    return lists;
+}
+function validateGoalPlan(content, ctx) {
+    const issues = [];
+    const frontmatter = parseFrontmatterFromContent(content);
+    const planData = frontmatter.kind === 'invalid' ? {} : frontmatter.data;
+    if (planData['oat_plan_source'] !== 'goal') {
+        issues.push(goalError('goal-plan-source', `Goal plans must declare "oat_plan_source: goal"; found ${JSON.stringify(planData['oat_plan_source'] ?? null)}.`));
+    }
+    const membership = readMilestoneMembership(content, ctx.implementationContent ?? '');
+    for (const error of membership.errors) {
+        issues.push(goalError(GOAL_MEMBERSHIP_RULE_CODES[error.code], error.message));
+    }
+    const owners = new Map();
+    for (const row of membership.milestones) {
+        for (const phaseId of row.phaseIds) {
+            if (!owners.has(phaseId))
+                owners.set(phaseId, row.milestoneId);
+        }
+    }
+    const declaredMilestones = new Set(membership.milestones.map((row) => row.milestoneId));
+    const declaredPhases = new Set(extractBriefPhaseIds(content));
+    for (const delivery of readRawDeliveries(ctx.stateFrontmatter)) {
+        if (!membership.present || delivery.milestone === null)
+            continue;
+        if (!declaredMilestones.has(delivery.milestone)) {
+            issues.push(goalError('goal-shipped-milestone-changed', `Delivery ${delivery.label} shipped milestone ${delivery.milestone}, which the Milestones table no longer declares.`));
+            continue;
+        }
+        for (const phaseId of delivery.scope) {
+            if (!declaredPhases.has(phaseId)) {
+                issues.push(goalError('goal-delivered-scope-changed', `Delivery ${delivery.label} froze ${phaseId} in its scope, but the brief no longer declares it.`));
+                continue;
+            }
+            const owner = owners.get(phaseId);
+            if (owner !== undefined && owner !== delivery.milestone) {
+                issues.push(goalError('goal-delivered-scope-changed', `Delivery ${delivery.label} froze ${phaseId} under ${delivery.milestone}, but the Milestones table now assigns it to ${owner}.`));
+            }
+            else if (owner === undefined) {
+                issues.push(goalError('goal-delivered-scope-changed', `Delivery ${delivery.label} froze ${phaseId} under ${delivery.milestone}, but the Milestones table no longer lists it there.`));
+            }
+        }
+    }
+    for (const [index, group] of rawList(planData['oat_plan_parallel_groups']).entries()) {
+        const groupOwners = new Set();
+        for (const member of rawList(group)) {
+            const phaseId = normalizePhaseId(String(member));
+            const owner = phaseId === null ? undefined : owners.get(phaseId);
+            if (owner !== undefined)
+                groupOwners.add(owner);
+        }
+        if (groupOwners.size > 1) {
+            issues.push(goalError('goal-group-crosses-milestone', `Parallel group ${index} spans milestones ${[...groupOwners].join(', ')}; a group must sit inside one milestone.`));
+        }
+    }
+    for (const { field, values } of persistedPhaseIdLists(ctx.stateFrontmatter)) {
+        for (const value of values) {
+            const token = typeof value === 'string' ? value : String(value);
+            if (normalizePhaseId(token) !== token) {
+                issues.push(goalError('goal-noncanonical-phase-id', `${field} holds ${JSON.stringify(value)}, which is not a canonical phase id like "p01" or "p-rev1".`));
+            }
+        }
+    }
+    return issues;
+}

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

@@ -24,7 +24,7 @@ export declare const SKILL_GATE_OVERRIDE_SOURCE = "state.md:oat_skill_gate_overr
  * `skills.test.ts` pins this constant against the live `oat_gateable: true`
  * declarations so the two cannot drift apart.
  */
-export declare const GATE_AWARE_SKILLS: readonly ['oat-project-brief', 'oat-project-implement', 'oat-project-import-plan', 'oat-project-lite', 'oat-project-plan', 'oat-project-quick-start'];
+export declare const GATE_AWARE_SKILLS: readonly ['oat-project-brief', 'oat-project-goal', 'oat-project-implement', 'oat-project-import-plan', 'oat-project-lite', 'oat-project-plan', 'oat-project-quick-start'];
 export type SkillGateOverrideValue = typeof SKILL_GATE_OVERRIDE_DISABLED;
 export interface ProjectSkillGateOverrides {
     /** False when the key is absent entirely: absence means follow configuration. */