@skaile/workspaces 5.11.0 → 5.12.0

package/dist/{chunk-2F5AWQX5.js → chunk-C3BMXXTN.js}

@@ -1,12 +1,12 @@
-import { readManifestSourceConfig, discoverAssetsInTree, barePublisher, createDefaultKindRegistry, sharesItsFolder, SEMVER_RE, parseManifestFile } from './chunk-J4RBUFGM.js';
-import { installFromManifest, assertSafeManifestPath } from './chunk-COH6FQAG.js';
-import { PresetManifestSchema } from './chunk-ZCAJZ4B2.js';
-import { defaultLibraryDir, resolveLibraryDir, GLOBAL_INSTALL_DIR_NAME, readLock, buildLibraryLockEntries, writeLock, mergeLockFile, buildLockFile, ManifestYamlEditor } from './chunk-PBBPZYVG.js';
-import { getGlobalCacheDir, storeManifestSlug, resolveSourcePublisher } from './chunk-ALEYHUC5.js';
+import { readManifestSourceConfig, discoverAssetsInTree, barePublisher, createDefaultKindRegistry, sharesItsFolder, SEMVER_RE, parseManifestFile } from './chunk-7CR2OZPA.js';
+import { installFromManifest, assertSafeManifestPath } from './chunk-UTKENBB6.js';
+import { PresetManifestSchema } from './chunk-6VLHITAM.js';
+import { defaultLibraryDir, resolveLibraryDir, GLOBAL_INSTALL_DIR_NAME, readLock, buildLibraryLockEntries, writeLock, mergeLockFile, buildLockFile, ManifestYamlEditor } from './chunk-T5TSLSRO.js';
+import { getGlobalCacheDir, storeManifestSlug, resolveSourcePublisher } from './chunk-PNOGX36L.js';
 import { userConfigPath, globalSkaileDir, mergeLegacyEntriesInto, migrateLegacyDir, globalCacheRoot } from './chunk-L5VSIPQD.js';
-import { encodeSkaileManifest, loadSkPublishManifest, SKAILE_MANIFEST_FILENAME } from './chunk-ZPWTOUTK.js';
-import { scanDirectory } from './chunk-SBSA3IQA.js';
-import { parseAssetRef, assetRefToStr } from './chunk-BNMZVPYA.js';
+import { encodeSkaileManifest, loadSkPublishManifest, SKAILE_MANIFEST_FILENAME } from './chunk-CTP3XBMF.js';
+import { scanDirectory } from './chunk-XTVSNWLL.js';
+import { parseAssetRef, assetRefToStr } from './chunk-PNTXHTBC.js';
 import { __export } from './chunk-NSBPE2FW.js';
 import * as fs11 from 'fs';
 import { existsSync, mkdirSync, symlinkSync, copyFileSync, cpSync } from 'fs';
@@ -20,6 +20,7 @@ import { createClient } from '@libsql/client';
 import { drizzle } from 'drizzle-orm/libsql';
 import { sqliteTable, text, integer } from 'drizzle-orm/sqlite-core';
 import { spawnSync } from 'child_process';
+import { valid, gt } from 'semver';
 import { isDeepStrictEqual } from 'util';
 
 // library/src/library.ts
@@ -369,6 +370,31 @@ function curatedManifestOverlay(sourceUrl) {
   const file = path16.join(getStoreManifestsDir(), `${storeManifestSlug(sourceUrl)}.yaml`);
   return fs11.existsSync(file) ? file : void 0;
 }
+function commitStoreManifest(file, message) {
+  const root = getStoreRoot();
+  try {
+    const rel = path16.relative(root, file);
+    if (rel.startsWith("..") || path16.isAbsolute(rel)) return false;
+    initStoreGitRepo(root);
+    const run = (args) => spawnSync(
+      "git",
+      [
+        "-c",
+        "user.name=skaile",
+        "-c",
+        "user.email=skaile@localhost",
+        "-c",
+        "commit.gpgsign=false",
+        ...args
+      ],
+      { cwd: root, stdio: "ignore" }
+    );
+    if (run(["add", "--", rel]).status !== 0) return false;
+    return run(["commit", "--quiet", "-m", message, "--only", "--", rel]).status === 0;
+  } catch {
+    return false;
+  }
+}
 function migratedMarkerPath() {
   return path16.join(getStoreRoot(), ".migrated");
 }
@@ -693,6 +719,7 @@ function assertNoLegacyLibDb(newDbPath) {
     );
   }
 }
+var INDEX_BUSY_TIMEOUT_MS = 5e3;
 async function createLibraryDb(dbPath) {
   assertNoLegacyLibDb(dbPath);
   try {
@@ -704,6 +731,7 @@ async function createLibraryDb(dbPath) {
     );
   }
   const client = createClient({ url: `file:${dbPath}` });
+  await client.execute(`PRAGMA busy_timeout = ${INDEX_BUSY_TIMEOUT_MS}`);
   await client.execute("PRAGMA journal_mode = WAL");
   await client.execute("PRAGMA foreign_keys = ON");
   if (await legacySourcesPresent(client) && !await librariesPresent(client)) {
@@ -890,7 +918,10 @@ var LocalIndex = class {
     this.dbHandleRef = null;
     this.dbPromise = null;
   }
-  /** Internal access for LibraryManager. Do not call from user code. */
+  /**
+   * Internal access for LibraryManager. Do not call from user code. Typed `unknown`
+   * so the published `.d.ts` pulls in no drizzle types (p461); the manager casts it.
+   */
   async dbHandle() {
     return this.ensureDb();
   }
@@ -1561,6 +1592,13 @@ var GitSyncDriver = class {
     }
     assertNoRebase(lib);
     const cfg = gitCfg(lib);
+    if (git(lib.path, ["rev-parse", "--verify", "--quiet", `refs/heads/${cfg.branch}`]).status !== 0) {
+      const current = git(lib.path, ["symbolic-ref", "--short", "-q", "HEAD"]).stdout.trim();
+      throw new LibrarySyncError(
+        current && current !== cfg.branch ? `no local branch "${cfg.branch}" in ${lib.name} (it is on "${current}"); run skaile library set ${lib.name} backendConfig.branch=${current}` : `no local branch "${cfg.branch}" in ${lib.name}; commit something on it first`,
+        "remote_error"
+      );
+    }
     const args = ["push", "origin", cfg.branch];
     if (opts?.force) args.push("--force-with-lease");
     const countRef = "refs/skaile/push-base";
@@ -1579,9 +1617,16 @@ var GitSyncDriver = class {
     const baseRef = fetched.status === 0 || remoteHasNoBranch ? countRef : trackingRef;
     const local = `refs/heads/${cfg.branch}`;
     const pushed = countCommits(lib.path, `${baseRef}..${local}`) ?? countCommits(lib.path, local) ?? 0;
+    const behind = remoteHasNoBranch ? 0 : countCommits(lib.path, `${local}..${baseRef}`) ?? 0;
     git(lib.path, ["update-ref", "-d", countRef]);
     const pushRes = git(lib.path, args);
     if (pushRes.status !== 0 && /non-fast-forward|fetch first|updates were rejected/i.test(pushRes.stderr)) {
+      if (pushed === 0 && behind > 0) {
+        throw new LibrarySyncError(
+          `behind origin by ${behind} commit(s); run skaile library pull ${lib.name}`,
+          "remote_error"
+        );
+      }
       throw new LibrarySyncError(
         `local and remote both changed; run skaile library git ${lib.name} pull --rebase origin ${cfg.branch}`,
         "remote_error"
@@ -1713,6 +1758,13 @@ var LibraryManager = class {
   lib;
   localDrv = new LocalSyncDriver();
   gitDrv = new GitSyncDriver();
+  /**
+   * The index's drizzle handle. `LocalIndex.dbHandle()` is typed `unknown` so the
+   * published `.d.ts` pulls in no drizzle types; the type lives here.
+   */
+  async db() {
+    return await this.lib.dbHandle();
+  }
   /** Resolve the sync driver for a given backend. */
   driverFor(backend) {
     switch (backend) {
@@ -1724,7 +1776,7 @@ var LibraryManager = class {
   }
   async addLibrary(input) {
     assertValidLibraryName(input.name);
-    const db = await this.lib.dbHandle();
+    const db = await this.db();
     const existing = await db.select().from(libraries).where(eq(libraries.name, input.name)).get();
     if (existing) throw new DuplicateLibraryNameError(input.name);
     const id = crypto.randomUUID();
@@ -1749,12 +1801,12 @@ var LibraryManager = class {
     return this.requireLibrary(id);
   }
   async listLibraries() {
-    const db = await this.lib.dbHandle();
+    const db = await this.db();
     const rows = await db.select().from(libraries).all();
     return rows.map(rowToLibrary2).sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
   }
   async getLibrary(nameOrId) {
-    const db = await this.lib.dbHandle();
+    const db = await this.db();
     let row = await db.select().from(libraries).where(eq(libraries.name, nameOrId)).get();
     if (!row) {
       row = await db.select().from(libraries).where(eq(libraries.id, nameOrId)).get();
@@ -1782,7 +1834,7 @@ var LibraryManager = class {
   async updateLibrary(nameOrId, patch) {
     const lib = await this.requireLibrary(nameOrId);
     if (patch.name !== void 0 && patch.name !== lib.name) assertValidLibraryName(patch.name);
-    const db = await this.lib.dbHandle();
+    const db = await this.db();
     const updates = {
       updatedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
@@ -1816,7 +1868,7 @@ var LibraryManager = class {
   }
   async setDefault(nameOrId) {
     const lib = await this.requireLibrary(nameOrId);
-    const db = await this.lib.dbHandle();
+    const db = await this.db();
     await db.update(libraries).set({ isDefault: false }).run();
     await db.update(libraries).set({ isDefault: true, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }).where(eq(libraries.id, lib.id)).run();
     return this.requireLibrary(lib.id);
@@ -2014,19 +2066,10 @@ var LocalCatalogSource = class {
       errors.push(`${err.path}: ${err.error}`);
     }
     const advisories = [];
-    let missingSha256Count = 0;
     for (const w of result.warnings) {
-      if (w.code === "missing_sha256") {
-        missingSha256Count++;
-        continue;
-      }
+      if (w.code === "missing_sha256") continue;
       advisories.push(`${w.path}: ${w.warning}`);
     }
-    if (missingSha256Count > 0) {
-      advisories.push(
-        `${missingSha256Count} asset(s): sha256 not pinned \u2014 auto-computed locally (pin only for store publish)`
-      );
-    }
     const keepRefs = assets.map((a) => a.ref);
     let pruned = [];
     if (!syncOpts?.only && result.assets.length > 0) {
@@ -3296,8 +3339,6 @@ function sha256Hex(bytes) {
   h.update(bytes);
   return h.digest("hex");
 }
-
-// library/src/remote/remote-catalog-source.ts
 var TarballHashMismatchError = class extends Error {
   constructor(expected, actual) {
     super(`SHA256 mismatch: expected ${expected}, got ${actual}`);
@@ -3324,6 +3365,19 @@ var CatalogHttpError = class extends Error {
   status;
   url;
 };
+function describeCatalogError(err, baseUrl) {
+  if (err instanceof OfflineError) return err.message;
+  if (err instanceof CatalogHttpError) {
+    return err.status >= 400 && err.status < 600 && !err.message.startsWith("tRPC") ? `${baseUrl} answered ${err.status} (${err.message})` : `${baseUrl}: ${err.message}`;
+  }
+  const e = err;
+  if (e?.name === "TimeoutError" || e?.name === "AbortError") {
+    return `no answer from ${baseUrl} within ${CATALOG_REQUEST_TIMEOUT_MS / 1e3} s`;
+  }
+  const cause = e?.cause;
+  const why = cause?.code ?? cause?.message ?? e?.message ?? String(err);
+  return `cannot reach ${baseUrl} (${why})`;
+}
 var DEFAULT_TTL_MS = 864e5;
 var RemoteCatalogSource = class {
   id;
@@ -3367,6 +3421,8 @@ var RemoteCatalogSource = class {
     if (this.cache.airGapped) {
       const stale2 = this.cache.getResolveStale(ref);
       if (stale2) return stale2.value;
+      const listed = this.cachedListedAsset(ref);
+      if (listed) return listed;
       throw new OfflineError(`Asset '${ref}' not in cache`);
     }
     const stale = this.cache.getResolveStale(ref);
@@ -3378,9 +3434,42 @@ var RemoteCatalogSource = class {
       return await this.fetchAndStoreResolve(ref);
     } catch (err) {
       if (stale) return stale.value;
+      const listed = this.cachedListedAsset(ref);
+      if (listed) return listed;
       throw err;
     }
   }
+  /**
+   * The row for `ref` from the cached, unfiltered catalog list (fresh or stale), or `null`.
+   * A version-less ref takes the highest listed version. Never touches the network.
+   */
+  cachedListedAsset(ref) {
+    const all = this.cache.getList(void 0) ?? this.cache.getListStale(void 0);
+    if (!all) return null;
+    const want = parseAssetRef(ref);
+    const bare = (p) => p?.replace(/^@/, "");
+    const hits = all.items.filter(
+      (a) => a.kind === want.kind && a.name === want.name && (want.publisher === void 0 || bare(a.publisher) === bare(want.publisher)) && (want.pin === void 0 || a.version === want.pin)
+    );
+    if (hits.length === 0) return null;
+    return hits.reduce(
+      (best, a) => valid(a.version) && valid(best.version) && gt(a.version, best.version) ? a : best
+    );
+  }
+  /**
+   * `filter` applied to the cached, unfiltered catalog list (fresh or stale), or `null` when
+   * that list is not cached or `filter` is empty. A `--kind` / publisher query needs no
+   * round trip once the whole list is on disk.
+   */
+  cachedListFiltered(filter) {
+    if (!filter || !filter.kind && !filter.publisher && !filter.prefix) return null;
+    const all = this.cache.getList(void 0) ?? this.cache.getListStale(void 0);
+    if (!all) return null;
+    const bare = (p) => p.replace(/^@/, "");
+    return all.items.filter(
+      (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))
+    );
+  }
   /**
    * 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
@@ -3406,6 +3495,8 @@ var RemoteCatalogSource = class {
     if (this.cache.airGapped) {
       const stale2 = this.cache.getListStale(filter);
       if (stale2) return stale2.items;
+      const subset = this.cachedListFiltered(filter);
+      if (subset) return subset;
       throw new OfflineError("Catalog list not in cache");
     }
     const stale = this.cache.getListStale(filter);
@@ -3414,7 +3505,13 @@ var RemoteCatalogSource = class {
       this.scheduleBackground(`list:${filterKey2}`, () => this.fetchAndStoreList(filter));
       return stale.items;
     }
-    return this.fetchAndStoreList(filter);
+    try {
+      return await this.fetchAndStoreList(filter);
+    } catch (err) {
+      const subset = this.cachedListFiltered(filter);
+      if (subset) return subset;
+      throw err;
+    }
   }
   /**
    * Fetch the content-addressed tarball for an asset. The bytes are downloaded
@@ -3518,6 +3615,9 @@ var RemoteCatalogSource = class {
    * @throws {@link CatalogHttpError} on a non-2xx response or malformed envelope.
    */
   async getInstallManifest(ref) {
+    if (this.cache.airGapped) {
+      throw new OfflineError(`Install manifest of '${ref}' is not cached`);
+    }
     const url = trpcGetUrl(this.baseUrl, "catalog.getInstallManifest", { ref });
     const res = await this.httpClient(url, {
       method: "GET",
@@ -3555,6 +3655,9 @@ var RemoteCatalogSource = class {
    * @docLink packages/library/api-reference#remote-catalog-source
    */
   async getCanonicalDigest(ref) {
+    if (this.cache.airGapped) {
+      throw new OfflineError(`Canonical digest of '${ref}' is not cached`);
+    }
     const url = trpcGetUrl(this.baseUrl, "catalog.getCanonicalDigest", { ref });
     const res = await this.httpClient(url, {
       method: "GET",
@@ -4143,6 +4246,7 @@ function writeCuratedManifest(input) {
   fs11.writeFileSync(manifestPath, encodeSkaileManifest(manifest), "utf-8");
   return { wrote: true, manifestPath, assetCount: assets.length };
 }
+var DEFAULT_ASSET_VERSION = "0.1.0";
 function openManifest(libraryPath) {
   const dir = path16.resolve(libraryPath);
   const file = path16.join(dir, SKAILE_MANIFEST_FILENAME);
@@ -4323,7 +4427,9 @@ async function syncManifestWithDisk(libraryPath, defaultPublisher, registry, opt
       kind: e.kind,
       name: e.name,
       root,
-      version: e.version
+      // A file with no version of its own (AGENT.md) reads as 0.1.0 in every library; the
+      // manifest entry is where that version is kept.
+      version: e.version || DEFAULT_ASSET_VERSION
     });
   }
   return { removed, unknownKind, skipped, failed };
@@ -4482,6 +4588,6 @@ function detectWorkspaceVersion(dir, filename = "skaile.yaml") {
   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, UserLibraryNotFoundError, WorkspaceConfigV2Schema, applyNonStructuralUpgrade, applyPreset, applyPresetFromData, assertManifestEditable, assertValidLibraryName, classifyRef, cloneOrInitGitRepo, conflictingAssetRoot, createEmptyLockFile, curatedManifestOverlay, deriveSlug, detectChanges, detectNestedPresetRefs, detectWorkspaceVersion, ensureGitRepo, evaluateUpgrade, extractLibraryInstanceId, extractReferencedKeys, 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, storeSecrets, syncManifestWithDisk, trackOriginBranch, trpcGetUrl, unregisteredLibraryNames, upsertManifestAsset, validateAllPlaceholders, validateKnowledge, validateNestingDepth, validatePlaceholder, writeCuratedManifest };
-//# sourceMappingURL=chunk-2F5AWQX5.js.map
-//# sourceMappingURL=chunk-2F5AWQX5.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, UserLibraryNotFoundError, WorkspaceConfigV2Schema, applyNonStructuralUpgrade, applyPreset, applyPresetFromData, assertManifestEditable, assertValidLibraryName, classifyRef, cloneOrInitGitRepo, commitStoreManifest, conflictingAssetRoot, createEmptyLockFile, curatedManifestOverlay, deriveSlug, describeCatalogError, detectChanges, detectNestedPresetRefs, detectWorkspaceVersion, ensureGitRepo, evaluateUpgrade, extractLibraryInstanceId, extractReferencedKeys, 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, storeSecrets, syncManifestWithDisk, trackOriginBranch, trpcGetUrl, unregisteredLibraryNames, upsertManifestAsset, validateAllPlaceholders, validateKnowledge, validateNestingDepth, validatePlaceholder, writeCuratedManifest };
+//# sourceMappingURL=chunk-C3BMXXTN.js.map
+//# sourceMappingURL=chunk-C3BMXXTN.js.map