maxsimcli 4.7.1 → 4.9.0

package/dist/install.cjs

@@ -32,10 +32,10 @@ let node_fs = require("node:fs");
 node_fs = __toESM(node_fs);
 let node_path = require("node:path");
 node_path = __toESM(node_path);
-let node_os = require("node:os");
-node_os = __toESM(node_os);
 let node_process = require("node:process");
 node_process = __toESM(node_process);
+let node_os = require("node:os");
+node_os = __toESM(node_os);
 let node_tty = require("node:tty");
 node_tty = __toESM(node_tty);
 let figlet = require("figlet");
@@ -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) => {
@@ -5643,11 +5644,7 @@ function ora(options) {
 
 //#endregion
 //#region ../../node_modules/@inquirer/core/dist/lib/key.js
-const isUpKey = (key, keybindings = []) => key.name === "up" || keybindings.includes("vim") && key.name === "k" || keybindings.includes("emacs") && key.ctrl && key.name === "p";
-const isDownKey = (key, keybindings = []) => key.name === "down" || keybindings.includes("vim") && key.name === "j" || keybindings.includes("emacs") && key.ctrl && key.name === "n";
-const isBackspaceKey = (key) => key.name === "backspace";
 const isTabKey = (key) => key.name === "tab";
-const isNumberKey = (key) => "1234567890".includes(key.name);
 const isEnterKey = (key) => key.name === "enter" || key.name === "return";
 
 //#endregion
@@ -6164,23 +6161,6 @@ function usePrefix({ status = "idle", theme }) {
 	return typeof prefix === "string" ? prefix : prefix[status === "loading" ? "idle" : status] ?? prefix["idle"];
 }
 
-//#endregion
-//#region ../../node_modules/@inquirer/core/dist/lib/use-memo.js
-function useMemo(fn, dependencies) {
-	return withPointer((pointer) => {
-		const prev = pointer.get();
-		if (!prev || prev.dependencies.length !== dependencies.length || prev.dependencies.some((dep, i) => dep !== dependencies[i])) {
-			const value = fn();
-			pointer.set({
-				value,
-				dependencies
-			});
-			return value;
-		}
-		return prev.value;
-	});
-}
-
 //#endregion
 //#region ../../node_modules/@inquirer/core/dist/lib/use-ref.js
 function useRef(val) {
@@ -6548,90 +6528,6 @@ function readlineWidth() {
 	});
 }
 
-//#endregion
-//#region ../../node_modules/@inquirer/core/dist/lib/pagination/use-pagination.js
-function usePointerPosition({ active, renderedItems, pageSize, loop }) {
-	const state = useRef({
-		lastPointer: active,
-		lastActive: void 0
-	});
-	const { lastPointer, lastActive } = state.current;
-	const middle = Math.floor(pageSize / 2);
-	const renderedLength = renderedItems.reduce((acc, item) => acc + item.length, 0);
-	const defaultPointerPosition = renderedItems.slice(0, active).reduce((acc, item) => acc + item.length, 0);
-	let pointer = defaultPointerPosition;
-	if (renderedLength > pageSize) if (loop) {
-		/**
-		* Creates the next position for the pointer considering an infinitely
-		* looping list of items to be rendered on the page.
-		*
-		* The goal is to progressively move the cursor to the middle position as the user move down, and then keep
-		* the cursor there. When the user move up, maintain the cursor position.
-		*/
-		pointer = lastPointer;
-		if (lastActive != null && lastActive < active && active - lastActive < pageSize) pointer = Math.min(middle, Math.abs(active - lastActive) === 1 ? Math.min(lastPointer + (renderedItems[lastActive]?.length ?? 0), Math.max(defaultPointerPosition, lastPointer)) : lastPointer + active - lastActive);
-	} else {
-		/**
-		* Creates the next position for the pointer considering a finite list of
-		* items to be rendered on a page.
-		*
-		* The goal is to keep the pointer in the middle of the page whenever possible, until
-		* we reach the bounds of the list (top or bottom). In which case, the cursor moves progressively
-		* to the bottom or top of the list.
-		*/
-		const spaceUnderActive = renderedItems.slice(active).reduce((acc, item) => acc + item.length, 0);
-		pointer = spaceUnderActive < pageSize - middle ? pageSize - spaceUnderActive : Math.min(defaultPointerPosition, middle);
-	}
-	state.current.lastPointer = pointer;
-	state.current.lastActive = active;
-	return pointer;
-}
-function usePagination({ items, active, renderItem, pageSize, loop = true }) {
-	const width = readlineWidth();
-	const bound = (num) => (num % items.length + items.length) % items.length;
-	const renderedItems = items.map((item, index) => {
-		if (item == null) return [];
-		return breakLines(renderItem({
-			item,
-			index,
-			isActive: index === active
-		}), width).split("\n");
-	});
-	const renderedLength = renderedItems.reduce((acc, item) => acc + item.length, 0);
-	const renderItemAtIndex = (index) => renderedItems[index] ?? [];
-	const pointer = usePointerPosition({
-		active,
-		renderedItems,
-		pageSize,
-		loop
-	});
-	const activeItem = renderItemAtIndex(active).slice(0, pageSize);
-	const activeItemPosition = pointer + activeItem.length <= pageSize ? pointer : pageSize - activeItem.length;
-	const pageBuffer = Array.from({ length: pageSize });
-	pageBuffer.splice(activeItemPosition, activeItem.length, ...activeItem);
-	const itemVisited = new Set([active]);
-	let bufferPointer = activeItemPosition + activeItem.length;
-	let itemPointer = bound(active + 1);
-	while (bufferPointer < pageSize && !itemVisited.has(itemPointer) && (loop && renderedLength > pageSize ? itemPointer !== active : itemPointer > active)) {
-		const linesToAdd = renderItemAtIndex(itemPointer).slice(0, pageSize - bufferPointer);
-		pageBuffer.splice(bufferPointer, linesToAdd.length, ...linesToAdd);
-		itemVisited.add(itemPointer);
-		bufferPointer += linesToAdd.length;
-		itemPointer = bound(itemPointer + 1);
-	}
-	bufferPointer = activeItemPosition - 1;
-	itemPointer = bound(active - 1);
-	while (bufferPointer >= 0 && !itemVisited.has(itemPointer) && (loop && renderedLength > pageSize ? itemPointer !== active : itemPointer < active)) {
-		const lines = renderItemAtIndex(itemPointer);
-		const linesToAdd = lines.slice(Math.max(0, lines.length - bufferPointer - 1));
-		pageBuffer.splice(bufferPointer - linesToAdd.length + 1, linesToAdd.length, ...linesToAdd);
-		itemVisited.add(itemPointer);
-		bufferPointer -= linesToAdd.length;
-		itemPointer = bound(itemPointer - 1);
-	}
-	return pageBuffer.filter((line) => typeof line === "string").join("\n");
-}
-
 //#endregion
 //#region ../../node_modules/mute-stream/lib/index.js
 var require_lib = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -7119,23 +7015,6 @@ function createPrompt(view) {
 	return prompt;
 }
 
-//#endregion
-//#region ../../node_modules/@inquirer/core/dist/lib/Separator.js
-/**
-* Separator object
-* Used to space/separate choices group
-*/
-var Separator = class {
-	separator = (0, node_util.styleText)("dim", Array.from({ length: 15 }).join(figures.line));
-	type = "separator";
-	constructor(separator) {
-		if (separator) this.separator = separator;
-	}
-	static isSeparator(choice) {
-		return Boolean(choice && typeof choice === "object" && "type" in choice && choice.type === "separator");
-	}
-};
-
 //#endregion
 //#region ../../node_modules/@inquirer/confirm/dist/index.js
 function getBooleanValue(value, defaultValue) {
@@ -7147,7 +7026,7 @@ function getBooleanValue(value, defaultValue) {
 function boolToString(value) {
 	return value ? "Yes" : "No";
 }
-var dist_default$1 = createPrompt((config, done) => {
+var dist_default = createPrompt((config, done) => {
 	const { transformer = boolToString } = config;
 	const [status, setStatus] = useState("idle");
 	const [value, setValue] = useState("");
@@ -7177,162 +7056,6 @@ var dist_default$1 = createPrompt((config, done) => {
 	return `${prefix} ${theme.style.message(config.message, status)}${defaultValue} ${formattedValue}`;
 });
 
-//#endregion
-//#region ../../node_modules/@inquirer/select/dist/index.js
-const selectTheme = {
-	icon: { cursor: figures.pointer },
-	style: {
-		disabled: (text) => (0, node_util.styleText)("dim", text),
-		description: (text) => (0, node_util.styleText)("cyan", text),
-		keysHelpTip: (keys) => keys.map(([key, action]) => `${(0, node_util.styleText)("bold", key)} ${(0, node_util.styleText)("dim", action)}`).join((0, node_util.styleText)("dim", " • "))
-	},
-	i18n: { disabledError: "This option is disabled and cannot be selected." },
-	indexMode: "hidden",
-	keybindings: []
-};
-function isSelectable(item) {
-	return !Separator.isSeparator(item) && !item.disabled;
-}
-function isNavigable(item) {
-	return !Separator.isSeparator(item);
-}
-function normalizeChoices(choices) {
-	return choices.map((choice) => {
-		if (Separator.isSeparator(choice)) return choice;
-		if (typeof choice !== "object" || choice === null || !("value" in choice)) {
-			const name = String(choice);
-			return {
-				value: choice,
-				name,
-				short: name,
-				disabled: false
-			};
-		}
-		const name = choice.name ?? String(choice.value);
-		const normalizedChoice = {
-			value: choice.value,
-			name,
-			short: choice.short ?? name,
-			disabled: choice.disabled ?? false
-		};
-		if (choice.description) normalizedChoice.description = choice.description;
-		return normalizedChoice;
-	});
-}
-var dist_default = createPrompt((config, done) => {
-	const { loop = true, pageSize = 7 } = config;
-	const theme = makeTheme(selectTheme, config.theme);
-	const { keybindings } = theme;
-	const [status, setStatus] = useState("idle");
-	const prefix = usePrefix({
-		status,
-		theme
-	});
-	const searchTimeoutRef = useRef();
-	const searchEnabled = !keybindings.includes("vim");
-	const items = useMemo(() => normalizeChoices(config.choices), [config.choices]);
-	const bounds = useMemo(() => {
-		const first = items.findIndex(isNavigable);
-		const last = items.findLastIndex(isNavigable);
-		if (first === -1) throw new ValidationError("[select prompt] No selectable choices. All choices are disabled.");
-		return {
-			first,
-			last
-		};
-	}, [items]);
-	const defaultItemIndex = useMemo(() => {
-		if (!("default" in config)) return -1;
-		return items.findIndex((item) => isSelectable(item) && item.value === config.default);
-	}, [config.default, items]);
-	const [active, setActive] = useState(defaultItemIndex === -1 ? bounds.first : defaultItemIndex);
-	const selectedChoice = items[active];
-	const [errorMsg, setError] = useState();
-	useKeypress((key, rl) => {
-		clearTimeout(searchTimeoutRef.current);
-		if (errorMsg) setError(void 0);
-		if (isEnterKey(key)) if (selectedChoice.disabled) setError(theme.i18n.disabledError);
-		else {
-			setStatus("done");
-			done(selectedChoice.value);
-		}
-		else if (isUpKey(key, keybindings) || isDownKey(key, keybindings)) {
-			rl.clearLine(0);
-			if (loop || isUpKey(key, keybindings) && active !== bounds.first || isDownKey(key, keybindings) && active !== bounds.last) {
-				const offset = isUpKey(key, keybindings) ? -1 : 1;
-				let next = active;
-				do
-					next = (next + offset + items.length) % items.length;
-				while (!isNavigable(items[next]));
-				setActive(next);
-			}
-		} else if (isNumberKey(key) && !Number.isNaN(Number(rl.line))) {
-			const selectedIndex = Number(rl.line) - 1;
-			let selectableIndex = -1;
-			const position = items.findIndex((item) => {
-				if (Separator.isSeparator(item)) return false;
-				selectableIndex++;
-				return selectableIndex === selectedIndex;
-			});
-			const item = items[position];
-			if (item != null && isSelectable(item)) setActive(position);
-			searchTimeoutRef.current = setTimeout(() => {
-				rl.clearLine(0);
-			}, 700);
-		} else if (isBackspaceKey(key)) rl.clearLine(0);
-		else if (searchEnabled) {
-			const searchTerm = rl.line.toLowerCase();
-			const matchIndex = items.findIndex((item) => {
-				if (Separator.isSeparator(item) || !isSelectable(item)) return false;
-				return item.name.toLowerCase().startsWith(searchTerm);
-			});
-			if (matchIndex !== -1) setActive(matchIndex);
-			searchTimeoutRef.current = setTimeout(() => {
-				rl.clearLine(0);
-			}, 700);
-		}
-	});
-	useEffect(() => () => {
-		clearTimeout(searchTimeoutRef.current);
-	}, []);
-	const message = theme.style.message(config.message, status);
-	const helpLine = theme.style.keysHelpTip([["↑↓", "navigate"], ["⏎", "select"]]);
-	let separatorCount = 0;
-	const page = usePagination({
-		items,
-		active,
-		renderItem({ item, isActive, index }) {
-			if (Separator.isSeparator(item)) {
-				separatorCount++;
-				return ` ${item.separator}`;
-			}
-			const cursor = isActive ? theme.icon.cursor : " ";
-			const indexLabel = theme.indexMode === "number" ? `${index + 1 - separatorCount}. ` : "";
-			if (item.disabled) {
-				const disabledLabel = typeof item.disabled === "string" ? item.disabled : "(disabled)";
-				const disabledCursor = isActive ? theme.icon.cursor : "-";
-				return theme.style.disabled(`${disabledCursor} ${indexLabel}${item.name} ${disabledLabel}`);
-			}
-			return (isActive ? theme.style.highlight : (x) => x)(`${cursor} ${indexLabel}${item.name}`);
-		},
-		pageSize,
-		loop
-	});
-	if (status === "done") return [
-		prefix,
-		message,
-		theme.style.answer(selectedChoice.short)
-	].filter(Boolean).join(" ");
-	const { description } = selectedChoice;
-	return `${[
-		[prefix, message].filter(Boolean).join(" "),
-		page,
-		" ",
-		description ? theme.style.description(description) : "",
-		errorMsg ? theme.style.error(errorMsg) : "",
-		helpLine
-	].filter(Boolean).join("\n").trimEnd()}${cursorHide}`;
-});
-
 //#endregion
 //#region ../../node_modules/minimist/index.js
 var require_minimist = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -7568,11 +7291,23 @@ 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.
 * Priority: explicitDir > CLAUDE_CONFIG_DIR env > ~/.claude
+*
+* @deprecated Global install is no longer supported in v5.0+.
+* Kept for uninstall.ts (cleaning up old global installs) and adapters.ts.
+* TODO: Remove when global install cleanup path is no longer needed.
 */
 function getGlobalDir(explicitDir = null) {
 	if (explicitDir) return expandTilde(explicitDir);
@@ -7582,6 +7317,9 @@ function getGlobalDir(explicitDir = null) {
 /**
 * Get the config directory path relative to home for hook templating.
 * Used for path.join(homeDir, '<configDir>', ...) replacement in hooks.
+*
+* @deprecated Global install is no longer supported in v5.0+.
+* TODO: Remove when hooks.ts no longer needs global/local distinction.
 */
 function getConfigDirFromHome(_isGlobal) {
 	return "'.claude'";
@@ -7700,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);
@@ -7717,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;
@@ -7784,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 = [];
@@ -7796,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
 	};
 }
 /**
@@ -7832,10 +7646,10 @@ 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$1({
+	return await dist_default({
 		message: "Replace with MAXSIM statusline?",
 		default: false
 	});
@@ -7859,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";
@@ -8082,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) {
@@ -8131,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) {
@@ -8158,7 +8070,6 @@ function uninstall(isGlobal, explicitConfigDir = null) {
 var import_lib = /* @__PURE__ */ __toESM(require_lib$1());
 const argv = (0, import_minimist.default)(process.argv.slice(2), {
 	boolean: [
-		"global",
 		"local",
 		"claude",
 		"uninstall",
@@ -8169,14 +8080,12 @@ const argv = (0, import_minimist.default)(process.argv.slice(2), {
 	],
 	string: ["config-dir"],
 	alias: {
-		g: "global",
 		l: "local",
 		u: "uninstall",
 		h: "help",
 		c: "config-dir"
 	}
 });
-const hasGlobal = !!argv["global"];
 const hasLocal = !!argv["local"];
 const hasUninstall = !!argv["uninstall"];
 const banner = "\n" + chalk.cyan(figlet.default.textSync("MAXSIM", { font: "ANSI Shadow" }).split("\n").map((line) => "  " + line).join("\n")) + "\n\n  MAXSIM " + chalk.dim("v" + pkg.version) + "\n  A meta-prompting, context engineering and spec-driven\n  development system for Claude Code.\n";
@@ -8194,30 +8103,37 @@ for (const flag of [
 	console.error(`Error: The --${flag} flag is no longer supported. MAXSIM v2.0 is Claude Code only.`);
 	process.exit(1);
 }
+if (argv["global"] || argv["g"]) {
+	console.error(chalk.red("Error: Global install is no longer supported."));
+	console.error("MAXSIM v5.0+ installs locally to .claude/ in your project directory.");
+	console.error("Run: npx maxsimcli --local");
+	process.exit(1);
+}
 if (hasVersion) {
 	console.log(pkg.version);
 	process.exit(0);
 }
 console.log(banner);
 if (hasHelp) {
-	console.log(`  ${chalk.yellow("Usage:")} npx maxsimcli [options]\n\n  ${chalk.yellow("Options:")}\n    ${chalk.cyan("-g, --global")}              Install globally (to config directory)\n    ${chalk.cyan("-l, --local")}               Install locally (to current directory)\n    ${chalk.cyan("-u, --uninstall")}           Uninstall MAXSIM (remove all MAXSIM files)\n    ${chalk.cyan("-c, --config-dir <path>")}   Specify custom config directory\n    ${chalk.cyan("-h, --help")}                Show this help message\n    ${chalk.cyan("--force-statusline")}        Replace existing statusline config\n\n  ${chalk.yellow("Examples:")}\n    ${chalk.dim("# Interactive install (prompts for location)")}\n    npx maxsimcli\n\n    ${chalk.dim("# Install globally")}\n    npx maxsimcli --global\n\n    ${chalk.dim("# Install to current project only")}\n    npx maxsimcli --local\n\n    ${chalk.dim("# Install to custom config directory")}\n    npx maxsimcli --global --config-dir ~/.claude-work\n\n    ${chalk.dim("# Uninstall MAXSIM globally")}\n    npx maxsimcli --global --uninstall\n\n  ${chalk.yellow("Notes:")}\n    The --config-dir option is useful when you have multiple configurations.\n    It takes priority over the CLAUDE_CONFIG_DIR environment variable.\n`);
+	console.log(`  ${chalk.yellow("Usage:")} npx maxsimcli [options]\n\n  ${chalk.yellow("Options:")}\n    ${chalk.cyan("-l, --local")}               Install to current project directory (default)\n    ${chalk.cyan("-u, --uninstall")}           Uninstall MAXSIM (remove all MAXSIM files)\n    ${chalk.cyan("-c, --config-dir <path>")}   Specify custom local directory name\n    ${chalk.cyan("-h, --help")}                Show this help message\n    ${chalk.cyan("--force-statusline")}        Replace existing statusline config\n\n  ${chalk.yellow("Examples:")}\n    ${chalk.dim("# Install to current project")}\n    npx maxsimcli\n\n    ${chalk.dim("# Explicit local install")}\n    npx maxsimcli --local\n\n    ${chalk.dim("# Uninstall MAXSIM")}\n    npx maxsimcli --local --uninstall\n\n  ${chalk.yellow("Notes:")}\n    MAXSIM installs to .claude/ in your project directory.\n    The --config-dir option specifies a custom directory name (relative to CWD).\n`);
 	process.exit(0);
 }
-async function install(isGlobal) {
+async function install() {
 	const dirName = getDirName();
 	const src = templatesRoot;
-	const targetDir = isGlobal ? getGlobalDir(explicitConfigDir) : node_path.join(process.cwd(), dirName);
-	const locationLabel = isGlobal ? targetDir.replace(node_os.homedir(), "~") : targetDir.replace(process.cwd(), ".");
-	const pathPrefix = isGlobal ? `${targetDir.replace(/\\/g, "/")}/` : `./${dirName}/`;
+	const targetDir = explicitConfigDir ? node_path.resolve(process.cwd(), explicitConfigDir) : node_path.join(process.cwd(), dirName);
+	const locationLabel = targetDir.replace(process.cwd(), ".");
+	const pathPrefix = `./${dirName}/`;
 	console.log(`  Installing for ${chalk.cyan("Claude Code")} to ${chalk.cyan(locationLabel)}\n`);
 	const failures = [];
 	const existingManifest = readManifest(targetDir);
 	const isAlreadyCurrent = existingManifest !== null && existingManifest.version === pkg.version;
 	if (existingManifest !== null) {
 		const { complete, missing } = verifyInstallComplete(targetDir, existingManifest);
-		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 (!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({
@@ -8313,6 +8229,27 @@ async function install(isGlobal) {
 			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)) {
@@ -8356,7 +8293,7 @@ async function install(isGlobal) {
 		node_fs.copyFileSync(toolSrc, toolDest);
 		console.log(`  ${chalk.green("✓")} Installed maxsim-tools.cjs`);
 	} else {
-		console.warn(`  ${chalk.yellow("!")} cli.cjs not found at ${toolSrc} — maxsim-tools.cjs not installed`);
+		console.warn(`  ${chalk.yellow("!")} cli.cjs not found at ${toolSrc} -- maxsim-tools.cjs not installed`);
 		failures.push("maxsim-tools.cjs");
 	}
 	const mcpSrc = node_path.resolve(__dirname, "mcp-server.cjs");
@@ -8365,9 +8302,9 @@ async function install(isGlobal) {
 		node_fs.mkdirSync(binDir, { recursive: true });
 		node_fs.copyFileSync(mcpSrc, mcpDest);
 		console.log(`  ${chalk.green("✓")} Installed mcp-server.cjs`);
-	} else console.warn(`  ${chalk.yellow("!")} mcp-server.cjs not found — MCP server not installed`);
-	installHookFiles(targetDir, isGlobal, failures);
-	const mcpJsonPath = isGlobal ? node_path.join(targetDir, "..", ".mcp.json") : node_path.join(process.cwd(), ".mcp.json");
+	} else console.warn(`  ${chalk.yellow("!")} mcp-server.cjs not found -- MCP server not installed`);
+	installHookFiles(targetDir, false, failures);
+	const mcpJsonPath = node_path.join(process.cwd(), ".mcp.json");
 	let mcpConfig = {};
 	let skipMcpConfig = false;
 	if (node_fs.existsSync(mcpJsonPath)) {
@@ -8378,7 +8315,7 @@ async function install(isGlobal) {
 			console.warn(`  ${chalk.yellow("!")} .mcp.json is corrupted (invalid JSON). Backup saved to .mcp.json.bak`);
 			let startFresh = true;
 			try {
-				startFresh = await dist_default$1({
+				startFresh = await dist_default({
 					message: ".mcp.json is corrupted. Start with a fresh config? (No = abort MCP setup)",
 					default: true
 				});
@@ -8407,7 +8344,7 @@ async function install(isGlobal) {
 	writeManifest(targetDir);
 	console.log(`  ${chalk.green("✓")} Wrote file manifest (${MANIFEST_NAME})`);
 	reportLocalPatches(targetDir);
-	const { settingsPath, settings, statuslineCommand } = configureSettingsHooks(targetDir, isGlobal);
+	const { settingsPath, settings, statuslineCommand } = configureSettingsHooks(targetDir, false);
 	return {
 		settingsPath,
 		settings,
@@ -8415,26 +8352,6 @@ async function install(isGlobal) {
 	};
 }
 /**
-* Prompt for install location
-*/
-async function promptLocation() {
-	if (!process.stdin.isTTY) {
-		console.log(chalk.yellow("Non-interactive terminal detected, defaulting to global install") + "\n");
-		return true;
-	}
-	const globalPath = getGlobalDir(explicitConfigDir).replace(node_os.homedir(), "~");
-	return await dist_default({
-		message: "Where would you like to install?",
-		choices: [{
-			name: "Global  " + chalk.dim(`(${globalPath})`) + "  — available in all projects",
-			value: "global"
-		}, {
-			name: "Local   " + chalk.dim("(./.claude)") + "  — this project only",
-			value: "local"
-		}]
-	}) === "global";
-}
-/**
 * Prompt whether to enable Agent Teams (experimental feature)
 */
 async function promptAgentTeams() {
@@ -8443,26 +8360,38 @@ async function promptAgentTeams() {
 	console.log(chalk.dim("  Coordinate multiple Claude Code instances working in parallel."));
 	console.log(chalk.dim("  Enables CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS in settings.json."));
 	console.log();
-	return dist_default$1({
+	return dist_default({
 		message: "Enable Agent Teams?",
 		default: false
 	});
 }
 /**
-* Install MAXSIM for Claude Code
+* Install MAXSIM for Claude Code (always local)
 */
-async function installForClaude(isGlobal, isInteractive) {
-	const result = await install(isGlobal);
+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;
 	}
-	finishInstall(result.settingsPath, result.settings, result.statuslineCommand, shouldInstallStatusline, isGlobal);
+	finishInstall(result.settingsPath, result.settings, result.statuslineCommand, shouldInstallStatusline, false);
 }
 const subcommand = argv._[0];
 (async () => {
@@ -8487,23 +8416,13 @@ const subcommand = argv._[0];
 		}
 		return;
 	}
-	if (hasGlobal && hasLocal) {
-		console.error(chalk.yellow("Cannot specify both --global and --local"));
-		process.exit(1);
-	} else if (explicitConfigDir && hasLocal) {
-		console.error(chalk.yellow("Cannot use --config-dir with --local"));
-		process.exit(1);
-	} else if (hasUninstall) {
-		if (!hasGlobal && !hasLocal) {
-			console.error(chalk.yellow("--uninstall requires --global or --local"));
+	if (hasUninstall) {
+		if (!hasLocal) {
+			console.error(chalk.yellow("--uninstall requires --local"));
 			process.exit(1);
 		}
-		uninstall(hasGlobal, explicitConfigDir);
-	} else if (hasGlobal || hasLocal) await installForClaude(hasGlobal, false);
-	else if (!process.stdin.isTTY) {
-		console.log(chalk.yellow("Non-interactive terminal detected, defaulting to global install") + "\n");
-		await installForClaude(true, false);
-	} else await installForClaude(await promptLocation(), true);
+		uninstall(false, explicitConfigDir);
+	} else await installForClaude(process.stdin.isTTY === true);
 })().catch((err) => {
 	if (err instanceof Error && err.message.includes("User force closed")) {
 		console.log("\n" + chalk.yellow("Installation cancelled") + "\n");