@jigyasudham/veto 3.3.0 → 3.5.0

package/dist/lessons/on-save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-save.js","sourceRoot":"","sources":["../../src/lessons/on-save.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,EAAE;AACF,yEAAyE;AACzE,8EAA8E;AAC9E,6EAA6E;AAC7E,qBAAqB;AACrB,EAAE;AACF,8EAA8E;AAC9E,8CAA8C;AAC9C,EAAE;AACF,8EAA8E;AAC9E,iEAAiE;AAEjE,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,SAAS,GAAG,GAAG,CAAC;AAYtB,MAAM,UAAU,GAAG,uHAAuH,CAAC;AAE3I;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAA6B,EAAE;IAC3D,IAAI,CAAC,sBAAsB,EAAE;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,iBAAiB,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC9B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IACpC,4EAA4E;IAC5E,sEAAsE;IACtE,4DAA4D;IAC5D,IAAI,KAAK,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,4EAA4E;IAC5E,uCAAuC;IACvC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,OAAO;QACL,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU;QACnD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/lessons/select.d.ts

@@ -0,0 +1,23 @@
+import type { LessonSource } from './adapters/index.js';
+export type ShadowSelection = {
+    lessonIds: string[];
+    estimatedTokens: number;
+    targetProjectIdentity: string | null;
+    reason: 'selected' | 'no_match' | 'consent_off' | 'project_excluded';
+};
+/** Rough, model-agnostic: about four characters per token. */
+export declare const estimateTokens: (text: string) => number;
+/** Deterministic, non-delivering selection used only for prospective shadow logs. */
+export declare function selectLessonsForShadow(input: {
+    query: string;
+    targetProjectDir: string;
+    targetHost: LessonSource;
+    now?: number;
+}): ShadowSelection;
+/** Append-only prospective evidence. It records IDs and metadata, never delivery. */
+export declare function logShadowSelection(input: {
+    query: string;
+    targetHost: LessonSource;
+    selection: ShadowSelection;
+}): string;
+//# sourceMappingURL=select.d.ts.map

package/dist/lessons/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/lessons/select.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAcxD,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,kBAAkB,CAAC;CACtE,CAAC;AAIF,8DAA8D;AAC9D,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MAAoC,CAAC;AA2DnF,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,YAAY,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CA+ClJ;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,GAAG,MAAM,CAOzH"}

package/dist/lessons/select.js

@@ -0,0 +1,136 @@
+import { randomUUID } from 'node:crypto';
+import { basename, dirname } from 'node:path';
+import { getDb } from '../memory/local.js';
+import { tokenize } from '../transcripts/tokenize.js';
+import { STOPWORDS } from '../transcripts/stopwords.js';
+import { isLessonsSharingEnabled } from '../memory/config.js';
+import { resolveProjectIdentity } from './identity.js';
+import { claudeProjectSlug, sameClaudeSlug } from './source-project.js';
+import { disabledLessonSources, isProjectExcluded, lessonEntryKey } from './store.js';
+const K1 = 1.2;
+const B = 0.75;
+const TOKEN_CAP = 500;
+// A note must share at least this many distinct query terms: one common word
+// in common ("code", "user") is coincidence, not relevance.
+const MIN_MATCHED_TERMS = 2;
+const STATUS_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+const STATUS_TITLE_RE = /\b(status|progress|next steps?|todo|wip|in progress)\b/i;
+const title = (row) => row.text_masked.split('\n', 1)[0].trim();
+/** Rough, model-agnostic: about four characters per token. */
+export const estimateTokens = (text) => Math.ceil(text.length / 4);
+/**
+ * The host already has this note in context, so re-injecting it only spends
+ * the budget. Claude loads the memory folder of the project it runs in; Codex
+ * and Gemini load their global file in every session. A Claude note from the
+ * SAME project but another checkout's folder (D: vs F:) is not loaded, and is
+ * exactly what sharing is for.
+ */
+function nativelyLoaded(row, host, projectDir) {
+    if (row.source_cli !== host)
+        return false;
+    if (host !== 'claude')
+        return true;
+    return sameClaudeSlug(basename(dirname(dirname(row.source_path))), claudeProjectSlug(projectDir));
+}
+function staleStatus(row, now) {
+    return STATUS_TITLE_RE.test(title(row)) && now - Date.parse(row.source_mtime) > STATUS_TTL_MS;
+}
+/**
+ * Which rows may reach this project at all: its own project's notes (any
+ * scope, quarantined included, since they never leave the project), plus other
+ * projects' user/machine notes that are not quarantined.
+ */
+function eligible(row, targetIdentity) {
+    if (row.project_identity === targetIdentity)
+        return true;
+    return row.scope !== 'project' && row.quarantined === 0;
+}
+/**
+ * BM25 of each candidate against the query. Collection statistics (document
+ * frequency, average length) come from the WHOLE lessons table: computed over
+ * the few eligible candidates they would make any shared word look rare.
+ */
+function rank(query, candidates, collection) {
+    // Scored on sub-tokens (recall), gated on whole words: `git-bash` expands to
+    // three terms but is one word, and one word must not clear the two-word bar.
+    const terms = [...new Set(tokenize(query).filter(term => !STOPWORDS.has(term)))];
+    const words = [...new Set(tokenize(query, false).filter(word => !STOPWORDS.has(word)))];
+    const docs = new Map(collection.map(row => [row.id, tokenize(row.text_masked)]));
+    const avg = [...docs.values()].reduce((sum, doc) => sum + doc.length, 0) / Math.max(docs.size, 1);
+    const df = new Map(terms.map(term => [term, [...docs.values()].filter(doc => doc.includes(term)).length]));
+    const needed = Math.min(MIN_MATCHED_TERMS, words.length);
+    return candidates.map(row => {
+        const doc = docs.get(row.id) ?? tokenize(row.text_masked);
+        const docWords = new Set(tokenize(row.text_masked, false));
+        const matched = words.filter(word => docWords.has(word)).length;
+        let score = 0;
+        for (const term of terms) {
+            const tf = doc.filter(token => token === term).length;
+            if (!tf)
+                continue;
+            const n = df.get(term) ?? 0;
+            const idf = Math.log(1 + (docs.size - n + 0.5) / (n + 0.5));
+            score += idf * (tf * (K1 + 1)) / (tf + K1 * (1 - B + B * (doc.length / Math.max(avg, 1))));
+        }
+        return { row, score: matched >= needed ? score : 0, matched };
+    });
+}
+/** Deterministic, non-delivering selection used only for prospective shadow logs. */
+export function selectLessonsForShadow(input) {
+    if (!isLessonsSharingEnabled())
+        return { lessonIds: [], estimatedTokens: 0, targetProjectIdentity: null, reason: 'consent_off' };
+    const targetIdentity = resolveProjectIdentity(input.targetProjectDir);
+    if (isProjectExcluded(targetIdentity))
+        return { lessonIds: [], estimatedTokens: 0, targetProjectIdentity: targetIdentity, reason: 'project_excluded' };
+    const now = input.now ?? Date.now();
+    const disabled = disabledLessonSources();
+    const all = getDb().prepare('SELECT * FROM lessons').all();
+    const candidates = all.filter(row => !disabled.has(row.source_cli)
+        && !nativelyLoaded(row, input.targetHost, input.targetProjectDir)
+        && !staleStatus(row, now)
+        && eligible(row, targetIdentity));
+    // Relevance first, then newest source on ties; a note without enough query
+    // terms in common is not selected at all, however much budget is left.
+    const ranked = rank(input.query, candidates, all)
+        .filter(entry => entry.score > 0)
+        .sort((a, b) => b.score - a.score || Date.parse(b.row.source_mtime) - Date.parse(a.row.source_mtime) || a.row.id.localeCompare(b.row.id));
+    // Newest wins on conflict: the same entry held in several places (one memory
+    // file copied into the D:, F: and G: checkouts' folders) counts once, as its
+    // newest version, even when an older copy ranks higher. Identical text from
+    // different entries is served once too. Same-named files of two different
+    // projects are two entries.
+    const newestByEntry = new Map();
+    for (const row of candidates) {
+        const held = newestByEntry.get(lessonEntryKey(row));
+        if (!held || Date.parse(row.source_mtime) > Date.parse(held.source_mtime))
+            newestByEntry.set(lessonEntryKey(row), row);
+    }
+    const chosen = [];
+    const seenText = new Set();
+    let tokens = 0;
+    for (const { row } of ranked) {
+        if (newestByEntry.get(lessonEntryKey(row)) !== row || seenText.has(row.text_masked))
+            continue;
+        const estimate = estimateTokens(row.text_masked);
+        if (tokens + estimate > TOKEN_CAP)
+            continue;
+        chosen.push(row);
+        seenText.add(row.text_masked);
+        tokens += estimate;
+    }
+    return {
+        lessonIds: chosen.map(row => row.id),
+        estimatedTokens: tokens,
+        targetProjectIdentity: targetIdentity,
+        reason: chosen.length ? 'selected' : 'no_match',
+    };
+}
+/** Append-only prospective evidence. It records IDs and metadata, never delivery. */
+export function logShadowSelection(input) {
+    const id = randomUUID();
+    getDb().prepare(`INSERT INTO lesson_shadow_log (id, query, target_project_identity, target_host, lesson_ids, estimated_tokens, reason, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+        .run(id, input.query, input.selection.targetProjectIdentity ?? '', input.targetHost, JSON.stringify(input.selection.lessonIds), input.selection.estimatedTokens, input.selection.reason, new Date().toISOString());
+    return id;
+}
+//# sourceMappingURL=select.js.map

package/dist/lessons/select.js.map

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

package/dist/lessons/source-project.d.ts

@@ -0,0 +1,9 @@
+import { claudeProjectSlug, sameClaudeSlug } from '../transcripts/claude-paths.js';
+export { claudeProjectSlug, sameClaudeSlug };
+export type ClaudeFolderProject = {
+    projectDir: string | null;
+    via: 'transcript' | 'known' | 'walk' | 'unresolved';
+};
+/** Resolve a ~/.claude/projects/<slug> folder to the project directory it was created for. */
+export declare function resolveClaudeProjectFolder(folder: string, slug: string): ClaudeFolderProject;
+//# sourceMappingURL=source-project.d.ts.map

package/dist/lessons/source-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-project.d.ts","sourceRoot":"","sources":["../../src/lessons/source-project.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC;AAqF7C,MAAM,MAAM,mBAAmB,GAAG;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAErH,8FAA8F;AAC9F,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAQ5F"}

package/dist/lessons/source-project.js

@@ -0,0 +1,149 @@
+// Which project does a Claude memory folder belong to?
+//
+// Claude Code keeps a project's memory in ~/.claude/projects/<slug>/memory,
+// where <slug> is the project's cwd with every non-alphanumeric character
+// replaced by '-'. The slug is lossy (D:\a-b and D:\a\b share one), so it is
+// reversed from evidence, most reliable first:
+//   1. a transcript in the same folder recording its `cwd` (Claude deletes
+//      these after about 30 days, so many folders have none left);
+//   2. a project directory Veto already knows about with the same slug;
+//   3. a walk down from the drive or filesystem root, entering only folders
+//      whose own slug prefixes what is left. The walk is bounded, and more
+//      than one match counts as unresolved.
+// Unresolved folders keep a slug identity that matches no other project.
+import { closeSync, openSync, readdirSync, readSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { getDb } from '../memory/local.js';
+import { claudeProjectSlug, sameClaudeSlug } from '../transcripts/claude-paths.js';
+export { claudeProjectSlug, sameClaudeSlug };
+const HEAD_BYTES = 256 * 1024;
+const TRANSCRIPTS_TO_TRY = 3;
+const WALK_BUDGET = 400;
+const WALK_DEPTH = 16;
+const win32 = process.platform === 'win32';
+function readHead(path) {
+    let fd = null;
+    try {
+        fd = openSync(path, 'r');
+        const buf = Buffer.allocUnsafe(HEAD_BYTES);
+        return buf.toString('utf8', 0, readSync(fd, buf, 0, HEAD_BYTES, 0));
+    }
+    catch {
+        return '';
+    }
+    finally {
+        if (fd !== null) {
+            try {
+                closeSync(fd);
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
+function cwdFromTranscripts(folder, slug) {
+    let names;
+    try {
+        names = readdirSync(folder).filter(name => name.endsWith('.jsonl'));
+    }
+    catch {
+        return null;
+    }
+    const newest = names
+        .map(name => { try {
+        return { path: join(folder, name), mtime: statSync(join(folder, name)).mtimeMs };
+    }
+    catch {
+        return null;
+    } })
+        .filter((entry) => entry !== null)
+        .sort((a, b) => b.mtime - a.mtime)
+        .slice(0, TRANSCRIPTS_TO_TRY);
+    for (const { path } of newest) {
+        for (const match of readHead(path).matchAll(/"cwd"\s*:\s*("(?:[^"\\]|\\.)*")/g)) {
+            try {
+                const cwd = JSON.parse(match[1]);
+                if (cwd && sameClaudeSlug(claudeProjectSlug(cwd), slug))
+                    return cwd;
+            }
+            catch { /* a truncated field at the end of the head */ }
+        }
+    }
+    return null;
+}
+function cwdFromKnownProjects(slug) {
+    const db = getDb();
+    // Keyed case-folded on Windows so D:\Veto and d:\veto count once; the first
+    // spelling seen (sessions before the case-folded alias table) is kept.
+    const found = new Map();
+    for (const sql of [
+        'SELECT DISTINCT project_dir AS dir FROM sessions WHERE project_dir IS NOT NULL',
+        'SELECT alias_path AS dir FROM project_identity_aliases',
+    ]) {
+        try {
+            for (const { dir } of db.prepare(sql).all()) {
+                const key = (win32 ? dir.toLowerCase() : dir).replace(/[\\/]+$/, '');
+                if (sameClaudeSlug(claudeProjectSlug(dir), slug) && !found.has(key))
+                    found.set(key, dir);
+            }
+        }
+        catch { /* table absent in an old database */ }
+    }
+    return found.size === 1 ? [...found.values()][0] : null;
+}
+function cwdFromWalk(slug) {
+    const drive = /^([A-Za-z])--(.*)$/.exec(slug);
+    let root;
+    let rest;
+    if (win32 && drive) {
+        root = `${drive[1]}:\\`;
+        rest = drive[2];
+    }
+    else if (!win32 && slug.startsWith('-')) {
+        root = '/';
+        rest = slug.slice(1);
+    }
+    else
+        return null;
+    const matches = [];
+    let budget = WALK_BUDGET;
+    const visit = (dir, remaining, depth) => {
+        if (matches.length > 1 || budget-- <= 0 || depth > WALK_DEPTH)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory() && !entry.isSymbolicLink())
+                continue;
+            const part = claudeProjectSlug(entry.name);
+            if (sameClaudeSlug(part, remaining)) {
+                matches.push(join(dir, entry.name));
+                continue;
+            }
+            const prefix = `${part}-`;
+            if (sameClaudeSlug(remaining.slice(0, prefix.length), prefix))
+                visit(join(dir, entry.name), remaining.slice(prefix.length), depth + 1);
+        }
+    };
+    if (rest)
+        visit(root, rest, 0);
+    return matches.length === 1 ? matches[0] : null;
+}
+/** Resolve a ~/.claude/projects/<slug> folder to the project directory it was created for. */
+export function resolveClaudeProjectFolder(folder, slug) {
+    const fromTranscript = cwdFromTranscripts(folder, slug);
+    if (fromTranscript)
+        return { projectDir: fromTranscript, via: 'transcript' };
+    const known = cwdFromKnownProjects(slug);
+    if (known)
+        return { projectDir: known, via: 'known' };
+    const walked = cwdFromWalk(slug);
+    if (walked)
+        return { projectDir: walked, via: 'walk' };
+    return { projectDir: null, via: 'unresolved' };
+}
+//# sourceMappingURL=source-project.js.map

package/dist/lessons/source-project.js.map

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

package/dist/lessons/store.d.ts

@@ -0,0 +1,135 @@
+import type { LessonSource } from './adapters/index.js';
+import type { LessonScope, ScopeReason } from './classify.js';
+export type LessonRow = {
+    id: string;
+    source_cli: LessonSource;
+    source_path: string;
+    section_anchor: string;
+    project_identity: string;
+    project_label: string | null;
+    scope: LessonScope;
+    scope_reason: ScopeReason | null;
+    kind: string;
+    text_masked: string;
+    source_hash: string;
+    source_mtime: string;
+    quarantined: number;
+    quarantine_reason: string | null;
+    created_at: string;
+    updated_at: string;
+};
+/** A section after masking and classification; raw memory text never reaches the store. */
+export type HarvestedSection = {
+    anchor: string;
+    textMasked: string;
+    scope: LessonScope;
+    scopeReason: ScopeReason;
+    kind: string;
+    quarantineReason: string | null;
+};
+export type SyncLessonsInput = {
+    sourceCli: LessonSource;
+    sourcePath: string;
+    projectIdentity: string;
+    projectLabel: string | null;
+    sourceMtime: string;
+    sections: HarvestedSection[];
+};
+/** A note's text, compared the way a person would: case and spacing do not make it a different note. */
+export declare function lessonSignature(textMasked: string): string;
+/**
+ * One memory entry wherever it is kept: the same file name and section in any
+ * checkout of the same project (the D:, F: and G: copies of one Claude memory
+ * folder) is one entry, held in several places.
+ */
+export declare function lessonEntryKey(row: {
+    source_cli: string;
+    project_identity: string;
+    source_path: string;
+    section_anchor: string;
+}): string;
+/**
+ * Tombstone a note and delete it with every version and copy of it. Each row
+ * removed gets a tombstone of its own, so a copy's later edits stay forgotten,
+ * and so does text identical to a copy (not only to the note picked). Returns
+ * how many rows were removed, the note itself included.
+ */
+export declare function tombstoneLesson(row: LessonRow): number;
+export declare function isProjectExcluded(projectIdentity: string): boolean;
+export type ProjectExclusion = {
+    project_identity: string;
+    project_label: string | null;
+    created_at: string;
+};
+export declare function excludedProjects(): ProjectExclusion[];
+/** Keep a project out of sharing, and delete what was already harvested from it. */
+export declare function excludeProject(projectIdentity: string, projectLabel: string | null): {
+    added: boolean;
+    removed: number;
+};
+export declare function includeProject(projectIdentity: string): boolean;
+/**
+ * Make a source's rows exactly its current sections: insert new ones, update
+ * changed ones, delete the rest (lifetime = source). A source that failed to
+ * parse never reaches this function, so a malformed file cannot erase rows;
+ * an empty section list is a successful parse of nothing and clears them.
+ * A forgotten section counts as absent: it is deleted, never re-added.
+ */
+export declare function syncLessons(input: SyncLessonsInput): {
+    inserted: number;
+    updated: number;
+    removed: number;
+};
+/** Delete every row harvested from one source file. */
+export declare function deleteLessonSource(source: LessonSource, sourcePath: string): number;
+/** Delete every row whose source file is no longer among the discovered ones. */
+export declare function purgeVanishedLessonSources(present: Array<{
+    source: LessonSource;
+    sourcePath: string;
+}>): number;
+export type LessonFileState = {
+    mtime: string | null;
+    size: number | null;
+    content_hash: string | null;
+    project_identity: string | null;
+    harvester_version: number;
+    unavailable_streak: number;
+};
+/** What this file looked like when it was last harvested, or null if never. */
+export declare function lessonFileState(source: LessonSource, sourcePath: string): LessonFileState | null;
+/** Remember a successful look at a file. Clears any unavailable streak. */
+export declare function recordLessonFileState(input: {
+    source: LessonSource;
+    sourcePath: string;
+    mtime: string;
+    size: number;
+    contentHash: string;
+    projectIdentity: string;
+    harvesterVersion: number;
+}): void;
+/**
+ * A file that could not be read. The streak grows so a source that is gone —
+ * an unplugged drive, most often — is probed less and less on the save path,
+ * where a multi-second stat would be paid by the user for nothing.
+ */
+export declare function recordLessonFileUnavailable(source: LessonSource, sourcePath: string): number;
+/** Drop remembered state for files no longer discovered, so it cannot outlive them. */
+export declare function purgeVanishedLessonFileState(present: Array<{
+    source: LessonSource;
+    sourcePath: string;
+}>): number;
+/**
+ * Projects whose Claude folder was never traced back to a directory on this
+ * machine - an unplugged drive, most often. Counted from what is stored rather
+ * than from a pass, because a pass that changed nothing resolves no projects.
+ */
+export declare function unresolvedProjectCount(): number;
+/** `veto lessons off` and a forced refresh both need the memory of files cleared. */
+export declare function clearLessonFileState(): number;
+export declare function enableLessonSource(source: LessonSource): boolean;
+export declare function disableLessonSource(source: LessonSource, reason: string): void;
+export declare function isLessonSourceEnabled(source: LessonSource): boolean;
+/** Hosts whose adapter tripped the format-drift canary; their rows are not served. */
+export declare function disabledLessonSources(): Set<LessonSource>;
+export declare function disabledLessonSourceReasons(): Map<LessonSource, string>;
+//# sourceMappingURL=store.d.ts.map

package/dist/lessons/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/lessons/store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,YAAY,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AASF,wGAAwG;AACxG,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzI;AAUD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAuBtD;AAED,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9G,wBAAgB,gBAAgB,IAAI,gBAAgB,EAAE,CAErD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQxH;AAED,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAE/D;AASD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAmC3G;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAU/G;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAIhG;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;CAC/I,GAAG,IAAI,CAMP;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAO5F;AAED,uFAAuF;AACvF,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAUjH;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI9E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAGnE;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,YAAY,CAAC,CAEzD;AAED,wBAAgB,2BAA2B,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAGvE"}