clawck 0.3.0 → 0.4.1

package/dist/cli/index.js

@@ -57,13 +57,17 @@ 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.3.0')
+    .version('0.4.0')
     .enablePositionalOptions()
     .option('--json', 'Output as JSON (for scripting/pipelines)')
     .option('-d, --dir <path>', 'Data directory (also: CLAWCK_DIR env var)');
@@ -133,7 +137,7 @@ program
     .option('-d, --dir <path>', 'Data directory')
     .action(async (opts) => {
     const config = loadConfig(resolveDataDir(opts));
-    (0, mcp_1.startMCPServer)(config);
+    await (0, mcp_1.startMCPServer)(config);
 });
 // ─── Status ───────────────────────────────────────────────
 program
@@ -168,40 +172,54 @@ program
     clawck.close();
 });
 // ─── Report ───────────────────────────────────────────────
-program
+const reportCmd = program
     .command('report')
     .description('Show a timesheet summary')
     .option('-d, --dir <path>', 'Data directory')
-    .option('--days <number>', 'Number of days to include', '7')
+    .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 format)')
+    .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(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 });
+        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}`);
-        clawck.close();
-        return;
     }
-    if (opts.format === 'pdf') {
+    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]}`;
@@ -209,43 +227,165 @@ program
             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(reports));
         clawck.close();
         return;
     }
-    if (program.opts().json) {
-        console.log(JSON.stringify(ts));
+    if (reports.length === 0) {
+        console.log('\n  No saved reports.\n');
         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`);
-        }
+    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]}`);
     }
-    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('');
+    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.detailed) {
-        const entries = clawck.query({ client: opts.client, project: opts.project, agent: opts.agent, from, to, limit: 500 });
-        console.log(`\n  📝 Entries:`);
-        printEntryTable(entries);
+    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.`);
     }
-    console.log('');
     clawck.close();
 });
 // ─── Start ───────────────────────────────────────────────
@@ -324,7 +464,10 @@ program
     }
     else {
         console.log(`  Stopped: ${entry.task}`);
-        console.log(`  Duration: ${duration_minutes !== null ? formatDuration(duration_minutes) : 'unknown'}  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();
 });
@@ -630,7 +773,7 @@ program
     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', 'umbrella-co'];
     const projects = ['website-rebuild', 'seo-content', 'grant-research', 'data-migration', 'email-campaigns', 'api-v2'];
@@ -719,7 +862,7 @@ program
             summary: 'Task failed - auto-generated seed entry',
             tags: ['seed', 'failed'],
             source: 'clawck',
-            spec_version: '0.1.0',
+            spec_version: types_1.SPEC_VERSION,
         });
     }
     console.log(`\n  ⏱️🦀 Seeded ${count + 6} entries into Clawck!`);
@@ -846,9 +989,9 @@ program
 // ─── Export ──────────────────────────────────────────────
 program
     .command('export')
-    .description('Export time entries as JSON or CSV')
+    .description('Export time entries as JSON, CSV, or ATP envelope')
     .option('-d, --dir <path>', 'Data directory')
-    .option('--format <type>', 'Output format (json or csv)', 'json')
+    .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')
@@ -867,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')) {
@@ -905,6 +1055,269 @@ 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')
@@ -914,9 +1327,12 @@ hook
     .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 {
@@ -928,6 +1344,8 @@ hook
         }
         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);
     }
@@ -942,9 +1360,12 @@ hook
     .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 {
@@ -956,6 +1377,8 @@ hook
         }
         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);
     }