@skaile/workspaces 6.8.1 → 6.9.1

package/dist/cli/index.js

@@ -1,71 +1,70 @@
 #!/usr/bin/env node
-import { status, enable, disable, install, uninstall } from '../chunk-JAGBPHXB.js';
-import { makeValidateCommand, scanIdentities } from '../chunk-7O2CR5SZ.js';
-import { storeNotInstallableReason, mcpNotRunnableHere } from '../chunk-62NNP7LU.js';
-import { checkHarnessSdk } from '../chunk-LZ3E6TML.js';
-import { makeProvidersCommand, loadRegistryView, addProviderEntry, ProviderRegistryWriteError, removeProviderEntry } from '../chunk-N65H7YYI.js';
-import { makeInstallCommand, makeCheckCommand, makeCleanCommand, pinComposedAgents, reportRewritten, reportReplaced, reportRelocked, reportMoved, reportStoreNotChecked, reportStoreNotCheckedForUpdates, globalProblems, editedConventionFiles, supportsInstallManifest, runYamlInstall, REF_HINT, reportInstalledSoftDeps } from '../chunk-YMO4ZDLC.js';
-import { reportUnknownHarnesses, reportProjectConfig, agentInstanceErrorLines } from '../chunk-E5AZA2FL.js';
-import { isRecord } from '../chunk-DFP476EU.js';
+import { status, enable, disable, install, uninstall } from '../chunk-X5SGUBUV.js';
+import { makeValidateCommand, scanIdentities } from '../chunk-WEPTGUR4.js';
+import { storeNotInstallableReason, mcpNotRunnableHere } from '../chunk-XB4XHGIE.js';
+import { checkHarnessSdk } from '../chunk-Q5SSRVD5.js';
+import { makeProvidersCommand, loadRegistryView, addProviderEntry, ProviderRegistryWriteError, removeProviderEntry } from '../chunk-IISEBVMA.js';
+import { makeInstallCommand, makeCheckCommand, makeCleanCommand, pinComposedAgents, reportRewritten, reportReplaced, reportRelocked, reportMoved, reportStoreNotChecked, reportStoreNotCheckedForUpdates, globalProblems, editedConventionFiles, supportsInstallManifest, runYamlInstall, REF_HINT, reportInstalledSoftDeps } from '../chunk-PLVM6OIV.js';
+import { reportUnknownHarnesses, reportProjectConfig, agentInstanceErrorLines, isRecord } from '../chunk-DJSGQW2Q.js';
 import { createSpinner } from '../chunk-NESV47MF.js';
-import { loadDeclaredPlugins } from '../chunk-QW5B3TEO.js';
-import { getStoreConfig, storeFetch, isStoreAuthenticated, getStoreToken } from '../chunk-BGATDUYX.js';
-import { makeSourceCommand, dropVanishedSourceRows, syncProjectSources, divergedSourceClones, uncachedSources } from '../chunk-I4DI5DAX.js';
-import { manifestEntryRootRefusals, manifestEntryFilesRefusals, 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, warnUntrackedAssetFiles, checkComposeKinds } from '../chunk-Z5EPCIB6.js';
-import { openCatalogSource, LocalCatalogDisabledError, openLibraryManager, openLibrary } from '../chunk-SVMIUCTT.js';
-import { getKindRegistry, getKnownKinds } from '../chunk-QCR5AE5E.js';
-import { AI_RESOURCES } from '../chunk-237BMOZW.js';
-import { logErr, unknownHarnessTargetMessage, S, logOk, setActiveCommand, 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-DXBHGNSI.js';
+import { loadDeclaredPlugins } from '../chunk-TMQFOJ6F.js';
+import { getStoreConfig, storeFetch, isStoreAuthenticated, getStoreToken } from '../chunk-J45JCYS4.js';
+import { makeSourceCommand, dropVanishedSourceRows, syncProjectSources, divergedSourceClones, uncachedSources } from '../chunk-FZTHL6SK.js';
+import { manifestEntryRootRefusals, manifestEntryFilesRefusals, libraryAssetRefusals, manifestEntryRenames, deviceLogin, loadStoreAuthConfig, logout, hasStoredAuth, exitOnLibrarySymlinks, resolveLibraryPublisherDetailed, getStoreIdentity, warnLibraryNameFallback, indexLibrary, warnIgnoredDomainFiles, removedDomainOption, rejectRemovedDomainOption, requireValidPublisherOrExit, exitOnManifestPublisherProblems, exitOnRootSkillLibrary, findAssetManifestFile, checkAssetFile, registerLibraryAsset, DOMAIN_REMOVED_HINT, reportLibrarySymlinks, checkAsset, rootLevelAssetFileProblem, assetEntryRef, manifestPublisherProblems, exitOnManifestPathProblems, exitOnRootSkillExtraAssets, manifestRequiresProblems, composeRefContext, registeredAssetKeys, duplicateAssetMessage, manifestParseFailureLine, manifestParseErrorText, unresolvedManifestDependencies, findEntryManifestFile, unheldRequiresOfFile, warnLegacyBundleFiles, warnUntrackedAssetFiles, checkComposeKinds } from '../chunk-ZUROGXJM.js';
+import { openCatalogSource, LocalCatalogDisabledError, openLibraryManager, openLibrary } from '../chunk-RZRJTCP2.js';
+import { getKindRegistry, getKnownKinds } from '../chunk-E675QKFG.js';
+import { AI_RESOURCES } from '../chunk-UWD7YBDR.js';
+import { logErr, unknownHarnessTargetMessage, S, logOk, setActiveCommand, 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-BLBXOG5Q.js';
 import { LocalSecretsProvider } from '../chunk-ILFGVSTJ.js';
-import { resolveInstanceAgentDir, instanceSessionOverrides, loadAgentManifest, manifestModelForHarness, runAgentChat, isCompositionError, resolveSessionId, loadSessionById, loadSession, listSessions, setCurrentSession, deleteSession, clearSession, hashAgentFiles, createCompositionContentSource, compileComposition, MarkdownStreamer, createFinalTextFallback, instanceForSession, resolveAgentInstance, describeComposition } from '../chunk-OLZE4IHX.js';
-import '../chunk-PKC2AHOB.js';
-import '../chunk-7RBFYW24.js';
-import '../chunk-N2W7OJC6.js';
-import '../chunk-BB5EJLKZ.js';
+import { resolveInstanceAgentDir, instanceSessionOverrides, modelForHarness, loadAgentManifest, manifestModelForHarness, runAgentChat, isCompositionError, resolveSessionId, loadSessionById, loadSession, listSessions, setCurrentSession, deleteSession, clearSession, hashAgentFiles, createCompositionContentSource, compileComposition, MarkdownStreamer, createFinalTextFallback, instanceForSession, resolveAgentInstance, describeComposition } from '../chunk-PBEDRYHP.js';
+import '../chunk-2UKNI2HJ.js';
+import '../chunk-EMSU6L7K.js';
+import '../chunk-S47KU4YB.js';
+import '../chunk-TUOHA6BM.js';
 import '../chunk-WYZXSJBK.js';
 import '../chunk-GTAHU4N4.js';
 import '../chunk-HQAPUPBE.js';
 import '../chunk-KW37WNXY.js';
 import '../chunk-3MWQKQUB.js';
-import '../chunk-REAF7ZFA.js';
+import '../chunk-QIV7H3GJ.js';
 import '../chunk-O7SG5PC2.js';
 import '../chunk-7QBNJTTQ.js';
 import '../chunk-O2SYFJWP.js';
-import '../chunk-HLAEYFUN.js';
+import '../chunk-U3FI4DVT.js';
 import '../chunk-32NA4TVC.js';
 import '../chunk-W3UDISS2.js';
-import '../chunk-CMXDFTA2.js';
-import { runFlow, resumeFlow } from '../chunk-EDKTS44C.js';
+import '../chunk-GYPPVANR.js';
+import { runFlow, resumeFlow } from '../chunk-SME3PK4L.js';
 import '../chunk-4R6DROGN.js';
 import { parseSkillRequirements, validateRequirements } from '../chunk-PTJTOPE5.js';
 import '../chunk-USSP43U3.js';
-import '../chunk-NAEXYRHR.js';
+import '../chunk-AQTAULXT.js';
 import '../chunk-BRPEW3UL.js';
-import '../chunk-SAL72A7T.js';
-import { checkHarnessModel, checkOmpListedModel, isUnlistedModel, checkModelSurface } from '../chunk-XIIIGLSL.js';
-import '../chunk-NW7Y5SNK.js';
-import '../chunk-6ZM5X2XW.js';
-import '../chunk-Y6LC5PEZ.js';
+import '../chunk-LMADWO4Q.js';
+import { checkHarnessModel, checkOmpListedModel, isUnlistedModel, checkModelSurface } from '../chunk-7UCPGQCW.js';
+import '../chunk-CPMLMNI5.js';
+import '../chunk-KVTV4LT2.js';
+import '../chunk-C324IAXI.js';
 import '../chunk-LOO5CB5M.js';
 import '../chunk-YEOG7CWQ.js';
-import '../chunk-SBNUXJ6E.js';
+import '../chunk-3AIEJSQR.js';
 import { findHarnessBinary, HARNESS_BINARIES } from '../chunk-WWSRIT3J.js';
-import '../chunk-I6XH46Q6.js';
+import '../chunk-RP3ML3QD.js';
 import '../chunk-5DE3DGVR.js';
 import '../chunk-7DN6JKP2.js';
-import '../chunk-ORXV3UB6.js';
-import { listHarnesses } from '../chunk-SILFO5RY.js';
+import '../chunk-5J6N6LHL.js';
+import { listHarnesses } from '../chunk-7TF5MNFK.js';
 import '../chunk-G5SUWZEU.js';
-import '../chunk-3HSLJAMJ.js';
+import '../chunk-LYVLDGML.js';
 import { getProviderPreset, AI_PROVIDER_PRESETS } from '../chunk-6UP2EDFN.js';
 import '../chunk-IFGTRL2I.js';
-import { loadFlow, flowLookupRoots, findFlowFileInRoots, loadAllFlowEntries } from '../chunk-WFK4MUBL.js';
+import { loadFlow, flowLookupRoots, findFlowFileInRoots, loadAllFlowEntries } from '../chunk-5J6JWGY4.js';
 import '../chunk-WD3L5QSU.js';
 import { nodeLabel, nodeSkillAsset, nodeIsInert, nodeIsOptional, nodeRunKind, nodeAssets } from '../chunk-7RGTAEG6.js';
 import '../chunk-7NN3P6VF.js';
-import { setLibraryAssetCheck, setRenamedEntryLookup, LibraryEntryError, AssetManager, parseRefTolerant, MissingManifestError, parseCanonicalLockKey, normalizeRepoUrl } from '../chunk-56PIAGD6.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-G44FFUMA.js';
-import { flowFileNameError, SEMVER_RE } from '../chunk-O5Y7VMVQ.js';
+import { setLibraryAssetCheck, setRenamedEntryLookup, LibraryEntryError, AssetManager, parseRefTolerant, MissingManifestError, parseCanonicalLockKey, normalizeRepoUrl } from '../chunk-VEIWFS7Z.js';
+import { CatalogHttpError, OfflineError, libraryDirMissing, missingLibraryDirMessage, cloneOrInitGitRepo, trackOriginBranch, stampManifestPublisher, isGitRepo, ensureGitRepo, conflictingAssetRoot, scanUnlistedAssets, setManifestPublisher, LIBRARY_OWNERSHIPS, assertManifestEditable, installLibraryAsset, getStoreManifestsDir, assertValidLibraryName, unparsableAssetFiles, missingRootAssets, syncManifestWithDisk, renamedLibraryName, storeManifestFile, getDefaultValue, isSecretPlaceholder } from '../chunk-GZL6RN4Z.js';
+import { flowFileNameError, SEMVER_RE } from '../chunk-5KWQMCH7.js';
 import '../chunk-OSABUEWA.js';
 import '../chunk-F3D25RGM.js';
 import '../chunk-3TXEJN4W.js';
@@ -73,19 +72,19 @@ import '../chunk-ISHJITXJ.js';
 import '../chunk-LNFKL23K.js';
 import '../chunk-JRN5QF4C.js';
 import '../chunk-NUELZWCF.js';
-import { installTargetOf, SCAFFOLD_KINDS } from '../chunk-KO3VSZQP.js';
+import { installTargetOf, SCAFFOLD_KINDS } from '../chunk-NDBHEOIA.js';
 import '../chunk-PKE3PXOK.js';
-import '../chunk-KTBKW2FI.js';
+import '../chunk-7QYBKUAS.js';
 import '../chunk-UQ6LFBPZ.js';
-import '../chunk-4CD2R4MJ.js';
-import { effectiveComposes, validatePreset, validateAgent, composeSlotDiagnostics, agentDeprecationDiagnostics, SLOT_ID_PATTERN } from '../chunk-VT6G5AJV.js';
-import { RUN_STATE_GITIGNORE_ENTRIES, LockParseError, loadSettings, globalSettingsPath, resolveSettings, projectSettingsPath, saveSettings, WorkspaceYamlEditor, readLock, resolveLibraryDir, checkAgentSkillConformance, resolveSettingsWithSources, resolveConfiguredHarnessName, FACTORY_SOURCE_URL, globalInstallDir, GLOBAL_INSTALL_DIR_NAME, workspaceProviderRegistryPath, userProviderRegistryPath, loadProviderRegistryFile, aiResourceRoots } from '../chunk-TMJBEGS4.js';
+import { CODEX_IDENTITY_DIR } from '../chunk-QBUJTVMY.js';
+import { effectiveComposes, validatePreset, validateAgent, composeSlotDiagnostics, agentDeprecationDiagnostics, SLOT_ID_PATTERN } from '../chunk-WS3BOCAT.js';
+import { LockParseError, loadSettings, globalSettingsPath, resolveSettings, projectSettingsPath, saveSettings, WorkspaceYamlEditor, readLock, resolveLibraryDir, checkAgentSkillConformance, resolveSettingsWithSources, resolveConfiguredHarnessName, FACTORY_SOURCE_URL, globalInstallDir, GLOBAL_INSTALL_DIR_NAME, workspaceProviderRegistryPath, userProviderRegistryPath, loadProviderRegistryFile, aiResourceRoots } from '../chunk-4KPQ6ILH.js';
 import '../chunk-4GY63JU6.js';
-import { factoryAssetRoots } from '../chunk-G7NMF5WQ.js';
-import { deployedDir } from '../chunk-5KRMNUL4.js';
+import { factoryAssetRoots } from '../chunk-4ROXSQEG.js';
+import { deployedPaths, deployedBase, deployedDir } from '../chunk-5KRMNUL4.js';
 import { DEFAULT_HARNESS_ID, HARNESS_DEFAULTS } from '../chunk-C5HFK34M.js';
 import { findKindDirs } from '../chunk-MWXYN6NY.js';
-import { SourceEntryError, LegacyKeyError, ConfigParseError, resolveSkWorkspaceConfig, unselectedInstanceIds, instanceChoiceText, sourceCacheKey, getGlobalCacheDir, resolveAgentDir, AgentRefResolutionError, resolveAgentDefinitionDir, effectiveAgentInstances, matchPin, coerceVersion, loadSkWorkspaceConfig, configParseErrorOf, findWorkspaceRoot, isWorkspaceConfigFilename, SKAILE_YAML_DEFAULT, AGENT_PROFILE_FIELDS } from '../chunk-O7ADRMCR.js';
+import { SourceEntryError, LegacyKeyError, ConfigParseError, resolveSkWorkspaceConfig, unselectedInstanceIds, instanceChoiceText, sourceCacheKey, getGlobalCacheDir, resolveAgentDir, AgentRefResolutionError, resolveAgentDefinitionDir, effectiveAgentInstances, isSameRemote, matchPin, coerceVersion, loadSkWorkspaceConfig, configParseErrorOf, findWorkspaceRoot, isWorkspaceConfigFilename, SKAILE_YAML_DEFAULT, AGENT_PROFILE_FIELDS } from '../chunk-FZO64PLQ.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-QC5BYUED.js';
@@ -94,7 +93,7 @@ import { pluginTitle } from '../chunk-RVRB27AN.js';
 import { parseAssetRef, isValidPublisher, PUBLISHER_HINT, isValidAssetName, ASSET_NAME_HINT, depToStr, assetRefToStr, slugifyAssetName, parseAssetRefLoose } from '../chunk-V5KG6CCV.js';
 import { portableSpawn, portableSpawnSync } from '../chunk-VSX2G7LA.js';
 import { parseModelRef, resolveEntryBaseUrl } from '../chunk-RXGPFAMN.js';
-import { openSqlite } from '../chunk-SGI5MRKP.js';
+import { RUN_STATE_GITIGNORE_ENTRIES, openSqlite } from '../chunk-MDCI4RSG.js';
 import '../chunk-C3CAXQMA.js';
 import { registerLogStore, LogStore, StdoutSink } from '../chunk-BOFL7GIF.js';
 import '../chunk-NSBPE2FW.js';
@@ -241,7 +240,7 @@ async function runSearch(kind, query, opts) {
   }
 }
 async function searchIndex(query, kind, projectDir) {
-  const { openLibrary: openLibrary2 } = await import('../open-library-Q7QZJY5D.js');
+  const { openLibrary: openLibrary2 } = await import('../open-library-3HMXYGUF.js');
   const library = await openLibrary2();
   try {
     const { libraryDirMissing: libraryDirMissing2 } = await import('../library/index.js');
@@ -417,14 +416,14 @@ async function withAddVersions(entries, projectDir) {
 }
 async function searchLocal(query, kind, opts, showStore, airGapped) {
   const projectDir = path19__default.resolve(opts.projectDir);
-  const { restoreSourceReaders } = await import('../source-DG5IAAGZ.js');
+  const { restoreSourceReaders } = await import('../source-URRPRGMZ.js');
   for (const name of await restoreSourceReaders(projectDir)) {
     logInfo(`Re-registered source "${name}" (its library entry was removed elsewhere).`);
   }
   const factory = await searchFactory(projectDir, query, kind);
   let entries = unionEntries(await searchIndex(query, kind, projectDir), factory);
   if (entries.length === 0 && !query && !kind && !airGapped) {
-    const { autoSyncForSearch } = await import('../source-DG5IAAGZ.js');
+    const { autoSyncForSearch } = await import('../source-URRPRGMZ.js');
     if (await autoSyncForSearch(projectDir)) {
       entries = unionEntries(await searchIndex(query, kind, projectDir), factory);
     }
@@ -478,7 +477,9 @@ function layoutLocalTable(rows, width, style = {}) {
     }
     return { ruleWidth: nameW + gap + descW + tailSpan, lines };
   }
-  if (indent + nameW + tailSpan <= width) {
+  const stackedW = width - (indent + 2) - tailSpan;
+  const stackable = stackedW >= MIN_LOCAL_DESCRIPTION_WIDTH && rows.some((r) => r.description !== "");
+  if (!stackable && indent + nameW + tailSpan <= width) {
     for (const r of rows) {
       lines.push(tailSpan > 0 ? `${pad}${refCell(r.ref)}${tail(r)}` : `${pad}${styleRef(r.ref)}`);
     }
@@ -542,7 +543,7 @@ async function searchStore(query, kind, opts, airGapped) {
     logInfo("air-gapped (cache_ttl: 0) \u2014 local sources only");
     return "skipped";
   }
-  const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-Q7QZJY5D.js');
+  const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-3HMXYGUF.js');
   try {
     const remote = await openCatalogSource2({ projectDir: path19__default.resolve(opts.projectDir) });
     const assets = await remote.listAssets(kind ? { kind } : {});
@@ -828,13 +829,29 @@ function makeAddCommand() {
     }
   });
 }
+function globalDeployedFiles(component, name, harness) {
+  const paths = deployedPaths(component, name, harness, true);
+  if (component === "agent" && harness === "codex") {
+    paths.push(
+      path19__default.join(
+        path19__default.dirname(deployedBase(component, harness, true)),
+        CODEX_IDENTITY_DIR,
+        `${name}.md`
+      )
+    );
+  }
+  return paths.filter((p6) => existsSync(p6));
+}
 function reportGlobalPaths(am2, assets) {
+  const harnesses = am2.deployTargets();
+  logInfo(S.dim(`harnesses: ${harnesses.join(", ")}`));
   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(), "~")}`));
+    for (const harness of harnesses) {
+      for (const file of globalDeployedFiles(component, name, harness)) {
+        logInfo(S.dim(`${harness}: ${file.replace(homedir(), "~")}`));
+      }
     }
   }
 }
@@ -1135,7 +1152,7 @@ async function resolveInfoEntry(am2, ref, opts) {
     return { entry: match ?? deployed, deployed: true };
   }
   const lookup = opts.storeLookup ?? (async (filter) => {
-    const { resolveCatalogSource } = await import('../open-library-Q7QZJY5D.js');
+    const { resolveCatalogSource } = await import('../open-library-3HMXYGUF.js');
     const { source, close } = await resolveCatalogSource({ projectDir: opts.projectDir });
     try {
       return await source.listAssets(filter);
@@ -1151,7 +1168,7 @@ async function resolveInfoEntry(am2, ref, opts) {
     );
     return { entry: hit ? catalogAssetToEntry(hit) : null };
   } catch (err) {
-    const { LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-Q7QZJY5D.js');
+    const { LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-3HMXYGUF.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 } : {} };
@@ -1477,6 +1494,7 @@ function makeAssetCommand() {
           process.exit(1);
         }
         exitOnManifestPublisherProblems(target.path, target.name);
+        exitOnRootSkillLibrary(target.path, target.name);
         if (reportLibrarySymlinks(src.dir, { rootIsAsset: true }) > 0) {
           logErr(
             `Not imported: ${src.dir} holds symlinks (listed above). Replace each with a copy of what it points at, or remove it, and run the import again.`
@@ -1867,7 +1885,7 @@ function makeCatalogCommand() {
     if (cfg.catalog.cache_ttl === 0 && !opts.force) {
       logOk(`Catalog mode: air-gapped (${S.heading(baseUrl)})`);
       logInfo(
-        "Network probe skipped because cache_ttl is 0. Use `skaile update` to refresh the cache, or `skaile catalog test --force` to probe anyway."
+        "Network probe skipped because cache_ttl is 0. Use `skaile update --catalog-only` to refresh the cache, or `skaile catalog test --force` to probe anyway."
       );
       return;
     }
@@ -1888,7 +1906,7 @@ function makeCatalogCommand() {
   return catalog;
 }
 async function runLocalCatalogTest(projectDir) {
-  const { resolveCatalogSource } = await import('../open-library-Q7QZJY5D.js');
+  const { resolveCatalogSource } = await import('../open-library-3HMXYGUF.js');
   let resolved;
   try {
     resolved = await resolveCatalogSource({ projectDir });
@@ -2064,7 +2082,7 @@ async function scanLibraryFlowEntries() {
     const { LocalIndex, resolveIndexPath, scanAuthoringLibraries } = await import('../library/index.js');
     const indexPath = resolveIndexPath();
     if (!existsSync(indexPath)) return entries;
-    const { getKindRegistry: getKindRegistry2 } = await import('../open-registry-RZW2AFD6.js');
+    const { getKindRegistry: getKindRegistry2 } = await import('../open-registry-BHBHQMBA.js');
     const index = new LocalIndex({ indexPath });
     try {
       for (const { library, assets } of await scanAuthoringLibraries(index, getKindRegistry2())) {
@@ -2730,6 +2748,19 @@ function makeConnectCommand() {
     await client.disconnect();
   });
 }
+
+// cli/src/group-help.ts
+function helpOnBareGroup(group) {
+  group.allowExcessArguments(true);
+  group.action(() => {
+    if (group.args.length > 0) {
+      group.unknownCommand();
+    }
+    group.help();
+  });
+}
+
+// cli/src/commands/connector.ts
 function parsePositiveIntOption(value) {
   const n = Number.parseInt(value, 10);
   if (!Number.isFinite(n) || n <= 0) {
@@ -3108,7 +3139,7 @@ ${installResult.output.trim() || "the package manager gave no output"}`
       await manager.disconnectAll();
     }
   });
-  cmd.action(() => cmd.help());
+  helpOnBareGroup(cmd);
   return cmd;
 }
 async function runDebugQuery(query, parentOpts, args) {
@@ -3237,7 +3268,7 @@ async function ensureTargetsRegistered(projectDir) {
   const { resolveSkWorkspaceConfig: resolveSkWorkspaceConfig2 } = await import('../core/index.js');
   const config = resolveSkWorkspaceConfig2(projectDir);
   if (config.plugins && config.plugins.length > 0) {
-    const { ensurePluginsLoaded } = await import('../plugin-store-OJTERUEZ.js');
+    const { ensurePluginsLoaded } = await import('../plugin-store-XQP2CRYH.js');
     const result = await ensurePluginsLoaded(projectDir, config.plugins, pluginRegistry);
     for (const f of result.failed) logWarn(f.error);
   }
@@ -3358,7 +3389,7 @@ function makeDeployCommand() {
   cmd.command("down").description("Tear down the active deploy and clear its handle").option("--project-dir <path>", "Project directory", process.cwd()).action(action(runDown));
   cmd.command("status").description("Show the active deploy's state, ws URL, and health").option("--project-dir <path>", "Project directory", process.cwd()).action(action(runStatus));
   cmd.command("logs").description("Stream logs from the active deploy (if the target supports it)").option("--project-dir <path>", "Project directory", process.cwd()).option("--follow", "Keep streaming new log lines").action(action(runLogs));
-  cmd.action(() => cmd.help());
+  helpOnBareGroup(cmd);
   return cmd;
 }
 var DIFF_SHOWS = { content: true, modified: true, incomplete: true };
@@ -3500,7 +3531,7 @@ function makeFlowCommand() {
     }
     console.log();
   });
-  cmd.action(() => cmd.help());
+  helpOnBareGroup(cmd);
   return cmd;
 }
 var HARNESS_ID_OF_TARGET = {
@@ -3522,7 +3553,7 @@ function makeHarnessCommand() {
   ).action(async (name, opts) => {
     await runHarnessSet(name, path19__default.resolve(opts.projectDir), opts);
   });
-  cmd.action(() => cmd.help());
+  helpOnBareGroup(cmd);
   return cmd;
 }
 async function runHarnessSet(name, projectDir, opts) {
@@ -3557,13 +3588,42 @@ async function runHarnessSet(name, projectDir, opts) {
       `model ${profile.model} is kept. Check it fits ${target}: skaile run "hi there" --dry-run`
     );
   }
+  const renderedBefore = rememberRenderedHashes(
+    projectDir,
+    new AssetManager({ registry: getKindRegistry(), projectDir }).lockedRenderedHashes()
+  );
   logInfo(`Installing for ${target} (${HARNESS_TARGETS[target].local.skill})`);
   await runYamlInstall({ projectDir });
-  if (opts.clean) removeOldHarnessCopies(projectDir);
+  if (opts.clean) {
+    removeOldHarnessCopies(projectDir, renderedBefore);
+    rmSync(switchHashesFile(projectDir), { force: true });
+  }
+}
+function switchHashesFile(projectDir) {
+  return path19__default.join(projectDir, ".skaile", "harness-switch-hashes.json");
 }
-function removeOldHarnessCopies(projectDir) {
+function rememberRenderedHashes(projectDir, current) {
+  const file = switchHashesFile(projectDir);
+  const merged = /* @__PURE__ */ new Map();
+  try {
+    const kept = JSON.parse(readFileSync(file, "utf-8"));
+    for (const [p6, sha] of Object.entries(kept)) if (typeof sha === "string") merged.set(p6, sha);
+  } catch {
+  }
+  for (const [p6, sha] of current) merged.set(p6, sha);
+  if (merged.size > 0) {
+    try {
+      mkdirSync(path19__default.dirname(file), { recursive: true });
+      writeFileSync(file, `${JSON.stringify(Object.fromEntries(merged), null, 2)}
+`);
+    } catch {
+    }
+  }
+  return merged;
+}
+function removeOldHarnessCopies(projectDir, renderedBefore) {
   const am2 = new AssetManager({ registry: getKindRegistry(), projectDir });
-  const stale = am2.listStaleHarnessCopies();
+  const stale = am2.listStaleHarnessCopies({ renderedBefore });
   if (stale.length === 0) {
     logInfo("No old harness copies to remove.");
     return;
@@ -3579,7 +3639,7 @@ function removeOldHarnessCopies(projectDir) {
   }
   if (foreign.length > 0) {
     logWarn(
-      `Kept ${foreign.length} cop${foreign.length === 1 ? "y" : "ies"} skaile did not write (the bytes differ from the new harness's copy, or it is not in the lock): ${rel(foreign)}. Delete ${foreign.length === 1 ? "it" : "them"} by hand if you do not need ${foreign.length === 1 ? "it" : "them"}.`
+      `Kept ${foreign.length} cop${foreign.length === 1 ? "y" : "ies"} skaile did not write (the bytes differ from the new harness's copy or, for an agent file, from what the lock recorded, or it is not in the lock): ${rel(foreign)}. Delete ${foreign.length === 1 ? "it" : "them"} by hand if you do not need ${foreign.length === 1 ? "it" : "them"}.`
     );
   }
 }
@@ -4338,7 +4398,7 @@ function makeIntegrationCommand() {
     }
     process.exit(0);
   });
-  cmd.action(() => cmd.help());
+  helpOnBareGroup(cmd);
   return cmd;
 }
 function exitOnSyncError(err) {
@@ -4368,6 +4428,7 @@ async function reindexLibrary(lib, library, name) {
   exitOnManifestPublisherProblems(lib.path, name);
   exitOnLibrarySymlinks(lib.path, `skaile library index ${name}`);
   exitOnManifestPathProblems(lib.path, `skaile library index ${name}`);
+  exitOnRootSkillExtraAssets(lib.path, `skaile library index ${name}`);
   const badRequires = manifestRequiresProblems(lib.path);
   const resolved = resolveLibraryPublisherDetailed(lib, {}, getStoreIdentity());
   warnLibraryNameFallback(name, resolved);
@@ -4567,7 +4628,7 @@ function refuseDeployFolder(dir, force = false) {
   );
   process.exit(1);
 }
-async function refuseUnusableLibraryDir(dir, force = false) {
+async function refuseUnusableLibraryDir(dir, force = false, ownership = "owner") {
   const deployed = DEPLOYED_COPY_DIRS.filter((d) => {
     const full = path19.join(dir, d);
     return fs8.existsSync(full) && fs8.statSync(full).isDirectory() && fs8.readdirSync(full).length > 0;
@@ -4588,6 +4649,31 @@ async function refuseUnusableLibraryDir(dir, force = false) {
     );
     process.exit(1);
   }
+  const rootFile = rootLevelAssetFileProblem(dir);
+  if (rootFile) {
+    logErr(rootFile);
+    process.exit(1);
+  }
+  const manifest = loadSkPublishManifest(dir);
+  const missing = manifest ? missingRootAssets(dir, manifest) : [];
+  if (manifest && missing.length > 0) {
+    const report = ownership === "reader" ? logWarn : logErr;
+    for (const a of missing) {
+      report(
+        `${SKAILE_MANIFEST_FILENAME} [assets] \u2014 ${assetEntryRef(a, manifest)}: root "${a.root}" does not exist.`
+      );
+    }
+    if (ownership === "reader") {
+      logWarn(
+        `Ask the owner to push the folder(s) or drop the entry from ${SKAILE_MANIFEST_FILENAME}, then run \`skaile library pull <name>\`; \`add\` of those assets fails until then.`
+      );
+      return;
+    }
+    logErr(
+      `Restore the folder(s) or drop the entry from ${SKAILE_MANIFEST_FILENAME}, then run \`skaile library init\` again; nothing was registered.`
+    );
+    process.exit(1);
+  }
 }
 async function assertLibraryPathFree(manager, dir, exceptId) {
   const clash = (await manager.listLibraries()).find(
@@ -4736,7 +4822,7 @@ function readOriginTracking(dir) {
   });
   return { url, branch: head.status === 0 && head.stdout.trim() || "main" };
 }
-function exitOnCloneWithoutCheckout(dir, name) {
+function exitOnCloneWithoutCheckout(dir, name, fresh) {
   const head = spawnSync("git", ["rev-parse", "--verify", "-q", "HEAD"], {
     cwd: dir,
     encoding: "utf-8"
@@ -4748,6 +4834,17 @@ function exitOnCloneWithoutCheckout(dir, name) {
   });
   const branches = (refs.stdout ?? "").split("\n").map((ref) => ref.trim().replace(/^refs\/remotes\/origin\//, "")).filter((branch) => branch !== "" && branch !== "HEAD" && !branch.startsWith("refs/"));
   if (branches.length === 0) return;
+  if (fresh) {
+    if (fresh.existed) fs8.rmSync(path19.join(dir, ".git"), { recursive: true, force: true });
+    else {
+      fs8.rmSync(dir, { recursive: true, force: true });
+      pruneEmptyLibraryParents(dir);
+    }
+    logErr(
+      `${fresh.url}: its remote HEAD names a branch that does not exist (remote branches: ${branches.join(", ")}); nothing was cloned or registered. Clone the branch you want, then adopt it: \`git clone --branch ${branches[0]} ${fresh.url} ${dir}\` and \`skaile library init ${name} --path ${dir}\`.`
+    );
+    process.exit(1);
+  }
   logErr(
     `${dir} is a git clone with no branch checked out (its remote HEAD names a branch that does not exist): run \`git -C ${dir} checkout ${branches[0]}\` (remote branches: ${branches.join(", ")}), then re-run \`skaile library init ${name} --path ${dir}\`.`
   );
@@ -4799,7 +4896,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-WJVCT2IK.js');
+  const { isGithubRemote, notGithubRemoteMessage } = await import('../library-publish-AZTYRASL.js');
   if (!isGithubRemote(url)) logWarn(notGithubRemoteMessage(name, url));
 }
 function scaffoldLibraryFiles(dir, name) {
@@ -4838,6 +4935,7 @@ by the same ref.
   }
   return written;
 }
+var GIT_IDENTITY_FIX = 'Set it with `git config --global user.name "<name>"` and `git config --global user.email "<email>"`.';
 function commitScaffold(dir, files) {
   const run2 = (args) => spawnSync("git", args, { cwd: dir, encoding: "utf-8" });
   const add = run2(["add", "--", ...files]);
@@ -4847,11 +4945,10 @@ function commitScaffold(dir, files) {
   return (commit.stderr.trim() || commit.stdout.trim()).split("\n")[0] || "git commit failed";
 }
 async function refuseRemoteOfSource(manager, url) {
-  const key = sourceCacheKey(url);
   const libraries = await manager.listLibraries();
   const cacheRoot = path19.resolve(getGlobalCacheDir()) + path19.sep;
   const clash = libraries.find(
-    (l) => path19.resolve(l.path).startsWith(cacheRoot) && "url" in l.backendConfig && sourceCacheKey(l.backendConfig.url) === key
+    (l) => path19.resolve(l.path).startsWith(cacheRoot) && "url" in l.backendConfig && isSameRemote(l.backendConfig.url, url)
   );
   if (!clash) return;
   logErr(
@@ -4989,7 +5086,7 @@ function makeLibraryCommand() {
         await refuseNestedLibraryPath(manager, libPath);
         if (fs8.existsSync(libPath)) {
           exitOnLibrarySymlinks(libPath, `skaile library init ${name} --path ${libPath}`);
-          await refuseUnusableLibraryDir(libPath, opts.force);
+          await refuseUnusableLibraryDir(libPath, opts.force, ownership);
         } else {
           refuseDeployFolder(libPath, opts.force);
         }
@@ -4997,7 +5094,9 @@ function makeLibraryCommand() {
         let backend = "local";
         let backendConfig;
         if (opts.git) {
-          const { branch, reason } = cloneOrInitGitRepo(libPath, opts.git, "main");
+          const existed = fs8.existsSync(libPath);
+          const { branch, reason, cloned } = cloneOrInitGitRepo(libPath, opts.git, "main");
+          if (cloned) exitOnCloneWithoutCheckout(libPath, name, { url: opts.git, existed });
           if (reason) {
             logWarn(
               `Could not clone ${opts.git}; initialised an empty repo with that origin instead. git said: ${reason}`
@@ -5005,7 +5104,7 @@ function makeLibraryCommand() {
           }
           await warnIfNotGithubRemote(name, opts.git);
           trackOriginBranch(libPath, branch);
-          await refuseUnusableLibraryDir(libPath, opts.force);
+          await refuseUnusableLibraryDir(libPath, opts.force, ownership);
           backend = "git";
           backendConfig = { url: opts.git, branch, authHint: "ssh" };
         } else if (adopted) {
@@ -5029,7 +5128,7 @@ function makeLibraryCommand() {
           `Library "${name}" ${blank ? "created" : "registered"} at ${libPath}${isDefault ? " (default)" : ""}`
         );
         if (scaffolded.length > 0) logInfo(`Scaffolded ${scaffolded.join(", ")}.`);
-        if (scaffolded.length > 0 && opts.git) {
+        if (scaffolded.length > 0 && (opts.git || adopted)) {
           const failure = commitScaffold(libPath, scaffolded);
           if (failure) {
             logWarn(
@@ -5176,6 +5275,7 @@ function makeLibraryCommand() {
         const target = await resolveTargetLibrary(manager, opts.library);
         assertManifestEditableOrExit(target.path);
         exitOnManifestPublisherProblems(target.path, target.name);
+        exitOnRootSkillLibrary(target.path, target.name);
         const effectiveKind = opts.kind ?? kind;
         const am2 = new AssetManager({ registry: getKindRegistry(), projectDir: process.cwd() });
         const libRoot = path19.resolve(target.path);
@@ -5408,6 +5508,7 @@ function makeLibraryCommand() {
       }
       await manager.updateLibrary(name, patch);
       logOk(`Updated ${name}.${field}`);
+      if (field === "backendConfig.url") await warnIfNotGithubRemote(name, value);
       if (field === "path") {
         logInfo(`Run \`skaile library index ${name}\` to re-index its assets from the new path.`);
       }
@@ -5565,13 +5666,24 @@ function makeLibraryCommand() {
       }
       const r = spawnSync("git", ["commit", "-m", opts.message], {
         cwd: lib.path,
-        stdio: "inherit"
+        encoding: "utf-8"
       });
+      const gitOutput = `${r.stdout ?? ""}${r.stderr ?? ""}`;
       if (r.status !== 0) {
-        logErr("git commit failed.");
+        const noIdentity = /tell me who you are|unable to auto-detect|empty ident name/i.test(
+          gitOutput
+        );
+        logErr(
+          noIdentity ? `git commit failed: no git identity is configured. ${GIT_IDENTITY_FIX}` : `git commit failed${gitOutput.trim() ? `: ${gitOutput.trim().split("\n")[0]}` : "."}`
+        );
         process.exit(1);
       }
       logOk(`Committed in ${name}.`);
+      if (/configured automatically/i.test(gitOutput)) {
+        logWarn(
+          `No git identity is configured, so git guessed one for this commit. ${GIT_IDENTITY_FIX} \`git -C ${lib.path} commit --amend --reset-author\` fixes this commit.`
+        );
+      }
     } finally {
       close();
     }
@@ -5602,16 +5714,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-WJVCT2IK.js');
+      const { runLibraryPublish } = await import('../library-publish-AZTYRASL.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-WJVCT2IK.js');
+    const { runLibraryRegister } = await import('../library-publish-AZTYRASL.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-WJVCT2IK.js');
+    const { runLibraryYank } = await import('../library-publish-AZTYRASL.js');
     await withStoreErrorHandling(() => runLibraryYank(lib, opts));
   });
   return cmd;
@@ -6271,7 +6383,7 @@ function scheduleSoftDepPreview() {
 }
 async function loadAssets() {
   softDepPreviewCache.clear();
-  const { gatherAssetFeeds } = await import('../asset-feeds-R75MH2WW.js');
+  const { gatherAssetFeeds } = await import('../asset-feeds-PANNQPEE.js');
   const { entries, notes } = await gatherAssetFeeds(am, am.projectDir);
   if (notes.length > 0) {
     state.message = notes.map((n) => `[${n.feed}] ${n.message}`).join(" \u2022 ");
@@ -6475,7 +6587,7 @@ function reconcileCollapsedSets(rows) {
 async function loadSourcesAndLibraries() {
   try {
     const [{ openLibraryManager: openLibraryManager2 }, { getGlobalCacheDir: getGlobalCacheDir2, globalSkaileDir: globalSkaileDir2 }] = await Promise.all([
-      import('../open-library-Q7QZJY5D.js'),
+      import('../open-library-3HMXYGUF.js'),
       import('../core/index.js')
     ]);
     const { manager, library, close } = await openLibraryManager2();
@@ -9419,8 +9531,8 @@ function makeNpxCommand() {
       process.exit(1);
     }
   });
-  npx.action(() => npx.help());
-  skills.action(() => skills.help());
+  helpOnBareGroup(npx);
+  helpOnBareGroup(skills);
   return npx;
 }
 function resolvePublisher(clonePath, url) {
@@ -9605,7 +9717,7 @@ function makePatchCommand() {
     am2.patchRemove(ref);
     logOk(`Patch removed for ${ref}`);
   });
-  cmd.action(() => cmd.help());
+  helpOnBareGroup(cmd);
   return cmd;
 }
 function action2(fn) {
@@ -9613,14 +9725,14 @@ function action2(fn) {
     try {
       await fn(...args);
     } catch (err) {
-      const { condensePluginFailure } = await import('../plugin-store-OJTERUEZ.js');
+      const { condensePluginFailure } = await import('../plugin-store-XQP2CRYH.js');
       logErr(condensePluginFailure(err instanceof Error ? err.message : String(err)));
       process.exitCode = 1;
     }
   };
 }
 async function reconcileAndReport(projectDir, plugins, opts = {}) {
-  const { reconcilePlugins } = await import('../plugin-store-OJTERUEZ.js');
+  const { reconcilePlugins } = await import('../plugin-store-XQP2CRYH.js');
   if (plugins.length === 0) {
     logInfo("No plugins declared \u2014 nothing to reconcile.");
     return;
@@ -9631,14 +9743,14 @@ async function reconcileAndReport(projectDir, plugins, opts = {}) {
     else logInfo(`Plugin store ${result.reason}.`);
   } catch (err) {
     if (opts.strict) throw err;
-    const { condensePluginFailure } = await import('../plugin-store-OJTERUEZ.js');
+    const { condensePluginFailure } = await import('../plugin-store-XQP2CRYH.js');
     logWarn(
       `reconcile skipped: ${condensePluginFailure(err instanceof Error ? err.message : String(err))}`
     );
   }
 }
 async function verifyPluginLoads(projectDir, spec, declared) {
-  const { loadPlugins } = await import('../plugin-store-OJTERUEZ.js');
+  const { loadPlugins } = await import('../plugin-store-XQP2CRYH.js');
   const { createPluginRegistry } = await import('../plugin-registry/index.js');
   const registry = createPluginRegistry();
   await loadPlugins(
@@ -9661,7 +9773,7 @@ async function runInstall2(typedSpec, opts) {
   const rawSpec = typedSpec.trim();
   const projectDir = path19__default.resolve(opts.projectDir);
   const { WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-  const { specName, rollbackPluginStore, npmSpecError, projectRelativeFileSpec } = await import('../plugin-store-OJTERUEZ.js');
+  const { specName, rollbackPluginStore, npmSpecError, projectRelativeFileSpec } = await import('../plugin-store-XQP2CRYH.js');
   const specError = npmSpecError(rawSpec);
   if (specError) throw new Error(specError);
   const spec = projectRelativeFileSpec(rawSpec, process.cwd(), projectDir);
@@ -9698,7 +9810,7 @@ async function runInstall2(typedSpec, opts) {
 async function runRemove(name, opts) {
   const projectDir = path19__default.resolve(opts.projectDir);
   const { WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-  const { specName } = await import('../plugin-store-OJTERUEZ.js');
+  const { specName } = await import('../plugin-store-XQP2CRYH.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}.`);
@@ -9714,7 +9826,7 @@ async function runRemove(name, opts) {
   logOk(`Removed ${S.cmd(name)} from skaile.yaml plugins`);
   const remaining = editor.getPlugins();
   if (remaining.length === 0) {
-    const { rollbackPluginStore } = await import('../plugin-store-OJTERUEZ.js');
+    const { rollbackPluginStore } = await import('../plugin-store-XQP2CRYH.js');
     await rollbackPluginStore(projectDir, []);
     logInfo("No plugins declared; removed .skaile/plugins/.");
     return;
@@ -9737,7 +9849,7 @@ async function runList(opts) {
   const registry = createPluginRegistry();
   if (declared.length > 0) {
     try {
-      const { loadPlugins } = await import('../plugin-store-OJTERUEZ.js');
+      const { loadPlugins } = await import('../plugin-store-XQP2CRYH.js');
       const result = await loadPlugins(projectDir, declared, registry);
       for (const f of result.failed) logWarn(f.error);
     } catch (err) {
@@ -9768,7 +9880,7 @@ function makePluginCommand() {
   cmd.command("install <spec>").description("Add a plugin spec to skaile.yaml plugins and reconcile the store").option("--project-dir <path>", "Project directory", process.cwd()).action(action2(runInstall2));
   cmd.command("remove <name>").description("Remove a plugin (by package name) from skaile.yaml plugins and reconcile").option("--project-dir <path>", "Project directory", process.cwd()).action(action2(runRemove));
   cmd.command("list").description("List declared plugins and the targets they contribute").option("--project-dir <path>", "Project directory", process.cwd()).action(action2(runList));
-  cmd.action(() => cmd.help());
+  helpOnBareGroup(cmd);
   return cmd;
 }
 
@@ -10984,7 +11096,7 @@ function makeRunCommand() {
       try {
         const agentDir = instanceId2 ? resolveInstanceAgentDir(projectDir, resolveSkWorkspaceConfig(projectDir), instanceId2) : resolveSingleShotAgentDir(projectDir, agentDefinition);
         const overrides = instanceId2 ? instanceSessionOverrides(resolveSkWorkspaceConfig(projectDir), instanceId2) : {};
-        const instanceModel = opts.model ? void 0 : overrides.model;
+        const instanceModel = opts.model ? void 0 : modelForHarness(overrides.model, harness);
         const sessionModel = instanceModel ?? config.model;
         if (dryRun) {
           const problem = await printCompositionDryRun(
@@ -11104,6 +11216,19 @@ function makeResumeCommand() {
       else console.log(`  ${S.dim("Run")} ${S.cmd("skaile run <flow-id>")} ${S.dim("first.")}`);
       process.exit(1);
     }
+    const preflightLines = async () => {
+      const settings = await resolveSettings(projectDir, {
+        harness: session.harness,
+        model: session.model
+      });
+      return preflightHarness({
+        projectDir,
+        harness: settings.harness ?? DEFAULT_HARNESS_ID,
+        model: settings.model,
+        roles: settings.roles
+      });
+    };
+    if (!dryRun && reportPreflight(await preflightLines())) process.exit(1);
     console.log();
     console.log(
       `  ${S.label("Resuming:")} ${S.heading(session.flowId)}${session.label ? S.dim(` \u2014 ${session.label}`) : ""}`
@@ -11123,6 +11248,7 @@ function makeResumeCommand() {
       logErr(friendly ?? (err instanceof Error ? err.message : String(err)));
       process.exit(1);
     }
+    if (dryRun && reportPreflight(await preflightLines())) process.exitCode = 1;
   });
   return cmd;
 }
@@ -11223,7 +11349,10 @@ function makeReplCommand() {
     let effectiveModel = effective.model;
     if (!opts.model && instanceId2) {
       try {
-        effectiveModel = instanceSessionOverrides(resolveSkWorkspaceConfig(projectDir), instanceId2).model ?? effectiveModel;
+        effectiveModel = modelForHarness(
+          instanceSessionOverrides(resolveSkWorkspaceConfig(projectDir), instanceId2).model,
+          effective.harness ?? DEFAULT_HARNESS_ID
+        ) ?? effectiveModel;
       } catch {
       }
     }
@@ -11262,14 +11391,15 @@ function valueNotFlag(flag) {
 function parseProviderIds(raw) {
   return (raw ?? "").split(",").map((id) => id.trim()).filter((id) => id.length > 0);
 }
-function parseModelEndpointFlag(raw) {
-  if (raw === void 0) return void 0;
-  if (raw === true) return { enabled: true };
+function parseModelEndpointFlag(raw, agent) {
+  const agentOverride = agent === true ? { agent: true } : {};
+  if (raw === void 0) return agent === true ? { enabled: true, ...agentOverride } : void 0;
+  if (raw === true) return { enabled: true, ...agentOverride };
   const port = Number(raw);
   if (raw === false || !/^\d+$/.test(raw) || port > 65535) {
     throw new Error(`--model-endpoint: invalid port '${String(raw)}'`);
   }
-  return { enabled: true, port };
+  return { enabled: true, port, ...agentOverride };
 }
 function parsePortOption(raw) {
   const port = Number(raw);
@@ -11337,6 +11467,9 @@ function makeServeCommand() {
   ).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)"
+  ).option(
+    "--model-endpoint-agent",
+    "Also offer the running agent as the model `skaile-agent` on the model endpoint (implies --model-endpoint)"
   ).option("--compile-test", "Build a compiled binary and run it (simulates Docker environment)").option(
     "--with-codex",
     "Include the Codex harness in the compiled binary (used with --compile-test)"
@@ -11367,7 +11500,7 @@ function makeServeCommand() {
         process.exitCode = 1;
         return;
       }
-      const dirProblem = (await import('../serve-preflight-24YWWYUG.js')).checkServeProjectDir(
+      const dirProblem = (await import('../serve-preflight-NHZOKHIC.js')).checkServeProjectDir(
         opts.projectDir
       );
       if (dirProblem) {
@@ -11396,7 +11529,7 @@ function makeServeCommand() {
       }
       let providers = parseProviderIds(opts.providers);
       if (!managedCodex) {
-        const { resolveServeProvider } = await import('../serve-preflight-24YWWYUG.js');
+        const { resolveServeProvider } = await import('../serve-preflight-NHZOKHIC.js');
         const picked = resolveServeProvider(opts.projectDir, opts.provider, providers);
         if ("problem" in picked) {
           logErr(picked.problem);
@@ -11405,10 +11538,10 @@ function makeServeCommand() {
         }
         providers = [...picked.providers];
       }
-      const modelEndpoint = parseModelEndpointFlag(opts.modelEndpoint);
-      const { checkHarnessSdk: checkHarnessSdk2, checkModelEndpointPeer, checkServeModel } = await import('../serve-preflight-24YWWYUG.js');
-      const { checkServeHarness, checkServeAgents } = await import('../serve-preflight-24YWWYUG.js');
-      const startProblem = managedCodex ? null : await checkServeHarness(opts.projectDir, opts.harness) ?? checkServeAgents(opts.projectDir);
+      const modelEndpoint = parseModelEndpointFlag(opts.modelEndpoint, opts.modelEndpointAgent);
+      const { checkHarnessSdk: checkHarnessSdk2, checkModelEndpointPeer, checkServeModel } = await import('../serve-preflight-NHZOKHIC.js');
+      const { checkServeHarness, checkServeAgents, checkServeConnectors } = await import('../serve-preflight-NHZOKHIC.js');
+      const startProblem = managedCodex ? null : await checkServeHarness(opts.projectDir, opts.harness) ?? checkServeAgents(opts.projectDir) ?? checkServeConnectors(opts.projectDir);
       if (startProblem) {
         logErr(startProblem);
         process.exitCode = 1;
@@ -11474,12 +11607,12 @@ function makeServeCommand() {
   );
 }
 async function ensurePluginsLoadedForServe(projectDir) {
-  const { logInfo: logInfo2, logWarn: logWarn2 } = await import('../helpers-LWNKX56Y.js');
+  const { logInfo: logInfo2, logWarn: logWarn2 } = await import('../helpers-INS4B7OQ.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-OJTERUEZ.js');
+    const { ensurePluginsLoaded } = await import('../plugin-store-XQP2CRYH.js');
     const { pluginRegistry } = await import('../plugin-registry/index.js');
     const result = await ensurePluginsLoaded(projectDir, config.plugins, pluginRegistry);
     if (result.loaded.length > 0) {
@@ -11493,14 +11626,14 @@ async function ensurePluginsLoadedForServe(projectDir) {
   }
 }
 async function runCompileTest(opts) {
-  const { logOk: logOk2, logErr: logErr2, logInfo: logInfo2, S: S2 } = await import('../helpers-LWNKX56Y.js');
+  const { logOk: logOk2, logErr: logErr2, logInfo: logInfo2, S: S2 } = await import('../helpers-INS4B7OQ.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-RPK5PNZQ.js');
+  const { MONOREPO_ROOT } = await import('../paths-77PXOXZY.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).");
@@ -12272,7 +12405,7 @@ function makeSessionCommand() {
     logOk(`Deleted session: ${S.dim(runId.slice(0, 8))}`);
   });
   cmd.addCommand(makeSessionLogsCommand());
-  cmd.action(() => cmd.help());
+  helpOnBareGroup(cmd);
   return cmd;
 }
 var SYNC_ICONS = {
@@ -12460,8 +12593,8 @@ function makeStoreCommand() {
     "--all",
     `List every match (default: ${STORE_ROW_LIMIT} rows, only what \`skaile add\` can install)`
   ).option("-C, --project-dir <dir>", "Project directory (catalog config overlay)", process.cwd()).action(async (query, opts) => {
-    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-Q7QZJY5D.js');
-    const { getKnownKinds: getKnownKinds2 } = await import('../open-registry-RZW2AFD6.js');
+    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-3HMXYGUF.js');
+    const { getKnownKinds: getKnownKinds2 } = await import('../open-registry-BHBHQMBA.js');
     const projectDir = path19__default.resolve(opts.projectDir);
     if (opts.kind && !getKnownKinds2().has(opts.kind)) {
       logErr(
@@ -12519,8 +12652,8 @@ function makeStoreCommand() {
     }
   });
   store.command("show <ref>").description("Show a store asset's details + provenance (source, files, integrity)").option("-C, --project-dir <dir>", "Project directory (catalog config overlay)", process.cwd()).action(async (ref, opts) => {
-    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-Q7QZJY5D.js');
-    const { supportsInstallManifest: supportsInstallManifest2 } = await import('../project-WVPRL7CP.js');
+    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-3HMXYGUF.js');
+    const { supportsInstallManifest: supportsInstallManifest2 } = await import('../project-HVNPK2ZF.js');
     try {
       parseAssetRef(ref);
     } catch (e) {
@@ -12539,6 +12672,7 @@ function makeStoreCommand() {
       const manifestFailure = {};
       if (supportsInstallManifest2(remote)) {
         manifest = await remote.getInstallManifest(canonical).catch(async (err) => {
+          if (err instanceof OfflineError) manifestFailure.airGapped = true;
           manifestFailure.text = await describeStoreFailure(err, path19__default.resolve(opts.projectDir));
           return null;
         });
@@ -12589,7 +12723,11 @@ function makeStoreCommand() {
       const notInstallable = storeNotInstallableReason(asset);
       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) {
+      else if (manifestFailure.airGapped) {
+        console.log(
+          `  ${S.dim(`Not installable offline: set catalog.cache_ttl above 0, then run skaile add ${canonical}`)}`
+        );
+      } 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.`)}`
@@ -13349,7 +13487,7 @@ program.command("init [project-dir]").description("Initialize a project director
   (projectDir, opts) => runInit(projectDir, opts)
 );
 async function runInit(projectDir, opts) {
-  const { mkdirSync: mkdirSync5, writeFileSync: writeFileSync7 } = await import('fs');
+  const { mkdirSync: mkdirSync6, writeFileSync: writeFileSync8 } = await import('fs');
   const { stringify: stringify2 } = await import('yaml');
   const { HARNESS_TARGETS: HARNESS_TARGETS2, SUPPORTED_HARNESSES: SUPPORTED_HARNESSES2, resolveConfiguredHarnessName: resolveConfiguredHarnessName2 } = await import('../core/index.js');
   const harness = opts.harness ?? "claude-code";
@@ -13373,28 +13511,28 @@ async function runInit(projectDir, opts) {
   const created = [];
   const { existsSync: existsSync22 } = await import('fs');
   if (!existsSync22(resolved)) {
-    mkdirSync5(resolved, { recursive: true });
+    mkdirSync6(resolved, { recursive: true });
     created.push(".");
   }
   const skaileDir = path19__default.join(resolved, ".skaile");
   if (!existsSync22(skaileDir)) {
-    mkdirSync5(path19__default.join(skaileDir, "sessions"), { recursive: true });
+    mkdirSync6(path19__default.join(skaileDir, "sessions"), { recursive: true });
     created.push(".skaile/");
   }
   const settingsPath = path19__default.join(skaileDir, "settings.json");
   if (!existsSync22(settingsPath)) {
-    writeFileSync7(settingsPath, "{}\n");
+    writeFileSync8(settingsPath, "{}\n");
     created.push(".skaile/settings.json");
   }
   const wsConfigPath = path19__default.join(resolved, "skaile.yaml");
   if (!existsSync22(wsConfigPath)) {
-    writeFileSync7(wsConfigPath, stringify2(buildInitWorkspaceConfig(projectName, harness)));
+    writeFileSync8(wsConfigPath, stringify2(buildInitWorkspaceConfig(projectName, harness)));
     created.push("skaile.yaml");
   }
   for (const dir of new Set(Object.values(HARNESS_TARGETS2[harness].local))) {
     const full = path19__default.join(resolved, dir);
     if (!existsSync22(full)) {
-      mkdirSync5(full, { recursive: true });
+      mkdirSync6(full, { recursive: true });
       created.push(`${dir}/`);
     }
   }
@@ -13422,7 +13560,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 { existsSync: existsSync22, readFileSync: readFileSync14, writeFileSync: writeFileSync8 } = await import('fs');
   const gitignorePath = path19__default.join(resolved, ".gitignore");
   const entries = [
     "node_modules/",
@@ -13431,18 +13569,14 @@ async function initGitScaffold(resolved, created) {
     "*.pyc",
     ".skaile/sessions/",
     ".skaile/cache/",
-    // skaile-created artifacts that must never be committed: the per-session log
-    // DB (SQLite incl. -shm/-wal, ends in .db — not caught by *.log), personal
-    // settings (holds API keys), the workspace AI provider registry (endpoints
-    // and credential references are per-machine), the install history, and the
-    // per-run model-endpoint discovery file (holds a bearer token).
-    ".skaile/logs.db*",
+    // skaile-created artifacts that must never be committed: personal settings (holds API
+    // keys), the workspace AI provider registry (endpoints and credential references are
+    // per-machine), and the per-run model-endpoint discovery file (holds a bearer token).
     ".skaile/settings.json",
     ".skaile/providers.yml",
-    ".skaile/history.yaml",
     ".skaile/model-endpoint.json",
-    // Machine state of the runs: one compiled-prompt snapshot per run, and the ledger of the
-    // agent files an install wrote.
+    // Machine state of the runs: the log database, the install history, one compiled-prompt
+    // snapshot per run, and the ledger of the agent files an install wrote.
     ...RUN_STATE_GITIGNORE_ENTRIES,
     // Per-machine files a run writes into the project: the system prompt handed to the harness
     // (it carries the host path) and omp's session logs.
@@ -13463,12 +13597,12 @@ async function initGitScaffold(resolved, created) {
     ".env",
     ".env.local"
   ];
-  const existing = existsSync22(gitignorePath) ? readFileSync13(gitignorePath, "utf-8") : "";
+  const existing = existsSync22(gitignorePath) ? readFileSync14(gitignorePath, "utf-8") : "";
   const have = new Set(existing.split("\n").map((l) => l.trim()));
   const append = entries.filter((e) => !have.has(e));
   if (append.length > 0) {
     const prefix = existing && !existing.endsWith("\n") ? "\n" : "";
-    writeFileSync7(gitignorePath, `${existing + prefix}${append.join("\n")}
+    writeFileSync8(gitignorePath, `${existing + prefix}${append.join("\n")}
 `);
     if (!existing) created.push(".gitignore");
   }
@@ -13502,7 +13636,7 @@ async function bootstrapUserConfig() {
 }
 async function hydrateInitSources(resolved, created) {
   try {
-    const { ensureSourcesCloned } = await import('../ensure-sources-VELKRM6X.js');
+    const { ensureSourcesCloned } = await import('../ensure-sources-5QWKUIUD.js');
     const hydrate = ensureSourcesCloned(resolved, { quiet: true });
     for (const n of hydrate.cloned) created.push(`~/.skaile/cache/sources/${n}/`);
     if (hydrate.failed.length > 0) {
@@ -13543,7 +13677,7 @@ function printInitSummary(resolved, projectDir, created) {
 }
 program.hook("preAction", (_program, actionCommand) => setActiveCommand(actionCommand));
 program.command("setup").description("Interactive provider setup wizard").action(async () => {
-  const { cmdSetup } = await import('../setup-F5JX64UP.js');
+  const { cmdSetup } = await import('../setup-EX7Z7XRN.js');
   await cmdSetup([], { projectDir: process.cwd() });
 });
 program.addCommand(makeInstallCommand());
@@ -13624,7 +13758,7 @@ program.hook("postAction", async (_thisCommand, actionCommand) => {
   const opts = actionCommand.opts();
   if (opts.global || opts.dryRun) return;
   const projectDir = path19__default.resolve(opts.projectDir ?? process.cwd());
-  const { refreshPluginSkills } = await import('../claude-code-DS26HI3K.js');
+  const { refreshPluginSkills } = await import('../claude-code-ILZ46SLO.js');
   try {
     if (await refreshPluginSkills(projectDir)) {
       logInfo(`Updated ${S.cmd(".claude/plugins/skaile/skills")} (the --full plugin copy)`);