@hegel-dev/companion 1.0.0

package/dist/hook.js

@@ -0,0 +1,320 @@
+import { stdin } from "node:process";
+import { appendFile, mkdir, access } from "node:fs/promises";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { loadConfig } from "./config.js";
+import { loadState, saveState, addPrompt, addResponse, addFileEdit, addConcern, recordModel, } from "./state.js";
+import { analyzePrompt, buildPromptRecord, } from "./analyzers/prompt-analyzer.js";
+import { analyzeResponse, buildResponseRecord, } from "./analyzers/response-analyzer.js";
+import { analyzeSession } from "./analyzers/session-analyzer.js";
+import { loadTranscript } from "./transcript.js";
+import { formatBlockMessage } from "./format.js";
+import { writeHooksFile } from "./hooks-generator.js";
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of stdin) {
+        chunks.push(chunk);
+    }
+    const raw = Buffer.concat(chunks).toString("utf-8");
+    // Cursor on Windows prepends a UTF-8 BOM (\uFEFF) to stdin — strip it
+    return raw.replace(/^\uFEFF/, "");
+}
+const LOG_DIR = ".hegel-state";
+const LOG_FILE = `${LOG_DIR}/hegel.log`;
+/**
+ * Detects if the hook is running inside the Hegel project itself.
+ * When true, bypass is automatic — you can't develop the guardian while it guards you.
+ */
+async function isSelfProject(input) {
+    const roots = input.workspace_roots ?? [];
+    for (const root of roots) {
+        try {
+            await access(join(root, "hegel.config.json"));
+            await access(join(root, ".cursor-plugin", "plugin.json"));
+            return true;
+        }
+        catch {
+            // not the Hegel project
+        }
+    }
+    return false;
+}
+async function shouldBypass(input, config) {
+    if (config.observeOnly)
+        return true;
+    return isSelfProject(input);
+}
+async function log(level, event, message) {
+    try {
+        await mkdir(LOG_DIR, { recursive: true });
+        const ts = new Date().toISOString();
+        await appendFile(LOG_FILE, `[${ts}] [${level}] [${event}] ${message}\n`, "utf-8");
+    }
+    catch {
+        // logging should never break the hook
+    }
+}
+function shortConversationId(conversationId) {
+    return conversationId ? conversationId.slice(0, 8) : "unknown";
+}
+function summarizeText(text) {
+    return `len=${text.length} chars words=${text.split(/\s+/).filter(Boolean).length}`;
+}
+function writeOutput(obj) {
+    process.stdout.write(JSON.stringify(obj) + "\n");
+}
+/**
+ * Hot-reload: regenerate hooks.json if the config hash has changed.
+ * Cheap on no-op (hash compare only, no write). We run this from both
+ * `sessionStart` and `beforeSubmitPrompt` because Cursor only fires
+ * `sessionStart` on extension/hook-runtime init — opening a new chat
+ * inside the same IDE window does NOT re-trigger it — so relying on
+ * `sessionStart` alone meant UI config changes (model, strictness,
+ * observeOnly, …) silently failed to propagate until an IDE restart.
+ */
+async function maybeRegenerateHooks(workspaceRoots, config, triggerEvent) {
+    for (const root of workspaceRoots ?? []) {
+        try {
+            const updated = await writeHooksFile(root, config);
+            if (updated) {
+                await log("info", `${triggerEvent}:hot-reload`, `Regenerated hooks.json for ${root} (config changed)`);
+            }
+        }
+        catch {
+            // best-effort; hooks.json update must never break the hook
+        }
+    }
+}
+async function handleBeforeSubmitPrompt(input, output) {
+    const config = await loadConfig(input.workspace_roots?.[0] || process.cwd());
+    await maybeRegenerateHooks(input.workspace_roots, config, "beforeSubmitPrompt");
+    const bypass = await shouldBypass(input, config);
+    const state = await loadState(input.conversation_id);
+    if (input.session_id)
+        state.sessionId = input.session_id;
+    if (input.composer_mode)
+        state.composerMode = input.composer_mode;
+    recordModel(state, input.model);
+    const promptText = input.prompt.trim();
+    if (input.composer_mode === "ask") {
+        await log("info", "beforeSubmitPrompt", `Skipping analysis in ask mode`);
+        const record = buildPromptRecord(promptText, []);
+        addPrompt(state, record);
+        await saveState(state);
+        output({ continue: true });
+        return;
+    }
+    // Escape hatch: if the user resubmits the same prompt that was just blocked,
+    // let it through — they've seen the warning and chose to proceed.
+    if (state.lastBlockedPrompt && state.lastBlockedPrompt === promptText) {
+        await log("info", "beforeSubmitPrompt", `Resubmit of blocked prompt — allowing through (${summarizeText(promptText)})`);
+        state.lastBlockedPrompt = undefined;
+        const record = buildPromptRecord(promptText, []);
+        addPrompt(state, record);
+        await saveState(state);
+        output({ continue: true });
+        return;
+    }
+    const transcript = await loadTranscript(input.transcript_path);
+    const { concerns, shouldBlock } = analyzePrompt(input.prompt, state, transcript);
+    await log("info", "beforeSubmitPrompt", `${summarizeText(promptText)} concerns=${concerns.length} block=${shouldBlock} bypass=${bypass} transcript=${transcript ? transcript.turns.length + " turns" : "unavailable"}`);
+    const record = buildPromptRecord(promptText, concerns);
+    addPrompt(state, record);
+    for (const c of concerns) {
+        c.sourceText = promptText.length > 200 ? promptText.slice(0, 200) + "..." : promptText;
+        c.sourceType = "prompt";
+        addConcern(state, c);
+    }
+    if (shouldBlock && !bypass) {
+        state.lastBlockedPrompt = promptText;
+        await saveState(state);
+        const msg = formatBlockMessage(concerns);
+        await log("warn", "beforeSubmitPrompt", `BLOCKED concerns=${concerns.length}`);
+        output({ continue: false, user_message: msg });
+    }
+    else {
+        if (shouldBlock && bypass) {
+            await log("info", "beforeSubmitPrompt", `BYPASS: would have blocked (${concerns.length} concerns)`);
+        }
+        state.lastBlockedPrompt = undefined;
+        await saveState(state);
+        output({ continue: true });
+    }
+}
+async function handleAfterAgentResponse(input, output) {
+    const state = await loadState(input.conversation_id);
+    if (input.session_id)
+        state.sessionId = input.session_id;
+    if (input.composer_mode)
+        state.composerMode = input.composer_mode;
+    recordModel(state, input.model);
+    if (input.composer_mode === "ask") {
+        await log("info", "afterAgentResponse", `Skipping analysis in ask mode`);
+        const record = buildResponseRecord(input.text, [], false);
+        addResponse(state, record);
+        await saveState(state);
+        output({});
+        return;
+    }
+    const transcript = await loadTranscript(input.transcript_path);
+    const { concerns } = analyzeResponse(input.text, state, transcript);
+    const lastPromptTs = state.prompts.at(-1)?.timestamp ?? 0;
+    const lastResponseTs = state.responses.at(-1)?.timestamp ?? 0;
+    const unprompted = state.prompts.length === 0 || lastResponseTs > lastPromptTs;
+    await log("info", "afterAgentResponse", `responseLen=${input.text.length} concerns=${concerns.length} unprompted=${unprompted}`);
+    const record = buildResponseRecord(input.text, concerns, unprompted);
+    addResponse(state, record);
+    if (unprompted)
+        state.turnCount++;
+    for (const c of concerns) {
+        c.sourceText = input.text.length > 200 ? input.text.slice(0, 200) + "..." : input.text;
+        c.sourceType = "response";
+        addConcern(state, c);
+    }
+    await saveState(state);
+    output({});
+}
+async function handleAfterFileEdit(input, output) {
+    const state = await loadState(input.conversation_id);
+    // Approximate change volume as lines removed + lines added.
+    // Without a line-level diff this overcounts unchanged lines in partial
+    // edits, but correlates better with real change size than max(old, new).
+    const totalLines = input.edits.reduce((sum, e) => {
+        const oldLines = (e.old_string.match(/\n/g) ?? []).length + 1;
+        const newLines = (e.new_string.match(/\n/g) ?? []).length + 1;
+        return sum + oldLines + newLines;
+    }, 0);
+    addFileEdit(state, {
+        timestamp: Date.now(),
+        filePath: input.file_path,
+        editCount: input.edits.length,
+        totalLinesChanged: totalLines,
+    });
+    await saveState(state);
+    output({});
+}
+async function handleStop(input, output) {
+    const state = await loadState(input.conversation_id);
+    await log("info", "stop", `status=${input.status} loop=${input.loop_count} turns=${state.turnCount}`);
+    // Skip session review for aborted turns (e.g. hook blocks, user cancel) and
+    // when nothing has changed since the last review (Cursor fires stop per turn).
+    const alreadyReviewed = state.lastReviewedAtTurn === state.turnCount;
+    if (input.status !== "aborted" && !alreadyReviewed) {
+        const transcript = await loadTranscript(input.transcript_path);
+        const { summary, concerns } = analyzeSession(state, transcript);
+        await log("info", "stop:review", summary.replace(/\n/g, " | "));
+        for (const c of concerns) {
+            c.sourceType = "session";
+            addConcern(state, c);
+        }
+        state.lastReviewedAtTurn = state.turnCount;
+        await saveState(state);
+    }
+    // Session review is intentionally NOT emitted as `followup_message`:
+    // Cursor treats stop-hook `followup_message` as a new agent turn, which
+    // (a) re-ingests Hegel's own review into the conversation transcript,
+    // (b) triggers a redundant assistant response, and
+    // (c) causes the prompt-analyzer to flag its own review as context-drift.
+    // The review is instead surfaced through the VS Code sidebar dashboard,
+    // the status bar, and the MCP `hegel-review` tool.
+    output({});
+}
+async function handlePreCompact(input, output) {
+    const config = await loadConfig(input.workspace_roots?.[0] || process.cwd());
+    const bypass = await shouldBypass(input, config);
+    const state = await loadState(input.conversation_id);
+    state.compactionCount++;
+    await saveState(state);
+    await log("info", "preCompact", `compaction #${state.compactionCount} — ${input.context_usage_percent}% used, compacting ${input.messages_to_compact} messages`);
+    if (bypass) {
+        output({});
+        return;
+    }
+    const pct = input.context_usage_percent;
+    const nth = state.compactionCount;
+    const msg = nth >= 3
+        ? `⚖️ Hegel: Context compacted ${nth} times (${pct}% used). Early context is severely degraded — strongly consider starting a fresh chat with a summary of key decisions.`
+        : pct >= 90
+            ? `⚖️ Hegel: Context window at ${pct}% — compacting ${input.messages_to_compact} messages. Important early context may be lost. Consider starting a fresh chat with a summary of key decisions.`
+            : `⚖️ Hegel: Context compaction triggered (${pct}% used). Continuing in the same session.`;
+    output({ user_message: msg });
+}
+async function handleSessionStart(input, output) {
+    const config = await loadConfig(input.workspace_roots?.[0] || process.cwd());
+    const bypass = await shouldBypass(input, config);
+    const mode = bypass ? "observe-only" : "active";
+    await log("info", "sessionStart", `Mode: ${mode} (observeOnly=${config.observeOnly}, selfProject=${await isSelfProject(input)})`);
+    // Hot-reload: regenerate hooks.json if config has changed since last setup.
+    // This path fires on extension/hook-runtime init; the same check also runs
+    // from `beforeSubmitPrompt` so per-chat UI changes propagate without an
+    // IDE restart.
+    await maybeRegenerateHooks(input.workspace_roots, config, "sessionStart");
+    output({
+        additional_context: `[Hegel dialectical companion is ${mode} for this session. It will monitor prompt quality, response patterns, and session health.]`,
+    });
+}
+// ── Main Dispatcher ──
+export async function processHookInput(input, output = writeOutput) {
+    const event = input.hook_event_name;
+    await log("info", event ?? "unknown", `conversation=${shortConversationId(input.conversation_id)} model=${input.model}`);
+    // Guard against stale state: if startedAt is more than 4 hours old,
+    // treat this as a new session (covers missing sessionStart and ID reuse).
+    if (event !== "sessionStart") {
+        const state = await loadState(input.conversation_id);
+        const ageMs = Date.now() - state.startedAt;
+        if (ageMs > 4 * 60 * 60 * 1000) {
+            await log("info", "stale-state-reset", `State for ${shortConversationId(input.conversation_id)} was ${Math.round(ageMs / 60_000)} min old — resetting startedAt`);
+            state.startedAt = Date.now();
+            await saveState(state);
+        }
+    }
+    switch (event) {
+        case "beforeSubmitPrompt":
+            await handleBeforeSubmitPrompt(input, output);
+            break;
+        case "afterAgentResponse":
+            await handleAfterAgentResponse(input, output);
+            break;
+        case "afterFileEdit":
+            await handleAfterFileEdit(input, output);
+            break;
+        case "stop":
+            await handleStop(input, output);
+            break;
+        case "preCompact":
+            await handlePreCompact(input, output);
+            break;
+        case "sessionStart":
+            await handleSessionStart(input, output);
+            break;
+        default:
+            output({});
+    }
+}
+export async function processHookJson(raw, output = writeOutput) {
+    let input;
+    try {
+        input = JSON.parse(raw);
+    }
+    catch {
+        output({});
+        return;
+    }
+    await processHookInput(input, output);
+}
+export async function runHook(readInput = readStdin, output = writeOutput) {
+    const raw = await readInput();
+    await processHookJson(raw, output);
+}
+function isEntrypoint() {
+    return !process.env.VITEST &&
+        !!process.argv[1] &&
+        import.meta.url === pathToFileURL(process.argv[1]).href;
+}
+if (isEntrypoint()) {
+    runHook().catch(async (err) => {
+        await log("error", "main", `Unhandled: ${err instanceof Error ? err.message : String(err)}`);
+        writeOutput({});
+    });
+}
+//# sourceMappingURL=hook.js.map

package/dist/hook.js.map

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

package/dist/hooks-generator.d.ts

@@ -0,0 +1,45 @@
+import type { HegelConfig } from "./config.js";
+interface HookEntry {
+    command?: string;
+    type?: string;
+    prompt?: string;
+    model?: string;
+    timeout?: number;
+    loop_limit?: number;
+}
+interface HooksConfig {
+    version: number;
+    hooks: Record<string, HookEntry[]>;
+    _hegel?: {
+        configHash: string;
+        generatedAt: string;
+    };
+}
+/**
+ * Computes a hash of the config fields that affect hooks.json content.
+ * When this hash changes, hooks.json needs regeneration.
+ */
+export declare function configHash(config: HegelConfig): string;
+/**
+ * Reads the _hegel.configHash from an existing hooks.json.
+ * Returns null if the file doesn't exist or has no Hegel metadata.
+ */
+export declare function readExistingHash(hooksFilePath: string): Promise<string | null>;
+/**
+ * Generates hooks.json content for a target project.
+ * This is the shared logic used by both setup.ts (CLI) and
+ * the sessionStart hot-reload check.
+ */
+export declare function generateHooksConfig(config: HegelConfig): HooksConfig;
+/**
+ * Writes hooks.json to a target project directory.
+ * Returns true if the file was written, false if no update was needed.
+ */
+/**
+ * Writes hooks.json to a target project directory.
+ * Returns true if the file was written, false if no update was needed.
+ * Pass force=true to always write (used by the setup CLI).
+ */
+export declare function writeHooksFile(projectPath: string, config: HegelConfig, force?: boolean): Promise<boolean>;
+export {};
+//# sourceMappingURL=hooks-generator.d.ts.map

package/dist/hooks-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-generator.d.ts","sourceRoot":"","sources":["../src/hooks-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,UAAU,SAAS;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAYtD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQpF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CA0DpE;AAED;;;GAGG;AACH;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,KAAK,UAAQ,GACZ,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/hooks-generator.js

@@ -0,0 +1,120 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createHash } from "node:crypto";
+import { buildPromptAnalysisPrompt, buildResponseAnalysisPrompt } from "./prompts.js";
+function hegelRoot() {
+    return resolve(join(dirname(fileURLToPath(import.meta.url)), ".."));
+}
+/**
+ * Computes a hash of the config fields that affect hooks.json content.
+ * When this hash changes, hooks.json needs regeneration.
+ */
+export function configHash(config) {
+    const significant = {
+        enableLlmAnalysis: config.enableLlmAnalysis,
+        strictness: config.strictness,
+        observeOnly: config.observeOnly,
+        model: config.model,
+        timeoutSeconds: config.timeoutSeconds,
+    };
+    return createHash("sha256")
+        .update(JSON.stringify(significant))
+        .digest("hex")
+        .slice(0, 12);
+}
+/**
+ * Reads the _hegel.configHash from an existing hooks.json.
+ * Returns null if the file doesn't exist or has no Hegel metadata.
+ */
+export async function readExistingHash(hooksFilePath) {
+    try {
+        const raw = await readFile(hooksFilePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return parsed._hegel?.configHash ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Generates hooks.json content for a target project.
+ * This is the shared logic used by both setup.ts (CLI) and
+ * the sessionStart hot-reload check.
+ */
+export function generateHooksConfig(config) {
+    const root = hegelRoot();
+    const hookScript = join(root, "dist", "hook.js").replace(/\\/g, "/");
+    const hooks = {
+        version: 1,
+        hooks: {
+            sessionStart: [
+                { command: `node ${hookScript}` },
+            ],
+            beforeSubmitPrompt: [
+                { command: `node ${hookScript}`, timeout: 5 },
+            ],
+            afterAgentResponse: [
+                { command: `node ${hookScript}` },
+            ],
+            afterFileEdit: [
+                { command: `node ${hookScript}` },
+            ],
+            preCompact: [
+                { command: `node ${hookScript}` },
+            ],
+            stop: [
+                { command: `node ${hookScript}`, loop_limit: 1 },
+            ],
+        },
+        _hegel: {
+            configHash: configHash(config),
+            generatedAt: new Date().toISOString(),
+        },
+    };
+    if (config.enableLlmAnalysis) {
+        const promptAnalysis = buildPromptAnalysisPrompt(config.strictness, config.observeOnly);
+        const responseAnalysis = buildResponseAnalysisPrompt(config.strictness, config.observeOnly);
+        const promptHook = {
+            type: "prompt",
+            prompt: promptAnalysis,
+            timeout: config.timeoutSeconds,
+        };
+        const responseHook = {
+            type: "prompt",
+            prompt: responseAnalysis,
+            timeout: config.timeoutSeconds,
+        };
+        if (config.model !== "auto") {
+            promptHook.model = config.model;
+            responseHook.model = config.model;
+        }
+        hooks.hooks.beforeSubmitPrompt.push(promptHook);
+        hooks.hooks.afterAgentResponse.push(responseHook);
+    }
+    return hooks;
+}
+/**
+ * Writes hooks.json to a target project directory.
+ * Returns true if the file was written, false if no update was needed.
+ */
+/**
+ * Writes hooks.json to a target project directory.
+ * Returns true if the file was written, false if no update was needed.
+ * Pass force=true to always write (used by the setup CLI).
+ */
+export async function writeHooksFile(projectPath, config, force = false) {
+    const cursorDir = join(projectPath, ".cursor");
+    const hooksFile = join(cursorDir, "hooks.json");
+    if (!force) {
+        const existingHash = await readExistingHash(hooksFile);
+        const currentHash = configHash(config);
+        if (existingHash === currentHash)
+            return false;
+    }
+    const hooks = generateHooksConfig(config);
+    await mkdir(cursorDir, { recursive: true });
+    await writeFile(hooksFile, JSON.stringify(hooks, null, 2) + "\n", "utf-8");
+    return true;
+}
+//# sourceMappingURL=hooks-generator.js.map

package/dist/hooks-generator.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,10 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { SessionState } from "./types.js";
+export declare function resolveWorkspaceRoot(argv?: string[], cwd?: string): string;
+export declare function stateDirForWorkspace(workspaceRoot: string): string;
+export declare function getMostRecentSession(stateDir: string, now?: number): Promise<SessionState | null>;
+export declare function buildStatusText(session: SessionState): string;
+export declare function buildReviewText(session: SessionState): string;
+export declare function createServer(stateDir: string): Server;
+export declare function runMcpServer(stateDir?: string): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AASnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ/C,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,MAAM,EAAiB,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAgBvG;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA0B9B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAwB7D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA6B7D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkErD;AAED,wBAAsB,YAAY,CAAC,QAAQ,GAAE,MAAqD,iBAIjG"}