@a5c-ai/hooks-adapter-cli 5.1.1-staging.52898ebfc24f

package/dist/cli/commands/invoke.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeCommand = void 0;
+const hooks_adapter_core_1 = require("@a5c-ai/hooks-adapter-core");
+const adapter_loader_1 = require("../adapter-loader");
+const bootstrap_runtime_1 = require("../bootstrap-runtime");
+const hooks_logger_1 = require("../hooks-logger");
+const stdin_1 = require("../stdin");
+function inferClaudeNativeEventName(stdinData) {
+    if (!stdinData) {
+        return undefined;
+    }
+    if (typeof stdinData['tool_name'] === 'string'
+        || typeof stdinData['tool_call_id'] === 'string'
+        || stdinData['tool_input'] !== undefined) {
+        return stdinData['tool_response'] !== undefined ? 'PostToolUse' : 'PreToolUse';
+    }
+    if (stdinData['stop_hook_active'] !== undefined
+        || typeof stdinData['last_assistant_message'] === 'string'
+        || typeof stdinData['reason'] === 'string') {
+        return 'Stop';
+    }
+    if (typeof stdinData['source'] === 'string'
+        || stdinData['initial_prompt'] !== undefined) {
+        return 'SessionStart';
+    }
+    if (stdinData['prompt'] !== undefined) {
+        return 'UserPromptSubmit';
+    }
+    if (stdinData['agent_type'] !== undefined) {
+        return 'SubagentStop';
+    }
+    if (stdinData['title'] !== undefined || stdinData['message'] !== undefined) {
+        return 'Notification';
+    }
+    return undefined;
+}
+function resolveRawEventName(explicitNativeEvent, adapterName, stdinData, env) {
+    if (explicitNativeEvent) {
+        return { rawEventName: explicitNativeEvent, source: 'cli' };
+    }
+    if (env['HOOKS_PROXY_EVENT_NAME']) {
+        return { rawEventName: env['HOOKS_PROXY_EVENT_NAME'], source: 'env' };
+    }
+    if (typeof stdinData?.['event_name'] === 'string') {
+        return { rawEventName: stdinData['event_name'], source: 'stdin' };
+    }
+    if (adapterName === 'claude') {
+        const inferred = inferClaudeNativeEventName(stdinData);
+        if (inferred) {
+            return { rawEventName: inferred, source: 'claude-heuristic' };
+        }
+    }
+    return { rawEventName: 'unknown', source: 'default' };
+}
+function renderOutput(args, loaded, merged, rawEventName, stdinPayload, event) {
+    if (!loaded.renderer) {
+        return (0, hooks_adapter_core_1.adaptOutput)({
+            adapter: args.adapter,
+            mergedResult: merged,
+            nativeInput: stdinPayload,
+            capabilities: loaded.capabilities,
+        });
+    }
+    const rendered = loaded.renderer(merged, rawEventName, event);
+    if (rendered && typeof rendered === 'object' && !Array.isArray(rendered) && 'output' in rendered) {
+        const adapterRendered = rendered;
+        return {
+            output: (adapterRendered.output
+                && typeof adapterRendered.output === 'object'
+                && !Array.isArray(adapterRendered.output))
+                ? adapterRendered.output
+                : {},
+            degradedFields: [
+                ...(Array.isArray(adapterRendered.degradedFields) ? adapterRendered.degradedFields : []),
+                ...(Array.isArray(adapterRendered.droppedFields) ? adapterRendered.droppedFields : []),
+            ].filter((value) => typeof value === 'string'),
+        };
+    }
+    return {
+        output: (rendered && typeof rendered === 'object' && !Array.isArray(rendered))
+            ? rendered
+            : {},
+        degradedFields: [],
+    };
+}
+/**
+ * Parse --handler values into HandlerRef objects.
+ * Format: "source:handler" or just "source" (handler defaults to "handler").
+ */
+function findWindowsPathPrefixLength(value) {
+    if (/^[A-Za-z]:[\\/]/.test(value)) {
+        return 2;
+    }
+    if (/^[\\/]{2}\?[\\/][A-Za-z]:[\\/]/.test(value)) {
+        return 6;
+    }
+    return 0;
+}
+function parseHandlerArgs(handlers, shell) {
+    return handlers.map((h) => {
+        const windowsPrefixLength = findWindowsPathPrefixLength(h);
+        const colonIdx = windowsPrefixLength > 0
+            ? h.indexOf(':', windowsPrefixLength)
+            : h.indexOf(':');
+        const withShell = (handler) => (shell ? { ...handler, shell } : handler);
+        if (colonIdx >= 0) {
+            return withShell({ source: h.slice(0, colonIdx), handler: h.slice(colonIdx + 1) });
+        }
+        return withShell({ 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('native-event', {
+        type: 'string',
+        describe: 'Explicit native hook event name (for Claude: SessionStart, PreToolUse, PostToolUse, Stop, etc.)',
+    })
+        .option('session-id', {
+        type: 'string',
+        describe: 'Explicit session ID override',
+    })
+        .option('disable-all-hooks', {
+        type: 'boolean',
+        default: false,
+        describe: 'Skip hook execution and return a disabled noop diagnostic result',
+    })
+        .option('handler-timeout-ms', {
+        type: 'number',
+        describe: 'Default timeout in milliseconds for command handlers',
+    })
+        .option('shell', {
+        type: 'string',
+        describe: 'Shell executable to use for explicit command handlers',
+    })
+        .option('json', {
+        type: 'boolean',
+        default: false,
+        describe: 'Output JSON format',
+    }),
+    handler: async (args) => {
+        const logger = (0, hooks_logger_1.createHooksLogger)('invoke');
+        // 1. Load adapter
+        const loaded = (0, adapter_loader_1.loadAdapter)(args.adapter);
+        await logger.info('invoke started', {
+            adapter: args.adapter,
+            bootstrapOnly: Boolean(args['bootstrap-only']),
+            handlerCount: args.handler?.length ?? 0,
+        });
+        // 2. Read stdin
+        const rawStdin = await (0, stdin_1.readStdin)();
+        const stdinPayload = (0, bootstrap_runtime_1.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 rawEvent = resolveRawEventName(args['native-event'], loaded.capabilities.name, stdinData, env);
+        const { rawEventName } = rawEvent;
+        await logger.debug('stdin parsed', {
+            rawEventName,
+            rawEventNameSource: rawEvent.source,
+            stdinBytes: rawStdin.length,
+            stdinJson: Boolean(stdinData),
+        });
+        // 3. Normalize event
+        const event = loaded.normalizer
+            ? loaded.normalizer(rawEventName, rawStdin, env)
+            : (0, hooks_adapter_core_1.normalizeEvent)({
+                adapter: args.adapter,
+                rawEventName,
+                stdinPayload,
+                env,
+                adapterMappings: loaded.phaseMappings,
+            });
+        // 4. Resolve session
+        const sessionId = (0, bootstrap_runtime_1.resolveSessionId)(loaded.sessionResolver, args['session-id'], event.execution.sessionId, stdinData, env);
+        await logger.debug('session resolved', {
+            sessionId,
+            explicitSessionId: args['session-id'] ?? null,
+        });
+        let session = null;
+        if (sessionId) {
+            const prepared = (0, bootstrap_runtime_1.prepareBootstrapSession)({
+                existingSession: await (0, hooks_adapter_core_1.loadSession)(sessionId),
+                adapter: args.adapter,
+                event,
+                sessionId,
+            });
+            session = prepared.session;
+            // 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']) {
+            const prepared = (0, bootstrap_runtime_1.prepareBootstrapSession)({
+                existingSession: session,
+                adapter: args.adapter,
+                event,
+                sessionId,
+            });
+            session = prepared.session;
+            if (session) {
+                await (0, hooks_adapter_core_1.saveSession)(session);
+            }
+            const propagated = await (0, bootstrap_runtime_1.propagateBootstrapEnv)(loaded.capabilities.envPersistenceMode, prepared.persistEnv, env);
+            await logger.info('bootstrap-only invoke completed', {
+                adapter: args.adapter,
+                sessionId,
+                propagated,
+            });
+            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, args.shell) : [];
+        const plan = (0, hooks_adapter_core_1.resolveHookPlan)({
+            phase: event.phase,
+            handlers,
+        });
+        // 7. Run plan and merge
+        let merged;
+        if (plan.length > 0) {
+            const results = await (0, hooks_adapter_core_1.runPlan)(event, plan, {
+                capabilities: loaded.capabilities,
+                disableAllHooks: args['disable-all-hooks'] || undefined,
+                handlerTimeoutMs: args['handler-timeout-ms'],
+            });
+            merged = (0, hooks_adapter_core_1.mergeResults)(results);
+        }
+        else {
+            // No handlers: produce a noop result
+            merged = (0, hooks_adapter_core_1.mergeResults)([{ decision: 'noop' }]);
+        }
+        await logger.debug('plan executed', {
+            phase: event.phase,
+            planLength: plan.length,
+            decision: merged.decision,
+            degradedFields: merged.diagnostics.degradedFields,
+        });
+        // 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_adapter_core_1.saveSession)(session);
+        }
+        // 9. Apply propagation backend
+        if (Object.keys(merged.persistEnv).length > 0) {
+            const backend = loaded.capabilities.envPersistenceMode;
+            await (0, hooks_adapter_core_1.propagateEnv)(backend, merged.persistEnv, {
+                nativeEnvFilePath: (0, bootstrap_runtime_1.resolveNativeEnvFilePath)(env),
+            });
+        }
+        // 10. Emit adapter-native output
+        const adapted = renderOutput(args, loaded, merged, rawEventName, stdinPayload, event);
+        await logger.info('invoke completed', {
+            adapter: args.adapter,
+            phase: event.phase,
+            sessionId,
+            decision: merged.decision,
+            degradedFields: adapted.degradedFields,
+        });
+        const finalOutput = { ...adapted.output };
+        if (Object.keys(adapted.output).length === 0) {
+            finalOutput.decision = merged.decision;
+        }
+        if (Object.keys(merged.persistEnv).length > 0) {
+            finalOutput.persistEnv = merged.persistEnv;
+        }
+        finalOutput.metadata = {
+            ...(sessionId ? { AGENT_SESSION_ID: sessionId } : {}),
+            AGENT_ADAPTER: args.adapter,
+        };
+        process.stdout.write(JSON.stringify(finalOutput, 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_adapter_core_1 = require("@a5c-ai/hooks-adapter-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_adapter_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,mEAAyD;AAO5C,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,gCAAW,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/hooks-logger.d.ts

@@ -0,0 +1,12 @@
+export type HooksLogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare function getHooksLogDir(): string;
+export declare function getHooksLogPath(): string;
+export declare function shouldLog(level: HooksLogLevel): boolean;
+export declare function appendHooksLog(command: string, level: HooksLogLevel, message: string, context?: Record<string, unknown>): Promise<void>;
+export declare function createHooksLogger(command: string): {
+    debug: (message: string, context?: Record<string, unknown>) => Promise<void>;
+    info: (message: string, context?: Record<string, unknown>) => Promise<void>;
+    warn: (message: string, context?: Record<string, unknown>) => Promise<void>;
+    error: (message: string, context?: Record<string, unknown>) => Promise<void>;
+};
+//# sourceMappingURL=hooks-logger.d.ts.map

package/dist/cli/hooks-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-logger.d.ts","sourceRoot":"","sources":["../../src/cli/hooks-logger.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AA+ChE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAGvD;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM;qBAE5B,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBAE1C,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBAEzC,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qBAExC,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAG7D"}

package/dist/cli/hooks-logger.js

@@ -0,0 +1,118 @@
+"use strict";
+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.getHooksLogDir = getHooksLogDir;
+exports.getHooksLogPath = getHooksLogPath;
+exports.shouldLog = shouldLog;
+exports.appendHooksLog = appendHooksLog;
+exports.createHooksLogger = createHooksLogger;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const LOG_LEVELS = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+const LOG_LEVEL_ENV = 'A5C_LOGGING_HOOKS_LEVEL';
+const LOG_FILE_NAME = 'hooks-adapter.log';
+function resolveHomeDir() {
+    const envHome = process.env.HOME?.trim();
+    if (envHome) {
+        return envHome;
+    }
+    const userProfile = process.env.USERPROFILE?.trim();
+    if (userProfile) {
+        return userProfile;
+    }
+    return os.homedir();
+}
+function parseLogLevel(value) {
+    switch ((value ?? '').trim().toLowerCase()) {
+        case 'debug':
+            return 'debug';
+        case 'warn':
+            return 'warn';
+        case 'error':
+            return 'error';
+        default:
+            return 'info';
+    }
+}
+function getHooksLogDir() {
+    return path.join(resolveHomeDir(), '.a5c', 'logs', 'hooks');
+}
+function getHooksLogPath() {
+    return path.join(getHooksLogDir(), LOG_FILE_NAME);
+}
+function shouldLog(level) {
+    const configured = parseLogLevel(process.env[LOG_LEVEL_ENV]);
+    return LOG_LEVELS[level] >= LOG_LEVELS[configured];
+}
+async function appendHooksLog(command, level, message, context) {
+    if (!shouldLog(level)) {
+        return;
+    }
+    const entry = {
+        ts: new Date().toISOString(),
+        level,
+        command,
+        msg: message,
+    };
+    if (context && Object.keys(context).length > 0) {
+        entry.ctx = context;
+    }
+    const logDir = getHooksLogDir();
+    const logPath = getHooksLogPath();
+    process.stderr.write(`[hooks-logger] writing to ${logPath} (home=${resolveHomeDir()})\n`);
+    try {
+        fs.mkdirSync(logDir, { recursive: true });
+        fs.appendFileSync(logPath, JSON.stringify(entry) + '\n', 'utf8');
+        process.stderr.write(`[hooks-logger] write OK\n`);
+    }
+    catch (err) {
+        process.stderr.write(`[hooks-logger] FAILED: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}
+function createHooksLogger(command) {
+    return {
+        debug: (message, context) => appendHooksLog(command, 'debug', message, context),
+        info: (message, context) => appendHooksLog(command, 'info', message, context),
+        warn: (message, context) => appendHooksLog(command, 'warn', message, context),
+        error: (message, context) => appendHooksLog(command, 'error', message, context),
+    };
+}
+//# sourceMappingURL=hooks-logger.js.map

package/dist/cli/hooks-logger.js.map

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

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":";AAYA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvE"}

package/dist/cli/main.js

@@ -0,0 +1,42 @@
+#!/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/yargs"));
+const helpers_1 = require("yargs/helpers");
+const hooks_logger_1 = require("./hooks-logger");
+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('adapters-hooks')
+        .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()
+        .parse();
+}
+if (require.main === module) {
+    const logger = (0, hooks_logger_1.createHooksLogger)('main');
+    main().catch((err) => {
+        void logger.error('cli main failed', {
+            error: err instanceof Error ? err.message : String(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":";;;;;;AAYA,oBAcC;AAxBD,wDAAgC;AAChC,2CAAwC;AACxC,iDAAmD;AACnD,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,gBAAgB,CAAC;SAC5B,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,KAAK,EAAE,CAAC;AACb,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAA,gCAAiB,EAAC,MAAM,CAAC,CAAC;IACzC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC5B,KAAK,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;YACnC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;QACH,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