@jigyasudham/veto 3.3.0 → 3.5.0

package/dist/lessons/discover.js

@@ -0,0 +1,65 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join } from 'node:path';
+function candidate(source, sourcePath, root, extra = {}) {
+    try {
+        const stat = statSync(sourcePath);
+        return stat.isFile() ? { source, sourcePath, fileName: basename(sourcePath), mtimeMs: stat.mtimeMs, global: false, root, ...extra } : null;
+    }
+    catch {
+        return null;
+    }
+}
+function claudeMemoryFiles(claudeHome) {
+    const projects = join(claudeHome, 'projects');
+    if (!existsSync(projects))
+        return [];
+    const out = [];
+    let folders;
+    try {
+        folders = readdirSync(projects, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const folder of folders) {
+        if (!folder.isDirectory())
+            continue;
+        const claudeFolder = join(projects, folder.name);
+        const memory = join(claudeFolder, 'memory');
+        let files;
+        try {
+            files = readdirSync(memory, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            if (!file.isFile() || !file.name.toLowerCase().endsWith('.md'))
+                continue;
+            const found = candidate('claude', join(memory, file.name), claudeHome, { claudeFolder, claudeSlug: folder.name });
+            if (found)
+                out.push(found);
+        }
+    }
+    return out;
+}
+/**
+ * Known native-memory locations only; discovery reads directory listings and
+ * file metadata and performs no writes. CODEX_HOME relocates ~/.codex, as it
+ * does for Codex itself.
+ */
+export function discoverNativeMemorySources(home = homedir()) {
+    const codexHome = home === homedir() && process.env.CODEX_HOME ? process.env.CODEX_HOME : join(home, '.codex');
+    const out = claudeMemoryFiles(join(home, '.claude'));
+    for (const path of [join(codexHome, 'AGENTS.md'), join(codexHome, 'AGENTS.override.md')]) {
+        const found = candidate('codex', path, codexHome, { global: true });
+        if (found)
+            out.push(found);
+    }
+    const gemini = candidate('gemini', join(home, '.gemini', 'GEMINI.md'), join(home, '.gemini'), { global: true });
+    if (gemini)
+        out.push(gemini);
+    return out.sort((a, b) => b.mtimeMs - a.mtimeMs);
+}
+//# sourceMappingURL=discover.js.map

package/dist/lessons/discover.js.map

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

package/dist/lessons/harvest.d.ts

@@ -0,0 +1,84 @@
+import { type LessonSource } from './adapters/index.js';
+/**
+ * Bump when anything that decides what a file yields changes: this harvester,
+ * the adapters, mask.ts or classify.ts. Every remembered file fingerprint is
+ * invalidated, so the next pass re-reads and re-classifies everything.
+ * `tests/lessons-harvester-version.test.ts` fails if those files change
+ * without this being bumped, so the reminder is not a comment alone.
+ */
+export declare const HARVESTER_VERSION = 1;
+export type HarvestOutcome = {
+    status: 'harvested';
+    inserted: number;
+    updated: number;
+    removed: number;
+} | {
+    status: 'unchanged';
+} | {
+    status: 'skipped';
+    reason: 'empty' | 'index' | 'veto-authored';
+    removed: number;
+} | {
+    status: 'disabled' | 'unavailable';
+    reason: string;
+};
+/**
+ * Read and harvest a single host-native memory file. The source is only ever
+ * opened for reading. An unrecognised shape disables that host's harvester
+ * (the format-drift canary) and leaves its existing rows untouched; selection
+ * stops serving them while the host is disabled.
+ */
+export declare function harvestNativeMemory(input: {
+    source: LessonSource;
+    sourcePath: string;
+    projectIdentity: string;
+    projectLabel?: string | null;
+    /** The project's own names; a note naming its project stays project scope. */
+    projectNames?: string[];
+    global?: boolean;
+    /** The host directory this file was found under; it may not resolve outside it. */
+    root?: string;
+    /** Ignore what this file looked like last time and read it again regardless. */
+    forced?: boolean;
+}): HarvestOutcome;
+export type LessonSyncReport = {
+    consent: boolean;
+    sources: number;
+    harvested: number;
+    /** Files whose bytes and project are what they were last time; nothing was parsed. */
+    unchanged: number;
+    skipped: number;
+    disabled: number;
+    unavailable: number;
+    /** Sources belonging to a project kept out of sharing; nothing of theirs is stored. */
+    excluded: number;
+    inserted: number;
+    updated: number;
+    removed: number;
+    unresolvedProjects: number;
+    /** Files the pass never reached because it ran out of its time budget. */
+    notReached: number;
+    elapsedMs: number;
+};
+export type SyncOptions = {
+    home?: string;
+    /** Re-read every file even if it looks untouched. Policy changes need this. */
+    forced?: boolean;
+    /**
+     * Stop once this many milliseconds have gone, checked before every file.
+     * What is left waits for the next pass; the work is idempotent, so nothing
+     * is lost by stopping. Only the save path sets it.
+     */
+    budgetMs?: number;
+};
+/**
+ * One pass: discover every known native-memory file, harvest what changed
+ * under its project's identity, and delete rows whose file has gone. Nothing
+ * is read until the user has accepted consent v2, and an excluded project's
+ * files are never read at all.
+ *
+ * A pass given a budget stops cleanly when it runs out and reports what it did
+ * not reach. Every step is idempotent, so the next pass simply carries on.
+ */
+export declare function syncLessonSources(options?: string | SyncOptions): LessonSyncReport;
+//# sourceMappingURL=harvest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harvest.d.ts","sourceRoot":"","sources":["../../src/lessons/harvest.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAY3E;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAgBnC,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnF;IAAE,MAAM,EAAE,UAAU,GAAG,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAsC3D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,cAAc,CA4EjB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAyCF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAAM,GAAG,WAAgB,GAAG,gBAAgB,CAsDtF"}

package/dist/lessons/harvest.js

@@ -0,0 +1,271 @@
+import { createHash } from 'node:crypto';
+import { readFileSync, realpathSync, statSync } from 'node:fs';
+import { basename, dirname, relative, isAbsolute } from 'node:path';
+import { isLessonsSharingEnabled } from '../memory/config.js';
+import { parseNativeMemory } from './adapters/index.js';
+import { classifyLesson } from './classify.js';
+import { discoverNativeMemorySources } from './discover.js';
+import { projectNames, resolveProjectIdentity } from './identity.js';
+import { maskLessonText } from './mask.js';
+import { resolveClaudeProjectFolder } from './source-project.js';
+import { deleteLessonSource, disableLessonSource, isLessonSourceEnabled, isProjectExcluded, lessonFileState, purgeVanishedLessonFileState, purgeVanishedLessonSources, recordLessonFileState, recordLessonFileUnavailable, syncLessons, unresolvedProjectCount, } from './store.js';
+/**
+ * Bump when anything that decides what a file yields changes: this harvester,
+ * the adapters, mask.ts or classify.ts. Every remembered file fingerprint is
+ * invalidated, so the next pass re-reads and re-classifies everything.
+ * `tests/lessons-harvester-version.test.ts` fails if those files change
+ * without this being bumped, so the reminder is not a comment alone.
+ */
+export const HARVESTER_VERSION = 1;
+/**
+ * A memory file is a hand-written note; anything this large is not one. The
+ * cap stops an unbounded read on the save path (council 534e2bd5, security).
+ */
+const MAX_SOURCE_BYTES = 2 * 1024 * 1024;
+/**
+ * After this many passes in a row where a file could not be read, a save stops
+ * probing it. Reading it is what costs seconds when the drive holding it is no
+ * longer plugged in, and a save must not wait for that. A command still tries
+ * every time, so plugging the drive back in and running `veto lessons` works.
+ */
+const UNAVAILABLE_BACKOFF_AFTER = 3;
+/**
+ * A memory file is followed only while it resolves inside the host directory
+ * it was discovered under: a link dropped into a memory folder must not turn
+ * the harvester into a reader of arbitrary files elsewhere on the machine.
+ *
+ * The boundary is that host directory and NOT the user's home, because neither
+ * is reliably inside the other — CODEX_HOME and a relocated Claude directory
+ * both live wherever the user puts them, and a home-based rule would refuse
+ * every note those users have.
+ *
+ * The whole path is resolved rather than just its last part, so a symlinked
+ * folder above the file is caught as well.
+ */
+function resolvesOutsideRoot(sourcePath, root) {
+    try {
+        const rel = relative(realpathSync(root), realpathSync(sourcePath));
+        return rel.startsWith('..') || isAbsolute(rel);
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Everything that decides what this file yields: its bytes, and the project
+ * identity and names that classification reads. Identity is part of it because
+ * an alias can move a file to another project without touching its contents —
+ * skipping on content alone would silently ignore `veto lessons alias`.
+ */
+function fingerprint(raw, input) {
+    return createHash('sha256')
+        .update(raw).update('\u0000')
+        .update(input.projectIdentity).update('\u0000')
+        .update(input.projectLabel ?? '').update('\u0000')
+        .update((input.projectNames ?? []).join('\u0000')).update('\u0000')
+        .update(input.global === true ? '1' : '0')
+        .digest('hex');
+}
+/**
+ * Read and harvest a single host-native memory file. The source is only ever
+ * opened for reading. An unrecognised shape disables that host's harvester
+ * (the format-drift canary) and leaves its existing rows untouched; selection
+ * stops serving them while the host is disabled.
+ */
+export function harvestNativeMemory(input) {
+    if (!isLessonSourceEnabled(input.source))
+        return { status: 'disabled', reason: 'source disabled after format drift' };
+    // Defaults to the file's own folder when a caller names no root, which is
+    // the strictest sensible reading of "where this file is allowed to live".
+    if (resolvesOutsideRoot(input.sourcePath, input.root ?? dirname(input.sourcePath))) {
+        return { status: 'unavailable', reason: "memory file resolves outside its host's own folder and was not read" };
+    }
+    // Stat first: an unchanged file costs this and nothing more. No transaction
+    // is opened on this path, so a quiet pass takes no write lock at all.
+    let size;
+    let mtime;
+    try {
+        const stat = statSync(input.sourcePath);
+        size = stat.size;
+        mtime = stat.mtime.toISOString();
+    }
+    catch {
+        recordLessonFileUnavailable(input.source, input.sourcePath);
+        return { status: 'unavailable', reason: 'native memory file could not be read' };
+    }
+    if (size > MAX_SOURCE_BYTES) {
+        // Left alone rather than emptied: this is a file we declined to read, not
+        // a file we read and found nothing in.
+        return { status: 'unavailable', reason: `memory file is larger than ${MAX_SOURCE_BYTES / (1024 * 1024)} MB and was not read` };
+    }
+    const known = input.forced ? null : lessonFileState(input.source, input.sourcePath);
+    // Identity is part of the comparison because an alias, or a drive coming
+    // back, moves a file to another project without touching a byte of it. It
+    // costs nothing here: the caller has already worked out which project this
+    // file belongs to.
+    const current = known?.harvester_version === HARVESTER_VERSION && known?.project_identity === input.projectIdentity;
+    if (current && known?.mtime === mtime && known?.size === size)
+        return { status: 'unchanged' };
+    let raw;
+    try {
+        raw = readFileSync(input.sourcePath, 'utf8');
+    }
+    catch {
+        recordLessonFileUnavailable(input.source, input.sourcePath);
+        return { status: 'unavailable', reason: 'native memory file could not be read' };
+    }
+    // mtime moved but the content did not — a touch, a sync tool, a restore.
+    // Remember the new mtime so the cheap path hits next time, and parse nothing.
+    const digest = fingerprint(raw, input);
+    const remember = () => recordLessonFileState({
+        source: input.source, sourcePath: input.sourcePath, mtime, size, contentHash: digest,
+        projectIdentity: input.projectIdentity, harvesterVersion: HARVESTER_VERSION,
+    });
+    if (current && known?.content_hash === digest) {
+        remember();
+        return { status: 'unchanged' };
+    }
+    const fileName = basename(input.sourcePath);
+    const parsed = parseNativeMemory(input.source, raw, fileName);
+    if (!parsed.ok) {
+        disableLessonSource(input.source, `${fileName}: ${parsed.reason}`);
+        return { status: 'disabled', reason: parsed.reason };
+    }
+    const base = { sourceCli: input.source, sourcePath: input.sourcePath, projectIdentity: input.projectIdentity, projectLabel: input.projectLabel ?? null, sourceMtime: mtime };
+    if ('skip' in parsed) {
+        const removed = syncLessons({ ...base, sections: [] }).removed;
+        remember();
+        return { status: 'skipped', reason: parsed.skip, removed };
+    }
+    const sections = parsed.sections.map(section => {
+        const masked = maskLessonText(section.text);
+        const classified = classifyLesson({
+            source: input.source, fileName, global: input.global === true, frontmatter: parsed.frontmatter,
+            section, maskedText: masked.text, secrets: masked.secrets, projectNames: input.projectNames,
+        });
+        return { anchor: section.anchor, textMasked: masked.text, ...classified };
+    });
+    const synced = syncLessons({ ...base, sections });
+    remember();
+    return { status: 'harvested', ...synced };
+}
+function sourceProject(source, folders) {
+    if (source.global || !source.claudeFolder || !source.claudeSlug)
+        return { identity: `global:${source.source}`, label: null, names: [] };
+    const cached = folders.get(source.claudeFolder);
+    if (cached)
+        return cached;
+    const { projectDir } = resolveClaudeProjectFolder(source.claudeFolder, source.claudeSlug);
+    const resolved = projectDir
+        ? { identity: resolveProjectIdentity(projectDir), label: basename(projectDir.replace(/[\\/]+$/, '')) || projectDir, names: projectNames(projectDir) }
+        : { identity: `claude-slug:${source.claudeSlug}`, label: source.claudeSlug, names: [] };
+    folders.set(source.claudeFolder, resolved);
+    return resolved;
+}
+/**
+ * Whether a file can be passed over without reading it or resolving which
+ * project it belongs to. Deliberately cheap: one stat and one indexed read.
+ * Project resolution is the expensive part of a pass — it can walk a drive
+ * root — so a quiet pass must never get that far.
+ */
+function untouchedSince(source, recheckUnresolved) {
+    const known = lessonFileState(source.source, source.sourcePath);
+    if (!known)
+        return false;
+    // A file that has failed to be read this many times running is treated as
+    // gone until a command looks for it again; even the stat is skipped, because
+    // the stat is the part that hangs.
+    if (!recheckUnresolved && known.unavailable_streak >= UNAVAILABLE_BACKOFF_AFTER)
+        return 'gone';
+    if (known.harvester_version !== HARVESTER_VERSION)
+        return false;
+    // A folder never traced to a directory on this machine may become traceable
+    // when a drive is plugged back in, and only resolving it again would notice.
+    // A pass with time to spare looks; a save does not, because that lookup is
+    // the one that walks a drive root.
+    if (recheckUnresolved && known.project_identity?.startsWith('claude-slug:'))
+        return false;
+    try {
+        const stat = statSync(source.sourcePath);
+        return known.mtime === stat.mtime.toISOString() && known.size === stat.size;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * One pass: discover every known native-memory file, harvest what changed
+ * under its project's identity, and delete rows whose file has gone. Nothing
+ * is read until the user has accepted consent v2, and an excluded project's
+ * files are never read at all.
+ *
+ * A pass given a budget stops cleanly when it runs out and reports what it did
+ * not reach. Every step is idempotent, so the next pass simply carries on.
+ */
+export function syncLessonSources(options = {}) {
+    const opts = typeof options === 'string' ? { home: options } : options;
+    const started = Date.now();
+    const report = {
+        consent: isLessonsSharingEnabled(), sources: 0, harvested: 0, unchanged: 0, skipped: 0, disabled: 0, unavailable: 0, excluded: 0,
+        inserted: 0, updated: 0, removed: 0, unresolvedProjects: 0, notReached: 0, elapsedMs: 0,
+    };
+    if (!report.consent)
+        return report;
+    const sources = discoverNativeMemorySources(opts.home);
+    report.sources = sources.length;
+    const folders = new Map();
+    // Only a pass that is not racing a save can afford to look for folders that
+    // were unresolved last time.
+    const recheckUnresolved = opts.budgetMs === undefined;
+    let index = 0;
+    for (const source of sources) {
+        // Checked before every file, not once at the start: a single slow stat on
+        // a drive that is no longer plugged in must not carry the whole pass past
+        // its bound (council 534e2bd5, devil).
+        if (opts.budgetMs !== undefined && Date.now() - started >= opts.budgetMs) {
+            report.notReached = sources.length - index;
+            break;
+        }
+        index++;
+        if (!opts.forced) {
+            const state = untouchedSince(source, recheckUnresolved);
+            if (state === 'gone') {
+                report.unavailable++;
+                continue;
+            }
+            if (state) {
+                report.unchanged++;
+                continue;
+            }
+        }
+        const project = sourceProject(source, folders);
+        if (isProjectExcluded(project.identity)) {
+            // Not even read: an excluded project's notes never reach the store.
+            report.excluded++;
+            report.removed += deleteLessonSource(source.source, source.sourcePath);
+            continue;
+        }
+        const outcome = harvestNativeMemory({
+            source: source.source, sourcePath: source.sourcePath, projectIdentity: project.identity,
+            projectLabel: project.label, projectNames: project.names, global: source.global, root: source.root, forced: opts.forced,
+        });
+        report[outcome.status]++;
+        if (outcome.status === 'harvested') {
+            report.inserted += outcome.inserted;
+            report.updated += outcome.updated;
+            report.removed += outcome.removed;
+        }
+        if (outcome.status === 'skipped')
+            report.removed += outcome.removed;
+    }
+    report.unresolvedProjects = unresolvedProjectCount();
+    // A pass cut short has not seen every source, so it cannot conclude that a
+    // missing one is gone for good.
+    if (report.notReached === 0) {
+        report.removed += purgeVanishedLessonSources(sources);
+        purgeVanishedLessonFileState(sources);
+    }
+    report.elapsedMs = Date.now() - started;
+    return report;
+}
+//# sourceMappingURL=harvest.js.map

package/dist/lessons/harvest.js.map

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

package/dist/lessons/identity.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The alias key for a checkout: absolute, no trailing separator, and on
+ * Windows case-folded (D:\Veto and d:\veto are one folder there).
+ */
+export declare function canonicalProjectPath(projectDir: string): string;
+/** `git@host:o/r.git`, `https://user:tok@host/o/r` and `ssh://git@host/o/r` are one remote. */
+export declare function normalizeRemote(url: string): string;
+/**
+ * A repository is identified by its origin remote and its ROOT commit(s),
+ * never by where it is checked out, so the D:, F: and G: copies of one repo
+ * share an identity. HEAD would not do: it moves with every commit. A folder
+ * without git history falls back to its own path.
+ */
+export declare function computeProjectIdentity(projectDir: string): string;
+export declare function resolveProjectIdentity(projectDir: string): string;
+/**
+ * What a project is called: its folder name and its origin repository's name.
+ * A note naming its own project is about that project (see classify.ts).
+ */
+export declare function projectNames(projectDir: string): string[];
+/** Explicitly unify an additional checked-out path with an existing identity. */
+export declare function addProjectAlias(aliasPath: string, projectIdentity: string): void;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/lessons/identity.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQjE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAWjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAQzD;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAIhF"}

package/dist/lessons/identity.js

@@ -0,0 +1,81 @@
+import { createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import { basename, resolve } from 'node:path';
+import { getDb, normalizeProjectDir } from '../memory/local.js';
+function git(projectDir, args) {
+    try {
+        return execFileSync('git', args, { cwd: projectDir, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true }).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The alias key for a checkout: absolute, no trailing separator, and on
+ * Windows case-folded (D:\Veto and d:\veto are one folder there).
+ */
+export function canonicalProjectPath(projectDir) {
+    let path = resolve(projectDir);
+    if (!/^[A-Za-z]:\\$|^\/$/.test(path))
+        path = path.replace(/[\\/]+$/, '');
+    path = normalizeProjectDir(path);
+    return process.platform === 'win32' ? path.toLowerCase() : path;
+}
+/** `git@host:o/r.git`, `https://user:tok@host/o/r` and `ssh://git@host/o/r` are one remote. */
+export function normalizeRemote(url) {
+    let u = url.trim().replace(/\/+$/, '').replace(/\.git$/i, '');
+    const scp = /^[\w.-]+@([^:/]+):(?!\/)(.+)$/.exec(u);
+    u = scp ? `${scp[1]}/${scp[2]}` : u.replace(/^[a-z][a-z0-9+.-]*:\/\//i, '').replace(/^[^@/]+@/, '');
+    return u.toLowerCase();
+}
+/**
+ * A repository is identified by its origin remote and its ROOT commit(s),
+ * never by where it is checked out, so the D:, F: and G: copies of one repo
+ * share an identity. HEAD would not do: it moves with every commit. A folder
+ * without git history falls back to its own path.
+ */
+export function computeProjectIdentity(projectDir) {
+    const roots = git(projectDir, ['rev-list', '--max-parents=0', 'HEAD']);
+    if (roots) {
+        const remote = git(projectDir, ['config', '--get', 'remote.origin.url']);
+        const key = [remote ? normalizeRemote(remote) : '', ...roots.split(/\s+/).sort()].join('\n');
+        return `git:${createHash('sha256').update(key).digest('hex').slice(0, 16)}`;
+    }
+    return `path:${canonicalProjectPath(projectDir)}`;
+}
+export function resolveProjectIdentity(projectDir) {
+    const alias = canonicalProjectPath(projectDir);
+    const db = getDb();
+    const known = db.prepare('SELECT project_identity FROM project_identity_aliases WHERE alias_path = ?').get(alias);
+    // A git identity, or an alias set by hand, is final. Only this folder's own
+    // path fallback is re-checked, so a folder that later gains git history
+    // joins its other checkouts.
+    if (known && known.project_identity !== `path:${alias}`)
+        return known.project_identity;
+    const identity = computeProjectIdentity(projectDir);
+    if (known?.project_identity !== identity)
+        addProjectAlias(projectDir, identity);
+    return identity;
+}
+/**
+ * What a project is called: its folder name and its origin repository's name.
+ * A note naming its own project is about that project (see classify.ts).
+ */
+export function projectNames(projectDir) {
+    const names = new Set();
+    const folder = basename(projectDir.replace(/[\\/]+$/, ''));
+    if (folder)
+        names.add(folder);
+    const remote = git(projectDir, ['config', '--get', 'remote.origin.url']);
+    const repoName = remote ? normalizeRemote(remote).split('/').pop() : null;
+    if (repoName)
+        names.add(repoName);
+    return [...names].filter(name => name.length >= 3);
+}
+/** Explicitly unify an additional checked-out path with an existing identity. */
+export function addProjectAlias(aliasPath, projectIdentity) {
+    getDb().prepare(`INSERT INTO project_identity_aliases (alias_path, project_identity, updated_at) VALUES (?, ?, ?)
+    ON CONFLICT(alias_path) DO UPDATE SET project_identity = excluded.project_identity, updated_at = excluded.updated_at`)
+        .run(canonicalProjectPath(aliasPath), projectIdentity, new Date().toISOString());
+}
+//# sourceMappingURL=identity.js.map

package/dist/lessons/identity.js.map

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