@danielmarbach/mnemonic-mcp 0.1.0

package/build/migration.js

@@ -0,0 +1,372 @@
+import fs from "fs/promises";
+import path from "path";
+import matter from "gray-matter";
+import { readVaultSchemaVersion, writeVaultSchemaVersion } from "./config.js";
+export class Migrator {
+    vaultManager;
+    migrations = new Map();
+    vaultLocks = new Map();
+    constructor(vaultManager) {
+        this.vaultManager = vaultManager;
+        this.registerBuiltInMigrations();
+    }
+    registerMigration(migration) {
+        if (this.migrations.has(migration.name)) {
+            throw new Error(`Migration already registered: ${migration.name}`);
+        }
+        if (!migration.minSchemaVersion && !migration.maxSchemaVersion) {
+            console.error(`[migration] Warning: ${migration.name} has no version constraints and will run on every invocation.`);
+        }
+        this.migrations.set(migration.name, migration);
+    }
+    listAvailableMigrations() {
+        return Array.from(this.migrations.values());
+    }
+    async getPendingMigrations(currentSchemaVersion, targetSchemaVersion) {
+        const all = this.listAvailableMigrations();
+        const current = this.parseVersion(currentSchemaVersion);
+        const target = targetSchemaVersion ? this.parseVersion(targetSchemaVersion) : undefined;
+        const pending = all.filter(mig => {
+            // Primary filter: maxSchemaVersion means "this migration upgrades TO this version"
+            // Run if current < max, don't run if current >= max
+            if (mig.maxSchemaVersion) {
+                const max = this.parseVersion(mig.maxSchemaVersion);
+                if (target && this.compareVersions(max, target) > 0)
+                    return false;
+                if (this.compareVersions(current, max) >= 0)
+                    return false;
+                return true;
+            }
+            // If no max, check min: minSchemaVersion means "this migration was introduced at this version"
+            // Run if current < min (haven't reached that version yet)
+            if (mig.minSchemaVersion) {
+                const min = this.parseVersion(mig.minSchemaVersion);
+                if (target && this.compareVersions(min, target) > 0)
+                    return false;
+                if (this.compareVersions(current, min) < 0)
+                    return true;
+                return false;
+            }
+            // No version constraints, always run
+            return true;
+        });
+        // Sort by target version so migrations execute in schema-version order
+        // regardless of registration sequence. Unbounded migrations run last.
+        return pending.sort((a, b) => {
+            const aVer = a.maxSchemaVersion ?? a.minSchemaVersion;
+            const bVer = b.maxSchemaVersion ?? b.minSchemaVersion;
+            if (!aVer && !bVer)
+                return 0;
+            if (!aVer)
+                return 1;
+            if (!bVer)
+                return -1;
+            return this.compareVersions(this.parseVersion(aVer), this.parseVersion(bVer));
+        });
+    }
+    async runMigration(migrationName, options) {
+        const migration = this.migrations.get(migrationName);
+        if (!migration) {
+            throw new Error(`Unknown migration: ${migrationName}`);
+        }
+        const vaults = [];
+        if (options.cwd) {
+            const projectVault = await this.vaultManager.getProjectVaultIfExists(options.cwd);
+            if (projectVault)
+                vaults.push(projectVault);
+        }
+        else {
+            vaults.push(...this.vaultManager.allKnownVaults());
+        }
+        const results = new Map();
+        for (const vault of vaults) {
+            const result = await this.withVaultLock(vault.storage.vaultPath, async () => {
+                const migrationResult = await this.runMigrationAtomically(vault, migration, options.dryRun);
+                if (!options.dryRun && migrationResult.errors.length === 0) {
+                    const currentSchemaVersion = await readVaultSchemaVersion(vault.storage.vaultPath);
+                    const nextSchemaVersion = this.getLatestSchemaVersion(currentSchemaVersion, [migration]);
+                    const filesToCommit = new Set(migrationResult.modifiedNoteIds.map((id) => `${vault.notesRelDir}/${id}.md`));
+                    if (nextSchemaVersion !== currentSchemaVersion) {
+                        await writeVaultSchemaVersion(vault.storage.vaultPath, nextSchemaVersion);
+                        filesToCommit.add(getConfigPathForVault(vault));
+                    }
+                    if (filesToCommit.size > 0) {
+                        const commitMessage = [
+                            `migrate: ${migrationName}`,
+                            "",
+                            `- Modified: ${migrationResult.notesModified} note(s)`,
+                            `- Processed: ${migrationResult.notesProcessed} note(s)`,
+                            `- Schema: ${currentSchemaVersion} -> ${nextSchemaVersion}`,
+                        ].join("\n");
+                        try {
+                            await vault.git.commit(commitMessage, [...filesToCommit]);
+                            await vault.git.push();
+                        }
+                        catch (err) {
+                            console.error(`[migration] Failed to commit for ${vault.storage.vaultPath}: ${err}`);
+                            migrationResult.warnings.push(`Auto-commit failed: ${err instanceof Error ? err.message : String(err)}`);
+                        }
+                    }
+                }
+                return migrationResult;
+            });
+            results.set(vault.storage.vaultPath, result);
+        }
+        return { results, vaultsProcessed: vaults.length };
+    }
+    async runAllPending(options) {
+        const vaults = [];
+        if (options.cwd) {
+            const projectVault = await this.vaultManager.getProjectVaultIfExists(options.cwd);
+            if (projectVault)
+                vaults.push(projectVault);
+        }
+        else {
+            vaults.push(...this.vaultManager.allKnownVaults());
+        }
+        const migrationResults = new Map();
+        for (const vault of vaults) {
+            const vaultResults = await this.withVaultLock(vault.storage.vaultPath, async () => {
+                const vaultVersion = await readVaultSchemaVersion(vault.storage.vaultPath);
+                const pending = await this.getPendingMigrations(vaultVersion);
+                if (pending.length === 0)
+                    return null;
+                const lockedVaultResults = [];
+                const filesToCommit = new Set();
+                let hasErrors = false;
+                if (!options.dryRun) {
+                    await vault.storage.beginAtomicNotesWrite();
+                }
+                try {
+                    for (const migration of pending) {
+                        const result = await migration.run(vault, options.dryRun);
+                        lockedVaultResults.push({ migration: migration.name, result });
+                        if (!options.dryRun && result.notesModified > 0) {
+                            for (const noteId of result.modifiedNoteIds) {
+                                filesToCommit.add(`${vault.notesRelDir}/${noteId}.md`);
+                            }
+                        }
+                        if (result.errors.length > 0)
+                            hasErrors = true;
+                    }
+                    if (!options.dryRun) {
+                        if (hasErrors) {
+                            await vault.storage.rollbackAtomicNotesWrite();
+                        }
+                        else {
+                            await vault.storage.commitAtomicNotesWrite();
+                        }
+                    }
+                }
+                catch (err) {
+                    if (!options.dryRun) {
+                        await vault.storage.rollbackAtomicNotesWrite();
+                    }
+                    throw err;
+                }
+                if (!options.dryRun && pending.length > 0) {
+                    if (!hasErrors) {
+                        const nextSchemaVersion = this.getLatestSchemaVersion(vaultVersion, pending);
+                        if (nextSchemaVersion !== vaultVersion) {
+                            await writeVaultSchemaVersion(vault.storage.vaultPath, nextSchemaVersion);
+                            filesToCommit.add(getConfigPathForVault(vault));
+                        }
+                        if (filesToCommit.size > 0) {
+                            const commitMessage = [
+                                "migrate: apply pending migrations",
+                                "",
+                                `- Migrations: ${pending.map((migration) => migration.name).join(", ")}`,
+                                `- Schema: ${vaultVersion} -> ${nextSchemaVersion}`,
+                            ].join("\n");
+                            try {
+                                await vault.git.commit(commitMessage, [...filesToCommit]);
+                                await vault.git.push();
+                            }
+                            catch (err) {
+                                const message = `Auto-commit failed: ${err instanceof Error ? err.message : String(err)}`;
+                                console.error(`[migration] Failed to commit for ${vault.storage.vaultPath}: ${err}`);
+                                for (const { result } of lockedVaultResults) {
+                                    result.warnings.push(message);
+                                }
+                            }
+                        }
+                    }
+                    else if (filesToCommit.size > 0) {
+                        const warning = "Schema version not advanced because one or more migrations reported errors; staged note updates were rolled back.";
+                        for (const { result } of lockedVaultResults) {
+                            result.warnings.push(warning);
+                        }
+                        console.error(`[migration] ${vault.storage.vaultPath}: ${warning}`);
+                    }
+                }
+                return lockedVaultResults;
+            });
+            if (vaultResults) {
+                migrationResults.set(vault.storage.vaultPath, vaultResults);
+            }
+        }
+        return { migrationResults, vaultsProcessed: vaults.length };
+    }
+    registerBuiltInMigrations() {
+        this.registerMigration(createV010BackfillMemoryVersionMigration());
+        this.registerMigration(createV011BackfillLifecycleMigration());
+    }
+    parseVersion(version) {
+        if (!/^\d+(\.\d+)*$/.test(version)) {
+            throw new Error(`Invalid schema version: ${version}`);
+        }
+        return version.split(".").map(n => parseInt(n, 10));
+    }
+    compareVersions(a, b) {
+        for (let i = 0; i < Math.max(a.length, b.length); i++) {
+            const aPart = a[i] || 0;
+            const bPart = b[i] || 0;
+            if (aPart !== bPart)
+                return aPart - bPart;
+        }
+        return 0;
+    }
+    getLatestSchemaVersion(currentSchemaVersion, migrations) {
+        let latest = currentSchemaVersion;
+        for (const migration of migrations) {
+            const candidate = migration.maxSchemaVersion ?? migration.minSchemaVersion;
+            if (!candidate) {
+                continue;
+            }
+            if (this.compareVersions(this.parseVersion(candidate), this.parseVersion(latest)) > 0) {
+                latest = candidate;
+            }
+        }
+        return latest;
+    }
+    async withVaultLock(vaultPath, operation) {
+        const previous = this.vaultLocks.get(vaultPath) ?? Promise.resolve();
+        let release;
+        const gate = new Promise((resolve) => {
+            release = resolve;
+        });
+        const tail = previous.then(() => gate);
+        this.vaultLocks.set(vaultPath, tail);
+        await previous;
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+            if (this.vaultLocks.get(vaultPath) === tail) {
+                this.vaultLocks.delete(vaultPath);
+            }
+        }
+    }
+    async runMigrationAtomically(vault, migration, dryRun) {
+        if (dryRun) {
+            return migration.run(vault, true);
+        }
+        await vault.storage.beginAtomicNotesWrite();
+        try {
+            const result = await migration.run(vault, false);
+            if (result.errors.length > 0) {
+                await vault.storage.rollbackAtomicNotesWrite();
+                if (result.notesModified > 0) {
+                    result.warnings.push("Atomic migration rollback applied; note changes were not flushed to disk.");
+                }
+                return result;
+            }
+            await vault.storage.commitAtomicNotesWrite();
+            return result;
+        }
+        catch (err) {
+            await vault.storage.rollbackAtomicNotesWrite();
+            throw err;
+        }
+    }
+}
+function getConfigPathForVault(vault) {
+    return vault.notesRelDir.replace(/notes$/, "config.json");
+}
+function createV010BackfillMemoryVersionMigration() {
+    return {
+        name: "v0.1.0-backfill-memory-versions",
+        description: "Adds memoryVersion: 1 to all notes that lack a version marker",
+        minSchemaVersion: "0.0",
+        maxSchemaVersion: "1.0",
+        async run(vault, dryRun) {
+            const result = {
+                notesProcessed: 0,
+                notesModified: 0,
+                modifiedNoteIds: [],
+                errors: [],
+                warnings: [],
+            };
+            const notes = await vault.storage.listNotes();
+            result.notesProcessed = notes.length;
+            for (const note of notes) {
+                try {
+                    if (note.memoryVersion === undefined || note.memoryVersion === 0) {
+                        result.notesModified++;
+                        result.modifiedNoteIds.push(note.id);
+                        if (!dryRun) {
+                            const updatedNote = {
+                                ...note,
+                                memoryVersion: 1,
+                            };
+                            await vault.storage.writeNote(updatedNote);
+                        }
+                    }
+                }
+                catch (err) {
+                    result.errors.push({
+                        noteId: note.id,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+            return result;
+        },
+    };
+}
+function createV011BackfillLifecycleMigration() {
+    return {
+        name: "v0.1.1-backfill-note-lifecycle",
+        description: "Adds lifecycle: permanent to notes that lack a lifecycle marker",
+        minSchemaVersion: "1.0",
+        maxSchemaVersion: "1.1",
+        async run(vault, dryRun) {
+            const result = {
+                notesProcessed: 0,
+                notesModified: 0,
+                modifiedNoteIds: [],
+                errors: [],
+                warnings: [],
+            };
+            const notes = await vault.storage.listNotes();
+            result.notesProcessed = notes.length;
+            for (const note of notes) {
+                try {
+                    const notePath = path.join(vault.storage.notesDir, `${note.id}.md`);
+                    const raw = await fs.readFile(notePath, "utf-8");
+                    const parsed = matter(raw);
+                    if (parsed.data["lifecycle"] === "temporary" || parsed.data["lifecycle"] === "permanent") {
+                        continue;
+                    }
+                    result.notesModified++;
+                    result.modifiedNoteIds.push(note.id);
+                    if (!dryRun) {
+                        await vault.storage.writeNote({
+                            ...note,
+                            lifecycle: "permanent",
+                        });
+                    }
+                }
+                catch (err) {
+                    result.errors.push({
+                        noteId: note.id,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=migration.js.map

package/build/migration.js.map

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

package/build/project-introspection.d.ts

@@ -0,0 +1,5 @@
+import type { Note } from "./storage.js";
+export declare function summarizePreview(content: string, maxLength?: number): string;
+export declare function classifyTheme(note: Note): string;
+export declare function titleCaseTheme(theme: string): string;
+//# sourceMappingURL=project-introspection.d.ts.map

package/build/project-introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-introspection.d.ts","sourceRoot":"","sources":["../src/project-introspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAMzE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWhD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/build/project-introspection.js

@@ -0,0 +1,28 @@
+export function summarizePreview(content, maxLength = 120) {
+    const singleLine = content.replace(/\s+/g, " ").trim();
+    if (singleLine.length <= maxLength) {
+        return singleLine;
+    }
+    return `${singleLine.slice(0, maxLength - 3)}...`;
+}
+export function classifyTheme(note) {
+    const title = note.title.toLowerCase();
+    const tags = new Set(note.tags.map((tag) => tag.toLowerCase()));
+    if (tags.has("overview") || title.includes("overview"))
+        return "overview";
+    if (tags.has("decisions") || tags.has("design") || tags.has("policy") || tags.has("ux"))
+        return "decisions";
+    if (tags.has("tools") || tags.has("mcp") || tags.has("docker") || tags.has("deployment"))
+        return "tooling";
+    if (tags.has("bugs") || tags.has("setup"))
+        return "bugs";
+    if (tags.has("relationships") || tags.has("graph") || tags.has("architecture") || tags.has("structure"))
+        return "architecture";
+    if (tags.has("linting") || tags.has("tests") || tags.has("quality"))
+        return "quality";
+    return "other";
+}
+export function titleCaseTheme(theme) {
+    return `${theme[0]?.toUpperCase() ?? ""}${theme.slice(1)}`;
+}
+//# sourceMappingURL=project-introspection.js.map

package/build/project-introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-introspection.js","sourceRoot":"","sources":["../src/project-introspection.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,SAAS,GAAG,GAAG;IAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,UAAU,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAEhE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC1E,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC;IAC5G,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3G,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IACzD,IAAI,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,cAAc,CAAC;IAC/H,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACtF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/build/project-memory-policy.d.ts

@@ -0,0 +1,17 @@
+export type WriteScope = "project" | "global";
+export declare const WRITE_SCOPES: readonly ["project", "global"];
+export type ProjectPolicyScope = WriteScope | "ask";
+export declare const PROJECT_POLICY_SCOPES: readonly ["project", "global", "ask"];
+export type ConsolidationMode = "supersedes" | "delete";
+export declare const CONSOLIDATION_MODES: readonly ["supersedes", "delete"];
+export interface ProjectMemoryPolicy {
+    projectId: string;
+    projectName?: string;
+    defaultScope: ProjectPolicyScope;
+    /** Default consolidation mode for this project. "supersedes" preserves history, "delete" removes sources. */
+    consolidationMode?: ConsolidationMode;
+    updatedAt: string;
+}
+export declare function resolveConsolidationMode(policy: ProjectMemoryPolicy | undefined): ConsolidationMode;
+export declare function resolveWriteScope(explicitScope: WriteScope | undefined, projectPolicyScope: ProjectPolicyScope | undefined, hasProjectContext: boolean): WriteScope | "ask";
+//# sourceMappingURL=project-memory-policy.d.ts.map

package/build/project-memory-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory-policy.d.ts","sourceRoot":"","sources":["../src/project-memory-policy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC9C,eAAO,MAAM,YAAY,gCAAiE,CAAC;AAC3F,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,KAAK,CAAC;AACpD,eAAO,MAAM,qBAAqB,uCAAgF,CAAC;AAEnH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,QAAQ,CAAC;AACxD,eAAO,MAAM,mBAAmB,mCAA2E,CAAC;AAE5G,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,kBAAkB,CAAC;IACjC,6GAA6G;IAC7G,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,GAAG,iBAAiB,CAEnG;AAED,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,UAAU,GAAG,SAAS,EACrC,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,EAClD,iBAAiB,EAAE,OAAO,GACzB,UAAU,GAAG,KAAK,CAUpB"}

package/build/project-memory-policy.js

@@ -0,0 +1,16 @@
+export const WRITE_SCOPES = ["project", "global"];
+export const PROJECT_POLICY_SCOPES = ["project", "global", "ask"];
+export const CONSOLIDATION_MODES = ["supersedes", "delete"];
+export function resolveConsolidationMode(policy) {
+    return policy?.consolidationMode ?? "supersedes";
+}
+export function resolveWriteScope(explicitScope, projectPolicyScope, hasProjectContext) {
+    if (explicitScope) {
+        return explicitScope;
+    }
+    if (projectPolicyScope) {
+        return projectPolicyScope;
+    }
+    return hasProjectContext ? "project" : "global";
+}
+//# sourceMappingURL=project-memory-policy.js.map

package/build/project-memory-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory-policy.js","sourceRoot":"","sources":["../src/project-memory-policy.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,QAAQ,CAA0C,CAAC;AAE3F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAkD,CAAC;AAGnH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAiD,CAAC;AAW5G,MAAM,UAAU,wBAAwB,CAAC,MAAuC;IAC9E,OAAO,MAAM,EAAE,iBAAiB,IAAI,YAAY,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,aAAqC,EACrC,kBAAkD,EAClD,iBAA0B;IAE1B,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,OAAO,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC"}

package/build/project.d.ts

@@ -0,0 +1,32 @@
+export type ProjectSource = "git-remote" | "git-remote-override" | "git-folder" | "folder";
+export interface ProjectInfo {
+    /** Stable identifier: normalized git remote URL or folder name */
+    id: string;
+    /** Human-readable name (last path segment of remote, or folder name) */
+    name: string;
+    /** How the project was detected */
+    source: ProjectSource;
+    /** Which remote produced this identity when remote-based detection is used. */
+    remoteName?: string;
+}
+export interface ProjectIdentityOverride {
+    remoteName: string;
+    updatedAt: string;
+}
+export interface ProjectDetectionOptions {
+    getProjectIdentityOverride?: (projectId: string) => Promise<ProjectIdentityOverride | undefined>;
+}
+export interface ProjectIdentityResolution {
+    project: ProjectInfo;
+    defaultProject: ProjectInfo;
+    identityOverride?: ProjectIdentityOverride;
+    identityOverrideApplied: boolean;
+}
+/**
+ * Resolve a working directory path to a stable project identifier.
+ * Uses the git remote URL when available so the same project is recognized
+ * across machines regardless of local clone path.
+ */
+export declare function detectProject(cwd: string, options?: ProjectDetectionOptions): Promise<ProjectInfo | null>;
+export declare function resolveProjectIdentity(cwd: string, options?: ProjectDetectionOptions): Promise<ProjectIdentityResolution | null>;
+//# sourceMappingURL=project.d.ts.map

package/build/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,qBAAqB,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE3F,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,aAAa,CAAC;IACtB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,0BAA0B,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;CAClG;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc,EAAE,WAAW,CAAC;IAC5B,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAGnH;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CA4C3C"}

package/build/project.js

@@ -0,0 +1,125 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import path from "path";
+const execFileAsync = promisify(execFile);
+/**
+ * Resolve a working directory path to a stable project identifier.
+ * Uses the git remote URL when available so the same project is recognized
+ * across machines regardless of local clone path.
+ */
+export async function detectProject(cwd, options = {}) {
+    const resolved = await resolveProjectIdentity(cwd, options);
+    return resolved?.project ?? null;
+}
+export async function resolveProjectIdentity(cwd, options = {}) {
+    if (!cwd)
+        return null;
+    const defaultProject = await detectDefaultProject(cwd);
+    if (!defaultProject)
+        return null;
+    if (defaultProject.source !== "git-remote") {
+        return {
+            project: defaultProject,
+            defaultProject,
+            identityOverrideApplied: false,
+        };
+    }
+    const identityOverride = await options.getProjectIdentityOverride?.(defaultProject.id);
+    if (!identityOverride) {
+        return {
+            project: defaultProject,
+            defaultProject,
+            identityOverrideApplied: false,
+        };
+    }
+    const overrideRemote = await getGitRemoteUrl(cwd, identityOverride.remoteName);
+    if (!overrideRemote) {
+        return {
+            project: defaultProject,
+            defaultProject,
+            identityOverride,
+            identityOverrideApplied: false,
+        };
+    }
+    return {
+        project: {
+            id: normalizeRemote(overrideRemote),
+            name: extractRepoName(overrideRemote),
+            source: "git-remote-override",
+            remoteName: identityOverride.remoteName,
+        },
+        defaultProject,
+        identityOverride,
+        identityOverrideApplied: true,
+    };
+}
+async function detectDefaultProject(cwd) {
+    if (!cwd)
+        return null;
+    // Try git remote first
+    const remote = await getGitRemoteUrl(cwd, "origin");
+    if (remote) {
+        const id = normalizeRemote(remote);
+        const name = extractRepoName(remote);
+        return { id, name, source: "git-remote", remoteName: "origin" };
+    }
+    // Try git root folder name (repo without remote)
+    try {
+        const { stdout: rootOut } = await execFileAsync("git", ["rev-parse", "--show-toplevel"], { cwd });
+        const root = rootOut.trim();
+        if (root) {
+            const name = path.basename(root);
+            return { id: slugify(name), name, source: "git-folder" };
+        }
+    }
+    catch {
+        // not a git repo at all — fall through
+    }
+    // Fallback: just use the directory name
+    const name = path.basename(path.resolve(cwd));
+    if (name) {
+        return { id: slugify(name), name, source: "folder" };
+    }
+    return null;
+}
+async function getGitRemoteUrl(cwd, remoteName) {
+    try {
+        const { stdout: remoteOut } = await execFileAsync("git", ["remote", "get-url", remoteName], { cwd });
+        const remote = remoteOut.trim();
+        return remote || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Normalize a git remote URL to a stable lowercase identifier.
+ * Strips protocol, auth, .git suffix, and converts separators to dashes.
+ *
+ * Examples:
+ *   git@github.com:acme/myapp.git  → github-com-acme-myapp
+ *   https://github.com/acme/myapp  → github-com-acme-myapp
+ */
+function normalizeRemote(remote) {
+    let s = remote.trim().toLowerCase();
+    // SSH: git@github.com:user/repo.git
+    s = s.replace(/^git@/, "").replace(/:/, "/");
+    // Strip protocol
+    s = s.replace(/^https?:\/\//, "").replace(/^ssh:\/\//, "");
+    // Strip auth (user:pass@)
+    s = s.replace(/^[^@]*@/, "");
+    // Strip .git
+    s = s.replace(/\.git$/, "");
+    // Normalise separators
+    s = s.replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+    return s;
+}
+function extractRepoName(remote) {
+    // Get the last path segment before .git
+    const match = remote.match(/\/([^/]+?)(\.git)?$/);
+    return match?.[1] ?? path.basename(remote);
+}
+function slugify(s) {
+    return s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+//# sourceMappingURL=project.js.map

package/build/project.js.map

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