preclaim 0.1.0

package/src/hooks/stop.ts

@@ -0,0 +1,43 @@
+#!/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();

package/src/index.ts

@@ -0,0 +1,74 @@
+#!/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();

package/src/lib/auth.ts

@@ -0,0 +1,17 @@
+import { loadCredentials, type PreclaimCredentials } from '@preclaim/core';
+
+export async function requireAuth(): Promise<PreclaimCredentials> {
+  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;
+}

package/src/lib/client-factory.ts

@@ -0,0 +1,26 @@
+import { PreclaimClient, findConfig, type PreclaimConfig, type PreclaimCredentials } from '@preclaim/core';
+import { requireAuth } from './auth.js';
+
+export interface ResolvedContext {
+  client: PreclaimClient;
+  config: PreclaimConfig;
+  credentials: PreclaimCredentials;
+}
+
+export async function resolveContext(): Promise<ResolvedContext> {
+  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 };
+}

package/src/lib/hook-io.ts

@@ -0,0 +1,37 @@
+// Hook I/O helpers for Claude Code hooks
+// Reads hook input from stdin and writes hook output to stdout
+
+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 async function readHookInput(): Promise<ClaudeHookInput> {
+  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: ClaudeHookOutput): void {
+  process.stdout.write(JSON.stringify(output));
+}

package/src/lib/output.ts

@@ -0,0 +1,20 @@
+import type { Lock } from '@preclaim/core';
+
+export function formatLock(lock: Lock): string {
+  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: Lock[]): string {
+  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');
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}