@skillsmith/core 0.12.3 → 0.12.5

package/dist/src/install/fan-out.js

@@ -11,60 +11,18 @@
  *
  * Every fan-out is recorded in `~/.skillsmith/links/manifest.json` so
  * `removeLinks(skillId)` can tear down both copies and symlinks atomically
- * during uninstall.
+ * during uninstall. The manifest itself lives in fan-out.manifest.ts.
  *
  * @module @skillsmith/core/install/fan-out
  */
-import { homedir } from 'node:os';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
 import * as fsp from 'node:fs/promises';
 import { CLIENT_NATIVE_PATHS, CANONICAL_CLIENT } from './paths.js';
-import { assertNotRealUserHome } from '../services/skill-manifest.js';
-const MANIFEST_VERSION = 1;
-/**
- * Resolve the manifest file path. Sits under `~/.skillsmith/` so it shares
- * the existing allow-list entry for that directory (DEFAULT_ALLOWED_DIRS in
- * `pathValidation.ts`).
- */
-export function getLinkManifestPath() {
-    return path.join(homedir(), '.skillsmith', 'links', 'manifest.json');
-}
-/**
- * Load the manifest from disk. Returns an empty manifest if the file is
- * missing or unreadable — fan-out is best-effort, never crash on cold start.
- */
-export async function loadManifest() {
-    const manifestPath = getLinkManifestPath();
-    try {
-        const raw = await fsp.readFile(manifestPath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (parsed?.version !== MANIFEST_VERSION || !Array.isArray(parsed.links)) {
-            return { version: MANIFEST_VERSION, links: [] };
-        }
-        return parsed;
-    }
-    catch {
-        return { version: MANIFEST_VERSION, links: [] };
-    }
-}
-/**
- * Persist the manifest atomically (write-temp + rename) so a crash mid-write
- * never leaves the file in a partial state.
- */
-export async function saveManifest(manifest) {
-    const manifestPath = getLinkManifestPath();
-    // SMI-6343 follow-up (adversarial review): a fourth parallel manifest-write
-    // implementation (a different file, `links/manifest.json`, but the same
-    // homedir-derived-with-no-override shape). The $HOME sandbox
-    // (vitest.setup.ts) was this file's only defense until this guard.
-    assertNotRealUserHome(manifestPath, 'write');
-    const dir = path.dirname(manifestPath);
-    await fsp.mkdir(dir, { recursive: true });
-    const tmp = `${manifestPath}.${process.pid}.tmp`;
-    await fsp.writeFile(tmp, JSON.stringify(manifest, null, 2), 'utf-8');
-    await fsp.rename(tmp, manifestPath);
-}
+import { assertOverwritable, leftoverBackupWarning, listLeftoverBackups, recoverDestination, replaceDestination, withDestinationLock, } from './fan-out.overwrite.js';
+import { getLinkManifestPath, loadManifest, readManifestFile, unreadableManifestError, updateManifest, } from './fan-out.manifest.js';
+import { removeRecordedLink, undoUnrecordedWrite } from './fan-out.cleanup.js';
+export { getLinkManifestPath, loadManifest, saveManifest } from './fan-out.manifest.js';
 /**
  * Detect a fan-out cycle: refuses to link `from → to` when `to` is already
  * the source of any entry, OR when `from` is already the destination of any
@@ -110,28 +68,22 @@ async function copyDirectoryRecursive(src, dest) {
         }
     }
 }
-async function pathExists(p) {
+/**
+ * Round 27 (cross-model review): this returned a plain boolean, so a
+ * permission or I/O failure was reported to the user as "does not exist" —
+ * sending them to reinstall a skill that is sitting right where they left it.
+ * Only absence is absence.
+ */
+async function inspectPath(p) {
     try {
         await fsp.access(p, fs.constants.F_OK);
-        return true;
+        return { kind: 'present' };
     }
-    catch {
-        return false;
-    }
-}
-async function removePath(p) {
-    try {
-        const stat = await fsp.lstat(p);
-        if (stat.isSymbolicLink() || stat.isFile()) {
-            await fsp.unlink(p);
-        }
-        else {
-            await fsp.rm(p, { recursive: true, force: true });
-        }
-    }
-    catch {
-        // Best-effort — uninstall should not fail because cleanup races with
-        // an external editor that already moved the file.
+    catch (err) {
+        const code = err?.code;
+        if (code === 'ENOENT' || code === 'ENOTDIR')
+            return { kind: 'absent' };
+        return { kind: 'unknown', reason: code ?? (err instanceof Error ? err.message : String(err)) };
     }
 }
 /**
@@ -151,74 +103,223 @@ export async function addLink(opts) {
     }
     const fromDir = path.join(CLIENT_NATIVE_PATHS[fromClient], skillId);
     const toDir = path.join(CLIENT_NATIVE_PATHS[toClient], skillId);
-    if (!(await pathExists(fromDir))) {
+    const source = await inspectPath(fromDir);
+    if (source.kind === 'absent') {
         throw new Error(`addLink: source skill '${skillId}' does not exist at ${fromDir} — install for ${fromClient} first`);
     }
-    const manifest = await loadManifest();
-    const cycle = detectCycle(manifest, fromDir, toDir);
+    if (source.kind === 'unknown') {
+        throw new Error(`addLink: the source skill at ${fromDir} could not be checked (${source.reason}), so ` +
+            `nothing was changed.`);
+    }
+    const cycle = detectCycle(await loadManifest(), fromDir, toDir);
     if (cycle)
         throw new Error(`addLink: ${cycle}`);
-    if (await pathExists(toDir)) {
-        if (!force) {
-            throw new Error(`addLink: ${toDir} already exists. Pass force: true (CLI: --force) to overwrite.`);
-        }
-        await removePath(toDir);
-    }
-    await fsp.mkdir(path.dirname(toDir), { recursive: true });
-    let kind = 'copy';
-    let fellBackToCopy = false;
-    if (preferSymlink) {
-        // Use a relative symlink so the manifest entry stays portable across
-        // homedir changes (matters for users who rsync their home directory).
-        const relTarget = path.relative(path.dirname(toDir), fromDir);
+    // SMI-6529 round 6: everything that reads or writes the destination runs
+    // under its lock, so a concurrent call can never touch another call's
+    // staging or backup folder (see fan-out.overwrite.ts).
+    return withDestinationLock(toDir, async () => {
+        // Round 9: fail before writing anything if the manifest can't be read,
+        // since the new copy could never be recorded.
+        const read = await readManifestFile();
+        if (read.state === 'unreadable')
+            throw unreadableManifestError(read.reason);
+        const manifest = read.manifest;
+        const recovery = await recoverDestination(toDir, manifest);
+        let existing = null;
         try {
-            await fsp.symlink(relTarget, toDir, 'dir');
-            kind = 'symlink';
+            existing = await fsp.lstat(toDir);
         }
         catch (err) {
-            const code = err.code;
-            if (code === 'EPERM' || code === 'ENOSYS') {
-                await copyDirectoryRecursive(fromDir, toDir);
-                kind = 'copy';
-                fellBackToCopy = true;
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+        if (existing) {
+            if (!force) {
+                throw new Error(`addLink: ${toDir} already exists. Pass force: true (CLI: --force) to overwrite. ` +
+                    `If it is an empty directory, an interrupted install may have left it; Skillsmith ` +
+                    `does not remove it for you, since an empty directory you made looks the same.`);
+            }
+            // Round 10: say why there's no record, rather than "not recorded".
+            if (read.state === 'corrupt' && !existing.isSymbolicLink()) {
+                throw new Error(`addLink: ${toDir} already exists, and the fan-out link manifest at ` +
+                    `${getLinkManifestPath()} could not be parsed, so nothing shows Skillsmith made ` +
+                    `this copy. Fix or move the manifest, or remove ${toDir} yourself, then retry.`);
+            }
+            await assertOverwritable(toDir, existing, manifest);
+        }
+        // Round 11: a symlink is replaced with no backup, so keep its target in
+        // case the new record can't be saved and it has to be put back.
+        const oldLinkTarget = existing?.isSymbolicLink() ? await fsp.readlink(toDir) : undefined;
+        let kind = 'copy';
+        let fellBackToCopy = false;
+        // The new copy or symlink is written to a staging path and swapped into
+        // place; a failure here never touches the existing destination. `placed`
+        // is what this call put in place, so an undo only removes that.
+        const { placed, warnings: swapWarnings } = await replaceDestination(toDir, async (staged) => {
+            if (preferSymlink) {
+                // A relative symlink keeps the manifest entry portable across homedir
+                // changes. It is computed for the FINAL location, not the staging path.
+                const relTarget = path.relative(path.dirname(toDir), fromDir);
+                try {
+                    await fsp.symlink(relTarget, staged, 'dir');
+                    kind = 'symlink';
+                }
+                catch (err) {
+                    const code = err.code;
+                    if (code === 'EPERM' || code === 'ENOSYS') {
+                        await copyDirectoryRecursive(fromDir, staged);
+                        kind = 'copy';
+                        fellBackToCopy = true;
+                    }
+                    else {
+                        throw err;
+                    }
+                }
             }
             else {
-                throw err;
+                await copyDirectoryRecursive(fromDir, staged);
+            }
+        });
+        const record = {
+            skillId,
+            from: fromDir,
+            to: toDir,
+            kind,
+            createdAt: new Date().toISOString(),
+        };
+        // SMI-6529 N7: a force-overwrite of an already-recorded destination
+        // replaces its manifest entry rather than appending a second one.
+        const resolvedToDir = path.resolve(toDir);
+        let manifestWarning;
+        try {
+            manifestWarning = await updateManifest((current) => {
+                current.links = current.links.filter((l) => path.resolve(l.to) !== resolvedToDir);
+                current.links.push(record);
+            });
+        }
+        catch (err) {
+            if (!existing || oldLinkTarget !== undefined) {
+                await undoUnrecordedWrite(toDir, err, oldLinkTarget, placed);
+            }
+            throw err;
+        }
+        const leftovers = await listLeftoverBackups(toDir);
+        const warnings = [
+            ...(manifestWarning ? [manifestWarning] : []),
+            ...swapWarnings,
+            ...(recovery.unreadable ? [recovery.unreadable] : []),
+            ...(leftovers.unreadable ? [leftovers.unreadable] : []),
+            ...leftovers.folders.map(leftoverBackupWarning),
+        ];
+        return warnings.length > 0 ? { record, fellBackToCopy, warnings } : { record, fellBackToCopy };
+    });
+}
+/**
+ * Warning for an uninstall that couldn't use the manifest (rounds 11–12). By
+ * then the canonical skill is gone, so a second uninstall stops at "not
+ * installed" and never gets here: any fan-out copy left is the user's to
+ * remove. List the ones on disk so they know where to look.
+ */
+async function unusableManifestWarning(read, skillId) {
+    const why = read.state === 'corrupt' ? 'could not be parsed' : `could not be read (${read.reason})`;
+    const canonical = path.resolve(CLIENT_NATIVE_PATHS[CANONICAL_CLIENT]);
+    const candidates = [];
+    const unreadable = [];
+    for (const root of new Set(Object.values(CLIENT_NATIVE_PATHS))) {
+        if (path.resolve(root) === canonical)
+            continue;
+        const dir = path.join(root, skillId);
+        try {
+            await fsp.lstat(dir);
+            candidates.push(dir);
+        }
+        catch (err) {
+            // Round 27 (cross-model review): a folder that could not be inspected is
+            // not a folder that isn't there, and this message went on to promise
+            // there was "nothing to clean up".
+            const code = err?.code;
+            if (code !== 'ENOENT' && code !== 'ENOTDIR') {
+                unreadable.push(`${dir} (${code ?? (err instanceof Error ? err.message : String(err))})`);
             }
         }
     }
-    else {
-        await copyDirectoryRecursive(fromDir, toDir);
-    }
-    const record = {
-        skillId,
-        from: fromDir,
-        to: toDir,
-        kind,
-        createdAt: new Date().toISOString(),
-    };
-    manifest.links.push(record);
-    await saveManifest(manifest);
-    return { record, fellBackToCopy };
+    const found = candidates.length > 0
+        ? ` These may be fan-out copies Skillsmith made; check each one and delete it yourself ` +
+            `if you don't need it: ${candidates.join(', ')}.`
+        : '';
+    const couldNotCheck = unreadable.length > 0
+        ? ` These could not be checked, so anything under them is not reported here: ` +
+            `${unreadable.join(', ')}.`
+        : '';
+    const next = found === '' && couldNotCheck === ''
+        ? ` No other client's skills folder has a ${skillId} folder, so there is nothing to clean up.`
+        : `${found}${couldNotCheck}`;
+    return (`the fan-out link manifest at ${getLinkManifestPath()} ${why}, so no fan-out copies of ` +
+        `${skillId} were checked or removed.${next}`);
 }
 /**
- * Remove every fan-out link recorded for `skillId`. Returns the number of
- * destinations removed. Safe to call when no manifest exists (returns 0).
+ * Remove every fan-out link recorded for `skillId`. Safe to call when no
+ * manifest exists (returns `{ removed: 0, refused: [] }`).
  *
  * Uninstall callers should invoke this BEFORE removing the canonical
  * directory so symlinks resolve cleanly during their lstat checks.
+ *
+ * SMI-6529 N6 (round 4): a destination `removeRecordedLink` refuses (a
+ * recorded copy that now contains `.git` at its root, or a removal error)
+ * keeps its manifest entry instead of being unconditionally dropped — the
+ * old unconditional `manifest.links = manifest.links.filter(...)` discarded
+ * the record for EVERY matching link regardless of whether the on-disk
+ * removal actually succeeded, so a refused destination could never be
+ * retried and its refusal was never reported anywhere.
  */
 export async function removeLinks(skillId) {
-    const manifest = await loadManifest();
-    const matching = manifest.links.filter((l) => l.skillId === skillId);
+    const read = await readManifestFile();
+    // Round 11: an unusable manifest used to read as empty, so an uninstall
+    // said nothing and left every fan-out copy behind. Say so instead, and
+    // leave the file alone.
+    if (read.state === 'unreadable' || read.state === 'corrupt') {
+        return { removed: 0, refused: [], warnings: [await unusableManifestWarning(read, skillId)] };
+    }
+    const matching = read.manifest.links.filter((l) => l.skillId === skillId);
     if (matching.length === 0)
-        return 0;
+        return { removed: 0, refused: [] };
+    const refused = [];
+    const warnings = [];
+    const removedTargets = new Set();
     for (const link of matching) {
-        await removePath(link.to);
+        // SMI-6529 round 6: same per-destination lock as addLink. The record is
+        // dropped while that lock is still held (round 10): filtering after the
+        // loop also dropped a record a later re-link had saved, leaving its copy
+        // untracked. Round 11: drop the records the manifest holds for this
+        // destination now, not the one read above; a force refresh that ran
+        // first had replaced it, and dropping only the old one left a record for
+        // the folder just removed. Every writer of a destination's records holds
+        // its lock, so this read is current.
+        const resolvedTo = path.resolve(link.to);
+        const step = await withDestinationLock(link.to, async () => {
+            const outcome = await removeRecordedLink(link.to);
+            const manifestWarning = outcome.removed
+                ? await updateManifest((current) => {
+                    current.links = current.links.filter((l) => l.skillId !== skillId || path.resolve(l.to) !== resolvedTo);
+                })
+                : undefined;
+            return { outcome, manifestWarning, leftovers: await listLeftoverBackups(link.to) };
+        });
+        if (step.manifestWarning)
+            warnings.push(step.manifestWarning);
+        if (step.outcome.removed) {
+            removedTargets.add(link.to);
+        }
+        else {
+            refused.push({ to: link.to, reason: step.outcome.reason });
+        }
+        if (step.leftovers.unreadable)
+            warnings.push(step.leftovers.unreadable);
+        warnings.push(...step.leftovers.folders.map(leftoverBackupWarning));
     }
-    manifest.links = manifest.links.filter((l) => l.skillId !== skillId);
-    await saveManifest(manifest);
-    return matching.length;
+    return warnings.length > 0
+        ? { removed: removedTargets.size, refused, warnings }
+        : { removed: removedTargets.size, refused };
 }
 /**
  * List all fan-out links for a skill (or all skills when `skillId` is

package/dist/src/install/fan-out.js.map

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

package/dist/src/install/fan-out.leftovers.d.ts

@@ -0,0 +1,60 @@
+import type { Stats } from 'node:fs';
+import type { LinkManifest } from './fan-out.manifest.js';
+/** What a leftover scan found, and whether it could look at all. */
+export interface LeftoverScan {
+    /** Hidden folders beside the destination that an interrupted operation left. */
+    folders: string[];
+    /**
+     * Set when the parent folder could not be listed. Round 24 (cross-model
+     * review): returning an empty list then reports "could not look" as "nothing
+     * is there", and the accepted residual's promise is that a displaced entry
+     * gets reported.
+     */
+    unreadable?: string;
+}
+export declare const BACKUP_TAG = ".skillsmith-backup-";
+export declare const STAGING_TAG = ".skillsmith-staging-";
+export declare function escapeRegExp(s: string): string;
+/** Hidden sibling name prefix for `dest`, e.g. `.foo.skillsmith-backup-`. */
+export declare function siblingPrefix(dest: string, tag: string): string;
+/** Exact match for a `mkdtemp` folder made from `siblingPrefix(dest, tag)` (6-char suffix). */
+export declare function siblingPattern(dest: string, tag: string): RegExp;
+export declare function lstatOrNull(p: string): Promise<Stats | null>;
+/** Whether the link manifest records `dest` as a copy Skillsmith made. */
+export declare function isRecordedCopy(dest: string, manifest: LinkManifest): boolean;
+/**
+ * Housekeeping under the destination lock, before any write:
+ *  - remove an empty backup folder (a crash before anything was moved in);
+ *  - restore a backup stranded by a crash between the rename-aside and the
+ *    swap: the destination is missing, this is the only backup whose
+ *    `original` is a real directory, and the manifest still records the
+ *    destination as a copy. Backups are only ever made of recorded copies,
+ *    so an unrecorded one has been uninstalled since, and restoring it would
+ *    bring back a stale, untracked copy. With two or more, nothing says which
+ *    is newest (a name can sort anywhere), so none is restored (round 9).
+ *
+ * Any other backup is left in place for `listLeftoverBackups` to report, and
+ * so is a staging folder left by a crashed write: round 14 (cross-model
+ * review) stopped deleting those here, since neither a folder's name nor its
+ * contents proves who owns it now. Returns the backup folders restored from.
+ */
+export declare function recoverDestination(dest: string, manifest: LinkManifest): Promise<{
+    restored: string[];
+    unreadable?: string;
+}>;
+/**
+ * Backup folders for `dest` that are still present: copies an interrupted
+ * refresh left behind (after the swap, or unrestorable). Round 7: these are
+ * reported to the user rather than kept silently or deleted. Round 8: an
+ * empty one holds nothing to report and is removed. Round 9: on a volume
+ * that ignores case, a backup made under another spelling of the name
+ * (`.Foo.` for `foo`) belongs to this destination too, so it is reported;
+ * it is never removed or restored, since on a case-sensitive volume the
+ * same name belongs to a different destination. Round 14: a staging folder
+ * left by a crashed write is reported the same way. Round 15: so is what a
+ * crashed or failed removal left under a parked name. Call under the lock.
+ */
+export declare function listLeftoverBackups(dest: string): Promise<LeftoverScan>;
+/** User-facing warning for a leftover backup, staging folder or parked entry. */
+export declare function leftoverBackupWarning(folder: string): string;
+//# sourceMappingURL=fan-out.leftovers.d.ts.map

package/dist/src/install/fan-out.leftovers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fan-out.leftovers.d.ts","sourceRoot":"","sources":["../../../src/install/fan-out.leftovers.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAGzD,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAqBD,eAAO,MAAM,UAAU,wBAAwB,CAAA;AAC/C,eAAO,MAAM,WAAW,yBAAyB,CAAA;AAEjD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhE;AAiBD,wBAAsB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAOlE;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAG5E;AAgBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8CtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8B7E;AAiCD,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAoB5D"}