maxsimcli 5.0.0 → 5.0.2

package/dist/assets/CHANGELOG.md

@@ -1,3 +1,34 @@
+## [5.0.1](https://github.com/maystudios/maxsimcli/compare/v5.0.0...v5.0.1) (2026-03-12)
+
+
+### Bug Fixes
+
+* **install:** update Discord community link ([3c548ab](https://github.com/maystudios/maxsimcli/commit/3c548ab608223780534ac8c5b1c79ad2bf66f338))
+
+# [5.0.0](https://github.com/maystudios/maxsimcli/compare/v4.16.0...v5.0.0) (2026-03-12)
+
+
+* feat!: replace MCP server with CLI github commands ([2fc6a0e](https://github.com/maystudios/maxsimcli/commit/2fc6a0eeafbd5e7f010406f8c097fa3aad654db3))
+
+
+### Bug Fixes
+
+* **e2e:** remove stale MCP server tests and update install assertions ([32f6fe1](https://github.com/maystudios/maxsimcli/commit/32f6fe1226da022aef46b831dbeec39e052401a4))
+
+
+### Features
+
+* add sound notification hooks for AskUserQuestion and Stop events ([6e96a6e](https://github.com/maystudios/maxsimcli/commit/6e96a6e7e5147eefae5a1e073927ce99ceedaf49))
+* make GitHub Issues single source of truth for task/plan tracking ([8409c10](https://github.com/maystudios/maxsimcli/commit/8409c107305ff1183f2997d92a1515979ce2dc28))
+
+
+### BREAKING CHANGES
+
+* MCP server removed. GitHub operations now use
+`node maxsim-tools.cjs github <command>` instead of MCP tools.
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+
 # [4.16.0](https://github.com/maystudios/maxsimcli/compare/v4.15.4...v4.16.0) (2026-03-12)
 
 

package/dist/assets/hooks/maxsim-sync-reminder.cjs

@@ -1,38 +1,5 @@
 #!/usr/bin/env node
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-let node_fs = require("node:fs");
-node_fs = __toESM(node_fs);
-let node_os = require("node:os");
-node_os = __toESM(node_os);
-let node_path = require("node:path");
-node_path = __toESM(node_path);
 
 //#region src/hooks/shared.ts
 /**
@@ -58,52 +25,12 @@ function readStdinJson(callback) {
 //#endregion
 //#region src/hooks/maxsim-sync-reminder.ts
 /**
-* Sync Reminder Hook — PostToolUse hook that detects .planning/ file writes
-* and gently reminds the user to sync changes to GitHub Issues.
-*
-* Debounces reminders: fires on the first .planning/ write per session,
-* then every DEBOUNCE_CALLS writes thereafter.
+* Sync Reminder Hook — No longer needed.
+* GitHub Issues is the sole source of truth for phase artifacts and todos.
+* Local .planning/ writes no longer need sync reminders.
 */
-/** Number of .planning/ writes between repeated reminders. */
 const DEBOUNCE_CALLS = 10;
-const REMINDER_MESSAGE = ".planning/ files changed locally. Consider syncing to GitHub Issues when ready.";
-function processSyncReminder(data) {
-	const sessionId = data.session_id;
-	const filePath = data.tool_input?.file_path;
-	if (!sessionId || !filePath) return null;
-	const normalized = node_path.normalize(filePath);
-	const planningSegment = `${node_path.sep}.planning${node_path.sep}`;
-	const planningEnd = `${node_path.sep}.planning`;
-	if (!normalized.includes(planningSegment) && !normalized.endsWith(planningEnd)) return null;
-	const stateFile = node_path.join(node_os.tmpdir(), `maxsim-sync-${sessionId}.json`);
-	let state;
-	try {
-		if (node_fs.existsSync(stateFile)) state = JSON.parse(node_fs.readFileSync(stateFile, "utf8"));
-		else state = {
-			callsSinceRemind: 0,
-			reminded: false
-		};
-	} catch {
-		state = {
-			callsSinceRemind: 0,
-			reminded: false
-		};
-	}
-	state.callsSinceRemind++;
-	if (!state.reminded || state.callsSinceRemind >= DEBOUNCE_CALLS) {
-		state.callsSinceRemind = 0;
-		state.reminded = true;
-		try {
-			node_fs.writeFileSync(stateFile, JSON.stringify(state));
-		} catch {}
-		return { hookSpecificOutput: {
-			hookEventName: "PostToolUse",
-			additionalContext: REMINDER_MESSAGE
-		} };
-	}
-	try {
-		node_fs.writeFileSync(stateFile, JSON.stringify(state));
-	} catch {}
+function processSyncReminder(_data) {
 	return null;
 }
 if (require.main === module) readStdinJson((data) => {

package/dist/assets/hooks/maxsim-sync-reminder.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"maxsim-sync-reminder.cjs","names":["path","os","fs"],"sources":["../../../src/hooks/shared.ts","../../../src/hooks/maxsim-sync-reminder.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\n/**\n * Play a system sound for notifications. Fire-and-forget, never blocks.\n * Suppressed when MAXSIM_SOUND=0, CI=true, or SSH_CONNECTION is set.\n */\nexport function playSound(type: 'question' | 'stop'): void {\n  try {\n    if (\n      process.env.MAXSIM_SOUND === '0' ||\n      process.env.CI === 'true' ||\n      process.env.SSH_CONNECTION\n    ) {\n      return;\n    }\n\n    const platform = process.platform;\n\n    if (platform === 'win32') {\n      const file =\n        type === 'question'\n          ? 'C:\\\\Windows\\\\Media\\\\notify.wav'\n          : 'C:\\\\Windows\\\\Media\\\\chimes.wav';\n      const { spawn } = require('node:child_process') as typeof import('node:child_process');\n      const child = spawn(\n        'powershell',\n        ['-NoProfile', '-Command', `(New-Object Media.SoundPlayer '${file}').PlaySync()`],\n        { stdio: 'ignore', windowsHide: true, detached: true },\n      );\n      child.unref();\n    } else if (platform === 'darwin') {\n      const file =\n        type === 'question'\n          ? '/System/Library/Sounds/Ping.aiff'\n          : '/System/Library/Sounds/Glass.aiff';\n      const { spawn } = require('node:child_process') as typeof import('node:child_process');\n      const child = spawn('afplay', [file], {\n        stdio: 'ignore',\n        detached: true,\n      });\n      child.unref();\n    } else {\n      // Linux / unknown — terminal bell fallback\n      process.stderr.write('\\x07');\n    }\n  } catch {\n    // Silent fail — never block hook execution\n  }\n}\n","#!/usr/bin/env node\n/**\n * Sync Reminder Hook — PostToolUse hook that detects .planning/ file writes\n * and gently reminds the user to sync changes to GitHub Issues.\n *\n * Debounces reminders: fires on the first .planning/ write per session,\n * then every DEBOUNCE_CALLS writes thereafter.\n */\n\nimport * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { readStdinJson } from './shared';\n\nexport interface SyncReminderInput {\n  session_id?: string;\n  cwd?: string;\n  tool_input?: { file_path?: string };\n}\n\nexport interface SyncReminderOutput {\n  hookSpecificOutput: {\n    hookEventName: string;\n    additionalContext: string;\n  };\n}\n\ninterface DebounceState {\n  callsSinceRemind: number;\n  reminded: boolean;\n}\n\n/** Number of .planning/ writes between repeated reminders. */\nexport const DEBOUNCE_CALLS = 10;\n\nconst REMINDER_MESSAGE =\n  '.planning/ files changed locally. Consider syncing to GitHub Issues when ready.';\n\nexport function processSyncReminder(\n  data: SyncReminderInput,\n): SyncReminderOutput | null {\n  const sessionId = data.session_id;\n  const filePath = data.tool_input?.file_path;\n\n  if (!sessionId || !filePath) {\n    return null;\n  }\n\n  // Normalize path for cross-platform (Windows backslash handling)\n  const normalized = path.normalize(filePath);\n\n  // Check if the file is inside a .planning/ directory\n  const planningSegment = `${path.sep}.planning${path.sep}`;\n  const planningEnd = `${path.sep}.planning`;\n  if (\n    !normalized.includes(planningSegment) &&\n    !normalized.endsWith(planningEnd)\n  ) {\n    return null;\n  }\n\n  // Load debounce state from temp file\n  const stateFile = path.join(\n    os.tmpdir(),\n    `maxsim-sync-${sessionId}.json`,\n  );\n\n  let state: DebounceState;\n  try {\n    if (fs.existsSync(stateFile)) {\n      state = JSON.parse(fs.readFileSync(stateFile, 'utf8')) as DebounceState;\n    } else {\n      state = { callsSinceRemind: 0, reminded: false };\n    }\n  } catch {\n    state = { callsSinceRemind: 0, reminded: false };\n  }\n\n  state.callsSinceRemind++;\n\n  // Fire reminder on first write OR after debounce interval expires\n  if (!state.reminded || state.callsSinceRemind >= DEBOUNCE_CALLS) {\n    state.callsSinceRemind = 0;\n    state.reminded = true;\n\n    try {\n      fs.writeFileSync(stateFile, JSON.stringify(state));\n    } catch {\n      // Silent fail -- never block hook execution\n    }\n\n    return {\n      hookSpecificOutput: {\n        hookEventName: 'PostToolUse',\n        additionalContext: REMINDER_MESSAGE,\n      },\n    };\n  }\n\n  // Not time for a reminder yet\n  try {\n    fs.writeFileSync(stateFile, JSON.stringify(state));\n  } catch {\n    // Silent fail -- never block hook execution\n  }\n\n  return null;\n}\n\n// Standalone entry\nif (require.main === module) {\n  readStdinJson<SyncReminderInput>((data) => {\n    const result = processSyncReminder(data);\n    if (result) {\n      process.stdout.write(JSON.stringify(result));\n    }\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;;;;;;;;;;;;;ACaJ,MAAa,iBAAiB;AAE9B,MAAM,mBACJ;AAEF,SAAgB,oBACd,MAC2B;CAC3B,MAAM,YAAY,KAAK;CACvB,MAAM,WAAW,KAAK,YAAY;AAElC,KAAI,CAAC,aAAa,CAAC,SACjB,QAAO;CAIT,MAAM,aAAaA,UAAK,UAAU,SAAS;CAG3C,MAAM,kBAAkB,GAAGA,UAAK,IAAI,WAAWA,UAAK;CACpD,MAAM,cAAc,GAAGA,UAAK,IAAI;AAChC,KACE,CAAC,WAAW,SAAS,gBAAgB,IACrC,CAAC,WAAW,SAAS,YAAY,CAEjC,QAAO;CAIT,MAAM,YAAYA,UAAK,KACrBC,QAAG,QAAQ,EACX,eAAe,UAAU,OAC1B;CAED,IAAI;AACJ,KAAI;AACF,MAAIC,QAAG,WAAW,UAAU,CAC1B,SAAQ,KAAK,MAAMA,QAAG,aAAa,WAAW,OAAO,CAAC;MAEtD,SAAQ;GAAE,kBAAkB;GAAG,UAAU;GAAO;SAE5C;AACN,UAAQ;GAAE,kBAAkB;GAAG,UAAU;GAAO;;AAGlD,OAAM;AAGN,KAAI,CAAC,MAAM,YAAY,MAAM,oBAAoB,gBAAgB;AAC/D,QAAM,mBAAmB;AACzB,QAAM,WAAW;AAEjB,MAAI;AACF,WAAG,cAAc,WAAW,KAAK,UAAU,MAAM,CAAC;UAC5C;AAIR,SAAO,EACL,oBAAoB;GAClB,eAAe;GACf,mBAAmB;GACpB,EACF;;AAIH,KAAI;AACF,UAAG,cAAc,WAAW,KAAK,UAAU,MAAM,CAAC;SAC5C;AAIR,QAAO;;AAIT,IAAI,QAAQ,SAAS,OACnB,gBAAkC,SAAS;CACzC,MAAM,SAAS,oBAAoB,KAAK;AACxC,KAAI,OACF,SAAQ,OAAO,MAAM,KAAK,UAAU,OAAO,CAAC;EAE9C"}
+{"version":3,"file":"maxsim-sync-reminder.cjs","names":[],"sources":["../../../src/hooks/shared.ts","../../../src/hooks/maxsim-sync-reminder.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\n/**\n * Play a system sound for notifications. Fire-and-forget, never blocks.\n * Suppressed when MAXSIM_SOUND=0, CI=true, or SSH_CONNECTION is set.\n */\nexport function playSound(type: 'question' | 'stop'): void {\n  try {\n    if (\n      process.env.MAXSIM_SOUND === '0' ||\n      process.env.CI === 'true' ||\n      process.env.SSH_CONNECTION\n    ) {\n      return;\n    }\n\n    const platform = process.platform;\n\n    if (platform === 'win32') {\n      const file =\n        type === 'question'\n          ? 'C:\\\\Windows\\\\Media\\\\notify.wav'\n          : 'C:\\\\Windows\\\\Media\\\\chimes.wav';\n      const { spawn } = require('node:child_process') as typeof import('node:child_process');\n      const child = spawn(\n        'powershell',\n        ['-NoProfile', '-Command', `(New-Object Media.SoundPlayer '${file}').PlaySync()`],\n        { stdio: 'ignore', windowsHide: true, detached: true },\n      );\n      child.unref();\n    } else if (platform === 'darwin') {\n      const file =\n        type === 'question'\n          ? '/System/Library/Sounds/Ping.aiff'\n          : '/System/Library/Sounds/Glass.aiff';\n      const { spawn } = require('node:child_process') as typeof import('node:child_process');\n      const child = spawn('afplay', [file], {\n        stdio: 'ignore',\n        detached: true,\n      });\n      child.unref();\n    } else {\n      // Linux / unknown — terminal bell fallback\n      process.stderr.write('\\x07');\n    }\n  } catch {\n    // Silent fail — never block hook execution\n  }\n}\n","#!/usr/bin/env node\n/**\n * Sync Reminder Hook — No longer needed.\n * GitHub Issues is the sole source of truth for phase artifacts and todos.\n * Local .planning/ writes no longer need sync reminders.\n */\n\nimport { readStdinJson } from './shared';\n\nexport interface SyncReminderInput {\n  session_id?: string;\n  cwd?: string;\n  tool_input?: { file_path?: string };\n}\n\nexport interface SyncReminderOutput {\n  hookSpecificOutput: {\n    hookEventName: string;\n    additionalContext: string;\n  };\n}\n\nexport const DEBOUNCE_CALLS = 10;\n\nexport function processSyncReminder(\n  _data: SyncReminderInput,\n): SyncReminderOutput | null {\n  // No-op: GitHub Issues is SSOT for phase artifacts and todos.\n  return null;\n}\n\n// Standalone entry\nif (require.main === module) {\n  readStdinJson<SyncReminderInput>((data) => {\n    const result = processSyncReminder(data);\n    if (result) {\n      process.stdout.write(JSON.stringify(result));\n    }\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;;;;;;;;;;ACEJ,MAAa,iBAAiB;AAE9B,SAAgB,oBACd,OAC2B;AAE3B,QAAO;;AAIT,IAAI,QAAQ,SAAS,OACnB,gBAAkC,SAAS;CACzC,MAAM,SAAS,oBAAoB,KAAK;AACxC,KAAI,OACF,SAAQ,OAAO,MAAM,KAAK,UAAU,OAAO,CAAC;EAE9C"}

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

@@ -73,13 +73,14 @@ Every agent return MUST include these sections (enforced by the handoff-contract
 
 ## Model Selection
 
-Config `model_profile` (quality/balanced/budget) provides baseline model per agent type. Orchestrator can override per-spawn for complex tasks.
-
-| Agent | quality | balanced | budget |
-|-------|---------|----------|--------|
-| executor | opus | sonnet | sonnet |
-| planner | opus | sonnet | haiku |
-| researcher | opus | sonnet | haiku |
-| verifier | sonnet | sonnet | haiku |
+Config `model_profile` (quality/balanced/budget/tokenburner) provides baseline model per agent type. Orchestrator can override per-spawn for complex tasks.
+
+| Agent | quality | balanced | budget | tokenburner |
+|-------|---------|----------|--------|-------------|
+| executor | opus | sonnet | sonnet | opus |
+| planner | opus | opus | sonnet | opus |
+| researcher | opus | sonnet | haiku | opus |
+| verifier | sonnet | sonnet | haiku | opus |
+| debugger | sonnet | sonnet | haiku | opus |
 
 Model is set via `model: inherit` in agent frontmatter (uses session model) or explicit override in orchestrator spawn.