@namewta/speculo 2.0.6 → 2.1.1

package/dist/src/hub-catalog.d.ts

@@ -0,0 +1,11 @@
+import { type SkillNode } from "./skill-trees.js";
+export type HubSkill = {
+    id: string;
+    name: string;
+    description: string;
+    root: string;
+    tree: Map<string, SkillNode>;
+};
+export type HubCatalog = Map<string, HubSkill>;
+/** Only category/name is a public entry. Nested SKILL.md files are package resources. */
+export declare function discoverHubCatalog(packageRoot: string): Promise<HubCatalog>;

package/dist/src/hub-catalog.js

@@ -0,0 +1,91 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join, posix } from "node:path";
+import { parseFrontmatter, readAssetCatalog, validateSkill } from "./assets.js";
+import { safeRelativePath } from "./paths.js";
+import { snapshotSkillTree, validSkillNode } from "./skill-trees.js";
+const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Only category/name is a public entry. Nested SKILL.md files are package resources. */
+export async function discoverHubCatalog(packageRoot) {
+    const root = join(packageRoot, "skills-hub"), catalog = new Map();
+    // npm omits .gitignore and normalizes modes. The build snapshot preserves the
+    // complete source package; any shipped source bytes that differ are rejected.
+    let bundle;
+    try {
+        bundle = JSON.parse(await readFile(join(packageRoot, "dist/src/hub-resources.json"), "utf8"));
+    }
+    catch (e) {
+        if (e.code !== "ENOENT")
+            throw e;
+    }
+    if (bundle && (bundle.schema_version !== 1 || !Array.isArray(bundle.packages) || new Set(bundle.packages.map(p => p.id)).size !== bundle.packages.length))
+        throw new Error("invalid-hub-bundle");
+    const names = new Set((await readAssetCatalog(join(packageRoot, "template"))).assets.map(a => a.name));
+    const categories = await readdir(root, { withFileTypes: true }).catch((e) => { if (e.code === "ENOENT")
+        return []; throw e; });
+    for (const category of categories.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (category.isSymbolicLink())
+            throw new Error("hub-source-symlink: " + category.name);
+        if (!category.isDirectory())
+            continue;
+        if (!SLUG.test(category.name))
+            throw new Error("invalid-hub-category: " + category.name);
+        for (const entry of (await readdir(join(root, category.name), { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
+            if (entry.isSymbolicLink())
+                throw new Error("hub-source-symlink: " + entry.name);
+            if (!entry.isDirectory())
+                continue;
+            const source = join(root, category.name, entry.name), content = await readFile(join(source, "SKILL.md"));
+            const errors = validateSkill(content, entry.name);
+            if (errors.length)
+                throw new Error(`invalid-hub-skill: ${category.name}/${entry.name}: ${errors.join("; ")}`);
+            if (names.has(entry.name))
+                throw new Error("duplicate-skill-name: " + entry.name);
+            names.add(entry.name);
+            const id = `${category.name}/${entry.name}`;
+            let tree = await snapshotSkillTree(source, { source: true });
+            if (bundle) {
+                const packaged = bundle.packages.find(p => p.id === id);
+                if (!packaged || !Array.isArray(packaged.nodes))
+                    throw new Error("missing-hub-bundle-package: " + id);
+                const original = new Map();
+                for (const { path, node } of packaged.nodes) {
+                    if (typeof path !== "string" || path && (!safeRelativePath(path) || path.endsWith("/")) || original.has(path) || !validSkillNode(node) || node.kind === "absent")
+                        throw new Error("invalid-hub-bundle-node");
+                    original.set(path, process.platform === "win32" ? { ...node, mode: node.kind === "directory" ? 0o755 : node.mode & 0o200 ? 0o666 : 0o444 } : node);
+                }
+                if (original.get("")?.kind !== "directory" || original.get("SKILL.md")?.kind !== "file")
+                    throw new Error("invalid-hub-bundle-root");
+                for (const [path, node] of original)
+                    if (path && original.get(posix.dirname(path) === "." ? "" : posix.dirname(path))?.kind !== "directory")
+                        throw new Error("invalid-hub-bundle-parent");
+                for (const [path, node] of tree) {
+                    const expected = original.get(path);
+                    if (!expected || expected.kind !== node.kind || node.kind === "file" && (expected.kind !== "file" || expected.content !== node.content))
+                        throw new Error(`stale-hub-bundle: ${id}/${path}; rebuild from skills-hub`);
+                }
+                tree = original;
+            }
+            // Markdown links to package resources must stay in this complete package.
+            for (const [path, node] of tree)
+                if (node.kind === "file" && path.endsWith(".md")) {
+                    const text = Buffer.from(node.content, "base64").toString("utf8").replace(/```[^]*?```/g, "");
+                    for (const match of text.matchAll(/\[[^\]]*\]\(([^\s)]+)(?:\s+"[^"]*")?\)/g)) {
+                        const link = match[1];
+                        if (/^(?:[a-z][a-z0-9+.-]*:|#|\/)/i.test(link) || /[<>${}]/.test(link))
+                            continue;
+                        const resource = decodeURIComponent(link.split("#")[0]);
+                        if (!resource)
+                            continue;
+                        const resolved = posix.normalize(posix.join(posix.dirname(path), resource)).replace(/\/$/, "");
+                        if (!safeRelativePath(resolved) || !tree.has(resolved))
+                            throw new Error(`hub-resource-link: ${category.name}/${entry.name}/${path}: ${link}`);
+                    }
+                }
+            catalog.set(id, { id, name: entry.name, description: String(parseFrontmatter(content).fields.description), root: source, tree });
+        }
+    }
+    if (bundle && bundle.packages.some(p => !catalog.has(p.id)))
+        throw new Error("hub-bundle-catalog-mismatch");
+    return catalog;
+}
+//# sourceMappingURL=hub-catalog.js.map

package/dist/src/hub-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-catalog.js","sourceRoot":"","sources":["../../src/hub-catalog.ts"],"names":[],"mappings":"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"}