@a5c-ai/hooks-mux-cli 5.0.1-staging.05ee168a

package/dist/cli/commands/doctor.js

@@ -0,0 +1,333 @@
+"use strict";
+/**
+ * doctor command — Report adapter capability profile, integration warnings,
+ * session store health, and stale session detection.
+ *
+ * Spec section 18.6 (Phase 5 enhancement).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doctorCommand = void 0;
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+const adapter_loader_1 = require("../adapter-loader");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ALL_CANONICAL_PHASES = [
+    'session.start', 'session.end', 'session.cwd_changed', 'session.file_changed',
+    'session.config_changed', 'session.compact.before', 'session.compact.after',
+    'turn.user_prompt_submitted', 'turn.before_agent', 'turn.after_agent',
+    'turn.stop', 'turn.error',
+    'model.before_request', 'model.after_response',
+    'planner.before_tool_selection',
+    'tool.before', 'tool.after', 'tool.error',
+    'tool.permission_request', 'tool.permission_denied',
+    'subagent.start', 'subagent.end',
+    'notification', 'message.received', 'message.sending', 'message.sent',
+    'mcp.elicitation', 'mcp.elicitation_result',
+];
+function buildCapabilityProfile(mappings) {
+    const supported = new Set();
+    const blockable = new Set();
+    const mutable = new Set();
+    const lossy = new Set();
+    const emulated = new Set();
+    for (const m of mappings) {
+        supported.add(m.canonicalPhase);
+        if (m.blockCapability)
+            blockable.add(m.canonicalPhase);
+        if (m.mutationCapability)
+            mutable.add(m.canonicalPhase);
+        if (m.supportLevel === 'lossy')
+            lossy.add(m.canonicalPhase);
+        if (m.supportLevel === 'emulated')
+            emulated.add(m.canonicalPhase);
+    }
+    const unsupported = ALL_CANONICAL_PHASES.filter((p) => !supported.has(p));
+    return {
+        supportedPhases: [...supported],
+        unsupportedPhases: unsupported,
+        blockablePhases: [...blockable],
+        mutablePhases: [...mutable],
+        lossyPhases: [...lossy],
+        emulatedPhases: [...emulated],
+    };
+}
+function analyzeAdapter(name) {
+    const warnings = [];
+    const packageName = `@a5c-ai/hooks-mux-adapter-${name}`;
+    try {
+        const loaded = (0, adapter_loader_1.loadAdapter)(name);
+        const caps = loaded.capabilities;
+        const profile = buildCapabilityProfile(loaded.phaseMappings);
+        // Generate warnings based on capability gaps
+        if (!caps.supportsBlock) {
+            warnings.push('Adapter does not support blocking decisions (deny/ask will be downgraded to noop)');
+        }
+        if (!caps.supportsNativeAdditionalContext) {
+            warnings.push('Adapter does not support native additionalContext injection');
+        }
+        if (caps.envPersistenceMode === 'none') {
+            warnings.push('No env persistence -- session context will not propagate to downstream tools');
+        }
+        if (caps.sessionIdQuality === 'synthetic' || caps.sessionIdQuality === 'none') {
+            warnings.push('Session ID is synthetic or unavailable -- cross-hook state may be unreliable');
+        }
+        if (caps.toolInterceptionScope === 'none') {
+            warnings.push('No tool interception -- tool.before/tool.after phases will be unsupported');
+        }
+        if (loaded.phaseMappings.length === 0) {
+            warnings.push('No phase mappings found -- all events will map to "unknown" phase');
+        }
+        // Capability gap warnings
+        if (profile.unsupportedPhases.length > 0) {
+            warnings.push(`${profile.unsupportedPhases.length} canonical phases are unsupported: ${profile.unsupportedPhases.slice(0, 5).join(', ')}${profile.unsupportedPhases.length > 5 ? '...' : ''}`);
+        }
+        if (profile.lossyPhases.length > 0) {
+            warnings.push(`${profile.lossyPhases.length} phases have lossy mapping: ${profile.lossyPhases.join(', ')}`);
+        }
+        if (!caps.supportsAsk && caps.supportsBlock) {
+            warnings.push('Adapter supports block but not ask -- interactive approval flows will not work');
+        }
+        if (!caps.supportsToolInputMutation && !caps.supportsToolResultMutation) {
+            warnings.push('No tool mutation support -- toolMutation results will be ignored');
+        }
+        if (caps.notes) {
+            for (const note of caps.notes) {
+                warnings.push(`Note: ${note}`);
+            }
+        }
+        const phaseSummaries = loaded.phaseMappings.map((m) => ({
+            canonicalPhase: m.canonicalPhase,
+            nativeHook: m.nativeHook,
+            supportLevel: m.supportLevel,
+            blockCapability: m.blockCapability,
+            mutationCapability: m.mutationCapability,
+        }));
+        return {
+            name,
+            available: true,
+            packageName,
+            capabilities: caps,
+            phaseMappings: phaseSummaries,
+            capabilityProfile: profile,
+            warnings,
+        };
+    }
+    catch (err) {
+        return {
+            name,
+            available: false,
+            packageName,
+            warnings: [],
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+async function checkSessionHealth(sessionDir, staleThresholdHours) {
+    const report = {
+        sessionDir,
+        dirExists: false,
+        sessionCount: 0,
+        staleSessions: [],
+        corruptSessions: [],
+        totalSizeBytes: 0,
+        errors: [],
+    };
+    try {
+        await fs.promises.access(sessionDir);
+        report.dirExists = true;
+    }
+    catch {
+        return report;
+    }
+    let entries;
+    try {
+        entries = await fs.promises.readdir(sessionDir);
+    }
+    catch (err) {
+        report.errors.push(`Failed to read session directory: ${err instanceof Error ? err.message : String(err)}`);
+        return report;
+    }
+    const jsonFiles = entries.filter((e) => e.endsWith('.json') && !e.includes('.corrupt.') && !e.endsWith('.lock'));
+    report.sessionCount = jsonFiles.length;
+    const now = Date.now();
+    for (const file of jsonFiles) {
+        const filePath = path.join(sessionDir, file);
+        try {
+            const stat = await fs.promises.stat(filePath);
+            report.totalSizeBytes += stat.size;
+            const raw = await fs.promises.readFile(filePath, 'utf-8');
+            const envelope = JSON.parse(raw);
+            const session = envelope.session;
+            if (!session || !session.updatedAt || !session.sessionId) {
+                report.corruptSessions.push(file);
+                continue;
+            }
+            const updatedAt = new Date(session.updatedAt).getTime();
+            const ageHours = (now - updatedAt) / (1000 * 60 * 60);
+            if (ageHours > staleThresholdHours) {
+                report.staleSessions.push({
+                    sessionId: session.sessionId,
+                    lastUpdated: session.updatedAt,
+                    ageHours: Math.round(ageHours * 10) / 10,
+                    adapter: session.adapter ?? 'unknown',
+                    fileSizeBytes: stat.size,
+                });
+            }
+        }
+        catch {
+            report.corruptSessions.push(file);
+        }
+    }
+    // Check for corrupt backup files
+    const corruptBackups = entries.filter((e) => e.includes('.corrupt.'));
+    if (corruptBackups.length > 0) {
+        report.errors.push(`${corruptBackups.length} corrupt backup file(s) found in session directory`);
+    }
+    return report;
+}
+exports.doctorCommand = {
+    command: 'doctor',
+    describe: 'Report adapter capability profile, session health, and integration warnings',
+    builder: (yargs) => yargs
+        .option('adapter', {
+        type: 'string',
+        describe: 'Specific adapter to check (omit for all known adapters)',
+    })
+        .option('json', {
+        type: 'boolean',
+        default: false,
+        describe: 'Output JSON format',
+    })
+        .option('session-dir', {
+        type: 'string',
+        describe: 'Session store directory to check (defaults to platform default)',
+    })
+        .option('stale-threshold', {
+        type: 'number',
+        default: 24,
+        describe: 'Hours after which a session is considered stale',
+    }),
+    handler: async (args) => {
+        const adapterNames = args.adapter ? [args.adapter] : [...adapter_loader_1.KNOWN_ADAPTERS];
+        const adapterReports = adapterNames.map(analyzeAdapter);
+        const sessionDir = args['session-dir'] ?? (0, hooks_mux_core_1.getDefaultSessionDir)();
+        const sessionHealth = await checkSessionHealth(sessionDir, args['stale-threshold'] ?? 24);
+        const report = {
+            timestamp: new Date().toISOString(),
+            adapters: adapterReports,
+            sessionHealth,
+        };
+        if (args.json) {
+            process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+            return;
+        }
+        // Human-readable output
+        console.log('=== Hooks Proxy Doctor ===');
+        console.log('');
+        // Adapter reports
+        console.log('--- Adapters ---');
+        for (const r of adapterReports) {
+            if (!r.available) {
+                console.log(`[x] ${r.name} (${r.packageName}): not available`);
+                if (r.error) {
+                    console.log(`    ${r.error}`);
+                }
+                console.log('');
+                continue;
+            }
+            const caps = r.capabilities;
+            const profile = r.capabilityProfile;
+            console.log(`[ok] ${r.name} (${r.packageName})`);
+            console.log(`  Family:           ${caps.family}`);
+            console.log(`  Session ID:       ${caps.sessionIdQuality}`);
+            console.log(`  Env persistence:  ${caps.envPersistenceMode}`);
+            console.log(`  Blocking:         ${caps.supportsBlock ? 'yes' : 'no'}`);
+            console.log(`  Ask:              ${caps.supportsAsk ? 'yes' : 'no'}`);
+            console.log(`  Tool scope:       ${caps.toolInterceptionScope}`);
+            console.log(`  Tool mutation:    input=${caps.supportsToolInputMutation ? 'yes' : 'no'} result=${caps.supportsToolResultMutation ? 'yes' : 'no'}`);
+            console.log(`  Phases:           ${profile.supportedPhases.length} supported, ${profile.unsupportedPhases.length} unsupported`);
+            if (profile.lossyPhases.length > 0) {
+                console.log(`  Lossy phases:     ${profile.lossyPhases.join(', ')}`);
+            }
+            if (profile.emulatedPhases.length > 0) {
+                console.log(`  Emulated phases:  ${profile.emulatedPhases.join(', ')}`);
+            }
+            if (r.warnings.length > 0) {
+                console.log('  Warnings:');
+                for (const w of r.warnings) {
+                    console.log(`    - ${w}`);
+                }
+            }
+            console.log('');
+        }
+        // Session health
+        console.log('--- Session Store ---');
+        console.log(`  Directory:    ${sessionHealth.sessionDir}`);
+        console.log(`  Exists:       ${sessionHealth.dirExists ? 'yes' : 'no'}`);
+        if (sessionHealth.dirExists) {
+            console.log(`  Sessions:     ${sessionHealth.sessionCount}`);
+            console.log(`  Total size:   ${formatBytes(sessionHealth.totalSizeBytes)}`);
+            if (sessionHealth.staleSessions.length > 0) {
+                console.log(`  Stale (>${args['stale-threshold'] ?? 24}h): ${sessionHealth.staleSessions.length}`);
+                for (const s of sessionHealth.staleSessions) {
+                    console.log(`    - ${s.sessionId} (${s.adapter}, ${s.ageHours}h old, ${formatBytes(s.fileSizeBytes)})`);
+                }
+            }
+            if (sessionHealth.corruptSessions.length > 0) {
+                console.log(`  Corrupt:      ${sessionHealth.corruptSessions.length}`);
+                for (const c of sessionHealth.corruptSessions) {
+                    console.log(`    - ${c}`);
+                }
+            }
+            if (sessionHealth.errors.length > 0) {
+                console.log('  Errors:');
+                for (const e of sessionHealth.errors) {
+                    console.log(`    - ${e}`);
+                }
+            }
+        }
+        console.log('');
+    },
+};
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    const val = bytes / Math.pow(1024, i);
+    return `${val.toFixed(i > 0 ? 1 : 0)} ${units[i]}`;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIH,2DAAkF;AAClF,sDAAgE;AAChE,uCAAyB;AACzB,2CAA6B;AA6D7B,MAAM,oBAAoB,GAAG;IAC3B,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,sBAAsB;IAC7E,wBAAwB,EAAE,wBAAwB,EAAE,uBAAuB;IAC3E,4BAA4B,EAAE,mBAAmB,EAAE,kBAAkB;IACrE,WAAW,EAAE,YAAY;IACzB,sBAAsB,EAAE,sBAAsB;IAC9C,+BAA+B;IAC/B,aAAa,EAAE,YAAY,EAAE,YAAY;IACzC,yBAAyB,EAAE,wBAAwB;IACnD,gBAAgB,EAAE,cAAc;IAChC,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc;IACrE,iBAAiB,EAAE,wBAAwB;CAC5C,CAAC;AAEF,SAAS,sBAAsB,CAAC,QAAwB;IACtD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,eAAe;YAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,CAAC,kBAAkB;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QACxD,IAAI,CAAC,CAAC,YAAY,KAAK,OAAO;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,CAAC,YAAY,KAAK,UAAU;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1E,OAAO;QACL,eAAe,EAAE,CAAC,GAAG,SAAS,CAAC;QAC/B,iBAAiB,EAAE,WAAW;QAC9B,eAAe,EAAE,CAAC,GAAG,SAAS,CAAC;QAC/B,aAAa,EAAE,CAAC,GAAG,OAAO,CAAC;QAC3B,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;QACvB,cAAc,EAAE,CAAC,GAAG,QAAQ,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,6BAA6B,IAAI,EAAE,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,4BAAW,EAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC;QACjC,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAE7D,6CAA6C;QAC7C,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAC;QACrG,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,+BAA+B,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,KAAK,MAAM,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,KAAK,WAAW,IAAI,IAAI,CAAC,gBAAgB,KAAK,MAAM,EAAE,CAAC;YAC9E,QAAQ,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,IAAI,CAAC,qBAAqB,KAAK,MAAM,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;QACrF,CAAC;QAED,0BAA0B;QAC1B,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,QAAQ,CAAC,IAAI,CACX,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,sCAAsC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAChL,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CACX,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,+BAA+B,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7F,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;QAClG,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC;YACxE,QAAQ,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAA0B,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7E,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;SACzC,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,IAAI;YACJ,SAAS,EAAE,IAAI;YACf,WAAW;YACX,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,cAAc;YAC7B,iBAAiB,EAAE,OAAO;YAC1B,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,IAAI;YACJ,SAAS,EAAE,KAAK;YAChB,WAAW;YACX,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,UAAkB,EAClB,mBAA2B;IAE3B,MAAM,MAAM,GAAwB;QAClC,UAAU;QACV,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,EAAE;QACjB,eAAe,EAAE,EAAE;QACnB,cAAc,EAAE,CAAC;QACjB,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5G,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACjH,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC;YAEnC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA+E,CAAC;YAC/G,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;YAEjC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBACzD,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClC,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YACxD,MAAM,QAAQ,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YAEtD,IAAI,QAAQ,GAAG,mBAAmB,EAAE,CAAC;gBACnC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC;oBACxB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,WAAW,EAAE,OAAO,CAAC,SAAS;oBAC9B,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,GAAG,EAAE;oBACxC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,SAAS;oBACrC,aAAa,EAAE,IAAI,CAAC,IAAI;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IACtE,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,oDAAoD,CAAC,CAAC;IACnG,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAEY,QAAA,aAAa,GAAsC;IAC9D,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,6EAA6E;IACvF,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,MAAM,CAAC,SAAS,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,yDAAyD;KACpE,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,oBAAoB;KAC/B,CAAC;SACD,MAAM,CAAC,aAAa,EAAE;QACrB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,iEAAiE;KAC5E,CAAC;SACD,MAAM,CAAC,iBAAiB,EAAE;QACzB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,iDAAiD;KAC5D,CAAC;IACN,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,+BAAc,CAAC,CAAC;QACzE,MAAM,cAAc,GAAoB,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAEzE,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,IAAA,qCAAoB,GAAE,CAAC;QACjE,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;QAE1F,MAAM,MAAM,GAAiB;YAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,cAAc;YACxB,aAAa;SACd,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,kBAAkB;QAClB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,kBAAkB,CAAC,CAAC;gBAC/D,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;oBACZ,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBAChC,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,CAAC,YAAa,CAAC;YAC7B,MAAM,OAAO,GAAG,CAAC,CAAC,iBAAkB,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,WAAW,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACnJ,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,eAAe,CAAC,MAAM,eAAe,OAAO,CAAC,iBAAiB,CAAC,MAAM,cAAc,CAAC,CAAC;YAChI,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1E,CAAC;YAED,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC3B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAC3B,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAED,iBAAiB;QACjB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,mBAAmB,aAAa,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,mBAAmB,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzE,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,mBAAmB,aAAa,CAAC,YAAY,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,mBAAmB,WAAW,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YAE5E,IAAI,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,aAAa,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;gBACnG,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,aAAa,EAAE,CAAC;oBAC5C,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,QAAQ,UAAU,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;gBAC1G,CAAC;YACH,CAAC;YAED,IAAI,aAAa,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,mBAAmB,aAAa,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;gBACvE,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,eAAe,EAAE,CAAC;oBAC9C,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YAED,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBACzB,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;oBACrC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;CACF,CAAC;AAEF,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC"}

package/dist/cli/commands/exec.d.ts

@@ -0,0 +1,18 @@
+/**
+ * exec command — Run a command with restored session context.
+ *
+ * Spec section 18.2.
+ *
+ * Pipeline:
+ *   1. Load session state
+ *   2. Materialize env/context into subprocess
+ *   3. Exec target command
+ */
+import type { CommandModule } from 'yargs';
+interface ExecArgs {
+    'session-id': string;
+    _: (string | number)[];
+}
+export declare const execCommand: CommandModule<object, ExecArgs>;
+export {};
+//# sourceMappingURL=exec.d.ts.map

package/dist/cli/commands/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAO3C,UAAU,QAAQ;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACxB;AAED,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,MAAM,EAAE,QAAQ,CAiGvD,CAAC"}

package/dist/cli/commands/exec.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * exec command — Run a command with restored session context.
+ *
+ * Spec section 18.2.
+ *
+ * Pipeline:
+ *   1. Load session state
+ *   2. Materialize env/context into subprocess
+ *   3. Exec target command
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execCommand = void 0;
+const child_process_1 = require("child_process");
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+const hooks_logger_1 = require("../hooks-logger");
+exports.execCommand = {
+    command: 'exec',
+    describe: 'Run a command with restored session context',
+    builder: (yargs) => yargs
+        .option('session-id', {
+        type: 'string',
+        demandOption: true,
+        describe: 'Session ID to load context from',
+    })
+        .parserConfiguration({ 'populate--': true })
+        .example('$0 exec --session-id abc123 -- echo hello', 'Run "echo hello" with session abc123 context'),
+    handler: async (args) => {
+        const logger = (0, hooks_logger_1.createHooksLogger)('exec');
+        const sessionId = args['session-id'];
+        const command = args['--'] ?? [];
+        if (command.length === 0) {
+            await logger.error('exec invoked without command', { sessionId });
+            console.error('Error: No command specified after --');
+            process.exitCode = 1;
+            return;
+        }
+        // Create a session store shim for materializeExecContext
+        const sessionStore = {
+            loadSession: (id) => (0, hooks_mux_core_1.loadSession)(id),
+            saveSession: async () => { },
+        };
+        // Materialize execution context
+        let childEnv;
+        try {
+            const materialized = await (0, hooks_mux_core_1.materializeExecContext)({
+                sessionId,
+                sessionStore,
+            });
+            // Merge materialized env with current process env
+            childEnv = {
+                ...process.env,
+                ...materialized.env,
+            };
+            await logger.debug('exec materialized session context', {
+                sessionId,
+                command: command.join(' '),
+            });
+        }
+        catch {
+            // Fallback: inject at least AGENT_SESSION_ID even if session not found
+            childEnv = {
+                ...process.env,
+                AGENT_SESSION_ID: sessionId,
+            };
+            await logger.warn('exec fell back to minimal session context', {
+                sessionId,
+                command: command.join(' '),
+            });
+        }
+        // Spawn the target command
+        const [cmd, ...cmdArgs] = command;
+        await logger.info('exec spawning command', {
+            sessionId,
+            command: [cmd, ...cmdArgs].join(' '),
+        });
+        const child = (0, child_process_1.spawn)(cmd, cmdArgs, {
+            env: childEnv,
+            stdio: 'inherit',
+        });
+        child.on('error', (err) => {
+            void logger.error('exec spawn failed', {
+                sessionId,
+                command: [cmd, ...cmdArgs].join(' '),
+                error: err.message,
+            });
+            console.error(`Failed to execute command: ${err.message}`);
+            process.exitCode = 1;
+        });
+        child.on('close', (code) => {
+            void logger.info('exec completed', {
+                sessionId,
+                command: [cmd, ...cmdArgs].join(' '),
+                exitCode: code ?? 0,
+            });
+            process.exitCode = code ?? 0;
+        });
+        // Wait for the child process to finish
+        await new Promise((resolve) => {
+            child.on('close', () => resolve());
+        });
+    },
+};
+//# sourceMappingURL=exec.js.map

package/dist/cli/commands/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/cli/commands/exec.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/invoke.d.ts

@@ -0,0 +1,27 @@
+/**
+ * invoke command — Primary hook entrypoint.
+ *
+ * Spec section 18.1.
+ *
+ * Pipeline:
+ *   1. Read stdin when adapter expects it
+ *   2. Normalize event via adapter normalizer when available, else core normalizeEvent
+ *   3. Resolve/load session context via core session store
+ *   4. Run handler or fan-out plan via core runPlan
+ *   5. Merge results via core mergeResults
+ *   6. Persist session store
+ *   7. Apply propagation backend
+ *   8. Emit adapter-native output via adapter renderer when available
+ */
+import type { CommandModule } from 'yargs';
+interface InvokeArgs {
+    adapter: string;
+    handler?: string[];
+    'bootstrap-only'?: boolean;
+    'native-event'?: string;
+    'session-id'?: string;
+    json?: boolean;
+}
+export declare const invokeCommand: CommandModule<object, InvokeArgs>;
+export {};
+//# sourceMappingURL=invoke.d.ts.map

package/dist/cli/commands/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAyB3C,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAmJD,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAiM3D,CAAC"}