@kiwidata/grimoire 0.1.1

package/dist/core/hooks.js

@@ -0,0 +1,168 @@
+import { readFile, writeFile, mkdir, access, chmod } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+/**
+ * Generate Claude Code hooks and git hooks for grimoire enforcement.
+ */
+export async function setupHooks(root) {
+    await setupClaudeHooks(root);
+    await setupClaudeSettings(root);
+    await setupGitHooks(root);
+}
+/**
+ * Generate .claude/hooks.json for Claude Code integration.
+ * Pre-commit: run grimoire check on changed files.
+ * Post-commit: verify Change: trailer when active grimoire changes exist.
+ */
+async function setupClaudeHooks(root) {
+    const claudeDir = join(root, ".claude");
+    const hooksPath = join(claudeDir, "hooks.json");
+    const hooks = {
+        hooks: {
+            PreCommit: [
+                {
+                    matcher: "*",
+                    command: "grimoire check --changed --json",
+                },
+            ],
+            PostCommit: [
+                {
+                    matcher: "*",
+                    command: trailerCheckScript(),
+                },
+            ],
+        },
+    };
+    await mkdir(claudeDir, { recursive: true });
+    if (await exists(hooksPath)) {
+        // Merge with existing hooks — don't overwrite user config
+        try {
+            const existing = JSON.parse(await readFile(hooksPath, "utf-8"));
+            const merged = mergeHooks(existing, hooks);
+            await writeFile(hooksPath, JSON.stringify(merged, null, 2) + "\n");
+            console.log(`  ${chalk.blue("merged")}  .claude/hooks.json`);
+        }
+        catch {
+            // Existing file is malformed — back it up and replace
+            await writeFile(hooksPath + ".bak", await readFile(hooksPath, "utf-8"));
+            await writeFile(hooksPath, JSON.stringify(hooks, null, 2) + "\n");
+            console.log(`  ${chalk.yellow("replaced")} .claude/hooks.json (old file backed up)`);
+        }
+    }
+    else {
+        await writeFile(hooksPath, JSON.stringify(hooks, null, 2) + "\n");
+        console.log(`  ${chalk.green("created")} .claude/hooks.json`);
+    }
+}
+/**
+ * Generate a standard git pre-commit hook as fallback for non-Claude environments.
+ */
+async function setupGitHooks(root) {
+    const gitHooksDir = join(root, ".git", "hooks");
+    // Only create if .git exists (this is a git repo)
+    if (!(await exists(join(root, ".git"))))
+        return;
+    const preCommitPath = join(gitHooksDir, "pre-commit");
+    // Don't overwrite existing hooks
+    if (await exists(preCommitPath)) {
+        const existing = await readFile(preCommitPath, "utf-8");
+        if (existing.includes("grimoire check")) {
+            console.log(`  ${chalk.yellow("exists")}  .git/hooks/pre-commit (already has grimoire)`);
+            return;
+        }
+        // Check if existing hook has exit/exec that would prevent our code from running
+        if (/^[^#]*\b(exit\s|exec\s)/m.test(existing)) {
+            console.log(`  ${chalk.yellow("manual")}  .git/hooks/pre-commit contains exit/exec — add manually: grimoire check --changed`);
+            return;
+        }
+        // Append grimoire check to existing hook
+        const appended = existing.trimEnd() + "\n\n# Grimoire pre-commit checks\ngrimoire check --changed\n";
+        await writeFile(preCommitPath, appended);
+        console.log(`  ${chalk.blue("appended")} .git/hooks/pre-commit`);
+        return;
+    }
+    await mkdir(gitHooksDir, { recursive: true });
+    const hookScript = `#!/bin/sh
+# Grimoire pre-commit checks
+# Generated by grimoire init — safe to customize
+
+# Run grimoire checks on changed files
+if command -v grimoire >/dev/null 2>&1; then
+  grimoire check --changed
+fi
+`;
+    await writeFile(preCommitPath, hookScript);
+    await chmod(preCommitPath, 0o755);
+    console.log(`  ${chalk.green("created")} .git/hooks/pre-commit`);
+}
+const BRANCH_GUARD_COMMAND = "grimoire branch-check --hook";
+const BRANCH_GUARD_MARKER = "grimoire branch-check";
+async function setupClaudeSettings(root) {
+    const settingsPath = join(root, ".claude", "settings.json");
+    const existed = await exists(settingsPath);
+    let settings = {};
+    let wasMalformed = false;
+    if (existed) {
+        const raw = await readFile(settingsPath, "utf-8");
+        try {
+            settings = JSON.parse(raw);
+        }
+        catch {
+            await writeFile(settingsPath + ".bak", raw);
+            wasMalformed = true;
+            settings = {};
+        }
+    }
+    const hooks = settings.hooks ?? {};
+    const userPromptSubmit = hooks.UserPromptSubmit ?? [];
+    const alreadyWired = userPromptSubmit.some((entry) => entry.hooks?.some((h) => h.command?.includes(BRANCH_GUARD_MARKER)));
+    if (alreadyWired) {
+        console.log(`  ${chalk.yellow("exists")}  .claude/settings.json (UserPromptSubmit branch-check)`);
+        return;
+    }
+    userPromptSubmit.push({
+        hooks: [{ type: "command", command: BRANCH_GUARD_COMMAND }],
+    });
+    hooks.UserPromptSubmit = userPromptSubmit;
+    settings.hooks = hooks;
+    await mkdir(join(root, ".claude"), { recursive: true });
+    await writeFile(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+    let verb;
+    if (!existed)
+        verb = "created";
+    else if (wasMalformed)
+        verb = "replaced";
+    else
+        verb = "updated";
+    console.log(`  ${chalk[verb === "created" ? "green" : verb === "replaced" ? "yellow" : "blue"](verb)} .claude/settings.json (UserPromptSubmit branch-check)`);
+}
+function trailerCheckScript() {
+    // Inline shell command that checks for Change: trailer
+    // Only enforces when there are active grimoire changes
+    return `sh -c 'if [ -d .grimoire/changes ] && [ "$(ls -A .grimoire/changes 2>/dev/null)" ]; then TRAILER=$(git log -1 --format="%(trailers:key=Change)" 2>/dev/null); if [ -z "$TRAILER" ]; then echo "WARNING: Commit is missing Change: trailer. Active grimoire changes exist."; fi; fi'`;
+}
+function mergeHooks(existing, additions) {
+    const merged = {
+        hooks: { ...existing.hooks },
+    };
+    for (const [phase, entries] of Object.entries(additions.hooks)) {
+        const key = phase;
+        const existingEntries = merged.hooks[key] ?? [];
+        const newEntries = entries ?? [];
+        // Only add entries that don't already exist (by command)
+        const existingCommands = new Set(existingEntries.map((e) => e.command));
+        const toAdd = newEntries.filter((e) => !existingCommands.has(e.command));
+        merged.hooks[key] = [...existingEntries, ...toAdd];
+    }
+    return merged;
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/core/hooks.js.map

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

package/dist/core/init.d.ts

@@ -0,0 +1,9 @@
+interface InitOptions {
+    skipAgents: boolean;
+    skipSkills: boolean;
+    noDetect: boolean;
+    agents: string[];
+}
+export declare function initProject(projectPath: string, options: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/core/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AA4BA,UAAU,WAAW;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAkCD,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Ff"}