@workscribe/cli 1.6.2 → 1.7.1

package/README.md

@@ -29,7 +29,7 @@ shell hook → capture → SQLite → session grouper → AI provider → markdo
 
 | Dependency | Version | Notes |
 |---|---|---|
-| Node.js | **22 or later** | Uses the built-in `node:sqlite` module — not available in Node 20 or earlier |
+| Node.js | **22 or later** | Uses the built-in `node:sqlite` module introduced in Node 22.5 |
 | Shell | zsh or bash | Hook is appended to `~/.zshrc` or `~/.bashrc` by `workscribe init` |
 | OS | macOS or Linux | Windows is not supported — the shell hook requires zsh or bash. WSL2 works. |
 
@@ -47,6 +47,21 @@ source ~/.zshrc   # or restart your terminal
 
 `workscribe init` walks you through choosing an AI provider, installs the shell hook, and offers to install a Claude Code session capture hook if Claude Code is detected. Safe to re-run — updates outdated hooks and skips steps already complete.
 
+## Uninstalling
+
+If the CLI is still installed:
+
+```bash
+workscribe uninstall        # removes shell hooks, optionally deletes ~/.workscribe/
+npm uninstall -g @workscribe/cli
+```
+
+If you've already removed the binary and still see `_workscribe_precmd` errors in your terminal, remove the hook block manually:
+
+1. Open `~/.zshrc` (or `~/.bashrc`)
+2. Delete everything between `# workscribe:hook:start` and `# workscribe:hook:end` (inclusive)
+3. Run `source ~/.zshrc` or restart your terminal
+
 ## AI providers
 
 Workscribe works with any of these — switch at any time via config:
@@ -68,14 +83,22 @@ workscribe config set ai.apiKey <your-key>
 
 | Command | Description |
 |---|---|
+| `workscribe init` | Set up Workscribe, install shell hooks, configure AI provider |
+| `workscribe uninstall` | Remove shell hooks and optionally delete all local data |
 | `workscribe summary` | Generate today's work summary |
 | `workscribe summary --date 2026-05-20` | Summary for a specific date |
 | `workscribe summary --week` | Summary for the current week |
 | `workscribe summary --fresh` | Bypass cache and regenerate |
 | `workscribe summary --slack` | Post summary to configured Slack channel |
-| `workscribe sessions` | List detected work sessions |
-| `workscribe events` | List captured events |
+| `workscribe summary --webhook <url>` | Post summary to a custom webhook URL |
+| `workscribe sessions` | List detected work sessions for today |
+| `workscribe sessions --date 2026-05-20` | Sessions for a specific date |
+| `workscribe events` | List captured events for today |
+| `workscribe events --date 2026-05-20` | Events for a specific date |
+| `workscribe events --limit 20` | Show only the most recent N events |
 | `workscribe export` | Save today's summary as a markdown file |
+| `workscribe export --date 2026-05-20` | Export summary for a specific date |
+| `workscribe export --output <path>` | Write to a custom file path |
 | `workscribe status` | Check capture is active and show event counts |
 | `workscribe undo` | Remove the last captured event |
 | `workscribe undo -n 5` | Remove the last 5 captured events |
@@ -83,9 +106,11 @@ workscribe config set ai.apiKey <your-key>
 | `workscribe clear` | Delete all captured events for today |
 | `workscribe clear --date 2026-05-20` | Delete all events for a specific date |
 | `workscribe clear --dry-run` | Preview what would be cleared without deleting |
+| `workscribe clear --yes` | Skip the confirmation prompt |
 | `workscribe pause` | Pause capture temporarily |
 | `workscribe resume` | Resume capture after a pause |
 | `workscribe config` | View current configuration |
+| `workscribe config get KEY` | Print a single config value |
 | `workscribe config set KEY VALUE` | Update a config value |
 
 ## Privacy
@@ -102,16 +127,33 @@ workscribe config set ai.apiKey <your-key>
 workscribe config set session.idleTimeout 20       # minutes before a new session starts (default: 30)
 workscribe config set ai.model gpt-4o              # override the default model for your provider
 workscribe config set redact.extra "MY_PATTERN"    # add a custom redaction regex
+workscribe config set summary.format json          # output summary as JSON instead of markdown
+workscribe config set capture.ignore "mycommand"   # suppress a command from being captured
 
 # Override the display name for a local clone whose folder name differs from the repo
 workscribe config set projects./Users/me/sandbox/myrepo actual-repo-name
 
 # Post summaries to Slack or a custom webhook
 workscribe config set integrations.slackWebhook https://hooks.slack.com/services/...
+workscribe config set integrations.webhook https://custom.endpoint/hook   # persistent default webhook
 workscribe summary --slack
-workscribe summary --webhook https://custom.endpoint/hook
+workscribe summary --webhook https://custom.endpoint/hook                 # one-off override
 ```
 
+| Config key | Default | Description |
+|---|---|---|
+| `ai.provider` | — | AI provider: `anthropic`, `openai`, `ollama`, `openai-compatible` |
+| `ai.apiKey` | — | API key for the configured provider |
+| `ai.model` | provider default | Model name override |
+| `ai.baseUrl` | — | Base URL for `openai-compatible` providers |
+| `session.idleTimeout` | `30` | Minutes of inactivity before a new session starts |
+| `capture.ignore` | common shell builtins | Commands to exclude from capture |
+| `redact.extra` | `[]` | Additional regex patterns to redact from captured commands |
+| `summary.format` | `markdown` | Output format: `markdown` or `json` |
+| `integrations.slackWebhook` | — | Slack incoming webhook URL |
+| `integrations.webhook` | — | Default webhook URL for `--webhook` |
+| `projects.<path>` | — | Display name override for a repo by absolute path |
+
 ## Slack integration
 
 Post your daily or weekly summary directly to a Slack channel:

package/dist/index.js

@@ -30,6 +30,7 @@ var import_commander = require("commander");
 var import_fs4 = __toESM(require("fs"));
 
 // src/db/index.ts
+var import_node_sqlite = require("node:sqlite");
 var import_fs = __toESM(require("fs"));
 
 // src/utils/paths.ts
@@ -43,42 +44,11 @@ var EXPORTS_DIR = import_path.default.join(WORKSCRIBE_DIR, "exports");
 var PAUSE_FLAG_PATH = import_path.default.join(WORKSCRIBE_DIR, "paused");
 var WEEKLY_CACHE_DIR = import_path.default.join(WORKSCRIBE_DIR, "weekly-cache");
 
-// src/db/adapter.ts
-function openDatabase(path9) {
-  try {
-    const { DatabaseSync } = require(node:sqlite);
-    return new DatabaseSync(path9);
-  } catch {
-  }
-  try {
-    const Database = require("better-sqlite3");
-    return new Database(path9);
-  } catch {
-  }
-  throw new Error(
-    "workscribe requires a SQLite driver.\n  Node 22.5+: node:sqlite is used automatically (no action needed).\n  Node 20\u201321: install the optional peer dependency:\n    npm install better-sqlite3"
-  );
-}
-
-// src/db/index.ts
-var _db = null;
-function getDb() {
-  if (_db) return _db;
-  if (!import_fs.default.existsSync(WORKSCRIBE_DIR)) {
-    import_fs.default.mkdirSync(WORKSCRIBE_DIR, { recursive: true });
-  }
-  _db = openDatabase(DB_PATH);
-  try {
-    import_fs.default.chmodSync(DB_PATH, 384);
-  } catch {
-  }
-  _db.exec("PRAGMA journal_mode = WAL");
-  _db.exec("PRAGMA foreign_keys = ON");
-  runMigrations(_db);
-  return _db;
-}
-function runMigrations(db) {
-  db.exec(`
+// src/db/migrations/001_initial_schema.ts
+var initial_schema_default = {
+  version: 1,
+  description: "initial schema",
+  sql: `
     CREATE TABLE IF NOT EXISTS events (
       id          INTEGER PRIMARY KEY AUTOINCREMENT,
       captured_at TEXT    NOT NULL,
@@ -112,7 +82,64 @@ function runMigrations(db) {
       event_id    INTEGER NOT NULL REFERENCES events(id),
       PRIMARY KEY (session_id, event_id)
     );
+  `
+};
+
+// src/db/migrations/index.ts
+var MIGRATIONS = [initial_schema_default];
+
+// src/db/index.ts
+var _db = null;
+function getDb() {
+  if (_db) return _db;
+  if (!import_fs.default.existsSync(WORKSCRIBE_DIR)) {
+    import_fs.default.mkdirSync(WORKSCRIBE_DIR, { recursive: true });
+  }
+  const db = new import_node_sqlite.DatabaseSync(DB_PATH);
+  try {
+    import_fs.default.chmodSync(DB_PATH, 384);
+  } catch {
+  }
+  db.exec("PRAGMA journal_mode = WAL");
+  db.exec("PRAGMA foreign_keys = ON");
+  applyMigrations(db);
+  _db = db;
+  return _db;
+}
+function applyMigrations(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS schema_migrations (
+      version    INTEGER PRIMARY KEY,
+      applied_at TEXT    NOT NULL DEFAULT (datetime('now'))
+    )
   `);
+  const hasEvents = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='events'").get();
+  const hasVersion1 = db.prepare("SELECT version FROM schema_migrations WHERE version = 1").get();
+  if (hasEvents && !hasVersion1) {
+    db.prepare("INSERT INTO schema_migrations (version, applied_at) VALUES ($version, datetime('now'))").run({
+      version: 1
+    });
+  }
+  const applied = new Set(
+    db.prepare("SELECT version FROM schema_migrations").all().map((r) => r.version)
+  );
+  for (const migration of MIGRATIONS) {
+    if (applied.has(migration.version)) continue;
+    db.exec("BEGIN");
+    try {
+      db.exec(migration.sql);
+      db.prepare("INSERT INTO schema_migrations (version, applied_at) VALUES ($version, datetime('now'))").run({
+        version: migration.version
+      });
+      db.exec("COMMIT");
+    } catch (err) {
+      try {
+        db.exec("ROLLBACK");
+      } catch {
+      }
+      throw new Error(`Migration ${migration.version} (${migration.description}) failed: ${err.message}`);
+    }
+  }
 }
 function insertEvent(params) {
   const db = getDb();
@@ -131,7 +158,7 @@ function getEventsForDate(date) {
   const db = getDb();
   const stmt = db.prepare(`
     SELECT * FROM events
-    WHERE date(captured_at) = $date
+    WHERE date(captured_at, 'localtime') = $date
     ORDER BY captured_at ASC
   `);
   return stmt.all({ date });
@@ -158,6 +185,16 @@ function insertSessionEvent(sessionId, eventId) {
   `);
   stmt.run({ session_id: sessionId, event_id: eventId });
 }
+function getEventsBySessionId(sessionId) {
+  const db = getDb();
+  const stmt = db.prepare(`
+    SELECT e.* FROM events e
+    INNER JOIN session_events se ON se.event_id = e.id
+    WHERE se.session_id = $session_id
+    ORDER BY e.captured_at ASC
+  `);
+  return stmt.all({ session_id: sessionId });
+}
 function getSessionsForDate(date) {
   const db = getDb();
   const stmt = db.prepare("SELECT * FROM sessions WHERE date = $date ORDER BY started_at ASC");
@@ -183,7 +220,7 @@ function deleteEventsByIds(ids) {
   if (ids.length === 0) return;
   const db = getDb();
   const placeholders = ids.map(() => "?").join(", ");
-  const affectedDates = db.prepare(`SELECT DISTINCT date(captured_at) as date FROM events WHERE id IN (${placeholders})`).all(...ids);
+  const affectedDates = db.prepare(`SELECT DISTINCT date(captured_at, 'localtime') as date FROM events WHERE id IN (${placeholders})`).all(...ids);
   db.prepare(`DELETE FROM events WHERE id IN (${placeholders})`).run(...ids);
   for (const { date } of affectedDates) {
     clearSessionsForDate(date);
@@ -683,6 +720,7 @@ function captureCommand(opts) {
   const nameOverride = config.projects?.[cwd] ?? null;
   const { repoName, branch } = getGitContext(cwd, nameOverride);
   const { category, metadata } = normalizeCommand(safeCommand);
+  if (opts.source) metadata.source = opts.source;
   if (category === "ai_session" && opts.gitBefore) {
     const commits = getCommitsSince(opts.gitBefore, cwd);
     if (commits.length > 0) metadata.commits = commits;
@@ -750,7 +788,7 @@ function parseHookPayload(raw) {
   return { command, cwd };
 }
 function registerHook(program2) {
-  program2.command("_hook").description("Internal: capture events from AI tool hooks (stdin JSON payload)").option("--source <source>", "hook source identifier (e.g. claude-code)").action(() => {
+  program2.command("_hook").description("Internal: capture events from AI tool hooks (stdin JSON payload)").option("--source <source>", "hook source identifier (e.g. claude-code)").action((opts) => {
     let raw = "";
     process.stdin.setEncoding("utf-8");
     process.stdin.on("data", (chunk) => {
@@ -760,7 +798,13 @@ function registerHook(program2) {
       try {
         const parsed = parseHookPayload(raw);
         if (!parsed) return;
-        captureCommand({ command: parsed.command, cwd: parsed.cwd, exitCode: null, durationMs: null });
+        captureCommand({
+          command: parsed.command,
+          cwd: parsed.cwd,
+          exitCode: null,
+          durationMs: null,
+          source: opts.source
+        });
       } catch (err) {
         debugLog("_hook", err);
       }
@@ -780,6 +824,7 @@ var import_fs6 = __toESM(require("fs"));
 var import_path3 = __toESM(require("path"));
 var HOOK_START = "# workscribe:hook:start";
 var HOOK_END = "# workscribe:hook:end";
+var HOOK_PREAMBLE = "# Workscribe \u2014 developer work journal";
 function getInstalledHookBlock(rcFile) {
   if (!import_fs6.default.existsSync(rcFile)) return null;
   const content = import_fs6.default.readFileSync(rcFile, "utf-8");
@@ -820,7 +865,9 @@ function removeHook(rcFile) {
   const content = import_fs6.default.readFileSync(rcFile, "utf-8");
   const startIdx = content.indexOf(HOOK_START);
   const endIdx = content.indexOf(HOOK_END) + HOOK_END.length;
-  const before = content.slice(0, startIdx).replace(/\n+$/, "\n");
+  const preambleIdx = content.lastIndexOf(HOOK_PREAMBLE, startIdx);
+  const blockStart = preambleIdx !== -1 ? preambleIdx : startIdx;
+  const before = content.slice(0, blockStart).replace(/\n+$/, "\n");
   const after = content.slice(endIdx).replace(/^\n/, "");
   import_fs6.default.writeFileSync(rcFile, before + after);
 }
@@ -1043,7 +1090,7 @@ function formatDate(isoString) {
   return new Date(isoString).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
 }
 function todayDate() {
-  return (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return localDateStr(/* @__PURE__ */ new Date());
 }
 function parseDate(input) {
   const d = /* @__PURE__ */ new Date(input + "T00:00:00");
@@ -1237,14 +1284,17 @@ function getOrBuildSessions(date) {
       durationMinutes: minutesBetween(s.started_at, s.ended_at),
       eventCount: s.event_count,
       summary: s.summary,
-      events: []
-      // not needed when using cached
+      events: getEventsBySessionId(s.id)
     }));
   }
+  const savedSummaries = /* @__PURE__ */ new Map();
+  for (const s of existing) {
+    if (s.summary) savedSummaries.set(`${s.repo_name}|${s.started_at}`, s.summary);
+  }
   clearSessionsForDate(date);
-  return buildSessions(date, events);
+  return buildSessions(date, events, savedSummaries);
 }
-function buildSessions(date, events) {
+function buildSessions(date, events, savedSummaries = /* @__PURE__ */ new Map()) {
   const config = readConfig();
   const idleMs = config.session.idleTimeout * 60 * 1e3;
   const sessions = [];
@@ -1257,13 +1307,14 @@ function buildSessions(date, events) {
       const first = repoGroup[0];
       const last = repoGroup[repoGroup.length - 1];
       const repoName = last.repo_name ?? first.repo_name ?? null;
+      const summary = savedSummaries.get(`${repoName}|${first.captured_at}`) ?? null;
       const sessionId = insertSession({
         date,
         started_at: first.captured_at,
         ended_at: last.captured_at,
         repo_name: repoName,
         event_count: repoGroup.length,
-        summary: null
+        summary
       });
       for (const event of repoGroup) {
         insertSessionEvent(sessionId, event.id);
@@ -1276,7 +1327,7 @@ function buildSessions(date, events) {
         repoName,
         durationMinutes: minutesBetween(first.captured_at, last.captured_at),
         eventCount: repoGroup.length,
-        summary: null,
+        summary,
         events: repoGroup
       });
     }
@@ -1940,7 +1991,12 @@ function registerConfig(program2) {
     if (value === void 0) {
       log.warn(`Key not found: ${key}`);
     } else {
-      log.plain(String(value));
+      const lastSegment = key.split(".").pop() ?? "";
+      if (SENSITIVE_KEYS.has(lastSegment) && typeof value === "string" && value.length > 0) {
+        log.plain(`${value.slice(0, 4)}${"*".repeat(8)} (${value.length} chars)`);
+      } else {
+        log.plain(String(value));
+      }
     }
   });
 }
@@ -2088,7 +2144,7 @@ function detectShellRcFiles() {
   return candidates.filter((c) => import_fs13.default.existsSync(c.rcFile) && isHookInstalled(c.rcFile));
 }
 function registerUninstall(program2) {
-  program2.command("uninstall").description("Remove shell hooks and optionally delete all Workscribe data").action(async () => {
+  program2.command("uninstall").description("Remove shell hooks and optionally delete all Workscribe data").option("--hooks-only", "remove shell hooks only, skip data deletion prompt (used by npm preuninstall)").action(async (opts) => {
     log.plain(import_chalk9.default.bold("\n  Workscribe \u2014 Uninstall\n"));
     const hooked = detectShellRcFiles();
     if (hooked.length === 0) {
@@ -2103,6 +2159,7 @@ function registerUninstall(program2) {
         );
       }
     }
+    if (opts.hooksOnly) return;
     if (import_fs13.default.existsSync(WORKSCRIBE_DIR)) {
       log.plain("");
       const { deleteData } = await (0, import_prompts3.default)({
@@ -2126,7 +2183,7 @@ function registerUninstall(program2) {
 
 // src/index.ts
 var program = new import_commander.Command();
-program.name("workscribe").description("Automatic developer work journal").version("1.6.2");
+program.name("workscribe").description("Automatic developer work journal").version("1.7.1");
 registerCapture(program);
 registerHook(program);
 registerInit(program);