opensquid 0.5.395

package/dist/codex/cli.test.js

@@ -0,0 +1,277 @@
+import * as crypto from "node:crypto";
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { CodexCliError, runCodexCli } from "./cli.js";
+import { codexDir, codexesDir, getCodex } from "./store.js";
+import { isFocusedCodex } from "./types.js";
+// ---------------------------------------------------------------------
+// Isolation
+// ---------------------------------------------------------------------
+let tmpRoot;
+let sourceRoot;
+const origConsoleLog = console.log;
+const origConsoleError = console.error;
+beforeEach(async () => {
+    const uniq = crypto.randomUUID();
+    tmpRoot = path.join(os.tmpdir(), `opensquid-cli-test-${uniq}`);
+    sourceRoot = path.join(os.tmpdir(), `opensquid-cli-src-${uniq}`);
+    await fs.mkdir(tmpRoot, { recursive: true });
+    await fs.mkdir(sourceRoot, { recursive: true });
+    // Silence console during tests.
+    console.log = () => { };
+    console.error = () => { };
+});
+afterEach(async () => {
+    await fs.rm(tmpRoot, { recursive: true, force: true });
+    await fs.rm(sourceRoot, { recursive: true, force: true });
+    console.log = origConsoleLog;
+    console.error = origConsoleError;
+});
+// Fixture: write a minimal valid codex YAML + lesson body at sourceRoot.
+async function makeSourceCodex(opts) {
+    const yaml = `
+id: react-19
+version: 1.0.0
+foundation:
+  tools:
+    - { name: react, semver: ">=19,<20" }
+  domains: [software-engineering]
+detected_by:
+  - { kind: file_exists, path: "package.json" }
+seed_lessons:
+  - id: atomic-search
+    trigger: "before creating a component"
+    bank_strategy: full
+    body_path: "lessons/atomic-search/lesson.md"
+`;
+    await fs.writeFile(path.join(sourceRoot, "codex.yaml"), yaml, "utf8");
+    if (opts?.withLessonBody) {
+        const lessonDir = path.join(sourceRoot, "lessons", "atomic-search");
+        await fs.mkdir(lessonDir, { recursive: true });
+        await fs.writeFile(path.join(lessonDir, "lesson.md"), "# Atomic search\n\nSearch atoms/molecules/organisms first.\n", "utf8");
+    }
+}
+async function makeCompositeSource() {
+    const yaml = `
+id: fullstack-bundle
+kind: composite
+version: 1.0.0
+includes:
+  - { id: react, semver: ">=18" }
+  - { id: tdd, semver: ">=1" }
+`;
+    await fs.writeFile(path.join(sourceRoot, "codex.yaml"), yaml, "utf8");
+}
+// ---------------------------------------------------------------------
+// install
+// ---------------------------------------------------------------------
+describe("runCodexCli install", () => {
+    it("installs a focused codex from a local directory", async () => {
+        await makeSourceCodex({ withLessonBody: true });
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        const manifest = path.join(codexDir("react-19", tmpRoot), "codex.yaml");
+        expect((await fs.stat(manifest)).isFile()).toBe(true);
+    });
+    it("copies lesson bodies + companion files into canonical location", async () => {
+        await makeSourceCodex({ withLessonBody: true });
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        const lessonBody = path.join(codexDir("react-19", tmpRoot), "lessons", "atomic-search", "lesson.md");
+        expect((await fs.stat(lessonBody)).isFile()).toBe(true);
+        const content = await fs.readFile(lessonBody, "utf8");
+        expect(content).toContain("Atomic search");
+    });
+    it("installs a composite codex (no content copy)", async () => {
+        await makeCompositeSource();
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        const dir = codexDir("fullstack-bundle", tmpRoot);
+        const entries = await fs.readdir(dir);
+        expect(entries).toEqual(["codex.yaml"]);
+    });
+    it("accepts an explicit codex.yaml path (not just the dir)", async () => {
+        await makeSourceCodex();
+        const explicitFile = path.join(sourceRoot, "codex.yaml");
+        await runCodexCli("install", [explicitFile, "--root", tmpRoot, "--no-seed"]);
+        expect((await fs.stat(path.join(codexDir("react-19", tmpRoot), "codex.yaml"))).isFile()).toBe(true);
+    });
+    it("throws when source path doesn't exist", async () => {
+        await expect(runCodexCli("install", ["/nonexistent/path", "--root", tmpRoot])).rejects.toThrow(CodexCliError);
+    });
+    it("throws when codex.yaml is missing from source dir", async () => {
+        await expect(runCodexCli("install", [sourceRoot, "--root", tmpRoot])).rejects.toThrow(CodexCliError);
+    });
+    it("throws on malformed codex.yaml", async () => {
+        await fs.writeFile(path.join(sourceRoot, "codex.yaml"), "id: bad-id-uppercase\nNOT_A: VALID_FIELD\n", "utf8");
+        await expect(runCodexCli("install", [sourceRoot, "--root", tmpRoot])).rejects.toThrow(CodexCliError);
+    });
+    it("respects --force on re-install", async () => {
+        await makeSourceCodex();
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        // Second install without --force throws ALREADY_INSTALLED.
+        await expect(runCodexCli("install", [sourceRoot, "--root", tmpRoot])).rejects.toThrow();
+        // With --force succeeds.
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--force", "--no-seed"]);
+    });
+    it("rejects missing source arg", async () => {
+        await expect(runCodexCli("install", ["--root", tmpRoot])).rejects.toThrow(CodexCliError);
+    });
+});
+// ---------------------------------------------------------------------
+// list
+// ---------------------------------------------------------------------
+describe("runCodexCli list", () => {
+    it("succeeds on empty root", async () => {
+        await runCodexCli("list", ["--root", tmpRoot]);
+    });
+    it("succeeds when codexes are installed", async () => {
+        await makeSourceCodex();
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        await runCodexCli("list", ["--root", tmpRoot]);
+    });
+});
+// ---------------------------------------------------------------------
+// remove
+// ---------------------------------------------------------------------
+describe("runCodexCli remove", () => {
+    it("removes an installed codex", async () => {
+        await makeSourceCodex();
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        await runCodexCli("remove", ["react-19", "--root", tmpRoot]);
+        await expect(fs.access(codexDir("react-19", tmpRoot))).rejects.toThrow();
+    });
+    it("is idempotent on missing codex", async () => {
+        // No throw — just no-op.
+        await runCodexCli("remove", ["ghost", "--root", tmpRoot]);
+    });
+    it("rejects missing id arg", async () => {
+        await expect(runCodexCli("remove", ["--root", tmpRoot])).rejects.toThrow(CodexCliError);
+    });
+});
+// ---------------------------------------------------------------------
+// doctor
+// ---------------------------------------------------------------------
+describe("runCodexCli doctor", () => {
+    it("reports empty state", async () => {
+        await runCodexCli("doctor", ["--root", tmpRoot]);
+    });
+    it("reports per-codex detail when id is passed", async () => {
+        await makeSourceCodex();
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        await runCodexCli("doctor", ["react-19", "--root", tmpRoot]);
+    });
+    it("reports gracefully on missing codex when id is passed", async () => {
+        await runCodexCli("doctor", ["ghost", "--root", tmpRoot]);
+    });
+});
+// ---------------------------------------------------------------------
+// flag parsing
+// ---------------------------------------------------------------------
+describe("flag parsing", () => {
+    it("honors --root override", async () => {
+        await makeSourceCodex();
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        // Codex should be in tmpRoot, NOT in the user's actual ~/.opensquid.
+        expect((await fs.stat(codexesDir(tmpRoot))).isDirectory()).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------
+// v0.6d — SKILL.md foreign-format auto-detect + install
+// ---------------------------------------------------------------------
+const ANTHROPIC_SKILL_MD = `---
+name: pdf
+description: Use when extracting text or tables from PDF files.
+license: Apache-2.0
+---
+
+# PDF Skill
+
+Use pdfplumber for text, PyMuPDF for images.
+`;
+const HERMES_SKILL_MD = `---
+name: google_meet
+description: Schedule and join Google Meet calls.
+version: 1.2.0
+author: Hermes Team
+license: MIT
+platforms:
+  - hermes
+metadata:
+  hermes:
+    tags: [calendar, meetings]
+---
+
+# google_meet
+
+Hermes integration for Meet.
+`;
+describe("install — SKILL.md auto-detect", () => {
+    it("converts a directory containing SKILL.md and installs as native codex", async () => {
+        await fs.writeFile(path.join(sourceRoot, "SKILL.md"), ANTHROPIC_SKILL_MD, "utf8");
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        const installed = await getCodex("pdf", { rootDir: tmpRoot });
+        expect(installed.id).toBe("pdf");
+        expect(installed.version).toBe("1.0.0");
+        expect(installed.license).toBe("Apache-2.0");
+        if (!isFocusedCodex(installed))
+            throw new Error("expected focused codex");
+        expect(installed.source?.kind).toBe("skill_md");
+        expect(installed.source?.original_variant).toBe("anthropic");
+        expect(installed.source?.original_name).toBe("pdf");
+        // Lesson body got materialized.
+        const lessonBody = await fs.readFile(path.join(codexDir("pdf", tmpRoot), "lessons", "pdf", "lesson.md"), "utf8");
+        expect(lessonBody).toContain("Use pdfplumber for text");
+    });
+    it("converts a SKILL.md file path directly (not a directory)", async () => {
+        const filePath = path.join(sourceRoot, "SKILL.md");
+        await fs.writeFile(filePath, ANTHROPIC_SKILL_MD, "utf8");
+        await runCodexCli("install", [filePath, "--root", tmpRoot, "--no-seed"]);
+        const installed = await getCodex("pdf", { rootDir: tmpRoot });
+        expect(installed.id).toBe("pdf");
+    });
+    it("rewrites underscore names to hyphens (google_meet → google-meet)", async () => {
+        await fs.writeFile(path.join(sourceRoot, "SKILL.md"), HERMES_SKILL_MD, "utf8");
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        const installed = await getCodex("google-meet", { rootDir: tmpRoot });
+        expect(installed.id).toBe("google-meet");
+        expect(installed.version).toBe("1.2.0");
+        if (!isFocusedCodex(installed))
+            throw new Error("expected focused codex");
+        expect(installed.source?.original_variant).toBe("hermes");
+        expect(installed.source?.original_name).toBe("google_meet");
+        expect(installed.metadata?.platforms).toEqual(["hermes"]);
+    });
+    it("prefers codex.yaml over SKILL.md when both exist (auto-detect)", async () => {
+        // Native codex says id=react-19; SKILL.md says id=pdf. Auto-detect
+        // picks codex.yaml. --source skill_md would override.
+        await makeSourceCodex({ withLessonBody: true });
+        await fs.writeFile(path.join(sourceRoot, "SKILL.md"), ANTHROPIC_SKILL_MD, "utf8");
+        await runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"]);
+        const installed = await getCodex("react-19", { rootDir: tmpRoot });
+        expect(installed.id).toBe("react-19");
+        // pdf should NOT be installed.
+        await expect(getCodex("pdf", { rootDir: tmpRoot })).rejects.toThrow();
+    });
+    it("--source skill_md forces SKILL.md branch when both files exist", async () => {
+        await makeSourceCodex({ withLessonBody: true });
+        await fs.writeFile(path.join(sourceRoot, "SKILL.md"), ANTHROPIC_SKILL_MD, "utf8");
+        await runCodexCli("install", [
+            sourceRoot,
+            "--root",
+            tmpRoot,
+            "--no-seed",
+            "--source",
+            "skill_md",
+        ]);
+        const installed = await getCodex("pdf", { rootDir: tmpRoot });
+        expect(installed.id).toBe("pdf");
+    });
+    it("rejects invalid --source value", async () => {
+        await fs.writeFile(path.join(sourceRoot, "SKILL.md"), ANTHROPIC_SKILL_MD, "utf8");
+        await expect(runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed", "--source", "yaml"])).rejects.toThrow(CodexCliError);
+    });
+    it("reports a clear error for malformed SKILL.md (missing description)", async () => {
+        await fs.writeFile(path.join(sourceRoot, "SKILL.md"), "---\nname: broken\n---\nbody\n", "utf8");
+        await expect(runCodexCli("install", [sourceRoot, "--root", tmpRoot, "--no-seed"])).rejects.toThrow(/description/);
+    });
+});

package/dist/codex/import-skill-md.d.ts

@@ -0,0 +1,53 @@
+/**
+ * SKILL.md → opensquid native codex converter (v0.6d).
+ *
+ * Pure functions. No filesystem side effects. Takes a raw SKILL.md
+ * string + optional path metadata, returns a `{codex, lesson}` pair
+ * that the install pipeline materializes to disk before calling the
+ * existing `installCodex` + `copyCodexContent` path.
+ *
+ * Handles the union of:
+ * - Anthropic skills (https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) — `name`, `description`, optional `license`, optional experimental `allowed-tools` / `model` / `compatibility`
+ * - obra/superpowers — strict Anthropic subset (name + description, CSO description discipline)
+ * - everything-claude-code (ECC) — Anthropic + non-standard `origin: ECC`
+ * - Hermes Agent skills (~/projects/hermes-agent/skills/) — Anthropic + `version` + `author` + `platforms` + `metadata.hermes.{tags, related_skills}`
+ *
+ * 100% deterministic. No LLM call. Per [[find-simple-solutions]]:
+ * frontmatter → codex.yaml is structural mapping; body → one lesson is
+ * the trivial 1:1 case that every sampled SKILL.md follows. Sub-skill
+ * body-splitting is deferred until a real corpus demands it.
+ */
+import type { Codex, CodexSource } from "./types.js";
+export type SkillMdVariant = NonNullable<CodexSource["original_variant"]>;
+export interface SkillMdParseResult {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export interface ConvertOptions {
+    /** Absolute path to the source SKILL.md (or its containing dir). */
+    originalPath?: string;
+    /** Wall-clock at conversion time. Defaults to `new Date().toISOString()`. */
+    now?: string;
+}
+export interface ConvertedLesson {
+    /** Lesson id (slug). */
+    id: string;
+    /** Path relative to the codex root — written via `lessons/<id>/lesson.md`. */
+    bodyPath: string;
+    /** Raw markdown body to write at `bodyPath`. */
+    body: string;
+}
+export interface ConvertedCodex {
+    codex: Codex;
+    lessons: ConvertedLesson[];
+    variant: SkillMdVariant;
+}
+export declare class SkillMdImportError extends Error {
+    readonly hint?: string | undefined;
+    constructor(message: string, hint?: string | undefined);
+}
+export declare function parseSkillMd(source: string): SkillMdParseResult;
+export declare function slugify(name: string): string;
+export declare function detectVariant(frontmatter: Record<string, unknown>, originalPath?: string): SkillMdVariant;
+export declare function convertSkillMdToCodex(source: string, options?: ConvertOptions): ConvertedCodex;
+//# sourceMappingURL=import-skill-md.d.ts.map

package/dist/codex/import-skill-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-skill-md.d.ts","sourceRoot":"","sources":["../../src.legacy/codex/import-skill-md.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAmB,WAAW,EAA2B,MAAM,YAAY,CAAC;AAM/F,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAE1E,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,cAAc,CAAC;CACzB;AAMD,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,IAAI,CAAC,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAQD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CA6C/D;AAQD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5C;AAMD,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CA6BhB;AAMD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,cAAc,CA8HhB"}

package/dist/codex/import-skill-md.js

@@ -0,0 +1,236 @@
+/**
+ * SKILL.md → opensquid native codex converter (v0.6d).
+ *
+ * Pure functions. No filesystem side effects. Takes a raw SKILL.md
+ * string + optional path metadata, returns a `{codex, lesson}` pair
+ * that the install pipeline materializes to disk before calling the
+ * existing `installCodex` + `copyCodexContent` path.
+ *
+ * Handles the union of:
+ * - Anthropic skills (https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) — `name`, `description`, optional `license`, optional experimental `allowed-tools` / `model` / `compatibility`
+ * - obra/superpowers — strict Anthropic subset (name + description, CSO description discipline)
+ * - everything-claude-code (ECC) — Anthropic + non-standard `origin: ECC`
+ * - Hermes Agent skills (~/projects/hermes-agent/skills/) — Anthropic + `version` + `author` + `platforms` + `metadata.hermes.{tags, related_skills}`
+ *
+ * 100% deterministic. No LLM call. Per [[find-simple-solutions]]:
+ * frontmatter → codex.yaml is structural mapping; body → one lesson is
+ * the trivial 1:1 case that every sampled SKILL.md follows. Sub-skill
+ * body-splitting is deferred until a real corpus demands it.
+ */
+import { parse as parseYaml } from "yaml";
+// ---------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------
+export class SkillMdImportError extends Error {
+    hint;
+    constructor(message, hint) {
+        super(message);
+        this.hint = hint;
+        this.name = "SkillMdImportError";
+    }
+}
+// ---------------------------------------------------------------------
+// Parse SKILL.md frontmatter + body
+// ---------------------------------------------------------------------
+const FRONTMATTER_FENCE_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+export function parseSkillMd(source) {
+    if (!source || !source.trim()) {
+        throw new SkillMdImportError("SKILL.md is empty", "SKILL.md must have a YAML frontmatter block + body");
+    }
+    // v0.6d audit fix (L1): strip UTF-8 BOM if present. The fence regex
+    // requires `---` at the very start; a BOM-prefixed file (common from
+    // Windows editors) would silently fail the match.
+    const stripped = source.charCodeAt(0) === 0xfeff ? source.slice(1) : source;
+    const match = stripped.match(FRONTMATTER_FENCE_RE);
+    if (!match) {
+        throw new SkillMdImportError("SKILL.md missing YAML frontmatter (--- ... ---) at top", "wrap your frontmatter in triple-dash fences and ensure the closing fence is on its own line");
+    }
+    const [, yamlText, bodyText] = match;
+    let parsed;
+    try {
+        parsed = parseYaml(yamlText);
+    }
+    catch (e) {
+        throw new SkillMdImportError(`SKILL.md frontmatter is not valid YAML: ${e instanceof Error ? e.message : String(e)}`, "frontmatter must be parseable as YAML (key: value pairs)");
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new SkillMdImportError("SKILL.md frontmatter must be a YAML mapping (key: value pairs)");
+    }
+    const frontmatter = parsed;
+    if (typeof frontmatter.name !== "string" || !frontmatter.name.trim()) {
+        throw new SkillMdImportError("SKILL.md frontmatter missing required `name` field", "per the Anthropic spec, `name` is required (max 64 chars, [a-z0-9-])");
+    }
+    if (typeof frontmatter.description !== "string" || !frontmatter.description.trim()) {
+        throw new SkillMdImportError("SKILL.md frontmatter missing required `description` field", "per the Anthropic spec, `description` is required (max 1024 chars)");
+    }
+    return { frontmatter, body: (bodyText ?? "").trim() };
+}
+// ---------------------------------------------------------------------
+// Slugify (ASCII-safe — sampled SKILL.md names are all ASCII)
+// ---------------------------------------------------------------------
+const SLUG_MAX_LEN = 64;
+export function slugify(name) {
+    const lower = name.toLowerCase();
+    // Replace any run of non-alphanumerics with a single dash. Trim
+    // leading/trailing dashes. Cap length per Anthropic spec.
+    const dashed = lower.replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+    if (!dashed) {
+        throw new SkillMdImportError(`cannot slugify name "${name}" (no alphanumeric characters)`, "skill names must include at least one ASCII letter or digit");
+    }
+    return dashed.slice(0, SLUG_MAX_LEN);
+}
+// ---------------------------------------------------------------------
+// Variant detection
+// ---------------------------------------------------------------------
+export function detectVariant(frontmatter, originalPath) {
+    if (frontmatter.origin === "ECC")
+        return "ecc";
+    // Hermes: rich frontmatter (`platforms`, `metadata.hermes.*`)
+    if (Array.isArray(frontmatter.platforms))
+        return "hermes";
+    const meta = frontmatter.metadata;
+    if (meta && typeof meta === "object" && !Array.isArray(meta)) {
+        if (meta.hermes !== undefined)
+            return "hermes";
+    }
+    // superpowers: path-based detection only. The CSO "Use when..." phrasing
+    // is recommended by superpowers but Anthropic's own skill-creator also
+    // uses it, so description alone is too noisy to distinguish.
+    const path = (originalPath ?? "").toLowerCase();
+    if (path.includes("superpowers/skills/") || path.includes("/superpowers/")) {
+        return "superpowers";
+    }
+    // Pure Anthropic minimum: only name + description (+ optional license)
+    const keys = new Set(Object.keys(frontmatter));
+    const anthropicKnown = new Set([
+        "name",
+        "description",
+        "license",
+        "compatibility",
+        "metadata",
+        "allowed-tools",
+        "model",
+    ]);
+    const allKnown = [...keys].every((k) => anthropicKnown.has(k));
+    if (allKnown)
+        return "anthropic";
+    return "unknown";
+}
+// ---------------------------------------------------------------------
+// Main conversion
+// ---------------------------------------------------------------------
+export function convertSkillMdToCodex(source, options = {}) {
+    const { frontmatter, body } = parseSkillMd(source);
+    const rawName = frontmatter.name.trim();
+    const id = slugify(rawName);
+    const description = frontmatter.description.trim();
+    const variant = detectVariant(frontmatter, options.originalPath);
+    const now = options.now ?? new Date().toISOString();
+    // ----- version: Hermes provides one; default to "1.0.0" otherwise -----
+    let version = "1.0.0";
+    let versionSynthesized = true;
+    if (typeof frontmatter.version === "string" && frontmatter.version.trim()) {
+        version = frontmatter.version.trim();
+        versionSynthesized = false;
+    }
+    // ----- author: Hermes "author" is a flat string; opensquid wants {name, contact?} -----
+    let author;
+    const rawAuthor = frontmatter.author;
+    if (typeof rawAuthor === "string" && rawAuthor.trim()) {
+        author = { name: rawAuthor.trim() };
+    }
+    else {
+        author = { name: "Imported from SKILL.md" };
+    }
+    // ----- license: pass through if present -----
+    const license = typeof frontmatter.license === "string" && frontmatter.license.trim()
+        ? frontmatter.license.trim()
+        : undefined;
+    // ----- foundation.tools from Anthropic experimental `allowed-tools` -----
+    let tools;
+    const allowedTools = frontmatter["allowed-tools"];
+    if (Array.isArray(allowedTools) && allowedTools.length > 0) {
+        tools = [];
+        for (const t of allowedTools) {
+            if (typeof t === "string" && t.trim()) {
+                tools.push({ name: t.trim() });
+            }
+        }
+        if (tools.length === 0)
+            tools = undefined;
+    }
+    // ----- preserved non-standard frontmatter → metadata extensibility bucket -----
+    const metadata = { imported_from: "skill_md" };
+    if (versionSynthesized) {
+        // mark for downstream auditing
+        metadata.imported = { synthesized_version: true };
+    }
+    // Preserve every frontmatter key we don't have a first-class slot for.
+    for (const [k, v] of Object.entries(frontmatter)) {
+        if (k === "name" ||
+            k === "description" ||
+            k === "version" ||
+            k === "author" ||
+            k === "license" ||
+            k === "allowed-tools") {
+            continue;
+        }
+        // Anthropic optional `model` → metadata.model. Hermes `platforms` →
+        // metadata.platforms. ECC `origin` → metadata.origin. Hermes
+        // `metadata.hermes.*` is already a nested object; preserve it under
+        // metadata.hermes (don't flatten).
+        if (k === "metadata" && v && typeof v === "object" && !Array.isArray(v)) {
+            // Merge into our metadata bucket without overwriting our own keys.
+            for (const [mk, mv] of Object.entries(v)) {
+                if (!(mk in metadata)) {
+                    metadata[mk] = mv;
+                }
+            }
+            continue;
+        }
+        metadata[k] = v;
+    }
+    // ----- source provenance -----
+    const sourceBlock = {
+        kind: "skill_md",
+        original_variant: variant,
+        original_name: rawName,
+        original_path: options.originalPath,
+        imported_at: now,
+    };
+    // ----- seed lesson (one cohesive lesson per SKILL.md) -----
+    // The lesson trigger is the description verbatim — lossy in tone but
+    // functionally correct. Future LLM-mediated trigger synthesis (deferred)
+    // could rewrite into the imperative voice opensquid prefers.
+    const seedLesson = {
+        id,
+        trigger: description,
+        priority: "medium",
+        bank_strategy: "full",
+        body_path: `lessons/${id}/lesson.md`,
+    };
+    // Lesson body = the SKILL.md body verbatim. If empty (extremely rare —
+    // would mean a frontmatter-only file), synthesize a stub.
+    const lessonBody = body.length > 0
+        ? body
+        : `# ${rawName}\n\n${description}\n\n*(Imported from SKILL.md with no body content.)*\n`;
+    const codex = {
+        id,
+        version,
+        description,
+        author,
+        license,
+        source: sourceBlock,
+        metadata,
+        kind: "focused",
+        foundation: tools ? { tools } : undefined,
+        seed_lessons: [seedLesson],
+        evolves: true,
+    };
+    return {
+        codex,
+        lessons: [{ id, bodyPath: seedLesson.body_path, body: lessonBody }],
+        variant,
+    };
+}
+//# sourceMappingURL=import-skill-md.js.map

package/dist/codex/import-skill-md.js.map

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