maxsimcli 4.8.0 → 4.10.0

package/dist/install.cjs

@@ -46,6 +46,7 @@ let node_readline = require("node:readline");
 node_readline = __toESM(node_readline);
 let node_crypto = require("node:crypto");
 node_crypto = __toESM(node_crypto);
+let node_child_process = require("node:child_process");
 
 //#region ../../node_modules/universalify/index.js
 var require_universalify = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -7290,7 +7291,15 @@ const builtInSkills = [
 	"brainstorming",
 	"roadmap-writing",
 	"sdd",
-	"maxsim-batch"
+	"maxsim-batch",
+	"agent-system-map",
+	"commit-conventions",
+	"evidence-collection",
+	"handoff-contract",
+	"input-validation",
+	"research-methodology",
+	"tool-priority-guide",
+	"verification-gates"
 ];
 /**
 * Get the global config directory for Claude Code.
@@ -7429,7 +7438,79 @@ function getCommitAttribution(explicitConfigDir) {
 * Clean up orphaned files from previous MAXSIM versions
 */
 function cleanupOrphanedFiles(configDir) {
-	for (const relPath of ["hooks/maxsim-notify.sh", "hooks/statusline.js"]) {
+	for (const relPath of [
+		"hooks/maxsim-notify.sh",
+		"hooks/statusline.js",
+		"commands/maxsim/add-phase.md",
+		"commands/maxsim/add-tests.md",
+		"commands/maxsim/add-todo.md",
+		"commands/maxsim/artefakte.md",
+		"commands/maxsim/audit-milestone.md",
+		"commands/maxsim/batch.md",
+		"commands/maxsim/check-drift.md",
+		"commands/maxsim/check-todos.md",
+		"commands/maxsim/cleanup.md",
+		"commands/maxsim/complete-milestone.md",
+		"commands/maxsim/discuss-phase.md",
+		"commands/maxsim/discuss.md",
+		"commands/maxsim/execute-phase.md",
+		"commands/maxsim/health.md",
+		"commands/maxsim/init-existing.md",
+		"commands/maxsim/insert-phase.md",
+		"commands/maxsim/list-phase-assumptions.md",
+		"commands/maxsim/map-codebase.md",
+		"commands/maxsim/new-milestone.md",
+		"commands/maxsim/new-project.md",
+		"commands/maxsim/pause-work.md",
+		"commands/maxsim/plan-milestone-gaps.md",
+		"commands/maxsim/plan-phase.md",
+		"commands/maxsim/realign.md",
+		"commands/maxsim/reapply-patches.md",
+		"commands/maxsim/remove-phase.md",
+		"commands/maxsim/research-phase.md",
+		"commands/maxsim/resume-work.md",
+		"commands/maxsim/roadmap.md",
+		"commands/maxsim/sdd.md",
+		"commands/maxsim/set-profile.md",
+		"commands/maxsim/update.md",
+		"commands/maxsim/verify-work.md",
+		"agents/maxsim-code-reviewer.md",
+		"agents/maxsim-codebase-mapper.md",
+		"agents/maxsim-debugger.md",
+		"agents/maxsim-drift-checker.md",
+		"agents/maxsim-executor.md",
+		"agents/maxsim-integration-checker.md",
+		"agents/maxsim-phase-researcher.md",
+		"agents/maxsim-plan-checker.md",
+		"agents/maxsim-planner.md",
+		"agents/maxsim-project-researcher.md",
+		"agents/maxsim-research-synthesizer.md",
+		"agents/maxsim-roadmapper.md",
+		"agents/maxsim-spec-reviewer.md",
+		"agents/maxsim-verifier.md",
+		"hooks/maxsim-context-monitor.js",
+		"maxsim/workflows/add-phase.md",
+		"maxsim/workflows/add-tests.md",
+		"maxsim/workflows/add-todo.md",
+		"maxsim/workflows/audit-milestone.md",
+		"maxsim/workflows/check-drift.md",
+		"maxsim/workflows/check-todos.md",
+		"maxsim/workflows/cleanup.md",
+		"maxsim/workflows/complete-milestone.md",
+		"maxsim/workflows/discuss.md",
+		"maxsim/workflows/insert-phase.md",
+		"maxsim/workflows/list-phase-assumptions.md",
+		"maxsim/workflows/map-codebase.md",
+		"maxsim/workflows/pause-work.md",
+		"maxsim/workflows/plan-milestone-gaps.md",
+		"maxsim/workflows/realign.md",
+		"maxsim/workflows/remove-phase.md",
+		"maxsim/workflows/resume-project.md",
+		"maxsim/workflows/roadmap.md",
+		"maxsim/workflows/set-profile.md",
+		"maxsim/workflows/transition.md",
+		"maxsim/workflows/update.md"
+	]) {
 		const fullPath = node_path.join(configDir, relPath);
 		if (node_fs.existsSync(fullPath)) {
 			node_fs.unlinkSync(fullPath);
@@ -7446,7 +7527,8 @@ function cleanupOrphanedHooks(settings) {
 		"hooks/statusline.js",
 		"maxsim-intel-index.js",
 		"maxsim-intel-session.js",
-		"maxsim-intel-prune.js"
+		"maxsim-intel-prune.js",
+		"maxsim-context-monitor"
 	];
 	let cleanedHooks = false;
 	const hooks = settings.hooks;
@@ -7513,7 +7595,7 @@ function configureSettingsHooks(targetDir, isGlobal) {
 	const settings = cleanupOrphanedHooks(readSettings(settingsPath));
 	const statuslineCommand = isGlobal ? buildHookCommand(targetDir, "maxsim-statusline.js") : "node " + dirName + "/hooks/maxsim-statusline.js";
 	const updateCheckCommand = isGlobal ? buildHookCommand(targetDir, "maxsim-check-update.js") : "node " + dirName + "/hooks/maxsim-check-update.js";
-	const contextMonitorCommand = isGlobal ? buildHookCommand(targetDir, "maxsim-context-monitor.js") : "node " + dirName + "/hooks/maxsim-context-monitor.js";
+	const syncReminderCommand = isGlobal ? buildHookCommand(targetDir, "maxsim-sync-reminder.js") : "node " + dirName + "/hooks/maxsim-sync-reminder.js";
 	if (!settings.hooks) settings.hooks = {};
 	const installHooks = settings.hooks;
 	if (!installHooks.SessionStart) installHooks.SessionStart = [];
@@ -7525,19 +7607,22 @@ function configureSettingsHooks(targetDir, isGlobal) {
 		console.log(`  ${chalk.green("✓")} Configured update check hook`);
 	}
 	if (!installHooks.PostToolUse) installHooks.PostToolUse = [];
-	if (!installHooks.PostToolUse.some((entry) => entry.hooks && entry.hooks.some((h) => h.command && h.command.includes("maxsim-context-monitor")))) {
-		installHooks.PostToolUse.push({ hooks: [{
-			type: "command",
-			command: contextMonitorCommand
-		}] });
-		console.log(`  ${chalk.green("✓")} Configured context window monitor hook`);
+	if (!installHooks.PostToolUse.some((entry) => entry.hooks && entry.hooks.some((h) => h.command && h.command.includes("maxsim-sync-reminder")))) {
+		installHooks.PostToolUse.push({
+			matcher: "Write|Edit",
+			hooks: [{
+				type: "command",
+				command: syncReminderCommand
+			}]
+		});
+		console.log(`  ${chalk.green("✓")} Configured sync reminder hook`);
 	}
 	return {
 		settingsPath,
 		settings,
 		statuslineCommand,
 		updateCheckCommand,
-		contextMonitorCommand
+		syncReminderCommand
 	};
 }
 /**
@@ -7561,8 +7646,8 @@ async function handleStatusline(settings, isInteractive, forceStatusline) {
 	console.log();
 	console.log("  MAXSIM includes a statusline showing:");
 	console.log("    • Model name");
-	console.log("    • Current task (from todo list)");
-	console.log("    • Context window usage (color-coded)");
+	console.log("    • Current phase number");
+	console.log("    • Milestone progress percentage");
 	console.log();
 	return await dist_default({
 		message: "Replace with MAXSIM statusline?",
@@ -7588,6 +7673,103 @@ function finishInstall(settingsPath, settings, statuslineCommand, shouldInstallS
 `);
 }
 
+//#endregion
+//#region src/hooks/shared.ts
+/** The '.claude' path segment -- template marker replaced during install. */
+const CLAUDE_DIR = ".claude";
+
+//#endregion
+//#region src/hooks/maxsim-check-update.ts
+/**
+* Check for MAXSIM updates in background, write result to cache.
+* Called by SessionStart hook - runs once per session.
+*/
+function checkForUpdate(options) {
+	const { homeDir, cwd } = options;
+	const cacheDir = node_path.join(homeDir, CLAUDE_DIR, "cache");
+	const cacheFile = node_path.join(cacheDir, "maxsim-update-check.json");
+	const projectVersionFile = node_path.join(cwd, CLAUDE_DIR, "maxsim", "VERSION");
+	const globalVersionFile = node_path.join(homeDir, CLAUDE_DIR, "maxsim", "VERSION");
+	if (!node_fs.existsSync(cacheDir)) node_fs.mkdirSync(cacheDir, { recursive: true });
+	(0, node_child_process.spawn)(process.execPath, ["-e", `
+  const fs = require('fs');
+  const { execSync } = require('child_process');
+
+  const cacheFile = ${JSON.stringify(cacheFile)};
+  const projectVersionFile = ${JSON.stringify(projectVersionFile)};
+  const globalVersionFile = ${JSON.stringify(globalVersionFile)};
+
+  // Check project directory first (local install), then global
+  let installed = '0.0.0';
+  try {
+    if (fs.existsSync(projectVersionFile)) {
+      installed = fs.readFileSync(projectVersionFile, 'utf8').trim();
+    } else if (fs.existsSync(globalVersionFile)) {
+      installed = fs.readFileSync(globalVersionFile, 'utf8').trim();
+    }
+  } catch (e) {}
+
+  let latest = null;
+  try {
+    latest = execSync('npm view maxsimcli version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
+  } catch (e) {}
+
+  const result = {
+    update_available: latest && installed !== latest,
+    installed,
+    latest: latest || 'unknown',
+    checked: Math.floor(Date.now() / 1000)
+  };
+
+  fs.writeFileSync(cacheFile, JSON.stringify(result));
+`], {
+		stdio: "ignore",
+		windowsHide: true,
+		detached: true
+	}).unref();
+}
+/**
+* Create a backup of the current MAXSIM installation before an update.
+* Called by the installer (not by the SessionStart hook).
+*
+* @param cwd - The project working directory containing .claude/
+* @returns The backup directory path on success, null on failure.
+*/
+function createBackupBeforeUpdate(cwd) {
+	try {
+		const sourceDir = node_path.join(cwd, CLAUDE_DIR);
+		const backupDir = node_path.join(sourceDir, "maxsim-backup");
+		node_fs.mkdirSync(backupDir, { recursive: true });
+		for (const relDir of [
+			"commands/maxsim",
+			"maxsim",
+			"hooks",
+			"agents",
+			"skills"
+		]) {
+			const src = node_path.join(sourceDir, relDir);
+			if (!node_fs.existsSync(src)) continue;
+			const dest = node_path.join(backupDir, relDir);
+			node_fs.mkdirSync(node_path.dirname(dest), { recursive: true });
+			node_fs.cpSync(src, dest, { recursive: true });
+		}
+		let version = "unknown";
+		const versionFile = node_path.join(sourceDir, "maxsim", "VERSION");
+		if (node_fs.existsSync(versionFile)) version = node_fs.readFileSync(versionFile, "utf8").trim();
+		node_fs.writeFileSync(node_path.join(backupDir, "backup-meta.json"), JSON.stringify({
+			created: (/* @__PURE__ */ new Date()).toISOString(),
+			version
+		}, null, 2));
+		return backupDir;
+	} catch {
+		return null;
+	}
+}
+if (require.main === module) checkForUpdate({
+	homeDir: node_os.homedir(),
+	cwd: process.cwd()
+});
+
 //#endregion
 //#region src/install/manifest.ts
 const MANIFEST_NAME = "maxsim-file-manifest.json";
@@ -7811,7 +7993,8 @@ function uninstall(isGlobal, explicitConfigDir = null) {
 			"maxsim-statusline.js",
 			"maxsim-check-update.js",
 			"maxsim-check-update.sh",
-			"maxsim-context-monitor.js"
+			"maxsim-context-monitor.js",
+			"maxsim-sync-reminder.js"
 		];
 		let hookCount = 0;
 		for (const hook of maxsimHooks) {
@@ -7860,7 +8043,7 @@ function uninstall(isGlobal, explicitConfigDir = null) {
 		if (settingsHooks && settingsHooks.PostToolUse) {
 			const before = settingsHooks.PostToolUse.length;
 			settingsHooks.PostToolUse = settingsHooks.PostToolUse.filter((entry) => {
-				if (entry.hooks && Array.isArray(entry.hooks)) return !entry.hooks.some((h) => h.command && h.command.includes("maxsim-context-monitor"));
+				if (entry.hooks && Array.isArray(entry.hooks)) return !entry.hooks.some((h) => h.command && (h.command.includes("maxsim-context-monitor") || h.command.includes("maxsim-sync-reminder")));
 				return true;
 			});
 			if (settingsHooks.PostToolUse.length < before) {
@@ -7950,6 +8133,7 @@ async function install() {
 		if (!complete) console.log(`  ${chalk.yellow("!")} Previous install (v${existingManifest.version}) is incomplete -- ${missing.length} missing file(s). Re-installing.`);
 		else if (isAlreadyCurrent) console.log(`  ${chalk.dim(`Version ${pkg.version} already installed -- upgrading in place`)}`);
 	}
+	if (existingManifest !== null) createBackupBeforeUpdate(process.cwd());
 	saveLocalPatches(targetDir);
 	cleanupOrphanedFiles(targetDir);
 	let spinner = ora({
@@ -8045,6 +8229,27 @@ async function install() {
 			failures.push("skills");
 		}
 	}
+	const rulesSrc = node_path.join(src, "rules");
+	if (node_fs.existsSync(rulesSrc)) {
+		spinner = ora({
+			text: "Installing rules...",
+			color: "cyan"
+		}).start();
+		const rulesDest = node_path.join(targetDir, "rules");
+		node_fs.mkdirSync(rulesDest, { recursive: true });
+		const ruleEntries = node_fs.readdirSync(rulesSrc, { withFileTypes: true });
+		for (const entry of ruleEntries) if (entry.isFile() && entry.name.endsWith(".md")) {
+			let content = node_fs.readFileSync(node_path.join(rulesSrc, entry.name), "utf8");
+			content = content.replace(/~\/\.claude\//g, pathPrefix);
+			node_fs.writeFileSync(node_path.join(rulesDest, entry.name), content);
+		}
+		const installedRuleFiles = node_fs.readdirSync(rulesDest).filter((f) => f.endsWith(".md")).length;
+		if (installedRuleFiles > 0) spinner.succeed(chalk.green("✓") + ` Installed ${installedRuleFiles} rules to rules/`);
+		else {
+			spinner.fail("Failed to install rules");
+			failures.push("rules");
+		}
+	}
 	const changelogSrc = node_path.join(src, "..", "CHANGELOG.md");
 	const changelogDest = node_path.join(targetDir, "maxsim", "CHANGELOG.md");
 	if (node_fs.existsSync(changelogSrc)) {
@@ -8167,9 +8372,21 @@ async function installForClaude(isInteractive) {
 	const result = await install();
 	let shouldInstallStatusline = false;
 	if (result.settings) shouldInstallStatusline = await handleStatusline(result.settings, isInteractive, forceStatusline);
+	const agentTeamsAlreadyEnabled = process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS === "1";
 	let enableAgentTeams = false;
-	if (isInteractive) enableAgentTeams = await promptAgentTeams();
-	if (enableAgentTeams && result.settings) {
+	if (agentTeamsAlreadyEnabled) console.log(`  ${chalk.green("✓")} Agent Teams: enabled`);
+	else if (isInteractive) enableAgentTeams = await promptAgentTeams();
+	else {
+		console.log();
+		console.log(chalk.cyan("  Agent Teams") + chalk.dim(" (Recommended for Parallel Execution)"));
+		console.log(chalk.dim("  MAXSIM's parallel execution uses Agent Teams for coordinating multiple agents."));
+		console.log(chalk.dim("  To enable, add to your environment:"));
+		console.log();
+		console.log(chalk.yellow("    export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1"));
+		console.log();
+		console.log(chalk.dim("  Or add to your shell profile (~/.bashrc, ~/.zshrc, etc.)"));
+	}
+	if ((enableAgentTeams || agentTeamsAlreadyEnabled) && result.settings) {
 		const env = result.settings.env ?? {};
 		env["CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS"] = "1";
 		result.settings.env = env;