@jigyasudham/veto 3.3.0 → 3.5.0

package/dist/lessons/manage.d.ts

@@ -0,0 +1,163 @@
+import { type LessonSource } from './adapters/index.js';
+import type { LessonScope } from './classify.js';
+import { type LessonSyncReport } from './harvest.js';
+import { type LessonRow, type ProjectExclusion } from './store.js';
+export declare const HOST_NAMES: Record<LessonSource, string>;
+/**
+ * Re-read every source so what is shown matches the files as they are now.
+ * Only with consent. A pass run from a command has no time budget: a person
+ * waiting for output would rather wait than be told a half-truth.
+ */
+export declare function refreshLessons(home?: string, options?: {
+    forced?: boolean;
+}): LessonSyncReport | null;
+export declare const lessonTitle: (row: LessonRow) => string;
+export declare function projectName(row: Pick<LessonRow, 'project_identity' | 'project_label'>): string;
+/** The label every note carries: which AI wrote it, for which project, when. */
+export declare function provenance(row: LessonRow): string;
+export type LessonReach = 'any-project' | 'own-project' | 'nowhere';
+/**
+ * Where a note may be selected (select.ts `eligible`): project notes and held
+ * notes only into their own project; the rest into any project. A held note
+ * from a global file, or any note of a folder no session can open under, has
+ * no project to go to.
+ */
+export declare function lessonReach(row: LessonRow): LessonReach;
+/** Which AIs may receive it. The AI that wrote it already reads it, except Claude in other folders. */
+export declare function receivingHosts(row: LessonRow): string;
+export declare const quarantineText: (reason: string | null) => string;
+export type LessonExplanation = {
+    row: LessonRow;
+    provenance: string;
+    scope: string;
+    held: string | null;
+    reach: string;
+    hostDisabled: string | null;
+};
+export declare function explainLesson(row: LessonRow): LessonExplanation;
+export type LessonFilter = {
+    scope?: LessonScope;
+    source?: LessonSource;
+    projectDir?: string;
+    shared?: boolean;
+    held?: boolean;
+};
+export declare function listLessons(filter?: LessonFilter): LessonRow[];
+export type FindLesson = {
+    row: LessonRow;
+} | {
+    error: 'too-short' | 'not-found';
+} | {
+    error: 'ambiguous';
+    matches: LessonRow[];
+};
+/** A note by its ID or any unique prefix of it (list shows the first 8 characters). */
+export declare function findLesson(idOrPrefix: string): FindLesson;
+/** Permanent: the note and every copy of it are deleted and never harvested again. */
+export declare function forgetLesson(row: LessonRow): {
+    removed: number;
+};
+export type LessonsOffResult = {
+    wasOn: boolean;
+    notes: number;
+    shadowLog: number;
+    remaining: number;
+};
+/**
+ * Turn sharing off and delete everything harvested, plus the would-have-shared
+ * log. Forgotten-note tombstones, exclusions and aliases stay: they are the
+ * user's own decisions and hold no note text. `remaining` is the purge proof.
+ */
+export declare function turnLessonsOff(): LessonsOffResult;
+export type LessonFlow = {
+    source: LessonSource;
+    projectIdentity: string;
+    projectLabel: string;
+    notes: number;
+    anyProject: number;
+    ownProject: number;
+    nowhere: number;
+    /** Notes whose scope would have let them travel, kept home by quarantine, by reason. */
+    heldBack: Record<string, number>;
+    unresolved: boolean;
+};
+/** Source → destination, one line per AI and project the notes came from. */
+export declare function lessonFlows(): LessonFlow[];
+/** The link that would most likely fix an unlinked folder. `aliasPath` is null when only the project is known, not the folder's own path. */
+export type AliasSuggestion = {
+    aliasPath: string | null;
+    targetDir: string;
+};
+export type UnresolvedFolder = {
+    identity: string;
+    label: string;
+    notes: number;
+    suggestion: AliasSuggestion | null;
+};
+/**
+ * The same project checked out on this machine: a known folder whose slug is
+ * the unlinked one's with another root (F:/a/b for D:/a/b, whose folder path
+ * is then known too), or failing that, one whose slug it ends with (a backup
+ * nested deeper, whose own path cannot be read back from its lossy slug).
+ * Anything but exactly one candidate suggests nothing.
+ */
+export declare function suggestAlias(identity: string, known: string[]): AliasSuggestion | null;
+/** Memory whose project Veto could not trace to a folder that exists: its project notes reach no session. */
+export declare function unresolvedFolders(): UnresolvedFolder[];
+/** Checkouts treated as one project: only groups of two or more folders are worth showing. */
+export declare function aliasGroups(): Array<{
+    identity: string;
+    paths: string[];
+}>;
+export type SetAliasResult = 
+/** memoryFolders: Claude memory folders this path names; 0 usually means a mistyped path. */
+{
+    ok: true;
+    identity: string;
+    label: string;
+    memoryFolders: number;
+} | {
+    ok: false;
+    error: 'target-missing' | 'same-folder' | 'different-repository';
+};
+/**
+ * Treat `aliasPath` as another checkout of the project at `targetDir`: its
+ * notes then count as that project's. For a drive that is not mounted, which
+ * is the case this exists for, the alias path need not exist. A folder that
+ * does exist and is a different repository is refused, since aliasing it
+ * would carry one project's private notes into another.
+ */
+export declare function setProjectAlias(aliasPath: string, targetDir: string): SetAliasResult;
+export declare function removeProjectAlias(aliasPath: string): boolean;
+export declare function excludeProjectDir(projectDir: string): {
+    label: string;
+    added: boolean;
+    removed: number;
+};
+export declare function includeProjectDir(projectDir: string): {
+    label: string;
+    removed: boolean;
+};
+/** Switch a host's harvester back on after a format change, and check it again straight away. */
+export declare function recheckSource(source: LessonSource, home?: string): {
+    wasDisabled: boolean;
+    stillDisabled: string | null;
+    report: LessonSyncReport | null;
+};
+export type LessonsStatus = {
+    sharing: boolean;
+    /** Consent was given for an older disclosure; sharing stays off until it is accepted again. */
+    needsReconsent: boolean;
+    consentAt: string | null;
+    notes: number;
+    byHost: Record<LessonSource, number>;
+    anyProject: number;
+    held: number;
+    disabledHosts: Map<LessonSource, string>;
+    excluded: ProjectExclusion[];
+    unresolved: number;
+    forgotten: number;
+    shadowLog: number;
+};
+export declare function lessonsStatus(): LessonsStatus;
+//# sourceMappingURL=manage.d.ts.map

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

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

package/dist/lessons/manage.js

@@ -0,0 +1,337 @@
+// The `veto lessons` surface: what Veto has harvested from each AI's own
+// memory, where each note may go, and the controls that stop it (council
+// 320c40dc, UX conditions). Everything here reads or changes Veto's own tables;
+// no host's memory file is ever written.
+import { existsSync, realpathSync, statSync } from 'node:fs';
+import { basename, dirname } from 'node:path';
+import { getConfig, disableLessonsSharing, isLessonsSharingEnabled, LESSONS_CONSENT_VERSION } from '../memory/config.js';
+import { getDb } from '../memory/local.js';
+import { LESSON_SOURCES } from './adapters/index.js';
+import { syncLessonSources } from './harvest.js';
+import { addProjectAlias, canonicalProjectPath, computeProjectIdentity, resolveProjectIdentity } from './identity.js';
+import { claudeProjectSlug, sameClaudeSlug } from './source-project.js';
+import { clearLessonFileState, disabledLessonSourceReasons, enableLessonSource, excludedProjects, excludeProject, includeProject, tombstoneLesson, } from './store.js';
+export const HOST_NAMES = { claude: 'Claude', codex: 'Codex', gemini: 'Gemini' };
+/**
+ * Re-read every source so what is shown matches the files as they are now.
+ * Only with consent. A pass run from a command has no time budget: a person
+ * waiting for output would rather wait than be told a half-truth.
+ */
+export function refreshLessons(home, options = {}) {
+    return isLessonsSharingEnabled() ? syncLessonSources({ home, forced: options.forced }) : null;
+}
+/**
+ * Forget what every file looked like, so the next pass reads them all again.
+ * Needed after a decision that changes what a file would yield without
+ * touching the file: re-including a project, or pointing an alias somewhere
+ * new. Without this the fast path would skip exactly the files that changed
+ * meaning.
+ */
+function invalidateHarvestedState() {
+    clearLessonFileState();
+}
+export const lessonTitle = (row) => row.text_masked.split('\n', 1)[0].trim();
+const isGlobal = (identity) => identity.startsWith('global:');
+/** A project no session can ever open under: a Claude folder never traced to a directory, or a folder that is not there. */
+function isUnresolved(identity) {
+    if (identity.startsWith('claude-slug:'))
+        return true;
+    if (!identity.startsWith('path:'))
+        return false;
+    try {
+        return !statSync(identity.slice('path:'.length)).isDirectory();
+    }
+    catch {
+        return true;
+    }
+}
+export function projectName(row) {
+    return isGlobal(row.project_identity) ? 'all projects' : row.project_label ?? row.project_identity;
+}
+/** The label every note carries: which AI wrote it, for which project, when. */
+export function provenance(row) {
+    return `from ${HOST_NAMES[row.source_cli]} memory · ${projectName(row)} · ${row.source_mtime.slice(0, 10)}`;
+}
+/**
+ * Where a note may be selected (select.ts `eligible`): project notes and held
+ * notes only into their own project; the rest into any project. A held note
+ * from a global file, or any note of a folder no session can open under, has
+ * no project to go to.
+ */
+export function lessonReach(row) {
+    if (row.scope !== 'project' && row.quarantined === 0)
+        return 'any-project';
+    return isGlobal(row.project_identity) || isUnresolved(row.project_identity) ? 'nowhere' : 'own-project';
+}
+/** Which AIs may receive it. The AI that wrote it already reads it, except Claude in other folders. */
+export function receivingHosts(row) {
+    if (row.source_cli === 'claude')
+        return 'Codex and Gemini, and Claude working in another folder';
+    return LESSON_SOURCES.filter(host => host !== row.source_cli).map(host => HOST_NAMES[host]).join(' and ')
+        + ` (${HOST_NAMES[row.source_cli]} already reads it)`;
+}
+const SCOPE_REASONS = {
+    'global-file': row => `it is in ${HOST_NAMES[row.source_cli]}'s global file, which it reads in every project`,
+    'names-project': row => `it names its own project (${projectName(row)}), so it is about that project`,
+    'user-entry': () => 'Claude saved it as a note about you (type: user)',
+    'feedback-entry': () => 'Claude saved it as feedback on how to work (type: feedback)',
+    'environment-heading': () => "its heading is about this machine's shell, console or network",
+    'project-default': () => 'anything not clearly about you or this machine stays with its project',
+};
+const QUARANTINE_REASONS = {
+    sensitive: 'it is about secrets, credentials, identity or personal details',
+    credential: 'it contains something that looks like a credential',
+    url: 'it contains a web address',
+    command: 'it contains a shell or network command',
+    directive: 'it tells an AI to fetch, send or run something, or to ignore its instructions',
+};
+export const quarantineText = (reason) => QUARANTINE_REASONS[reason ?? ''] ?? reason ?? '';
+export function explainLesson(row) {
+    const reason = row.scope_reason ? SCOPE_REASONS[row.scope_reason]?.(row) : null;
+    const reach = lessonReach(row);
+    const where = reach === 'any-project' ? 'any project'
+        : reach === 'own-project' ? `${projectName(row)} only`
+            : isGlobal(row.project_identity) ? 'nowhere: it is held back and has no project of its own'
+                : 'nowhere yet: Veto cannot tell which folder this memory belongs to (see veto lessons alias)';
+    return {
+        row,
+        provenance: provenance(row),
+        scope: `${row.scope}: ${reason ?? 'classified before Veto recorded why'}`,
+        held: row.quarantined ? `kept in its own project: ${quarantineText(row.quarantine_reason)}` : null,
+        reach: reach === 'nowhere' ? where : `${where}, in ${receivingHosts(row)}`,
+        hostDisabled: disabledLessonSourceReasons().get(row.source_cli) ?? null,
+    };
+}
+export function listLessons(filter = {}) {
+    const identity = filter.projectDir ? resolveProjectIdentity(filter.projectDir) : null;
+    const rows = getDb().prepare('SELECT * FROM lessons').all();
+    return rows
+        .filter(row => (!filter.scope || row.scope === filter.scope)
+        && (!filter.source || row.source_cli === filter.source)
+        && (!identity || row.project_identity === identity)
+        && (!filter.shared || lessonReach(row) === 'any-project')
+        && (!filter.held || row.quarantined === 1))
+        .sort((a, b) => Number(isGlobal(a.project_identity)) - Number(isGlobal(b.project_identity))
+        || projectName(a).localeCompare(projectName(b))
+        || b.source_mtime.localeCompare(a.source_mtime)
+        || a.id.localeCompare(b.id));
+}
+const MIN_ID_PREFIX = 4;
+/** A note by its ID or any unique prefix of it (list shows the first 8 characters). */
+export function findLesson(idOrPrefix) {
+    const prefix = idOrPrefix.trim().toLowerCase();
+    if (prefix.length < MIN_ID_PREFIX)
+        return { error: 'too-short' };
+    const matches = getDb().prepare("SELECT * FROM lessons WHERE substr(id, 1, ?) = ? ORDER BY id LIMIT 6").all(prefix.length, prefix);
+    if (matches.length === 1)
+        return { row: matches[0] };
+    return matches.length ? { error: 'ambiguous', matches } : { error: 'not-found' };
+}
+/** Permanent: the note and every copy of it are deleted and never harvested again. */
+export function forgetLesson(row) {
+    return { removed: tombstoneLesson(row) };
+}
+/**
+ * Turn sharing off and delete everything harvested, plus the would-have-shared
+ * log. Forgotten-note tombstones, exclusions and aliases stay: they are the
+ * user's own decisions and hold no note text. `remaining` is the purge proof.
+ */
+export function turnLessonsOff() {
+    const wasOn = isLessonsSharingEnabled();
+    disableLessonsSharing();
+    const db = getDb();
+    const notes = Number(db.prepare('DELETE FROM lessons').run().changes);
+    clearLessonFileState();
+    const shadowLog = Number(db.prepare('DELETE FROM lesson_shadow_log').run().changes);
+    const count = (table) => db.prepare(`SELECT COUNT(*) AS n FROM ${table}`).get().n;
+    return { wasOn, notes, shadowLog, remaining: count('lessons') + count('lesson_shadow_log') };
+}
+/** Source → destination, one line per AI and project the notes came from. */
+export function lessonFlows() {
+    const flows = new Map();
+    for (const row of getDb().prepare('SELECT * FROM lessons').all()) {
+        const key = `${row.source_cli}\n${row.project_identity}`;
+        let flow = flows.get(key);
+        if (!flow) {
+            flow = {
+                source: row.source_cli, projectIdentity: row.project_identity, projectLabel: projectName(row),
+                notes: 0, anyProject: 0, ownProject: 0, nowhere: 0, heldBack: {}, unresolved: isUnresolved(row.project_identity),
+            };
+            flows.set(key, flow);
+        }
+        flow.notes++;
+        const reach = lessonReach(row);
+        if (reach === 'any-project')
+            flow.anyProject++;
+        else if (reach === 'own-project')
+            flow.ownProject++;
+        else
+            flow.nowhere++;
+        if (row.quarantined && row.scope !== 'project') {
+            const reason = row.quarantine_reason ?? 'held';
+            flow.heldBack[reason] = (flow.heldBack[reason] ?? 0) + 1;
+        }
+    }
+    return [...flows.values()].sort((a, b) => Number(isGlobal(a.projectIdentity)) - Number(isGlobal(b.projectIdentity))
+        || b.notes - a.notes || a.projectLabel.localeCompare(b.projectLabel));
+}
+const isDirectory = (path) => { try {
+    return statSync(path).isDirectory();
+}
+catch {
+    return false;
+} };
+/** A folder as the file system spells it (D:/Veto, not the case-folded d:/veto the alias table keeps). */
+const trueCase = (dir) => { try {
+    return realpathSync.native(dir);
+}
+catch {
+    return dir;
+} };
+/** A Claude folder slug without its root: `F--a-b` and `D--a-b` differ only in the drive. */
+function slugTail(slug) {
+    const drive = /^([A-Za-z])--(.*)$/.exec(slug);
+    return drive ? { drive: drive[1], tail: drive[2] } : { drive: null, tail: slug.replace(/^-+/, '') };
+}
+/** Project folders on this machine that Veto has seen, spelled as the file system spells them. */
+function knownProjectDirs() {
+    const db = getDb();
+    const dirs = 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 = canonicalProjectPath(dir);
+                if (!dirs.has(key) && isDirectory(dir))
+                    dirs.set(key, trueCase(dir));
+            }
+        }
+        catch { /* table absent in an old database */ }
+    }
+    return [...dirs.values()];
+}
+/**
+ * The same project checked out on this machine: a known folder whose slug is
+ * the unlinked one's with another root (F:/a/b for D:/a/b, whose folder path
+ * is then known too), or failing that, one whose slug it ends with (a backup
+ * nested deeper, whose own path cannot be read back from its lossy slug).
+ * Anything but exactly one candidate suggests nothing.
+ */
+export function suggestAlias(identity, known) {
+    const exactPath = identity.startsWith('path:') ? identity.slice('path:'.length) : null;
+    const unlinked = slugTail(exactPath ? claudeProjectSlug(exactPath) : identity.slice('claude-slug:'.length));
+    const same = known.filter(dir => sameClaudeSlug(slugTail(claudeProjectSlug(dir)).tail, unlinked.tail));
+    const nested = known.filter(dir => {
+        const tail = slugTail(claudeProjectSlug(dir)).tail;
+        return unlinked.tail.length > tail.length + 1 && sameClaudeSlug(unlinked.tail.slice(-(tail.length + 1)), `-${tail}`);
+    });
+    const match = same.length ? same : nested;
+    if (match.length !== 1)
+        return null;
+    const targetDir = match[0];
+    if (exactPath)
+        return { aliasPath: exactPath, targetDir };
+    const drive = same.length && unlinked.drive && /^[A-Za-z]:/.test(targetDir) ? `${unlinked.drive.toUpperCase()}:${targetDir.slice(2)}` : null;
+    return { aliasPath: drive, targetDir };
+}
+/** Memory whose project Veto could not trace to a folder that exists: its project notes reach no session. */
+export function unresolvedFolders() {
+    const rows = getDb().prepare('SELECT project_identity, project_label, COUNT(*) AS notes FROM lessons GROUP BY project_identity, project_label')
+        .all();
+    const unresolved = rows.filter(row => isUnresolved(row.project_identity));
+    const known = unresolved.length ? knownProjectDirs() : [];
+    return unresolved.map(row => ({
+        identity: row.project_identity,
+        label: row.project_label ?? row.project_identity,
+        notes: row.notes,
+        suggestion: suggestAlias(row.project_identity, known),
+    }));
+}
+/** Checkouts treated as one project: only groups of two or more folders are worth showing. */
+export function aliasGroups() {
+    const rows = getDb().prepare('SELECT alias_path, project_identity FROM project_identity_aliases ORDER BY alias_path')
+        .all();
+    const groups = new Map();
+    for (const row of rows)
+        groups.set(row.project_identity, [...(groups.get(row.project_identity) ?? []), row.alias_path]);
+    return [...groups].filter(([, paths]) => paths.length > 1).map(([identity, paths]) => ({ identity, paths }));
+}
+/**
+ * Treat `aliasPath` as another checkout of the project at `targetDir`: its
+ * notes then count as that project's. For a drive that is not mounted, which
+ * is the case this exists for, the alias path need not exist. A folder that
+ * does exist and is a different repository is refused, since aliasing it
+ * would carry one project's private notes into another.
+ */
+export function setProjectAlias(aliasPath, targetDir) {
+    if (!isDirectory(targetDir))
+        return { ok: false, error: 'target-missing' };
+    if (canonicalProjectPath(aliasPath) === canonicalProjectPath(targetDir))
+        return { ok: false, error: 'same-folder' };
+    const identity = resolveProjectIdentity(targetDir);
+    if (existsSync(aliasPath)) {
+        const own = computeProjectIdentity(aliasPath);
+        if (own.startsWith('git:') && own !== identity)
+            return { ok: false, error: 'different-repository' };
+    }
+    addProjectAlias(aliasPath, identity);
+    invalidateHarvestedState();
+    const slug = claudeProjectSlug(canonicalProjectPath(aliasPath));
+    const folders = getDb().prepare("SELECT DISTINCT source_path FROM lessons WHERE source_cli = 'claude'").all();
+    const memoryFolders = new Set(folders.map(row => basename(dirname(dirname(row.source_path)))).filter(folder => sameClaudeSlug(folder, slug))).size;
+    return { ok: true, identity, label: basename(targetDir.replace(/[\\/]+$/, '')) || targetDir, memoryFolders };
+}
+export function removeProjectAlias(aliasPath) {
+    const removed = Number(getDb().prepare('DELETE FROM project_identity_aliases WHERE alias_path = ?').run(canonicalProjectPath(aliasPath)).changes) > 0;
+    if (removed)
+        invalidateHarvestedState();
+    return removed;
+}
+export function excludeProjectDir(projectDir) {
+    const label = basename(projectDir.replace(/[\\/]+$/, '')) || projectDir;
+    return { label, ...excludeProject(resolveProjectIdentity(projectDir), label) };
+}
+export function includeProjectDir(projectDir) {
+    const removed = includeProject(resolveProjectIdentity(projectDir));
+    // The project's files are untouched, so only forgetting their fingerprints
+    // brings its notes back.
+    if (removed)
+        invalidateHarvestedState();
+    return { label: basename(projectDir.replace(/[\\/]+$/, '')) || projectDir, removed };
+}
+/** Switch a host's harvester back on after a format change, and check it again straight away. */
+export function recheckSource(source, home) {
+    const wasDisabled = enableLessonSource(source);
+    // The file that tripped the canary has not changed; only our willingness to
+    // read it has.
+    if (wasDisabled)
+        invalidateHarvestedState();
+    const report = refreshLessons(home, { forced: true });
+    return { wasDisabled, stillDisabled: disabledLessonSourceReasons().get(source) ?? null, report };
+}
+export function lessonsStatus() {
+    const config = getConfig().lessons;
+    const db = getDb();
+    const rows = db.prepare('SELECT * FROM lessons').all();
+    const byHost = { claude: 0, codex: 0, gemini: 0 };
+    for (const row of rows)
+        byHost[row.source_cli] = (byHost[row.source_cli] ?? 0) + 1;
+    const count = (table) => db.prepare(`SELECT COUNT(*) AS n FROM ${table}`).get().n;
+    return {
+        sharing: isLessonsSharingEnabled(config),
+        needsReconsent: config.enabled && config.consent_version !== LESSONS_CONSENT_VERSION,
+        consentAt: config.consent_at,
+        notes: rows.length,
+        byHost,
+        anyProject: rows.filter(row => lessonReach(row) === 'any-project').length,
+        held: rows.filter(row => row.quarantined === 1).length,
+        disabledHosts: disabledLessonSourceReasons(),
+        excluded: excludedProjects(),
+        unresolved: unresolvedFolders().length,
+        forgotten: db.prepare('SELECT COUNT(DISTINCT forget_id) AS n FROM lesson_tombstones').get().n,
+        shadowLog: count('lesson_shadow_log'),
+    };
+}
+//# sourceMappingURL=manage.js.map

package/dist/lessons/manage.js.map

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

package/dist/lessons/mask.d.ts

@@ -0,0 +1,6 @@
+/** Remove data that must not leave the originating native-memory document. */
+export declare function maskLessonText(input: string): {
+    text: string;
+    secrets: number;
+};
+//# sourceMappingURL=mask.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mask.d.ts","sourceRoot":"","sources":["../../src/lessons/mask.ts"],"names":[],"mappings":"AAWA,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAU/E"}

package/dist/lessons/mask.js

@@ -0,0 +1,22 @@
+import { mask } from '../transcripts/mask.js';
+const EMAIL_RE = /\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/gi;
+// A home directory in every spelling a note can carry it: C:\Users\x (also
+// JSON-escaped), C:/Users/x, Git Bash /c/Users/x, /Users/x and /home/x. The
+// lookbehind keeps a URL path like example.com/home/x from matching.
+const WINDOWS_HOME_RE = /\b[A-Z]:(?:\\\\|\\|\/)Users(?:\\\\|\\|\/)[^\\\/\s"'`)]+/gi;
+const POSIX_HOME_RE = /(?<![\w.:\/~-])(?:\/[a-z](?=\/Users\/))?\/(?:Users|home)\/[^\/\s"'`)]+/gi;
+// Claude's project-folder slug of a home path: C--Users-<name>-...
+const HOME_SLUG_RE = /\b([A-Z])--Users-[^-\s/\\]+/gi;
+/** Remove data that must not leave the originating native-memory document. */
+export function maskLessonText(input) {
+    const masked = mask(input);
+    return {
+        secrets: masked.count,
+        text: masked.text
+            .replace(EMAIL_RE, '[email redacted]')
+            .replace(WINDOWS_HOME_RE, '~')
+            .replace(POSIX_HOME_RE, '~')
+            .replace(HOME_SLUG_RE, '$1--Users-[user]'),
+    };
+}
+//# sourceMappingURL=mask.js.map

package/dist/lessons/mask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.js","sourceRoot":"","sources":["../../src/lessons/mask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,MAAM,QAAQ,GAAG,6CAA6C,CAAC;AAC/D,2EAA2E;AAC3E,4EAA4E;AAC5E,qEAAqE;AACrE,MAAM,eAAe,GAAG,2DAA2D,CAAC;AACpF,MAAM,aAAa,GAAG,0EAA0E,CAAC;AACjG,mEAAmE;AACnE,MAAM,YAAY,GAAG,+BAA+B,CAAC;AAErD,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,KAAK;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;aACd,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC;aACrC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;aAC7B,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;aAC3B,OAAO,CAAC,YAAY,EAAE,kBAAkB,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/lessons/on-save.d.ts

@@ -0,0 +1,18 @@
+export type OnSaveLessons = {
+    /** Notes added, changed and removed; all zero means nothing is worth saying. */
+    added: number;
+    updated: number;
+    removed: number;
+    /** Sources left for the next save because the budget ran out. */
+    pending: number;
+    note?: string;
+};
+/**
+ * Harvest what changed since the last pass. Returns null when there is nothing
+ * to report — sharing is off, the switch is off, or no note moved — so a save
+ * that changed nothing says nothing.
+ */
+export declare function harvestOnSave(options?: {
+    home?: string;
+}): OnSaveLessons | null;
+//# sourceMappingURL=on-save.d.ts.map

package/dist/lessons/on-save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-save.d.ts","sourceRoot":"","sources":["../../src/lessons/on-save.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,aAAa,GAAG;IAC1B,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,aAAa,GAAG,IAAI,CAqBnF"}

package/dist/lessons/on-save.js

@@ -0,0 +1,53 @@
+// Save-time harvesting.
+//
+// Recording a lesson by hand is the step that never happens, so saving a
+// session re-reads each AI's own memory and records what changed. The pass is
+// consent-gated, time-boxed and idempotent: anything it does not reach waits
+// for the next save.
+//
+// It never throws. The caller wraps it too, but a harvest problem must not be
+// able to affect whether a session was saved.
+//
+// Nothing here delivers a note to any AI. Delivery is a separate, still-gated
+// step that requires its own consent version (council 534e2bd5).
+import { firstHarvestOnSave, isHarvestOnSaveEnabled } from '../memory/config.js';
+import { syncLessonSources } from './harvest.js';
+/**
+ * A quiet pass costs one stat per file and opens no transaction, so this bound
+ * is only ever reached by a genuinely cold one: a first run, an upgrade that
+ * bumped HARVESTER_VERSION, or a day's worth of edits at once. Such a pass
+ * stops here and the rest is picked up by the next save.
+ */
+const BUDGET_MS = 150;
+const FIRST_NOTE = 'Veto now re-reads your AIs\' notes when you save. See them with `veto lessons list`; stop it with `veto lessons off`.';
+/**
+ * Harvest what changed since the last pass. Returns null when there is nothing
+ * to report — sharing is off, the switch is off, or no note moved — so a save
+ * that changed nothing says nothing.
+ */
+export function harvestOnSave(options = {}) {
+    if (!isHarvestOnSaveEnabled())
+        return null;
+    let report;
+    try {
+        report = syncLessonSources({ home: options.home, budgetMs: BUDGET_MS });
+    }
+    catch {
+        return null;
+    }
+    const added = report.inserted;
+    const { updated, removed } = report;
+    // Work still queued is not news. A cold pass drains over several saves, and
+    // saying "nothing changed, 66 to go" each time is noise about our own
+    // bookkeeping. Only a note actually moving is worth a line.
+    if (added === 0 && updated === 0 && removed === 0)
+        return null;
+    // Claimed only once anything was actually harvested, so the note lands on a
+    // save the user can see the result of.
+    const first = firstHarvestOnSave();
+    return {
+        added, updated, removed, pending: report.notReached,
+        ...(first ? { note: FIRST_NOTE } : {}),
+    };
+}
+//# sourceMappingURL=on-save.js.map