@skaile/workspaces 6.1.0 → 6.2.0

package/dist/cli/index.js

@@ -1,95 +1,95 @@
 #!/usr/bin/env node
-import { makeValidateCommand, scanIdentities } from '../chunk-IHFGPHCT.js';
-import { storeNotInstallableReason, mcpNotRunnableHere } from '../chunk-EX3GLAL6.js';
-import { makeProvidersCommand, loadRegistryView, addProviderEntry, ProviderRegistryWriteError, removeProviderEntry } from '../chunk-NB7SYQYP.js';
-import { makeInstallCommand, makeCheckCommand, makeCleanCommand, pinComposedAgents, reportRewritten, reportReplaced, reportRelocked, reportMoved, reportStoreNotChecked, globalProblems, editedConventionFiles, supportsInstallManifest, runYamlInstall, REF_HINT, reportInstalledSoftDeps } from '../chunk-CEKW3KXP.js';
-import { unknownHarnessMessage, reportProjectConfig, driverAliasOption, foldDriverFlag, friendlyHarnessError, harnessErrorNotes, isRecord } from '../chunk-7HX6FNKL.js';
+import { makeValidateCommand, scanIdentities } from '../chunk-Z3IRZBXB.js';
+import { storeNotInstallableReason, mcpNotRunnableHere } from '../chunk-7H6XRCPG.js';
+import { makeProvidersCommand, loadRegistryView, addProviderEntry, ProviderRegistryWriteError, removeProviderEntry } from '../chunk-ICSGNT5P.js';
+import { makeInstallCommand, makeCheckCommand, makeCleanCommand, pinComposedAgents, reportRewritten, reportReplaced, reportRelocked, reportMoved, reportStoreNotChecked, globalProblems, editedConventionFiles, supportsInstallManifest, runYamlInstall, REF_HINT, reportInstalledSoftDeps } from '../chunk-ITFCWMOY.js';
+import { reportUnknownHarnesses, reportProjectConfig, agentInstanceErrorLines, isRecord } from '../chunk-LRBP3234.js';
 import { createSpinner } from '../chunk-NESV47MF.js';
-import { loadDeclaredPlugins } from '../chunk-QSYQOTWN.js';
-import { getStoreConfig, storeFetch, isStoreAuthenticated, getStoreToken } from '../chunk-3GMOPFWH.js';
-import { makeSourceCommand, syncProjectSources, divergedSourceClones } from '../chunk-AZ2H6R5I.js';
-import { libraryAssetRefusals, deviceLogin, loadStoreAuthConfig, logout, hasStoredAuth, exitOnLibrarySymlinks, resolveLibraryPublisherDetailed, getStoreIdentity, warnLibraryNameFallback, indexLibrary, warnIgnoredDomainFiles, removedDomainOption, rejectRemovedDomainOption, requireValidPublisherOrExit, exitOnManifestPublisherProblems, findAssetManifestFile, checkAssetFile, registerLibraryAsset, DOMAIN_REMOVED_HINT, reportLibrarySymlinks, checkAsset, manifestPublisherProblems, exitOnManifestPathProblems, manifestRequiresProblems, composeRefContext, registeredAssetKeys, assetEntryRef, duplicateAssetMessage, manifestParseFailureLine, manifestParseErrorText, unresolvedManifestDependencies, findEntryManifestFile, unheldRequiresOfFile, warnLegacyBundleFiles, checkComposeKinds } from '../chunk-AITJ7ELM.js';
-import { openCatalogSource, LocalCatalogDisabledError, openLibraryManager, openLibrary } from '../chunk-RDTLPOPD.js';
-import { AI_RESOURCES } from '../chunk-AATHJRKL.js';
-import { status, enable, disable, install, uninstall } from '../chunk-ASWTQQ7E.js';
-import { logErr, S, logOk, logInfo, logWarn, TARGET_DEFAULT_HINT, parseHarnessFilter, requireProjectConfig, deferredWarnings, warnPlaceholderBodies, warnFilesOnlyDelegates, reportLegacyOmpCopies, logNoProject, warnLegacyClaudeCopies, kindColorPad, kindColor, colorRef, formatSoftDepSection, bareSoftDepName, formatSoftDepHint, formatRelativeTime, formatSoftDepRemovePreview, formatSoftDepAddPreview, fitWidth, KIND_COL_WIDTH } from '../chunk-QEULL4Q3.js';
-import { getKindRegistry, getKnownKinds } from '../chunk-COYF6IG2.js';
+import { loadDeclaredPlugins } from '../chunk-BY5WIRCU.js';
+import { getStoreConfig, storeFetch, isStoreAuthenticated, getStoreToken } from '../chunk-KB56WBQ3.js';
+import { makeSourceCommand, syncProjectSources, divergedSourceClones } from '../chunk-PMWRM4EJ.js';
+import { libraryAssetRefusals, manifestEntryRenames, deviceLogin, loadStoreAuthConfig, logout, hasStoredAuth, exitOnLibrarySymlinks, resolveLibraryPublisherDetailed, getStoreIdentity, warnLibraryNameFallback, indexLibrary, warnIgnoredDomainFiles, removedDomainOption, rejectRemovedDomainOption, requireValidPublisherOrExit, exitOnManifestPublisherProblems, findAssetManifestFile, checkAssetFile, registerLibraryAsset, DOMAIN_REMOVED_HINT, reportLibrarySymlinks, checkAsset, manifestPublisherProblems, exitOnManifestPathProblems, manifestRequiresProblems, composeRefContext, registeredAssetKeys, assetEntryRef, duplicateAssetMessage, manifestParseFailureLine, manifestParseErrorText, unresolvedManifestDependencies, findEntryManifestFile, unheldRequiresOfFile, warnLegacyBundleFiles, checkComposeKinds } from '../chunk-2XM3ZH36.js';
+import { openCatalogSource, LocalCatalogDisabledError, openLibraryManager, openLibrary } from '../chunk-BEYNH2LS.js';
+import { AI_RESOURCES } from '../chunk-5LQ62LNT.js';
+import { status, enable, disable, install, uninstall } from '../chunk-MM4YO3EL.js';
+import { logErr, unknownHarnessTargetMessage, S, logOk, logInfo, logWarnErr, unknownHarnessMessage, logWarn, TARGET_DEFAULT_HINT, parseHarnessFilter, requireProjectConfig, deferredWarnings, warnPlaceholderBodies, warnFilesOnlyDelegates, reportLegacyOmpCopies, logNoProject, warnStaleHarnessCopies, kindColorPad, kindColor, colorRef, formatSoftDepSection, bareSoftDepName, driverAliasOption, foldDriverFlag, friendlyHarnessError, harnessErrorNotes, formatSoftDepHint, formatRelativeTime, formatSoftDepRemovePreview, formatSoftDepAddPreview, fitWidth, KIND_COL_WIDTH } from '../chunk-T2VBPVWZ.js';
+import { getKindRegistry, getKnownKinds } from '../chunk-JJJ2G4K2.js';
 import { LocalSecretsProvider } from '../chunk-ILFGVSTJ.js';
-import { resolveInstanceAgentDir, instanceSessionOverrides, runAgentChat, isCompositionError, resolveSessionId, loadSessionById, loadSession, listSessions, setCurrentSession, deleteSession, clearSession, loadAgentManifest, hashAgentFiles, createCompositionContentSource, compileComposition, manifestModelForHarness, instanceForSession, resolveAgentInstance, describeComposition, MarkdownStreamer, createFinalTextFallback } from '../chunk-2LAPHLDH.js';
-import '../chunk-QAKUD6QN.js';
-import '../chunk-6YR4ALVX.js';
-import '../chunk-ZAELRYKS.js';
-import '../chunk-X3YGUKCG.js';
+import { resolveInstanceAgentDir, instanceSessionOverrides, runAgentChat, isCompositionError, resolveSessionId, loadSessionById, loadSession, listSessions, setCurrentSession, deleteSession, clearSession, loadAgentManifest, hashAgentFiles, createCompositionContentSource, compileComposition, manifestModelForHarness, instanceForSession, resolveAgentInstance, describeComposition, MarkdownStreamer, createFinalTextFallback } from '../chunk-SJNZ4WPA.js';
+import '../chunk-GF5JXQIZ.js';
+import '../chunk-OCQNUV4T.js';
+import '../chunk-ZWJCRHP3.js';
+import '../chunk-Q5RN4PWV.js';
 import '../chunk-WYZXSJBK.js';
-import '../chunk-HMISULVD.js';
-import '../chunk-Z3VKUWAX.js';
+import '../chunk-QK7AG5AV.js';
+import '../chunk-TSTRH4SM.js';
 import '../chunk-KW37WNXY.js';
 import '../chunk-3MWQKQUB.js';
-import '../chunk-KUQAJVYT.js';
+import '../chunk-3HACK2Z7.js';
 import '../chunk-O7SG5PC2.js';
 import '../chunk-7QBNJTTQ.js';
 import '../chunk-O2SYFJWP.js';
-import '../chunk-EJPMNDTP.js';
+import '../chunk-KXJMQTOU.js';
 import '../chunk-32NA4TVC.js';
 import '../chunk-W3UDISS2.js';
-import '../chunk-ZFUZ5AKM.js';
-import { runFlow, resumeFlow } from '../chunk-J72MO2WA.js';
+import '../chunk-I7LC5TDY.js';
+import { runFlow, resumeFlow } from '../chunk-5JPW27BI.js';
 import '../chunk-4R6DROGN.js';
-import { parseSkillRequirements, validateRequirements } from '../chunk-IRYKRKVQ.js';
-import '../chunk-VYVTEMAW.js';
-import '../chunk-DGTI65OC.js';
+import { parseSkillRequirements, validateRequirements } from '../chunk-URCJIV7T.js';
+import '../chunk-PNUM7GUY.js';
+import '../chunk-K3R2UKG7.js';
 import '../chunk-6GWSDPBP.js';
-import '../chunk-BBBCJSSU.js';
-import { checkHarnessModel, checkModelProvider } from '../chunk-5Y2KGB4H.js';
-import '../chunk-7LP7RCZI.js';
-import '../chunk-SVTMNSPI.js';
-import '../chunk-XGULGQA3.js';
+import '../chunk-QIHL3YPL.js';
+import { checkHarnessModel, checkModelProvider } from '../chunk-RQMIZONH.js';
+import '../chunk-JFLQICIU.js';
+import '../chunk-QXKUFROW.js';
+import '../chunk-U673DB5U.js';
 import '../chunk-LOO5CB5M.js';
 import '../chunk-BIRW3HOG.js';
-import '../chunk-5J4NPGFM.js';
-import '../chunk-GNZBFSRB.js';
-import '../chunk-XFIEVEU7.js';
+import '../chunk-TZERN27L.js';
+import '../chunk-BOT64P3U.js';
+import '../chunk-6OHZUUR7.js';
 import '../chunk-7DN6JKP2.js';
-import '../chunk-FKQNBCDW.js';
-import { listHarnesses, getProviderPreset, AI_PROVIDER_PRESETS } from '../chunk-ILLTBKDJ.js';
+import '../chunk-M4OG2YN4.js';
+import { listHarnesses, getProviderPreset, AI_PROVIDER_PRESETS } from '../chunk-X37JUNEW.js';
 import '../chunk-G5SUWZEU.js';
 import '../chunk-IFGTRL2I.js';
-import { loadFlow, flowLookupRoots, findFlowFileInRoots, loadAllFlowEntries } from '../chunk-4MUDQCBP.js';
+import { loadFlow, flowLookupRoots, findFlowFileInRoots, loadAllFlowEntries } from '../chunk-PJJSBZZP.js';
 import '../chunk-WD3L5QSU.js';
-import { nodeLabel, nodeSkillAsset, nodeIsInert, nodeIsOptional, nodeRunKind } from '../chunk-7RGTAEG6.js';
+import { nodeLabel, nodeSkillAsset, nodeIsInert, nodeIsOptional, nodeRunKind, nodeAssets } from '../chunk-7RGTAEG6.js';
 import '../chunk-JCPD4QRM.js';
-import { setLibraryAssetCheck, LibraryEntryError, AssetManager, parseRefTolerant, MissingManifestError, parseCanonicalLockKey, normalizeRepoUrl, FACTORY_SOURCE_URL } from '../chunk-HWNK3F3X.js';
-import { CatalogHttpError, libraryDirMissing, missingLibraryDirMessage, cloneOrInitGitRepo, trackOriginBranch, stampManifestPublisher, isGitRepo, ensureGitRepo, conflictingAssetRoot, scanUnlistedAssets, setManifestPublisher, LIBRARY_OWNERSHIPS, assertManifestEditable, installLibraryAsset, getStoreManifestsDir, assertValidLibraryName, unparsableAssetFiles, syncManifestWithDisk, renamedLibraryName, storeManifestFile, getDefaultValue, isSecretPlaceholder } from '../chunk-S2XHGWQC.js';
-import { flowFileNameError, SEMVER_RE } from '../chunk-UI745XC3.js';
-import '../chunk-YLLVSR2U.js';
-import '../chunk-BFMYYNDT.js';
+import { setLibraryAssetCheck, setRenamedEntryLookup, LibraryEntryError, AssetManager, parseRefTolerant, MissingManifestError, parseCanonicalLockKey, normalizeRepoUrl } from '../chunk-PKBLJI23.js';
+import { CatalogHttpError, libraryDirMissing, missingLibraryDirMessage, cloneOrInitGitRepo, trackOriginBranch, stampManifestPublisher, isGitRepo, ensureGitRepo, conflictingAssetRoot, scanUnlistedAssets, setManifestPublisher, LIBRARY_OWNERSHIPS, assertManifestEditable, installLibraryAsset, getStoreManifestsDir, assertValidLibraryName, unparsableAssetFiles, syncManifestWithDisk, renamedLibraryName, storeManifestFile, getDefaultValue, isSecretPlaceholder } from '../chunk-6CYKTHNT.js';
+import { flowFileNameError, SEMVER_RE } from '../chunk-MAZ3UXJK.js';
+import '../chunk-E5NQRHEB.js';
+import '../chunk-F3D25RGM.js';
 import '../chunk-3TXEJN4W.js';
 import '../chunk-ISHJITXJ.js';
 import '../chunk-LNFKL23K.js';
 import '../chunk-JRN5QF4C.js';
 import '../chunk-NUELZWCF.js';
-import { installTargetOf, SCAFFOLD_KINDS } from '../chunk-NUA33BYO.js';
-import '../chunk-NOA6EJXE.js';
+import { installTargetOf, SCAFFOLD_KINDS } from '../chunk-S2H3RBK7.js';
+import '../chunk-PKE3PXOK.js';
 import '../chunk-KTBKW2FI.js';
 import '../chunk-UQ6LFBPZ.js';
-import '../chunk-ABFPSVIS.js';
-import { effectiveComposes, validatePreset, validateAgent, composeSlotDiagnostics, agentDeprecationDiagnostics, SLOT_ID_PATTERN } from '../chunk-E572OHGY.js';
-import { loadSettings, globalSettingsPath, resolveSettings, projectSettingsPath, saveSettings, WorkspaceYamlEditor, resolveLibraryDir, checkAgentSkillConformance, resolveSettingsWithSources, resolveConfiguredHarnessName, readLock, globalInstallDir, GLOBAL_INSTALL_DIR_NAME, workspaceProviderRegistryPath, userProviderRegistryPath, loadProviderRegistryFile, aiResourceRoots } from '../chunk-VMVDAZLA.js';
+import '../chunk-COAFAYBS.js';
+import { effectiveComposes, validatePreset, validateAgent, composeSlotDiagnostics, agentDeprecationDiagnostics, SLOT_ID_PATTERN } from '../chunk-76FLBODK.js';
+import { loadSettings, globalSettingsPath, resolveSettings, projectSettingsPath, saveSettings, WorkspaceYamlEditor, resolveLibraryDir, checkAgentSkillConformance, resolveSettingsWithSources, resolveConfiguredHarnessName, readLock, FACTORY_SOURCE_URL, globalInstallDir, GLOBAL_INSTALL_DIR_NAME, workspaceProviderRegistryPath, userProviderRegistryPath, loadProviderRegistryFile, aiResourceRoots } from '../chunk-BRK5QZKI.js';
 import '../chunk-4GY63JU6.js';
-import { factoryAssetRoots } from '../chunk-ZDLUQLI6.js';
+import { factoryAssetRoots } from '../chunk-QPWR3YMY.js';
 import { deployedDir } from '../chunk-5KRMNUL4.js';
-import { DEFAULT_HARNESS_ID, HARNESS_DEFAULTS } from '../chunk-Z7ZEZZB6.js';
+import { DEFAULT_HARNESS_ID, HARNESS_DEFAULTS } from '../chunk-C5HFK34M.js';
 import { findKindDirs } from '../chunk-MWXYN6NY.js';
-import { SourceEntryError, LegacyKeyError, resolveSkWorkspaceConfig, sourceCacheKey, getGlobalCacheDir, resolveAgentDir, AgentRefResolutionError, resolveAgentDefinitionDir, effectiveAgentInstances, matchPin, coerceVersion, loadSkWorkspaceConfig, findWorkspaceRoot, isWorkspaceConfigFilename, SKAILE_YAML_DEFAULT, AGENT_PROFILE_FIELDS } from '../chunk-ZHGKAZJ7.js';
+import { SourceEntryError, LegacyKeyError, resolveSkWorkspaceConfig, sourceCacheKey, getGlobalCacheDir, resolveAgentDir, AgentRefResolutionError, resolveAgentDefinitionDir, effectiveAgentInstances, matchPin, coerceVersion, loadSkWorkspaceConfig, findWorkspaceRoot, isWorkspaceConfigFilename, SKAILE_YAML_DEFAULT, AGENT_PROFILE_FIELDS } from '../chunk-KJSC2ZD6.js';
 import { globalCacheRoot, globalSkaileDir, userConfigPath } from '../chunk-L5VSIPQD.js';
 import { HARNESS_TARGETS, SUPPORTED_HARNESSES, harnessNameForHarnessId } from '../chunk-VTETQCR6.js';
-import { SKAILE_MANIFEST_FILENAME, loadSkPublishManifest, decodeSkaileManifest, LIBRARY_GITIGNORE, librarySymlinkMessage, isNonAssetPath, isNonAssetDir, encodeSkaileManifest } from '../chunk-ZBHZLWV3.js';
+import { SKAILE_MANIFEST_FILENAME, loadSkPublishManifest, decodeSkaileManifest, LIBRARY_GITIGNORE, librarySymlinkMessage, isNonAssetPath, isNonAssetDir, encodeSkaileManifest } from '../chunk-KPKGWXUJ.js';
 import { pluginTitle } from '../chunk-RVRB27AN.js';
-import { dedupeRequirements, parseFrontmatter, scanDirectory, parseRequires } from '../chunk-RHN5MRQO.js';
-import { parseAssetRef, isValidPublisher, PUBLISHER_HINT, isValidAssetName, ASSET_NAME_HINT, depToStr, assetRefToStr, slugifyAssetName, parseAssetRefLoose } from '../chunk-LSSYC5IC.js';
-import { portableSpawn, portableSpawnSync } from '../chunk-ADPM6AYF.js';
+import { setWalkTruncationSink, dedupeRequirements, parseFrontmatter, scanDirectory, parseRequires } from '../chunk-JMIKGAUA.js';
+import { parseAssetRef, isValidPublisher, PUBLISHER_HINT, isValidAssetName, ASSET_NAME_HINT, depToStr, assetRefToStr, slugifyAssetName, parseAssetRefLoose } from '../chunk-IZQOO6MN.js';
+import { portableSpawn, portableSpawnSync } from '../chunk-VSX2G7LA.js';
 import { openSqlite } from '../chunk-DKXNKFKP.js';
-import { parseModelRef, resolveEntryBaseUrl } from '../chunk-LSI2IVFT.js';
+import { parseModelRef, resolveEntryBaseUrl } from '../chunk-RXGPFAMN.js';
 import '../chunk-C3CAXQMA.js';
 import { registerLogStore, LogStore, StdoutSink } from '../chunk-BOFL7GIF.js';
 import '../chunk-NSBPE2FW.js';
@@ -226,15 +226,17 @@ async function runSearch(kind, query, opts) {
   const showStore = !opts.local;
   const { resolveConfig } = await import('../library/index.js');
   const airGapped = resolveConfig({ projectDir: path19__default.resolve(opts.projectDir) }).catalog.cache_ttl === 0;
-  if (showLocal) {
-    await searchLocal(query, kind, opts, showStore, airGapped);
-  }
-  if (showStore) {
-    await searchStore(query, kind, opts, airGapped);
+  const localHits = showLocal ? await searchLocal(query, kind, opts, showStore, airGapped) : false;
+  const store = showStore ? await searchStore(query, kind, opts, airGapped) : "skipped";
+  if (showLocal && showStore && !localHits && store !== "hits") {
+    const what = query ? ` for "${query}"` : kind ? ` for kind "${kind}"` : "";
+    logInfo(
+      store === "empty" ? `No results${what} (local and store).` : `No local results${what}; the store was not searched.`
+    );
   }
 }
 async function searchIndex(query, kind, projectDir) {
-  const { openLibrary: openLibrary2 } = await import('../open-library-NKKUJLWA.js');
+  const { openLibrary: openLibrary2 } = await import('../open-library-XBR46DJL.js');
   const library = await openLibrary2();
   try {
     const { libraryDirMissing: libraryDirMissing2 } = await import('../library/index.js');
@@ -409,14 +411,14 @@ async function withAddVersions(entries, projectDir) {
 }
 async function searchLocal(query, kind, opts, showStore, airGapped) {
   const projectDir = path19__default.resolve(opts.projectDir);
-  const { restoreSourceReaders } = await import('../source-ASEHI2XS.js');
+  const { restoreSourceReaders } = await import('../source-2DJ5KNOI.js');
   for (const name of await restoreSourceReaders(projectDir)) {
     logInfo(`Re-registered source "${name}" (its library entry was removed elsewhere).`);
   }
   const factory = await searchFactory(projectDir, query, kind);
   let entries = unionEntries(await searchIndex(query, kind, projectDir), factory);
   if (entries.length === 0 && !query && !kind && !airGapped) {
-    const { autoSyncForSearch } = await import('../source-ASEHI2XS.js');
+    const { autoSyncForSearch } = await import('../source-2DJ5KNOI.js');
     if (await autoSyncForSearch(projectDir)) {
       entries = unionEntries(await searchIndex(query, kind, projectDir), factory);
     }
@@ -427,7 +429,7 @@ async function searchLocal(query, kind, opts, showStore, airGapped) {
         query ? `No entries matching "${query}".` : kind ? `No "${kind}" assets found in this project's sources.` : "No assets found. Run `skaile source sync` first."
       );
     }
-    return;
+    return false;
   }
   if (showStore) {
     console.log(`
@@ -439,6 +441,7 @@ async function searchLocal(query, kind, opts, showStore, airGapped) {
       projectDir
     )
   );
+  return true;
 }
 var MIN_LOCAL_DESCRIPTION_WIDTH = 10;
 function layoutLocalTable(rows, width, style = {}) {
@@ -531,9 +534,9 @@ function formatStoreRows(assets, indent, width = terminalWidth()) {
 async function searchStore(query, kind, opts, airGapped) {
   if (airGapped && !opts.store) {
     logInfo("air-gapped (cache_ttl: 0) \u2014 local sources only");
-    return;
+    return "skipped";
   }
-  const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-NKKUJLWA.js');
+  const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-XBR46DJL.js');
   try {
     const remote = await openCatalogSource2({ projectDir: path19__default.resolve(opts.projectDir) });
     const assets = await remote.listAssets(kind ? { kind } : {});
@@ -546,6 +549,7 @@ async function searchStore(query, kind, opts, airGapped) {
       logInfo("No results in store");
     }
     for (const note of storeSelectionNotes(sel, "    ")) console.log(note);
+    return sel.shown.length > 0 ? "hits" : "empty";
   } catch (e) {
     const local = e instanceof LocalCatalogDisabledError2;
     if (opts.store) {
@@ -558,6 +562,7 @@ async function searchStore(query, kind, opts, airGapped) {
         local ? "remote catalog disabled (catalog.url: local) \u2014 showing local results only" : "store unavailable \u2014 showing local results only (run with --store to see the error)"
       );
     }
+    return "skipped";
   }
 }
 async function describeStoreFailure(err, projectDir) {
@@ -642,6 +647,9 @@ function makeAddCommand() {
   return new Command("add").description("Add to skaile.yaml + deploy").argument("<ref>", "Asset reference (kind:@<publisher>/name#<version>)").option("--project-dir <path>", "Project directory", process.cwd()).option("--global", "Record in ~/.skaile/skaile.yaml + deploy to every global harness").option(
     "--harness <ids>",
     "Comma-separated global harnesses to deploy into (default: all resolved); implies --global"
+  ).option(
+    "--only",
+    "with --harness on an asset that is already global: replace its harness set (default: add to it)"
   ).option("--target <agent>", `Harness target (${TARGET_DEFAULT_HINT})`).option(
     "--link",
     "symlink local-path assets instead of copying (dev loop; machine-local, not for committing)"
@@ -660,6 +668,10 @@ function makeAddCommand() {
       process.exit(1);
     }
     const harnesses = parseHarnessFilter(opts.harness);
+    if (opts.only && harnesses === void 0) {
+      logErr("--only needs --harness: it replaces the set of harnesses the asset goes to.");
+      process.exit(1);
+    }
     if (!opts.global && harnesses === void 0) requireProjectConfig(opts.projectDir);
     const warnings = deferredWarnings();
     const collisionKeys = [];
@@ -687,6 +699,12 @@ function makeAddCommand() {
       const added = await am2.add(ref, {
         link: opts.link,
         force: opts.force,
+        only: opts.only === true,
+        onDroppedCopy: (droppedRef, harness, copy) => logInfo(
+          S.dim(
+            `${harness} is no longer in the set of ${droppedRef} but still holds ${copy.replace(homedir(), "~")} (delete it with skaile remove ${droppedRef} --global --harness ${harness})`
+          )
+        ),
         onLibraryOrigin: (deployedRef, library) => libraryOf.set(deployedRef, library),
         onPlaceholderBody: (deployedRef) => placeholderBodies.push(deployedRef),
         onPlaceholderDescription: (deployedRef) => placeholderDescriptions.push(deployedRef),
@@ -748,24 +766,24 @@ function makeAddCommand() {
           logInfo(
             `Recorded in skaile.yaml (store bytes are fetched + verified into .skaile/cache/store). ${kind} assets are not deployed into the harness target \u2014 they are composed when skaile runs the agent.`
           );
-        else logInfo("Nothing to deploy (already up to date).");
+        else {
+          logInfo("Nothing to deploy (already up to date).");
+          if (am2.global) reportGlobalPaths(am2, [parsedRef]);
+        }
       } else {
         for (const a of added) {
           const library = libraryOf.get(a);
           logOk(library ? `${a} (library ${library})` : a);
         }
         warnPlaceholderBodies(placeholderBodies, placeholderDescriptions);
-        if (!am2.global) warnFilesOnlyDelegates(am2.projectDir, am2.harness);
+        if (!am2.global && added.some((a) => a.startsWith("agent:"))) {
+          warnFilesOnlyDelegates(am2.projectDir, am2.harness);
+        }
         if (am2.global) {
-          for (const a of added) {
-            const { kind, name } = parseAssetRef(a);
-            const component = installTargetOf(getKindRegistry(), kind);
-            if (!component) continue;
-            for (const harness of am2.deployTargets()) {
-              const dir = deployedDir(component, name, harness, true);
-              if (existsSync(dir)) logInfo(S.dim(`${harness}: ${dir.replace(homedir(), "~")}`));
-            }
-          }
+          reportGlobalPaths(
+            am2,
+            added.map((a) => parseAssetRef(a))
+          );
           reportLegacyOmpCopies(am2.takeLegacyCopiesRemoved(), am2.takeLegacyCopiesKept());
         }
         if (added.length > 1) {
@@ -794,12 +812,23 @@ function makeAddCommand() {
     }
   });
 }
+function reportGlobalPaths(am2, assets) {
+  for (const { kind, name } of assets) {
+    const component = installTargetOf(getKindRegistry(), kind);
+    if (!component) continue;
+    for (const harness of am2.deployTargets()) {
+      const dir = deployedDir(component, name, harness, true);
+      if (existsSync(dir)) logInfo(S.dim(`${harness}: ${dir.replace(homedir(), "~")}`));
+    }
+  }
+}
 function printAddPlan(plan) {
   const line = (item, label) => {
     logInfo(
       `${label} ${colorRef(item.ref)}${item.version ? `#${item.version}` : ""} (${item.origin})`
     );
     for (const folder of item.folders) console.log(`    folder: ${S.dim(folder)}`);
+    for (const file of item.renders) console.log(`    writes: ${S.dim(file)}`);
     if (item.files.length > 0) console.log(`    files:  ${S.dim(item.files.join(", "))}`);
   };
   for (const item of plan.filter((i) => i.requested)) line(item, "Would add");
@@ -853,7 +882,8 @@ function makeRemoveCommand() {
       ", "
     )} (lock entry) \u2014 it was kept; remove that asset to delete it, or \`skaile remove ${ref} --force\`` : void 0;
     if (!result.changed) {
-      logErr(`Not deployed or declared: ${ref}`);
+      const otherKind = await am2.otherKindHint(ref);
+      logErr(`Not deployed or declared: ${ref}${otherKind ? `. ${otherKind}` : ""}`);
       if (keptNote) logInfo(keptNote);
       if (ownerNote) logInfo(ownerNote);
       process.exitCode = 1;
@@ -898,6 +928,7 @@ function makeListCommand() {
       runGlobalList(kind, opts, harnesses);
       return;
     }
+    if (await reportUnknownHarnesses(path19__default.resolve(opts.projectDir)) > 0) process.exit(1);
     const am2 = new AssetManager({
       registry: getKindRegistry(),
       projectDir: path19__default.resolve(opts.projectDir),
@@ -917,7 +948,7 @@ function makeListCommand() {
     }
     if (declared.length === 0) {
       logInfo("No dependencies declared in skaile.yaml.");
-      warnLegacyClaudeCopies(am2);
+      warnStaleHarnessCopies(am2);
       return;
     }
     const kindW = Math.max(4, ...declared.map((e) => e.kind.length));
@@ -943,7 +974,7 @@ function makeListCommand() {
     const invalid = declared.filter((e) => e.state === "invalid").length;
     if (invalid > 0)
       logInfo(`${invalid} invalid \u2014 fix the ${S.cmd("skaile.yaml")} dependencies entry.`);
-    warnLegacyClaudeCopies(am2);
+    warnStaleHarnessCopies(am2);
     console.log();
   });
 }
@@ -1069,7 +1100,7 @@ async function resolveInfoEntry(am2, ref, opts) {
     return { entry: match ?? deployed };
   }
   const lookup = opts.storeLookup ?? (async (filter) => {
-    const { resolveCatalogSource } = await import('../open-library-NKKUJLWA.js');
+    const { resolveCatalogSource } = await import('../open-library-XBR46DJL.js');
     const { source, close } = await resolveCatalogSource({ projectDir: opts.projectDir });
     try {
       return await source.listAssets(filter);
@@ -1085,7 +1116,7 @@ async function resolveInfoEntry(am2, ref, opts) {
     );
     return { entry: hit ? catalogAssetToEntry(hit) : null };
   } catch (err) {
-    const { LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-NKKUJLWA.js');
+    const { LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-XBR46DJL.js');
     const storeNote = err instanceof Error ? err.message : String(err);
     const disabled = err instanceof LocalCatalogDisabledError2 || /catalog\.url/i.test(storeNote);
     return { entry: null, storeNote, ...disabled ? { storeDisabled: true } : {} };
@@ -1113,7 +1144,8 @@ function makeInfoCommand() {
     }
     const entry = lookup.entry;
     if (!entry) {
-      logErr(infoNotFoundHint(ref, lookup));
+      const otherKind = await am2.otherKindHint(ref);
+      logErr(`${infoNotFoundHint(ref, lookup)}${otherKind ? ` ${otherKind}` : ""}`);
       process.exit(1);
     }
     const softDeps = await am2.softDepsOf([ref]);
@@ -1440,10 +1472,11 @@ function makeAssetCommand() {
           getKindRegistry(),
           norm.content
         );
-        if (checked.errors.length > 0) {
-          for (const f of checked.errors) logErr(`${norm.name}/SKILL.md [${f.tag}] \u2014 ${f.text}`);
+        const refusals = [...checked.errors, ...checked.advisories.filter((f) => f.scaffoldBody)];
+        if (refusals.length > 0) {
+          for (const f of refusals) logErr(`${norm.name}/SKILL.md [${f.tag}] \u2014 ${f.text}`);
           logErr(
-            `Not imported: ${checked.errors.length} problem(s) in SKILL.md. Fix them in ${src.skillFile} (or drop --no-normalize) and run the import again.`
+            `Not imported: ${refusals.length} problem(s) in SKILL.md. Fix them in ${src.skillFile} (or drop --no-normalize) and run the import again.`
           );
           process.exit(1);
         }
@@ -1807,7 +1840,7 @@ function makeCatalogCommand() {
   return catalog;
 }
 async function runLocalCatalogTest(projectDir) {
-  const { resolveCatalogSource } = await import('../open-library-NKKUJLWA.js');
+  const { resolveCatalogSource } = await import('../open-library-XBR46DJL.js');
   let resolved;
   try {
     resolved = await resolveCatalogSource({ projectDir });
@@ -1983,7 +2016,7 @@ async function scanLibraryFlowEntries() {
     const { LocalIndex, resolveIndexPath, scanAuthoringLibraries } = await import('../library/index.js');
     const indexPath = resolveIndexPath();
     if (!existsSync(indexPath)) return entries;
-    const { getKindRegistry: getKindRegistry2 } = await import('../open-registry-BYAXSHUI.js');
+    const { getKindRegistry: getKindRegistry2 } = await import('../open-registry-W562DCDL.js');
     const index = new LocalIndex({ indexPath });
     try {
       for (const { library, assets } of await scanAuthoringLibraries(index, getKindRegistry2())) {
@@ -2248,6 +2281,12 @@ function printModelSelectionSection(config, projectDir) {
       console.log(
         `  ${S.dim("no AI provider is configured \u2014 add one with")} ${S.cmd("skaile providers add <id> --preset <preset>")}`
       );
+    } else if (resolved.fallback) {
+      console.log(`  ${S.label("selector:".padEnd(16))} ${selector}`);
+      console.log(
+        `  ${S.label("passed on as:".padEnd(16))} the model id ${resolved.modelId ?? selector} ${S.dim("(no provider selected)")}`
+      );
+      for (const warning of resolved.warnings) logWarn(warning);
     } else {
       const entry = registry.providers[resolved.providerId];
       console.log(`  ${S.label("selector:".padEnd(16))} ${selector}`);
@@ -2294,6 +2333,7 @@ async function showConfig(opts) {
     logErr(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
+  if (await reportUnknownHarnesses(projectDir) > 0) process.exit(1);
   printEffectiveSection(config, sources);
   printWorkspaceDefaultsSection(wsDefaults);
   printModelSelectionSection(config, projectDir);
@@ -2432,6 +2472,13 @@ function makeConfigCommand() {
           logWarn(
             "no AI provider is configured yet \u2014 add one with `skaile providers add <id> --preset <preset>`"
           );
+        } else if (resolved.fallback) {
+          console.log(
+            S.dim(
+              `  \u2192 passed on as the model id ${resolved.modelId ?? value} (no provider selected)`
+            )
+          );
+          for (const warning of resolved.warnings) logWarn(warning);
         } else {
           console.log(
             S.dim(
@@ -3115,7 +3162,7 @@ async function ensureTargetsRegistered(projectDir) {
   const { resolveSkWorkspaceConfig: resolveSkWorkspaceConfig2 } = await import('../core/index.js');
   const config = resolveSkWorkspaceConfig2(projectDir);
   if (config.plugins && config.plugins.length > 0) {
-    const { ensurePluginsLoaded } = await import('../plugin-store-ABE35NRX.js');
+    const { ensurePluginsLoaded } = await import('../plugin-store-36SIL4TV.js');
     const result = await ensurePluginsLoaded(projectDir, config.plugins, pluginRegistry);
     for (const f of result.failed) logWarn(f.error);
   }
@@ -3274,7 +3321,10 @@ function makeDiffCommand() {
     );
     switch (result.status) {
       case "not-found":
-        if (problems.length === 0) logErr(`Asset not found: ${ref}`);
+        if (problems.length === 0) {
+          const hint = await am2.otherKindHint(ref);
+          logErr(`Asset not found: ${ref}${hint ? `. ${hint}` : ""}`);
+        }
         break;
       case "not-deployed":
         if (problems.length === 0) {
@@ -3395,7 +3445,7 @@ function makeHarnessCommand() {
 async function runHarnessSet(name, projectDir) {
   const target = parseHarnessTarget(name);
   if (!target) {
-    logErr(`Unknown harness "${name}". Supported: ${SUPPORTED_HARNESSES.join(", ")}`);
+    logErr(unknownHarnessTargetMessage(name));
     process.exit(1);
   }
   requireProjectConfig(projectDir);
@@ -3746,7 +3796,7 @@ var TOGGLE_SUPPORTED = ["claude-code"];
 function resolveHarness(harness) {
   if (harness === "all") return [...ALL_HARNESSES];
   if (harness === "claude-code" || harness === "omp" || harness === "codex") return [harness];
-  logErr(`Unknown harness "${harness}". Supported: ${ALL_HARNESSES.join(", ")}, all`);
+  logErr(unknownHarnessTargetMessage(harness, ["all"]));
   return null;
 }
 function withHarness(raw, fallback) {
@@ -4350,6 +4400,16 @@ function warnUnlistedAssets(unlisted, name) {
     );
   }
 }
+function warnManifestNeedsCommit(libPath, name) {
+  const status4 = spawnSync("git", ["status", "--porcelain", "--", SKAILE_MANIFEST_FILENAME], {
+    cwd: libPath,
+    encoding: "utf-8"
+  });
+  if (status4.status !== 0 || status4.stdout.trim() === "") return;
+  logInfo(
+    `${SKAILE_MANIFEST_FILENAME} was changed in the clone. Commit it with \`skaile library commit ${name}\`; \`pull\` and \`sync\` stop until you do.`
+  );
+}
 function assertManifestEditableOrExit(libraryPath) {
   try {
     assertManifestEditable(libraryPath);
@@ -4603,7 +4663,7 @@ function remoteBranches(url) {
   return r.stdout.split("\n").map((line) => line.split("	")[1]?.replace(/^refs\/heads\//, "")).filter((b) => !!b);
 }
 async function warnIfNotGithubRemote(name, url) {
-  const { isGithubRemote, notGithubRemoteMessage } = await import('../library-publish-I3UWXAHI.js');
+  const { isGithubRemote, notGithubRemoteMessage } = await import('../library-publish-XMRCKRNR.js');
   if (!isGithubRemote(url)) logWarn(notGithubRemoteMessage(name, url));
 }
 function scaffoldLibraryFiles(dir, name) {
@@ -4789,7 +4849,7 @@ function makeLibraryCommand() {
           ownership,
           isDefault
         });
-        const scaffolded = blank ? scaffoldLibraryFiles(libPath, name) : [];
+        const scaffolded = blank && ownership !== "reader" ? scaffoldLibraryFiles(libPath, name) : [];
         logOk(
           `Library "${name}" ${blank ? "created" : "registered"} at ${libPath}${isDefault ? " (default)" : ""}`
         );
@@ -4806,8 +4866,9 @@ function makeLibraryCommand() {
         }
         if (!blank) {
           const lib = await manager.requireLibrary(name);
-          if (adoptWritesManifest(libPath)) {
+          if (ownership === "owner" && adoptWritesManifest(libPath)) {
             await reindexLibrary(lib, library, name);
+            warnManifestNeedsCommit(lib.path, name);
             return;
           }
           const unlisted = await countUnlistedAssets(libPath);
@@ -4818,8 +4879,9 @@ function makeLibraryCommand() {
             );
           }
           warnLibraryNameFallback(name, resolved);
-          if (resolved.source !== "manifest") {
+          if (ownership === "owner" && resolved.source !== "manifest") {
             stampManifestPublisher(lib.path, resolved.publisher);
+            warnManifestNeedsCommit(lib.path, name);
           }
           const res = await indexLibrary(lib, library);
           for (const e of res.errors) logWarn(e);
@@ -5334,16 +5396,16 @@ function makeLibraryCommand() {
     "With --create-repo: create the repo private (the store only accepts public repos)"
   ).option("--ref <gitref>", "Git ref to ingest (default: the library branch or main)").option("--dry-run", "Print the plan; push nothing and call no store endpoint").action(
     async (lib, opts) => {
-      const { runLibraryPublish } = await import('../library-publish-I3UWXAHI.js');
+      const { runLibraryPublish } = await import('../library-publish-XMRCKRNR.js');
       await withStoreErrorHandling(() => runLibraryPublish(lib, opts));
     }
   );
   cmd.command("register <lib>").description("Register the library's manifest without pushing (bytes already on github)").option("--asset <ref>", "Publish only the single asset matching this ref/name").option("--ref <gitref>", "Git ref to ingest (default: the library branch or main)").option("--dry-run", "Print the plan; call no store endpoint").action(async (lib, opts) => {
-    const { runLibraryRegister } = await import('../library-publish-I3UWXAHI.js');
+    const { runLibraryRegister } = await import('../library-publish-XMRCKRNR.js');
     await withStoreErrorHandling(() => runLibraryRegister(lib, opts));
   });
   cmd.command("yank <lib>").description("Retract the library's published assets from the store").option("--asset <ref>", "Yank only the single asset matching this ref/name").action(async (lib, opts) => {
-    const { runLibraryYank } = await import('../library-publish-I3UWXAHI.js');
+    const { runLibraryYank } = await import('../library-publish-XMRCKRNR.js');
     await withStoreErrorHandling(() => runLibraryYank(lib, opts));
   });
   return cmd;
@@ -6003,7 +6065,7 @@ function scheduleSoftDepPreview() {
 }
 async function loadAssets() {
   softDepPreviewCache.clear();
-  const { gatherAssetFeeds } = await import('../asset-feeds-HJFV7UPW.js');
+  const { gatherAssetFeeds } = await import('../asset-feeds-KPKCE64E.js');
   const { entries, notes } = await gatherAssetFeeds(am, am.projectDir);
   if (notes.length > 0) {
     state.message = notes.map((n) => `[${n.feed}] ${n.message}`).join(" \u2022 ");
@@ -6207,7 +6269,7 @@ function reconcileCollapsedSets(rows) {
 async function loadSourcesAndLibraries() {
   try {
     const [{ openLibraryManager: openLibraryManager2 }, { getGlobalCacheDir: getGlobalCacheDir2, globalSkaileDir: globalSkaileDir2 }] = await Promise.all([
-      import('../open-library-NKKUJLWA.js'),
+      import('../open-library-XBR46DJL.js'),
       import('../core/index.js')
     ]);
     const { manager, library, close } = await openLibraryManager2();
@@ -8043,7 +8105,35 @@ function finalIdentity(kind, name) {
     return `${kind}:${name}`;
   }
 }
-function planMarkdownMoves(root, knownKinds, manual, unknownTypes, identities, conflicts) {
+function existingIdentities(root) {
+  const found = /* @__PURE__ */ new Map();
+  const note = (file, kind, fallback) => {
+    let name = fallback;
+    try {
+      const text = readText(file);
+      const body = file.endsWith(".yaml") ? text : FRONTMATTER.exec(text)?.[1] ?? "";
+      const parsed = parse(body);
+      if (isRecord(parsed) && typeof parsed.name === "string" && parsed.name !== "")
+        name = parsed.name;
+    } catch {
+    }
+    const identity = finalIdentity(kind, name);
+    if (!found.has(identity)) found.set(identity, posix2(path19__default.relative(root, file)));
+  };
+  for (const file of walkFiles(root, (b) => b.endsWith(".preset.yaml"))) {
+    note(file, "preset", path19__default.basename(file).replace(/\.preset\.yaml$/, ""));
+  }
+  for (const [base, kind] of [
+    ["RULESET.md", "ruleset"],
+    ["PERSONA.md", "persona"]
+  ]) {
+    for (const file of walkFiles(root, (b) => b === base)) {
+      note(file, kind, path19__default.basename(path19__default.dirname(file)));
+    }
+  }
+  return found;
+}
+function planMarkdownMoves(root, knownKinds, manual, unknownTypes, identities, conflicts, existing) {
   const moves = [];
   const changes = [];
   const targets = /* @__PURE__ */ new Set();
@@ -8071,6 +8161,13 @@ function planMarkdownMoves(root, knownKinds, manual, unknownTypes, identities, c
         );
         continue;
       }
+      const present = existing.get(identity);
+      if (present !== void 0) {
+        conflicts.push(
+          `${present} already is ${identity}, and ${posix2(path19__default.relative(root, file))} would become it too: rename one first. Nothing was changed.`
+        );
+        continue;
+      }
       identities.set(identity, posix2(path19__default.relative(root, file)));
       targets.add(to);
       moves.push({ from: file, to, kind: found.type });
@@ -8155,7 +8252,7 @@ function repoPublisher(root) {
   }
   return DEFAULT_PUBLISHER;
 }
-function planBundles(root, skaileYamls, publisher, notes, manual, conflicts, identities) {
+function planBundles(root, skaileYamls, publisher, notes, manual, conflicts, identities, existing) {
   const changes = [];
   const presets = [];
   const handled = /* @__PURE__ */ new Set();
@@ -8183,6 +8280,13 @@ function planBundles(root, skaileYamls, publisher, notes, manual, conflicts, ide
       manual.push(`${rel(target)} already exists; bundle ${name} not converted`);
       return;
     }
+    const present = existing.get(identity);
+    if (present !== void 0) {
+      conflicts.push(
+        `${present} already is ${identity}, and ${origin} would become it too: rename the bundle first. Nothing was changed.`
+      );
+      return;
+    }
     let description;
     let refs = [];
     let before;
@@ -8348,13 +8452,15 @@ function planAssetMigration(options) {
   const conflicts = [];
   const unknownTypes = [];
   const identities = /* @__PURE__ */ new Map();
+  const existing = existingIdentities(root);
   const { moves, changes: moveChanges } = planMarkdownMoves(
     root,
     knownKinds,
     manual,
     unknownTypes,
     identities,
-    conflicts
+    conflicts,
+    existing
   );
   for (const move of moves) {
     notes.push(
@@ -8381,7 +8487,8 @@ function planAssetMigration(options) {
     notes,
     manual,
     conflicts,
-    identities
+    identities,
+    existing
   );
   const skaileChanges = skaileYamls.flatMap(
     ({ file, source }) => planSkaileYaml(root, file, source, notes, manual)
@@ -9165,8 +9272,15 @@ function makeOutdatedCommand() {
       );
     }
     console.log();
-    if (filtered.some((e) => e.problem === void 0 && !e.pinned)) {
-      logWarn(`Run ${S.cmd("skaile update")} to re-lock and re-deploy.`);
+    const needsUpdate = filtered.some(
+      (e) => e.problem === void 0 && !e.pinned && !e.contentChanged
+    );
+    const needsRelock = filtered.some(
+      (e) => e.problem === void 0 && !e.pinned && e.contentChanged
+    );
+    if (needsUpdate) logWarn(`Run ${S.cmd("skaile update")} to re-lock and re-deploy.`);
+    if (needsRelock) {
+      logWarn(`Run ${S.cmd("skaile install")} to re-lock the changed library assets.`);
     }
     if (filtered.some((e) => e.problem !== void 0 && !e.manualFix)) {
       logWarn(`Run ${S.cmd("skaile install")} to restore or re-lock the broken assets.`);
@@ -9247,7 +9361,7 @@ function action2(fn) {
   };
 }
 async function reconcileAndReport(projectDir, plugins, opts = {}) {
-  const { reconcilePlugins } = await import('../plugin-store-ABE35NRX.js');
+  const { reconcilePlugins } = await import('../plugin-store-36SIL4TV.js');
   if (plugins.length === 0) {
     logInfo("No plugins declared \u2014 nothing to reconcile.");
     return;
@@ -9262,7 +9376,7 @@ async function reconcileAndReport(projectDir, plugins, opts = {}) {
   }
 }
 async function verifyPluginLoads(projectDir, spec) {
-  const { loadPlugins } = await import('../plugin-store-ABE35NRX.js');
+  const { loadPlugins } = await import('../plugin-store-36SIL4TV.js');
   const { createPluginRegistry } = await import('../plugin-registry/index.js');
   const registry = createPluginRegistry();
   const result = await loadPlugins(projectDir, [spec], registry);
@@ -9276,7 +9390,9 @@ async function verifyPluginLoads(projectDir, spec) {
 async function runInstall2(spec, opts) {
   const projectDir = path19__default.resolve(opts.projectDir);
   const { WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-  const { specName, rollbackPluginStore } = await import('../plugin-store-ABE35NRX.js');
+  const { specName, rollbackPluginStore, npmSpecError } = await import('../plugin-store-36SIL4TV.js');
+  const specError = npmSpecError(spec);
+  if (specError) throw new Error(specError);
   const yamlPath = path19__default.join(projectDir, "skaile.yaml");
   if (!existsSync(yamlPath)) {
     throw new Error(`no skaile.yaml in ${projectDir}; run \`skaile init\` first`);
@@ -9305,7 +9421,7 @@ async function runInstall2(spec, opts) {
 async function runRemove(name, opts) {
   const projectDir = path19__default.resolve(opts.projectDir);
   const { WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-  const { specName } = await import('../plugin-store-ABE35NRX.js');
+  const { specName } = await import('../plugin-store-36SIL4TV.js');
   const yamlPath = path19__default.join(projectDir, "skaile.yaml");
   if (!existsSync(yamlPath)) {
     logInfo(`No plugin matching ${S.cmd(name)}: there is no skaile.yaml in ${projectDir}.`);
@@ -9337,7 +9453,7 @@ async function runList(opts) {
   const registry = createPluginRegistry();
   if (declared.length > 0) {
     try {
-      const { loadPlugins } = await import('../plugin-store-ABE35NRX.js');
+      const { loadPlugins } = await import('../plugin-store-36SIL4TV.js');
       const result = await loadPlugins(projectDir, declared, registry);
       for (const f of result.failed) logWarn(f.error);
     } catch (err) {
@@ -10133,6 +10249,11 @@ function makeRebuildCommand() {
   ).option("--project-dir <dir>", "Project directory", process.cwd()).action(async (agentArg, opts) => {
     const projectDir = path19__default.resolve(opts.projectDir);
     requireProjectConfig(projectDir, { allowMissing: true });
+    const instanceErrors = agentInstanceErrorLines(projectDir);
+    if (instanceErrors.length > 0) {
+      for (const line of instanceErrors) logErr(line);
+      process.exit(1);
+    }
     let agentDir;
     if (agentArg) {
       agentDir = resolveNamedAgent(projectDir, agentArg);
@@ -10373,6 +10494,34 @@ function isNearFlowId(typed, id) {
 function harnessOptionDescription() {
   return `Harness to run (${listHarnesses().map((d) => d.id).join(", ")})`;
 }
+function nodeSkillRefs(flow) {
+  const refs = /* @__PURE__ */ new Map();
+  for (const node of flow.nodes) {
+    for (const asset of nodeAssets(node)) {
+      if (asset.startsWith("skill:") && !refs.has(asset)) refs.set(asset, node.id);
+    }
+  }
+  return refs;
+}
+async function reportMissingNodeSkills(projectDir, flow) {
+  const refs = nodeSkillRefs(flow);
+  if (refs.size === 0) return;
+  let missing;
+  try {
+    missing = new AssetManager({
+      registry: getKindRegistry(),
+      projectDir
+    }).undeployedSkills([...refs.keys()]);
+  } catch {
+    return;
+  }
+  for (const ref of missing) {
+    const bare = ref.replace(/#.*$/, "");
+    logWarn(
+      `Node ${refs.get(ref)} needs ${S.cmd(bare)}, which is not deployed. Run ${S.cmd(`skaile add ${bare}`)}.`
+    );
+  }
+}
 function makeRunCommand() {
   const cmd = new Command("run").description("Start a flow or run a single-shot text prompt").argument("[flow-id-or-text...]", "Flow ID or text prompt").option("--project-dir <path>", "Project directory", process.cwd()).option("--harness <name>", harnessOptionDescription()).addOption(driverAliasOption()).option("--model <name>", "Model override").option("--label <label>", "Human-readable session label").option("--dry-run", "Print plan without executing (single-shot: resolved composition items)").option(
     "--agent-definition <ref|path>",
@@ -10383,7 +10532,9 @@ function makeRunCommand() {
   ).option("--skill <name>", "Skill name (for single-shot mode)").action(async (positional, opts) => {
     const projectDir = path19__default.resolve(opts.projectDir);
     await loadDeclaredPlugins(projectDir);
-    await reportProjectConfig(projectDir, { harness: false });
+    if (await reportProjectConfig(projectDir, { harness: false, instances: true }) > 0) {
+      process.exit(1);
+    }
     const cliHarness = foldDriverFlag(opts).harness;
     const dryRun = opts.dryRun ?? false;
     const agentDefinition = opts.agentDefinition?.trim() || void 0;
@@ -10539,6 +10690,7 @@ function makeRunCommand() {
         onEvent: makeFlowEventHandler(),
         onLog: (line) => console.log(line)
       });
+      if (dryRun) await reportMissingNodeSkills(projectDir, flow);
     } catch (err) {
       const friendly = friendlyHarnessError(err);
       logErr(friendly ?? (err instanceof Error ? err.message : String(err)));
@@ -10678,7 +10830,9 @@ function makeReplCommand() {
       console.log();
     }
     await loadDeclaredPlugins(projectDir);
-    await reportProjectConfig(projectDir, { harness: false });
+    if (await reportProjectConfig(projectDir, { harness: false, instances: true }) > 0) {
+      process.exit(1);
+    }
     const effective = await resolveSettings(projectDir, {
       harness: harnessOverride,
       model: opts.model
@@ -10714,6 +10868,15 @@ function makeReplCommand() {
     }
   });
 }
+function valueNotFlag(flag) {
+  return (value) => {
+    if (value.startsWith("--")) {
+      logErr(`${flag} needs a value, got '${value}'`);
+      process.exit(1);
+    }
+    return value;
+  };
+}
 function parseProviderIds(raw) {
   return (raw ?? "").split(",").map((id) => id.trim()).filter((id) => id.length > 0);
 }
@@ -10760,21 +10923,31 @@ function describeBindError(err, host, port) {
   }
 }
 function makeServeCommand() {
-  return new Command("serve").description("Start a WebSocket agent server (for platform integration)").option("--port <port>", "WebSocket server port", "8080").option(
+  return new Command("serve").description("Start a WebSocket agent server (for platform integration)").option("--port <port>", "WebSocket server port", valueNotFlag("--port"), "8080").option(
     "--host <address>",
-    "Address to bind (default: all interfaces; use 127.0.0.1 for local clients only)"
-  ).option("--project-dir <path>", "Project directory", process.cwd()).option(
+    "Address to bind (default: all interfaces; use 127.0.0.1 for local clients only)",
+    valueNotFlag("--host")
+  ).option(
+    "--project-dir <path>",
+    "Project directory",
+    valueNotFlag("--project-dir"),
+    process.cwd()
+  ).option(
     "--managed-codex-config <path>",
-    "Explicit private host configuration for managed Codex"
-  ).option("--harness <name>", "Override harness").addOption(driverAliasOption()).option("--model <name>", "Override model").option("--provider <name>", "Override provider").option(
+    "Explicit private host configuration for managed Codex",
+    valueNotFlag("--managed-codex-config")
+  ).option("--harness <name>", "Override harness", valueNotFlag("--harness")).addOption(driverAliasOption().argParser(valueNotFlag("--driver"))).option("--model <name>", "Override model", valueNotFlag("--model")).option("--provider <name>", "Override provider", valueNotFlag("--provider")).option(
     "--session-id <id>",
-    "Label for the session; does not restore the conversation (use --resume-session-id)"
+    "Label for the session; does not restore the conversation (use --resume-session-id)",
+    valueNotFlag("--session-id")
   ).option(
     "--resume-session-id <id>",
-    "harnessSessionId of an earlier session (from its session_info event); restores that conversation"
+    "harnessSessionId of an earlier session (from its session_info event); restores that conversation",
+    valueNotFlag("--resume-session-id")
   ).option(
     "--providers <ids>",
-    "Restrict the AI provider registry to these entry ids (comma-separated)"
+    "Restrict the AI provider registry to these entry ids (comma-separated)",
+    valueNotFlag("--providers")
   ).option(
     "--model-endpoint [port]",
     "Serve an OpenAI-compatible model endpoint on loopback for apps next to the session (optional port; default from skaile.yaml model_endpoint.port, else ephemeral)"
@@ -10808,6 +10981,14 @@ function makeServeCommand() {
         process.exitCode = 1;
         return;
       }
+      const dirProblem = (await import('../serve-preflight-CGA5G3AE.js')).checkServeProjectDir(
+        opts.projectDir
+      );
+      if (dirProblem) {
+        logErr(dirProblem);
+        process.exitCode = 1;
+        return;
+      }
       let managedCodex;
       if (opts.managedCodexConfig) {
         try {
@@ -10829,7 +11010,14 @@ function makeServeCommand() {
       }
       const providers = parseProviderIds(opts.providers);
       const modelEndpoint = parseModelEndpointFlag(opts.modelEndpoint);
-      const { checkHarnessSdk, checkModelEndpointPeer, checkServeModel } = await import('../serve-preflight-FLTIBTEX.js');
+      const { checkHarnessSdk, checkModelEndpointPeer, checkServeModel } = await import('../serve-preflight-CGA5G3AE.js');
+      const { checkServeHarness, checkServeAgentDefinition } = await import('../serve-preflight-CGA5G3AE.js');
+      const startProblem = managedCodex ? null : await checkServeHarness(opts.projectDir, opts.harness) ?? checkServeAgentDefinition(opts.projectDir);
+      if (startProblem) {
+        logErr(startProblem);
+        process.exitCode = 1;
+        return;
+      }
       const harnessProblem = managedCodex ? null : await checkHarnessSdk(opts.projectDir, opts.harness);
       if (harnessProblem) {
         logErr(harnessProblem);
@@ -10890,12 +11078,12 @@ function makeServeCommand() {
   );
 }
 async function ensurePluginsLoadedForServe(projectDir) {
-  const { logInfo: logInfo2, logWarn: logWarn2 } = await import('../helpers-JNMK3FC2.js');
+  const { logInfo: logInfo2, logWarn: logWarn2 } = await import('../helpers-LUSV2ICC.js');
   try {
     const { resolveSkWorkspaceConfig: resolveSkWorkspaceConfig2 } = await import('../core/index.js');
     const config = resolveSkWorkspaceConfig2(projectDir);
     if (!config.plugins || config.plugins.length === 0) return;
-    const { ensurePluginsLoaded } = await import('../plugin-store-ABE35NRX.js');
+    const { ensurePluginsLoaded } = await import('../plugin-store-36SIL4TV.js');
     const { pluginRegistry } = await import('../plugin-registry/index.js');
     const result = await ensurePluginsLoaded(projectDir, config.plugins, pluginRegistry);
     if (result.loaded.length > 0) {
@@ -10909,14 +11097,14 @@ async function ensurePluginsLoadedForServe(projectDir) {
   }
 }
 async function runCompileTest(opts) {
-  const { logOk: logOk2, logErr: logErr2, logInfo: logInfo2, S: S2 } = await import('../helpers-JNMK3FC2.js');
+  const { logOk: logOk2, logErr: logErr2, logInfo: logInfo2, S: S2 } = await import('../helpers-LUSV2ICC.js');
   const { tmpdir } = await import('os');
   const { dirname: dirname3, join: join6, resolve: resolve4 } = await import('path');
   const { fileURLToPath: fileURLToPath2 } = await import('url');
   const { unlinkSync, existsSync: existsSync22 } = await import('fs');
   const { spawn } = await import('child_process');
   const { portableSpawnSync: portableSpawnSync2 } = await import('../core/index.js');
-  const { MONOREPO_ROOT } = await import('../paths-UKWE35XS.js');
+  const { MONOREPO_ROOT } = await import('../paths-2AZXB3QL.js');
   if (MONOREPO_ROOT === null) {
     logErr2("--compile-test is only available inside the skaile-dev workspace.");
     logInfo2("Run it from a checkout of skaile-ai/skaile-dev (the monorepo shell).");
@@ -11874,8 +12062,8 @@ function makeStoreCommand() {
     "--all",
     `List every match (default: ${STORE_ROW_LIMIT} rows, only what \`skaile add\` can install)`
   ).option("-C, --project-dir <dir>", "Project directory (catalog config overlay)", process.cwd()).action(async (query, opts) => {
-    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-NKKUJLWA.js');
-    const { getKnownKinds: getKnownKinds2 } = await import('../open-registry-BYAXSHUI.js');
+    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-XBR46DJL.js');
+    const { getKnownKinds: getKnownKinds2 } = await import('../open-registry-W562DCDL.js');
     const projectDir = path19__default.resolve(opts.projectDir);
     if (opts.kind && !getKnownKinds2().has(opts.kind)) {
       logErr(
@@ -11933,8 +12121,8 @@ function makeStoreCommand() {
     }
   });
   store.command("show <ref>").description("Show a store asset's details + provenance (source, files, integrity)").option("-C, --project-dir <dir>", "Project directory (catalog config overlay)", process.cwd()).action(async (ref, opts) => {
-    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-NKKUJLWA.js');
-    const { supportsInstallManifest: supportsInstallManifest2 } = await import('../project-BIPK47JK.js');
+    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-XBR46DJL.js');
+    const { supportsInstallManifest: supportsInstallManifest2 } = await import('../project-D7GN7WLS.js');
     try {
       parseAssetRef(ref);
     } catch (e) {
@@ -12176,7 +12364,7 @@ function makeUpdateCommand() {
         }
       }
       if (target) {
-        await updateOne(am2, projectDir, target);
+        await updateOne(am2, projectDir, target, opts.force);
         return;
       }
       const spinner = createSpinner();
@@ -12270,7 +12458,8 @@ async function resolveUpdateTarget(am2, name) {
     );
     process.exit(1);
   }
-  logErr(`No declared asset matches "${name}".`);
+  const otherKind = await am2.otherKindHint(name);
+  logErr(`No declared asset matches "${name}".${otherKind ? ` ${otherKind}` : ""}`);
   if (declared.length > 0) logInfo(`Declared: ${declared.map((d) => d.ref).join(", ")}`);
   process.exit(1);
 }
@@ -12318,7 +12507,7 @@ function readText2(file) {
     return "";
   }
 }
-async function updateOne(am2, projectDir, target) {
+async function updateOne(am2, projectDir, target, force) {
   const lockPath = path19__default.join(projectDir, "skaile.lock.yaml");
   const before = readText2(lockPath);
   const spinner = createSpinner();
@@ -12327,6 +12516,7 @@ async function updateOne(am2, projectDir, target) {
   try {
     deployed = await am2.add(target.ref, {
       preferLockedLibrary: true,
+      force,
       onLibraryMoved: (m) => reportMoved([m])
     });
   } catch (err) {
@@ -12525,6 +12715,12 @@ function makeWhyCommand() {
         process.exitCode = 1;
         return;
       }
+      const otherKind = await am2.otherKindHint(ref);
+      if (otherKind) {
+        logErr(`${ref} is not a locked skill. ${otherKind}`);
+        process.exitCode = 1;
+        return;
+      }
       let declared;
       try {
         declared = await am2.listDeclared();
@@ -12727,7 +12923,7 @@ async function runInit(projectDir, opts) {
   const { HARNESS_TARGETS: HARNESS_TARGETS2, SUPPORTED_HARNESSES: SUPPORTED_HARNESSES2, resolveConfiguredHarnessName: resolveConfiguredHarnessName2 } = await import('../core/index.js');
   const harness = opts.harness ?? "claude-code";
   if (!SUPPORTED_HARNESSES2.includes(harness)) {
-    logErr(`Unknown harness "${opts.harness}". Supported: ${SUPPORTED_HARNESSES2.join(", ")}`);
+    logErr(unknownHarnessTargetMessage(opts.harness ?? ""));
     process.exitCode = 1;
     return;
   }
@@ -12871,7 +13067,7 @@ async function bootstrapUserConfig() {
 }
 async function hydrateInitSources(resolved, created) {
   try {
-    const { ensureSourcesCloned } = await import('../ensure-sources-IH7CHSJF.js');
+    const { ensureSourcesCloned } = await import('../ensure-sources-K5EFNC3L.js');
     const hydrate = ensureSourcesCloned(resolved, { quiet: true });
     for (const n of hydrate.cloned) created.push(`~/.skaile/cache/sources/${n}/`);
     if (hydrate.failed.length > 0) {
@@ -12911,7 +13107,7 @@ function printInitSummary(resolved, projectDir, created) {
   console.log();
 }
 program.command("setup").description("Interactive provider setup wizard").action(async () => {
-  const { cmdSetup } = await import('../setup-AG6NFHSN.js');
+  const { cmdSetup } = await import('../setup-IBDNJAOU.js');
   await cmdSetup([], { projectDir: process.cwd() });
 });
 program.addCommand(makeInstallCommand());
@@ -12992,7 +13188,7 @@ program.hook("postAction", async (_thisCommand, actionCommand) => {
   const opts = actionCommand.opts();
   if (opts.global || opts.dryRun) return;
   const projectDir = path19__default.resolve(opts.projectDir ?? process.cwd());
-  const { refreshPluginSkills } = await import('../claude-code-RE46FJXI.js');
+  const { refreshPluginSkills } = await import('../claude-code-BBMNVH2J.js');
   try {
     if (await refreshPluginSkills(projectDir)) {
       logInfo(`Updated ${S.cmd(".claude/plugins/skaile/skills")} (the --full plugin copy)`);
@@ -13013,6 +13209,17 @@ process.once("beforeExit", () => {
 setLibraryAssetCheck(
   (asset, libraryPath) => libraryAssetRefusals(asset, libraryPath, getKindRegistry())
 );
+setRenamedEntryLookup(manifestEntryRenames);
+setWalkTruncationSink((info, root) => {
+  const where = path19__default.basename(root);
+  if (info.reason === "cycle") {
+    logWarnErr(
+      `${where}: asset scan truncated (cycle) - the symlink ${info.path} points back into the tree, so the result is incomplete. Remove the symlink; \`skaile library index ${where}\` lists every one.`
+    );
+    return;
+  }
+  logWarnErr(`${where}: asset scan truncated (${info.reason}) - the result is incomplete.`);
+});
 try {
   await program.parseAsync();
   commandSettled = true;