@zedtech/zedkit-ai 0.0.0 → 0.2.0

package/dist/bin.d.ts

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

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// Original work by the same author.
+import { main } from "./cli.js";
+process.exitCode = main(process.argv.slice(2), {
+    out: (line) => console.log(line),
+    err: (line) => console.error(line),
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,oCAAoC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IAC7C,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAChC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+/** Where the CLI writes: normal lines and error lines. */
+export type Sinks = {
+    out: (line: string) => void;
+    err: (line: string) => void;
+};
+/** Run the CLI. Returns the process exit code (0 ok, 1 validation problems, 2 usage or runtime error). */
+export declare function main(argv: string[], sinks: Sinks): number;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAyBA,0DAA0D;AAC1D,MAAM,MAAM,KAAK,GAAG;IAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CAAC;AAqFjF,0GAA0G;AAC1G,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAQzD"}

package/dist/cli.js

@@ -0,0 +1,123 @@
+// Original work by the same author.
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { err, ok, tryCatch } from "@zedtech/zedkit-core";
+import { installKit } from "./install.js";
+import { readManifest } from "./kit.js";
+import { checkDrift, validateKit } from "./validate.js";
+const USAGE = `zedkit-ai <command>
+
+  init [dir] [--preset core|full] [--provider ...] [--dry-run]
+      Copy skills, subagents, commands and an AGENTS.md template into dir
+      (default .), then wire the providers (default all). Never overwrites
+      existing files (an existing AGENTS.md without the ladder gets the
+      ladder section appended). --provider takes cursor,claude,codex,muse,all;
+      --target is an alias of --provider.
+  validate [dir]
+      Check skills, subagents and commands, plus provider-copy drift
+      (default dir: .agents; a project root is accepted too). Exit 1
+      on problems.
+  list
+      Show presets, subagents and commands.
+`;
+const OPTIONS = {
+    preset: { type: "string" },
+    provider: { type: "string" },
+    target: { type: "string" },
+    "dry-run": { type: "boolean" },
+};
+function parse(args, options, maxPositionals) {
+    const parsed = tryCatch(() => parseArgs({ args, allowPositionals: true, options }));
+    if (!parsed.ok)
+        return err(parsed.error);
+    if (parsed.value.positionals.length > maxPositionals) {
+        return err(new Error(`unexpected argument "${parsed.value.positionals[maxPositionals]}"`));
+    }
+    return ok(parsed.value);
+}
+function parseProviders(value) {
+    if (value === undefined)
+        return ok(undefined);
+    const names = String(value).split(",").map((s) => s.trim());
+    if (names.includes("all"))
+        return ok(undefined);
+    const bad = names.find((n) => n !== "claude" && n !== "cursor" && n !== "codex" && n !== "muse");
+    if (bad !== undefined)
+        return err(new Error(`unknown provider "${bad}" (cursor, claude, codex, muse, all)`));
+    return ok(names);
+}
+function fail(message, sinks) {
+    sinks.err(`error: ${message}`);
+    return 2;
+}
+function runInit(args, sinks) {
+    const parsed = parse(args, OPTIONS, 1);
+    if (!parsed.ok)
+        return fail(parsed.error.message, sinks);
+    const { values, positionals } = parsed.value;
+    const providers = parseProviders(values.provider ?? values.target);
+    if (!providers.ok)
+        return fail(providers.error.message, sinks);
+    const dryRun = values["dry-run"] === true;
+    const preset = typeof values.preset === "string" ? values.preset : undefined;
+    const result = installKit({
+        dest: resolve(positionals[0] ?? "."),
+        ...(preset !== undefined && { preset }),
+        ...(providers.value !== undefined && { providers: providers.value }),
+        dryRun,
+    });
+    if (!result.ok)
+        return fail(result.error.message, sinks);
+    for (const action of result.value) {
+        sinks.out(`${action.kind.padEnd(5)} ${action.path}${action.note ? `  (${action.note})` : ""}`);
+    }
+    sinks.out(dryRun ? "dry run: nothing written" : "next: ask your agent to run the `setup-ai` skill, then `zedkit-ai validate`");
+    return 0;
+}
+function runValidate(args, sinks) {
+    const parsed = parse(args, {}, 1);
+    if (!parsed.ok)
+        return fail(parsed.error.message, sinks);
+    const dir = resolve(parsed.value.positionals[0] ?? ".agents");
+    if (!existsSync(dir))
+        return fail(`no such directory: ${dir}`, sinks);
+    // A project root points at its .agents/; an .agents/ dir drifts against
+    // its own parent. Any other dir just has nothing to drift against.
+    const nested = join(dir, ".agents");
+    const agentsDir = existsSync(nested) ? nested : dir;
+    const projectRoot = agentsDir === dir ? dirname(dir) : dir;
+    const issues = [...validateKit(agentsDir), ...checkDrift(projectRoot, agentsDir)];
+    for (const issue of issues)
+        sinks.out(`${issue.path}: ${issue.message}`);
+    sinks.out(issues.length === 0 ? "ok" : `${issues.length} problem(s)`);
+    return issues.length === 0 ? 0 : 1;
+}
+function runList(args, sinks) {
+    const parsed = parse(args, {}, 0);
+    if (!parsed.ok)
+        return fail(parsed.error.message, sinks);
+    const manifest = readManifest();
+    if (!manifest.ok)
+        return fail(manifest.error.message, sinks);
+    for (const [name, skills] of Object.entries(manifest.value.presets)) {
+        sinks.out(`preset ${name}: ${skills === "*" ? "every skill" : skills.join(", ")}`);
+    }
+    sinks.out(`agents: ${manifest.value.agents.join(", ")}`);
+    sinks.out(`commands: ${(manifest.value.commands ?? []).join(", ") || "(none)"}`);
+    return 0;
+}
+/** Run the CLI. Returns the process exit code (0 ok, 1 validation problems, 2 usage or runtime error). */
+export function main(argv, sinks) {
+    const [command, ...rest] = argv;
+    if (command === "init")
+        return runInit(rest, sinks);
+    if (command === "validate")
+        return runValidate(rest, sinks);
+    if (command === "list")
+        return runList(rest, sinks);
+    const help = command === undefined || command === "--help" || command === "-h";
+    (help ? sinks.out : sinks.err)(USAGE.trimEnd());
+    return help ? 0 : 2;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAe,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAiB,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,KAAK,GAAG;;;;;;;;;;;;;;CAcb,CAAC;AAOF,MAAM,OAAO,GAAG;IACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1B,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CACtB,CAAC;AAEX,SAAS,KAAK,CAAC,IAAc,EAAE,OAA+C,EAAE,cAAsB;IACpG,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QACrD,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,EAAE,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,cAAc,CAAC,KAAmC;IACzD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC;IACjG,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,qBAAqB,GAAG,sCAAsC,CAAC,CAAC,CAAC;IAC7G,OAAO,EAAE,CAAC,KAAmB,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,IAAI,CAAC,OAAe,EAAE,KAAY;IACzC,KAAK,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IAC/B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,OAAO,CAAC,IAAc,EAAE,KAAY;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7C,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;IACnE,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACpC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;QACvC,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;QACpE,MAAM;KACP,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,6EAA6E,CAAC,CAAC;IAC/H,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,IAAc,EAAE,KAAY;IAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,sBAAsB,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IACtE,wEAAwE;IACxE,mEAAmE;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACpD,MAAM,WAAW,GAAG,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3D,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,EAAE,GAAG,UAAU,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAClF,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,aAAa,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,OAAO,CAAC,IAAc,EAAE,KAAY;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACpE,KAAK,CAAC,GAAG,CAAC,UAAU,IAAI,KAAK,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,WAAW,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IACjF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,IAAI,CAAC,IAAc,EAAE,KAAY;IAC/C,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5D,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC;IAC/E,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC"}

package/dist/frontmatter.d.ts

@@ -0,0 +1,9 @@
+import { type Result } from "@zedtech/zedkit-core";
+export type Frontmatter = {
+    /** Parsed YAML mapping. */
+    data: Record<string, unknown>;
+    /** Frontmatter source text, without the `---` fences. */
+    raw: string;
+};
+export declare function parseFrontmatter(text: string): Result<Frontmatter>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGtE,MAAM,MAAM,WAAW,GAAG;IACxB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAKF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAelE"}

package/dist/frontmatter.js

@@ -0,0 +1,22 @@
+// Original work by the same author.
+import { err, ok, tryCatch } from "@zedtech/zedkit-core";
+import { parse } from "yaml";
+// Optional BOM, opening fence, body (may be empty), closing fence.
+const FENCE = /^\uFEFF?---[ \t]*\n(?:([\s\S]*?)\n)?---[ \t]*(?:\n|$)/;
+export function parseFrontmatter(text) {
+    const match = FENCE.exec(text.replace(/\r\n/g, "\n"));
+    if (!match) {
+        return err(new Error("missing frontmatter (file must start with a --- block)"));
+    }
+    const raw = match[1] ?? "";
+    const parsed = tryCatch(() => parse(raw));
+    if (!parsed.ok) {
+        return err(new Error(`invalid YAML frontmatter: ${parsed.error.message}`));
+    }
+    const value = parsed.value ?? {};
+    if (typeof value !== "object" || Array.isArray(value)) {
+        return err(new Error("frontmatter must be a YAML mapping"));
+    }
+    return ok({ data: value, raw });
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAe,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAS7B,mEAAmE;AACnE,MAAM,KAAK,GAAG,uDAAuD,CAAC;AAEtE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,KAAgC,EAAE,GAAG,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { type Action, type InstallOptions, type Provider, type Target, installKit } from "./install.js";
+export { type Issue, checkDrift, validateKit } from "./validate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxG,OAAO,EAAE,KAAK,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { installKit } from "./install.js";
+export { checkDrift, validateKit } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxG,OAAO,EAAc,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,36 @@
+import { type Result } from "@zedtech/zedkit-core";
+export type Provider = "claude" | "cursor" | "codex" | "muse";
+/** @deprecated Use {@link Provider}. Kept so `--target` and old callers keep working. */
+export type Target = Provider;
+export type InstallOptions = {
+    /** Project directory to install into. */
+    dest: string;
+    /** Preset name from kit.json. Default `core`. */
+    preset?: string;
+    /** Providers to wire. Default: all. */
+    providers?: Provider[];
+    /** @deprecated Use `providers`. */
+    targets?: Target[];
+    /** Report what would happen without touching the disk. */
+    dryRun?: boolean;
+    /** Custom kit directory (default: the bundled kit). */
+    kit?: string;
+};
+export type Action = {
+    kind: "copy" | "link" | "write" | "append" | "skip";
+    path: string;
+    /** Why it was skipped, what was appended, or what a link points to. */
+    note?: string;
+};
+/**
+ * Install the kit into a project. The shared source (skills, subagents,
+ * commands, AGENTS.md) is copied into `.agents/` (the project owns it from
+ * then on); each chosen provider then gets its thin layer, links where the
+ * provider follows them, real files where it does not. Existing files are
+ * never overwritten: they are reported as skipped, except an existing
+ * AGENTS.md missing the ladder, which gets the ladder section appended
+ * (reported as `append`). A bad preset or kit fails before anything is
+ * written.
+ */
+export declare function installKit(options: InstallOptions): Result<Action[]>;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAeA,OAAO,EAAqB,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAItE,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,yFAAyF;AACzF,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;AAE9B,MAAM,MAAM,cAAc,GAAG;IAC3B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AA0NF;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAapE"}

package/dist/install.js

@@ -0,0 +1,242 @@
+// Original work by the same author.
+import { copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, readlinkSync, statSync, symlinkSync, writeFileSync, } from "node:fs";
+import { dirname, join, sep } from "node:path";
+import { err, ok, tryCatch } from "@zedtech/zedkit-core";
+import { parseFrontmatter } from "./frontmatter.js";
+import { kitDir, readManifest } from "./kit.js";
+const ALL_PROVIDERS = ["claude", "cursor", "codex", "muse"];
+const CURSOR_RULE = `---
+description: Project rules
+alwaysApply: true
+---
+
+Read and follow /AGENTS.md at the repo root, and use the skills in .agents/skills.
+`;
+function lstatOf(path) {
+    const stat = tryCatch(() => lstatSync(path));
+    return stat.ok ? stat.value : undefined;
+}
+function isDirectory(path) {
+    const stat = tryCatch(() => statSync(path));
+    return stat.ok && stat.value.isDirectory();
+}
+// Why `rel` cannot be created, or undefined when the way is free. The path
+// itself is taken if anything (even a dangling symlink) is there; a parent
+// that is not a directory would make the write fail halfway.
+function obstacle(ctx, rel) {
+    const parts = rel.split(sep);
+    for (let i = 1; i < parts.length; i++) {
+        const parent = join(ctx.dest, ...parts.slice(0, i));
+        if (lstatOf(parent) && !isDirectory(parent)) {
+            return `${parts.slice(0, i).join(sep)} is not a directory`;
+        }
+    }
+    return lstatOf(join(ctx.dest, rel)) ? "already exists, left untouched" : undefined;
+}
+function place(ctx, kind, rel, make, note) {
+    const blocked = obstacle(ctx, rel);
+    if (blocked) {
+        const current = tryCatch(() => readlinkSync(join(ctx.dest, rel)));
+        const same = kind === "link" && current.ok && current.value === note;
+        ctx.actions.push({ kind: "skip", path: rel, note: same ? "already linked" : blocked });
+        return;
+    }
+    ctx.actions.push({ kind, path: rel, ...(note !== undefined && { note }) });
+    if (ctx.dryRun)
+        return;
+    mkdirSync(dirname(join(ctx.dest, rel)), { recursive: true });
+    make();
+}
+function copyFile(ctx, from, rel) {
+    place(ctx, "copy", rel, () => copyFileSync(from, join(ctx.dest, rel)));
+}
+function link(ctx, rel, target) {
+    place(ctx, "link", rel, () => symlinkSync(target, join(ctx.dest, rel)), target);
+}
+function skillNames(manifest, kit, preset) {
+    const entry = Object.hasOwn(manifest.presets, preset) ? manifest.presets[preset] : undefined;
+    if (entry === undefined) {
+        throw new Error(`unknown preset "${preset}" (have: ${Object.keys(manifest.presets).join(", ")})`);
+    }
+    if (entry !== "*")
+        return entry;
+    return readdirSync(join(kit, "skills"), { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+}
+// Resolve everything the install needs from the kit before the first write,
+// so a bad preset or manifest never leaves a half install behind.
+function plan(kit, manifest, preset) {
+    const skills = skillNames(manifest, kit, preset);
+    for (const name of skills) {
+        if (!existsSync(join(kit, "skills", name, "SKILL.md")))
+            throw new Error(`kit has no skill "${name}"`);
+    }
+    for (const name of manifest.agents) {
+        if (!existsSync(join(kit, "agents", `${name}.md`)))
+            throw new Error(`kit has no agent "${name}"`);
+    }
+    const commands = manifest.commands ?? [];
+    for (const name of commands) {
+        if (!existsSync(join(kit, "commands", `${name}.md`)))
+            throw new Error(`kit has no command "${name}"`);
+    }
+    const licences = readdirSync(join(kit, "skills")).filter((f) => f.startsWith("LICENSE-"));
+    return { skills, licences, agents: manifest.agents, commands };
+}
+// The ladder section every AGENTS.md must carry, lifted from the bundled
+// template so the wording has a single home. Undefined when the kit has
+// no template or no ladder section (foreign kits keep working).
+function ladderSection(kit) {
+    const template = tryCatch(() => readFileSync(join(kit, "AGENTS.template.md"), "utf8"));
+    if (!template.ok)
+        return undefined;
+    const start = template.value.indexOf("## Before writing any code");
+    if (start < 0)
+        return undefined;
+    const rest = template.value.slice(start);
+    const next = rest.indexOf("\n## ", 1);
+    return `${(next < 0 ? rest : rest.slice(0, next)).trimEnd()}\n`;
+}
+// Fresh projects get the whole template; an existing AGENTS.md is never
+// overwritten, but when it lacks the ladder the section is appended (and
+// reported as `append`, so dry runs agree with real ones).
+function installAgentsMd(ctx) {
+    const blocked = obstacle(ctx, "AGENTS.md");
+    if (blocked === undefined) {
+        copyFile(ctx, join(ctx.kit, "AGENTS.template.md"), "AGENTS.md");
+        return;
+    }
+    const current = tryCatch(() => readFileSync(join(ctx.dest, "AGENTS.md"), "utf8"));
+    if (!current.ok || current.value.toLowerCase().includes("ladder")) {
+        ctx.actions.push({ kind: "skip", path: "AGENTS.md", note: blocked });
+        return;
+    }
+    const section = ladderSection(ctx.kit);
+    if (section === undefined) {
+        ctx.actions.push({ kind: "skip", path: "AGENTS.md", note: blocked });
+        return;
+    }
+    ctx.actions.push({ kind: "append", path: "AGENTS.md", note: "ladder section" });
+    if (ctx.dryRun)
+        return;
+    const gap = current.value === "" ? "" : current.value.endsWith("\n") ? "\n" : "\n\n";
+    writeFileSync(join(ctx.dest, "AGENTS.md"), `${current.value}${gap}${section}`);
+}
+function installContent(ctx, content) {
+    for (const name of content.skills) {
+        const rel = join(".agents", "skills", name);
+        // dereference: a symlink inside a skill must not be copied as a dangling one
+        place(ctx, "copy", rel, () => cpSync(join(ctx.kit, "skills", name), join(ctx.dest, rel), { recursive: true, dereference: true }));
+    }
+    // Licence texts of vendored skills travel with them.
+    for (const file of content.licences) {
+        copyFile(ctx, join(ctx.kit, "skills", file), join(".agents", "skills", file));
+    }
+    copyFile(ctx, join(ctx.kit, "THIRD_PARTY_NOTICES.md"), join(".agents", "THIRD_PARTY_NOTICES.md"));
+    // Project personas for persona-review; an existing file is left untouched.
+    if (existsSync(join(ctx.kit, "personas.template.md"))) {
+        copyFile(ctx, join(ctx.kit, "personas.template.md"), join(".agents", "personas.md"));
+    }
+    for (const name of content.agents) {
+        copyFile(ctx, join(ctx.kit, "agents", `${name}.md`), join(".agents", "agents", `${name}.md`));
+    }
+    for (const name of content.commands) {
+        copyFile(ctx, join(ctx.kit, "commands", `${name}.md`), join(".agents", "commands", `${name}.md`));
+    }
+    installAgentsMd(ctx);
+}
+function agentsMdReady(ctx) {
+    if (ctx.actions.some((a) => a.kind === "copy" && a.path === "AGENTS.md"))
+        return true;
+    const stat = tryCatch(() => statSync(join(ctx.dest, "AGENTS.md")));
+    return stat.ok && stat.value.isFile();
+}
+// Name of another rule in .cursor/rules/ that is already always on, if any.
+// A second always-on rule would only duplicate (or fight) it, so the
+// installer skips project.mdc then. Reads the disk only, so dry runs agree.
+function existingAlwaysOnRule(ctx) {
+    const dir = join(ctx.dest, ".cursor", "rules");
+    const entries = tryCatch(() => readdirSync(dir, { withFileTypes: true }));
+    if (!entries.ok)
+        return undefined;
+    for (const entry of entries.value) {
+        if (!entry.isFile() || !entry.name.endsWith(".mdc") || entry.name === "project.mdc")
+            continue;
+        const read = tryCatch(() => readFileSync(join(dir, entry.name), "utf8"));
+        if (!read.ok)
+            continue;
+        const front = parseFrontmatter(read.value);
+        if (front.ok && front.value.data.alwaysApply === true)
+            return entry.name;
+    }
+    return undefined;
+}
+function writeCursorRule(ctx) {
+    const rel = join(".cursor", "rules", "project.mdc");
+    if (obstacle(ctx, rel) === undefined) {
+        const existing = existingAlwaysOnRule(ctx);
+        if (existing !== undefined) {
+            ctx.actions.push({ kind: "skip", path: rel, note: `always-on rule ${existing} already exists` });
+            return;
+        }
+    }
+    place(ctx, "write", rel, () => writeFileSync(join(ctx.dest, rel), CURSOR_RULE));
+}
+function wireClaude(ctx) {
+    link(ctx, join(".claude", "skills"), "../.agents/skills");
+    link(ctx, join(".claude", "agents"), "../.agents/agents");
+    link(ctx, join(".claude", "commands"), "../.agents/commands");
+    // Only when AGENTS.md is (or will be) a real file: never a dangling link.
+    if (agentsMdReady(ctx))
+        link(ctx, "CLAUDE.md", "AGENTS.md");
+    else
+        ctx.actions.push({ kind: "skip", path: "CLAUDE.md", note: "AGENTS.md is not a file" });
+}
+function wireCursor(ctx, content) {
+    link(ctx, join(".cursor", "skills"), "../.agents/skills");
+    // Real files, not links: a symlinked folder shows up empty here, so the
+    // copies are authoritative for Cursor. They can drift from .agents/;
+    // checkDrift reports that, and init never overwrites them.
+    for (const name of content.agents) {
+        copyFile(ctx, join(ctx.kit, "agents", `${name}.md`), join(".cursor", "agents", `${name}.md`));
+    }
+    for (const name of content.commands) {
+        copyFile(ctx, join(ctx.kit, "commands", `${name}.md`), join(".cursor", "commands", `${name}.md`));
+    }
+    writeCursorRule(ctx);
+}
+function wireProvider(ctx, provider, content) {
+    if (provider === "claude")
+        wireClaude(ctx);
+    else if (provider === "cursor")
+        wireCursor(ctx, content);
+    // codex and muse read the shared source directly (AGENTS.md plus
+    // .agents/): no per-provider layer to generate.
+}
+/**
+ * Install the kit into a project. The shared source (skills, subagents,
+ * commands, AGENTS.md) is copied into `.agents/` (the project owns it from
+ * then on); each chosen provider then gets its thin layer, links where the
+ * provider follows them, real files where it does not. Existing files are
+ * never overwritten: they are reported as skipped, except an existing
+ * AGENTS.md missing the ladder, which gets the ladder section appended
+ * (reported as `append`). A bad preset or kit fails before anything is
+ * written.
+ */
+export function installKit(options) {
+    const kit = options.kit ?? kitDir();
+    const manifest = readManifest(kit);
+    if (!manifest.ok)
+        return err(manifest.error);
+    const ctx = { dest: options.dest, kit, dryRun: options.dryRun ?? false, actions: [] };
+    const run = tryCatch(() => {
+        const content = plan(kit, manifest.value, options.preset ?? "core");
+        installContent(ctx, content);
+        for (const provider of options.providers ?? options.targets ?? ALL_PROVIDERS) {
+            wireProvider(ctx, provider, content);
+        }
+    });
+    return run.ok ? ok(ctx.actions) : err(run.error);
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/kit.d.ts

@@ -0,0 +1,13 @@
+import { type Result } from "@zedtech/zedkit-core";
+export type KitManifest = {
+    /** Preset name -> skill names, or "*" for every skill in the kit. */
+    presets: Record<string, string[] | "*">;
+    /** Subagent names (files in `agents/`). */
+    agents: string[];
+    /** Command names (files in `commands/`). Absent means none. */
+    commands?: string[];
+};
+/** Absolute path of the bundled kit (same relative spot from `src/` and `dist/`). */
+export declare function kitDir(): string;
+export declare function readManifest(dir?: string): Result<KitManifest>;
+//# sourceMappingURL=kit.d.ts.map

package/dist/kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEtE,MAAM,MAAM,WAAW,GAAG;IACxB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IACxC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAMD,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAiB,GAAG,MAAM,CAAC,WAAW,CAAC,CAuBxE"}

package/dist/kit.js

@@ -0,0 +1,36 @@
+// Original work by the same author.
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { err, ok, tryCatch } from "@zedtech/zedkit-core";
+/** Absolute path of the bundled kit (same relative spot from `src/` and `dist/`). */
+export function kitDir() {
+    return fileURLToPath(new URL("../kit/", import.meta.url));
+}
+function isStringList(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+export function readManifest(dir = kitDir()) {
+    const read = tryCatch(() => JSON.parse(readFileSync(`${dir}/kit.json`, "utf8")));
+    if (!read.ok) {
+        return err(new Error(`cannot read kit.json in ${dir}: ${read.error.message}`));
+    }
+    const data = read.value;
+    const presets = data?.presets;
+    if (!presets || typeof presets !== "object" || !isStringList(data?.agents)) {
+        return err(new Error("kit.json needs `presets` (object) and `agents` (string list)"));
+    }
+    if (data.commands !== undefined && !isStringList(data.commands)) {
+        return err(new Error("kit.json `commands` must be a string list"));
+    }
+    for (const [name, value] of Object.entries(presets)) {
+        if (value !== "*" && !isStringList(value)) {
+            return err(new Error(`kit.json preset "${name}" must be a string list or "*"`));
+        }
+    }
+    return ok({
+        presets: presets,
+        agents: data.agents,
+        ...(data.commands !== undefined && { commands: data.commands }),
+    });
+}
+//# sourceMappingURL=kit.js.map

package/dist/kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAe,MAAM,sBAAsB,CAAC;AAWtE,qFAAqF;AACrF,MAAM,UAAU,MAAM;IACpB,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,MAAM,EAAE;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,GAAG,WAAW,EAAE,MAAM,CAAC,CAAY,CAAC,CAAC;IAC5F,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,2BAA2B,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAA2F,CAAC;IAC9G,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChE,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,oBAAoB,IAAI,gCAAgC,CAAC,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;QACR,OAAO,EAAE,OAAiC;QAC1C,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAoB,EAAE,CAAC;KAC5E,CAAC,CAAC;AACL,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,22 @@
+export type Issue = {
+    path: string;
+    message: string;
+};
+/**
+ * Check a directory laid out as `skills/<name>/SKILL.md`, `agents/<name>.md`,
+ * `commands/<name>.md` and optionally `kit.json`. Returns every problem
+ * found; empty means valid. An unreadable entry (dangling symlink,
+ * permissions) is reported as a problem instead of throwing.
+ */
+export declare function validateKit(root: string): Issue[];
+/**
+ * Compare the provider copies (`.cursor/agents`, `.cursor/commands`) against
+ * the shared `source` (usually the project's `.agents/`). Copies are real
+ * files because that provider does not follow a symlinked folder here; when
+ * the source changes they go stale, and init never overwrites them. Reports
+ * each missing or drifted copy. Links and missing folders cannot drift and
+ * are skipped silently, as are extra files on the provider side (the user's
+ * own). Paths are relative to `projectRoot`.
+ */
+export declare function checkDrift(projectRoot: string, source: string): Issue[];
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAoMtD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAMjD;AAOD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,CAoBvE"}

package/dist/validate.js

@@ -0,0 +1,240 @@
+// Original work by the same author.
+import { existsSync, lstatSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { tryCatch } from "@zedtech/zedkit-core";
+import { readManifest } from "./kit.js";
+import { parseFrontmatter } from "./frontmatter.js";
+const NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const MAX_NAME = 64;
+const MAX_DESCRIPTION = 1024;
+function read(path) {
+    return readFileSync(path, "utf8");
+}
+function dirsIn(path) {
+    if (!existsSync(path))
+        return [];
+    return readdirSync(path).filter((entry) => statSync(join(path, entry)).isDirectory());
+}
+function checkName(name, expected, path, issues) {
+    if (name !== expected) {
+        issues.push({ path, message: `name must equal "${expected}" (got ${JSON.stringify(name)})` });
+    }
+    if (!NAME.test(expected) || expected.length > MAX_NAME) {
+        issues.push({ path, message: `name must be lowercase-hyphen, at most ${MAX_NAME} characters` });
+    }
+}
+// True when `description:` is a plain or quoted scalar that fits on one line.
+// A block scalar (`>`, `|`) can be shown literally in an agent list, and a
+// continuation line is just as invisible to simple parsers.
+function isSingleLineDescription(raw) {
+    const lines = raw.split("\n");
+    const at = lines.findIndex((line) => /^description:/.test(line));
+    if (at < 0)
+        return true;
+    const value = (lines[at] ?? "").slice("description:".length).trim();
+    const next = lines[at + 1];
+    return value !== "" && !/^[>|]/.test(value) && !(next !== undefined && /^[ \t]+\S/.test(next));
+}
+function checkDescription(value, path, issues) {
+    if (typeof value !== "string" || value.trim() === "") {
+        issues.push({ path, message: "description is required and must be a non-empty string" });
+    }
+    else if (value.length > MAX_DESCRIPTION) {
+        issues.push({ path, message: `description is ${value.length} characters (max ${MAX_DESCRIPTION})` });
+    }
+}
+function checkSkill(root, name, issues) {
+    const file = join(root, "skills", name, "SKILL.md");
+    const path = relative(root, file);
+    if (!existsSync(file)) {
+        issues.push({ path: relative(root, join(root, "skills", name)), message: "skill folder has no SKILL.md" });
+        return;
+    }
+    const parsed = parseFrontmatter(read(file));
+    if (!parsed.ok) {
+        issues.push({ path, message: parsed.error.message });
+        return;
+    }
+    checkName(parsed.value.data.name, name, path, issues);
+    checkDescription(parsed.value.data.description, path, issues);
+}
+function checkAgent(root, file, issues) {
+    const path = join("agents", file);
+    const parsed = parseFrontmatter(read(join(root, path)));
+    if (!parsed.ok) {
+        issues.push({ path, message: parsed.error.message });
+        return;
+    }
+    const { data, raw } = parsed.value;
+    checkName(data.name, file.replace(/\.md$/, ""), path, issues);
+    checkDescription(data.description, path, issues);
+    if (!isSingleLineDescription(raw)) {
+        issues.push({ path, message: "description must be a single line (no `>` or `|` block, no continuation lines)" });
+    }
+    // An id the tool does not know falls back silently, and the kit is
+    // tool-agnostic: only `inherit` is portable.
+    if (data.model !== undefined && data.model !== "inherit") {
+        issues.push({ path, message: 'model must be omitted or "inherit" (pin a model in your project, after listing what your tool accepts)' });
+    }
+    // `readonly` is a single-tool field, and at least one tool drops the
+    // whole definition when it sees an unknown key. Read-only stays in the
+    // prompt body plus `disallowedTools`, which every tool tolerates.
+    if (data.readonly !== undefined) {
+        issues.push({ path, message: "readonly is not portable: some tools skip agent files that set it (use disallowedTools instead)" });
+    }
+}
+function checkCommand(root, file, skills, issues) {
+    const path = join("commands", file);
+    const base = file.replace(/\.md$/, "");
+    if (!NAME.test(base) || base.length > MAX_NAME) {
+        issues.push({ path, message: `name must be lowercase-hyphen, at most ${MAX_NAME} characters` });
+    }
+    const text = read(join(root, path));
+    const parsed = parseFrontmatter(text);
+    if (!parsed.ok) {
+        issues.push({ path, message: parsed.error.message });
+        return;
+    }
+    checkDescription(parsed.value.data.description, path, issues);
+    if (!isSingleLineDescription(parsed.value.raw)) {
+        issues.push({ path, message: "description must be a single line (no `>` or `|` block, no continuation lines)" });
+    }
+    // A command runs a skill by name: it must name at least one installed one.
+    const names = [...skills].filter((name) => text.includes(`\`${name}\``));
+    if (names.length === 0) {
+        issues.push({ path, message: "names no installed skill (a command runs a `skill` by name)" });
+    }
+}
+function checkLineEndings(root, issues) {
+    const entries = readdirSync(root, { recursive: true, encoding: "utf8" });
+    for (const entry of entries) {
+        const full = join(root, entry);
+        if (entry.endsWith(".md") && statSync(full).isFile() && read(full).includes("\r")) {
+            issues.push({ path: entry, message: "CR found: use LF line endings" });
+        }
+    }
+}
+const LADDER_SKILLS = ["plan", "implement", "review", "ponytail-review"];
+// The ponytail ladder must survive in the skills that ask it and in the
+// template every setup inherits. Only checked where the file exists, so
+// minimal or foreign layouts are unaffected.
+function checkLadder(root, issues) {
+    for (const name of LADDER_SKILLS) {
+        const file = join(root, "skills", name, "SKILL.md");
+        if (existsSync(file) && !read(file).toLowerCase().includes("ladder")) {
+            issues.push({
+                path: relative(root, file),
+                message: "must state the ponytail ladder (regression: the 7 questions vanished)",
+            });
+        }
+    }
+    const template = join(root, "AGENTS.template.md");
+    if (existsSync(template) && !read(template).toLowerCase().includes("ladder")) {
+        issues.push({
+            path: "AGENTS.template.md",
+            message: "must state the ponytail ladder (every setup inherits this file)",
+        });
+    }
+}
+function checkManifest(root, issues) {
+    if (!existsSync(join(root, "kit.json")))
+        return;
+    const manifest = readManifest(root);
+    if (!manifest.ok) {
+        issues.push({ path: "kit.json", message: manifest.error.message });
+        return;
+    }
+    const skills = new Set(dirsIn(join(root, "skills")));
+    const agents = new Set(existsSync(join(root, "agents"))
+        ? readdirSync(join(root, "agents")).map((f) => f.replace(/\.md$/, ""))
+        : []);
+    for (const [preset, names] of Object.entries(manifest.value.presets)) {
+        for (const name of names === "*" ? [] : names) {
+            if (!skills.has(name))
+                issues.push({ path: "kit.json", message: `preset "${preset}" lists missing skill "${name}"` });
+        }
+    }
+    for (const name of manifest.value.agents) {
+        if (!agents.has(name))
+            issues.push({ path: "kit.json", message: `lists missing agent "${name}"` });
+    }
+    const commands = new Set(existsSync(join(root, "commands"))
+        ? readdirSync(join(root, "commands")).map((f) => f.replace(/\.md$/, ""))
+        : []);
+    for (const name of manifest.value.commands ?? []) {
+        if (!commands.has(name))
+            issues.push({ path: "kit.json", message: `lists missing command "${name}"` });
+    }
+}
+function collect(root) {
+    const issues = [];
+    const skills = new Set(dirsIn(join(root, "skills")));
+    for (const name of skills)
+        checkSkill(root, name, issues);
+    const agentsDir = join(root, "agents");
+    if (existsSync(agentsDir)) {
+        for (const file of readdirSync(agentsDir).filter((f) => f.endsWith(".md"))) {
+            checkAgent(root, file, issues);
+        }
+    }
+    const commandsDir = join(root, "commands");
+    if (existsSync(commandsDir)) {
+        for (const file of readdirSync(commandsDir).filter((f) => f.endsWith(".md"))) {
+            checkCommand(root, file, skills, issues);
+        }
+    }
+    checkManifest(root, issues);
+    checkLadder(root, issues);
+    checkLineEndings(root, issues);
+    return issues;
+}
+/**
+ * Check a directory laid out as `skills/<name>/SKILL.md`, `agents/<name>.md`,
+ * `commands/<name>.md` and optionally `kit.json`. Returns every problem
+ * found; empty means valid. An unreadable entry (dangling symlink,
+ * permissions) is reported as a problem instead of throwing.
+ */
+export function validateKit(root) {
+    if (!existsSync(root)) {
+        return [{ path: root, message: "directory does not exist" }];
+    }
+    const result = tryCatch(() => collect(root));
+    return result.ok ? result.value : [{ path: root, message: `cannot read: ${result.error.message}` }];
+}
+function isRealDir(path) {
+    const stat = tryCatch(() => lstatSync(path));
+    return stat.ok && stat.value.isDirectory();
+}
+/**
+ * Compare the provider copies (`.cursor/agents`, `.cursor/commands`) against
+ * the shared `source` (usually the project's `.agents/`). Copies are real
+ * files because that provider does not follow a symlinked folder here; when
+ * the source changes they go stale, and init never overwrites them. Reports
+ * each missing or drifted copy. Links and missing folders cannot drift and
+ * are skipped silently, as are extra files on the provider side (the user's
+ * own). Paths are relative to `projectRoot`.
+ */
+export function checkDrift(projectRoot, source) {
+    const run = tryCatch(() => {
+        const issues = [];
+        for (const kind of ["agents", "commands"]) {
+            const from = join(source, kind);
+            const to = join(projectRoot, ".cursor", kind);
+            if (!isRealDir(from) || !isRealDir(to))
+                continue;
+            for (const file of readdirSync(from).filter((f) => f.endsWith(".md"))) {
+                const target = join(to, file);
+                const want = relative(projectRoot, join(from, file));
+                if (!existsSync(target)) {
+                    issues.push({ path: relative(projectRoot, target), message: `copy missing: copy it from ${want} or re-run init` });
+                }
+                else if (read(target) !== read(join(from, file))) {
+                    issues.push({ path: relative(projectRoot, target), message: `drifted from ${want}: copy it over (init never overwrites)` });
+                }
+            }
+        }
+        return issues;
+    });
+    return run.ok ? run.value : [{ path: projectRoot, message: `cannot check drift: ${run.error.message}` }];
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/kit/agents/plan-challenger.md

@@ -1,50 +1,10 @@
 ---
 name: plan-challenger
-description: "Pre-mortem for a plan, run before any code is written: is each part needed, is each claim verified, what fails in production. Use after the architect's plan or on any non-trivial design. Reports ranked objections; never writes code."
+description: "Deprecated alias of the skeptic agent (angle: plan). Kept for one release so existing briefs keep working; new briefs must name skeptic with an angle."
 model: inherit
 disallowedTools: Write, Edit, NotebookEdit
 ---
 
-You are the skeptic in the room. Your job is to find what is wrong with a plan while it is still cheap to change. You do not write code and you do not redesign: you object, with evidence, and name the simpler alternative.
-
-If you are given a loose idea instead of a plan, first state it as a plan (what changes, where) so there is something concrete to attack.
-
-## Three questions for every part of the plan
-
-Search the repository before claiming something is missing or duplicated. Cite `file:line`.
-
-1. **Is it needed?** Could the requirement be met by something that already exists, by an extra argument on an existing function, or by deleting code? Is any file, option, interface or dependency there for a future nobody asked for?
-2. **Is it true?** Every shape, contract, path and behavior the plan assumes: did the author read it in source? List each assumption as VERIFIED (you opened it) or UNVERIFIED. An UNVERIFIED assumption that the design rests on is a blocker.
-3. **Is it enough?** Does the plan cover the requirement's edge cases and error paths? Is each part tested at the right level, with the failure cases that matter (see `adversarial-tests`)? Does a bug fix come with a test that fails first?
-
-## Pre-mortem
-
-Assume the change shipped and caused an incident. Write the three most likely stories, from the plan's own gaps:
-
-- **Load**: a call per item in a loop, an unbounded list or fan-out, a query with no index, a third party's rate limit.
-- **Compatibility**: old data or old clients meeting the new version, a consumer you did not search for, a half-finished rollout.
-- **State**: a flow that can stop midway and leave a wrong status, a retry that repeats a side effect, two writers at once.
-
-For each story say which part of the plan allows it and the smallest change that prevents it.
-
-## Rules
-
-- Rank objections: BLOCKER (do not start until resolved), SHOULD (fix in this change), COULD (note it). Report low-probability findings as COULD instead of dropping them.
-- Reject (BLOCKER) a plan whose ladder table is missing, or weak: a piece hand-made at rung 7 with no one-line justification while rung 3–5 could cover it. Verify the table's claims against the repo before accepting them.
-- Never accept a contract or shape you have not seen in source.
-- Do not pad. Five sharp objections beat twenty vague ones.
-
-## Output
-
-```
-## Challenge: <feature>
-Restated plan: <two lines>
-
-Assumptions: <claim — VERIFIED/UNVERIFIED — how to verify>
-Objections:
-1. [BLOCKER|SHOULD|COULD] <part of plan> — <objection> — <evidence file:line> — <simpler alternative>
-Pre-mortem: <three stories, each with the part of the plan and the prevention>
-
-Verdict: GO — no blockers
-         REVISE — <N> blockers, and what would make them go away
-```
+This agent was renamed to `skeptic`. Behave exactly as `skeptic` with angle
+`plan`, and note once at the top of your report that the caller should switch
+to `skeptic`.

package/kit/agents/skeptic.md

@@ -0,0 +1,62 @@
+---
+name: skeptic
+description: "Pre-mortem for a plan or decision, run before building: attacks it from one angle per brief (plan, ui/ux, security, scope, data/ops, copy). Use after the architect's plan or on any non-trivial design. Reports ranked objections; never writes code."
+model: inherit
+disallowedTools: Write, Edit, NotebookEdit
+---
+
+You are the skeptic in the room. Your job is to find what is wrong while it is
+still cheap to change. The brief names your angle (one or several, below).
+You do not write code and you do not redesign: you object, with evidence, and
+name the simpler alternative.
+
+If you are given a loose idea instead of a plan, first state it as a plan
+(what changes, where) so there is something concrete to attack.
+
+## Three questions for every part (all angles)
+
+Search the repository before claiming something is missing or duplicated. Cite `file:line`.
+
+1. **Is it needed?** Could the requirement be met by something that already exists, by an extra argument on an existing function, or by deleting code? Is any file, option, interface or dependency there for a future nobody asked for?
+2. **Is it true?** Every shape, contract, path and behavior assumed: did the author read it in source? List each assumption as VERIFIED (you opened it) or UNVERIFIED. An UNVERIFIED assumption that the design rests on is a blocker.
+3. **Is it enough?** Does it cover the edge cases and error paths? Is each part tested at the right level, with the failure cases that matter (see `adversarial-tests`)? Does a bug fix come with a test that fails first?
+
+## Pre-mortem (all angles)
+
+Assume it shipped and caused an incident. Write the three most likely stories:
+
+- **Load**: a call per item in a loop, an unbounded list or fan-out, a query with no index, a third party's rate limit.
+- **Compatibility**: old data or old clients meeting the new version, a consumer you did not search for, a half-finished rollout.
+- **State**: a flow that can stop midway and leave a wrong status, a retry that repeats a side effect, two writers at once.
+
+For each story say which part allows it and the smallest change that prevents it.
+
+## Angles (the brief picks)
+
+- **plan**: the classic review above, plus: reject (BLOCKER) a plan whose ladder table is missing or weak — a piece hand-made at rung 7 with no one-line justification while rung 3–5 could cover it. Verify the table's claims against the repo.
+- **ui/ux**: is each choice needed for the lazy, distracted, doubtful end client? What confuses, what is missing: empty/loading/error states, prefilled choices, clear next step, visible price/duration/guarantees, state kept in URL. Never propose a component the kit already has — search it first.
+- **security**: attacker view on the design: trust boundaries, auth gaps, secret handling, tenant isolation, injection and IDOR shapes, what a malicious input or user reaches.
+- **scope**: is it worth building? Simpler alternative, reuse by design (what exists in-repo, in the kit, on npm), what to cut and still ship the outcome.
+- **data/ops**: failure, migration and rollback: what breaks mid-run, backfill story, rollback story, observability (logs, metrics, alerts), data loss and replay.
+- **copy**: microcopy review: plain words, no jargon, errors that say what happened and the next step, message keys instead of hard-coded strings, tone consistent with the product.
+
+## Rules
+
+- Rank objections: BLOCKER (do not start until resolved), SHOULD (fix in this change), COULD (note it). Report low-probability findings as COULD instead of dropping them.
+- Never accept a contract or shape you have not seen in source.
+- Do not pad. Five sharp objections beat twenty vague ones.
+
+## Output
+
+```
+## Challenge: <feature> (angle: <plan|ui/ux|...>)
+Restated plan: <two lines>
+
+Assumptions: <claim — VERIFIED/UNVERIFIED — how to verify>
+Objections:
+1. [BLOCKER|SHOULD|COULD] <part> — <objection> — <evidence file:line> — <simpler alternative>
+Pre-mortem: <three stories, each with the part and the prevention>
+
+Verdict: GO — no blockers
+         REVISE — <N> blockers, and what would make them go away
+```

package/kit/kit.json

@@ -33,7 +33,8 @@
     "plan-challenger",
     "verifier",
     "improver",
-    "security-reviewer"
+    "security-reviewer",
+    "skeptic"
   ],
   "commands": [
     "review",

package/kit/personas.template.md

@@ -0,0 +1,16 @@
+# Project personas
+
+Named audiences for `persona-review`. The skill reads this file, picks 2–4
+personas per change, and requires evidence (command, screenshot, `file:line`)
+for every verdict. Customize names and details per project; keep one row each
+for the end client, the integrator, and the operator.
+
+| Persona | Task | Bar |
+|---|---|---|
+| Lazy end client (distracted, doubtful) | complete the task on a phone, half-attentive | reassured, choices prefilled, clear next step, price/duration/guarantees visible, state kept in URL |
+| Integrating developer | adopt the feature from README + examples alone | contract, errors and failure semantics clear without reading the implementation |
+| Coding agent | consume the API/docs programmatically | machine-readable surface, stable names, no hidden steps, examples that run |
+| Maintainer / operator | see what happened, repair, replay | logs, recovery path, no data loss, rollback documented |
+| New contributor | make a first correct change | conventions discoverable, tests runnable, review checklist clear |
+| Security reviewer | verify isolation, auth and secrets | verifiable from tests + code, no trust-me steps |
+| Business owner | judge delivery | stated problem solved, adoption cost stated, big picture in one paragraph |

package/kit/skills/challenge/SKILL.md

@@ -8,9 +8,9 @@ plan wastes implementation effort.
 
 ## Process
 
-1. Run the `plan-challenger` subagent on the plan: needed parts only,
-   verified claims, production failure modes. Ranked objections, no code.
-   Reject a plan whose ladder table is missing or weak.
+1. Run the `skeptic` subagent (angle: plan) on the plan: needed parts
+   only, verified claims, production failure modes. Ranked objections, no
+   code. Reject a plan whose ladder table is missing or weak.
 2. Check the domain language with `domain-modeling` (terms sharp, glossary
    and ADRs current) and the module shape with `codebase-design` (deep
    modules, seams in the right place).

package/kit/skills/persona-review/SKILL.md

@@ -10,7 +10,7 @@ A change can be correct and still useless to the person it is for. Name the audi
 ## Steps
 
 1. **Name the recipient** of the deliverable and the task they are trying to do. If the repo's docs do not say, ask.
-2. **Pick 2 to 4 personas** whose view differs. Common ones:
+2. **Pick 2 to 4 personas** whose view differs. First read the repo's `.agents/personas.md` (installed from the kit template, customized per project); fall back to these generics only when it is missing:
 
 | Persona | Question |
 |---|---|

package/kit/skills/review/SKILL.md

@@ -13,13 +13,14 @@ missing) and capture it once: `git diff <fixed-point>...HEAD` plus
 `git log <fixed-point>..HEAD --oneline`. Fail fast here on a bad ref or an
 empty diff — never inside the subagents.
 
-## 2. Pick the lenses
+## 2. Pick the lenses (route over `lenses.md`)
 
-Always: `code-review` (its Standards and Spec axes; Standards applies
-`ponytail-review`, never ad-hoc smells) and `persona-review` (does the change
-serve its real audience). Add `adversarial-tests` when logic, handlers or
-endpoints changed; add the `security-reviewer` subagent when auth, secrets,
-tenancy, user data or external calls are touched.
+Read the registry in `lenses.md` (same folder). Minimum on every review:
+`code`, `ponytail`, `persona`, `quality gate`. Add each lens whose Trigger
+matches the pinned diff (e.g. `packages/ui/**` -> `ui` + `a11y` + `copy`;
+`package.json`/lockfile -> `dependencies`; public API -> `release`).
+A lens whose runner is `planned` reports skipped-planned (not a blocker);
+skipping a mandatory lens whose runner exists IS a blocker — say so.
 
 ## 3. Fan out
 
@@ -34,4 +35,12 @@ finding. When the change implements a plan with a ladder table, brief
 
 Dedupe across lenses (same location and issue keep the strongest wording),
 rank by severity, and end with exactly one verdict: ship, fix-then-ship (list
-the blockers), or rework. One report, no per-lens sections.
+the blockers), or rework. One report, no per-lens sections — but it opens
+with the lenses-run table (every lens: ran or skipped + reason), so a
+missing mandatory lens is visible at a glance:
+
+```
+| Lens | Ran? | Evidence |
+| code | yes | <top finding or "clean"> |
+| ui | skipped, no UI paths | — |
+```

package/kit/skills/review/lenses.md

@@ -0,0 +1,25 @@
+# Lens registry
+
+One row per review lens. `review` routes over this table: path/type ->
+mandatory lenses. Runner `Status` `planned` means the skill/agent does not
+exist yet (kit-agents roadmap): the lens reports skipped-planned, never a
+blocker, until the runner lands. Skipping a mandatory lens whose runner
+exists IS a blocker.
+
+| Lens | Runner (skill or agent) | Status | Trigger (changed paths/types) | Mandatory? | Output |
+|---|---|---|---|---|---|
+| code | skill `code-review` (Standards applies `ponytail-review`) | exists | always | yes | findings + verdict |
+| ponytail | skill `ponytail-review` (via code lens, surfaced separately) | exists | always | yes | ladder table + lean findings |
+| persona | skill `persona-review` + repo `.agents/personas.md` | exists | always | yes | per-persona Pass/Rough/Fail + evidence |
+| quality gate | agent `verifier` | exists | always | yes | gate results + DoD checklist |
+| adversarial-tests | skill `adversarial-tests` | exists | logic, handlers, endpoints, state machines | when triggered | edge cases + missing tests |
+| security | agent `security-reviewer` | exists | auth, secrets, tenancy, user data, external calls, crypto | when triggered | threats + fixes, file:line |
+| skeptic | agent `skeptic` (angle per brief: plan, ui/ux, security, scope, data/ops, copy) | exists | plans, specs, ADRs, estimates, product/UI/scope decisions | when triggered | pre-mortem + ranked objections |
+| ui | agent `ui-designer` | planned | `packages/ui/**`, `**/*.tsx`, styles, preview/gallery | when triggered | kit/a11y/state findings + persona(lazy client) |
+| copy | agent `copywriter` | planned | user-visible strings, messages, errors, CTAs | when triggered | keys + FR/EN proposals |
+| a11y | agent `a11y-auditor` | planned | `**/*.tsx`, components, forms, tables | when triggered | WCAG findings + fixes, file:line |
+| seo | agent `seo-auditor` | planned | `packages/seo/**`, pages, metadata, sitemap, redirects | when triggered | rule findings + fixes |
+| dependencies | agent `dependency-auditor` | planned | `package.json`, lockfiles, catalogs, `Dockerfile` | when triggered | need/size/license/maintenance/duplicates |
+| docs | agent `docs-writer` | planned | `README.md`, `AGENTS.md`, `CATALOG.md`, `docs/**`, skills | when triggered | drift + fixes, compiling examples |
+| release | agent `release-manager` | planned | `.changeset/**`, public API, catalog `Status` | when triggered | semver + migration-note check |
+| research | skill `research` | exists | new capability with no in-repo precedent | optional | adopt/wrap/build + sources |

package/kit/skills/setup-ai/SKILL.md

@@ -91,6 +91,7 @@ Shared source first, provider layers after. `zedkit-ai init --provider <names>`
 - **Role and style**: fill it from evidence, not taste. Role and audience from the README (who the project serves); reply language from the language of the docs and commit messages; tone from commit style (terse or explanatory). If the evidence is missing or mixed, ask the user exactly one question covering what is unknown (for example reply language and audience) before writing; with nobody to ask, default to English replies and mark the choice `UNVERIFIED`.
 - **Nested `AGENTS.md`**: only what differs from the root. Link, do not copy.
 - **Repo skills**: folder `.agents/skills/<name>/SKILL.md`. The `description` says when to use it. Steps use this repo's real paths and commands, end with the command that proves the result, and point at an existing example file as the model. Follow `rules-upkeep` for format.
+- **Personas**: `.agents/personas.md` starts from the kit template (init installs it); customize the names and bars from repo evidence (README audience, real users), one row each for end client, integrator and operator. `persona-review` reads this file.
 - **Subagents**: `.agents/agents/<name>.md`, one-line description, `model` omitted. Read-only unless the job needs writes.
 - **Improve mode**: edit in place, smallest change, keep the author's wording where it is correct. Log what changed.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zedtech/zedkit-ai",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -35,7 +35,7 @@
   ],
   "dependencies": {
     "yaml": "2.9.1",
-    "@zedtech/zedkit-core": "0.0.0"
+    "@zedtech/zedkit-core": "0.1.0"
   },
   "devDependencies": {
     "@types/node": "22.20.5",