briefed 0.1.0

package/dist/commands/stats.js

@@ -0,0 +1,87 @@
+import { resolve, join } from "path";
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { countTokens, formatTokens } from "../utils/tokens.js";
+import { checkStaleness, formatStaleness } from "../extract/staleness.js";
+export async function statsCommand(opts) {
+    const root = resolve(opts.repo);
+    console.log("briefed stats\n");
+    // L1 Skeleton
+    const skeletonPath = join(root, ".briefed", "skeleton.md");
+    if (existsSync(skeletonPath)) {
+        const skeleton = readFileSync(skeletonPath, "utf-8");
+        const tokens = countTokens(skeleton);
+        console.log(`  L1 Skeleton:     ${formatTokens(tokens)} tokens (${skeleton.length} chars)`);
+        console.log(`    Delivery:      CLAUDE.md (always loaded, survives compaction)`);
+    }
+    else {
+        console.log("  L1 Skeleton:     not generated (run briefed init)");
+    }
+    // L3 Gotchas / Rules
+    const rulesDir = join(root, ".claude", "rules");
+    if (existsSync(rulesDir)) {
+        const ruleFiles = readdirSync(rulesDir).filter((f) => f.startsWith("briefed-"));
+        let totalTokens = 0;
+        let totalGotchas = 0;
+        for (const file of ruleFiles) {
+            const content = readFileSync(join(rulesDir, file), "utf-8");
+            totalTokens += countTokens(content);
+            totalGotchas += (content.match(/^- /gm) || []).length;
+        }
+        console.log(`  L3 Gotchas:      ${totalGotchas} constraints across ${ruleFiles.length} rule files (~${formatTokens(totalTokens)} tokens)`);
+        console.log(`    Delivery:      .claude/rules/ (path-scoped, loaded on demand)`);
+    }
+    else {
+        console.log("  L3 Gotchas:      not generated");
+    }
+    // L2 Contracts
+    const contractsDir = join(root, ".briefed", "contracts");
+    if (existsSync(contractsDir)) {
+        const contractFiles = readdirSync(contractsDir).filter((f) => f.endsWith(".yaml"));
+        let totalTokens = 0;
+        for (const file of contractFiles) {
+            const content = readFileSync(join(contractsDir, file), "utf-8");
+            totalTokens += countTokens(content);
+        }
+        console.log(`  L2 Contracts:    ${contractFiles.length} modules (~${formatTokens(totalTokens)} tokens total)`);
+        console.log(`    Delivery:      UserPromptSubmit hook (1-3 modules per prompt)`);
+    }
+    else {
+        console.log("  L2 Contracts:    not generated");
+    }
+    // Module index
+    const indexPath = join(root, ".briefed", "index.json");
+    if (existsSync(indexPath)) {
+        const index = JSON.parse(readFileSync(indexPath, "utf-8"));
+        console.log(`  Module Index:    ${index.modules?.length || 0} modules indexed`);
+        console.log(`    Generated:     ${index.generated || "unknown"}`);
+    }
+    // Hooks
+    const settingsPath = join(root, ".claude", "settings.json");
+    if (existsSync(settingsPath)) {
+        const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+        const hasBriefedHooks = JSON.stringify(settings.hooks || {}).includes("briefed");
+        console.log(`  Hooks:           ${hasBriefedHooks ? "installed" : "not installed"}`);
+    }
+    else {
+        console.log("  Hooks:           not installed");
+    }
+    console.log("");
+    // Estimated per-prompt cost
+    const skeletonTokens = existsSync(skeletonPath)
+        ? countTokens(readFileSync(skeletonPath, "utf-8"))
+        : 0;
+    console.log(`  Estimated tokens per prompt:`);
+    console.log(`    L1 (always):     ~${formatTokens(skeletonTokens)}`);
+    console.log(`    L3 (per file):   ~100-300`);
+    console.log(`    L2 (per prompt): ~400-1500`);
+    console.log(`    Total:           ~${formatTokens(skeletonTokens + 700)}-${formatTokens(skeletonTokens + 1800)}`);
+    console.log("");
+    console.log(`  Compare to without briefed:`);
+    console.log(`    Orientation:     ~5000-10000 tokens (3-6 file reads)`);
+    console.log(`    Time:            ~8-12 seconds`);
+    // Staleness check
+    console.log("");
+    const staleness = checkStaleness(root);
+    console.log(formatStaleness(staleness));
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/stats.js.map

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

package/dist/deliver/ci.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generate a GitHub Action workflow that auto-updates briefed context on PRs.
+ */
+export declare function generateGitHubAction(root: string): void;

package/dist/deliver/ci.js

@@ -0,0 +1,62 @@
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+/**
+ * Generate a GitHub Action workflow that auto-updates briefed context on PRs.
+ */
+export function generateGitHubAction(root) {
+    const workflowDir = join(root, ".github", "workflows");
+    if (!existsSync(workflowDir))
+        mkdirSync(workflowDir, { recursive: true });
+    const workflow = `# Auto-update briefed context on pushes to main
+# Generated by briefed — regenerate with: npx briefed ci
+name: Update briefed context
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - 'src/**'
+      - 'lib/**'
+      - 'app/**'
+      - 'packages/**'
+      - '*.ts'
+      - '*.js'
+      - '*.py'
+      - '*.go'
+      - '*.rs'
+
+jobs:
+  update-context:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # full history for git log
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Run briefed init
+        run: npx briefed@latest init --skip-hooks
+
+      - name: Check for changes
+        id: changes
+        run: |
+          git diff --quiet CLAUDE.md .claude/rules/ .briefed/ 2>/dev/null || echo "changed=true" >> $GITHUB_OUTPUT
+
+      - name: Commit updated context
+        if: steps.changes.outputs.changed == 'true'
+        run: |
+          git config user.name "briefed[bot]"
+          git config user.email "briefed[bot]@users.noreply.github.com"
+          git add CLAUDE.md .claude/rules/ .briefed/
+          git commit -m "chore: update briefed context [skip ci]"
+          git push
+`;
+    writeFileSync(join(workflowDir, "briefed.yml"), workflow);
+}
+//# sourceMappingURL=ci.js.map

package/dist/deliver/ci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../../src/deliver/ci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1E,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDlB,CAAC;IAEA,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC"}

package/dist/deliver/claudemd.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Append or update the briefed skeleton section in CLAUDE.md.
+ * Preserves existing CLAUDE.md content. Only modifies the briefed section.
+ */
+export declare function updateClaudeMd(root: string, skeleton: string): void;
+/**
+ * Save the skeleton as a standalone file in .briefed/ for hook re-injection.
+ */
+export declare function saveSkeletonFile(root: string, skeleton: string): void;

package/dist/deliver/claudemd.js

@@ -0,0 +1,51 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+const BRIEFED_START = "<!-- briefed:start -->";
+const BRIEFED_END = "<!-- briefed:end -->";
+/**
+ * Append or update the briefed skeleton section in CLAUDE.md.
+ * Preserves existing CLAUDE.md content. Only modifies the briefed section.
+ */
+export function updateClaudeMd(root, skeleton) {
+    const claudeDir = join(root, ".claude");
+    const claudeMdPath = join(root, "CLAUDE.md");
+    // Ensure directories exist
+    if (!existsSync(claudeDir)) {
+        mkdirSync(claudeDir, { recursive: true });
+    }
+    const briefedSection = `${BRIEFED_START}\n${skeleton}\n${BRIEFED_END}`;
+    if (existsSync(claudeMdPath)) {
+        let content = readFileSync(claudeMdPath, "utf-8");
+        if (content.includes(BRIEFED_START)) {
+            // Replace existing briefed section
+            const startIdx = content.indexOf(BRIEFED_START);
+            const endIdx = content.indexOf(BRIEFED_END);
+            if (endIdx !== -1) {
+                content =
+                    content.slice(0, startIdx) +
+                        briefedSection +
+                        content.slice(endIdx + BRIEFED_END.length);
+            }
+        }
+        else {
+            // Append briefed section
+            content = content.trimEnd() + "\n\n" + briefedSection + "\n";
+        }
+        writeFileSync(claudeMdPath, content);
+    }
+    else {
+        // Create new CLAUDE.md with just the briefed section
+        writeFileSync(claudeMdPath, briefedSection + "\n");
+    }
+}
+/**
+ * Save the skeleton as a standalone file in .briefed/ for hook re-injection.
+ */
+export function saveSkeletonFile(root, skeleton) {
+    const briefedDir = join(root, ".briefed");
+    if (!existsSync(briefedDir)) {
+        mkdirSync(briefedDir, { recursive: true });
+    }
+    writeFileSync(join(briefedDir, "skeleton.md"), skeleton);
+}
+//# sourceMappingURL=claudemd.js.map

package/dist/deliver/claudemd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudemd.js","sourceRoot":"","sources":["../../src/deliver/claudemd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAC/C,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAAgB;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAE7C,2BAA2B;IAC3B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,cAAc,GAAG,GAAG,aAAa,KAAK,QAAQ,KAAK,WAAW,EAAE,CAAC;IAEvE,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,IAAI,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAElD,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACpC,mCAAmC;YACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;wBAC1B,cAAc;wBACd,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,yBAAyB;YACzB,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;QAC/D,CAAC;QAED,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,qDAAqD;QACrD,aAAa,CAAC,YAAY,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC"}

package/dist/deliver/cross-tool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generate .cursorrules for Cursor IDE users.
+ * Same content as the briefed CLAUDE.md skeleton, formatted for Cursor.
+ */
+export declare function writeCursorRules(root: string, skeleton: string, conventions: string): void;
+/**
+ * Generate AGENTS.md (cross-tool format adopted by multiple AI coding tools).
+ * Provides a standardized context file that works with Claude Code, Cursor, Copilot, etc.
+ */
+export declare function writeAgentsMd(root: string, skeleton: string, conventions: string): void;

package/dist/deliver/cross-tool.js

@@ -0,0 +1,49 @@
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+/**
+ * Generate .cursorrules for Cursor IDE users.
+ * Same content as the briefed CLAUDE.md skeleton, formatted for Cursor.
+ */
+export function writeCursorRules(root, skeleton, conventions) {
+    const content = `# Project Context (generated by briefed)
+# This file provides Cursor with structural context about this codebase.
+# Regenerate with: npx briefed init
+
+${skeleton}
+
+${conventions}
+`.trim();
+    writeFileSync(join(root, ".cursorrules"), content + "\n");
+}
+/**
+ * Generate AGENTS.md (cross-tool format adopted by multiple AI coding tools).
+ * Provides a standardized context file that works with Claude Code, Cursor, Copilot, etc.
+ */
+export function writeAgentsMd(root, skeleton, conventions) {
+    const agentsPath = join(root, "AGENTS.md");
+    const BRIEFED_START = "<!-- briefed:agents:start -->";
+    const BRIEFED_END = "<!-- briefed:agents:end -->";
+    const briefedSection = `${BRIEFED_START}
+${skeleton}
+
+${conventions}
+${BRIEFED_END}`;
+    if (existsSync(agentsPath)) {
+        let content = readFileSync(agentsPath, "utf-8");
+        if (content.includes(BRIEFED_START)) {
+            const startIdx = content.indexOf(BRIEFED_START);
+            const endIdx = content.indexOf(BRIEFED_END);
+            if (endIdx !== -1) {
+                content = content.slice(0, startIdx) + briefedSection + content.slice(endIdx + BRIEFED_END.length);
+            }
+        }
+        else {
+            content = content.trimEnd() + "\n\n" + briefedSection + "\n";
+        }
+        writeFileSync(agentsPath, content);
+    }
+    else {
+        writeFileSync(agentsPath, briefedSection + "\n");
+    }
+}
+//# sourceMappingURL=cross-tool.js.map

package/dist/deliver/cross-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-tool.js","sourceRoot":"","sources":["../../src/deliver/cross-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,WAAmB;IAClF,MAAM,OAAO,GAAG;;;;EAIhB,QAAQ;;EAER,WAAW;CACZ,CAAC,IAAI,EAAE,CAAC;IAEP,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAgB,EAAE,WAAmB;IAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAE3C,MAAM,aAAa,GAAG,+BAA+B,CAAC;IACtD,MAAM,WAAW,GAAG,6BAA6B,CAAC;IAElD,MAAM,cAAc,GAAG,GAAG,aAAa;EACvC,QAAQ;;EAER,WAAW;EACX,WAAW,EAAE,CAAC;IAEd,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACrG,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;QAC/D,CAAC;QACD,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/deliver/git-hook.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Install a git post-commit hook that auto-updates briefed context.
+ * Runs `briefed init --skip-hooks` after every commit (~5 seconds).
+ * Developer never thinks about it — context stays fresh automatically.
+ */
+export declare function installGitHook(root: string): boolean;
+/**
+ * Remove briefed's git hook.
+ */
+export declare function removeGitHook(root: string): void;

package/dist/deliver/git-hook.js

@@ -0,0 +1,104 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, chmodSync } from "fs";
+import { join } from "path";
+import { execSync } from "child_process";
+/**
+ * Install a git post-commit hook that auto-updates briefed context.
+ * Runs `briefed init --skip-hooks` after every commit (~5 seconds).
+ * Developer never thinks about it — context stays fresh automatically.
+ */
+export function installGitHook(root) {
+    // Find the git hooks directory
+    let hooksDir;
+    try {
+        const gitDir = execSync("git rev-parse --git-dir", {
+            cwd: root,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        hooksDir = join(root, gitDir, "hooks");
+    }
+    catch {
+        // Not a git repo — skip
+        return false;
+    }
+    if (!existsSync(hooksDir)) {
+        mkdirSync(hooksDir, { recursive: true });
+    }
+    const hookPath = join(hooksDir, "post-commit");
+    const briefedMarker = "# briefed: auto-update context";
+    const hookScript = `#!/bin/sh
+${briefedMarker}
+# Re-index codebase after each commit to keep context fresh.
+# Runs in background so it doesn't slow down your commit.
+# Remove this hook with: briefed unhook
+(npx briefed init --skip-hooks > /dev/null 2>&1 &)
+`;
+    if (existsSync(hookPath)) {
+        const existing = readFileSync(hookPath, "utf-8");
+        // Already has briefed hook
+        if (existing.includes(briefedMarker))
+            return true;
+        // Append to existing hook
+        writeFileSync(hookPath, existing.trimEnd() + "\n\n" + hookScript);
+    }
+    else {
+        writeFileSync(hookPath, hookScript);
+    }
+    // Make executable (Unix/Mac)
+    try {
+        chmodSync(hookPath, 0o755);
+    }
+    catch {
+        // Windows doesn't need chmod
+    }
+    return true;
+}
+/**
+ * Remove briefed's git hook.
+ */
+export function removeGitHook(root) {
+    let hooksDir;
+    try {
+        const gitDir = execSync("git rev-parse --git-dir", {
+            cwd: root,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        hooksDir = join(root, gitDir, "hooks");
+    }
+    catch {
+        return;
+    }
+    const hookPath = join(hooksDir, "post-commit");
+    if (!existsSync(hookPath))
+        return;
+    const content = readFileSync(hookPath, "utf-8");
+    const briefedMarker = "# briefed: auto-update context";
+    if (!content.includes(briefedMarker))
+        return;
+    // Remove the briefed section
+    const lines = content.split("\n");
+    const filtered = [];
+    let inBriefedBlock = false;
+    for (const line of lines) {
+        if (line.includes(briefedMarker)) {
+            inBriefedBlock = true;
+            continue;
+        }
+        if (inBriefedBlock && (line.startsWith("#") || line.startsWith("(npx briefed"))) {
+            continue;
+        }
+        inBriefedBlock = false;
+        filtered.push(line);
+    }
+    const remaining = filtered.join("\n").trim();
+    if (remaining === "#!/bin/sh" || !remaining) {
+        // Hook is now empty — remove it
+        const { unlinkSync } = require("fs");
+        unlinkSync(hookPath);
+    }
+    else {
+        writeFileSync(hookPath, remaining + "\n");
+    }
+}
+//# sourceMappingURL=git-hook.js.map

package/dist/deliver/git-hook.js.map

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

package/dist/deliver/hooks.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Install briefed hooks into .claude/settings.json.
+ * Adds SessionStart (compact) and UserPromptSubmit hooks.
+ */
+export declare function installHooks(root: string): void;
+/**
+ * Generate the hook scripts that get executed by Claude Code.
+ */
+export declare function generateHookScripts(root: string): void;