@workscribe/cli 1.10.0 → 1.11.0

package/dist/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env -S node --disable-warning=ExperimentalWarning
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -26,6 +26,20 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/index.ts
 var import_commander = require("commander");
 
+// src/utils/node-version.ts
+function assertNodeVersion(nodeVersion) {
+  const major = Number(nodeVersion.split(".")[0]);
+  if (major < 22) {
+    process.stderr.write(
+      `workscribe requires Node.js 22 or later (you have v${nodeVersion}).
+Upgrade at https://nodejs.org or via your version manager:
+  nvm install 22 && nvm use 22
+`
+    );
+    process.exit(1);
+  }
+}
+
 // src/capture/index.ts
 var import_fs9 = __toESM(require("fs"));
 
@@ -307,7 +321,10 @@ var BUILTIN_PATTERNS = [
   // Values after long-form secret flags (single-char flags like -t/-p/-k are too ambiguous)
   /(?<=--(password|passwd|secret|token|key|api[-_]?key|auth[-_]?token)\s+)\S+/gi,
   // export VAR=VALUE where VAR looks sensitive
-  /(?<=export\s+(?:[A-Z_]*(?:TOKEN|SECRET|KEY|PASSWORD|PASS|AUTH|CREDENTIAL)[A-Z_]*)=)\S+/gi
+  /(?<=export\s+(?:[A-Z_]*(?:TOKEN|SECRET|KEY|PASSWORD|PASS|AUTH|CREDENTIAL)[A-Z_]*)=)\S+/gi,
+  // Inline assignment: VAR_WITH_SENSITIVE_KEYWORD=value cmd  (e.g. API_KEY=secret npm start)
+  // Lookbehind matches only the variable-name= prefix, so only the value is replaced
+  /(?<=[A-Z_][A-Z0-9_]*(?:TOKEN|SECRET|KEY|PASSWORD|PASS|AUTH|CREDENTIAL)[A-Z0-9_]*=)\S+/gi
 ];
 function redact(command, extraPatterns = []) {
   let result = command;
@@ -1059,8 +1076,11 @@ function captureCommand(opts) {
 }
 
 // src/cli/capture.ts
+var CAPTURE_HANG_TIMEOUT_MS = 5e3;
 function registerCapture(program2) {
   program2.command("_capture").description("Internal: capture a shell command event (called by shell hook)").option("--cmd <command>", "command that was executed").option("--cwd <path>", "working directory").option("--exit <code>", "exit code", parseInt).option("--duration <ms>", "duration in milliseconds", parseInt).option("--git-before <sha>", "git HEAD SHA before this command ran").action((opts) => {
+    const hangGuard = setTimeout(() => process.exit(0), CAPTURE_HANG_TIMEOUT_MS);
+    hangGuard.unref();
     try {
       if (!opts.cmd || !opts.cwd) return;
       captureCommand({
@@ -1119,6 +1139,404 @@ var import_os4 = __toESM(require("os"));
 var import_prompts = __toESM(require("prompts"));
 var import_chalk2 = __toESM(require("chalk"));
 
+// src/utils/format.ts
+function formatDuration(minutes) {
+  if (minutes < 60) return `${Math.round(minutes)}m`;
+  const h = Math.floor(minutes / 60);
+  const m = Math.round(minutes % 60);
+  return m > 0 ? `${h}h ${m}m` : `${h}h`;
+}
+function formatDate(isoString) {
+  return new Date(isoString).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+}
+function todayDate() {
+  return localDateStr(/* @__PURE__ */ new Date());
+}
+function parseDate(input) {
+  const d = /* @__PURE__ */ new Date(input + "T00:00:00");
+  if (isNaN(d.getTime())) throw new Error(`Invalid date: ${input}`);
+  return input;
+}
+function localDateStr(d) {
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+function startOfWeek(dateStr) {
+  const d = /* @__PURE__ */ new Date(dateStr + "T00:00:00");
+  const day = d.getDay();
+  const diff = day === 0 ? -6 : 1 - day;
+  d.setDate(d.getDate() + diff);
+  return localDateStr(d);
+}
+function eachDayOfRange(start, end) {
+  const days = [];
+  const cur = /* @__PURE__ */ new Date(start + "T00:00:00");
+  const last = /* @__PURE__ */ new Date(end + "T00:00:00");
+  while (cur <= last) {
+    days.push(localDateStr(cur));
+    cur.setDate(cur.getDate() + 1);
+  }
+  return days;
+}
+function isoWeekKey(dateStr) {
+  const d = /* @__PURE__ */ new Date(dateStr + "T00:00:00");
+  const jan4 = new Date(d.getFullYear(), 0, 4);
+  const weekNum = Math.ceil(((d.getTime() - jan4.getTime()) / 864e5 + jan4.getDay() + 1) / 7);
+  return `${d.getFullYear()}-W${String(weekNum).padStart(2, "0")}`;
+}
+
+// src/ai/prompt.ts
+var SYSTEM_PROMPT = `You write short developer work summaries. Focus on what the developer accomplished and what changed \u2014 not which tools or commands were used.
+
+Here is an example:
+
+INPUT:
+Project: api-service
+Branch: feature/auth
+Duration: 2h 00m
+Events:
+  - versioning {"branch":"feature/auth"}
+  - 2x dependencies {"tool":"npm","packages":["bcrypt","jsonwebtoken"]}
+  - 8x testing [failed]
+  - testing
+  - 2x files {"tool":"mkdir"}
+  - shipping {"message":"fix: auth token validation"}
+  - shipping {"remote":"origin","branch":"feature/auth"}
+
+OUTPUT:
+- Added authentication dependencies (bcrypt, JWT)
+- Debugged and resolved failing auth tests
+- Committed and pushed the token validation fix
+
+RULES \u2014 follow these exactly:
+
+1. Interpret repeated events as patterns, not individual steps.
+   - Many testing [failed] followed by a passing test = debugging a failure. Say "resolved failing X tests", not "ran tests multiple times".
+   - Many versioning events = branch housekeeping. Fold into context, do not list each git command.
+
+2. Omit utility commands entirely. File size checks, file reads, grep searches, and cat commands are research steps \u2014 they are not outcomes and must not appear in the summary.
+
+3. Do not name the AI tool. For ai_session events: focus on what was built or committed. If a commits array is present in metadata, use those commit messages. Never write "via Claude Code", "using Claude Code", or similar \u2014 omit the tool name entirely.
+
+4. For other events with a hint field: describe the developer's intent, not the raw command.
+
+5. For dependencies events: infer the purpose from package names and describe the domain (bcrypt/jsonwebtoken \u2192 authentication, prisma/pg \u2192 database, jest/vitest \u2192 testing). For unfamiliar packages, name them directly.
+
+6. Fold supporting events into the narrative. Building, shipping, versioning, and file operations are context \u2014 only make them a bullet when they are the primary activity (e.g. a standalone build fix or deploy with no accompanying commits).
+
+7. Stick to what the events show. Do not infer subject matter from the branch name. Do not add details not derivable from the events.
+
+Maximum 5 bullets. Output ONLY the bullet points, nothing else.`;
+function getSystemPrompt() {
+  const contexts = getActiveProfileAiContexts();
+  if (contexts.length === 0) return SYSTEM_PROMPT;
+  return SYSTEM_PROMPT + "\n\n" + contexts.join("\n");
+}
+var DEFAULT_EXCLUDED_CATEGORIES = /* @__PURE__ */ new Set(["exploring", "note", "linting"]);
+function buildExcludedSet(includeCategories = []) {
+  const excluded = new Set(DEFAULT_EXCLUDED_CATEGORIES);
+  for (const cat of includeCategories) excluded.delete(cat);
+  return excluded;
+}
+function countExcludedEvents(sessions, excluded) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const session of sessions) {
+    for (const event of session.events) {
+      if (excluded.has(event.category)) {
+        counts.set(event.category, (counts.get(event.category) ?? 0) + 1);
+      }
+    }
+  }
+  return counts;
+}
+function buildUserMessage(payload, includeCategories = []) {
+  const excluded = buildExcludedSet(includeCategories);
+  const lines = [`Date: ${payload.date}`, ""];
+  for (const session of payload.sessions) {
+    lines.push(`Project: ${session.project ?? "unknown"}`);
+    if (session.branch) lines.push(`Branch: ${session.branch}`);
+    lines.push(`Duration: ${formatDuration(session.durationMinutes)}`);
+    for (const event of session.events) {
+      if (event.category === "note") {
+        lines.push(`NOTE: ${event.metadata.text}`);
+      }
+    }
+    lines.push("Events:");
+    const counts = /* @__PURE__ */ new Map();
+    for (const event of session.events) {
+      if (excluded.has(event.category)) continue;
+      const failed = event.exitCode !== null && event.exitCode !== 0 ? " [failed]" : "";
+      let key;
+      if (event.hint) {
+        key = `other  [${event.hint}]${failed}`;
+      } else {
+        const meta = Object.keys(event.metadata).length > 0 ? ` ${JSON.stringify(event.metadata)}` : "";
+        key = `${event.category}${meta}${failed}`;
+      }
+      counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    for (const [key, count] of counts) {
+      lines.push(`  - ${count > 1 ? `${count}x ` : ""}${key}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+var WEEKLY_SYSTEM_PROMPT = `You write short weekly developer summaries. Here is an example:
+
+INPUT:
+Week: 2026-05-18 to 2026-05-22
+
+Monday 2026-05-18:
+  Project: api-service (feature/auth) \u2014 2h 10m
+  Events: 3x code_commit, 2x test_run, dependency_install
+
+Tuesday 2026-05-19:
+  Project: api-service (feature/auth) \u2014 1h 30m
+  Events: 2x code_commit, test_run, build
+
+Wednesday 2026-05-20:
+  Project: dashboard (main) \u2014 3h 00m
+  Events: 4x code_commit, 2x build, test_run
+
+Thursday 2026-05-21:
+  Project: api-service (feature/auth) \u2014 1h 00m
+  Events: code_commit {"message":"feat: merge auth"}, branch_switch
+
+Friday 2026-05-22:
+  Project: dashboard (main) \u2014 2h 00m
+  Events: 3x code_commit, build
+
+OUTPUT:
+## Week of 18 May \u2014 9h 40m across 2 projects
+
+**api-service** (Mon\u2013Thu): Built and shipped the auth feature \u2014 JWT setup, token validation fixes, and final merge.
+**dashboard** (Wed, Fri): Active development across 7 commits with builds passing.
+
+Now summarise the following week. Output ONLY the summary \u2014 a one-line header then one bullet per active project. Maximum 4 bullets.`;
+var DAY_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+function buildWeeklyMessage(payload) {
+  const lines = [`Week: ${payload.weekStart} to ${payload.weekEnd}`, ""];
+  for (const { date, sessions } of payload.days) {
+    const dayName = DAY_NAMES[(/* @__PURE__ */ new Date(date + "T00:00:00")).getDay()];
+    lines.push(`${dayName} ${date}:`);
+    for (const session of sessions) {
+      const project = session.project ?? "unknown";
+      const branch = session.branch ? ` (${session.branch})` : "";
+      lines.push(`  Project: ${project}${branch} \u2014 ${formatDuration(session.durationMinutes)}`);
+      for (const event of session.events) {
+        if (event.category === "note") {
+          lines.push(`  NOTE: ${event.metadata.text}`);
+        }
+      }
+      const excluded = buildExcludedSet();
+      const counts = /* @__PURE__ */ new Map();
+      for (const event of session.events) {
+        if (excluded.has(event.category)) continue;
+        const failed = event.exitCode !== null && event.exitCode !== 0 ? " [failed]" : "";
+        let key;
+        if (event.hint) {
+          key = `other  [${event.hint}]${failed}`;
+        } else {
+          const meta = Object.keys(event.metadata).length > 0 ? ` ${JSON.stringify(event.metadata)}` : "";
+          key = `${event.category}${meta}${failed}`;
+        }
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+      }
+      const eventLine = [...counts.entries()].map(([key, count]) => `${count > 1 ? `${count}x ` : ""}${key}`).join(", ");
+      lines.push(`  Events: ${eventLine}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+
+// src/ai/fetch.ts
+var DEFAULT_TIMEOUT_MS = 3e4;
+async function fetchWithTimeout(url, init, timeoutMs = DEFAULT_TIMEOUT_MS) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    return await fetch(url, { ...init, signal: controller.signal });
+  } catch (err) {
+    if (err.name === "AbortError") {
+      throw new Error(`Request timed out after ${timeoutMs / 1e3}s`);
+    }
+    throw err;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// src/ai/providers/index.ts
+var GenericProvider = class {
+  constructor(config, model, apiKey, baseUrl, includeCategories = []) {
+    this.config = config;
+    this.model = model;
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl;
+    this.includeCategories = includeCategories;
+  }
+  config;
+  model;
+  apiKey;
+  baseUrl;
+  includeCategories;
+  async call(system, userMsg, maxTokens) {
+    const response = await fetchWithTimeout(this.config.chatUrl(this.baseUrl), {
+      method: "POST",
+      headers: this.config.headers(this.apiKey),
+      body: JSON.stringify(this.config.buildChatBody(this.model, system, userMsg, maxTokens))
+    });
+    if (!response.ok) {
+      throw new Error(this.config.chatError(response.status, await response.text()));
+    }
+    return this.config.parseText(await response.json());
+  }
+  async summarize(payload) {
+    return this.call(getSystemPrompt(), buildUserMessage(payload, this.includeCategories), this.config.dailyTokens);
+  }
+  async summarizeWeek(payload) {
+    return this.call(WEEKLY_SYSTEM_PROMPT, buildWeeklyMessage(payload), this.config.weeklyTokens);
+  }
+  async validate() {
+    const isPost = this.config.validateMethod === "POST";
+    const response = await fetchWithTimeout(this.config.validateUrl(this.baseUrl), {
+      method: this.config.validateMethod,
+      headers: isPost ? this.config.headers(this.apiKey) : void 0,
+      body: isPost && this.config.buildValidateBody ? JSON.stringify(this.config.buildValidateBody(this.model)) : void 0
+    });
+    if (!response.ok) {
+      throw new Error(this.config.validateError(response.status, await response.text(), this.baseUrl));
+    }
+  }
+};
+
+// src/ai/providers/config.ts
+var PROVIDER_CONFIGS = {
+  anthropic: {
+    defaultModel: "claude-haiku-4-5-20251001",
+    defaultBaseUrl: "https://api.anthropic.com/v1",
+    dailyTokens: 1024,
+    weeklyTokens: 1024,
+    chatUrl: (baseUrl) => `${baseUrl}/messages`,
+    validateUrl: (baseUrl) => `${baseUrl}/messages`,
+    validateMethod: "POST",
+    headers: (apiKey) => ({
+      "Content-Type": "application/json",
+      "x-api-key": apiKey,
+      "anthropic-version": "2023-06-01"
+    }),
+    buildChatBody: (model, system, userMsg, maxTokens) => ({
+      model,
+      max_tokens: maxTokens,
+      system,
+      messages: [{ role: "user", content: userMsg }]
+    }),
+    buildValidateBody: (model) => ({
+      model,
+      max_tokens: 1,
+      messages: [{ role: "user", content: "." }]
+    }),
+    parseText: (json) => {
+      const data = json;
+      return data.content.find((b) => b.type === "text")?.text ?? "";
+    },
+    chatError: (status, body) => `Anthropic API error ${status}: ${body}`,
+    validateError: (status, body) => `Anthropic API error ${status}: ${body}`
+  },
+  openai: {
+    defaultModel: "gpt-4o-mini",
+    defaultBaseUrl: "https://api.openai.com/v1",
+    dailyTokens: 1024,
+    weeklyTokens: 1024,
+    chatUrl: (baseUrl) => `${baseUrl}/chat/completions`,
+    validateUrl: (baseUrl) => `${baseUrl}/chat/completions`,
+    validateMethod: "POST",
+    headers: (apiKey) => ({
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    }),
+    buildChatBody: (model, system, userMsg, maxTokens) => ({
+      model,
+      messages: [
+        { role: "system", content: system },
+        { role: "user", content: userMsg }
+      ],
+      max_tokens: maxTokens
+    }),
+    buildValidateBody: (model) => ({
+      model,
+      messages: [{ role: "user", content: "." }],
+      max_tokens: 1
+    }),
+    parseText: (json) => {
+      const data = json;
+      return data.choices[0]?.message?.content ?? "";
+    },
+    chatError: (status, body) => `OpenAI API error ${status}: ${body}`,
+    validateError: (status, body) => `OpenAI API error ${status}: ${body}`
+  },
+  ollama: {
+    defaultModel: "llama3",
+    defaultBaseUrl: "http://localhost:11434",
+    dailyTokens: 300,
+    weeklyTokens: 400,
+    chatUrl: (baseUrl) => `${baseUrl}/api/chat`,
+    validateUrl: (baseUrl) => `${baseUrl}/api/tags`,
+    validateMethod: "GET",
+    headers: () => ({ "Content-Type": "application/json" }),
+    buildChatBody: (model, system, userMsg, maxTokens) => ({
+      model,
+      stream: false,
+      messages: [
+        { role: "system", content: system },
+        { role: "user", content: userMsg }
+      ],
+      options: { num_predict: maxTokens, temperature: 0.3 }
+    }),
+    parseText: (json) => {
+      return json.message?.content ?? "";
+    },
+    chatError: (status, body) => `Ollama error ${status}: ${body}. Is Ollama running? Try: ollama serve`,
+    validateError: (_status, _body, baseUrl) => `Ollama is not reachable at ${baseUrl}. Is it running? Try: ollama serve`
+  }
+};
+
+// src/ai/router.ts
+function getProvider(config) {
+  const { provider, apiKey = "", model, baseUrl } = config.ai;
+  if (!provider) {
+    throw new Error(
+      "No AI provider configured.\nRun: workscribe config set ai.provider <anthropic|openai|ollama|openai-compatible>"
+    );
+  }
+  const configKey = provider === "openai-compatible" ? "openai" : provider;
+  const providerConfig = PROVIDER_CONFIGS[configKey];
+  if (!providerConfig) {
+    throw new Error(
+      `Unknown provider: "${provider}"
+Supported providers: anthropic, openai, ollama, openai-compatible`
+    );
+  }
+  if (provider !== "ollama" && !apiKey) {
+    throw new Error(`${provider} requires an API key.
+Run: workscribe config set ai.apiKey <your-key>`);
+  }
+  if (provider === "openai-compatible" && !baseUrl) {
+    throw new Error("openai-compatible requires a base URL.\nRun: workscribe config set ai.baseUrl <url>");
+  }
+  return new GenericProvider(
+    providerConfig,
+    model || providerConfig.defaultModel,
+    apiKey,
+    baseUrl || providerConfig.defaultBaseUrl,
+    config.summary?.includeCategories ?? []
+  );
+}
+
 // src/capture/shell-hook.ts
 var import_fs10 = __toESM(require("fs"));
 var import_path7 = __toESM(require("path"));
@@ -1245,9 +1663,15 @@ function detectShell() {
   if (shell.includes("bash")) return { name: "bash", rcFile: import_path9.default.join(import_os4.default.homedir(), ".bashrc") };
   return null;
 }
+function step(current, total, label) {
+  log.plain(import_chalk2.default.bold(`
+  [${current}/${total}] ${label}`));
+}
 function registerInit(program2) {
   program2.command("init").description("Set up Workscribe and install or update shell hooks").action(async () => {
+    const TOTAL_STEPS = 5;
     log.plain(import_chalk2.default.bold("\n  Workscribe \u2014 Developer Work Journal\n"));
+    step(1, TOTAL_STEPS, "Creating data directory");
     if (!import_fs12.default.existsSync(WORKSCRIBE_DIR)) {
       import_fs12.default.mkdirSync(WORKSCRIBE_DIR, { recursive: true, mode: 448 });
       log.success(`Created ${WORKSCRIBE_DIR}`);
@@ -1256,12 +1680,15 @@ function registerInit(program2) {
         import_fs12.default.chmodSync(WORKSCRIBE_DIR, 448);
       } catch {
       }
+      log.info(`${WORKSCRIBE_DIR} already exists`);
     }
     if (!import_fs12.default.existsSync(PROFILES_DIR)) {
       import_fs12.default.mkdirSync(PROFILES_DIR, { recursive: true, mode: 448 });
     }
+    step(2, TOTAL_STEPS, "Initialising database");
     getDb();
-    log.success("Database initialized");
+    log.success("Database ready");
+    step(3, TOTAL_STEPS, "Installing shell hook");
     const shell = detectShell();
     if (!shell) {
       log.warn("Could not detect shell. Supported: zsh, bash");
@@ -1274,6 +1701,12 @@ function registerInit(program2) {
         const hookContent = import_fs12.default.readFileSync(hookFile, "utf-8");
         if (!import_fs12.default.existsSync(shell.rcFile)) import_fs12.default.writeFileSync(shell.rcFile, "");
         if (!isHookInstalled(shell.rcFile)) {
+          log.plain("");
+          log.plain(import_chalk2.default.dim("  Workscribe adds a lightweight hook to your shell that captures each"));
+          log.plain(import_chalk2.default.dim("  command you run \u2014 the text, exit code, duration, and working directory."));
+          log.plain(import_chalk2.default.dim("  It runs in the background and adds no latency to your terminal."));
+          log.plain(import_chalk2.default.dim("  Credentials and secrets are redacted before anything is stored."));
+          log.plain("");
           installHook(shell.rcFile, hookContent);
           log.success(`Shell hook installed in ${shell.rcFile}`);
         } else if (isHookOutdated(shell.rcFile, hookContent)) {
@@ -1294,6 +1727,7 @@ function registerInit(program2) {
         }
       }
     }
+    step(4, TOTAL_STEPS, "Detecting AI coding tools");
     const installedTools = loadAIToolRegistry().filter(
       (entry) => entry.hook !== null && AI_HOOK_INTEGRATIONS[entry.hook]?.isInstalled()
     );
@@ -1348,6 +1782,8 @@ function registerInit(program2) {
     } catch {
       log.info("Could not reach profile registry \u2014 run workscribe profile detect after connecting");
     }
+    step(5, TOTAL_STEPS, "Configuring AI provider");
+    let providerConfigured = !!config.ai.provider;
     if (config.ai.provider) {
       log.info(`AI provider already configured: ${import_chalk2.default.cyan(config.ai.provider)}`);
     } else {
@@ -1364,7 +1800,10 @@ function registerInit(program2) {
           { title: "Skip \u2014 configure later", value: "skip" }
         ]
       });
-      if (provider && provider !== "skip") {
+      if (!provider || provider === "skip") {
+        providerConfigured = false;
+        log.info("Skipped \u2014 run later: workscribe config set ai.provider <provider>");
+      } else {
         config.ai.provider = provider;
         if (provider === "ollama") {
           log.plain(`
@@ -1389,26 +1828,59 @@ function registerInit(program2) {
             if (baseUrl) config.ai.baseUrl = baseUrl;
           }
         }
-        writeConfig(config);
-        log.success(`AI provider set to ${import_chalk2.default.cyan(provider)}`);
-      } else if (provider === "skip" || !provider) {
-        log.info("Skipped \u2014 run later: workscribe config set ai.provider <provider>");
+        log.plain("");
+        log.info(`Validating ${import_chalk2.default.cyan(provider)} connection\u2026`);
+        try {
+          const testProvider = getProvider(config);
+          await testProvider.validate();
+          log.success("API key verified");
+          writeConfig(config);
+          providerConfigured = true;
+        } catch (error) {
+          log.warn(`Validation failed: ${error.message}`);
+          const { retry } = await (0, import_prompts.default)({
+            type: "confirm",
+            name: "retry",
+            message: "Save anyway and configure later?",
+            initial: false
+          });
+          if (retry) {
+            writeConfig(config);
+            providerConfigured = false;
+            log.info("Config saved \u2014 run workscribe config set ai.apiKey <key> to update");
+          } else {
+            log.info("API key not saved \u2014 run workscribe init again to configure");
+            providerConfigured = false;
+          }
+        }
       }
     }
     if (!import_fs12.default.existsSync(CONFIG_PATH)) {
       writeConfig(config);
-      log.success("Config file created");
     }
     log.plain("");
     log.plain(import_chalk2.default.bold("  Setup complete!"));
+    log.plain("");
     if (shell) {
-      log.plain("");
-      log.plain(`  Activate capture now:  ${import_chalk2.default.cyan(`source ${shell.rcFile}`)}`);
+      log.plain(`  Activate capture now:`);
+      log.plain(`    ${import_chalk2.default.cyan(`source ${shell.rcFile}`)}`);
       log.plain(`  Or restart your terminal.`);
+      log.plain("");
+    }
+    if (providerConfigured) {
+      log.plain(`  Then run a few commands and generate your first summary:`);
+      log.plain(`    ${import_chalk2.default.cyan("workscribe summary")}`);
+      log.plain("");
+      log.plain(`  Check capture is working:`);
+      log.plain(`    ${import_chalk2.default.cyan("workscribe status")}`);
+    } else {
+      log.plain(`  Before generating summaries, configure an AI provider:`);
+      log.plain(`    ${import_chalk2.default.cyan("workscribe config set ai.provider anthropic")}`);
+      log.plain(`    ${import_chalk2.default.cyan("workscribe config set ai.apiKey <your-key>")}`);
+      log.plain("");
+      log.plain(`  Then run:`);
+      log.plain(`    ${import_chalk2.default.cyan("workscribe summary")}`);
     }
-    log.plain("");
-    log.plain(`  ${import_chalk2.default.dim("workscribe summary")}   \u2014 generate today's work summary`);
-    log.plain(`  ${import_chalk2.default.dim("workscribe status")}    \u2014 check capture is working`);
     log.plain("");
   });
 }
@@ -1416,56 +1888,6 @@ function registerInit(program2) {
 // src/cli/status.ts
 var import_fs13 = __toESM(require("fs"));
 var import_chalk3 = __toESM(require("chalk"));
-
-// src/utils/format.ts
-function formatDuration(minutes) {
-  if (minutes < 60) return `${Math.round(minutes)}m`;
-  const h = Math.floor(minutes / 60);
-  const m = Math.round(minutes % 60);
-  return m > 0 ? `${h}h ${m}m` : `${h}h`;
-}
-function formatDate(isoString) {
-  return new Date(isoString).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
-}
-function todayDate() {
-  return localDateStr(/* @__PURE__ */ new Date());
-}
-function parseDate(input) {
-  const d = /* @__PURE__ */ new Date(input + "T00:00:00");
-  if (isNaN(d.getTime())) throw new Error(`Invalid date: ${input}`);
-  return input;
-}
-function localDateStr(d) {
-  const y = d.getFullYear();
-  const m = String(d.getMonth() + 1).padStart(2, "0");
-  const day = String(d.getDate()).padStart(2, "0");
-  return `${y}-${m}-${day}`;
-}
-function startOfWeek(dateStr) {
-  const d = /* @__PURE__ */ new Date(dateStr + "T00:00:00");
-  const day = d.getDay();
-  const diff = day === 0 ? -6 : 1 - day;
-  d.setDate(d.getDate() + diff);
-  return localDateStr(d);
-}
-function eachDayOfRange(start, end) {
-  const days = [];
-  const cur = /* @__PURE__ */ new Date(start + "T00:00:00");
-  const last = /* @__PURE__ */ new Date(end + "T00:00:00");
-  while (cur <= last) {
-    days.push(localDateStr(cur));
-    cur.setDate(cur.getDate() + 1);
-  }
-  return days;
-}
-function isoWeekKey(dateStr) {
-  const d = /* @__PURE__ */ new Date(dateStr + "T00:00:00");
-  const jan4 = new Date(d.getFullYear(), 0, 4);
-  const weekNum = Math.ceil(((d.getTime() - jan4.getTime()) / 864e5 + jan4.getDay() + 1) / 7);
-  return `${d.getFullYear()}-W${String(weekNum).padStart(2, "0")}`;
-}
-
-// src/cli/status.ts
 function registerStatus(program2) {
   program2.command("status").description("Show capture status and event counts").action(() => {
     const config = readConfig();
@@ -1694,8 +2116,8 @@ function registerSessions(program2) {
     if (opts.date) {
       try {
         date = parseDate(opts.date);
-      } catch (e) {
-        log.error(e.message);
+      } catch (error) {
+        log.error(error.message);
         process.exit(1);
       }
     }
@@ -1715,6 +2137,16 @@ function registerSessions(program2) {
       log.plain(
         `  ${import_chalk5.default.dim(start)} \u2013 ${import_chalk5.default.dim(end)}  ${repo}  ${import_chalk5.default.dim(duration)}  ${import_chalk5.default.dim(session.eventCount + " events")}`
       );
+      for (const event of session.events) {
+        if (event.category === "note") {
+          let text = "";
+          try {
+            text = JSON.parse(event.metadata ?? "{}").text ?? "";
+          } catch {
+          }
+          if (text) log.plain(`    ${import_chalk5.default.yellow("note")}  ${import_chalk5.default.dim(text)}`);
+        }
+      }
     }
     log.plain("");
   });
@@ -1726,356 +2158,6 @@ var import_fs14 = __toESM(require("fs"));
 var import_os5 = __toESM(require("os"));
 var import_path10 = __toESM(require("path"));
 
-// src/ai/prompt.ts
-var SYSTEM_PROMPT = `You write short developer work summaries. Here is an example:
-
-INPUT:
-Project: api-service
-Branch: feature/auth
-Duration: 2h 00m
-Events:
-  - versioning {"branch":"feature/auth"}
-  - 2x dependencies {"tool":"npm","packages":["bcrypt","jsonwebtoken"]}
-  - 2x testing {"tool":"jest"} [failed]
-  - testing {"tool":"jest"}
-  - 2x files {"tool":"mkdir"}
-  - shipping {"message":"fix: auth token validation"}
-  - shipping {"remote":"origin","branch":"feature/auth"}
-
-OUTPUT:
-- Switched to the authentication feature branch and added authentication dependencies (bcrypt, JWT)
-- Resolved failing auth tests
-- Committed and pushed authentication fixes
-
-For dependencies events with a packages field: infer the purpose of packages from their names and describe the domain, not just the packages. Examples: bcrypt/jsonwebtoken \u2192 authentication, prisma/mongoose/pg \u2192 database, jest/vitest/mocha \u2192 testing, axios/got/node-fetch \u2192 HTTP client, stripe/paypal \u2192 payments, socket.io/ws \u2192 real-time. Use your knowledge of common packages. For unfamiliar packages, name them directly without guessing their domain.
-
-Events like shipping (pushes), building, versioning (branch switches, stash), files (file ops, env vars), and infrastructure provide context \u2014 fold them into the surrounding narrative rather than listing them as separate bullets. Only surface them directly when they are the main activity (e.g. a standalone build fix, a deploy, or a significant restructure with no accompanying commits).
-
-For ai_session events: describe what was built during the AI session using the tool name (e.g. "via Claude Code"). If a commits array is present in metadata, use those commit messages to describe what was built. Group all activity from the session into one narrative bullet.
-
-For other events with a hint field: interpret the command snippet and describe the activity in plain language. Do not quote the raw command.
-
-Maximum 5 bullets. Output ONLY the bullet points, nothing else.`;
-function getSystemPrompt() {
-  const contexts = getActiveProfileAiContexts();
-  if (contexts.length === 0) return SYSTEM_PROMPT;
-  return SYSTEM_PROMPT + "\n\n" + contexts.join("\n");
-}
-var EXCLUDED = /* @__PURE__ */ new Set(["exploring"]);
-function buildUserMessage(payload) {
-  const lines = [`Date: ${payload.date}`, ""];
-  for (const session of payload.sessions) {
-    lines.push(`Project: ${session.project ?? "unknown"}`);
-    if (session.branch) lines.push(`Branch: ${session.branch}`);
-    lines.push(`Duration: ${formatDuration(session.durationMinutes)}`);
-    lines.push("Events:");
-    const counts = /* @__PURE__ */ new Map();
-    for (const event of session.events) {
-      if (EXCLUDED.has(event.category)) continue;
-      const failed = event.exitCode !== null && event.exitCode !== 0 ? " [failed]" : "";
-      let key;
-      if (event.hint) {
-        key = `other  [${event.hint}]${failed}`;
-      } else {
-        const meta = Object.keys(event.metadata).length > 0 ? ` ${JSON.stringify(event.metadata)}` : "";
-        key = `${event.category}${meta}${failed}`;
-      }
-      counts.set(key, (counts.get(key) ?? 0) + 1);
-    }
-    for (const [key, count] of counts) {
-      lines.push(`  - ${count > 1 ? `${count}x ` : ""}${key}`);
-    }
-    lines.push("");
-  }
-  return lines.join("\n");
-}
-var WEEKLY_SYSTEM_PROMPT = `You write short weekly developer summaries. Here is an example:
-
-INPUT:
-Week: 2026-05-18 to 2026-05-22
-
-Monday 2026-05-18:
-  Project: api-service (feature/auth) \u2014 2h 10m
-  Events: 3x code_commit, 2x test_run, dependency_install
-
-Tuesday 2026-05-19:
-  Project: api-service (feature/auth) \u2014 1h 30m
-  Events: 2x code_commit, test_run, build
-
-Wednesday 2026-05-20:
-  Project: dashboard (main) \u2014 3h 00m
-  Events: 4x code_commit, 2x build, test_run
-
-Thursday 2026-05-21:
-  Project: api-service (feature/auth) \u2014 1h 00m
-  Events: code_commit {"message":"feat: merge auth"}, branch_switch
-
-Friday 2026-05-22:
-  Project: dashboard (main) \u2014 2h 00m
-  Events: 3x code_commit, build
-
-OUTPUT:
-## Week of 18 May \u2014 9h 40m across 2 projects
-
-**api-service** (Mon\u2013Thu): Built and shipped the auth feature \u2014 JWT setup, token validation fixes, and final merge.
-**dashboard** (Wed, Fri): Active development across 7 commits with builds passing.
-
-Now summarise the following week. Output ONLY the summary \u2014 a one-line header then one bullet per active project. Maximum 4 bullets.`;
-var DAY_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
-function buildWeeklyMessage(payload) {
-  const lines = [`Week: ${payload.weekStart} to ${payload.weekEnd}`, ""];
-  for (const { date, sessions } of payload.days) {
-    const dayName = DAY_NAMES[(/* @__PURE__ */ new Date(date + "T00:00:00")).getDay()];
-    lines.push(`${dayName} ${date}:`);
-    for (const s of sessions) {
-      const project = s.project ?? "unknown";
-      const branch = s.branch ? ` (${s.branch})` : "";
-      lines.push(`  Project: ${project}${branch} \u2014 ${formatDuration(s.durationMinutes)}`);
-      const counts = /* @__PURE__ */ new Map();
-      for (const e of s.events) {
-        if (EXCLUDED.has(e.category)) continue;
-        const failed = e.exitCode !== null && e.exitCode !== 0 ? " [failed]" : "";
-        let key;
-        if (e.hint) {
-          key = `other  [${e.hint}]${failed}`;
-        } else {
-          const meta = Object.keys(e.metadata).length > 0 ? ` ${JSON.stringify(e.metadata)}` : "";
-          key = `${e.category}${meta}${failed}`;
-        }
-        counts.set(key, (counts.get(key) ?? 0) + 1);
-      }
-      const eventLine = [...counts.entries()].map(([k, n]) => `${n > 1 ? `${n}x ` : ""}${k}`).join(", ");
-      lines.push(`  Events: ${eventLine}`);
-    }
-    lines.push("");
-  }
-  return lines.join("\n");
-}
-
-// src/ai/fetch.ts
-var DEFAULT_TIMEOUT_MS = 3e4;
-async function fetchWithTimeout(url, init, timeoutMs = DEFAULT_TIMEOUT_MS) {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    return await fetch(url, { ...init, signal: controller.signal });
-  } catch (err) {
-    if (err.name === "AbortError") {
-      throw new Error(`Request timed out after ${timeoutMs / 1e3}s`);
-    }
-    throw err;
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-// src/ai/providers/anthropic.ts
-var AnthropicProvider = class {
-  apiKey;
-  model;
-  constructor(apiKey, model) {
-    this.apiKey = apiKey;
-    this.model = model || "claude-haiku-4-5-20251001";
-  }
-  async summarize(payload) {
-    const response = await fetchWithTimeout("https://api.anthropic.com/v1/messages", {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-api-key": this.apiKey,
-        "anthropic-version": "2023-06-01"
-      },
-      body: JSON.stringify({
-        model: this.model,
-        max_tokens: 1024,
-        system: getSystemPrompt(),
-        messages: [{ role: "user", content: buildUserMessage(payload) }]
-      })
-    });
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(`Anthropic API error ${response.status}: ${body}`);
-    }
-    const data = await response.json();
-    return data.content.find((block) => block.type === "text")?.text ?? "";
-  }
-  async summarizeWeek(payload) {
-    const response = await fetchWithTimeout("https://api.anthropic.com/v1/messages", {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-api-key": this.apiKey,
-        "anthropic-version": "2023-06-01"
-      },
-      body: JSON.stringify({
-        model: this.model,
-        max_tokens: 1024,
-        system: WEEKLY_SYSTEM_PROMPT,
-        messages: [{ role: "user", content: buildWeeklyMessage(payload) }]
-      })
-    });
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(`Anthropic API error ${response.status}: ${body}`);
-    }
-    const data = await response.json();
-    return data.content.find((block) => block.type === "text")?.text ?? "";
-  }
-};
-
-// src/ai/providers/openai.ts
-var OpenAIProvider = class {
-  apiKey;
-  model;
-  baseUrl;
-  constructor(apiKey, model, baseUrl) {
-    this.apiKey = apiKey;
-    this.model = model || "gpt-4o-mini";
-    this.baseUrl = baseUrl || "https://api.openai.com/v1";
-  }
-  async summarize(payload) {
-    const response = await fetchWithTimeout(`${this.baseUrl}/chat/completions`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${this.apiKey}`
-      },
-      body: JSON.stringify({
-        model: this.model,
-        messages: [
-          { role: "system", content: getSystemPrompt() },
-          { role: "user", content: buildUserMessage(payload) }
-        ],
-        max_tokens: 1024
-      })
-    });
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(`OpenAI API error ${response.status}: ${body}`);
-    }
-    const data = await response.json();
-    return data.choices[0]?.message?.content ?? "";
-  }
-  async summarizeWeek(payload) {
-    const response = await fetchWithTimeout(`${this.baseUrl}/chat/completions`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${this.apiKey}`
-      },
-      body: JSON.stringify({
-        model: this.model,
-        messages: [
-          { role: "system", content: WEEKLY_SYSTEM_PROMPT },
-          { role: "user", content: buildWeeklyMessage(payload) }
-        ],
-        max_tokens: 1024
-      })
-    });
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(`OpenAI API error ${response.status}: ${body}`);
-    }
-    const data = await response.json();
-    return data.choices[0]?.message?.content ?? "";
-  }
-};
-
-// src/ai/providers/ollama.ts
-var OllamaProvider = class {
-  model;
-  baseUrl;
-  constructor(model, baseUrl) {
-    this.model = model || "llama3";
-    this.baseUrl = baseUrl || "http://localhost:11434";
-  }
-  async summarize(payload) {
-    const response = await fetchWithTimeout(`${this.baseUrl}/api/chat`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        model: this.model,
-        stream: false,
-        messages: [
-          { role: "system", content: getSystemPrompt() },
-          { role: "user", content: buildUserMessage(payload) }
-        ],
-        options: {
-          num_predict: 300,
-          // hard cap on output tokens — forces conciseness
-          temperature: 0.3
-          // lower temperature = more focused, less wandering
-        }
-      })
-    });
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(`Ollama error ${response.status}: ${body}. Is Ollama running? Try: ollama serve`);
-    }
-    const data = await response.json();
-    return data.message?.content ?? "";
-  }
-  async summarizeWeek(payload) {
-    const response = await fetchWithTimeout(`${this.baseUrl}/api/chat`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        model: this.model,
-        stream: false,
-        messages: [
-          { role: "system", content: WEEKLY_SYSTEM_PROMPT },
-          { role: "user", content: buildWeeklyMessage(payload) }
-        ],
-        options: {
-          num_predict: 400,
-          temperature: 0.3
-        }
-      })
-    });
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(`Ollama error ${response.status}: ${body}. Is Ollama running? Try: ollama serve`);
-    }
-    const data = await response.json();
-    return data.message?.content ?? "";
-  }
-};
-
-// src/ai/router.ts
-function getProvider(config) {
-  const { provider, apiKey, model, baseUrl } = config.ai;
-  if (!provider) {
-    throw new Error(
-      "No AI provider configured.\nRun: workscribe config set ai.provider <anthropic|openai|ollama|openai-compatible>"
-    );
-  }
-  switch (provider) {
-    case "anthropic": {
-      if (!apiKey) throw new Error("Anthropic requires an API key.\nRun: workscribe config set ai.apiKey <your-key>");
-      return new AnthropicProvider(apiKey, model || void 0);
-    }
-    case "openai": {
-      if (!apiKey) throw new Error("OpenAI requires an API key.\nRun: workscribe config set ai.apiKey <your-key>");
-      return new OpenAIProvider(apiKey, model || void 0);
-    }
-    case "openai-compatible": {
-      if (!apiKey)
-        throw new Error("This provider requires an API key.\nRun: workscribe config set ai.apiKey <your-key>");
-      if (!baseUrl)
-        throw new Error("openai-compatible requires a base URL.\nRun: workscribe config set ai.baseUrl <url>");
-      return new OpenAIProvider(apiKey, model || void 0, baseUrl);
-    }
-    case "ollama": {
-      return new OllamaProvider(model || void 0, baseUrl || void 0);
-    }
-    default:
-      throw new Error(
-        `Unknown provider: "${provider}"
-Supported providers: anthropic, openai, ollama, openai-compatible`
-      );
-  }
-}
-
 // src/integrations/webhook.ts
 async function postToWebhook(url, text) {
   const response = await fetchWithTimeout(
@@ -2121,7 +2203,7 @@ function eventRowToPayload(row) {
   };
   if (row.category === "other" && typeof metadata.hint === "string") {
     payload.hint = metadata.hint;
-    const { hint: _h, tool: _t, ...rest } = metadata;
+    const { hint: _hint, tool: _tool, ...rest } = metadata;
     payload.metadata = rest;
   }
   return payload;
@@ -2146,21 +2228,21 @@ async function handleWebhook(opts, config, summary) {
       const body = isSlackWebhookUrl(webhookUrl) ? formatForSlack(summary, username) : summary;
       await postToWebhook(webhookUrl, body);
       log.success("Posted.");
-    } catch (e) {
-      log.error(`Webhook failed: ${e.message}`);
+    } catch (error) {
+      log.error(`Webhook failed: ${error.message}`);
     }
   } else if (opts.slack && !config.integrations?.slackWebhook) {
     log.warn("--slack requires integrations.slackWebhook to be set in config");
   }
 }
 function registerSummary(program2) {
-  program2.command("summary").description("Generate an AI work summary").option("--date <YYYY-MM-DD>", "date to summarize (default: today)").option("--week", "summarize the current week").option("--fresh", "bypass cache and regenerate").option("--slack", "post summary to Slack webhook from config").option("--webhook <url>", "post summary to a custom webhook URL").action(async (opts) => {
+  program2.command("summary").description("Generate an AI work summary").option("--date <YYYY-MM-DD>", "date to summarize (default: today)").option("--week", "summarize the current week").option("--fresh", "bypass cache and regenerate").option("--verbose", "show all captured events including those not sent to AI").option("--slack", "post summary to Slack webhook from config").option("--webhook <url>", "post summary to a custom webhook URL").action(async (opts) => {
     const config = readConfig();
     let provider;
     try {
       provider = getProvider(config);
-    } catch (e) {
-      log.error(e.message);
+    } catch (error) {
+      log.error(error.message);
       process.exit(1);
     }
     if (opts.week) {
@@ -2200,8 +2282,8 @@ function registerSummary(program2) {
         import_fs14.default.mkdirSync(WEEKLY_CACHE_DIR, { recursive: true });
         import_fs14.default.writeFileSync(cacheFile, summary, { encoding: "utf-8", mode: 384 });
         await handleWebhook(opts, config, summary);
-      } catch (e) {
-        log.error(`Weekly summary failed [${config.ai.provider}]: ${e.message}`);
+      } catch (error) {
+        log.error(`Weekly summary failed [${config.ai.provider}]: ${error.message}`);
         process.exit(1);
       }
       return;
@@ -2210,8 +2292,8 @@ function registerSummary(program2) {
     if (opts.date) {
       try {
         date = parseDate(opts.date);
-      } catch (e) {
-        log.error(e.message);
+      } catch (error) {
+        log.error(error.message);
         process.exit(1);
       }
     }
@@ -2243,12 +2325,35 @@ function registerSummary(program2) {
         return;
       }
     }
+    const excluded = buildExcludedSet(config.summary?.includeCategories ?? []);
+    const allSessionPayloads = sessions.map((session) => sessionToPayload(session, date));
+    if (opts.verbose) {
+      log.plain("");
+      log.plain(import_chalk6.default.bold("  Captured events (--verbose):"));
+      for (const sessionPayload of allSessionPayloads) {
+        const branch = sessionPayload.branch ? ` (${sessionPayload.branch})` : "";
+        log.plain(
+          import_chalk6.default.dim(
+            `
+  ${sessionPayload.project ?? "unknown"}${branch} \u2014 ${formatDuration(sessionPayload.durationMinutes)}`
+          )
+        );
+        for (const event of sessionPayload.events) {
+          const tag = excluded.has(event.category) ? import_chalk6.default.dim(`  [excluded] ${event.category}`) : `  ${event.category}`;
+          const hint = event.hint ? import_chalk6.default.dim(` [${event.hint}]`) : "";
+          const meta = Object.keys(event.metadata).length > 0 ? import_chalk6.default.dim(` ${JSON.stringify(event.metadata)}`) : "";
+          log.plain(`    ${tag}${hint}${meta}`);
+        }
+      }
+      log.plain("");
+    }
     log.plain("");
     log.info(`Generating summary via ${import_chalk6.default.cyan(config.ai.provider)}\u2026`);
     const allSummaries = [];
     const jsonSessions = [];
-    for (const session of sessions) {
-      const sessionPayload = { date, sessions: [sessionToPayload(session, date)] };
+    for (let index = 0; index < sessions.length; index++) {
+      const session = sessions[index];
+      const sessionPayload = { date, sessions: [allSessionPayloads[index]] };
       try {
         const bullets = await provider.summarize(sessionPayload);
         const project = session.repoName ?? "unknown";
@@ -2267,8 +2372,8 @@ ${bullets.trim()}`;
             bullets: parseBullets(bullets)
           });
         }
-      } catch (e) {
-        log.error(`Summary failed [${config.ai.provider}]: ${e.message}`);
+      } catch (error) {
+        log.error(`Summary failed [${config.ai.provider}]: ${error.message}`);
         process.exit(1);
       }
     }
@@ -2280,6 +2385,14 @@ ${bullets.trim()}`;
       log.plain(fullSummary);
     }
     log.plain("");
+    const excludedCounts = countExcludedEvents(allSessionPayloads, excluded);
+    if (excludedCounts.size > 0) {
+      const total = [...excludedCounts.values()].reduce((sum, count) => sum + count, 0);
+      const breakdown = [...excludedCounts.entries()].map(([category, count]) => `${category} \xD7${count}`).join(", ");
+      log.plain(import_chalk6.default.dim(`  \u2139 ${total} event${total === 1 ? "" : "s"} not included in summary (${breakdown})`));
+      log.plain(import_chalk6.default.dim("    Use --verbose to inspect \xB7 workscribe config set summary.includeCategories to opt in"));
+      log.plain("");
+    }
     await handleWebhook(opts, config, fullSummary);
   });
 }
@@ -2740,9 +2853,133 @@ function registerProfile(program2) {
   });
 }
 
+// src/cli/note.ts
+function registerNote(program2) {
+  program2.command("note <text>").description("Attach a free-text annotation to the current session").action((text) => {
+    const { repoName, branch } = getGitContext(process.cwd());
+    insertEvent({
+      captured_at: (/* @__PURE__ */ new Date()).toISOString(),
+      command: "workscribe note",
+      cwd: process.cwd(),
+      exit_code: null,
+      duration_ms: null,
+      repo_name: repoName,
+      branch,
+      category: "note",
+      metadata: JSON.stringify({ text })
+    });
+    log.success(`Note saved${repoName ? ` to ${repoName}` : ""}`);
+  });
+}
+
+// src/cli/week.ts
+var import_chalk11 = __toESM(require("chalk"));
+var import_fs19 = __toESM(require("fs"));
+var import_path14 = __toESM(require("path"));
+var import_os7 = __toESM(require("os"));
+function eventRowToPayload3(row) {
+  let metadata = {};
+  try {
+    if (row.metadata) metadata = JSON.parse(row.metadata);
+  } catch {
+  }
+  const payload = {
+    category: row.category,
+    metadata,
+    exitCode: row.exit_code,
+    durationMs: row.duration_ms
+  };
+  if (row.category === "other" && typeof metadata.hint === "string") {
+    payload.hint = metadata.hint;
+    const { hint: _hint, tool: _tool, ...rest } = metadata;
+    payload.metadata = rest;
+  }
+  return payload;
+}
+function sessionToPayload2(session, date) {
+  return {
+    date,
+    project: session.repoName,
+    branch: session.events[0]?.branch ?? null,
+    startTime: formatDate(session.startedAt),
+    endTime: formatDate(session.endedAt),
+    durationMinutes: session.durationMinutes,
+    events: session.events.map(eventRowToPayload3)
+  };
+}
+async function postSummary(opts, config, summary) {
+  const webhookUrl = opts.webhook ?? (opts.slack ? config.integrations?.slackWebhook : void 0);
+  if (!webhookUrl) {
+    if (opts.slack) log.warn("--slack requires integrations.slackWebhook to be set in config");
+    return;
+  }
+  try {
+    log.info("Posting to webhook\u2026");
+    const username = import_os7.default.userInfo().username;
+    const body = isSlackWebhookUrl(webhookUrl) ? formatForSlack(summary, username) : summary;
+    await postToWebhook(webhookUrl, body);
+    log.success("Posted.");
+  } catch (error) {
+    log.error(`Webhook failed: ${error.message}`);
+  }
+}
+function registerWeek(program2) {
+  program2.command("week").description("Generate an AI weekly digest (Mon\u2013today)").option("--fresh", "bypass cache and regenerate").option("--slack", "post to Slack webhook from config").option("--webhook <url>", "post to a custom webhook URL").action(async (opts) => {
+    const config = readConfig();
+    let provider;
+    try {
+      provider = getProvider(config);
+    } catch (error) {
+      log.error(error.message);
+      process.exit(1);
+    }
+    const today = todayDate();
+    const weekStart = startOfWeek(today);
+    const days = eachDayOfRange(weekStart, today);
+    const weeklyDays = [];
+    for (const day of days) {
+      const sessions = getOrBuildSessions(day);
+      if (sessions.length > 0) {
+        weeklyDays.push({ date: day, sessions: sessions.map((session) => sessionToPayload2(session, day)) });
+      }
+    }
+    if (weeklyDays.length === 0) {
+      log.plain("No activity captured this week.");
+      return;
+    }
+    const cacheKey = isoWeekKey(today);
+    const cacheFile = import_path14.default.join(WEEKLY_CACHE_DIR, `${cacheKey}.md`);
+    if (!opts.fresh && import_fs19.default.existsSync(cacheFile)) {
+      const cached = import_fs19.default.readFileSync(cacheFile, "utf-8");
+      log.plain("");
+      log.plain(cached);
+      log.plain("");
+      log.plain(import_chalk11.default.dim("  (cached \u2014 use --fresh to regenerate)"));
+      await postSummary(opts, config, cached);
+      return;
+    }
+    const payload = { weekStart, weekEnd: today, days: weeklyDays };
+    log.plain("");
+    log.info(`Generating weekly digest via ${import_chalk11.default.cyan(config.ai.provider)}\u2026`);
+    try {
+      const summary = provider.summarizeWeek ? await provider.summarizeWeek(payload) : await provider.summarize({ date: today, sessions: weeklyDays.flatMap((day) => day.sessions) });
+      log.plain("");
+      log.plain(summary);
+      log.plain("");
+      import_fs19.default.mkdirSync(WEEKLY_CACHE_DIR, { recursive: true });
+      import_fs19.default.writeFileSync(cacheFile, summary, { encoding: "utf-8", mode: 384 });
+      await postSummary(opts, config, summary);
+    } catch (error) {
+      log.error(`Weekly digest failed [${config.ai.provider}]: ${error.message}`);
+      process.exit(1);
+    }
+  });
+}
+
 // src/index.ts
+assertNodeVersion(process.versions.node);
 var program = new import_commander.Command();
-program.name("workscribe").description("Automatic developer work journal").version("1.10.0");
+program.name("workscribe").description("Automatic developer work journal").version("1.11.0");
 registerCapture(program);
 registerHook(program);
 registerInit(program);
@@ -2757,5 +2994,7 @@ registerUndo(program);
 registerClear(program);
 registerUninstall(program);
 registerProfile(program);
+registerNote(program);
+registerWeek(program);
 program.parse();
 //# sourceMappingURL=index.js.map