@skillsmith/core 0.12.3 → 0.12.4

package/dist/src/exports/services.install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.install.d.ts","sourceRoot":"","sources":["../../../src/exports/services.install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,6CAA6C,CAAA;AAsBpD,OAAO,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,2CAA2C,CAAA;AAElD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAEtF,OAAO,EACL,0BAA0B,IAAI,kCAAkC,EAChE,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,IAAI,iBAAiB,EACvC,KAAK,gBAAgB,EAErB,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,eAAe,IAAI,mBAAmB,EAC3C,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,IAAI,oBAAoB,EAC7C,KAAK,cAAc,IAAI,kBAAkB,EACzC,KAAK,iBAAiB,GACvB,MAAM,yCAAyC,CAAA;AAEhD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,4CAA4C,CAAA;AAUnD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,8CAA8C,CAAA;AAMrD,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,uBAAuB,EACvB,kCAAkC,GACnC,MAAM,gCAAgC,CAAA;AAMvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"services.install.d.ts","sourceRoot":"","sources":["../../../src/exports/services.install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,6CAA6C,CAAA;AAsBpD,OAAO,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,2CAA2C,CAAA;AAElD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAMtF,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,GAC9B,MAAM,gDAAgD,CAAA;AAEvD,OAAO,EACL,0BAA0B,IAAI,kCAAkC,EAChE,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,IAAI,iBAAiB,EACvC,KAAK,gBAAgB,EAErB,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,eAAe,IAAI,mBAAmB,EAC3C,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,IAAI,oBAAoB,EAC7C,KAAK,cAAc,IAAI,kBAAkB,EACzC,KAAK,iBAAiB,GACvB,MAAM,yCAAyC,CAAA;AAEhD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,4CAA4C,CAAA;AAUnD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,8CAA8C,CAAA;AAMrD,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,uBAAuB,EACvB,kCAAkC,GACnC,MAAM,gCAAgC,CAAA;AAMvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/src/exports/services.install.js

@@ -39,6 +39,11 @@ export { buildAdoptedManifestEntry, adoptUntrackedSkillEntry, } from '../service
 // ============================================================================
 export { SkillInstallationService, } from '../services/skill-installation.service.js';
 export { ManifestManager, assertNotRealUserHome } from '../services/skill-manifest.js';
+// SMI-6529 L20 (round 2): exported so mcp-server's `install.ts` conflict
+// pre-flight can run the SAME pre-write target guard `install()` itself runs
+// internally, BEFORE any backup/GC side effect — see that call site's own
+// comment for why running it first matters.
+export { checkInstallTarget, } from '../services/skill-installation.target-guard.js';
 export { TRUST_TIER_SCANNER_OPTIONS as INSTALL_TRUST_TIER_SCANNER_OPTIONS, } from '../services/skill-installation.types.js';
 export { recordAiDefenceFeedback, collectTrendWarnings, } from '../services/skill-installation.feedback.js';
 // ============================================================================

package/dist/src/exports/services.install.js.map

@@ -1 +1 @@
-{"version":3,"file":"services.install.js","sourceRoot":"","sources":["../../../src/exports/services.install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,0EAA0E;AAC1E,gCAAgC;AAChC,EAAE;AACF,2EAA2E;AAC3E,qEAAqE;AACrE,0EAA0E;AAC1E,4EAA4E;AAC5E,qEAAqE;AACrE,uEAAuE;AACvE,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,6CAA6C,CAAA;AAEpD,+EAA+E;AAC/E,sEAAsE;AACtE,+EAA+E;AAC/E,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,oFAAoF;AACpF,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,2EAA2E;AAE3E,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E,OAAO,EACL,wBAAwB,GAEzB,MAAM,2CAA2C,CAAA;AAElD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAEtF,OAAO,EACL,0BAA0B,IAAI,kCAAkC,GAmBjE,MAAM,yCAAyC,CAAA;AAEhD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,4CAA4C,CAAA;AAEnD,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,qEAAqE;AACrE,2EAA2E;AAC3E,qEAAqE;AACrE,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GAStB,MAAM,8CAA8C,CAAA;AAErD,+EAA+E;AAC/E,gDAAgD;AAChD,+EAA+E;AAE/E,OAAO,EACL,oBAAoB,GAGrB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,uBAAuB,EACvB,kCAAkC,GACnC,MAAM,gCAAgC,CAAA;AAEvC,4EAA4E;AAC5E,gEAAgE;AAChE,yEAAyE;AACzE,QAAQ;AACR,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"services.install.js","sourceRoot":"","sources":["../../../src/exports/services.install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,0EAA0E;AAC1E,gCAAgC;AAChC,EAAE;AACF,2EAA2E;AAC3E,qEAAqE;AACrE,0EAA0E;AAC1E,4EAA4E;AAC5E,qEAAqE;AACrE,uEAAuE;AACvE,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,6CAA6C,CAAA;AAEpD,+EAA+E;AAC/E,sEAAsE;AACtE,+EAA+E;AAC/E,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,oFAAoF;AACpF,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,2EAA2E;AAE3E,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E,OAAO,EACL,wBAAwB,GAEzB,MAAM,2CAA2C,CAAA;AAElD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAEtF,yEAAyE;AACzE,6EAA6E;AAC7E,0EAA0E;AAC1E,4CAA4C;AAC5C,OAAO,EACL,kBAAkB,GAGnB,MAAM,gDAAgD,CAAA;AAEvD,OAAO,EACL,0BAA0B,IAAI,kCAAkC,GAmBjE,MAAM,yCAAyC,CAAA;AAEhD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,4CAA4C,CAAA;AAEnD,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,qEAAqE;AACrE,2EAA2E;AAC3E,qEAAqE;AACrE,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GAStB,MAAM,8CAA8C,CAAA;AAErD,+EAA+E;AAC/E,gDAAgD;AAChD,+EAA+E;AAE/E,OAAO,EACL,oBAAoB,GAGrB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,uBAAuB,EACvB,kCAAkC,GACnC,MAAM,gCAAgC,CAAA;AAEvC,4EAA4E;AAC5E,gEAAgE;AAChE,yEAAyE;AACzE,QAAQ;AACR,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/src/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @skillsmith/core - Core functionality for skill discovery
  */
-export declare const VERSION = "0.12.3";
+export declare const VERSION = "0.12.4";
 export * from './exports/services.js';
 export * from './exports/repositories.js';
 export { createDatabaseSync, createDatabaseAsync } from './db/createDatabase.js';

package/dist/src/index.js

@@ -2,7 +2,7 @@
  * @skillsmith/core - Core functionality for skill discovery
  */
 // Version
-export const VERSION = '0.12.3';
+export const VERSION = '0.12.4';
 // ============================================================================
 // Grouped Exports from Barrel Files
 // ============================================================================

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

@@ -0,0 +1,37 @@
+import { type EntryIdentity } from './remove-if-same.js';
+/** Result of {@link removeRecordedLink}. */
+export type RecordedLinkRemoval = {
+    removed: true;
+} | {
+    removed: false;
+    reason: string;
+};
+/**
+ * SMI-6529 H3 (round 2) / N6 (round 4): uninstall's teardown of a copy-mode
+ * fan-out (or symlink) Skillsmith created and recorded in the link manifest.
+ *
+ * A recorded copy can later become a real git working tree (the user
+ * `git init`s or clones into that path), so a non-symlink recorded copy with
+ * `.git` at its root is refused: reported and left in place. Symlinks are
+ * just unlinked; what they point at is untouched.
+ *
+ * Returns `{ removed: true }` on a removal, or when the path is already gone,
+ * and `{ removed: false, reason }` on a refusal or a failure, so the caller
+ * keeps the manifest entry and reports it.
+ */
+export declare function removeRecordedLink(p: string): Promise<RecordedLinkRemoval>;
+/**
+ * SMI-6529 rounds 10–11: undo addLink's write when its record couldn't be
+ * saved. A fresh destination is removed. A refreshed symlink is put back,
+ * since its existing record still describes it (it was replaced with no
+ * backup). Left as is, either would be a destination the manifest doesn't
+ * describe: uninstall would miss it, and a force refresh would refuse it.
+ *
+ * The caller holds the destination's lock, so no other Skillsmith call has
+ * touched it. Another program may have, so only the entry this call placed is
+ * removed; anything else found there is left, and the error says so. Round
+ * 15: `placed` is the staged entry's identity, taken before it was swapped
+ * into place, so a swap after that moment can't pass as this call's write.
+ */
+export declare function undoUnrecordedWrite(toDir: string, cause: unknown, oldLinkTarget: string | undefined, placed: EntryIdentity | null): Promise<void>;
+//# sourceMappingURL=fan-out.cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fan-out.cleanup.d.ts","sourceRoot":"","sources":["../../../src/install/fan-out.cleanup.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAMtE,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAExF;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkBhF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,MAAM,EAAE,aAAa,GAAG,IAAI,GAC3B,OAAO,CAAC,IAAI,CAAC,CAuBf"}

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

@@ -0,0 +1,75 @@
+import * as fsp from 'node:fs/promises';
+import { checkGitAtRoot, gitRefusal } from './fan-out.overwrite.js';
+import { removeIfSame } from './remove-if-same.js';
+function errorText(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * SMI-6529 H3 (round 2) / N6 (round 4): uninstall's teardown of a copy-mode
+ * fan-out (or symlink) Skillsmith created and recorded in the link manifest.
+ *
+ * A recorded copy can later become a real git working tree (the user
+ * `git init`s or clones into that path), so a non-symlink recorded copy with
+ * `.git` at its root is refused: reported and left in place. Symlinks are
+ * just unlinked; what they point at is untouched.
+ *
+ * Returns `{ removed: true }` on a removal, or when the path is already gone,
+ * and `{ removed: false, reason }` on a refusal or a failure, so the caller
+ * keeps the manifest entry and reports it.
+ */
+export async function removeRecordedLink(p) {
+    let stat;
+    try {
+        stat = await fsp.lstat(p);
+    }
+    catch (err) {
+        // Already gone: races with an external editor or uninstall are expected,
+        // and there is nothing left to report. Round 15 (cross-model review): any
+        // other error means we can't tell what is there, so the record is kept.
+        if (err.code === 'ENOENT')
+            return { removed: true };
+        return { removed: false, reason: `${p} could not be checked: ${errorText(err)}` };
+    }
+    if (!stat.isSymbolicLink() && !stat.isFile()) {
+        const refusal = gitRefusal(p, await checkGitAtRoot(p), 'delete');
+        if (refusal)
+            return { removed: false, reason: refusal };
+    }
+    // Remove only the entry checked above.
+    const removal = await removeIfSame(p, stat);
+    return removal.removed ? removal : { removed: false, reason: `${p} ${removal.reason}.` };
+}
+/**
+ * SMI-6529 rounds 10–11: undo addLink's write when its record couldn't be
+ * saved. A fresh destination is removed. A refreshed symlink is put back,
+ * since its existing record still describes it (it was replaced with no
+ * backup). Left as is, either would be a destination the manifest doesn't
+ * describe: uninstall would miss it, and a force refresh would refuse it.
+ *
+ * The caller holds the destination's lock, so no other Skillsmith call has
+ * touched it. Another program may have, so only the entry this call placed is
+ * removed; anything else found there is left, and the error says so. Round
+ * 15: `placed` is the staged entry's identity, taken before it was swapped
+ * into place, so a swap after that moment can't pass as this call's write.
+ */
+export async function undoUnrecordedWrite(toDir, cause, oldLinkTarget, placed) {
+    const fail = (what) => new Error(`addLink: ${errorText(cause)}; this call's unrecorded write could not be undone: ${what}.`, { cause });
+    if (placed === null) {
+        // Round 21 (Opus): the write could not be identified — something replaced
+        // it while it was being created — so nothing here is safe to remove.
+        throw fail(`${toDir} holds a write this call could not identify, since something replaced it while ` +
+            `it was being created, so nothing was removed`);
+    }
+    const removal = await removeIfSame(toDir, placed);
+    if (!removal.removed)
+        throw fail(`${toDir} ${removal.reason}`);
+    if (oldLinkTarget !== undefined) {
+        try {
+            await fsp.symlink(oldLinkTarget, toDir, 'dir');
+        }
+        catch (err) {
+            throw fail(`${toDir} could not be put back as the symlink it was (${errorText(err)})`);
+        }
+    }
+}
+//# sourceMappingURL=fan-out.cleanup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fan-out.cleanup.js","sourceRoot":"","sources":["../../../src/install/fan-out.cleanup.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAA;AAEtE,SAAS,SAAS,CAAC,GAAY;IAC7B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AACzD,CAAC;AAKD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,CAAS;IAChD,IAAI,IAAW,CAAA;IACf,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yEAAyE;QACzE,0EAA0E;QAC1E,wEAAwE;QACxE,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAC9E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,0BAA0B,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAA;IACnF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAChE,IAAI,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IACzD,CAAC;IACD,uCAAuC;IACvC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAC3C,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,CAAA;AAC1F,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAa,EACb,KAAc,EACd,aAAiC,EACjC,MAA4B;IAE5B,MAAM,IAAI,GAAG,CAAC,IAAY,EAAS,EAAE,CACnC,IAAI,KAAK,CACP,YAAY,SAAS,CAAC,KAAK,CAAC,uDAAuD,IAAI,GAAG,EAC1F,EAAE,KAAK,EAAE,CACV,CAAA;IACH,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,0EAA0E;QAC1E,qEAAqE;QACrE,MAAM,IAAI,CACR,GAAG,KAAK,iFAAiF;YACvF,8CAA8C,CACjD,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACjD,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9D,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,GAAG,KAAK,iDAAiD,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACxF,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -1,32 +1,7 @@
 import { type ClientId } from './paths.js';
-export type LinkKind = 'symlink' | 'copy';
-export interface LinkRecord {
-    skillId: string;
-    from: string;
-    to: string;
-    kind: LinkKind;
-    createdAt: string;
-}
-export interface LinkManifest {
-    version: 1;
-    links: LinkRecord[];
-}
-/**
- * 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 declare function getLinkManifestPath(): string;
-/**
- * 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 declare function loadManifest(): Promise<LinkManifest>;
-/**
- * Persist the manifest atomically (write-temp + rename) so a crash mid-write
- * never leaves the file in a partial state.
- */
-export declare function saveManifest(manifest: LinkManifest): Promise<void>;
+import { type LinkRecord } from './fan-out.manifest.js';
+export { getLinkManifestPath, loadManifest, saveManifest } from './fan-out.manifest.js';
+export type { LinkKind, LinkManifest, LinkRecord } from './fan-out.manifest.js';
 export interface AddLinkOptions {
     /** Skill identifier (e.g. `author/name`). Used as the directory name on disk. */
     skillId: string;
@@ -46,6 +21,12 @@ export interface AddLinkResult {
     record: LinkRecord;
     /** True if `preferSymlink` was set but EPERM forced a fallback to copy. */
     fellBackToCopy: boolean;
+    /**
+     * Things to tell the user: hidden backups left by an interrupted refresh
+     * (SMI-6529 round 7), or a corrupt link manifest moved aside (round 9).
+     * Omitted when none.
+     */
+    warnings?: string[];
 }
 /**
  * Create a fan-out link from one client's skill directory into another's.
@@ -58,14 +39,43 @@ export interface AddLinkResult {
  *   `~/.skillsmith/links/manifest.json` so uninstall can tear it down.
  */
 export declare function addLink(opts: AddLinkOptions): Promise<AddLinkResult>;
+/** Result of {@link removeLinks} — see N6's doc comment on `removeRecordedLink`. */
+export interface RemoveLinksResult {
+    /** Count of destinations actually removed from disk. */
+    removed: number;
+    /**
+     * Destinations refused (left in place, e.g. N6's `.git`-at-root guard, or
+     * a removal error) — each entry stays in the manifest so a future
+     * `removeLinks` call retries it, and callers should surface `reason` to
+     * the user rather than silently discarding it.
+     */
+    refused: Array<{
+        to: string;
+        reason: string;
+    }>;
+    /**
+     * Things to tell the user: hidden backups left by an interrupted refresh
+     * (SMI-6529 round 7), a corrupt link manifest moved aside (round 9), or a
+     * manifest this uninstall couldn't use (round 11). Omitted when none.
+     */
+    warnings?: string[];
+}
 /**
- * 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 declare function removeLinks(skillId: string): Promise<number>;
+export declare function removeLinks(skillId: string): Promise<RemoveLinksResult>;
 /**
  * List all fan-out links for a skill (or all skills when `skillId` is
  * undefined). Read-only — for `skillsmith list --client X` and the

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

@@ -1 +1 @@
-{"version":3,"file":"fan-out.d.ts","sourceRoot":"","sources":["../../../src/install/fan-out.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAyC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGjF,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,QAAQ,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAA;IACV,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAY1D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAYxE;AAED,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,UAAU,EAAE,QAAQ,CAAA;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,QAAQ,CAAA;IAClB,iFAAiF;IACjF,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAA;IAClB,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAA;CACxB;AAuED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAiE1E;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAIvE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,QAAQ,CAE/C"}
+{"version":3,"file":"fan-out.d.ts","sourceRoot":"","sources":["../../../src/install/fan-out.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAyC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAA;AASjF,OAAO,EAQL,KAAK,UAAU,EAEhB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACvF,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAE/E,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,UAAU,EAAE,QAAQ,CAAA;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,QAAQ,CAAA;IAClB,iFAAiF;IACjF,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAA;IAClB,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAoED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA6H1E;AAED,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAkDD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgD7E;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAIvE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,QAAQ,CAE/C"}