sidecar-cli 0.1.0-beta.4

package/dist/services/summary-service.js

@@ -0,0 +1,68 @@
+import fs from 'node:fs';
+import { nowIso } from '../lib/format.js';
+import { getSidecarPaths } from '../lib/paths.js';
+import { renderSummaryMarkdown } from '../templates/summary.js';
+import { createEvent } from './event-service.js';
+export function readSummaryInputs(db, projectId, limit) {
+    const project = db.prepare(`SELECT name, root_path FROM projects WHERE id = ?`).get(projectId);
+    const decisions = db
+        .prepare(`SELECT created_at, title, summary FROM events WHERE project_id = ? AND type = 'decision' ORDER BY created_at DESC LIMIT ?`)
+        .all(projectId, limit);
+    const worklogs = db
+        .prepare(`SELECT created_at, title, summary FROM events WHERE project_id = ? AND type = 'worklog' ORDER BY created_at DESC LIMIT ?`)
+        .all(projectId, limit);
+    const notes = db
+        .prepare(`SELECT created_at, title, summary FROM events WHERE project_id = ? AND type = 'note' ORDER BY created_at DESC LIMIT ?`)
+        .all(projectId, limit);
+    const openTasks = db
+        .prepare(`SELECT id, title, priority, updated_at FROM tasks WHERE project_id = ? AND status = 'open' ORDER BY updated_at DESC LIMIT ?`)
+        .all(projectId, limit);
+    const artifacts = db
+        .prepare(`SELECT path, kind, note, created_at FROM artifacts WHERE project_id = ? ORDER BY created_at DESC LIMIT ?`)
+        .all(projectId, limit);
+    const activeSession = db
+        .prepare(`SELECT id, started_at, actor_type, actor_name FROM sessions WHERE project_id = ? AND ended_at IS NULL ORDER BY started_at DESC LIMIT 1`)
+        .get(projectId);
+    const recentEventCount = db
+        .prepare(`SELECT COUNT(*) as count FROM events WHERE project_id = ? AND created_at >= datetime('now', '-7 day')`)
+        .get(projectId).count;
+    return {
+        projectName: project.name,
+        projectPath: project.root_path,
+        decisions,
+        worklogs,
+        notes,
+        openTasks,
+        artifacts,
+        activeSession: activeSession ?? null,
+        recentEventCount,
+    };
+}
+export function refreshSummaryFile(db, rootPath, projectId, limit = 10) {
+    const sidecarPaths = getSidecarPaths(rootPath);
+    const data = readSummaryInputs(db, projectId, limit);
+    const generatedAt = nowIso();
+    const markdown = renderSummaryMarkdown({
+        projectName: data.projectName,
+        projectPath: data.projectPath,
+        generatedAt,
+        activeSession: data.activeSession,
+        recentEventCount: data.recentEventCount,
+        decisions: data.decisions,
+        worklogs: data.worklogs,
+        notes: data.notes,
+        openTasks: data.openTasks,
+        artifacts: data.artifacts,
+    });
+    fs.writeFileSync(sidecarPaths.summaryPath, markdown);
+    const eventId = createEvent(db, {
+        projectId,
+        type: 'summary_generated',
+        title: 'Summary refreshed',
+        summary: 'Regenerated .sidecar/summary.md from local records',
+        source: 'generated',
+        createdBy: 'system',
+        details: { limit, path: sidecarPaths.summaryPath },
+    });
+    return { path: sidecarPaths.summaryPath, eventId, generatedAt };
+}

package/dist/services/task-service.js

@@ -0,0 +1,54 @@
+import { nowIso } from '../lib/format.js';
+import { createEvent } from './event-service.js';
+export function addTask(db, input) {
+    const ts = nowIso();
+    const info = db
+        .prepare(`
+      INSERT INTO tasks (project_id, title, description, status, priority, created_at, updated_at, closed_at, origin_event_id)
+      VALUES (?, ?, ?, 'open', ?, ?, ?, NULL, NULL)
+    `)
+        .run(input.projectId, input.title, input.description ?? null, input.priority ?? 'medium', ts, ts);
+    const taskId = Number(info.lastInsertRowid);
+    const eventId = createEvent(db, {
+        projectId: input.projectId,
+        type: 'task_created',
+        title: `Task #${taskId} created`,
+        summary: input.title,
+        details: { taskId, description: input.description ?? null, priority: input.priority ?? 'medium' },
+        createdBy: input.by,
+    });
+    db.prepare(`UPDATE tasks SET origin_event_id = ? WHERE id = ?`).run(eventId, taskId);
+    return { taskId, eventId };
+}
+export function markTaskDone(db, input) {
+    const existing = db
+        .prepare(`SELECT id, title, status FROM tasks WHERE project_id = ? AND id = ?`)
+        .get(input.projectId, input.taskId);
+    if (!existing) {
+        return { ok: false, reason: 'Task not found' };
+    }
+    if (existing.status === 'done') {
+        return { ok: false, reason: 'Task is already done' };
+    }
+    const ts = nowIso();
+    db.prepare(`UPDATE tasks SET status = 'done', updated_at = ?, closed_at = ? WHERE id = ?`).run(ts, ts, input.taskId);
+    const eventId = createEvent(db, {
+        projectId: input.projectId,
+        type: 'task_completed',
+        title: `Task #${input.taskId} completed`,
+        summary: existing.title,
+        details: { taskId: input.taskId },
+        createdBy: input.by,
+    });
+    return { ok: true, eventId };
+}
+export function listTasks(db, input) {
+    if (input.status === 'all') {
+        return db
+            .prepare(`SELECT * FROM tasks WHERE project_id = ? ORDER BY CASE WHEN status = 'open' THEN 0 ELSE 1 END, updated_at DESC`)
+            .all(input.projectId);
+    }
+    return db
+        .prepare(`SELECT * FROM tasks WHERE project_id = ? AND status = ? ORDER BY updated_at DESC`)
+        .all(input.projectId, input.status);
+}

package/dist/templates/agents.js

@@ -0,0 +1,38 @@
+export function renderAgentsMarkdown(projectName) {
+    return `# Sidecar Agent Guide
+
+Sidecar is the local project memory tool for this repository.
+
+## Required workflow
+
+1. Run \`sidecar context --format markdown\`.
+2. Do the work.
+3. Record updates:
+   - decision: \`sidecar decision record ...\`
+   - worklog: \`sidecar worklog record ...\`
+   - follow-up task: \`sidecar task add ...\`
+4. Run \`sidecar summary refresh\`.
+
+## Commands to use
+
+- Context: \`sidecar context --format markdown\`
+- Decision: \`sidecar decision record --title "<title>" --summary "<summary>" --by agent\`
+- Worklog: \`sidecar worklog record --done "<what changed>" --files src/a.ts,src/b.ts --by agent\`
+- Task: \`sidecar task add "<follow-up>" --priority medium --by agent\`
+- Summary: \`sidecar summary refresh\`
+
+## Example workflow
+
+\`\`\`bash
+sidecar context --format markdown
+sidecar session start --actor agent --name codex
+sidecar decision record --title "Choose SQLite" --summary "Local, deterministic storage" --by agent
+sidecar worklog record --goal "Refactor context output" --done "Improved markdown and json context payload" --files src/cli.ts,src/services/context-service.ts --by agent
+sidecar task add "Add integration test for context output" --priority medium --by agent
+sidecar summary refresh
+sidecar session end --summary "Context and summary updates complete"
+\`\`\`
+
+Project: ${projectName}.
+`;
+}

package/dist/templates/summary.js

@@ -0,0 +1,52 @@
+export function renderSummaryMarkdown(input) {
+    const lines = [];
+    lines.push('# Project Summary');
+    lines.push('');
+    lines.push(`Generated: ${input.generatedAt}`);
+    lines.push('');
+    lines.push('## Overview');
+    lines.push(`- Project: ${input.projectName}`);
+    lines.push(`- Path: ${input.projectPath}`);
+    lines.push(`- Events in last 7 days: ${input.recentEventCount}`);
+    lines.push(`- Open tasks: ${input.openTasks.length}`);
+    lines.push('');
+    lines.push('## Active Session');
+    if (!input.activeSession) {
+        lines.push('- None');
+    }
+    else {
+        lines.push(`- #${input.activeSession.id} (${input.activeSession.actor_type}${input.activeSession.actor_name ? `: ${input.activeSession.actor_name}` : ''}) started ${input.activeSession.started_at}`);
+    }
+    lines.push('');
+    lines.push('## Recent Decisions');
+    if (input.decisions.length === 0)
+        lines.push('- None');
+    for (const d of input.decisions)
+        lines.push(`- ${d.created_at} | ${d.title}: ${d.summary}`);
+    lines.push('');
+    lines.push('## Recent Work');
+    if (input.worklogs.length === 0)
+        lines.push('- None');
+    for (const w of input.worklogs)
+        lines.push(`- ${w.created_at} | ${w.title}: ${w.summary}`);
+    lines.push('');
+    lines.push('## Open Tasks');
+    if (input.openTasks.length === 0)
+        lines.push('- None');
+    for (const t of input.openTasks)
+        lines.push(`- #${t.id} [${t.priority ?? 'n/a'}] ${t.title}`);
+    lines.push('');
+    lines.push('## Recent Notes');
+    if (input.notes.length === 0)
+        lines.push('- None');
+    for (const n of input.notes)
+        lines.push(`- ${n.created_at} | ${n.title}: ${n.summary}`);
+    lines.push('');
+    lines.push('## Artifacts');
+    if (input.artifacts.length === 0)
+        lines.push('- None');
+    for (const a of input.artifacts)
+        lines.push(`- ${a.created_at} | ${a.kind} | ${a.path}${a.note ? ` - ${a.note}` : ''}`);
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/types/models.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "sidecar-cli",
+  "version": "0.1.0-beta.4",
+  "description": "Local-first project memory and recording tool",
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "node -e \"console.log('No tests configured')\"",
+    "pack_release": "node scripts/create-release-tarball.mjs",
+    "clean": "node scripts/clean-dist.mjs",
+    "release_check": "node scripts/release-check.mjs",
+    "release:cut": "node scripts/cut-release.mjs",
+    "release:stable": "node scripts/cut-release.mjs --channel stable",
+    "release:beta": "node scripts/cut-release.mjs --channel beta",
+    "release:rc": "node scripts/cut-release.mjs --channel rc"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "private": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.8.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "bin": {
+    "sidecar": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}