@g3nomaly/skills 0.3.0 → 1.0.0

package/dist/cli/commands/remove.js

@@ -0,0 +1,60 @@
+// packages/skills/src/cli/commands/remove.ts
+import { removeEntries, ConflictDecision, StepKind } from "@g3nomaly/core/cli";
+import { saveUserManifest } from "../../registry/userManifest";
+import { openSkillProject, resolveSkillKeys, skillRegistry, skillTargets } from "../adapter";
+export const noValueDialogue = {
+    steps: {
+        selectSkills: {
+            kind: StepKind.MultiSelect,
+            message: "Select skills to remove:",
+            choices: (input) => input.keyChoices ?? [],
+        },
+    },
+};
+export const cascadeDialogue = {
+    steps: {
+        cascade: {
+            kind: StepKind.Confirm,
+            message: "Also remove {dependents}?",
+            initial: true,
+        },
+    },
+};
+export const collisionDialogue = {
+    steps: {
+        conflict: {
+            kind: StepKind.Select,
+            message: "{key} ({target}) has local changes. What would you like to do?",
+            choices: [
+                { value: ConflictDecision.Keep, label: "Keep the skill — remove nothing" },
+                { value: ConflictDecision.Overwrite, label: "Remove it anyway, including my changes" },
+            ],
+        },
+    },
+};
+export const incompleteDialogue = {
+    steps: {
+        incomplete: {
+            kind: StepKind.Confirm,
+            message: "{key} ({target}) is missing {missing} on disk. Remove the rest and untrack it?",
+            initial: true,
+        },
+    },
+};
+/** Removes installed skills and drops them from each target's `skills.json`. */
+export async function removeCommand(keys, options = {}, deps = {}) {
+    const { projectRoot, config } = await openSkillProject(deps);
+    const registry = await skillRegistry();
+    const targets = await skillTargets(config, projectRoot, options.targets);
+    // Unknown keys stay in the list so the command reports them as "not installed".
+    const { resolved, unknown } = resolveSkillKeys(keys, registry);
+    await removeEntries(registry, targets, [...resolved, ...unknown], options, {
+        onNoValue: noValueDialogue,
+        onCascade: cascadeDialogue,
+        onCollision: collisionDialogue,
+        onIncomplete: incompleteDialogue,
+    });
+    for (const target of targets)
+        saveUserManifest(target.store);
+}
+//# sourceMappingURL=remove.js.map

package/dist/cli/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../src/cli/commands/remove.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO7F,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,KAAK,EAAE;QACL,YAAY,EAAE;YACZ,IAAI,EAAK,QAAQ,CAAC,WAAW;YAC7B,OAAO,EAAE,0BAA0B;YACnC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE;SAC3C;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,KAAK,EAAE;QACL,OAAO,EAAE;YACP,IAAI,EAAK,QAAQ,CAAC,OAAO;YACzB,OAAO,EAAE,2BAA2B;YACpC,OAAO,EAAE,IAAI;SACd;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,KAAK,EAAE;QACL,QAAQ,EAAE;YACR,IAAI,EAAK,QAAQ,CAAC,MAAM;YACxB,OAAO,EAAE,gEAAgE;YACzE,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAO,KAAK,EAAE,iCAAiC,EAAE;gBAC/E,EAAE,KAAK,EAAE,gBAAgB,CAAC,SAAS,EAAE,KAAK,EAAE,wCAAwC,EAAE;aACvF;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,KAAK,EAAE;QACL,UAAU,EAAE;YACV,IAAI,EAAK,QAAQ,CAAC,OAAO;YACzB,OAAO,EAAE,gFAAgF;YACzF,OAAO,EAAE,IAAI;SACd;KACF;CACF,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc,EAAE,OAAO,GAAkB,EAAE,EAAE,IAAI,GAAgB,EAAE;IACrG,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,aAAa,EAAE,CAAC;IACvC,MAAM,OAAO,GAAI,MAAM,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1E,gFAAgF;IAChF,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE/D,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,EAAE,OAAO,EAAE;QACzE,SAAS,EAAK,eAAe;QAC7B,SAAS,EAAK,eAAe;QAC7B,WAAW,EAAG,iBAAiB;QAC/B,YAAY,EAAE,kBAAkB;KACjC,CAAC,CAAC;IAEH,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}

package/dist/cli/commands/update.d.ts

@@ -0,0 +1,13 @@
+import type { Dialogue, InstallInput, InstallOptions } from "@g3nomaly/core/cli";
+import type { ProjectDeps } from "../adapter";
+export interface UpdateOptions extends InstallOptions {
+    targets?: string[];
+}
+export declare const entryNotFoundDialogue: Dialogue<InstallInput>;
+export declare const collisionDialogue: Dialogue<InstallInput>;
+/**
+ * Re-installs skills already present in a target's `skills.json`. Files the
+ * user changed since install are reported and kept unless overwritten.
+ */
+export declare function updateCommand(keys: string[], options?: UpdateOptions, deps?: ProjectDeps): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAQxD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,YAAY,CAWpD,CAAC;AAEF;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtH"}

package/dist/cli/commands/update.js

@@ -0,0 +1,49 @@
+// packages/skills/src/cli/commands/update.ts
+import { updateEntries, runDialogueValue, ConflictDecision, StepKind, c, lineError } from "@g3nomaly/core/cli";
+import { saveUserManifest } from "../../registry/userManifest";
+import { openSkillProject, resolveSkillKeys, skillRegistry, skillSource, skillTargets } from "../adapter";
+export const entryNotFoundDialogue = {
+    steps: {
+        entryNotFound: {
+            kind: StepKind.Confirm,
+            message: "Unknown skill(s): {unknown}. Continue with the remaining selection?",
+            initial: false,
+        },
+    },
+};
+export const collisionDialogue = {
+    steps: {
+        conflict: {
+            kind: StepKind.Select,
+            message: "{key} ({target}) has local changes. What would you like to do?",
+            choices: [
+                { value: ConflictDecision.Keep, label: "Keep my changes — skip modified files" },
+                { value: ConflictDecision.Overwrite, label: "Overwrite with the package version" },
+            ],
+        },
+    },
+};
+/**
+ * Re-installs skills already present in a target's `skills.json`. Files the
+ * user changed since install are reported and kept unless overwritten.
+ */
+export async function updateCommand(keys, options = {}, deps = {}) {
+    const { projectRoot, config } = await openSkillProject(deps);
+    const registry = await skillRegistry();
+    const targets = await skillTargets(config, projectRoot, options.targets);
+    const { resolved, unknown } = resolveSkillKeys(keys, registry);
+    if (unknown.length > 0) {
+        console.error(lineError(`Unknown skill(s): ${unknown.map((k) => c.key(k)).join(", ")}. Run ${c.cmd("g3n-skills ls")} to see what is available.`));
+        const proceed = resolved.length > 0
+            && (await runDialogueValue(entryNotFoundDialogue, { unknown: unknown.map((k) => c.key(k)).join(", ") }, options.answers)) === true;
+        if (!proceed)
+            process.exit(1);
+    }
+    await updateEntries(registry, targets, skillSource, resolved, options, {
+        onCollision: collisionDialogue,
+    });
+    if (!options.dryRun)
+        for (const target of targets)
+            saveUserManifest(target.store);
+}
+//# sourceMappingURL=update.js.map

package/dist/cli/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/G,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1G,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,KAAK,EAAE;QACL,aAAa,EAAE;YACb,IAAI,EAAK,QAAQ,CAAC,OAAO;YACzB,OAAO,EAAE,qEAAqE;YAC9E,OAAO,EAAE,KAAK;SACf;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,KAAK,EAAE;QACL,QAAQ,EAAE;YACR,IAAI,EAAK,QAAQ,CAAC,MAAM;YACxB,OAAO,EAAE,gEAAgE;YACzE,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAO,KAAK,EAAE,uCAAuC,EAAE;gBACrF,EAAE,KAAK,EAAE,gBAAgB,CAAC,SAAS,EAAE,KAAK,EAAE,oCAAoC,EAAE;aACnF;SACF;KACF;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc,EAAE,OAAO,GAAkB,EAAE,EAAE,IAAI,GAAgB,EAAE;IACrG,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,aAAa,EAAE,CAAC;IACvC,MAAM,OAAO,GAAI,MAAM,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1E,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,qBAAqB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAClJ,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;eAC9B,CAAC,MAAM,gBAAgB,CAAC,qBAAqB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;QACrI,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE;QACrE,WAAW,EAAE,iBAAiB;KAC/B,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpF,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env bun
+// packages/skills/src/cli/index.ts
+import { Command } from "commander";
+import { readPackageMeta, warnIfOutdated } from "@g3nomaly/core/utils";
+import { SkillTargetSchema } from "@g3nomaly/core/config";
+import { initCommand } from "./commands/init";
+import { addCommand } from "./commands/add";
+import { removeCommand } from "./commands/remove";
+import { updateCommand } from "./commands/update";
+import { lsCommand } from "./commands/ls";
+import { hookCommand } from "./commands/hook";
+function parseTargets(value) {
+    return value === undefined ? undefined : [SkillTargetSchema.parse(value)];
+}
+// `hook` bypasses Commander so the hook's own `--flags` reach it untouched.
+if (process.argv[2] === "hook") {
+    hookCommand(process.argv[3], process.argv.slice(4));
+}
+else {
+    const program = new Command()
+        .name("g3n-skills")
+        .description("Install g3n skills into a project's agent directories");
+    program
+        .command("init")
+        .description("Configure which harnesses skills are installed for")
+        .option("-f, --force", "Reconfigure without prompting")
+        .option("--targets <list>", "Comma-separated targets (claude,codex); skips the prompt")
+        .action(async (opts) => {
+        const targets = opts.targets?.split(",").map((t) => SkillTargetSchema.parse(t.trim()));
+        await initCommand({ force: opts.force, targets });
+    });
+    program
+        .command("add [skills...]")
+        .description("Install skills or whole groups (e.g. speech, grilling)")
+        .option("-f, --force", "Overwrite locally modified files")
+        .option("-t, --target <target>", "Only this target (claude|codex)")
+        .option("--remote <url>", "Install from a git repository with a plugin or marketplace manifest instead of the package")
+        .action(async (skills, opts) => {
+        await addCommand(skills, { force: opts.force, targets: parseTargets(opts.target), remote: opts.remote });
+    });
+    program
+        .command("remove [skills...]")
+        .description("Remove installed skills")
+        .option("-f, --force", "Remove even if files have been modified")
+        .option("-t, --target <target>", "Only this target (claude|codex)")
+        .action(async (skills, opts) => {
+        await removeCommand(skills, { force: opts.force, targets: parseTargets(opts.target) });
+    });
+    program
+        .command("update [skills...]")
+        .description("Re-install installed skills from the package")
+        .option("-f, --force", "Overwrite locally modified files without prompting")
+        .option("--dry-run", "Report what would change without writing")
+        .option("-t, --target <target>", "Only this target (claude|codex)")
+        .action(async (skills, opts) => {
+        await updateCommand(skills, { force: opts.force, dryRun: opts.dryRun, targets: parseTargets(opts.target) });
+    });
+    program
+        .command("ls")
+        .description("List skills available in the package")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        await lsCommand({ json: opts.json });
+    });
+    program
+        .command("hook <name> [flags...]")
+        .description("Run a task-manager hook: sync-tree, guard-tree, next-entry, get-entry, list-entries, set-state, cleanup");
+    const self = readPackageMeta(import.meta.url);
+    await warnIfOutdated(self.name, self.version, import.meta.url);
+    program.parseAsync();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/decisions/index.d.ts

@@ -0,0 +1,6 @@
+export { decisionsDirFor, decisionPathFor } from "./paths";
+export { listDecisionIds, readDecision } from "./read";
+export type { DecisionDocument } from "./read";
+export { nextDecisionId, addDecision } from "./write";
+export type { NewDecision } from "./write";
+//# sourceMappingURL=index.d.ts.map

package/dist/decisions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decisions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/decisions/index.js

@@ -0,0 +1,5 @@
+// packages/skills/src/decisions/index.ts
+export { decisionsDirFor, decisionPathFor } from "./paths";
+export { listDecisionIds, readDecision } from "./read";
+export { nextDecisionId, addDecision } from "./write";
+//# sourceMappingURL=index.js.map

package/dist/decisions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decisions/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/decisions/paths.d.ts

@@ -0,0 +1,4 @@
+/** Folder holding a plan's decision files. */
+export declare function decisionsDirFor(planDir: string): string;
+export declare function decisionPathFor(planDir: string, id: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/decisions/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/decisions/paths.ts"],"names":[],"mappings":"AAKA,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/decisions/paths.js

@@ -0,0 +1,12 @@
+// packages/skills/src/decisions/paths.ts
+import { join } from "node:path";
+import { DECISIONS_DIR } from "../schemas/decision";
+import { MARKDOWN } from "../filetree/levels";
+/** Folder holding a plan's decision files. */
+export function decisionsDirFor(planDir) {
+    return join(planDir, DECISIONS_DIR);
+}
+export function decisionPathFor(planDir, id) {
+    return join(decisionsDirFor(planDir), `${id}${MARKDOWN}`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/decisions/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/decisions/paths.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,8CAA8C;AAC9C,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,EAAU;IACzD,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/decisions/read.d.ts

@@ -0,0 +1,18 @@
+import { type Decision } from "../schemas/decision";
+/** One decision as it sits on disk: where it was read from, its fields, its prose. */
+export interface DecisionDocument {
+    file: string;
+    meta: Decision;
+    body: string;
+}
+/** Ids of a plan's decisions, in numbered order. A plan with no `decisions/` folder has none. */
+export declare function listDecisionIds(planDir: string): Promise<string[]>;
+/**
+ * Reads one decision of a plan and checks it against its schema.
+ *
+ * @param id file name without extension, e.g. `0001-use-jwt`
+ * @throws FileValidationError when a field fails its schema, or when the `id`
+ *   inside the file disagrees with the file it was read from
+ */
+export declare function readDecision(planDir: string, id: string): Promise<DecisionDocument>;
+//# sourceMappingURL=read.d.ts.map

package/dist/decisions/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/decisions/read.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpE,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iGAAiG;AACjG,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcxE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgBzF"}

package/dist/decisions/read.js

@@ -0,0 +1,45 @@
+// packages/skills/src/decisions/read.ts
+import { readdir } from "node:fs/promises";
+import { FileValidationError, parseFile } from "../schemas/validation";
+import { DecisionSchema } from "../schemas/decision";
+import { MARKDOWN } from "../filetree/levels";
+import { readDocument } from "../filetree/frontmatter";
+import { decisionPathFor, decisionsDirFor } from "./paths";
+/** Ids of a plan's decisions, in numbered order. A plan with no `decisions/` folder has none. */
+export async function listDecisionIds(planDir) {
+    let files;
+    try {
+        files = await readdir(decisionsDirFor(planDir), { withFileTypes: true });
+    }
+    catch (error) {
+        if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    return files
+        .filter((entry) => entry.isFile() && entry.name.endsWith(MARKDOWN))
+        .map((entry) => entry.name.slice(0, -MARKDOWN.length))
+        .sort((a, b) => a.localeCompare(b));
+}
+/**
+ * Reads one decision of a plan and checks it against its schema.
+ *
+ * @param id file name without extension, e.g. `0001-use-jwt`
+ * @throws FileValidationError when a field fails its schema, or when the `id`
+ *   inside the file disagrees with the file it was read from
+ */
+export async function readDecision(planDir, id) {
+    const file = decisionPathFor(planDir, id);
+    if (!(await Bun.file(file).exists())) {
+        throw new Error(`no decision "${id}" in ${decisionsDirFor(planDir)}`);
+    }
+    const { frontmatter, body } = await readDocument(file);
+    const meta = parseFile(DecisionSchema, file, frontmatter);
+    if (meta.id !== id) {
+        throw new FileValidationError(file, [
+            { field: "id", message: `is "${meta.id}" but it was read as "${id}"` },
+        ]);
+    }
+    return { file, meta, body };
+}
+//# sourceMappingURL=read.js.map

package/dist/decisions/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/decisions/read.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAiB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAS3D,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,IAAI,KAAK,CAAC;IAEV,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACzG,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAClE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SACrD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,EAAU;IAC5D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,QAAQ,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAE1D,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE;YAClC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC,EAAE,yBAAyB,EAAE,GAAG,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC9B,CAAC"}

package/dist/decisions/write.d.ts

@@ -0,0 +1,20 @@
+import { type DecisionStatus } from "../schemas/decision";
+import { type DecisionDocument } from "./read";
+/** What `addDecision` needs from its caller; the id and date are worked out here. */
+export interface NewDecision {
+    title: string;
+    status: DecisionStatus;
+    /** Id of the earlier decision this one replaces; that file is moved to `superseded` */
+    supersedes?: string;
+    body: string;
+}
+/** Next free id in a plan: one above the highest number in use, then the title as a slug. */
+export declare function nextDecisionId(planDir: string, title: string): Promise<string>;
+/**
+ * Writes a new decision file into a plan, numbered after the ones already
+ * there and dated today. Called by the `add-decision` hook.
+ *
+ * @throws Error when `supersedes` names no decision of this plan
+ */
+export declare function addDecision(planDir: string, decision: NewDecision): Promise<DecisionDocument>;
+//# sourceMappingURL=write.d.ts.map

package/dist/decisions/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/decisions/write.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwC,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGhG,OAAO,EAAiC,KAAK,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE9E,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AASD,6FAA6F;AAC7F,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpF;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwBnG"}

package/dist/decisions/write.js

@@ -0,0 +1,48 @@
+// packages/skills/src/decisions/write.ts
+import { mkdir } from "node:fs/promises";
+import { parseFile } from "../schemas/validation";
+import { DecisionSchema, DecisionStatusSchema } from "../schemas/decision";
+import { setStatusLine } from "../filetree/status";
+import { decisionPathFor, decisionsDirFor } from "./paths";
+import { listDecisionIds, readDecision } from "./read";
+function slugFor(title) {
+    const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+    if (slug === "")
+        throw new Error(`title "${title}" has no letters or digits to build an id from`);
+    return slug;
+}
+/** Next free id in a plan: one above the highest number in use, then the title as a slug. */
+export async function nextDecisionId(planDir, title) {
+    const numbers = (await listDecisionIds(planDir)).map((id) => Number.parseInt(id.slice(0, 4), 10));
+    const next = Math.max(0, ...numbers.filter((n) => Number.isInteger(n))) + 1;
+    if (next > 9999)
+        throw new Error(`${decisionsDirFor(planDir)} has used every decision number`);
+    return `${String(next).padStart(4, "0")}-${slugFor(title)}`;
+}
+/**
+ * Writes a new decision file into a plan, numbered after the ones already
+ * there and dated today. Called by the `add-decision` hook.
+ *
+ * @throws Error when `supersedes` names no decision of this plan
+ */
+export async function addDecision(planDir, decision) {
+    const replaced = decision.supersedes === undefined
+        ? undefined
+        : await readDecision(planDir, decision.supersedes);
+    const id = await nextDecisionId(planDir, decision.title);
+    const file = decisionPathFor(planDir, id);
+    const meta = parseFile(DecisionSchema, file, {
+        id,
+        title: decision.title,
+        status: decision.status,
+        date: new Date().toISOString().slice(0, 10),
+        ...(decision.supersedes === undefined ? {} : { supersedes: decision.supersedes }),
+    });
+    await mkdir(decisionsDirFor(planDir), { recursive: true });
+    await Bun.write(file, `---\n${Bun.YAML.stringify(meta, null, 2).trimEnd()}\n---\n\n${decision.body.trim()}\n`);
+    if (replaced !== undefined && replaced.meta.status !== "superseded") {
+        await setStatusLine(replaced.file, "superseded", DecisionStatusSchema);
+    }
+    return readDecision(planDir, id);
+}
+//# sourceMappingURL=write.js.map

package/dist/decisions/write.js.map

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

package/dist/filetree/ensure.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Creates every folder and index file the tree under `root` is missing, and
+ * leaves everything that already exists untouched. A hook can call this on
+ * every run.
+ */
+export declare function ensureTree(root: string): Promise<void>;
+//# sourceMappingURL=ensure.d.ts.map

package/dist/filetree/ensure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.d.ts","sourceRoot":"","sources":["../../src/filetree/ensure.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D"}

package/dist/filetree/ensure.js

@@ -0,0 +1,36 @@
+// packages/skills/src/filetree/ensure.ts
+import { mkdir } from "node:fs/promises";
+import { resolve } from "node:path";
+import { CHILD_LEVEL } from "./levels";
+import { childDirFor, indexPathFor, tasksDirFor } from "./paths";
+import { listEntryNames } from "./entries";
+import { generateIndex } from "./generate";
+/**
+ * Creates every folder and index file the tree under `root` is missing, and
+ * leaves everything that already exists untouched. A hook can call this on
+ * every run.
+ */
+export async function ensureTree(root) {
+    await ensureFrom(resolve(root), "root");
+}
+/** `dir` is absolute; `childDirFor` keeps it that way down the walk. */
+async function ensureFrom(dir, level) {
+    await mkdir(dir, { recursive: true });
+    if (level === "phase")
+        await mkdir(tasksDirFor(dir), { recursive: true });
+    await ensureIndexFile(dir, level);
+    const child = CHILD_LEVEL[level];
+    if (child === null)
+        return;
+    for (const name of await listEntryNames(dir, level)) {
+        await ensureFrom(childDirFor(dir, name), child);
+    }
+}
+/** Builds a missing index from the folder it belongs to; keeps an existing one. */
+async function ensureIndexFile(dir, level) {
+    const exists = await Bun.file(indexPathFor(dir, level)).exists();
+    if (exists)
+        return;
+    await generateIndex(dir, level);
+}
+//# sourceMappingURL=ensure.js.map

package/dist/filetree/ensure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.js","sourceRoot":"","sources":["../../src/filetree/ensure.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAkB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,wEAAwE;AACxE,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,KAAgB;IACrD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,OAAO;QAAE,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1E,MAAM,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAElC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAE3B,KAAK,MAAM,IAAI,IAAI,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,KAAgB;IAC1D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjE,IAAI,MAAM;QAAE,OAAO;IAEnB,MAAM,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/filetree/entries.d.ts

@@ -0,0 +1,9 @@
+import { type TreeLevel } from "./levels";
+/**
+ * Names of the entries of a folder at `level`, alphabetical — the order the
+ * queue runs in. A folder only counts as an entry once it holds its own
+ * `<name>.md`, so a directory left behind by hand is skipped rather than
+ * reported as a broken plan.
+ */
+export declare function listEntryNames(dir: string, level: TreeLevel): Promise<string[]>;
+//# sourceMappingURL=entries.d.ts.map

package/dist/filetree/entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../src/filetree/entries.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAGhE;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAMrF"}

package/dist/filetree/entries.js

@@ -0,0 +1,49 @@
+// packages/skills/src/filetree/entries.ts
+import { readdir } from "node:fs/promises";
+import { ENTRY_KIND, MARKDOWN } from "./levels";
+import { entryPathFor, tasksDirFor } from "./paths";
+/**
+ * Names of the entries of a folder at `level`, alphabetical — the order the
+ * queue runs in. A folder only counts as an entry once it holds its own
+ * `<name>.md`, so a directory left behind by hand is skipped rather than
+ * reported as a broken plan.
+ */
+export async function listEntryNames(dir, level) {
+    const names = ENTRY_KIND[level] === "folder"
+        ? await listFolderEntries(dir, level)
+        : await listTaskEntries(dir);
+    return names.sort((a, b) => a.localeCompare(b));
+}
+async function listFolderEntries(dir, level) {
+    const names = [];
+    for (const entry of await readdir(dir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const described = await Bun.file(entryPathFor(dir, level, entry.name)).exists();
+        if (described)
+            names.push(entry.name);
+    }
+    return names;
+}
+/** A phase with no `tasks/` folder yet has no tasks, which is not an error. */
+async function listTaskEntries(phaseDir) {
+    let files;
+    try {
+        files = await readdir(tasksDirFor(phaseDir), { withFileTypes: true });
+    }
+    catch (error) {
+        if (isMissing(error))
+            return [];
+        throw error;
+    }
+    return files
+        .filter((entry) => entry.isFile() && entry.name.endsWith(MARKDOWN))
+        .map((entry) => entry.name.slice(0, -MARKDOWN.length));
+}
+function isMissing(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+//# sourceMappingURL=entries.js.map

package/dist/filetree/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../../src/filetree/entries.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAkB,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,KAAgB;IAChE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,QAAQ;QAC1C,CAAC,CAAC,MAAM,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC;QACrC,CAAC,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,KAAgB;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QAEnC,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAChF,IAAI,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,IAAI,KAAK,CAAC;IAEV,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAClE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,QAAQ,CACxB,CAAC;AACJ,CAAC"}

package/dist/filetree/frontmatter.d.ts

@@ -0,0 +1,16 @@
+/** A `.md` file split at its closing fence. */
+export interface Document {
+    frontmatter: unknown;
+    /** Everything after the closing fence, leading blank lines trimmed. */
+    body: string;
+}
+/**
+ * Reads a `.md` file as its frontmatter mapping plus the prose under it.
+ *
+ * @throws FileValidationError when the file has no frontmatter block or the
+ *   block is not a YAML mapping
+ */
+export declare function readDocument(file: string): Promise<Document>;
+/** Reads only the frontmatter mapping of a `.md` file. */
+export declare function readFrontmatter(file: string): Promise<unknown>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/filetree/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/filetree/frontmatter.ts"],"names":[],"mappings":"AAKA,+CAA+C;AAC/C,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBlE;AAED,0DAA0D;AAC1D,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpE"}

package/dist/filetree/frontmatter.js

@@ -0,0 +1,43 @@
+// packages/skills/src/filetree/frontmatter.ts
+import { FileValidationError } from "../schemas/validation";
+const FENCE = "---";
+/**
+ * Reads a `.md` file as its frontmatter mapping plus the prose under it.
+ *
+ * @throws FileValidationError when the file has no frontmatter block or the
+ *   block is not a YAML mapping
+ */
+export async function readDocument(file) {
+    const text = await Bun.file(file).text();
+    const split = splitAtFences(text);
+    if (split === null) {
+        throw new FileValidationError(file, [
+            { field: "(frontmatter)", message: `no ${FENCE} block at the top of the file` },
+        ]);
+    }
+    const frontmatter = Bun.YAML.parse(split.block);
+    if (typeof frontmatter !== "object" || frontmatter === null || Array.isArray(frontmatter)) {
+        throw new FileValidationError(file, [
+            { field: "(frontmatter)", message: "block is not a YAML mapping" },
+        ]);
+    }
+    return { frontmatter, body: split.body };
+}
+/** Reads only the frontmatter mapping of a `.md` file. */
+export async function readFrontmatter(file) {
+    return (await readDocument(file)).frontmatter;
+}
+/** Text inside the fences and text after them, or `null` when there are none. */
+function splitAtFences(text) {
+    const lines = text.split("\n");
+    if (lines[0]?.trimEnd() !== FENCE)
+        return null;
+    const closing = lines.findIndex((line, index) => index > 0 && line.trimEnd() === FENCE);
+    if (closing === -1)
+        return null;
+    return {
+        block: lines.slice(1, closing).join("\n"),
+        body: lines.slice(closing + 1).join("\n").replace(/^\n+/, ""),
+    };
+}
+//# sourceMappingURL=frontmatter.js.map