ghostrail 0.13.0 → 0.15.0

package/dist/factory/state.d.ts

@@ -0,0 +1,85 @@
+import type { GhostrailConfig } from "../config/schema.js";
+import type { GlobalEnv } from "../global/store.js";
+/** The store directory a pre-TJ-1585 ghostrail kept inside its checkout. */
+export declare const LEGACY_STORE_DIR = ".factory";
+/**
+ * The identity of the repo a checkout belongs to.
+ *
+ * `[factory].source` wins when set, matching `resolveRepoSlug`: a factory that
+ * clones from a URL is that repo's factory wherever the command was typed. The
+ * checkout's `origin` is the fallback, and a repo with neither is keyed on its
+ * path, marked so it is visibly path-keyed.
+ */
+export declare function repoIdFor(repoPath: string, config?: GhostrailConfig): Promise<string>;
+/**
+ * Where this checkout's ghostrail keeps its state, and the legacy directory it
+ * used to keep it in.
+ *
+ * Both, because every caller that needs the new path also needs to know whether
+ * there is something at the old one to carry over.
+ */
+export declare function stateDirFor(repoPath: string, config?: GhostrailConfig, env?: GlobalEnv, home?: string): Promise<{
+    dir: string;
+    legacy: string;
+    repoId: string;
+}>;
+/** What {@link migrateLegacyStore} did, so the caller can report it honestly. */
+export type MigrationOutcome = {
+    kind: "nothing-to-do";
+} | {
+    kind: "migrated";
+    from: string;
+    to: string;
+} | {
+    kind: "already-populated";
+    from: string;
+    to: string;
+} | {
+    kind: "failed";
+    from: string;
+    to: string;
+    error: string;
+};
+/**
+ * Carry a checkout's `.factory` over to the repo's state directory.
+ *
+ * Copies rather than moves, and never deletes the original. A move that half
+ * succeeds loses a run history that exists nowhere else, and the cost of
+ * leaving a stale directory behind is one line of output telling the operator
+ * they can remove it. They can see it; the tool cannot see what it destroyed.
+ *
+ * Skipped when the destination already holds anything. That is what makes this
+ * idempotent, and it is also the answer to two checkouts of one repo each
+ * having their own `.factory`: the first is carried over and the second is
+ * reported rather than silently merged into or clobbering it. Merging two event
+ * logs is possible, but choosing which history is the real one is not a
+ * decision to make on someone's behalf.
+ */
+export declare function migrateLegacyStore(legacy: string, dir: string): Promise<MigrationOutcome>;
+/** One line describing an outcome, or undefined when there is nothing to say. */
+export declare function describeMigration(outcome: MigrationOutcome): string | undefined;
+/**
+ * The clone URL for this repo: `[factory].source` when set, else the checkout's
+ * own origin. Undefined for a repo with no remote, which cannot be cloned and
+ * must keep using the checkout it lives in.
+ */
+export declare function cloneSourceFor(repoPath: string, config?: GhostrailConfig): Promise<string | undefined>;
+/**
+ * Where worktrees should be made from: ghostrail's own clone when it can have
+ * one, else the operator's checkout.
+ *
+ * Falls back rather than failing, in every case. A repo with no remote has
+ * nothing to clone; a clone that cannot be made or fetched leaves the old
+ * borrow-your-checkout behavior in place. Neither is worth refusing to run
+ * over, and both are worth saying out loud.
+ */
+export declare function resolveWorkRepo(options: {
+    repoPath: string;
+    stateDir: string;
+    config: GhostrailConfig;
+    env?: NodeJS.ProcessEnv;
+}): Promise<{
+    path?: string;
+    note?: string;
+}>;
+//# sourceMappingURL=state.d.ts.map

package/dist/factory/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/factory/state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAS3F;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,eAAe,EACxB,GAAG,GAAE,SAAuB,EAC5B,IAAI,GAAE,MAAkB,GACvB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAO1D;AAED,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAYhE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoB/F;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAW/E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwB5C"}

package/dist/factory/state.js

@@ -0,0 +1,157 @@
+import { cp, readdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import process from "node:process";
+import { spawnCollect } from "../backend/proc.js";
+import { canonicalRepoId, localRepoId } from "../global/repo-id.js";
+import { repoStateDir } from "../global/state-dir.js";
+import { ensureManagedCheckout } from "./checkout.js";
+/** The store directory a pre-TJ-1585 ghostrail kept inside its checkout. */
+export const LEGACY_STORE_DIR = ".factory";
+/**
+ * The identity of the repo a checkout belongs to.
+ *
+ * `[factory].source` wins when set, matching `resolveRepoSlug`: a factory that
+ * clones from a URL is that repo's factory wherever the command was typed. The
+ * checkout's `origin` is the fallback, and a repo with neither is keyed on its
+ * path, marked so it is visibly path-keyed.
+ */
+export async function repoIdFor(repoPath, config) {
+    const source = config?.factory.source;
+    if (source !== undefined) {
+        const fromSource = canonicalRepoId(source);
+        if (fromSource !== undefined)
+            return fromSource;
+    }
+    const origin = await spawnCollect(["git", "-C", repoPath, "remote", "get-url", "origin"]);
+    const fromOrigin = origin.exitCode === 0 ? canonicalRepoId(origin.stdout) : undefined;
+    return fromOrigin ?? localRepoId(repoPath);
+}
+/**
+ * Where this checkout's ghostrail keeps its state, and the legacy directory it
+ * used to keep it in.
+ *
+ * Both, because every caller that needs the new path also needs to know whether
+ * there is something at the old one to carry over.
+ */
+export async function stateDirFor(repoPath, config, env = process.env, home = homedir()) {
+    const repoId = await repoIdFor(repoPath, config);
+    return {
+        repoId,
+        dir: repoStateDir(repoId, env, home),
+        legacy: join(repoPath, LEGACY_STORE_DIR),
+    };
+}
+/** True when `dir` exists and holds at least one entry. */
+async function hasContent(dir) {
+    try {
+        if (!(await stat(dir)).isDirectory())
+            return false;
+        return (await readdir(dir)).length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Carry a checkout's `.factory` over to the repo's state directory.
+ *
+ * Copies rather than moves, and never deletes the original. A move that half
+ * succeeds loses a run history that exists nowhere else, and the cost of
+ * leaving a stale directory behind is one line of output telling the operator
+ * they can remove it. They can see it; the tool cannot see what it destroyed.
+ *
+ * Skipped when the destination already holds anything. That is what makes this
+ * idempotent, and it is also the answer to two checkouts of one repo each
+ * having their own `.factory`: the first is carried over and the second is
+ * reported rather than silently merged into or clobbering it. Merging two event
+ * logs is possible, but choosing which history is the real one is not a
+ * decision to make on someone's behalf.
+ */
+export async function migrateLegacyStore(legacy, dir) {
+    if (!(await hasContent(legacy)))
+        return { kind: "nothing-to-do" };
+    if (await hasContent(dir))
+        return { kind: "already-populated", from: legacy, to: dir };
+    try {
+        await cp(legacy, dir, { recursive: true });
+        // Verified before it is reported as done: `cp` resolving is not proof the
+        // destination is readable, and this is the only claim the operator has that
+        // their history survived.
+        if (!(await hasContent(dir))) {
+            return { kind: "failed", from: legacy, to: dir, error: "the copy left nothing behind" };
+        }
+        return { kind: "migrated", from: legacy, to: dir };
+    }
+    catch (error) {
+        return {
+            kind: "failed",
+            from: legacy,
+            to: dir,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/** One line describing an outcome, or undefined when there is nothing to say. */
+export function describeMigration(outcome) {
+    switch (outcome.kind) {
+        case "nothing-to-do":
+            return undefined;
+        case "migrated":
+            return `carried this repo's run history over to ${outcome.to}; ${outcome.from} is now unused and safe to delete`;
+        case "already-populated":
+            return `left ${outcome.from} alone: ${outcome.to} already holds history for this repo, and merging two histories is not a choice to make for you`;
+        case "failed":
+            return `could not carry ${outcome.from} over to ${outcome.to} (${outcome.error}); the original is untouched`;
+    }
+}
+/**
+ * The clone URL for this repo: `[factory].source` when set, else the checkout's
+ * own origin. Undefined for a repo with no remote, which cannot be cloned and
+ * must keep using the checkout it lives in.
+ */
+export async function cloneSourceFor(repoPath, config) {
+    const source = config?.factory.source;
+    if (source !== undefined && source.length > 0)
+        return source;
+    const origin = await spawnCollect(["git", "-C", repoPath, "remote", "get-url", "origin"]);
+    if (origin.exitCode !== 0)
+        return undefined;
+    const url = origin.stdout.trim();
+    return url.length === 0 ? undefined : url;
+}
+/**
+ * Where worktrees should be made from: ghostrail's own clone when it can have
+ * one, else the operator's checkout.
+ *
+ * Falls back rather than failing, in every case. A repo with no remote has
+ * nothing to clone; a clone that cannot be made or fetched leaves the old
+ * borrow-your-checkout behavior in place. Neither is worth refusing to run
+ * over, and both are worth saying out loud.
+ */
+export async function resolveWorkRepo(options) {
+    const { repoPath, stateDir, config } = options;
+    if (!config.backend.managedCheckout)
+        return {};
+    // A backend that clones per run has no use for one kept between runs.
+    if (config.backend.kind !== "local-worktree")
+        return {};
+    const source = await cloneSourceFor(repoPath, config);
+    if (source === undefined) {
+        return { note: `${repoPath} has no remote, so runs use this checkout directly` };
+    }
+    const result = await ensureManagedCheckout({
+        stateDir,
+        source,
+        baseBranch: config.factory.baseBranch,
+        ...(options.env === undefined ? {} : { env: options.env }),
+    });
+    if (result.kind === "unavailable") {
+        return { note: `using ${repoPath} for worktrees: ${result.reason}` };
+    }
+    return {
+        path: result.path,
+        ...(result.fetched ? {} : { note: `could not fetch ${source}; runs branch from a stale base` }),
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/factory/state.js.map

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

package/dist/global/index.d.ts

@@ -1,4 +1,6 @@
-export { type Ghostrail, REGISTRY_FILE, findByPath, parseRegistry, renderRegistry, upsert, } from "./registry.js";
+export { type Ghostrail, REGISTRY_FILE, entryKey, findByKey, findByPath, parseRegistry, renderRegistry, upsert, } from "./registry.js";
+export { canonicalRepoId, isLocalRepoId, localRepoId, repoKey } from "./repo-id.js";
+export { repoStateDir, stateHome } from "./state-dir.js";
 export { artifactFileName, type GlobalEnv, GlobalStore, resolveGlobalDir } from "./store.js";
 export { STAGED_ARTIFACTS_DIR, stageArtifacts } from "./stage.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/global/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/global/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EACd,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EACd,MAAM,GACP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/global/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EACd,aAAa,EACb,QAAQ,EACR,SAAS,EACT,UAAU,EACV,aAAa,EACb,cAAc,EACd,MAAM,GACP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/global/index.js

@@ -1,4 +1,6 @@
-export { REGISTRY_FILE, findByPath, parseRegistry, renderRegistry, upsert, } from "./registry.js";
+export { REGISTRY_FILE, entryKey, findByKey, findByPath, parseRegistry, renderRegistry, upsert, } from "./registry.js";
+export { canonicalRepoId, isLocalRepoId, localRepoId, repoKey } from "./repo-id.js";
+export { repoStateDir, stateHome } from "./state-dir.js";
 export { artifactFileName, GlobalStore, resolveGlobalDir } from "./store.js";
 export { STAGED_ARTIFACTS_DIR, stageArtifacts } from "./stage.js";
 //# sourceMappingURL=index.js.map

package/dist/global/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/global/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EACd,MAAM,GACP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAkB,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/global/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,QAAQ,EACR,SAAS,EACT,UAAU,EACV,aAAa,EACb,cAAc,EACd,MAAM,GACP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAkB,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/global/registry.d.ts

@@ -10,7 +10,24 @@
 export interface Ghostrail {
     /** Display name, from `[factory].name` or the directory. Never an identity. */
     name: string;
-    /** Absolute path to the repo. This is the identity. */
+    /**
+     * The repo this ghostrail is for, canonical (`host/owner/name`), or
+     * `local:<path>` for a repo with no usable remote. **This is the identity.**
+     *
+     * Optional only for backward compatibility: a registry written before repo
+     * identities existed has none, and an entry without one falls back to being
+     * keyed on its `path`, exactly as it was. This file is advertised as
+     * hand-editable, and refusing to read yesterday's one would be the worst
+     * possible reading of that promise.
+     */
+    repo?: string;
+    /**
+     * Absolute path to the checkout most recently used for this repo.
+     *
+     * A hint, for a human reading the file and for a local-worktree run that
+     * needs somewhere to make worktrees from. Not the identity: two checkouts of
+     * one repo are one ghostrail, which is the whole point of `repo`.
+     */
     path: string;
     /** ISO date the entry was added, for the operator. Nothing reads it. */
     added: string;
@@ -36,9 +53,10 @@ export declare const REGISTRY_FILE = "ghostrails.toml";
  * than fatal, so a registry written by a later ghostrail still reads here.
  * Order is preserved exactly, and the array is fresh on every call.
  *
- * Two entries at the same path are malformed for the same reason: a parsed
- * registry never contains duplicate paths, which is what lets `upsert` and
- * `findByPath` stay as simple as they are.
+ * Two entries for the same ghostrail are malformed for the same reason: a
+ * parsed registry never contains duplicate keys, which is what lets `upsert`
+ * and `findByKey` stay as simple as they are. The key is the repo identity, or
+ * the path for an entry written before identities existed.
  */
 export declare function parseRegistry(toml: string): Ghostrail[] | undefined;
 /**
@@ -51,10 +69,25 @@ export declare function parseRegistry(toml: string): Ghostrail[] | undefined;
  * the header invites them to do.
  */
 export declare function renderRegistry(entries: readonly Ghostrail[]): string;
+/**
+ * What an entry is keyed on: its repo identity, or its path when it has none.
+ *
+ * One function so the parser, `findByKey`, and `upsert` cannot disagree about
+ * what "the same ghostrail" means, which is exactly the kind of drift that let
+ * two checkouts become two ghostrails in the first place.
+ */
+export declare function entryKey(entry: Ghostrail): string;
 /** The entry at `path`, or undefined. Exact string equality; callers resolve first. */
 export declare function findByPath(entries: readonly Ghostrail[], path: string): Ghostrail | undefined;
+/** The entry for a repo identity (or a path, for an entry that has none). */
+export declare function findByKey(entries: readonly Ghostrail[], key: string): Ghostrail | undefined;
 /**
- * Add `entry`, or replace the one at the same path.
+ * Add `entry`, or replace the one with the same identity.
+ *
+ * Keyed on the repo, so `init` in a second checkout of a known repo updates
+ * that ghostrail (adopting the new checkout as its `path`) instead of adding a
+ * second one. An entry with no identity still matches on path, so a
+ * pre-identity registry keeps working.
  *
  * A replacement keeps its position so a diff of the file shows a changed block
  * rather than a move; a new entry appends. Neither argument is mutated.

package/dist/global/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/global/registry.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,uCAAuC;AACvC,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAyB/C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAS,CA2BnE;AAOD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAapE;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE7F;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,CAMnF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/global/registry.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,uCAAuC;AACvC,eAAO,MAAM,aAAa,oBAAoB,CAAC;AA2B/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAS,CA4BnE;AAOD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAcpE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEjD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE7F;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,CAOnF"}

package/dist/global/registry.js

@@ -17,12 +17,15 @@ function isRecord(value) {
 function parseEntry(raw) {
     if (!isRecord(raw))
         return undefined;
-    const { name, path, added, watch } = raw;
+    const { name, repo, path, added, watch } = raw;
     if (typeof name !== "string" || typeof path !== "string")
         return undefined;
     if (typeof added !== "string" || typeof watch !== "boolean")
         return undefined;
-    return { name, path, added, watch };
+    // Absent is legal (a pre-identity registry); present but not a string is not.
+    if (repo !== undefined && typeof repo !== "string")
+        return undefined;
+    return { name, ...(repo === undefined ? {} : { repo }), path, added, watch };
 }
 /**
  * Parse the registry, or undefined when it cannot be trusted.
@@ -38,9 +41,10 @@ function parseEntry(raw) {
  * than fatal, so a registry written by a later ghostrail still reads here.
  * Order is preserved exactly, and the array is fresh on every call.
  *
- * Two entries at the same path are malformed for the same reason: a parsed
- * registry never contains duplicate paths, which is what lets `upsert` and
- * `findByPath` stay as simple as they are.
+ * Two entries for the same ghostrail are malformed for the same reason: a
+ * parsed registry never contains duplicate keys, which is what lets `upsert`
+ * and `findByKey` stay as simple as they are. The key is the repo identity, or
+ * the path for an entry written before identities existed.
  */
 export function parseRegistry(toml) {
     let root;
@@ -58,18 +62,19 @@ export function parseRegistry(toml) {
     if (!Array.isArray(raw))
         return undefined;
     const entries = [];
-    const paths = new Set();
+    const keys = new Set();
     for (const item of raw) {
         const entry = parseEntry(item);
         if (entry === undefined)
             return undefined;
-        // `path` is the identity, so two blocks claiming it is a contradiction
-        // rather than a preference to resolve. Copying a block and forgetting to
-        // change the path is a plausible hand-edit, and honouring either one of
-        // them would silently ignore an edit the operator clearly meant.
-        if (paths.has(entry.path))
+        // Two blocks claiming one ghostrail is a contradiction rather than a
+        // preference to resolve. Copying a block and forgetting to change the repo
+        // is a plausible hand-edit, and honouring either one of them would silently
+        // ignore an edit the operator clearly meant.
+        const key = entryKey(entry);
+        if (keys.has(key))
             return undefined;
-        paths.add(entry.path);
+        keys.add(key);
         entries.push(entry);
     }
     return entries;
@@ -91,6 +96,7 @@ export function renderRegistry(entries) {
     const blocks = entries.map((entry) => [
         "[[ghostrail]]",
         `name  = ${quote(entry.name)}`,
+        ...(entry.repo === undefined ? [] : [`repo  = ${quote(entry.repo)}`]),
         `path  = ${quote(entry.path)}`,
         `added = ${quote(entry.added)}`,
         `watch = ${entry.watch}`,
@@ -99,18 +105,38 @@ export function renderRegistry(entries) {
     // run together the blocks are hard to read and give noisier diffs.
     return `${[HEADER, ...blocks].join("\n\n")}\n`;
 }
+/**
+ * What an entry is keyed on: its repo identity, or its path when it has none.
+ *
+ * One function so the parser, `findByKey`, and `upsert` cannot disagree about
+ * what "the same ghostrail" means, which is exactly the kind of drift that let
+ * two checkouts become two ghostrails in the first place.
+ */
+export function entryKey(entry) {
+    return entry.repo ?? entry.path;
+}
 /** The entry at `path`, or undefined. Exact string equality; callers resolve first. */
 export function findByPath(entries, path) {
     return entries.find((entry) => entry.path === path);
 }
+/** The entry for a repo identity (or a path, for an entry that has none). */
+export function findByKey(entries, key) {
+    return entries.find((entry) => entryKey(entry) === key);
+}
 /**
- * Add `entry`, or replace the one at the same path.
+ * Add `entry`, or replace the one with the same identity.
+ *
+ * Keyed on the repo, so `init` in a second checkout of a known repo updates
+ * that ghostrail (adopting the new checkout as its `path`) instead of adding a
+ * second one. An entry with no identity still matches on path, so a
+ * pre-identity registry keeps working.
  *
  * A replacement keeps its position so a diff of the file shows a changed block
  * rather than a move; a new entry appends. Neither argument is mutated.
  */
 export function upsert(entries, entry) {
-    const index = entries.findIndex((existing) => existing.path === entry.path);
+    const key = entryKey(entry);
+    const index = entries.findIndex((existing) => entryKey(existing) === key);
     if (index === -1)
         return [...entries, entry];
     const next = [...entries];

package/dist/global/registry.js.map

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

package/dist/global/repo-id.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The canonical identity of the repo a git remote points at, as
+ * `host[:port]/path/to/repo`, or undefined when the remote is not one.
+ *
+ * The point is that every spelling of one repo collapses to one string:
+ * scp-like and URL forms, with or without `.git`, with or without a default
+ * port, are the same repo and must key the same ghostrail.
+ *
+ * Strict everywhere except case. Anything unrecognised is undefined rather than
+ * guessed, because the two failure directions are not symmetric: wrongly
+ * merging two repos pools their history and cannot be undone, while wrongly
+ * separating two clones only leaves today's behavior in place. The exception is
+ * lowercasing, which is deliberately lenient: hosts are case-insensitive and so
+ * are repos on the forges people use, so `Owner/Repo` and `owner/repo` are one
+ * repo. On a case-sensitive host that could merge two repos differing only in
+ * case, which is judged far less likely than someone typing a clone URL with
+ * different capitalisation.
+ *
+ * Never throws. A remote that cannot be read is a missing identity, and the
+ * caller falls back to {@link localRepoId}.
+ */
+export declare function canonicalRepoId(remote: string): string | undefined;
+/**
+ * The identity of a repo with no usable remote, from its absolute path.
+ *
+ * The `local:` prefix means it can never collide with a `host/...` identity,
+ * and makes a path-keyed entry visibly path-keyed rather than silently so. The
+ * path is kept verbatim: it is already absolute, and case-folding it would be
+ * wrong on a case-sensitive filesystem.
+ */
+export declare function localRepoId(path: string): string;
+/**
+ * Whether an identity is path-keyed rather than derived from a remote.
+ *
+ * Checks `local:/`, not `local:`. The shorter prefix looks like the marker and
+ * is not one: a host genuinely named `local` on a non-default port produces
+ * `local:22/owner/repo`, which is an ordinary canonical identity.
+ */
+export declare function isLocalRepoId(id: string): boolean;
+/**
+ * A filesystem-safe directory name for an identity.
+ *
+ * The hash is not decoration. Folding characters and truncating both lose
+ * information, so two different identities can reduce to the same readable
+ * stem; the hash of the *full* identity is what keeps the key unique. The stem
+ * is there so a human browsing the state directory can tell what they are
+ * looking at.
+ */
+export declare function repoKey(id: string): string;
+//# sourceMappingURL=repo-id.d.ts.map

package/dist/global/repo-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-id.d.ts","sourceRoot":"","sources":["../../src/global/repo-id.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBlE;AAqDD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAU1C"}