clawck 0.1.3 → 0.4.1

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,33 @@ 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 periods_1 = require("../reports/periods");
+const patterns_1 = require("../core/patterns");
+const hooks_1 = require("../hooks");
+const benchmarks_1 = require("../core/benchmarks");
+const atp_1 = require("../core/atp");
+const types_2 = require("../core/types");
 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.4.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 +103,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 +124,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 +134,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);
-    (0, mcp_1.startMCPServer)(config);
+    const config = loadConfig(resolveDataDir(opts));
+    await (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();
@@ -126,73 +172,236 @@ program
     clawck.close();
 });
 // ─── Report ───────────────────────────────────────────────
-program
+const reportCmd = program
     .command('report')
     .description('Show a timesheet summary')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
-    .option('--days <number>', 'Number of days to include', '7')
+    .option('-d, --dir <path>', 'Data directory')
+    .option('--days <number>', 'Number of days to include')
+    .option('--period <type>', 'Time period (day, week, month, year, custom)')
+    .option('--from <date>', 'Start date (YYYY-MM-DD or ISO)')
+    .option('--to <date>', 'End date (YYYY-MM-DD or ISO)')
+    .option('--style <type>', 'Report style (full, short, visual, text, table, calendar)', 'full')
     .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/html format)')
     .option('--detailed', 'Show individual entries')
+    .option('--save', 'Save report to database')
+    .option('--name <name>', 'Name for saved report')
     .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();
-    const from = new Date(Date.now() - days * 86400000).toISOString();
+    // Resolve time period
+    const resolved = (0, periods_1.resolvePeriod)({
+        period: opts.period,
+        from: opts.from,
+        to: opts.to,
+        days: opts.days ? parseInt(opts.days) : undefined,
+    });
+    const { from, to, period } = resolved;
+    // --detailed maps to style='table' when no explicit --style
+    const style = opts.detailed && opts.style === 'full' ? 'table' : opts.style;
     const ts = clawck.timesheet(from, to, {
         client: opts.client,
         project: opts.project,
         agent: opts.agent,
     });
+    const periodLabel = opts.period || (opts.days ? `${opts.days} days` : period);
+    let reportContent = '';
+    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, style });
+        reportContent = html;
+        fs_1.default.writeFileSync(outputPath, html);
+        console.log(`  HTML report saved to: ${outputPath}`);
+    }
+    else 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,
+            style,
+        });
+        reportContent = fs_1.default.readFileSync(outputPath).toString('base64');
+        console.log(`  PDF report saved to: ${outputPath}`);
+    }
+    else {
+        // Terminal output
+        if (program.opts().json) {
+            reportContent = JSON.stringify(ts);
+            console.log(reportContent);
+        }
+        else {
+            const totalAgentRuntimeMin = ts.entries.reduce((s, r) => s + (r.agent_runtime_minutes || 0), 0);
+            if (style === 'table') {
+                const entries = clawck.query({ client: opts.client, project: opts.project, agent: opts.agent, from, to, limit: 500 });
+                printEntryTable(entries);
+            }
+            else if (style === 'short') {
+                console.log(`\n  📋 Clawck Timesheet — ${periodLabel}`);
+                console.log(`  ${'─'.repeat(50)}`);
+                console.log(`  ⏱️  Wall-clock hours:  ${ts.total_agent_hours.toFixed(2)} hrs`);
+                if (totalAgentRuntimeMin > 0) {
+                    console.log(`  🤖 Agent runtime:     ${formatDuration(totalAgentRuntimeMin)} (estimated)`);
+                }
+                console.log(`  👤 Human equiv:       ${ts.total_human_equiv_hours.toFixed(2)} hrs`);
+                console.log(`  💰 Agent cost:        $${ts.total_cost_usd.toFixed(2)}`);
+                console.log(`  💚 Est. savings:      $${ts.total_savings_usd.toFixed(0)}`);
+                console.log(`  🔢 Total entries:     ${ts.total_entries}`);
+                console.log(`  🪙 Total tokens:      ${ts.total_tokens.toLocaleString()}`);
+                console.log('');
+            }
+            else {
+                // full, text, visual, calendar all fall back to full terminal output
+                console.log(`\n  📋 Clawck Timesheet — ${periodLabel}`);
+                console.log(`  ${'─'.repeat(50)}`);
+                console.log(`  ⏱️  Wall-clock hours:  ${ts.total_agent_hours.toFixed(2)} hrs`);
+                if (totalAgentRuntimeMin > 0) {
+                    console.log(`  🤖 Agent runtime:     ${formatDuration(totalAgentRuntimeMin)} (estimated)`);
+                }
+                console.log(`  👤 Human equiv:       ${ts.total_human_equiv_hours.toFixed(2)} hrs`);
+                console.log(`  💰 Agent cost:        $${ts.total_cost_usd.toFixed(2)}`);
+                console.log(`  💚 Est. savings:      $${ts.total_savings_usd.toFixed(0)}`);
+                console.log(`  🔢 Total entries:     ${ts.total_entries}`);
+                console.log(`  🪙 Total tokens:      ${ts.total_tokens.toLocaleString()}`);
+                if (ts.by_project.length > 0) {
+                    console.log(`\n  📁 By Project:`);
+                    for (const p of ts.by_project) {
+                        const bar = '█'.repeat(Math.max(1, Math.round(p.agent_hours / (ts.total_agent_hours || 1) * 20)));
+                        console.log(`  ${bar} ${p.project} (${p.client}): ${p.agent_hours.toFixed(2)}h → ${p.human_equiv_hours.toFixed(2)}h human equiv`);
+                    }
+                }
+                if (ts.by_agent.length > 0) {
+                    console.log(`\n  🤖 By Agent:`);
+                    for (const a of ts.by_agent) {
+                        console.log(`  • ${a.agent} (${a.model}): ${a.agent_hours.toFixed(2)}h, ${a.success_rate}% success`);
+                    }
+                }
+                console.log('');
+            }
+        }
+    }
+    // Save report if requested
+    if (opts.save) {
+        const metadata = {
+            filters: { client: opts.client, project: opts.project, agent: opts.agent },
+            total_entries: ts.total_entries,
+            total_agent_hours: ts.total_agent_hours,
+            total_cost_usd: ts.total_cost_usd,
+            total_savings_usd: ts.total_savings_usd,
+        };
+        const saved = clawck.saveReport({
+            name: opts.name || `Report ${new Date().toISOString().split('T')[0]}`,
+            period,
+            period_start: from,
+            period_end: to,
+            style,
+            format: opts.format,
+            content: reportContent || JSON.stringify(ts),
+            metadata,
+        });
+        console.log(`  Report saved: ${saved.id.slice(0, 8)}`);
+    }
+    clawck.close();
+});
+// ─── Report Subcommands ─────────────────────────────────
+reportCmd
+    .command('list')
+    .description('List saved reports')
+    .option('-d, --dir <path>', 'Data directory')
+    .option('--limit <n>', 'Max reports to show', '20')
+    .action(async (opts) => {
+    const config = loadConfig(resolveDataDir(opts));
+    const clawck = await new clawck_1.Clawck(config).ready();
+    const reports = clawck.listReports(parseInt(opts.limit) || 20);
     if (program.opts().json) {
-        console.log(JSON.stringify(ts));
+        console.log(JSON.stringify(reports));
         clawck.close();
         return;
     }
-    console.log(`\n  📋 Clawck Timesheet — Last ${days} days`);
-    console.log(`  ${'─'.repeat(50)}`);
-    console.log(`  ⏱️  Agent hours:       ${ts.total_agent_hours.toFixed(2)} hrs`);
-    console.log(`  👤 Human equiv:       ${ts.total_human_equiv_hours.toFixed(2)} hrs`);
-    console.log(`  💰 Agent cost:        $${ts.total_cost_usd.toFixed(2)}`);
-    console.log(`  💚 Est. savings:      $${ts.total_savings_usd.toFixed(0)}`);
-    console.log(`  🔢 Total entries:     ${ts.total_entries}`);
-    console.log(`  🪙 Total tokens:      ${ts.total_tokens.toLocaleString()}`);
-    if (ts.by_project.length > 0) {
-        console.log(`\n  📁 By Project:`);
-        for (const p of ts.by_project) {
-            const bar = '█'.repeat(Math.max(1, Math.round(p.agent_hours / (ts.total_agent_hours || 1) * 20)));
-            console.log(`  ${bar} ${p.project} (${p.client}): ${p.agent_hours.toFixed(2)}h → ${p.human_equiv_hours.toFixed(2)}h human equiv`);
-        }
-    }
-    if (ts.by_agent.length > 0) {
-        console.log(`\n  🤖 By Agent:`);
-        for (const a of ts.by_agent) {
-            console.log(`  • ${a.agent} (${a.model}): ${a.agent_hours.toFixed(2)}h, ${a.success_rate}% success`);
-        }
+    if (reports.length === 0) {
+        console.log('\n  No saved reports.\n');
+        clawck.close();
+        return;
     }
-    if (opts.detailed) {
-        const entries = clawck.query({ client: opts.client, project: opts.project, agent: opts.agent, from, to, limit: 500 });
-        console.log(`\n  📝 Entries:`);
-        printEntryTable(entries);
+    console.log(`\n  Saved Reports:`);
+    console.log(`  ${'ID'.padEnd(10)} ${'Name'.padEnd(30)} ${'Period'.padEnd(8)} ${'Style'.padEnd(10)} ${'Format'.padEnd(10)} ${'Date'}`);
+    console.log(`  ${'─'.repeat(80)}`);
+    for (const r of reports) {
+        console.log(`  ${r.id.slice(0, 8).padEnd(10)} ${(r.name || '-').slice(0, 28).padEnd(30)} ${r.period.padEnd(8)} ${r.style.padEnd(10)} ${r.format.padEnd(10)} ${r.created_at.split('T')[0]}`);
     }
     console.log('');
     clawck.close();
 });
+reportCmd
+    .command('show <id>')
+    .description('Retrieve a saved report')
+    .option('-d, --dir <path>', 'Data directory')
+    .option('--output <path>', 'Write content to file')
+    .action(async (id, opts) => {
+    const config = loadConfig(resolveDataDir(opts));
+    const clawck = await new clawck_1.Clawck(config).ready();
+    const report = clawck.getReport(id);
+    if (!report) {
+        console.error(`  Report not found: ${id}`);
+        clawck.close();
+        process.exit(1);
+    }
+    if (opts.output) {
+        const content = typeof report.content === 'string' ? report.content : report.content;
+        fs_1.default.writeFileSync(opts.output, content);
+        console.log(`  Report written to: ${opts.output}`);
+    }
+    else if (program.opts().json) {
+        console.log(JSON.stringify(report));
+    }
+    else {
+        console.log(typeof report.content === 'string' ? report.content : '[binary content — use --output to save]');
+    }
+    clawck.close();
+});
+reportCmd
+    .command('delete <id>')
+    .description('Delete a saved report')
+    .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 deleted = clawck.deleteReport(id);
+    if (!deleted) {
+        console.error(`  Report not found: ${id}`);
+        clawck.close();
+        process.exit(1);
+    }
+    if (program.opts().json) {
+        console.log(JSON.stringify({ ok: true }));
+    }
+    else {
+        console.log(`  Report deleted.`);
+    }
+    clawck.close();
+});
 // ─── Start ───────────────────────────────────────────────
 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 +411,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 +427,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 +435,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 +457,17 @@ 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(`  Wall clock: ${duration_minutes !== null ? formatDuration(duration_minutes) : 'unknown'}  Status: ${entry.status}`);
+        if (entry.agent_runtime_ms != null) {
+            console.log(`  Agent runtime (est.): ${formatDuration(entry.agent_runtime_ms / 60000)}`);
+        }
     }
     clawck.close();
 });
@@ -262,7 +475,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 +484,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 +502,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 +517,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 +541,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 +550,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 +558,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 +572,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 +589,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 agents = ['research-agent-01', 'writer-agent-02', 'coder-agent-03', 'analyst-agent-04', 'outreach-agent-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 +794,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 +821,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'],
+        });
     }
-    console.log(`\n  ⏱️🦀 Seeded ${count} entries into Clawck!`);
-    console.log(`  └─ Run: clawck serve\n`);
+    // 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: types_1.SPEC_VERSION,
+        });
+    }
+    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 +904,7 @@ program
         from,
         to,
         limit: parseInt(opts.limit) || 50,
+        approved: approvedFilter,
     });
     if (program.opts().json) {
         console.log(JSON.stringify(entries));
@@ -461,9 +918,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 +941,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 +950,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) {
@@ -532,15 +989,15 @@ program
 // ─── Export ──────────────────────────────────────────────
 program
     .command('export')
-    .description('Export time entries as JSON or CSV')
-    .option('-d, --dir <path>', 'Data directory', '.clawck')
-    .option('--format <type>', 'Output format (json or csv)', 'json')
+    .description('Export time entries as JSON, CSV, or ATP envelope')
+    .option('-d, --dir <path>', 'Data directory')
+    .option('--format <type>', 'Output format (json, csv, or atp)', '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();
@@ -553,6 +1010,13 @@ program
         to,
         limit: 10000,
     });
+    if (opts.format === 'atp') {
+        const baselines = clawck.getBaselines();
+        const envelope = (0, atp_1.exportATP)(entries, benchmarks_1.INDUSTRY_BENCHMARKS, baselines);
+        console.log(JSON.stringify(envelope, null, 2));
+        clawck.close();
+        return;
+    }
     if (opts.format === 'csv') {
         const csvEscape = (val) => {
             if (val.includes(',') || val.includes('"') || val.includes('\n')) {
@@ -560,7 +1024,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 +1045,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 +1055,387 @@ program
     }
     clawck.close();
 });
+// ─── Benchmark ──────────────────────────────────────────
+const benchmark = program
+    .command('benchmark')
+    .description('View industry benchmarks for task categories');
+benchmark
+    .command('list')
+    .description('List all industry benchmarks')
+    .action(async () => {
+    if (program.opts().json) {
+        console.log(JSON.stringify(benchmarks_1.INDUSTRY_BENCHMARKS));
+        return;
+    }
+    console.log(`\n  Industry Benchmarks (human median times):`);
+    console.log(`  ${'─'.repeat(80)}`);
+    console.log(`  ${'Category'.padEnd(15)} ${'Task Type'.padEnd(25)} ${'Median'.padEnd(10)} ${'P25'.padEnd(10)} ${'P75'.padEnd(10)} Source`);
+    console.log(`  ${'─'.repeat(80)}`);
+    for (const b of benchmarks_1.INDUSTRY_BENCHMARKS) {
+        console.log(`  ${b.category.padEnd(15)} ${b.task_type.padEnd(25)} ${formatDuration(b.human_median_minutes).padEnd(10)} ${formatDuration(b.human_p25_minutes).padEnd(10)} ${formatDuration(b.human_p75_minutes).padEnd(10)} ${b.source}`);
+    }
+    console.log('');
+});
+benchmark
+    .command('category <name>')
+    .description('Show benchmarks for a specific category')
+    .action(async (name) => {
+    const catBenchmarks = benchmarks_1.INDUSTRY_BENCHMARKS.filter(b => b.category === name);
+    if (catBenchmarks.length === 0) {
+        console.error(`  No benchmarks found for category: ${name}`);
+        console.error(`  Available: ${types_2.TASK_CATEGORIES.join(', ')}`);
+        process.exit(1);
+    }
+    if (program.opts().json) {
+        console.log(JSON.stringify(catBenchmarks));
+        return;
+    }
+    console.log(`\n  Benchmarks for "${name}":`);
+    for (const b of catBenchmarks) {
+        console.log(`  - ${b.task_type}`);
+        console.log(`    Median: ${formatDuration(b.human_median_minutes)}  Fast: ${formatDuration(b.human_p25_minutes)}  Slow: ${formatDuration(b.human_p75_minutes)}`);
+        console.log(`    Source: ${b.source} (${b.year})`);
+    }
+    console.log('');
+});
+// ─── Baseline ───────────────────────────────────────────
+const baseline = program
+    .command('baseline')
+    .description('Manage personal time baselines');
+baseline
+    .command('add')
+    .description('Add a personal baseline')
+    .requiredOption('--category <type>', 'Task category')
+    .requiredOption('--task-type <type>', 'Task type identifier')
+    .requiredOption('--minutes <n>', 'How long this takes you (minutes)', parseFloat)
+    .option('--description <text>', 'Description of the task')
+    .option('-d, --dir <path>', 'Data directory')
+    .action(async (opts) => {
+    const config = loadConfig(resolveDataDir(opts));
+    const clawck = await new clawck_1.Clawck(config).ready();
+    const bl = clawck.addBaseline({
+        category: opts.category,
+        task_type: opts.taskType,
+        description: opts.description || '',
+        my_minutes: opts.minutes,
+    });
+    if (program.opts().json) {
+        console.log(JSON.stringify(bl));
+    }
+    else {
+        console.log(`  Added baseline: ${bl.task_type} (${bl.category}) — ${formatDuration(bl.my_minutes)}`);
+        console.log(`  ID: ${bl.id.slice(0, 8)}`);
+    }
+    clawck.close();
+});
+baseline
+    .command('list')
+    .description('List all personal baselines')
+    .option('-d, --dir <path>', 'Data directory')
+    .action(async (opts) => {
+    const config = loadConfig(resolveDataDir(opts));
+    const clawck = await new clawck_1.Clawck(config).ready();
+    const baselines = clawck.getBaselines();
+    if (program.opts().json) {
+        console.log(JSON.stringify(baselines));
+        clawck.close();
+        return;
+    }
+    if (baselines.length === 0) {
+        console.log('\n  No personal baselines set.');
+        console.log('  Add one: clawck baseline add --category code --task-type code_review --minutes 30\n');
+        clawck.close();
+        return;
+    }
+    console.log(`\n  Personal Baselines:`);
+    for (const b of baselines) {
+        console.log(`  ${b.id.slice(0, 8)}  ${b.category.padEnd(14)} ${b.task_type.padEnd(25)} ${formatDuration(b.my_minutes).padEnd(8)} ${b.description}`);
+    }
+    console.log('');
+    clawck.close();
+});
+baseline
+    .command('remove <id>')
+    .description('Remove a personal baseline')
+    .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 deleted = clawck.removeBaseline(id);
+    if (!deleted) {
+        console.error(`  Baseline not found: ${id}`);
+        clawck.close();
+        process.exit(1);
+    }
+    if (program.opts().json) {
+        console.log(JSON.stringify({ ok: true }));
+    }
+    else {
+        console.log(`  Removed baseline: ${id}`);
+    }
+    clawck.close();
+});
+// ─── Demo ───────────────────────────────────────────────
+program
+    .command('demo')
+    .description('Generate demo data, reports, and start interactive dashboard')
+    .option('-d, --dir <path>', 'Demo data directory', '.clawck-demo')
+    .action(async (opts) => {
+    const demoDir = path_1.default.resolve(opts.dir);
+    if (!fs_1.default.existsSync(demoDir))
+        fs_1.default.mkdirSync(demoDir, { recursive: true });
+    const config = loadConfig(demoDir);
+    config.data_dir = demoDir;
+    const clawck = await new clawck_1.Clawck(config).ready();
+    const { v4: uuid } = await Promise.resolve().then(() => __importStar(require('uuid')));
+    const agents = ['research-agent-01', 'writer-agent-02', 'coder-agent-03', 'analyst-agent-04', 'outreach-agent-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', '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',
+        'Refactor authentication module', 'Migrate legacy CSV data to new schema',
+        'Analyze Q3 customer churn patterns', 'Draft outreach emails for partnership',
+        'Write unit tests for payment flow', 'Design email template for newsletter',
+        'Find relevant grant opportunities', 'Compile industry benchmark report',
+        'Update API documentation', 'Generate social media content calendar',
+        'Review and optimize database queries', 'Create investor pitch deck outline',
+        'Summarize recent industry news', 'Plan sprint roadmap for Q4',
+    ];
+    const pick = (arr) => arr[Math.floor(Math.random() * arr.length)];
+    // Seed 35 completed entries across 14 days
+    for (let i = 0; i < 35; 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 toolCalls = Math.round(Math.random() * 15);
+        const category = i < categories.length ? categories[i] : pick(categories);
+        const end = new Date(Date.now() - daysAgo * 86400000);
+        const start = new Date(end.getTime() - durationMin * 60000);
+        const model = pick(models);
+        clawck.upsert({
+            id: uuid(),
+            task: pick(tasks),
+            project: i < projects.length ? projects[i] : pick(projects),
+            client: i < clients.length ? clients[i] : pick(clients),
+            category,
+            agent: i < agents.length ? agents[i] : pick(agents),
+            model,
+            start: start.toISOString(),
+            end: end.toISOString(),
+            status: 'completed',
+            tokens_in: tokensIn,
+            tokens_out: tokensOut,
+            cost_usd: Math.round((tokensIn * 0.000003 + tokensOut * 0.000015) * 10000) / 10000,
+            tool_calls: toolCalls,
+            summary: 'Demo entry',
+            tags: ['demo'],
+            source: 'clawck-demo',
+            spec_version: '0.2.0',
+            approved: Math.random() < 0.6,
+            agent_runtime_ms: Math.round((tokensOut / 80) * 1000 + toolCalls * 2000),
+            wall_clock_ms: Math.round(durationMin * 60000),
+        });
+    }
+    // Add 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: ['demo'] });
+    }
+    // Add failed entries
+    for (let i = 0; i < 3; i++) {
+        const start = new Date(Date.now() - Math.random() * 7 * 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', tags: ['demo', 'failed'], source: 'clawck-demo', spec_version: '0.2.0',
+        });
+    }
+    // Add personal baselines
+    const baselineData = [
+        { category: 'code', task_type: 'code_review', description: 'Review a pull request', my_minutes: 30 },
+        { category: 'content', task_type: 'blog_post', description: 'Write a 1000-word blog post', my_minutes: 180 },
+        { category: 'research', task_type: 'competitive_analysis', description: 'Analyze competitor landscape', my_minutes: 360 },
+        { category: 'testing', task_type: 'unit_tests', description: 'Write unit tests for a module', my_minutes: 120 },
+        { category: 'communication', task_type: 'meeting_summary', description: 'Summarize a 1-hour meeting', my_minutes: 30 },
+        { category: 'planning', task_type: 'sprint_planning', description: 'Plan a 2-week sprint', my_minutes: 120 },
+    ];
+    for (const bl of baselineData) {
+        clawck.addBaseline(bl);
+    }
+    // Generate HTML report
+    const to = new Date().toISOString();
+    const from = new Date(Date.now() - 14 * 86400000).toISOString();
+    const ts = clawck.timesheet(from, to);
+    const dateRange = `${from.split('T')[0]} to ${to.split('T')[0]}`;
+    const rawEntries = clawck.query({ from, to, limit: 10000 });
+    const htmlPath = path_1.default.join(demoDir, 'clawck-demo-report.html');
+    const html = (0, html_1.generateTimesheetHTML)(ts, { dateRange, rawEntries });
+    fs_1.default.writeFileSync(htmlPath, html);
+    // Generate PDF report
+    const pdfPath = path_1.default.join(demoDir, 'clawck-demo-report.pdf');
+    await (0, pdf_1.generateTimesheetPDF)(ts, { dateRange, outputPath: pdfPath });
+    // Open HTML in browser
+    const opener = process.platform === 'darwin' ? 'open' : 'xdg-open';
+    const { execSync } = await Promise.resolve().then(() => __importStar(require('child_process')));
+    try {
+        execSync(`${opener} "${htmlPath}"`, { stdio: 'ignore' });
+    }
+    catch { }
+    // Start server
+    const { startServer: startDemoServer } = await Promise.resolve().then(() => __importStar(require('../server/api')));
+    const net = await Promise.resolve().then(() => __importStar(require('net')));
+    const port = await new Promise((resolve) => {
+        const srv = net.createServer();
+        srv.listen(0, () => {
+            const addr = srv.address();
+            srv.close(() => resolve(addr.port));
+        });
+    });
+    config.port = port;
+    console.log(`\n  ⏱️🦀 Clawck Demo\n`);
+    console.log(`  Generated reports:`);
+    console.log(`    HTML:  ${htmlPath} (opened in browser)`);
+    console.log(`    PDF:   ${pdfPath}`);
+    console.log(`\n  Dashboard running at: http://localhost:${port}`);
+    console.log(`\n  Try these commands:`);
+    console.log(`    clawck list -d ${demoDir}`);
+    console.log(`    clawck report --format html -d ${demoDir}`);
+    console.log(`    clawck baseline list -d ${demoDir}`);
+    console.log(`    clawck benchmark list`);
+    console.log(`    clawck export --format atp -d ${demoDir}`);
+    console.log(`    clawck entries --approved -d ${demoDir}`);
+    console.log(`\n  Press Ctrl+C to stop the demo server.\n`);
+    // Open dashboard
+    try {
+        execSync(`${opener} "http://localhost:${port}"`, { stdio: 'ignore' });
+    }
+    catch { }
+    await startDemoServer(config);
+});
+// ─── 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)')
+    .option('--verbose', 'Log received stdin JSON to stderr for debugging')
+    .action(async (opts) => {
+    try {
+        const raw = await (0, hooks_1.readStdin)();
+        if (opts.verbose)
+            process.stderr.write(`clawck: hook start stdin: ${raw}\n`);
+        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);
+        if (opts.verbose)
+            process.stderr.write(`clawck: hook start context: ${JSON.stringify(context)}\n`);
+        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)')
+    .option('--verbose', 'Log received stdin JSON to stderr for debugging')
+    .action(async (opts) => {
+    try {
+        const raw = await (0, hooks_1.readStdin)();
+        if (opts.verbose)
+            process.stderr.write(`clawck: hook stop stdin: ${raw}\n`);
+        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);
+        if (opts.verbose)
+            process.stderr.write(`clawck: hook stop context: ${JSON.stringify(context)}\n`);
+        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 +1475,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 +1485,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 +1526,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,