@skaile/workspaces 6.0.0 → 6.2.0

package/dist/{chunk-UL22SDGR.js → chunk-6CYKTHNT.js}

@@ -1,14 +1,14 @@
-import { readManifestSourceConfig, discoverAssetsInTree, barePublisher, createDefaultKindRegistry, sharesItsFolder, SEMVER_RE, invalidSemverMessage, parseManifestFile } from './chunk-QOM5Z62G.js';
-import { installFromManifest, assertSafeManifestPath } from './chunk-7XSAW5OC.js';
-import { PresetManifestSchema } from './chunk-E572OHGY.js';
-import { defaultLibraryDir, resolveLibraryDir, GLOBAL_INSTALL_DIR_NAME, readLock, buildLibraryLockEntries, writeLock, mergeLockFile, buildLockFile, ManifestYamlEditor } from './chunk-L4YKW5AY.js';
-import { getGlobalCacheDir, storeManifestSlug, priorStoreManifestSlugs, resolveSourcePublisher } from './chunk-OHNKYHRR.js';
+import { readManifestSourceConfig, discoverAssetsInTree, barePublisher, createDefaultKindRegistry, sharesItsFolder, SEMVER_RE, invalidSemverMessage, parseManifestFile } from './chunk-MAZ3UXJK.js';
+import { installFromManifest, assertSafeManifestPath } from './chunk-E5NQRHEB.js';
+import { PresetManifestSchema } from './chunk-76FLBODK.js';
+import { defaultLibraryDir, resolveLibraryDir, GLOBAL_INSTALL_DIR_NAME, readLock, buildLibraryLockEntries, writeLock, mergeLockFile, buildLockFile, ManifestYamlEditor } from './chunk-BRK5QZKI.js';
+import { getGlobalCacheDir, storeManifestSlug, priorStoreManifestSlugs, resolveSourcePublisher } from './chunk-KJSC2ZD6.js';
 import { userConfigPath, globalSkaileDir, mergeLegacyEntriesInto, migrateLegacyDir, globalCacheRoot } from './chunk-L5VSIPQD.js';
-import { encodeSkaileManifest, expandManifestFiles, SKAILE_MANIFEST_FILENAME, librarySymlinkMessage, loadSkPublishManifest } from './chunk-UQ33Y4DM.js';
-import { scanDirectory } from './chunk-GOCWM7FN.js';
-import { parseAssetRef, assetRefToStr, isValidAssetName } from './chunk-WDXZA7QW.js';
+import { encodeSkaileManifest, expandManifestFiles, SKAILE_MANIFEST_FILENAME, librarySymlinkMessage, loadSkPublishManifest } from './chunk-KPKGWXUJ.js';
+import { scanDirectory } from './chunk-JMIKGAUA.js';
+import { parseAssetRef, assetRefToStr, isValidAssetName } from './chunk-IZQOO6MN.js';
 import { __export } from './chunk-NSBPE2FW.js';
-import * as fs11 from 'fs';
+import * as fs12 from 'fs';
 import { existsSync, mkdirSync, symlinkSync, copyFileSync, cpSync } from 'fs';
 import * as path16 from 'path';
 import { resolve, relative, sep, join, dirname } from 'path';
@@ -121,9 +121,9 @@ function projectConfigPath(projectDir) {
   return path16.join(projectDir, ".skaile", CONFIG_FILENAME);
 }
 function loadConfigFile(filePath) {
-  if (!fs11.existsSync(filePath)) return null;
+  if (!fs12.existsSync(filePath)) return null;
   try {
-    const content = fs11.readFileSync(filePath, "utf-8");
+    const content = fs12.readFileSync(filePath, "utf-8");
     const raw = parse(content);
     if (!raw || typeof raw !== "object") return null;
     return SkaileConfigSchema.partial().parse(raw);
@@ -172,10 +172,10 @@ function resolveConfig(opts) {
 }
 function saveConfig(filePath, config) {
   const dir = path16.dirname(filePath);
-  if (!fs11.existsSync(dir)) {
-    fs11.mkdirSync(dir, { recursive: true });
+  if (!fs12.existsSync(dir)) {
+    fs12.mkdirSync(dir, { recursive: true });
   }
-  fs11.writeFileSync(filePath, stringify(config, { indent: 2 }), "utf-8");
+  fs12.writeFileSync(filePath, stringify(config, { indent: 2 }), "utf-8");
 }
 var KnowledgeManifestSchema = z3.looseObject({
   name: z3.string().optional(),
@@ -202,9 +202,9 @@ function validateKnowledge(data) {
 // library/src/knowledge/knowledge-kind-provider.ts
 function collectDirRecursive(baseDir, relativeDir) {
   const full = path16.join(baseDir, relativeDir);
-  if (!fs11.existsSync(full) || !fs11.statSync(full).isDirectory()) return [];
+  if (!fs12.existsSync(full) || !fs12.statSync(full).isDirectory()) return [];
   const results = [];
-  for (const entry of fs11.readdirSync(full, { withFileTypes: true })) {
+  for (const entry of fs12.readdirSync(full, { withFileTypes: true })) {
     const rel = path16.posix.join(relativeDir, entry.name);
     if (entry.isDirectory()) {
       results.push(...collectDirRecursive(baseDir, rel));
@@ -312,7 +312,7 @@ var assignments = sqliteTable("assignments", {
   assignedAt: text("assigned_at").notNull()
 });
 function isClone(dir) {
-  return fs11.existsSync(path16.join(dir, ".git"));
+  return fs12.existsSync(path16.join(dir, ".git"));
 }
 function getSidecarRoot() {
   const home = globalSkaileDir();
@@ -346,9 +346,9 @@ function deriveSlug(sourceConfig, sourcePath, existingSlugs) {
 }
 function listSidecarSlugsOnDisk() {
   const root = getSidecarRoot();
-  if (!fs11.existsSync(root)) return [];
+  if (!fs12.existsSync(root)) return [];
   const out = [];
-  for (const entry of fs11.readdirSync(root, { withFileTypes: true })) {
+  for (const entry of fs12.readdirSync(root, { withFileTypes: true })) {
     if (!entry.isDirectory()) continue;
     if (entry.name.startsWith(".")) continue;
     out.push(entry.name);
@@ -369,16 +369,16 @@ function getStoreManifestsDir() {
 function storeManifestFile(sourceUrl) {
   const dir = getStoreManifestsDir();
   const current = path16.join(dir, `${storeManifestSlug(sourceUrl)}.yaml`);
-  if (fs11.existsSync(current)) return current;
+  if (fs12.existsSync(current)) return current;
   for (const slug of priorStoreManifestSlugs(sourceUrl)) {
     const old = path16.join(dir, `${slug}.yaml`);
-    if (fs11.existsSync(old)) return old;
+    if (fs12.existsSync(old)) return old;
   }
   return current;
 }
 function curatedManifestOverlay(sourceUrl) {
   const file = storeManifestFile(sourceUrl);
-  return fs11.existsSync(file) ? file : void 0;
+  return fs12.existsSync(file) ? file : void 0;
 }
 function commitStoreManifest(file, message) {
   const root = getStoreRoot();
@@ -410,14 +410,14 @@ function migratedMarkerPath() {
 }
 function collectSidecarMigrationCandidates(sidecarRoot) {
   const candidates = [];
-  if (fs11.existsSync(sidecarRoot)) {
-    for (const entry of fs11.readdirSync(sidecarRoot, { withFileTypes: true })) {
+  if (fs12.existsSync(sidecarRoot)) {
+    for (const entry of fs12.readdirSync(sidecarRoot, { withFileTypes: true })) {
       if (!entry.isDirectory()) continue;
       if (entry.name.startsWith(".")) continue;
       const sidecarDir = path16.join(sidecarRoot, entry.name);
       const current = path16.join(sidecarDir, "skaile.manifest.yaml");
       const legacy = path16.join(sidecarDir, ".skaile-source.yaml");
-      const src = fs11.existsSync(current) ? current : fs11.existsSync(legacy) ? legacy : void 0;
+      const src = fs12.existsSync(current) ? current : fs12.existsSync(legacy) ? legacy : void 0;
       if (src) candidates.push({ src, slug: entry.name });
     }
   }
@@ -427,9 +427,9 @@ function moveSidecarManifests(candidates, manifestsDir) {
   let migrated = 0;
   for (const { src, slug } of candidates) {
     const dest = path16.join(manifestsDir, `${slug}.yaml`);
-    if (fs11.existsSync(dest)) continue;
+    if (fs12.existsSync(dest)) continue;
     try {
-      fs11.renameSync(src, dest);
+      fs12.renameSync(src, dest);
       migrated++;
     } catch (err) {
       process.stderr.write(
@@ -441,10 +441,10 @@ function moveSidecarManifests(candidates, manifestsDir) {
   return migrated;
 }
 function initStoreGitRepo(storeRoot) {
-  if (fs11.existsSync(path16.join(storeRoot, ".git"))) return;
+  if (fs12.existsSync(path16.join(storeRoot, ".git"))) return;
   try {
     spawnSync("git", ["init", "--quiet"], { cwd: storeRoot, stdio: "ignore" });
-    fs11.writeFileSync(
+    fs12.writeFileSync(
       path16.join(storeRoot, ".gitignore"),
       "# Remote-store cache \u2014 local to this machine.\nremote-cache/\n",
       "utf8"
@@ -455,14 +455,14 @@ function initStoreGitRepo(storeRoot) {
 function migrateSidecarsToStoreIfNeeded() {
   const storeRoot = getStoreRoot();
   const marker = migratedMarkerPath();
-  if (fs11.existsSync(marker)) return { migrated: 0, storeRoot };
+  if (fs12.existsSync(marker)) return { migrated: 0, storeRoot };
   const sidecarRoot = getSidecarRoot();
   const manifestsDir = getStoreManifestsDir();
   const candidates = collectSidecarMigrationCandidates(sidecarRoot);
-  fs11.mkdirSync(manifestsDir, { recursive: true });
+  fs12.mkdirSync(manifestsDir, { recursive: true });
   const migrated = moveSidecarManifests(candidates, manifestsDir);
   initStoreGitRepo(storeRoot);
-  fs11.writeFileSync(marker, (/* @__PURE__ */ new Date()).toISOString(), "utf8");
+  fs12.writeFileSync(marker, (/* @__PURE__ */ new Date()).toISOString(), "utf8");
   return { migrated, storeRoot };
 }
 
@@ -707,7 +707,7 @@ async function purgeOrphanedAssetDefinitions(client) {
   await client.execute(`PRAGMA user_version = ${ORPHAN_PURGE_VERSION}`);
 }
 function assertNoLegacyLibDb(newDbPath) {
-  if (fs11.existsSync(newDbPath)) return;
+  if (fs12.existsSync(newDbPath)) return;
   const parent = path16.dirname(newDbPath);
   const skaileHome = globalSkaileDir();
   const defaultIndexPath2 = path16.join(skaileHome, "index.db");
@@ -723,7 +723,7 @@ function assertNoLegacyLibDb(newDbPath) {
     candidates.push(path16.join(path16.dirname(parent), "library", "lib.db"));
   }
   for (const legacy of candidates) {
-    if (!fs11.existsSync(legacy)) continue;
+    if (!fs12.existsSync(legacy)) continue;
     throw new Error(
       `Found legacy index database at ${legacy}. The lib.db \u2192 index.db relocation ran for one release and has been removed. Move the file manually to ${newDbPath} (and any -wal / -shm siblings), then retry.`
     );
@@ -898,12 +898,12 @@ var LocalIndex = class {
       dbPath = resolveIndexPath();
       this._kindRegistry = optionsOrDir?.kindRegistry;
     }
-    if (!fs11.existsSync(dir)) {
-      fs11.mkdirSync(dir, { recursive: true });
+    if (!fs12.existsSync(dir)) {
+      fs12.mkdirSync(dir, { recursive: true });
     }
     const dbParent = path16.dirname(dbPath);
-    if (!fs11.existsSync(dbParent)) {
-      fs11.mkdirSync(dbParent, { recursive: true });
+    if (!fs12.existsSync(dbParent)) {
+      fs12.mkdirSync(dbParent, { recursive: true });
     }
     this.libraryDir = dir;
     this.dbPath = dbPath;
@@ -1250,17 +1250,20 @@ var LocalIndex = class {
 var UNREGISTERED_FILE = ".unregistered-libraries";
 function libraryDirMissing(lib) {
   try {
-    return !fs11.statSync(lib.path).isDirectory();
+    return !fs12.statSync(lib.path).isDirectory();
   } catch {
     return true;
   }
 }
 function missingLibraryDirMessage(lib) {
-  return `library "${lib.name}" is registered but its directory ${lib.path} is missing - run skaile library init ${lib.name} --path <dir> or skaile library remove ${lib.name}`;
+  const cfg = lib.backendConfig;
+  const cloneUrl = lib.ownership === "reader" && cfg && typeof cfg === "object" && "url" in cfg ? String(cfg.url) : void 0;
+  const head = `library "${lib.name}" is registered but its directory ${lib.path} is missing - `;
+  return cloneUrl ? `${head}it is the clone of the source ${cloneUrl}: run skaile source sync in a project that declares it, or skaile library remove ${lib.name}` : `${head}run skaile library init ${lib.name} --path <dir> or skaile library remove ${lib.name}`;
 }
 function realDir(dir) {
   try {
-    return fs11.realpathSync(dir);
+    return fs12.realpathSync(dir);
   } catch {
     return path16.resolve(dir);
   }
@@ -1268,7 +1271,7 @@ function realDir(dir) {
 function unregisteredLibraryNames() {
   try {
     return new Set(
-      fs11.readFileSync(path16.join(resolveLibraryDir(), UNREGISTERED_FILE), "utf8").split("\n").map((l) => l.trim()).filter(Boolean)
+      fs12.readFileSync(path16.join(resolveLibraryDir(), UNREGISTERED_FILE), "utf8").split("\n").map((l) => l.trim()).filter(Boolean)
     );
   } catch {
     return /* @__PURE__ */ new Set();
@@ -1279,8 +1282,8 @@ function markLibraryUnregistered(lib) {
   const known = unregisteredLibraryNames();
   const add = [.../* @__PURE__ */ new Set([lib.name, path16.basename(lib.path)])].filter((n) => !known.has(n));
   if (add.length === 0) return;
-  fs11.mkdirSync(resolveLibraryDir(), { recursive: true });
-  fs11.appendFileSync(
+  fs12.mkdirSync(resolveLibraryDir(), { recursive: true });
+  fs12.appendFileSync(
     path16.join(resolveLibraryDir(), UNREGISTERED_FILE),
     `${add.join("\n")}
 `,
@@ -1297,62 +1300,80 @@ function clearLibraryUnregistered(lib) {
   const keep = [...known].filter((n) => !drop.has(n));
   if (keep.length === known.size) return;
   const file = path16.join(resolveLibraryDir(), UNREGISTERED_FILE);
-  if (keep.length === 0) fs11.rmSync(file, { force: true });
-  else fs11.writeFileSync(file, `${keep.join("\n")}
+  if (keep.length === 0) fs12.rmSync(file, { force: true });
+  else fs12.writeFileSync(file, `${keep.join("\n")}
 `, "utf8");
 }
 var RENAMED_FILE = ".renamed-libraries";
-function readRenames() {
+function readAllRenames() {
   const out = /* @__PURE__ */ new Map();
   try {
-    for (const line of fs11.readFileSync(path16.join(resolveLibraryDir(), RENAMED_FILE), "utf8").split("\n")) {
-      const [from, to] = line.split("	").map((s) => s.trim());
-      if (from && to && from !== to) out.set(from, to);
+    for (const line of fs12.readFileSync(path16.join(resolveLibraryDir(), RENAMED_FILE), "utf8").split("\n")) {
+      const [from, to, flag] = line.split("	").map((s) => s.trim());
+      if (from && to && from !== to) out.set(from, { to, gone: flag === "gone" });
     }
   } catch {
   }
   return out;
 }
-function writeRenames(renames) {
+function writeAllRenames(renames) {
   const file = path16.join(resolveLibraryDir(), RENAMED_FILE);
   if (renames.size === 0) {
-    fs11.rmSync(file, { force: true });
+    fs12.rmSync(file, { force: true });
     return;
   }
-  fs11.mkdirSync(resolveLibraryDir(), { recursive: true });
-  fs11.writeFileSync(
+  fs12.mkdirSync(resolveLibraryDir(), { recursive: true });
+  fs12.writeFileSync(
     file,
-    `${[...renames].map(([from, to]) => `${from}	${to}`).join("\n")}
+    `${[...renames].map(([from, r]) => `${from}	${r.to}${r.gone ? "	gone" : ""}`).join("\n")}
 `,
     "utf8"
   );
 }
 function recordLibraryRename(from, to) {
   if (from === to) return;
-  const renames = readRenames();
-  for (const [k, v] of renames) if (v === from) renames.set(k, to);
+  const renames = readAllRenames();
+  for (const [k, r] of renames) if (r.to === from && !r.gone) renames.set(k, { to, gone: false });
   renames.delete(to);
-  renames.set(from, to);
-  for (const [k, v] of renames) if (k === v) renames.delete(k);
-  writeRenames(renames);
+  renames.set(from, { to, gone: false });
+  for (const [k, r] of renames) if (k === r.to) renames.delete(k);
+  writeAllRenames(renames);
 }
 function renamedLibraryName(name) {
-  return readRenames().get(name);
+  const r = readAllRenames().get(name);
+  return r && !r.gone ? r.to : void 0;
+}
+function lastLibraryName(name) {
+  const renames = readAllRenames();
+  let at = name;
+  const seen = /* @__PURE__ */ new Set();
+  for (let next = renames.get(at); next && !seen.has(at); next = renames.get(at)) {
+    seen.add(at);
+    at = next.to;
+  }
+  return at === name ? void 0 : at;
 }
 function clearLibraryRenamed(name) {
-  const renames = readRenames();
-  if (renames.delete(name)) writeRenames(renames);
+  const renames = readAllRenames();
+  let changed = renames.delete(name);
+  for (const [from, r] of renames) {
+    if (r.gone && r.to === name) {
+      renames.delete(from);
+      changed = true;
+    }
+  }
+  if (changed) writeAllRenames(renames);
 }
 function dropLibraryRenamesTo(name) {
-  const renames = readRenames();
+  const renames = readAllRenames();
   let changed = false;
-  for (const [from, to] of renames) {
-    if (to === name) {
-      renames.delete(from);
+  for (const [from, r] of renames) {
+    if (r.to === name && !r.gone) {
+      renames.set(from, { to: name, gone: true });
       changed = true;
     }
   }
-  if (changed) writeRenames(renames);
+  if (changed) writeAllRenames(renames);
 }
 
 // library/src/user-library.ts
@@ -1886,8 +1907,8 @@ var LibraryManager = class {
   async removeLibrary(nameOrId, opts = {}) {
     const lib = await this.requireLibrary(nameOrId);
     await this.lib.removeSource(lib.id);
-    if (opts.purge && fs11.existsSync(lib.path)) {
-      fs11.rmSync(lib.path, { recursive: true, force: true });
+    if (opts.purge && fs12.existsSync(lib.path)) {
+      fs12.rmSync(lib.path, { recursive: true, force: true });
     }
     dropLibraryRenamesTo(lib.name);
     if (!opts.purge) markLibraryUnregistered(lib);
@@ -1906,7 +1927,7 @@ var LibraryManager = class {
     );
     if (writableDefault) return { library: writableDefault, created: false };
     const personalPath = path16.join(librariesDir, "personal");
-    fs11.mkdirSync(personalPath, { recursive: true });
+    fs12.mkdirSync(personalPath, { recursive: true });
     const lib = await this.addLibrary({
       name: "personal",
       path: personalPath,
@@ -2089,12 +2110,20 @@ var LocalCatalogSource = class {
     }
     const keepRefs = assets.map((a) => a.ref);
     let pruned = [];
-    if (!syncOpts?.only && result.assets.length > 0) {
+    if (!syncOpts?.only && (result.assets.length > 0 || isReadableDirectory(this.rootPath))) {
       pruned = await this.library.pruneAssetDefs(this.sourceId, keepRefs);
     }
     return { assetsFound: assets.length, assetsUpdated, errors, advisories, pruned };
   }
 };
+function isReadableDirectory(dir) {
+  try {
+    fs12.readdirSync(dir);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function defToCatalogAsset(def) {
   return {
     id: def.id,
@@ -2231,11 +2260,11 @@ var SidecarGit = class {
    * @docLink packages/library/concepts#sidecar-git
    */
   async ensureInitialized() {
-    if (!fs11.existsSync(this.rootDir)) {
-      fs11.mkdirSync(this.rootDir, { recursive: true });
+    if (!fs12.existsSync(this.rootDir)) {
+      fs12.mkdirSync(this.rootDir, { recursive: true });
     }
     const gitDir = path16.join(this.rootDir, ".git");
-    const freshRepo = !fs11.existsSync(gitDir);
+    const freshRepo = !fs12.existsSync(gitDir);
     if (freshRepo) {
       const init = this.spawn(["init", "-b", "main"]);
       if (init.exitCode !== 0) {
@@ -2243,9 +2272,9 @@ var SidecarGit = class {
       }
     }
     const attrsPath = path16.join(this.rootDir, ".gitattributes");
-    if (!fs11.existsSync(attrsPath)) fs11.writeFileSync(attrsPath, GITATTRIBUTES, "utf-8");
+    if (!fs12.existsSync(attrsPath)) fs12.writeFileSync(attrsPath, GITATTRIBUTES, "utf-8");
     const readmePath = path16.join(this.rootDir, "README.md");
-    if (!fs11.existsSync(readmePath)) fs11.writeFileSync(readmePath, ROOT_README, "utf-8");
+    if (!fs12.existsSync(readmePath)) fs12.writeFileSync(readmePath, ROOT_README, "utf-8");
     if (!this.hasGlobalGitConfig("user.name")) {
       this.spawn(["config", "user.name", FALLBACK_USER_NAME]);
     }
@@ -2271,7 +2300,7 @@ var SidecarGit = class {
   async commit(slug, message, opts) {
     if (opts?.skip) return;
     const slugDir = path16.join(this.rootDir, slug);
-    if (fs11.existsSync(slugDir)) {
+    if (fs12.existsSync(slugDir)) {
       this.spawn(["add", "--", slug]);
     } else {
       this.spawn(["add", "-A"]);
@@ -2332,10 +2361,10 @@ ${result.stderr}`;
 function migrateWorkspaceConfig(dir, opts) {
   const filename = opts?.filename ?? "skaile.yaml";
   const filePath = path16.join(dir, filename);
-  if (!fs11.existsSync(filePath)) {
+  if (!fs12.existsSync(filePath)) {
     return { migrated: false, version: 1, warnings: ["No skaile.yaml found"] };
   }
-  const content = fs11.readFileSync(filePath, "utf-8");
+  const content = fs12.readFileSync(filePath, "utf-8");
   const raw = parse(content);
   if (!raw || typeof raw !== "object") {
     return { migrated: false, version: 1, warnings: ["Invalid YAML content"] };
@@ -2367,7 +2396,7 @@ function migrateWorkspaceConfig(dir, opts) {
     } else {
       doc.set("version", 2);
     }
-    fs11.writeFileSync(filePath, doc.toString(), "utf-8");
+    fs12.writeFileSync(filePath, doc.toString(), "utf-8");
   }
   return {
     migrated: !opts?.dryRun,
@@ -3261,17 +3290,17 @@ var CatalogCache = class {
   /** Read a cached tarball from disk if present, otherwise `null`. */
   readTarball(sha256) {
     const p = this.tarballPath(sha256);
-    if (!fs11.existsSync(p)) return null;
-    return fs11.readFileSync(p);
+    if (!fs12.existsSync(p)) return null;
+    return fs12.readFileSync(p);
   }
   /** Persist a tarball blob to disk (atomic write). */
   writeTarball(sha256, bytes) {
     const dir = path16.join(this.dir, TARBALL_DIR);
-    if (!fs11.existsSync(dir)) fs11.mkdirSync(dir, { recursive: true });
+    if (!fs12.existsSync(dir)) fs12.mkdirSync(dir, { recursive: true });
     const finalPath = this.tarballPath(sha256);
     const tmpPath = `${finalPath}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
-    fs11.writeFileSync(tmpPath, bytes);
-    fs11.renameSync(tmpPath, finalPath);
+    fs12.writeFileSync(tmpPath, bytes);
+    fs12.renameSync(tmpPath, finalPath);
   }
   // ── public: invalidation ────────────────────────────────────────────────
   /**
@@ -3291,8 +3320,8 @@ var CatalogCache = class {
   invalidateEverything() {
     this.invalidateAll();
     const tarballDir = path16.join(this.dir, TARBALL_DIR);
-    if (fs11.existsSync(tarballDir)) {
-      fs11.rmSync(tarballDir, { recursive: true, force: true });
+    if (fs12.existsSync(tarballDir)) {
+      fs12.rmSync(tarballDir, { recursive: true, force: true });
     }
   }
   /** Return whether `ttlMs` is zero (air-gapped mode). */
@@ -3301,9 +3330,9 @@ var CatalogCache = class {
   }
   // ── private ─────────────────────────────────────────────────────────────
   ensureDir() {
-    if (!fs11.existsSync(this.dir)) fs11.mkdirSync(this.dir, { recursive: true });
+    if (!fs12.existsSync(this.dir)) fs12.mkdirSync(this.dir, { recursive: true });
     const tarballDir = path16.join(this.dir, TARBALL_DIR);
-    if (!fs11.existsSync(tarballDir)) fs11.mkdirSync(tarballDir, { recursive: true });
+    if (!fs12.existsSync(tarballDir)) fs12.mkdirSync(tarballDir, { recursive: true });
   }
   indexPath() {
     return path16.join(this.dir, INDEX_FILE);
@@ -3311,12 +3340,12 @@ var CatalogCache = class {
   loadIndex() {
     if (this.index) return this.index;
     const p = this.indexPath();
-    if (!fs11.existsSync(p)) {
+    if (!fs12.existsSync(p)) {
       this.index = { version: 1, resolve: {}, list: {} };
       return this.index;
     }
     try {
-      const raw = JSON.parse(fs11.readFileSync(p, "utf-8"));
+      const raw = JSON.parse(fs12.readFileSync(p, "utf-8"));
       if (raw && typeof raw === "object" && raw.version === 1) {
         this.index = {
           version: 1,
@@ -3334,8 +3363,8 @@ var CatalogCache = class {
     this.index = idx;
     const p = this.indexPath();
     const tmp = `${p}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
-    fs11.writeFileSync(tmp, JSON.stringify(idx, null, 2), "utf-8");
-    fs11.renameSync(tmp, p);
+    fs12.writeFileSync(tmp, JSON.stringify(idx, null, 2), "utf-8");
+    fs12.renameSync(tmp, p);
   }
 };
 function filterKey(filter) {
@@ -3489,6 +3518,21 @@ var RemoteCatalogSource = class {
       (a) => (!filter.kind || a.kind === filter.kind) && (!filter.publisher || bare(a.publisher) === bare(filter.publisher)) && (!filter.prefix || `${bare(a.publisher)}/${a.name}`.startsWith(filter.prefix))
     ).map(cachedAsset);
   }
+  /**
+   * `true` when the cached catalog (a resolved row or the cached list, fresh or stale) holds
+   * `ref`. Never touches the network: `check` and `doctor` use it to tell a store-supplied
+   * lock entry from one whose source is gone (p1062). Pass the locked ref with its version
+   * (`kind:@pub/name#1.0.0`): `add` caches the row under the ref it asked for, so an
+   * unversioned lookup alone misses it (p380).
+   */
+  holdsCached(ref) {
+    if (this.cache.getResolveStale(ref)?.value) return true;
+    try {
+      return this.cachedListedAsset(ref) !== null;
+    } catch {
+      return false;
+    }
+  }
   /**
    * Fetch `ref` from the store, bypassing the resolve cache, and cache the answer.
    * For a caller that knows the cached answer is wrong, e.g. a cached miss for an
@@ -4103,8 +4147,9 @@ var RestCatalogSource = class {
   }
   // ── extension API ───────────────────────────────────────────────────────
   /**
-   * Force a metadata-cache refresh. Wipes all resolve/list entries and
-   * re-fetches `listAssets()` (no filter) to pre-warm the canonical query.
+   * Force a metadata-cache refresh. Re-fetches `listAssets()` (no filter), then wipes all
+   * resolve/list entries and stores the fresh list. When the fetch fails the old entries stay,
+   * so a failed `skaile update` keeps the warm cache for offline reads (p960).
    *
    * Driven by `skaile update`. Tarballs (content-addressed) are not touched.
    *
@@ -4115,7 +4160,6 @@ var RestCatalogSource = class {
    *   error then reads `no answer from <url> within <n> s`.
    */
   async refresh(opts) {
-    this.cache.invalidateAll();
     let items;
     try {
       items = await this.fetchListNetwork(void 0, opts?.timeoutMs);
@@ -4126,6 +4170,7 @@ var RestCatalogSource = class {
       }
       throw err;
     }
+    this.cache.invalidateAll();
     this.cache.setList(void 0, items);
     for (const item of items) {
       this.cache.setResolve(item.id, item);
@@ -4314,15 +4359,15 @@ function discoveredToAssetEntry(asset, repoPublisher, inheritPublisher) {
 }
 function writeCuratedManifest(input) {
   const manifestPath = input.manifestFile;
-  if (fs11.existsSync(manifestPath) && !input.force) {
+  if (fs12.existsSync(manifestPath) && !input.force) {
     return { wrote: false, manifestPath, assetCount: 0 };
   }
   const publisher = input.publisher.startsWith("@") ? input.publisher.slice(1) : input.publisher;
   const inheritPublisher = input.inheritPublisher ?? false;
   const assets = input.assets.map((a) => discoveredToAssetEntry(a, publisher, inheritPublisher)).sort((a, b) => `${a.kind}:${a.name}`.localeCompare(`${b.kind}:${b.name}`));
   const manifest = { publisher, assets };
-  fs11.mkdirSync(path16.dirname(manifestPath), { recursive: true });
-  fs11.writeFileSync(manifestPath, encodeSkaileManifest(manifest), "utf-8");
+  fs12.mkdirSync(path16.dirname(manifestPath), { recursive: true });
+  fs12.writeFileSync(manifestPath, encodeSkaileManifest(manifest), "utf-8");
   return { wrote: true, manifestPath, assetCount: assets.length };
 }
 function filesEntryPaths(libraryPath, entry) {
@@ -4336,8 +4381,8 @@ var DEFAULT_ASSET_VERSION = "0.1.0";
 function openManifest(libraryPath) {
   const dir = path16.resolve(libraryPath);
   const file = path16.join(dir, SKAILE_MANIFEST_FILENAME);
-  if (!fs11.existsSync(file)) {
-    fs11.mkdirSync(dir, { recursive: true });
+  if (!fs12.existsSync(file)) {
+    fs12.mkdirSync(dir, { recursive: true });
     return { editor: ManifestYamlEditor.create(file), created: true };
   }
   const editor = ManifestYamlEditor.load(file);
@@ -4347,14 +4392,14 @@ function openManifest(libraryPath) {
 }
 function assertManifestEditable(libraryPath) {
   const file = path16.join(path16.resolve(libraryPath), SKAILE_MANIFEST_FILENAME);
-  if (!fs11.existsSync(file)) return;
+  if (!fs12.existsSync(file)) return;
   openManifest(libraryPath);
 }
 function assetRootProblem(libraryPath, root) {
   const libDir = path16.resolve(libraryPath);
   let realLib;
   try {
-    realLib = fs11.realpathSync(libDir);
+    realLib = fs12.realpathSync(libDir);
   } catch {
     return void 0;
   }
@@ -4373,12 +4418,12 @@ function assetRootProblem(libraryPath, root) {
     walked.push(part);
     let stat;
     try {
-      stat = fs11.lstatSync(current);
+      stat = fs12.lstatSync(current);
     } catch {
       return void 0;
     }
     if (stat.isSymbolicLink()) {
-      return librarySymlinkMessage({ path: walked.join("/"), target: fs11.readlinkSync(current) });
+      return librarySymlinkMessage({ path: walked.join("/"), target: fs12.readlinkSync(current) });
     }
   }
   return void 0;
@@ -4393,7 +4438,7 @@ function existingRootConflict(libraryPath, existing, root) {
   if (!existing?.root || existing.source) return void 0;
   const existingAbs = path16.resolve(libraryPath, existing.root);
   if (existingAbs === path16.resolve(libraryPath, root)) return void 0;
-  const stat = fs11.statSync(existingAbs, { throwIfNoEntry: false });
+  const stat = fs12.statSync(existingAbs, { throwIfNoEntry: false });
   return stat?.isDirectory() ? existing.root : void 0;
 }
 function upsertManifestAsset(libraryPath, input) {
@@ -4429,7 +4474,7 @@ function missingRootAssets(libraryPath, manifest) {
   return (manifest.assets ?? []).filter((a) => {
     if (a.source || manifest.source || !a.root) return false;
     const dir = path16.resolve(libraryPath, a.root);
-    return !(fs11.existsSync(dir) && fs11.statSync(dir).isDirectory());
+    return !(fs12.existsSync(dir) && fs12.statSync(dir).isDirectory());
   });
 }
 function pruneMissingRootAssets(libraryPath) {
@@ -4484,6 +4529,7 @@ function reconcileEntryNames(libraryPath, scanned, refused) {
     const holders = parsable.filter(
       (s) => s.kind === entry.kind && path16.resolve(path16.dirname(s.source)) === dir
     );
+    if (holders.some((s) => declaresInvalidName(s.source, s.kind))) continue;
     if (holders.length === 0) {
       const renamedAway = refused.some(
         (s) => s.kind === entry.kind && s.name !== entry.name && path16.resolve(path16.dirname(s.source)) === dir
@@ -4562,6 +4608,16 @@ async function syncManifestWithDisk(libraryPath, defaultPublisher, registry, opt
       });
       continue;
     }
+    if (declaresInvalidName(e.source, e.kind)) {
+      failed.push({
+        kind: e.kind,
+        name: e.name,
+        file: path16.relative(libraryPath, e.source),
+        findings: opts.check?.(e) ?? [],
+        inManifest: false
+      });
+      continue;
+    }
     if (e.version && !SEMVER_RE.test(e.version)) {
       skipped.push({
         kind: e.kind,
@@ -4663,19 +4719,30 @@ async function unparsableAssetFiles(libraryPath, registry) {
 }
 function isParsable(file) {
   try {
-    return parseManifestFile(file, fs11.readFileSync(file, "utf-8")).ok;
+    return parseManifestFile(file, fs12.readFileSync(file, "utf-8")).ok;
   } catch {
     return false;
   }
 }
 function parseFailureOf(file) {
   try {
-    const res = parseManifestFile(file, fs11.readFileSync(file, "utf-8"));
+    const res = parseManifestFile(file, fs12.readFileSync(file, "utf-8"));
     return res.ok ? void 0 : res.reason;
   } catch (err) {
     return err instanceof Error ? err.message : String(err);
   }
 }
+function declaresInvalidName(file, kind) {
+  try {
+    const res = parseManifestFile(file, fs12.readFileSync(file, "utf-8"));
+    if (!res.ok) return false;
+    const declared = kind === "flow" ? res.data.id : res.data.name;
+    if (declared === void 0 || declared === null || declared === "") return false;
+    return typeof declared !== "string" || !isValidAssetName(declared);
+  } catch {
+    return false;
+  }
+}
 var PinPolicySchema = z3.enum(PIN_POLICIES);
 var LibraryInstanceRefSchema = z3.object({
   id: z3.string().uuid(),
@@ -4729,8 +4796,8 @@ function parseWorkspaceV2(raw) {
 }
 function loadWorkspaceV2(dir, filename = "skaile.yaml") {
   const filePath = path16.join(dir, filename);
-  if (!fs11.existsSync(filePath)) return null;
-  const content = fs11.readFileSync(filePath, "utf-8");
+  if (!fs12.existsSync(filePath)) return null;
+  const content = fs12.readFileSync(filePath, "utf-8");
   const raw = parse(content);
   if (!raw || typeof raw !== "object") return null;
   return parseWorkspaceV2(raw);
@@ -4738,23 +4805,23 @@ function loadWorkspaceV2(dir, filename = "skaile.yaml") {
 function saveWorkspaceV2(dir, v2, filename = "skaile.yaml") {
   const filePath = path16.join(dir, filename);
   let existing = {};
-  if (fs11.existsSync(filePath)) {
-    const content = fs11.readFileSync(filePath, "utf-8");
+  if (fs12.existsSync(filePath)) {
+    const content = fs12.readFileSync(filePath, "utf-8");
     existing = parse(content) ?? {};
   }
   existing.version = 2;
   if (v2.library !== void 0) existing.library = v2.library;
   if (v2.presets_applied !== void 0) existing.presets_applied = v2.presets_applied;
-  if (!fs11.existsSync(dir)) {
-    fs11.mkdirSync(dir, { recursive: true });
+  if (!fs12.existsSync(dir)) {
+    fs12.mkdirSync(dir, { recursive: true });
   }
-  fs11.writeFileSync(filePath, stringify(existing, { indent: 2 }), "utf-8");
+  fs12.writeFileSync(filePath, stringify(existing, { indent: 2 }), "utf-8");
 }
 var LOCK_FILENAME = "skaile.lock.yaml";
 function loadLockFile(dir) {
   const filePath = path16.join(dir, LOCK_FILENAME);
-  if (!fs11.existsSync(filePath)) return null;
-  const content = fs11.readFileSync(filePath, "utf-8");
+  if (!fs12.existsSync(filePath)) return null;
+  const content = fs12.readFileSync(filePath, "utf-8");
   const raw = parse(content);
   if (raw !== null && !("assignments" in raw) && "subscriptions" in raw) {
     const legacySubs = raw.subscriptions;
@@ -4771,10 +4838,10 @@ function loadLockFile(dir) {
 }
 function saveLockFile(dir, lock) {
   const filePath = path16.join(dir, LOCK_FILENAME);
-  if (!fs11.existsSync(dir)) {
-    fs11.mkdirSync(dir, { recursive: true });
+  if (!fs12.existsSync(dir)) {
+    fs12.mkdirSync(dir, { recursive: true });
   }
-  fs11.writeFileSync(
+  fs12.writeFileSync(
     filePath,
     `# Auto-generated by skaile. Do not edit manually.
 ${stringify(lock, { indent: 2 })}`,
@@ -4792,13 +4859,13 @@ function createEmptyLockFile() {
 }
 function detectWorkspaceVersion(dir, filename = "skaile.yaml") {
   const filePath = path16.join(dir, filename);
-  if (!fs11.existsSync(filePath)) return null;
-  const content = fs11.readFileSync(filePath, "utf-8");
+  if (!fs12.existsSync(filePath)) return null;
+  const content = fs12.readFileSync(filePath, "utf-8");
   const raw = parse(content);
   if (!raw || typeof raw !== "object") return null;
   return raw.version === 2 ? 2 : 1;
 }
 
-export { AssignmentNotFoundError, CatalogCache, CatalogConfigSchema, CatalogHttpError, DuplicateAssignmentError, DuplicateLibraryNameError, GitSyncDriver, InstanceHasConsumersError, InstanceNotFoundError, InterpolationError, KnowledgeManifestSchema, LIBRARY_BACKENDS, LIBRARY_OWNERSHIPS, LOCAL_CATALOG_URL, LibraryConfigSchema, LibraryError, LibraryInstanceRefSchema, LibraryManager, LibrarySectionSchema, LibrarySyncError, LocalCatalogSource, LocalIndex, LocalSyncDriver, LockAssignmentSchema, LockFileSchema, OfflineError, OperationNotPermittedError, PIN_POLICIES, PinPolicySchema, PresetAppliedSchema, PresetExpandedSchema, RemoteCatalogSource, RequiresEdgeSchema, RestCatalogSource, SidecarGit, SkaileConfigSchema, SourceNotFoundError, TarballHashMismatchError, UNLISTED_SCAN_SKIP_DIRS, UserLibraryNotFoundError, WorkspaceConfigV2Schema, applyNonStructuralUpgrade, applyPreset, applyPresetFromData, assertManifestEditable, assertValidLibraryName, assetRootProblem, classifyRef, cloneOrInitGitRepo, commitStoreManifest, conflictingAssetRoot, createEmptyLockFile, curatedManifestOverlay, deriveSlug, describeCatalogError, detectChanges, detectNestedPresetRefs, detectWorkspaceVersion, ensureGitRepo, evaluateUpgrade, extractLibraryInstanceId, extractReferencedKeys, filesEntryPaths, filterKey, getConfigDefaults, getDefaultValue, getSidecarRoot, getStoreManifestsDir, getStoreRoot, hasInterpolationTokens, installLibraryAsset, interpolate, isGitRepo, isLocalCatalogUrl, isSecretPlaceholder, knowledgeKindProvider, libraryDirMissing, listSidecarSlugsOnDisk, loadLockFile, loadWorkspaceV2, markLibraryUnregistered, migrateSidecarsToStoreIfNeeded, migrateWorkspaceConfig, missingLibraryDirMessage, missingRootAssets, parsePreset, parsePresetYaml, parseWorkspaceV2, projectConfigPath, pruneMissingRootAssets, queryInstancePickerChoices, recordLibraryRename, renamedLibraryName, resolveAllItems, resolveConfig, resolveIndexPath, resolveItem, resolvePin, resolveSidecarPaths, saveConfig, saveLockFile, saveWorkspaceV2, scanAuthoringLibraries, scanLibraryRoot, scanUnlistedAssets, setManifestPublisher, setOriginUrl, sha256Hex, stampManifestPublisher, storeManifestFile, storeSecrets, syncManifestWithDisk, trackOriginBranch, trpcGetUrl, unparsableAssetFiles, unregisteredLibraryNames, upsertManifestAsset, validateAllPlaceholders, validateKnowledge, validateNestingDepth, validatePlaceholder, writeCuratedManifest };
-//# sourceMappingURL=chunk-UL22SDGR.js.map
-//# sourceMappingURL=chunk-UL22SDGR.js.map
+export { AssignmentNotFoundError, CatalogCache, CatalogConfigSchema, CatalogHttpError, DuplicateAssignmentError, DuplicateLibraryNameError, GitSyncDriver, InstanceHasConsumersError, InstanceNotFoundError, InterpolationError, KnowledgeManifestSchema, LIBRARY_BACKENDS, LIBRARY_OWNERSHIPS, LOCAL_CATALOG_URL, LibraryConfigSchema, LibraryError, LibraryInstanceRefSchema, LibraryManager, LibrarySectionSchema, LibrarySyncError, LocalCatalogSource, LocalIndex, LocalSyncDriver, LockAssignmentSchema, LockFileSchema, OfflineError, OperationNotPermittedError, PIN_POLICIES, PinPolicySchema, PresetAppliedSchema, PresetExpandedSchema, RemoteCatalogSource, RequiresEdgeSchema, RestCatalogSource, SidecarGit, SkaileConfigSchema, SourceNotFoundError, TarballHashMismatchError, UNLISTED_SCAN_SKIP_DIRS, UserLibraryNotFoundError, WorkspaceConfigV2Schema, applyNonStructuralUpgrade, applyPreset, applyPresetFromData, assertManifestEditable, assertValidLibraryName, assetRootProblem, classifyRef, cloneOrInitGitRepo, commitStoreManifest, conflictingAssetRoot, createEmptyLockFile, curatedManifestOverlay, deriveSlug, describeCatalogError, detectChanges, detectNestedPresetRefs, detectWorkspaceVersion, ensureGitRepo, evaluateUpgrade, extractLibraryInstanceId, extractReferencedKeys, filesEntryPaths, filterKey, getConfigDefaults, getDefaultValue, getSidecarRoot, getStoreManifestsDir, getStoreRoot, hasInterpolationTokens, installLibraryAsset, interpolate, isGitRepo, isLocalCatalogUrl, isSecretPlaceholder, knowledgeKindProvider, lastLibraryName, libraryDirMissing, listSidecarSlugsOnDisk, loadLockFile, loadWorkspaceV2, markLibraryUnregistered, migrateSidecarsToStoreIfNeeded, migrateWorkspaceConfig, missingLibraryDirMessage, missingRootAssets, parsePreset, parsePresetYaml, parseWorkspaceV2, projectConfigPath, pruneMissingRootAssets, queryInstancePickerChoices, recordLibraryRename, renamedLibraryName, resolveAllItems, resolveConfig, resolveIndexPath, resolveItem, resolvePin, resolveSidecarPaths, saveConfig, saveLockFile, saveWorkspaceV2, scanAuthoringLibraries, scanLibraryRoot, scanUnlistedAssets, setManifestPublisher, setOriginUrl, sha256Hex, stampManifestPublisher, storeManifestFile, storeSecrets, syncManifestWithDisk, trackOriginBranch, trpcGetUrl, unparsableAssetFiles, unregisteredLibraryNames, upsertManifestAsset, validateAllPlaceholders, validateKnowledge, validateNestingDepth, validatePlaceholder, writeCuratedManifest };
+//# sourceMappingURL=chunk-6CYKTHNT.js.map
+//# sourceMappingURL=chunk-6CYKTHNT.js.map