@a5c-ai/hooks-mux-cli 5.0.1-staging.37ca18bd

package/dist/cli/adapter-loader.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dynamic adapter resolution.
+ *
+ * Attempts to load a harness adapter package by convention:
+ *   @a5c-ai/hooks-mux-adapter-<name>
+ *
+ * Each adapter package is expected to export:
+ *   - createAdapter(): AdapterCapabilities
+ *   - phase mappings (e.g. CLAUDE_PHASE_MAPPINGS / equivalent)
+ *   - normalizer function
+ *   - renderer function
+ *   - session resolver
+ */
+import type { AdapterCapabilities, PhaseMapping } from '@a5c-ai/hooks-mux-core';
+export interface LoadedAdapter {
+    capabilities: AdapterCapabilities;
+    phaseMappings: PhaseMapping[];
+    /** Raw module exports for adapter-specific functions. */
+    module: Record<string, unknown>;
+}
+/**
+ * Attempt to load an adapter package by name.
+ *
+ * @param adapterName - Short adapter name (e.g. 'claude', 'codex', 'copilot').
+ * @returns The loaded adapter with capabilities, phase mappings, and raw module.
+ * @throws If the adapter package cannot be found or loaded.
+ */
+export declare function loadAdapter(adapterName: string): LoadedAdapter;
+/**
+ * List of known adapter names for discovery/doctor purposes.
+ */
+export declare const KNOWN_ADAPTERS: readonly ["claude", "codex", "copilot", "cursor", "gemini", "oh-my-pi", "openclaw", "opencode", "pi"];
+//# sourceMappingURL=adapter-loader.d.ts.map

package/dist/cli/adapter-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-loader.d.ts","sourceRoot":"","sources":["../../src/cli/adapter-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGhF,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,mBAAmB,CAAC;IAClC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAsD9D;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,uGAUjB,CAAC"}

package/dist/cli/adapter-loader.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Dynamic adapter resolution.
+ *
+ * Attempts to load a harness adapter package by convention:
+ *   @a5c-ai/hooks-mux-adapter-<name>
+ *
+ * Each adapter package is expected to export:
+ *   - createAdapter(): AdapterCapabilities
+ *   - phase mappings (e.g. CLAUDE_PHASE_MAPPINGS / equivalent)
+ *   - normalizer function
+ *   - renderer function
+ *   - session resolver
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KNOWN_ADAPTERS = void 0;
+exports.loadAdapter = loadAdapter;
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+/**
+ * Attempt to load an adapter package by name.
+ *
+ * @param adapterName - Short adapter name (e.g. 'claude', 'codex', 'copilot').
+ * @returns The loaded adapter with capabilities, phase mappings, and raw module.
+ * @throws If the adapter package cannot be found or loaded.
+ */
+function loadAdapter(adapterName) {
+    // Auto-detection: probe env vars to determine the adapter
+    if (adapterName === 'auto') {
+        const detected = (0, hooks_mux_core_1.detectHarness)();
+        if (!detected) {
+            process.stderr.write('[hooks-mux] auto-detection failed: no harness signals found in environment\n');
+            process.exit(1);
+        }
+        process.stderr.write(`[hooks-mux] auto-detected adapter="${detected.adapter}" ` +
+            `confidence=${detected.confidence} evidence=[${detected.evidence.join(', ')}]\n`);
+        adapterName = detected.adapter;
+    }
+    const packageName = `@a5c-ai/hooks-mux-adapter-${adapterName}`;
+    let mod;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        mod = require(packageName);
+    }
+    catch (err) {
+        throw new Error(`Failed to load adapter "${adapterName}" (package: ${packageName}): ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Extract createAdapter function
+    const createAdapterFn = mod['createAdapter'];
+    if (typeof createAdapterFn !== 'function') {
+        throw new Error(`Adapter package "${packageName}" does not export a createAdapter function`);
+    }
+    const capabilities = createAdapterFn();
+    // Extract phase mappings -- convention: <ADAPTER>_PHASE_MAPPINGS or phaseMappings
+    let phaseMappings = [];
+    for (const key of Object.keys(mod)) {
+        if (key.endsWith('_PHASE_MAPPINGS') || key === 'phaseMappings') {
+            const candidate = mod[key];
+            if (Array.isArray(candidate)) {
+                phaseMappings = candidate;
+                break;
+            }
+        }
+    }
+    return { capabilities, phaseMappings, module: mod };
+}
+/**
+ * List of known adapter names for discovery/doctor purposes.
+ */
+exports.KNOWN_ADAPTERS = [
+    'claude',
+    'codex',
+    'copilot',
+    'cursor',
+    'gemini',
+    'oh-my-pi',
+    'openclaw',
+    'opencode',
+    'pi',
+];
+//# sourceMappingURL=adapter-loader.js.map

package/dist/cli/adapter-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-loader.js","sourceRoot":"","sources":["../../src/cli/adapter-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAmBH,kCAsDC;AAtED,2DAAuD;AASvD;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,WAAmB;IAC7C,0DAA0D;IAC1D,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAA,8BAAa,GAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8EAA8E,CAC/E,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sCAAsC,QAAQ,CAAC,OAAO,IAAI;YAC1D,cAAc,QAAQ,CAAC,UAAU,cAAc,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CACjF,CAAC;QACF,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,MAAM,WAAW,GAAG,6BAA6B,WAAW,EAAE,CAAC;IAE/D,IAAI,GAA4B,CAAC;IACjC,IAAI,CAAC;QACH,8DAA8D;QAC9D,GAAG,GAAG,OAAO,CAAC,WAAW,CAA4B,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,2BAA2B,WAAW,eAAe,WAAW,MAC9D,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,oBAAoB,WAAW,4CAA4C,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,EAAyB,CAAC;IAE9D,kFAAkF;IAClF,IAAI,aAAa,GAAmB,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;YAC/D,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,aAAa,GAAG,SAA2B,CAAC;gBAC5C,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACtD,CAAC;AAED;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,UAAU;IACV,UAAU;IACV,IAAI;CACI,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * bootstrap command — Dedicated no-op context bootstrap.
+ *
+ * Spec section 18.3.
+ *
+ * Delegates to invoke with --bootstrap-only flag internally.
+ * Reads stdin for session discovery, creates/loads session, and persists it.
+ */
+import type { CommandModule } from 'yargs';
+interface BootstrapArgs {
+    adapter: string;
+    'session-id'?: string;
+    json?: boolean;
+}
+export declare const bootstrapCommand: CommandModule<object, BootstrapArgs>;
+export {};
+//# sourceMappingURL=bootstrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAQ3C,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,MAAM,EAAE,aAAa,CAoEjE,CAAC"}

package/dist/cli/commands/bootstrap.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * bootstrap command — Dedicated no-op context bootstrap.
+ *
+ * Spec section 18.3.
+ *
+ * Delegates to invoke with --bootstrap-only flag internally.
+ * Reads stdin for session discovery, creates/loads session, and persists it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootstrapCommand = void 0;
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+const adapter_loader_1 = require("../adapter-loader");
+exports.bootstrapCommand = {
+    command: 'bootstrap',
+    describe: 'No-op context bootstrap — initialize session without running handlers',
+    builder: (yargs) => yargs
+        .option('adapter', {
+        type: 'string',
+        demandOption: true,
+        describe: 'Adapter name (e.g. claude, codex, copilot) or "auto" to detect from environment',
+    })
+        .option('session-id', {
+        type: 'string',
+        describe: 'Explicit session ID override',
+    })
+        .option('json', {
+        type: 'boolean',
+        default: false,
+        describe: 'Output JSON format',
+    }),
+    handler: async (args) => {
+        const loaded = (0, adapter_loader_1.loadAdapter)(args.adapter);
+        const env = process.env;
+        // Determine session ID
+        const sessionId = args['session-id']
+            ?? env['AGENT_SESSION_ID']
+            ?? `bootstrap-${Date.now()}`;
+        // Normalize a synthetic session.start event for context extraction
+        const event = (0, hooks_mux_core_1.normalizeEvent)({
+            adapter: args.adapter,
+            rawEventName: 'bootstrap',
+            env,
+            adapterMappings: loaded.phaseMappings,
+        });
+        // Load or create session
+        let session = await (0, hooks_mux_core_1.loadSession)(sessionId);
+        if (!session) {
+            session = {
+                version: 'a5c.hooks.session.v1',
+                sessionId,
+                adapter: args.adapter,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                cwd: event.execution.cwd ?? undefined,
+                persistedEnv: { ...event.env.persisted },
+                contextVars: {},
+                contextFragments: [],
+                metadata: {},
+            };
+        }
+        await (0, hooks_mux_core_1.saveSession)(session);
+        const output = {
+            status: 'bootstrapped',
+            sessionId,
+            adapter: args.adapter,
+            createdAt: session.createdAt,
+        };
+        if (args.json) {
+            process.stdout.write(JSON.stringify(output, null, 2) + '\n');
+        }
+        else {
+            console.log(`Session bootstrapped: ${sessionId} (adapter: ${args.adapter})`);
+        }
+    },
+};
+//# sourceMappingURL=bootstrap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/cli/commands/bootstrap.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAGH,2DAIgC;AAChC,sDAAgD;AAQnC,QAAA,gBAAgB,GAAyC;IACpE,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,uEAAuE;IACjF,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,MAAM,CAAC,SAAS,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,iFAAiF;KAC5F,CAAC;SACD,MAAM,CAAC,YAAY,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,8BAA8B;KACzC,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,oBAAoB;KAC/B,CAAC;IACN,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,MAAM,GAAG,IAAA,4BAAW,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAA6B,CAAC;QAElD,uBAAuB;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC;eAC/B,GAAG,CAAC,kBAAkB,CAAC;eACvB,aAAa,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAE/B,mEAAmE;QACnE,MAAM,KAAK,GAAG,IAAA,+BAAc,EAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,WAAW;YACzB,GAAG;YACH,eAAe,EAAE,MAAM,CAAC,aAAa;SACtC,CAAC,CAAC;QAEH,yBAAyB;QACzB,IAAI,OAAO,GAAG,MAAM,IAAA,4BAAW,EAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG;gBACR,OAAO,EAAE,sBAAsB;gBAC/B,SAAS;gBACT,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,SAAS;gBACrC,YAAY,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE;gBACxC,WAAW,EAAE,EAAE;gBACf,gBAAgB,EAAE,EAAE;gBACpB,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC;QAED,MAAM,IAAA,4BAAW,EAAC,OAAO,CAAC,CAAC;QAE3B,MAAM,MAAM,GAAG;YACb,MAAM,EAAE,cAAc;YACtB,SAAS;YACT,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,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;QAC/D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,yBAAyB,SAAS,cAAc,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/cli/commands/clear-session.d.ts

@@ -0,0 +1,13 @@
+/**
+ * clear-session command — Delete one session state file.
+ *
+ * Spec section 18.5.
+ */
+import type { CommandModule } from 'yargs';
+interface ClearSessionArgs {
+    'session-id': string;
+    json?: boolean;
+}
+export declare const clearSessionCommand: CommandModule<object, ClearSessionArgs>;
+export {};
+//# sourceMappingURL=clear-session.d.ts.map

package/dist/cli/commands/clear-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-session.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clear-session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,UAAU,gBAAgB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,MAAM,EAAE,gBAAgB,CA0BvE,CAAC"}

package/dist/cli/commands/clear-session.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * clear-session command — Delete one session state file.
+ *
+ * Spec section 18.5.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearSessionCommand = void 0;
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+exports.clearSessionCommand = {
+    command: 'clear-session',
+    describe: 'Delete a session state file',
+    builder: (yargs) => yargs
+        .option('session-id', {
+        type: 'string',
+        demandOption: true,
+        describe: 'Session ID to delete',
+    })
+        .option('json', {
+        type: 'boolean',
+        default: false,
+        describe: 'Output JSON format',
+    }),
+    handler: async (args) => {
+        await (0, hooks_mux_core_1.deleteSession)(args['session-id']);
+        if (args.json) {
+            process.stdout.write(JSON.stringify({ status: 'deleted', sessionId: args['session-id'] }) + '\n');
+        }
+        else {
+            console.log(`Session deleted: ${args['session-id']}`);
+        }
+    },
+};
+//# sourceMappingURL=clear-session.js.map

package/dist/cli/commands/clear-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-session.js","sourceRoot":"","sources":["../../../src/cli/commands/clear-session.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,2DAAuD;AAO1C,QAAA,mBAAmB,GAA4C;IAC1E,OAAO,EAAE,eAAe;IACxB,QAAQ,EAAE,6BAA6B;IACvC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,MAAM,CAAC,YAAY,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,sBAAsB;KACjC,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,oBAAoB;KAC/B,CAAC;IACN,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,IAAA,8BAAa,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAExC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,IAAI,CAC5E,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * doctor command — Report adapter capability profile, integration warnings,
+ * session store health, and stale session detection.
+ *
+ * Spec section 18.6 (Phase 5 enhancement).
+ */
+import type { CommandModule } from 'yargs';
+interface DoctorArgs {
+    adapter?: string;
+    json?: boolean;
+    'session-dir'?: string;
+    'stale-threshold'?: number;
+}
+export declare const doctorCommand: CommandModule<object, DoctorArgs>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAO3C,UAAU,UAAU;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AA0PD,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAoH3D,CAAC"}

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":"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"}

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;AAM3C,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,CAyEvD,CAAC"}

package/dist/cli/commands/exec.js

@@ -0,0 +1,79 @@
+"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");
+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 sessionId = args['session-id'];
+        const command = args['--'] ?? [];
+        if (command.length === 0) {
+            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,
+            };
+        }
+        catch {
+            // Fallback: inject at least AGENT_SESSION_ID even if session not found
+            childEnv = {
+                ...process.env,
+                AGENT_SESSION_ID: sessionId,
+            };
+        }
+        // Spawn the target command
+        const [cmd, ...cmdArgs] = command;
+        const child = (0, child_process_1.spawn)(cmd, cmdArgs, {
+            env: childEnv,
+            stdio: 'inherit',
+        });
+        child.on('error', (err) => {
+            console.error(`Failed to execute command: ${err.message}`);
+            process.exitCode = 1;
+        });
+        child.on('close', (code) => {
+            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":";AAAA;;;;;;;;;GASG;;;AAEH,iDAAsC;AAEtC,2DAGgC;AAOnB,QAAA,WAAW,GAAoC;IAC1D,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,6CAA6C;IACvD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,MAAM,CAAC,YAAY,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,iCAAiC;KAC5C,CAAC;SACD,mBAAmB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;SAC3C,OAAO,CACN,2CAA2C,EAC3C,8CAA8C,CAC/C;IACL,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,OAAO,GAAI,IAAI,CAAC,IAAI,CAA0B,IAAI,EAAE,CAAC;QAE3D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACtD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,yDAAyD;QACzD,MAAM,YAAY,GAAG;YACnB,WAAW,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,IAAA,4BAAW,EAAC,EAAE,CAAC;YAC5C,WAAW,EAAE,KAAK,IAAI,EAAE,GAA6B,CAAC;SACvD,CAAC;QAEF,gCAAgC;QAChC,IAAI,QAA4C,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,IAAA,uCAAsB,EAAC;gBAChD,SAAS;gBACT,YAAY;aACb,CAAC,CAAC;YAEH,kDAAkD;YAClD,QAAQ,GAAG;gBACT,GAAG,OAAO,CAAC,GAAG;gBACd,GAAG,YAAY,CAAC,GAAG;aACpB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,QAAQ,GAAG;gBACT,GAAG,OAAO,CAAC,GAAG;gBACd,gBAAgB,EAAE,SAAS;aAC5B,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,MAAM,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC;QAClC,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,GAAG,EAAE,OAAO,EAAE;YAChC,GAAG,EAAE,QAAQ;YACb,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,8BAA8B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,uCAAuC;QACvC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * invoke command — Primary hook entrypoint.
+ *
+ * Spec section 18.1.
+ *
+ * Pipeline:
+ *   1. Read stdin when adapter expects it
+ *   2. Normalize event via 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
+ */
+import type { CommandModule } from 'yargs';
+interface InvokeArgs {
+    adapter: string;
+    handler?: string[];
+    'bootstrap-only'?: boolean;
+    '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;AAgB3C,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA6CD,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAiJ3D,CAAC"}

package/dist/cli/commands/invoke.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * invoke command — Primary hook entrypoint.
+ *
+ * Spec section 18.1.
+ *
+ * Pipeline:
+ *   1. Read stdin when adapter expects it
+ *   2. Normalize event via 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeCommand = void 0;
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+const adapter_loader_1 = require("../adapter-loader");
+const stdin_1 = require("../stdin");
+/**
+ * Try to parse a string as JSON, returning undefined on failure.
+ */
+function tryParseJson(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve the session ID from explicit flag, env, or stdin payload.
+ */
+function resolveSessionId(explicitSessionId, stdinData, env) {
+    if (explicitSessionId)
+        return explicitSessionId;
+    if (env['AGENT_SESSION_ID'])
+        return env['AGENT_SESSION_ID'];
+    if (stdinData && typeof stdinData['session_id'] === 'string') {
+        return stdinData['session_id'];
+    }
+    return null;
+}
+/**
+ * Parse --handler values into HandlerRef objects.
+ * Format: "source:handler" or just "source" (handler defaults to "handler").
+ */
+function parseHandlerArgs(handlers) {
+    return handlers.map((h) => {
+        const colonIdx = h.indexOf(':');
+        if (colonIdx >= 0) {
+            return { source: h.slice(0, colonIdx), handler: h.slice(colonIdx + 1) };
+        }
+        return { source: h, handler: 'handler' };
+    });
+}
+exports.invokeCommand = {
+    command: 'invoke',
+    describe: 'Primary hook entrypoint — normalize, execute, merge, propagate',
+    builder: (yargs) => yargs
+        .option('adapter', {
+        type: 'string',
+        demandOption: true,
+        describe: 'Adapter name (e.g. claude, codex, copilot) or "auto" to detect from environment',
+    })
+        .option('handler', {
+        type: 'array',
+        string: true,
+        describe: 'Shell command handler(s) in command:label format',
+    })
+        .option('bootstrap-only', {
+        type: 'boolean',
+        default: false,
+        describe: 'Only bootstrap session context, skip handler execution',
+    })
+        .option('session-id', {
+        type: 'string',
+        describe: 'Explicit session ID override',
+    })
+        .option('json', {
+        type: 'boolean',
+        default: false,
+        describe: 'Output JSON format',
+    }),
+    handler: async (args) => {
+        // 1. Load adapter
+        const loaded = (0, adapter_loader_1.loadAdapter)(args.adapter);
+        // 2. Read stdin
+        const rawStdin = await (0, stdin_1.readStdin)();
+        const stdinPayload = tryParseJson(rawStdin);
+        const stdinData = (typeof stdinPayload === 'object' && stdinPayload !== null && !Array.isArray(stdinPayload))
+            ? stdinPayload
+            : undefined;
+        // Determine raw event name from env or stdin
+        const env = process.env;
+        const rawEventName = env['HOOKS_PROXY_EVENT_NAME']
+            ?? stdinData?.['event_name']
+            ?? 'unknown';
+        // 3. Normalize event
+        const event = (0, hooks_mux_core_1.normalizeEvent)({
+            adapter: args.adapter,
+            rawEventName,
+            stdinPayload,
+            env,
+            adapterMappings: loaded.phaseMappings,
+        });
+        // 4. Resolve session
+        const sessionId = resolveSessionId(args['session-id'], stdinData, env);
+        let session = null;
+        if (sessionId) {
+            session = await (0, hooks_mux_core_1.loadSession)(sessionId);
+            if (!session) {
+                // Create a new session
+                session = {
+                    version: 'a5c.hooks.session.v1',
+                    sessionId,
+                    adapter: args.adapter,
+                    createdAt: new Date().toISOString(),
+                    updatedAt: new Date().toISOString(),
+                    cwd: event.execution.cwd ?? undefined,
+                    transcriptPath: event.execution.transcriptPath ?? undefined,
+                    persistedEnv: { ...event.env.persisted },
+                    contextVars: {},
+                    contextFragments: [],
+                    metadata: {},
+                };
+            }
+            // Inject session context into event execution
+            event.execution.sessionId = sessionId;
+            if (session.persistedEnv) {
+                Object.assign(event.execution.persistedEnv, session.persistedEnv);
+            }
+        }
+        // 5. Bootstrap-only mode: persist session and exit
+        if (args['bootstrap-only']) {
+            if (session) {
+                await (0, hooks_mux_core_1.saveSession)(session);
+            }
+            if (args.json) {
+                process.stdout.write(JSON.stringify({ status: 'bootstrapped', sessionId }, null, 2) + '\n');
+            }
+            return;
+        }
+        // 6. Resolve execution plan
+        const handlers = args.handler ? parseHandlerArgs(args.handler) : [];
+        const plan = (0, hooks_mux_core_1.resolveHookPlan)({
+            phase: event.phase,
+            handlers,
+        });
+        // 7. Run plan and merge
+        let merged;
+        if (plan.length > 0) {
+            const results = await (0, hooks_mux_core_1.runPlan)(event, plan, { capabilities: loaded.capabilities });
+            merged = (0, hooks_mux_core_1.mergeResults)(results);
+        }
+        else {
+            // No handlers: produce a noop result
+            merged = (0, hooks_mux_core_1.mergeResults)([{ decision: 'noop' }]);
+        }
+        // 8. Persist session updates
+        if (session && sessionId) {
+            if (Object.keys(merged.persistEnv).length > 0) {
+                session.persistedEnv = { ...session.persistedEnv, ...merged.persistEnv };
+            }
+            if (Object.keys(merged.contextVars).length > 0) {
+                session.contextVars = { ...session.contextVars, ...merged.contextVars };
+            }
+            for (const key of merged.unsetEnv) {
+                delete session.persistedEnv[key];
+            }
+            session.updatedAt = new Date().toISOString();
+            await (0, hooks_mux_core_1.saveSession)(session);
+        }
+        // 9. Apply propagation backend
+        if (Object.keys(merged.persistEnv).length > 0) {
+            const backend = loaded.capabilities.envPersistenceMode;
+            await (0, hooks_mux_core_1.propagateEnv)(backend, merged.persistEnv, {
+                nativeEnvFilePath: env['CLAUDE_ENV_FILE'] ?? env['HOOKS_PROXY_ENV_FILE'],
+            });
+        }
+        // 10. Emit adapter-native output
+        const adapted = (0, hooks_mux_core_1.adaptOutput)({
+            adapter: args.adapter,
+            mergedResult: merged,
+            nativeInput: stdinPayload,
+            capabilities: loaded.capabilities,
+        });
+        process.stdout.write(JSON.stringify(adapted.output, null, args.json ? 2 : 0) + '\n');
+    },
+};
+//# sourceMappingURL=invoke.js.map

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

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

package/dist/cli/commands/show-session.d.ts

@@ -0,0 +1,13 @@
+/**
+ * show-session command — Inspect current session state.
+ *
+ * Spec section 18.4.
+ */
+import type { CommandModule } from 'yargs';
+interface ShowSessionArgs {
+    'session-id': string;
+    json?: boolean;
+}
+export declare const showSessionCommand: CommandModule<object, ShowSessionArgs>;
+export {};
+//# sourceMappingURL=show-session.d.ts.map

package/dist/cli/commands/show-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-session.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/show-session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,UAAU,eAAe;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,EAAE,eAAe,CA0CrE,CAAC"}

package/dist/cli/commands/show-session.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * show-session command — Inspect current session state.
+ *
+ * Spec section 18.4.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showSessionCommand = void 0;
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+exports.showSessionCommand = {
+    command: 'show-session',
+    describe: 'Inspect current session state',
+    builder: (yargs) => yargs
+        .option('session-id', {
+        type: 'string',
+        demandOption: true,
+        describe: 'Session ID to inspect',
+    })
+        .option('json', {
+        type: 'boolean',
+        default: false,
+        describe: 'Output JSON format',
+    }),
+    handler: async (args) => {
+        const session = await (0, hooks_mux_core_1.loadSession)(args['session-id']);
+        if (!session) {
+            if (args.json) {
+                process.stdout.write(JSON.stringify({ error: 'Session not found', sessionId: args['session-id'] }) + '\n');
+            }
+            else {
+                console.error(`Session not found: ${args['session-id']}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        if (args.json) {
+            process.stdout.write(JSON.stringify(session, null, 2) + '\n');
+        }
+        else {
+            console.log(`Session: ${session.sessionId}`);
+            console.log(`  Adapter:  ${session.adapter}`);
+            console.log(`  Created:  ${session.createdAt}`);
+            console.log(`  Updated:  ${session.updatedAt}`);
+            if (session.cwd)
+                console.log(`  CWD:      ${session.cwd}`);
+            const envCount = Object.keys(session.persistedEnv).length;
+            console.log(`  Env vars: ${envCount}`);
+            const varCount = Object.keys(session.contextVars).length;
+            console.log(`  Context:  ${varCount} vars, ${session.contextFragments.length} fragments`);
+        }
+    },
+};
+//# sourceMappingURL=show-session.js.map

package/dist/cli/commands/show-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-session.js","sourceRoot":"","sources":["../../../src/cli/commands/show-session.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,2DAAqD;AAOxC,QAAA,kBAAkB,GAA2C;IACxE,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,+BAA+B;IACzC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,MAAM,CAAC,YAAY,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,uBAAuB;KAClC,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,oBAAoB;KAC/B,CAAC;IACN,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,MAAM,IAAA,4BAAW,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAEtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YAC7G,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YAChD,IAAI,OAAO,CAAC,GAAG;gBAAE,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,UAAU,OAAO,CAAC,gBAAgB,CAAC,MAAM,YAAY,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAWA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvE"}

package/dist/cli/main.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const invoke_1 = require("./commands/invoke");
+const exec_1 = require("./commands/exec");
+const bootstrap_1 = require("./commands/bootstrap");
+const show_session_1 = require("./commands/show-session");
+const clear_session_1 = require("./commands/clear-session");
+const doctor_1 = require("./commands/doctor");
+async function main(argv = process.argv) {
+    await (0, yargs_1.default)((0, helpers_1.hideBin)(argv))
+        .scriptName('a5c-hooks-mux')
+        .usage('$0 <command> [options]')
+        .command(invoke_1.invokeCommand)
+        .command(exec_1.execCommand)
+        .command(bootstrap_1.bootstrapCommand)
+        .command(show_session_1.showSessionCommand)
+        .command(clear_session_1.clearSessionCommand)
+        .command(doctor_1.doctorCommand)
+        .demandCommand(1, 'You must provide a command')
+        .strict()
+        .help()
+        .parseAsync();
+}
+if (require.main === module) {
+    main().catch((err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";;;;;;AAWA,oBAcC;AAvBD,kDAA0B;AAC1B,2CAAwC;AACxC,8CAAkD;AAClD,0CAA8C;AAC9C,oDAAwD;AACxD,0DAA6D;AAC7D,4DAA+D;AAC/D,8CAAkD;AAE3C,KAAK,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI;IACtD,MAAM,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,IAAI,CAAC,CAAC;SACvB,UAAU,CAAC,eAAe,CAAC;SAC3B,KAAK,CAAC,wBAAwB,CAAC;SAC/B,OAAO,CAAC,sBAAa,CAAC;SACtB,OAAO,CAAC,kBAAW,CAAC;SACpB,OAAO,CAAC,4BAAgB,CAAC;SACzB,OAAO,CAAC,iCAAkB,CAAC;SAC3B,OAAO,CAAC,mCAAmB,CAAC;SAC5B,OAAO,CAAC,sBAAa,CAAC;SACtB,aAAa,CAAC,CAAC,EAAE,4BAA4B,CAAC;SAC9C,MAAM,EAAE;SACR,IAAI,EAAE;SACN,UAAU,EAAE,CAAC;AAClB,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC5B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/stdin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stdin reading utility.
+ */
+/**
+ * Read all of stdin as a string.
+ * Returns empty string if stdin is a TTY (interactive terminal).
+ */
+export declare function readStdin(): Promise<string>;
+//# sourceMappingURL=stdin.d.ts.map

package/dist/cli/stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../../src/cli/stdin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAc3C"}

package/dist/cli/stdin.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Stdin reading utility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readStdin = readStdin;
+/**
+ * Read all of stdin as a string.
+ * Returns empty string if stdin is a TTY (interactive terminal).
+ */
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        const stdin = process.stdin;
+        if (stdin.isTTY) {
+            resolve('');
+            return;
+        }
+        stdin.on('data', (chunk) => chunks.push(chunk));
+        stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        stdin.on('error', reject);
+    });
+}
+//# sourceMappingURL=stdin.js.map

package/dist/cli/stdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.js","sourceRoot":"","sources":["../../src/cli/stdin.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAMH,8BAcC;AAlBD;;;GAGG;AACH,SAAgB,SAAS;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,EAAE,CAAC,CAAC;YACZ,OAAO;QACT,CAAC;QAED,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACxE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { main } from './cli/main';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = void 0;
+var main_1 = require("./cli/main");
+Object.defineProperty(exports, "main", { enumerable: true, get: function () { return main_1.main; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAAzB,4FAAA,IAAI,OAAA"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@a5c-ai/hooks-mux-cli",
+  "version": "5.0.1-staging.37ca18bd",
+  "description": "CLI entrypoint for the hooks-mux system",
+  "license": "UNLICENSED",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "a5c-hooks-mux": "dist/cli/main.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a5c-ai/babysitter.git",
+    "directory": "packages/hooks-mux/cli"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rimraf dist",
+    "lint": "eslint \"src/**/*.ts\" --max-warnings=0",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@a5c-ai/hooks-mux-core": "5.0.1-staging.37ca18bd",
+    "yargs": "^17.0.0"
+  },
+  "devDependencies": {
+    "@types/yargs": "^17.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "rimraf": "^6.0.0"
+  }
+}