@hegel-dev/companion 1.0.0

package/dist/mcp.js

@@ -0,0 +1,173 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { readdir, stat, readFile } from "node:fs/promises";
+import { join, isAbsolute } from "node:path";
+import { pathToFileURL } from "node:url";
+import { sessionDurationMinutes, totalFilesEdited, totalLinesChanged } from "./state.js";
+// Look for .hegel-state in the directory where the MCP server was launched
+// Cursor launches MCP servers with the workspace root as the CWD.
+// If process.argv[2] is provided, use that as the workspace root instead.
+const ACTIVE_SESSION_MAX_AGE_MS = 4 * 60 * 60 * 1000;
+export function resolveWorkspaceRoot(argv = process.argv, cwd = process.cwd()) {
+    // 1. Explicit environment variable (bulletproof across all shells/spawners)
+    if (process.env.HEGEL_WORKSPACE_ROOT) {
+        return process.env.HEGEL_WORKSPACE_ROOT;
+    }
+    // 2. Fallback to argument parsing
+    // When run via npx, argv looks like:
+    // [0] node
+    // [1] .../mcp.js
+    // [2] hegel-mcp (sometimes, depending on npx version/args)
+    // [3] C:\Projects\CopybarasCircle
+    // Find the first argument that looks like an absolute path or exists after the script name
+    const pathArg = argv.slice(2).find(arg => arg !== "hegel-mcp" && arg !== "--");
+    return pathArg ? (isAbsolute(pathArg) ? pathArg : join(cwd, pathArg)) : cwd;
+}
+export function stateDirForWorkspace(workspaceRoot) {
+    return join(workspaceRoot, ".hegel-state");
+}
+export async function getMostRecentSession(stateDir, now = Date.now()) {
+    try {
+        const files = await readdir(stateDir);
+        const jsonFiles = files.filter((f) => f.endsWith(".json"));
+        if (jsonFiles.length === 0)
+            return null;
+        const stats = await Promise.all(jsonFiles.map(async (f) => {
+            const fullPath = join(stateDir, f);
+            const s = await stat(fullPath);
+            return { name: f, fullPath, mtime: s.mtimeMs };
+        }));
+        stats.sort((a, b) => b.mtime - a.mtime);
+        const raw = await readFile(stats[0].fullPath, "utf-8");
+        const session = JSON.parse(raw);
+        if (now - session.startedAt > ACTIVE_SESSION_MAX_AGE_MS) {
+            return null;
+        }
+        return session;
+    }
+    catch (err) {
+        // console.error(`Failed to read state dir ${STATE_DIR}:`, err);
+        return null;
+    }
+}
+export function buildStatusText(session) {
+    const duration = Math.round(sessionDurationMinutes(session));
+    const activeConcerns = session.concerns.slice(-5).reverse();
+    let statusText = `Hegel Session Status (ID: ${session.conversationId.slice(0, 8)})\n`;
+    statusText += `Duration: ${duration}m | Turns: ${session.turnCount} | Compactions: ${session.compactionCount}\n\n`;
+    if (activeConcerns.length === 0) {
+        statusText += "Health: CLEAN\nNo recent concerns detected.";
+    }
+    else {
+        const criticalCount = session.concerns.filter(c => c.severity === "critical").length;
+        const warningCount = session.concerns.filter(c => c.severity === "warning").length;
+        statusText += `Health: ${criticalCount > 0 ? "CRITICAL" : warningCount > 0 ? "WARNING" : "INFO"}\n`;
+        statusText += `Total Concerns: ${session.concerns.length} (${criticalCount} critical, ${warningCount} warning)\n\n`;
+        statusText += "Recent Concerns:\n";
+        for (const c of activeConcerns) {
+            statusText += `- [${c.severity.toUpperCase()}] ${c.category}: ${c.message}\n`;
+            if (c.suggestion)
+                statusText += `  Suggestion: ${c.suggestion}\n`;
+        }
+    }
+    return statusText;
+}
+export function buildReviewText(session) {
+    const duration = Math.round(sessionDurationMinutes(session));
+    const filesEdited = totalFilesEdited(session);
+    const linesChanged = totalLinesChanged(session);
+    let reviewText = `Hegel Comprehensive Session Review (ID: ${session.conversationId.slice(0, 8)})\n`;
+    reviewText += `Duration: ${duration}m | Turns: ${session.turnCount} | Files Edited: ${filesEdited} | Lines Changed: ${linesChanged} | Compactions: ${session.compactionCount}\n\n`;
+    if (session.concerns.length === 0) {
+        reviewText += "Session was completely clean. Excellent workflow!";
+    }
+    else {
+        const byCategory = new Map();
+        for (const c of session.concerns) {
+            byCategory.set(c.category, (byCategory.get(c.category) || 0) + 1);
+        }
+        reviewText += "Concern Categories Summary:\n";
+        for (const [cat, count] of byCategory.entries()) {
+            reviewText += `- ${cat}: ${count} occurrences\n`;
+        }
+        reviewText += "\nDetailed Concerns Log:\n";
+        for (const c of session.concerns) {
+            reviewText += `- [${c.severity.toUpperCase()}] ${c.category}: ${c.message}\n`;
+            if (c.suggestion)
+                reviewText += `  Suggestion: ${c.suggestion}\n`;
+        }
+    }
+    return reviewText;
+}
+export function createServer(stateDir) {
+    const server = new Server({
+        name: "hegel-mcp",
+        version: "1.0.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: "hegel-status",
+                    description: "Fetch the real-time health status of the current Hegel session. Use this mid-task to check for context drift, prompt degradation, or other concerns.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                {
+                    name: "hegel-review",
+                    description: "Fetch a comprehensive retrospective of the current Hegel session. Use this at the end of a major task to summarize the session's health and workflow.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+            ],
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const session = await getMostRecentSession(stateDir);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No active Hegel session found. Ensure you are in a Cursor workspace with Hegel initialized.",
+                    },
+                ],
+            };
+        }
+        if (request.params.name === "hegel-status") {
+            return {
+                content: [{ type: "text", text: buildStatusText(session) }],
+            };
+        }
+        if (request.params.name === "hegel-review") {
+            return {
+                content: [{ type: "text", text: buildReviewText(session) }],
+            };
+        }
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    });
+    return server;
+}
+export async function runMcpServer(stateDir = stateDirForWorkspace(resolveWorkspaceRoot())) {
+    const server = createServer(stateDir);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+function isEntrypoint() {
+    return !process.env.VITEST &&
+        !!process.argv[1] &&
+        import.meta.url === pathToFileURL(process.argv[1]).href;
+}
+if (isEntrypoint()) {
+    runMcpServer().catch(console.error);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/prompts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LLM prompt templates for Hegel's Layer 2 deep analysis.
+ *
+ * Prompt-based hooks in Cursor return { ok: boolean, reason?: string }.
+ * When ok=false, Cursor blocks the action and shows the reason.
+ * $ARGUMENTS is auto-replaced with the hook input JSON.
+ */
+export type StrictnessLevel = "relaxed" | "balanced" | "strict";
+export declare function buildPromptAnalysisPrompt(strictness: StrictnessLevel, bypass: boolean): string;
+export declare function buildResponseAnalysisPrompt(strictness: StrictnessLevel, bypass: boolean): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAWhE,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAqC9F;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAmChG"}

package/dist/prompts.js

@@ -0,0 +1,85 @@
+/**
+ * LLM prompt templates for Hegel's Layer 2 deep analysis.
+ *
+ * Prompt-based hooks in Cursor return { ok: boolean, reason?: string }.
+ * When ok=false, Cursor blocks the action and shows the reason.
+ * $ARGUMENTS is auto-replaced with the hook input JSON.
+ */
+const STRICTNESS_GUIDANCE = {
+    relaxed: "Only flag serious issues — vague one-word prompts, clearly dangerous operations, or missing context that will definitely cause problems. Let most prompts through.",
+    balanced: "Flag prompts that lack specificity, miss acceptance criteria for significant tasks, or skip verification after major changes. Allow clear, purposeful prompts even if brief.",
+    strict: "Scrutinize every prompt rigorously. Question assumptions, demand explicit acceptance criteria, flag any missing context, and challenge prompts that don't reference specific files or behaviors.",
+};
+export function buildPromptAnalysisPrompt(strictness, bypass) {
+    const bypassBlock = bypass
+        ? `## OBSERVE-ONLY MODE (ACTIVE)
+
+You are in observe-only mode. This is a hard rule that overrides everything below.
+- **You MUST always return ok=true.** Never return ok=false. Never block the prompt.
+- Still provide your full analysis in the reason field so it gets logged for tuning.
+- Format the reason as: "OBSERVE: <your analysis here>"
+
+`
+        : "";
+    return `You are Hegel, a dialectical critical thinking companion for AI-assisted software development.
+
+Your role: analyze the developer's prompt BEFORE it reaches the AI coding assistant. You are the antithesis — challenging the thesis (the prompt) so the developer reaches a better synthesis.
+
+${bypassBlock}## Evaluation criteria
+
+1. **Clarity**: Is the intent specific enough for an AI to act on without guessing?
+2. **Context**: Does the prompt reference concrete files, functions, behaviors, or error messages — or does it rely on ambiguous pronouns and implicit context?
+3. **Scope**: Is the task well-bounded, or could it spiral into uncontrolled changes?
+4. **Verification**: For significant changes (refactoring, architecture, security), does the developer mention how to verify the result?
+5. **Critical thinking**: Is the developer blindly continuing from a previous AI response without questioning it?
+
+## Strictness level: ${strictness}
+${STRICTNESS_GUIDANCE[strictness]}
+
+## Instructions
+
+Analyze the user prompt provided in $ARGUMENTS (the "prompt" field).
+
+- If the prompt is adequate for its purpose, return ok=true.
+- If there are genuine concerns, return ok=false with a concise reason (1-2 sentences) explaining what's missing and how to improve it.
+- Do NOT be pedantic about short prompts if they are clear in context (e.g., "yes, proceed" after a detailed plan is fine).
+- Do NOT flag prompts that are questions or requests for explanation.
+- Do NOT flag follow-up directives that reference items from a previous AI response (e.g., "fix #3 and #5" referencing a numbered list the AI just provided).
+- Focus on prompts that will lead to CODE CHANGES without sufficient guidance.`;
+}
+export function buildResponseAnalysisPrompt(strictness, bypass) {
+    const bypassBlock = bypass
+        ? `## OBSERVE-ONLY MODE (ACTIVE)
+
+You are in observe-only mode. This is a hard rule that overrides everything below.
+- **You MUST always return ok=true.** Never return ok=false. Never block the response.
+- Still provide your full analysis in the reason field so it gets logged for tuning.
+- Format the reason as: "OBSERVE: <your analysis here>"
+
+`
+        : "";
+    return `You are Hegel, a dialectical critical thinking companion reviewing an AI coding assistant's response.
+
+Your role: identify red flags in the AI's output that the developer should be aware of before accepting the changes.
+
+${bypassBlock}## What to look for
+
+1. **Overconfidence**: Claims like "this will definitely work" or "all issues resolved" without caveats
+2. **Missing edge cases**: The AI solved the happy path but didn't mention error handling, boundary conditions, or failure modes
+3. **Scope creep**: The AI changed more than what was asked for, or made architectural decisions without explicit approval
+4. **Untested claims**: Significant changes proposed without any mention of testing or verification
+5. **Security blind spots**: Changes touching auth, permissions, secrets, or user data without security considerations
+6. **Sycophancy**: The AI agrees with everything the developer says without pushing back on questionable decisions
+
+## Strictness level: ${strictness}
+${STRICTNESS_GUIDANCE[strictness]}
+
+## Instructions
+
+Analyze the AI assistant's response provided in $ARGUMENTS (the "text" field).
+
+- If the response appears reasonable and well-considered, return ok=true.
+- If there are red flags the developer should notice, return ok=false with a concise reason (1-2 sentences) describing the concern.
+- Be practical — not every response needs a lecture. Focus on things that could lead to real problems.`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,mBAAmB,GAAoC;IAC3D,OAAO,EACL,oKAAoK;IACtK,QAAQ,EACN,8KAA8K;IAChL,MAAM,EACJ,kMAAkM;CACrM,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,UAA2B,EAAE,MAAe;IACpF,MAAM,WAAW,GAAG,MAAM;QACxB,CAAC,CAAC;;;;;;;CAOL;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;EAIP,WAAW;;;;;;;;uBAQU,UAAU;EAC/B,mBAAmB,CAAC,UAAU,CAAC;;;;;;;;;;;+EAW8C,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,UAA2B,EAAE,MAAe;IACtF,MAAM,WAAW,GAAG,MAAM;QACxB,CAAC,CAAC;;;;;;;CAOL;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;EAIP,WAAW;;;;;;;;;uBASU,UAAU;EAC/B,mBAAmB,CAAC,UAAU,CAAC;;;;;;;;uGAQsE,CAAC;AACxG,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { mkdir, writeFile, readdir, readFile, access } from "node:fs/promises";
+import { execFileSync } from "node:child_process";
+import { writeHooksFile } from "./hooks-generator.js";
+import type { HegelConfig } from "./config.js";
+export declare const COMPANION_RULE = "# Hegel Companion Rule\n\nYou are working in a project that uses Hegel, a dialectical companion for AI-assisted development.\nHegel monitors your prompts and responses for quality, context drift, and session health.\n\n## MCP Tools Available\n\nYou have access to the `hegel-mcp` server which provides two tools:\n1. `hegel-status`: Fetch the real-time health status of the current session.\n2. `hegel-review`: Fetch a comprehensive retrospective of the session.\n\n## When to use these tools\n\n- **Proactive Self-Correction**: If the user seems frustrated, repeats the same prompt, or if you feel the conversation is losing focus, call `hegel-status` to check if Hegel has flagged `context-drift` or `prompt-degradation`. Adjust your behavior accordingly.\n- **End-of-Task Summaries**: When completing a significant multi-step task, call `hegel-review` and append a brief session health summary to your final response.\n- **Transparency**: If Hegel blocks a prompt or flags a critical concern, acknowledge it and help the user formulate a better prompt.\n";
+interface SetupDeps {
+    loadConfig: (workspaceRoot?: string) => Promise<HegelConfig>;
+    writeHooksFile: typeof writeHooksFile;
+    mkdir: typeof mkdir;
+    writeFile: typeof writeFile;
+    readdir: typeof readdir;
+    readFile: typeof readFile;
+    access: typeof access;
+    execFileSync: typeof execFileSync;
+    log: (message: string) => void;
+    error: (message: string) => void;
+    resolveHegelRoot: () => string;
+}
+/**
+ * Walks up from `startDir` (exclusive) looking for an ancestor that already
+ * contains a Hegel install (hegel.config.json + .cursor/hooks.json).
+ * Returns the ancestor path if found, or null. Stops at the filesystem root.
+ */
+export declare function findAncestorHegelInstall(startDir: string, accessFn?: typeof access): Promise<string | null>;
+export declare function runSetup(argv?: string[], deps?: SetupDeps): Promise<number>;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAc,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,cAAc,siCAgB1B,CAAC;AAEF,UAAU,SAAS;IACjB,UAAU,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7D,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,MAAM,CAAC;CAChC;AAgBD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,OAAO,MAAe,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBxB;AAED,wBAAsB,QAAQ,CAC5B,IAAI,GAAE,MAAM,EAAiB,EAC7B,IAAI,GAAE,SAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAuLjB"}

package/dist/setup.js

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+import { resolve, join, dirname, parse } from "node:path";
+import { mkdir, writeFile, readdir, readFile, access } from "node:fs/promises";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { loadConfig } from "./config.js";
+import { writeHooksFile, configHash } from "./hooks-generator.js";
+export const COMPANION_RULE = `# Hegel Companion Rule
+
+You are working in a project that uses Hegel, a dialectical companion for AI-assisted development.
+Hegel monitors your prompts and responses for quality, context drift, and session health.
+
+## MCP Tools Available
+
+You have access to the \`hegel-mcp\` server which provides two tools:
+1. \`hegel-status\`: Fetch the real-time health status of the current session.
+2. \`hegel-review\`: Fetch a comprehensive retrospective of the session.
+
+## When to use these tools
+
+- **Proactive Self-Correction**: If the user seems frustrated, repeats the same prompt, or if you feel the conversation is losing focus, call \`hegel-status\` to check if Hegel has flagged \`context-drift\` or \`prompt-degradation\`. Adjust your behavior accordingly.
+- **End-of-Task Summaries**: When completing a significant multi-step task, call \`hegel-review\` and append a brief session health summary to your final response.
+- **Transparency**: If Hegel blocks a prompt or flags a critical concern, acknowledge it and help the user formulate a better prompt.
+`;
+const defaultDeps = {
+    loadConfig,
+    writeHooksFile,
+    mkdir,
+    writeFile,
+    readdir,
+    readFile,
+    access,
+    execFileSync,
+    log: console.log,
+    error: console.error,
+    resolveHegelRoot: () => resolve(join(dirname(fileURLToPath(import.meta.url)), "..")),
+};
+/**
+ * Walks up from `startDir` (exclusive) looking for an ancestor that already
+ * contains a Hegel install (hegel.config.json + .cursor/hooks.json).
+ * Returns the ancestor path if found, or null. Stops at the filesystem root.
+ */
+export async function findAncestorHegelInstall(startDir, accessFn = access) {
+    const root = parse(startDir).root;
+    let current = dirname(startDir);
+    while (current && current !== root) {
+        try {
+            await accessFn(join(current, "hegel.config.json"));
+            await accessFn(join(current, ".cursor", "hooks.json"));
+            return current;
+        }
+        catch {
+            // keep walking up
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return null;
+}
+export async function runSetup(argv = process.argv, deps = defaultDeps) {
+    const rest = argv.slice(2);
+    const forceFlag = rest.includes("--force");
+    const positional = rest.filter((a) => !a.startsWith("--"));
+    let targetDir = positional[0];
+    if (targetDir === "init" && positional[1]) {
+        targetDir = positional[1];
+    }
+    // Catch the common typo `npx hegel-companion init init` — argv[3]==="init"
+    // was being treated as the target path, scaffolding into ./init/.
+    if (targetDir === "init") {
+        deps.error("Error: 'init' is not a valid project path.");
+        deps.error("       Did you mean: npx hegel-companion init .");
+        return 1;
+    }
+    if (!targetDir) {
+        deps.log("Usage: npx hegel-companion init <project-path>");
+        deps.log("");
+        deps.log("Generates .cursor/hooks.json in the target project with Hegel hooks.");
+        deps.log("Use '.' for the current directory. Pass --force to bypass safety checks.");
+        deps.log("");
+        deps.log("Current config:");
+        const config = await deps.loadConfig();
+        deps.log(`  model:       ${config.model}`);
+        deps.log(`  enableLlmAnalysis: ${config.enableLlmAnalysis}`);
+        deps.log(`  timeoutSeconds:  ${config.timeoutSeconds}s`);
+        deps.log(`  strictness:  ${config.strictness}`);
+        deps.log(`  observeOnly:   ${config.observeOnly}`);
+        deps.log(`  configHash:  ${configHash(config)}`);
+        return 1;
+    }
+    const projectPath = resolve(targetDir);
+    // Refuse to nest a Hegel install inside another one. This catches e.g.
+    // `init hegel-mcp` being run from a workspace that already has Hegel set up,
+    // which would silently create an orphan .cursor/ and hegel.config.json that
+    // Cursor never reads.
+    const ancestor = await findAncestorHegelInstall(projectPath, deps.access);
+    if (ancestor && !forceFlag) {
+        deps.error(`Error: ${ancestor} already has a Hegel install.`);
+        deps.error(`       Refusing to scaffold a nested install at ${projectPath}.`);
+        deps.error(`       If this is intentional, rerun with --force.`);
+        return 1;
+    }
+    const config = await deps.loadConfig(projectPath);
+    const hooksFile = join(projectPath, ".cursor", "hooks.json");
+    const hegelRoot = deps.resolveHegelRoot();
+    // Source-repo mode: when `init` targets the Hegel repo itself, Cursor's
+    // MCP server lives at `<hegelRoot>/dist/mcp.js`, not at
+    // `node_modules/@hegel-dev/companion/dist/mcp.js`. Detect this and emit an
+    // absolute local path so running the CLI inside the source repo doesn't
+    // silently break the MCP config.
+    const isSourceRepo = resolve(projectPath) === resolve(hegelRoot);
+    // Pre-flight report: if an existing install is present, tell the user what
+    // we're about to touch before doing it. Without --force, a matching config
+    // hash makes hooks.json a no-op (see writeHooksFile); this prevents
+    // accidental rewrites that change `generatedAt` for no functional reason.
+    const existingHooks = await deps.readFile(hooksFile, "utf-8").catch(() => null);
+    if (existingHooks) {
+        deps.log(`Existing Hegel install detected at ${projectPath}.`);
+        if (isSourceRepo) {
+            deps.log("  (running against the Hegel source repo — will use local dist/ paths)");
+        }
+        if (!forceFlag) {
+            deps.log("  hooks.json will be rewritten only if the config hash differs.");
+            deps.log("  Pass --force to rewrite unconditionally.");
+        }
+    }
+    const hooksWritten = await deps.writeHooksFile(projectPath, config, forceFlag);
+    if (!hooksWritten && existingHooks) {
+        deps.log(`hooks.json is already up to date (config hash ${configHash(config)})`);
+    }
+    // Write the Hegel Companion rule
+    const rulesDir = join(projectPath, ".cursor", "rules");
+    await deps.mkdir(rulesDir, { recursive: true });
+    await deps.writeFile(join(rulesDir, "hegel-companion.mdc"), COMPANION_RULE, "utf-8");
+    // Scaffold hegel.config.json if it doesn't exist
+    const configPath = join(projectPath, "hegel.config.json");
+    try {
+        const existingConfig = await deps.readFile(configPath, "utf-8").catch(() => null);
+        if (!existingConfig) {
+            const defaultConfig = {
+                "$schema": isSourceRepo
+                    ? "./hegel.config.schema.json"
+                    : "./node_modules/@hegel-dev/companion/hegel.config.schema.json",
+                "model": "auto",
+                "enableLlmAnalysis": true,
+                "timeoutSeconds": 15,
+                "strictness": "balanced",
+                "observeOnly": true
+            };
+            await deps.writeFile(configPath, JSON.stringify(defaultConfig, null, 2) + "\n", "utf-8");
+            deps.log(`✅ Default hegel.config.json created`);
+        }
+    }
+    catch {
+        // Ignore
+    }
+    // Register MCP server in .cursor/mcp.json
+    const mcpConfigPath = join(projectPath, ".cursor", "mcp.json");
+    try {
+        let mcpConfig = { mcpServers: {} };
+        const existingMcp = await deps.readFile(mcpConfigPath, "utf-8").catch(() => null);
+        if (existingMcp) {
+            mcpConfig = JSON.parse(existingMcp);
+            if (!mcpConfig.mcpServers)
+                mcpConfig.mcpServers = {};
+        }
+        // We use a direct node command rather than npx because Cursor's internal
+        // MCP spawner on Windows often fails to pass environment variables or
+        // trailing arguments correctly through npx. In source-repo mode we point
+        // at the local build; in consumer mode, at the node_modules install.
+        const mcpArgs = isSourceRepo
+            ? [join(hegelRoot, "dist", "mcp.js").replace(/\\/g, "/")]
+            : ["node_modules/@hegel-dev/companion/dist/mcp.js"];
+        mcpConfig.mcpServers["hegel-mcp"] = {
+            command: "node",
+            args: mcpArgs,
+            env: {
+                "HEGEL_WORKSPACE_ROOT": projectPath
+            }
+        };
+        await deps.writeFile(mcpConfigPath, JSON.stringify(mcpConfig, null, 2) + "\n", "utf-8");
+        deps.log(`✅ MCP server registered in .cursor/mcp.json`);
+    }
+    catch {
+        deps.log("Failed to register MCP server in .cursor/mcp.json");
+    }
+    // Find and install the VS Code extension
+    const vscodeDir = join(hegelRoot, "hegel-vscode");
+    try {
+        const files = await deps.readdir(vscodeDir);
+        const vsixFile = files.find(f => f.endsWith(".vsix"));
+        if (vsixFile) {
+            const vsixPath = join(vscodeDir, vsixFile);
+            deps.log(`Installing VS Code extension: ${vsixFile}...`);
+            deps.execFileSync("cursor", ["--install-extension", vsixPath], { stdio: "inherit" });
+        }
+    }
+    catch {
+        deps.log("Could not install VS Code extension automatically.");
+    }
+    const model = config.model === "auto" ? "Cursor default" : config.model;
+    const mode = config.observeOnly ? "observe-only (silent — full analysis, no chat intervention)" : "active (will block on concerns)";
+    deps.log("");
+    deps.log(`✅ Hegel hooks written to ${hooksFile}`);
+    deps.log(`✅ Hegel Companion Rule written to ${join(rulesDir, "hegel-companion.mdc")}`);
+    deps.log(`   Config hash: ${configHash(config)}`);
+    deps.log("");
+    deps.log(`Mode: ${mode}`);
+    deps.log("");
+    deps.log("Layers:");
+    deps.log(`  Layer 1: Rule-based analysis (command hooks) — ${config.observeOnly ? "full analysis, no chat intervention" : "blocks on warning+"}`);
+    if (config.enableLlmAnalysis) {
+        deps.log(`  Layer 2: LLM deep analysis (prompt hooks) — model: ${model} — ${config.observeOnly ? "full analysis, no chat intervention" : "blocks on concern"}`);
+    }
+    else {
+        deps.log("  Layer 2: LLM deep analysis — disabled (enableLlmAnalysis=false)");
+    }
+    if (config.observeOnly) {
+        deps.log("");
+        deps.log("  observeOnly is ON — both layers run full analysis and collect stats,");
+        deps.log("     but the user never sees intervention in the chat.");
+        deps.log("     Set observeOnly=false in hegel.config.json to enable blocking.");
+    }
+    deps.log("");
+    deps.log("Hot-reload: config changes are auto-detected on the next prompt.");
+    deps.log("            Change hegel.config.json → hooks.json is regenerated on the next");
+    deps.log("            beforeSubmitPrompt hook. Model changes on Layer 2 prompt hooks");
+    deps.log("            usually require a full Cursor restart to take effect.");
+    return 0;
+}
+function isEntrypoint() {
+    return !process.env.VITEST &&
+        !!process.argv[1] &&
+        import.meta.url === pathToFileURL(process.argv[1]).href;
+}
+if (isEntrypoint()) {
+    runSetup().then((exitCode) => {
+        if (exitCode !== 0)
+            process.exit(exitCode);
+    }).catch((err) => {
+        defaultDeps.error(`Setup failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,14 @@
+import type { SessionState, Concern, PromptRecord, ResponseRecord, FileEditRecord } from "./types.js";
+export declare function isSafeConversationId(conversationId: string): boolean;
+export declare function loadState(conversationId: string): Promise<SessionState>;
+export declare function saveState(state: SessionState): Promise<void>;
+export declare function addPrompt(state: SessionState, record: PromptRecord): void;
+export declare function addResponse(state: SessionState, record: ResponseRecord): void;
+export declare function addFileEdit(state: SessionState, record: FileEditRecord): void;
+export declare function addConcern(state: SessionState, concern: Concern): void;
+export declare function recentPrompts(state: SessionState, count?: number): PromptRecord[];
+export declare function sessionDurationMinutes(state: SessionState): number;
+export declare function totalFilesEdited(state: SessionState): number;
+export declare function totalLinesChanged(state: SessionState): number;
+export declare function recordModel(state: SessionState, model: string): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAkBpB,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAEpE;AAOD,wBAAsB,SAAS,CAC7B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlE;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,GACnB,IAAI,CAGN;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,cAAc,GACrB,IAAI,CAEN;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,cAAc,GACrB,IAAI,CAEN;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,OAAO,GACf,IAAI,CAEN;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,KAAK,GAAE,MAAU,GAChB,YAAY,EAAE,CAEhB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAG5D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAE7D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKpE"}