maxsimcli 4.15.3 → 4.16.0

package/dist/assets/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [4.15.4](https://github.com/maystudios/maxsimcli/compare/v4.15.3...v4.15.4) (2026-03-12)
+
+
+### Bug Fixes
+
+* remove stale references to dashboard, plan-phase, milestones shims and enhance statusline ([b895bf2](https://github.com/maystudios/maxsimcli/commit/b895bf22228117e93ad36cfb358777a4591109ed))
+
+## [4.15.3](https://github.com/maystudios/maxsimcli/compare/v4.15.2...v4.15.3) (2026-03-11)
+
+
+### Bug Fixes
+
+* **workflows:** move init CLI call into router to prevent workflow freelancing ([242e943](https://github.com/maystudios/maxsimcli/commit/242e9438968e90012c7ccc5b3180380a628c7154))
+
 ## [4.15.2](https://github.com/maystudios/maxsimcli/compare/v4.15.1...v4.15.2) (2026-03-11)
 
 

package/dist/assets/hooks/maxsim-statusline.cjs

@@ -60,7 +60,7 @@ const CLAUDE_DIR = ".claude";
 //#region src/hooks/maxsim-statusline.ts
 /**
 * Claude Code Statusline - MAXSIM Edition
-* Shows: [update] model | P{N} | v{M}: {pct}% | dirname
+* Shows: [update] model | P{N} {BoardColumn} | {milestone}: {pct}% | dirname
 */
 const CACHE_TTL_SECONDS = 60;
 /**
@@ -112,25 +112,49 @@ try {
     // gh api failed for milestones, continue with defaults
   }
 
-  // Get current phase from labels on open issues
+  // Get current phase from open issues with 'phase' label, parse number from title
   let phaseNumber = null;
+  let issueNumber = null;
   try {
     const phaseRaw = execSync(
-      'gh api "repos/' + owner + '/' + repo + '/issues?state=open&labels=phase:&per_page=1&sort=created&direction=desc" --jq ".[0].labels[] | select(.name | startswith(\\"phase:\\")) | .name"',
+      'gh api "repos/' + owner + '/' + repo + '/issues?state=open&labels=phase&per_page=1&sort=updated&direction=desc" --jq ".[0] | {number: .number, title: .title}"',
       { encoding: 'utf8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] }
     ).trim();
-    if (phaseRaw && phaseRaw.startsWith('phase:')) {
-      phaseNumber = phaseRaw.replace('phase:', '').trim();
+    const phaseData = JSON.parse(phaseRaw || '{}');
+    const titleMatch = (phaseData.title || '').match(/^\\[Phase\\s+(\\S+)\\]/);
+    if (titleMatch) {
+      phaseNumber = titleMatch[1];
     }
+    issueNumber = phaseData.number || null;
   } catch (e) {
     // gh api failed for phase, continue with null
   }
 
+  // Get board column via GraphQL
+  let boardColumn = null;
+  if (issueNumber) {
+    try {
+      const gqlQuery = '{ repository(owner: "' + owner + '", name: "' + repo + '") { issue(number: ' + issueNumber + ') { projectItems(first: 5, includeArchived: false) { nodes { fieldValueByName(name: "Status") { ... on ProjectV2ItemFieldSingleSelectValue { name } } } } } } }';
+      const boardRaw = execSync(
+        'gh api graphql -f query=@-',
+        { input: gqlQuery, encoding: 'utf8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] }
+      ).trim();
+      const boardData = JSON.parse(boardRaw);
+      const nodes = boardData?.data?.repository?.issue?.projectItems?.nodes || [];
+      if (nodes.length > 0 && nodes[0]?.fieldValueByName?.name) {
+        boardColumn = nodes[0].fieldValueByName.name;
+      }
+    } catch (e) {
+      boardColumn = null;
+    }
+  }
+
   // Write cache
   const cacheData = JSON.stringify({
     phase_number: phaseNumber,
     milestone_title: milestoneTitle,
     milestone_pct: milestonePct,
+    board_column: boardColumn,
     updated: Math.floor(Date.now() / 1000),
   });
 
@@ -138,7 +162,18 @@ try {
   fs.mkdirSync(dir, { recursive: true });
   fs.writeFileSync(${JSON.stringify(cacheFile)}, cacheData);
 } catch (e) {
-  // Silently degrade if gh not available
+  try {
+    const dir = ${JSON.stringify(cacheDir)};
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(${JSON.stringify(cacheFile)}, JSON.stringify({
+      phase_number: null,
+      milestone_title: null,
+      milestone_pct: 0,
+      board_column: null,
+      offline: true,
+      updated: Math.floor(Date.now() / 1000),
+    }));
+  } catch (_) {}
   process.exit(0);
 }
 `;
@@ -174,8 +209,12 @@ function formatStatusline(data) {
 		cache = null;
 	}
 	if (cacheAge > CACHE_TTL_SECONDS) spawnBackgroundRefresh(cacheDir, cacheFile);
+	if (cache?.offline) return `${updateIndicator}${DIM}${model}${RESET}${SEP}${DIM}P? offline${RESET}${SEP}${DIM}${dirname}${RESET}`;
 	let phaseSegment = "";
-	if (cache?.phase_number) phaseSegment = `${SEP}${DIM}P${cache.phase_number}${RESET}`;
+	if (cache?.phase_number) {
+		const column = cache.board_column ? ` ${cache.board_column}` : "";
+		phaseSegment = `${SEP}${DIM}P${cache.phase_number}${column}${RESET}`;
+	}
 	let milestoneSegment = "";
 	if (cache?.milestone_title) milestoneSegment = `${SEP}${DIM}${cache.milestone_title}: ${cache.milestone_pct}%${RESET}`;
 	return `${updateIndicator}${DIM}${model}${RESET}${phaseSegment}${milestoneSegment}${SEP}${DIM}${dirname}${RESET}`;

package/dist/assets/hooks/maxsim-statusline.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"maxsim-statusline.cjs","names":["path","fs"],"sources":["../../../src/hooks/shared.ts","../../../src/hooks/maxsim-statusline.ts"],"sourcesContent":["/**\n * Shared utilities for MAXSIM hooks.\n */\n\n/**\n * Read all stdin as a string, then invoke callback with parsed JSON.\n * Used by statusline and sync-reminder hooks.\n */\nexport function readStdinJson<T>(callback: (data: T) => void): void {\n  let input = '';\n  process.stdin.setEncoding('utf8');\n  process.stdin.on('data', (chunk: string) => (input += chunk));\n  process.stdin.on('end', () => {\n    try {\n      const data = JSON.parse(input) as T;\n      callback(data);\n    } catch {\n      // Silent fail -- never block hook execution\n      process.exit(0);\n    }\n  });\n}\n\n/** The '.claude' path segment -- template marker replaced during install. */\nexport const CLAUDE_DIR = '.claude';\n","#!/usr/bin/env node\n/**\n * Claude Code Statusline - MAXSIM Edition\n * Shows: [update] model | P{N} | v{M}: {pct}% | dirname\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { spawn } from 'node:child_process';\nimport { readStdinJson, CLAUDE_DIR } from './shared';\n\nexport interface StatuslineInput {\n  model?: { display_name?: string };\n  workspace?: { current_dir?: string; project_dir?: string };\n  session_id?: string;\n}\n\nexport interface ProgressCache {\n  phase_number: string | null;\n  milestone_title: string | null;\n  milestone_pct: number;\n  updated: number;\n}\n\nconst CACHE_TTL_SECONDS = 60;\n\n/**\n * Spawn a detached Node child process to refresh the progress cache in the background.\n * The child runs gh CLI commands to detect owner/repo, find the first open milestone,\n * compute progress, and find the current phase label.\n */\nfunction spawnBackgroundRefresh(cacheDir: string, cacheFile: string): void {\n  try {\n    const script = `\nconst { execSync } = require('child_process');\nconst fs = require('fs');\nconst path = require('path');\n\ntry {\n  // Detect owner/repo\n  const nameWithOwner = execSync('gh repo view --json nameWithOwner -q .nameWithOwner', {\n    encoding: 'utf8',\n    timeout: 10000,\n    stdio: ['pipe', 'pipe', 'pipe'],\n  }).trim();\n\n  if (!nameWithOwner || !nameWithOwner.includes('/')) {\n    process.exit(0);\n  }\n\n  const [owner, repo] = nameWithOwner.split('/');\n\n  // Get milestones\n  let milestoneTitle = null;\n  let milestonePct = 0;\n  try {\n    const milestonesRaw = execSync(\n      'gh api repos/' + owner + '/' + repo + '/milestones --jq \".\"',\n      { encoding: 'utf8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] }\n    ).trim();\n    if (milestonesRaw) {\n      const milestones = JSON.parse(milestonesRaw);\n      const openMilestone = milestones.find(function(m) { return m.state === 'open'; });\n      if (openMilestone) {\n        milestoneTitle = openMilestone.title || null;\n        const total = (openMilestone.open_issues || 0) + (openMilestone.closed_issues || 0);\n        if (total > 0) {\n          milestonePct = Math.round(((openMilestone.closed_issues || 0) / total) * 100);\n        }\n      }\n    }\n  } catch (e) {\n    // gh api failed for milestones, continue with defaults\n  }\n\n  // Get current phase from labels on open issues\n  let phaseNumber = null;\n  try {\n    const phaseRaw = execSync(\n      'gh api \"repos/' + owner + '/' + repo + '/issues?state=open&labels=phase:&per_page=1&sort=created&direction=desc\" --jq \".[0].labels[] | select(.name | startswith(\\\\\"phase:\\\\\")) | .name\"',\n      { encoding: 'utf8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] }\n    ).trim();\n    if (phaseRaw && phaseRaw.startsWith('phase:')) {\n      phaseNumber = phaseRaw.replace('phase:', '').trim();\n    }\n  } catch (e) {\n    // gh api failed for phase, continue with null\n  }\n\n  // Write cache\n  const cacheData = JSON.stringify({\n    phase_number: phaseNumber,\n    milestone_title: milestoneTitle,\n    milestone_pct: milestonePct,\n    updated: Math.floor(Date.now() / 1000),\n  });\n\n  const dir = ${JSON.stringify(cacheDir)};\n  fs.mkdirSync(dir, { recursive: true });\n  fs.writeFileSync(${JSON.stringify(cacheFile)}, cacheData);\n} catch (e) {\n  // Silently degrade if gh not available\n  process.exit(0);\n}\n`;\n\n    const child = spawn(process.execPath, ['-e', script], {\n      stdio: 'ignore',\n      windowsHide: true,\n      detached: true,\n    });\n    child.unref();\n  } catch {\n    // Silent fail -- never break statusline\n  }\n}\n\nexport function formatStatusline(data: StatuslineInput): string {\n  const model = data.model?.display_name || 'Claude';\n  const dir = data.workspace?.project_dir || data.workspace?.current_dir || process.cwd();\n  const dirname = path.basename(dir);\n\n  const SEP = ' \\u2502 ';\n  const DIM = '\\x1b[2m';\n  const RESET = '\\x1b[0m';\n\n  // MAXSIM update available?\n  let updateIndicator = '';\n  const updateCacheFile = path.join(dir, CLAUDE_DIR, 'cache', 'maxsim-update-check.json');\n  if (fs.existsSync(updateCacheFile)) {\n    try {\n      const cache = JSON.parse(fs.readFileSync(updateCacheFile, 'utf8'));\n      if (cache.update_available) {\n        updateIndicator = '\\x1b[33m\\u2B06\\x1b[0m ';\n      }\n    } catch {\n      // ignore\n    }\n  }\n\n  // Check if this is a MAXSIM project\n  const planningDir = path.join(dir, '.planning');\n  const isMaxsimProject = fs.existsSync(planningDir);\n\n  if (!isMaxsimProject) {\n    return `${updateIndicator}${DIM}${model}${RESET}${SEP}${DIM}${dirname}${RESET}`;\n  }\n\n  // Read progress cache\n  const cacheDir = path.join(dir, CLAUDE_DIR, 'cache');\n  const cacheFile = path.join(cacheDir, 'maxsim-progress.json');\n  let cache: ProgressCache | null = null;\n  let cacheAge = Infinity;\n\n  if (fs.existsSync(cacheFile)) {\n    try {\n      cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8')) as ProgressCache;\n      cacheAge = Math.floor(Date.now() / 1000) - (cache.updated || 0);\n    } catch {\n      cache = null;\n    }\n  }\n\n  // Spawn background refresh if cache is stale or missing\n  if (cacheAge > CACHE_TTL_SECONDS) {\n    spawnBackgroundRefresh(cacheDir, cacheFile);\n  }\n\n  // Build phase segment\n  let phaseSegment = '';\n  if (cache?.phase_number) {\n    phaseSegment = `${SEP}${DIM}P${cache.phase_number}${RESET}`;\n  }\n\n  // Build milestone segment\n  let milestoneSegment = '';\n  if (cache?.milestone_title) {\n    milestoneSegment = `${SEP}${DIM}${cache.milestone_title}: ${cache.milestone_pct}%${RESET}`;\n  }\n\n  return `${updateIndicator}${DIM}${model}${RESET}${phaseSegment}${milestoneSegment}${SEP}${DIM}${dirname}${RESET}`;\n}\n\n// Standalone entry\nif (require.main === module) {\n  readStdinJson<StatuslineInput>((data) => {\n    process.stdout.write(formatStatusline(data));\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,SAAgB,cAAiB,UAAmC;CAClE,IAAI,QAAQ;AACZ,SAAQ,MAAM,YAAY,OAAO;AACjC,SAAQ,MAAM,GAAG,SAAS,UAAmB,SAAS,MAAO;AAC7D,SAAQ,MAAM,GAAG,aAAa;AAC5B,MAAI;AAEF,YADa,KAAK,MAAM,MAAM,CAChB;UACR;AAEN,WAAQ,KAAK,EAAE;;GAEjB;;;AAIJ,MAAa,aAAa;;;;;;;;ACA1B,MAAM,oBAAoB;;;;;;AAO1B,SAAS,uBAAuB,UAAkB,WAAyB;AACzE,KAAI;EACF,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAgEH,KAAK,UAAU,SAAS,CAAC;;qBAEpB,KAAK,UAAU,UAAU,CAAC;;;;;;AAY3C,gCALoB,QAAQ,UAAU,CAAC,MAAM,OAAO,EAAE;GACpD,OAAO;GACP,aAAa;GACb,UAAU;GACX,CAAC,CACI,OAAO;SACP;;AAKV,SAAgB,iBAAiB,MAA+B;CAC9D,MAAM,QAAQ,KAAK,OAAO,gBAAgB;CAC1C,MAAM,MAAM,KAAK,WAAW,eAAe,KAAK,WAAW,eAAe,QAAQ,KAAK;CACvF,MAAM,UAAUA,UAAK,SAAS,IAAI;CAElC,MAAM,MAAM;CACZ,MAAM,MAAM;CACZ,MAAM,QAAQ;CAGd,IAAI,kBAAkB;CACtB,MAAM,kBAAkBA,UAAK,KAAK,KAAK,YAAY,SAAS,2BAA2B;AACvF,KAAIC,QAAG,WAAW,gBAAgB,CAChC,KAAI;AAEF,MADc,KAAK,MAAMA,QAAG,aAAa,iBAAiB,OAAO,CAAC,CACxD,iBACR,mBAAkB;SAEd;CAMV,MAAM,cAAcD,UAAK,KAAK,KAAK,YAAY;AAG/C,KAAI,CAFoBC,QAAG,WAAW,YAAY,CAGhD,QAAO,GAAG,kBAAkB,MAAM,QAAQ,QAAQ,MAAM,MAAM,UAAU;CAI1E,MAAM,WAAWD,UAAK,KAAK,KAAK,YAAY,QAAQ;CACpD,MAAM,YAAYA,UAAK,KAAK,UAAU,uBAAuB;CAC7D,IAAI,QAA8B;CAClC,IAAI,WAAW;AAEf,KAAIC,QAAG,WAAW,UAAU,CAC1B,KAAI;AACF,UAAQ,KAAK,MAAMA,QAAG,aAAa,WAAW,OAAO,CAAC;AACtD,aAAW,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK,IAAI,MAAM,WAAW;SACvD;AACN,UAAQ;;AAKZ,KAAI,WAAW,kBACb,wBAAuB,UAAU,UAAU;CAI7C,IAAI,eAAe;AACnB,KAAI,OAAO,aACT,gBAAe,GAAG,MAAM,IAAI,GAAG,MAAM,eAAe;CAItD,IAAI,mBAAmB;AACvB,KAAI,OAAO,gBACT,oBAAmB,GAAG,MAAM,MAAM,MAAM,gBAAgB,IAAI,MAAM,cAAc,GAAG;AAGrF,QAAO,GAAG,kBAAkB,MAAM,QAAQ,QAAQ,eAAe,mBAAmB,MAAM,MAAM,UAAU;;AAI5G,IAAI,QAAQ,SAAS,OACnB,gBAAgC,SAAS;AACvC,SAAQ,OAAO,MAAM,iBAAiB,KAAK,CAAC;EAC5C"}
+{"version":3,"file":"maxsim-statusline.cjs","names":["path","fs"],"sources":["../../../src/hooks/shared.ts","../../../src/hooks/maxsim-statusline.ts"],"sourcesContent":["/**\n * Shared utilities for MAXSIM hooks.\n */\n\n/**\n * Read all stdin as a string, then invoke callback with parsed JSON.\n * Used by statusline and sync-reminder hooks.\n */\nexport function readStdinJson<T>(callback: (data: T) => void): void {\n  let input = '';\n  process.stdin.setEncoding('utf8');\n  process.stdin.on('data', (chunk: string) => (input += chunk));\n  process.stdin.on('end', () => {\n    try {\n      const data = JSON.parse(input) as T;\n      callback(data);\n    } catch {\n      // Silent fail -- never block hook execution\n      process.exit(0);\n    }\n  });\n}\n\n/** The '.claude' path segment -- template marker replaced during install. */\nexport const CLAUDE_DIR = '.claude';\n","#!/usr/bin/env node\n/**\n * Claude Code Statusline - MAXSIM Edition\n * Shows: [update] model | P{N} {BoardColumn} | {milestone}: {pct}% | dirname\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { spawn } from 'node:child_process';\nimport { readStdinJson, CLAUDE_DIR } from './shared';\n\nexport interface StatuslineInput {\n  model?: { display_name?: string };\n  workspace?: { current_dir?: string; project_dir?: string };\n  session_id?: string;\n}\n\nexport interface ProgressCache {\n  phase_number: string | null;\n  milestone_title: string | null;\n  milestone_pct: number;\n  board_column: string | null;\n  offline?: boolean;\n  updated: number;\n}\n\nconst CACHE_TTL_SECONDS = 60;\n\n/**\n * Spawn a detached Node child process to refresh the progress cache in the background.\n * The child runs gh CLI commands to detect owner/repo, find the first open milestone,\n * compute progress, and find the current phase label.\n */\nfunction spawnBackgroundRefresh(cacheDir: string, cacheFile: string): void {\n  try {\n    const script = `\nconst { execSync } = require('child_process');\nconst fs = require('fs');\nconst path = require('path');\n\ntry {\n  // Detect owner/repo\n  const nameWithOwner = execSync('gh repo view --json nameWithOwner -q .nameWithOwner', {\n    encoding: 'utf8',\n    timeout: 10000,\n    stdio: ['pipe', 'pipe', 'pipe'],\n  }).trim();\n\n  if (!nameWithOwner || !nameWithOwner.includes('/')) {\n    process.exit(0);\n  }\n\n  const [owner, repo] = nameWithOwner.split('/');\n\n  // Get milestones\n  let milestoneTitle = null;\n  let milestonePct = 0;\n  try {\n    const milestonesRaw = execSync(\n      'gh api repos/' + owner + '/' + repo + '/milestones --jq \".\"',\n      { encoding: 'utf8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] }\n    ).trim();\n    if (milestonesRaw) {\n      const milestones = JSON.parse(milestonesRaw);\n      const openMilestone = milestones.find(function(m) { return m.state === 'open'; });\n      if (openMilestone) {\n        milestoneTitle = openMilestone.title || null;\n        const total = (openMilestone.open_issues || 0) + (openMilestone.closed_issues || 0);\n        if (total > 0) {\n          milestonePct = Math.round(((openMilestone.closed_issues || 0) / total) * 100);\n        }\n      }\n    }\n  } catch (e) {\n    // gh api failed for milestones, continue with defaults\n  }\n\n  // Get current phase from open issues with 'phase' label, parse number from title\n  let phaseNumber = null;\n  let issueNumber = null;\n  try {\n    const phaseRaw = execSync(\n      'gh api \"repos/' + owner + '/' + repo + '/issues?state=open&labels=phase&per_page=1&sort=updated&direction=desc\" --jq \".[0] | {number: .number, title: .title}\"',\n      { encoding: 'utf8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] }\n    ).trim();\n    const phaseData = JSON.parse(phaseRaw || '{}');\n    const titleMatch = (phaseData.title || '').match(/^\\\\[Phase\\\\s+(\\\\S+)\\\\]/);\n    if (titleMatch) {\n      phaseNumber = titleMatch[1];\n    }\n    issueNumber = phaseData.number || null;\n  } catch (e) {\n    // gh api failed for phase, continue with null\n  }\n\n  // Get board column via GraphQL\n  let boardColumn = null;\n  if (issueNumber) {\n    try {\n      const gqlQuery = '{ repository(owner: \"' + owner + '\", name: \"' + repo + '\") { issue(number: ' + issueNumber + ') { projectItems(first: 5, includeArchived: false) { nodes { fieldValueByName(name: \"Status\") { ... on ProjectV2ItemFieldSingleSelectValue { name } } } } } } }';\n      const boardRaw = execSync(\n        'gh api graphql -f query=@-',\n        { input: gqlQuery, encoding: 'utf8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] }\n      ).trim();\n      const boardData = JSON.parse(boardRaw);\n      const nodes = boardData?.data?.repository?.issue?.projectItems?.nodes || [];\n      if (nodes.length > 0 && nodes[0]?.fieldValueByName?.name) {\n        boardColumn = nodes[0].fieldValueByName.name;\n      }\n    } catch (e) {\n      boardColumn = null;\n    }\n  }\n\n  // Write cache\n  const cacheData = JSON.stringify({\n    phase_number: phaseNumber,\n    milestone_title: milestoneTitle,\n    milestone_pct: milestonePct,\n    board_column: boardColumn,\n    updated: Math.floor(Date.now() / 1000),\n  });\n\n  const dir = ${JSON.stringify(cacheDir)};\n  fs.mkdirSync(dir, { recursive: true });\n  fs.writeFileSync(${JSON.stringify(cacheFile)}, cacheData);\n} catch (e) {\n  try {\n    const dir = ${JSON.stringify(cacheDir)};\n    fs.mkdirSync(dir, { recursive: true });\n    fs.writeFileSync(${JSON.stringify(cacheFile)}, JSON.stringify({\n      phase_number: null,\n      milestone_title: null,\n      milestone_pct: 0,\n      board_column: null,\n      offline: true,\n      updated: Math.floor(Date.now() / 1000),\n    }));\n  } catch (_) {}\n  process.exit(0);\n}\n`;\n\n    const child = spawn(process.execPath, ['-e', script], {\n      stdio: 'ignore',\n      windowsHide: true,\n      detached: true,\n    });\n    child.unref();\n  } catch {\n    // Silent fail -- never break statusline\n  }\n}\n\nexport function formatStatusline(data: StatuslineInput): string {\n  const model = data.model?.display_name || 'Claude';\n  const dir = data.workspace?.project_dir || data.workspace?.current_dir || process.cwd();\n  const dirname = path.basename(dir);\n\n  const SEP = ' \\u2502 ';\n  const DIM = '\\x1b[2m';\n  const RESET = '\\x1b[0m';\n\n  // MAXSIM update available?\n  let updateIndicator = '';\n  const updateCacheFile = path.join(dir, CLAUDE_DIR, 'cache', 'maxsim-update-check.json');\n  if (fs.existsSync(updateCacheFile)) {\n    try {\n      const cache = JSON.parse(fs.readFileSync(updateCacheFile, 'utf8'));\n      if (cache.update_available) {\n        updateIndicator = '\\x1b[33m\\u2B06\\x1b[0m ';\n      }\n    } catch {\n      // ignore\n    }\n  }\n\n  // Check if this is a MAXSIM project\n  const planningDir = path.join(dir, '.planning');\n  const isMaxsimProject = fs.existsSync(planningDir);\n\n  if (!isMaxsimProject) {\n    return `${updateIndicator}${DIM}${model}${RESET}${SEP}${DIM}${dirname}${RESET}`;\n  }\n\n  // Read progress cache\n  const cacheDir = path.join(dir, CLAUDE_DIR, 'cache');\n  const cacheFile = path.join(cacheDir, 'maxsim-progress.json');\n  let cache: ProgressCache | null = null;\n  let cacheAge = Infinity;\n\n  if (fs.existsSync(cacheFile)) {\n    try {\n      cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8')) as ProgressCache;\n      cacheAge = Math.floor(Date.now() / 1000) - (cache.updated || 0);\n    } catch {\n      cache = null;\n    }\n  }\n\n  // Spawn background refresh if cache is stale or missing\n  if (cacheAge > CACHE_TTL_SECONDS) {\n    spawnBackgroundRefresh(cacheDir, cacheFile);\n  }\n\n  // Offline fallback\n  if (cache?.offline) {\n    return `${updateIndicator}${DIM}${model}${RESET}${SEP}${DIM}P? offline${RESET}${SEP}${DIM}${dirname}${RESET}`;\n  }\n\n  // Build phase segment: P{N} {BoardColumn}\n  let phaseSegment = '';\n  if (cache?.phase_number) {\n    const column = cache.board_column ? ` ${cache.board_column}` : '';\n    phaseSegment = `${SEP}${DIM}P${cache.phase_number}${column}${RESET}`;\n  }\n\n  // Build milestone segment\n  let milestoneSegment = '';\n  if (cache?.milestone_title) {\n    milestoneSegment = `${SEP}${DIM}${cache.milestone_title}: ${cache.milestone_pct}%${RESET}`;\n  }\n\n  return `${updateIndicator}${DIM}${model}${RESET}${phaseSegment}${milestoneSegment}${SEP}${DIM}${dirname}${RESET}`;\n}\n\n// Standalone entry\nif (require.main === module) {\n  readStdinJson<StatuslineInput>((data) => {\n    process.stdout.write(formatStatusline(data));\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,SAAgB,cAAiB,UAAmC;CAClE,IAAI,QAAQ;AACZ,SAAQ,MAAM,YAAY,OAAO;AACjC,SAAQ,MAAM,GAAG,SAAS,UAAmB,SAAS,MAAO;AAC7D,SAAQ,MAAM,GAAG,aAAa;AAC5B,MAAI;AAEF,YADa,KAAK,MAAM,MAAM,CAChB;UACR;AAEN,WAAQ,KAAK,EAAE;;GAEjB;;;AAIJ,MAAa,aAAa;;;;;;;;ACE1B,MAAM,oBAAoB;;;;;;AAO1B,SAAS,uBAAuB,UAAkB,WAAyB;AACzE,KAAI;EACF,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAwFH,KAAK,UAAU,SAAS,CAAC;;qBAEpB,KAAK,UAAU,UAAU,CAAC;;;kBAG7B,KAAK,UAAU,SAAS,CAAC;;uBAEpB,KAAK,UAAU,UAAU,CAAC;;;;;;;;;;;;AAkB7C,gCALoB,QAAQ,UAAU,CAAC,MAAM,OAAO,EAAE;GACpD,OAAO;GACP,aAAa;GACb,UAAU;GACX,CAAC,CACI,OAAO;SACP;;AAKV,SAAgB,iBAAiB,MAA+B;CAC9D,MAAM,QAAQ,KAAK,OAAO,gBAAgB;CAC1C,MAAM,MAAM,KAAK,WAAW,eAAe,KAAK,WAAW,eAAe,QAAQ,KAAK;CACvF,MAAM,UAAUA,UAAK,SAAS,IAAI;CAElC,MAAM,MAAM;CACZ,MAAM,MAAM;CACZ,MAAM,QAAQ;CAGd,IAAI,kBAAkB;CACtB,MAAM,kBAAkBA,UAAK,KAAK,KAAK,YAAY,SAAS,2BAA2B;AACvF,KAAIC,QAAG,WAAW,gBAAgB,CAChC,KAAI;AAEF,MADc,KAAK,MAAMA,QAAG,aAAa,iBAAiB,OAAO,CAAC,CACxD,iBACR,mBAAkB;SAEd;CAMV,MAAM,cAAcD,UAAK,KAAK,KAAK,YAAY;AAG/C,KAAI,CAFoBC,QAAG,WAAW,YAAY,CAGhD,QAAO,GAAG,kBAAkB,MAAM,QAAQ,QAAQ,MAAM,MAAM,UAAU;CAI1E,MAAM,WAAWD,UAAK,KAAK,KAAK,YAAY,QAAQ;CACpD,MAAM,YAAYA,UAAK,KAAK,UAAU,uBAAuB;CAC7D,IAAI,QAA8B;CAClC,IAAI,WAAW;AAEf,KAAIC,QAAG,WAAW,UAAU,CAC1B,KAAI;AACF,UAAQ,KAAK,MAAMA,QAAG,aAAa,WAAW,OAAO,CAAC;AACtD,aAAW,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK,IAAI,MAAM,WAAW;SACvD;AACN,UAAQ;;AAKZ,KAAI,WAAW,kBACb,wBAAuB,UAAU,UAAU;AAI7C,KAAI,OAAO,QACT,QAAO,GAAG,kBAAkB,MAAM,QAAQ,QAAQ,MAAM,IAAI,YAAY,QAAQ,MAAM,MAAM,UAAU;CAIxG,IAAI,eAAe;AACnB,KAAI,OAAO,cAAc;EACvB,MAAM,SAAS,MAAM,eAAe,IAAI,MAAM,iBAAiB;AAC/D,iBAAe,GAAG,MAAM,IAAI,GAAG,MAAM,eAAe,SAAS;;CAI/D,IAAI,mBAAmB;AACvB,KAAI,OAAO,gBACT,oBAAmB,GAAG,MAAM,MAAM,MAAM,gBAAgB,IAAI,MAAM,cAAc,GAAG;AAGrF,QAAO,GAAG,kBAAkB,MAAM,QAAQ,QAAQ,eAAe,mBAAmB,MAAM,MAAM,UAAU;;AAI5G,IAAI,QAAQ,SAAS,OACnB,gBAAgC,SAAS;AACvC,SAAQ,OAAO,MAAM,iBAAiB,KAAK,CAAC;EAC5C"}

package/dist/assets/templates/agents/AGENTS.md

@@ -7,7 +7,7 @@
 | Agent | Role | Tools | Preloaded Skills | On-Demand Skills |
 |-------|------|-------|-----------------|-----------------|
 | `executor` | Implements plans with atomic commits and deviation handling | Read, Write, Edit, Bash, Grep, Glob | handoff-contract, evidence-collection, commit-conventions | tool-priority-guide, agent-system-map |
-| `planner` | Creates PLAN.md files with task breakdown and goal-backward verification | Read, Write, Bash, Grep, Glob | handoff-contract, input-validation | research-methodology, agent-system-map |
+| `planner` | Creates plans (posted as GitHub Issue comments) with task breakdown and goal-backward verification | Read, Write, Bash, Grep, Glob | handoff-contract, input-validation | research-methodology, agent-system-map |
 | `researcher` | Investigates domains with source evaluation and confidence levels | Read, Bash, Grep, Glob, WebFetch | handoff-contract, evidence-collection | research-methodology, tool-priority-guide |
 | `verifier` | Verifies work against specifications with fresh evidence and hard gates | Read, Bash, Grep, Glob | verification-gates, evidence-collection, handoff-contract | agent-system-map, tool-priority-guide |
 

package/dist/assets/templates/agents/executor.md

@@ -19,7 +19,7 @@ You are a plan executor. You implement plans atomically -- one commit per task,
 ## Input Validation
 
 Before any work, verify required inputs exist:
-- Plan content (provided by the orchestrator from a GitHub Issue comment, or as a PLAN.md file path)
+- Plan content (provided by the orchestrator from a GitHub Issue comment)
 - STATE.md readable -- `test -f .planning/STATE.md`
 
 If missing, return immediately:

package/dist/assets/templates/agents/planner.md

@@ -2,8 +2,8 @@
 name: planner
 description: >-
   Creates executable phase plans with task breakdown, dependency analysis,
-  and goal-backward verification. Use when planning phases, creating PLAN.md
-  files, breaking work into tasks, or performing gap closure planning.
+  and goal-backward verification. Use when planning phases, creating plans
+  (posted as GitHub Issue comments), breaking work into tasks, or performing gap closure planning.
 tools: Read, Write, Bash, Grep, Glob
 model: inherit
 skills:
@@ -24,13 +24,13 @@ Context and research input is provided from GitHub Issue comments (type: `contex
 Before any work, verify required inputs exist:
 - ROADMAP.md -- `test -f .planning/ROADMAP.md`
 - REQUIREMENTS.md -- `test -f .planning/REQUIREMENTS.md`
-- Phase directory -- `test -d .planning/phases/{phase}/` (if running in local mode) or context provided in spawn prompt (if running in GitHub mode)
+- Phase context provided in spawn prompt (GitHub Issues is the source of truth)
 
 If missing, return immediately using the input-validation error format.
 
 ## Planning Protocol
 
-1. **Load context** -- read ROADMAP.md, REQUIREMENTS.md, and context/research provided from GitHub Issue comments (or local CONTEXT.md, RESEARCH.md if in local mode)
+1. **Load context** -- read ROADMAP.md, REQUIREMENTS.md, and context/research provided from GitHub Issue comments
 2. **Identify scope** -- extract phase goal, requirements, and user decisions from context
 3. **Break into tasks** -- each task is an atomic unit with clear action, done criteria, verify block, and file list
 4. **Build dependency graph** -- identify which tasks depend on others

package/dist/assets/templates/references/git-planning-commit.md

@@ -24,7 +24,7 @@ node ~/.claude/maxsim/bin/maxsim-tools.cjs commit "" --files .planning/codebase/
 
 | Command | Scope | Example |
 |---------|-------|---------|
-| plan-phase | phase | `docs(phase-03): create authentication plans` |
+| plan | phase | `docs(phase-03): create authentication plans` |
 | execute-phase | phase | `docs(phase-03): complete authentication phase` |
 | new-milestone | milestone | `docs: start milestone v1.1` |
 | remove-phase | chore | `chore: remove phase 17 (dashboard)` |

package/dist/assets/templates/references/questioning.md

@@ -19,7 +19,7 @@ By the end of questioning, you need enough clarity to write a PROJECT.md that do
 - **Research** needs: what domain to research, what the user already knows, what unknowns exist
 - **Requirements** needs: clear enough vision to scope v1 features
 - **Roadmap** needs: clear enough vision to decompose into phases, what "done" looks like
-- **plan-phase** needs: specific requirements to break into tasks, context for implementation choices
+- **plan** needs: specific requirements to break into tasks, context for implementation choices
 - **execute-phase** needs: success criteria to verify against, the "why" behind requirements
 
 A vague PROJECT.md forces every downstream phase to guess. The cost compounds.

package/dist/assets/templates/templates/codebase/structure.md

@@ -148,7 +148,7 @@ maxsim/
 **commands/maxsim/**
 - Purpose: Slash command definitions for Claude Code
 - Contains: *.md files (one per command)
-- Key files: new-project.md, plan-phase.md, execute-plan.md
+- Key files: new-project.md, plan.md, execute-plan.md
 - Subdirectories: None (flat structure)
 
 **maxsim/references/**

package/dist/assets/templates/templates/milestone-archive.md

@@ -1,6 +1,6 @@
 # Milestone Archive Template
 
-This template is used by the complete-milestone workflow to create archive files in `.planning/milestones/`.
+This template is used by the complete-milestone workflow to create archive files in `.planning/archive/`.
 
 ---
 
@@ -112,8 +112,8 @@ _For current project status, see .planning/ROADMAP.md_
 
 **Archive location:**
 
-- Save to `.planning/milestones/v{VERSION}-{NAME}.md`
-- Example: `.planning/milestones/v1.0-mvp.md`
+- Save to `.planning/archive/v{VERSION}-{NAME}.md`
+- Example: `.planning/archive/v1.0-mvp.md`
 
 **After archiving:**
 

package/dist/assets/templates/workflows/batch.md

@@ -13,7 +13,6 @@ Follows the batch-worktree skill process: Research (decompose) -> Plan (validate
 
 <required_reading>
 Read all files referenced by the invoking prompt's execution_context before starting.
-@./references/dashboard-bridge.md
 </required_reading>
 
 <process>
@@ -225,7 +224,7 @@ For each unit (spawn all with `run_in_background: true` for parallel execution):
 
 ```
 Task(
-  subagent_type="general-purpose",
+  subagent_type="executor",
   model="{executor_model}",
   isolation="worktree",
   run_in_background=true,
@@ -299,7 +298,7 @@ For each failed unit:
 **Attempt 1 — spawn fix agent:**
 ```
 Task(
-  subagent_type="general-purpose",
+  subagent_type="executor",
   model="{executor_model}",
   isolation="worktree",
   prompt="

package/dist/assets/templates/workflows/diagnose-issues.md

@@ -1,7 +1,7 @@
 <purpose>
 Orchestrate parallel debug agents to investigate UAT gaps and find root causes.
 
-After UAT finds gaps, spawn one debug agent per gap. Each agent investigates autonomously with symptoms pre-filled from UAT. Collect root causes, update UAT.md gaps with diagnosis, then hand off to plan-phase --gaps with actual diagnoses.
+After UAT finds gaps, spawn one debug agent per gap. Each agent investigates autonomously with symptoms pre-filled from UAT. Collect root causes, update UAT.md gaps with diagnosis, then hand off to plan --gaps with actual diagnoses.
 
 Orchestrator stays lean: parse gaps, spawn agents, collect results, update UAT.
 </purpose>
@@ -15,7 +15,7 @@ Debug files use the `.planning/debug/` path (hidden directory with leading dot).
 <core_principle>
 **Diagnose before planning fixes.**
 
-UAT tells us WHAT is broken (symptoms). Debug agents find WHY (root cause). plan-phase --gaps then creates targeted fixes based on actual causes, not guesses.
+UAT tells us WHAT is broken (symptoms). Debug agents find WHY (root cause). plan --gaps then creates targeted fixes based on actual causes, not guesses.
 
 Without diagnosis: "Comment doesn't refresh" → guess at fix → maybe wrong
 With diagnosis: "Comment doesn't refresh" → "useEffect missing dependency" → precise fix
@@ -94,7 +94,7 @@ Template placeholders:
 - `{errors}`: Any error messages from UAT (or "None reported")
 - `{reproduction}`: "Test {test_num} in UAT"
 - `{timeline}`: "Discovered during UAT"
-- `{goal}`: `find_root_cause_only` (UAT flow - plan-phase --gaps handles fixes)
+- `{goal}`: `find_root_cause_only` (UAT flow - plan --gaps handles fixes)
 - `{slug}`: Generated from truth
 </step>
 
@@ -118,7 +118,7 @@ Each agent returns with:
 - {file1}: {what's wrong}
 - {file2}: {related issue}
 
-**Suggested Fix Direction:** {brief hint for plan-phase --gaps}
+**Suggested Fix Direction:** {brief hint for plan --gaps}
 ```
 
 Parse each return to extract:
@@ -190,7 +190,7 @@ Do NOT offer manual next steps - verify-work handles the rest.
 
 <context_efficiency>
 Agents start with symptoms pre-filled from UAT (no symptom gathering).
-Agents only diagnose—plan-phase --gaps handles fixes (no fix application).
+Agents only diagnose—plan --gaps handles fixes (no fix application).
 </context_efficiency>
 
 <failure_handling>
@@ -206,7 +206,7 @@ Agents only diagnose—plan-phase --gaps handles fixes (no fix application).
 **All agents fail:**
 - Something systemic (permissions, git, etc.)
 - Report for manual investigation
-- Fall back to plan-phase --gaps without root causes (less precise)
+- Fall back to plan --gaps without root causes (less precise)
 </failure_handling>
 
 <success_criteria>

package/dist/assets/templates/workflows/discovery-phase.md

@@ -2,13 +2,12 @@
 Execute discovery at the appropriate depth level.
 Produces DISCOVERY.md (for Level 2-3) that informs PLAN.md creation.
 
-Called from plan-phase.md's mandatory_discovery step with a depth parameter.
+Called from plan-create.md's mandatory_discovery step with a depth parameter.
 
 NOTE: For comprehensive ecosystem research ("how do experts build this"), use /maxsim:plan --research instead, which produces RESEARCH.md.
 </purpose>
 
 <required_reading>
-@./references/dashboard-bridge.md
 </required_reading>
 
 <depth_levels>
@@ -20,7 +19,7 @@ NOTE: For comprehensive ecosystem research ("how do experts build this"), use /m
 | 2     | Standard     | 15-30 min | DISCOVERY.md                                 | Choosing between options, new integration |
 | 3     | Deep Dive    | 1+ hour   | Detailed DISCOVERY.md with validation gates  | Architectural decisions, novel problems   |
 
-**Depth is determined by plan-phase.md before routing here.**
+**Depth is determined by plan-create.md before routing here.**
 </depth_levels>
 
 <source_hierarchy>
@@ -38,7 +37,7 @@ See ~/.claude/maxsim/templates/discovery.md `<discovery_protocol>` for full prot
 <process>
 
 <step name="determine_depth">
-Check the depth parameter passed from plan-phase.md:
+Check the depth parameter passed from plan-create.md:
 - `depth=verify` → Level 1 (Quick Verification)
 - `depth=standard` → Level 2 (Standard Discovery)
 - `depth=deep` → Level 3 (Deep Dive)
@@ -73,7 +72,7 @@ For: Single known library, confirming syntax/version still correct.
    - API syntax unchanged
    - No breaking changes in recent versions
 
-4. **If verified:** Return to plan-phase.md with confirmation. No DISCOVERY.md needed.
+4. **If verified:** Return to plan-create.md with confirmation. No DISCOVERY.md needed.
 
 5. **If concerns found:** Escalate to Level 2.
 
@@ -118,7 +117,7 @@ For: Choosing between options, new external integration.
    - Code examples from Context7
    - Confidence level (should be MEDIUM-HIGH for Level 2)
 
-7. Return to plan-phase.md.
+7. Return to plan-create.md.
 
 **Output:** `.planning/phases/XX-name/DISCOVERY.md`
 </step>
@@ -171,7 +170,7 @@ For: Architectural decisions, novel problems, high-risk choices.
 
 7. **Confidence gate:** If overall confidence is LOW, present options before proceeding.
 
-8. Return to plan-phase.md.
+8. Return to plan-create.md.
 
 **Output:** `.planning/phases/XX-name/DISCOVERY.md` (comprehensive)
 </step>

package/dist/assets/templates/workflows/discuss-phase.md

@@ -11,7 +11,6 @@ You are a thinking partner, not an interviewer. The user is the visionary — yo
 </purpose>
 
 <required_reading>
-@./references/dashboard-bridge.md
 @./references/thinking-partner.md
 </required_reading>
 
@@ -27,13 +26,11 @@ Every question directed at the user MUST use a structured tool. NEVER write a qu
 - Any clarification or follow-up question
 - Existing context handling (update/view/skip)
 
-**Tool selection:** At workflow start, probe for the dashboard (see @dashboard-bridge). Then:
-- **DASHBOARD_ACTIVE = true** → use `mcp__maxsim-dashboard__ask_question` (questions appear in browser). Follow the schema translation rules from @dashboard-bridge.
-- **DASHBOARD_ACTIVE = false** → use `AskUserQuestion` (questions appear in terminal).
+**Tool selection:** Use `AskUserQuestion` (questions appear in terminal).
 
 **Why:** Plain-text questions create a worse UX — the user has to type free-form answers instead of selecting from well-designed options. Structured choices are the entire point of the discuss workflow.
 
-**The rule is simple:** If you need input from the user → use the appropriate structured tool based on dashboard availability. Zero exceptions.
+**The rule is simple:** If you need input from the user → use `AskUserQuestion`. Zero exceptions.
 </tool_mandate>
 
 <downstream_awareness>
@@ -603,19 +600,19 @@ Display banner:
  MAXSIM ► AUTO-ADVANCING TO PLAN
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Context captured. Spawning plan-phase...
+Context captured. Spawning plan...
 ```
 
-Spawn plan-phase as Task with direct workflow file reference (do NOT use Skill tool — Skills don't resolve inside Task subagents):
+Spawn plan as Task with direct workflow file reference (do NOT use Skill tool — Skills don't resolve inside Task subagents):
 ```
 Task(
   prompt="
     <objective>
-    You are the plan-phase orchestrator. Create executable plans for Phase ${PHASE}: ${PHASE_NAME}, then auto-advance to execution.
+    You are the plan orchestrator. Create executable plans for Phase ${PHASE}: ${PHASE_NAME}, then auto-advance to execution.
     </objective>
 
     <execution_context>
-    @./workflows/plan-phase.md
+    @./workflows/plan.md
     @./references/ui-brand.md
     @./references/model-profile-resolution.md
     </execution_context>
@@ -626,7 +623,7 @@ Task(
     </arguments>
 
     <instructions>
-    1. Read plan-phase.md from execution_context for your complete workflow
+    1. Read plan.md from execution_context for your complete workflow
     2. Follow ALL steps: initialize, validate, load context, research, plan, verify, auto-advance
     3. When spawning agents (researcher, planner), use Task with specified subagent_type and model
     4. For step 14 (auto-advance to execute): spawn execute-phase as a Task with DIRECT file reference — tell it to read execute-phase.md. Include @file refs to execute-phase.md, checkpoints.md, tdd.md, model-profile-resolution.md. Pass --no-transition flag so execute-phase returns results instead of chaining further.
@@ -639,7 +636,7 @@ Task(
 )
 ```
 
-**Handle plan-phase return:**
+**Handle plan return:**
 - **PHASE COMPLETE** → Full chain succeeded. Display:
   ```
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

package/dist/assets/templates/workflows/execute-phase.md

@@ -24,8 +24,6 @@ Orchestrator coordinates, not executes. Each subagent loads the full execute-pla
 
 <required_reading>
 Read STATE.md before any operation to load project context.
-
-@./references/dashboard-bridge.md
 </required_reading>
 
 <process>
@@ -53,19 +51,6 @@ REVIEW_CONFIG (from init JSON review_config — spec_review, code_review, simpli
 When `parallelization` is false, plans within a wave execute sequentially.
 </step>
 
-<step name="probe_dashboard">
-Probe for MCP dashboard availability (see @dashboard-bridge). If `DASHBOARD_ACTIVE`, emit:
-```
-mcp__maxsim-dashboard__submit_lifecycle_event(
-  event_type: "phase-started",
-  phase_name: PHASE_NAME,
-  phase_number: PHASE_NUMBER
-)
-```
-
-**Note:** The dashboard is NOT auto-launched. Users start it explicitly via `maxsim dashboard`. This step only checks if a running dashboard is reachable via MCP.
-</step>
-
 <step name="handle_branching">
 Check `branching_strategy` from init:
 
@@ -124,17 +109,12 @@ When `phase_issue_number` is set (GitHub integration active):
 
 **Filtering:** Skip plans where `has_summary: true`. If `--gaps-only`: also skip non-gap_closure plans. If all filtered: "No matching incomplete plans" → exit.
 
-**Fallback -- no GitHub integration:**
-
-When `phase_issue_number` is not set, use local file scanning:
+**If GitHub integration is NOT active** (`phase_issue_number` is not set):
 
-```bash
-PLAN_INDEX=$(node ~/.claude/maxsim/bin/maxsim-tools.cjs phase-plan-index "${PHASE_NUMBER}")
+GitHub Issues is the source of truth for plans. Report the error and exit:
+```
+GitHub integration required. Ensure GitHub Issues is configured: run /maxsim:init to set up.
 ```
-
-Parse JSON for: `phase`, `plans[]` (each with `id`, `wave`, `autonomous`, `objective`, `files_modified`, `task_count`, `has_summary`), `waves` (map of wave number → plan IDs), `incomplete`, `has_checkpoints`.
-
-**Skip plans where `has_summary: true`** (local SUMMARY.md file present). If `--gaps-only`: also skip non-gap_closure plans.
 
 Report:
 ```
@@ -322,7 +302,7 @@ For each wave:
 
 1. **Describe what's being built (BEFORE spawning):**
 
-   Read each plan's `<objective>` from the plan comment content (or local PLAN.md in fallback). Extract what's being built and why.
+   Read each plan's `<objective>` from the plan comment content. Extract what's being built and why.
 
    ```
    ---
@@ -338,16 +318,7 @@ For each wave:
    - Bad: "Executing terrain generation plan"
    - Good: "Procedural terrain generator using Perlin noise — creates height maps, biome zones, and collision meshes. Required before vehicle physics can interact with ground."
 
-2. **Emit plan-started lifecycle event** (if `DASHBOARD_ACTIVE`):
-   ```
-   mcp__maxsim-dashboard__submit_lifecycle_event(
-     event_type: "plan-started",
-     phase_name: PHASE_NAME, phase_number: PHASE_NUMBER,
-     step: plan_index, total_steps: total_plans
-   )
-   ```
-
-3. **Spawn executor agents:**
+2. **Spawn executor agents:**
 
    Pass plan content from GitHub and GitHub context — executors do NOT need to read local PLAN.md files.
    This keeps orchestrator context lean (~10-15%).
@@ -421,16 +392,7 @@ For each wave:
 
    Review stages to check: `Spec:` and `Code:` lines in `## Review Cycle`. Both must be PASS or SKIPPED for the plan to be considered review-complete.
 
-   If pass — **emit plan-complete lifecycle event** (if `DASHBOARD_ACTIVE`):
-   ```
-   mcp__maxsim-dashboard__submit_lifecycle_event(
-     event_type: "plan-complete",
-     phase_name: PHASE_NAME, phase_number: PHASE_NUMBER,
-     step: plan_index, total_steps: total_plans
-   )
-   ```
-
-   Then report:
+   If pass — report:
    ```
    ---
    ## Wave {N} Complete
@@ -583,12 +545,6 @@ When GitHub integration is active, look for `<!-- maxsim:type=uat -->` comments
 mcp_get_issue_detail(issue_number: parent_phase_issue_number)
 ```
 
-As fallback, check local files:
-```bash
-PARENT_INFO=$(node ~/.claude/maxsim/bin/maxsim-tools.cjs find-phase "${PARENT_PHASE}" --raw)
-# Extract directory from PARENT_INFO JSON, then find UAT file in that directory
-```
-
 **If no parent UAT found:** Skip this step (gap-closure may have been triggered by VERIFICATION.md instead).
 
 **3. Update UAT gap statuses:**
@@ -645,11 +601,6 @@ mcp_get_issue_detail(issue_number: phase_issue_number)
 
 Look for `<!-- maxsim:type=verification -->` comment and parse `status:` field.
 
-Fallback:
-```bash
-grep "^status:" "$PHASE_DIR"/*-VERIFICATION.md | cut -d: -f2 | tr -d ' '
-```
-
 | Status | Action |
 |--------|--------|
 | `passed` | → update_roadmap |
@@ -725,14 +676,6 @@ mcp_post_comment(
 )
 ```
 
-**Emit phase-complete lifecycle event** (if `DASHBOARD_ACTIVE`):
-```
-mcp__maxsim-dashboard__submit_lifecycle_event(
-  event_type: "phase-complete",
-  phase_name: PHASE_NAME,
-  phase_number: PHASE_NUMBER
-)
-```
 </step>
 
 <step name="offer_next">
@@ -745,8 +688,7 @@ Parse `--no-transition` flag from $ARGUMENTS.
 
 **If `--no-transition` flag present:**
 
-Execute-phase was spawned by plan-phase's auto-advance. Do NOT run transition.md.
-After verification passes and roadmap is updated, return completion status to parent:
+Execute-phase was spawned by plan's auto-advance. After verification passes and roadmap is updated, return completion status to parent:
 
 ```
 ## PHASE COMPLETE
@@ -780,13 +722,11 @@ STOP. Do not proceed to auto-advance or transition.
 ╚══════════════════════════════════════════╝
 ```
 
-Execute the transition workflow inline (do NOT use Task — orchestrator context is ~10-15%, transition needs phase completion data already in context):
-
-Read and follow `~/.claude/maxsim/workflows/transition.md`, passing through the `--auto` flag so it propagates to the next phase invocation.
+Phase advancement is complete. The user may run `/maxsim:go` or `/maxsim:execute` to continue to the next phase.
 
 **If neither `--auto` nor `AUTO_CFG` is true:**
 
-The workflow ends. The user runs `/maxsim:progress` or invokes the transition workflow manually.
+The workflow ends. The user runs `/maxsim:go` or `/maxsim:execute` to advance to the next phase.
 </step>
 
 </process>
@@ -802,7 +742,7 @@ Plan content passed directly from GitHub comments to subagents — no local PLAN
 - **Dependency chain breaks:** Wave 1 fails → Wave 2 dependents likely fail → user chooses attempt or skip
 - **All agents in wave fail:** Systemic issue → stop, report for investigation
 - **Checkpoint unresolvable:** "Skip this plan?" or "Abort phase execution?" → record partial progress in STATE.md
-- **GitHub integration unavailable:** Fall back to local file I/O for all plan reading and summary writing
+- **GitHub integration unavailable:** Report error — GitHub Issues is the source of truth for plans and summaries
 </failure_handling>
 
 <resumption>