@skaile/workspaces 5.19.0 → 6.1.0

package/dist/{chunk-MRHVPQNO.js → chunk-HWNK3F3X.js}

@@ -1,22 +1,23 @@
-import { unregisteredLibraryNames, renamedLibraryName, resolveConfig, RemoteCatalogSource, OfflineError, describeCatalogError, CatalogHttpError, scanUnlistedAssets, missingRootAssets, storeManifestFile, missingLibraryDirMessage, filesEntryPaths } from './chunk-XM6T2AZ2.js';
-import { SEMVER_RE, invalidSemverMessage, flowFileNameError, readManifestSourceConfig, discoverAssetsInTree, isManifestMode } from './chunk-I37INEWE.js';
-import { parseFlowDefinition } from './chunk-X3RMRJNR.js';
-import { installTargetOf, readKeptLegacyCopies, writeKeptLegacyCopies, canonicalEntryRef, diffDeployedAgent, deployedAssetDrift, assertNoLibrarySymlinks, deployAll, removeAsset, createScaffold, installAgent } from './chunk-JTOWA6RS.js';
+import { unregisteredLibraryNames, renamedLibraryName, resolveConfig, RemoteCatalogSource, OfflineError, describeCatalogError, CatalogHttpError, scanUnlistedAssets, missingRootAssets, storeManifestFile, missingLibraryDirMessage, filesEntryPaths, lastLibraryName } from './chunk-S2XHGWQC.js';
+import { SEMVER_RE, invalidSemverMessage, flowFileNameError, computeDeterministicHash, readManifestSourceConfig, discoverAssetsInTree, isManifestMode } from './chunk-UI745XC3.js';
+import { parseFlowDefinition } from './chunk-JRN5QF4C.js';
+import { installTargetOf, readKeptLegacyCopies, writeKeptLegacyCopies, canonicalEntryRef, diffDeployedAgent, deployedAssetDrift, assertNoLibrarySymlinks, deployAll, removeAsset, sourceComposedFiles, cachedComposedFiles, createScaffold, installAgent } from './chunk-NUA33BYO.js';
 import { appendHistory, getRecentHistory, clearHistory } from './chunk-KTBKW2FI.js';
 import { commitChanges } from './chunk-UQ6LFBPZ.js';
-import { driverTargetSupportsAgents, CODEX_IDENTITY_DIR } from './chunk-C7WBGSBV.js';
-import { isScaffoldBody, isScaffoldDescription } from './chunk-335ENCCS.js';
-import { resolveConfiguredDriverTarget, GLOBAL_INSTALL_DIR_NAME, resolveLibraryDir, buildLibraryLockEntries, writeLock, computeHash, buildLockFile, readLock, assertLockHashes, verifyLock, mergeLockFile, resyncLockSources, extractForPatch, generatePatch, savePatch, applyPatch, LOCK_SCHEMA_VERSION } from './chunk-N46LQR46.js';
-import { resolveRuntimeAssets, factoryAssetRoots } from './chunk-TIIXG3PN.js';
-import { deployedBase, isDeployed, deployedPaths, deployedDir } from './chunk-5TBFN46Z.js';
-import { resolveSkWorkspaceConfig, effectiveAgentInstances, loadMcpServerDeclarations, resolveGlobalHarnesses, resolveGlobalSkWorkspaceConfig, getGlobalCacheDir, sourceCacheKey, getRepoCommit, matchPin, buildProvenanceIndex, coerceVersion, sourceShortName, readLinks, isCommitOnRemote, resolveAll, agentSourceCacheDir, ensureRepo, scanRepo, SKAILE_YAML_DEFAULT, checkRepoStatus, resolveAgentDefinitionDir, resolveAsset, MAX_PRESET_DEPTH, PresetDepthError, DEFAULT_AGENT_INSTANCE_ID } from './chunk-V257LUBM.js';
+import { harnessTargetSupportsAgents, CODEX_IDENTITY_DIR } from './chunk-ABFPSVIS.js';
+import { isScaffoldBody, isScaffoldDescription } from './chunk-E572OHGY.js';
+import { resolveConfiguredHarnessName, GLOBAL_INSTALL_DIR_NAME, resolveLibraryDir, buildLibraryLockEntries, writeLock, computeHash, buildLockFile, readLock, assertLockHashes, verifyLock, mergeLockFile, resyncLockSources, extractForPatch, generatePatch, savePatch, applyPatch, LOCK_SCHEMA_VERSION } from './chunk-VMVDAZLA.js';
+import { resolveRuntimeAssets, factoryAssetRoots } from './chunk-ZDLUQLI6.js';
+import { deployedBase, isDeployed, deployedPaths, deployedDir } from './chunk-5KRMNUL4.js';
+import { resolveSkWorkspaceConfig, effectiveAgentInstances, mcpDeclarationFromMdContent, loadMcpServerDeclarations, resolveGlobalHarnesses, resolveGlobalSkWorkspaceConfig, getGlobalCacheDir, sourceCacheKey, getRepoCommit, matchPin, buildProvenanceIndex, coerceVersion, sourceShortName, readLinks, isCommitOnRemote, findWorkspaceRoot, resolveAll, agentSourceCacheDir, ensureRepo, resolveAgentDefinitionDir, scanRepo, SKAILE_YAML_DEFAULT, checkRepoStatus, resolveAsset, MAX_PRESET_DEPTH, PresetDepthError, DEFAULT_AGENT_INSTANCE_ID } from './chunk-ZHGKAZJ7.js';
 import { globalSkaileDir, globalCacheRoot, migrateLegacyDir } from './chunk-L5VSIPQD.js';
-import { DRIVER_TARGETS, SUPPORTED_DRIVER_TARGETS } from './chunk-IG5LZ3WU.js';
-import { loadSkPublishManifest, listAssetFiles, isNonAssetDir, isNonAssetFile } from './chunk-UQ33Y4DM.js';
-import { scanDirectory, parseFrontmatter, parseRequires, dedupeRequirements, readAssetBody } from './chunk-GOCWM7FN.js';
-import { parseAssetRef, parseAssetRefLoose, assetRefToStr, slugifyAssetName, depToStr, parseDep } from './chunk-WDXZA7QW.js';
+import { HARNESS_TARGETS, SUPPORTED_HARNESSES } from './chunk-VTETQCR6.js';
+import { listAssetFiles, loadSkPublishManifest, decodeSkaileManifest, isNonAssetDir, isNonAssetFile } from './chunk-ZBHZLWV3.js';
+import { scanDirectory, parseFrontmatter, parseRequires, dedupeRequirements, readAssetBody } from './chunk-RHN5MRQO.js';
+import { parseAssetRef, parseAssetRefLoose, assetRefToStr, slugifyAssetName, depToStr, parseDep } from './chunk-LSSYC5IC.js';
 import { spawnSync } from 'child_process';
-import { existsSync, rmSync, readFileSync, readdirSync, lstatSync, writeFileSync, unlinkSync, mkdirSync } from 'fs';
+import { existsSync, rmSync, readFileSync, writeFileSync, readdirSync, lstatSync, statSync, unlinkSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
 import path, { resolve, dirname, sep, join, relative, posix } from 'path';
 import { gt } from 'semver';
 import { parse, stringify } from 'yaml';
@@ -40,8 +41,8 @@ function writeLedger(projectDir, ledger) {
   writeFileSync(p, `${JSON.stringify(ledger, null, 2)}
 `, "utf-8");
 }
-function renderedInstanceFiles(projectDir, driverTarget) {
-  const recorded = readLedger(projectDir).targets[driverTarget];
+function renderedInstanceFiles(projectDir, harness) {
+  const recorded = readLedger(projectDir).targets[harness];
   if (!recorded) return [];
   let instances;
   try {
@@ -51,11 +52,11 @@ function renderedInstanceFiles(projectDir, driverTarget) {
   }
   return Object.entries(instances).filter(([id]) => recorded[id]?.length).map(([id, instance]) => ({ id, ref: instance.ref, files: recorded[id] }));
 }
-function instanceRenderedAgentNames(projectDir, driverTarget) {
+function instanceRenderedAgentNames(projectDir, harness) {
   const names = /* @__PURE__ */ new Set();
-  if (!driverTargetSupportsAgents(driverTarget)) return names;
-  const agentDir = resolve(deployedBase("agent", driverTarget, false, projectDir));
-  for (const files of Object.values(readLedger(projectDir).targets[driverTarget] ?? {})) {
+  if (!harnessTargetSupportsAgents(harness)) return names;
+  const agentDir = resolve(deployedBase("agent", harness, false, projectDir));
+  for (const files of Object.values(readLedger(projectDir).targets[harness] ?? {})) {
     for (const rel of files) {
       const abs = resolve(projectDir, rel);
       if (!abs.startsWith(agentDir + sep)) continue;
@@ -80,8 +81,8 @@ function bindInstance(projectDir, id, instance) {
   }
   return { srcDir, errors };
 }
-function unboundAgentInstances(projectDir, driverTarget) {
-  if (!driverTargetSupportsAgents(driverTarget)) return [];
+function unboundAgentInstances(projectDir, harness) {
+  if (!harnessTargetSupportsAgents(harness)) return [];
   let instances;
   try {
     instances = effectiveAgentInstances(resolveSkWorkspaceConfig(projectDir));
@@ -96,16 +97,16 @@ function unboundAgentInstances(projectDir, driverTarget) {
   return out;
 }
 function removeAgentInstanceRenderings(opts) {
-  const { projectDir, driverTarget, ids } = opts;
-  if (!driverTargetSupportsAgents(driverTarget) || ids.length === 0) return [];
+  const { projectDir, harness, ids } = opts;
+  if (!harnessTargetSupportsAgents(harness) || ids.length === 0) return [];
   const ledger = readLedger(projectDir);
-  const previous = ledger.targets[driverTarget];
+  const previous = ledger.targets[harness];
   if (!previous) return [];
   const gone = new Set(ids);
   const claimed = new Set(
     Object.entries(previous).filter(([id]) => !gone.has(id)).flatMap(([, files]) => files)
   );
-  const agentDeployDir = deployedBase("agent", driverTarget, false, projectDir);
+  const agentDeployDir = deployedBase("agent", harness, false, projectDir);
   const removable = [resolve(agentDeployDir), resolve(dirname(agentDeployDir), CODEX_IDENTITY_DIR)];
   const root = resolve(projectDir);
   const removed = [];
@@ -120,28 +121,28 @@ function removeAgentInstanceRenderings(opts) {
   }
   const owned = Object.fromEntries(Object.entries(previous).filter(([id]) => !gone.has(id)));
   const nextTargets = { ...ledger.targets };
-  if (Object.keys(owned).length > 0) nextTargets[driverTarget] = owned;
-  else delete nextTargets[driverTarget];
+  if (Object.keys(owned).length > 0) nextTargets[harness] = owned;
+  else delete nextTargets[harness];
   if (JSON.stringify(nextTargets) !== JSON.stringify(ledger.targets)) {
     writeLedger(projectDir, { version: 1, targets: nextTargets });
   }
   return removed;
 }
 function installAgentInstances(opts) {
-  const { projectDir, driverTarget, log } = opts;
+  const { projectDir, harness, log } = opts;
   const result = {
     instances: [],
     removed: [],
     warnings: [],
     errors: []
   };
-  if (!driverTargetSupportsAgents(driverTarget)) return result;
+  if (!harnessTargetSupportsAgents(harness)) return result;
   const wsConfig = opts.wsConfig ?? resolveSkWorkspaceConfig(projectDir);
   const instances = effectiveAgentInstances(wsConfig);
-  const agentDeployDir = deployedBase("agent", driverTarget, false, projectDir);
-  const skillsRelDir = DRIVER_TARGETS[driverTarget]?.local.skill ?? "";
+  const agentDeployDir = deployedBase("agent", harness, false, projectDir);
+  const skillsRelDir = HARNESS_TARGETS[harness]?.local.skill ?? "";
   const ledger = readLedger(projectDir);
-  const previous = ledger.targets[driverTarget] ?? {};
+  const previous = ledger.targets[harness] ?? {};
   const owned = {};
   for (const [id, instance] of Object.entries(instances)) {
     const { srcDir, errors } = bindInstance(projectDir, id, instance);
@@ -154,7 +155,7 @@ function installAgentInstances(opts) {
       srcDir,
       agentDeployDir,
       projectDir,
-      driverTarget,
+      harness,
       skillsRelDir,
       id,
       /* includeSubAgents */
@@ -180,8 +181,8 @@ function installAgentInstances(opts) {
     result.removed.push(rel);
   }
   const nextTargets = { ...ledger.targets };
-  if (Object.keys(owned).length > 0) nextTargets[driverTarget] = owned;
-  else delete nextTargets[driverTarget];
+  if (Object.keys(owned).length > 0) nextTargets[harness] = owned;
+  else delete nextTargets[harness];
   if (JSON.stringify(nextTargets) !== JSON.stringify(ledger.targets)) {
     writeLedger(projectDir, { version: 1, targets: nextTargets });
   }
@@ -497,12 +498,12 @@ function canonicalJson(value) {
 function entryHash(entry) {
   return createHash("sha256").update(canonicalJson(entry)).digest("hex");
 }
-async function mcpServerDrift(projectDir, driverTarget, opts = {}) {
-  const relConfig = TARGET_MCP_CONFIG[driverTarget];
+async function mcpServerDrift(projectDir, harnessTarget, opts = {}) {
+  const relConfig = TARGET_MCP_CONFIG[harnessTarget];
   if (!relConfig) return [];
   const declarations = opts.declarations ?? await loadMcpServerDeclarations(projectDir);
-  const skippedNow = await readNotedSkips(projectDir, driverTarget);
-  const ledger = await readManaged(projectDir, driverTarget);
+  const skippedNow = await readNotedSkips(projectDir, harnessTarget);
+  const ledger = await readManaged(projectDir, harnessTarget);
   const managed = new Set(ledger.ids);
   let servers = {};
   try {
@@ -595,13 +596,21 @@ function requiredFieldsAdvice(id, keys) {
   const setting = keys.map((k) => `${k}: env:${k}`).join(", ");
   return `needs ${keys.join(", ")} (required): set it with an mcp_servers entry (id: ${id}, env: ${setting}) in skaile.yaml and export the variable, then run skaile install`;
 }
-function mcpConfigFileOf(driverTarget) {
-  return TARGET_MCP_CONFIG[driverTarget];
+function mcpNotRunnableReason(mdContent, name) {
+  try {
+    const decl = mcpDeclarationFromMdContent(mdContent, name);
+    return decl ? skipReason(decl) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function mcpConfigFileOf(harnessTarget) {
+  return TARGET_MCP_CONFIG[harnessTarget];
 }
-async function mcpRenderedFootprint(projectDir, driverTarget, name) {
-  const relConfig = TARGET_MCP_CONFIG[driverTarget];
+async function mcpRenderedFootprint(projectDir, harnessTarget, name) {
+  const relConfig = TARGET_MCP_CONFIG[harnessTarget];
   if (!relConfig) return void 0;
-  const ledger = await readManaged(projectDir, driverTarget);
+  const ledger = await readManaged(projectDir, harnessTarget);
   if (!ledger.ids.includes(name)) return void 0;
   const dir = payloadDir(projectDir, name);
   let hasPayload = false;
@@ -616,15 +625,47 @@ async function mcpRenderedFootprint(projectDir, driverTarget, name) {
     ...dir && hasPayload ? { payloadDir: `${path.relative(projectDir, dir).split(path.sep).join("/")}/` } : {}
   };
 }
-async function renderMcpServerConfig(projectDir, driverTarget, opts) {
+async function mcpCommittedRenderIntact(projectDir, harnessTarget, name) {
+  const relConfig = TARGET_MCP_CONFIG[harnessTarget];
+  if (!relConfig) return false;
+  if ((await readNotedSkips(projectDir, harnessTarget))[name] !== void 0) return true;
+  let ledger;
+  let servers;
+  try {
+    ledger = await readManaged(projectDir, harnessTarget);
+    const file = await readJsonStrict(path.join(projectDir, relConfig));
+    servers = file?.mcpServers ?? {};
+  } catch {
+    return false;
+  }
+  if (!Object.hasOwn(servers, name)) return false;
+  const entry = servers[name];
+  const recorded = ledger.ids.includes(name) ? ledger.rendered[name] : void 0;
+  if (recorded !== void 0 && entryHash(entry) !== recorded) return false;
+  const e = entry ?? {};
+  const strings = [e.command, ...Array.isArray(e.args) ? e.args : []].filter(
+    (v) => typeof v === "string"
+  );
+  for (const v of strings) {
+    const at = v.indexOf(".skaile/assets/");
+    if (at < 0) continue;
+    try {
+      await fs.stat(path.join(projectDir, v.slice(at)));
+    } catch {
+      return false;
+    }
+  }
+  return true;
+}
+async function renderMcpServerConfig(projectDir, harnessTarget, opts) {
   const warn = opts?.warn ?? ((m) => console.warn(`skaile: ${m}`));
-  const relConfig = TARGET_MCP_CONFIG[driverTarget];
+  const relConfig = TARGET_MCP_CONFIG[harnessTarget];
   if (!relConfig) return { written: false, servers: [], removed: [], skipped: [] };
   const configPath = path.join(projectDir, relConfig);
   const declarations = await loadMcpServerDeclarations(projectDir);
   const skipped = [];
   const renderable = /* @__PURE__ */ new Map();
-  const noted = await readNotedSkips(projectDir, driverTarget);
+  const noted = await readNotedSkips(projectDir, harnessTarget);
   for (const decl of declarations) {
     const reason = skipReason(decl) ?? await ensurePayload(projectDir, decl, opts?.fetchPayload ?? defaultFetchPayload);
     if (reason) {
@@ -636,8 +677,8 @@ async function renderMcpServerConfig(projectDir, driverTarget, opts) {
     }
     renderable.set(decl.id, buildEntry(decl));
   }
-  await writeNotedSkips(projectDir, driverTarget, noted, skipped);
-  const ledger = await readManaged(projectDir, driverTarget);
+  await writeNotedSkips(projectDir, harnessTarget, noted, skipped);
+  const ledger = await readManaged(projectDir, harnessTarget);
   const managedIds = ledger.ids;
   const existingFile = await readJsonStrict(configPath);
   if (renderable.size === 0 && managedIds.length === 0 && !existingFile) {
@@ -660,7 +701,7 @@ async function renderMcpServerConfig(projectDir, driverTarget, opts) {
   }
   const rendered = Object.fromEntries(owned.map((id) => [id, entryHash(next[id])]));
   const ledgerStale = JSON.stringify(owned) !== JSON.stringify(managedIds) || canonicalJson(rendered) !== canonicalJson(ledger.rendered);
-  if (ledgerStale) await writeManaged(projectDir, driverTarget, { ids: owned, rendered });
+  if (ledgerStale) await writeManaged(projectDir, harnessTarget, { ids: owned, rendered });
   if (Object.keys(next).length === 0 && !existingFile) {
     return { path: configPath, written: false, servers: owned, removed, skipped };
   }
@@ -839,6 +880,16 @@ function libraryDiskHashes(libPath, cache, registry) {
   }
   return hashes;
 }
+function repoManifestVersion(repoDir) {
+  try {
+    const { manifest } = decodeSkaileManifest(
+      readFileSync(join(repoDir, "skaile.manifest.yaml"), "utf8")
+    );
+    return manifest.version || void 0;
+  } catch {
+    return void 0;
+  }
+}
 function manifestFileHasAssetsArray(libPath) {
   try {
     const doc = parse(readFileSync(join(libPath, "skaile.manifest.yaml"), "utf8"));
@@ -847,6 +898,10 @@ function manifestFileHasAssetsArray(libPath) {
     return false;
   }
 }
+var libraryAssetCheck;
+function setLibraryAssetCheck(check) {
+  libraryAssetCheck = check;
+}
 function isUnlistedLibraryAsset(entry, libPath) {
   const manifest = loadSkPublishManifest(libPath);
   const listed = manifest?.assets ?? [];
@@ -1117,7 +1172,9 @@ function relockedRefs(prev, next) {
     e.library?.version ?? "",
     e.library && !e.library.installed ? e.library.name : "",
     e.library?.sha256 ?? e.sha256,
-    key.includes("#0.0.0-sha.") ? "" : e.source?.commit ?? ""
+    key.includes("#0.0.0-sha.") ? "" : e.source?.commit ?? "",
+    // The `../` compose folders are part of the lock: `update` moving them is a re-lock.
+    (e.composed ?? []).map((f) => `${f.path}:${f.sha256}`).join("\n")
   ].join("\0");
   const out = [];
   for (const [key, entry] of Object.entries(next.assets)) {
@@ -1152,9 +1209,13 @@ function libraryMoves(prev, next) {
   }
   return out;
 }
+function unregisteredLibraryName(origin) {
+  return lastLibraryName(origin.name) ?? origin.name;
+}
 function unregisteredLibraryFix(origin, ref) {
-  const register = origin.url ? `\`skaile library init ${origin.name} --git ${origin.url}\` (no registered library has the remote ${origin.url} either)` : `\`skaile library init ${origin.name} --path <dir>\``;
-  return `register library "${origin.name}" again with ${register}, or drop the dependency with \`skaile remove ${ref}\``;
+  const name = unregisteredLibraryName(origin);
+  const register = origin.url ? `\`skaile library init ${name} --git ${origin.url}\` (no registered library has the remote ${origin.url} either)` : `\`skaile library init ${name} --path <dir>\``;
+  return `register library "${name}" again with ${register}, or drop the dependency with \`skaile remove ${ref}\``;
 }
 function declaredNoHolderReason(ref) {
   return `is declared but no library or source holds it \u2014 register the library that holds it with \`skaile library init <name> --path <dir>\`, or drop it with \`skaile remove ${ref.split("#")[0]}\``;
@@ -1180,7 +1241,7 @@ function libraryCollisionSummary(all) {
   return `${all.length} assets exist in several libraries (${libraries.join(", ")}); using ${usedText.join(", ")}. Highest version wins; an equal version goes to the default library, then by name. ` + (differing.length > 0 ? `Same version, different bytes for: ${differing.join(", ")}. ` : "") + "Pin a version (<ref>#<version>) to choose another; `--verbose` lists each asset.";
 }
 function lockedLibraryProblem(lookup, origin, ref) {
-  return lookup.state === "dir-missing" ? missingLibraryDirMessage({ name: origin.name, path: lookup.path }) : `library "${origin.name}" is not registered \u2014 renamed or removed? ${unregisteredLibraryFix(origin, ref)}`;
+  return lookup.state === "dir-missing" ? missingLibraryDirMessage({ name: origin.name, path: lookup.path }) : `library "${unregisteredLibraryName(origin)}" is not registered \u2014 renamed or removed? ${unregisteredLibraryFix(origin, ref)}`;
 }
 function gapIdentity(ref) {
   const p = parseRefTolerant(ref);
@@ -1293,7 +1354,7 @@ function decodeEntryHarnesses(value) {
   for (const [key, list] of Object.entries(value)) {
     if (!Array.isArray(list)) continue;
     const valid = list.filter(
-      (h) => SUPPORTED_DRIVER_TARGETS.includes(h)
+      (h) => SUPPORTED_HARNESSES.includes(h)
     );
     if (valid.length > 0) out[key] = [...new Set(valid)];
   }
@@ -1302,8 +1363,8 @@ function decodeEntryHarnesses(value) {
 var AssetManager = class {
   /** Resolved absolute path to the workspace root. */
   projectDir;
-  /** Agent framework driver target used for all deploy operations. */
-  driverTarget;
+  /** Harness all deploy operations target (a `HarnessName`). */
+  harness;
   /** Whether this instance operates in global-install mode. */
   global;
   /** Asset-kind registry shared with the host (one instance per process). */
@@ -1344,7 +1405,7 @@ var AssetManager = class {
     this.projectDir = resolve(opts.projectDir);
     this.global = opts.global ?? false;
     this.registry = opts.registry;
-    this.driverTarget = opts.driverTarget ?? (this.global ? void 0 : resolveConfiguredDriverTarget(this.projectDir)) ?? "claude-code";
+    this.harness = opts.harness ?? (this.global ? void 0 : resolveConfiguredHarnessName(this.projectDir)) ?? "claude-code";
     this.harnessesOverride = opts.harnesses ?? opts.backends;
     this.injectedStoreFetcher = opts.storeFetcher;
     this.injectedAssetFetcher = opts.assetFetcher;
@@ -1369,7 +1430,7 @@ var AssetManager = class {
   /**
    * Root for this manager's **state** — config SSOT, lock, cache, history.
    * `~/.skaile` in global mode (the cross-harness SSOT), else the project dir.
-   * Deploy dirs are unaffected; they come from `DRIVER_TARGETS[target]`.
+   * Deploy dirs are unaffected; they come from `HARNESS_TARGETS[target]`.
    */
   get stateRoot() {
     return this.global ? globalSkaileDir() : this.projectDir;
@@ -1379,11 +1440,11 @@ var AssetManager = class {
    * filter), else the explicit `global_harnesses:` of `~/.skaile/skaile.yaml`, else every harness
    * whose root dir exists under `~` plus the harness the project is configured for (a project on
    * a harness whose dir does not exist yet still gets its user-scope assets). In project mode
-   * this is exactly `[driverTarget]`, so the shared fan-out loop degenerates to the
+   * this is exactly `[harness]`, so the shared fan-out loop degenerates to the
    * single-target path.
    */
   targetHarnesses() {
-    if (!this.global) return [this.driverTarget];
+    if (!this.global) return [this.harness];
     if (this.harnessesOverride && this.harnessesOverride.length > 0) return this.harnessesOverride;
     return this.defaultGlobalHarnesses();
   }
@@ -1391,7 +1452,7 @@ var AssetManager = class {
   defaultGlobalHarnesses() {
     const resolved = resolveGlobalHarnesses();
     if (resolveGlobalSkWorkspaceConfig().global_harnesses?.length) return resolved;
-    const configured = resolveConfiguredDriverTarget(this.projectDir);
+    const configured = resolveConfiguredHarnessName(this.projectDir);
     return configured && !resolved.includes(configured) ? [...resolved, configured] : resolved;
   }
   /**
@@ -1429,6 +1490,43 @@ var AssetManager = class {
       return !recorded || recorded.includes(target);
     });
   }
+  /**
+   * A 5.12.0 global record has no `global_asset_harnesses:` key, yet `add --global --harness`
+   * wrote one copy only. On the first global `install`, an entry with exactly one existing copy
+   * among several default harnesses is that harness's subset (OQ6): record it, so the install
+   * does not fan the asset out to harnesses the user never asked for (p1442). A copy under the
+   * 5.12.0 omp folder (`~/.omp/skills`) counts as an omp copy. Nothing is inferred once the key
+   * exists (an entry without a row then means "every harness"), with one default harness, or
+   * with no copy yet. Global mode only; returns the rows written.
+   */
+  inferLegacyHarnessSubsets(entries) {
+    if (!this.global) return [];
+    const configPath = join(this.stateRoot, "skaile.yaml");
+    if (!existsSync(configPath)) return [];
+    let raw;
+    try {
+      raw = parse(readFileSync(configPath, "utf8"));
+    } catch {
+      return [];
+    }
+    if (!raw || typeof raw !== "object" || ENTRY_HARNESSES_KEY in raw) return [];
+    const all = this.defaultGlobalHarnesses();
+    if (all.length < 2) return [];
+    const rows = [];
+    for (const e of entries) {
+      const component = this.installTarget(e.kind);
+      if (!component || !e.name) continue;
+      const holding = all.filter(
+        (h) => isDeployed(component, e.name, h, true) || h === "omp" && legacyOmpPaths(component, e.name).length > 0
+      );
+      if (holding.length !== 1) continue;
+      const publisher = e.publisher?.replace(/^@/, "");
+      const ref = `${e.kind}:${publisher ? `@${publisher}/` : ""}${e.name}`;
+      if (this.setEntryHarnessRow(raw, ref, holding)) rows.push({ ref, harnesses: holding });
+    }
+    if (rows.length > 0) writeFileSync(configPath, stringify(raw, { lineWidth: 120 }));
+    return rows;
+  }
   /**
    * Set (or, with `harnesses` undefined, clear) the harness row of `ref` in the parsed
    * `~/.skaile/skaile.yaml` `raw`. Returns whether `raw` changed.
@@ -1520,7 +1618,7 @@ var AssetManager = class {
     return this.legacyCopiesRemoved.splice(0);
   }
   /**
-   * The harnesses `add` / `install` deploy into: `[driverTarget]` for a project, the global
+   * The harnesses `add` / `install` deploy into: `[harness]` for a project, the global
    * harness set (see {@link AssetManager.targetHarnesses}) for a global manager.
    */
   deployTargets() {
@@ -1554,18 +1652,38 @@ var AssetManager = class {
   get patchDir() {
     return join(this.projectDir, ".skaile", "patches");
   }
-  /** Deploy options for one harness. In global mode, `driverTarget` is the
-   * fan-out target (not the constructor's `driverTarget`, which is project-only). */
-  deployOptsFor(target, link, onSecretFile) {
+  /** Deploy options for one harness. In global mode, `harness` is the
+   * fan-out target (not the constructor's `harness`, which is project-only). */
+  deployOptsFor(target, link, onSecretFile, composed) {
+    const records = this.global ? void 0 : this.composedRecords();
     return {
       registry: this.registry,
-      driverTarget: target,
+      harness: target,
       global: this.global,
       cwd: this.projectDir,
       link: link === true,
-      ...onSecretFile ? { onSecretFile: (entry, p) => onSecretFile(canonicalEntryRef(entry), p) } : {}
+      ...onSecretFile ? { onSecretFile: (entry, p) => onSecretFile(canonicalEntryRef(entry), p) } : {},
+      ...records ? { lockedComposed: (agent) => records.get(agent) } : {},
+      ...composed ? {
+        refreshComposed: composed.refresh,
+        onComposedDrift: (entry, ref) => composed.onDrift(canonicalEntryRef(entry), ref)
+      } : {}
     };
   }
+  /** Agent name → the `../` compose folder files its lock entry records (`LockEntry.composed`). */
+  composedRecords() {
+    const out = /* @__PURE__ */ new Map();
+    for (const [key, entry] of Object.entries(this.tryReadLock()?.assets ?? {})) {
+      if (!entry.composed?.length) continue;
+      const { name } = parseCanonicalLockKey(key);
+      if (name) out.set(name, entry.composed);
+    }
+    return out;
+  }
+  /** `install`'s `Missing:` line for a `../` compose folder the library moved past the lock. */
+  composedDriftLine(agentRef, composeRef) {
+    return `${agentRef} (composes ${composeRef}: the library's copy changed since the lock; \`skaile update\` moves the lock to it)`;
+  }
   /**
    * Names of the `mcp-server` assets the lock holds (the declaration ids, unscoped); a missing
    * `.mcp.json` entry of one counts as drift even before skaile owned it.
@@ -1588,7 +1706,7 @@ var AssetManager = class {
     if (locked.size === 0) return [];
     let rows;
     try {
-      rows = await mcpServerDrift(this.projectDir, this.driverTarget, { locked });
+      rows = await mcpServerDrift(this.projectDir, this.harness, { locked });
     } catch {
       return [];
     }
@@ -1616,13 +1734,9 @@ var AssetManager = class {
    */
   async mcpRenderFootprint(name) {
     if (this.global) return void 0;
-    const file = mcpConfigFileOf(this.driverTarget);
+    const file = mcpConfigFileOf(this.harness);
     if (!file) return void 0;
-    const footprint = await mcpRenderedFootprint(
-      this.projectDir,
-      this.driverTarget,
-      unscopedName(name)
-    );
+    const footprint = await mcpRenderedFootprint(this.projectDir, this.harness, unscopedName(name));
     return footprint ? { ...footprint, written: true } : { file, written: false };
   }
   /**
@@ -1634,11 +1748,11 @@ var AssetManager = class {
    */
   async mcpPendingRender() {
     if (this.global) return [];
-    const file = mcpConfigFileOf(this.driverTarget);
+    const file = mcpConfigFileOf(this.harness);
     if (!file) return [];
     let rows;
     try {
-      rows = await mcpServerDrift(this.projectDir, this.driverTarget, {
+      rows = await mcpServerDrift(this.projectDir, this.harness, {
         locked: this.lockedMcpNames()
       });
     } catch {
@@ -1652,7 +1766,7 @@ var AssetManager = class {
     });
   }
   /**
-   * Render the project's declared MCP servers into the driver target's own
+   * Render the project's declared MCP servers into the harness target's own
    * native MCP config (`<project>/.mcp.json` for `claude-code`), so the coding
    * agent sees the same servers skaile's agent loop wires up.
    *
@@ -1665,14 +1779,14 @@ var AssetManager = class {
    *   removed) because they had drifted from the declaration: `install` names them, as it does
    *   a restored skill file.
    */
-  async renderDriverMcpConfig() {
+  async renderHarnessMcpConfig() {
     if (this.global) return [];
     const before = await this.mcpDriftRows();
     try {
-      await renderMcpServerConfig(this.projectDir, this.driverTarget);
+      await renderMcpServerConfig(this.projectDir, this.harness);
     } catch (err) {
       console.warn(
-        `skaile: could not render MCP config for ${this.driverTarget}: ${err instanceof Error ? err.message : String(err)}`
+        `skaile: could not render MCP config for ${this.harness}: ${err instanceof Error ? err.message : String(err)}`
       );
       return [];
     }
@@ -1696,7 +1810,7 @@ var AssetManager = class {
     return restored;
   }
   /**
-   * Render every agent instance of `skaile.yaml` into the driver target's native
+   * Render every agent instance of `skaile.yaml` into the harness target's native
    * agent files (`.claude/agents/<id>.md`, …) and prune the renderings of
    * instances that left the config. Runs after the skills deploy, so composed
    * skills resolve. Project scope only. An instance whose `ref` resolves to no agent is
@@ -1707,10 +1821,10 @@ var AssetManager = class {
     try {
       const result = installAgentInstances({
         projectDir: this.projectDir,
-        driverTarget: this.driverTarget
+        harness: this.harness
       });
       const details = [];
-      for (const u of unboundAgentInstances(this.projectDir, this.driverTarget)) {
+      for (const u of unboundAgentInstances(this.projectDir, this.harness)) {
         if (!u.ref.startsWith("agent:")) continue;
         const at = result.errors.findIndex((e) => e.startsWith(`agent instance "${u.id}":`));
         if (at < 0) continue;
@@ -1727,7 +1841,7 @@ var AssetManager = class {
       };
     } catch (err) {
       console.warn(
-        `skaile: could not render agent instances for ${this.driverTarget}: ${err instanceof Error ? err.message : String(err)}`
+        `skaile: could not render agent instances for ${this.harness}: ${err instanceof Error ? err.message : String(err)}`
       );
       return {};
     }
@@ -1770,6 +1884,15 @@ var AssetManager = class {
     for (const [slug, decl] of Object.entries(repositories)) {
       const localPath = this.resolveRepoDir(decl, slug);
       if (!localPath || !existsSync(localPath)) continue;
+      if (decl.url && normalizeRepoUrl(decl.url) !== normalizeRepoUrl(FACTORY_SOURCE_URL) && !existsSync(join(localPath, ".git"))) {
+        this.reportSourceError(
+          { localPath, sourceUrl: decl.url, commit: "" },
+          new Error(
+            `${decl.url}: its clone ${localPath} is not a git repository, so git pull fails - run \`skaile source sync\` to clone it again`
+          )
+        );
+        continue;
+      }
       const commit = getRepoCommit(localPath) ?? "0".repeat(40);
       clones.push({
         localPath,
@@ -2093,6 +2216,33 @@ var AssetManager = class {
     if (!scan) return [];
     return [...scan.byKey.values()].flat();
   }
+  /**
+   * The version `add` deploys for each asset of a source clone registered as a `reader`
+   * library, when its file declares none: the repo commit pseudo-version (p855). `search`
+   * reads this where no project is in scope, so it lists what `add` locks, not the index
+   * default.
+   *
+   * @returns `<library>\0<kind>:@<publisher>/<name>` -> version; only assets that declare none.
+   */
+  async sourceAssetVersions() {
+    const out = /* @__PURE__ */ new Map();
+    const scan = await this.scanLibraries();
+    if (!scan) return out;
+    const snap = await this.loadLibraryIndex();
+    for (const [key, candidates] of scan.byKey) {
+      for (const c of candidates) {
+        if (c.entry.version) continue;
+        const lib = snap?.libraries.find((l) => l.name === c.library);
+        if (lib?.ownership !== "reader" || !("url" in lib.backendConfig)) continue;
+        const manifestVersion = repoManifestVersion(lib.path);
+        const commit = getRepoCommit(lib.path);
+        if (manifestVersion) out.set(`${c.library}\0${key}`, manifestVersion);
+        else if (commit)
+          out.set(`${c.library}\0${key}`, `${PSEUDO_VERSION_PREFIX}${commit.slice(0, 7)}`);
+      }
+    }
+    return out;
+  }
   /**
    * Every origin that holds `ref` (`kind:@publisher/name`) with the version it holds, in
    * the order `add <ref>` prefers them, so the first row is the one `add` deploys: the
@@ -2486,7 +2636,7 @@ var AssetManager = class {
       const slot = `${component}/${a.name}`;
       const prior = seen.get(slot);
       if (prior && differs(prior, a)) {
-        const dir2 = deployedDir(component, a.name, this.driverTarget, this.global, this.projectDir);
+        const dir2 = deployedDir(component, a.name, this.harness, this.global, this.projectDir);
         throw new Error(
           `${refOf(prior)} and ${refOf(a)} both deploy to ${shown(dir2)} \u2014 keep only one of them`
         );
@@ -2558,7 +2708,7 @@ var AssetManager = class {
     }
     const drift = deployedAssetDrift(entry, {
       registry: this.registry,
-      driverTarget: target,
+      harness: target,
       global: this.global,
       cwd: this.projectDir
     });
@@ -2602,7 +2752,14 @@ var AssetManager = class {
       if (!existsSync(indexPath)) return null;
       const index = new LocalIndex({ indexPath });
       try {
-        return { libraries: await index.listSources(), defs: await index.listAssetDefs() };
+        const libraries = await index.listSources();
+        const defs = await index.listAssetDefs();
+        const hidden = this.undeclaredSourceClones(libraries);
+        if (hidden.size === 0) return { libraries, defs };
+        return {
+          libraries: libraries.filter((l) => !hidden.has(l.id)),
+          defs: defs.filter((d) => !d.libraryId || !hidden.has(d.libraryId))
+        };
       } finally {
         index.close();
       }
@@ -2610,6 +2767,32 @@ var AssetManager = class {
       return null;
     }
   }
+  /**
+   * Ids of the registered libraries that are the clone of a source this project does not
+   * declare. `source add` registers the clone as a machine-wide reader library so `search`
+   * and the indexer can read it, but a `sources:` clone belongs to the projects that declare
+   * it (OQ12, p321): another project neither resolves it, nor ties with it by name, nor has
+   * `update` re-pin its locked assets to it. A reader library the user registered by hand
+   * (`library init --reader --git`) lives outside the sources cache and is never hidden.
+   */
+  undeclaredSourceClones(libraries) {
+    const hidden = /* @__PURE__ */ new Set();
+    if (!this.global && !findWorkspaceRoot(this.projectDir)) return hidden;
+    let declared;
+    try {
+      declared = new Set(this.loadConfig().sources.map((s) => sourceCacheKey(s.url)));
+    } catch {
+      return hidden;
+    }
+    const cloneRoots = [join(globalCacheRoot(), "sources"), this.reposDir].map((d) => resolve(d));
+    for (const l of libraries) {
+      if (l.ownership !== "reader" || !("url" in l.backendConfig)) continue;
+      const at = resolve(l.path);
+      if (!cloneRoots.some((root) => at.startsWith(root + sep))) continue;
+      if (!declared.has(sourceCacheKey(l.backendConfig.url))) hidden.add(l.id);
+    }
+    return hidden;
+  }
   /**
    * Library-origin lock entries for the assets {@link resolveLibraryEntries}
    * matched. The locked version is the one actually deployed: the on-disk
@@ -2741,7 +2924,7 @@ var AssetManager = class {
       const lookup = this.lockedLibrary(e.library, snap, { kind, publisher, name });
       if (lookup.state === "ok") continue;
       const component = this.installTarget(kind);
-      const deployed = component !== void 0 && isDeployed(component, name, this.driverTarget, this.global, this.projectDir);
+      const deployed = component !== void 0 && isDeployed(component, name, this.harness, this.global, this.projectDir);
       const problem = lockedLibraryProblem(lookup, e.library, `${kind}:@${publisher}/${name}`);
       const kept = deployed ? "the deployed copy and its lock entry are kept" : "its lock entry is kept; no deployed copy exists";
       lines.push(`${ref} (${problem}; ${kept})`);
@@ -2753,14 +2936,19 @@ var AssetManager = class {
    * `install --locked`. An entry is restored only when its library is still
    * registered/on disk, still holds the asset, and still offers the locked
    * version; anything else is reported in `missing` with the reason.
+   *
+   * @param opts.storeFallback - `install --locked` only: an entry whose library is not registered
+   *   here is restored from a store that serves the locked sha256 (OQ15, p1490). Reads such as
+   *   the drift check never ask a store.
    */
-  async restoreLibraryLockEntries(lock) {
+  async restoreLibraryLockEntries(lock, opts) {
     const entries = [];
     const missing = [];
+    const viaStore = [];
     const locked = Object.entries(lock.assets).filter(
       ([, e]) => e.library !== void 0 && !e.library.installed
     );
-    if (locked.length === 0) return { entries, missing };
+    if (locked.length === 0) return { entries, missing, viaStore };
     const snap = await this.loadLibraryIndex();
     const diskHashes = /* @__PURE__ */ new Map();
     const fileSets = /* @__PURE__ */ new Map();
@@ -2773,6 +2961,12 @@ var AssetManager = class {
       }
       const lookup = this.lockedLibrary(origin, snap, { kind, publisher, name });
       if (lookup.state !== "ok") {
+        const fallback = lookup.state === "unregistered" && opts?.storeFallback ? await this.storeEntryForLockedLibraryAsset(publisher, kind, name, origin) : null;
+        if (fallback) {
+          entries.push(fallback);
+          viaStore.push(ref);
+          continue;
+        }
         missing.push(
           `${ref} (${lockedLibraryProblem(lookup, origin, `${kind}:@${publisher}/${name}`)})`
         );
@@ -2795,7 +2989,7 @@ var AssetManager = class {
         const component = this.installTarget(kind);
         const newer = gt(coerceVersion(current), coerceVersion(origin.version));
         const comparable = !isPseudoVersion(current) && !isPseudoVersion(origin.version);
-        const intact = (newer || comparable) && (component === void 0 || isDeployed(component, name, this.driverTarget, this.global, this.projectDir));
+        const intact = (newer || comparable) && (component === void 0 || isDeployed(component, name, this.harness, this.global, this.projectDir));
         if (!intact) {
           missing.push(
             `${ref} (library "${lookup.name}" is at ${current}, locked ${origin.version}${newer || comparable ? "; `skaile update` moves the lock to it" : ""})`
@@ -2815,27 +3009,76 @@ var AssetManager = class {
       found.version = sameVersion ? origin.version : current;
       entries.push(withLibraryFiles(found, libPath, fileSets, this.registry));
     }
-    return { entries, missing };
+    return { entries, missing, viaStore };
+  }
+  /**
+   * The store's copy of a library-origin lock entry whose library is not registered here: a
+   * store (project `stores:` or the global catalog) that serves `kind:@publisher/name#version`
+   * under the very sha256 the lock recorded holds the same bytes. The entry is fetched and
+   * verified like any store asset; the lock stays as it is. `null` when the lock has no hash,
+   * no store answers, or the hash differs (OQ15, p1490).
+   */
+  async storeEntryForLockedLibraryAsset(publisher, kind, name, origin) {
+    if (!origin.sha256 || !origin.version || isPseudoVersion(origin.version)) return null;
+    const { repositories, stores: projectStores } = this.loadConfig();
+    const stores = [...projectStores, ...await this.globalStoreFallback(projectStores)];
+    const fetcher = this.storeFetcherFor(stores);
+    if (!fetcher) return null;
+    for (const store of stores) {
+      try {
+        const m = await fetcher.getInstallManifest(
+          store.url,
+          `${kind}:@${publisher}/${name}#${origin.version}`
+        );
+        if (!m || m.sha256 !== origin.sha256) continue;
+        const [entry] = await this.buildCatalogEntries(
+          [
+            {
+              publisher,
+              kind,
+              name,
+              version: origin.version,
+              sourceUrl: m.sourceUrl,
+              commit: m.commit,
+              files: m.files,
+              sha256: m.sha256,
+              ...m.deps?.length ? { deps: m.deps, storeRequires: m.deps } : {}
+            }
+          ],
+          repositories
+        );
+        if (entry) return entry;
+      } catch (err) {
+        this.noteStoreFailure(store.url, err);
+      }
+    }
+    return null;
   }
   /**
    * Whether a deployed copy exists for the lock entries `install` kept for the unresolved
-   * `ref`. A kind with no install target has no deployed copy.
+   * `ref`. A kind with no install target has none, except an `mcp-server`: its copy is the
+   * `.mcp.json` entry skaile wrote and the payload that entry points into (p792).
    */
-  keptCopyDeployed(kept, ref) {
+  async keptCopyDeployed(kept, ref) {
     const want = parseRefTolerant(ref.split(" ")[0] ?? ref);
     if (!want) return false;
-    return Object.keys(kept.assets).some((key) => {
+    for (const key of Object.keys(kept.assets)) {
       const id = parseCanonicalLockKey(key);
-      if (id.kind !== want.kind || id.name !== want.name) return false;
-      if (want.publisher && id.publisher !== want.publisher) return false;
+      if (id.kind !== want.kind || id.name !== want.name) continue;
+      if (want.publisher && id.publisher !== want.publisher) continue;
       const component = this.installTarget(id.kind);
-      return component !== void 0 && isDeployed(component, id.name, this.driverTarget, this.global, this.projectDir);
-    });
+      if (component !== void 0) {
+        if (isDeployed(component, id.name, this.harness, this.global, this.projectDir)) return true;
+      } else if (id.kind === "mcp-server" && !this.global && await mcpCommittedRenderIntact(this.projectDir, this.harness, id.name)) {
+        return true;
+      }
+    }
+    return false;
   }
   /** Whether the deployed copy of a library asset is on disk; a kind with no install target has none to check. */
   lockedCopyDeployed(kind, name) {
     const component = this.installTarget(kind);
-    return component === void 0 || isDeployed(component, name, this.driverTarget, this.global, this.projectDir);
+    return component === void 0 || isDeployed(component, name, this.harness, this.global, this.projectDir);
   }
   /**
    * The library-origin lock entries `install` keeps when the library holds a newer version:
@@ -2953,6 +3196,24 @@ var AssetManager = class {
   lockedRefsNamed(kind, name) {
     return Object.keys(this.tryReadLock()?.assets ?? {}).map(parseCanonicalLockKey).filter((id) => id.kind === kind && id.name === name).map((id) => id.publisher ? `${kind}:@${id.publisher}/${name}` : `${kind}:${name}`);
   }
+  /**
+   * The library a library-origin lock entry of `kind` and `name` (and `publisher`, when given)
+   * resolves to on this machine, or `undefined` when the lock holds no such entry, it is not
+   * from a library, or its library is not here. `info` prints it next to `source:`.
+   */
+  async lockedLibraryOf(kind, name, publisher) {
+    const bare = publisher?.replace(/^@/, "");
+    const names = await this.lockedLibraryNames();
+    for (const [key, entry] of Object.entries(this.tryReadLock()?.assets ?? {})) {
+      if (!entry.library || entry.library.installed) continue;
+      const id = parseCanonicalLockKey(key);
+      if (id.kind !== kind || id.name !== name || !id.publisher) continue;
+      if (bare && id.publisher !== bare) continue;
+      const lib = names.get(`${kind}:${id.publisher}/${name}`);
+      if (lib) return lib;
+    }
+    return void 0;
+  }
   /**
    * Where each library-origin lock entry of this project resolves on this machine: identity
    * `kind:publisher/name` (no scope sigil, no version) → the name the locked library is
@@ -2995,6 +3256,88 @@ var AssetManager = class {
     }
     return { libraries: await this.lockedLibraryNames(), shas };
   }
+  /**
+   * Canonical refs of the locked source assets that share a source URL with `resolved` but
+   * are locked at another commit than the one `resolved` carries for it. Assets in `resolved`
+   * and library-origin entries are skipped.
+   */
+  staleSourceSiblingRefs(resolved, declared = []) {
+    const pinOf = /* @__PURE__ */ new Map();
+    for (const d of declared) {
+      const id = refIdentity(d);
+      const pin = parseAssetRefLoose(d)?.pin;
+      if (id !== null && pin) pinOf.set(id.replace(/^@/, ""), pin);
+    }
+    const commitOf = /* @__PURE__ */ new Map();
+    const held = /* @__PURE__ */ new Set();
+    for (const c of resolved) {
+      if (!c.sourceUrl || !c.commit) continue;
+      commitOf.set(normalizeRepoUrl(c.sourceUrl), c.commit);
+      held.add(`${c.publisher.replace(/^@/, "")}/${c.kind}:${c.name}`);
+    }
+    const out = [];
+    for (const [key, entry] of Object.entries(this.tryReadLock()?.assets ?? {})) {
+      const src = entry.source;
+      if (!src?.url || entry.library) continue;
+      const commit = commitOf.get(normalizeRepoUrl(src.url));
+      if (!commit || src.commit === commit) continue;
+      const { publisher, kind, name } = parseCanonicalLockKey(key);
+      if (!publisher || !kind || !name || held.has(`${publisher}/${kind}:${name}`)) continue;
+      const pin = pinOf.get(`${publisher}/${kind}:${name}`);
+      out.push(`${kind}:@${publisher}/${name}${pin ? `#${pin}` : ""}`);
+    }
+    return out;
+  }
+  /**
+   * The lock entries that came from a source or the store (a `source:`, no `library:`), by
+   * identity `<publisher>/<kind>:<name>` -> locked version. The lock's origin
+   * wins: a library registered later that holds the same ref does not take such an asset
+   * (`update`, `install`, `add`; OQ15, p1490).
+   */
+  lockedOriginVersions() {
+    const out = /* @__PURE__ */ new Map();
+    for (const [key, e] of Object.entries(this.tryReadLock()?.assets ?? {})) {
+      if (!e.source || e.library) continue;
+      const { publisher, kind, name, version } = parseCanonicalLockKey(key);
+      if (publisher && kind && name) out.set(`${publisher}/${kind}:${name}`, version ?? "");
+    }
+    return out;
+  }
+  /**
+   * Say which registered library holds a ref the lock keeps on its source or the store: the
+   * candidate that lost, with the way to switch (p1490). Printed once per `add`.
+   */
+  async noteLosingLibraries(refs) {
+    const lock = this.tryReadLock();
+    for (const ref of refs) {
+      const plain = ref.split("#")[0] ?? ref;
+      let hit;
+      try {
+        hit = await this.resolveLibraryEntries([plain], { quiet: true });
+      } catch {
+        continue;
+      }
+      const entry = hit.entries[0];
+      const library = entry ? hit.libraryOf.get(entry) : void 0;
+      if (!entry || !library) continue;
+      const canonical = canonicalEntryRef(entry);
+      const plainCanonical = canonical.split("#")[0] ?? canonical;
+      const lockedUrl = Object.entries(lock?.assets ?? {}).find(([k, e]) => {
+        const id = parseCanonicalLockKey(k);
+        return e.source && !e.library && `${id.kind}:@${id.publisher}/${id.name}` === plainCanonical;
+      })?.[1].source?.url;
+      if (lockedUrl) {
+        const ownClone = (await this.loadLibraryIndex())?.libraries.some(
+          (l) => l.name === library && l.ownership === "reader" && "url" in l.backendConfig && sourceCacheKey(l.backendConfig.url) === sourceCacheKey(lockedUrl)
+        );
+        if (ownClone) continue;
+      }
+      this.emitLibraryCollision(
+        `${plainCanonical} is locked from ${lockedUrl ?? "its source"}, which wins; library "${library}" also holds it${entry.version ? ` (${entry.version})` : ""} and is not used. To switch, run \`skaile remove ${plainCanonical}\`, then \`skaile add ${plainCanonical}\`.`,
+        [plainCanonical]
+      );
+    }
+  }
   // ── Store fetch-then-deploy ────────────────────────────────────────────
   /** A candidate's stable identity key (`<publisher>/<kind>:<name>@<version>`). */
   candidateKey(c) {
@@ -3154,10 +3497,19 @@ var AssetManager = class {
         fresh.push(ref);
       }
       if (fresh.length === 0) break;
+      const keepsOrigin = (ref) => {
+        const id = refIdentity(ref);
+        const locked = id !== null ? opts.lockedOrigin?.get(id) : void 0;
+        if (locked === void 0) return false;
+        const pin = ref.includes("#") ? ref.slice(ref.indexOf("#") + 1).trim() : void 0;
+        return !pin || locked === "" || matchPin(pin, locked);
+      };
+      const originKept = fresh.filter(keepsOrigin);
+      if (opts.warnCollisions && originKept.length > 0) await this.noteLosingLibraries(originKept);
       const libraryTried = new Set(
         fresh.filter((ref) => {
           const id = refIdentity(ref);
-          return id !== null && (opts.provenanceIndex.get(id)?.length ?? 0) === 0;
+          return id !== null && (opts.provenanceIndex.get(id)?.length ?? 0) === 0 && !keepsOrigin(ref);
         })
       );
       const hit = await this.resolveLibraryEntries([...libraryTried], {
@@ -3185,7 +3537,7 @@ var AssetManager = class {
         }
         presets.push(...r.presets);
         const hit2 = await this.resolveLibraryEntries(
-          r.missing.filter((m) => !libraryTried.has(m)),
+          r.missing.filter((m) => !libraryTried.has(m) && !keepsOrigin(m)),
           {
             quiet: !opts.warnCollisions,
             lockedLibraries: opts.lockedLibraries,
@@ -3488,7 +3840,8 @@ var AssetManager = class {
         };
       }
       const orphans = await this.orphanedSourceGaps(
-        await this.declaredLockKeys(lockForLibraries, dependencies)
+        await this.declaredLockKeys(lockForLibraries, dependencies),
+        true
       );
       if (orphans.size > 0) {
         return {
@@ -3531,6 +3884,7 @@ var AssetManager = class {
       // library holding the same ref does not move a locked asset. `update` re-resolves.
       ...opts?.moveLibraries ? { preferLocked: await this.lockedPreference() } : { lockedLibraries: await this.lockedLibraryNames() },
       ...keepLocked ? { keepLocked } : {},
+      lockedOrigin: this.lockedOriginVersions(),
       readStoreRequires: true
     });
     this.assertNoFolderCollision([...resolved, ...lib.entries.map((e) => this.entryIdentity(e))]);
@@ -3574,7 +3928,7 @@ var AssetManager = class {
     const missingHints = await this.publisherChangeHints(stillMissing);
     const prevLock = this.tryReadLock();
     const kept = keptLockEntries(prevLock, stillMissing);
-    const storeNotChecked = this.storeNotCheckedRefs(
+    const storeNotChecked = await this.storeNotCheckedRefs(
       kept,
       sources.map((s) => s.url)
     );
@@ -3582,7 +3936,7 @@ var AssetManager = class {
     for (const ref of /* @__PURE__ */ new Set([...kept.refs, ...fixes.keys()])) {
       const fix = fixes.get(ref);
       const notes = [
-        kept.refs.has(ref) ? this.keptCopyDeployed(kept, ref) ? "the deployed copy and its lock entry are kept" : "its lock entry is kept; no deployed copy exists" : void 0,
+        kept.refs.has(ref) ? await this.keptCopyDeployed(kept, ref) ? "the deployed copy and its lock entry are kept" : "its lock entry is kept; no deployed copy exists" : void 0,
         fix
       ].filter((n) => n !== void 0);
       missingHints[ref] = `${fix ? "" : missingHints[ref] ?? ""} (${notes.join("; ")})`;
@@ -3601,12 +3955,24 @@ var AssetManager = class {
     const entries = [...await this.buildCatalogEntries(resolved, repositories), ...lib.entries];
     assertFlowsLoad(entries, "installed");
     assertNoLibrarySymlinks(entries, this.registry, repositories, opts?.link === true);
+    const forceCommand = opts?.moveLibraries === true ? "skaile update --force" : "skaile install --force";
     if (!opts?.force) {
       await this.assertNoHandEditsPruned(
         resolved,
-        /* @__PURE__ */ new Set([...Object.keys(libraryLock), ...Object.keys(kept.assets)])
+        /* @__PURE__ */ new Set([...Object.keys(libraryLock), ...Object.keys(kept.assets)]),
+        forceCommand
       );
     }
+    const relockRemoved = await this.relockDeletions(
+      entries,
+      prevLock,
+      withKeptLockEntries(freshLock, kept),
+      opts?.force === true,
+      forceCommand,
+      lib.libraryOf
+    );
+    if (!opts?.force) this.assertNoUnrecordedAgentOverwrite(entries, prevLock, forceCommand);
+    const inferredHarnesses = this.inferLegacyHarnessSubsets(entries);
     const { removed, replaced } = this.reconcileRemovedAssets(
       resolved,
       /* @__PURE__ */ new Set([...Object.keys(libraryLock), ...Object.keys(kept.assets)])
@@ -3614,6 +3980,7 @@ var AssetManager = class {
     const copyDrift = await this.lockedCopyDrift();
     const missingCopies = await this.incompleteDeploys();
     const unrecordedAgents = this.unrecordedAgentFiles(prevLock);
+    const composedDrift = /* @__PURE__ */ new Set();
     const deployed = [
       ...new Set(
         this.targetHarnesses().flatMap(
@@ -3621,22 +3988,32 @@ var AssetManager = class {
             this.entriesForHarness(entries, t),
             repositories,
             patches,
-            this.deployOptsFor(t, opts?.link)
+            this.deployOptsFor(t, opts?.link, void 0, {
+              refresh: opts?.moveLibraries === true,
+              onDrift: (ref, composeRef) => composedDrift.add(this.composedDriftLine(ref, composeRef))
+            })
           )
         )
       )
     ];
     this.sweepLegacyOmpCopies(entries);
-    const mcpRestored = await this.renderDriverMcpConfig();
+    const mcpRestored = await this.renderHarnessMcpConfig();
     const agentRender = await this.renderAgentInstances();
-    const restored = [...this.restoredCopies(copyDrift, deployed, missingCopies), ...mcpRestored];
+    const restored = [
+      ...this.restoredCopies(copyDrift, deployed, missingCopies),
+      ...relockRemoved,
+      ...mcpRestored
+    ];
     const rewritten = this.rewrittenAgentFiles(unrecordedAgents);
     const lockWanted = resolved.length > 0 || lib.entries.length > 0 || existsSync(this.lockPath);
     let lockWritten = false;
     let relocked = [];
     let moved = [];
     if (lockWanted) {
-      const lockData = this.withRenderedAgents(withKeptLockEntries(freshLock, kept));
+      const lockData = this.withRenderedAgents(
+        withKeptLockEntries(freshLock, kept),
+        opts?.moveLibraries ? void 0 : prevLock
+      );
       moved = libraryMoves(prevLock, libraryLock);
       const movedRefs = new Set(moved.map((m) => m.ref));
       relocked = relockedRefs(prevLock, lockData).filter((k) => !movedRefs.has(k.split("#")[0]));
@@ -3652,12 +4029,17 @@ var AssetManager = class {
     return {
       deployed,
       removed,
-      missing: [...reportedMissing, ...versionBlocked.filter((b) => !reportedMissing.includes(b))],
+      missing: [
+        ...reportedMissing,
+        ...versionBlocked.filter((b) => !reportedMissing.includes(b)),
+        ...composedDrift
+      ],
       ...placeholderBodies.length > 0 ? { placeholderBodies } : {},
       ...placeholderDescriptions.length > 0 ? { placeholderDescriptions } : {},
       ...storeNotChecked.length > 0 ? { storeNotChecked } : {},
       ...Object.keys(missingHints).length > 0 ? { missingHints } : {},
       ...relocked.length > 0 ? { relocked } : {},
+      ...inferredHarnesses.length > 0 ? { inferredHarnesses } : {},
       ...moved.length > 0 ? { moved } : {},
       ...replaced.length > 0 ? { replaced } : {},
       ...restored.length > 0 ? { restored } : {},
@@ -3678,7 +4060,7 @@ var AssetManager = class {
    * @param declaredSourceUrls - The `sources:` URLs of `skaile.yaml`; a lock entry from one of
    *   them is that source's, not the store's.
    */
-  storeNotCheckedRefs(kept, declaredSourceUrls) {
+  async storeNotCheckedRefs(kept, declaredSourceUrls) {
     const skipped = this.catalogUrlOverride === "";
     if (!skipped && this.storeFailures.size === 0) return [];
     const declared = new Set(declaredSourceUrls.map(normalizeRepoUrl));
@@ -3689,7 +4071,7 @@ var AssetManager = class {
         const entry = kept.assets[key];
         return entry !== void 0 && !entry.library && entry.source !== void 0 && !declared.has(normalizeRepoUrl(entry.source.url));
       });
-      if (!fromStore || !this.keptCopyDeployed(kept, ref)) continue;
+      if (!fromStore || !await this.keptCopyDeployed(kept, ref)) continue;
       if (skipped && this.storeFailures.size === 0) {
         out.push({ ref, reason: "skipped", detail: "--no-catalog: the store was not asked" });
         continue;
@@ -3745,7 +4127,7 @@ var AssetManager = class {
     const locked = this.lockedRequirementsOf(id);
     const withLocked = (scanned) => [.../* @__PURE__ */ new Set([...scanned, ...locked])];
     const keptAgent = kind === "agent" && !this.global ? join(agentSourceCacheDir(this.projectDir), name) : null;
-    const dir = keptAgent && existsSync(keptAgent) ? keptAgent : deployedDir(component, name, this.driverTarget, this.global, this.projectDir);
+    const dir = keptAgent && existsSync(keptAgent) ? keptAgent : deployedDir(component, name, this.harness, this.global, this.projectDir);
     if (!existsSync(dir)) return withLocked([]);
     try {
       const scanned = await scanDirectory(dir, publisher ?? "", { knownKinds: this.knownKinds });
@@ -3835,7 +4217,7 @@ var AssetManager = class {
    * other version taking its place) whose deployed folder holds hand edits: the files that differ
    * from the lock are named, nothing is removed, and `--force` prunes anyway (OQ6).
    */
-  async assertNoHandEditsPruned(resolved, keep) {
+  async assertNoHandEditsPruned(resolved, keep, forceCommand) {
     const oldLock = this.tryReadLock();
     if (!oldLock) return;
     const resolvedRefs = [
@@ -3867,7 +4249,158 @@ var AssetManager = class {
     throw new Error(
       `Not pruned: skaile.yaml no longer declares ${lines.length === 1 ? "an asset" : "assets"} whose deployed copy holds your edits:
   ${lines.join("\n  ")}
-Nothing was changed. Declare it again to keep it, or run \`skaile install --force\` to prune it with its edits.`
+Nothing was changed. Declare it again to keep it, or run \`${forceCommand}\` to prune it with its edits.`
+    );
+  }
+  /**
+   * Report (and, without `force`, guard) the files a re-lock deletes from a deployed copy
+   * (OQ5, p1441): the asset is locked already and its library or source now holds other content
+   * (`next` re-locks it), and the deployed folder holds files the new content does not ship. The
+   * deploy clears them. Two cases:
+   *  - the deployed copy still equals what `prevLock` recorded (per-file sha256 for a source
+   *    or store asset, the library hash for a library asset): the new version dropped those
+   *    files, nobody edited them, so they are deleted and come back as `removed` rows (an
+   *    `install`/`update` prints `Removed <file> (not part of <ref>)`), without a refusal;
+   *  - the copy diverged (a file the previous content did not ship, an edited file, or no hash
+   *    to compare): without `force` this throws one error naming the files and changes nothing.
+   *    A source or store asset names only the files the previous content did not ship (or that
+   *    were edited); a library asset records no file list, so it names every file to delete.
+   *
+   * @param entries - The catalog entries about to be deployed.
+   * @param next - The lock the run is about to write (or merge).
+   * @param libraryOf - The library each library-origin entry came from.
+   */
+  async relockDeletions(entries, prevLock, next, force, forceCommand, libraryOf) {
+    if (!prevLock) return [];
+    const relocked = relockedRefs(prevLock, next).map((key) => ({
+      key,
+      id: parseCanonicalLockKey(key)
+    }));
+    if (relocked.length === 0) return [];
+    const shown = (p) => (this.global ? p : relative(this.projectDir, p)).split(sep).join("/");
+    let snap;
+    const rows = [];
+    const refused = [];
+    for (const e of entries) {
+      const hit = relocked.find(({ id }) => id.kind === e.kind && id.name === e.name);
+      const component = hit ? this.installTarget(e.kind) : void 0;
+      if (!hit || !component) continue;
+      const prevEntry = Object.entries(prevLock.assets).find(([k]) => {
+        const o = parseCanonicalLockKey(k);
+        return o.kind === hit.id.kind && o.name === hit.id.name && o.publisher === hit.id.publisher;
+      })?.[1];
+      const removed = [];
+      const blocked = [];
+      for (const t of this.targetHarnesses()) {
+        const drift = deployedAssetDrift(e, this.deployOptsFor(t));
+        if (!drift || drift.extra.length === 0) continue;
+        const dir = deployedDir(component, e.name, t, this.global, this.projectDir);
+        const files = drift.extra;
+        let untouched;
+        if (prevEntry && prevEntry.files.length > 0) {
+          const locked = new Map(
+            lockedAssetFiles(e.kind, prevEntry.files).map((f) => [f.rel, f.sha256])
+          );
+          untouched = files.filter((rel) => {
+            const want = locked.get(rel);
+            if (want === void 0) return false;
+            try {
+              return computeHash(join(dir, rel)) === want;
+            } catch {
+              return false;
+            }
+          });
+        } else if (prevEntry?.library?.sha256 && !prevEntry.library.installed) {
+          const libName = libraryOf.get(e);
+          snap ??= await this.loadLibraryIndex();
+          const libPath = libName ? this.libraryPath({ name: libName }, snap) : null;
+          if (libPath) {
+            const assetRoot = statSync(e.source).isDirectory() ? e.source : dirname(e.source);
+            const hash = computeDeterministicHash(
+              dir,
+              listAssetFiles(dir),
+              posix.normalize(relative(libPath, assetRoot).split(sep).join("/"))
+            );
+            if (hash === prevEntry.library.sha256) untouched = [...files];
+          }
+        }
+        const own = new Set(untouched ?? []);
+        for (const f of files) (own.has(f) ? removed : blocked).push(shown(join(dir, f)));
+      }
+      if (removed.length > 0) rows.push({ ref: hit.key, restored: [], removed });
+      if (blocked.length > 0) refused.push({ ref: hit.key, restored: [], removed: blocked });
+    }
+    if (refused.length === 0 || force) return [...rows, ...refused];
+    const lines = refused.map((r) => `${r.ref} (${r.removed.join(", ")})`);
+    throw new Error(
+      `Not re-locked: the deployed copy of ${refused.length === 1 ? "an asset" : "assets"} holds files its locked content did not ship or that were edited, and the deploy would delete them:
+  ${lines.join("\n  ")}
+Nothing was changed. Copy what you need, or run \`${forceCommand}\` to delete them.`
+    );
+  }
+  /**
+   * Stop `install` from overwriting a hand-edited rendered agent file that no lock entry
+   * records (OQ5, p1440): the lock is gone (or never held the agent), so nothing tells an edit
+   * from a stale render, and the deploy would replace the file without a word. Checks the file
+   * named after each agent about to be deployed and the file of each agent instance whose bound
+   * agent has no lock entry. Throws one error naming each file that exists and differs from its
+   * render and changes nothing; `--force` (the caller skips this check) overwrites. A file that
+   * equals its render is not an edit. Project mode only.
+   */
+  assertNoUnrecordedAgentOverwrite(entries, prevLock, forceCommand) {
+    if (this.global) return;
+    const lockedAgents = new Set(
+      Object.keys(prevLock?.assets ?? {}).map(parseCanonicalLockKey).filter((k) => k.kind && this.installTarget(k.kind) === "agent").map((k) => k.name)
+    );
+    const opts = this.deployOptsFor(this.harness);
+    const lines = /* @__PURE__ */ new Set();
+    const collect = (diff, what) => {
+      if (!diff) return;
+      for (const m of diff.matchAll(/^--- (.+?)\t/gm)) {
+        const abs = m[1];
+        if (!existsSync(abs)) continue;
+        lines.add(
+          `${relative(this.projectDir, abs).split(sep).join("/")} (${what} differs from its render)`
+        );
+      }
+    };
+    for (const e of entries) {
+      if (this.installTarget(e.kind) !== "agent" || lockedAgents.has(e.name)) continue;
+      try {
+        collect(diffDeployedAgent(e, opts), `agent ${e.name}`);
+      } catch {
+      }
+    }
+    let instances = {};
+    try {
+      instances = effectiveAgentInstances(resolveSkWorkspaceConfig(this.projectDir));
+    } catch {
+    }
+    for (const [id, config] of Object.entries(instances)) {
+      if (!config.ref.startsWith("agent:")) continue;
+      const bound = parseRefTolerant(config.ref);
+      if (bound?.kind === "agent" && lockedAgents.has(bound.name)) continue;
+      try {
+        const srcDir = resolveAgentDefinitionDir(this.projectDir, config.ref);
+        if (srcDir === void 0) continue;
+        const entry = {
+          kind: "agent",
+          name: id,
+          description: "",
+          source: srcDir,
+          version: "",
+          requires: [],
+          dependencies: []
+        };
+        collect(diffDeployedAgent(entry, opts, { id, srcDir, config }), `agent instance ${id}`);
+      } catch {
+      }
+    }
+    if (lines.size === 0) return;
+    throw new Error(
+      `Not deployed: the deploy would overwrite ${lines.size === 1 ? "a rendered agent file" : "rendered agent files"} that no lock entry records:
+  ${[...lines].join("\n  ")}
+Nothing was changed. Move your edits away, or run \`${forceCommand}\` to overwrite the file.`
     );
   }
   /**
@@ -4095,7 +4628,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     }
     assertLockHashes(lock);
     this.assertNoFolderCollision(Object.keys(lock.assets).map(parseCanonicalLockKey));
-    const orphaned = [...(await this.orphanedSourceGaps()).values()];
+    const orphaned = [...(await this.orphanedSourceGaps(void 0, true)).values()];
     if (orphaned.length > 0) {
       throw new Error(
         `Lock file verification failed:
@@ -4170,12 +4703,14 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       throw new Error(`Lock file verification failed:
   ${reason}`);
     }
-    const library = await this.restoreLibraryLockEntries(lock);
+    const library = await this.restoreLibraryLockEntries(lock, { storeFallback: true });
     assertFlowsLoad([...resolved, ...library.entries], "installed");
     assertNoLibrarySymlinks([...resolved, ...library.entries], this.registry, repositories);
+    const inferredHarnesses = this.inferLegacyHarnessSubsets([...resolved, ...library.entries]);
     const copyDrift = await this.lockedCopyDrift();
     const missingCopies = await this.incompleteDeploys();
     const unrecordedAgents = this.unrecordedAgentFiles(lock);
+    const composedDrift = /* @__PURE__ */ new Set();
     const deployed = [
       ...new Set(
         this.targetHarnesses().flatMap(
@@ -4183,13 +4718,16 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
             this.entriesForHarness([...resolved, ...library.entries], t),
             repositories,
             patches,
-            this.deployOptsFor(t)
+            this.deployOptsFor(t, void 0, void 0, {
+              refresh: false,
+              onDrift: (ref, composeRef) => composedDrift.add(this.composedDriftLine(ref, composeRef))
+            })
           )
         )
       )
     ];
     this.sweepLegacyOmpCopies([...resolved, ...library.entries]);
-    const mcpRestored = await this.renderDriverMcpConfig();
+    const mcpRestored = await this.renderHarnessMcpConfig();
     const agentRender = await this.renderAgentInstances();
     const restored = [...this.restoredCopies(copyDrift, deployed, missingCopies), ...mcpRestored];
     const rewritten = this.rewrittenAgentFiles(unrecordedAgents);
@@ -4201,6 +4739,8 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     );
     const gaps = (await this.projectState()).gaps.filter((g) => {
       if (g.type === "agent") return false;
+      if (g.unreadableSource) return false;
+      if (g.type === "library" && library.viaStore.includes(g.ref)) return false;
       const p = parseRefTolerant(g.ref);
       return !(p && alreadyMissing.has(`${p.kind}:${p.name}`));
     }).map((g) => g.message);
@@ -4209,10 +4749,11 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     return {
       deployed,
       removed: [],
-      missing: [...library.missing, ...gaps],
+      missing: [...library.missing, ...gaps, ...composedDrift],
       ...placeholderBodies.length > 0 ? { placeholderBodies } : {},
       ...placeholderDescriptions.length > 0 ? { placeholderDescriptions } : {},
       lockWritten: false,
+      ...inferredHarnesses.length > 0 ? { inferredHarnesses } : {},
       ...restored.length > 0 ? { restored } : {},
       ...rewritten.length > 0 ? { rewritten } : {},
       ...agentRender
@@ -4240,6 +4781,72 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     }
     return [...found].sort((a, b) => gt(coerceVersion(a), coerceVersion(b)) ? -1 : 1);
   }
+  /**
+   * The refs of the other kinds that a source or a library holds under the same publisher and
+   * name as `parsed` (`agent:@pub/captain` for a `@pub/captain` that is no skill), for the
+   * `Did you mean` of an `add` that missed.
+   */
+  async otherKindRefs(parsed) {
+    if (!parsed.publisher) return [];
+    const publisher = parsed.publisher.replace(/^@/, "");
+    const found = [];
+    for (const kind of [...this.knownKinds].sort()) {
+      if (kind === parsed.kind) continue;
+      const candidate = `${kind}:@${publisher}/${parsed.name}`;
+      try {
+        if (await this.info(candidate) !== null) found.push(candidate);
+      } catch {
+      }
+    }
+    return found;
+  }
+  /**
+   * What `add` would deploy for the resolved candidates and library entries, without touching
+   * the project: one item per asset with its origin, version, deploy folders and files.
+   */
+  planAddItems(resolved, lib, stores, parsed) {
+    const storeUrls = new Set(stores.map((s) => normalizeRepoUrl(s.url)));
+    const factoryUrl = normalizeRepoUrl(FACTORY_SOURCE_URL);
+    const folders = (kind, name) => {
+      const component = this.installTarget(kind);
+      if (!component) return [];
+      return this.targetHarnesses().map((t) => {
+        const dir = deployedDir(component, name, t, this.global, this.projectDir);
+        const rel = relative(this.projectDir, dir);
+        const shown = this.global || rel.startsWith("..") ? dir.replace(homedir(), "~") : `${rel}${dir.endsWith(sep) ? sep : ""}`;
+        return shown;
+      });
+    };
+    const asked = (kind, name, publisher) => kind === parsed.kind && name === parsed.name && (!parsed.publisher || (publisher ?? "").replace(/^@/, "") === parsed.publisher.replace(/^@/, ""));
+    const items = [];
+    for (const c of resolved) {
+      const url = normalizeRepoUrl(c.sourceUrl);
+      items.push({
+        ref: assetRefToStr({
+          kind: c.kind,
+          name: c.name,
+          publisher: c.publisher.replace(/^@/, "")
+        }),
+        version: c.version,
+        origin: storeUrls.has(url) ? `store ${c.sourceUrl}` : url === factoryUrl ? "factory" : `source ${sourceShortName(c.sourceUrl)}`,
+        requested: asked(c.kind, c.name, c.publisher),
+        folders: folders(c.kind, c.name),
+        files: c.files.map((f) => f.path)
+      });
+    }
+    for (const e of lib.entries) {
+      const id = this.entryIdentity(e);
+      items.push({
+        ref: canonicalEntryRef(e),
+        version: e.version ?? "",
+        origin: `library ${lib.libraryOf.get(e) ?? ""}`.trim(),
+        requested: asked(e.kind, e.name, id.publisher),
+        folders: folders(e.kind, e.name),
+        files: [...e.files ?? []]
+      });
+    }
+    return items.sort((a, b) => Number(b.requested) - Number(a.requested));
+  }
   /**
    * Parse the ref `add` was given. A ref the grammar rejects fails with the parser's message
    * minus its manifest-migration advice (it points at a skill that is not for `add`), and:
@@ -4257,7 +4864,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       const plain = err.message.endsWith(advice) ? err.message.slice(0, -advice.length) : err.message;
       if (plain.startsWith("publisher required")) {
         const matches = await this.resolvableMatches(ref, repositories, sources);
-        const hint = matches.length === 0 ? "" : matches.length === 1 ? ` Did you mean ${matches[0]}?` : ` Did you mean one of: ${matches.join(", ")}?`;
+        const hint = matches.length === 0 ? ` Find the publisher with \`skaile store search ${ref.trim().replace(/^[^:@/#\s]+:/, "").replace(/#.*$/, "")}\`.` : matches.length === 1 ? ` Did you mean ${matches[0]}?` : ` Did you mean one of: ${matches.join(", ")}?`;
         throw new Error(`${plain}${hint}`);
       }
       const pinned = /^(.*\/[^@#/]+)@([^@#/]+)$/.exec(ref.trim());
@@ -4338,6 +4945,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
         stores,
         declaredRefs: dependencies,
         warnCollisions: true,
+        lockedOrigin: this.lockedOriginVersions(),
         readStoreRequires: true,
         ...opts?.preferLockedLibrary ? { preferLocked: await this.lockedPreference() } : {}
       });
@@ -4381,8 +4989,9 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
         );
       }
       const available = await this.availableVersions(parsed, stores);
+      const otherKinds = /^[^@/#\s]+:/.test(ref.trim()) ? [] : await this.otherKindRefs(parsed);
       throw new Error(
-        `Asset not found: ${ref}${(await this.publisherChangeHints([ref]))[ref] ?? ""}${missing.length ? ` (missing: ${missing.join(", ")})` : ""}${available.length ? `; ${parsed.name} has version(s): ${available.join(", ")}` : ""}`
+        `Asset not found: ${ref}${(await this.publisherChangeHints([ref]))[ref] ?? ""}${missing.length ? ` (missing: ${missing.join(", ")})` : ""}${available.length ? `; ${parsed.name} has version(s): ${available.join(", ")}` : ""}` + (otherKinds.length === 0 ? "" : otherKinds.length === 1 ? `. Did you mean ${otherKinds[0]}?` : `. Did you mean one of: ${otherKinds.join(", ")}?`)
       );
     }
     if (parsed.kind === "preset" && missing.length > 0) {
@@ -4405,6 +5014,62 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
             )
           );
         }
+        const problems = origin && libPath && !(e.kind === "flow" && flowLoadError(e) !== void 0) ? libraryAssetCheck?.({ kind: e.kind, name: e.name, source: e.source }, libPath) ?? [] : [];
+        if (problems.length > 0) {
+          throw new Error(
+            `${canonicalEntryRef(e)} in library "${origin}" fails the checks of \`skaile validate\` - nothing was added:
+${problems.map((l) => `  ${l}`).join("\n")}
+Fix the asset, then run \`skaile library index ${origin}\` and add it again.`
+          );
+        }
+      }
+    }
+    if (libraryAssetCheck) {
+      for (const c of resolved) {
+        const decl = Object.entries(repositories).find(([, d]) => d.url === c.sourceUrl);
+        const cloneDir = decl ? this.resolveRepoDir(decl[1], decl[0]) : null;
+        const entry = cloneDir ? this.candidateToCatalogEntry(c, repositories) : null;
+        if (!cloneDir || !entry) continue;
+        if (entry.kind === "flow" && flowLoadError(entry) !== void 0) continue;
+        const problems = libraryAssetCheck(
+          { kind: entry.kind, name: entry.name, source: entry.source },
+          cloneDir
+        );
+        if (problems.length > 0) {
+          throw new Error(
+            `${canonicalEntryRef(entry)} from source ${c.sourceUrl} fails the checks of \`skaile validate\` - nothing was added:
+${problems.map((l) => `  ${l}`).join("\n")}
+Fix the asset in the source repo, then run \`skaile source sync\` and add it again.`
+          );
+        }
+      }
+    }
+    const staleSiblings = this.staleSourceSiblingRefs(resolved, dependencies);
+    if (staleSiblings.length > 0) {
+      const siblings = await this.resolveLibraryFirst(staleSiblings, {
+        provenanceIndex,
+        overrides,
+        stores,
+        declaredRefs: dependencies,
+        lockedOrigin: this.lockedOriginVersions(),
+        readStoreRequires: true
+      });
+      for (const sib of staleSiblings) {
+        const pin = parseAssetRefLoose(sib)?.pin;
+        if (!pin) continue;
+        const id = refIdentity(sib.replace(/#.*$/, ""));
+        const kept = siblings.resolved.some(
+          (c) => `${c.publisher.replace(/^@/, "")}/${c.kind}:${c.name}` === id?.replace(/^@/, "") && matchPin(pin, c.version ?? "")
+        );
+        if (!kept) {
+          throw new Error(
+            `${sib.replace(/#.*$/, "")} is pinned to ${pin} in skaile.yaml, but its source moved on and no longer holds ${pin}, so adding ${ref} would break the lock - nothing was added. Change the pin in skaile.yaml, or drop the pinned asset, then add again.`
+          );
+        }
+      }
+      const held = new Set(resolved.map((c) => this.candidateKey(c)));
+      for (const c of siblings.resolved) {
+        if (!held.has(this.candidateKey(c))) resolved.push(c);
       }
     }
     this.assertSourceCommitsPublished(resolved, repositories);
@@ -4441,6 +5106,11 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
         `${ref.split("#")[0]} requires ${missing.join(", ")} (not found \u2014 ${REGISTER_HOLDER}, or remove the requirement from the asset's manifest) \u2014 nothing was added`
       );
     }
+    if (opts?.dryRun) {
+      const plan = this.planAddItems(resolved, lib, stores, parsed);
+      opts.onPlan?.(plan);
+      return [];
+    }
     const entries = [...await this.buildCatalogEntries(resolved, repositories), ...lib.entries];
     assertFlowsLoad(entries, "added");
     assertNoLibrarySymlinks(entries, this.registry, repositories, opts?.link === true);
@@ -4463,7 +5133,11 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
             this.entriesForHarness(entries, t),
             repositories,
             patches,
-            this.deployOptsFor(t, opts?.link, opts?.onSecretFile)
+            this.deployOptsFor(t, opts?.link, opts?.onSecretFile, {
+              refresh: true,
+              onDrift: () => {
+              }
+            })
           )
         )
       )
@@ -4484,7 +5158,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       opts?.onPlaceholderDescription?.(placeholder);
     }
     this.addDependencyToConfig(ref);
-    await this.renderDriverMcpConfig();
+    await this.renderHarnessMcpConfig();
     await this.renderAgentInstances();
     if (resolved.length > 0 || lib.entries.length > 0) {
       const libraryLock = await this.libraryLockEntries(lib);
@@ -4751,7 +5425,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
    * Removes only `ref` itself; use {@link removeWithDependencies} to also drop the
    * dependencies it leaves orphaned.
    *
-   * Deliberately does NOT re-render the driver target's MCP config: the render
+   * Deliberately does NOT re-render the harness target's MCP config: the render
    * step is async (the declaration resolver is), and making this synchronous
    * method async would break every external caller. {@link removeWithDependencies}
    * (what `skaile remove` runs) does re-render it; a caller of this method gets the
@@ -4820,14 +5494,22 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     }
     const kept = [];
     const ownedBy = [];
+    const mcpPublishers = target.kind === "mcp-server" && !this.global ? [
+      .../* @__PURE__ */ new Set([
+        ...this.lockHolders("mcp-server", target.name).map((h) => h.publisher),
+        target.publisher?.replace(/^@/, "")
+      ])
+    ].filter((p) => !!p) : [];
     const changed = this.removeResolved(target, { force: opts?.force, kept, ownedBy });
+    const droppedSettings = changed && mcpPublishers.length > 0 ? this.dropRemovedMcpServerSettings(target.name, mcpPublishers) : [];
     const keptNote = {
       ...kept.length > 0 ? { kept } : {},
-      ...ownedBy.length > 0 ? { ownedBy } : {}
+      ...ownedBy.length > 0 ? { ownedBy } : {},
+      ...droppedSettings.length > 0 ? { droppedSettings } : {}
     };
     const pruned = changed && requiredRefs.length > 0 ? await this.pruneOrphans(requiredRefs) : [];
     if (changed && (target.kind === "mcp-server" || pruned.some((r) => r.startsWith("mcp-server:")))) {
-      await this.renderDriverMcpConfig();
+      await this.renderHarnessMcpConfig();
     }
     return { changed, pruned, ...keptNote };
   }
@@ -4991,6 +5673,40 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     }
     return changed;
   }
+  /**
+   * After an `mcp-server` asset left the project: drop what would keep it rendered. Its staged
+   * store bytes under `.skaile/cache/store/<publisher>/mcp-server/<name>/` go (an `mcp_servers:`
+   * entry of the same id would otherwise keep loading them), and so does an `mcp_servers:` entry
+   * that only sets values for it: `env` and the like, with no `command`, `url` or recipe of its
+   * own. An entry that can run alone is the user's own server and stays.
+   *
+   * @returns The dropped `mcp_servers` entries, as `mcp_servers entry "<id>"`.
+   */
+  dropRemovedMcpServerSettings(name, publishers) {
+    for (const publisher of publishers) {
+      rmSync(join(this.storeCacheDir, publisher, "mcp-server", name), {
+        recursive: true,
+        force: true
+      });
+    }
+    const configPath = join(this.stateRoot, "skaile.yaml");
+    if (!existsSync(configPath)) return [];
+    const raw = parse(readFileSync(configPath, "utf8")) ?? {};
+    if (!Array.isArray(raw.mcp_servers)) return [];
+    const dropped = [];
+    const standalone = ["command", "url", "recipe", "launcher"];
+    raw.mcp_servers = raw.mcp_servers.filter((entry) => {
+      const e = entry;
+      if (!e || typeof e.id !== "string" || unscopedName(e.id) !== name) return true;
+      if (standalone.some((k) => e[k] !== void 0 && e[k] !== null)) return true;
+      dropped.push(`mcp_servers entry "${e.id}"`);
+      return false;
+    });
+    if (dropped.length === 0) return [];
+    if (raw.mcp_servers.length === 0) delete raw.mcp_servers;
+    writeFileSync(configPath, stringify(raw, { lineWidth: 120 }));
+    return dropped;
+  }
   /**
    * After `remove --global --harness X`: the harnesses outside `X` that still hold a copy of the
    * asset, or `undefined` when none does (or this is not a harness-limited global remove).
@@ -5162,7 +5878,11 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       }
     }
     if (best) return best;
-    const lib = await this.resolveLibraryEntries([ref], { quiet: true });
+    const lockedLibraries = await this.lockedLibraryNames();
+    const lib = await this.resolveLibraryEntries([ref], {
+      quiet: true,
+      ...lockedLibraries.size > 0 ? { lockedLibraries } : {}
+    });
     return lib.entries[0] ?? null;
   }
   /**
@@ -5184,7 +5904,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     const seen = /* @__PURE__ */ new Set();
     for (const k of kinds) {
       try {
-        const base = deployedBase(k, this.driverTarget, this.global, this.projectDir);
+        const base = deployedBase(k, this.harness, this.global, this.projectDir);
         if (!existsSync(base)) continue;
         for (const item of readdirSync(base, { withFileTypes: true })) {
           let name;
@@ -5226,7 +5946,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
    * @returns One {@link LegacyDeployedAsset} per stale copy, sorted by kind then name.
    */
   listLegacyClaudeDeployed() {
-    if (this.global || this.driverTarget === "claude-code") return [];
+    if (this.global || this.harness === "claude-code") return [];
     const tracked = /* @__PURE__ */ new Map();
     const track = (kind, name) => {
       const component = kind ? this.installTarget(kind) : void 0;
@@ -5254,7 +5974,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     const out = [];
     for (const { kind, name, component: k } of tracked.values()) {
       const legacy = deployedDir(k, name, "claude-code", false, this.projectDir);
-      if (legacy === deployedDir(k, name, this.driverTarget, false, this.projectDir)) continue;
+      if (legacy === deployedDir(k, name, this.harness, false, this.projectDir)) continue;
       const found = deployedPaths(k, name, "claude-code", false, this.projectDir).find((p) => {
         try {
           lstatSync(p);
@@ -5329,9 +6049,13 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
         state = "declared";
       } else if (parsed.kind === "mcp-server") {
         const wired = await wiredMcpNames();
-        const isWired = wired.has(parsed.name) || wired.has(unscopedName(parsed.name));
+        const isWired = wired.has(parsed.name) || wired.has(unscopedName(parsed.name)) || !this.global && await mcpCommittedRenderIntact(
+          this.projectDir,
+          this.harness,
+          unscopedName(parsed.name)
+        );
         const skippedReason = Object.entries(
-          await readSkippedMcpServers(this.projectDir, this.driverTarget)
+          await readSkippedMcpServers(this.projectDir, this.harness)
         ).find(([id]) => id === parsed.name || unscopedName(id) === parsed.name)?.[1];
         const drifted = (await this.mcpDriftRows()).some(
           (r) => unscopedName(r.drift.id) === unscopedName(parsed.name) && r.drift.missing.length + r.drift.modified.length + r.drift.extra.length > 0
@@ -5350,7 +6074,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
           const onDisk = isDeployed(
             component,
             parsed.name,
-            this.driverTarget,
+            this.harness,
             this.global,
             this.projectDir
           );
@@ -5388,7 +6112,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
   async mcpNotices() {
     if (this.global) return [];
     const out = [];
-    const skipped = await readSkippedMcpServers(this.projectDir, this.driverTarget);
+    const skipped = await readSkippedMcpServers(this.projectDir, this.harness);
     for (const [id, reason] of Object.entries(skipped)) {
       out.push({ id, kind: "skipped", reason, text: `MCP server "${id}" is skipped: ${reason}` });
     }
@@ -5433,10 +6157,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       const component = kind ? this.installTarget(kind) : void 0;
       if (!publisher || !kind || !name || !component || component === "agent") continue;
       if (patches[`${kind}:${name}`]) continue;
-      const dest = join(
-        deployedBase(component, this.driverTarget, this.global, this.projectDir),
-        name
-      );
+      const dest = join(deployedBase(component, this.harness, this.global, this.projectDir), name);
       if (!existsSync(dest) || lstatSync(dest).isSymbolicLink()) continue;
       const missing = lockedAssetFiles(kind, entry.files).map((f) => f.rel).filter((rel) => !existsSync(join(dest, rel)));
       if (missing.length > 0) out.push({ ref: `${kind}:@${publisher}/${name}`, missing });
@@ -5453,7 +6174,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       const component = this.installTarget(entry.kind);
       if (!entry.files || !component || component === "agent") continue;
       const dest = join(
-        deployedBase(component, this.driverTarget, this.global, this.projectDir),
+        deployedBase(component, this.harness, this.global, this.projectDir),
         entry.name
       );
       if (!existsSync(dest)) continue;
@@ -5531,7 +6252,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     const repoStatuses = this.buildRepoStatuses(repositories);
     const lockByKindName = indexLockByKindName(lock);
     const entries = [];
-    const instanceFiles = this.global ? /* @__PURE__ */ new Set() : instanceRenderedAgentNames(this.projectDir, this.driverTarget);
+    const instanceFiles = this.global ? /* @__PURE__ */ new Set() : instanceRenderedAgentNames(this.projectDir, this.harness);
     for (const d of deployed) {
       const lockEntry = lockByKindName.get(`${d.kind}:${d.name}`);
       if (!lockEntry && d.kind === "agent" && instanceFiles.has(d.name)) continue;
@@ -5677,11 +6398,12 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     if (!lock) return [];
     const bare = (s) => s.includes("#") ? s.slice(0, s.indexOf("#")) : s;
     const asked = parseRefTolerant(ref);
+    const askedPublisher = asked?.publisher?.replace(/^@/, "");
     const matchesIdentity = (k) => {
       if (bare(k) === bare(ref)) return true;
-      if (!asked || asked.publisher) return false;
+      if (!asked) return false;
       const locked = parseCanonicalLockKey(k);
-      return locked.kind === asked.kind && locked.name === asked.name;
+      return locked.kind === asked.kind && locked.name === asked.name && (!askedPublisher || locked.publisher === askedPublisher);
     };
     const key = lock.assets[ref] ? ref : Object.keys(lock.assets).find(matchesIdentity);
     if (!key) return asked?.kind === "preset" ? this.whyPreset(lock, asked) : [];
@@ -5817,6 +6539,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     const libraryAssets = Object.entries(lock.assets).filter(
       ([, e]) => e.library && !e.library.installed
     );
+    const declaredPins = this.declaredPinsByIdentity();
     if (libraryAssets.length > 0) {
       const snap = await this.loadLibraryIndex();
       const diskHashes = /* @__PURE__ */ new Map();
@@ -5842,6 +6565,8 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
           { kind, publisher, name },
           found.version
         );
+        const declaredPin = declaredPins.get(`${kind}:${publisher}/${name}`);
+        if (declaredPin && diskVersion && !matchPin(declaredPin, diskVersion)) continue;
         if (diskVersion && !isPseudoVersion(diskVersion) && gt(coerceVersion(diskVersion), coerceVersion(origin.version))) {
           result.push({
             kind,
@@ -5880,6 +6605,26 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
               library: lookup.name,
               contentChanged: true
             });
+            continue;
+          }
+        }
+        if (entry.composed && kind === "agent") {
+          const srcDir = statSync(found.source).isDirectory() ? found.source : dirname(found.source);
+          const now = new Map(
+            sourceComposedFiles(srcDir, name, this.projectDir).map((f) => [f.path, f.sha256])
+          );
+          const locked = new Map(entry.composed.map((f) => [f.path, f.sha256]));
+          const same = now.size === locked.size && [...now].every(([f, h]) => locked.get(f) === h);
+          if (!same) {
+            result.push({
+              kind,
+              name,
+              publisher,
+              currentVersion: origin.version,
+              behind: 0,
+              library: lookup.name,
+              contentChanged: true
+            });
           }
         }
       }
@@ -5889,6 +6634,23 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     await this.addPinnedRows(lock, result);
     return this.addLockGapRows(result);
   }
+  /**
+   * The `#pin` of every publisher-qualified `skaile.yaml` dependency, keyed `kind:publisher/name`
+   * (no scope sigil). `update` honours it, so `outdated` must not list a move it keeps.
+   */
+  declaredPinsByIdentity() {
+    const pins = /* @__PURE__ */ new Map();
+    for (const dep of this.loadConfig().dependencies) {
+      try {
+        const p = parseAssetRef(dep);
+        if (p.pin && p.publisher) {
+          pins.set(`${p.kind}:${p.publisher.replace(/^@/, "")}/${p.name}`, p.pin);
+        }
+      } catch {
+      }
+    }
+    return pins;
+  }
   /**
    * List a locked asset whose `skaile.yaml` ref carries a `#version` pin while a source, a
    * library or a store holds a newer one: `locked 0.7.0 -> 0.9.0 (pinned)`. The pin is the
@@ -5993,20 +6755,20 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
   async addLibraryMoves(libraryAssets, rows) {
     const refs = [];
     const lockedIn = /* @__PURE__ */ new Map();
+    const declaredPins = this.declaredPinsByIdentity();
     for (const [key, entry] of libraryAssets) {
       const { publisher, kind, name } = parseCanonicalLockKey(key);
       if (!publisher || !kind || !name || !entry.library) continue;
       const ref = `${kind}:@${publisher}/${name}`;
-      refs.push(ref);
+      const pin = declaredPins.get(`${kind}:${publisher}/${name}`);
+      refs.push(pin ? `${ref}#${pin}` : ref);
       lockedIn.set(ref, { name: entry.library.name, key });
     }
     if (refs.length === 0) return;
     let res;
+    const preferLocked = await this.lockedPreference();
     try {
-      res = await this.resolveLibraryEntries(refs, {
-        quiet: true,
-        preferLocked: await this.lockedPreference()
-      });
+      res = await this.resolveLibraryEntries(refs, { quiet: true, preferLocked });
     } catch {
       return;
     }
@@ -6016,9 +6778,11 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       const ref = `${e.kind}:@${publisher}/${e.name}`;
       const from = lockedIn.get(ref);
       if (!to || !from || from.name === to) continue;
+      const renamedOnly = preferLocked.libraries.get(`${e.kind}:${publisher}/${e.name}`) === to;
       const row = rows.find(
         (r) => r.kind === e.kind && r.name === e.name && r.publisher.replace(/^@/, "") === publisher
       );
+      if (renamedOnly && !row) continue;
       if (row) {
         row.library = from.name;
         row.movesTo = to;
@@ -6150,7 +6914,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
           (r) => unscopedName(r.drift.id) === unscopedName(parsed.name)
         );
         if (!row) return { status: "identical" };
-        const fileSetDiffers = row.drift.extra.length > 0 || row.drift.missing.some((f) => !f.includes(" entry "));
+        const fileSetDiffers = row.drift.extra.length > 0 || row.drift.missing.length > 0;
         return {
           status: "differs",
           diff: mcpDriftDiff(row.drift),
@@ -6171,7 +6935,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     if (parsed.kind === "preset" && this.presetRecorded(parsed)) return { status: "no-files" };
     if (!component) return { status: "not-deployed" };
     if (component === "agent") {
-      const opts = this.deployOptsFor(this.driverTarget);
+      const opts = this.deployOptsFor(this.harness);
       const parts = [diffDeployedAgent(entry, opts)];
       for (const inst of this.instancesBoundTo(parsed)) {
         parts.push(diffDeployedAgent(entry, opts, inst));
@@ -6181,7 +6945,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       return diff === "" ? { status: "identical" } : { status: "differs", diff };
     }
     const deployedPath = join(
-      deployedBase(component, this.driverTarget, this.global, this.projectDir),
+      deployedBase(component, this.harness, this.global, this.projectDir),
       parsed.name
     );
     if (!existsSync(deployedPath)) return { status: "not-deployed" };
@@ -6248,7 +7012,8 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       provenanceIndex,
       overrides,
       stores,
-      declaredRefs: dependencies
+      declaredRefs: dependencies,
+      lockedOrigin: this.lockedOriginVersions()
     });
     this.assertSourceCommitsPublished(resolved, repositories);
     const libraryLock = await this.libraryLockEntries(lib);
@@ -6257,6 +7022,8 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     for (const [key, entry] of Object.entries(lockData.assets)) {
       const rendered = prior?.assets[key]?.rendered;
       if (rendered) entry.rendered = rendered;
+      const composed = prior?.assets[key]?.composed;
+      if (composed) entry.composed = composed;
     }
     writeLock(this.lockPath, lockData);
     return lockData;
@@ -6404,7 +7171,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
         const dep = memberIdentity(depToStr(req));
         if (!dep) continue;
         const depComponent = this.installTarget(dep.kind);
-        if (depComponent && !isDeployed(depComponent, dep.name, this.driverTarget, this.global, this.projectDir)) {
+        if (depComponent && !isDeployed(depComponent, dep.name, this.harness, this.global, this.projectDir)) {
           const inRepos = await resolveAsset({ kind: dep.kind, name: dep.name }, repositories, this.reposDir, {
             knownKinds: this.knownKinds
           }) !== null;
@@ -6616,10 +7383,11 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
         ref: s.url,
         reason,
         message: `source ${s.url} ${reason}`,
-        manualFix: true
+        manualFix: true,
+        unreadableSource: true
       });
     }
-    for (const u of unboundAgentInstances(this.projectDir, this.driverTarget)) {
+    for (const u of unboundAgentInstances(this.projectDir, this.harness)) {
       const reason = u.ref.startsWith("agent:") ? await this.unboundAgentReason(u.id, u.ref) : `is bound by agent instance "${u.id}" but resolves to no agent.yaml \u2014 fix the path, or drop the binding from skaile.yaml`;
       gaps.push({
         type: "agent",
@@ -6842,7 +7610,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
         continue;
       }
       if (lookup.state === "unregistered") {
-        const reason2 = `is locked, but library "${origin.name}" is not registered (renamed or removed?) \u2014 ${unregisteredLibraryFix(origin, ref)}`;
+        const reason2 = `is locked, but library "${unregisteredLibraryName(origin)}" is not registered (renamed or removed?) \u2014 ${unregisteredLibraryFix(origin, ref)}`;
         gaps.push({ type: "library", ref, reason: reason2, message: `${ref} ${reason2}`, manualFix: true });
         continue;
       }
@@ -6862,12 +7630,15 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
    * The locked source assets whose source is no longer in `skaile.yaml` `sources:` (`source
    * remove`, a hand edit), keyed by lock key. ONE sentence for it: `check`, `doctor`, `outdated`,
    * `install`, `install --locked` and `update` all say it (p1062), and none re-clones the source.
-   * A source of a store-resolved lock entry is not told apart from one, so no GitHub source is
-   * called missing while a `stores:` entry exists.
+   * A GitHub lock entry that no source declares counts as store-supplied only when a store
+   * lists the ref (OQ3): a configured store alone proves nothing, as it may never have held
+   * the asset. `check`, `doctor` and `outdated` read the store's cached catalog and never touch
+   * the network; `install` and `update` (`online`) ask the store itself.
    *
    * @param inScope - Only these lock keys count (`install` prunes an undeclared entry as usual).
+   * @param online - Ask the stores when the cached catalog does not list the ref.
    */
-  async orphanedSourceGaps(inScope) {
+  async orphanedSourceGaps(inScope, online = false) {
     const out = /* @__PURE__ */ new Map();
     let config;
     try {
@@ -6875,7 +7646,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     } catch {
       return out;
     }
-    const storeBacked = config.stores.length > 0 || (await this.globalStoreFallback(config.stores, false)).length > 0;
+    const stores = [...config.stores, ...await this.globalStoreFallback(config.stores, false)];
     const registered = new Set(config.sources.map((s) => sourceCacheKey(s.url)));
     for (const [key, entry] of Object.entries(this.tryReadLock()?.assets ?? {})) {
       const url = entry.source?.url;
@@ -6885,13 +7656,38 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       const { publisher, kind, name } = parseCanonicalLockKey(key);
       if (!publisher || !kind || !name) continue;
       if (registered.has(sourceCacheKey(url))) continue;
-      if (storeBacked && GITHUB_REPO_URL.test(url)) continue;
       const ref = `${kind}:@${publisher}/${name}`;
+      if (GITHUB_REPO_URL.test(url) && await this.storeListsRef(stores, ref, online)) continue;
       const reason = `is locked, but its source ${url} is not in skaile.yaml sources: any more \u2014 register it again with \`skaile source add ${url}\`, or drop the dependency with \`skaile remove ${ref}\``;
       out.set(key, { type: "source", ref, reason, message: `${ref} ${reason}`, manualFix: true });
     }
     return out;
   }
+  /**
+   * `true` when one of `stores` lists `ref` (a canonical lock key): its cached catalog holds it
+   * or, with `online`, the store answers for it. An injected store fetcher is the store client
+   * itself, so it is asked either way. A store an online install cannot ask (unreachable,
+   * air-gapped, `--no-catalog`) may hold the ref; `check` never asks, so a store lists only what
+   * its cached catalog holds.
+   */
+  async storeListsRef(stores, ref, online) {
+    for (const store of stores) {
+      try {
+        if (this.injectedStoreFetcher) {
+          if (await this.injectedStoreFetcher.getInstallManifest(store.url, ref)) return true;
+          continue;
+        }
+        const remote = this.remoteStore(store.url);
+        if (remote.holdsCached(ref)) return true;
+        if (!online) continue;
+        if (this.catalogUrlOverride === "") return true;
+        if (await remote.resolve(ref)) return true;
+      } catch {
+        if (online) return true;
+      }
+    }
+    return false;
+  }
   /**
    * Locked source assets whose source cannot supply them any more: the source is no longer in
    * `skaile.yaml` `sources:` (`source remove`, a hand edit), or it is there but now publishes
@@ -6948,8 +7744,12 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
    * rendering occupies and their sha256. Call it after the deploy, so the bytes hashed are the
    * ones `install` just wrote; {@link lockedCopyDrift} compares later edits with them.
    * Entries that carry a record (kept from an earlier lock) are left as they are.
+   *
+   * @param keepComposedOf - The lock an `install` read: an agent whose `../` compose folder is
+   *   not in the cache keeps that lock's `composed:` record. Omitted by `update` and `add`,
+   *   which copy the library's current bytes.
    */
-  withRenderedAgents(lock) {
+  withRenderedAgents(lock, keepComposedOf) {
     if (this.global) return lock;
     for (const [key, entry] of Object.entries(lock.assets)) {
       if (entry.rendered || entry.library?.installed) continue;
@@ -6958,6 +7758,18 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       const rendered = this.renderedAgentFiles(name);
       if (rendered.length > 0) entry.rendered = rendered;
     }
+    for (const [key, entry] of Object.entries(lock.assets)) {
+      if (entry.library?.installed) continue;
+      const { kind, name } = parseCanonicalLockKey(key);
+      if (!kind || !name || this.installTarget(kind) !== "agent") continue;
+      const composed = cachedComposedFiles(name, this.projectDir);
+      if (composed.length > 0) entry.composed = composed;
+      else {
+        const earlier = keepComposedOf?.assets[key]?.composed;
+        if (earlier?.length) entry.composed = earlier;
+        else delete entry.composed;
+      }
+    }
     return this.withInstanceRenderings(lock);
   }
   /**
@@ -6983,7 +7795,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       ownFiles.set(key, new Set(this.renderedAgentFiles(name).map((f) => f.path)));
     }
     const instanceFiles = /* @__PURE__ */ new Map();
-    for (const instance of renderedInstanceFiles(this.projectDir, this.driverTarget)) {
+    for (const instance of renderedInstanceFiles(this.projectDir, this.harness)) {
       const want = parseRefTolerant(instance.ref);
       if (!want || want.kind !== "agent") continue;
       const wantPublisher = want.publisher?.replace(/^@/, "");
@@ -7038,12 +7850,12 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
   /** The files of one agent's rendering for the active harness, project-relative, with sha256. */
   renderedAgentFiles(name) {
     const out = [];
-    for (const path2 of deployedPaths("agent", name, this.driverTarget, false, this.projectDir)) {
+    for (const path2 of deployedPaths("agent", name, this.harness, false, this.projectDir)) {
       this.hashTree(path2, out);
     }
     this.hashTree(
       join(
-        dirname(deployedBase("agent", this.driverTarget, false, this.projectDir)),
+        dirname(deployedBase("agent", this.harness, false, this.projectDir)),
         CODEX_IDENTITY_DIR,
         `${name}.md`
       ),
@@ -7110,7 +7922,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       if (!kind || !name || !component) continue;
       const dir = relative(
         this.projectDir,
-        deployedDir(component, name, this.driverTarget, this.global, this.projectDir)
+        deployedDir(component, name, this.harness, this.global, this.projectDir)
       ).split(sep).join("/");
       out.push({
         ref: d.key,
@@ -7127,7 +7939,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       if (!kind || !name || !component) continue;
       const dir = relative(
         this.projectDir,
-        deployedDir(component, name, this.driverTarget, this.global, this.projectDir)
+        deployedDir(component, name, this.harness, this.global, this.projectDir)
       ).split(sep).join("/");
       const files = inc.missing.map((f) => `${dir}/${f}`);
       const row = out.find((r) => r.ref.split("#")[0] === bare);
@@ -7161,7 +7973,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     const out = [];
     const deployOpts = {
       registry: this.registry,
-      driverTarget: this.driverTarget,
+      harness: this.harness,
       global: this.global,
       cwd: this.projectDir
     };
@@ -7185,7 +7997,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       const component = kind ? this.installTarget(kind) : void 0;
       if (!kind || !name || !component || component === "agent") continue;
       if (patches[`${kind}:${name}`]) continue;
-      const dest = deployedDir(component, name, this.driverTarget, this.global, this.projectDir);
+      const dest = deployedDir(component, name, this.harness, this.global, this.projectDir);
       try {
         const deployed = lstatSync(dest);
         if (deployed.isSymbolicLink() || !deployed.isDirectory()) continue;
@@ -7213,12 +8025,13 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
         out.push({ ref: refOf(key), key, modified, extra, library: false });
     }
     for (const [key, entry] of Object.entries(lock.assets)) {
-      if (!entry.rendered || entry.rendered.length === 0 || entry.library?.installed) continue;
+      const recorded = [...entry.rendered ?? [], ...entry.composed ?? []];
+      if (recorded.length === 0 || entry.library?.installed) continue;
       const { kind, name } = parseCanonicalLockKey(key);
       if (!kind || !name || this.installTarget(kind) !== "agent") continue;
       if (patches[`${kind}:${name}`]) continue;
       const modified = [];
-      for (const f of entry.rendered) {
+      for (const f of recorded) {
         const file = join(this.projectDir, f.path);
         if (!existsSync(file)) continue;
         try {
@@ -7229,7 +8042,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       }
       if (modified.length > 0) {
         const instanceOf = /* @__PURE__ */ new Map();
-        for (const inst of renderedInstanceFiles(this.projectDir, this.driverTarget)) {
+        for (const inst of renderedInstanceFiles(this.projectDir, this.harness)) {
           for (const f of inst.files) if (modified.includes(f)) instanceOf.set(f, inst.id);
         }
         out.push({
@@ -7239,7 +8052,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
           extra: [],
           library: false,
           rendered: true,
-          lockedSha: new Map(entry.rendered.map((f) => [f.path, f.sha256])),
+          lockedSha: new Map(recorded.map((f) => [f.path, f.sha256])),
           instanceOf
         });
       }
@@ -7259,7 +8072,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       const { publisher, kind, name } = parseCanonicalLockKey(key);
       const component = kind ? this.installTarget(kind) : void 0;
       if (!kind || !name || !component || named.has(`${kind}:${name}`)) continue;
-      if (isDeployed(component, name, this.driverTarget, this.global, this.projectDir)) {
+      if (isDeployed(component, name, this.harness, this.global, this.projectDir)) {
         const renderedGone = component === "agent" && !this.global && (entry.rendered ?? []).some((f) => !existsSync(join(this.projectDir, f.path)));
         if (!renderedGone) continue;
       }
@@ -7267,7 +8080,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       const dangling = deployedPaths(
         component,
         name,
-        this.driverTarget,
+        this.harness,
         this.global,
         this.projectDir
       ).find((p) => isSymlink(p) && !existsSync(p));
@@ -7352,10 +8165,23 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
           ({ id }) => id.kind === want.kind && id.name === want.name && (!want.publisher || id.publisher === want.publisher)
         );
         if (held.length > 0 && !held.some(({ id }) => !id.version || matchPin(want.pin, id.version))) {
-          gap = {
-            type: "pin",
-            reason: `is pinned in skaile.yaml but the lock holds ${held.map((h) => h.key).join(", ")} \u2014 run \`skaile install\``
-          };
+          const lockHolds = held.map((h) => h.key).join(", ");
+          const pinned = await this.info(d.ref);
+          const pinHeld = pinned !== null && matchPin(want.pin, pinned.version ?? "");
+          if (!pinHeld && this.loadConfig().stores.length === 0) {
+            const plainRef = d.ref.split("#")[0] ?? d.ref;
+            const other = pinned ?? await this.info(plainRef);
+            gap = {
+              type: "pin",
+              reason: `is pinned in skaile.yaml but the lock holds ${lockHolds}, and no library or source holds ${want.pin}${other?.version ? ` (${want.name} has version(s): ${other.version})` : ""} \u2014 change the pin in skaile.yaml`,
+              manualFix: true
+            };
+          } else {
+            gap = {
+              type: "pin",
+              reason: `is pinned in skaile.yaml but the lock holds ${lockHolds} \u2014 run \`skaile install\``
+            };
+          }
         }
       }
       if (gap) gaps.push({ ...gap, ref: d.ref, message: `${d.ref} ${gap.reason}` });
@@ -7585,7 +8411,7 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
       for (const dest of deployedPaths(
         component,
         name,
-        this.driverTarget,
+        this.harness,
         this.global,
         this.projectDir
       )) {
@@ -7806,8 +8632,8 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
     }
     if (ids.length === 0) return false;
     writeFileSync(configPath, stringify(raw, { lineWidth: 120 }));
-    for (const driverTarget of this.targetHarnesses()) {
-      removeAgentInstanceRenderings({ projectDir: this.projectDir, driverTarget, ids });
+    for (const harness of this.targetHarnesses()) {
+      removeAgentInstanceRenderings({ projectDir: this.projectDir, harness, ids });
     }
     return true;
   }
@@ -7828,6 +8654,6 @@ Nothing was changed. Declare it again to keep it, or run \`skaile install --forc
   }
 };
 
-export { AssetManager, FACTORY_SOURCE_URL, LibraryEntryError, MissingManifestError, installAgentInstances, normalizeRepoUrl, parseCanonicalLockKey, parseRefTolerant, renderMcpServerConfig, softDepName };
-//# sourceMappingURL=chunk-MRHVPQNO.js.map
-//# sourceMappingURL=chunk-MRHVPQNO.js.map
+export { AssetManager, FACTORY_SOURCE_URL, LibraryEntryError, MissingManifestError, installAgentInstances, mcpNotRunnableReason, normalizeRepoUrl, parseCanonicalLockKey, parseRefTolerant, renderMcpServerConfig, setLibraryAssetCheck, softDepName };
+//# sourceMappingURL=chunk-HWNK3F3X.js.map
+//# sourceMappingURL=chunk-HWNK3F3X.js.map