@open-agent-toolkit/cli 0.2.58 → 0.2.62

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

@@ -63,6 +63,9 @@ async function recordDetectedRecommendation(repoRoot, document, dependencies) {
         throw new Error('Cannot record detected split recommendation without an active project');
     }
     const discoveryPath = join(repoRoot, localConfig.activeProject, 'discovery.md');
+    if (!(await exists(discoveryPath, dependencies))) {
+        return false;
+    }
     await dependencies.appendFile(discoveryPath, [
         '',
         '## Detected Split Recommendation',
@@ -74,6 +77,7 @@ async function recordDetectedRecommendation(repoRoot, document, dependencies) {
             .join(', ')}`,
         '',
     ].join('\n'), 'utf8');
+    return true;
 }
 function isEffectivelyNonInteractive(options, context, processEnv) {
     return (options.nonInteractive === true ||
@@ -180,7 +184,10 @@ export function createProjectSplitRunCommand(overrides = {}) {
             if (isEffectivelyNonInteractive(options, context, dependencies.processEnv) &&
                 (document.origin === 'detected-mid-stream' ||
                     document.origin === 'detected-convergence')) {
-                await recordDetectedRecommendation(repoRoot, document, dependencies);
+                const recorded = await recordDetectedRecommendation(repoRoot, document, dependencies);
+                if (!recorded) {
+                    context.logger.info('skipped split recommendation: no discovery.md for this project');
+                }
                 context.logger.error('Detected split requires interactive confirmation; recommendation recorded.');
                 process.exitCode = 1;
                 return;

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;AAE9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,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,CA0ET"}
+{"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;AAE9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,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,CAsGT"}

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

@@ -3,7 +3,7 @@ import { join } from 'node:path';
 import { buildCommandContext, } from '../../../app/command-context.js';
 import { readGlobalOptions } from '../../shared/shared.utils.js';
 import { Command } from 'commander';
-import { extractPhaseIdsFromPlan, parseFrontmatterFromContent, validateParallelGroups, } from './validate-plan.js';
+import { extractPhaseIdsFromPlan, parseFrontmatterFromContent, validateLitePlan, validateParallelGroups, } from './validate-plan.js';
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
 };
@@ -47,6 +47,30 @@ export function createProjectValidatePlanCommand(overrides = {}) {
         }
         const groups = frontmatterResult.data['oat_plan_parallel_groups'];
         const phaseIds = extractPhaseIdsFromPlan(content);
+        let workflowMode = null;
+        try {
+            const stateContent = readFileSync(join(options.projectPath, 'state.md'), 'utf-8');
+            const stateFrontmatter = parseFrontmatterFromContent(stateContent);
+            const mode = stateFrontmatter.kind === 'invalid'
+                ? null
+                : stateFrontmatter.data['oat_workflow_mode'];
+            workflowMode = typeof mode === 'string' ? mode : null;
+        }
+        catch {
+            workflowMode = null;
+        }
+        const liteResult = validateLitePlan(content, workflowMode);
+        if (!liteResult.ok) {
+            if (context.json) {
+                context.logger.json({ valid: false, errors: [liteResult.message] });
+            }
+            else {
+                context.logger.error('Plan validation failed:');
+                context.logger.error(`  - ${liteResult.message}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
         const result = validateParallelGroups(groups, phaseIds);
         if (result.valid) {
             if (context.json) {

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

@@ -15,6 +15,14 @@ export type ValidationResult = {
     valid: false;
     errors: string[];
 };
+export type LitePlanValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: 'lite-multi-phase' | 'lite-parallel-groups' | 'lite-criterion-without-command';
+    message: string;
+};
+export declare function validateLitePlan(planContent: string, workflowMode: string | null | undefined): LitePlanValidationResult;
 export declare function validateParallelGroups(groups: unknown, phaseIds: readonly string[]): ValidationResult;
 export declare function extractPhaseIdsFromPlan(planContent: string): string[];
 //# sourceMappingURL=validate-plan.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"validate-plan.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/validate-plan/validate-plan.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GACd,iBAAiB,CAyBnB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,gBAAgB,CAgDlB;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrE"}
+{"version":3,"file":"validate-plan.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/validate-plan/validate-plan.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GACd,iBAAiB,CAyBnB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvC,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,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,gBAAgB,CAgDlB;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrE"}

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

@@ -25,6 +25,55 @@ export function parseFrontmatterFromContent(content) {
         };
     }
 }
+function validationCriteria(planContent) {
+    const heading = /^## Validation Criteria[ \t]*$/m.exec(planContent);
+    if (!heading)
+        return null;
+    const bodyStart = heading.index + heading[0].length;
+    const remaining = planContent.slice(bodyStart);
+    const nextHeading = /^##\s+/m.exec(remaining);
+    const body = remaining.slice(0, nextHeading?.index ?? remaining.length);
+    return body
+        .split('\n')
+        .filter((line) => /^\s*-\s+/.test(line))
+        .map((line) => line.replace(/^\s*-\s+(?:\[[ xX]\]\s*)?/, '').trim());
+}
+export function validateLitePlan(planContent, workflowMode) {
+    if (workflowMode !== 'lite') {
+        return { ok: true };
+    }
+    const phaseCount = planContent.match(/^## Phase\b.*$/gm)?.length ?? 0;
+    if (phaseCount !== 1) {
+        return {
+            ok: false,
+            code: 'lite-multi-phase',
+            message: `Lite plans must contain exactly one phase; found ${phaseCount}.`,
+        };
+    }
+    const frontmatter = parseFrontmatterFromContent(planContent);
+    const groups = frontmatter.kind === 'invalid'
+        ? undefined
+        : frontmatter.data['oat_plan_parallel_groups'];
+    if (groups !== undefined &&
+        groups !== null &&
+        !(Array.isArray(groups) && groups.length === 0)) {
+        return {
+            ok: false,
+            code: 'lite-parallel-groups',
+            message: 'Lite plans must declare no parallel groups.',
+        };
+    }
+    const criteria = validationCriteria(planContent);
+    const invalidCriterion = criteria?.find((criterion) => !criterion.startsWith('manual:') && !/`[^`\n]+`/.test(criterion));
+    if (!criteria || criteria.length === 0 || invalidCriterion !== undefined) {
+        return {
+            ok: false,
+            code: 'lite-criterion-without-command',
+            message: 'Every lite Validation Criteria bullet must name a command in backticks or start with manual: after the bullet marker.',
+        };
+    }
+    return { ok: true };
+}
 export function validateParallelGroups(groups, phaseIds) {
     // Missing or empty → valid (sequential execution, no parallelism declared)
     if (groups === undefined || groups === null) {

package/dist/commands/remove/skill/remove-skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remove-skill.d.ts","sourceRoot":"","sources":["../../../../src/commands/remove/skill/remove-skill.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EACL,iBAAiB,EAElB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,aAAa,EAInB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,KAAK,yBAAyB,EAG9B,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,KAC1C,cAAc,CAAC;IACpB,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,WAAW,EAAE,MAAM,eAAe,EAAE,CAAC;IACrC,sBAAsB,EAAE,CACtB,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,KACf,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,KAAK,WAAW,EAAE,CAAC;IAC3E,kBAAkB,EAAE,CAClB,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,KAAK,KACT,cAAc,EAAE,CAAC;IACtB,iCAAiC,EAAE,CACjC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,wBAAgB,oCAAoC,IAAI,uBAAuB,CA0C9E;AA2OD,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,uBAAuB,GACpC,OAAO,CAAC,OAAO,CAAC,CAsDlB;AAED,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAwCT"}
+{"version":3,"file":"remove-skill.d.ts","sourceRoot":"","sources":["../../../../src/commands/remove/skill/remove-skill.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EACL,iBAAiB,EAElB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,aAAa,EAKnB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,KAAK,yBAAyB,EAG9B,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqCpC,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,KAC1C,cAAc,CAAC;IACpB,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,WAAW,EAAE,MAAM,eAAe,EAAE,CAAC;IACrC,sBAAsB,EAAE,CACtB,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,KACf,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,KAAK,WAAW,EAAE,CAAC;IAC3E,kBAAkB,EAAE,CAClB,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,KAAK,KACT,cAAc,EAAE,CAAC;IACtB,iCAAiC,EAAE,CACjC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,wBAAgB,oCAAoC,IAAI,uBAAuB,CA0C9E;AAiPD,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,uBAAuB,GACpC,OAAO,CAAC,OAAO,CAAC,CA2DlB;AAED,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAwCT"}

package/dist/commands/remove/skill/remove-skill.js

@@ -7,7 +7,7 @@ import { DEFAULT_SYNC_CONFIG, loadSyncConfig, } from '../../../config/sync-confi
 import { classifyObsoleteMappingRetirement, } from '../../../engine/index.js';
 import { dirExists, fileExists } from '../../../fs/io.js';
 import { resolveProjectRoot, resolveScopeRoot, toPosixPath } from '../../../fs/paths.js';
-import { loadManifest, removeEntry, saveManifest, } from '../../../manifest/index.js';
+import { detectManifestVersionRestamp, formatManifestVersionRestampWarning, loadManifest, removeEntry, saveManifest, } from '../../../manifest/index.js';
 import { claudeAdapter } from '../../../providers/claude/index.js';
 import { codexAdapter } from '../../../providers/codex/index.js';
 import { copilotAdapter } from '../../../providers/copilot/index.js';
@@ -179,6 +179,7 @@ async function buildScopePlan(scope, scopeRoot, skillName, dependencies) {
         managedProviderViews: dedupeViews(managedProviderViews),
         unmanagedProviderViews: dedupeViews(unmanagedProviderViews),
         manifestProvidersToRemove: [...manifestProvidersToRemove],
+        versionRestamp: detectManifestVersionRestamp(scope, manifest),
     };
 }
 function logDryRun(context, plan) {
@@ -217,6 +218,9 @@ async function applyPlan(context, plan, dependencies) {
     for (const provider of plan.manifestProvidersToRemove) {
         nextManifest = removeEntry(nextManifest, plan.canonicalRelativePath, provider);
     }
+    if (plan.versionRestamp && !context.json) {
+        context.logger.warn(formatManifestVersionRestampWarning('remove skill', plan.versionRestamp));
+    }
     await dependencies.saveManifest(plan.manifestPath, nextManifest);
     context.logger.info(`[apply][${plan.scope}] removed ${plan.canonicalRelativePath}`);
     if (plan.unmanagedProviderViews.length > 0) {
@@ -267,6 +271,11 @@ export async function runRemoveSkill(context, skillName, dryRun, dependencies) {
             status: 'removed',
             skill: skillName,
             scopes: toJsonScopeResults(plans),
+            // Applied restamps only. The dry-run payload deliberately omits this
+            // field rather than naming a restamp that no save will perform.
+            manifestVersionRestamps: plans
+                .map((plan) => plan.versionRestamp)
+                .filter((restamp) => restamp !== undefined),
         });
     }
     return true;

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

@@ -1,12 +1,43 @@
 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_implement_exit_gate', '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 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_implement_exit_gate', 'oat_skill_gate_overrides', '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 const SKILL_GATE_OVERRIDE_FIELD = "oat_skill_gate_overrides";
+export declare const SKILL_GATE_OVERRIDE_DISABLED = "disabled";
+export declare const SKILL_GATE_OVERRIDE_SOURCE = "state.md:oat_skill_gate_overrides";
+/**
+ * Canonical gate-aware lifecycle skills: exactly the skills declaring
+ * `oat_gateable: true` in their frontmatter, which is the only set a project
+ * override may target. An override key outside this set can never disable
+ * anything, so accepting one would silently record an inert instruction.
+ *
+ * This set does not bound which skills a configured gate may target. Gate
+ * resolution performs the same config lookup for any skill name, so a
+ * configured gate on a non-gate-aware skill still resolves and executes; it
+ * simply applies to every project because no override key for it is accepted.
+ *
+ * `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-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. */
+    present: boolean;
+    overrides: Record<string, SkillGateOverrideValue>;
+}
+/**
+ * Strict parser for the per-project gate override map.
+ *
+ * Absence is not an error and never fabricates configuration. Every rejection
+ * names the offending project state path so the operator can repair it.
+ */
+export declare function parseSkillGateOverrides(frontmatter: string, statePath: string): ProjectSkillGateOverrides;
 export declare function getFrontmatterBlock(content: string): string | null;
 export declare function getFrontmatterField(frontmatter: string, field: string): string | null;
 export declare function parseFrontmatterScalarFields(frontmatter: string, fields: readonly 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":"AAKA,eAAO,MAAM,mBAAmB,YAAI,gBAAgB,EAAE,cAAc,CAAU,CAAC;AAE/E,eAAO,MAAM,oBAAoB,YAC/B,WAAW,EACX,MAAM,EACN,QAAQ,EACR,MAAM,EACN,WAAW,EACX,eAAe,CACP,CAAC;AAEX,eAAO,MAAM,gCAAgC,YAC3C,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,mCAAmC,EACnC,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,mBAAmB,CACX,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,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA4BpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxD;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":"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"}

package/dist/commands/shared/frontmatter.js

@@ -29,6 +29,7 @@ export const PROJECT_STATE_FRONTMATTER_FIELDS = [
     'oat_hill_completed',
     'oat_parallel_execution',
     'oat_implement_exit_gate',
+    'oat_skill_gate_overrides',
     'oat_pr_status',
     'oat_pr_url',
     'oat_project_created',
@@ -48,6 +49,98 @@ export function isProjectStatePhase(value) {
 export function isProjectStateFrontmatterField(value) {
     return PROJECT_STATE_FRONTMATTER_FIELDS.includes(value);
 }
+const hasOwnProperty = Object.prototype.hasOwnProperty;
+export const SKILL_GATE_OVERRIDE_FIELD = 'oat_skill_gate_overrides';
+export const SKILL_GATE_OVERRIDE_DISABLED = 'disabled';
+export const SKILL_GATE_OVERRIDE_SOURCE = `state.md:${SKILL_GATE_OVERRIDE_FIELD}`;
+/**
+ * Canonical gate-aware lifecycle skills: exactly the skills declaring
+ * `oat_gateable: true` in their frontmatter, which is the only set a project
+ * override may target. An override key outside this set can never disable
+ * anything, so accepting one would silently record an inert instruction.
+ *
+ * This set does not bound which skills a configured gate may target. Gate
+ * resolution performs the same config lookup for any skill name, so a
+ * configured gate on a non-gate-aware skill still resolves and executes; it
+ * simply applies to every project because no override key for it is accepted.
+ *
+ * `skills.test.ts` pins this constant against the live `oat_gateable: true`
+ * declarations so the two cannot drift apart.
+ */
+export const GATE_AWARE_SKILLS = [
+    'oat-project-implement',
+    'oat-project-import-plan',
+    'oat-project-lite',
+    'oat-project-plan',
+    'oat-project-quick-start',
+];
+function skillGateOverrideError(statePath, detail) {
+    return new Error(`${statePath}: \`${SKILL_GATE_OVERRIDE_FIELD}\` ${detail}. Use a map of gate-aware skill names to the literal value \`${SKILL_GATE_OVERRIDE_DISABLED}\`, or remove the key to follow configured gates.`);
+}
+/**
+ * Strict parser for the per-project gate override map.
+ *
+ * Absence is not an error and never fabricates configuration. Every rejection
+ * names the offending project state path so the operator can repair it.
+ */
+export function parseSkillGateOverrides(frontmatter, statePath) {
+    const document = YAML.parseDocument(frontmatter, { uniqueKeys: true });
+    if (document.errors.length > 0) {
+        throw skillGateOverrideError(statePath, `cannot be read because the frontmatter is malformed (${document.errors[0]?.message ?? 'YAML parse error'})`);
+    }
+    // A scalar or sequence root is malformed project state, not "no overrides":
+    // returning an empty map here would silently launch a disabled gate.
+    if (!isMap(document.contents)) {
+        throw skillGateOverrideError(statePath, 'cannot be read because the frontmatter root is not a YAML map');
+    }
+    const matches = document.contents.items.filter((pair) => isScalar(pair.key) && pair.key.value === SKILL_GATE_OVERRIDE_FIELD);
+    if (matches.length === 0) {
+        return { present: false, overrides: {} };
+    }
+    // `uniqueKeys` already rejects a duplicate top-level key above; this stays as
+    // a fail-closed guard rather than silently reading the first of several.
+    if (matches.length > 1) {
+        throw skillGateOverrideError(statePath, 'is declared more than once');
+    }
+    const value = matches[0]?.value;
+    // An explicitly null or empty map is a deliberate "no overrides" statement.
+    if (value === null || (isScalar(value) && value.value === null)) {
+        return { present: true, overrides: {} };
+    }
+    if (!isMap(value)) {
+        throw skillGateOverrideError(statePath, 'must be a map of skill names to `disabled`');
+    }
+    const overrides = {};
+    for (const pair of value.items) {
+        if (!isScalar(pair.key) || typeof pair.key.value !== 'string') {
+            throw skillGateOverrideError(statePath, 'has a non-string skill key');
+        }
+        // Exact spelling only: a padded or decorated key is not the skill name.
+        const skill = pair.key.value;
+        if (!skill) {
+            throw skillGateOverrideError(statePath, 'has an empty skill key');
+        }
+        if (pair.key.anchor !== undefined || pair.key.tag !== undefined) {
+            throw skillGateOverrideError(statePath, `decorates the key \`${skill}\` with a YAML anchor or tag`);
+        }
+        if (!GATE_AWARE_SKILLS.includes(skill)) {
+            throw skillGateOverrideError(statePath, `names \`${skill}\`, which is not a gate-aware skill`);
+        }
+        if (hasOwnProperty.call(overrides, skill)) {
+            throw skillGateOverrideError(statePath, `declares \`${skill}\` more than once`);
+        }
+        const entry = pair.value;
+        if (!isScalar(entry) ||
+            entry.anchor !== undefined ||
+            entry.tag !== undefined ||
+            typeof entry.value !== 'string' ||
+            entry.value !== SKILL_GATE_OVERRIDE_DISABLED) {
+            throw skillGateOverrideError(statePath, `sets \`${skill}\` to an unsupported value`);
+        }
+        overrides[skill] = SKILL_GATE_OVERRIDE_DISABLED;
+    }
+    return { present: true, overrides };
+}
 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":"AAQA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAU9E,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;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;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;AAsgBD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAkF9B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/state/generate.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAU9E,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;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;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;AAkHD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvE;AAgiBD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAkF9B"}

package/dist/commands/state/generate.js

@@ -88,6 +88,8 @@ async function readProjectState(repoRoot, projectPath) {
     const stateFile = join(repoRoot, projectPath, 'state.md');
     const phase = (await parseFrontmatterField(stateFile, 'oat_phase')) || 'unknown';
     const phaseStatus = (await parseFrontmatterField(stateFile, 'oat_phase_status')) || 'unknown';
+    const readyForRaw = await parseFrontmatterField(stateFile, 'oat_ready_for');
+    const readyFor = readyForRaw && readyForRaw !== 'null' ? readyForRaw : '';
     let currentTask = await parseFrontmatterField(stateFile, 'oat_current_task');
     if (!currentTask || currentTask === 'null')
         currentTask = '-';
@@ -115,6 +117,7 @@ async function readProjectState(repoRoot, projectPath) {
     return {
         phase,
         phaseStatus,
+        readyFor,
         currentTask,
         lifecycle,
         pauseTimestamp,
@@ -230,6 +233,15 @@ function computeNextStep(project, hasProjects, state) {
             reason: `Complete ${state.phase} HiLL approval before advancing`,
         };
     }
+    if (state.workflowMode === 'quick' &&
+        state.phase === 'discovery' &&
+        state.phaseStatus === 'complete' &&
+        state.readyFor === 'oat-project-quick-start') {
+        return {
+            step: 'oat-project-quick-start',
+            reason: 'Continue the promoted quick workflow',
+        };
+    }
     // Workflow mode routing
     const key = `${state.workflowMode}:${state.phase}:${state.phaseStatus}`;
     const routeMap = {
@@ -271,6 +283,10 @@ function computeNextStep(project, hasProjects, state) {
             step: 'oat-project-import-plan',
             reason: 'Continue import-plan normalization',
         },
+        'lite:plan:in_progress': {
+            step: 'oat-project-lite',
+            reason: 'Continue lite planning',
+        },
     };
     if (routeMap[key])
         return routeMap[key];
@@ -298,6 +314,12 @@ function computeNextStep(project, hasProjects, state) {
         return sharedMap[sharedKey];
     // Implementation complete — recommend docs sync if not yet done, then PR
     if (state.phase === 'implement' && state.phaseStatus === 'complete') {
+        if (state.workflowMode === 'lite') {
+            return {
+                step: 'oat-project-pr-final',
+                reason: 'Generate final PR description from plan and implementation',
+            };
+        }
         if (!state.docsUpdated || state.docsUpdated === '') {
             return {
                 step: 'oat-project-document',
@@ -469,6 +491,7 @@ function buildDashboardMarkdown(project, state, knowledge, staleness, nextStep,
     lines.push('- `oat-project-new` - Create a spec-driven project');
     lines.push('- `oat-project-quick-start` - Create a quick workflow project');
     lines.push('- `oat-project-import-plan` - Import an external provider plan');
+    lines.push('- `oat-project-lite` - Create a lite workflow project');
     lines.push('- `oat project open <name>` - Open or resume a project');
     lines.push('- `oat project pause [name]` - Pause active or named project');
     lines.push('- `oat-project-complete` - Mark project complete');

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

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

package/dist/commands/status/index.js

@@ -17,7 +17,7 @@ import { detectDrift, detectStrays, filterKnownStrays, } from '../../drift/index
 import { HOOK_DRIFT_WARNING, HOOK_STRAY_INFO, mergeUserScopeMaterializationEntries, scanBundledManagedAgents, scanCanonical, } from '../../engine/index.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
 import { normalizeToPosixPath, resolveProjectRoot, resolveScopeRoot, } from '../../fs/paths.js';
-import { loadManifest, saveManifest } from '../../manifest/manager.js';
+import { detectManifestVersionRestamp, formatManifestVersionRestampWarning, loadManifest, saveManifest, } from '../../manifest/manager.js';
 import { applyCodexProjectExtensionPlan, computeCodexProjectExtensionPlan, } from '../../providers/codex/codec/sync-extension.js';
 import { applyCursorProjectExtensionPlan, computeCursorProjectExtensionPlan, } from '../../providers/cursor/codec/sync-extension.js';
 import { getConfigAwareAdapters, getProviderRegistrations, getSyncMappings, resolveProviderScopeContext, } from '../../providers/shared/index.js';
@@ -651,6 +651,7 @@ async function collectScopeReports(scope, context, dependencies) {
         activeAdapterNames,
         userAgentMaterializationCoverage: scope === 'user' ? agentCoverage : 'none',
         providerContext,
+        versionRestamp: detectManifestVersionRestamp(scope, manifest),
     };
 }
 async function runStatusCommand(context, dependencies, options = {}) {
@@ -844,6 +845,12 @@ async function runStatusCommand(context, dependencies, options = {}) {
                     }
                 }
                 if (manifestChanged) {
+                    // Placed after the collection-migration block and immediately before
+                    // the only status-owned save. An aborted migration never reaches
+                    // here, so it never claims a restamp it did not perform.
+                    if (scopeCollection.versionRestamp && !context.json) {
+                        context.logger.warn(formatManifestVersionRestampWarning('status', scopeCollection.versionRestamp));
+                    }
                     await dependencies.saveManifest(scopeCollection.manifestPath, scopeCollection.manifest);
                 }
                 if (adoptedCount > 0) {

package/dist/commands/sync/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiB3D,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EAExB,MAAM,cAAc,CAAC;AA2TtB,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,aAAa,EAAE,EAC3B,YAAY,EAAE,uBAAuB,GACpC,OAAO,CAAC,IAAI,CAAC,CA4Kf"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiB3D,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EAExB,MAAM,cAAc,CAAC;AAgVtB,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,aAAa,EAAE,EAC3B,YAAY,EAAE,uBAAuB,GACpC,OAAO,CAAC,IAAI,CAAC,CAoMf"}

package/dist/commands/sync/apply.js

@@ -126,13 +126,26 @@ function coreHumanStatus(status) {
             return 'unknown';
     }
 }
-function formatCoreResults(plan, evidence, dependencies) {
+/** The sentence `formatSyncPlan` appends to its heading for an empty plan. */
+const EMPTY_PLAN_SUFFIX = '\nNo changes required.';
+function formatCoreResults(plan, evidence, dependencies, restampOnly) {
     const operations = [...plan.entries, ...plan.removals];
     if (operations.length === 0) {
         if ((plan.collections?.length ?? 0) > 0) {
             return 'Core results\nNo per-entry operations.';
         }
-        return dependencies.formatSyncPlan(plan, true);
+        const planOutput = dependencies.formatSyncPlan(plan, true);
+        if (!restampOnly || !planOutput.endsWith(EMPTY_PLAN_SUFFIX)) {
+            return planOutput;
+        }
+        // `formatSyncPlan` appends "No changes required." to its heading for any
+        // empty plan, and it is shared with dry-run and other callers, so it stays
+        // untouched. On the restamp-only path that sentence would contradict the
+        // trailing message two lines later, so the command layer drops exactly that
+        // known suffix and lets the trailing message be the run's single claim.
+        // Removing only a matching suffix, rather than keeping the first line,
+        // means an injected formatter's other content is never truncated.
+        return planOutput.slice(0, -EMPTY_PLAN_SUFFIX.length);
     }
     const resultsByIdentity = new Map((evidence?.operationResults ?? []).map((result) => [
         syncOperationIdentity(result),
@@ -155,7 +168,12 @@ function formatCoreResults(plan, evidence, dependencies) {
         : '';
     return `Core results${aggregate}\n${lines.join('\n')}`;
 }
-function formatAppliedOutput(scopePlans, coreApplyEvidence, dependencies) {
+function formatAppliedOutput(scopePlans, coreApplyEvidence, dependencies, 
+// True when the run planned no operation at all and the manifest restamp is
+// the only mutation. It is a whole-run state, matching the single trailing
+// summary message, so with `--scope all` every scope's body is empty and at
+// least one of them was restamped.
+restampOnly) {
     if (scopePlans.length === 0) {
         return dependencies.formatSyncPlan({
             scope: 'project',
@@ -165,7 +183,7 @@ function formatAppliedOutput(scopePlans, coreApplyEvidence, dependencies) {
     }
     return scopePlans
         .map((scopePlan) => {
-        const syncOutput = formatCoreResults(scopePlan.plan, coreApplyEvidence.find((evidence) => evidence.plan === scopePlan.plan), dependencies);
+        const syncOutput = formatCoreResults(scopePlan.plan, coreApplyEvidence.find((evidence) => evidence.plan === scopePlan.plan), dependencies, restampOnly);
         const collectionOutput = formatCollectionLifecycle(buildCollectionLifecycle(scopePlan, coreApplyEvidence.find((evidence) => evidence.plan === scopePlan.plan)
             ?.collectionResults));
         if (scopePlan.materializationExtensions.length === 0) {
@@ -310,9 +328,25 @@ export async function runSyncApply(context, scopePlans, dependencies) {
         });
     }
     else {
-        context.logger.info(formatAppliedOutput(scopePlans, coreApplyEvidence, dependencies));
+        // A restamp is a real mutation: it overwrites the producing-version
+        // evidence even though no file operation was planned. Reporting "no
+        // changes required" for that case would contradict the advisory this same
+        // run just emitted, so the state is resolved once and threaded through
+        // both the plan body and the trailing message.
+        //
+        // `failed === 0` is load-bearing rather than defensive: a rejected
+        // collection is counted as a failure but is not a *planned* operation
+        // (`countPlannedOperations` admits only the mutating collection actions),
+        // so a run can fail with `plannedOperations === 0`. That run is not
+        // restamp-only and must never be described as needing no content changes.
+        const restampOnly = summary.plannedOperations === 0 &&
+            summary.failed === 0 &&
+            versionSkew.length > 0;
+        context.logger.info(formatAppliedOutput(scopePlans, coreApplyEvidence, dependencies, restampOnly));
         if (summary.plannedOperations === 0) {
-            context.logger.info('\nNo changes required.');
+            context.logger.info(restampOnly
+                ? '\nManifest version refreshed; no content changes required.'
+                : '\nNo changes required.');
         }
         else if (summary.failed > 0) {
             context.logger.warn('\nSync completed with partial failures.');

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,eAAe,CAAC;AAWvB,OAAO,EAOL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,OAAO,KAAK,EACV,aAAa,EAEb,uBAAuB,EAGxB,MAAM,cAAc,CAAC;AAEtB,KAAK,0BAA0B,GAAG,IAAI,CACpC,uBAAuB,EACvB,iBAAiB,GAAG,eAAe,CACpC,GAAG;IACF,aAAa,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,KACrC,UAAU,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1D,eAAe,EAAE,CACf,IAAI,EAAE,UAAU,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QAChE,sCAAsC,CAAC,EAAE,QAAQ,CAC/C,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAClC,CAAC;KACH,KACE,UAAU,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC5D,2BAA2B,CAAC,EAAE,CAAC,KAAK,EAAE;QACpC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,UAAU,CAAC;KACpB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrC,CAAC;AAkgBF,wBAAgB,iBAAiB,CAC/B,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CA+DT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,eAAe,CAAC;AAWvB,OAAO,EAOL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,OAAO,KAAK,EACV,aAAa,EAEb,uBAAuB,EAGxB,MAAM,cAAc,CAAC;AAEtB,KAAK,0BAA0B,GAAG,IAAI,CACpC,uBAAuB,EACvB,iBAAiB,GAAG,eAAe,CACpC,GAAG;IACF,aAAa,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,KACrC,UAAU,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1D,eAAe,EAAE,CACf,IAAI,EAAE,UAAU,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QAChE,sCAAsC,CAAC,EAAE,QAAQ,CAC/C,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAClC,CAAC;KACH,KACE,UAAU,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC5D,2BAA2B,CAAC,EAAE,CAAC,KAAK,EAAE;QACpC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,UAAU,CAAC;KACpB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrC,CAAC;AA2fF,wBAAgB,iBAAiB,CAC/B,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CA+DT"}