@skaile/workspaces 6.0.0 → 6.2.0

package/dist/cli/index.js

@@ -1,101 +1,102 @@
 #!/usr/bin/env node
-import { makeValidateCommand, scanIdentities, isRecord } from '../chunk-NMI2TWMH.js';
-import { storeNotInstallableReason } from '../chunk-PUK7TQT4.js';
-import { makeProvidersCommand, loadRegistryView, addProviderEntry, ProviderRegistryWriteError, removeProviderEntry } from '../chunk-3IXIEHUB.js';
-import { makeInstallCommand, makeCheckCommand, makeCleanCommand, pinComposedAgents, reportRewritten, reportReplaced, reportRelocked, reportMoved, reportStoreNotChecked, globalProblems, editedConventionFiles, supportsInstallManifest, REF_HINT, reportInstalledSoftDeps } from '../chunk-WEH33JSG.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 { getStoreConfig, storeFetch, isStoreAuthenticated, getStoreToken } from '../chunk-VXEYX73S.js';
-import { makeSourceCommand, syncProjectSources, divergedSourceClones } from '../chunk-WYHQUCHR.js';
-import { deviceLogin, loadStoreAuthConfig, logout, hasStoredAuth, exitOnLibrarySymlinks, resolveLibraryPublisherDetailed, getStoreIdentity, warnLibraryNameFallback, indexLibrary, warnIgnoredDomainFiles, removedDomainOption, rejectRemovedDomainOption, requireValidPublisherOrExit, exitOnManifestPublisherProblems, findAssetManifestFile, checkAssetFile, registerLibraryAsset, DOMAIN_REMOVED_HINT, reportLibrarySymlinks, checkAsset, manifestPublisherProblems, exitOnManifestRootProblems, manifestRequiresProblems, composeRefContext, registeredAssetKeys, assetEntryRef, duplicateAssetMessage, unresolvedManifestDependencies, findEntryManifestFile, unheldRequiresOfFile, warnLegacyBundleFiles, checkComposeKinds } from '../chunk-TKHJXPSB.js';
-import { openCatalogSource, LocalCatalogDisabledError, openLibraryManager, openLibrary } from '../chunk-DHYSUJ3H.js';
-import { AI_RESOURCES } from '../chunk-2UUKCROR.js';
-import { loadDeclaredPlugins } from '../chunk-YGRZNFRO.js';
-import { status, enable, disable, install, uninstall } from '../chunk-Y2TO2U7W.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-KX2PT5Q4.js';
-import { getKindRegistry, getKnownKinds } from '../chunk-ARWKK325.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-VJRTDKXS.js';
-import '../chunk-VBI7HGHB.js';
-import '../chunk-OULSJRXV.js';
-import '../chunk-7TPYPVAH.js';
-import '../chunk-SRODW6M2.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-U56GGCC2.js';
-import '../chunk-6Z5KTFJT.js';
+import '../chunk-QK7AG5AV.js';
+import '../chunk-TSTRH4SM.js';
 import '../chunk-KW37WNXY.js';
 import '../chunk-3MWQKQUB.js';
-import '../chunk-E3GPGTW3.js';
+import '../chunk-3HACK2Z7.js';
 import '../chunk-O7SG5PC2.js';
 import '../chunk-7QBNJTTQ.js';
 import '../chunk-O2SYFJWP.js';
-import '../chunk-AF432MS3.js';
+import '../chunk-KXJMQTOU.js';
 import '../chunk-32NA4TVC.js';
 import '../chunk-W3UDISS2.js';
-import '../chunk-ZFUZ5AKM.js';
-import { runFlow, resumeFlow } from '../chunk-T2BDID2J.js';
+import '../chunk-I7LC5TDY.js';
+import { runFlow, resumeFlow } from '../chunk-5JPW27BI.js';
 import '../chunk-4R6DROGN.js';
-import { parseSkillRequirements, validateRequirements } from '../chunk-FKU57Q5Q.js';
-import '../chunk-H6UVIKQ2.js';
-import '../chunk-SNEE6UGY.js';
+import { parseSkillRequirements, validateRequirements } from '../chunk-URCJIV7T.js';
+import '../chunk-PNUM7GUY.js';
+import '../chunk-K3R2UKG7.js';
 import '../chunk-6GWSDPBP.js';
-import '../chunk-LN6QB7XI.js';
-import { checkModelProvider, checkHarnessModel } from '../chunk-4XWLB7JB.js';
-import '../chunk-WDAIWDLK.js';
-import '../chunk-4DWBSTYA.js';
-import '../chunk-JDR6ILCW.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-7CV3HFWJ.js';
-import '../chunk-GEQSUC6U.js';
-import '../chunk-XFIEVEU7.js';
+import '../chunk-TZERN27L.js';
+import '../chunk-BOT64P3U.js';
+import '../chunk-6OHZUUR7.js';
 import '../chunk-7DN6JKP2.js';
-import '../chunk-UVVVR4XO.js';
-import { listHarnesses, getProviderPreset, AI_PROVIDER_PRESETS } from '../chunk-F2GOZMRA.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-SZXGRHQQ.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 { LibraryEntryError, AssetManager, parseRefTolerant, MissingManifestError, parseCanonicalLockKey, normalizeRepoUrl, FACTORY_SOURCE_URL } from '../chunk-OAHVKSQJ.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-UL22SDGR.js';
-import { flowFileNameError, SEMVER_RE } from '../chunk-QOM5Z62G.js';
-import '../chunk-7XSAW5OC.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-X3RMRJNR.js';
+import '../chunk-JRN5QF4C.js';
 import '../chunk-NUELZWCF.js';
-import { installTargetOf, SCAFFOLD_KINDS } from '../chunk-3JKGY2YC.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-DUMTLYSO.js';
-import { effectiveComposes, validatePreset, validateAgent, composeSlotDiagnostics, agentDeprecationDiagnostics, SLOT_ID_PATTERN } from '../chunk-E572OHGY.js';
-import { loadSettings, globalSettingsPath, resolveSettings, projectSettingsPath, saveSettings, WorkspaceYamlEditor, resolveLibraryDir, checkAgentSkillConformance, resolveSettingsWithSources, readLock, globalInstallDir, GLOBAL_INSTALL_DIR_NAME, workspaceProviderRegistryPath, userProviderRegistryPath, loadProviderRegistryFile, aiResourceRoots } from '../chunk-L4YKW5AY.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-OTIB4D2K.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-OHNKYHRR.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-UQ33Y4DM.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-GOCWM7FN.js';
-import { parseAssetRef, isValidPublisher, PUBLISHER_HINT, isValidAssetName, ASSET_NAME_HINT, depToStr, assetRefToStr, slugifyAssetName, parseAssetRefLoose } from '../chunk-WDXZA7QW.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';
 import * as fs8 from 'fs';
 import fs8__default, { readFileSync, existsSync, mkdirSync, writeFileSync, lstatSync, rmSync, readdirSync, statSync } from 'fs';
-import * as path18 from 'path';
-import path18__default, { resolve, join } from 'path';
+import * as path19 from 'path';
+import path19__default, { resolve, join } from 'path';
 import { fileURLToPath } from 'url';
 import { Help, Command, Option } from 'commander';
 import { rcompare } from 'semver';
@@ -224,21 +225,29 @@ async function runSearch(kind, query, opts) {
   const showLocal = !opts.store;
   const showStore = !opts.local;
   const { resolveConfig } = await import('../library/index.js');
-  const airGapped = resolveConfig({ projectDir: path18__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 airGapped = resolveConfig({ projectDir: path19__default.resolve(opts.projectDir) }).catalog.cache_ttl === 0;
+  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) {
-  const { openLibrary: openLibrary2 } = await import('../open-library-RJGJIW5H.js');
+async function searchIndex(query, kind, projectDir) {
+  const { openLibrary: openLibrary2 } = await import('../open-library-XBR46DJL.js');
   const library = await openLibrary2();
   try {
     const { libraryDirMissing: libraryDirMissing2 } = await import('../library/index.js');
     const sources = await library.listSources();
     const gone = new Set(sources.filter(libraryDirMissing2).map((l) => l.id));
+    for (const id of new AssetManager({
+      registry: getKindRegistry(),
+      projectDir
+    }).undeclaredSourceClones(sources)) {
+      gone.add(id);
+    }
     const defs = (await library.listAssetDefs(kind ? { kind } : {})).filter((d) => !d.libraryId || !gone.has(d.libraryId));
     const libraryNames = new Map(sources.map((l) => [l.id, l.name]));
     let entries = defs.map(
@@ -270,7 +279,7 @@ async function searchIndex(query, kind) {
   }
 }
 async function searchFactory(projectDir, query, kind) {
-  const prefixes = factoryAssetRoots().map((r) => r.endsWith(path18__default.sep) ? r : r + path18__default.sep);
+  const prefixes = factoryAssetRoots().map((r) => r.endsWith(path19__default.sep) ? r : r + path19__default.sep);
   const isFactoryPath = (p6) => prefixes.some((fp) => p6 === fp.slice(0, -1) || p6.startsWith(fp));
   try {
     const entries = await new AssetManager({ registry: getKindRegistry(), projectDir }).search(
@@ -383,18 +392,35 @@ async function expandCompetingOrigins(entries, projectDir) {
   }
   return out;
 }
+async function withAddVersions(entries, projectDir) {
+  if (!entries.some((e) => e.library && e.publisher)) return entries;
+  let versions;
+  try {
+    versions = await new AssetManager({
+      registry: getKindRegistry(),
+      projectDir
+    }).sourceAssetVersions();
+  } catch {
+    return entries;
+  }
+  if (versions.size === 0) return entries;
+  return entries.map((e) => {
+    const v = e.library ? versions.get(`${e.library}\0${entryDedupKey(e)}`) : void 0;
+    return v && v !== e.version ? { ...e, version: v } : e;
+  });
+}
 async function searchLocal(query, kind, opts, showStore, airGapped) {
-  const projectDir = path18__default.resolve(opts.projectDir);
-  const { restoreSourceReaders } = await import('../source-GBMYD3RO.js');
+  const projectDir = path19__default.resolve(opts.projectDir);
+  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), factory);
+  let entries = unionEntries(await searchIndex(query, kind, projectDir), factory);
   if (entries.length === 0 && !query && !kind && !airGapped) {
-    const { autoSyncForSearch } = await import('../source-GBMYD3RO.js');
+    const { autoSyncForSearch } = await import('../source-2DJ5KNOI.js');
     if (await autoSyncForSearch(projectDir)) {
-      entries = unionEntries(await searchIndex(query, kind), factory);
+      entries = unionEntries(await searchIndex(query, kind, projectDir), factory);
     }
   }
   if (entries.length === 0) {
@@ -403,15 +429,19 @@ 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(`
   ${S.heading("Local:")}`);
   }
   printLocalEntries(
-    await expandCompetingOrigins(await expandLibraryCopies(entries, projectDir), projectDir)
+    await withAddVersions(
+      await expandCompetingOrigins(await expandLibraryCopies(entries, projectDir), projectDir),
+      projectDir
+    )
   );
+  return true;
 }
 var MIN_LOCAL_DESCRIPTION_WIDTH = 10;
 function layoutLocalTable(rows, width, style = {}) {
@@ -504,11 +534,11 @@ 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-RJGJIW5H.js');
+  const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-XBR46DJL.js');
   try {
-    const remote = await openCatalogSource2({ projectDir: path18__default.resolve(opts.projectDir) });
+    const remote = await openCatalogSource2({ projectDir: path19__default.resolve(opts.projectDir) });
     const assets = await remote.listAssets(kind ? { kind } : {});
     const sel = selectStoreRows(filterCatalogAssets(assets, query), query, Boolean(opts.all));
     if (sel.shown.length > 0) {
@@ -519,11 +549,12 @@ 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) {
       logErr(
-        local ? "remote catalog disabled (catalog.url: local) \u2014 set catalog.url: https://skaile.store to search the store" : `Store search failed: ${await describeStoreFailure(e, path18__default.resolve(opts.projectDir))}`
+        local ? "remote catalog disabled (catalog.url: local) \u2014 set catalog.url: https://skaile.store to search the store" : `Store search failed: ${await describeStoreFailure(e, path19__default.resolve(opts.projectDir))}`
       );
       process.exit(1);
     } else {
@@ -531,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) {
@@ -615,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)"
@@ -624,18 +659,25 @@ function makeAddCommand() {
   ).option("--no-soft-deps", "skip the soft-dep prompt entirely (don't add, don't report)").option(
     "--force",
     "overwrite a deployed folder that no lock entry owns (a hand-made skill of the same name)"
-  ).option("--verbose", "print the full `exists in N libraries` warning for every asset").action(async (ref, opts) => {
+  ).option("--verbose", "print the full `exists in N libraries` warning for every asset").option(
+    "--dry-run",
+    "show the library, version, dependencies and folders the add would use; change nothing"
+  ).action(async (ref, opts) => {
     if (opts.withSoftDeps && opts.softDeps === false) {
       logErr("--with-soft-deps and --no-soft-deps are mutually exclusive.");
       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 = [];
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir),
+      projectDir: path19__default.resolve(opts.projectDir),
       global: opts.global || harnesses !== void 0,
       harnesses,
       harness: opts.target,
@@ -653,9 +695,16 @@ function makeAddCommand() {
       const placeholderDescriptions = [];
       let presets = [];
       const skippedSecrets = /* @__PURE__ */ new Set();
+      let plan = [];
       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),
@@ -671,9 +720,18 @@ function makeAddCommand() {
           warnings.push(
             `${secretPath} looks like a secret: it is not deployed or hashed with the asset. Keep secrets out of an asset root`
           );
+        },
+        dryRun: opts.dryRun === true,
+        onPlan: (items) => {
+          plan = items;
         }
       });
-      spinner.stop("Done");
+      spinner.stop(opts.dryRun ? "Planned" : "Done");
+      if (opts.dryRun) {
+        warnings.flush();
+        printAddPlan(plan);
+        return;
+      }
       warnings.flush();
       if (!am2.global) await pinComposedAgents(am2.projectDir);
       await promptSoftDepAdds(am2, ref, {
@@ -708,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) {
@@ -754,6 +812,29 @@ 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");
+  for (const item of plan.filter((i) => !i.requested)) line(item, "Would also add");
+  logInfo("Dry run: nothing was changed.");
+}
 function readableError(err) {
   if (err instanceof Error && err.code === "unknown_asset_kind") {
     return `Error: ${err.message.replace(/^unknown_asset_kind: /, "")}`;
@@ -773,7 +854,7 @@ function makeRemoveCommand() {
       requireProjectConfig(opts.projectDir, { allowMissing: true });
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir),
+      projectDir: path19__default.resolve(opts.projectDir),
       global: opts.global || harnesses !== void 0,
       harnesses,
       harness: opts.target
@@ -801,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;
@@ -813,6 +895,9 @@ function makeRemoveCommand() {
     for (const dep of result.pruned) {
       logOk(`Removed ${dep} (no longer required by anything declared in skaile.yaml)`);
     }
+    for (const setting of result.droppedSettings ?? []) {
+      logOk(`Removed ${setting} from skaile.yaml (it only set values for ${ref})`);
+    }
     await promptSoftDepRemovals(am2, ref, {
       isTTY: !!process.stdin.isTTY,
       noSoftDeps: opts.softDeps === false,
@@ -843,9 +928,10 @@ 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: path18__default.resolve(opts.projectDir),
+      projectDir: path19__default.resolve(opts.projectDir),
       harness: opts.target
     });
     let declared;
@@ -862,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));
@@ -888,14 +974,14 @@ 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();
   });
 }
 function runGlobalList(kind, opts, harnesses) {
   const am2 = new AssetManager({
     registry: getKindRegistry(),
-    projectDir: path18__default.resolve(opts.projectDir),
+    projectDir: path19__default.resolve(opts.projectDir),
     global: true,
     harnesses
   });
@@ -974,7 +1060,7 @@ function infoVersionLine(locked, latest) {
 }
 function lockedVersionOf(projectDir, kind, name, publisher) {
   try {
-    const lock = readLock(path18__default.join(projectDir, "skaile.lock.yaml"));
+    const lock = readLock(path19__default.join(projectDir, "skaile.lock.yaml"));
     for (const key of Object.keys(lock?.assets ?? {})) {
       const id = parseCanonicalLockKey(key);
       if (id.kind !== kind || id.name !== name || !id.version) continue;
@@ -1014,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-RJGJIW5H.js');
+    const { resolveCatalogSource } = await import('../open-library-XBR46DJL.js');
     const { source, close } = await resolveCatalogSource({ projectDir: opts.projectDir });
     try {
       return await source.listAssets(filter);
@@ -1030,7 +1116,7 @@ async function resolveInfoEntry(am2, ref, opts) {
     );
     return { entry: hit ? catalogAssetToEntry(hit) : null };
   } catch (err) {
-    const { LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-RJGJIW5H.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 } : {} };
@@ -1046,7 +1132,7 @@ function infoNotFoundHint(ref, lookup) {
 }
 function makeInfoCommand() {
   return new Command("info").description("Show asset metadata, deps, deploy status").argument("<ref>", "Asset reference (kind:name)").option("--project-dir <path>", "Project directory", process.cwd()).action(async (ref, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     requireProjectConfig(projectDir, { allowMissing: true });
     const am2 = new AssetManager({ registry: getKindRegistry(), projectDir });
     let lookup;
@@ -1058,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]);
@@ -1079,6 +1166,12 @@ function makeInfoCommand() {
     if (entry.publisher) console.log(`  repository:  ${S.dim(entry.publisher)}`);
     const infoSource = showLocked && entry.source.endsWith(`#${entry.version}`) ? `${entry.source.slice(0, -`#${entry.version}`.length)}#${infoLocked}` : entry.source;
     console.log(`  source:      ${S.dim(infoSource)}`);
+    const infoLibrary = await am2.lockedLibraryOf(
+      entry.kind,
+      entry.name,
+      parseRefTolerant(ref)?.publisher ?? entry.publisher
+    );
+    if (infoLibrary) console.log(`  library:     ${S.dim(infoLibrary)}`);
     if (entry.kind === "mcp-server") {
       const skipped = (await am2.mcpNotices()).find(
         (n) => n.kind === "skipped" && (n.id === entry.name || n.id.endsWith(`/${entry.name}`))
@@ -1117,7 +1210,7 @@ function makeCreateCommand() {
     new Option("-k, --kind <kind>", "Asset kind").default("skill").choices([...SCAFFOLD_KINDS])
   ).option("-d, --dir <dir>", "Target directory (default: cwd)").action((name, opts) => {
     const am2 = new AssetManager({ registry: getKindRegistry(), projectDir: process.cwd() });
-    const destDir = opts.dir ? path18__default.resolve(opts.dir) : process.cwd();
+    const destDir = opts.dir ? path19__default.resolve(opts.dir) : process.cwd();
     const result = am2.create(name, opts.kind, destDir);
     if (result.ok) logOk(`Created ${kindColor(opts.kind)}: ${pc5.dim(result.path)}`);
     else {
@@ -1132,7 +1225,7 @@ function makeDoctorCommand() {
       const problems = globalProblems(
         new AssetManager({
           registry: getKindRegistry(),
-          projectDir: path18__default.resolve(opts.projectDir),
+          projectDir: path19__default.resolve(opts.projectDir),
           global: true,
           harnesses: parseHarnessFilter(opts.harness)
         })
@@ -1146,19 +1239,24 @@ function makeDoctorCommand() {
       return;
     }
     requireProjectConfig(opts.projectDir);
+    const configErrors = await reportProjectConfig(path19__default.resolve(opts.projectDir), {
+      harness: true,
+      instances: true
+    });
+    if (configErrors > 0) process.exitCode = 1;
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     const { gaps } = await am2.projectState();
-    const edited = await editedConventionFiles(path18__default.resolve(opts.projectDir));
+    const edited = await editedConventionFiles(path19__default.resolve(opts.projectDir));
     const notices = [
       ...(await am2.mcpNotices()).map((n) => n.text),
       // A library that went back past the lock is no drift either (p1257).
       ...await am2.libraryOlderNotices()
     ];
     if (gaps.length === 0 && edited.length === 0) {
-      logOk("No missing dependencies.");
+      if (configErrors === 0) logOk("No missing dependencies.");
       for (const n of notices) logWarn(n);
       return;
     }
@@ -1189,20 +1287,20 @@ function claudeSkillRoots() {
   const roots = [];
   const override = process.env.SKAILE_CLAUDE_SKILLS_DIR;
   if (override) roots.push(override);
-  roots.push(path18.join(os.homedir(), ".claude", "skills"));
+  roots.push(path19.join(os.homedir(), ".claude", "skills"));
   return roots;
 }
 function resolveImportSource(nameOrPath) {
-  const asPath = path18.resolve(nameOrPath);
+  const asPath = path19.resolve(nameOrPath);
   if (fs8.existsSync(asPath)) {
-    const dir = fs8.statSync(asPath).isDirectory() ? asPath : path18.dirname(asPath);
-    const skillFile = path18.join(dir, "SKILL.md");
+    const dir = fs8.statSync(asPath).isDirectory() ? asPath : path19.dirname(asPath);
+    const skillFile = path19.join(dir, "SKILL.md");
     if (fs8.existsSync(skillFile)) return { dir, skillFile, via: "path" };
   }
-  if (!nameOrPath.includes(path18.sep) && !nameOrPath.startsWith(".")) {
+  if (!nameOrPath.includes(path19.sep) && !nameOrPath.startsWith(".")) {
     for (const root of claudeSkillRoots()) {
-      const dir = path18.join(root, nameOrPath);
-      const skillFile = path18.join(dir, "SKILL.md");
+      const dir = path19.join(root, nameOrPath);
+      const skillFile = path19.join(dir, "SKILL.md");
       if (fs8.existsSync(skillFile)) return { dir, skillFile, via: "claude-skills" };
     }
   }
@@ -1260,8 +1358,8 @@ ${body}
 // cli/src/commands/asset-cmd.ts
 function copyFilter(root) {
   return (src) => {
-    const rel = path18.relative(root, src).split(path18.sep).join("/");
-    return rel === "" || !(isNonAssetPath(rel) || isNonAssetDir(path18.basename(src)));
+    const rel = path19.relative(root, src).split(path19.sep).join("/");
+    return rel === "" || !(isNonAssetPath(rel) || isNonAssetDir(path19.basename(src)));
   };
 }
 async function resolveDefByRef(library, ref, opts) {
@@ -1344,16 +1442,16 @@ function makeAssetCommand() {
         }
         const rawSkill = fs8.readFileSync(src.skillFile, "utf8");
         const norm = opts.normalize ? normalizeSkillContent(rawSkill, {
-          fallbackName: path18.basename(src.dir),
+          fallbackName: path19.basename(src.dir),
           version: opts.version,
           stage: opts.stage
-        }) : { content: rawSkill, name: path18.basename(src.dir), changed: false, notes: [] };
+        }) : { content: rawSkill, name: path19.basename(src.dir), changed: false, notes: [] };
         if (!opts.normalize && !isValidAssetName(norm.name)) {
           logWarn(
             `Name "${norm.name}" is not canonical (kebab-case); \`skaile validate\` will reject this manifest entry. Drop --no-normalize to slugify it.`
           );
         }
-        const destDir = path18.join(target.path, norm.name);
+        const destDir = path19.join(target.path, norm.name);
         if (fs8.existsSync(destDir)) {
           logErr(`Destination already exists: ${destDir}`);
           process.exit(1);
@@ -1374,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);
         }
@@ -1385,7 +1484,7 @@ function makeAssetCommand() {
           logWarn(`${norm.name}/SKILL.md [${f.tag}] \u2014 ${f.text}`);
         }
         fs8.cpSync(src.dir, destDir, { recursive: true, filter: copyFilter(src.dir) });
-        fs8.writeFileSync(path18.join(destDir, "SKILL.md"), norm.content, "utf8");
+        fs8.writeFileSync(path19.join(destDir, "SKILL.md"), norm.content, "utf8");
         for (const note of norm.notes) logInfo(`  \u2022 ${note}`);
         const fm = parseFrontmatter(norm.content).data;
         for (const f of checkAgentSkillConformance(fm, { dirName: norm.name })) {
@@ -1451,10 +1550,10 @@ function makeAssetCommand() {
           );
           process.exit(1);
         }
-        const basename3 = path18.basename(srcPath);
+        const basename3 = path19.basename(srcPath);
         const destDir = target.path;
         fs8.mkdirSync(destDir, { recursive: true });
-        const destPath = path18.join(destDir, basename3);
+        const destPath = path19.join(destDir, basename3);
         if (fs8.existsSync(destPath)) {
           logErr(`Destination already exists: ${destPath}`);
           process.exit(1);
@@ -1486,7 +1585,7 @@ function makeAssetCommand() {
         }
         logOk(`Migrated ${basename3} \u2192 ${target.name} (${opts.mode})`);
         const publisher = loadSkPublishManifest(target.path)?.publisher ?? "<publisher>";
-        const migratedKind = fs8.existsSync(path18.join(destPath, "SKILL.md")) ? "skill" : "<kind>";
+        const migratedKind = fs8.existsSync(path19.join(destPath, "SKILL.md")) ? "skill" : "<kind>";
         logInfo(
           `Not addable yet: run ${S.cmd(`skaile library index ${target.name}`)}, then ${S.cmd(`skaile add ${migratedKind}:@${publisher.replace(/^@/, "")}/${basename3}`)}`
         );
@@ -1612,14 +1711,14 @@ function makeAuthCommand() {
 }
 function collectCacheTargets(scope) {
   const out = [];
-  out.push(path18__default.join(scope.projectDir, ".skaile", "cache"));
-  out.push(path18__default.join(scope.projectDir, ".skaile", "store-cache"));
-  out.push(path18__default.join(scope.projectDir, ".skaile", "repos"));
+  out.push(path19__default.join(scope.projectDir, ".skaile", "cache"));
+  out.push(path19__default.join(scope.projectDir, ".skaile", "store-cache"));
+  out.push(path19__default.join(scope.projectDir, ".skaile", "repos"));
   if (scope.global) {
     out.push(globalCacheRoot());
     const home = globalSkaileDir();
-    out.push(path18__default.join(home, "repos"));
-    out.push(path18__default.join(home, "catalog-cache"));
+    out.push(path19__default.join(home, "repos"));
+    out.push(path19__default.join(home, "catalog-cache"));
   }
   return out;
 }
@@ -1633,7 +1732,7 @@ function dirSize(target) {
 function dirSizeOfDir(dir) {
   let total = 0;
   for (const ent of readdirSync(dir, { withFileTypes: true })) {
-    const child = path18__default.join(dir, ent.name);
+    const child = path19__default.join(dir, ent.name);
     if (ent.isSymbolicLink()) continue;
     if (ent.isDirectory()) total += dirSizeOfDir(child);
     else if (ent.isFile()) total += statSync(child).size;
@@ -1659,7 +1758,7 @@ function makeCacheCommand() {
   const cmd = new Command("cache").description("Inspect and reclaim the re-derivable cache");
   cmd.command("clean").description("Remove the project cache (.skaile/cache); --global also clears ~/.skaile/cache").option("--global", "Also clear the global cache (sources + catalog) and legacy dirs").option("--dry-run", "Show what would be removed without doing it").option("-y, --yes", "Skip confirmation prompt").option("--project-dir <path>", "Project directory", process.cwd()).action(async (opts) => {
     const targets = collectCacheTargets({
-      projectDir: path18__default.resolve(opts.projectDir),
+      projectDir: path19__default.resolve(opts.projectDir),
       global: opts.global
     }).filter((t) => existsSync(t));
     if (targets.length === 0) {
@@ -1689,12 +1788,12 @@ function makeCacheCommand() {
     for (const r of removed) logOk(`Removed ${r}`);
   });
   cmd.command("dir").description("Print the resolved cache roots").option("--global", "Include the global cache root").option("--project-dir <path>", "Project directory", process.cwd()).action((opts) => {
-    console.log(path18__default.join(path18__default.resolve(opts.projectDir), ".skaile", "cache"));
+    console.log(path19__default.join(path19__default.resolve(opts.projectDir), ".skaile", "cache"));
     if (opts.global) console.log(globalCacheRoot());
   });
   cmd.command("size").description("Show cache disk usage per directory").option("--global", "Include the global cache").option("--project-dir <path>", "Project directory", process.cwd()).action((opts) => {
     const targets = collectCacheTargets({
-      projectDir: path18__default.resolve(opts.projectDir),
+      projectDir: path19__default.resolve(opts.projectDir),
       global: opts.global
     });
     console.log();
@@ -1710,7 +1809,7 @@ function makeCatalogCommand() {
   const catalog = new Command("catalog").description("Catalog source health and configuration");
   catalog.command("test").description("Probe the configured catalog source and report status").option("--project-dir <path>", "Project directory (for project-level config overlay)").option("--url <url>", "Override the catalog URL for this probe").option("--force", "Probe the network even in air-gapped mode (cache_ttl: 0)").action(async (opts) => {
     const { resolveConfig, isLocalCatalogUrl, trpcGetUrl } = await import('../library/index.js');
-    const projectDir = opts.projectDir ? path18__default.resolve(opts.projectDir) : void 0;
+    const projectDir = opts.projectDir ? path19__default.resolve(opts.projectDir) : void 0;
     const cfg = resolveConfig({ projectDir });
     const baseUrl = opts.url ?? cfg.catalog.url;
     if (isLocalCatalogUrl(baseUrl)) {
@@ -1732,7 +1831,7 @@ function makeCatalogCommand() {
   });
   catalog.command("info").description("Print the resolved catalog configuration (url, framing, cacheTtlMs)").option("--project-dir <path>", "Project directory (for project-level config overlay)").action(async (opts) => {
     const { resolveConfig } = await import('../library/index.js');
-    const projectDir = opts.projectDir ? path18__default.resolve(opts.projectDir) : void 0;
+    const projectDir = opts.projectDir ? path19__default.resolve(opts.projectDir) : void 0;
     const cfg = resolveConfig({ projectDir });
     console.log(`url: ${cfg.catalog.url}`);
     console.log(`framing: ${cfg.catalog.framing}`);
@@ -1741,7 +1840,7 @@ function makeCatalogCommand() {
   return catalog;
 }
 async function runLocalCatalogTest(projectDir) {
-  const { resolveCatalogSource } = await import('../open-library-RJGJIW5H.js');
+  const { resolveCatalogSource } = await import('../open-library-XBR46DJL.js');
   let resolved;
   try {
     resolved = await resolveCatalogSource({ projectDir });
@@ -1917,13 +2016,13 @@ 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-3QS3J7KO.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())) {
         for (const asset of assets) {
           if (asset.kind !== "flow") continue;
-          if (flowFileNameError(asset.manifest, path18__default.basename(asset.manifestPath))) continue;
+          if (flowFileNameError(asset.manifest, path19__default.basename(asset.manifestPath))) continue;
           try {
             const flow = loadFlow(asset.manifestPath);
             if (flow.id) {
@@ -1991,9 +2090,9 @@ function findSkills() {
 }
 function walkSkills(dir, out) {
   for (const entry of fs8__default.readdirSync(dir, { withFileTypes: true })) {
-    const full = path18__default.join(dir, entry.name);
+    const full = path19__default.join(dir, entry.name);
     if (entry.isDirectory()) {
-      const skillMd = path18__default.join(full, "SKILL.md");
+      const skillMd = path19__default.join(full, "SKILL.md");
       if (fs8__default.existsSync(skillMd)) {
         out.push({ name: entry.name, path: full, skillPath: skillMd });
       } else {
@@ -2015,7 +2114,7 @@ function resolveFlowIds() {
   }
 }
 function resolveSessionIds(projectDir) {
-  const sessionsDir = path18__default.join(projectDir, ".skaile", "sessions");
+  const sessionsDir = path19__default.join(projectDir, ".skaile", "sessions");
   if (!fs8__default.existsSync(sessionsDir)) return [];
   try {
     return fs8__default.readdirSync(sessionsDir).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -".json".length));
@@ -2070,50 +2169,6 @@ function resolveDynamic(words, cword) {
   if (cmd === "config" && ["get", "set"].includes(sub) && isLast(3)) return CONFIG_KEYS;
   return null;
 }
-function unknownHarnessMessage(harness) {
-  const known = listHarnesses().map((d) => d.id);
-  if (known.includes(harness)) return void 0;
-  return `Unknown agent harness: "${harness}". Available: ${known.join(", ")}`;
-}
-var warnedDriverFlag = false;
-function warnDriverFlagDeprecated() {
-  if (warnedDriverFlag) return;
-  warnedDriverFlag = true;
-  console.error("--driver is deprecated; use --harness");
-}
-function driverAliasOption() {
-  return new Option("--driver <name>", "Deprecated alias of --harness").hideHelp();
-}
-function foldDriverFlag(opts, fallback) {
-  const { driver, ...rest } = opts;
-  if (driver !== void 0) warnDriverFlagDeprecated();
-  return { ...rest, harness: rest.harness ?? driver ?? fallback };
-}
-function friendlyHarnessError(err) {
-  const e = err;
-  if (!e) return null;
-  const isSpawnEnoent = e.code === "ENOENT" && (e.syscall?.startsWith("spawn") === true || /^spawn .*ENOENT/.test(e.message ?? ""));
-  const isConfig = e.category === "config" || e.detail?.category === "config";
-  if (!isSpawnEnoent && !isConfig) return null;
-  const hint = e.hint ?? e.detail?.hint;
-  const base = hint ?? "The configured agent binary is not installed or not on your PATH.";
-  return `${base}
-Try a different harness with \`--harness claude-sdk\`.`;
-}
-function harnessErrorNotes(err) {
-  const e = err;
-  const notes = [];
-  const category = e?.category ?? e?.detail?.category;
-  const hint = e?.hint ?? e?.detail?.hint;
-  if (hint && category !== "config") notes.push(hint);
-  else if (category === "auth") notes.push("Check your API key or login.");
-  if (e?.logSessionId) {
-    notes.push(`Full records: .skaile/logs.db (skaile session logs ${e.logSessionId}).`);
-  }
-  return notes;
-}
-
-// cli/src/commands/config.ts
 var PERSONAL_KEYS = /* @__PURE__ */ new Set(["harness", "model"]);
 function resolveDriverKeyAlias(key) {
   if (key !== "driver") return key;
@@ -2226,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}`);
@@ -2261,7 +2322,7 @@ function printResolvedPathsSection(config) {
   console.log(`  ${S.label("prompts:".padEnd(16))} ${config.promptsDir ?? paths.promptsDir}`);
 }
 async function showConfig(opts) {
-  const projectDir = opts.projectDir ? path18__default.resolve(opts.projectDir) : process.cwd();
+  const projectDir = opts.projectDir ? path19__default.resolve(opts.projectDir) : process.cwd();
   let config;
   let sources;
   let wsDefaults;
@@ -2272,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);
@@ -2328,7 +2390,7 @@ function makeConfigCommand() {
   cmd.command("show").description("Show effective config with sources").option("--project-dir <path>", "Project directory").action((opts) => showConfig(opts));
   cmd.command("get <key>").description("Get an effective config value").option("--project-dir <path>", "Project directory").option("--global", "Read ~/.skaile/settings.json only, not the project's value").action(async (rawKey, opts) => {
     const key = resolveDriverKeyAlias(rawKey);
-    const projectDir = opts.projectDir ? path18__default.resolve(opts.projectDir) : process.cwd();
+    const projectDir = opts.projectDir ? path19__default.resolve(opts.projectDir) : process.cwd();
     if (CATALOG_KEYS.has(key)) {
       const { resolveConfig } = await import('../library/index.js');
       const field = key.slice("catalog.".length);
@@ -2344,7 +2406,7 @@ function makeConfigCommand() {
   ).option("--project-dir <path>", "Project directory").option("--global", "Write to ~/.skaile/settings.json instead of project-local").action(
     async (rawKey, value, opts) => {
       const key = resolveDriverKeyAlias(rawKey);
-      const projectDir = opts.projectDir ? path18__default.resolve(opts.projectDir) : process.cwd();
+      const projectDir = opts.projectDir ? path19__default.resolve(opts.projectDir) : process.cwd();
       if (CATALOG_KEYS.has(key)) {
         await setCatalogKey(key, value);
         return;
@@ -2378,6 +2440,19 @@ function makeConfigCommand() {
           process.exit(1);
         }
       }
+      if (key === "model") {
+        await loadDeclaredPlugins(projectDir);
+        const harness = (await resolveSettings(projectDir)).harness ?? DEFAULT_HARNESS_ID;
+        const refusal = checkHarnessModel(harness, {
+          registry: loadRegistryView({ projectDir }).merged,
+          model: value,
+          roles: resolveSkWorkspaceConfig(projectDir).roles
+        });
+        if (refusal) {
+          logErr(`${refusal} (the project's harness is ${harness})`);
+          process.exit(1);
+        }
+      }
       const projectHarness = key === "harness" ? resolveSkWorkspaceConfig(projectDir).agent_config?.default?.harness : void 0;
       const filePath = opts.global ? globalSettingsPath() : projectSettingsPath(projectDir);
       const existing = await loadSettings(filePath);
@@ -2397,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(
@@ -2412,7 +2494,7 @@ function makeConfigCommand() {
     "Remove a value that `config set` wrote: harness, model, apiKey.<provider> (removes the provider entry) or catalog.url, catalog.cache_ttl, catalog.framing (the default applies again)"
   ).option("--project-dir <path>", "Project directory").option("--global", "Remove from ~/.skaile/settings.json instead of project-local").action(async (rawKey, opts) => {
     const key = resolveDriverKeyAlias(rawKey);
-    const projectDir = opts.projectDir ? path18__default.resolve(opts.projectDir) : process.cwd();
+    const projectDir = opts.projectDir ? path19__default.resolve(opts.projectDir) : process.cwd();
     if (CATALOG_KEYS.has(key)) {
       await unsetCatalogKey(key);
       return;
@@ -2735,8 +2817,8 @@ function makeConnectorCommand() {
     async (driver, opts) => {
       const { installNpmPackages } = await import('../connectors/index.js');
       const { scanDirectory: scanDirectory2, factoryAssetRoots: factoryAssetRoots2, WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-      const projectDir = path18__default.resolve(opts.projectDir);
-      const yamlPath = path18__default.join(projectDir, "skaile.yaml");
+      const projectDir = path19__default.resolve(opts.projectDir);
+      const yamlPath = path19__default.join(projectDir, "skaile.yaml");
       if (!existsSync(yamlPath)) {
         logErr("No skaile.yaml found in current directory. Run 'skaile init' first.");
         process.exit(1);
@@ -2796,8 +2878,8 @@ ${installResult.output}`);
   );
   cmd.command("remove <id>").option("--project-dir <path>", "Workspace directory", process.cwd()).description("Remove a connector from skaile.yaml by its instance ID").action(async (id, opts) => {
     const { WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-    const projectDir = path18__default.resolve(opts.projectDir);
-    const yamlPath = path18__default.join(projectDir, "skaile.yaml");
+    const projectDir = path19__default.resolve(opts.projectDir);
+    const yamlPath = path19__default.join(projectDir, "skaile.yaml");
     if (!existsSync(yamlPath)) {
       logErr("No skaile.yaml found in current directory.");
       process.exit(1);
@@ -2814,7 +2896,7 @@ ${installResult.output}`);
   cmd.command("status [id]").option("--project-dir <path>", "Workspace directory", process.cwd()).description("Connect and report health status for one or all connectors").action(async (id, opts) => {
     const res = await import('../connectors/index.js');
     res.registerBuiltinConnectors();
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const declarations = res.loadConnectorDeclarations(projectDir);
     if (declarations.length === 0) {
       console.log("No connectors configured in skaile.yaml.");
@@ -2838,7 +2920,7 @@ ${installResult.output}`);
     await manager.disconnectAll();
   });
   cmd.command("list").description("List all configured connectors").option("--project-dir <path>", "Workspace directory", process.cwd()).action(async (opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const manager = await connectConnectors(projectDir);
     try {
       console.log(JSON.stringify(manager.listConnectors(), null, 2));
@@ -2847,7 +2929,7 @@ ${installResult.output}`);
     }
   });
   cmd.command("sync [id]").description("Re-sync a filesystem-face connector or all of them (git pull, S3 refresh, etc.)").option("--all", "Sync all connectors").option("--project-dir <path>", "Workspace directory", process.cwd()).action(async (id, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const manager = await connectConnectors(projectDir);
     try {
       if (opts.all) {
@@ -2871,7 +2953,7 @@ ${installResult.output}`);
     }
   });
   cmd.command("ops <id>").description("List available operations for a connector").option("--project-dir <path>", "Workspace directory", process.cwd()).action(async (id, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const manager = await connectConnectors(projectDir);
     try {
       if (!manager.has(id)) {
@@ -2886,7 +2968,7 @@ ${installResult.output}`);
     }
   });
   cmd.command("read <id> <resource-path>").description("Read content from a connector").option("--project-dir <path>", "Workspace directory", process.cwd()).action(async (id, resourcePath, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const manager = await connectConnectors(projectDir);
     try {
       const content = await manager.read(id, resourcePath);
@@ -2896,7 +2978,7 @@ ${installResult.output}`);
     }
   });
   cmd.command("write <id> <resource-path> <content>").description("Write content to a connector at a path").option("--project-dir <path>", "Workspace directory", process.cwd()).action(async (id, resourcePath, content, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const manager = await connectConnectors(projectDir);
     try {
       await manager.write(id, resourcePath, { data: content });
@@ -2906,7 +2988,7 @@ ${installResult.output}`);
     }
   });
   cmd.command("entries <id> [resource-path]").description("List entries in a connector (files, keys, rows, etc)").option("--project-dir <path>", "Workspace directory", process.cwd()).option("--recursive", "Include nested entries").option("--limit <n>", "Maximum entries to return", parsePositiveIntOption).action(async (id, resourcePath, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const manager = await connectConnectors(projectDir);
     try {
       const entries = await manager.list(id, resourcePath, {
@@ -2919,7 +3001,7 @@ ${installResult.output}`);
     }
   });
   cmd.command("search <id> <query>").description("Search within a connector for matching content").option("--project-dir <path>", "Workspace directory", process.cwd()).action(async (id, query, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const manager = await connectConnectors(projectDir);
     try {
       const results = await manager.search(id, query);
@@ -2929,7 +3011,7 @@ ${installResult.output}`);
     }
   });
   cmd.command("delete <id> <resource-path>").description("Delete an entry from a connector").option("--project-dir <path>", "Workspace directory", process.cwd()).action(async (id, resourcePath, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const manager = await connectConnectors(projectDir);
     try {
       const ok = await manager.delete(id, resourcePath);
@@ -2939,7 +3021,7 @@ ${installResult.output}`);
     }
   });
   cmd.command("run <id> <op> [args...]").description("Run a custom adapter operation (e.g. git log, sqlite query)").option("--project-dir <path>", "Workspace directory", process.cwd()).allowUnknownOption().action(async (id, op, args, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const manager = await connectConnectors(projectDir);
     try {
       if (!manager.has(id)) {
@@ -3048,7 +3130,7 @@ function envRecord() {
 async function buildDeployContext(projectDir) {
   const { resolveSkWorkspaceConfig: resolveSkWorkspaceConfig2 } = await import('../core/index.js');
   const config = resolveSkWorkspaceConfig2(projectDir);
-  const workspaceId = config.name ?? path18__default.basename(projectDir);
+  const workspaceId = config.name ?? path19__default.basename(projectDir);
   let log;
   try {
     const { createLogger } = await import('../core/logging.js');
@@ -3080,13 +3162,13 @@ 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-MSH6GK6T.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);
   }
 }
 async function runUp(opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   await ensureTargetsRegistered(projectDir);
   const { resolveSkWorkspaceConfig: resolveSkWorkspaceConfig2 } = await import('../core/index.js');
   const { resolveDeployTarget, pluginRegistry } = await import('../plugin-registry/index.js');
@@ -3154,7 +3236,7 @@ async function restoreFromHandle(projectDir) {
   return { target, handle, ctx };
 }
 async function runDown(opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const restored = await restoreFromHandle(projectDir);
   if (!restored) return;
   await restored.handle.stop();
@@ -3163,7 +3245,7 @@ async function runDown(opts) {
   logOk(`Stopped ${S.cmd(restored.target.id)} and cleared the handle.`);
 }
 async function runStatus(opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const restored = await restoreFromHandle(projectDir);
   if (!restored) return;
   const health = await restored.handle.health();
@@ -3177,7 +3259,7 @@ async function runStatus(opts) {
   console.log();
 }
 async function runLogs(opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const restored = await restoreFromHandle(projectDir);
   if (!restored) return;
   if (!restored.handle.logs) {
@@ -3200,12 +3282,15 @@ function makeDeployCommand() {
   return cmd;
 }
 var DIFF_SHOWS = { content: true, modified: true, incomplete: true };
+function uniqueMessages(gaps) {
+  return [...new Set(gaps.map((g) => g.message))];
+}
 function makeDiffCommand() {
   return new Command("diff").description("Show changes between deployed and source versions").argument("<ref>", "Asset reference (kind:name)").option("--project-dir <path>", "Project directory", process.cwd()).action(async (ref, opts) => {
     requireProjectConfig(opts.projectDir);
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     try {
       parseAssetRef(ref);
@@ -3226,7 +3311,7 @@ function makeDiffCommand() {
     const requirementGaps = await am2.requirementGapsOf(ref);
     const blocking = gaps.filter((g) => !DIFF_SHOWS[g.type]);
     if (blocking.length > 0) {
-      for (const g of [...blocking, ...requirementGaps]) logErr(g.message);
+      for (const line of uniqueMessages([...blocking, ...requirementGaps])) logErr(line);
       process.exitCode = 1;
       return;
     }
@@ -3236,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) {
@@ -3257,7 +3345,7 @@ function makeDiffCommand() {
         console.log(result.diff);
         break;
     }
-    for (const g of [...problems, ...requirementGaps]) logErr(g.message);
+    for (const line of uniqueMessages([...problems, ...requirementGaps])) logErr(line);
     if (result.status === "not-found" || problems.length > 0 || requirementGaps.length > 0)
       process.exitCode = 1;
   });
@@ -3265,7 +3353,7 @@ function makeDiffCommand() {
 function makeFlowCommand() {
   const cmd = new Command("flow").description("Manage flows");
   cmd.command("list").description("List the flows of this project").option("--project-dir <path>", "Project directory", process.cwd()).option("--all", "Also list the flows of registered libraries and cached sources").action(async (opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const flows = discoverProjectFlows(projectDir);
     const others = opts.all ? await discoverOtherFlows(projectDir) : [];
     if (flows.length === 0 && others.length === 0) {
@@ -3301,7 +3389,7 @@ function makeFlowCommand() {
     }
   });
   cmd.command("show <id>").description("Show flow details and node graph").option("--project-dir <path>", "Project directory", process.cwd()).option("--all", "Also look in registered libraries and cached sources").action(async (id, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const flow = discoverProjectFlows(projectDir).find((f) => f.id === id) ?? (opts.all ? (await discoverOtherFlows(projectDir)).find((o) => o.flow.id === id)?.flow : void 0);
     if (!flow) {
       logErr(`Flow not found: ${id}`);
@@ -3335,12 +3423,68 @@ function makeFlowCommand() {
   cmd.action(() => cmd.help());
   return cmd;
 }
+var HARNESS_ID_OF_TARGET = {
+  "claude-code": "claude-sdk",
+  omp: "omp",
+  codex: "codex"
+};
+function parseHarnessTarget(name) {
+  if (name === "claude-sdk") return "claude-code";
+  return SUPPORTED_HARNESSES.includes(name) ? name : void 0;
+}
+function makeHarnessCommand() {
+  const cmd = new Command("harness").description("Choose the coding-agent harness of a project");
+  cmd.command("set <name>").description(
+    `Switch the project to a harness (${SUPPORTED_HARNESSES.join(" | ")}): rewrite skaile.yaml and install for it`
+  ).option("--project-dir <path>", "Project directory", process.cwd()).action(async (name, opts) => {
+    await runHarnessSet(name, path19__default.resolve(opts.projectDir));
+  });
+  cmd.action(() => cmd.help());
+  return cmd;
+}
+async function runHarnessSet(name, projectDir) {
+  const target = parseHarnessTarget(name);
+  if (!target) {
+    logErr(unknownHarnessTargetMessage(name));
+    process.exit(1);
+  }
+  requireProjectConfig(projectDir);
+  const file = path19__default.join(projectDir, "skaile.yaml");
+  const before = resolveConfiguredHarnessName(projectDir);
+  let editor;
+  try {
+    editor = WorkspaceYamlEditor.load(file);
+  } catch (err) {
+    logErr(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+  const profile = editor.getAgentConfig("default");
+  editor.setAgentConfig("default", {
+    agent: target,
+    harness: HARNESS_ID_OF_TARGET[target]
+  });
+  editor.save();
+  if (before === target) {
+    logInfo(`Project is already on ${S.cmd(target)}; installing for it.`);
+  } else {
+    logOk(
+      `Set ${S.cmd("agent-config.default")} to ${S.cmd(`agent: ${target}`)}, ${S.cmd(`harness: ${HARNESS_ID_OF_TARGET[target]}`)} in skaile.yaml`
+    );
+  }
+  if (profile?.model) {
+    logInfo(
+      `model ${profile.model} is kept. Check it fits ${target}: skaile run "hi there" --dry-run`
+    );
+  }
+  logInfo(`Installing for ${target} (${HARNESS_TARGETS[target].local.skill})`);
+  await runYamlInstall({ projectDir });
+}
 function makeHistoryCommand() {
   const cmd = new Command("history").description("Show recent add/remove/update actions");
   cmd.argument("[limit]", "Number of entries to show", "20").option("--project-dir <path>", "Project directory", process.cwd()).action((limitStr, opts) => {
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     const limit = parseInt(limitStr, 10) || 20;
     const entries = am2.history(limit);
@@ -3363,7 +3507,7 @@ function makeHistoryCommand() {
   cmd.command("clear").description("Clear action history").option("--project-dir <path>", "Project directory", process.cwd()).action((opts) => {
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     am2.clearHistory();
     logOk("History cleared.");
@@ -3394,7 +3538,7 @@ async function readConfig(p6) {
   }
 }
 async function writeConfig(p6, value) {
-  await fs5.mkdir(path18__default.dirname(p6), { recursive: true });
+  await fs5.mkdir(path19__default.dirname(p6), { recursive: true });
   const cleaned = {};
   for (const [k, v] of Object.entries(value)) {
     if (v === void 0) continue;
@@ -3403,7 +3547,7 @@ async function writeConfig(p6, value) {
   await fs5.writeFile(p6, stringify$1(cleaned));
 }
 function configPath(projectDir) {
-  return path18__default.join(projectDir, ".codex", "config.toml");
+  return path19__default.join(projectDir, ".codex", "config.toml");
 }
 async function install2(projectDir) {
   const p6 = configPath(projectDir);
@@ -3414,7 +3558,7 @@ async function install2(projectDir) {
   const matches = previous && JSON.stringify(previous) === JSON.stringify(next);
   let warning;
   if (previous && !matches) {
-    warning = `overwrote existing ${SKAILE_MCP_NAME} entry in ${path18__default.relative(projectDir, p6)}`;
+    warning = `overwrote existing ${SKAILE_MCP_NAME} entry in ${path19__default.relative(projectDir, p6)}`;
   }
   if (matches) return { changed: false, method: "toml" };
   servers[SKAILE_MCP_NAME] = next;
@@ -3422,7 +3566,7 @@ async function install2(projectDir) {
   return { changed: true, method: "toml", warning };
 }
 function userConfigPath2() {
-  return path18__default.join(process.env.CODEX_HOME || path18__default.join(homedir(), ".codex"), "config.toml");
+  return path19__default.join(process.env.CODEX_HOME || path19__default.join(homedir(), ".codex"), "config.toml");
 }
 async function readUserConfig() {
   const p6 = userConfigPath2();
@@ -3464,7 +3608,7 @@ async function trustProject(projectDir) {
   } catch {
     return "refused";
   }
-  await fs5.mkdir(path18__default.dirname(p6), { recursive: true });
+  await fs5.mkdir(path19__default.dirname(p6), { recursive: true });
   await fs5.writeFile(p6, next);
   await writeTrustMark(projectDir, [
     .../* @__PURE__ */ new Set([
@@ -3476,7 +3620,7 @@ async function trustProject(projectDir) {
 }
 var TRUST_MARK = "codexTrustAdded";
 function stateFilePath(projectDir) {
-  return path18__default.join(projectDir, ".skaile", "plugin-state.json");
+  return path19__default.join(projectDir, ".skaile", "plugin-state.json");
 }
 async function readState(projectDir) {
   try {
@@ -3500,7 +3644,7 @@ async function writeTrustMark(projectDir, roots) {
   const state2 = await readState(projectDir);
   if (roots.length > 0) state2[TRUST_MARK] = roots;
   else delete state2[TRUST_MARK];
-  await fs5.mkdir(path18__default.dirname(stateFilePath(projectDir)), { recursive: true });
+  await fs5.mkdir(path19__default.dirname(stateFilePath(projectDir)), { recursive: true });
   await fs5.writeFile(stateFilePath(projectDir), JSON.stringify(state2, null, 2));
 }
 async function untrustProject(projectDir) {
@@ -3598,12 +3742,12 @@ async function status2(projectDir) {
     installed: "yes",
     enabled: trusted ? "n/a" : "untrusted",
     method: "mcp",
-    location: path18__default.relative(projectDir, p6)
+    location: path19__default.relative(projectDir, p6)
   };
 }
 async function install3(projectDir) {
-  const extDir = path18__default.join(projectDir, ".omp", "extensions");
-  const extPath = path18__default.join(extDir, "skaile.ts");
+  const extDir = path19__default.join(projectDir, ".omp", "extensions");
+  const extPath = path19__default.join(extDir, "skaile.ts");
   await fs5.mkdir(extDir, { recursive: true });
   const { WorkspacePlugin } = await import('../workspace-plugin/index.js');
   const plugin = new WorkspacePlugin({ projectDir });
@@ -3618,7 +3762,7 @@ async function install3(projectDir) {
   return { changed: true, method: "generated" };
 }
 async function uninstall3(projectDir) {
-  const extPath = path18__default.join(projectDir, ".omp", "extensions", "skaile.ts");
+  const extPath = path19__default.join(projectDir, ".omp", "extensions", "skaile.ts");
   try {
     await fs5.unlink(extPath);
     return { changed: true };
@@ -3627,14 +3771,14 @@ async function uninstall3(projectDir) {
   }
 }
 async function status3(projectDir) {
-  const extPath = path18__default.join(projectDir, ".omp", "extensions", "skaile.ts");
+  const extPath = path19__default.join(projectDir, ".omp", "extensions", "skaile.ts");
   if (existsSync(extPath)) {
     return {
       harness: "omp",
       installed: "yes",
       enabled: "n/a",
       method: "extension",
-      location: path18__default.relative(projectDir, extPath)
+      location: path19__default.relative(projectDir, extPath)
     };
   }
   return {
@@ -3652,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) {
@@ -3689,15 +3833,27 @@ async function installOmp(projectDir) {
     logInfo(`omp: already installed (${r.method})`);
   }
   await unignoreOmpExtension(projectDir);
-  if (isGitIgnored(projectDir, OMP_EXTENSION)) {
+  const rule = ompExtensionIgnoreRule(projectDir, OMP_EXTENSION);
+  if (rule) {
     logWarn(
-      `git ignores ${OMP_EXTENSION} (a global ignore file or .git/info/exclude); omp does not load an ignored extension. Remove that rule.`
+      `git ignores ${OMP_EXTENSION} (${rule}); omp does not load an ignored extension. Remove that rule.`
     );
   }
   console.log(`  ${S.dim("\u2192")} OMP auto-discovers extensions on next startup.`);
 }
-function isGitIgnored(projectDir, file) {
-  return spawnSync("git", ["check-ignore", "-q", file], { cwd: projectDir, stdio: "ignore" }).status === 0;
+function ompExtensionIgnoreRule(projectDir, file) {
+  const verbose = (p6) => {
+    const r = spawnSync("git", ["check-ignore", "-v", p6], { cwd: projectDir, encoding: "utf-8" });
+    return r.status === 0 ? r.stdout.trim() || void 0 : void 0;
+  };
+  const hit = verbose(file);
+  if (!hit) return void 0;
+  const dirs = [];
+  for (let d = path19__default.posix.dirname(file); d !== "."; d = path19__default.posix.dirname(d)) dirs.push(d);
+  if (dirs.some((d) => verbose(d) !== void 0)) return void 0;
+  const [rule] = hit.split("	");
+  const m = /^(.*?):(\d+):(.*)$/.exec(rule ?? "");
+  return m ? `${m[1]}:${m[2]}: ${m[3]}` : rule;
 }
 async function installCodex(projectDir) {
   const r = await install2(projectDir);
@@ -3722,7 +3878,7 @@ ${await trustEntry(projectDir)}`
   console.log(`  ${S.dim("\u2192")} Restart Codex CLI to pick up the change.`);
 }
 async function runInstall(opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const targets = resolveHarness(opts.harness);
   if (!targets) return 1;
   let exitCode = 0;
@@ -3785,7 +3941,7 @@ async function uninstallCodex(projectDir) {
   }
 }
 async function runUninstall(opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const targets = resolveHarness(opts.harness);
   if (!targets) return 1;
   let exitCode = 0;
@@ -3808,12 +3964,12 @@ async function runUninstall(opts) {
   return exitCode;
 }
 async function removeEmptyPluginState(projectDir) {
-  const stateFile = path18__default.join(projectDir, ".skaile", "plugin-state.json");
+  const stateFile = path19__default.join(projectDir, ".skaile", "plugin-state.json");
   try {
     const parsed = JSON.parse(await fs5.readFile(stateFile, "utf-8"));
     if (typeof parsed !== "object" || parsed === null || Object.keys(parsed).length > 0) return;
     await fs5.unlink(stateFile);
-    await fs5.rmdir(path18__default.dirname(stateFile)).catch(() => void 0);
+    await fs5.rmdir(path19__default.dirname(stateFile)).catch(() => void 0);
   } catch {
   }
 }
@@ -3824,7 +3980,7 @@ var PER_MACHINE_FILES = {
 };
 var OMP_EXTENSION = ".omp/extensions/skaile.ts";
 async function unignoreOmpExtension(projectDir) {
-  const gitignore = path18__default.join(projectDir, ".gitignore");
+  const gitignore = path19__default.join(projectDir, ".gitignore");
   let text;
   try {
     text = await fs5.readFile(gitignore, "utf-8");
@@ -3841,12 +3997,12 @@ async function unignoreOmpExtension(projectDir) {
 }
 var CLAUDE_FULL_FILES = [".claude/settings.json", ".claude/plugins/skaile/"];
 async function ignorePerMachineFiles(projectDir, targets, full) {
-  const gitignore = path18__default.join(projectDir, ".gitignore");
+  const gitignore = path19__default.join(projectDir, ".gitignore");
   let existing = null;
   try {
     existing = await fs5.readFile(gitignore, "utf-8");
   } catch {
-    if (!existsSync(path18__default.join(projectDir, ".git"))) return;
+    if (!existsSync(path19__default.join(projectDir, ".git"))) return;
   }
   const have = new Set((existing ?? "").split("\n").map((l) => l.trim()));
   const wanted = [
@@ -3890,7 +4046,7 @@ async function toggleTarget(t, projectDir, action3) {
   });
 }
 async function runToggle(opts, action3) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const requestedAll = opts.harness === "all";
   const targets = resolveHarness(opts.harness);
   if (!targets) return 1;
@@ -3903,7 +4059,7 @@ async function runToggle(opts, action3) {
   return exitCode;
 }
 async function runStatus2(opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const targets = resolveHarness(opts.harness);
   if (!targets) return 1;
   const rows = [];
@@ -3975,7 +4131,7 @@ async function runHook(event) {
     await plugin.shutdown();
     return;
   }
-  const store = new PluginStore(path18__default.join(projectDir, ".skaile", "plugin-state.json"));
+  const store = new PluginStore(path19__default.join(projectDir, ".skaile", "plugin-state.json"));
   await store.load();
   const status4 = store.get("connector:status");
   if (status4 && typeof status4 === "object" && Object.keys(status4).length > 0) {
@@ -4054,7 +4210,7 @@ function makeIntegrationCommand() {
   cmd.command("omp-exec <kind> <name>").description(
     "Run one tool or slash command of the omp extension (used by .omp/extensions/skaile.ts)"
   ).option("--project-dir <path>", "Project directory", process.cwd()).action(async (kind, name, opts) => {
-    process.exitCode = await runOmpExec(kind, name, path18__default.resolve(opts.projectDir));
+    process.exitCode = await runOmpExec(kind, name, path19__default.resolve(opts.projectDir));
   });
   cmd.command("hook <event>").description(
     "Run a Claude Code lifecycle hook (session-start | session-end | user-prompt-submit)"
@@ -4097,7 +4253,7 @@ function unfinishedGitState(dir) {
   for (const [entry, state2] of Object.entries(UNFINISHED_GIT_ENTRIES)) {
     const p6 = spawnSync("git", ["rev-parse", "--git-path", entry], { cwd: dir, encoding: "utf-8" });
     if (p6.status !== 0) return "the git directory could not be read";
-    if (fs8.existsSync(path18.resolve(dir, p6.stdout.trim()))) return state2;
+    if (fs8.existsSync(path19.resolve(dir, p6.stdout.trim()))) return state2;
   }
   return null;
 }
@@ -4105,7 +4261,7 @@ async function reindexLibrary(lib, library, name) {
   assertManifestEditableOrExit(lib.path);
   exitOnManifestPublisherProblems(lib.path, name);
   exitOnLibrarySymlinks(lib.path, `skaile library index ${name}`);
-  exitOnManifestRootProblems(lib.path, `skaile library index ${name}`);
+  exitOnManifestPathProblems(lib.path, `skaile library index ${name}`);
   const badRequires = manifestRequiresProblems(lib.path);
   const resolved = resolveLibraryPublisherDetailed(lib, {}, getStoreIdentity());
   warnLibraryNameFallback(name, resolved);
@@ -4122,7 +4278,7 @@ async function reindexLibrary(lib, library, name) {
     {
       check: (e) => checkAssetFile(e.source, e.kind, registry, lib.path, composeRefs),
       // A flow the engine would never load under its id (p871): keep it out of the manifest and the index.
-      refuse: (e) => e.kind === "flow" && flowFileNameError({ id: e.name }, path18.basename(e.source)) !== void 0
+      refuse: (e) => e.kind === "flow" && flowFileNameError({ id: e.name }, path19.basename(e.source)) !== void 0
     }
   );
   const manifest = loadSkPublishManifest(lib.path);
@@ -4143,7 +4299,7 @@ async function reindexLibrary(lib, library, name) {
   }
   const invalidVersion = skipped.filter((x) => x.reason === "invalid-version");
   for (const s of invalidVersion) {
-    const found = checkAssetFile(path18.join(lib.path, s.file), s.kind, registry).find(
+    const found = checkAssetFile(path19.join(lib.path, s.file), s.kind, registry).find(
       (f) => f.text.startsWith("version ")
     );
     const detail = found?.text ?? s.detail;
@@ -4154,28 +4310,36 @@ async function reindexLibrary(lib, library, name) {
   }
   const duplicates = skipped.filter((x) => x.reason === "duplicate");
   for (const s of duplicates) {
-    logErr(duplicateAssetMessage(s.kind, s.name, path18.dirname(s.file), s.detail, name));
+    logErr(duplicateAssetMessage(s.kind, s.name, path19.dirname(s.file), s.detail, name));
   }
   for (const s of failed) {
     for (const f of s.findings) logErr(`${s.file} [${f.tag}] \u2014 ${f.text}`);
   }
-  const duplicateFiles = new Set(duplicates.map((s) => path18.resolve(lib.path, s.file)));
+  const duplicateFiles = new Set(duplicates.map((s) => path19.resolve(lib.path, s.file)));
   const skippedKeys = new Set(
     [
       ...skipped.filter((s) => s.reason !== "duplicate"),
       ...failed.filter((s) => !s.inManifest)
     ].map((s) => `${s.kind}:${s.name}`)
   );
+  const refusedFiles = new Set(
+    [
+      ...skipped.filter((s) => s.reason !== "duplicate"),
+      ...failed.filter((s) => !s.inManifest)
+    ].map((s) => path19.resolve(lib.path, s.file))
+  );
   const res = await indexLibrary(lib, library, {
-    exclude: (a) => skippedKeys.has(`${a.kind}:${a.name}`) || duplicateFiles.has(path18.resolve(a.manifestPath))
+    exclude: (a) => skippedKeys.has(`${a.kind}:${a.name}`) || duplicateFiles.has(path19.resolve(a.manifestPath)) || refusedFiles.has(path19.resolve(a.manifestPath))
   });
   const unparsable = res.unparsable;
   for (const e of res.errors) (unparsable.includes(e) ? logErr : logWarn)(e);
   const syncUnparsable = skipped.filter(
-    (s) => s.reason === "unparsable" && !unparsable.some((e) => e.includes(s.file))
+    (s) => s.reason === "unparsable" && !unparsable.some((e) => e.startsWith(`${s.file} `))
   );
   for (const s of syncUnparsable) {
-    logErr(`${s.kind}:${s.name} skipped: manifest file ${s.file} could not be parsed.`);
+    logErr(
+      manifestParseFailureLine(lib.path, s.file) ?? `${s.file} [${s.kind}] \u2014 ${manifestParseErrorText("the manifest file could not be read")}`
+    );
   }
   for (const p6 of badRequires) logErr(`${p6.asset}: ${p6.message}`);
   for (const w of await unresolvedManifestDependencies(lib.path)) logWarn(w);
@@ -4185,7 +4349,7 @@ async function reindexLibrary(lib, library, name) {
     const file = findEntryManifestFile(lib.path, a);
     if (!file) continue;
     for (const f of unheldRequiresOfFile(file, a.kind, composeRefs)) {
-      logWarn(`${path18.relative(lib.path, file)} [${f.tag}] \u2014 ${f.text}`);
+      logWarn(`${path19.relative(lib.path, file)} [${f.tag}] \u2014 ${f.text}`);
     }
   }
   const skippedUnparsable = unparsable.length + syncUnparsable.length;
@@ -4236,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);
@@ -4250,18 +4424,55 @@ var DEPLOYED_COPY_DIRS = [
     )
   )
 ];
+var DEPLOY_ROOT_FOLDERS = new Set(
+  DEPLOYED_COPY_DIRS.map((d) => d.split("/")[0])
+);
+function deployFolderBelowProject(dir) {
+  const real = canonicalDir(dir);
+  const home = (() => {
+    try {
+      return fs8.realpathSync(os.homedir());
+    } catch {
+      return void 0;
+    }
+  })();
+  for (let cur = real; path19.dirname(cur) !== cur; cur = path19.dirname(cur)) {
+    const project = path19.dirname(cur);
+    const folder = path19.basename(cur);
+    if (!DEPLOY_ROOT_FOLDERS.has(folder) || project === home) continue;
+    const isProject = fs8.existsSync(path19.join(project, "skaile.yaml")) || DEPLOYED_COPY_DIRS.some((d) => {
+      const full = path19.join(project, d);
+      try {
+        return fs8.statSync(full).isDirectory() && fs8.readdirSync(full).length > 0;
+      } catch {
+        return false;
+      }
+    });
+    if (isProject) return { folder, project };
+  }
+  return void 0;
+}
+function refuseDeployFolder(dir, force = false) {
+  const deployFolder = force ? void 0 : deployFolderBelowProject(dir);
+  if (!deployFolder) return;
+  logErr(
+    `${dir} is inside the deploy folder ${deployFolder.folder}/ of the project ${deployFolder.project}: a library holds asset sources, not the copies \`skaile add\` deployed. Pick another --path for the library, or pass --force when the sources live in that folder.`
+  );
+  process.exit(1);
+}
 async function refuseUnusableLibraryDir(dir, force = false) {
   const deployed = DEPLOYED_COPY_DIRS.filter((d) => {
-    const full = path18.join(dir, d);
+    const full = path19.join(dir, d);
     return fs8.existsSync(full) && fs8.statSync(full).isDirectory() && fs8.readdirSync(full).length > 0;
   });
   if (deployed.length > 0 && !force) {
-    const where = fs8.existsSync(path18.join(dir, "skaile.yaml")) ? "skaile.yaml with deployed copies" : "deployed copies";
+    const where = fs8.existsSync(path19.join(dir, "skaile.yaml")) ? "skaile.yaml with deployed copies" : "deployed copies";
     logErr(
       `${dir} is a project folder (${where} in ${deployed.map((d) => `${d}/`).join(", ")}): a library holds asset sources, not the copies \`skaile add\` deployed. Pick another --path for the library, or pass --force when the sources live in those folders.`
     );
     process.exit(1);
   }
+  refuseDeployFolder(dir, force);
   assertManifestEditableOrExit(dir);
   const unparsable = await unparsableAssetFiles(dir, getKindRegistry());
   if (unparsable.length > 0) {
@@ -4273,26 +4484,26 @@ async function refuseUnusableLibraryDir(dir, force = false) {
 }
 async function assertLibraryPathFree(manager, dir, exceptId) {
   const clash = (await manager.listLibraries()).find(
-    (l) => l.id !== exceptId && path18.resolve(l.path) === dir
+    (l) => l.id !== exceptId && path19.resolve(l.path) === dir
   );
   if (clash) throw new Error(`${dir} is already registered as library "${clash.name}".`);
 }
 function canonicalDir(dir) {
-  const abs = path18.resolve(dir);
+  const abs = path19.resolve(dir);
   const missing = [];
   let existing = abs;
   while (!fs8.existsSync(existing)) {
-    const parent = path18.dirname(existing);
+    const parent = path19.dirname(existing);
     if (parent === existing) return abs;
-    missing.unshift(path18.basename(existing));
+    missing.unshift(path19.basename(existing));
     existing = parent;
   }
-  return path18.join(fs8.realpathSync(existing), ...missing);
+  return path19.join(fs8.realpathSync(existing), ...missing);
 }
 function refuseGlobalInstallFolder(name, dir) {
   const reserved = globalInstallDir();
-  const rel = path18.relative(canonicalDir(reserved).toLowerCase(), canonicalDir(dir).toLowerCase());
-  const inside = rel === "" || !rel.startsWith("..") && !path18.isAbsolute(rel);
+  const rel = path19.relative(canonicalDir(reserved).toLowerCase(), canonicalDir(dir).toLowerCase());
+  const inside = rel === "" || !rel.startsWith("..") && !path19.isAbsolute(rel);
   if (name?.toLowerCase() === GLOBAL_INSTALL_DIR_NAME || inside) {
     logErr(
       `"${GLOBAL_INSTALL_DIR_NAME}" is reserved: ${reserved} holds assets from \`skaile install\`, not a library you author.`
@@ -4302,8 +4513,8 @@ function refuseGlobalInstallFolder(name, dir) {
 }
 async function refuseNestedLibraryPath(manager, dir, exceptId) {
   const within = (parent, child) => {
-    const rel = path18.relative(parent, child);
-    return rel === "" || !rel.startsWith("..") && !path18.isAbsolute(rel);
+    const rel = path19.relative(parent, child);
+    return rel === "" || !rel.startsWith("..") && !path19.isAbsolute(rel);
   };
   const target = canonicalDir(dir).toLowerCase();
   const librariesDir = resolveLibraryDir();
@@ -4340,7 +4551,7 @@ function assertCreateDirInsideLibrary(libRoot, destDir, given) {
     }
   };
   let probe = destDir;
-  while (!exists(probe)) probe = path18.dirname(probe);
+  while (!exists(probe)) probe = path19.dirname(probe);
   let realProbe;
   try {
     realProbe = fs8.realpathSync(probe);
@@ -4353,19 +4564,19 @@ function assertCreateDirInsideLibrary(libRoot, destDir, given) {
     process.exit(1);
   }
   const realRoot = canonicalDir(libRoot);
-  const realDest = path18.join(realProbe, path18.relative(probe, destDir));
-  const rel = path18.relative(realRoot, realDest);
-  if (rel === ".." || rel.startsWith(`..${path18.sep}`) || path18.isAbsolute(rel)) {
+  const realDest = path19.join(realProbe, path19.relative(probe, destDir));
+  const rel = path19.relative(realRoot, realDest);
+  if (rel === ".." || rel.startsWith(`..${path19.sep}`) || path19.isAbsolute(rel)) {
     logErr(
       `--dir "${given}" must stay inside the library (${realRoot}): it resolves to ${realDest}.`
     );
     process.exit(1);
   }
-  const relParts = path18.relative(path18.resolve(libRoot), path18.resolve(destDir)).split(path18.sep);
-  let walked = path18.resolve(libRoot);
+  const relParts = path19.relative(path19.resolve(libRoot), path19.resolve(destDir)).split(path19.sep);
+  let walked = path19.resolve(libRoot);
   for (const [i, part] of relParts.entries()) {
     if (part === "" || part === ".") continue;
-    walked = path18.join(walked, part);
+    walked = path19.join(walked, part);
     if (!exists(walked)) break;
     if (fs8.lstatSync(walked).isSymbolicLink()) {
       logErr(
@@ -4379,7 +4590,7 @@ function assertCreateDirInsideLibrary(libRoot, destDir, given) {
   }
 }
 function adoptWritesManifest(libPath) {
-  if (!fs8.existsSync(path18.join(libPath, SKAILE_MANIFEST_FILENAME))) return true;
+  if (!fs8.existsSync(path19.join(libPath, SKAILE_MANIFEST_FILENAME))) return true;
   const manifest = loadSkPublishManifest(libPath);
   if (!manifest || manifest.source || (manifest.assets ?? []).length > 0) return false;
   return manifestPublisherProblems(libPath).length === 0;
@@ -4433,13 +4644,13 @@ function requireValidLibraryName(name) {
 var LOCAL_OWNERSHIP_REASON = "ownership only governs sync with a git remote, and a local library is always owned by you.";
 function pruneEmptyLibraryParents(libPath) {
   const root = canonicalDir(resolveLibraryDir());
-  let dir = path18.dirname(path18.resolve(libPath));
+  let dir = path19.dirname(path19.resolve(libPath));
   for (; ; ) {
-    const rel = path18.relative(root, canonicalDir(dir));
-    if (rel === "" || rel.startsWith("..") || path18.isAbsolute(rel)) return;
+    const rel = path19.relative(root, canonicalDir(dir));
+    if (rel === "" || rel.startsWith("..") || path19.isAbsolute(rel)) return;
     if (!fs8.existsSync(dir) || fs8.readdirSync(dir).length > 0) return;
     fs8.rmdirSync(dir);
-    dir = path18.dirname(dir);
+    dir = path19.dirname(dir);
   }
 }
 function remoteBranches(url) {
@@ -4452,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-KKQ2ULLX.js');
+  const { isGithubRemote, notGithubRemoteMessage } = await import('../library-publish-XMRCKRNR.js');
   if (!isGithubRemote(url)) logWarn(notGithubRemoteMessage(name, url));
 }
 function scaffoldLibraryFiles(dir, name) {
@@ -4484,7 +4695,7 @@ by the same ref.
   ];
   const written = [];
   for (const [file, content] of files) {
-    const target = path18.join(dir, file);
+    const target = path19.join(dir, file);
     if (fs8.existsSync(target)) continue;
     fs8.writeFileSync(target, content, "utf8");
     written.push(file);
@@ -4519,7 +4730,7 @@ function makeLibraryCommand() {
       for (const l of ls) {
         const def = l.isDefault ? pc5.green("\u25B8 ") : "  ";
         console.log(
-          `${def}${S.cmd(l.name.padEnd(nameW))}  ${pc5.dim(l.backend.padEnd(backendW))}  ${pc5.dim(l.ownership.padEnd(ownerW))}  ${pc5.dim(l.path)}`
+          `${def}${S.cmd(l.name.padEnd(nameW))}  ${pc5.dim(l.backend.padEnd(backendW))}  ${pc5.dim(l.ownership.padEnd(ownerW))}  ${pc5.dim(l.path)}${libraryDirMissing(l) ? `  ${pc5.red("(directory missing)")}` : ""}`
         );
       }
       console.log(`
@@ -4541,6 +4752,11 @@ function makeLibraryCommand() {
     const { manager, close } = await openLibraryManager();
     try {
       const l = await manager.requireLibrary(name);
+      if (libraryDirMissing(l)) {
+        logErr(missingLibraryDirMessage(l));
+        process.exitCode = 1;
+        return;
+      }
       console.log();
       console.log(S.heading(`  ${l.name}`));
       console.log(`  ${S.rule(50)}`);
@@ -4552,10 +4768,6 @@ function makeLibraryCommand() {
       console.log(`  ${S.label("manifestGen")}   ${l.manifestGenerated}`);
       console.log(`  ${S.label("backendConfig")} ${JSON.stringify(l.backendConfig)}`);
       console.log();
-      if (libraryDirMissing(l)) {
-        logErr(missingLibraryDirMessage(l));
-        process.exitCode = 1;
-      }
     } finally {
       close();
     }
@@ -4577,7 +4789,7 @@ function makeLibraryCommand() {
         opts.path ??= gone.path;
       }
       const ownership = flagged[0] ?? gone?.ownership ?? "owner";
-      const libPath = opts.path ? path18.resolve(opts.path) : path18.join(resolveLibraryDir(), name);
+      const libPath = opts.path ? path19.resolve(opts.path) : path19.join(resolveLibraryDir(), name);
       refuseGlobalInstallFolder(name, libPath);
       if (fs8.existsSync(libPath) && !fs8.statSync(libPath).isDirectory()) {
         logErr(`${libPath} exists and is not a directory.`);
@@ -4603,6 +4815,8 @@ function makeLibraryCommand() {
         if (fs8.existsSync(libPath)) {
           exitOnLibrarySymlinks(libPath, `skaile library init ${name} --path ${libPath}`);
           await refuseUnusableLibraryDir(libPath, opts.force);
+        } else {
+          refuseDeployFolder(libPath, opts.force);
         }
         const hasDefault = (await manager.listLibraries()).some((l) => l.isDefault);
         let backend = "local";
@@ -4635,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)" : ""}`
         );
@@ -4652,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);
@@ -4664,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);
@@ -4769,10 +4985,10 @@ function makeLibraryCommand() {
         exitOnManifestPublisherProblems(target.path, target.name);
         const effectiveKind = opts.kind ?? kind;
         const am2 = new AssetManager({ registry: getKindRegistry(), projectDir: process.cwd() });
-        const libRoot = path18.resolve(target.path);
-        const destDir = opts.dir ? path18.resolve(libRoot, opts.dir) : libRoot;
-        const relDest = path18.relative(libRoot, destDir);
-        if (relDest === ".." || relDest.startsWith(`..${path18.sep}`) || path18.isAbsolute(relDest)) {
+        const libRoot = path19.resolve(target.path);
+        const destDir = opts.dir ? path19.resolve(libRoot, opts.dir) : libRoot;
+        const relDest = path19.relative(libRoot, destDir);
+        if (relDest === ".." || relDest.startsWith(`..${path19.sep}`) || path19.isAbsolute(relDest)) {
           logErr(`--dir "${opts.dir}" must stay inside the library (${libRoot}).`);
           process.exit(1);
         }
@@ -4781,21 +4997,21 @@ function makeLibraryCommand() {
           libRoot,
           effectiveKind,
           name,
-          path18.relative(libRoot, path18.join(destDir, name))
+          path19.relative(libRoot, path19.join(destDir, name))
         );
         if (taken) {
           logErr(
-            `${effectiveKind}:${name} already exists at "${taken}" \u2014 creating it again under "${path18.relative(libRoot, destDir) || "."}" would re-point the manifest entry. Pick another name.`
+            `${effectiveKind}:${name} already exists at "${taken}" \u2014 creating it again under "${path19.relative(libRoot, destDir) || "."}" would re-point the manifest entry. Pick another name.`
           );
           process.exit(1);
         }
-        const wanted = path18.relative(libRoot, path18.join(destDir, name));
+        const wanted = path19.relative(libRoot, path19.join(destDir, name));
         const onDisk = (await scanUnlistedAssets(libRoot, target.name, getKindRegistry())).find(
           (u) => u.entry.kind === effectiveKind && u.entry.name === name && u.root !== wanted
         );
         if (onDisk) {
           logErr(
-            `${effectiveKind}:${name} already exists at "${onDisk.root}" (not in the manifest yet) \u2014 creating it again under "${path18.relative(libRoot, destDir) || "."}" would be a duplicate. Run \`skaile library index ${target.name}\` first or pick another name.`
+            `${effectiveKind}:${name} already exists at "${onDisk.root}" (not in the manifest yet) \u2014 creating it again under "${path19.relative(libRoot, destDir) || "."}" would be a duplicate. Run \`skaile library index ${target.name}\` first or pick another name.`
           );
           process.exit(1);
         }
@@ -4845,6 +5061,12 @@ function makeLibraryCommand() {
   cmd.command("default <name>").description("Set <name> as the default library").action(async (name) => {
     const { manager, close } = await openLibraryManager();
     try {
+      const lib = await manager.requireLibrary(name);
+      if (libraryDirMissing(lib)) {
+        logErr(missingLibraryDirMessage(lib));
+        process.exitCode = 1;
+        return;
+      }
       const updated = await manager.setDefault(name);
       logOk(`Default \u2192 ${updated.name}`);
     } finally {
@@ -4861,7 +5083,7 @@ function makeLibraryCommand() {
       logErr(`A library named "${newName}" is already registered.`);
       process.exit(1);
     }
-    const newPath = path18.join(path18.dirname(lib.path), newName);
+    const newPath = path19.join(path19.dirname(lib.path), newName);
     refuseGlobalInstallFolder(newName, newPath);
     if (fs8.existsSync(newPath)) {
       logErr(`Target directory already exists: ${newPath}`);
@@ -4954,7 +5176,7 @@ function makeLibraryCommand() {
         }
         patch.isDefault = false;
       } else if (field === "path") {
-        const dir = path18.resolve(value);
+        const dir = path19.resolve(value);
         if (!fs8.existsSync(dir) || !fs8.statSync(dir).isDirectory()) {
           logErr(`Directory does not exist: ${dir}. \`library set path=\` does not move files.`);
           process.exit(1);
@@ -5174,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-KKQ2ULLX.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-KKQ2ULLX.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-KKQ2ULLX.js');
+    const { runLibraryYank } = await import('../library-publish-XMRCKRNR.js');
     await withStoreErrorHandling(() => runLibraryYank(lib, opts));
   });
   return cmd;
@@ -5234,9 +5456,9 @@ async function printOverallStatus(projectDir, asJson) {
     } catch {
       secretsStrategy = "unavailable";
     }
-    const resolvedProjectDir = path18.resolve(projectDir);
-    const hasWorkspaceConfig = existsSync(path18.join(resolvedProjectDir, "skaile.yaml"));
-    const hasLockFile = existsSync(path18.join(resolvedProjectDir, "skaile.lock.yaml"));
+    const resolvedProjectDir = path19.resolve(projectDir);
+    const hasWorkspaceConfig = existsSync(path19.join(resolvedProjectDir, "skaile.yaml"));
+    const hasLockFile = existsSync(path19.join(resolvedProjectDir, "skaile.lock.yaml"));
     let assignments = [];
     if (hasWorkspaceConfig) {
       try {
@@ -5843,7 +6065,7 @@ function scheduleSoftDepPreview() {
 }
 async function loadAssets() {
   softDepPreviewCache.clear();
-  const { gatherAssetFeeds } = await import('../asset-feeds-PXUWCXVI.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 ");
@@ -5851,7 +6073,7 @@ async function loadAssets() {
   const installed = new Set(am.listDeployed().map((e) => `${e.kind}:${e.name}`));
   let lock = null;
   try {
-    lock = readLock(path18__default.join(am.projectDir, "skaile.lock.yaml"));
+    lock = readLock(path19__default.join(am.projectDir, "skaile.lock.yaml"));
   } catch {
   }
   const rows = buildAssetRows(
@@ -5873,7 +6095,7 @@ function rebuildSourceTree() {
   rebuildVisibleSources();
 }
 function sourceOrgRepo(s) {
-  const parts = s.path.split(path18__default.sep).filter(Boolean);
+  const parts = s.path.split(path19__default.sep).filter(Boolean);
   if (parts.length < 2) return null;
   return { org: parts[parts.length - 2], repo: parts[parts.length - 1] };
 }
@@ -6047,13 +6269,13 @@ function reconcileCollapsedSets(rows) {
 async function loadSourcesAndLibraries() {
   try {
     const [{ openLibraryManager: openLibraryManager2 }, { getGlobalCacheDir: getGlobalCacheDir2, globalSkaileDir: globalSkaileDir2 }] = await Promise.all([
-      import('../open-library-RJGJIW5H.js'),
+      import('../open-library-XBR46DJL.js'),
       import('../core/index.js')
     ]);
     const { manager, library, close } = await openLibraryManager2();
     try {
       const newRoot = getGlobalCacheDir2();
-      const legacyRoot = path18__default.join(globalSkaileDir2(), "sources");
+      const legacyRoot = path19__default.join(globalSkaileDir2(), "sources");
       const isSourceRow = (l) => l.path.startsWith(newRoot) || l.path.startsWith(legacyRoot);
       const libs = await manager.listLibraries();
       const defs = await library.listAssetDefs();
@@ -7013,13 +7235,13 @@ async function run(projectDir) {
 }
 function makeManageCommand() {
   return new Command("manage").description("Interactive TUI for managing assets, sources, and libraries").option("--project-dir <path>", "Project directory", process.cwd()).action(async (opts) => {
-    await run(path18__default.resolve(opts.projectDir));
+    await run(path19__default.resolve(opts.projectDir));
   });
 }
 function makeMcpServerCommand() {
   return new Command("mcp-server").description("Start skaile workspace MCP server (stdio transport)").option("--project-dir <path>", "Project directory (default: cwd)", process.cwd()).action(async (opts) => {
-    const path42 = await import('path');
-    const projectDir = path42.default.resolve(opts.projectDir);
+    const path43 = await import('path');
+    const projectDir = path43.default.resolve(opts.projectDir);
     const { LogStore: LogStore2, StdoutSink: StdoutSink2, registerLogStore: registerLogStore2 } = await import('../core/logging.js');
     registerLogStore2(
       new LogStore2({
@@ -7061,10 +7283,10 @@ function walkFiles(root, match) {
       return;
     }
     for (const entry of entries) {
-      const full = path18__default.join(dir, entry.name);
+      const full = path19__default.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (SKIPPED_DIRS.has(entry.name)) continue;
-        if (entry.name === "cache" && path18__default.basename(dir) === ".skaile") continue;
+        if (entry.name === "cache" && path19__default.basename(dir) === ".skaile") continue;
         visit(full);
       } else if (entry.isFile() && match(entry.name)) {
         out.push(full);
@@ -7082,14 +7304,14 @@ function applyChanges2(changes) {
     switch (change.type) {
       case "write":
       case "create":
-        mkdirSync(path18__default.dirname(change.path), { recursive: true });
+        mkdirSync(path19__default.dirname(change.path), { recursive: true });
         writeFileSync(change.path, change.after, "utf-8");
         break;
       case "delete":
         rmSync(change.path, { force: true });
         break;
       case "move":
-        mkdirSync(path18__default.dirname(change.to), { recursive: true });
+        mkdirSync(path19__default.dirname(change.to), { recursive: true });
         writeFileSync(change.to, change.after, "utf-8");
         rmSync(change.from, { force: true });
         break;
@@ -7182,7 +7404,7 @@ function unifiedDiff(before, after, oldLabel, newLabel, context = 3) {
   return `${out.join("\n")}
 `;
 }
-var posix = (p6) => p6.split(path18__default.sep).join("/");
+var posix = (p6) => p6.split(path19__default.sep).join("/");
 function colorizeDiff(diff) {
   return diff.split("\n").map((line) => {
     if (line.startsWith("+++") || line.startsWith("---")) return S.bold(line);
@@ -7193,7 +7415,7 @@ function colorizeDiff(diff) {
   }).join("\n");
 }
 function renderChange(change, base) {
-  const rel = (p6) => posix(path18__default.relative(base, p6) || path18__default.basename(p6));
+  const rel = (p6) => posix(path19__default.relative(base, p6) || path19__default.basename(p6));
   switch (change.type) {
     case "write":
       return unifiedDiff(
@@ -7220,7 +7442,7 @@ ${diff}`;
   }
 }
 function changeLabel(change, base) {
-  const rel = (p6) => posix(path18__default.relative(base, p6) || path18__default.basename(p6));
+  const rel = (p6) => posix(path19__default.relative(base, p6) || path19__default.basename(p6));
   switch (change.type) {
     case "write":
       return `modify ${rel(change.path)}`;
@@ -7291,7 +7513,7 @@ function itemFromRef(raw, defaultKind, ctx) {
     return { kind: prefixed[1], ref: value };
   }
   if (PATH_LIKE.test(value)) return { kind: defaultKind, ref: value };
-  if (defaultKind === "skill" && !value.includes("/") && existsSync(path18__default.join(ctx.agentDir, "skills", value, "SKILL.md"))) {
+  if (defaultKind === "skill" && !value.includes("/") && existsSync(path19__default.join(ctx.agentDir, "skills", value, "SKILL.md"))) {
     return { kind: "skill", ref: `./skills/${value}` };
   }
   return { kind: defaultKind, ref: `${defaultKind}:${value}` };
@@ -7427,7 +7649,7 @@ function migrateAgentYaml(source, options) {
         manual.push("metadata.soul: not a string; left unchanged");
         continue;
       }
-      if (path18__default.posix.basename(soul.replace(/\\/g, "/")).toLowerCase() === "soul.md") {
+      if (path19__default.posix.basename(soul.replace(/\\/g, "/")).toLowerCase() === "soul.md") {
         notes.push("metadata.soul \u2192 dropped (SOUL.md is a convention file)");
       } else {
         derived.push({ kind: "persona", ref: soul });
@@ -7661,7 +7883,7 @@ function migrateSubagents(skaileYamlPath, source) {
   if (!isMap(agentNode)) return void 0;
   const subNode = agentNode.get("subagents", true);
   if (!isMap(subNode)) return void 0;
-  const dir = path18__default.dirname(skaileYamlPath);
+  const dir = path19__default.dirname(skaileYamlPath);
   const notes = [];
   const manual = [];
   const changes = [];
@@ -7679,10 +7901,10 @@ function migrateSubagents(skaileYamlPath, source) {
       continue;
     }
     const id = instanceId(name);
-    const assetDir = path18__default.join(dir, ".skaile", "agents", id);
+    const assetDir = path19__default.join(dir, ".skaile", "agents", id);
     if (takenIds.has(id) || existsSync(assetDir)) {
       manual.push(
-        `agent.subagents.${name}: ${takenIds.has(id) ? `agents.${id} already exists` : `${path18__default.relative(dir, assetDir)} already exists`}; left in place`
+        `agent.subagents.${name}: ${takenIds.has(id) ? `agents.${id} already exists` : `${path19__default.relative(dir, assetDir)} already exists`}; left in place`
       );
       continue;
     }
@@ -7706,13 +7928,13 @@ function migrateSubagents(skaileYamlPath, source) {
       manifest.tools = { ...allowed ? { allowed } : {}, ...denied ? { denied } : {} };
     }
     const text = stringify(manifest, { lineWidth: 0 });
-    const manifestPath = path18__default.join(assetDir, "agent.yaml");
+    const manifestPath = path19__default.join(assetDir, "agent.yaml");
     changes.push({ type: "create", path: manifestPath, after: text });
     assetManifests.push({ file: manifestPath, text });
     if (typeof spec.prompt === "string" && spec.prompt.trim() !== "") {
       changes.push({
         type: "create",
-        path: path18__default.join(assetDir, "SOUL.md"),
+        path: path19__default.join(assetDir, "SOUL.md"),
         after: `${spec.prompt.replace(/\s+$/, "")}
 `
       });
@@ -7771,7 +7993,7 @@ function validateMigratedAgent(text, registry) {
 function collectAgentFiles(paths) {
   const files = /* @__PURE__ */ new Set();
   for (const input of paths) {
-    const abs = path18__default.resolve(input);
+    const abs = path19__default.resolve(input);
     if (!existsSync(abs)) continue;
     if (statSync(abs).isDirectory()) {
       for (const f of walkFiles(abs, (b) => b === "agent.yaml" || b === "skaile.yaml"))
@@ -7788,7 +8010,7 @@ function planAgentMigration(options) {
   const reports = [];
   for (const file of collectAgentFiles(options.paths)) {
     const source = readText(file);
-    const base = path18__default.basename(file);
+    const base = path19__default.basename(file);
     if (base === "skaile.yaml") {
       const result = migrateSubagents(file, source);
       if (!result) continue;
@@ -7796,7 +8018,7 @@ function planAgentMigration(options) {
       for (const asset of result.assetManifests) {
         const v = validateMigratedAgent(asset.text, options.registry);
         validation2.errors.push(
-          ...v.errors.map((e) => `${path18__default.basename(path18__default.dirname(asset.file))}: ${e}`)
+          ...v.errors.map((e) => `${path19__default.basename(path19__default.dirname(asset.file))}: ${e}`)
         );
         validation2.warnings.push(...v.warnings);
       }
@@ -7824,7 +8046,7 @@ function planAgentMigration(options) {
         });
         continue;
       }
-      migration = migrateAgentYaml(source, { agentDir: path18__default.dirname(file), knownKinds });
+      migration = migrateAgentYaml(source, { agentDir: path19__default.dirname(file), knownKinds });
     } catch (error) {
       reports.push({
         file,
@@ -7854,7 +8076,7 @@ function planAgentMigration(options) {
 var DEFAULT_PUBLISHER = "skaile-ai";
 var PRESET_DEFAULT_VERSION = "1.0.0";
 var FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
-var posix2 = (p6) => p6.split(path18__default.sep).join("/");
+var posix2 = (p6) => p6.split(path19__default.sep).join("/");
 var MOVED_KINDS = { persona: "PERSONA.md", ruleset: "RULESET.md" };
 var KIND_MANIFEST_FILES = /* @__PURE__ */ new Set(["PERSONA.md", "RULESET.md", "SKILL.md"]);
 function readFrontmatterType(text) {
@@ -7876,7 +8098,42 @@ ${kept.join("\n")}
 ${rest}`;
   return { type: parsed.type, withoutType };
 }
-function planMarkdownMoves(root, knownKinds, manual, unknownTypes) {
+function finalIdentity(kind, name) {
+  try {
+    return `${kind}:${slugifyAssetName(name)}`;
+  } catch {
+    return `${kind}:${name}`;
+  }
+}
+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();
@@ -7885,17 +8142,33 @@ function planMarkdownMoves(root, knownKinds, manual, unknownTypes) {
     if (!text.startsWith("---")) continue;
     const found = readFrontmatterType(text);
     if (!found) continue;
-    const base = path18__default.basename(file);
-    const inAgentParts = file.split(path18__default.sep).includes("_agent-parts");
+    const base = path19__default.basename(file);
+    const inAgentParts = file.split(path19__default.sep).includes("_agent-parts");
     const targetName = MOVED_KINDS[found.type];
     if (targetName !== void 0 && !KIND_MANIFEST_FILES.has(base)) {
-      const to = path18__default.join(path18__default.dirname(file), base.replace(/\.md$/i, ""), targetName);
+      const to = path19__default.join(path19__default.dirname(file), base.replace(/\.md$/i, ""), targetName);
       if (existsSync(to) || targets.has(to)) {
         manual.push(
-          `${posix2(path18__default.relative(root, file))}: ${posix2(path18__default.relative(root, to))} already exists; not moved`
+          `${posix2(path19__default.relative(root, file))}: ${posix2(path19__default.relative(root, to))} already exists; not moved`
+        );
+        continue;
+      }
+      const identity = finalIdentity(found.type, base.replace(/\.md$/i, ""));
+      const earlier = identities.get(identity);
+      if (earlier !== void 0) {
+        conflicts.push(
+          `${earlier} and ${posix2(path19__default.relative(root, file))} both become ${identity}: rename one bundle first. Nothing was changed.`
+        );
+        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 });
       changes.push({ type: "move", from: file, to, before: text, after: found.withoutType });
@@ -7913,13 +8186,13 @@ function planAgentRefRewrites(root, moves, knownKinds, notes) {
   const changes = [];
   for (const file of walkFiles(root, (b) => b === "agent.yaml")) {
     const source = readText(file);
-    const agentDir = path18__default.dirname(file);
+    const agentDir = path19__default.dirname(file);
     let hits = 0;
     const refRewrite = (_kind, ref) => {
-      const moved = byOldPath.get(path18__default.resolve(agentDir, ref));
+      const moved = byOldPath.get(path19__default.resolve(agentDir, ref));
       if (moved === void 0) return ref;
       hits++;
-      const rel = posix2(path18__default.relative(agentDir, moved));
+      const rel = posix2(path19__default.relative(agentDir, moved));
       return rel.startsWith(".") ? rel : `./${rel}`;
     };
     let output;
@@ -7936,7 +8209,7 @@ function planAgentRefRewrites(root, moves, knownKinds, notes) {
     if (hits === 0 || output === source) continue;
     changes.push({ type: "write", path: file, before: source, after: output });
     notes.push(
-      `${posix2(path18__default.relative(root, file))}: persona/ruleset refs \u2192 composes items at the new paths`
+      `${posix2(path19__default.relative(root, file))}: persona/ruleset refs \u2192 composes items at the new paths`
     );
   }
   return changes;
@@ -7960,14 +8233,14 @@ function presetText(name, description, refs, version) {
 }
 function skillDirs(dir) {
   try {
-    return readdirSync(path18__default.join(dir, "skills"), { withFileTypes: true }).filter((e) => e.isDirectory() && existsSync(path18__default.join(dir, "skills", e.name, "SKILL.md"))).map((e) => e.name).sort();
+    return readdirSync(path19__default.join(dir, "skills"), { withFileTypes: true }).filter((e) => e.isDirectory() && existsSync(path19__default.join(dir, "skills", e.name, "SKILL.md"))).map((e) => e.name).sort();
   } catch {
     return [];
   }
 }
 function repoPublisher(root) {
   for (const name of ["skaile.manifest.yaml", "skaile.yaml"]) {
-    const file = path18__default.join(root, name);
+    const file = path19__default.join(root, name);
     if (!existsSync(file)) continue;
     try {
       const parsed = parse(readText(file));
@@ -7979,15 +8252,15 @@ function repoPublisher(root) {
   }
   return DEFAULT_PUBLISHER;
 }
-function planBundles(root, skaileYamls, publisher, notes, manual, conflicts) {
+function planBundles(root, skaileYamls, publisher, notes, manual, conflicts, identities, existing) {
   const changes = [];
   const presets = [];
   const handled = /* @__PURE__ */ new Set();
   const claimed = /* @__PURE__ */ new Map();
-  const rel = (p6) => posix2(path18__default.relative(root, p6));
+  const rel = (p6) => posix2(path19__default.relative(root, p6));
   const convert = (name, bundleFile, dir) => {
-    const target = path18__default.join(dir === root ? path18__default.join(dir, name) : dir, `${name}.preset.yaml`);
-    const origin = bundleFile ? rel(bundleFile) : `${rel(path18__default.join(dir, "skills")) || "skills"}/`;
+    const target = path19__default.join(dir === root ? path19__default.join(dir, name) : dir, `${name}.preset.yaml`);
+    const origin = bundleFile ? rel(bundleFile) : `${rel(path19__default.join(dir, "skills")) || "skills"}/`;
     const earlier = claimed.get(target);
     if (earlier !== void 0) {
       conflicts.push(
@@ -7995,10 +8268,25 @@ function planBundles(root, skaileYamls, publisher, notes, manual, conflicts) {
       );
       return;
     }
+    const identity = finalIdentity("preset", name);
+    const sameName = identities.get(identity);
+    if (sameName !== void 0) {
+      conflicts.push(
+        `${sameName} and ${origin} both become ${identity}: rename one bundle first. Nothing was changed.`
+      );
+      return;
+    }
     if (existsSync(target)) {
       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;
@@ -8026,11 +8314,12 @@ function planBundles(root, skaileYamls, publisher, notes, manual, conflicts) {
     }
     if (refs.length === 0) {
       manual.push(
-        `bundle ${name}: no dependencies found${bundleFile ? ` in ${rel(bundleFile)}` : ` and no skills under ${rel(path18__default.join(dir, "skills"))}`}; no preset generated`
+        `bundle ${name}: no dependencies found${bundleFile ? ` in ${rel(bundleFile)}` : ` and no skills under ${rel(path19__default.join(dir, "skills"))}`}; no preset generated`
       );
       return;
     }
     claimed.set(target, origin);
+    identities.set(identity, origin);
     const after = presetText(name, description, refs, version);
     if (before !== void 0 && bundleFile) {
       changes.push({ type: "move", from: bundleFile, to: target, before, after });
@@ -8051,18 +8340,18 @@ function planBundles(root, skaileYamls, publisher, notes, manual, conflicts) {
     const assets = Array.isArray(raw.assets) ? raw.assets : [];
     for (const entry of assets) {
       if (!isRecord(entry) || entry.kind !== "bundle" || typeof entry.name !== "string") continue;
-      const baseDir = path18__default.dirname(file);
-      const entryRoot = typeof entry.root === "string" ? path18__default.join(baseDir, entry.root) : baseDir;
+      const baseDir = path19__default.dirname(file);
+      const entryRoot = typeof entry.root === "string" ? path19__default.join(baseDir, entry.root) : baseDir;
       const files = Array.isArray(entry.files) ? entry.files : [];
       const bundleName = files.find(
         (f) => typeof f === "string" && f.endsWith(".bundle.yaml")
       );
-      convert(entry.name, bundleName ? path18__default.join(entryRoot, bundleName) : void 0, entryRoot);
+      convert(entry.name, bundleName ? path19__default.join(entryRoot, bundleName) : void 0, entryRoot);
     }
   }
   for (const bundleFile of walkFiles(root, (b) => b.endsWith(".bundle.yaml"))) {
     if (handled.has(bundleFile)) continue;
-    const base = path18__default.basename(bundleFile);
+    const base = path19__default.basename(bundleFile);
     let name = base.replace(/\.bundle\.yaml$/, "");
     try {
       const parsed = parse(readText(bundleFile));
@@ -8071,7 +8360,7 @@ function planBundles(root, skaileYamls, publisher, notes, manual, conflicts) {
     } catch {
     }
     if (presets.some((p6) => p6.bundleFile === bundleFile)) continue;
-    convert(name, bundleFile, path18__default.dirname(bundleFile));
+    convert(name, bundleFile, path19__default.dirname(bundleFile));
   }
   return changes;
 }
@@ -8081,8 +8370,8 @@ function planSkaileYaml(root, file, source, notes, manual) {
   if (doc.errors.length > 0 || !isMap(doc.contents)) return [];
   const map = doc.contents;
   const raw = doc.toJS();
-  const dir = path18__default.dirname(file);
-  const rel = (p6) => posix2(path18__default.relative(root, p6));
+  const dir = path19__default.dirname(file);
+  const rel = (p6) => posix2(path19__default.relative(root, p6));
   const changes = [];
   let changed = false;
   const deps = map.get("dependencies", true);
@@ -8099,7 +8388,7 @@ function planSkaileYaml(root, file, source, notes, manual) {
   const hasPublication = PUBLICATION_KEYS.some((k) => raw[k] !== void 0);
   let remove = false;
   if (hasPublication) {
-    const manifestPath = path18__default.join(dir, "skaile.manifest.yaml");
+    const manifestPath = path19__default.join(dir, "skaile.manifest.yaml");
     if (existsSync(manifestPath)) {
       manual.push(
         `${rel(file)}: publisher/version/assets left in place \u2014 ${rel(manifestPath)} already exists; merge by hand`
@@ -8156,16 +8445,26 @@ function planSkaileYaml(root, file, source, notes, manual) {
   return changes;
 }
 function planAssetMigration(options) {
-  const root = path18__default.resolve(options.root);
+  const root = path19__default.resolve(options.root);
   const knownKinds = new Set(options.registry.getAllKinds());
   const notes = [];
   const manual = [];
   const conflicts = [];
   const unknownTypes = [];
-  const { moves, changes: moveChanges } = planMarkdownMoves(root, knownKinds, manual, unknownTypes);
+  const identities = /* @__PURE__ */ new Map();
+  const existing = existingIdentities(root);
+  const { moves, changes: moveChanges } = planMarkdownMoves(
+    root,
+    knownKinds,
+    manual,
+    unknownTypes,
+    identities,
+    conflicts,
+    existing
+  );
   for (const move of moves) {
     notes.push(
-      `${posix2(path18__default.relative(root, move.from))} \u2192 ${posix2(path18__default.relative(root, move.to))} (${move.kind})`
+      `${posix2(path19__default.relative(root, move.from))} \u2192 ${posix2(path19__default.relative(root, move.to))} (${move.kind})`
     );
   }
   const agentChanges = planAgentRefRewrites(root, moves, knownKinds, notes);
@@ -8177,11 +8476,20 @@ function planAssetMigration(options) {
       const raw = parse(source);
       if (isRecord(raw)) skaileYamls.push({ file, source, raw });
     } catch {
-      manual.push(`${posix2(path18__default.relative(root, file))}: invalid YAML; skipped`);
+      manual.push(`${posix2(path19__default.relative(root, file))}: invalid YAML; skipped`);
     }
   }
   const publisher = repoPublisher(root);
-  const bundleChanges = planBundles(root, skaileYamls, publisher, notes, manual, conflicts);
+  const bundleChanges = planBundles(
+    root,
+    skaileYamls,
+    publisher,
+    notes,
+    manual,
+    conflicts,
+    identities,
+    existing
+  );
   const skaileChanges = skaileYamls.flatMap(
     ({ file, source }) => planSkaileYaml(root, file, source, notes, manual)
   );
@@ -8266,12 +8574,12 @@ function migrateHarnessSettings(text, label = "settings.json") {
 }
 function workspaceYamlFiles(projectDir) {
   const files = [];
-  if (existsSync(path18__default.join(projectDir, SKAILE_YAML_DEFAULT))) {
-    files.push(path18__default.join(projectDir, SKAILE_YAML_DEFAULT));
+  if (existsSync(path19__default.join(projectDir, SKAILE_YAML_DEFAULT))) {
+    files.push(path19__default.join(projectDir, SKAILE_YAML_DEFAULT));
   }
   try {
     for (const entry of readdirSync(projectDir).sort()) {
-      if (entry.endsWith(SKAILE_YAML_SUFFIX)) files.push(path18__default.join(projectDir, entry));
+      if (entry.endsWith(SKAILE_YAML_SUFFIX)) files.push(path19__default.join(projectDir, entry));
     }
   } catch {
   }
@@ -8285,7 +8593,7 @@ function planHarnessMigration(opts) {
     if (seen.has(file) || !existsSync(file)) return;
     seen.add(file);
     const before = readText(file);
-    const label = path18__default.basename(file);
+    const label = path19__default.basename(file);
     let result;
     try {
       result = rewrite(before, label);
@@ -8308,7 +8616,7 @@ function runMigrateHarness(opts) {
     "--apply"
   );
   const cwd = process.cwd();
-  const projectDir = path18__default.resolve(opts.projectDir ?? findWorkspaceRoot(cwd) ?? cwd);
+  const projectDir = path19__default.resolve(opts.projectDir ?? findWorkspaceRoot(cwd) ?? cwd);
   const plan = planHarnessMigration({ projectDir });
   for (const note of plan.notes) console.log(`  ${note}`);
   printChanges(plan.changes, projectDir);
@@ -8468,7 +8776,7 @@ function workspaceConfigFiles(dir) {
   } catch {
     return [];
   }
-  return names.filter((name) => isWorkspaceConfigFilename(name)).sort().map((name) => path18__default.join(dir, name));
+  return names.filter((name) => isWorkspaceConfigFilename(name)).sort().map((name) => path19__default.join(dir, name));
 }
 function readAgentConfigBlock(raw) {
   const key = AGENT_CONFIG_KEYS2.find((candidate) => raw[candidate] !== void 0);
@@ -8480,7 +8788,7 @@ function readAgentConfigBlock(raw) {
   return flat ? { key, profiles: { default: profiles }, flat } : { key, profiles, flat };
 }
 function planProviderMigration(options) {
-  const projectDir = path18__default.resolve(options.projectDir);
+  const projectDir = path19__default.resolve(options.projectDir);
   const registryPath = options.workspace ? workspaceProviderRegistryPath(projectDir) : userProviderRegistryPath();
   const plan = {
     registryPath,
@@ -8496,7 +8804,7 @@ function planProviderMigration(options) {
       raw = parseDocument(readFileSync(file, "utf-8")).toJS() ?? {};
     } catch (error) {
       plan.warnings.push(
-        `${path18__default.basename(file)}: not valid YAML (${error instanceof Error ? error.message : String(error)}) \u2014 skipped`
+        `${path19__default.basename(file)}: not valid YAML (${error instanceof Error ? error.message : String(error)}) \u2014 skipped`
       );
       continue;
     }
@@ -8545,7 +8853,7 @@ function planProviderMigration(options) {
       });
       if (!model) {
         plan.warnings.push(
-          `${path18__default.basename(file)}: profile '${profile}' had no model: \u2014 it now resolves against registry order. Pin it with 'model: ${providerId}/<modelId>'.`
+          `${path19__default.basename(file)}: profile '${profile}' had no model: \u2014 it now resolves against registry order. Pin it with 'model: ${providerId}/<modelId>'.`
         );
       }
       touched = true;
@@ -8612,7 +8920,7 @@ function printPlan(plan) {
   for (const entry of plan.entries) {
     const base = entry.entry.base_url ?? S.dim("(transport-derived)");
     console.log(
-      `  ${S.label(`${path18__default.basename(entry.file)} ${entry.profile}`)} provider: ${entry.legacy.provider}, cloud: ${entry.legacy.cloud}`
+      `  ${S.label(`${path19__default.basename(entry.file)} ${entry.profile}`)} provider: ${entry.legacy.provider}, cloud: ${entry.legacy.cloud}`
     );
     console.log(`    \u2192 providers.yml ${S.bold(entry.providerId)}  ${base}`);
     console.log(
@@ -8628,7 +8936,7 @@ function printPlan(plan) {
   console.log();
 }
 async function runMigrateProviders(opts) {
-  const projectDir = opts.projectDir ? path18__default.resolve(opts.projectDir) : process.cwd();
+  const projectDir = opts.projectDir ? path19__default.resolve(opts.projectDir) : process.cwd();
   const plan = planProviderMigration({ projectDir, workspace: opts.workspace });
   for (const warning of plan.warnings) logWarn(warning);
   if (plan.entries.length === 0 && Object.keys(plan.providers).length === 0) {
@@ -8732,7 +9040,7 @@ async function runMigrateAgents(paths, opts) {
   let failures = 0;
   let manualCount = 0;
   for (const report of plan.reports) {
-    const rel = path18__default.relative(base, report.file) || report.file;
+    const rel = path19__default.relative(base, report.file) || report.file;
     for (const note of report.notes) console.log(`  ${S.label(rel)} ${note}`);
     for (const note of report.manual) {
       manualCount++;
@@ -8759,7 +9067,7 @@ async function runMigrateAssets(root, opts) {
   const write = resolveMode(opts);
   const base = process.cwd();
   const plan = planAssetMigration({
-    root: path18__default.resolve(root ?? base),
+    root: path19__default.resolve(root ?? base),
     registry: getKindRegistry()
   });
   if (plan.conflicts.length > 0) {
@@ -8771,7 +9079,7 @@ async function runMigrateAssets(root, opts) {
   for (const note of plan.manual) logWarn(note);
   for (const { file, type } of plan.unknownTypes) {
     logWarn(
-      `${path18__default.relative(base, file) || file}: frontmatter type "${type}" is not a registered asset kind (reported, not rewritten)`
+      `${path19__default.relative(base, file) || file}: frontmatter type "${type}" is not a registered asset kind (reported, not rewritten)`
     );
   }
   printChanges(plan.changes, base);
@@ -8795,8 +9103,8 @@ function makeNpxCommand() {
   skills.command("add <url>").description(
     "Clone a repo, register it in the project's skaile.yaml sources[], and install a skill from it"
   ).requiredOption("--skill <name>", "Skill name to install from the repo").option("--project-dir <path>", "Project directory", process.cwd()).option("--target <agent>", `Agent framework (${TARGET_DEFAULT_HINT})`).option("--global", "Deploy globally").action(async (url, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
-    const projYaml = path18__default.join(projectDir, "skaile.yaml");
+    const projectDir = path19__default.resolve(opts.projectDir);
+    const projYaml = path19__default.join(projectDir, "skaile.yaml");
     if (!existsSync(projYaml)) {
       logErr(`No skaile.yaml in ${projectDir} \u2014 run \`skaile init\` first.`);
       process.exit(1);
@@ -8809,11 +9117,11 @@ function makeNpxCommand() {
     }
     const spinner = createSpinner();
     const key = sourceCacheKey(url);
-    const clonePath = path18__default.join(getGlobalCacheDir(), key);
+    const clonePath = path19__default.join(getGlobalCacheDir(), key);
     spinner.start(`Cloning ${url}`);
     try {
       if (!existsSync(clonePath)) {
-        mkdirSync(path18__default.dirname(clonePath), { recursive: true });
+        mkdirSync(path19__default.dirname(clonePath), { recursive: true });
         execSync(`git clone ${url} ${clonePath}`, { stdio: "ignore" });
       }
       spinner.stop(`Cloned to ${key}`);
@@ -8868,7 +9176,7 @@ function makeNpxCommand() {
   return npx;
 }
 function resolvePublisher(clonePath, url) {
-  const manifestPath = path18__default.join(clonePath, SKAILE_MANIFEST_FILENAME);
+  const manifestPath = path19__default.join(clonePath, SKAILE_MANIFEST_FILENAME);
   if (existsSync(manifestPath)) {
     try {
       const { manifest } = decodeSkaileManifest(readFileSync(manifestPath, "utf8"));
@@ -8881,12 +9189,12 @@ function resolvePublisher(clonePath, url) {
   return url.match(/github\.com[/:]([^/]+)\/[^/]+/)?.[1];
 }
 function resolveSkillName(clonePath, requested) {
-  const skillsDir = path18__default.join(clonePath, "skills");
-  if (existsSync(path18__default.join(skillsDir, requested, "SKILL.md"))) return requested;
+  const skillsDir = path19__default.join(clonePath, "skills");
+  if (existsSync(path19__default.join(skillsDir, requested, "SKILL.md"))) return requested;
   if (!existsSync(skillsDir)) return requested;
   for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
     if (!entry.isDirectory()) continue;
-    const md = path18__default.join(skillsDir, entry.name, "SKILL.md");
+    const md = path19__default.join(skillsDir, entry.name, "SKILL.md");
     if (!existsSync(md)) continue;
     try {
       const { data } = parseFrontmatter(readFileSync(md, "utf8"));
@@ -8940,7 +9248,7 @@ function makeOutdatedCommand() {
     requireProjectConfig(opts.projectDir);
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir),
+      projectDir: path19__default.resolve(opts.projectDir),
       harness: opts.target
     });
     const entries = await am2.outdated();
@@ -8964,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.`);
@@ -8983,7 +9298,7 @@ function makePatchCommand() {
   cmd.command("extract <ref>").alias("start").description("Extract asset for local editing").option("--project-dir <path>", "Project directory", process.cwd()).action(async (ref, opts) => {
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     try {
       const dest = await am2.patch(ref);
@@ -8997,7 +9312,7 @@ function makePatchCommand() {
   cmd.command("commit <ref>").description("Generate .patch file from edits").option("--project-dir <path>", "Project directory", process.cwd()).action(async (ref, opts) => {
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     try {
       const patchFile = await am2.patchCommit(ref);
@@ -9011,7 +9326,7 @@ function makePatchCommand() {
   cmd.command("submit <ref>").description("Apply patch to repo clone and prepare for PR").option("--project-dir <path>", "Project directory", process.cwd()).action(async (ref, opts) => {
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     try {
       await am2.patchSubmit(ref);
@@ -9027,7 +9342,7 @@ function makePatchCommand() {
   cmd.command("remove <ref>").description("Remove local patch after upstream merge").option("--project-dir <path>", "Project directory", process.cwd()).action((ref, opts) => {
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     am2.patchRemove(ref);
     logOk(`Patch removed for ${ref}`);
@@ -9046,7 +9361,7 @@ function action2(fn) {
   };
 }
 async function reconcileAndReport(projectDir, plugins, opts = {}) {
-  const { reconcilePlugins } = await import('../plugin-store-MSH6GK6T.js');
+  const { reconcilePlugins } = await import('../plugin-store-36SIL4TV.js');
   if (plugins.length === 0) {
     logInfo("No plugins declared \u2014 nothing to reconcile.");
     return;
@@ -9061,7 +9376,7 @@ async function reconcileAndReport(projectDir, plugins, opts = {}) {
   }
 }
 async function verifyPluginLoads(projectDir, spec) {
-  const { loadPlugins } = await import('../plugin-store-MSH6GK6T.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);
@@ -9073,10 +9388,12 @@ async function verifyPluginLoads(projectDir, spec) {
   logOk(`Loaded ${S.cmd(spec)}${contributed.length > 0 ? ` (${contributed.join(", ")})` : ""}`);
 }
 async function runInstall2(spec, opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const { WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-  const { specName, rollbackPluginStore } = await import('../plugin-store-MSH6GK6T.js');
-  const yamlPath = path18__default.join(projectDir, "skaile.yaml");
+  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`);
   }
@@ -9102,10 +9419,10 @@ async function runInstall2(spec, opts) {
   }
 }
 async function runRemove(name, opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const { WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-  const { specName } = await import('../plugin-store-MSH6GK6T.js');
-  const yamlPath = path18__default.join(projectDir, "skaile.yaml");
+  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}.`);
     return;
@@ -9121,7 +9438,7 @@ async function runRemove(name, opts) {
   await reconcileAndReport(projectDir, editor.getPlugins());
 }
 async function runList(opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const { resolveSkWorkspaceConfig: resolveSkWorkspaceConfig2 } = await import('../core/index.js');
   const config = resolveSkWorkspaceConfig2(projectDir);
   const declared = config.plugins ?? [];
@@ -9136,7 +9453,7 @@ async function runList(opts) {
   const registry = createPluginRegistry();
   if (declared.length > 0) {
     try {
-      const { loadPlugins } = await import('../plugin-store-MSH6GK6T.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) {
@@ -9404,8 +9721,8 @@ function redactSecrets(preset, findings) {
   }
   return { preset: next, keys };
 }
-function placeholderKey(itemId, path42) {
-  return `${itemId}_${path42}`.replace(/[^a-zA-Z0-9]+/g, "_").replace(/^_+|_+$/g, "").toUpperCase();
+function placeholderKey(itemId, path43) {
+  return `${itemId}_${path43}`.replace(/[^a-zA-Z0-9]+/g, "_").replace(/^_+|_+$/g, "").toUpperCase();
 }
 function setAtPath(root, segments, value) {
   let node = root;
@@ -9428,7 +9745,7 @@ function makePresetCommand() {
   cmd.command("init [name]").description("Scaffold a new .preset.yaml file").option("--dir <path>", "Output directory", process.cwd()).action(async (name, opts) => {
     const presetName = name ?? "my-preset";
     const filename = `${presetName}.preset.yaml`;
-    const outPath = path18__default.join(path18__default.resolve(opts.dir), filename);
+    const outPath = path19__default.join(path19__default.resolve(opts.dir), filename);
     if (existsSync(outPath)) {
       logErr(`File already exists: ${outPath}`);
       logInfo("Choose a different name or remove the existing file.");
@@ -9461,7 +9778,7 @@ function makePresetCommand() {
   return cmd;
 }
 async function runPresetExport(name, opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const file = loadSkWorkspaceConfig(projectDir);
   if (!file) {
     logErr(`No skaile.yaml found in ${projectDir}`);
@@ -9471,7 +9788,7 @@ async function runPresetExport(name, opts) {
   const presetName = name ?? file.config.name ?? "my-preset";
   let lock = null;
   try {
-    lock = readLock(path18__default.join(projectDir, "skaile.lock.yaml"));
+    lock = readLock(path19__default.join(projectDir, "skaile.lock.yaml"));
   } catch {
     lock = null;
   }
@@ -9512,7 +9829,7 @@ async function runPresetExport(name, opts) {
   const contents = header ? `${header}
 ${body}` : body;
   if (opts.out && opts.dir !== process.cwd()) logWarn("--dir is ignored when --out is set.");
-  const outPath = opts.out ? path18__default.resolve(opts.out) : path18__default.join(path18__default.resolve(opts.dir), `${presetName}.preset.yaml`);
+  const outPath = opts.out ? path19__default.resolve(opts.out) : path19__default.join(path19__default.resolve(opts.dir), `${presetName}.preset.yaml`);
   if (existsSync(outPath) && !opts.force) {
     logErr(`File already exists: ${outPath}`);
     logInfo("Pass --force to overwrite, or choose a different --out/--dir.");
@@ -9524,7 +9841,7 @@ ${body}` : body;
     logErr(`Failed to write ${outPath}: ${e.message}`);
     process.exit(1);
   }
-  logOk(`Exported ${S.brand(path18__default.basename(outPath))}`);
+  logOk(`Exported ${S.brand(path19__default.basename(outPath))}`);
   logInfo(`Path: ${outPath}`);
   if (unresolved.length > 0) {
     console.error(S.err("This file is NOT safe to share."));
@@ -9565,13 +9882,13 @@ function collectInput(value, acc) {
   return acc;
 }
 async function runPresetApply(filePath, opts) {
-  const projectDir = path18__default.resolve(opts.projectDir);
+  const projectDir = path19__default.resolve(opts.projectDir);
   const file = loadSkWorkspaceConfig(projectDir);
   if (!file) {
     logErr("No skaile.yaml \u2014 run `skaile init` first");
     process.exit(1);
   }
-  const resolved = path18__default.resolve(filePath);
+  const resolved = path19__default.resolve(filePath);
   if (!existsSync(resolved)) {
     logErr(`File not found: ${resolved}`);
     process.exit(1);
@@ -9789,7 +10106,7 @@ async function reportNestedPresetRefs(preset) {
 }
 async function checkPresetCycles(preset, resolved) {
   const { detectCycles } = await import('../discovery/index.js');
-  const presetRef = path18__default.basename(resolved, ".preset.yaml");
+  const presetRef = path19__default.basename(resolved, ".preset.yaml");
   const edges = [];
   for (const item of preset.items) {
     if (item.ref) {
@@ -9841,7 +10158,7 @@ function printPresetSummary(preset, placeholderCount, hasWarnings) {
   }
 }
 async function runPresetValidate(filePath) {
-  const resolved = path18__default.resolve(filePath);
+  const resolved = path19__default.resolve(filePath);
   const preset = await loadPresetForValidation(resolved);
   await reportNestedPresetRefs(preset);
   await checkPresetCycles(preset, resolved);
@@ -9894,7 +10211,7 @@ function resolveNamedAgent(projectDir, arg) {
     logErr(message);
     process.exit(1);
   };
-  const asPath = path18__default.resolve(projectDir, arg);
+  const asPath = path19__default.resolve(projectDir, arg);
   const isPath = arg.includes("/") || arg.includes("\\");
   const viaRef = (ref) => {
     try {
@@ -9919,7 +10236,7 @@ function resolveNamedAgent(projectDir, arg) {
     if (!(err instanceof AgentRefResolutionError)) throw err;
     if (err.code === "ambiguous") return fail(err.message);
   }
-  if (existsSync(path18__default.join(asPath, "agent.yaml"))) return asPath;
+  if (existsSync(path19__default.join(asPath, "agent.yaml"))) return asPath;
   const known = Object.keys(instances);
   return fail(
     `No agent "${arg}" found. Give an agent name, an agent: ref or a path` + (known.length > 0 ? ` (agent instances of this project: ${known.join(", ")})` : "") + "."
@@ -9930,8 +10247,13 @@ function makeRebuildCommand() {
     "[agent]",
     "Agent name, agent: ref, instance id or path (defaults to the project agent)"
   ).option("--project-dir <dir>", "Project directory", process.cwd()).action(async (agentArg, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    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);
@@ -9988,9 +10310,9 @@ function makeRebuildCommand() {
 }
 function resolveSingleShotAgentDir(projectDir, agentDefinition) {
   if (!agentDefinition) return resolveAgentDir(projectDir);
-  const asPath = agentDefinition.endsWith("agent.yaml") ? path18__default.dirname(path18__default.resolve(projectDir, agentDefinition)) : agentDefinition;
+  const asPath = agentDefinition.endsWith("agent.yaml") ? path19__default.dirname(path19__default.resolve(projectDir, agentDefinition)) : agentDefinition;
   const dir = resolveAgentDefinitionDir(projectDir, asPath);
-  if (!dir || !fs8__default.existsSync(path18__default.join(dir, "agent.yaml"))) {
+  if (!dir || !fs8__default.existsSync(path19__default.join(dir, "agent.yaml"))) {
     throw new Error(
       `--agent-definition "${agentDefinition}" does not resolve to an agent directory with agent.yaml${dir ? ` (looked in ${dir})` : ""}`
     );
@@ -10049,7 +10371,7 @@ async function printCompositionDryRun(projectDir, agentDir, harness, model, inst
 async function findSkillFile(projectDir, skill) {
   const name = skill.trim().replace(/^skill:/, "").replace(/^@[^/]+\//, "").replace(/#.*$/, "");
   for (const target of SUPPORTED_HARNESSES) {
-    const file = path18__default.join(deployedDir("skill", name, target, false, projectDir), "SKILL.md");
+    const file = path19__default.join(deployedDir("skill", name, target, false, projectDir), "SKILL.md");
     if (fs8__default.existsSync(file)) return file;
   }
   const am2 = new AssetManager({ registry: getKindRegistry(), projectDir });
@@ -10065,6 +10387,14 @@ async function printSkillDryRun(projectDir, skill) {
     return false;
   }
   const content = fs8__default.readFileSync(file, "utf-8");
+  const prerequisiteErrors = checkAssetFile(file, "skill", getKindRegistry()).filter(
+    (f) => f.text.startsWith("metadata.prerequisites")
+  );
+  if (prerequisiteErrors.length > 0) {
+    for (const f of prerequisiteErrors) logErr(`${file} [${f.tag}] - ${f.text}`);
+    logErr(`Fix the skill's metadata.prerequisites (see \`skaile validate\`), then run it again.`);
+    return false;
+  }
   const { data } = parseFrontmatter(content);
   const meta = data.metadata ?? {};
   console.log(`  ${S.label("Skill:")}       ${S.heading(String(data.name ?? skill))}`);
@@ -10164,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>",
@@ -10172,8 +10530,11 @@ function makeRunCommand() {
     "--instance <id>",
     "Run the skaile.yaml `agents:` instance <id> (`default` is the primary `agent:`) with its overrides; single-shot prompts only"
   ).option("--skill <name>", "Skill name (for single-shot mode)").action(async (positional, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     await loadDeclaredPlugins(projectDir);
+    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;
@@ -10329,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)));
@@ -10342,7 +10704,7 @@ function makeResumeCommand() {
     "--session <run-id>",
     "Target session by runId (full ID or the prefix `session list` prints)"
   ).option("--dry-run", "Print plan without executing").action(async (opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     let sessionId = opts.session;
     const dryRun = opts.dryRun ?? false;
     if (sessionId) {
@@ -10383,7 +10745,7 @@ function makeResumeCommand() {
 }
 function makeStatusCommand() {
   return new Command("status").description("Show current session state").option("--project-dir <path>", "Project directory", process.cwd()).action(async (opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const session = await loadSession(projectDir);
     if (!session) {
       logInfo("No active session.");
@@ -10409,7 +10771,7 @@ function makeStatusCommand() {
 }
 function makeClearCommand() {
   return new Command("clear").description("Unset current session pointer").option("--project-dir <path>", "Project directory", process.cwd()).action(async (opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     await clearSession(projectDir);
     logOk("Session cleared.");
   });
@@ -10421,8 +10783,8 @@ function makeReplCommand() {
   ).action(async (opts) => {
     const { findWorkspaceRoot: findWorkspaceRoot2 } = await import('../core/index.js');
     const { startRepl } = await import('../tui/index.js');
-    const os2 = await import('os');
-    const userCwd = path18__default.resolve(opts.projectDir ?? process.cwd());
+    const os3 = await import('os');
+    const userCwd = path19__default.resolve(opts.projectDir ?? process.cwd());
     const workspaceRoot = findWorkspaceRoot2(userCwd);
     const instanceId2 = opts.instance?.trim() || void 0;
     let projectDir;
@@ -10451,12 +10813,12 @@ function makeReplCommand() {
         p4.cancel("Cancelled.");
         process.exit(0);
       }
-      const tmpDir = fs8__default.mkdtempSync(path18__default.join(os2.tmpdir(), "skaile-repl-"));
+      const tmpDir = fs8__default.mkdtempSync(path19__default.join(os3.tmpdir(), "skaile-repl-"));
       projectDir = tmpDir;
       agentCwd = userCwd;
       logOk(`Temporary workspace: ${S.cmd(tmpDir)}`);
       if (!harnessOverride) {
-        const claudeDir = path18__default.join(os2.homedir(), ".claude");
+        const claudeDir = path19__default.join(os3.homedir(), ".claude");
         if (fs8__default.existsSync(claudeDir)) {
           harnessOverride = "claude-sdk";
           logInfo(`Detected ${S.cmd("~/.claude")} \u2192 using ${S.cmd("claude-sdk")} harness`);
@@ -10468,6 +10830,9 @@ function makeReplCommand() {
       console.log();
     }
     await loadDeclaredPlugins(projectDir);
+    if (await reportProjectConfig(projectDir, { harness: false, instances: true }) > 0) {
+      process.exit(1);
+    }
     const effective = await resolveSettings(projectDir, {
       harness: harnessOverride,
       model: opts.model
@@ -10503,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);
 }
@@ -10549,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)"
@@ -10597,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 {
@@ -10618,7 +11010,14 @@ function makeServeCommand() {
       }
       const providers = parseProviderIds(opts.providers);
       const modelEndpoint = parseModelEndpointFlag(opts.modelEndpoint);
-      const { checkHarnessSdk, checkModelEndpointPeer, checkServeModel } = await import('../serve-preflight-L4POEHNQ.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);
@@ -10679,12 +11078,12 @@ function makeServeCommand() {
   );
 }
 async function ensurePluginsLoadedForServe(projectDir) {
-  const { logInfo: logInfo2, logWarn: logWarn2 } = await import('../helpers-DE53KG3E.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-MSH6GK6T.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) {
@@ -10698,14 +11097,14 @@ async function ensurePluginsLoadedForServe(projectDir) {
   }
 }
 async function runCompileTest(opts) {
-  const { logOk: logOk2, logErr: logErr2, logInfo: logInfo2, S: S2 } = await import('../helpers-DE53KG3E.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-QAV4C3KX.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).");
@@ -10898,6 +11297,15 @@ function localQuery(dbPath, q) {
     db.close();
   }
 }
+function localSessionExists(dbPath, sessionId) {
+  const db = openSqlite(dbPath, { readonly: true });
+  try {
+    db.exec("PRAGMA query_only=1;");
+    return db.prepare("SELECT 1 AS found FROM log_entries WHERE session_id = $sid LIMIT 1").get({ $sid: sessionId }) != null;
+  } finally {
+    db.close();
+  }
+}
 function buildSelect(q) {
   const where = ["session_id = $sid"];
   const params = { $sid: q.sessionId };
@@ -11188,7 +11596,7 @@ function resolveMode2(opts) {
   if (opts.forceLocal && opts.forceRemote) {
     throw new Error("Cannot use both --local and --remote");
   }
-  const startDir = path18__default.resolve(opts.projectDir ?? process.cwd());
+  const startDir = path19__default.resolve(opts.projectDir ?? process.cwd());
   const localDb = findLogsDb(startDir);
   if (opts.forceLocal) {
     if (!localDb) {
@@ -11221,14 +11629,14 @@ function resolveMode2(opts) {
 function findLogsDb(startDir) {
   let dir = startDir;
   for (let i = 0; i < MAX_WALK_LEVELS; i++) {
-    const candidate = path18__default.join(dir, ".skaile", "logs.db");
+    const candidate = path19__default.join(dir, ".skaile", "logs.db");
     if (existsSync(candidate)) {
       try {
         if (statSync(candidate).isFile()) return candidate;
       } catch {
       }
     }
-    const parent = path18__default.dirname(dir);
+    const parent = path19__default.dirname(dir);
     if (parent === dir) return void 0;
     dir = parent;
   }
@@ -11327,6 +11735,9 @@ function buildLogQuery(opts) {
 async function fetchEntries(sessionId, opts, resolved, query) {
   if (resolved.mode === "local") {
     const result2 = localQuery(resolved.dbPath, { ...query, sessionId });
+    if (result2.entries.length === 0 && !localSessionExists(resolved.dbPath, sessionId)) {
+      throw new Error(`No session ${sessionId} in this project's log database.`);
+    }
     return { entries: result2.entries, nextCursor: result2.nextCursor };
   }
   if (!opts.projectId) {
@@ -11418,7 +11829,7 @@ async function requireSession(projectDir, idOrPrefix) {
 function makeSessionCommand() {
   const cmd = new Command("session").description("Manage sessions");
   cmd.command("list").description("List all sessions for a project").option("--project-dir <path>", "Project directory", process.cwd()).action(async (opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const sessions = await listSessions(projectDir);
     const current = await loadSession(projectDir);
     if (sessions.length === 0) {
@@ -11446,18 +11857,18 @@ function makeSessionCommand() {
     console.log();
   });
   cmd.command("show <run-id>").description("Show a specific session (full run ID or the prefix `session list` prints)").option("--project-dir <path>", "Project directory", process.cwd()).action(async (idOrPrefix, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const { session } = await requireSession(projectDir, idOrPrefix);
     console.log(JSON.stringify(session, null, 2));
   });
   cmd.command("switch <run-id>").description("Switch the current session (full run ID or the prefix `session list` prints)").option("--project-dir <path>", "Project directory", process.cwd()).action(async (idOrPrefix, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const { runId } = await requireSession(projectDir, idOrPrefix);
     await setCurrentSession(projectDir, runId);
     logOk(`Switched to session: ${S.dim(runId.slice(0, 8))}`);
   });
   cmd.command("delete <run-id>").description("Delete a session (full run ID or the prefix `session list` prints)").option("--project-dir <path>", "Project directory", process.cwd()).action(async (idOrPrefix, opts) => {
-    const projectDir = path18__default.resolve(opts.projectDir);
+    const projectDir = path19__default.resolve(opts.projectDir);
     const { runId } = await requireSession(projectDir, idOrPrefix);
     await deleteSession(projectDir, runId);
     logOk(`Deleted session: ${S.dim(runId.slice(0, 8))}`);
@@ -11534,7 +11945,7 @@ function makeShowCommand() {
     requireProjectConfig(opts.projectDir, { allowMissing: true });
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir),
+      projectDir: path19__default.resolve(opts.projectDir),
       harness: opts.target
     });
     if (!kind) {
@@ -11562,7 +11973,7 @@ function searchCuratedManifests(query) {
     const slug = file.slice(0, -".yaml".length);
     let manifest;
     try {
-      manifest = decodeSkaileManifest(readFileSync(path18.join(dir, file), "utf-8")).manifest;
+      manifest = decodeSkaileManifest(readFileSync(path19.join(dir, file), "utf-8")).manifest;
     } catch {
       continue;
     }
@@ -11582,6 +11993,13 @@ async function fetchIdentity() {
   const jwt = await getStoreToken();
   return storeFetch({ ...getStoreConfig(), jwt }, "/api/v1/me");
 }
+function storeRefProblem(ref, err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const plain = message.replace(/ Run the `migrate-skaile-manifest`.*$/, "");
+  if (!plain.startsWith("publisher required")) return message;
+  const name = /^(?:[^:@/#\s]+:)?([^@/#\s]+)/.exec(ref.trim())?.[1];
+  return name ? `${plain} Find the publisher with \`skaile store search ${name}\`.` : plain;
+}
 async function storeNotFoundMessage(remote, ref) {
   const parsed = parseAssetRef(ref);
   let versions = [];
@@ -11636,7 +12054,7 @@ function makeStoreCommand() {
   });
   store.command("mode <auto|local|remote>").description("Set the catalog resolution mode (not yet wired)").action((_mode) => {
     logErr(
-      `\`skaile store mode\` is scaffolded but not yet wired. Store config lives at ${path18__default.join(globalSkaileDir(), "store", "config.yaml")}.`
+      `\`skaile store mode\` is scaffolded but not yet wired. Store config lives at ${path19__default.join(globalSkaileDir(), "store", "config.yaml")}.`
     );
     process.exit(2);
   });
@@ -11644,9 +12062,9 @@ 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-RJGJIW5H.js');
-    const { getKnownKinds: getKnownKinds2 } = await import('../open-registry-3QS3J7KO.js');
-    const projectDir = path18__default.resolve(opts.projectDir);
+    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(
         `Unknown kind "${opts.kind}". Valid kinds: ${[...getKnownKinds2()].sort().join(", ")}`
@@ -11703,16 +12121,16 @@ 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-RJGJIW5H.js');
-    const { supportsInstallManifest: supportsInstallManifest2 } = await import('../project-HZW2MZPA.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) {
-      logErr(`Invalid asset ref "${ref}": ${e instanceof Error ? e.message : String(e)}`);
+      logErr(`Invalid asset ref "${ref}": ${storeRefProblem(ref, e)}`);
       process.exit(1);
     }
     try {
-      const remote = await openCatalogSource2({ projectDir: path18__default.resolve(opts.projectDir) });
+      const remote = await openCatalogSource2({ projectDir: path19__default.resolve(opts.projectDir) });
       const asset = await remote.resolve(ref);
       if (!asset) {
         logErr(await storeNotFoundMessage(remote, ref));
@@ -11723,7 +12141,7 @@ function makeStoreCommand() {
       const manifestFailure = {};
       if (supportsInstallManifest2(remote)) {
         manifest = await remote.getInstallManifest(canonical).catch(async (err) => {
-          manifestFailure.text = await describeStoreFailure(err, path18__default.resolve(opts.projectDir));
+          manifestFailure.text = await describeStoreFailure(err, path19__default.resolve(opts.projectDir));
           return null;
         });
       }
@@ -11771,9 +12189,14 @@ function makeStoreCommand() {
       }
       console.log();
       const notInstallable = storeNotInstallableReason(asset);
-      console.log(
-        notInstallable ? `  ${S.dim(`Not installable: ${notInstallable}`)}` : `  ${S.dim(`Install:  skaile add ${canonical}`)}`
-      );
+      const notRunnable = !notInstallable && asset.kind === "mcp-server" && manifest ? await mcpNotRunnableHere(manifest, asset.name) : void 0;
+      if (notInstallable) console.log(`  ${S.dim(`Not installable: ${notInstallable}`)}`);
+      else if (notRunnable) {
+        console.log(`  ${S.dim(`Not runnable here: ${notRunnable}`)}`);
+        console.log(
+          `  ${S.dim(`skaile add ${canonical} still records it in the lock, but writes no .mcp.json entry.`)}`
+        );
+      } else console.log(`  ${S.dim(`Install:  skaile add ${canonical}`)}`);
       console.log();
     } catch (e) {
       if (e instanceof LocalCatalogDisabledError2) {
@@ -11782,7 +12205,7 @@ function makeStoreCommand() {
         );
       } else {
         logErr(
-          `Store show failed: ${await describeStoreFailure(e, path18__default.resolve(opts.projectDir))}`
+          `Store show failed: ${await describeStoreFailure(e, path19__default.resolve(opts.projectDir))}`
         );
       }
       process.exit(1);
@@ -11856,7 +12279,7 @@ function makeTreeCommand() {
     requireProjectConfig(opts.projectDir);
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     const root = await am2.tree();
     if (root.children.length === 0) {
@@ -11882,9 +12305,12 @@ function makeUpdateCommand() {
   return new Command("update").description("Refresh the Catalog cache and re-deploy outdated assets in the current project").argument(
     "[name]",
     "Update only this declared asset (kind:@publisher/name, kind:name or name); exits 1 when none matches"
-  ).option("--project-dir <path>", "Project directory", process.cwd()).option("--no-catalog", "Skip refreshing the catalog cache").option("--catalog-only", "Refresh the catalog cache only; do not re-deploy assets").option("--no-sync", "Skip syncing sources from upstream before re-deploying").option("-y, --yes", "Sync sources without the confirmation prompt").action(
+  ).option("--project-dir <path>", "Project directory", process.cwd()).option("--no-catalog", "Skip refreshing the catalog cache").option("--catalog-only", "Refresh the catalog cache only; do not re-deploy assets").option("--no-sync", "Skip syncing sources from upstream before re-deploying").option("-y, --yes", "Sync sources without the confirmation prompt").option(
+    "--force",
+    "Delete files the new content does not ship, and overwrite hand-edited agent files"
+  ).action(
     async (name, opts) => {
-      const projectDir = path18__default.resolve(opts.projectDir);
+      const projectDir = path19__default.resolve(opts.projectDir);
       if (!opts.catalogOnly) requireProjectConfig(projectDir);
       const am2 = new AssetManager({
         registry: getKindRegistry(),
@@ -11904,7 +12330,7 @@ function makeUpdateCommand() {
         const catalogSpinner = createSpinner();
         catalogSpinner.start("Refreshing catalog cache");
         try {
-          const remote = await openCatalogSource({ projectDir: path18__default.resolve(opts.projectDir) });
+          const remote = await openCatalogSource({ projectDir: path19__default.resolve(opts.projectDir) });
           const result2 = await remote.refresh({ timeoutMs: CATALOG_REFRESH_TIMEOUT_MS });
           catalogSpinner.stop(
             `Catalog refreshed: ${S.heading(String(result2.assetsCached))} assets cached`
@@ -11938,14 +12364,14 @@ function makeUpdateCommand() {
         }
       }
       if (target) {
-        await updateOne(am2, projectDir, target);
+        await updateOne(am2, projectDir, target, opts.force);
         return;
       }
       const spinner = createSpinner();
       spinner.start("Re-deploying assets");
       let result;
       try {
-        result = await am2.install({ moveLibraries: true });
+        result = await am2.install({ moveLibraries: true, force: opts.force });
       } catch (err) {
         spinner.stop("Failed");
         logErr(String(err));
@@ -12032,20 +12458,21 @@ 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);
 }
 async function needsCatalog(am2, projectDir) {
   let lock = null;
   try {
-    lock = readLock(path18__default.join(projectDir, "skaile.lock.yaml"));
+    lock = readLock(path19__default.join(projectDir, "skaile.lock.yaml"));
   } catch {
     lock = null;
   }
   let declaredUrls = /* @__PURE__ */ new Set();
   try {
-    const yamlPath = path18__default.join(projectDir, "skaile.yaml");
+    const yamlPath = path19__default.join(projectDir, "skaile.yaml");
     declaredUrls = new Set(
       WorkspaceYamlEditor.load(yamlPath).getSources().map((s) => normalizeRepoUrl(s.url))
     );
@@ -12080,8 +12507,8 @@ function readText2(file) {
     return "";
   }
 }
-async function updateOne(am2, projectDir, target) {
-  const lockPath = path18__default.join(projectDir, "skaile.lock.yaml");
+async function updateOne(am2, projectDir, target, force) {
+  const lockPath = path19__default.join(projectDir, "skaile.lock.yaml");
   const before = readText2(lockPath);
   const spinner = createSpinner();
   spinner.start(`Updating ${target.ref}`);
@@ -12089,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) {
@@ -12277,7 +12705,7 @@ function makeWhyCommand() {
     requireProjectConfig(opts.projectDir);
     const am2 = new AssetManager({
       registry: getKindRegistry(),
-      projectDir: path18__default.resolve(opts.projectDir)
+      projectDir: path19__default.resolve(opts.projectDir)
     });
     const chain = await am2.why(ref);
     if (chain.length === 0) {
@@ -12287,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();
@@ -12349,7 +12783,7 @@ function isIndexBusyError(err) {
 var _defaultFormatHelp = Help.prototype.formatHelp;
 var pkg = JSON.parse(
   readFileSync(
-    path18__default.resolve(path18__default.dirname(fileURLToPath(import.meta.url)), "../../package.json"),
+    path19__default.resolve(path19__default.dirname(fileURLToPath(import.meta.url)), "../../package.json"),
     "utf-8"
   )
 );
@@ -12360,7 +12794,7 @@ for (const key of [
   "SKAILE_CACHE_DIR"
 ]) {
   const value = process.env[key];
-  if (value) process.env[key] = path18__default.resolve(value);
+  if (value) process.env[key] = path19__default.resolve(value);
 }
 var program = new Command("skaile").description("AI asset manager").version(pkg.version, "-v, --version", "Show the skaile CLI version").enablePositionalOptions().configureHelp({
   formatHelp(cmd, helper) {
@@ -12375,6 +12809,7 @@ Project:
   clean [--all] [--dry-run]    Remove skaile-managed assets
   setup                        Interactive provider setup wizard
   config show|get|set          Personal settings
+  harness set <name>           Switch the project to claude-code | omp | codex and install
 
 Assets (skill, agent, prompt, flow, preset, contract):
   add <ref> [--global]         Add to skaile.yaml + deploy
@@ -12472,48 +12907,61 @@ Advanced:
   }
 });
 var INIT_HARNESS_DEFAULTS = {
-  "claude-code": { harness: "claude-sdk" },
-  omp: { harness: "omp" },
-  codex: { harness: "codex" }
+  "claude-code": { harness: HARNESS_ID_OF_TARGET["claude-code"] },
+  omp: { harness: HARNESS_ID_OF_TARGET.omp },
+  codex: { harness: HARNESS_ID_OF_TARGET.codex }
 };
-program.command("init [project-dir]").description("Initialize a project directory (defaults to current directory)").option("--harness <name>", "Coding-agent harness (claude-code | omp | codex)", "claude-code").option("--no-git", "Skip git init and .gitignore").action(
+program.command("init [project-dir]").description("Initialize a project directory (defaults to current directory)").option(
+  "--harness <name>",
+  "Coding-agent harness of a new project (claude-code | omp | codex; default claude-code)"
+).option("--no-git", "Skip git init and .gitignore").action(
   (projectDir, opts) => runInit(projectDir, opts)
 );
 async function runInit(projectDir, opts) {
   const { mkdirSync: mkdirSync5, writeFileSync: writeFileSync7 } = await import('fs');
   const { stringify: stringify2 } = await import('yaml');
-  const { HARNESS_TARGETS: HARNESS_TARGETS2, SUPPORTED_HARNESSES: SUPPORTED_HARNESSES2 } = await import('../core/index.js');
-  const harness = opts.harness;
+  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;
   }
-  const resolved = path18__default.resolve(projectDir ?? ".");
-  const projectName = path18__default.basename(resolved);
+  const resolved = path19__default.resolve(projectDir ?? ".");
+  if (opts.harness && (await import('fs')).existsSync(path19__default.join(resolved, "skaile.yaml"))) {
+    const current = resolveConfiguredHarnessName2(resolved);
+    if (current !== harness) {
+      logErr(
+        `${resolved} is already a skaile project${current ? ` on ${current}` : ""}. To switch it to ${harness}, run: skaile harness set ${harness}`
+      );
+      process.exitCode = 1;
+      return;
+    }
+  }
+  const projectName = path19__default.basename(resolved);
   const created = [];
   const { existsSync: existsSync22 } = await import('fs');
   if (!existsSync22(resolved)) {
     mkdirSync5(resolved, { recursive: true });
     created.push(".");
   }
-  const skaileDir = path18__default.join(resolved, ".skaile");
+  const skaileDir = path19__default.join(resolved, ".skaile");
   if (!existsSync22(skaileDir)) {
-    mkdirSync5(path18__default.join(skaileDir, "sessions"), { recursive: true });
+    mkdirSync5(path19__default.join(skaileDir, "sessions"), { recursive: true });
     created.push(".skaile/");
   }
-  const settingsPath = path18__default.join(skaileDir, "settings.json");
+  const settingsPath = path19__default.join(skaileDir, "settings.json");
   if (!existsSync22(settingsPath)) {
     writeFileSync7(settingsPath, "{}\n");
     created.push(".skaile/settings.json");
   }
-  const wsConfigPath = path18__default.join(resolved, "skaile.yaml");
+  const wsConfigPath = path19__default.join(resolved, "skaile.yaml");
   if (!existsSync22(wsConfigPath)) {
     writeFileSync7(wsConfigPath, stringify2(buildInitWorkspaceConfig(projectName, harness)));
     created.push("skaile.yaml");
   }
   for (const dir of new Set(Object.values(HARNESS_TARGETS2[harness].local))) {
-    const full = path18__default.join(resolved, dir);
+    const full = path19__default.join(resolved, dir);
     if (!existsSync22(full)) {
       mkdirSync5(full, { recursive: true });
       created.push(`${dir}/`);
@@ -12545,7 +12993,7 @@ function buildInitWorkspaceConfig(projectName, harness) {
 async function initGitScaffold(resolved, created) {
   const { execSync: execSync2 } = await import('child_process');
   const { existsSync: existsSync22, readFileSync: readFileSync13, writeFileSync: writeFileSync7 } = await import('fs');
-  const gitignorePath = path18__default.join(resolved, ".gitignore");
+  const gitignorePath = path19__default.join(resolved, ".gitignore");
   const entries = [
     "node_modules/",
     // Python bytecode a deployed skill script leaves inside `.claude/skills` and friends.
@@ -12589,7 +13037,7 @@ async function initGitScaffold(resolved, created) {
 `);
     if (!existing) created.push(".gitignore");
   }
-  if (!existsSync22(path18__default.join(resolved, ".git"))) {
+  if (!existsSync22(path19__default.join(resolved, ".git"))) {
     try {
       execSync2("git init", { cwd: resolved, stdio: "pipe" });
       created.push(".git/");
@@ -12619,7 +13067,7 @@ async function bootstrapUserConfig() {
 }
 async function hydrateInitSources(resolved, created) {
   try {
-    const { ensureSourcesCloned } = await import('../ensure-sources-UPTHZKGF.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) {
@@ -12635,7 +13083,7 @@ function printInitSummary(resolved, projectDir, created) {
   logOk(`Initialized project at ${S.heading(resolved)}`);
   console.log();
   console.log(S.heading("  Next steps:"));
-  const isCurrentDir = resolved === path18__default.resolve(".");
+  const isCurrentDir = resolved === path19__default.resolve(".");
   let step = 1;
   if (!isCurrentDir) {
     console.log(`  ${S.dim(`${step}.`)} ${S.cmd(`cd ${projectDir}`)}`);
@@ -12659,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-AGYB4PKR.js');
+  const { cmdSetup } = await import('../setup-IBDNJAOU.js');
   await cmdSetup([], { projectDir: process.cwd() });
 });
 program.addCommand(makeInstallCommand());
@@ -12667,6 +13115,7 @@ program.addCommand(makeCheckCommand());
 program.addCommand(makeCleanCommand());
 program.addCommand(makeCacheCommand());
 program.addCommand(makeConfigCommand());
+program.addCommand(makeHarnessCommand());
 program.addCommand(makeProvidersCommand());
 program.addCommand(makeMigrateCommand());
 program.addCommand(makeAddCommand());
@@ -12738,8 +13187,8 @@ program.hook("postAction", async (_thisCommand, actionCommand) => {
   if (!["add", "remove", "install", "update"].includes(actionCommand.name())) return;
   const opts = actionCommand.opts();
   if (opts.global || opts.dryRun) return;
-  const projectDir = path18__default.resolve(opts.projectDir ?? process.cwd());
-  const { refreshPluginSkills } = await import('../claude-code-VJGYBXQR.js');
+  const projectDir = path19__default.resolve(opts.projectDir ?? process.cwd());
+  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)`);
@@ -12757,6 +13206,20 @@ process.once("beforeExit", () => {
   logErr("The command ended before it finished (nothing left to wait for).");
   process.exit(1);
 });
+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;