@girardmedia/bootspring 2.4.0 → 2.5.0

package/dist/core/index.d.ts

@@ -1848,7 +1848,7 @@ declare namespace projectState {
  * @module core/task-extractor
  */
 type TaskComplexity = 'low' | 'medium' | 'high';
-type TaskStatus = 'pending' | 'in_progress' | 'completed';
+type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'blocked' | 'skipped';
 type TaskPhase = 'foundation' | 'mvp' | 'launch' | string;
 interface Task {
     id?: string;
@@ -1913,6 +1913,10 @@ interface ExtractFromDocsOptions {
 interface SyncFromTaskQueueOptions {
     replace?: boolean | undefined;
 }
+interface SyncPlanningTasksOptions extends SyncFromTaskQueueOptions {
+    preferTodo?: boolean | undefined;
+    allowLegacyQueue?: boolean | undefined;
+}
 /**
  * Main extraction function - parse all seed documents
  */
@@ -1974,10 +1978,27 @@ declare function extractFromSeedFile(projectRoot: string): ExtractionResult;
  * Parses both table format and detailed task sections
  */
 declare function extractFromTaskQueue(content: string): Task[];
+/**
+ * Extract tasks from TODO.md
+ * Parses both the lightweight checklist format and the enriched metadata format.
+ */
+declare function extractFromTodo(content: string): Task[];
 /**
  * Load and extract from TASK_QUEUE.md in planning directory
  */
 declare function extractFromTaskQueueFile(projectRoot: string): ExtractionResult;
+/**
+ * Load and extract from TODO.md in planning directory
+ */
+declare function extractFromTodoFile(projectRoot: string): ExtractionResult;
+/**
+ * Load planning tasks from the canonical TODO.md surface first, then fall back
+ * to legacy TASK_QUEUE.md when allowed.
+ */
+declare function extractFromPlanningFiles(projectRoot: string, options?: {
+    preferTodo?: boolean | undefined;
+    allowLegacyQueue?: boolean | undefined;
+}): ExtractionResult;
 /**
  * Sync tasks from TASK_QUEUE.md to BUILD_STATE.json
  * Options:
@@ -1989,6 +2010,23 @@ declare function syncFromTaskQueue(projectRoot: string, options?: SyncFromTaskQu
     updated: number;
     total: number;
 };
+/**
+ * Sync tasks from canonical TODO.md to BUILD_STATE.json
+ */
+declare function syncFromTodo(projectRoot: string, options?: SyncFromTaskQueueOptions): {
+    added: number;
+    updated: number;
+    total: number;
+};
+/**
+ * Sync tasks from planning source of truth into BUILD_STATE.json.
+ * Canonical behavior is TODO.md-first with legacy TASK_QUEUE.md fallback.
+ */
+declare function syncFromPlanningFiles(projectRoot: string, options?: SyncPlanningTasksOptions): {
+    added: number;
+    updated: number;
+    total: number;
+};
 
 type taskExtractor_DocumentMap = DocumentMap;
 type taskExtractor_ExtractFromDocsOptions = ExtractFromDocsOptions;
@@ -1999,6 +2037,7 @@ type taskExtractor_Integrations = Integrations;
 type taskExtractor_MvpCriterion = MvpCriterion;
 type taskExtractor_RoadmapExtraction = RoadmapExtraction;
 type taskExtractor_SyncFromTaskQueueOptions = SyncFromTaskQueueOptions;
+type taskExtractor_SyncPlanningTasksOptions = SyncPlanningTasksOptions;
 type taskExtractor_Task = Task;
 type taskExtractor_TaskComplexity = TaskComplexity;
 type taskExtractor_TaskPhase = TaskPhase;
@@ -2007,6 +2046,7 @@ declare const taskExtractor_deduplicateTasks: typeof deduplicateTasks;
 declare const taskExtractor_estimateComplexity: typeof estimateComplexity;
 declare const taskExtractor_extractAcceptanceCriteria: typeof extractAcceptanceCriteria;
 declare const taskExtractor_extractFromDocs: typeof extractFromDocs;
+declare const taskExtractor_extractFromPlanningFiles: typeof extractFromPlanningFiles;
 declare const taskExtractor_extractFromPrd: typeof extractFromPrd;
 declare const taskExtractor_extractFromPreseedDir: typeof extractFromPreseedDir;
 declare const taskExtractor_extractFromRoadmap: typeof extractFromRoadmap;
@@ -2015,13 +2055,17 @@ declare const taskExtractor_extractFromSeedFile: typeof extractFromSeedFile;
 declare const taskExtractor_extractFromTaskQueue: typeof extractFromTaskQueue;
 declare const taskExtractor_extractFromTaskQueueFile: typeof extractFromTaskQueueFile;
 declare const taskExtractor_extractFromTechnicalSpec: typeof extractFromTechnicalSpec;
+declare const taskExtractor_extractFromTodo: typeof extractFromTodo;
+declare const taskExtractor_extractFromTodoFile: typeof extractFromTodoFile;
 declare const taskExtractor_extractIntegrations: typeof extractIntegrations;
 declare const taskExtractor_extractMvpCriteria: typeof extractMvpCriteria;
 declare const taskExtractor_extractSection: typeof extractSection;
 declare const taskExtractor_orderByDependencies: typeof orderByDependencies;
+declare const taskExtractor_syncFromPlanningFiles: typeof syncFromPlanningFiles;
 declare const taskExtractor_syncFromTaskQueue: typeof syncFromTaskQueue;
+declare const taskExtractor_syncFromTodo: typeof syncFromTodo;
 declare namespace taskExtractor {
-  export { type taskExtractor_DocumentMap as DocumentMap, type taskExtractor_ExtractFromDocsOptions as ExtractFromDocsOptions, type taskExtractor_ExtractSectionOptions as ExtractSectionOptions, type taskExtractor_ExtractionMetadata as ExtractionMetadata, type taskExtractor_ExtractionResult as ExtractionResult, type taskExtractor_Integrations as Integrations, type taskExtractor_MvpCriterion as MvpCriterion, type Phase$1 as Phase, type taskExtractor_RoadmapExtraction as RoadmapExtraction, type taskExtractor_SyncFromTaskQueueOptions as SyncFromTaskQueueOptions, type taskExtractor_Task as Task, type taskExtractor_TaskComplexity as TaskComplexity, type taskExtractor_TaskPhase as TaskPhase, type taskExtractor_TaskStatus as TaskStatus, taskExtractor_deduplicateTasks as deduplicateTasks, taskExtractor_estimateComplexity as estimateComplexity, taskExtractor_extractAcceptanceCriteria as extractAcceptanceCriteria, taskExtractor_extractFromDocs as extractFromDocs, taskExtractor_extractFromPrd as extractFromPrd, taskExtractor_extractFromPreseedDir as extractFromPreseedDir, taskExtractor_extractFromRoadmap as extractFromRoadmap, taskExtractor_extractFromSeed as extractFromSeed, taskExtractor_extractFromSeedFile as extractFromSeedFile, taskExtractor_extractFromTaskQueue as extractFromTaskQueue, taskExtractor_extractFromTaskQueueFile as extractFromTaskQueueFile, taskExtractor_extractFromTechnicalSpec as extractFromTechnicalSpec, taskExtractor_extractIntegrations as extractIntegrations, taskExtractor_extractMvpCriteria as extractMvpCriteria, taskExtractor_extractSection as extractSection, taskExtractor_orderByDependencies as orderByDependencies, taskExtractor_syncFromTaskQueue as syncFromTaskQueue };
+  export { type taskExtractor_DocumentMap as DocumentMap, type taskExtractor_ExtractFromDocsOptions as ExtractFromDocsOptions, type taskExtractor_ExtractSectionOptions as ExtractSectionOptions, type taskExtractor_ExtractionMetadata as ExtractionMetadata, type taskExtractor_ExtractionResult as ExtractionResult, type taskExtractor_Integrations as Integrations, type taskExtractor_MvpCriterion as MvpCriterion, type Phase$1 as Phase, type taskExtractor_RoadmapExtraction as RoadmapExtraction, type taskExtractor_SyncFromTaskQueueOptions as SyncFromTaskQueueOptions, type taskExtractor_SyncPlanningTasksOptions as SyncPlanningTasksOptions, type taskExtractor_Task as Task, type taskExtractor_TaskComplexity as TaskComplexity, type taskExtractor_TaskPhase as TaskPhase, type taskExtractor_TaskStatus as TaskStatus, taskExtractor_deduplicateTasks as deduplicateTasks, taskExtractor_estimateComplexity as estimateComplexity, taskExtractor_extractAcceptanceCriteria as extractAcceptanceCriteria, taskExtractor_extractFromDocs as extractFromDocs, taskExtractor_extractFromPlanningFiles as extractFromPlanningFiles, taskExtractor_extractFromPrd as extractFromPrd, taskExtractor_extractFromPreseedDir as extractFromPreseedDir, taskExtractor_extractFromRoadmap as extractFromRoadmap, taskExtractor_extractFromSeed as extractFromSeed, taskExtractor_extractFromSeedFile as extractFromSeedFile, taskExtractor_extractFromTaskQueue as extractFromTaskQueue, taskExtractor_extractFromTaskQueueFile as extractFromTaskQueueFile, taskExtractor_extractFromTechnicalSpec as extractFromTechnicalSpec, taskExtractor_extractFromTodo as extractFromTodo, taskExtractor_extractFromTodoFile as extractFromTodoFile, taskExtractor_extractIntegrations as extractIntegrations, taskExtractor_extractMvpCriteria as extractMvpCriteria, taskExtractor_extractSection as extractSection, taskExtractor_orderByDependencies as orderByDependencies, taskExtractor_syncFromPlanningFiles as syncFromPlanningFiles, taskExtractor_syncFromTaskQueue as syncFromTaskQueue, taskExtractor_syncFromTodo as syncFromTodo };
 }
 
 /**

package/dist/core.js

@@ -1600,7 +1600,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@girardmedia/bootspring",
-      version: "2.4.0",
+      version: "2.5.0",
       description: "Thin client for Bootspring cloud MCP, hosted agents, and paywalled workflow intelligence",
       keywords: [
         "ai",
@@ -1654,6 +1654,9 @@ var require_package = __commonJS({
         start: "node bin/bootspring.js",
         dashboard: "node bin/bootspring.js dashboard",
         mcp: "node dist/mcp-server.js",
+        "version:sync": "node scripts/sync-version-metadata.js",
+        "verify:version-sync": "node scripts/sync-version-metadata.js --check",
+        "release:prepare": "npm run version:sync && npm run build && npm test && npm run lint --if-present && npm run verify:package && npm run verify:mcp-contract && npm run verify:release-gates",
         pretest: "npm run build",
         test: "vitest run",
         "test:launch-smoke": "vitest run __tests__/unit/cli-first-run-smoke.test.js __tests__/unit/health-fresh-start.test.ts __tests__/unit/session-project-scope.test.ts __tests__/unit/auth-cli-mixed-states.test.ts __tests__/unit/api-client-project-auth-fallback.test.js __tests__/unit/cli-help-surface.test.js __tests__/unit/cli-command-manifest.test.js",
@@ -1664,7 +1667,7 @@ var require_package = __commonJS({
         "lint:fix": "eslint . --fix",
         typecheck: "tsc --noEmit",
         "typecheck:active": "tsc --noEmit -p tsconfig.active.json",
-        build: "tsup && npm run build:cli",
+        build: "npm run version:sync && tsup && npm run build:cli",
         "build:cli": "cd monorepo && pnpm build --filter @bootspring/cli && cd .. && mkdir -p dist/cli && cp monorepo/apps/cli/dist/index.cjs dist/cli/index.cjs",
         "build:watch": "tsup --watch",
         dev: "tsx watch src/index.ts",
@@ -1674,13 +1677,13 @@ var require_package = __commonJS({
         "verify:thin-client-contract": "node scripts/verify-thin-client-contract.js",
         "build:mcp-contract": "node scripts/export-mcp-contract.js",
         "verify:mcp-contract": "node scripts/export-mcp-contract.js --check",
-        "planning:sync": "node scripts/sync-planning-queue.js",
-        "planning:sync:check": "node scripts/sync-planning-queue.js --check",
-        "planning:realign": "node scripts/sync-planning-queue.js --sync-runtime",
+        "planning:sync": "node scripts/sync-planning-state.js",
+        "planning:sync:check": "node scripts/sync-planning-state.js --check",
+        "planning:realign": "node scripts/sync-planning-state.js --sync-runtime",
         "verify:package": "node scripts/check-package-boundaries.js",
         "db:sync": "node shared/db/sync.js",
         "db:sync:check": "node shared/db/sync.js --check",
-        prepublishOnly: "npm run build && npm test && npm run lint --if-present && npm run verify:package && npm run verify:mcp-contract"
+        prepublishOnly: "npm run verify:version-sync && npm run build && npm test && npm run lint --if-present && npm run verify:package && npm run verify:mcp-contract"
       },
       devDependencies: {
         "@eslint/js": "^9.39.2",

package/dist/mcp/index.d.ts

@@ -1 +1 @@
-export { A as AccessInfo, j as AgentData, k as AssistResponseData, B as BoundInvoker, l as BuildCapabilitiesOptions, C as CapabilitiesInfo, m as CapabilitiesManifest, n as ContextValidationResult, F as FilteredWorkflows, I as IntentDetectionData, o as InvocationContext, p as InvokeParallelOptions, q as InvokeSequenceOptions, r as InvokeToolOptions, s as InvokeToolResult, L as ListOptions, t as MAX_CALL_DEPTH, M as MCPCapabilities, a as MCPContent, b as MCPInputSchema, c as MCPPrompt, d as MCPPromptArgument, e as MCPPropertySchema, f as MCPResource, g as MCPTool, h as MCPToolResult, u as MCPToolResultWithMeta, O as OrchestratorStatus, P as PRDData, v as PackInfo, w as ParallelResult, x as PlatformInfo, y as PolicyInfo, z as PolicyProfile, D as ProgressInfo, E as ProjectContextDisplay, Q as QualityCheckResult, G as QualityGateResults, R as RESOURCES, H as ResourceDefinition, J as ResourceHandler, K as ResourceResponse, S as SequenceResult, N as SkillData, T as SkillsCapability, U as SuccessOptions, V as TOOLS, W as TelemetryCapability, X as TodoItem, Y as ToolCall, Z as ToolDefinition, _ as ToolHandler, $ as ToolSequenceResult, a0 as ValidationResult, a1 as WorkflowAccessContext, a2 as WorkflowDefinition, a3 as WorkflowsCapability, a4 as agentDetails, a5 as assistResponse, a6 as buildCapabilities, a7 as capabilitiesList, a8 as contextSummary, a9 as contextValidation, aa as createBoundInvoker, ab as createInvocationContext, ac as error, ad as generateProgressBar, ae as getAvailableTools, af as getCurrentContext, ag as getRegistry, ah as getToolDefinition, ai as hasTool, aj as intentDetection, ak as invokeTool, al as invokeToolParallel, am as invokeToolSequence, an as list, ao as loopStatus, ap as main, aq as orchestratorStatus, ar as qualityResults, as as resourceHandlers, at as skillDetails, au as success, av as todoList, aw as toolHandlers, ax as trackTelemetry, ay as validateDependencies, az as warning } from '../index-QqbeEiDm.js';
+export { A as AccessInfo, j as AgentData, k as AssistResponseData, B as BoundInvoker, l as BuildCapabilitiesOptions, C as CapabilitiesInfo, m as CapabilitiesManifest, n as ContextValidationResult, F as FilteredWorkflows, I as IntentDetectionData, o as InvocationContext, p as InvokeParallelOptions, q as InvokeSequenceOptions, r as InvokeToolOptions, s as InvokeToolResult, L as ListOptions, t as MAX_CALL_DEPTH, M as MCPCapabilities, a as MCPContent, b as MCPInputSchema, c as MCPPrompt, d as MCPPromptArgument, e as MCPPropertySchema, f as MCPResource, g as MCPTool, h as MCPToolResult, u as MCPToolResultWithMeta, O as OrchestratorStatus, P as PRDData, v as PackInfo, w as ParallelResult, x as PlatformInfo, y as PolicyInfo, z as PolicyProfile, D as ProgressInfo, E as ProjectContextDisplay, Q as QualityCheckResult, G as QualityGateResults, R as RESOURCES, H as ResourceDefinition, J as ResourceHandler, K as ResourceResponse, S as SequenceResult, N as SkillData, T as SkillsCapability, U as SuccessOptions, V as TOOLS, W as TelemetryCapability, X as TodoItem, Y as ToolCall, Z as ToolDefinition, _ as ToolHandler, $ as ToolSequenceResult, a0 as ValidationResult, a1 as WorkflowAccessContext, a2 as WorkflowDefinition, a3 as WorkflowsCapability, a4 as agentDetails, a5 as assistResponse, a6 as buildCapabilities, a7 as capabilitiesList, a8 as contextSummary, a9 as contextValidation, aa as createBoundInvoker, ab as createInvocationContext, ac as error, ad as generateProgressBar, ae as getAvailableTools, af as getCurrentContext, ag as getRegistry, ah as getToolDefinition, ai as hasTool, aj as intentDetection, ak as invokeTool, al as invokeToolParallel, am as invokeToolSequence, an as list, ao as loopStatus, ap as main, aq as orchestratorStatus, ar as qualityResults, as as resourceHandlers, at as skillDetails, au as success, av as todoList, aw as toolHandlers, ax as trackTelemetry, ay as validateDependencies, az as warning } from '../index-DvGc3BRk.js';

package/dist/mcp-server.js

@@ -45,7 +45,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@girardmedia/bootspring",
-      version: "2.4.0",
+      version: "2.5.0",
       description: "Thin client for Bootspring cloud MCP, hosted agents, and paywalled workflow intelligence",
       keywords: [
         "ai",
@@ -99,6 +99,9 @@ var require_package = __commonJS({
         start: "node bin/bootspring.js",
         dashboard: "node bin/bootspring.js dashboard",
         mcp: "node dist/mcp-server.js",
+        "version:sync": "node scripts/sync-version-metadata.js",
+        "verify:version-sync": "node scripts/sync-version-metadata.js --check",
+        "release:prepare": "npm run version:sync && npm run build && npm test && npm run lint --if-present && npm run verify:package && npm run verify:mcp-contract && npm run verify:release-gates",
         pretest: "npm run build",
         test: "vitest run",
         "test:launch-smoke": "vitest run __tests__/unit/cli-first-run-smoke.test.js __tests__/unit/health-fresh-start.test.ts __tests__/unit/session-project-scope.test.ts __tests__/unit/auth-cli-mixed-states.test.ts __tests__/unit/api-client-project-auth-fallback.test.js __tests__/unit/cli-help-surface.test.js __tests__/unit/cli-command-manifest.test.js",
@@ -109,7 +112,7 @@ var require_package = __commonJS({
         "lint:fix": "eslint . --fix",
         typecheck: "tsc --noEmit",
         "typecheck:active": "tsc --noEmit -p tsconfig.active.json",
-        build: "tsup && npm run build:cli",
+        build: "npm run version:sync && tsup && npm run build:cli",
         "build:cli": "cd monorepo && pnpm build --filter @bootspring/cli && cd .. && mkdir -p dist/cli && cp monorepo/apps/cli/dist/index.cjs dist/cli/index.cjs",
         "build:watch": "tsup --watch",
         dev: "tsx watch src/index.ts",
@@ -119,13 +122,13 @@ var require_package = __commonJS({
         "verify:thin-client-contract": "node scripts/verify-thin-client-contract.js",
         "build:mcp-contract": "node scripts/export-mcp-contract.js",
         "verify:mcp-contract": "node scripts/export-mcp-contract.js --check",
-        "planning:sync": "node scripts/sync-planning-queue.js",
-        "planning:sync:check": "node scripts/sync-planning-queue.js --check",
-        "planning:realign": "node scripts/sync-planning-queue.js --sync-runtime",
+        "planning:sync": "node scripts/sync-planning-state.js",
+        "planning:sync:check": "node scripts/sync-planning-state.js --check",
+        "planning:realign": "node scripts/sync-planning-state.js --sync-runtime",
         "verify:package": "node scripts/check-package-boundaries.js",
         "db:sync": "node shared/db/sync.js",
         "db:sync:check": "node shared/db/sync.js --check",
-        prepublishOnly: "npm run build && npm test && npm run lint --if-present && npm run verify:package && npm run verify:mcp-contract"
+        prepublishOnly: "npm run verify:version-sync && npm run build && npm test && npm run lint --if-present && npm run verify:package && npm run verify:mcp-contract"
       },
       devDependencies: {
         "@eslint/js": "^9.39.2",

package/generators/templates/build-planning.template.js

@@ -4,7 +4,7 @@
  * Generates planning artifacts for the autonomous build loop:
  * - MASTER_PLAN.md - Vision + phases + progress tracker
  * - TODO.md - Checkbox list by phase
- * - TASK_QUEUE.md - Ordered tasks with acceptance criteria
+ * - TASK_QUEUE.md - Legacy compatibility mirror only when explicitly requested
  * - CONTEXT.md - Condensed context for AI iterations
  *
  * @package bootspring
@@ -45,11 +45,14 @@ function generateAll(projectRoot, docs, tasks, options = {}) {
   fs.writeFileSync(todoPath, todo);
   files.todo = todoPath;
 
-  // Generate TASK_QUEUE.md
-  const queue = generateImplementationQueue(tasks, options);
-  const queuePath = path.join(planningDir, 'TASK_QUEUE.md');
-  fs.writeFileSync(queuePath, queue);
-  files.implementationQueue = queuePath;
+  const legacyQueuePath = path.join(planningDir, 'TASK_QUEUE.md');
+  const includeLegacyTaskQueue = options.includeLegacyTaskQueue === true;
+
+  if (includeLegacyTaskQueue) {
+    const queue = generateImplementationQueue(tasks, options);
+    fs.writeFileSync(legacyQueuePath, queue);
+    files.implementationQueue = legacyQueuePath;
+  }
 
   // Generate CONTEXT.md
   const context = generateContext(docs, tasks, options);
@@ -663,7 +666,7 @@ function extractTechStack(docs) {
  * @param {string} projectRoot - Project root path
  * @param {object} state - Current build state
  */
-function updateFromState(projectRoot, state) {
+function updateFromState(projectRoot, state, options = {}) {
   if (!state || !state.implementationQueue) return;
 
   const tasks = state.implementationQueue;
@@ -673,10 +676,11 @@ function updateFromState(projectRoot, state) {
   const todo = generateTodo(tasks, { projectName: state.projectName });
   fs.writeFileSync(path.join(planningDir, 'TODO.md'), todo);
 
-  // Legacy: also regenerate TASK_QUEUE.md if it already exists (backward compat)
-  const queuePath = path.join(planningDir, 'TASK_QUEUE.md');
-  if (fs.existsSync(queuePath)) {
-    const existingQueue = fs.readFileSync(queuePath, 'utf-8');
+  if (options.includeLegacyTaskQueue === true) {
+    const queuePath = path.join(planningDir, 'TASK_QUEUE.md');
+    const existingQueue = fs.existsSync(queuePath)
+      ? fs.readFileSync(queuePath, 'utf-8')
+      : '';
     const existingVersionMatch = existingQueue.match(/\*\*Current Version:\*\*\s*([^\n]+)/i)
       || existingQueue.match(/>\s*Current Version:\s*([^\n]+)/i);
     const queueVersion = existingVersionMatch

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girardmedia/bootspring",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Thin client for Bootspring cloud MCP, hosted agents, and paywalled workflow intelligence",
   "keywords": [
     "ai",
@@ -54,6 +54,9 @@
     "start": "node bin/bootspring.js",
     "dashboard": "node bin/bootspring.js dashboard",
     "mcp": "node dist/mcp-server.js",
+    "version:sync": "node scripts/sync-version-metadata.js",
+    "verify:version-sync": "node scripts/sync-version-metadata.js --check",
+    "release:prepare": "npm run version:sync && npm run build && npm test && npm run lint --if-present && npm run verify:package && npm run verify:mcp-contract && npm run verify:release-gates",
     "pretest": "npm run build",
     "test": "vitest run",
     "test:launch-smoke": "vitest run __tests__/unit/cli-first-run-smoke.test.js __tests__/unit/health-fresh-start.test.ts __tests__/unit/session-project-scope.test.ts __tests__/unit/auth-cli-mixed-states.test.ts __tests__/unit/api-client-project-auth-fallback.test.js __tests__/unit/cli-help-surface.test.js __tests__/unit/cli-command-manifest.test.js",
@@ -64,7 +67,7 @@
     "lint:fix": "eslint . --fix",
     "typecheck": "tsc --noEmit",
     "typecheck:active": "tsc --noEmit -p tsconfig.active.json",
-    "build": "tsup && npm run build:cli",
+    "build": "npm run version:sync && tsup && npm run build:cli",
     "build:cli": "cd monorepo && pnpm build --filter @bootspring/cli && cd .. && mkdir -p dist/cli && cp monorepo/apps/cli/dist/index.cjs dist/cli/index.cjs",
     "build:watch": "tsup --watch",
     "dev": "tsx watch src/index.ts",
@@ -74,13 +77,13 @@
     "verify:thin-client-contract": "node scripts/verify-thin-client-contract.js",
     "build:mcp-contract": "node scripts/export-mcp-contract.js",
     "verify:mcp-contract": "node scripts/export-mcp-contract.js --check",
-    "planning:sync": "node scripts/sync-planning-queue.js",
-    "planning:sync:check": "node scripts/sync-planning-queue.js --check",
-    "planning:realign": "node scripts/sync-planning-queue.js --sync-runtime",
+    "planning:sync": "node scripts/sync-planning-state.js",
+    "planning:sync:check": "node scripts/sync-planning-state.js --check",
+    "planning:realign": "node scripts/sync-planning-state.js --sync-runtime",
     "verify:package": "node scripts/check-package-boundaries.js",
     "db:sync": "node shared/db/sync.js",
     "db:sync:check": "node shared/db/sync.js --check",
-    "prepublishOnly": "npm run build && npm test && npm run lint --if-present && npm run verify:package && npm run verify:mcp-contract"
+    "prepublishOnly": "npm run verify:version-sync && npm run build && npm test && npm run lint --if-present && npm run verify:package && npm run verify:mcp-contract"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",