clawck 0.1.3 → 0.3.0

package/dist/cli/index.js

@@ -11,6 +11,39 @@
  *   clawck status            Show running tasks and stats
  *   clawck report [--days N] Show timesheet summary
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -22,22 +55,29 @@ const api_1 = require("../server/api");
 const mcp_1 = require("../server/mcp");
 const clawck_1 = require("../core/clawck");
 const types_1 = require("../core/types");
+const pdf_1 = require("../reports/pdf");
+const html_1 = require("../reports/html");
+const patterns_1 = require("../core/patterns");
+const hooks_1 = require("../hooks");
 const program = new commander_1.Command();
 program
     .name('clawck')
     .description('⏱️🦀 Clawck — Time tracking for AI agents')
-    .version('0.1.3')
-    .option('--json', 'Output as JSON (for scripting/pipelines)');
+    .version('0.3.0')
+    .enablePositionalOptions()
+    .option('--json', 'Output as JSON (for scripting/pipelines)')
+    .option('-d, --dir <path>', 'Data directory (also: CLAWCK_DIR env var)');
 // ─── Init ─────────────────────────────────────────────────
 program
     .command('init')
     .description('Initialize a .clawck/ directory in the current folder')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .action(async (opts) => {
-    const dir = path_1.default.resolve(opts.dir);
+    const resolvedDir = resolveDataDir(opts);
+    const dir = path_1.default.resolve(resolvedDir);
     // Prevent nesting: don't create .clawck inside an existing .clawck
     const cwd = process.cwd();
-    if (path_1.default.basename(cwd) === '.clawck' && opts.dir === '.clawck') {
+    if (path_1.default.basename(cwd) === '.clawck' && resolvedDir === '.clawck') {
         console.error('  Already inside a .clawck directory. Aborting to prevent nesting.');
         process.exit(1);
     }
@@ -59,6 +99,8 @@ program
             default_source: 'clawck',
             human_equivalents: types_1.DEFAULT_HUMAN_EQUIVALENTS,
             remote_sources: [],
+            patterns: patterns_1.DEFAULT_PATTERNS,
+            default_pattern: 'default',
         };
         fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
     }
@@ -78,9 +120,9 @@ program
     .command('serve')
     .description('Start the Clawck API server and dashboard')
     .option('-p, --port <number>', 'Port number', '3456')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .action(async (opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     config.port = parseInt(opts.port) || config.port;
     (0, api_1.startServer)(config);
 });
@@ -88,18 +130,18 @@ program
 program
     .command('mcp')
     .description('Start the Clawck MCP server (stdio, for Claude Code / Cline / Cursor)')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .action(async (opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     (0, mcp_1.startMCPServer)(config);
 });
 // ─── Status ───────────────────────────────────────────────
 program
     .command('status')
     .description('Show currently running tasks and stats')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .action(async (opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const stats = clawck.stats();
     const running = clawck.running();
@@ -129,14 +171,16 @@ program
 program
     .command('report')
     .description('Show a timesheet summary')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .option('--days <number>', 'Number of days to include', '7')
     .option('--client <name>', 'Filter by client')
     .option('--project <name>', 'Filter by project')
     .option('--agent <name>', 'Filter by agent')
+    .option('--format <type>', 'Output format (terminal, pdf, or html)', 'terminal')
+    .option('--output <path>', 'Output file path (for pdf format)')
     .option('--detailed', 'Show individual entries')
     .action(async (opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const days = parseInt(opts.days) || 7;
     const to = new Date().toISOString();
@@ -146,6 +190,30 @@ program
         project: opts.project,
         agent: opts.agent,
     });
+    if (opts.format === 'html') {
+        const today = new Date().toISOString().split('T')[0];
+        const outputPath = opts.output || `clawck-report-${today}.html`;
+        const dateRange = `${from.split('T')[0]} to ${to.split('T')[0]}`;
+        const rawEntries = clawck.query({ from, to, client: opts.client, project: opts.project, agent: opts.agent, limit: 10000 });
+        const html = (0, html_1.generateTimesheetHTML)(ts, { dateRange, clientName: opts.client, rawEntries });
+        fs_1.default.writeFileSync(outputPath, html);
+        console.log(`  HTML report saved to: ${outputPath}`);
+        clawck.close();
+        return;
+    }
+    if (opts.format === 'pdf') {
+        const today = new Date().toISOString().split('T')[0];
+        const outputPath = opts.output || `clawck-report-${today}.pdf`;
+        const dateRange = `${from.split('T')[0]} to ${to.split('T')[0]}`;
+        await (0, pdf_1.generateTimesheetPDF)(ts, {
+            clientName: opts.client,
+            dateRange,
+            outputPath,
+        });
+        console.log(`  PDF report saved to: ${outputPath}`);
+        clawck.close();
+        return;
+    }
     if (program.opts().json) {
         console.log(JSON.stringify(ts));
         clawck.close();
@@ -184,15 +252,16 @@ program
 program
     .command('start <task>')
     .description('Start tracking time for a task')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .option('--project <name>', 'Project name')
     .option('--client <name>', 'Client name')
     .option('--category <type>', 'Task category')
     .option('--agent <name>', 'Agent name')
     .option('--model <name>', 'Model name')
     .option('--tags <tags...>', 'Tags')
+    .option('--pattern <name>', 'Use a tracking pattern')
     .action(async (task, opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const entry = clawck.start({
         task,
@@ -202,6 +271,7 @@ program
         agent: opts.agent,
         model: opts.model,
         tags: opts.tags,
+        pattern: opts.pattern,
     });
     if (program.opts().json) {
         console.log(JSON.stringify(entry));
@@ -217,7 +287,7 @@ program
 program
     .command('stop <id>')
     .description('Stop tracking time for a task')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .option('--status <status>', 'Outcome (completed/failed)', 'completed')
     .option('--summary <text>', 'Summary of work done')
     .option('--tokens-in <n>', 'Input tokens consumed', parseFloat)
@@ -225,7 +295,7 @@ program
     .option('--cost <n>', 'Cost in USD', parseFloat)
     .option('--tool-calls <n>', 'Number of tool calls', parseInt)
     .action(async (id, opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const entry = clawck.stop({
         id,
@@ -247,14 +317,14 @@ program
         process.exit(1);
     }
     const duration_minutes = entry.end
-        ? +((new Date(entry.end).getTime() - new Date(entry.start).getTime()) / 60000).toFixed(1)
+        ? (new Date(entry.end).getTime() - new Date(entry.start).getTime()) / 60000
         : null;
     if (program.opts().json) {
-        console.log(JSON.stringify({ ...entry, duration_minutes }));
+        console.log(JSON.stringify({ ...entry, duration_minutes: duration_minutes ? Math.round(duration_minutes * 100) / 100 : null }));
     }
     else {
         console.log(`  Stopped: ${entry.task}`);
-        console.log(`  Duration: ${duration_minutes}m  Status: ${entry.status}`);
+        console.log(`  Duration: ${duration_minutes !== null ? formatDuration(duration_minutes) : 'unknown'}  Status: ${entry.status}`);
     }
     clawck.close();
 });
@@ -262,7 +332,7 @@ program
 program
     .command('log <task>')
     .description('Log a completed task retroactively')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .option('--duration <minutes>', 'Duration in minutes', parseFloat)
     .option('--project <name>', 'Project name')
     .option('--client <name>', 'Client name')
@@ -271,12 +341,13 @@ program
     .option('--model <name>', 'Model name')
     .option('--summary <text>', 'Summary of work done')
     .option('--tags <tags...>', 'Tags')
+    .option('--pattern <name>', 'Use a tracking pattern')
     .action(async (task, opts) => {
     if (!opts.duration) {
         console.error('  --duration <minutes> is required');
         process.exit(1);
     }
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const entry = clawck.log({
         task,
@@ -288,6 +359,7 @@ program
         model: opts.model,
         summary: opts.summary,
         tags: opts.tags,
+        pattern: opts.pattern,
     });
     if (program.opts().json) {
         console.log(JSON.stringify(entry));
@@ -302,9 +374,9 @@ program
 program
     .command('get <id>')
     .description('Get a single time entry by ID')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .action(async (id, opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const entry = clawck.get(id);
     if (!entry) {
@@ -326,6 +398,8 @@ program
         console.log(`  Project: ${entry.project}  Client: ${entry.client}`);
         console.log(`  Agent: ${entry.agent}  Model: ${entry.model}`);
         console.log(`  Start: ${entry.start}  End: ${entry.end || '(running)'}`);
+        console.log(`  Approved: ${entry.approved ? 'yes' : 'no'}`);
+        console.log(`  Created: ${entry.created_at}  Updated: ${entry.updated_at}`);
     }
     clawck.close();
 });
@@ -333,7 +407,7 @@ program
 program
     .command('entries')
     .description('Query time entries')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .option('--client <name>', 'Filter by client')
     .option('--project <name>', 'Filter by project')
     .option('--agent <name>', 'Filter by agent')
@@ -341,9 +415,12 @@ program
     .option('--from <date>', 'Start date (ISO 8601)')
     .option('--to <date>', 'End date (ISO 8601)')
     .option('--limit <n>', 'Max entries', '50')
+    .option('--approved', 'Show only approved entries')
+    .option('--unapproved', 'Show only unapproved entries')
     .action(async (opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
+    const approvedFilter = opts.approved ? true : opts.unapproved ? false : undefined;
     const entries = clawck.query({
         client: opts.client,
         project: opts.project,
@@ -352,6 +429,7 @@ program
         from: opts.from,
         to: opts.to,
         limit: parseInt(opts.limit) || 50,
+        approved: approvedFilter,
     });
     if (program.opts().json) {
         console.log(JSON.stringify(entries));
@@ -368,21 +446,195 @@ program
     console.log('');
     clawck.close();
 });
+// ─── Approve ─────────────────────────────────────────────
+program
+    .command('approve <id>')
+    .description('Approve a time entry (supports 8-char prefix)')
+    .option('-d, --dir <path>', 'Data directory')
+    .action(async (id, opts) => {
+    const config = loadConfig(resolveDataDir(opts));
+    const clawck = await new clawck_1.Clawck(config).ready();
+    const entry = resolveEntryId(clawck, id);
+    if (!entry) {
+        clawck.close();
+        process.exit(1);
+    }
+    const approved = clawck.approve(entry.id);
+    if (program.opts().json) {
+        console.log(JSON.stringify(approved));
+    }
+    else {
+        console.log(`  Approved: ${approved.task}`);
+        console.log(`  ID: ${approved.id.slice(0, 8)}  Project: ${approved.project}`);
+    }
+    clawck.close();
+});
+// ─── Pattern ─────────────────────────────────────────────
+const pattern = program
+    .command('pattern')
+    .description('Manage tracking patterns (task templates)');
+pattern
+    .command('list')
+    .description('List all tracking patterns')
+    .option('-d, --dir <path>', 'Data directory')
+    .action(async (opts) => {
+    const config = loadConfig(resolveDataDir(opts));
+    const clawck = await new clawck_1.Clawck(config).ready();
+    const patterns = clawck.getPatterns();
+    if (program.opts().json) {
+        console.log(JSON.stringify(patterns));
+        clawck.close();
+        return;
+    }
+    console.log(`\n  Tracking Patterns:`);
+    for (const p of patterns) {
+        const defaultMark = config.default_pattern === p.name ? ' (default)' : '';
+        console.log(`  - ${p.name}${defaultMark}`);
+        if (p.description)
+            console.log(`    ${p.description}`);
+        const fields = [];
+        if (p.category)
+            fields.push(`category: ${p.category}`);
+        if (p.project)
+            fields.push(`project: ${p.project}`);
+        if (p.client)
+            fields.push(`client: ${p.client}`);
+        if (p.agent)
+            fields.push(`agent: ${p.agent}`);
+        if (p.tags?.length)
+            fields.push(`tags: ${p.tags.join(', ')}`);
+        if (fields.length)
+            console.log(`    ${fields.join('  ')}`);
+    }
+    console.log('');
+    clawck.close();
+});
+pattern
+    .command('add')
+    .description('Add a new tracking pattern')
+    .requiredOption('--name <name>', 'Pattern name')
+    .option('-d, --dir <path>', 'Data directory')
+    .option('--category <type>', 'Default category')
+    .option('--project <name>', 'Default project')
+    .option('--client <name>', 'Default client')
+    .option('--agent <name>', 'Default agent')
+    .option('--tags <tags...>', 'Default tags')
+    .option('--description <text>', 'Pattern description')
+    .action(async (opts) => {
+    const dataDir = resolveDataDir(opts);
+    const config = loadConfig(dataDir);
+    const configPath = path_1.default.join(path_1.default.resolve(dataDir), 'config.json');
+    const newPattern = { name: opts.name };
+    if (opts.description)
+        newPattern.description = opts.description;
+    if (opts.category)
+        newPattern.category = opts.category;
+    if (opts.project)
+        newPattern.project = opts.project;
+    if (opts.client)
+        newPattern.client = opts.client;
+    if (opts.agent)
+        newPattern.agent = opts.agent;
+    if (opts.tags)
+        newPattern.tags = opts.tags;
+    let fileConfig = {};
+    if (fs_1.default.existsSync(configPath)) {
+        try {
+            fileConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf-8'));
+        }
+        catch { }
+    }
+    if (!fileConfig.patterns)
+        fileConfig.patterns = [...patterns_1.DEFAULT_PATTERNS];
+    fileConfig.patterns.push(newPattern);
+    fs_1.default.writeFileSync(configPath, JSON.stringify(fileConfig, null, 2));
+    console.log(`  Added pattern: ${opts.name}`);
+});
+pattern
+    .command('use <name>')
+    .description('Set the default tracking pattern')
+    .option('-d, --dir <path>', 'Data directory')
+    .action(async (name, opts) => {
+    const dataDir = resolveDataDir(opts);
+    const configPath = path_1.default.join(path_1.default.resolve(dataDir), 'config.json');
+    let fileConfig = {};
+    if (fs_1.default.existsSync(configPath)) {
+        try {
+            fileConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf-8'));
+        }
+        catch { }
+    }
+    fileConfig.default_pattern = name;
+    fs_1.default.writeFileSync(configPath, JSON.stringify(fileConfig, null, 2));
+    console.log(`  Default pattern set to: ${name}`);
+});
+// ─── Setup ───────────────────────────────────────────────
+program
+    .command('setup [target]')
+    .description('Output ready-to-paste config snippets for agent integration')
+    .action(async (target) => {
+    const snippetsDir = path_1.default.resolve(__dirname, '../../docs/snippets');
+    function readSnippet(filename) {
+        const filePath = path_1.default.join(snippetsDir, filename);
+        if (!fs_1.default.existsSync(filePath)) {
+            console.error(`  Snippet not found: ${filePath}`);
+            process.exit(1);
+        }
+        return fs_1.default.readFileSync(filePath, 'utf-8');
+    }
+    if (!target) {
+        console.log(`
+  ⏱️🦀 Clawck Setup — Agent Integration
+
+  Available targets:
+
+    clawck setup claude      Output CLAUDE.md time tracking snippet
+    clawck setup mcp         Output MCP server config JSON
+    clawck setup openclaw    Output OpenClaw snippets (AGENT.md + HEARTBEAT.md)
+
+  Paste the output into the appropriate file for your agent platform.
+  See docs/skills/clawck-setup.md for full integration guide.
+`);
+        return;
+    }
+    switch (target) {
+        case 'claude': {
+            console.log('\n# Add this to your CLAUDE.md (project or ~/.claude/CLAUDE.md for global):\n');
+            console.log(readSnippet('claude-md.txt'));
+            break;
+        }
+        case 'mcp': {
+            console.log('\n# Add this to your mcp_servers.json (or ~/.claude/mcp_servers.json for global):\n');
+            console.log(readSnippet('mcp-config.json'));
+            break;
+        }
+        case 'openclaw': {
+            console.log('\n# ─── AGENT.md ─────────────────────────────────────────\n');
+            console.log(readSnippet('openclaw-agent-md.txt'));
+            console.log('\n# ─── HEARTBEAT.md ─────────────────────────────────────\n');
+            console.log(readSnippet('openclaw-heartbeat-md.txt'));
+            break;
+        }
+        default:
+            console.error(`  Unknown target: "${target}". Run "clawck setup" to see options.`);
+            process.exit(1);
+    }
+});
 // ─── Seed (for testing) ──────────────────────────────────
 program
     .command('seed')
     .description('Seed the database with sample entries (for testing)')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .option('-n, --count <number>', 'Number of entries', '25')
     .action(async (opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const count = parseInt(opts.count) || 25;
     const agents = ['cubi-research-01', 'cubi-writer-02', 'cubi-coder-03', 'cubi-analyst-04', 'cubi-outreach-05'];
     const models = ['claude-sonnet-4-20250514', 'claude-haiku-4-5-20251001', 'gpt-4o', 'gemini-2.0-flash'];
-    const clients = ['acme-corp', 'globex-inc', 'initech', 'hooli'];
-    const projects = ['website-rebuild', 'seo-content', 'grant-research', 'data-migration', 'email-campaigns'];
-    const categories = ['research', 'content', 'code', 'data_entry', 'analysis', 'communication', 'testing', 'design'];
+    const clients = ['acme-corp', 'globex-inc', 'initech', 'hooli', 'umbrella-co'];
+    const projects = ['website-rebuild', 'seo-content', 'grant-research', 'data-migration', 'email-campaigns', 'api-v2'];
+    const categories = ['research', 'content', 'code', 'data_entry', 'analysis', 'communication', 'testing', 'design', 'planning', 'other'];
     const tasks = [
         'Research competitor pricing strategies',
         'Write blog post about AI automation',
@@ -399,20 +651,26 @@ program
         'Review and optimize database queries',
         'Create investor pitch deck outline',
         'Summarize recent industry news',
+        'Plan sprint roadmap for Q4',
+        'Coordinate team standup notes',
     ];
+    const pick = (arr) => arr[Math.floor(Math.random() * arr.length)];
+    // Ensure coverage: cycle through all clients, projects, categories, agents
     for (let i = 0; i < count; i++) {
-        const daysAgo = Math.random() * 14;
         const durationMin = 5 + Math.random() * 120;
         const tokensIn = Math.round(1000 + Math.random() * 50000);
         const tokensOut = Math.round(500 + Math.random() * 20000);
-        const category = categories[Math.floor(Math.random() * categories.length)];
-        clawck.log({
-            task: tasks[Math.floor(Math.random() * tasks.length)],
-            project: projects[Math.floor(Math.random() * projects.length)],
-            client: clients[Math.floor(Math.random() * clients.length)],
+        const category = i < categories.length ? categories[i] : pick(categories);
+        const client = i < clients.length ? clients[i] : pick(clients);
+        const project = i < projects.length ? projects[i] : pick(projects);
+        const agent = i < agents.length ? agents[i] : pick(agents);
+        const entry = clawck.log({
+            task: pick(tasks),
+            project,
+            client,
             category,
-            agent: agents[Math.floor(Math.random() * agents.length)],
-            model: models[Math.floor(Math.random() * models.length)],
+            agent,
+            model: pick(models),
             duration_minutes: Math.round(durationMin),
             tokens_in: tokensIn,
             tokens_out: tokensOut,
@@ -420,27 +678,82 @@ program
             summary: 'Auto-generated seed entry for testing',
             tags: ['seed', 'test'],
         });
+        // Approve ~60% of completed entries
+        if (Math.random() < 0.6) {
+            clawck.approve(entry.id);
+        }
+    }
+    // Add 2-3 running entries
+    for (let i = 0; i < 3; i++) {
+        clawck.start({
+            task: pick(tasks),
+            project: pick(projects),
+            client: pick(clients),
+            category: pick(categories),
+            agent: pick(agents),
+            model: pick(models),
+            tags: ['seed'],
+        });
+    }
+    // Add 2-3 failed entries via upsert
+    const { v4: uuid } = await Promise.resolve().then(() => __importStar(require('uuid')));
+    for (let i = 0; i < 3; i++) {
+        const daysAgo = Math.random() * 7;
+        const start = new Date(Date.now() - daysAgo * 86400000);
+        const end = new Date(start.getTime() + (10 + Math.random() * 30) * 60000);
+        clawck.upsert({
+            id: uuid(),
+            task: pick(tasks),
+            project: pick(projects),
+            client: pick(clients),
+            category: pick(categories),
+            agent: pick(agents),
+            model: pick(models),
+            start: start.toISOString(),
+            end: end.toISOString(),
+            status: 'failed',
+            tokens_in: Math.round(500 + Math.random() * 5000),
+            tokens_out: Math.round(100 + Math.random() * 1000),
+            cost_usd: Math.round(Math.random() * 0.05 * 10000) / 10000,
+            tool_calls: Math.round(Math.random() * 5),
+            summary: 'Task failed - auto-generated seed entry',
+            tags: ['seed', 'failed'],
+            source: 'clawck',
+            spec_version: '0.1.0',
+        });
     }
-    console.log(`\n  ⏱️🦀 Seeded ${count} entries into Clawck!`);
-    console.log(`  └─ Run: clawck serve\n`);
+    console.log(`\n  ⏱️🦀 Seeded ${count + 6} entries into Clawck!`);
+    console.log(`  ├─ ${count} completed entries (~60% approved)`);
+    console.log(`  ├─ 3 running entries`);
+    console.log(`  ├─ 3 failed entries`);
+    console.log(`  │`);
+    console.log(`  │  Try these:`);
+    console.log(`  │  clawck list -d ${resolveDataDir(opts)}`);
+    console.log(`  │  clawck report --format html -d ${resolveDataDir(opts)}`);
+    console.log(`  │  clawck pattern list -d ${resolveDataDir(opts)}`);
+    console.log(`  │  clawck entries --approved -d ${resolveDataDir(opts)}`);
+    console.log(`  └─ clawck serve -d ${resolveDataDir(opts)}\n`);
     clawck.close();
 });
 // ─── List ───────────────────────────────────────────────
 program
     .command('list')
     .description('List time entries in a human-readable table')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .option('--days <number>', 'Number of days to include', '7')
     .option('--client <name>', 'Filter by client')
     .option('--project <name>', 'Filter by project')
     .option('--agent <name>', 'Filter by agent')
     .option('--limit <n>', 'Max entries', '50')
+    .option('--approved', 'Show only approved entries')
+    .option('--unapproved', 'Show only unapproved entries')
     .action(async (opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const days = parseInt(opts.days) || 7;
     const from = new Date(Date.now() - days * 86400000).toISOString();
     const to = new Date().toISOString();
+    const approvedFilter = opts.approved ? true : opts.unapproved ? false : undefined;
     const entries = clawck.query({
         client: opts.client,
         project: opts.project,
@@ -448,6 +761,7 @@ program
         from,
         to,
         limit: parseInt(opts.limit) || 50,
+        approved: approvedFilter,
     });
     if (program.opts().json) {
         console.log(JSON.stringify(entries));
@@ -461,9 +775,9 @@ program
 program
     .command('delete <id>')
     .description('Delete a time entry by ID (supports 8-char prefix)')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .action(async (id, opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const entry = resolveEntryId(clawck, id);
     if (!entry) {
@@ -484,7 +798,7 @@ program
 program
     .command('edit <id>')
     .description('Edit a time entry by ID (supports 8-char prefix)')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .option('--task <text>', 'Update task description')
     .option('--duration <minutes>', 'Update duration (recalculates end)', parseFloat)
     .option('--project <name>', 'Update project')
@@ -493,7 +807,7 @@ program
     .option('--category <type>', 'Update category')
     .option('--summary <text>', 'Update summary')
     .action(async (id, opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const entry = resolveEntryId(clawck, id);
     if (!entry) {
@@ -533,14 +847,14 @@ program
 program
     .command('export')
     .description('Export time entries as JSON or CSV')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
+    .option('-d, --dir <path>', 'Data directory')
     .option('--format <type>', 'Output format (json or csv)', 'json')
     .option('--days <number>', 'Number of days to include', '7')
     .option('--client <name>', 'Filter by client')
     .option('--project <name>', 'Filter by project')
     .option('--agent <name>', 'Filter by agent')
     .action(async (opts) => {
-    const config = loadConfig(opts.dir);
+    const config = loadConfig(resolveDataDir(opts));
     const clawck = await new clawck_1.Clawck(config).ready();
     const days = parseInt(opts.days) || 7;
     const from = new Date(Date.now() - days * 86400000).toISOString();
@@ -560,7 +874,7 @@ program
             }
             return val;
         };
-        console.log('id,date,task,category,duration_minutes,project,client,agent,model,status,tokens_in,tokens_out,cost_usd,summary');
+        console.log('id,date,task,category,duration_minutes,project,client,agent,model,status,tokens_in,tokens_out,cost_usd,summary,created_at,updated_at');
         for (const e of entries) {
             const durationMin = e.end
                 ? ((new Date(e.end).getTime() - new Date(e.start).getTime()) / 60000).toFixed(2)
@@ -581,6 +895,8 @@ program
                 String(e.tokens_out),
                 e.cost_usd.toFixed(4),
                 csvEscape(e.summary),
+                csvEscape(e.created_at || ''),
+                csvEscape(e.updated_at || ''),
             ].join(','));
         }
     }
@@ -589,10 +905,114 @@ program
     }
     clawck.close();
 });
+// ─── Hook (runtime, singular) ────────────────────────────
+const hook = program
+    .command('hook')
+    .description('Runtime hook command (called by platform hooks, reads JSON from stdin)');
+hook
+    .command('start')
+    .description('Start tracking — called by platform hooks')
+    .option('-d, --dir <path>', 'Data directory')
+    .option('--platform <name>', 'Force platform (claude|gemini|cursor|cline|windsurf|codex)')
+    .action(async (opts) => {
+    try {
+        const raw = await (0, hooks_1.readStdin)();
+        let json = {};
+        if (raw.trim()) {
+            try {
+                json = JSON.parse(raw);
+            }
+            catch {
+                json = {};
+            }
+        }
+        const platform = opts.platform || undefined;
+        const context = (0, hooks_1.normalize)(json, platform);
+        const config = loadConfig(resolveDataDir(opts));
+        await (0, hooks_1.handleHookStart)(config, context);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`clawck: hook start failed: ${msg}\n`);
+    }
+    process.exit(0);
+});
+hook
+    .command('stop')
+    .description('Stop tracking — called by platform hooks')
+    .option('-d, --dir <path>', 'Data directory')
+    .option('--platform <name>', 'Force platform (claude|gemini|cursor|cline|windsurf|codex)')
+    .action(async (opts) => {
+    try {
+        const raw = await (0, hooks_1.readStdin)();
+        let json = {};
+        if (raw.trim()) {
+            try {
+                json = JSON.parse(raw);
+            }
+            catch {
+                json = {};
+            }
+        }
+        const platform = opts.platform || undefined;
+        const context = (0, hooks_1.normalize)(json, platform);
+        const config = loadConfig(resolveDataDir(opts));
+        await (0, hooks_1.handleHookStop)(config, context);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`clawck: hook stop failed: ${msg}\n`);
+    }
+    process.exit(0);
+});
+// ─── Hooks (management, plural) ──────────────────────────
+const hooks = program
+    .command('hooks')
+    .description('Manage platform hook integrations');
+hooks
+    .command('install <platform>')
+    .description('Output hook configuration for a platform')
+    .action(async (platformName) => {
+    const key = platformName.toLowerCase();
+    if (!hooks_1.PLATFORMS[key]) {
+        console.error(`  Unknown platform: "${platformName}"`);
+        console.error(`  Available: ${hooks_1.PLATFORM_NAMES.join(', ')}`);
+        process.exit(1);
+    }
+    const info = hooks_1.PLATFORMS[key];
+    console.log(`\n  ⏱️🦀 Clawck Hooks — ${info.displayName}`);
+    console.log(`  ${'─'.repeat(40)}`);
+    if (info.configPaths.length > 0) {
+        console.log(`\n  Add to: ${info.configPaths[0]}\n`);
+    }
+    console.log(info.generate());
+    console.log(`\n  Or copy from: docs/snippets/${info.snippetFile}`);
+    console.log('');
+});
+hooks
+    .command('status')
+    .description('Show which platforms have clawck hooks installed')
+    .action(async () => {
+    console.log(`\n  ⏱️🦀 Clawck Hooks — Status`);
+    console.log(`  ${'─'.repeat(40)}`);
+    for (const name of hooks_1.PLATFORM_NAMES) {
+        const info = hooks_1.PLATFORMS[name];
+        const installed = info.detect();
+        const icon = installed ? '✓' : '✗';
+        console.log(`  ${icon}  ${info.displayName.padEnd(16)} ${installed ? 'installed' : 'not found'}`);
+    }
+    console.log(`\n  Run "clawck hooks install <platform>" to set up a platform.\n`);
+});
 // ─── Helpers ──────────────────────────────────────────────
+function resolveDataDir(subcommandOpts) {
+    return subcommandOpts.dir
+        ?? program.opts().dir
+        ?? process.env.CLAWCK_DIR
+        ?? '.clawck';
+}
 function formatDuration(mins) {
     if (mins < 1)
-        return '<1 min';
+        return `${Math.round(mins * 60)}s`;
     if (mins < 60)
         return `${Math.round(mins)} min`;
     const h = Math.floor(mins / 60);
@@ -632,7 +1052,7 @@ function printEntryTable(entries) {
         console.log('\n  No entries found.\n');
         return;
     }
-    const header = `  ${'ID'.padEnd(10)} ${'Task'.padEnd(42)} ${'Duration'.padEnd(10)} ${'Project'.padEnd(12)} ${'Agent'.padEnd(12)} ${'Time'}`;
+    const header = `  ${'ID'.padEnd(10)} ${'Task'.padEnd(42)} ${'Duration'.padEnd(10)} ${'Project'.padEnd(12)} ${'Agent'.padEnd(12)} ${'OK'.padEnd(4)} ${'Time'}`;
     console.log(`\n${header}`);
     console.log(`  ${'─'.repeat(header.length - 2)}`);
     for (const e of entries) {
@@ -642,7 +1062,8 @@ function printEntryTable(entries) {
         const dur = e.end ? formatDuration(durationMin) : 'running';
         const task = e.task.length > 40 ? e.task.slice(0, 37) + '...' : e.task;
         const time = new Date(e.start).toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: false });
-        console.log(`  ${e.id.slice(0, 8).padEnd(10)} ${task.padEnd(42)} ${dur.padEnd(10)} ${e.project.slice(0, 12).padEnd(12)} ${e.agent.padEnd(12)} ${time}`);
+        const approved = e.approved ? 'v' : '-';
+        console.log(`  ${e.id.slice(0, 8).padEnd(10)} ${task.padEnd(42)} ${dur.padEnd(10)} ${e.project.slice(0, 12).padEnd(12)} ${e.agent.padEnd(12)} ${approved.padEnd(4)} ${time}`);
     }
     console.log(`\n  ${entries.length} entries\n`);
 }
@@ -682,6 +1103,22 @@ function loadConfig(dir) {
         console.error('  Config error: "remote_sources" must be an array');
         process.exit(1);
     }
+    if (fileConfig.webhooks !== undefined) {
+        if (!Array.isArray(fileConfig.webhooks)) {
+            console.error('  Config error: "webhooks" must be an array');
+            process.exit(1);
+        }
+        for (const [i, wh] of fileConfig.webhooks.entries()) {
+            if (!wh.url || typeof wh.url !== 'string') {
+                console.error(`  Config error: "webhooks[${i}].url" must be a string`);
+                process.exit(1);
+            }
+            if (!Array.isArray(wh.events)) {
+                console.error(`  Config error: "webhooks[${i}].events" must be an array`);
+                process.exit(1);
+            }
+        }
+    }
     return {
         ...types_1.DEFAULT_CONFIG,
         ...fileConfig,