@skaile/workspaces 0.24.0 → 0.26.0

package/dist/{chunk-LJ52ZKIU.js → chunk-JIQLLZ65.js}

@@ -1,6 +1,8 @@
 import { AssetKindRegistryFrozenError, AssetKindConflictError, AssetKindPatternConflictError, AssetKindPathAmbiguityError } from './chunk-OKRUTSG7.js';
-import { parseFrontmatter } from './chunk-DH4N5AW4.js';
-import { validatePersona, validateRuleset, validateSkill, validateAgent, validateConnector, validateMcpServer, validateContract, validatePrompt, validatePreset } from './chunk-NELZIQ2E.js';
+import { decodeSkaileManifest, SKAILE_MANIFEST_FILENAME } from './chunk-IERB3UXJ.js';
+import { parseFrontmatter } from './chunk-2FS4FPZ7.js';
+import { isValidAssetName } from './chunk-IEJ5IOC3.js';
+import { validatePersona, validateRuleset, validateSkill, validateAgent, validateConnector, validateMcpServer, validateContract, validatePrompt, validatePreset } from './chunk-QDJKE557.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as z from 'zod';
@@ -481,8 +483,14 @@ var SyncConfigSchema = z.object({
   path: ["poll_interval"]
 });
 var AssetEntrySchema = z.object({
-  /** Relative path within the repo (directory or file). */
+  /** Asset root directory, relative to the repo. Files are resolved under it. */
   path: z.string().min(1),
+  /**
+   * Optional recursive root. When set (and `files` absent), the asset spans
+   * every file under `<path>` (walked recursively). Mirrors the
+   * `skaile.manifest.yaml` `root:` form via `manifestToSourceConfig`.
+   */
+  root: z.string().min(1).optional(),
   /** Asset kind — validated against `IAssetKindRegistry` at discovery time. */
   kind: z.string().min(1),
   /** Publisher namespace. Required per entry; overrides publisher_default / _overrides. */
@@ -496,12 +504,19 @@ var AssetEntrySchema = z.object({
    * Optional on write, REQUIRED on Catalog publish (Phase 4).
    */
   sha256: z.string().regex(/^[a-f0-9]{64}$/, "sha256 must be 64-character hex").optional(),
-  /** Curated file filter (paths relative to `path:`). At least one entry. */
-  files: z.array(z.string().min(1)).min(1),
+  /**
+   * Curated file filter (paths relative to `path:`). At least one entry when
+   * present. Optional: a `root`-only entry omits it and is materialised by a
+   * recursive walk at discovery time.
+   */
+  files: z.array(z.string().min(1)).min(1).optional(),
   /** Author-declared requires-graph entries. */
   requires: z.array(z.string().min(1)).default([]),
   /** Optional passthrough to `AssetDefinition.manifest`. */
   metadata: z.record(z.string(), z.unknown()).optional()
+}).refine((a) => a.root !== void 0 || a.files !== void 0, {
+  message: "asset entry must declare either `root` or `files`",
+  path: ["files"]
 });
 var SourceConfigSchema = z.object({
   /** Schema version. `1` (glob mode) or `2` (allows `assets:` block). */
@@ -580,6 +595,91 @@ function collectWarnings(config) {
   }
   return warnings;
 }
+function atPublisher(publisher) {
+  return publisher.startsWith("@") ? publisher : `@${publisher}`;
+}
+function derivePublisherFromPath(p) {
+  const seg = p.split("/").find((s) => s.length > 0 && s !== ".");
+  return seg ? `@${seg}` : "@unknown";
+}
+function manifestFilesToStrings(files) {
+  if (!Array.isArray(files) || files.length === 0) return void 0;
+  const out = files.map((f) => typeof f === "string" ? f : f.path).filter((p) => p.length > 0);
+  return out.length > 0 ? out : void 0;
+}
+function manifestEntryMetadata(a, manifest) {
+  const meta = {};
+  if (a.description !== void 0) meta.description = a.description;
+  if (a.keywords !== void 0) meta.keywords = a.keywords;
+  if (a.category !== void 0) meta.category = a.category;
+  const license = a.license ?? manifest.license;
+  if (license !== void 0) meta.license = license;
+  const homepage = a.homepage ?? manifest.homepage;
+  if (homepage !== void 0) meta.homepage = homepage;
+  return Object.keys(meta).length > 0 ? meta : void 0;
+}
+function adaptManifestAssetEntry(a, manifest) {
+  const root = typeof a.root === "string" && a.root.length > 0 ? a.root : void 0;
+  const assetPath = root ?? ".";
+  const files = root ? void 0 : manifestFilesToStrings(a.files);
+  const publisher = a.publisher ? atPublisher(a.publisher) : manifest.publisher ? atPublisher(manifest.publisher) : derivePublisherFromPath(assetPath);
+  const entry = {
+    path: assetPath,
+    kind: a.kind,
+    publisher,
+    name: a.name,
+    version: a.version ?? manifest.version ?? "0.1.0",
+    requires: a.dependencies ?? []
+  };
+  if (root) entry.root = root;
+  if (files) entry.files = files;
+  if (a.sha256) entry.sha256 = a.sha256;
+  const metadata = manifestEntryMetadata(a, manifest);
+  if (metadata) entry.metadata = metadata;
+  return entry;
+}
+function manifestToSourceConfig(manifest) {
+  const publisherDefault = manifest.publisher ? atPublisher(manifest.publisher) : "@<domain>";
+  const devPaths = manifest.dev_paths ?? [];
+  if (!manifest.assets || manifest.assets.length === 0) {
+    return {
+      version: 1,
+      publisher_default: publisherDefault,
+      default_ref: "main",
+      publisher_overrides: [],
+      dev_paths: devPaths
+    };
+  }
+  return {
+    version: 2,
+    publisher_default: publisherDefault,
+    default_ref: "main",
+    publisher_overrides: [],
+    dev_paths: devPaths,
+    assets: manifest.assets.map((a) => adaptManifestAssetEntry(a, manifest))
+  };
+}
+function decodeManifestSourceConfig(text) {
+  const { manifest, diagnostics } = decodeSkaileManifest(text);
+  const fatal = diagnostics.filter((d) => d.severity === "error");
+  if (fatal.length > 0) {
+    return {
+      ok: false,
+      errors: fatal.map((d) => ({ path: d.path ?? "", message: d.message }))
+    };
+  }
+  return { ok: true, config: manifestToSourceConfig(manifest) };
+}
+function readManifestSourceConfig(dir) {
+  const filePath = path.join(dir, SKAILE_MANIFEST_FILENAME);
+  if (!fs.existsSync(filePath)) return void 0;
+  try {
+    const result = decodeManifestSourceConfig(fs.readFileSync(filePath, "utf-8"));
+    return result.ok ? result.config : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function mergeSourceConfigs(base, overlay) {
   if (!base && !overlay) return void 0;
   if (!overlay) return base;
@@ -638,11 +738,11 @@ function loadMergedSourceConfig(rootPath, sidecarPath) {
   return warnings.length > 0 ? { ok: true, config: merged, warnings } : { ok: true, config: merged };
 }
 function loadSourceConfigFromDir(dir) {
-  const filePath = path.join(dir, ".skaile-source.yaml");
+  const filePath = path.join(dir, SKAILE_MANIFEST_FILENAME);
   if (!fs.existsSync(filePath)) return void 0;
   try {
     const text = fs.readFileSync(filePath, "utf-8");
-    return loadSourceConfig(text);
+    return decodeManifestSourceConfig(text);
   } catch (err) {
     return {
       ok: false,
@@ -718,10 +818,18 @@ function processEntry(rootPath, entry, registry) {
   const errors = [];
   const assetRoot = path.resolve(rootPath, entry.path);
   const assetRootRelative = entry.path;
-  const manifestFileRel = pickManifestFile(entry, registry);
+  const files = entry.files ?? expandRootFiles(assetRoot);
+  if (entry.files === void 0 && files.length === 0) {
+    errors.push({
+      path: assetRootRelative,
+      error: `ManifestFileMissing: root "${entry.root ?? entry.path}" contains no files`
+    });
+    return { asset: null, errors };
+  }
+  const manifestFileRel = pickManifestFile(entry.path, files, entry.kind, registry);
   const manifestAbsPath = path.join(assetRoot, manifestFileRel);
   const missing = [];
-  for (const file of entry.files) {
+  for (const file of files) {
     if (!fs.existsSync(path.join(assetRoot, file))) {
       missing.push(file);
     }
@@ -757,7 +865,7 @@ function processEntry(rootPath, entry, registry) {
   }
   const { sha256: computedHash, missing: hashMissing } = computeDeterministicHashDetailed(
     assetRoot,
-    entry.files
+    files
   );
   if (hashMissing.length > 0) {
     errors.push({
@@ -800,7 +908,7 @@ function processEntry(rootPath, entry, registry) {
     relativePath: path.join(assetRootRelative, manifestFileRel).replace(/\\/g, "/"),
     fileFilter: {
       assetRoot,
-      files: [...entry.files].sort()
+      files: [...files].sort()
     },
     sha256: computedHash,
     requires
@@ -818,26 +926,49 @@ var MANIFEST_FILENAMES = /* @__PURE__ */ new Set([
   "RULESET.md"
 ]);
 var MANIFEST_SUFFIXES = [".flow.yaml", ".flow.json", ".prompt.md", ".preset.yaml"];
-function pickManifestFile(entry, registry) {
-  const provider = registry.getProvider(entry.kind);
+function pickManifestFile(assetPath, files, kind, registry) {
+  const provider = registry.getProvider(kind);
   if (provider) {
-    for (const file of entry.files) {
-      if (provider.matchesPath(path.join(entry.path, file).replace(/\\/g, "/"))) {
+    for (const file of files) {
+      if (provider.matchesPath(path.join(assetPath, file).replace(/\\/g, "/"))) {
         return file;
       }
     }
   }
-  for (const file of entry.files) {
+  for (const file of files) {
     if (MANIFEST_FILENAMES.has(path.basename(file))) return file;
     if (MANIFEST_SUFFIXES.some((s) => file.endsWith(s))) return file;
   }
-  return entry.files[0];
+  return files[0];
+}
+function expandRootFiles(assetRoot) {
+  const out = [];
+  const walk = (absDir, relDir) => {
+    let entries;
+    try {
+      entries = fs.readdirSync(absDir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries.sort((a, b) => a.name < b.name ? -1 : 1)) {
+      const rel = relDir ? `${relDir}/${e.name}` : e.name;
+      if (e.isDirectory()) {
+        if (e.name === ".git" || e.name === "node_modules" || e.name === ".skaile") continue;
+        walk(path.join(absDir, e.name), rel);
+      } else if (e.isFile()) {
+        out.push(rel);
+      }
+    }
+  };
+  walk(assetRoot, "");
+  return out;
 }
 function parseManifest(absPath) {
   try {
     const content = fs.readFileSync(absPath, "utf-8");
     if (absPath.endsWith(".md")) {
       const { data } = parseFrontmatter(content);
+      if (!data || Object.keys(data).length === 0) return null;
       return data;
     }
     if (absPath.endsWith(".yaml") || absPath.endsWith(".yml")) {
@@ -927,7 +1058,7 @@ function discoverAssetsInTree(rootPath, optionsOrSourceConfig) {
       }
       const publisher = resolvePublisher(relativePath, sourceConfig);
       const name = deriveName(relativePath, kind, manifest);
-      const version = typeof manifest.version === "string" ? manifest.version : "0.1.0";
+      const version = coerceVersion(manifest.version);
       const ref = `${publisher}/${name}@${version}`;
       const fileFilter = registry.defaultFileFilter(kind, absPath) ?? {
         assetRoot: path.dirname(absPath),
@@ -985,6 +1116,7 @@ function parseManifest2(absPath) {
     const content = fs.readFileSync(absPath, "utf-8");
     if (absPath.endsWith(".md")) {
       const { data } = parseFrontmatter(content);
+      if (!data || Object.keys(data).length === 0) return null;
       return data;
     }
     if (absPath.endsWith(".yaml") || absPath.endsWith(".yml")) {
@@ -1019,8 +1151,13 @@ function resolvePublisher(relativePath, sourceConfig) {
   }
   return template;
 }
+function coerceVersion(version) {
+  if (typeof version === "string") return version;
+  if (typeof version === "number") return String(version);
+  return "0.1.0";
+}
 function deriveName(relativePath, kind, manifest) {
-  if (typeof manifest.name === "string" && manifest.name.length > 0) {
+  if (typeof manifest.name === "string" && manifest.name.length > 0 && isValidAssetName(manifest.name)) {
     return manifest.name;
   }
   const parts = relativePath.split("/");
@@ -1119,7 +1256,7 @@ async function discoverAssetsInTreeEntries(entries, options) {
     }
     const publisher = resolvePublisher2(relativePath, resolvedSourceConfig);
     const name = deriveName2(relativePath, kind, manifest);
-    const version = typeof manifest.version === "string" ? manifest.version : "0.1.0";
+    const version = coerceVersion2(manifest.version);
     const ref = `${publisher}/${name}@${version}`;
     const fileFilter = computeFileFilter(kind, relativePath, blobByPath);
     let sha256;
@@ -1158,6 +1295,7 @@ function parseManifestText(relativePath, text) {
   try {
     if (relativePath.endsWith(".md")) {
       const { data } = parseFrontmatter(text);
+      if (!data || Object.keys(data).length === 0) return null;
       return data;
     }
     if (relativePath.endsWith(".yaml") || relativePath.endsWith(".yml")) {
@@ -1192,8 +1330,13 @@ function resolvePublisher2(relativePath, sourceConfig) {
   }
   return template;
 }
+function coerceVersion2(version) {
+  if (typeof version === "string") return version;
+  if (typeof version === "number") return String(version);
+  return "0.1.0";
+}
 function deriveName2(relativePath, kind, manifest) {
-  if (typeof manifest.name === "string" && manifest.name.length > 0) {
+  if (typeof manifest.name === "string" && manifest.name.length > 0 && isValidAssetName(manifest.name)) {
     return manifest.name;
   }
   const parts = relativePath.split("/");
@@ -1335,11 +1478,11 @@ async function fetchAsBuffer(fetchBlob, sha) {
 }
 async function resolveSourceConfigFromTree(explicit, blobByPath, fetchBlob) {
   if (explicit) return explicit;
-  const entry = blobByPath.get(".skaile-source.yaml");
+  const entry = blobByPath.get(SKAILE_MANIFEST_FILENAME);
   if (!entry) return void 0;
   const bytes = await fetchAsBuffer(fetchBlob, entry.sha);
   if (!bytes) return void 0;
-  const result = loadSourceConfig(bytes.toString("utf-8"));
+  const result = decodeManifestSourceConfig(bytes.toString("utf-8"));
   return result.ok ? result.config : void 0;
 }
 async function discoverFromManifestTree(sourceConfig, blobByPath, fetchBlob, registry, includeDev = false) {
@@ -1366,8 +1509,16 @@ async function discoverFromManifestTree(sourceConfig, blobByPath, fetchBlob, reg
 async function processManifestEntryTree(entry, blobByPath, fetchBlob, registry) {
   const errors = [];
   const assetRootRelative = entry.path;
+  const files = entry.files ?? expandRootFilesTree(entry.path, blobByPath);
+  if (entry.files === void 0 && files.length === 0) {
+    errors.push({
+      path: assetRootRelative,
+      error: `ManifestFileMissing: root "${entry.root ?? entry.path}" contains no files`
+    });
+    return { asset: null, errors };
+  }
   const missing = [];
-  for (const file of entry.files) {
+  for (const file of files) {
     const full = joinPosix(entry.path, file);
     if (!blobByPath.has(full)) missing.push(file);
   }
@@ -1378,7 +1529,7 @@ async function processManifestEntryTree(entry, blobByPath, fetchBlob, registry)
     });
     return { asset: null, errors };
   }
-  const manifestFileRel = pickManifestFileTree(entry, registry);
+  const manifestFileRel = pickManifestFileTree(entry.path, files, entry.kind, registry);
   const manifestFull = joinPosix(entry.path, manifestFileRel);
   const manifestEntry = blobByPath.get(manifestFull);
   let manifestBytes;
@@ -1422,7 +1573,7 @@ async function processManifestEntryTree(entry, blobByPath, fetchBlob, registry)
   }
   let computedHash;
   try {
-    computedHash = await computeManifestHashTree(entry, blobByPath, fetchBlob);
+    computedHash = await computeManifestHashTree(entry.path, files, blobByPath, fetchBlob);
   } catch (err) {
     errors.push({
       path: assetRootRelative,
@@ -1464,7 +1615,7 @@ async function processManifestEntryTree(entry, blobByPath, fetchBlob, registry)
     relativePath: manifestFull,
     fileFilter: {
       assetRoot: entry.path,
-      files: [...entry.files].sort()
+      files: [...files].sort()
     },
     sha256: computedHash,
     requires
@@ -1482,25 +1633,38 @@ var MANIFEST_FILENAMES2 = /* @__PURE__ */ new Set([
   "RULESET.md"
 ]);
 var MANIFEST_SUFFIXES2 = [".flow.yaml", ".flow.json", ".prompt.md", ".preset.yaml"];
-function pickManifestFileTree(entry, registry) {
-  const provider = registry.getProvider(entry.kind);
+function pickManifestFileTree(assetPath, files, kind, registry) {
+  const provider = registry.getProvider(kind);
   if (provider) {
-    for (const file of entry.files) {
-      if (provider.matchesPath(joinPosix(entry.path, file))) return file;
+    for (const file of files) {
+      if (provider.matchesPath(joinPosix(assetPath, file))) return file;
     }
   }
-  for (const file of entry.files) {
+  for (const file of files) {
     const base = file.split("/").pop() ?? file;
     if (MANIFEST_FILENAMES2.has(base)) return file;
     if (MANIFEST_SUFFIXES2.some((s) => file.endsWith(s))) return file;
   }
-  return entry.files[0];
+  return files[0];
 }
-async function computeManifestHashTree(entry, blobByPath, fetchBlob) {
+function expandRootFilesTree(assetPath, blobByPath) {
+  const out = [];
+  const root = assetPath === "." ? "" : assetPath;
+  for (const blobPath of blobByPath.keys()) {
+    if (!isInDir(blobPath, root)) continue;
+    const rel = root === "" ? blobPath : blobPath.slice(root.length + 1);
+    if (rel.startsWith(".git/") || rel.startsWith("node_modules/") || rel.startsWith(".skaile/") || rel.includes("/.git/") || rel.includes("/node_modules/") || rel.includes("/.skaile/")) {
+      continue;
+    }
+    out.push(rel);
+  }
+  return out.sort();
+}
+async function computeManifestHashTree(assetPath, files, blobByPath, fetchBlob) {
   const hash = crypto.createHash("sha256");
-  const sorted = [...entry.files].sort();
+  const sorted = [...files].sort();
   for (const file of sorted) {
-    const full = joinPosix(entry.path, file);
+    const full = joinPosix(assetPath, file);
     const blob = blobByPath.get(full);
     if (!blob) continue;
     hash.update(file);
@@ -1523,6 +1687,6 @@ function validateRequiresSyntax2(requires) {
 // discovery/src/index.ts
 var VERSION = "0.0.0";
 
-export { AssetKindRegistry, BUILTIN_PROVIDERS, SEMVER_RE, SourceConfigSchema, VERSION, agentProvider, buildRequiresGraph, computeDeterministicHash, computeDeterministicHashDetailed, connectorProvider, contractProvider, createDefaultRegistry, detectCycles, discoverAssetsInTree, discoverAssetsInTreeEntries, discoverFromManifest, extractRequires, isExcludedDevPath, isManifestMode, loadMergedSourceConfig, loadSourceConfig, mcpServerProvider, mergeSourceConfigs, parseSourceConfig, personaProvider, presetProvider, promptProvider, rulesetProvider, skillProvider, validateSourceConfig };
-//# sourceMappingURL=chunk-LJ52ZKIU.js.map
-//# sourceMappingURL=chunk-LJ52ZKIU.js.map
+export { AssetKindRegistry, BUILTIN_PROVIDERS, SEMVER_RE, SourceConfigSchema, VERSION, agentProvider, buildRequiresGraph, computeDeterministicHash, computeDeterministicHashDetailed, connectorProvider, contractProvider, createDefaultRegistry, decodeManifestSourceConfig, detectCycles, discoverAssetsInTree, discoverAssetsInTreeEntries, discoverFromManifest, extractRequires, isExcludedDevPath, isManifestMode, loadMergedSourceConfig, loadSourceConfig, manifestToSourceConfig, mcpServerProvider, mergeSourceConfigs, parseSourceConfig, personaProvider, presetProvider, promptProvider, readManifestSourceConfig, rulesetProvider, skillProvider, validateSourceConfig };
+//# sourceMappingURL=chunk-JIQLLZ65.js.map
+//# sourceMappingURL=chunk-JIQLLZ65.js.map