@skaile/workspaces 0.22.0-beta.1 → 0.22.0

package/dist/cli/index.js

@@ -1,23 +1,24 @@
 #!/usr/bin/env node
-import { openCatalogSource, openLibrary, createFullRegistry, openLibraryManager } from '../chunk-3ECS5PFD.js';
+import { openCatalogSource, openLibraryManager, createFullRegistry, openLibrary } from '../chunk-K2HDYSAM.js';
 import { logErr, S, logOk, colorRef, logInfo, logWarn, kindColorPad, kindColor, formatRelativeTime } from '../chunk-4NDWKA64.js';
-import { getStoreConfig, storeFetch, saveStoreTokens, clearStoreTokens, isStoreAuthenticated } from '../chunk-XIHFJVOD.js';
+import { getStoreConfig, storeFetch, saveStoreTokens, clearStoreTokens, isStoreAuthenticated } from '../chunk-WH2EB2SF.js';
 import { AI_RESOURCES } from '../chunk-2M3XTMOL.js';
 import { LocalSecretsProvider } from '../chunk-JDX54X4Y.js';
-import { resolveLibraryDir, LocalCatalogSource, skaileHomeDir } from '../chunk-JHF66MCK.js';
+import { resolveLibraryDir, LocalCatalogSource, skaileHomeDir } from '../chunk-MNAHNDUI.js';
 import '../chunk-R7FOF242.js';
-import '../chunk-D7K72XEY.js';
+import '../chunk-JN2CUVSU.js';
 import '../chunk-OKRUTSG7.js';
-import { runFlow, resumeFlow } from '../chunk-DKGDOALM.js';
+import { runFlow, resumeFlow } from '../chunk-53UNDY6K.js';
 import '../chunk-GCJXPUHG.js';
 import { validateFlowVersions, parseSkillFrontmatter } from '../chunk-IPUYL6TD.js';
-import { runAgentChat, loadSessionById, loadSession, listSessions, setCurrentSession, deleteSession, clearSession, loadAgentManifest, compileComposition, MarkdownStreamer, resolveMixin } from '../chunk-V3QMSM5I.js';
-import { buildClaudePluginFiles } from '../chunk-NJLHHZIW.js';
+import { runAgentChat, loadSessionById, loadSession, listSessions, setCurrentSession, deleteSession, clearSession, loadAgentManifest, compileComposition, MarkdownStreamer, resolveMixin } from '../chunk-SKXCTV55.js';
+import { buildClaudePluginFiles } from '../chunk-NDD5VMN5.js';
 import '../chunk-X5YPJV4N.js';
 import '../chunk-O7SG5PC2.js';
-import '../chunk-W2O5LWYU.js';
-import '../chunk-7PTP3SQJ.js';
-import '../chunk-PBWMV5GM.js';
+import '../chunk-7QBNJTTQ.js';
+import '../chunk-GTS2FODO.js';
+import '../chunk-WQ7DE5UC.js';
+import '../chunk-32NA4TVC.js';
 import '../chunk-W3UDISS2.js';
 import '../chunk-TDSRLMDB.js';
 import '../chunk-M5TE6YI5.js';
@@ -26,23 +27,23 @@ import '../chunk-KOVLSBXK.js';
 import '../chunk-RRVQAE5D.js';
 import '../chunk-6VTG73UY.js';
 import '../chunk-LV2HPH3C.js';
-import '../chunk-LT4DLEYE.js';
-import '../chunk-APAOQLPT.js';
+import '../chunk-OJN25VJO.js';
+import '../chunk-NBJ5TOEC.js';
 import '../chunk-6MB7CRME.js';
 import '../chunk-QAVZOJCV.js';
 import '../chunk-6E6PKKAD.js';
 import { loadAllFlows } from '../chunk-ICS76R4T.js';
 import '../chunk-GZWJGNNN.js';
 import '../chunk-FVTV7M76.js';
-import { AssetManager } from '../chunk-VCYXVP2S.js';
-import '../chunk-PTIHB2TV.js';
-import { readLock, resolveSettings, globalSettingsPath, projectSettingsPath, loadSettings, saveSettings, portableSpawn, portableSpawnSync, WorkspaceYamlEditor } from '../chunk-UMOENHVH.js';
+import { AssetManager } from '../chunk-7HSXUKNB.js';
+import '../chunk-2RYQERIT.js';
+import { readLock, resolveSettings, globalSettingsPath, projectSettingsPath, loadSettings, saveSettings, portableSpawn, portableSpawnSync, WorkspaceYamlEditor } from '../chunk-ETMUGBHF.js';
 import { DRIVER_DEFAULTS } from '../chunk-K5GBV4SA.js';
 import '../chunk-KLNL7QHN.js';
-import '../chunk-GFNW72LW.js';
-import { resolveSkWorkspaceConfig, resolveAgentDir, findWorkspaceRoot, workspaceConfigFilename } from '../chunk-J3VKAEQP.js';
-import '../chunk-4AZKT2BU.js';
-import { ASSET_KINDS } from '../chunk-I3UEM3FX.js';
+import '../chunk-PFOXL4SH.js';
+import { resolveSkWorkspaceConfig, resolveAgentDir, decodeSkaileYaml, findWorkspaceRoot, workspaceConfigFilename } from '../chunk-V5TBKO5Q.js';
+import { parseFrontmatter } from '../chunk-K7WPR77X.js';
+import { ASSET_KINDS, assetRefToStr } from '../chunk-VUCPJBAG.js';
 import '../chunk-JKNWJ64A.js';
 import { SUPPORTED_DRIVER_TARGETS } from '../chunk-O4JH3KUE.js';
 import { openSqlite } from '../chunk-24UIWON4.js';
@@ -53,7 +54,7 @@ import '../chunk-NELZIQ2E.js';
 import '../chunk-CGYEHQOX.js';
 import '../chunk-NSBPE2FW.js';
 import * as fs10 from 'fs';
-import fs10__default, { readFileSync, existsSync, writeFileSync, rmSync, statSync } from 'fs';
+import fs10__default, { readFileSync, existsSync, writeFileSync, readdirSync, rmSync, statSync } from 'fs';
 import * as path14 from 'path';
 import path14__default, { resolve, join } from 'path';
 import { fileURLToPath } from 'url';
@@ -309,7 +310,7 @@ function makeSearchCommand() {
     }
     if (showStore) {
       try {
-        const { getStoreConfig: getStoreConfig2, storeFetch: storeFetch2 } = await import('../store-client-5WBRUC5U.js');
+        const { getStoreConfig: getStoreConfig2, storeFetch: storeFetch2 } = await import('../store-client-JP642EEI.js');
         const config = getStoreConfig2();
         const params = {};
         if (query) params.q = query;
@@ -471,7 +472,7 @@ function makeCatalogCommand() {
     const cfg = resolveConfig({ projectDir });
     const baseUrl = opts.url ?? cfg.catalog.url;
     if (isLocalCatalogUrl(baseUrl)) {
-      const { resolveCatalogSource } = await import('../open-library-M4DB3D3J.js');
+      const { resolveCatalogSource } = await import('../open-library-CT4VVESU.js');
       let resolved;
       try {
         resolved = await resolveCatalogSource({ projectDir: opts.projectDir });
@@ -1432,7 +1433,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-AJ3FGXIC.js');
+    const { ensurePluginsLoaded } = await import('../plugin-store-QS7TC5HY.js');
     const result = await ensurePluginsLoaded(projectDir, config.plugins, pluginRegistry);
     for (const f of result.failed) logWarn(f.error);
   }
@@ -2203,48 +2204,28 @@ var state = {
   pendingAdds: /* @__PURE__ */ new Set(),
   pendingRemoves: /* @__PURE__ */ new Set(),
   collapsedSources: /* @__PURE__ */ new Set(),
-  collapsedDomains: /* @__PURE__ */ new Set(),
+  collapsedRepos: /* @__PURE__ */ new Set(),
   message: "",
   cols: 80,
   awaitingExitConfirm: false
 };
-function buildVisibleRows(rows, collapsedSources, collapsedDomains) {
+function buildVisibleRows(rows, collapsedSources, collapsedRepos) {
   return rows.filter((row) => {
-    if (row.type === "source-header") return true;
-    if (row.type === "header") {
-      if (collapsedSources.has(row.source)) return false;
-      return !hasCollapsedAncestor(row.source, row.domain, collapsedDomains, true);
-    }
-    const source = row.entry?.publisher || "other";
-    const domain = row.entry?.domain || "other";
-    if (collapsedSources.has(source)) return false;
-    return !hasCollapsedAncestor(source, domain, collapsedDomains, false);
-  });
-}
-function compareDomainPaths(a, b) {
-  const A = a.split("/");
-  const B = b.split("/");
-  const len = Math.min(A.length, B.length);
-  for (let i = 0; i < len; i++) {
-    const c = A[i].localeCompare(B[i]);
-    if (c !== 0) return c;
-  }
-  return A.length - B.length;
-}
-function hasCollapsedAncestor(source, domain, collapsedDomains, strict) {
-  const segs = domain.split("/");
-  const upper = strict ? segs.length : segs.length + 1;
-  for (let i = 1; i < upper; i++) {
-    const prefix = segs.slice(0, i).join("/");
-    if (collapsedDomains.has(`${source}:${prefix}`)) return true;
-  }
-  return false;
+    if (row.type === "publisher-header") return true;
+    if (row.type === "repo-header") {
+      return !collapsedSources.has(row.source);
+    }
+    const publisher = row.entry?.publisher || "other";
+    if (collapsedSources.has(publisher)) return false;
+    const repo = row.entry?.repo || "";
+    return repo === "" || !collapsedRepos.has(`${publisher}:${repo}`);
+  });
 }
-function domainAssetRefs(rows, source, domain) {
-  return rows.filter((r) => isAsset(r) && inDomain(r, source, domain)).map((r) => assetRefOf(r));
+function repoAssetRefs(rows, publisher, repo) {
+  return rows.filter((r) => isAsset(r) && inRepo(r, publisher, repo)).map((r) => assetRefOf(r)).filter((ref) => ref !== null);
 }
 function sourceAssetRefs(rows, source) {
-  return rows.filter((r) => isAsset(r) && inSource(r, source)).map((r) => assetRefOf(r));
+  return rows.filter((r) => isAsset(r) && inSource(r, source)).map((r) => assetRefOf(r)).filter((ref) => ref !== null);
 }
 function isAsset(r) {
   return r.type === "asset";
@@ -2252,14 +2233,17 @@ function isAsset(r) {
 function inSource(r, source) {
   return (r.entry?.publisher || "other") === source;
 }
-function inDomain(r, source, domain) {
-  if (!inSource(r, source)) return false;
-  const d = r.entry?.domain || "other";
-  return d === domain || d.startsWith(`${domain}/`);
+function inRepo(r, publisher, repo) {
+  if (!inSource(r, publisher)) return false;
+  return (r.entry?.repo || "") === repo;
 }
 function assetRefOf(r) {
-  if (!isAsset(r) || !r.entry) return null;
-  return `${r.entry.kind}:${r.entry.name}`;
+  if (!isAsset(r) || !r.entry?.publisher) return null;
+  return assetRefToStr({
+    kind: r.entry.kind,
+    name: r.entry.name,
+    publisher: r.entry.publisher
+  });
 }
 function findAssetRow(ref) {
   return state.assetRows.find((r) => isAsset(r) && assetRefOf(r) === ref);
@@ -2297,48 +2281,38 @@ function bulkSelection(refs, action3) {
   for (const ref of refs) setSelection(ref, action3);
 }
 function actOnHeader(row, action3) {
-  if (row.type === "source-header") {
+  if (row.type === "publisher-header") {
     bulkSelection(sourceAssetRefs(state.assetRows, row.source), action3);
     return true;
   }
-  if (row.type === "header") {
-    bulkSelection(domainAssetRefs(state.assetRows, row.source, row.domain), action3);
+  if (row.type === "repo-header") {
+    bulkSelection(repoAssetRefs(state.assetRows, row.source, row.repo), action3);
     return true;
   }
   return false;
 }
 async function loadAssets() {
-  const { gatherAssetFeeds } = await import('../asset-feeds-QXCSAJRN.js');
+  const { gatherAssetFeeds } = await import('../asset-feeds-Y2CDCM3W.js');
   const { entries, notes } = await gatherAssetFeeds(am, am.projectDir);
   if (notes.length > 0) {
     state.message = notes.map((n) => `[${n.feed}] ${n.message}`).join(" \u2022 ");
   }
   const installed = new Set(am.listDeployed().map((e) => `${e.kind}:${e.name}`));
-  const bySource = /* @__PURE__ */ new Map();
+  const byPublisher = /* @__PURE__ */ new Map();
   for (const e of entries) {
-    const source = e.publisher || "other";
-    const domain = e.domain || "other";
-    if (!bySource.has(source)) bySource.set(source, /* @__PURE__ */ new Map());
-    const domainMap = bySource.get(source);
-    if (!domainMap.has(domain)) domainMap.set(domain, []);
-    domainMap.get(domain).push(e);
+    const publisher = e.publisher || "other";
+    const repo = e.repo || "";
+    if (!byPublisher.has(publisher)) byPublisher.set(publisher, /* @__PURE__ */ new Map());
+    const byRepo = byPublisher.get(publisher);
+    if (!byRepo.has(repo)) byRepo.set(repo, []);
+    byRepo.get(repo).push(e);
   }
   const rows = [];
-  for (const [source, domainMap] of [...bySource.entries()].sort(
+  for (const [publisher, byRepo] of [...byPublisher.entries()].sort(
     (a, b) => a[0].localeCompare(b[0])
   )) {
-    rows.push({ type: "source-header", source });
-    const emittedHeaders = /* @__PURE__ */ new Set();
-    for (const [domain, items] of [...domainMap.entries()].sort(
-      (a, b) => compareDomainPaths(a[0], b[0])
-    )) {
-      const segs = domain.split("/");
-      for (let i = 1; i <= segs.length; i++) {
-        const prefix = segs.slice(0, i).join("/");
-        if (emittedHeaders.has(prefix)) continue;
-        rows.push({ type: "header", source, domain: prefix, depth: i });
-        emittedHeaders.add(prefix);
-      }
+    rows.push({ type: "publisher-header", source: publisher });
+    const pushAssets = (items) => {
       items.sort(
         (a, b) => a.kind !== b.kind ? a.kind.localeCompare(b.kind) : a.name.localeCompare(b.name)
       );
@@ -2346,26 +2320,34 @@ async function loadAssets() {
         const ref = `${entry.kind}:${entry.name}`;
         rows.push({ type: "asset", entry, installed: installed.has(ref) });
       }
+    };
+    const noRepo = byRepo.get("");
+    if (noRepo) pushAssets(noRepo);
+    for (const [repo, items] of [...byRepo.entries()].filter(([r]) => r !== "").sort((a, b) => a[0].localeCompare(b[0]))) {
+      rows.push({ type: "repo-header", source: publisher, repo });
+      pushAssets(items);
     }
   }
   state.assetRows = rows;
-  const newSources = new Set(rows.filter((r) => r.type === "source-header").map((r) => r.source));
+  const newSources = new Set(
+    rows.filter((r) => r.type === "publisher-header").map((r) => r.source)
+  );
   for (const s of state.collapsedSources) {
     if (!newSources.has(s)) state.collapsedSources.delete(s);
   }
-  const newDomainKeys = new Set(
-    rows.filter((r) => r.type === "header").map((r) => `${r.source}:${r.domain}`)
+  const newRepoKeys = new Set(
+    rows.filter((r) => r.type === "repo-header").map((r) => `${r.source}:${r.repo}`)
   );
-  for (const d of state.collapsedDomains) {
-    if (!newDomainKeys.has(d)) state.collapsedDomains.delete(d);
+  for (const d of state.collapsedRepos) {
+    if (!newRepoKeys.has(d)) state.collapsedRepos.delete(d);
   }
-  for (const d of newDomainKeys) state.collapsedDomains.add(d);
+  for (const d of newRepoKeys) state.collapsedRepos.add(d);
   rebuildVisible();
 }
 async function loadSourcesAndLibraries() {
   try {
     const [{ openLibraryManager: openLibraryManager2 }, { skaileHomeDir: skaileHomeDir2 }] = await Promise.all([
-      import('../open-library-M4DB3D3J.js'),
+      import('../open-library-CT4VVESU.js'),
       import('../library/index.js')
     ]);
     const { manager, library, close } = await openLibraryManager2();
@@ -2404,7 +2386,7 @@ function rebuildVisible() {
   state.visibleRows = buildVisibleRows(
     state.assetRows,
     state.collapsedSources,
-    state.collapsedDomains
+    state.collapsedRepos
   );
   clampCursor();
 }
@@ -2512,7 +2494,7 @@ function renderHeaderLine(opts) {
   return opts.selected ? pc5.bgWhite(pc5.black(`${line} `.padEnd(state.cols))) : line;
 }
 function renderAssetRow(row, selected) {
-  if (row.type === "source-header") {
+  if (row.type === "publisher-header") {
     return renderHeaderLine({
       indent: " ",
       collapsed: state.collapsedSources.has(row.source),
@@ -2522,21 +2504,20 @@ function renderAssetRow(row, selected) {
       selected
     });
   }
-  if (row.type === "header") {
-    const depth2 = row.depth ?? 1;
-    const segs = row.domain.split("/");
-    const segment = segs[segs.length - 1];
+  if (row.type === "repo-header") {
+    const slug = row.repo;
+    const bare = slug.includes("/") ? slug.slice(slug.indexOf("/") + 1) : slug;
     return renderHeaderLine({
-      indent: " ".repeat(1 + depth2 * 2),
-      collapsed: state.collapsedDomains.has(`${row.source}:${row.domain}`),
-      match: (r) => isAsset(r) && inDomain(r, row.source, row.domain),
-      refs: domainAssetRefs(state.assetRows, row.source, row.domain),
-      label: pc5.bold(segment),
+      indent: " ".repeat(3),
+      collapsed: state.collapsedRepos.has(`${row.source}:${slug}`),
+      match: (r) => isAsset(r) && inRepo(r, row.source, slug),
+      refs: repoAssetRefs(state.assetRows, row.source, slug),
+      label: pc5.bold(bare),
       selected
     });
   }
   const e = row.entry;
-  const ref = assetRefOf(row);
+  const ref = assetRefOf(row) ?? "";
   let status4;
   if (state.pendingAdds.has(ref)) status4 = pc5.blue("+ ");
   else if (state.pendingRemoves.has(ref)) status4 = pc5.red("- ");
@@ -2544,10 +2525,11 @@ function renderAssetRow(row, selected) {
   else status4 = pc5.dim("\xB7 ");
   const kind = kindColorPad(e.kind, 8);
   const name = e.name.padEnd(30);
-  const desc = e.description?.slice(0, state.cols - 52) ?? "";
-  const depth = (e.domain || "other").split("/").length;
-  const indent = " ".repeat(1 + (depth + 1) * 2);
-  const line = `${indent}${status4} ${kind} ${name} ${pc5.dim(desc)}`;
+  const badge = e.category ? `${pc5.dim("[")}${pc5.cyan(e.category)}${pc5.dim("]")} ` : "";
+  const badgeWidth = e.category ? e.category.length + 3 : 0;
+  const desc = e.description?.slice(0, Math.max(0, state.cols - 52 - badgeWidth)) ?? "";
+  const indent = " ".repeat(e.repo ? 5 : 3);
+  const line = `${indent}${status4} ${kind} ${name} ${badge}${pc5.dim(desc)}`;
   return selected ? pc5.inverse(line.padEnd(state.cols)) : line;
 }
 function renderSourceRow(row, selected) {
@@ -2686,13 +2668,13 @@ async function showInfo() {
 function expandUnderCursor() {
   const row = state.visibleRows[state.cursor];
   if (!row) return;
-  if (row.type === "source-header" && state.collapsedSources.has(row.source)) {
+  if (row.type === "publisher-header" && state.collapsedSources.has(row.source)) {
     state.collapsedSources.delete(row.source);
     rebuildVisible();
-  } else if (row.type === "header") {
-    const dk = `${row.source}:${row.domain}`;
-    if (state.collapsedDomains.has(dk)) {
-      state.collapsedDomains.delete(dk);
+  } else if (row.type === "repo-header") {
+    const dk = `${row.source}:${row.repo}`;
+    if (state.collapsedRepos.has(dk)) {
+      state.collapsedRepos.delete(dk);
       rebuildVisible();
     }
   }
@@ -2700,23 +2682,23 @@ function expandUnderCursor() {
 function collapseOrJumpUnderCursor() {
   const row = state.visibleRows[state.cursor];
   if (!row) return;
-  if (row.type === "source-header") {
+  if (row.type === "publisher-header") {
     if (!state.collapsedSources.has(row.source)) {
       state.collapsedSources.add(row.source);
       rebuildVisible();
     }
     return;
   }
-  if (row.type === "header") {
-    const dk = `${row.source}:${row.domain}`;
-    if (!state.collapsedDomains.has(dk)) {
-      state.collapsedDomains.add(dk);
+  if (row.type === "repo-header") {
+    const dk = `${row.source}:${row.repo}`;
+    if (!state.collapsedRepos.has(dk)) {
+      state.collapsedRepos.add(dk);
       rebuildVisible();
     } else {
       const idx2 = findLastIndex(
         state.visibleRows,
         state.cursor,
-        (r) => r.type === "source-header"
+        (r) => r.type === "publisher-header"
       );
       if (idx2 >= 0) state.cursor = idx2;
     }
@@ -2725,7 +2707,7 @@ function collapseOrJumpUnderCursor() {
   const idx = findLastIndex(
     state.visibleRows,
     state.cursor,
-    (r) => r.type === "header" || r.type === "source-header"
+    (r) => r.type === "repo-header" || r.type === "publisher-header"
   );
   if (idx >= 0) state.cursor = idx;
 }
@@ -2912,54 +2894,50 @@ function makeMcpServerCommand() {
 function makeNpxCommand() {
   const npx = new Command("npx").description("Compatibility shim for npx skills syntax");
   const skills = npx.command("skills").description("Skill installation from external repos");
-  skills.command("add <url>").description("Register a repo as a Library Source and install a skill from it").requiredOption("--skill <name>", "Skill name to install from the repo").option("--project-dir <path>", "Project directory", process.cwd()).option("--target <agent>", "Agent framework", "claude-code").option("--global", "Deploy globally").action(async (url, opts) => {
+  skills.command("add <url>").description(
+    "Clone a repo, register it in the project's skaile.yaml sources[], and install a skill from it"
+  ).requiredOption("--skill <name>", "Skill name to install from the repo").option("--project-dir <path>", "Project directory", process.cwd()).option("--target <agent>", "Agent framework", "claude-code").option("--global", "Deploy globally").action(async (url, opts) => {
     const projectDir = path14__default.resolve(opts.projectDir);
-    const spinner5 = p5.spinner();
-    let sourcePath;
-    const isUrl = /^(https?:|git@|git:)/.test(url);
-    if (isUrl) {
-      sourcePath = cloneDestination(url);
-      spinner5.start(`Cloning ${url}`);
-      try {
-        if (!existsSync(sourcePath)) {
-          execSync(`git clone ${url} ${sourcePath}`, { stdio: "ignore" });
-        }
-        spinner5.stop(`Cloned to ${path14__default.basename(sourcePath)}`);
-      } catch (err) {
-        spinner5.stop("Clone failed");
-        logErr(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-      }
-    } else {
-      sourcePath = path14__default.resolve(url);
-      if (!existsSync(sourcePath)) {
-        logErr(`Path does not exist: ${sourcePath}`);
-        process.exit(1);
-      }
+    const projYaml = path14__default.join(projectDir, "skaile.yaml");
+    if (!existsSync(projYaml)) {
+      logErr(`No skaile.yaml in ${projectDir} \u2014 run \`skaile init\` first.`);
+      process.exit(1);
     }
-    const library = await openLibrary();
+    if (!/^(?:https?:|git@|git:)/.test(url)) {
+      logErr(
+        "npx skills add requires a git URL \u2014 resolution runs through the project's sources[]."
+      );
+      process.exit(1);
+    }
+    const spinner5 = p5.spinner();
+    const slug = sourceSlug(url);
+    const clonePath = path14__default.join(homedir(), ".skaile", "sources", slug);
+    spinner5.start(`Cloning ${url}`);
     try {
-      const existing = await library.listSources();
-      let source = existing.find((s) => s.path === sourcePath);
-      if (!source) {
-        source = await library.addSource({
-          backend: "local",
-          name: path14__default.basename(sourcePath),
-          path: sourcePath,
-          ownership: "owner"
-        });
+      if (!existsSync(clonePath)) {
+        execSync(`git clone ${url} ${clonePath}`, { stdio: "ignore" });
       }
-      spinner5.start("Syncing source");
-      const { LocalCatalogSource: LocalCatalogSource2 } = await import('../library/index.js');
-      const registry = createFullRegistry();
-      const catalogSource = new LocalCatalogSource2(library, source.id, sourcePath, registry);
-      const result = await catalogSource.sync();
-      await library.syncSource(source.id);
-      spinner5.stop(`Indexed ${result.assetsUpdated} assets`);
-    } finally {
-      library.close();
+      spinner5.stop(`Cloned to ${slug}`);
+    } catch (err) {
+      spinner5.stop("Clone failed");
+      logErr(err instanceof Error ? err.message : String(err));
+      process.exit(1);
     }
-    const skillRef = `skill:${opts.skill}`;
+    const editor = WorkspaceYamlEditor.load(projYaml);
+    editor.setSource({ url });
+    editor.save();
+    const publisher = resolvePublisher(clonePath, url);
+    if (!publisher) {
+      logErr(
+        `Could not determine the publisher for "${opts.skill}". Declare \`publisher:\` in the source's skaile.yaml, or use a github URL.`
+      );
+      process.exit(1);
+    }
+    const skillName = resolveSkillName(clonePath, opts.skill);
+    if (skillName !== opts.skill) {
+      logInfo(`Resolved "${opts.skill}" \u2192 directory "${skillName}".`);
+    }
+    const skillRef = `skill:${skillName}@${publisher}`;
     const am2 = new AssetManager({ projectDir, global: opts.global, driverTarget: opts.target });
     spinner5.start(`Installing ${skillRef}`);
     try {
@@ -2970,9 +2948,7 @@ function makeNpxCommand() {
       } else {
         for (const a of added) logOk(a);
       }
-      logInfo(
-        `Source registered at ${S.dim(sourcePath)} \u2014 manage via ${S.cmd("skaile source")}.`
-      );
+      logInfo(`Source registered in skaile.yaml \u2014 manage via ${S.cmd("skaile source")}.`);
     } catch (err) {
       spinner5.stop("Failed");
       logErr(err.message);
@@ -2983,25 +2959,37 @@ function makeNpxCommand() {
   skills.action(() => skills.help());
   return npx;
 }
-function cloneDestination(url) {
-  const cleaned = url.replace(/\.git$/, "");
-  const root = path14__default.join(homedir(), ".skaile", "clones");
-  let host = "unknown";
-  let pathPart = cleaned;
-  const httpMatch = cleaned.match(/^https?:\/\/([^/]+)\/(.+)$/);
-  const gitMatch = cleaned.match(/^git@([^:]+):(.+)$/);
-  const gitProtoMatch = cleaned.match(/^git:\/\/([^/]+)\/(.+)$/);
-  if (httpMatch) {
-    host = httpMatch[1];
-    pathPart = httpMatch[2];
-  } else if (gitMatch) {
-    host = gitMatch[1];
-    pathPart = gitMatch[2];
-  } else if (gitProtoMatch) {
-    host = gitProtoMatch[1];
-    pathPart = gitProtoMatch[2];
-  }
-  return path14__default.join(root, host, pathPart);
+function resolvePublisher(clonePath, url) {
+  const yamlPath = path14__default.join(clonePath, "skaile.yaml");
+  if (existsSync(yamlPath)) {
+    try {
+      const { config } = decodeSkaileYaml(readFileSync(yamlPath, "utf8"));
+      if (typeof config.publisher === "string" && config.publisher.length > 0) {
+        return config.publisher;
+      }
+    } catch {
+    }
+  }
+  return url.match(/github\.com[/:]([^/]+)\/[^/]+/)?.[1];
+}
+function resolveSkillName(clonePath, requested) {
+  const skillsDir = path14__default.join(clonePath, "skills");
+  if (existsSync(path14__default.join(skillsDir, requested, "SKILL.md"))) return requested;
+  if (!existsSync(skillsDir)) return requested;
+  for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const md = path14__default.join(skillsDir, entry.name, "SKILL.md");
+    if (!existsSync(md)) continue;
+    try {
+      const { data } = parseFrontmatter(readFileSync(md, "utf8"));
+      if (typeof data.name === "string" && data.name === requested) return entry.name;
+    } catch {
+    }
+  }
+  return requested;
+}
+function sourceSlug(url) {
+  return url.replace(/\.git$/, "").split(/[/:]/).pop() ?? "source";
 }
 var SKAILE_MCP_NAME = "skaile-workspace";
 var MCP_SERVER_ENTRY = {
@@ -3691,7 +3679,7 @@ function action2(fn) {
   };
 }
 async function reconcileAndReport(projectDir, plugins) {
-  const { reconcilePlugins } = await import('../plugin-store-AJ3FGXIC.js');
+  const { reconcilePlugins } = await import('../plugin-store-QS7TC5HY.js');
   if (plugins.length === 0) {
     logInfo("No plugins declared \u2014 nothing to reconcile.");
     return;
@@ -3707,7 +3695,7 @@ async function reconcileAndReport(projectDir, plugins) {
 async function runInstall2(spec, opts) {
   const projectDir = path14__default.resolve(opts.projectDir);
   const { WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-  const { specName } = await import('../plugin-store-AJ3FGXIC.js');
+  const { specName } = await import('../plugin-store-QS7TC5HY.js');
   const yamlPath = path14__default.join(projectDir, "skaile.yaml");
   const editor = WorkspaceYamlEditor2.load(yamlPath);
   const replaced = editor.addPlugin(spec, specName);
@@ -3719,7 +3707,7 @@ async function runInstall2(spec, opts) {
 async function runRemove(name, opts) {
   const projectDir = path14__default.resolve(opts.projectDir);
   const { WorkspaceYamlEditor: WorkspaceYamlEditor2 } = await import('../core/index.js');
-  const { specName } = await import('../plugin-store-AJ3FGXIC.js');
+  const { specName } = await import('../plugin-store-QS7TC5HY.js');
   const yamlPath = path14__default.join(projectDir, "skaile.yaml");
   const editor = WorkspaceYamlEditor2.load(yamlPath);
   const removed = editor.removePlugin(name, specName);
@@ -3747,7 +3735,7 @@ async function runList(opts) {
   const registry = createPluginRegistry();
   if (declared.length > 0) {
     try {
-      const { loadPlugins } = await import('../plugin-store-AJ3FGXIC.js');
+      const { loadPlugins } = await import('../plugin-store-QS7TC5HY.js');
       const result = await loadPlugins(projectDir, declared, registry);
       for (const f of result.failed) logWarn(f.error);
     } catch (err) {
@@ -3950,7 +3938,7 @@ function makeInstallCommand() {
       const spinner6 = p5.spinner();
       spinner6.start(`Installing ${ref}`);
       try {
-        const { openCatalogSource: openCatalogSource2, openLibrary: openLibrary2 } = await import('../open-library-M4DB3D3J.js');
+        const { openCatalogSource: openCatalogSource2, openLibrary: openLibrary2 } = await import('../open-library-CT4VVESU.js');
         const catalog = await openCatalogSource2({ projectDir: path14__default.resolve(opts.projectDir) });
         if (!supportsInstallManifest(catalog)) {
           throw new Error(
@@ -3982,7 +3970,7 @@ function makeInstallCommand() {
     }
     const projectDir = path14__default.resolve(opts.projectDir);
     try {
-      const { ensureSourcesCloned } = await import('../ensure-sources-SL2S4UEX.js');
+      const { ensureSourcesCloned } = await import('../ensure-sources-REWWBH2K.js');
       const hydrate = ensureSourcesCloned(projectDir, { quiet: true });
       if (hydrate.cloned.length > 0) {
         logOk(`Cloned source(s): ${hydrate.cloned.join(", ")}`);
@@ -4440,7 +4428,7 @@ async function ensurePluginsLoadedForServe(projectDir) {
     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-AJ3FGXIC.js');
+    const { ensurePluginsLoaded } = await import('../plugin-store-QS7TC5HY.js');
     const { pluginRegistry } = await import('../plugin-registry/index.js');
     const result = await ensurePluginsLoaded(projectDir, config.plugins, pluginRegistry);
     if (result.loaded.length > 0) {
@@ -5296,6 +5284,14 @@ function sourceClonePath(name) {
 function deriveSlug(url) {
   return url.replace(/\.git$/, "").split(/[/:]/).pop() ?? "source";
 }
+function normalizeSourceUrl(input) {
+  const s = input.trim();
+  if (/^(?:https?|git|ssh|file):\/\//.test(s) || /^git@/.test(s)) return s;
+  const repo = s.replace(/\.git$/, "");
+  if (/^[\w.-]+\/[\w.-]+$/.test(repo)) return `git@github.com:${repo}.git`;
+  if (/^[\w.-]+$/.test(repo)) return `git@github.com:skaile-ai/${repo}.git`;
+  return s;
+}
 function requireProjectYamlPath() {
   const root = findWorkspaceRoot(process.cwd());
   if (!root) {
@@ -5371,8 +5367,11 @@ function makeSourceCommand() {
   const cmd = new Command("source").description(
     "Manage github sources for the current project (recorded in skaile.yaml)"
   );
-  cmd.command("add <git-url>").description("Clone a github repo and register it in this project's skaile.yaml").option("--name <slug>", "[deprecated] no-op \u2014 the source entry stores only the URL").option("--pin <ref>", "Pin a branch, tag, or 40-char SHA").option("--branch <branch>", "[deprecated] alias for --pin").option("--force", "Remove an existing clone and re-clone", false).option("--dev", "Also index dev-only assets under the source's dev_paths", false).action(
-    async (url, opts) => {
+  cmd.command("add <source>").description(
+    "Clone a github repo and register it in this project's skaile.yaml. <source> may be a full git URL, an owner/repo shorthand, or a bare name (\u2192 git@github.com:skaile-ai/<name>.git)."
+  ).option("--name <slug>", "[deprecated] no-op \u2014 the source entry stores only the URL").option("--pin <ref>", "Pin a branch, tag, or 40-char SHA").option("--branch <branch>", "[deprecated] alias for --pin").option("--force", "Remove an existing clone and re-clone", false).option("--dev", "Also index dev-only assets under the source's dev_paths", false).action(
+    async (source, opts) => {
+      const url = normalizeSourceUrl(source);
       const yamlPath = requireProjectYamlPath();
       if (opts.name) {
         logWarn(
@@ -6244,7 +6243,7 @@ Advanced:
 });
 program.command("init [project-dir]").description("Initialize a project directory (defaults to current directory)").option("--backend <name>", "Coding-agent backend (claude-code | omp | codex)", "claude-code").option("--no-git", "Skip git init and .gitignore").action(async (projectDir, opts) => {
   const { execSync: execSync3 } = await import('child_process');
-  const { existsSync: existsSync12, mkdirSync: mkdirSync3, readFileSync: readFileSync5, writeFileSync: writeFileSync2 } = await import('fs');
+  const { existsSync: existsSync12, mkdirSync: mkdirSync3, readFileSync: readFileSync6, writeFileSync: writeFileSync2 } = await import('fs');
   const { stringify } = await import('yaml');
   const { DRIVER_TARGETS, SUPPORTED_DRIVER_TARGETS: SUPPORTED_DRIVER_TARGETS2 } = await import('../core/index.js');
   const backend = opts.backend;
@@ -6302,7 +6301,7 @@ program.command("init [project-dir]").description("Initialize a project director
   if (opts.git) {
     const gitignorePath = path14__default.join(resolved, ".gitignore");
     const entries = ["node_modules/", ".skaile/sessions/", "*.log", ".env", ".env.local"];
-    const existing = existsSync12(gitignorePath) ? readFileSync5(gitignorePath, "utf-8") : "";
+    const existing = existsSync12(gitignorePath) ? readFileSync6(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) {
@@ -6338,7 +6337,7 @@ program.command("init [project-dir]").description("Initialize a project director
     );
   }
   try {
-    const { ensureSourcesCloned } = await import('../ensure-sources-SL2S4UEX.js');
+    const { ensureSourcesCloned } = await import('../ensure-sources-REWWBH2K.js');
     const hydrate = ensureSourcesCloned(resolved, { quiet: true });
     for (const n of hydrate.cloned) created.push(`~/.skaile/sources/${n}/`);
     if (hydrate.failed.length > 0) {
@@ -6364,7 +6363,7 @@ program.command("init [project-dir]").description("Initialize a project director
   console.log();
 });
 program.command("setup").description("Interactive provider setup wizard").action(async () => {
-  const { cmdSetup } = await import('../setup-GBSQX7JF.js');
+  const { cmdSetup } = await import('../setup-F6DGKL7J.js');
   await cmdSetup([], { projectDir: process.cwd() });
 });
 program.addCommand(makeInstallCommand());