maxsimcli 3.11.0 → 4.0.0

package/dist/cli.js

@@ -40,9 +40,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
-const os = __importStar(require("node:os"));
 const node_child_process_1 = require("node:child_process");
-const node_module_1 = require("node:module");
 const index_js_1 = require("./core/index.js");
 // ─── Arg parsing utilities ───────────────────────────────────────────────────
 /** Extract a single named flag's value from args */
@@ -63,8 +61,16 @@ function getFlags(args, ...flags) {
 function hasFlag(args, flag) {
     return args.includes(`--${flag}`);
 }
+// ─── Result dispatcher ───────────────────────────────────────────────────────
+/** Convert a CmdResult into the appropriate output()/error() call. */
+function handleResult(r, raw) {
+    if (r.ok)
+        (0, index_js_1.output)(r.result, raw, r.rawValue);
+    else
+        (0, index_js_1.error)(r.error);
+}
 // ─── Subcommand handlers ─────────────────────────────────────────────────────
-const handleState = (args, cwd, raw) => {
+const handleState = async (args, cwd, raw) => {
     const sub = args[1];
     const handlers = {
         'update': () => (0, index_js_1.cmdStateUpdate)(cwd, args[2], args[3]),
@@ -77,12 +83,12 @@ const handleState = (args, cwd, raw) => {
                 if (key && value !== undefined)
                     patches[key] = value;
             }
-            (0, index_js_1.cmdStatePatch)(cwd, patches, raw);
+            return (0, index_js_1.cmdStatePatch)(cwd, patches, raw);
         },
         'advance-plan': () => (0, index_js_1.cmdStateAdvancePlan)(cwd, raw),
         'record-metric': () => {
             const f = getFlags(args, 'phase', 'plan', 'duration', 'tasks', 'files');
-            (0, index_js_1.cmdStateRecordMetric)(cwd, {
+            return (0, index_js_1.cmdStateRecordMetric)(cwd, {
                 phase: f.phase ?? '', plan: f.plan ?? '', duration: f.duration ?? '',
                 tasks: f.tasks ?? undefined, files: f.files ?? undefined,
             }, raw);
@@ -90,7 +96,7 @@ const handleState = (args, cwd, raw) => {
         'update-progress': () => (0, index_js_1.cmdStateUpdateProgress)(cwd, raw),
         'add-decision': () => {
             const f = getFlags(args, 'phase', 'summary', 'summary-file', 'rationale', 'rationale-file');
-            (0, index_js_1.cmdStateAddDecision)(cwd, {
+            return (0, index_js_1.cmdStateAddDecision)(cwd, {
                 phase: f.phase ?? undefined, summary: f.summary ?? undefined,
                 summary_file: f['summary-file'] ?? undefined,
                 rationale: f.rationale ?? '', rationale_file: f['rationale-file'] ?? undefined,
@@ -98,12 +104,12 @@ const handleState = (args, cwd, raw) => {
         },
         'add-blocker': () => {
             const f = getFlags(args, 'text', 'text-file');
-            (0, index_js_1.cmdStateAddBlocker)(cwd, { text: f.text ?? undefined, text_file: f['text-file'] ?? undefined }, raw);
+            return (0, index_js_1.cmdStateAddBlocker)(cwd, { text: f.text ?? undefined, text_file: f['text-file'] ?? undefined }, raw);
         },
         'resolve-blocker': () => (0, index_js_1.cmdStateResolveBlocker)(cwd, getFlag(args, '--text'), raw),
         'record-session': () => {
             const f = getFlags(args, 'stopped-at', 'resume-file');
-            (0, index_js_1.cmdStateRecordSession)(cwd, {
+            return (0, index_js_1.cmdStateRecordSession)(cwd, {
                 stopped_at: f['stopped-at'] ?? undefined,
                 resume_file: f['resume-file'] ?? 'None',
             }, raw);
@@ -111,21 +117,21 @@ const handleState = (args, cwd, raw) => {
     };
     const handler = sub ? handlers[sub] : undefined;
     if (handler)
-        return handler();
-    (0, index_js_1.cmdStateLoad)(cwd, raw);
+        return handleResult(await handler(), raw);
+    return handleResult(await (0, index_js_1.cmdStateLoad)(cwd, raw), raw);
 };
 const handleTemplate = (args, cwd, raw) => {
     const sub = args[1];
     if (sub === 'select') {
-        (0, index_js_1.cmdTemplateSelect)(cwd, args[2], raw);
+        handleResult((0, index_js_1.cmdTemplateSelect)(cwd, args[2]), raw);
     }
     else if (sub === 'fill') {
         const f = getFlags(args, 'phase', 'plan', 'name', 'type', 'wave', 'fields');
-        (0, index_js_1.cmdTemplateFill)(cwd, args[2], {
+        handleResult((0, index_js_1.cmdTemplateFill)(cwd, args[2], {
             phase: f.phase ?? '', plan: f.plan ?? undefined, name: f.name ?? undefined,
             type: f.type ?? 'execute', wave: f.wave ?? '1',
             fields: f.fields ? JSON.parse(f.fields) : {},
-        }, raw);
+        }), raw);
     }
     else {
         (0, index_js_1.error)('Unknown template subcommand. Available: select, fill');
@@ -135,10 +141,10 @@ const handleFrontmatter = (args, cwd, raw) => {
     const sub = args[1];
     const file = args[2];
     const handlers = {
-        'get': () => (0, index_js_1.cmdFrontmatterGet)(cwd, file, getFlag(args, '--field'), raw),
-        'set': () => (0, index_js_1.cmdFrontmatterSet)(cwd, file, getFlag(args, '--field'), getFlag(args, '--value') ?? undefined, raw),
-        'merge': () => (0, index_js_1.cmdFrontmatterMerge)(cwd, file, getFlag(args, '--data'), raw),
-        'validate': () => (0, index_js_1.cmdFrontmatterValidate)(cwd, file, getFlag(args, '--schema'), raw),
+        'get': () => handleResult((0, index_js_1.cmdFrontmatterGet)(cwd, file, getFlag(args, '--field')), raw),
+        'set': () => handleResult((0, index_js_1.cmdFrontmatterSet)(cwd, file, getFlag(args, '--field'), getFlag(args, '--value') ?? undefined), raw),
+        'merge': () => handleResult((0, index_js_1.cmdFrontmatterMerge)(cwd, file, getFlag(args, '--data')), raw),
+        'validate': () => handleResult((0, index_js_1.cmdFrontmatterValidate)(cwd, file, getFlag(args, '--schema')), raw),
     };
     const handler = sub ? handlers[sub] : undefined;
     if (handler)
@@ -148,52 +154,58 @@ const handleFrontmatter = (args, cwd, raw) => {
 const handleVerify = async (args, cwd, raw) => {
     const sub = args[1];
     const handlers = {
-        'plan-structure': () => (0, index_js_1.cmdVerifyPlanStructure)(cwd, args[2], raw),
-        'phase-completeness': () => (0, index_js_1.cmdVerifyPhaseCompleteness)(cwd, args[2], raw),
-        'references': () => (0, index_js_1.cmdVerifyReferences)(cwd, args[2], raw),
-        'commits': () => (0, index_js_1.cmdVerifyCommits)(cwd, args.slice(2), raw),
-        'artifacts': () => (0, index_js_1.cmdVerifyArtifacts)(cwd, args[2], raw),
-        'key-links': () => (0, index_js_1.cmdVerifyKeyLinks)(cwd, args[2], raw),
+        'plan-structure': () => handleResult((0, index_js_1.cmdVerifyPlanStructure)(cwd, args[2]), raw),
+        'phase-completeness': () => handleResult((0, index_js_1.cmdVerifyPhaseCompleteness)(cwd, args[2]), raw),
+        'references': () => handleResult((0, index_js_1.cmdVerifyReferences)(cwd, args[2]), raw),
+        'commits': async () => handleResult(await (0, index_js_1.cmdVerifyCommits)(cwd, args.slice(2)), raw),
+        'artifacts': () => handleResult((0, index_js_1.cmdVerifyArtifacts)(cwd, args[2]), raw),
+        'key-links': () => handleResult((0, index_js_1.cmdVerifyKeyLinks)(cwd, args[2]), raw),
     };
     const handler = sub ? handlers[sub] : undefined;
     if (handler)
         return handler();
     (0, index_js_1.error)('Unknown verify subcommand. Available: plan-structure, phase-completeness, references, commits, artifacts, key-links');
 };
-const handlePhases = (args, cwd, raw) => {
+const handlePhases = async (args, cwd, raw) => {
     const sub = args[1];
     if (sub === 'list') {
-        const f = getFlags(args, 'type', 'phase');
-        (0, index_js_1.cmdPhasesList)(cwd, { type: f.type, phase: f.phase, includeArchived: hasFlag(args, 'include-archived') }, raw);
+        const f = getFlags(args, 'type', 'phase', 'offset', 'limit');
+        handleResult(await (0, index_js_1.cmdPhasesList)(cwd, {
+            type: f.type,
+            phase: f.phase,
+            includeArchived: hasFlag(args, 'include-archived'),
+            offset: f.offset !== null ? parseInt(f.offset, 10) : undefined,
+            limit: f.limit !== null ? parseInt(f.limit, 10) : undefined,
+        }), raw);
     }
     else {
         (0, index_js_1.error)('Unknown phases subcommand. Available: list');
     }
 };
-const handleRoadmap = (args, cwd, raw) => {
+const handleRoadmap = async (args, cwd, raw) => {
     const sub = args[1];
     const handlers = {
-        'get-phase': () => (0, index_js_1.cmdRoadmapGetPhase)(cwd, args[2], raw),
-        'analyze': () => (0, index_js_1.cmdRoadmapAnalyze)(cwd, raw),
-        'update-plan-progress': () => (0, index_js_1.cmdRoadmapUpdatePlanProgress)(cwd, args[2], raw),
+        'get-phase': () => (0, index_js_1.cmdRoadmapGetPhase)(cwd, args[2]),
+        'analyze': () => (0, index_js_1.cmdRoadmapAnalyze)(cwd),
+        'update-plan-progress': () => (0, index_js_1.cmdRoadmapUpdatePlanProgress)(cwd, args[2]),
     };
     const handler = sub ? handlers[sub] : undefined;
     if (handler)
-        return handler();
+        return handleResult(await handler(), raw);
     (0, index_js_1.error)('Unknown roadmap subcommand. Available: get-phase, analyze, update-plan-progress');
 };
 const handlePhase = (args, cwd, raw) => {
     const sub = args[1];
     const handlers = {
-        'next-decimal': () => (0, index_js_1.cmdPhaseNextDecimal)(cwd, args[2], raw),
-        'add': () => (0, index_js_1.cmdPhaseAdd)(cwd, args.slice(2).join(' '), raw),
-        'insert': () => (0, index_js_1.cmdPhaseInsert)(cwd, args[2], args.slice(3).join(' '), raw),
-        'remove': () => (0, index_js_1.cmdPhaseRemove)(cwd, args[2], { force: hasFlag(args, 'force') }, raw),
-        'complete': () => (0, index_js_1.cmdPhaseComplete)(cwd, args[2], raw),
+        'next-decimal': () => (0, index_js_1.cmdPhaseNextDecimal)(cwd, args[2]),
+        'add': () => (0, index_js_1.cmdPhaseAdd)(cwd, args.slice(2).join(' ')),
+        'insert': () => (0, index_js_1.cmdPhaseInsert)(cwd, args[2], args.slice(3).join(' ')),
+        'remove': () => (0, index_js_1.cmdPhaseRemove)(cwd, args[2], { force: hasFlag(args, 'force') }),
+        'complete': () => (0, index_js_1.cmdPhaseComplete)(cwd, args[2]),
     };
     const handler = sub ? handlers[sub] : undefined;
     if (handler)
-        return handler();
+        return handleResult(handler(), raw);
     (0, index_js_1.error)('Unknown phase subcommand. Available: next-decimal, add, insert, remove, complete');
 };
 const handleMilestone = (args, cwd, raw) => {
@@ -210,10 +222,10 @@ const handleMilestone = (args, cwd, raw) => {
             }
             milestoneName = nameArgs.join(' ') || null;
         }
-        (0, index_js_1.cmdMilestoneComplete)(cwd, args[2], {
+        handleResult((0, index_js_1.cmdMilestoneComplete)(cwd, args[2], {
             name: milestoneName ?? undefined,
             archivePhases: hasFlag(args, 'archive-phases'),
-        }, raw);
+        }), raw);
     }
     else {
         (0, index_js_1.error)('Unknown milestone subcommand. Available: complete');
@@ -222,8 +234,8 @@ const handleMilestone = (args, cwd, raw) => {
 const handleValidate = (args, cwd, raw) => {
     const sub = args[1];
     const handlers = {
-        'consistency': () => (0, index_js_1.cmdValidateConsistency)(cwd, raw),
-        'health': () => (0, index_js_1.cmdValidateHealth)(cwd, { repair: hasFlag(args, 'repair') }, raw),
+        'consistency': () => handleResult((0, index_js_1.cmdValidateConsistency)(cwd), raw),
+        'health': () => handleResult((0, index_js_1.cmdValidateHealth)(cwd, { repair: hasFlag(args, 'repair') }), raw),
     };
     const handler = sub ? handlers[sub] : undefined;
     if (handler)
@@ -233,89 +245,98 @@ const handleValidate = (args, cwd, raw) => {
 const handleInit = (args, cwd, raw) => {
     const workflow = args[1];
     const handlers = {
-        'execute-phase': () => (0, index_js_1.cmdInitExecutePhase)(cwd, args[2], raw),
-        'plan-phase': () => (0, index_js_1.cmdInitPlanPhase)(cwd, args[2], raw),
-        'new-project': () => (0, index_js_1.cmdInitNewProject)(cwd, raw),
-        'new-milestone': () => (0, index_js_1.cmdInitNewMilestone)(cwd, raw),
-        'quick': () => (0, index_js_1.cmdInitQuick)(cwd, args.slice(2).join(' '), raw),
-        'resume': () => (0, index_js_1.cmdInitResume)(cwd, raw),
-        'verify-work': () => (0, index_js_1.cmdInitVerifyWork)(cwd, args[2], raw),
-        'phase-op': () => (0, index_js_1.cmdInitPhaseOp)(cwd, args[2], raw),
-        'todos': () => (0, index_js_1.cmdInitTodos)(cwd, args[2], raw),
-        'milestone-op': () => (0, index_js_1.cmdInitMilestoneOp)(cwd, raw),
-        'map-codebase': () => (0, index_js_1.cmdInitMapCodebase)(cwd, raw),
-        'init-existing': () => (0, index_js_1.cmdInitExisting)(cwd, raw),
-        'progress': () => (0, index_js_1.cmdInitProgress)(cwd, raw),
+        'execute-phase': () => (0, index_js_1.cmdInitExecutePhase)(cwd, args[2]),
+        'plan-phase': () => (0, index_js_1.cmdInitPlanPhase)(cwd, args[2]),
+        'new-project': () => (0, index_js_1.cmdInitNewProject)(cwd),
+        'new-milestone': () => (0, index_js_1.cmdInitNewMilestone)(cwd),
+        'quick': () => (0, index_js_1.cmdInitQuick)(cwd, args.slice(2).join(' ')),
+        'resume': () => (0, index_js_1.cmdInitResume)(cwd),
+        'verify-work': () => (0, index_js_1.cmdInitVerifyWork)(cwd, args[2]),
+        'phase-op': () => (0, index_js_1.cmdInitPhaseOp)(cwd, args[2]),
+        'todos': () => (0, index_js_1.cmdInitTodos)(cwd, args[2]),
+        'milestone-op': () => (0, index_js_1.cmdInitMilestoneOp)(cwd),
+        'map-codebase': () => (0, index_js_1.cmdInitMapCodebase)(cwd),
+        'init-existing': () => (0, index_js_1.cmdInitExisting)(cwd),
+        'progress': () => (0, index_js_1.cmdInitProgress)(cwd),
     };
     const handler = workflow ? handlers[workflow] : undefined;
     if (handler)
-        return handler();
+        return handleResult(handler(), raw);
     (0, index_js_1.error)(`Unknown init workflow: ${workflow}\nAvailable: execute-phase, plan-phase, new-project, new-milestone, quick, resume, verify-work, phase-op, todos, milestone-op, map-codebase, init-existing, progress`);
 };
 // ─── Command registry ────────────────────────────────────────────────────────
 const COMMANDS = {
     'state': handleState,
-    'resolve-model': (args, cwd, raw) => (0, index_js_1.cmdResolveModel)(cwd, args[1], raw),
-    'find-phase': (args, cwd, raw) => (0, index_js_1.cmdFindPhase)(cwd, args[1], raw),
+    'resolve-model': (args, cwd, raw) => handleResult((0, index_js_1.cmdResolveModel)(cwd, args[1], raw), raw),
+    'find-phase': (args, cwd, raw) => handleResult((0, index_js_1.cmdFindPhase)(cwd, args[1]), raw),
     'commit': async (args, cwd, raw) => {
         const files = args.indexOf('--files') !== -1
             ? args.slice(args.indexOf('--files') + 1).filter(a => !a.startsWith('--'))
             : [];
-        await (0, index_js_1.cmdCommit)(cwd, args[1], files, raw, hasFlag(args, 'amend'));
+        handleResult(await (0, index_js_1.cmdCommit)(cwd, args[1], files, raw, hasFlag(args, 'amend')), raw);
     },
     'verify-summary': async (args, cwd, raw) => {
         const countIndex = args.indexOf('--check-count');
         const checkCount = countIndex !== -1 ? parseInt(args[countIndex + 1], 10) : 2;
-        await (0, index_js_1.cmdVerifySummary)(cwd, args[1], checkCount, raw);
+        handleResult(await (0, index_js_1.cmdVerifySummary)(cwd, args[1], checkCount), raw);
     },
     'template': handleTemplate,
     'frontmatter': handleFrontmatter,
     'verify': handleVerify,
-    'generate-slug': (args, _cwd, raw) => (0, index_js_1.cmdGenerateSlug)(args[1], raw),
-    'current-timestamp': (args, _cwd, raw) => (0, index_js_1.cmdCurrentTimestamp)((args[1] || 'full'), raw),
-    'list-todos': (args, cwd, raw) => (0, index_js_1.cmdListTodos)(cwd, args[1], raw),
-    'verify-path-exists': (args, cwd, raw) => (0, index_js_1.cmdVerifyPathExists)(cwd, args[1], raw),
-    'config-ensure-section': (_args, cwd, raw) => (0, index_js_1.cmdConfigEnsureSection)(cwd, raw),
-    'config-set': (args, cwd, raw) => (0, index_js_1.cmdConfigSet)(cwd, args[1], args[2], raw),
-    'config-get': (args, cwd, raw) => (0, index_js_1.cmdConfigGet)(cwd, args[1], raw),
-    'history-digest': (_args, cwd, raw) => (0, index_js_1.cmdHistoryDigest)(cwd, raw),
+    'generate-slug': (args, _cwd, raw) => handleResult((0, index_js_1.cmdGenerateSlug)(args[1], raw), raw),
+    'current-timestamp': (args, _cwd, raw) => handleResult((0, index_js_1.cmdCurrentTimestamp)((args[1] || 'full'), raw), raw),
+    'list-todos': (args, cwd, raw) => handleResult((0, index_js_1.cmdListTodos)(cwd, args[1], raw), raw),
+    'verify-path-exists': (args, cwd, raw) => handleResult((0, index_js_1.cmdVerifyPathExists)(cwd, args[1], raw), raw),
+    'config-ensure-section': (_args, cwd, raw) => handleResult((0, index_js_1.cmdConfigEnsureSection)(cwd, raw), raw),
+    'config-set': (args, cwd, raw) => handleResult((0, index_js_1.cmdConfigSet)(cwd, args[1], args[2], raw), raw),
+    'config-get': (args, cwd, raw) => handleResult((0, index_js_1.cmdConfigGet)(cwd, args[1], raw), raw),
+    'history-digest': (_args, cwd, raw) => handleResult((0, index_js_1.cmdHistoryDigest)(cwd, raw), raw),
     'phases': handlePhases,
     'roadmap': handleRoadmap,
     'requirements': (args, cwd, raw) => {
         if (args[1] === 'mark-complete')
-            (0, index_js_1.cmdRequirementsMarkComplete)(cwd, args.slice(2), raw);
+            handleResult((0, index_js_1.cmdRequirementsMarkComplete)(cwd, args.slice(2)), raw);
         else
             (0, index_js_1.error)('Unknown requirements subcommand. Available: mark-complete');
     },
     'phase': handlePhase,
     'milestone': handleMilestone,
     'validate': handleValidate,
-    'progress': (args, cwd, raw) => (0, index_js_1.cmdProgressRender)(cwd, args[1] || 'json', raw),
+    'progress': (args, cwd, raw) => handleResult((0, index_js_1.cmdProgressRender)(cwd, args[1] || 'json', raw), raw),
     'todo': (args, cwd, raw) => {
         if (args[1] === 'complete')
-            (0, index_js_1.cmdTodoComplete)(cwd, args[2], raw);
+            handleResult((0, index_js_1.cmdTodoComplete)(cwd, args[2], raw), raw);
         else
             (0, index_js_1.error)('Unknown todo subcommand. Available: complete');
     },
     'scaffold': (args, cwd, raw) => {
         const f = getFlags(args, 'phase', 'name');
-        (0, index_js_1.cmdScaffold)(cwd, args[1], { phase: f.phase, name: f.name ? args.slice(args.indexOf('--name') + 1).join(' ') : null }, raw);
+        handleResult((0, index_js_1.cmdScaffold)(cwd, args[1], { phase: f.phase, name: f.name ? args.slice(args.indexOf('--name') + 1).join(' ') : null }, raw), raw);
     },
     'init': handleInit,
-    'phase-plan-index': (args, cwd, raw) => (0, index_js_1.cmdPhasePlanIndex)(cwd, args[1], raw),
-    'state-snapshot': (_args, cwd, raw) => (0, index_js_1.cmdStateSnapshot)(cwd, raw),
+    'phase-plan-index': (args, cwd, raw) => handleResult((0, index_js_1.cmdPhasePlanIndex)(cwd, args[1]), raw),
+    'state-snapshot': (_args, cwd, raw) => handleResult((0, index_js_1.cmdStateSnapshot)(cwd, raw), raw),
     'summary-extract': (args, cwd, raw) => {
         const fieldsIndex = args.indexOf('--fields');
         const fields = fieldsIndex !== -1 ? args[fieldsIndex + 1].split(',') : null;
-        (0, index_js_1.cmdSummaryExtract)(cwd, args[1], fields, raw);
+        handleResult((0, index_js_1.cmdSummaryExtract)(cwd, args[1], fields, raw), raw);
     },
     'websearch': async (args, _cwd, raw) => {
         const f = getFlags(args, 'limit', 'freshness');
-        await (0, index_js_1.cmdWebsearch)(args[1], {
+        handleResult(await (0, index_js_1.cmdWebsearch)(args[1], {
             limit: f.limit ? parseInt(f.limit, 10) : 10,
             freshness: f.freshness ?? undefined,
-        }, raw);
+        }, raw), raw);
     },
+    'artefakte-read': (args, cwd, raw) => handleResult((0, index_js_1.cmdArtefakteRead)(cwd, args[1], getFlag(args, '--phase') ?? undefined, raw), raw),
+    'artefakte-write': (args, cwd, raw) => handleResult((0, index_js_1.cmdArtefakteWrite)(cwd, args[1], getFlag(args, '--content') ?? undefined, getFlag(args, '--phase') ?? undefined, raw), raw),
+    'artefakte-append': (args, cwd, raw) => handleResult((0, index_js_1.cmdArtefakteAppend)(cwd, args[1], getFlag(args, '--entry') ?? undefined, getFlag(args, '--phase') ?? undefined, raw), raw),
+    'artefakte-list': (args, cwd, raw) => handleResult((0, index_js_1.cmdArtefakteList)(cwd, getFlag(args, '--phase') ?? undefined, raw), raw),
+    'context-load': (args, cwd, raw) => handleResult((0, index_js_1.cmdContextLoad)(cwd, getFlag(args, '--phase') ?? undefined, getFlag(args, '--topic') ?? undefined, hasFlag(args, 'include-history')), raw),
+    'skill-list': (_args, cwd, raw) => (0, index_js_1.cmdSkillList)(cwd, raw),
+    'skill-install': (args, cwd, raw) => (0, index_js_1.cmdSkillInstall)(cwd, args[1], raw),
+    'skill-update': (args, cwd, raw) => (0, index_js_1.cmdSkillUpdate)(cwd, args[1], raw),
+    'start': async (args, cwd, raw) => handleResult(await (0, index_js_1.cmdStart)(cwd, { noBrowser: hasFlag(args, 'no-browser'), networkMode: hasFlag(args, 'network') }), raw),
     'dashboard': (args) => handleDashboard(args.slice(1)),
     'start-server': async () => {
         const serverPath = path.join(__dirname, 'mcp-server.cjs');
@@ -325,43 +346,58 @@ const COMMANDS = {
 };
 // ─── Main ────────────────────────────────────────────────────────────────────
 async function main() {
-    const args = process.argv.slice(2);
-    // Optional cwd override for sandboxed subagents running outside project root.
-    let cwd = process.cwd();
-    const cwdEqArg = args.find(arg => arg.startsWith('--cwd='));
-    const cwdIdx = args.indexOf('--cwd');
-    if (cwdEqArg) {
-        const value = cwdEqArg.slice('--cwd='.length).trim();
-        if (!value)
-            (0, index_js_1.error)('Missing value for --cwd');
-        args.splice(args.indexOf(cwdEqArg), 1);
-        cwd = path.resolve(value);
-    }
-    else if (cwdIdx !== -1) {
-        const value = args[cwdIdx + 1];
-        if (!value || value.startsWith('--'))
-            (0, index_js_1.error)('Missing value for --cwd');
-        args.splice(cwdIdx, 2);
-        cwd = path.resolve(value);
-    }
-    if (!fs.existsSync(cwd) || !fs.statSync(cwd).isDirectory()) {
-        (0, index_js_1.error)(`Invalid --cwd: ${cwd}`);
-    }
-    const rawIndex = args.indexOf('--raw');
-    const raw = rawIndex !== -1;
-    if (rawIndex !== -1)
-        args.splice(rawIndex, 1);
-    const command = args[0];
-    if (!command) {
-        (0, index_js_1.error)(`Usage: maxsim-tools <command> [args] [--raw] [--cwd <path>]\nCommands: ${Object.keys(COMMANDS).join(', ')}`);
+    try {
+        const args = process.argv.slice(2);
+        // Optional cwd override for sandboxed subagents running outside project root.
+        let cwd = process.cwd();
+        const cwdEqArg = args.find(arg => arg.startsWith('--cwd='));
+        const cwdIdx = args.indexOf('--cwd');
+        if (cwdEqArg) {
+            const value = cwdEqArg.slice('--cwd='.length).trim();
+            if (!value)
+                (0, index_js_1.error)('Missing value for --cwd');
+            args.splice(args.indexOf(cwdEqArg), 1);
+            cwd = path.resolve(value);
+        }
+        else if (cwdIdx !== -1) {
+            const value = args[cwdIdx + 1];
+            if (!value || value.startsWith('--'))
+                (0, index_js_1.error)('Missing value for --cwd');
+            args.splice(cwdIdx, 2);
+            cwd = path.resolve(value);
+        }
+        if (!fs.existsSync(cwd) || !fs.statSync(cwd).isDirectory()) {
+            (0, index_js_1.error)(`Invalid --cwd: ${cwd}`);
+        }
+        const rawIndex = args.indexOf('--raw');
+        const raw = rawIndex !== -1;
+        if (rawIndex !== -1)
+            args.splice(rawIndex, 1);
+        const command = args[0];
+        if (!command) {
+            (0, index_js_1.error)(`Usage: maxsim-tools <command> [args] [--raw] [--cwd <path>]\nCommands: ${Object.keys(COMMANDS).join(', ')}`);
+        }
+        const handler = COMMANDS[command];
+        if (!handler) {
+            (0, index_js_1.error)(`Unknown command: ${command}`);
+        }
+        await handler(args, cwd, raw);
     }
-    const handler = COMMANDS[command];
-    if (!handler) {
-        (0, index_js_1.error)(`Unknown command: ${command}`);
+    catch (thrown) {
+        if (thrown instanceof index_js_1.CliOutput) {
+            (0, index_js_1.writeOutput)(thrown);
+            process.exit(0);
+        }
+        if (thrown instanceof index_js_1.CliError) {
+            process.stderr.write('Error: ' + thrown.message + '\n');
+            process.exit(1);
+        }
+        // Re-throw unexpected errors
+        throw thrown;
     }
-    await handler(args, cwd, raw);
 }
 // ─── Dashboard ───────────────────────────────────────────────────────────────
+const dashboard_launcher_js_1 = require("./core/dashboard-launcher.js");
 /**
  * Dashboard launch command.
  *
@@ -370,47 +406,15 @@ async function main() {
  * Supports --stop to kill a running instance.
  */
 async function handleDashboard(args) {
-    const DEFAULT_PORT = 3333;
-    const PORT_RANGE_END = 3343;
-    const HEALTH_TIMEOUT_MS = 1500;
     const networkMode = args.includes('--network');
     // Handle --stop flag
     if (args.includes('--stop')) {
-        for (let port = DEFAULT_PORT; port <= PORT_RANGE_END; port++) {
-            const running = await checkHealth(port, HEALTH_TIMEOUT_MS);
+        for (let port = dashboard_launcher_js_1.DEFAULT_PORT; port <= dashboard_launcher_js_1.PORT_RANGE_END; port++) {
+            const running = await (0, dashboard_launcher_js_1.checkHealth)(port);
             if (running) {
-                console.log(`Dashboard found on port ${port} — sending shutdown...`);
-                console.log(`Dashboard at http://localhost:${port} is running.`);
-                console.log(`To stop it, close the browser tab or kill the process on port ${port}.`);
-                try {
-                    if (process.platform === 'win32') {
-                        const result = (0, node_child_process_1.execSync)(`netstat -ano | findstr :${port} | findstr LISTENING`, { encoding: 'utf-8' }).trim();
-                        const lines = result.split('\n');
-                        const pids = new Set();
-                        for (const line of lines) {
-                            const parts = line.trim().split(/\s+/);
-                            const pid = parts[parts.length - 1];
-                            if (pid && pid !== '0')
-                                pids.add(pid);
-                        }
-                        for (const pid of pids) {
-                            try {
-                                (0, node_child_process_1.execSync)(`taskkill /PID ${pid} /F`, { stdio: 'ignore' });
-                                console.log(`Killed process ${pid}`);
-                            }
-                            catch {
-                                // Process may have already exited
-                            }
-                        }
-                    }
-                    else {
-                        (0, node_child_process_1.execSync)(`lsof -i :${port} -t | xargs kill -SIGTERM 2>/dev/null`, { stdio: 'ignore' });
-                    }
-                    console.log('Dashboard stopped.');
-                }
-                catch {
-                    console.log('Could not automatically stop the dashboard. Kill the process manually.');
-                }
+                console.log(`Dashboard found on port ${port} — stopping...`);
+                (0, dashboard_launcher_js_1.killProcessOnPort)(port);
+                console.log('Dashboard stopped.');
                 return;
             }
         }
@@ -418,152 +422,40 @@ async function handleDashboard(args) {
         return;
     }
     // Check if dashboard is already running
-    for (let port = DEFAULT_PORT; port <= PORT_RANGE_END; port++) {
-        const running = await checkHealth(port, HEALTH_TIMEOUT_MS);
-        if (running) {
-            console.log(`Dashboard already running at http://localhost:${port}`);
-            return;
-        }
+    const runningPort = await (0, dashboard_launcher_js_1.findRunningDashboard)();
+    if (runningPort) {
+        console.log(`Dashboard already running at http://localhost:${runningPort}`);
+        return;
     }
     // Resolve the dashboard server entry point
-    const serverPath = resolveDashboardServer();
+    const serverPath = (0, dashboard_launcher_js_1.resolveDashboardServer)();
     if (!serverPath) {
         console.error('Could not find @maxsim/dashboard server entry point.');
         console.error('Ensure @maxsim/dashboard is installed and built.');
         process.exit(1);
     }
-    // Determine runner: if .ts file, use tsx; if .js file, use node
-    const isTsFile = serverPath.endsWith('.ts');
-    const runner = 'node';
-    const runnerArgs = isTsFile ? ['--import', 'tsx', serverPath] : [serverPath];
-    // Standalone server must run from its own directory to find .next/
     const serverDir = path.dirname(serverPath);
-    // Read dashboard.json for projectCwd (one level up from dashboard/ dir)
-    let projectCwd = process.cwd();
-    const dashboardConfigPath = path.join(path.dirname(serverDir), 'dashboard.json');
-    if (fs.existsSync(dashboardConfigPath)) {
-        try {
-            const config = JSON.parse(fs.readFileSync(dashboardConfigPath, 'utf8'));
-            if (config.projectCwd) {
-                projectCwd = config.projectCwd;
-            }
-        }
-        catch {
-            // Use default cwd
-        }
-    }
-    // node-pty is a native addon that must be installed in the dashboard directory.
-    // Auto-install it if missing so the terminal works out of the box.
-    const ptyModulePath = path.join(serverDir, 'node_modules', 'node-pty');
-    if (!fs.existsSync(ptyModulePath)) {
-        console.log('Installing node-pty for terminal support...');
-        try {
-            (0, node_child_process_1.execSync)('npm install node-pty --save-optional --no-audit --no-fund --loglevel=error', {
-                cwd: serverDir,
-                stdio: 'inherit',
-                timeout: 120_000,
-            });
-        }
-        catch {
-            console.warn('node-pty installation failed — terminal will be unavailable.');
-        }
+    const dashConfig = (0, dashboard_launcher_js_1.readDashboardConfig)(serverPath);
+    // Auto-install node-pty if missing
+    console.log('Installing node-pty for terminal support...');
+    if (!(0, dashboard_launcher_js_1.ensureNodePty)(serverDir)) {
+        console.warn('node-pty installation failed — terminal will be unavailable.');
     }
     console.log('Dashboard starting...');
-    const child = (0, node_child_process_1.spawn)(runner, runnerArgs, {
-        cwd: serverDir,
-        detached: true,
-        stdio: 'ignore',
-        env: {
-            ...process.env,
-            MAXSIM_PROJECT_CWD: projectCwd,
-            NODE_ENV: isTsFile ? 'development' : 'production',
-            ...(networkMode ? { MAXSIM_NETWORK_MODE: '1' } : {}),
-        },
-        // On Windows, use shell to ensure detached works correctly
-        ...(process.platform === 'win32' ? { shell: true } : {}),
+    const pid = (0, dashboard_launcher_js_1.spawnDashboard)({
+        serverPath,
+        projectCwd: dashConfig.projectCwd,
+        networkMode,
     });
-    child.unref();
     // Wait briefly for the server to start, then check health
     await new Promise((resolve) => setTimeout(resolve, 3000));
-    for (let port = DEFAULT_PORT; port <= PORT_RANGE_END; port++) {
-        const running = await checkHealth(port, HEALTH_TIMEOUT_MS);
-        if (running) {
-            console.log(`Dashboard ready at http://localhost:${port}`);
-            return;
-        }
-    }
-    console.log(`Dashboard spawned (PID ${child.pid}). It may take a moment to start.`);
-    console.log(`Check http://localhost:${DEFAULT_PORT} once ready.`);
-}
-/**
- * Check if a dashboard health endpoint is responding on the given port.
- */
-async function checkHealth(port, timeoutMs) {
-    try {
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), timeoutMs);
-        const res = await fetch(`http://localhost:${port}/api/health`, {
-            signal: controller.signal,
-        });
-        clearTimeout(timer);
-        if (res.ok) {
-            const data = await res.json();
-            return data.status === 'ok';
-        }
-        return false;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Resolve the dashboard server entry point path.
- * Tries: built server.js first, then source server.ts for dev mode.
- */
-function resolveDashboardServer() {
-    // Strategy 0: Installed standalone build (production path)
-    const localDashboard = path.join(process.cwd(), '.claude', 'dashboard', 'server.js');
-    if (fs.existsSync(localDashboard))
-        return localDashboard;
-    const globalDashboard = path.join(os.homedir(), '.claude', 'dashboard', 'server.js');
-    if (fs.existsSync(globalDashboard))
-        return globalDashboard;
-    // Strategy 1: Resolve from @maxsim/dashboard package
-    try {
-        const require_ = (0, node_module_1.createRequire)(import.meta.url);
-        const pkgPath = require_.resolve('@maxsim/dashboard/package.json');
-        const pkgDir = path.dirname(pkgPath);
-        const serverJs = path.join(pkgDir, 'server.js');
-        if (fs.existsSync(serverJs))
-            return serverJs;
-        const serverTs = path.join(pkgDir, 'server.ts');
-        if (fs.existsSync(serverTs))
-            return serverTs;
-    }
-    catch {
-        // @maxsim/dashboard not resolvable
-    }
-    // Strategy 2: Walk up from this file to find the monorepo root
-    try {
-        let dir = path.dirname(new URL(import.meta.url).pathname);
-        // On Windows, remove leading / from /C:/...
-        if (process.platform === 'win32' && dir.startsWith('/')) {
-            dir = dir.slice(1);
-        }
-        for (let i = 0; i < 5; i++) {
-            const candidate = path.join(dir, 'packages', 'dashboard', 'server.ts');
-            if (fs.existsSync(candidate))
-                return candidate;
-            const candidateJs = path.join(dir, 'packages', 'dashboard', 'server.js');
-            if (fs.existsSync(candidateJs))
-                return candidateJs;
-            dir = path.dirname(dir);
-        }
-    }
-    catch {
-        // Fallback walk failed
+    const readyPort = await (0, dashboard_launcher_js_1.findRunningDashboard)();
+    if (readyPort) {
+        console.log(`Dashboard ready at http://localhost:${readyPort}`);
+        return;
     }
-    return null;
+    console.log(`Dashboard spawned (PID ${pid}). It may take a moment to start.`);
+    console.log(`Check http://localhost:${dashboard_launcher_js_1.DEFAULT_PORT} once ready.`);
 }
 main();
 //# sourceMappingURL=cli.js.map