@skaile/workspaces 6.15.0 → 6.16.0

package/dist/cli/index.js

@@ -1,97 +1,99 @@
 #!/usr/bin/env node
-import { status, enable, disable, install, uninstall } from '../chunk-JIZ35OOU.js';
-import { makeValidateCommand, scanIdentities } from '../chunk-OIWFXUZB.js';
-import { storeNotInstallableReason, mcpNotRunnableHere } from '../chunk-HCIXCCUH.js';
-import { checkHarnessSdk } from '../chunk-2RVEYDQK.js';
-import { makeProvidersCommand, loadRegistryView, addProviderEntry, ProviderRegistryWriteError, removeProviderEntry } from '../chunk-RKTEHX2S.js';
-import { makeInstallCommand, makeCheckCommand, makeCleanCommand, pinComposedAgents, reportRewritten, reportReplaced, reportRelocked, reportMoved, reportStoreNotChecked, reportStoreNotCheckedForUpdates, globalProblems, editedConventionFiles, supportsInstallManifest, runYamlInstall, REF_HINT, reportInstalledSoftDeps } from '../chunk-R7422XD4.js';
+import { AI_RESOURCES } from '../chunk-BTMSHGN3.js';
+import { status, enable, disable, install, uninstall } from '../chunk-NJ6UCY2B.js';
+import { makeValidateCommand, scanIdentities, findManifestCandidates } from '../chunk-6M44OQKH.js';
+import { storeNotInstallableReason, mcpNotRunnableHere } from '../chunk-4X5WXQV7.js';
+import { refreshStaleAgentFiles } from '../chunk-3LAJJURV.js';
+import { makeProvidersCommand, loadRegistryView, addProviderEntry, ProviderRegistryWriteError, removeProviderEntry } from '../chunk-TW5AP6IF.js';
+import { makeInstallCommand, makeCheckCommand, makeCleanCommand, pinComposedAgents, reportRewritten, reportReplaced, reportRelocked, reportMoved, reportStoreNotChecked, reportStoreNotCheckedForUpdates, globalProblems, editedConventionFiles, supportsInstallManifest, runYamlInstall, REF_HINT, reportInstalledSoftDeps } from '../chunk-65SOXO7I.js';
 import { createSpinner } from '../chunk-NESV47MF.js';
-import { getStoreConfig, storeFetch, isStoreAuthenticated, getStoreToken } from '../chunk-IRIWNKQS.js';
-import { makeSourceCommand, dropVanishedSourceRows, syncProjectSources, divergedSourceClones, uncachedSources } from '../chunk-XPSZIBPU.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, manifestPublisherProblems, assetEntryRef, exitOnManifestPathProblems, exitOnRootSkillExtraAssets, manifestRequiresProblems, composeRefContext, registeredAssetKeys, duplicateAssetMessage, manifestParseFailureLine, manifestParseErrorText, unresolvedManifestDependencies, findEntryManifestFile, unheldRequiresOfFile, warnLegacyBundleFiles, warnUntrackedAssetFiles, checkComposeKinds } from '../chunk-6WIZC6GM.js';
-import { openCatalogSource, LocalCatalogDisabledError, openLibraryManager, openLibrary } from '../chunk-KIFAU62K.js';
-import { getKindRegistry, getKnownKinds } from '../chunk-HPQ2WDYC.js';
-import { logErr, unknownHarnessTargetMessage, S, logOk, setActiveCommand, logInfo, logWarnErr, canonicalHarnessId, unknownHarnessMessage, logWarn, TARGET_DEFAULT_HINT, parseHarnessFilter, requireProjectConfig, deferredWarnings, warnPlaceholderBodies, warnFilesOnlyDelegates, reportLegacyOmpCopies, reportUnknownHarnesses, warnProjectConfig, logNoProject, warnStaleHarnessCopies, kindColorPad, kindColor, colorRef, formatSoftDepSection, bareSoftDepName, reportProjectConfig, driverAliasOption, foldDriverFlag, friendlyHarnessError, harnessErrorNotes, agentInstanceErrorLines, formatSoftDepHint, formatRelativeTime, isRecord, formatSoftDepRemovePreview, formatSoftDepAddPreview, fitWidth, KIND_COL_WIDTH } from '../chunk-A4VKIVGB.js';
-import { AI_RESOURCES } from '../chunk-ZLDAPZIX.js';
-import { loadDeclaredPlugins } from '../chunk-2PVYDAFN.js';
+import { getStoreConfig, storeFetch, isStoreAuthenticated, getStoreToken } from '../chunk-SX54OQQT.js';
+import { makeSourceCommand, dropVanishedSourceRows, syncProjectSources, divergedSourceClones, uncachedSources } from '../chunk-7IW5E6LB.js';
+import { manifestEntryRootRefusals, manifestEntryFilesRefusals, libraryAssetRefusals, manifestEntryRenames, deviceLogin, loadStoreAuthConfig, logout, hasStoredAuth, exitOnLibrarySymlinks, resolveLibraryPublisherDetailed, getStoreIdentity, warnLibraryNameFallback, indexLibrary, warnIgnoredDomainFiles, removedDomainOption, rejectRemovedDomainOption, requireValidPublisherOrExit, exitOnManifestPublisherProblems, exitOnRootSkillLibrary, findAssetManifestFile, checkAssetFileFull, registerLibraryAsset, DOMAIN_REMOVED_HINT, reportLibrarySymlinks, manifestParseErrorText, runAssetChecks, checkAssetFile, rootLevelAssetFileProblem, manifestPublisherProblems, assetEntryRef, exitOnManifestPathProblems, exitOnRootSkillExtraAssets, manifestRequiresProblems, composeRefContext, registeredAssetKeys, duplicateAssetMessage, manifestParseFailureLine, unresolvedManifestDependencies, findEntryManifestFile, unheldRequiresOfFile, warnLegacyBundleFiles, warnUntrackedAssetFiles, manifestKindOfFile, checkComposeKinds } from '../chunk-KDRA6FYE.js';
+import { openCatalogSource, LocalCatalogDisabledError, openLibraryManager, openLibrary } from '../chunk-Z7HLX4V2.js';
+import { getKindRegistry, getKnownKinds } from '../chunk-U2WPJHRA.js';
+import { logErr, unknownHarnessTargetMessage, S, logOk, setActiveCommand, logInfo, logWarnErr, canonicalHarnessId, noteExperimentalHarness, logWarn, TARGET_DEFAULT_HINT, parseHarnessFilter, requireProjectConfig, deferredWarnings, warnPlaceholderBodies, warnFilesOnlyDelegates, reportLegacyOmpCopies, reportUnknownHarnesses, warnProjectConfig, logNoProject, warnStaleHarnessCopies, kindColorPad, kindColor, colorRef, formatSoftDepSection, bareSoftDepName, reportProjectConfig, driverAliasOption, foldDriverFlag, friendlyHarnessError, harnessErrorNotes, agentInstanceErrorLines, formatSoftDepHint, formatRelativeTime, isRecord, formatSoftDepRemovePreview, formatSoftDepAddPreview, fitWidth, KIND_COL_WIDTH } from '../chunk-WW22FS74.js';
+import { loadDeclaredPlugins } from '../chunk-T65N4CIZ.js';
 import { LocalSecretsProvider } from '../chunk-ILFGVSTJ.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-YLKOCMU7.js';
-import '../chunk-A3G3FHGB.js';
-import '../chunk-72PPC4SC.js';
-import '../chunk-C5ZCREBI.js';
-import '../chunk-IOXFT5D7.js';
+import { resolveInstanceAgentDir, instanceSessionOverrides, loadAgentManifest, manifestModelForHarness, runAgentChat, resolveSessionId, loadSessionById, loadSession, listSessions, setCurrentSession, deleteSession, clearSession, hashAgentFiles, instanceForSession, resolveAgentInstance, MarkdownStreamer, createFinalTextFallback, describeComposition } from '../chunk-ZII54C3E.js';
+import '../chunk-NNJQQYHY.js';
+import '../chunk-Z23I2JA6.js';
+import '../chunk-TVRL3IPZ.js';
+import '../chunk-PD42JZWI.js';
 import '../chunk-WYZXSJBK.js';
-import '../chunk-EB2LKPI6.js';
-import '../chunk-V2VDTQ7A.js';
+import '../chunk-SMFZ5YGN.js';
+import '../chunk-3A7JUOY2.js';
 import '../chunk-KW37WNXY.js';
 import '../chunk-3MWQKQUB.js';
-import '../chunk-FJJEC6O2.js';
+import '../chunk-3UYKT62L.js';
 import '../chunk-O7SG5PC2.js';
 import '../chunk-7QBNJTTQ.js';
 import '../chunk-O2SYFJWP.js';
-import '../chunk-7K73MCI6.js';
+import '../chunk-CU5WY6HN.js';
 import '../chunk-32NA4TVC.js';
 import '../chunk-W3UDISS2.js';
-import { runFlow, resumeFlow } from '../chunk-YDMZWVZN.js';
+import { runFlow, resumeFlow } from '../chunk-6KV34G6A.js';
 import '../chunk-4R6DROGN.js';
-import { parseSkillRequirements, validateRequirements } from '../chunk-KOI7QFDH.js';
-import '../chunk-LQWOU7S2.js';
-import '../chunk-6VQW2X2F.js';
+import { parseSkillRequirements, validateRequirements } from '../chunk-M7XIYHWB.js';
+import '../chunk-SFBLZOV5.js';
+import '../chunk-QUIK7L3Z.js';
 import '../chunk-6HTN2UIJ.js';
-import '../chunk-SBAUZ7XH.js';
-import { checkHarnessModel, detectHarnesses, checkOmpListedModel, isUnlistedModel, checkModelSurface } from '../chunk-IYXOSBQ4.js';
-import '../chunk-J7FEWDRQ.js';
-import '../chunk-TYRAEMWE.js';
-import { checkCodexCredential } from '../chunk-SXRN27TU.js';
+import '../chunk-H3PY5DFL.js';
+import { preflight, detectHarnesses } from '../chunk-PRB67LCK.js';
+import '../chunk-2SSG5B24.js';
+import '../chunk-OD4N5O7V.js';
+import '../chunk-72DYHOO2.js';
 import '../chunk-5KSGZP3E.js';
 import '../chunk-7EKQDY2T.js';
 import '../chunk-HXST2IYJ.js';
 import '../chunk-U7EZ2WSC.js';
-import '../chunk-AEFDFCS2.js';
+import '../chunk-VFEZUSB6.js';
 import '../chunk-NBAGV6L2.js';
-import '../chunk-O74SRQ3W.js';
-import { resolveHarnessBinary, HARNESS_BINARIES } from '../chunk-YKD2MYLU.js';
+import '../chunk-PPSSDUN6.js';
+import '../chunk-YKD2MYLU.js';
 import '../chunk-5DE3DGVR.js';
 import '../chunk-7DN6JKP2.js';
-import '../chunk-CWUHUL6W.js';
-import { listHarnesses } from '../chunk-U7EJB6LY.js';
+import '../chunk-NAQXDTF3.js';
+import { listHarnesses } from '../chunk-S3UOZBGE.js';
 import '../chunk-G5SUWZEU.js';
-import '../chunk-CG63XGVV.js';
+import '../chunk-EGKCKWWE.js';
 import { getProviderPreset, AI_PROVIDER_PRESETS } from '../chunk-6UP2EDFN.js';
 import '../chunk-IFGTRL2I.js';
-import { loadFlow, flowLookupRoots, findFlowFileInRoots, loadAllFlowEntries } from '../chunk-WDG5IVEA.js';
+import { loadFlow, flowLookupRoots, findFlowFileInRoots, loadAllFlowEntries } from '../chunk-2ZDZJ7XQ.js';
 import '../chunk-WD3L5QSU.js';
 import { nodeLabel, nodeSkillAsset, nodeIsInert, nodeIsOptional, nodeRunKind, nodeAssets } from '../chunk-7RGTAEG6.js';
 import '../chunk-JPV4WE5L.js';
-import { setLibraryAssetCheck, setRenamedEntryLookup, LibraryEntryError, AssetManager, parseRefTolerant, MissingManifestError, writeHarnessSwitchState, harnessSwitchKeptKey, parseCanonicalLockKey, normalizeRepoUrl, readHarnessSwitchState } from '../chunk-MUQBP2BK.js';
-import { CatalogHttpError, OfflineError, libraryDirMissing, missingLibraryDirMessage, cloneOrInitGitRepo, trackOriginBranch, stampManifestPublisher, addMissingEntryVersions, isGitRepo, ensureGitRepo, conflictingAssetRoot, scanUnlistedAssets, setManifestPublisher, LIBRARY_OWNERSHIPS, assertManifestEditable, installLibraryAsset, getStoreManifestsDir, assertValidLibraryName, unparsableAssetFiles, missingRootAssets, syncManifestWithDisk, renamedLibraryName, storeManifestFile, getDefaultValue, isSecretPlaceholder } from '../chunk-7FXOOUOC.js';
-import { flowFileNameError, SEMVER_RE } from '../chunk-DRUAQ7IY.js';
-import '../chunk-CVUMZTNO.js';
-import '../chunk-F3D25RGM.js';
-import '../chunk-3TXEJN4W.js';
+import { setLibraryAssetCheck, setRenamedEntryLookup, LibraryEntryError, AssetManager, parseRefTolerant, MissingManifestError, writeHarnessSwitchState, harnessSwitchKeptKey, parseCanonicalLockKey, readHarnessSwitchState } from '../chunk-2JUCWMIS.js';
 import '../chunk-ISHJITXJ.js';
 import '../chunk-LNFKL23K.js';
 import '../chunk-JRN5QF4C.js';
 import '../chunk-NUELZWCF.js';
-import { installTargetOf, SCAFFOLD_KINDS } from '../chunk-7LJUK5JK.js';
+import { installTargetOf, SCAFFOLD_KINDS, assembleAgentPrompt } from '../chunk-MG6QD7GE.js';
+import '../chunk-2PJYJPDE.js';
 import '../chunk-PKE3PXOK.js';
+import { isCompositionError, createCompositionContentSource, compileComposition, agentPromptInput } from '../chunk-4ZNKEDYH.js';
+import { CatalogHttpError, OfflineError, libraryDirMissing, missingLibraryDirMessage, cloneOrInitGitRepo, trackOriginBranch, stampManifestPublisher, addMissingEntryVersions, isGitRepo, ensureGitRepo, conflictingAssetRoot, scanUnlistedAssets, setManifestPublisher, LIBRARY_OWNERSHIPS, assertManifestEditable, installLibraryAsset, getStoreManifestsDir, assertValidLibraryName, unparsableAssetFiles, missingRootAssets, syncManifestWithDisk, renamedLibraryName, storeManifestFile, getDefaultValue, isSecretPlaceholder } from '../chunk-RPRMD7XV.js';
+import { parseManifestFile, flowFileNameError, SEMVER_RE } from '../chunk-QUPZKTF3.js';
+import '../chunk-ZQPBYLCS.js';
+import '../chunk-F3D25RGM.js';
+import '../chunk-3TXEJN4W.js';
 import '../chunk-LKBRBVVS.js';
 import '../chunk-UQ6LFBPZ.js';
-import { CODEX_IDENTITY_DIR } from '../chunk-7VBD5XUM.js';
-import { effectiveComposes, validatePreset, validateAgent, composeSlotDiagnostics, agentDeprecationDiagnostics, SLOT_ID_PATTERN } from '../chunk-LCXQ4LVP.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-MEU2HHGV.js';
+import { CODEX_IDENTITY_DIR } from '../chunk-IG4YQ7ER.js';
+import { LockParseError, loadSettings, globalSettingsPath, resolveSettings, projectSettingsPath, saveSettings, modelForHarness, WorkspaceYamlEditor, readLock, resolveLibraryDir, identityFindings, assetPathProblem, checkAgentSkillConformance, resolveSettingsWithSources, resolveConfiguredHarnessName, FACTORY_SOURCE_URL, globalInstallDir, GLOBAL_INSTALL_DIR_NAME, workspaceProviderRegistryPath, userProviderRegistryPath, loadProviderRegistryFile, aiResourceRoots } from '../chunk-U7P22GEB.js';
 import '../chunk-4GY63JU6.js';
-import { factoryAssetRoots } from '../chunk-CJO3XKO7.js';
+import { factoryAssetRoots } from '../chunk-ETGC2MEM.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, isSameRemote, matchPin, coerceVersion, loadSkWorkspaceConfig, configParseErrorOf, findWorkspaceRoot, isWorkspaceConfigFilename, SKAILE_YAML_DEFAULT, AGENT_PROFILE_FIELDS } from '../chunk-BNLXZXZN.js';
+import { SourceEntryError, LegacyKeyError, ConfigParseError, resolveSkWorkspaceConfig, unselectedInstanceIds, instanceChoiceText, sourceCacheKey, getGlobalCacheDir, resolveAgentDir, AgentRefResolutionError, repoIdentity, resolveAgentDefinitionDir, effectiveAgentInstances, sameRepo, matchPin, coerceVersion, loadSkWorkspaceConfig, configParseErrorOf, findWorkspaceRoot, isWorkspaceConfigFilename, SKAILE_YAML_DEFAULT, AGENT_PROFILE_FIELDS } from '../chunk-BRAOB37W.js';
 import { globalCacheRoot, globalSkaileDir, userConfigPath } from '../chunk-L5VSIPQD.js';
 import { HARNESS_TARGETS, SUPPORTED_HARNESSES, harnessNameForHarnessId } from '../chunk-VTETQCR6.js';
-import { loadSkPublishManifest, SKAILE_MANIFEST_FILENAME, decodeSkaileManifest, LIBRARY_GITIGNORE, librarySymlinkMessage, isNonAssetPath, isNonAssetDir, encodeSkaileManifest } from '../chunk-MS2IXLTC.js';
-import { setWalkTruncationSink, dedupeRequirements, parseFrontmatter, scanDirectory, parseRequires } from '../chunk-VS6XC5JE.js';
+import { loadSkPublishManifest, SKAILE_MANIFEST_FILENAME, decodeSkaileManifest, LIBRARY_GITIGNORE, librarySymlinkMessage, isNonAssetPath, isNonAssetDir, encodeSkaileManifest } from '../chunk-PMXTBWFD.js';
+import { setWalkTruncationSink, dedupeRequirements, parseFrontmatter, scanDirectory, parseRequires } from '../chunk-2MTRRK37.js';
 import { pluginTitle } from '../chunk-RVRB27AN.js';
-import { parseAssetRef, isValidAssetName, ASSET_NAME_HINT, depToStr, assetRefToStr, slugifyAssetName, parseAssetRefLoose } from '../chunk-7HRZACI4.js';
+import { parseAssetRef, isValidAssetName, depToStr, assetRefToStr, slugifyAssetName, parseAssetRefLoose } from '../chunk-HW4BDJPC.js';
+import { effectiveComposes, validatePreset, validateAgent, composeSlotDiagnostics, agentDeprecationDiagnostics, SLOT_ID_PATTERN } from '../chunk-LCXQ4LVP.js';
 import { portableSpawn, portableSpawnSync } from '../chunk-VSX2G7LA.js';
 import { parseModelRef, resolveEntryBaseUrl } from '../chunk-RXGPFAMN.js';
 import { RUN_STATE_GITIGNORE_ENTRIES, openSqlite } from '../chunk-RZL4TOK3.js';
@@ -134,6 +136,30 @@ function truncateText(text, max) {
   if (max <= 1) return "\u2026".slice(0, Math.max(0, max));
   return `${flat.slice(0, max - 1).trimEnd()}\u2026`;
 }
+function wrapText(text, width) {
+  const flat = text.replace(/\s+/g, " ").trim();
+  if (flat === "") return [];
+  const lines = [];
+  let line = "";
+  for (let word of flat.split(" ")) {
+    while (word.length > width) {
+      if (line !== "") {
+        lines.push(line);
+        line = "";
+      }
+      lines.push(word.slice(0, width));
+      word = word.slice(width);
+    }
+    if (line === "") line = word;
+    else if (line.length + 1 + word.length <= width) line = `${line} ${word}`;
+    else {
+      lines.push(line);
+      line = word;
+    }
+  }
+  if (line !== "") lines.push(line);
+  return lines;
+}
 function localEntryRef(e) {
   return e.publisher ? `${e.kind}:@${e.publisher}/${e.name}` : e.name;
 }
@@ -241,7 +267,7 @@ async function runSearch(kind, query, opts) {
   }
 }
 async function searchIndex(query, kind, projectDir) {
-  const { openLibrary: openLibrary2 } = await import('../open-library-EVUKLOV7.js');
+  const { openLibrary: openLibrary2 } = await import('../open-library-FVV6GG4I.js');
   const library = await openLibrary2();
   try {
     const { libraryDirMissing: libraryDirMissing2 } = await import('../library/index.js');
@@ -417,14 +443,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-VXE3RSSA.js');
+  const { restoreSourceReaders } = await import('../source-P6JPZYWP.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-VXE3RSSA.js');
+    const { autoSyncForSearch } = await import('../source-P6JPZYWP.js');
     if (await autoSyncForSearch(projectDir)) {
       entries = unionEntries(await searchIndex(query, kind, projectDir), factory);
     }
@@ -478,7 +504,7 @@ function layoutLocalTable(rows, width, style = {}) {
     }
     return { ruleWidth: nameW + gap + descW + tailSpan, lines };
   }
-  const stackedW = width - (indent + 2) - tailSpan;
+  const stackedW = width - (indent + 2);
   const stackable = stackedW >= MIN_LOCAL_DESCRIPTION_WIDTH && rows.some((r) => r.description !== "");
   if (!stackable && indent + nameW + tailSpan <= width) {
     for (const r of rows) {
@@ -487,17 +513,18 @@ function layoutLocalTable(rows, width, style = {}) {
     return { ruleWidth: nameW + tailSpan, lines };
   }
   const subPad = " ".repeat(indent + 2);
-  const subDescW = width - (indent + 2) - tailSpan;
   for (const r of rows) {
     lines.push(`${pad}${styleRef(r.ref)}`);
-    const desc = subDescW >= MIN_LOCAL_DESCRIPTION_WIDTH ? truncateText(r.description, subDescW) : "";
-    const descCell = (r.version || r.library) && desc ? desc.padEnd(subDescW) : desc;
-    const parts = [
-      descCell,
-      r.version ? styleVer(r.version) : "",
-      r.library ? styleLib(r.library) : ""
-    ].filter((s) => s !== "");
-    if (parts.length > 0) lines.push(`${subPad}${parts.join(COLUMN_GAP)}`);
+    const body = stackedW >= MIN_LOCAL_DESCRIPTION_WIDTH ? wrapText(r.description, stackedW) : [];
+    const plainTail = [r.version, r.library ?? ""].filter((s) => s !== "").join(COLUMN_GAP);
+    const styledTail = [r.version ? styleVer(r.version) : "", r.library ? styleLib(r.library) : ""].filter((s) => s !== "").join(COLUMN_GAP);
+    const last = body.at(-1);
+    if (plainTail !== "" && last !== void 0 && last.length + gap + plainTail.length <= stackedW) {
+      body[body.length - 1] = `${last}${COLUMN_GAP}${styledTail}`;
+    } else if (plainTail !== "") {
+      body.push(styledTail);
+    }
+    for (const text of body) lines.push(`${subPad}${text}`);
   }
   return { ruleWidth: Math.max(1, Math.min(nameW, width - indent)), lines };
 }
@@ -544,7 +571,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-EVUKLOV7.js');
+  const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-FVV6GG4I.js');
   try {
     const remote = await openCatalogSource2({ projectDir: path19__default.resolve(opts.projectDir) });
     const assets = await remote.listAssets(kind ? { kind } : {});
@@ -1154,7 +1181,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-EVUKLOV7.js');
+    const { resolveCatalogSource } = await import('../open-library-FVV6GG4I.js');
     const { source, close } = await resolveCatalogSource({ projectDir: opts.projectDir });
     try {
       return await source.listAssets(filter);
@@ -1170,7 +1197,7 @@ async function resolveInfoEntry(am2, ref, opts) {
     );
     return { entry: hit ? catalogAssetToEntry(hit) : null };
   } catch (err) {
-    const { LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-EVUKLOV7.js');
+    const { LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-FVV6GG4I.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 } : {} };
@@ -1305,13 +1332,18 @@ function makeDoctorCommand() {
       projectDir: path19__default.resolve(opts.projectDir)
     });
     const { gaps } = await am2.projectState();
-    const edited = await editedConventionFiles(path19__default.resolve(opts.projectDir));
+    const edited = [
+      ...await editedConventionFiles(path19__default.resolve(opts.projectDir)),
+      ...await am2.staleAgentFileLines()
+    ];
     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(),
       // An asset-named agent file an instance's file replaced: the next install removes it.
-      ...am2.leftoverAgentFileNotices()
+      ...am2.leftoverAgentFileNotices(),
+      // An agent whose `extends` parent is not there: said once at `add`, then here (v16-D11).
+      ...am2.missingParentNotices()
     ];
     await am2.probeStoreOrigins();
     const notChecked = am2.takeStoreNotChecked();
@@ -1462,6 +1494,38 @@ function withCanonicalRef(def) {
   const { id: _storageId, ...rest } = def;
   return { ref: catalogAssetRef(def), ...rest };
 }
+function migrateSourceProblems(srcPath) {
+  const root = path19.resolve(srcPath);
+  const isFile2 = fs8.statSync(root).isFile();
+  const registry = getKindRegistry();
+  const candidates = isFile2 ? [{ filePath: root, kind: manifestKindOfFile(root) }] : findManifestCandidates(root);
+  const lines = [];
+  for (const c of candidates) {
+    if (c.kind === void 0) continue;
+    const rel = path19.relative(isFile2 ? path19.dirname(root) : root, c.filePath);
+    let text;
+    try {
+      text = fs8.readFileSync(c.filePath, "utf-8");
+    } catch {
+      continue;
+    }
+    const parsed = parseManifestFile(c.filePath, text);
+    if (!parsed.ok) {
+      lines.push(`${rel} [${c.kind}] \u2014 ${manifestParseErrorText(parsed.reason)}`);
+      continue;
+    }
+    for (const f of checkAssetFile(
+      "migrate",
+      c.filePath,
+      c.kind,
+      registry,
+      isFile2 ? path19.dirname(root) : root
+    )) {
+      lines.push(`${rel} [${f.tag}] \u2014 ${f.text}`);
+    }
+  }
+  return lines;
+}
 function resolveLibraryOption(opts) {
   if (opts.library && opts.to && opts.library !== opts.to) {
     logErr(
@@ -1541,23 +1605,32 @@ function makeAssetCommand() {
           process.exit(1);
         }
         const importedFm = parseFrontmatter(norm.content);
-        const checked = checkAsset(
-          "skill",
-          importedFm.data,
-          importedFm.body,
-          norm.name,
-          getKindRegistry(),
-          norm.content
-        );
-        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}`);
+        const importedParse = parseManifestFile(src.skillFile, norm.content);
+        if (!importedParse.ok) {
+          logErr(
+            `${norm.name}/SKILL.md [skill] \u2014 ${manifestParseErrorText(importedParse.reason)}`
+          );
           logErr(
-            `Not imported: ${refusals.length} problem(s) in SKILL.md. Fix them in ${src.skillFile} (or drop --no-normalize) and run the import again.`
+            `Not imported: SKILL.md does not parse. Fix it in ${src.skillFile} and run the import again.`
           );
           process.exit(1);
         }
-        for (const f of checked.advisories) {
+        const checked = runAssetChecks("import", {
+          kind: "skill",
+          parsed: importedFm.data,
+          body: importedFm.body,
+          dirName: norm.name,
+          registry: getKindRegistry(),
+          rawText: norm.content
+        });
+        if (checked.errors.length > 0) {
+          for (const f of checked.errors) 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.`
+          );
+          process.exit(1);
+        }
+        for (const f of checked.warnings) {
           logWarn(`${norm.name}/SKILL.md [${f.tag}] \u2014 ${f.text}`);
         }
         fs8.cpSync(src.dir, destDir, { recursive: true, filter: copyFilter(src.dir) });
@@ -1641,6 +1714,14 @@ function makeAssetCommand() {
           );
           process.exit(1);
         }
+        const migrateProblems = migrateSourceProblems(srcPath);
+        if (migrateProblems.length > 0) {
+          for (const line of migrateProblems) logErr(line);
+          logErr(
+            `Not migrated: ${migrateProblems.length} problem(s) in ${srcPath}. Fix them there and run the migrate again.`
+          );
+          process.exit(1);
+        }
         switch (opts.mode) {
           case "copy":
             fs8.cpSync(srcPath, destPath, { recursive: true, filter: copyFilter(srcPath) });
@@ -1827,9 +1908,9 @@ function dirSizeOfDir(dir) {
   return total;
 }
 function removeCacheTargets(targets, opts) {
-  const present2 = targets.filter((t) => existsSync(t));
-  for (const t of present2) rmSync(t, { recursive: true, force: true });
-  return present2;
+  const present = targets.filter((t) => existsSync(t));
+  for (const t of present) rmSync(t, { recursive: true, force: true });
+  return present;
 }
 function fmtBytes(n) {
   const u = ["B", "KB", "MB", "GB"];
@@ -1932,7 +2013,7 @@ function makeCatalogCommand() {
   return catalog;
 }
 async function runLocalCatalogTest(projectDir) {
-  const { resolveCatalogSource } = await import('../open-library-EVUKLOV7.js');
+  const { resolveCatalogSource } = await import('../open-library-FVV6GG4I.js');
   let resolved;
   try {
     resolved = await resolveCatalogSource({ projectDir });
@@ -2108,7 +2189,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-4HNCWOCN.js');
+    const { getKindRegistry: getKindRegistry2 } = await import('../open-registry-VX2BVMS5.js');
     const index = new LocalIndex({ indexPath });
     try {
       for (const { library, assets } of await scanAuthoringLibraries(index, getKindRegistry2())) {
@@ -2536,22 +2617,27 @@ function makeConfigCommand() {
       if (key === "harness") {
         value = canonicalHarnessId(value);
         await loadDeclaredPlugins(projectDir);
-        const unknown = unknownHarnessMessage(value);
+        const [unknown] = await preflight({ projectDir }, value, void 0, void 0, {
+          checks: ["harness"]
+        });
         if (unknown) {
-          logErr(unknown);
+          logErr(unknown.line);
           process.exit(1);
         }
+        noteExperimentalHarness(value);
       }
       if (key === "model") {
         await loadDeclaredPlugins(projectDir);
         const harness = (await resolveSettings(projectDir)).harness ?? DEFAULT_HARNESS_ID;
-        const refusal2 = checkHarnessModel(harness, {
-          registry: loadRegistryView({ projectDir }).merged,
-          model: value,
-          roles: resolveSkWorkspaceConfig(projectDir).roles
-        });
+        const [refusal2] = await preflight(
+          { projectDir, roles: resolveSkWorkspaceConfig(projectDir).roles },
+          harness,
+          value,
+          void 0,
+          { checks: ["refusal"] }
+        );
         if (refusal2) {
-          logErr(`${refusal2} (the project's harness is ${harness})`);
+          logErr(`${refusal2.line} (the project's harness is ${harness})`);
           process.exit(1);
         }
       }
@@ -2716,11 +2802,11 @@ function makeConnectCommand() {
         process.exitCode = 1;
         return;
       }
-      await new Promise((resolve4) => {
+      await new Promise((resolve5) => {
         client.onMessage((event) => {
           console.log(formatEvent(event));
           if (event.type === "finished" || event.type === "debug_result") {
-            resolve4();
+            resolve5();
           }
         });
         client.send(parsed);
@@ -2764,12 +2850,12 @@ function makeConnectCommand() {
       client.send(cmd);
       rl.prompt();
     });
-    await new Promise((resolve4) => {
-      rl.on("close", resolve4);
+    await new Promise((resolve5) => {
+      rl.on("close", resolve5);
       client.onDisconnect(() => {
         logErr("Server disconnected");
         rl.close();
-        resolve4();
+        resolve5();
       });
     });
     await client.disconnect();
@@ -2865,15 +2951,15 @@ function parseOpArgs(args) {
 async function promptText(label, defaultVal) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const hint = defaultVal ? ` [${defaultVal}]` : "";
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     rl.question(`  ${label}${hint}: `, (answer) => {
       rl.close();
-      resolve4(answer.trim() || defaultVal || "");
+      resolve5(answer.trim() || defaultVal || "");
     });
   });
 }
 async function promptSecret(label) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     process.stdout.write(`  ${label} (hidden): `);
     const stdin = process.stdin;
     stdin.setRawMode?.(true);
@@ -2886,7 +2972,7 @@ async function promptSecret(label) {
         stdin.pause();
         stdin.removeListener("data", onData);
         process.stdout.write("\n");
-        resolve4(value);
+        resolve5(value);
       } else if (char === "") {
         process.exit(1);
       } else if (char === "\x7F") {
@@ -3186,17 +3272,17 @@ async function runDebugQuery(query, parentOpts, args) {
     process.exitCode = 1;
     return;
   }
-  await new Promise((resolve4) => {
+  await new Promise((resolve5) => {
     const timeout = setTimeout(() => {
       logErr("Timeout: no debug_result received within 5s");
       process.exitCode = 1;
-      resolve4();
+      resolve5();
     }, 5e3);
     client.onMessage((event) => {
       if (event.type !== "debug_result") return;
       clearTimeout(timeout);
       printDebugResult(query, event.data);
-      resolve4();
+      resolve5();
     });
     client.send({ type: "debug", query, args });
   });
@@ -3297,7 +3383,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-ZC3EGZ3D.js');
+    const { ensurePluginsLoaded } = await import('../plugin-store-MVTW6G7J.js');
     const result = await ensurePluginsLoaded(projectDir, config.plugins, pluginRegistry);
     for (const f of result.failed) logWarn(f.error);
   }
@@ -3340,12 +3426,12 @@ async function runUp(opts) {
   await holdUntilSignal(handle, controller);
 }
 function holdUntilSignal(handle, controller) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const onSig = () => {
       process.removeListener("SIGINT", onSig);
       controller.abort();
       logInfo("Stopping\u2026");
-      handle.stop().then(() => logOk("Stopped.")).catch((e) => logErr(`stop failed: ${e instanceof Error ? e.message : String(e)}`)).finally(() => resolve4());
+      handle.stop().then(() => logOk("Stopped.")).catch((e) => logErr(`stop failed: ${e instanceof Error ? e.message : String(e)}`)).finally(() => resolve5());
     };
     process.on("SIGINT", onSig);
   });
@@ -3582,6 +3668,12 @@ function makeHarnessCommand() {
   ).action(async (name, opts) => {
     await runHarnessSet(name, path19__default.resolve(opts.projectDir), opts);
   });
+  cmd.command("list").description(
+    "List the harnesses run, repl and config set harness take, and whether the release tests cover them"
+  ).option("--project-dir <path>", "Project directory", process.cwd()).option("--json", "Machine-readable output").action(async (opts) => {
+    await loadDeclaredPlugins(path19__default.resolve(opts.projectDir));
+    runHarnessList(opts);
+  });
   cmd.command("status").description("Report each harness's installed program, version, SDK and login").option(
     "--project-dir <path>",
     "Project whose node_modules the SDK probe looks in",
@@ -3592,6 +3684,34 @@ function makeHarnessCommand() {
   helpOnBareGroup(cmd);
   return cmd;
 }
+function runHarnessList(opts) {
+  const rows = listHarnesses().map((h) => ({
+    id: h.id,
+    name: h.name,
+    stability: h.stability ?? null
+  }));
+  if (opts.json) {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+  const cols = [
+    { header: "harness", cell: (r) => r.id },
+    { header: "stability", cell: (r) => r.stability ?? "-" },
+    { header: "name", cell: (r) => r.name }
+  ];
+  const widths = cols.map((c) => Math.max(c.header.length, ...rows.map((r) => c.cell(r).length)));
+  const fmt = (parts) => parts.map((p6, i) => p6.padEnd(widths[i] ?? p6.length)).join("  ");
+  console.log();
+  console.log(`  ${S.heading(fmt(cols.map((c) => c.header)))}`);
+  for (const r of rows) console.log(`  ${fmt(cols.map((c) => c.cell(r)))}`);
+  console.log();
+  if (rows.some((r) => r.stability === "experimental")) {
+    console.log(
+      `  ${S.dim("experimental: not covered by the release tests (smoke only: run --dry-run)")}`
+    );
+    console.log();
+  }
+}
 function loginSuffix(login) {
   if (!login) return "";
   if (login.status === "ok") return `  login: ok${login.detail ? ` (${login.detail})` : ""}`;
@@ -4542,7 +4662,7 @@ async function reindexLibrary(lib, library, name) {
     resolved.publisher
   );
   const { removed, unknownKind, skipped, failed, renamed, superseded, versionAdded } = await syncManifestWithDisk(lib.path, resolved.publisher, registry, {
-    check: (e) => checkAssetFile(e.source, e.kind, registry, lib.path, composeRefs),
+    check: (e) => checkAssetFile("index", 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 }, path19.basename(e.source)) !== void 0
   });
@@ -4565,14 +4685,12 @@ async function reindexLibrary(lib, library, name) {
   reportVersionsAdded(versionAdded, manifest);
   const invalidVersion = skipped.filter((x) => x.reason === "invalid-version");
   for (const s of invalidVersion) {
-    const found = checkAssetFile(path19.join(lib.path, s.file), s.kind, registry).find(
-      (f) => f.text.startsWith("version ")
-    );
-    const detail = found?.text ?? s.detail;
-    const hint = detail.includes("Write it quoted") ? "" : " Set a valid `metadata.version` (e.g. 0.1.0).";
-    logErr(
-      `${s.kind}:${s.name} skipped: ${detail}.${hint} Re-run \`skaile library index ${name}\` after the fix.`
+    const lines = checkAssetFile("index", path19.join(lib.path, s.file), s.kind, registry).map(
+      (f) => `${s.file} [${f.tag}] \u2014 ${f.text}`
     );
+    for (const line of lines.length > 0 ? lines : [`${s.file} [${s.kind}] \u2014 ${s.detail}`]) {
+      logErr(line);
+    }
   }
   const duplicates = skipped.filter((x) => x.reason === "duplicate");
   for (const s of duplicates) {
@@ -4614,8 +4732,13 @@ async function reindexLibrary(lib, library, name) {
     if (a.source) continue;
     const file = findEntryManifestFile(lib.path, a);
     if (!file) continue;
+    const rel = path19.relative(lib.path, file);
     for (const f of unheldRequiresOfFile(file, a.kind, composeRefs)) {
-      logWarn(`${path19.relative(lib.path, file)} [${f.tag}] \u2014 ${f.text}`);
+      logWarn(`${rel} [${f.tag}] \u2014 ${f.text}`);
+    }
+    const checked = checkAssetFileFull("index", file, a.kind, registry, lib.path, composeRefs);
+    for (const f of checked.warnings.filter((w) => w.unheldRef === void 0)) {
+      logWarn(`${rel} [${f.tag}] \u2014 ${f.text}`);
     }
   }
   const skippedUnparsable = unparsable.length + syncUnparsable.length;
@@ -4656,10 +4779,30 @@ async function reindexLibrary(lib, library, name) {
 async function indexPulledLibrary(lib, library, name) {
   const res = await indexLibrary(lib, library);
   for (const e of res.errors) logWarn(e);
+  warnDanglingEntries(res.errors, lib, name);
   logOk(`Indexed ${res.assetsUpdated} asset(s) from ${name}.`);
   warnUnlistedAssets(await countUnlistedAssets(lib.path), name, lib.ownership);
   warnIgnoredDomainFiles(lib.path);
 }
+function warnDanglingEntries(errors, lib, name) {
+  const reader = lib.ownership === "reader";
+  let missing = false;
+  for (const e of errors) {
+    const root = /root "(.*)" contains no files$/.exec(e)?.[1];
+    if (root === void 0) continue;
+    if (!fs8.existsSync(path19.resolve(lib.path, root))) {
+      missing = true;
+      continue;
+    }
+    logWarn(
+      reader ? `Ask the owner: root "${root}" holds no files; add the asset's files, or drop the entry.` : `root "${root}" holds no files: add the asset's files, or drop the entry.`
+    );
+  }
+  if (!missing) return;
+  logWarn(
+    reader ? `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.` : `A manifest entry has no folder; run \`skaile library index ${name}\` to drop it from ${SKAILE_MANIFEST_FILENAME}.`
+  );
+}
 function warnUnlistedAssets(unlisted, name, ownership) {
   if (unlisted === 0) return;
   const fix = ownership !== "reader" ? `run \`skaile library index ${name}\`.` : `add them to ${SKAILE_MANIFEST_FILENAME} in the source repo and pull, or, for your own repo, run \`skaile library set ${name} ownership=owner\` and then \`skaile library index ${name}\`.`;
@@ -5007,7 +5150,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-57422ULT.js');
+  const { isGithubRemote, notGithubRemoteMessage } = await import('../library-publish-F3AKF66O.js');
   if (!isGithubRemote(url)) logWarn(notGithubRemoteMessage(name, url));
 }
 function scaffoldLibraryFiles(dir, name) {
@@ -5059,7 +5202,7 @@ async function refuseRemoteOfSource(manager, 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 && isSameRemote(l.backendConfig.url, url)
+    (l) => path19.resolve(l.path).startsWith(cacheRoot) && "url" in l.backendConfig && sameRepo(l.backendConfig.url, url)
   );
   if (!clash) return;
   logErr(
@@ -5395,15 +5538,21 @@ function makeLibraryCommand() {
           process.exit(1);
         }
       }
-      if (!isValidAssetName(name)) {
-        logErr(`Invalid asset name "${name}": ${ASSET_NAME_HINT}.`);
+      const nameKind = opts.kind ?? kind ?? "skill";
+      const nameProblem = identityFindings({
+        kind: nameKind,
+        parsed: nameKind === "flow" ? { id: name } : { name },
+        body: void 0,
+        dirName: name
+      })[0];
+      if (nameProblem) {
+        logErr(nameProblem.text);
         process.exit(1);
       }
       if (opts.publisher !== void 0) requireValidPublisherOrExit(opts.publisher);
       if (opts.description !== void 0) {
-        const len = opts.description.trim().length;
-        if (len === 0 || len > 1024) {
-          logErr("--description must be 1\u20131024 characters (Agent Skills spec).");
+        if (opts.description.trim().length === 0) {
+          logErr("--description must not be empty.");
           process.exit(1);
         }
       }
@@ -5423,6 +5572,11 @@ function makeLibraryCommand() {
           process.exit(1);
         }
         if (opts.dir) assertCreateDirInsideLibrary(libRoot, destDir, opts.dir);
+        const skippedDir = opts.dir ? assetPathProblem(opts.dir) : void 0;
+        if (skippedDir) {
+          logErr(`--dir "${opts.dir}": ${skippedDir}`);
+          process.exit(1);
+        }
         const taken = conflictingAssetRoot(
           libRoot,
           effectiveKind,
@@ -5457,7 +5611,11 @@ function makeLibraryCommand() {
           );
         }
         const scaffoldFile = findAssetManifestFile(res.path, effectiveKind, name);
-        const scaffoldProblems = scaffoldFile ? checkAssetFile(scaffoldFile, effectiveKind, getKindRegistry()) : [];
+        const scaffoldChecked = scaffoldFile ? checkAssetFileFull("create", scaffoldFile, effectiveKind, getKindRegistry()) : { errors: [], warnings: [] };
+        const scaffoldProblems = scaffoldChecked.errors;
+        for (const w of scaffoldChecked.warnings) {
+          logWarn(`${path19.relative(target.path, scaffoldFile ?? "")} [${w.tag}] \u2014 ${w.text}`);
+        }
         const { ref } = await registerLibraryAsset(target, library, {
           kind: effectiveKind,
           name,
@@ -5851,16 +6009,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-57422ULT.js');
+      const { runLibraryPublish } = await import('../library-publish-F3AKF66O.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-57422ULT.js');
+    const { runLibraryRegister } = await import('../library-publish-F3AKF66O.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-57422ULT.js');
+    const { runLibraryYank } = await import('../library-publish-F3AKF66O.js');
     await withStoreErrorHandling(() => runLibraryYank(lib, opts));
   });
   return cmd;
@@ -6520,7 +6678,7 @@ function scheduleSoftDepPreview() {
 }
 async function loadAssets() {
   softDepPreviewCache.clear();
-  const { gatherAssetFeeds } = await import('../asset-feeds-PM7FKHJP.js');
+  const { gatherAssetFeeds } = await import('../asset-feeds-ON7FYHHF.js');
   const { entries, notes } = await gatherAssetFeeds(am, am.projectDir);
   if (notes.length > 0) {
     state.message = notes.map((n) => `[${n.feed}] ${n.message}`).join(" \u2022 ");
@@ -6724,7 +6882,7 @@ function reconcileCollapsedSets(rows) {
 async function loadSourcesAndLibraries() {
   try {
     const [{ openLibraryManager: openLibraryManager2 }, { getGlobalCacheDir: getGlobalCacheDir2, globalSkaileDir: globalSkaileDir2 }] = await Promise.all([
-      import('../open-library-EVUKLOV7.js'),
+      import('../open-library-FVV6GG4I.js'),
       import('../core/index.js')
     ]);
     const { manager, library, close } = await openLibraryManager2();
@@ -7191,10 +7349,10 @@ async function showInfo() {
   }
   console.log();
   console.log(pc5.dim("  Press any key to return..."));
-  await new Promise((resolve4) => {
+  await new Promise((resolve5) => {
     const onData = () => {
       process.stdin.removeListener("data", onData);
-      resolve4();
+      resolve5();
     };
     process.stdin.once("data", onData);
   });
@@ -8631,10 +8789,10 @@ function planMarkdownMoves(root, knownKinds, manual, unknownTypes, identities, c
         );
         continue;
       }
-      const present2 = existing.get(identity);
-      if (present2 !== void 0) {
+      const present = existing.get(identity);
+      if (present !== void 0) {
         conflicts.push(
-          `${present2} already is ${identity}, and ${posix2(path19__default.relative(root, file))} would become it too: rename one first. Nothing was changed.`
+          `${present} already is ${identity}, and ${posix2(path19__default.relative(root, file))} would become it too: rename one first. Nothing was changed.`
         );
         continue;
       }
@@ -8751,10 +8909,10 @@ function planBundles(root, skaileYamls, publisher, notes, manual, conflicts, ide
       notConverted.push(`${origin.replace(/\/$/, "")} (${rel(target)} exists)`);
       return;
     }
-    const present2 = existing.get(identity);
-    if (present2 !== void 0) {
+    const present = existing.get(identity);
+    if (present !== void 0) {
       conflicts.push(
-        `${present2} already is ${identity}, and ${origin} would become it too: rename the bundle first. Nothing was changed.`
+        `${present} already is ${identity}, and ${origin} would become it too: rename the bundle first. Nothing was changed.`
       );
       return;
     }
@@ -9881,14 +10039,14 @@ function action2(fn) {
     try {
       await fn(...args);
     } catch (err) {
-      const { condensePluginFailure } = await import('../plugin-store-ZC3EGZ3D.js');
+      const { condensePluginFailure } = await import('../plugin-store-MVTW6G7J.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-ZC3EGZ3D.js');
+  const { reconcilePlugins } = await import('../plugin-store-MVTW6G7J.js');
   if (plugins.length === 0) {
     logInfo("No plugins declared \u2014 nothing to reconcile.");
     return;
@@ -9899,14 +10057,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-ZC3EGZ3D.js');
+    const { condensePluginFailure } = await import('../plugin-store-MVTW6G7J.js');
     logWarn(
       `reconcile skipped: ${condensePluginFailure(err instanceof Error ? err.message : String(err))}`
     );
   }
 }
 async function verifyPluginLoads(projectDir, spec, declared) {
-  const { loadPlugins } = await import('../plugin-store-ZC3EGZ3D.js');
+  const { loadPlugins } = await import('../plugin-store-MVTW6G7J.js');
   const { createPluginRegistry } = await import('../plugin-registry/index.js');
   const registry = createPluginRegistry();
   await loadPlugins(
@@ -9929,7 +10087,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-ZC3EGZ3D.js');
+  const { specName, rollbackPluginStore, npmSpecError, projectRelativeFileSpec } = await import('../plugin-store-MVTW6G7J.js');
   const specError = npmSpecError(rawSpec);
   if (specError) throw new Error(specError);
   const spec = projectRelativeFileSpec(rawSpec, process.cwd(), projectDir);
@@ -9966,7 +10124,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-ZC3EGZ3D.js');
+  const { specName } = await import('../plugin-store-MVTW6G7J.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}.`);
@@ -9982,7 +10140,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-ZC3EGZ3D.js');
+    const { rollbackPluginStore } = await import('../plugin-store-MVTW6G7J.js');
     await rollbackPluginStore(projectDir, []);
     logInfo("No plugins declared; removed .skaile/plugins/.");
     return;
@@ -10005,7 +10163,7 @@ async function runList(opts) {
   const registry = createPluginRegistry();
   if (declared.length > 0) {
     try {
-      const { loadPlugins } = await import('../plugin-store-ZC3EGZ3D.js');
+      const { loadPlugins } = await import('../plugin-store-MVTW6G7J.js');
       const result = await loadPlugins(projectDir, declared, registry);
       for (const f of result.failed) logWarn(f.error);
     } catch (err) {
@@ -10088,11 +10246,11 @@ function presetItemsToWorkspace(preset, values) {
 }
 function resolveItemConfig(item, preset, values, envVarsToSet) {
   const byKey = placeholderIndex(item, preset);
-  const resolve4 = (key) => {
+  const resolve5 = (key) => {
     const ph = byKey.get(key) ?? { key, type: "text", required: true };
     return resolvePlaceholderValue(ph, values[key]);
   };
-  return substituteNode(item.config ?? {}, resolve4, envVarsToSet);
+  return substituteNode(item.config ?? {}, resolve5, envVarsToSet);
 }
 function placeholderIndex(item, preset) {
   const map = /* @__PURE__ */ new Map();
@@ -10100,20 +10258,20 @@ function placeholderIndex(item, preset) {
   for (const ph of item.placeholders ?? []) map.set(ph.key, ph);
   return map;
 }
-function substituteNode(node, resolve4, envVarsToSet) {
-  if (typeof node === "string") return substituteString(node, resolve4, envVarsToSet);
-  if (Array.isArray(node)) return node.map((el) => substituteNode(el, resolve4, envVarsToSet));
+function substituteNode(node, resolve5, envVarsToSet) {
+  if (typeof node === "string") return substituteString(node, resolve5, envVarsToSet);
+  if (Array.isArray(node)) return node.map((el) => substituteNode(el, resolve5, envVarsToSet));
   if (node && typeof node === "object") {
     const out = {};
-    for (const [k, v] of Object.entries(node)) out[k] = substituteNode(v, resolve4, envVarsToSet);
+    for (const [k, v] of Object.entries(node)) out[k] = substituteNode(v, resolve5, envVarsToSet);
     return out;
   }
   return node;
 }
-function substituteString(value, resolve4, envVarsToSet) {
+function substituteString(value, resolve5, envVarsToSet) {
   const tokens = [...value.matchAll(TOKEN_RE)];
   if (tokens.length === 0) return value;
-  const secret = tokens.find(([, ns]) => ns === "SECRET") ?? tokens.find(([, , key]) => "envRef" in resolve4(key));
+  const secret = tokens.find(([, ns]) => ns === "SECRET") ?? tokens.find(([, , key]) => "envRef" in resolve5(key));
   if (secret) {
     const [full, , key] = secret;
     if (tokens.length > 1 || full !== value) {
@@ -10125,7 +10283,7 @@ function substituteString(value, resolve4, envVarsToSet) {
     return `env:${key}`;
   }
   return value.replace(TOKEN_RE, (_m, _ns, key) => {
-    const resolved = resolve4(key);
+    const resolved = resolve5(key);
     return "envRef" in resolved ? resolved.envRef : resolved.value;
   });
 }
@@ -10174,11 +10332,11 @@ function buildPresetFromWorkspace(config, name, sources = []) {
   };
 }
 function neededSources(config, lock) {
-  const factoryUrl = normalizeRepoUrl(FACTORY_SOURCE_URL);
-  const nonFactory = (config.sources ?? []).filter((s) => normalizeRepoUrl(s.url) !== factoryUrl);
+  const factoryUrl = repoIdentity(FACTORY_SOURCE_URL).key;
+  const nonFactory = (config.sources ?? []).filter((s) => repoIdentity(s.url).key !== factoryUrl);
   if (!lock) return nonFactory;
-  const inClosure = new Set(lock.sources.map((s) => normalizeRepoUrl(s.url)));
-  return nonFactory.filter((s) => inClosure.has(normalizeRepoUrl(s.url)));
+  const inClosure = new Set(lock.sources.map((s) => repoIdentity(s.url).key));
+  return nonFactory.filter((s) => inClosure.has(repoIdentity(s.url).key));
 }
 function sourcesWithSidecar(sources) {
   return sources.filter((s) => existsSync(storeManifestFile(s.url))).map((s) => s.url);
@@ -10534,10 +10692,10 @@ function applyItems(editor, config, items) {
     unchangedSources: []
   };
   const existingSourceUrls = new Map(
-    editor.getSources().map((src) => [normalizeRepoUrl(src.url), src])
+    editor.getSources().map((src) => [repoIdentity(src.url).key, src])
   );
   for (const src of items.sources) {
-    const key = normalizeRepoUrl(src.url);
+    const key = repoIdentity(src.url).key;
     const existing = existingSourceUrls.get(key);
     if (!existing) {
       editor.setSource(src);
@@ -10872,61 +11030,6 @@ async function sessionIdsHint(projectDir) {
   return sessions.length > 0 ? "Run skaile session list to see the ids." : null;
 }
 
-// cli/src/commands/harness-preflight.ts
-var present = (...lines) => lines.filter((l) => !!l);
-var OR_PICK_ANOTHER = "Or pick another harness with --harness.";
-function missingBinary(harnessId) {
-  const hint = HARNESS_BINARIES[harnessId]?.hint ?? `${harnessId} is not installed.`;
-  return `${hint} ${OR_PICK_ANOTHER}`;
-}
-var claudeSdk = async (input, deps) => present(
-  await deps.sdkProblem(input.projectDir, input.harness),
-  checkHarnessModel("claude-sdk", input),
-  checkModelSurface("claude-sdk", input)
-);
-var codex = async (input, deps) => present(
-  await deps.sdkProblem(input.projectDir, input.harness),
-  checkHarnessModel("codex", input),
-  deps.codexCredential(input)
-);
-var omp = async (input, deps) => {
-  if (!deps.hasBinary("omp")) return [missingBinary("omp")];
-  const refusal = checkHarnessModel("omp", input);
-  if (refusal) return [refusal];
-  const own = input.model && !input.model.startsWith("@") ? input.model : void 0;
-  const unlisted = own && isUnlistedModel(input);
-  return present(unlisted ? await deps.ompListed(own) : void 0);
-};
-function cliHarness(harnessId) {
-  return async (input, deps) => deps.hasBinary(harnessId) ? present(checkHarnessModel(harnessId, input), checkModelSurface(harnessId, input)) : [missingBinary(harnessId)];
-}
-var PREFLIGHTS = {
-  "claude-sdk": claudeSdk,
-  codex,
-  omp,
-  gemini: cliHarness("gemini"),
-  qwen: cliHarness("qwen"),
-  opencode: cliHarness("opencode"),
-  goose: cliHarness("goose"),
-  continue: cliHarness("continue")
-};
-async function preflightHarness(input, deps = {}) {
-  const check = PREFLIGHTS[input.harness];
-  if (!check) return [];
-  return check(
-    {
-      ...input,
-      registry: input.registry ?? loadRegistryView({ projectDir: input.projectDir }).merged
-    },
-    {
-      hasBinary: deps.hasBinary ?? ((id) => resolveHarnessBinary(HARNESS_BINARIES[id]) !== void 0),
-      sdkProblem: deps.sdkProblem ?? checkHarnessSdk,
-      ompListed: deps.ompListed ?? checkOmpListedModel,
-      codexCredential: deps.codexCredential ?? checkCodexCredential
-    }
-  );
-}
-
 // cli/src/commands/run.ts
 function resolveSingleShotAgentDir(projectDir, agentDefinition) {
   if (!agentDefinition) return resolveAgentDir(projectDir);
@@ -10944,6 +11047,51 @@ async function printCompositionDryRun(projectDir, agentDir, harness, model, chec
   await printCompositionPlan(projectDir, agentDir, manifest, harness, model, instanceIdOverride);
   return reportPreflight(await check(model ?? manifestModelForHarness(manifest, harness)));
 }
+async function printAgentPrompt(projectDir, agentDir, harness, instanceIdOverride, json) {
+  if (!agentDir) {
+    logErr(
+      "No agent definition: the project has no `agent:` and neither --instance nor --agent-definition picks one, so there is no agent prompt to print."
+    );
+    return false;
+  }
+  const manifest = await loadAgentManifest(agentDir);
+  if (!manifest) {
+    logErr(`${agentDir} has no agent.yaml or AGENT.md: not an agent package.`);
+    return false;
+  }
+  const wsConfig = resolveSkWorkspaceConfig(projectDir);
+  const { instanceId: instanceId2, instance } = instanceForSession(wsConfig, instanceIdOverride, agentDir);
+  const resolved = await resolveAgentInstance({
+    instanceId: instanceId2,
+    instance,
+    asset: { manifest, dir: agentDir },
+    projectDir,
+    registry: getKindRegistry(),
+    host: { nativeSubagents: harnessNameForHarnessId(harness) !== void 0 },
+    dryRun: true
+  });
+  const { composed, memory } = agentPromptInput(resolved, []);
+  const assembled = await assembleAgentPrompt({
+    srcDir: agentDir,
+    projectDir,
+    harness,
+    instanceId: instanceId2,
+    instance,
+    wsConfig,
+    resolved: { composed, memory }
+  });
+  if (!assembled) {
+    logErr(`${agentDir} has no agent.yaml or AGENT.md: not an agent package.`);
+    return false;
+  }
+  for (const warning of resolved.warnings) logWarnErr(warning);
+  process.stdout.write(
+    json ? `${JSON.stringify({ agent: instanceId2, harness, prompt: assembled.sentPrompt })}
+` : `${assembled.sentPrompt}
+`
+  );
+  return true;
+}
 async function printCompositionPlan(projectDir, agentDir, manifest, harness, model, instanceIdOverride) {
   console.log();
   console.log(`  ${S.label("Project dir:")} ${projectDir}`);
@@ -11014,7 +11162,7 @@ async function printSkillDryRun(projectDir, skill) {
     return false;
   }
   const content = fs8__default.readFileSync(file, "utf-8");
-  const prerequisiteErrors = checkAssetFile(file, "skill", getKindRegistry()).filter(
+  const prerequisiteErrors = checkAssetFile("validate", file, "skill", getKindRegistry()).filter(
     (f) => f.text.startsWith("metadata.prerequisites")
   );
   if (prerequisiteErrors.length > 0) {
@@ -11122,9 +11270,10 @@ function harnessOptionDescription() {
   return `Harness to run (${listHarnesses().map((d) => d.id).join(", ")}); claude-code (deploy) = claude-sdk (run)`;
 }
 function reportPreflight(problems) {
-  for (const line of problems) logErr(line);
+  for (const { line } of problems) logErr(line);
   return problems.length > 0;
 }
+var START_CHECKS = ["start", "refusal", "readiness"];
 function nodeSkillRefs(flow) {
   const refs = /* @__PURE__ */ new Map();
   for (const node of flow.nodes) {
@@ -11163,16 +11312,31 @@ function makeRunCommand() {
   ).option(
     "--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) => {
+  ).option(
+    "--print-prompt",
+    "With --dry-run: print the agent prompt a run assembles (the body of the native agent file) on stdout and nothing else, then exit 0; exit 1 when there is no agent definition"
+  ).option("--json", "With --print-prompt: print { agent, harness, prompt } as one JSON line").option("--skill <name>", "Skill name (for single-shot mode)").action(async (positional, opts) => {
     const projectDir = path19__default.resolve(opts.projectDir);
     await loadDeclaredPlugins(projectDir);
+    if (opts.printPrompt) warnProjectConfig(projectDir, { stderr: true });
     if (await reportProjectConfig(projectDir, { harness: false, instances: true }) > 0) {
       process.exit(1);
     }
-    const cliHarness2 = canonicalHarnessId(
+    const cliHarness = canonicalHarnessId(
       foldDriverFlag(opts).harness
     );
     const dryRun = opts.dryRun ?? false;
+    const printPrompt = opts.printPrompt ?? false;
+    if (printPrompt && !dryRun) {
+      logErr(
+        "--print-prompt needs --dry-run: `skaile run --dry-run --print-prompt` prints the prompt and starts nothing."
+      );
+      process.exit(1);
+    }
+    if (opts.json && !printPrompt) {
+      logErr("--json on `run` only goes with --print-prompt.");
+      process.exit(1);
+    }
     const agentDefinition = opts.agentDefinition?.trim() || void 0;
     const instanceId2 = opts.instance?.trim() || void 0;
     if (instanceId2 && agentDefinition) {
@@ -11181,8 +11345,8 @@ function makeRunCommand() {
       );
       process.exit(1);
     }
-    let flowId = positional[0];
-    if (!flowId) {
+    let flowId = positional[0] ?? "";
+    if (!flowId && !printPrompt) {
       const flows = discoverProjectFlows(projectDir);
       if (flows.length === 0) {
         logErr(
@@ -11205,17 +11369,34 @@ function makeRunCommand() {
       flowId = selected;
     }
     const config = await resolveSettings(projectDir, {
-      harness: cliHarness2,
+      harness: cliHarness,
       model: opts.model
     });
     const harness = config.harness ?? DEFAULT_HARNESS_ID;
     const model = config.model;
-    const unknownHarness = unknownHarnessMessage(harness);
+    const [unknownHarness] = await preflight({ projectDir }, harness, void 0, void 0, {
+      checks: ["harness"]
+    });
     if (unknownHarness) {
-      logErr(unknownHarness);
+      logErr(unknownHarness.line);
       process.exit(1);
     }
-    const preflightFor = (forModel) => preflightHarness({ projectDir, harness, model: forModel, roles: config.roles });
+    noteExperimentalHarness(harness);
+    if (printPrompt) {
+      try {
+        const agentDir = instanceId2 ? resolveInstanceAgentDir(projectDir, resolveSkWorkspaceConfig(projectDir), instanceId2) : resolveSingleShotAgentDir(projectDir, agentDefinition);
+        if (!await printAgentPrompt(projectDir, agentDir, harness, instanceId2, opts.json === true)) {
+          process.exit(1);
+        }
+      } catch (err) {
+        logErr(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+      }
+      return;
+    }
+    const preflightFor = (forModel) => preflight({ projectDir, roles: config.roles }, harness, forModel, void 0, {
+      checks: START_CHECKS
+    });
     const flowPath = findProjectFlowFile(flowId, projectDir);
     if (flowPath && agentDefinition) {
       logErr(
@@ -11286,6 +11467,7 @@ function makeRunCommand() {
             );
           }
         }
+        await refreshStaleAgentFiles({ projectDir, harness: config.harness });
         await runAgentChat({
           projectDir,
           ...agentDir ? { agentDir } : {},
@@ -11381,12 +11563,13 @@ function makeResumeCommand() {
         harness: session.harness,
         model: session.model
       });
-      return preflightHarness({
-        projectDir,
-        harness: settings.harness ?? DEFAULT_HARNESS_ID,
-        model: settings.model,
-        roles: settings.roles
-      });
+      return preflight(
+        { projectDir, roles: settings.roles },
+        settings.harness ?? DEFAULT_HARNESS_ID,
+        settings.model,
+        void 0,
+        { checks: START_CHECKS }
+      );
     };
     if (!dryRun && reportPreflight(await preflightLines())) process.exit(1);
     console.log();
@@ -11508,6 +11691,7 @@ function makeReplCommand() {
       harness: harnessOverride,
       model: opts.model
     });
+    noteExperimentalHarness(effective.harness ?? DEFAULT_HARNESS_ID);
     let effectiveModel = effective.model;
     if (!opts.model && instanceId2) {
       try {
@@ -11518,14 +11702,16 @@ function makeReplCommand() {
       } catch {
       }
     }
-    const preflight = await preflightHarness({
-      projectDir,
-      harness: effective.harness ?? DEFAULT_HARNESS_ID,
-      model: effectiveModel,
-      roles: effective.roles
-    });
-    if (reportPreflight(preflight)) process.exit(1);
+    const problems = await preflight(
+      { projectDir, roles: effective.roles },
+      effective.harness ?? DEFAULT_HARNESS_ID,
+      effectiveModel,
+      void 0,
+      { checks: START_CHECKS }
+    );
+    if (reportPreflight(problems)) process.exit(1);
     try {
+      await refreshStaleAgentFiles({ projectDir, harness: harnessOverride });
       await startRepl({
         projectDir,
         cwd: agentCwd !== projectDir ? agentCwd : void 0,
@@ -11663,7 +11849,7 @@ function makeServeCommand() {
         process.exitCode = 1;
         return;
       }
-      const dirProblem = (await import('../serve-preflight-YY3YC6GH.js')).checkServeProjectDir(
+      const dirProblem = (await import('../serve-preflight-XJS5OZML.js')).checkServeProjectDir(
         opts.projectDir
       );
       if (dirProblem) {
@@ -11692,7 +11878,7 @@ function makeServeCommand() {
       }
       let providers = parseProviderIds(opts.providers);
       if (!managedCodex) {
-        const { resolveServeProvider } = await import('../serve-preflight-YY3YC6GH.js');
+        const { resolveServeProvider } = await import('../serve-preflight-XJS5OZML.js');
         const picked = resolveServeProvider(opts.projectDir, opts.provider, providers);
         if ("problem" in picked) {
           logErr(picked.problem);
@@ -11702,37 +11888,43 @@ function makeServeCommand() {
         providers = [...picked.providers];
       }
       const modelEndpoint = parseModelEndpointFlag(opts.modelEndpoint, opts.modelEndpointAgent);
-      const { checkHarnessSdk: checkHarnessSdk2, checkModelEndpointPeer, checkServeModel } = await import('../serve-preflight-YY3YC6GH.js');
-      const { checkServeHarness, checkServeAgents, checkServeConnectors } = await import('../serve-preflight-YY3YC6GH.js');
-      const startProblem = managedCodex ? null : await checkServeHarness(opts.projectDir, opts.harness) ?? checkServeAgents(opts.projectDir) ?? await checkServeConnectors(opts.projectDir);
-      if (startProblem) {
-        logErr(startProblem);
-        process.exitCode = 1;
-        return;
-      }
-      const harnessProblem = managedCodex ? null : await checkHarnessSdk2(opts.projectDir, opts.harness);
-      if (harnessProblem) {
-        logErr(harnessProblem);
-        process.exitCode = 1;
-        return;
-      }
-      const endpointProblem = managedCodex ? null : await checkModelEndpointPeer(opts.projectDir, modelEndpoint);
-      if (endpointProblem) {
-        logErr(endpointProblem);
-        process.exitCode = 1;
-        return;
-      }
-      const modelProblem = managedCodex ? null : await checkServeModel(opts.projectDir, {
-        harness: opts.harness,
-        model: opts.model,
-        providers
-      });
-      if (modelProblem) {
-        logErr(modelProblem);
-        process.exitCode = 1;
-        return;
+      if (!managedCodex) {
+        const { preflight: preflight2 } = await import('../bridge/index.js');
+        const {
+          agentRefLookups,
+          checkModelEndpointPeer,
+          checkServeConnectors,
+          resolveServeStart,
+          serveAgentRef,
+          servesLocalRegistry
+        } = await import('../serve-preflight-XJS5OZML.js');
+        const { harness, model } = await resolveServeStart(opts.projectDir, {
+          harness: opts.harness,
+          model: opts.model
+        });
+        const stage = async (checks, agentRef) => (await preflight2(
+          { projectDir: opts.projectDir, providers },
+          harness,
+          model,
+          agentRef,
+          {
+            checks,
+            serve: true,
+            agentRefs: agentRefLookups
+          }
+        ))[0]?.line;
+        const problem = await stage(["harness", "agent"], serveAgentRef(opts.projectDir)) ?? await checkServeConnectors(opts.projectDir) ?? await stage(["start"]) ?? await checkModelEndpointPeer(opts.projectDir, modelEndpoint) ?? (model && servesLocalRegistry(opts.projectDir) ? await stage(["refusal", "readiness"]) : void 0);
+        if (problem) {
+          logErr(problem);
+          process.exitCode = 1;
+          return;
+        }
       }
       try {
+        if (!managedCodex) {
+          const { refreshStaleAgentFiles: refreshStaleAgentFiles2 } = await import('../agent-file-refresh-76NNFB4W.js');
+          await refreshStaleAgentFiles2({ projectDir: opts.projectDir, harness: opts.harness });
+        }
         await startAgentServer({
           port,
           ...opts.host ? { host: opts.host } : {},
@@ -11770,12 +11962,12 @@ function makeServeCommand() {
   );
 }
 async function ensurePluginsLoadedForServe(projectDir) {
-  const { logInfo: logInfo2, logWarn: logWarn2 } = await import('../helpers-U75UGGH5.js');
+  const { logInfo: logInfo2, logWarn: logWarn2 } = await import('../helpers-26MR5QPO.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-ZC3EGZ3D.js');
+    const { ensurePluginsLoaded } = await import('../plugin-store-MVTW6G7J.js');
     const { pluginRegistry } = await import('../plugin-registry/index.js');
     const result = await ensurePluginsLoaded(projectDir, config.plugins, pluginRegistry);
     if (result.loaded.length > 0) {
@@ -11789,14 +11981,14 @@ async function ensurePluginsLoadedForServe(projectDir) {
   }
 }
 async function runCompileTest(opts) {
-  const { logOk: logOk2, logErr: logErr2, logInfo: logInfo2, S: S2 } = await import('../helpers-U75UGGH5.js');
+  const { logOk: logOk2, logErr: logErr2, logInfo: logInfo2, S: S2 } = await import('../helpers-26MR5QPO.js');
   const { tmpdir } = await import('os');
-  const { dirname: dirname3, join: join6, resolve: resolve4 } = await import('path');
+  const { dirname: dirname4, join: join6, resolve: resolve5 } = await import('path');
   const { fileURLToPath: fileURLToPath2 } = await import('url');
   const { unlinkSync, existsSync: existsSync24 } = await import('fs');
   const { spawn } = await import('child_process');
   const { portableSpawnSync: portableSpawnSync2 } = await import('../core/index.js');
-  const { MONOREPO_ROOT } = await import('../paths-PXBWY532.js');
+  const { MONOREPO_ROOT } = await import('../paths-PIWSSUUG.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).");
@@ -11805,7 +11997,7 @@ async function runCompileTest(opts) {
   }
   const outfile = join6(tmpdir(), `skaile-compile-test-${Date.now()}`);
   const __thisFile = fileURLToPath2(import.meta.url);
-  const entryPoint = resolve4(dirname3(__thisFile), "..", "index.ts");
+  const entryPoint = resolve5(dirname4(__thisFile), "..", "index.ts");
   logInfo2(`Building compiled binary...`);
   logInfo2(`Entry: ${S2.dim(entryPoint)}`);
   logInfo2(`Output: ${S2.dim(outfile)}`);
@@ -12120,19 +12312,19 @@ function buildTailSelect(q) {
   return { sql, params };
 }
 function sleepUnlessAborted(ms, signal) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     if (signal?.aborted) {
-      resolve4();
+      resolve5();
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve4();
+      resolve5();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
       signal?.removeEventListener("abort", onAbort);
-      resolve4();
+      resolve5();
     };
     signal?.addEventListener("abort", onAbort, { once: true });
   });
@@ -12219,7 +12411,7 @@ async function remoteTail(opts) {
     ]
   });
   const filter = makeFilter(opts.query);
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     let settled = false;
     const finish2 = (err) => {
       if (settled) return;
@@ -12230,11 +12422,11 @@ async function remoteTail(opts) {
       }
       opts.signal?.removeEventListener("abort", onAbort);
       if (err) reject(err);
-      else resolve4();
+      else resolve5();
     };
     const onAbort = () => finish2();
     if (opts.signal?.aborted) {
-      resolve4();
+      resolve5();
       return;
     }
     opts.signal?.addEventListener("abort", onAbort, { once: true });
@@ -12756,8 +12948,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-EVUKLOV7.js');
-    const { getKnownKinds: getKnownKinds2 } = await import('../open-registry-4HNCWOCN.js');
+    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-FVV6GG4I.js');
+    const { getKnownKinds: getKnownKinds2 } = await import('../open-registry-VX2BVMS5.js');
     const projectDir = path19__default.resolve(opts.projectDir);
     if (opts.kind && !getKnownKinds2().has(opts.kind)) {
       logErr(
@@ -12815,8 +13007,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-EVUKLOV7.js');
-    const { supportsInstallManifest: supportsInstallManifest2 } = await import('../project-HB7OYPEF.js');
+    const { openCatalogSource: openCatalogSource2, LocalCatalogDisabledError: LocalCatalogDisabledError2 } = await import('../open-library-FVV6GG4I.js');
+    const { supportsInstallManifest: supportsInstallManifest2 } = await import('../project-GFQP4TW6.js');
     try {
       parseAssetRef(ref);
     } catch (e) {
@@ -13187,14 +13379,14 @@ async function needsCatalog(am2, projectDir) {
   try {
     const yamlPath = path19__default.join(projectDir, "skaile.yaml");
     declaredUrls = new Set(
-      WorkspaceYamlEditor.load(yamlPath).getSources().map((s) => normalizeRepoUrl(s.url))
+      WorkspaceYamlEditor.load(yamlPath).getSources().map((s) => repoIdentity(s.url).key)
     );
   } catch {
   }
-  const factoryUrl = normalizeRepoUrl(FACTORY_SOURCE_URL);
+  const factoryUrl = repoIdentity(FACTORY_SOURCE_URL).key;
   for (const [key, e] of Object.entries(lock?.assets ?? {})) {
     if (e.library !== void 0 || e.source === void 0) continue;
-    const url = normalizeRepoUrl(e.source.url);
+    const url = repoIdentity(e.source.url).key;
     if (declaredUrls.has(url)) continue;
     if (url === factoryUrl) {
       const { kind, name, publisher } = parseCanonicalLockKey(key);
@@ -13532,6 +13724,7 @@ Project:
   setup                        Interactive provider setup wizard
   config show|get|set          Personal settings
   harness set <name>           Switch the project to claude-code | omp | codex and install
+  harness list [--json]        List harnesses and whether the release tests cover them
 
 Assets (skill, agent, prompt, flow, preset, contract):
   add <ref> [--global]         Add to skaile.yaml + deploy
@@ -13800,7 +13993,7 @@ async function bootstrapUserConfig() {
 }
 async function hydrateInitSources(resolved, created) {
   try {
-    const { ensureSourcesCloned } = await import('../ensure-sources-I7GCXPXK.js');
+    const { ensureSourcesCloned } = await import('../ensure-sources-CI3JQJST.js');
     const hydrate = ensureSourcesCloned(resolved, { quiet: true });
     for (const n of hydrate.cloned) created.push(`~/.skaile/cache/sources/${n}/`);
     if (hydrate.failed.length > 0) {
@@ -13841,7 +14034,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-2XV6T53V.js');
+  const { cmdSetup } = await import('../setup-BFEBJLYF.js');
   await cmdSetup([], { projectDir: process.cwd() });
 });
 program.addCommand(makeInstallCommand());
@@ -13922,7 +14115,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-5QYXWC5H.js');
+  const { refreshPluginSkills } = await import('../claude-code-VL6UM7BZ.js');
   try {
     if (await refreshPluginSkills(projectDir)) {
       logInfo(`Updated ${S.cmd(".claude/plugins/skaile/skills")} (the --full plugin copy)`);