brainclaw 0.28.0 → 1.5.3

package/dist/commands/hooks.js

@@ -16,23 +16,26 @@ alwaysApply: true
 
 # Brainclaw session bootstrap
 
-**At the start of every session, before doing anything else:**
+Brainclaw is the shared coordination layer for this project. Use its MCP facades first — the CLI is only a fallback when MCP is unavailable.
 
-\`\`\`bash
-brainclaw context
-\`\`\`
+## At the start of every session
 
-This loads the shared project memory: active constraints, recent decisions, known traps,
-open plan items, active claims, and the last handoff.
+Call \`bclaw_work(intent)\` — it handles session setup, context load, and scope claim in a single call.
 
-**Before finishing any session:**
+- \`bclaw_work(intent: "resume")\` when continuing an existing task.
+- \`bclaw_work(intent: "execute", scope: "<path>", task: "<text>")\` when starting new work on a specific scope.
+- \`bclaw_work(intent: "consult")\` to read context without claiming.
 
-\`\`\`bash
-brainclaw claim release <id>               # release claims you opened
-brainclaw plan update <id> --status done   # close plan items you completed
-# or in one shot:
-brainclaw session-end --auto-release
-\`\`\`
+## To coordinate with other agents
+
+\`bclaw_coordinate(intent)\` — \`assign\`, \`consult\`, \`review\`, or \`reroute\`.
+
+## Before finishing
+
+- Release your claims: \`bclaw_release_claim(id)\`.
+- Close out the session: \`bclaw_session_end\` (or let it auto-release via the session hook).
+
+CLI fallback only: \`brainclaw context\` / \`brainclaw session-end --auto-release\` if MCP is not reachable.
 `;
 }
 /**
@@ -46,23 +49,53 @@ export function generateWindsurfHook(projectName) {
 
 ## SESSION START (always run first)
 
-Before responding to any request, execute:
+Call the Brainclaw MCP facade before responding to any request:
 
-\`\`\`bash
-brainclaw context
-\`\`\`
+- \`bclaw_work(intent: "resume")\` when continuing an existing task.
+- \`bclaw_work(intent: "execute", scope: "<path>", task: "<text>")\` when starting new work on a specific scope.
+- \`bclaw_work(intent: "consult")\` to read context without claiming.
 
-This gives you: active constraints, recent decisions, known traps, open plans, active claims,
-and the last handoff note. Do not skip this step.
+This returns active constraints, recent decisions, known traps, open plans, active claims, and the last handoff. Do not skip.
+
+## COORDINATION
+
+\`bclaw_coordinate(intent)\` to assign, consult, review, or reroute other agents.
 
 ## SESSION END (before finishing)
 
-\`\`\`bash
-brainclaw claim release <id>               # for each claim you hold
-brainclaw plan update <id> --status done   # for each plan item you completed
-# or:
-brainclaw session-end --auto-release
-\`\`\`
+- \`bclaw_release_claim(id)\` for each claim you hold.
+- \`bclaw_session_end\` to close the session (auto-releases remaining claims).
+
+CLI fallback only when MCP is unavailable: \`brainclaw context\` / \`brainclaw session-end --auto-release\`.
+`;
+}
+/**
+ * Generate a generic markdown session-trigger section.
+ */
+export function generateMarkdownHook(agentName, projectName) {
+    return `# Brainclaw session trigger — ${projectName}
+# This block is always active. ${agentName} reads this file on every activation.
+
+## SESSION START (always run first)
+
+Call the Brainclaw MCP facade before responding to any request:
+
+- \`bclaw_work(intent: "resume")\` when continuing an existing task.
+- \`bclaw_work(intent: "execute", scope: "<path>", task: "<text>")\` when starting new work on a specific scope.
+- \`bclaw_work(intent: "consult")\` to read context without claiming.
+
+This returns active constraints, recent decisions, known traps, open plans, active claims, and the last handoff. Do not skip.
+
+## COORDINATION
+
+\`bclaw_coordinate(intent)\` to assign, consult, review, or reroute other agents.
+
+## SESSION END (before finishing)
+
+- \`bclaw_release_claim(id)\` for each claim you hold.
+- \`bclaw_session_end\` to close the session (auto-releases remaining claims).
+
+CLI fallback only when MCP is unavailable: \`brainclaw context\` / \`brainclaw session-end --auto-release\`.
 `;
 }
 export function writeHook(content, relativePath, cwd) {
@@ -108,6 +141,18 @@ export function runHooks(options = {}) {
             created: autoResult.created,
         });
     }
+    if (target === 'cline' || target === 'all') {
+        const content = generateMarkdownHook('Cline', config.project_name);
+        results.push(writeHook(content, '.clinerules/brainclaw.md', cwd));
+    }
+    if (target === 'codex' || target === 'all') {
+        const content = generateMarkdownHook('Codex', config.project_name);
+        results.push(writeHook(content, 'AGENTS.md', cwd));
+    }
+    if (target === 'github-copilot' || target === 'all') {
+        const content = generateMarkdownHook('GitHub Copilot', config.project_name);
+        results.push(writeHook(content, '.github/copilot-instructions.md', cwd));
+    }
     for (const r of results) {
         console.log(`✔ Hook written to ${r.relativePath} (${r.created ? 'created' : 'updated'})`);
     }
@@ -134,6 +179,18 @@ export function writeDetectedAgentHooks(agentName, projectName, cwd) {
             created: autoResult.created,
         });
     }
+    if (agentName === 'cline') {
+        const content = generateMarkdownHook('Cline', projectName);
+        results.push(writeHook(content, '.clinerules/brainclaw.md', cwd));
+    }
+    if (agentName === 'codex') {
+        const content = generateMarkdownHook('Codex', projectName);
+        results.push(writeHook(content, 'AGENTS.md', cwd));
+    }
+    if (agentName === 'github-copilot') {
+        const content = generateMarkdownHook('GitHub Copilot', projectName);
+        results.push(writeHook(content, '.github/copilot-instructions.md', cwd));
+    }
     return results;
 }
 //# sourceMappingURL=hooks.js.map

package/dist/commands/inbox.js

@@ -0,0 +1,169 @@
+/**
+ * CLI command: brainclaw inbox
+ *
+ * Subcommands:
+ *   brainclaw inbox                — list pending messages
+ *   brainclaw inbox --all          — list all messages
+ *   brainclaw inbox ack <id>       — acknowledge a message
+ *   brainclaw inbox send <to> <text> — send a message
+ *
+ * @module
+ */
+import { memoryExists } from '../core/io.js';
+import { readInbox, ackMessage, archiveMessage, sendMessage, getThread } from '../core/messaging.js';
+import { resolveCurrentAgentName } from '../core/agent-registry.js';
+import { resolveStoreChain } from '../core/store-resolution.js';
+export function runInboxList(options) {
+    const cwd = options.cwd;
+    if (!memoryExists(cwd)) {
+        console.error('Error: .brainclaw/ not found. Run `brainclaw init` first.');
+        process.exit(1);
+    }
+    const effectiveCwd = cwd ?? process.cwd();
+    const agent = options.agent ?? resolveCurrentAgentName(effectiveCwd) ?? 'unknown';
+    const status = options.all ? undefined : options.status ?? 'pending';
+    const msgType = options.type;
+    const threadId = options.thread;
+    let messages;
+    if (options.localOnly) {
+        const result = readInbox({ agent, status, type: msgType, thread_id: threadId, markAsRead: false }, effectiveCwd);
+        messages = result.messages;
+    }
+    else {
+        const chain = resolveStoreChain(effectiveCwd);
+        const seenIds = new Set();
+        messages = [];
+        for (const store of chain) {
+            try {
+                // Fetch all messages from this store (no pagination limit)
+                const storeResult = readInbox({ agent, status, type: msgType, thread_id: threadId, markAsRead: false, limit: 1_000_000 }, store.cwd);
+                for (const msg of storeResult.messages) {
+                    if (!seenIds.has(msg.id)) {
+                        seenIds.add(msg.id);
+                        messages.push(msg);
+                    }
+                }
+            }
+            catch { /* skip unreadable stores */ }
+        }
+        // Fallback when no chain found
+        if (messages.length === 0 && chain.length === 0) {
+            const result = readInbox({ agent, status, type: msgType, thread_id: threadId, markAsRead: false }, effectiveCwd);
+            messages = result.messages;
+        }
+    }
+    const total = messages.length;
+    if (options.json) {
+        console.log(JSON.stringify({ total, offset: 0, limit: total, messages }, null, 2));
+        return;
+    }
+    const label = status ? `${status} messages` : 'all messages';
+    console.log(`\n📬 Inbox for ${agent} — ${total} ${label}\n`);
+    if (messages.length === 0) {
+        console.log('  (no messages)');
+    }
+    for (const msg of messages) {
+        const ack = msg.requires_ack ? ' [ACK required]' : '';
+        const thread = msg.thread_id ? ` thread:${msg.thread_id}` : '';
+        const ref = msg.ref ? ` ref:${msg.ref}` : '';
+        console.log(`  [${msg.short_label ?? msg.id}] ${msg.type} from ${msg.from} (${msg.status})${ack}${thread}${ref}`);
+        console.log(`    ${msg.text.slice(0, 120)}${msg.text.length > 120 ? '...' : ''}`);
+        console.log('');
+    }
+}
+export function runInboxAck(messageId, options) {
+    const cwd = options.cwd;
+    if (!memoryExists(cwd)) {
+        console.error('Error: .brainclaw/ not found. Run `brainclaw init` first.');
+        process.exit(1);
+    }
+    const effectiveCwd = cwd ?? process.cwd();
+    const agent = options.agent ?? resolveCurrentAgentName(effectiveCwd) ?? 'unknown';
+    try {
+        const result = ackMessage(messageId, agent, effectiveCwd);
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log(`✔ Message acknowledged: [${result.id}]`);
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+export function runInboxArchive(messageId, options) {
+    const cwd = options.cwd;
+    if (!memoryExists(cwd)) {
+        console.error('Error: .brainclaw/ not found. Run `brainclaw init` first.');
+        process.exit(1);
+    }
+    const effectiveCwd = cwd ?? process.cwd();
+    const agent = options.agent ?? resolveCurrentAgentName(effectiveCwd) ?? 'unknown';
+    try {
+        const result = archiveMessage(messageId, agent, effectiveCwd);
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log(`✔ Message archived: [${result.id}]`);
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+export function runInboxSend(to, text, options) {
+    const cwd = options.cwd;
+    if (!memoryExists(cwd)) {
+        console.error('Error: .brainclaw/ not found. Run `brainclaw init` first.');
+        process.exit(1);
+    }
+    const effectiveCwd = cwd ?? process.cwd();
+    const from = options.agent ?? resolveCurrentAgentName(effectiveCwd) ?? 'unknown';
+    const msgType = (options.type ?? 'info');
+    try {
+        const result = sendMessage({
+            from,
+            to,
+            type: msgType,
+            text,
+            ref: options.ref,
+            scope: options.scope,
+            thread_id: options.thread,
+            requires_ack: options.ack,
+        }, effectiveCwd);
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log(`✔ Message sent: [${result.shortLabel}] ${result.type} → ${result.to}`);
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+export function runInboxThread(threadId, options) {
+    const cwd = options.cwd;
+    if (!memoryExists(cwd)) {
+        console.error('Error: .brainclaw/ not found. Run `brainclaw init` first.');
+        process.exit(1);
+    }
+    const effectiveCwd = cwd ?? process.cwd();
+    const messages = getThread(threadId, effectiveCwd);
+    if (options.json) {
+        console.log(JSON.stringify({ thread_id: threadId, total: messages.length, messages }, null, 2));
+        return;
+    }
+    console.log(`\nThread ${threadId} — ${messages.length} message(s)\n`);
+    for (const msg of messages) {
+        console.log(`  [${msg.short_label ?? msg.id}] ${msg.from} → ${msg.to} (${msg.type}, ${msg.status})`);
+        console.log(`    ${msg.text.slice(0, 120)}${msg.text.length > 120 ? '...' : ''}`);
+        console.log('');
+    }
+}
+//# sourceMappingURL=inbox.js.map

package/dist/commands/init.js

@@ -12,7 +12,7 @@ import { scanProject, upsertProject } from '../core/global-registry.js';
 import { analyzeRepository, scanWorkspaceBoundaries } from '../core/repo-analysis.js';
 import { renderBootstrapSummary, runBootstrapProfile } from '../core/bootstrap.js';
 import { isAgentIntegrationName, upsertAgentIntegrationDeclaration } from '../core/agent-integrations.js';
-import { describeAutoConfigWrite, ensureAgentFiles, ensureGitignoreEntries, writeDetectedAgentAutoConfig } from '../core/agent-files.js';
+import { BRAINCLAW_EXCLUSIVE_DIRECTORIES, describeAutoConfigWrite, ensureAgentFiles, ensureGitignoreEntries, writeDetectedAgentAutoConfig } from '../core/agent-files.js';
 import { detectAiAgent, detectWslEnvironment } from '../core/ai-agent-detection.js';
 import { buildAiSurfaceInventory, renderAiSurfaceUsageHints } from '../core/ai-surface-inventory.js';
 import { ensureUserStore, hasCompletedSetup } from '../core/setup-state.js';
@@ -61,6 +61,8 @@ export async function runInit(options = {}) {
     const topology = resolveTopology(options.topology);
     const ignoreStrategy = topology === 'embedded' ? 'none' : 'project-gitignore';
     const skipAgentBootstrap = options.skipAgentBootstrap === true || process.env.BRAINCLAW_SKIP_AGENT_BOOTSTRAP === '1';
+    const testMode = process.env.BRAINCLAW_TEST_MODE === '1';
+    const skipAiSurfaceScan = testMode || options.noAiScan === true || options.aiScan === false;
     if (memoryExists(cwd) && !options.force) {
         console.error('Error: project memory already exists. Use --force to overwrite.');
         process.exit(1);
@@ -165,10 +167,11 @@ export async function runInit(options = {}) {
     // Add agent instruction files to .gitignore (they are generated, not source)
     if (!skipAgentBootstrap) {
         const generatedWorkspacePaths = detectedAutoConfig
+            .filter((item) => item.kind !== 'recommendation')
             .map((item) => item.relativePath)
             .filter((item) => item !== undefined)
             .filter((item) => !item.startsWith('.codeium/'));
-        ensureGitignoreEntries(cwd, ['AGENTS.md', '.github/copilot-instructions.md', ...generatedWorkspacePaths]);
+        ensureGitignoreEntries(cwd, ['AGENTS.md', '.github/copilot-instructions.md', ...generatedWorkspacePaths, ...BRAINCLAW_EXCLUSIVE_DIRECTORIES]);
     }
     console.log(`✔ Initialized project memory in ${storageDir}/`);
     console.log('✔ Created project.md, config.yaml, and split state directories');
@@ -180,17 +183,19 @@ export async function runInit(options = {}) {
     if (detectedExport) {
         console.log(`\u2714 Agent instructions written to ${detectedExport.relativePath} (${detectedExport.created ? 'created' : 'updated'})`);
     }
-    const visibleSurfaces = buildAiSurfaceInventory().filter((surface) => surface.status !== 'not_detected');
-    if (visibleSurfaces.length > 0) {
-        console.log('✔ Other AI work surfaces detected on this machine:');
-        for (const surface of visibleSurfaces) {
-            console.log(`  - ${surface.display_name} [${surface.surface_kind}, ${surface.status}]`);
-        }
-        const usageHints = renderAiSurfaceUsageHints(visibleSurfaces);
-        if (usageHints.length > 0) {
-            console.log('  Suggested uses:');
-            for (const line of usageHints) {
-                console.log(`    ${line}`);
+    if (!skipAiSurfaceScan) {
+        const visibleSurfaces = buildAiSurfaceInventory().filter((surface) => surface.status !== 'not_detected');
+        if (visibleSurfaces.length > 0) {
+            console.log('✔ Other AI work surfaces detected on this machine:');
+            for (const surface of visibleSurfaces) {
+                console.log(`  - ${surface.display_name} [${surface.surface_kind}, ${surface.status}]`);
+            }
+            const usageHints = renderAiSurfaceUsageHints(visibleSurfaces);
+            if (usageHints.length > 0) {
+                console.log('  Suggested uses:');
+                for (const line of usageHints) {
+                    console.log(`    ${line}`);
+                }
             }
         }
     }
@@ -247,25 +252,27 @@ export async function runInit(options = {}) {
     }
     // Install post-merge hook for auto-release of claims after merge
     installPostMergeHookIfMissing(cwd);
-    const onboardingPreflight = runBootstrapProfile({ cwd, refresh: true });
-    console.log('');
-    console.log('Onboarding preflight:');
-    for (const line of renderBootstrapSummary(onboardingPreflight).split('\n')) {
-        console.log(`  ${line}`);
-    }
-    if (onboardingPreflight.importPlan.suggestion_count > 0) {
-        console.log('');
-        console.log(`Next step: run 'brainclaw bootstrap --apply' to import ${onboardingPreflight.importPlan.suggestion_count} suggested item(s) into canonical memory.`);
-        console.log(`Rollback: run 'brainclaw bootstrap --uninstall' to deactivate the last bootstrap-managed import.`);
-    }
-    if ((onboardingPreflight.importPlan.interview?.question_count ?? 0) > 0) {
-        console.log('');
-        console.log(`Interview: run 'brainclaw bootstrap --interview --audience cli' for terminal agents or '--audience ide_chat' for IDE chat agents.`);
-        console.log(`Apply confirmed answers: write a JSON answers file and run 'brainclaw bootstrap --answers-file <path> --apply'.`);
-    }
-    else if ((onboardingPreflight.profile.gaps?.length ?? 0) > 0) {
+    if (!testMode) {
+        const onboardingPreflight = runBootstrapProfile({ cwd, refresh: true });
         console.log('');
-        console.log(`Next step: review the onboarding gaps, then use 'brainclaw bootstrap --json' as the basis for an interview/import flow.`);
+        console.log('Onboarding preflight:');
+        for (const line of renderBootstrapSummary(onboardingPreflight).split('\n')) {
+            console.log(`  ${line}`);
+        }
+        if (onboardingPreflight.importPlan.suggestion_count > 0) {
+            console.log('');
+            console.log(`Next step: run 'brainclaw bootstrap --apply' to import ${onboardingPreflight.importPlan.suggestion_count} suggested item(s) into canonical memory.`);
+            console.log(`Rollback: run 'brainclaw bootstrap --uninstall' to deactivate the last bootstrap-managed import.`);
+        }
+        if ((onboardingPreflight.importPlan.interview?.question_count ?? 0) > 0) {
+            console.log('');
+            console.log(`Interview: run 'brainclaw bootstrap --interview --audience cli' for terminal agents or '--audience ide_chat' for IDE chat agents.`);
+            console.log(`Apply confirmed answers: write a JSON answers file and run 'brainclaw bootstrap --answers-file <path> --apply'.`);
+        }
+        else if ((onboardingPreflight.profile.gaps?.length ?? 0) > 0) {
+            console.log('');
+            console.log(`Next step: review the onboarding gaps, then use 'brainclaw bootstrap --json' as the basis for an interview/import flow.`);
+        }
     }
     console.log('');
     console.log(`Tip: run 'brainclaw context --json' to load the shared memory into your agent session.`);

package/dist/commands/install-hooks.js

@@ -31,6 +31,54 @@ export function runInstallHooks(options = {}) {
         console.log(`✔ post-merge hook installed at ${postMergePath}`);
         console.log('  Auto-releases claims whose scope was touched by the merge.');
     }
+    // Claude Code preToolUse hook (claim-warning)
+    const claudeHookPath = path.join(hooksDir, 'claude-pre-tool.sh');
+    if (!fs.existsSync(claudeHookPath) || options.force) {
+        fs.writeFileSync(claudeHookPath, generateClaudePreToolScript(), { encoding: 'utf-8', mode: 0o755 });
+        console.log(`✔ Claude Code preToolUse hook generated at ${claudeHookPath}`);
+        console.log('  To activate, add to .claude/settings.json hooks: { "PreToolUse": ".git/hooks/claude-pre-tool.sh" }');
+    }
+}
+function generateClaudePreToolScript() {
+    return `#!/bin/sh
+# brainclaw Claude Code preToolUse hook
+# Generated by: brainclaw install-hooks
+exec node -e "
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const toolName = process.env.CLAUDE_TOOL_NAME || process.argv[2] || process.env.TOOL_NAME || '';
+const isWrite = /edit|write|replace|bash|str_replace/i.test(toolName);
+
+if (!isWrite || !toolName) process.exit(0);
+
+try {
+  const BCLAW_CMD = fs.existsSync(path.join(process.cwd(), 'node_modules', '.bin', 'brainclaw')) 
+    ? 'npx brainclaw' : 'brainclaw';
+  const out = execSync(BCLAW_CMD + ' claim list --json', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] });
+  const claims = JSON.parse(out);
+  if (claims && claims.length > 0) process.exit(0);
+} catch (e) {
+  // ignore if brainclaw not found or fails
+  process.exit(0);
+}
+
+const sessionMark = path.join(process.cwd(), '.brainclaw', 'tmp', 'claude_warned');
+if (!fs.existsSync(path.dirname(sessionMark))) fs.mkdirSync(path.dirname(sessionMark), { recursive: true });
+
+if (fs.existsSync(sessionMark)) {
+  const mtime = fs.statSync(sessionMark).mtimeMs;
+  if (Date.now() - mtime < 2 * 60 * 60 * 1000) {
+    process.exit(0); // already warned this session
+  }
+}
+fs.writeFileSync(sessionMark, Date.now().toString());
+
+process.stderr.write('\\n[Brainclaw] ⚠️  WARNING: You are about to use an Edit/Write tool (' + toolName + ') but you have NO active claim.\\n');
+process.stderr.write('[Brainclaw] Consider running \\\`brainclaw claim create <scope>\\\` to lock your work and avoid conflicts.\\n\\n');
+" 2>&1 || exit 0
+`;
 }
 function generatePostMergeScript() {
     return `#!/bin/sh
@@ -48,6 +96,7 @@ else
 fi
 
 $BCLAW_CMD release-claims --from-git-diff 2>/dev/null || true
+$BCLAW_CMD worktree clean 2>/dev/null || true
 `;
 }
 function findGitRoot(cwd) {
@@ -62,54 +111,32 @@ function findGitRoot(cwd) {
     }
 }
 function generateHookScript() {
+    // Use node directly to avoid sh.exe pipe issues on Windows (SIGPIPE).
+    // The script is a self-contained node -e that runs both checks.
     return `#!/bin/sh
-# brainclaw pre-commit hook
-# 1. Blocks commits if sensitive content is detected in .brainclaw/
-# 2. Blocks commits if staged files are covered by an active constraint
-# Generated by: brainclaw install-hooks
+# brainclaw pre-commit hook — generated by brainclaw install-hooks
+# Runs via node to avoid sh.exe SIGPIPE issues on Windows.
+exec node -e "
+const { execSync } = require('child_process');
+const staged = execSync('git diff --cached --name-only', { encoding: 'utf-8' }).trim();
+if (!staged) process.exit(0);
 
-if ! command -v node >/dev/null 2>&1; then
-  echo "brainclaw hook: node not found, skipping check."
-  exit 0
-fi
-
-BCLAW_CMD=""
-if command -v brainclaw >/dev/null 2>&1; then
-  BCLAW_CMD="brainclaw"
-elif command -v bclaw >/dev/null 2>&1; then
-  BCLAW_CMD="bclaw"
-else
-  BCLAW_CMD="npx --no brainclaw"
-fi
-
-# Check 1: sensitive content in .brainclaw/
-RESULT=$($BCLAW_CMD doctor --json 2>/dev/null) || {
-  echo "brainclaw hook: could not run doctor check, skipping."
-  exit 0
+// Check 1: reject staged .brainclaw/ files
+const brainclawFiles = staged.split('\\\\n').filter(f => f.startsWith('.brainclaw/'));
+if (brainclawFiles.length > 0) {
+  process.stderr.write('\\\\nbrainclaw: .brainclaw/ files are staged — blocked.\\\\n');
+  brainclawFiles.forEach(f => process.stderr.write('  ' + f + '\\\\n'));
+  process.stderr.write('  Fix: git reset HEAD .brainclaw/\\\\n\\\\n');
+  process.exit(1);
 }
 
-echo "$RESULT" | node -e "
-const chunks = [];
-process.stdin.on('data', d => chunks.push(d));
-process.stdin.on('end', () => {
-  try {
-    const data = JSON.parse(chunks.join(''));
-    const issues = (data.checks || []).filter(c =>
-      (c.name === 'state_security' || c.name === 'candidate_security') &&
-      c.status !== 'ok'
-    );
-    if (issues.length > 0) {
-      process.stderr.write('\\nbrainclaw: sensitive content in .brainclaw/ — commit blocked.\\n');
-      issues.forEach(c => process.stderr.write('  ⚠  ' + c.message + '\\n'));
-      process.stderr.write('  Fix: review with \`brainclaw doctor\`\\n\\n');
-      process.exit(1);
-    }
-  } catch (_) { /* skip parse errors */ }
-});
-" || exit 1
-
-# Check 2: active constraint violations on staged files
-$BCLAW_CMD check-constraints --staged 2>&1 || exit 1
+// Check 2: active constraint violations
+try {
+  execSync('brainclaw check-constraints --staged', { stdio: 'inherit' });
+} catch (e) {
+  if (e.status) process.exit(e.status);
+}
+" 2>&1 || exit $?
 `;
 }
 //# sourceMappingURL=install-hooks.js.map

package/dist/commands/link.js

@@ -0,0 +1,89 @@
+import { requireInitialized } from '../core/guards.js';
+import { resolveTargetStore } from '../core/store-resolution.js';
+import { addCrossProjectLink, removeCrossProjectLink, resolveCrossProjectLinks, } from '../core/cross-project.js';
+export function runLink(subcommand, args, options = {}) {
+    const cwd = resolveTargetStore(options.cwd ?? process.cwd(), options.store ?? 'local');
+    requireInitialized(cwd);
+    switch (subcommand) {
+        case 'add': {
+            const target = args[0];
+            if (!target) {
+                console.error('Error: link add requires <path>');
+                console.error('Usage: brainclaw link add <path> [--name <slug>] [--role publisher|subscriber] [--channels candidate,handoff,runtime_note] [--force]');
+                process.exit(1);
+            }
+            try {
+                const link = addCrossProjectLink({
+                    path: target,
+                    name: options.name,
+                    role: options.role,
+                    channels: options.channels,
+                    force: options.force,
+                    cwd,
+                });
+                if (options.json) {
+                    console.log(JSON.stringify(link, null, 2));
+                }
+                else {
+                    console.log(`✔ Linked '${link.name ?? link.path}' (path=${link.path}, role=${link.role}${link.channels?.length ? `, channels=${link.channels.join(',')}` : ''})`);
+                }
+            }
+            catch (err) {
+                console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+                process.exit(1);
+            }
+            break;
+        }
+        case 'list':
+        case 'ls': {
+            const links = resolveCrossProjectLinks(cwd);
+            if (options.json) {
+                console.log(JSON.stringify(links, null, 2));
+                return;
+            }
+            if (links.length === 0) {
+                console.log('No cross-project links configured.');
+                console.log('Add one with: brainclaw link add <path> [--role publisher|subscriber]');
+                return;
+            }
+            console.log(`\n${links.length} cross-project link(s):\n`);
+            for (const link of links) {
+                const availability = link.available ? '✓' : '✗ (target not initialised)';
+                const channels = link.channels?.length ? ` [${link.channels.join(',')}]` : '';
+                console.log(`  ${link.projectName}  ${availability}`);
+                console.log(`      path:  ${link.path}`);
+                console.log(`      abs:   ${link.absolutePath}`);
+                console.log(`      role:  ${link.role}${channels}`);
+            }
+            console.log('');
+            break;
+        }
+        case 'remove':
+        case 'rm': {
+            const target = args[0];
+            if (!target) {
+                console.error('Error: link remove requires <name|path>');
+                process.exit(1);
+            }
+            try {
+                const removed = removeCrossProjectLink(target, cwd);
+                if (options.json) {
+                    console.log(JSON.stringify(removed, null, 2));
+                }
+                else {
+                    console.log(`✔ Removed cross-project link '${removed.name ?? removed.path}'`);
+                }
+            }
+            catch (err) {
+                console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+                process.exit(1);
+            }
+            break;
+        }
+        default:
+            console.error(`Unknown link subcommand: ${subcommand}`);
+            console.error('Usage: brainclaw link <add|list|remove> ...');
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=link.js.map