preclaim 0.1.0

package/dist/hooks/post-tool-use.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+// PostToolUse hook — commit detection
+// Detects git commit commands and releases all session locks
+import { PreclaimClient, findConfig, loadCredentials } from '@preclaim/core';
+import { readHookInput } from '../lib/hook-io.js';
+async function main() {
+    try {
+        const input = await readHookInput();
+        // Only match Bash tool calls
+        if (input.tool_name !== 'Bash')
+            return;
+        const command = input.tool_input?.command;
+        if (!command)
+            return;
+        // Detect git commit (not amend, not just `git commit --help`)
+        const isCommit = /\bgit\s+commit\b/.test(command) && !/--help/.test(command);
+        if (!isCommit)
+            return;
+        const found = await findConfig();
+        if (!found)
+            return;
+        const creds = await loadCredentials();
+        if (!creds)
+            return;
+        const client = new PreclaimClient({
+            baseUrl: found.config.backend,
+            accessToken: creds.accessToken,
+            timeoutMs: 3000,
+        });
+        // Release all locks for this session
+        await client.releaseLocks({
+            project_id: found.config.projectId,
+            session_id: input.session_id,
+        });
+    }
+    catch {
+        // Silent fail — non-critical
+    }
+}
+main();
+//# sourceMappingURL=post-tool-use.js.map

package/dist/hooks/post-tool-use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool-use.js","sourceRoot":"","sources":["../../src/hooks/post-tool-use.ts"],"names":[],"mappings":";AACA,sCAAsC;AACtC,6DAA6D;AAE7D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;QAEpC,6BAA6B;QAC7B,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM;YAAE,OAAO;QAEvC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,OAA6B,CAAC;QAChE,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,KAAK,GAAG,MAAM,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YAChC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;YAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,MAAM,CAAC,YAAY,CAAC;YACxB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;YAClC,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/hooks/pre-tool-use.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=pre-tool-use.d.ts.map

package/dist/hooks/pre-tool-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool-use.d.ts","sourceRoot":"","sources":["../../src/hooks/pre-tool-use.ts"],"names":[],"mappings":""}

package/dist/hooks/pre-tool-use.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+// PreToolUse hook — the gatekeeper
+// Intercepts Edit/Write/MultiEdit tool calls, claims file locks
+import { PreclaimClient, findConfig, loadCredentials } from '@preclaim/core';
+import { readHookInput, writeHookOutput } from '../lib/hook-io.js';
+import { minimatch } from 'minimatch';
+const WRITE_TOOLS = new Set(['Edit', 'Write', 'MultiEdit']);
+async function main() {
+    try {
+        const input = await readHookInput();
+        // Only intercept file-writing tools
+        if (!input.tool_name || !WRITE_TOOLS.has(input.tool_name)) {
+            return; // No output = allow
+        }
+        // Extract file path from tool input
+        const filePath = input.tool_input?.file_path;
+        if (!filePath) {
+            return; // No file path = allow
+        }
+        // Load config
+        const found = await findConfig();
+        if (!found) {
+            return; // No config = allow (not a preclaim project)
+        }
+        // Check ignore patterns
+        const relativePath = filePath.startsWith('/') ? filePath : filePath;
+        if (found.config.ignore.some(pattern => minimatch(relativePath, pattern))) {
+            return; // Ignored file = allow
+        }
+        // Load credentials
+        const creds = await loadCredentials();
+        if (!creds) {
+            if (found.config.failOpen)
+                return;
+            writeHookOutput({
+                permissionDecision: 'deny',
+                reason: 'Preclaim: not authenticated. Run `preclaim login`.',
+            });
+            return;
+        }
+        // Claim file
+        const client = new PreclaimClient({
+            baseUrl: found.config.backend,
+            accessToken: creds.accessToken,
+            timeoutMs: 2000, // Must be fast
+        });
+        const result = await client.claimFile({
+            project_id: found.config.projectId,
+            file_path: relativePath,
+            session_id: input.session_id,
+            ttl_minutes: found.config.ttl,
+        });
+        // Network error — fail open
+        if (result.error) {
+            if (found.config.failOpen) {
+                writeHookOutput({
+                    permissionDecision: 'allow',
+                    systemMessage: `[Preclaim] Warning: could not reach server (${result.error}). Proceeding without lock.`,
+                });
+                return;
+            }
+            writeHookOutput({
+                permissionDecision: 'deny',
+                reason: `Preclaim: server error — ${result.error}`,
+            });
+            return;
+        }
+        const data = result.data;
+        if (data.status === 'acquired') {
+            writeHookOutput({
+                permissionDecision: 'allow',
+                systemMessage: `[Preclaim] Locked: ${relativePath} (expires: ${data.expires_at})`,
+            });
+        }
+        else if (data.status === 'already_held') {
+            writeHookOutput({
+                permissionDecision: 'allow',
+                systemMessage: `[Preclaim] Lock extended: ${relativePath} (expires: ${data.expires_at})`,
+            });
+        }
+        else if (data.status === 'conflict') {
+            writeHookOutput({
+                permissionDecision: 'deny',
+                reason: [
+                    `Preclaim: ${relativePath} is locked by another session.`,
+                    `  Session: ${data.holder.session_id.slice(0, 8)}…`,
+                    `  Since: ${new Date(data.holder.acquired_at).toLocaleTimeString()}`,
+                    `  Expires: ${new Date(data.holder.expires_at).toLocaleTimeString()}`,
+                    '',
+                    'Wait for the lock to expire or work on a different file.',
+                ].join('\n'),
+            });
+        }
+    }
+    catch {
+        // Fail open — never block development
+        return;
+    }
+}
+main();
+//# sourceMappingURL=pre-tool-use.js.map

package/dist/hooks/pre-tool-use.js.map

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

package/dist/hooks/session-start.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=session-start.d.ts.map

package/dist/hooks/session-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":""}

package/dist/hooks/session-start.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+// SessionStart hook — init
+// Registers session, starts heartbeat daemon, injects system message
+import { spawn } from 'node:child_process';
+import { writeFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PreclaimClient, findConfig, loadCredentials } from '@preclaim/core';
+import { readHookInput, writeHookOutput } from '../lib/hook-io.js';
+async function main() {
+    try {
+        const input = await readHookInput();
+        const found = await findConfig();
+        if (!found)
+            return;
+        const creds = await loadCredentials();
+        if (!creds) {
+            writeHookOutput({
+                systemMessage: '[Preclaim] Not authenticated. File locking disabled. Run `preclaim login` to enable.',
+            });
+            return;
+        }
+        const client = new PreclaimClient({
+            baseUrl: found.config.backend,
+            accessToken: creds.accessToken,
+            timeoutMs: 3000,
+        });
+        // Register session
+        const result = await client.registerSession({
+            session_id: input.session_id,
+            project_id: found.config.projectId,
+            provider: 'claude-code',
+        });
+        if (result.error) {
+            if (found.config.failOpen) {
+                writeHookOutput({
+                    systemMessage: `[Preclaim] Warning: could not register session (${result.error}). File locking may not work.`,
+                });
+                return;
+            }
+        }
+        // Start heartbeat daemon
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const heartbeatScript = join(__dirname, 'heartbeat-daemon.js');
+        const daemon = spawn('node', [heartbeatScript], {
+            detached: true,
+            stdio: 'ignore',
+            env: {
+                ...process.env,
+                PRECLAIM_SESSION_ID: input.session_id,
+                PRECLAIM_BACKEND: found.config.backend,
+                PRECLAIM_ACCESS_TOKEN: creds.accessToken,
+            },
+        });
+        daemon.unref();
+        // Save PID for cleanup
+        if (daemon.pid) {
+            await writeFile(join(process.cwd(), '.preclaim.pid'), String(daemon.pid));
+        }
+        writeHookOutput({
+            systemMessage: [
+                '[Preclaim] Session registered. File locking is active.',
+                '',
+                'Preclaim coordinates file access across multiple AI sessions:',
+                '- Files are automatically locked when you edit them',
+                '- Locks prevent other sessions from editing the same files',
+                '- Locks are released when you commit or this session ends',
+                '- If a lock is denied, work on a different file',
+            ].join('\n'),
+        });
+    }
+    catch {
+        // Fail open
+    }
+}
+main();
+//# sourceMappingURL=session-start.js.map

package/dist/hooks/session-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":";AACA,2BAA2B;AAC3B,qEAAqE;AAErE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEnE,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;QAEpC,MAAM,KAAK,GAAG,MAAM,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,eAAe,CAAC;gBACd,aAAa,EAAE,sFAAsF;aACtG,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YAChC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;YAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;YAC1C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;YAClC,QAAQ,EAAE,aAAa;SACxB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC1B,eAAe,CAAC;oBACd,aAAa,EAAE,mDAAmD,MAAM,CAAC,KAAK,+BAA+B;iBAC9G,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,eAAe,CAAC,EAAE;YAC9C,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;YACf,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,mBAAmB,EAAE,KAAK,CAAC,UAAU;gBACrC,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;gBACtC,qBAAqB,EAAE,KAAK,CAAC,WAAW;aACzC;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,EAAE,CAAC;QAEf,uBAAuB;QACvB,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,eAAe,CAAC;YACd,aAAa,EAAE;gBACb,wDAAwD;gBACxD,EAAE;gBACF,+DAA+D;gBAC/D,qDAAqD;gBACrD,4DAA4D;gBAC5D,2DAA2D;gBAC3D,iDAAiD;aAClD,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/hooks/stop.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=stop.d.ts.map

package/dist/hooks/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/hooks/stop.ts"],"names":[],"mappings":""}

package/dist/hooks/stop.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+// Stop hook — cleanup
+// Releases all locks and stops heartbeat daemon
+import { readFile, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { PreclaimClient, findConfig, loadCredentials } from '@preclaim/core';
+import { readHookInput } from '../lib/hook-io.js';
+async function main() {
+    try {
+        const input = await readHookInput();
+        const found = await findConfig();
+        if (!found)
+            return;
+        const creds = await loadCredentials();
+        if (!creds)
+            return;
+        const client = new PreclaimClient({
+            baseUrl: found.config.backend,
+            accessToken: creds.accessToken,
+            timeoutMs: 3000,
+        });
+        // End session (releases all locks)
+        await client.endSession(input.session_id);
+        // Kill heartbeat daemon if running
+        const pidFile = join(process.cwd(), '.preclaim.pid');
+        try {
+            const pid = parseInt(await readFile(pidFile, 'utf-8'), 10);
+            process.kill(pid, 'SIGTERM');
+            await unlink(pidFile);
+        }
+        catch {
+            // No daemon running or already stopped
+        }
+    }
+    catch {
+        // Silent fail — cleanup is best-effort
+    }
+}
+main();
+//# sourceMappingURL=stop.js.map

package/dist/hooks/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/hooks/stop.ts"],"names":[],"mappings":";AACA,sBAAsB;AACtB,gDAAgD;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;QAEpC,MAAM,KAAK,GAAG,MAAM,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YAChC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;YAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,mCAAmC;QACnC,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE1C,mCAAmC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC7B,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { loginCommand } from './commands/login.js';
+import { lockCommand } from './commands/lock.js';
+import { unlockCommand } from './commands/unlock.js';
+import { statusCommand } from './commands/status.js';
+import { checkCommand } from './commands/check.js';
+import { whoamiCommand } from './commands/whoami.js';
+import { configCommand } from './commands/config.js';
+import { installHooksCommand } from './commands/install-hooks.js';
+const program = new Command();
+program
+    .name('preclaim')
+    .description('AI File Coordination Layer — predictive file locking for AI coding agents')
+    .version('0.1.0');
+program
+    .command('init')
+    .description('Initialize Preclaim in the current project')
+    .option('--backend <url>', 'Backend URL', 'https://preclaim.vercel.app')
+    .option('--project-id <id>', 'Project ID')
+    .action(initCommand);
+program
+    .command('login')
+    .description('Authenticate with Preclaim')
+    .action(loginCommand);
+program
+    .command('lock <file>')
+    .description('Lock a file')
+    .option('-s, --session <id>', 'Session ID')
+    .option('-t, --ttl <minutes>', 'Lock TTL in minutes')
+    .action(lockCommand);
+program
+    .command('unlock [file]')
+    .description('Release a file lock')
+    .option('-s, --session <id>', 'Session ID')
+    .option('-a, --all', 'Release all locks for this session')
+    .action(unlockCommand);
+program
+    .command('status')
+    .description('Show active locks for this project')
+    .action(statusCommand);
+program
+    .command('check <files...>')
+    .description('Check lock status for files')
+    .action(checkCommand);
+program
+    .command('whoami')
+    .description('Show current user info')
+    .action(whoamiCommand);
+program
+    .command('config')
+    .description('View or modify project configuration')
+    .option('--get <key>', 'Get a config value')
+    .option('--set <key=value>', 'Set a config value')
+    .action(configCommand);
+program
+    .command('install-hooks')
+    .description('Install Claude Code hooks in the current project')
+    .action(installHooksCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,2EAA2E,CAAC;KACxF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,6BAA6B,CAAC;KACvE,MAAM,CAAC,mBAAmB,EAAE,YAAY,CAAC;KACzC,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,4BAA4B,CAAC;KACzC,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,aAAa,CAAC;KAC1B,MAAM,CAAC,oBAAoB,EAAE,YAAY,CAAC;KAC1C,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;KACpD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,oBAAoB,EAAE,YAAY,CAAC;KAC1C,MAAM,CAAC,WAAW,EAAE,oCAAoC,CAAC;KACzD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,wBAAwB,CAAC;KACrC,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,sCAAsC,CAAC;KACnD,MAAM,CAAC,aAAa,EAAE,oBAAoB,CAAC;KAC3C,MAAM,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;KACjD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/auth.d.ts

@@ -0,0 +1,3 @@
+import { type PreclaimCredentials } from '@preclaim/core';
+export declare function requireAuth(): Promise<PreclaimCredentials>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,wBAAsB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAchE"}

package/dist/lib/auth.js

@@ -0,0 +1,15 @@
+import { loadCredentials } from '@preclaim/core';
+export async function requireAuth() {
+    const creds = await loadCredentials();
+    if (!creds) {
+        console.error('Not logged in. Run `preclaim login` first.');
+        process.exit(1);
+    }
+    // Check expiry
+    if (new Date(creds.expiresAt) < new Date()) {
+        console.error('Session expired. Run `preclaim login` to re-authenticate.');
+        process.exit(1);
+    }
+    return creds;
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA4B,MAAM,gBAAgB,CAAC;AAE3E,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,eAAe;IACf,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/client-factory.d.ts

@@ -0,0 +1,8 @@
+import { PreclaimClient, type PreclaimConfig, type PreclaimCredentials } from '@preclaim/core';
+export interface ResolvedContext {
+    client: PreclaimClient;
+    config: PreclaimConfig;
+    credentials: PreclaimCredentials;
+}
+export declare function resolveContext(): Promise<ResolvedContext>;
+//# sourceMappingURL=client-factory.d.ts.map

package/dist/lib/client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.d.ts","sourceRoot":"","sources":["../../src/lib/client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAc,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG3G,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,eAAe,CAAC,CAgB/D"}

package/dist/lib/client-factory.js

@@ -0,0 +1,17 @@
+import { PreclaimClient, findConfig } from '@preclaim/core';
+import { requireAuth } from './auth.js';
+export async function resolveContext() {
+    const credentials = await requireAuth();
+    const found = await findConfig();
+    if (!found) {
+        console.error('No .preclaim.json found. Run `preclaim init` in your project root.');
+        process.exit(1);
+    }
+    const client = new PreclaimClient({
+        baseUrl: found.config.backend,
+        accessToken: credentials.accessToken,
+        timeoutMs: 5000,
+    });
+    return { client, config: found.config, credentials };
+}
+//# sourceMappingURL=client-factory.js.map

package/dist/lib/client-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.js","sourceRoot":"","sources":["../../src/lib/client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAiD,MAAM,gBAAgB,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQxC,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,WAAW,GAAG,MAAM,WAAW,EAAE,CAAC;IAExC,MAAM,KAAK,GAAG,MAAM,UAAU,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;QAC7B,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;AACvD,CAAC"}

package/dist/lib/hook-io.d.ts

@@ -0,0 +1,13 @@
+export interface ClaudeHookInput {
+    session_id: string;
+    tool_name?: string;
+    tool_input?: Record<string, unknown>;
+}
+export interface ClaudeHookOutput {
+    permissionDecision?: 'allow' | 'deny';
+    reason?: string;
+    systemMessage?: string;
+}
+export declare function readHookInput(): Promise<ClaudeHookInput>;
+export declare function writeHookOutput(output: ClaudeHookOutput): void;
+//# sourceMappingURL=hook-io.d.ts.map

package/dist/lib/hook-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-io.d.ts","sourceRoot":"","sources":["../../src/lib/hook-io.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAiB9D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE9D"}

package/dist/lib/hook-io.js

@@ -0,0 +1,24 @@
+// Hook I/O helpers for Claude Code hooks
+// Reads hook input from stdin and writes hook output to stdout
+export async function readHookInput() {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('data', (chunk) => { data += chunk; });
+        process.stdin.on('end', () => {
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                reject(new Error('Failed to parse hook input'));
+            }
+        });
+        process.stdin.on('error', reject);
+        // Timeout after 3s
+        setTimeout(() => reject(new Error('Hook input timeout')), 3000);
+    });
+}
+export function writeHookOutput(output) {
+    process.stdout.write(JSON.stringify(output));
+}
+//# sourceMappingURL=hook-io.js.map

package/dist/lib/hook-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-io.js","sourceRoot":"","sources":["../../src/lib/hook-io.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,+DAA+D;AAc/D,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAElC,mBAAmB;QACnB,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,4 @@
+import type { Lock } from '@preclaim/core';
+export declare function formatLock(lock: Lock): string;
+export declare function formatLockTable(locks: Lock[]): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAI7C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAWrD"}

package/dist/lib/output.js

@@ -0,0 +1,17 @@
+export function formatLock(lock) {
+    const acquired = new Date(lock.acquired_at).toLocaleTimeString();
+    const expires = new Date(lock.expires_at).toLocaleTimeString();
+    return `  ${lock.file_path}  (session: ${lock.session_id.slice(0, 8)}…  acquired: ${acquired}  expires: ${expires})`;
+}
+export function formatLockTable(locks) {
+    if (locks.length === 0) {
+        return 'No active locks.';
+    }
+    const lines = ['Active locks:', ''];
+    for (const lock of locks) {
+        lines.push(formatLock(lock));
+    }
+    lines.push('', `Total: ${locks.length} lock(s)`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC/D,OAAO,KAAK,IAAI,CAAC,SAAS,eAAe,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,gBAAgB,QAAQ,cAAc,OAAO,GAAG,CAAC;AACvH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,CAAC,MAAM,UAAU,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "preclaim",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "preclaim": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@preclaim/core": "workspace:*",
+    "commander": "^13.1.0",
+    "minimatch": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  }
+}

package/src/commands/check.ts

@@ -0,0 +1,28 @@
+import { resolveContext } from '../lib/client-factory.js';
+
+export async function checkCommand(filePaths: string[]) {
+  if (filePaths.length === 0) {
+    console.error('Specify one or more file paths to check.');
+    process.exit(1);
+  }
+
+  const { client, config } = await resolveContext();
+
+  const result = await client.batchCheck({
+    project_id: config.projectId,
+    file_paths: filePaths,
+  });
+
+  if (result.error) {
+    console.error(`Failed to check: ${result.error}`);
+    process.exit(1);
+  }
+
+  for (const [path, lock] of Object.entries(result.data!.locks)) {
+    if (lock) {
+      console.log(`LOCKED  ${path}  (session: ${lock.session_id.slice(0, 8)}…  expires: ${new Date(lock.expires_at).toLocaleTimeString()})`);
+    } else {
+      console.log(`FREE    ${path}`);
+    }
+  }
+}

package/src/commands/config.ts

@@ -0,0 +1,43 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { findConfig, type PreclaimConfig } from '@preclaim/core';
+
+export async function configCommand(opts: { get?: string; set?: string }) {
+  const found = await findConfig();
+  if (!found) {
+    console.error('No .preclaim.json found. Run `preclaim init` first.');
+    process.exit(1);
+  }
+
+  if (opts.get) {
+    const value = found.config[opts.get as keyof PreclaimConfig];
+    console.log(JSON.stringify(value, null, 2));
+    return;
+  }
+
+  if (opts.set) {
+    const [key, ...rest] = opts.set.split('=');
+    const value = rest.join('=');
+
+    if (!key || !value) {
+      console.error('Usage: preclaim config --set key=value');
+      process.exit(1);
+    }
+
+    const raw = await readFile(found.configPath, 'utf-8');
+    const config = JSON.parse(raw) as Record<string, unknown>;
+
+    // Try to parse as JSON, fallback to string
+    try {
+      config[key] = JSON.parse(value);
+    } catch {
+      config[key] = value;
+    }
+
+    await writeFile(found.configPath, JSON.stringify(config, null, 2) + '\n');
+    console.log(`Set ${key} = ${JSON.stringify(config[key])}`);
+    return;
+  }
+
+  // No flags — show full config
+  console.log(JSON.stringify(found.config, null, 2));
+}