maxsimcli 4.15.3 → 4.16.0

package/dist/mcp-server.cjs

@@ -7,6 +7,19 @@ var __getOwnPropNames$1 = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp$1 = Object.prototype.hasOwnProperty;
 var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp$1(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp$1(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
 var __copyProps$1 = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") {
 		for (var keys = __getOwnPropNames$1(from), i = 0, n = keys.length, key; i < n; i++) {
@@ -26765,8 +26778,9 @@ function configPath(cwd) {
 function phasesPath(cwd) {
 	return planningPath(cwd, "phases");
 }
-/** Phase-file predicates. */
+/** Phase-file predicates. @deprecated Use GitHub Issues for plan/summary tracking. Local fallback only. */
 const isPlanFile = (f) => f.endsWith("-PLAN.md") || f === "PLAN.md";
+/** @deprecated Use GitHub Issues for plan/summary tracking. Local fallback only. */
 const isSummaryFile = (f) => f.endsWith("-SUMMARY.md") || f === "SUMMARY.md";
 /** Strip suffix to get plan/summary ID. */
 const planId = (f) => f.replace("-PLAN.md", "").replace("PLAN.md", "");
@@ -27005,10 +27019,19 @@ async function searchPhaseInDir(baseDir, relBase, normalized) {
 }
 async function findPhaseInternal(cwd, phase) {
 	if (!phase) return null;
-	const pd = phasesPath(cwd);
 	const normalized = normalizePhaseName(phase);
-	const current = await searchPhaseInDir(pd, node_path.default.join(".planning", "phases"), normalized);
-	if (current) return current;
+	try {
+		const { findPhaseFromGitHub } = await Promise.resolve().then(() => sync_exports);
+		const ghResult = await findPhaseFromGitHub(cwd, normalized);
+		if (ghResult) return ghResult;
+	} catch {
+		debugLog("find-phase-github-fallback", "GitHub lookup failed, falling back to local");
+	}
+	const current = await searchPhaseInDir(phasesPath(cwd), node_path.default.join(".planning", "phases"), normalized);
+	if (current) {
+		current.source = "local";
+		return current;
+	}
 	const archiveDir = planningPath(cwd, "archive");
 	if (await pathExistsInternal(archiveDir)) try {
 		const versionDirs = (await node_fs.promises.readdir(archiveDir, { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name).sort().reverse();
@@ -27016,29 +27039,13 @@ async function findPhaseInternal(cwd, phase) {
 			const result = await searchPhaseInDir(node_path.default.join(archiveDir, versionName), node_path.default.join(".planning", "archive", versionName), normalized);
 			if (result) {
 				result.archived = versionName;
+				result.source = "local";
 				return result;
 			}
 		}
 	} catch (e) {
 		debugLog("find-phase-async-archive-search-failed", e);
 	}
-	const milestonesDir = planningPath(cwd, "milestones");
-	if (!await pathExistsInternal(milestonesDir)) return null;
-	try {
-		const archiveDirs = (await node_fs.promises.readdir(milestonesDir, { withFileTypes: true })).filter((e) => e.isDirectory() && /^v[\d.]+-phases$/.test(e.name)).map((e) => e.name).sort().reverse();
-		for (const archiveName of archiveDirs) {
-			const versionMatch = archiveName.match(/^(v[\d.]+)-phases$/);
-			if (!versionMatch) continue;
-			const version = versionMatch[1];
-			const result = await searchPhaseInDir(node_path.default.join(milestonesDir, archiveName), node_path.default.join(".planning", "milestones", archiveName), normalized);
-			if (result) {
-				result.archived = version;
-				return result;
-			}
-		}
-	} catch (e) {
-		debugLog("find-phase-async-milestone-search-failed", e);
-	}
 	return null;
 }
 async function getArchivedPhaseDirs(cwd) {
@@ -27059,25 +27066,6 @@ async function getArchivedPhaseDirs(cwd) {
 	} catch (e) {
 		debugLog("get-archived-phase-dirs-async-archive-failed", e);
 	}
-	const milestonesDir = planningPath(cwd, "milestones");
-	try {
-		const phaseDirs = (await node_fs.promises.readdir(milestonesDir, { withFileTypes: true })).filter((e) => e.isDirectory() && /^v[\d.]+-phases$/.test(e.name)).map((e) => e.name).sort().reverse();
-		for (const archiveName of phaseDirs) {
-			const versionMatch = archiveName.match(/^(v[\d.]+)-phases$/);
-			if (!versionMatch) continue;
-			const version = versionMatch[1];
-			const archiveMilestonePath = node_path.default.join(milestonesDir, archiveName);
-			const dirs = await listSubDirs(archiveMilestonePath, true);
-			for (const dir of dirs) results.push({
-				name: dir,
-				milestone: version,
-				basePath: node_path.default.join(".planning", "milestones", archiveName),
-				fullPath: node_path.default.join(archiveMilestonePath, dir)
-			});
-		}
-	} catch (e) {
-		debugLog("get-archived-phase-dirs-async-failed", e);
-	}
 	return results;
 }
 
@@ -33763,10 +33751,7 @@ function cmdErr(error) {
 *
 * Ported from maxsim/bin/lib/phase.cjs
 */
-async function scaffoldPhaseStubs(dirPath, phaseId, name) {
-	const today = todayISO();
-	await Promise.all([node_fs.promises.writeFile(node_path.default.join(dirPath, `${phaseId}-CONTEXT.md`), `# Phase ${phaseId} Context: ${name}\n\n**Created:** ${today}\n**Phase goal:** [To be defined during /maxsim:discuss-phase]\n\n---\n\n_Context will be populated by /maxsim:discuss-phase_\n`), node_fs.promises.writeFile(node_path.default.join(dirPath, `${phaseId}-RESEARCH.md`), `# Phase ${phaseId}: ${name} - Research\n\n**Researched:** Not yet\n**Domain:** TBD\n**Confidence:** TBD\n\n---\n\n_Research will be populated by /maxsim:research-phase_\n`)]);
-}
+async function scaffoldPhaseStubs(_dirPath, _phaseId, _name) {}
 async function phaseAddCore(cwd, description, options) {
 	const rmPath = roadmapPath(cwd);
 	let content;
@@ -33789,8 +33774,8 @@ async function phaseAddCore(cwd, description, options) {
 	const dirPath = planningPath(cwd, "phases", dirName);
 	await node_fs.promises.mkdir(dirPath, { recursive: true });
 	await node_fs.promises.writeFile(node_path.default.join(dirPath, ".gitkeep"), "");
-	if (options?.includeStubs) await scaffoldPhaseStubs(dirPath, paddedNum, description);
-	const phaseEntry = `\n### Phase ${newPhaseNum}: ${description}\n\n**Goal:** [To be planned]\n**Requirements**: TBD\n**Depends on:** Phase ${maxPhase}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /maxsim:plan-phase ${newPhaseNum} to break down)\n`;
+	if (options?.includeStubs) await /* @__PURE__ */ scaffoldPhaseStubs(dirPath, paddedNum, description);
+	const phaseEntry = `\n### Phase ${newPhaseNum}: ${description}\n\n**Goal:** [To be planned]\n**Requirements**: TBD\n**Depends on:** Phase ${maxPhase}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /maxsim:plan ${newPhaseNum} to break down)\n`;
 	let updatedContent;
 	const lastSeparator = content.lastIndexOf("\n---");
 	if (lastSeparator > 0) updatedContent = content.slice(0, lastSeparator) + phaseEntry + content.slice(lastSeparator);
@@ -33833,8 +33818,8 @@ async function phaseInsertCore(cwd, afterPhase, description, options) {
 	const dirPath = planningPath(cwd, "phases", dirName);
 	await node_fs.promises.mkdir(dirPath, { recursive: true });
 	await node_fs.promises.writeFile(node_path.default.join(dirPath, ".gitkeep"), "");
-	if (options?.includeStubs) await scaffoldPhaseStubs(dirPath, decimalPhase, description);
-	const phaseEntry = `\n### Phase ${decimalPhase}: ${description} (INSERTED)\n\n**Goal:** [Urgent work - to be planned]\n**Requirements**: TBD\n**Depends on:** Phase ${afterPhase}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /maxsim:plan-phase ${decimalPhase} to break down)\n`;
+	if (options?.includeStubs) await /* @__PURE__ */ scaffoldPhaseStubs(dirPath, decimalPhase, description);
+	const phaseEntry = `\n### Phase ${decimalPhase}: ${description} (INSERTED)\n\n**Goal:** [Urgent work - to be planned]\n**Requirements**: TBD\n**Depends on:** Phase ${afterPhase}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /maxsim:plan ${decimalPhase} to break down)\n`;
 	const headerPattern = new RegExp(`(#{2,4}\\s*Phase\\s+0*${afterPhaseEscaped}:[^\\n]*\\n)`, "i");
 	const headerMatch = content.match(headerPattern);
 	if (!headerMatch) throw new Error(`Could not find Phase ${afterPhase} header`);
@@ -38842,48 +38827,6 @@ function escapeStringRegexp(string) {
 	return string.replace(/[|\\{}()[\]^$+*?.]/g, "\\$&").replace(/-/g, "\\x2d");
 }
 
-//#endregion
-//#region src/core/state.ts
-/**
-* State — STATE.md operations and progression engine
-*
-* Ported from maxsim/bin/lib/state.cjs
-*/
-function stateExtractField(content, fieldName) {
-	const escaped = escapeStringRegexp(fieldName);
-	const boldPattern = new RegExp(`\\*\\*\\s*${escaped}\\s*:\\s*\\*\\*\\s*(.+)`, "i");
-	const boldMatch = content.match(boldPattern);
-	if (boldMatch) return boldMatch[1].trim();
-	const plainPattern = new RegExp(`^\\s*${escaped}\\s*:\\s*(.+)`, "im");
-	const plainMatch = content.match(plainPattern);
-	return plainMatch ? plainMatch[1].trim() : null;
-}
-function stateReplaceField(content, fieldName, newValue) {
-	const escaped = escapeStringRegexp(fieldName);
-	const boldPattern = new RegExp(`(\\*\\*\\s*${escaped}\\s*:\\s*\\*\\*\\s*)(.*)`, "i");
-	let replaced = content.replace(boldPattern, (_match, prefix) => `${prefix}${newValue}`);
-	if (replaced !== content) return replaced;
-	const plainPattern = new RegExp(`(^[ \\t]*${escaped}\\s*:\\s*)(.*)`, "im");
-	replaced = content.replace(plainPattern, (_match, prefix) => `${prefix}${newValue}`);
-	return replaced !== content ? replaced : null;
-}
-/**
-* Append an entry to a section in STATE.md content, removing placeholder text.
-* Returns updated content or null if section not found.
-*/
-function appendToStateSection(content, sectionPattern, entry, placeholderPatterns) {
-	const match = content.match(sectionPattern);
-	if (!match) return null;
-	let sectionBody = match[2];
-	for (const pat of placeholderPatterns || [
-		/None yet\.?\s*\n?/gi,
-		/No decisions yet\.?\s*\n?/gi,
-		/None\.?\s*\n?/gi
-	]) sectionBody = sectionBody.replace(pat, "");
-	sectionBody = sectionBody.trimEnd() + "\n" + entry + "\n";
-	return content.replace(sectionPattern, (_m, header) => `${header}${sectionBody}`);
-}
-
 //#endregion
 //#region src/github/sync.ts
 /**
@@ -38902,6 +38845,12 @@ function appendToStateSection(content, sectionPattern, entry, placeholderPattern
 * CRITICAL: All operations use client.ts (Octokit adapter) exclusively.
 * CRITICAL: Never call process.exit() — return GhResult instead.
 */
+var sync_exports = /* @__PURE__ */ __exportAll({
+	checkPhaseProgress: () => checkPhaseProgress,
+	detectInterruptedPhase: () => detectInterruptedPhase,
+	findPhaseFromGitHub: () => findPhaseFromGitHub,
+	getAllPhasesProgress: () => getAllPhasesProgress
+});
 /**
 * Get the progress of a phase by counting open/closed sub-issues.
 *
@@ -39019,6 +38968,130 @@ async function getAllPhasesProgress() {
 		return results;
 	});
 }
+/**
+* Populate a PhaseSearchResult from GitHub Issues data.
+*
+* Looks up the phase in the local mapping cache, then queries GitHub for
+* sub-issue counts and comments to derive plans/summaries/research status.
+*
+* Returns null if:
+* - No mapping file exists
+* - Phase not found in mapping
+* - GitHub API call fails
+*
+* @param cwd - Project root directory
+* @param phaseNum - Normalized phase number (e.g., "01", "02A")
+*/
+async function findPhaseFromGitHub(cwd, phaseNum) {
+	let mapping;
+	try {
+		mapping = loadMapping(cwd);
+	} catch {
+		return null;
+	}
+	if (!mapping) return null;
+	const phaseMapping = mapping.phases[phaseNum];
+	if (!phaseMapping) return null;
+	const issueNumber = phaseMapping.tracking_issue.number;
+	if (!issueNumber) return null;
+	const progressResult = await checkPhaseProgress(issueNumber);
+	if (!progressResult.ok) return null;
+	const { tasks, completed, total } = progressResult.data;
+	let phaseName = null;
+	let phaseSlug = null;
+	try {
+		const octokit = getOctokit();
+		const { owner, repo } = await getRepoInfo();
+		const titleMatch = (await octokit.rest.issues.get({
+			owner,
+			repo,
+			issue_number: issueNumber
+		})).data.title.match(/\[Phase\s+\S+\]\s*(.*)/);
+		if (titleMatch) {
+			phaseName = titleMatch[1].trim();
+			phaseSlug = phaseName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+		}
+	} catch {}
+	const planNames = tasks.map((t) => `task-${t.number}`);
+	const summaryNames = tasks.filter((t) => t.state === "closed").map((t) => `task-${t.number}`);
+	const completedSet = new Set(summaryNames);
+	const incompletePlans = planNames.filter((p) => !completedSet.has(p));
+	let hasResearch = false;
+	let hasContext = false;
+	let hasVerification = false;
+	try {
+		const octokit = getOctokit();
+		const { owner, repo } = await getRepoInfo();
+		const comments = await octokit.rest.issues.listComments({
+			owner,
+			repo,
+			issue_number: issueNumber,
+			per_page: 100
+		});
+		for (const comment of comments.data) {
+			const body = comment.body ?? "";
+			if (body.includes("<!-- maxsim:type=research -->") || body.includes("## Research") || body.startsWith("## Phase") && body.includes("Research")) hasResearch = true;
+			if (body.includes("<!-- maxsim:type=context -->") || body.includes("## Context")) hasContext = true;
+			if (body.includes("<!-- maxsim:type=verification -->") || body.includes("## Verification")) hasVerification = true;
+		}
+	} catch {}
+	return {
+		found: true,
+		directory: `.planning/phases/${phaseNum}-${phaseSlug || "unknown"}`,
+		phase_number: phaseNum,
+		phase_name: phaseName,
+		phase_slug: phaseSlug,
+		plans: planNames,
+		summaries: summaryNames,
+		incomplete_plans: incompletePlans,
+		has_research: hasResearch,
+		has_context: hasContext,
+		has_verification: hasVerification,
+		source: "github"
+	};
+}
+
+//#endregion
+//#region src/core/state.ts
+/**
+* State — STATE.md operations and progression engine
+*
+* Ported from maxsim/bin/lib/state.cjs
+*/
+function stateExtractField(content, fieldName) {
+	const escaped = escapeStringRegexp(fieldName);
+	const boldPattern = new RegExp(`\\*\\*\\s*${escaped}\\s*:\\s*\\*\\*\\s*(.+)`, "i");
+	const boldMatch = content.match(boldPattern);
+	if (boldMatch) return boldMatch[1].trim();
+	const plainPattern = new RegExp(`^\\s*${escaped}\\s*:\\s*(.+)`, "im");
+	const plainMatch = content.match(plainPattern);
+	return plainMatch ? plainMatch[1].trim() : null;
+}
+function stateReplaceField(content, fieldName, newValue) {
+	const escaped = escapeStringRegexp(fieldName);
+	const boldPattern = new RegExp(`(\\*\\*\\s*${escaped}\\s*:\\s*\\*\\*\\s*)(.*)`, "i");
+	let replaced = content.replace(boldPattern, (_match, prefix) => `${prefix}${newValue}`);
+	if (replaced !== content) return replaced;
+	const plainPattern = new RegExp(`(^[ \\t]*${escaped}\\s*:\\s*)(.*)`, "im");
+	replaced = content.replace(plainPattern, (_match, prefix) => `${prefix}${newValue}`);
+	return replaced !== content ? replaced : null;
+}
+/**
+* Append an entry to a section in STATE.md content, removing placeholder text.
+* Returns updated content or null if section not found.
+*/
+function appendToStateSection(content, sectionPattern, entry, placeholderPatterns) {
+	const match = content.match(sectionPattern);
+	if (!match) return null;
+	let sectionBody = match[2];
+	for (const pat of placeholderPatterns || [
+		/None yet\.?\s*\n?/gi,
+		/No decisions yet\.?\s*\n?/gi,
+		/None\.?\s*\n?/gi
+	]) sectionBody = sectionBody.replace(pat, "");
+	sectionBody = sectionBody.trimEnd() + "\n" + entry + "\n";
+	return content.replace(sectionPattern, (_m, header) => `${header}${sectionBody}`);
+}
 
 //#endregion
 //#region src/mcp/state-tools.ts
@@ -39315,6 +39388,20 @@ async function cmdRoadmapAnalyze(cwd) {
 			checkboxPattern: new RegExp(`-\\s*\\[(x| )\\]\\s*.*Phase\\s+${phaseNum.replace(".", "\\.")}`, "i")
 		});
 	}
+	let ghPhaseProgress = null;
+	try {
+		const mapping = loadMapping(cwd);
+		if (mapping && Object.keys(mapping.phases).length > 0) {
+			const ghResult = await getAllPhasesProgress();
+			if (ghResult.ok) {
+				ghPhaseProgress = /* @__PURE__ */ new Map();
+				for (const entry of ghResult.data) ghPhaseProgress.set(entry.phaseNumber, {
+					total: entry.progress.total,
+					completed: entry.progress.completed
+				});
+			}
+		}
+	} catch {}
 	let allDirs = [];
 	try {
 		allDirs = await listSubDirs(phasesDir);
@@ -39325,7 +39412,15 @@ async function cmdRoadmapAnalyze(cwd) {
 		let summaryCount = 0;
 		let hasContext = false;
 		let hasResearch = false;
-		try {
+		const ghData = ghPhaseProgress?.get(p.phaseNum);
+		if (ghData) {
+			planCount = ghData.total;
+			summaryCount = ghData.completed;
+			if (summaryCount >= planCount && planCount > 0) diskStatus = "complete";
+			else if (summaryCount > 0) diskStatus = "partial";
+			else if (planCount > 0) diskStatus = "planned";
+			else diskStatus = "empty";
+		} else try {
 			const dirMatch = allDirs.find((d) => d.startsWith(p.normalized + "-") || d === p.normalized);
 			if (dirMatch) {
 				const phaseFiles = await node_fs.promises.readdir(node_path.default.join(phasesDir, dirMatch));