@lcvbeek/patina 0.1.0

package/README.md

@@ -0,0 +1,195 @@
+<img width="250" height="72" alt="Patina (2)" src="https://github.com/user-attachments/assets/77650975-b20b-4a65-b582-bb86ff6c2ae3" />
+
+# Patina
+
+Patina is what forms naturally when you keep working with AI. Each retro cycle deposits a thin layer — captured moments, reflection answers, Claude's synthesis, a proposed instruction change. Over time, `patina.md` builds up into something with real depth: a working record of how your team uses AI, versioned in git, shared by everyone including new hires.
+
+---
+
+## How is this different from Claude Code's built-in `/insights`?
+
+`/insights` produces a personal HTML report in `~/.claude/` — useful analysis, but it belongs to one person and doesn't persist between sessions. Patina produces `patina.md`, a structured document that lives in your repo, is versioned with git, and accumulates layers across cycles. The goal isn't better analysis — it's a shared artifact your team actually owns and maintains together.
+
+---
+
+## The loop
+
+```
+patina capture                  # anyone on the team, anytime
+  → records a notable moment to .patina/captures/
+  → committed to the repo, visible to everyone
+
+patina run                      # when you're ready for a retro
+  → auto-ingests Claude Code JSONL logs
+  → loads all captures since the last cycle
+  → 6 reflection questions (~10 min)
+  → Claude synthesises session data + captures + your answers
+  → coaching insight + proposed instruction diff
+
+patina diff                     # review the proposed change
+patina buff                     # apply it to .patina/patina.md
+```
+
+Next session, the whole team works from an updated set of shared instructions.
+
+---
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `patina init` | Scaffold `.patina/` in the current directory, create `patina.md` |
+| `patina capture [text]` | Capture a notable moment while it's fresh — feeds into the next retro |
+| `patina run` | Full retro session — auto-ingests logs, loads captures, asks reflection questions, calls Claude for synthesis |
+| `patina diff` | Review the proposed instruction change from the last `patina run` |
+| `patina buff` | Apply the pending diff to `patina.md` (`patina apply` also works) |
+| `patina status` | Show metrics: token spend, rework rate, tool usage, trends across cycles |
+| `patina ingest` | Manually parse Claude Code logs (optional — `patina run` does this automatically) |
+
+### patina capture
+
+```bash
+patina capture "agent almost pushed directly to main — need an approval gate rule"
+patina capture --tag near-miss "agent almost pushed directly to main"
+patina capture          # interactive mode
+```
+
+Tags: `near-miss` / `went-well` / `frustration` / `pattern` / `other`
+
+Captures are written to `.patina/captures/` as individual JSON files (one per capture, to avoid merge conflicts) and committed to the repo. Author is read from `git config user.name`.
+
+---
+
+## What gets committed
+
+`.patina/` is partially tracked:
+
+| Path | Committed | Why |
+|---|---|---|
+| `.patina/patina.md` | ✓ | The shared AI operating document |
+| `.patina/cycles/` | ✓ | Each layer — full cycle reports, the team's accumulated record |
+| `.patina/captures/` | ✓ | In-the-moment observations from anyone on the team |
+| `.patina/sessions/` | ✗ | Personal session data, machine-specific |
+| `.patina/metrics.json` | ✗ | Derived from sessions, not a source of truth |
+| `.patina/pending-diff.json` | ✗ | Ephemeral — consumed by `patina buff` |
+
+---
+
+## What `patina run` produces
+
+- `.patina/cycles/YYYY-MM-DD.md` — full cycle report: metrics snapshot, identified patterns, coaching insight, proposed instruction diff, reflection answers
+- `.patina/pending-diff.json` — the diff staged for `patina buff`
+- An updated `.patina/patina.md` once you run `patina buff`
+
+---
+
+## What `patina.md` is
+
+Your team's AI operating constitution. It has sections for working agreements, agent profiles, delegation patterns, an incident log, eval criteria, and an opportunity backlog. `patina buff` appends a new entry to the cycle history and inserts the proposed instruction into the right section.
+
+The file is yours — edit it directly whenever you want. Patina treats it as the source of truth for how your team works with AI and passes it to Claude during synthesis.
+
+### How agents read it
+
+`patina init` adds the following line to your project's `CLAUDE.md` (creating it if it doesn't exist):
+
+```
+@.patina/patina.md
+```
+
+Claude Code's `@filename` import syntax means every Claude Code session in the project automatically gets the contents of `patina.md` — no manual copying needed. When `patina buff` updates `patina.md`, Claude picks up the change in the next session.
+
+If a `CLAUDE.md` already exists, `init` appends the import line without touching anything else.
+
+---
+
+## What gets tracked
+
+Everything stays local. No data leaves your machine except what you choose to send to Claude via the `claude` CLI during `patina run`.
+
+What gets ingested from your Claude Code logs:
+- Session timestamps and project names
+- Estimated token counts
+- Tool call names and frequencies
+- Whether a session contained rework (detected heuristically from the JSONL)
+
+What is never sent to Claude:
+- Raw session content or conversation transcripts
+- Anything outside `.patina/`
+
+---
+
+## Requirements
+
+- Node.js 18+
+- Access to Claude via one of:
+  - **Claude Code CLI** (recommended) — install at [claude.ai/code](https://claude.ai/code), authenticate once, and Patina uses it automatically. Respects your existing plan including Claude Max.
+  - **Anthropic API key** — set `ANTHROPIC_API_KEY` in your environment. Patina falls back to this if the CLI isn't found. Billed separately per token.
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+---
+
+## Install
+
+```bash
+git clone https://github.com/lcvbeek/patina.git
+cd patina
+npm install
+```
+
+Run via:
+
+```bash
+npx tsx src/index.ts <command>
+```
+
+Or add an alias:
+
+```bash
+alias patina="npx tsx /path/to/patina/src/index.ts"
+```
+
+Global install via `npm install -g` is coming once the CLI is stable.
+
+---
+
+## First run
+
+```bash
+cd your-project
+patina init        # creates .patina/ and patina.md
+patina run         # first cycle — answer the reflection questions
+patina diff        # review what Claude proposed
+patina buff        # apply the change
+git add .patina/patina.md .patina/cycles/ .patina/captures/
+git commit -m "First patina cycle"
+```
+
+If you have no prior Claude Code session data, `patina run` will still work — your reflection answers are the primary input for the first cycle.
+
+---
+
+## Early software
+
+This is v0.1.0. It works, but expect rough edges:
+
+- The `claude` CLI call in `patina run` has a 120-second timeout; if Claude is slow the command will fail (your reflection answers are saved to `.patina/pending-reflection.json` so you can retry without re-answering)
+- Session ingestion parses Claude Code's JSONL format — if Anthropic changes that format, ingestion will break
+- Token estimates are heuristic, not exact
+
+If something breaks or the instruction diff Claude produces is bad, that's useful signal. Open an issue or message me directly.
+
+---
+
+## Design decisions worth knowing
+
+**Why a living doc instead of CLAUDE.md?** `patina.md` is a structured format Patina can reliably read and append to. You can copy entries into your `CLAUDE.md` or `AGENTS.md` manually — that handoff is intentional for now.
+
+**Why does it use the `claude` CLI instead of the API directly?** No separate API key, and it respects your existing Claude Code authentication and model access.
+
+**Why six questions?** The reflection questions supplement sparse log data and give Claude qualitative signal the JSONL doesn't contain — what felt frustrating, what nearly went wrong. Both matter for the synthesis.
+
+**Why individual capture files instead of appending to one file?** Multiple teammates capturing on the same day would produce merge conflicts in a single file. One file per capture means clean parallel commits.

package/dist/commands/apply.d.ts

@@ -0,0 +1,2 @@
+export declare function applyCommand(): Promise<void>;
+//# sourceMappingURL=apply.d.ts.map

package/dist/commands/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/commands/apply.ts"],"names":[],"mappings":"AAkJA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA8ElD"}

package/dist/commands/apply.js

@@ -0,0 +1,186 @@
+import fs from 'fs';
+import path from 'path';
+import readline from 'readline';
+import { assertInitialised, readPendingDiff, LIVING_DOC_FILE, PENDING_DIFF_FILE, METRICS_FILE, } from '../lib/storage.js';
+const isTTY = process.stdout.isTTY;
+function bold(s) { return isTTY ? `\x1b[1m${s}\x1b[0m` : s; }
+function dim(s) { return isTTY ? `\x1b[2m${s}\x1b[0m` : s; }
+function green(s) { return isTTY ? `\x1b[32m${s}\x1b[0m` : s; }
+function cyan(s) { return isTTY ? `\x1b[36m${s}\x1b[0m` : s; }
+function yellow(s) { return isTTY ? `\x1b[33m${s}\x1b[0m` : s; }
+function red(s) { return isTTY ? `\x1b[31m${s}\x1b[0m` : s; }
+function hr(len = 60) { return dim('─'.repeat(len)); }
+function confirm(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => {
+        rl.question(question, answer => {
+            rl.close();
+            resolve(answer.trim().toLowerCase().startsWith('y'));
+        });
+    });
+}
+/**
+ * Find the section header in patina.md and insert the diff text after it.
+ * Falls back to appending at the end of the section if the header isn't found exactly.
+ */
+function applyDiffToDoc(content, section, diffText) {
+    const lines = content.split('\n');
+    // Try to find the matching section header (## 1. Working Agreements, etc.)
+    // Match by number prefix or by full title (case-insensitive)
+    const sectionLower = section.toLowerCase().trim();
+    let sectionIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.startsWith('## ') && line.toLowerCase().includes(sectionLower.replace(/^\d+\.\s*/, ''))) {
+            sectionIdx = i;
+            break;
+        }
+        // Also match by number alone: "## 1." prefix
+        const numMatch = sectionLower.match(/^(\d+)\./);
+        if (numMatch && line.startsWith(`## ${numMatch[1]}.`)) {
+            sectionIdx = i;
+            break;
+        }
+    }
+    if (sectionIdx === -1) {
+        // Section not found — append before the last --- or at end
+        const lastHrIdx = lines.lastIndexOf('---');
+        const insertAt = lastHrIdx !== -1 ? lastHrIdx : lines.length;
+        const newLines = [
+            ...lines.slice(0, insertAt),
+            '',
+            `<!-- Added by patina apply ${new Date().toISOString().slice(0, 10)} -->`,
+            ...diffText.split('\n'),
+            '',
+            ...lines.slice(insertAt),
+        ];
+        return newLines.join('\n');
+    }
+    // Find the end of this section (next ## heading or end of file)
+    let sectionEnd = lines.length;
+    for (let i = sectionIdx + 1; i < lines.length; i++) {
+        if (lines[i].startsWith('## ')) {
+            sectionEnd = i;
+            break;
+        }
+    }
+    // Find the last non-empty, non-comment line in the section to insert after
+    let insertAfter = sectionEnd - 1;
+    for (let i = sectionEnd - 1; i > sectionIdx; i--) {
+        if (lines[i].trim() !== '' && !lines[i].trim().startsWith('<!--')) {
+            insertAfter = i;
+            break;
+        }
+    }
+    const newLines = [
+        ...lines.slice(0, insertAfter + 1),
+        ...diffText.split('\n'),
+        '',
+        ...lines.slice(insertAfter + 1),
+    ];
+    return newLines.join('\n');
+}
+const CYCLE_HISTORY_CAP = 5;
+/**
+ * Update the Retro Cycle History table in patina.md.
+ * Keeps at most CYCLE_HISTORY_CAP rows — oldest rows are dropped when the cap
+ * is exceeded. Full cycle detail is preserved in .patina/cycles/.
+ */
+function updateCycleHistory(content, insight, changeDesc) {
+    const today = new Date().toISOString().slice(0, 10);
+    const cycleCount = (content.match(/^\| \d+/gm) || []).length + 1;
+    const newRow = `| ${cycleCount} | ${today} | ${insight.slice(0, 60)}… | ${changeDesc.slice(0, 50)}… |`;
+    const placeholder = '| — | — | — | — |';
+    if (content.includes(placeholder)) {
+        return content.replace(placeholder, newRow);
+    }
+    // Append a new row before the end of the history table
+    const historyHeader = '## 7. Retro Cycle History';
+    const historyIdx = content.indexOf(historyHeader);
+    if (historyIdx === -1)
+        return content;
+    const after = content.slice(historyIdx);
+    const lastRowMatch = after.match(/(\| .+ \|\n?)(?!.*\| .+ \|)/s);
+    if (!lastRowMatch)
+        return content;
+    const insertPos = historyIdx + after.indexOf(lastRowMatch[0]) + lastRowMatch[0].length;
+    let updated = content.slice(0, insertPos) + newRow + '\n' + content.slice(insertPos);
+    // Trim oldest rows if over cap — find all data rows in Section 7 and drop from the top
+    const headerMatch = updated.match(/## 7\. Retro Cycle History[\s\S]*?\| Cycle \| Date \| Key Insight \| Change Made \|\n\|[-| ]+\|\n/);
+    if (headerMatch) {
+        const tableStart = updated.indexOf(headerMatch[0]) + headerMatch[0].length;
+        const afterTable = updated.slice(tableStart);
+        const rowRegex = /^\| \d+ \|.+\|\n?/gm;
+        const rows = [...afterTable.matchAll(rowRegex)];
+        if (rows.length > CYCLE_HISTORY_CAP) {
+            const excess = rows.length - CYCLE_HISTORY_CAP;
+            const firstKeep = rows[excess].index;
+            updated = updated.slice(0, tableStart) + afterTable.slice(firstKeep);
+        }
+    }
+    return updated;
+}
+export async function applyCommand() {
+    assertInitialised();
+    const cwd = process.cwd();
+    const pending = readPendingDiff(cwd);
+    if (!pending) {
+        console.log(yellow('No pending diff found.'));
+        console.log(dim('Run `patina run` first, then `patina diff` to review.'));
+        return;
+    }
+    const livingDocPath = path.join(cwd, LIVING_DOC_FILE);
+    console.log(`\n${bold('patina apply')} — applying instruction change`);
+    console.log(hr());
+    console.log(`  Section : ${cyan(pending.section)}`);
+    console.log(`  Adding  :\n`);
+    pending.diff.split('\n').forEach(line => {
+        console.log(`    ${green('+ ' + line)}`);
+    });
+    console.log();
+    const ok = await confirm(`Apply this change to ${LIVING_DOC_FILE}? [y/N] `);
+    if (!ok) {
+        console.log(dim('Aborted. Pending diff unchanged.'));
+        return;
+    }
+    // Read or create living doc
+    let content = fs.existsSync(livingDocPath)
+        ? fs.readFileSync(livingDocPath, 'utf-8')
+        : '# AI Operating Constitution\n\n## 1. Working Agreements\n\n';
+    // Apply the diff
+    content = applyDiffToDoc(content, pending.section, pending.diff);
+    // Update cycle history
+    content = updateCycleHistory(content, pending.rationale, pending.diff.slice(0, 50));
+    // Update the "last updated" timestamp
+    content = content.replace(/> Maintained by `patina`\. Last updated: .+/, `> Maintained by \`patina\`. Last updated: ${new Date().toISOString().slice(0, 10)}`);
+    fs.writeFileSync(livingDocPath, content, 'utf-8');
+    // Warn if patina.md is getting large
+    const SIZE_WARN_BYTES = 5 * 1024; // 5KB
+    if (Buffer.byteLength(content, 'utf-8') > SIZE_WARN_BYTES) {
+        console.log(yellow('⚠') + `  patina.md is over 5KB — consider reviewing sections for outdated entries.`);
+    }
+    // Clear pending diff
+    const pendingDiffPath = path.join(cwd, PENDING_DIFF_FILE);
+    if (fs.existsSync(pendingDiffPath))
+        fs.unlinkSync(pendingDiffPath);
+    // Update metrics.json with cycle count
+    const metricsPath = path.join(cwd, METRICS_FILE);
+    if (fs.existsSync(metricsPath)) {
+        try {
+            const metrics = JSON.parse(fs.readFileSync(metricsPath, 'utf-8'));
+            metrics.cycles_completed = (metrics.cycles_completed || 0) + 1;
+            metrics.last_apply = new Date().toISOString();
+            fs.writeFileSync(metricsPath, JSON.stringify(metrics, null, 2) + '\n', 'utf-8');
+        }
+        catch { /* non-fatal */ }
+    }
+    console.log();
+    console.log(green('✓') + ` Applied to ${bold(LIVING_DOC_FILE)}`);
+    console.log(green('✓') + ' Cycle history updated');
+    console.log(green('✓') + ' Pending diff cleared');
+    console.log();
+    console.log(dim(`Next: review ${LIVING_DOC_FILE} to confirm the change looks right.`));
+    console.log(dim('Run `patina ingest` at the start of your next cycle to continue tracking.'));
+    console.log();
+}
+//# sourceMappingURL=apply.js.map

package/dist/commands/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/commands/apply.ts"],"names":[],"mappings":"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"}

package/dist/commands/capture.d.ts

@@ -0,0 +1,5 @@
+export interface CaptureOptions {
+    tag?: string;
+}
+export declare function captureCommand(text: string | undefined, options: CaptureOptions): Promise<void>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/commands/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AA0CA,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Ef"}

package/dist/commands/capture.js

@@ -0,0 +1,88 @@
+import { spawnSync } from 'child_process';
+import readline from 'readline';
+import { assertInitialised, writeCapture, CAPTURE_TAGS, } from '../lib/storage.js';
+// ---------------------------------------------------------------------------
+// ANSI helpers
+// ---------------------------------------------------------------------------
+const isTTY = process.stdout.isTTY;
+function bold(s) { return isTTY ? `\x1b[1m${s}\x1b[0m` : s; }
+function dim(s) { return isTTY ? `\x1b[2m${s}\x1b[0m` : s; }
+function green(s) { return isTTY ? `\x1b[32m${s}\x1b[0m` : s; }
+function cyan(s) { return isTTY ? `\x1b[36m${s}\x1b[0m` : s; }
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function getGitAuthor() {
+    const result = spawnSync('git', ['config', 'user.name'], { encoding: 'utf8' });
+    if (result.status === 0 && result.stdout.trim()) {
+        return result.stdout.trim();
+    }
+    return process.env.USER ?? 'unknown';
+}
+function generateId(now) {
+    const ts = now.toISOString().replace(/[:.]/g, '-');
+    const rand = Math.random().toString(36).slice(2, 6);
+    return `${ts}-${rand}`;
+}
+export async function captureCommand(text, options) {
+    assertInitialised();
+    let captureText = text?.trim();
+    let captureTag;
+    // Validate tag option if provided
+    if (options.tag) {
+        if (!CAPTURE_TAGS.includes(options.tag)) {
+            console.error(`Invalid tag "${options.tag}". Valid tags: ${CAPTURE_TAGS.join(', ')}`);
+            process.exit(1);
+        }
+        captureTag = options.tag;
+    }
+    // Interactive mode when no inline text given
+    if (!captureText) {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: isTTY,
+        });
+        captureText = await new Promise((resolve) => {
+            rl.question(`${bold('What happened?')}\n> `, (answer) => {
+                resolve(answer.trim());
+            });
+        });
+        if (!captureText) {
+            rl.close();
+            console.log(dim('Nothing captured.'));
+            return;
+        }
+        if (!captureTag) {
+            const tagAnswer = await new Promise((resolve) => {
+                rl.question(`\n${bold('Tag')} ${dim(`(${CAPTURE_TAGS.join(' / ')} — Enter to skip)`)}\n> `, (answer) => resolve(answer.trim().toLowerCase()));
+            });
+            if (CAPTURE_TAGS.includes(tagAnswer)) {
+                captureTag = tagAnswer;
+            }
+        }
+        rl.close();
+    }
+    const now = new Date();
+    const capture = {
+        id: generateId(now),
+        text: captureText,
+        tag: captureTag,
+        author: getGitAuthor(),
+        timestamp: now.toISOString(),
+    };
+    writeCapture(capture);
+    const tagLabel = captureTag ? ` ${cyan(`[${captureTag}]`)}` : '';
+    const when = now.toLocaleDateString('en-US', {
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+    });
+    console.log();
+    console.log(`${green('✓')} Captured${tagLabel}: ${captureText}`);
+    console.log(dim(`  by ${capture.author} · ${when}`));
+    console.log(dim('  Feeds into your next `patina run`.'));
+    console.log();
+}
+//# sourceMappingURL=capture.js.map

package/dist/commands/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"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"}

package/dist/commands/diff.d.ts

@@ -0,0 +1,2 @@
+export declare function diffCommand(): Promise<void>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAgBA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAsCjD"}

package/dist/commands/diff.js

@@ -0,0 +1,43 @@
+import fs from 'fs';
+import path from 'path';
+import { assertInitialised, readPendingDiff, LIVING_DOC_FILE, } from '../lib/storage.js';
+const isTTY = process.stdout.isTTY;
+function bold(s) { return isTTY ? `\x1b[1m${s}\x1b[0m` : s; }
+function dim(s) { return isTTY ? `\x1b[2m${s}\x1b[0m` : s; }
+function green(s) { return isTTY ? `\x1b[32m${s}\x1b[0m` : s; }
+function cyan(s) { return isTTY ? `\x1b[36m${s}\x1b[0m` : s; }
+function yellow(s) { return isTTY ? `\x1b[33m${s}\x1b[0m` : s; }
+function hr(len = 60) { return dim('─'.repeat(len)); }
+export async function diffCommand() {
+    assertInitialised();
+    const cwd = process.cwd();
+    const pending = readPendingDiff(cwd);
+    if (!pending) {
+        console.log(yellow('No pending diff found.'));
+        console.log(dim('Run `patina run` first to generate a retrospective.'));
+        return;
+    }
+    const livingDocPath = path.join(cwd, LIVING_DOC_FILE);
+    const livingDocExists = fs.existsSync(livingDocPath);
+    console.log(`\n${bold('patina diff')} — proposed instruction change`);
+    console.log(hr());
+    console.log(`  Generated : ${dim(new Date(pending.timestamp).toLocaleString())}`);
+    console.log(`  Target    : ${cyan(livingDocExists ? LIVING_DOC_FILE : LIVING_DOC_FILE + ' (will be created)')}`);
+    console.log(`  Section   : ${cyan(pending.section)}`);
+    console.log();
+    console.log(bold('Rationale'));
+    console.log(hr());
+    console.log(`  ${pending.rationale}`);
+    console.log();
+    console.log(bold('Proposed addition'));
+    console.log(hr());
+    pending.diff.split('\n').forEach(line => {
+        console.log(`  ${green('+ ' + line)}`);
+    });
+    console.log();
+    console.log(hr());
+    console.log(`Run ${cyan('`patina buff`')} to apply this change to ${LIVING_DOC_FILE}.`);
+    console.log(`Delete ${dim('.patina/pending-diff.json')} to discard it.`);
+    console.log();
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"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"}

package/dist/commands/ingest.d.ts

@@ -0,0 +1,14 @@
+export interface IngestOptions {
+    claudeDir?: string;
+    verbose?: boolean;
+}
+/**
+ * Core ingest logic — returns counts. Used by both ingestCommand and auto-ingest in patina run.
+ */
+export declare function runIngest(options?: IngestOptions): {
+    ingested: number;
+    skipped: number;
+    errors: number;
+};
+export declare function ingestCommand(options?: IngestOptions): Promise<void>;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/commands/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0C5G;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6E9E"}