@jean.gnc/harness-kit 0.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/placeholders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/placeholders/index.js

@@ -0,0 +1,3 @@
+export { parsePlaceholders, substitute } from "./tokens.js";
+export { offsetToLineCol } from "./source-position.js";
+//# sourceMappingURL=index.js.map

package/dist/placeholders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/placeholders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAS5D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/placeholders/source-position.d.ts

@@ -0,0 +1,6 @@
+export interface LineCol {
+    readonly line: number;
+    readonly column: number;
+}
+export declare function offsetToLineCol(text: string, offset: number): LineCol;
+//# sourceMappingURL=source-position.d.ts.map

package/dist/placeholders/source-position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-position.d.ts","sourceRoot":"","sources":["../../src/placeholders/source-position.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAWrE"}

package/dist/placeholders/source-position.js

@@ -0,0 +1,13 @@
+export function offsetToLineCol(text, offset) {
+    const clamped = Math.max(0, Math.min(offset, text.length));
+    let line = 1;
+    let lastLineStart = 0;
+    for (let i = 0; i < clamped; i += 1) {
+        if (text.charCodeAt(i) === 10 /* \n */) {
+            line += 1;
+            lastLineStart = i + 1;
+        }
+    }
+    return { line, column: clamped - lastLineStart + 1 };
+}
+//# sourceMappingURL=source-position.js.map

package/dist/placeholders/source-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-position.js","sourceRoot":"","sources":["../../src/placeholders/source-position.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAAc;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,CAAC;YACV,aAAa,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,GAAG,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/placeholders/tokens.d.ts

@@ -0,0 +1,26 @@
+export interface Placeholder {
+    readonly prefix: string;
+    readonly value: string | null;
+    readonly raw: string;
+    readonly start: number;
+    readonly end: number;
+}
+export type ValidatorResult = {
+    ok: true;
+    rendered: string;
+} | {
+    ok: false;
+    error: string;
+};
+export type Validator = (value: string | null) => ValidatorResult;
+export type ValidatorRegistry = Readonly<Record<string, Validator>>;
+export type SubstituteResult = {
+    ok: true;
+    rendered: string;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function parsePlaceholders(body: string): Placeholder[];
+export declare function substitute(body: string, registry: ValidatorRegistry): SubstituteResult;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/placeholders/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/placeholders/tokens.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,eAAe,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAIhG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAgB7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,CA+BtF"}

package/dist/placeholders/tokens.js

@@ -0,0 +1,50 @@
+const TOKEN_PATTERN = /\{\{([a-z][a-z0-9-]*)(?::([^{}\n]+?))?\}\}/g;
+export function parsePlaceholders(body) {
+    const tokens = [];
+    for (const match of body.matchAll(TOKEN_PATTERN)) {
+        const raw = match[0];
+        const prefix = match[1];
+        if (prefix === undefined)
+            continue;
+        const start = match.index;
+        tokens.push({
+            prefix,
+            value: match[2] ?? null,
+            raw,
+            start,
+            end: start + raw.length,
+        });
+    }
+    return tokens;
+}
+export function substitute(body, registry) {
+    const tokens = parsePlaceholders(body);
+    const errors = [];
+    const knownPrefixes = Object.keys(registry).sort().join(", ");
+    let rendered = "";
+    let cursor = 0;
+    for (const token of tokens) {
+        rendered += body.slice(cursor, token.start);
+        const validator = registry[token.prefix];
+        if (!validator) {
+            errors.push(`unknown placeholder prefix "${token.prefix}" in ${token.raw} (valid: ${knownPrefixes})`);
+            rendered += token.raw;
+            cursor = token.end;
+            continue;
+        }
+        const result = validator(token.value);
+        if (!result.ok) {
+            errors.push(`${token.raw}: ${result.error}`);
+            rendered += token.raw;
+        }
+        else {
+            rendered += result.rendered;
+        }
+        cursor = token.end;
+    }
+    rendered += body.slice(cursor);
+    if (errors.length > 0)
+        return { ok: false, errors };
+    return { ok: true, rendered };
+}
+//# sourceMappingURL=tokens.js.map

package/dist/placeholders/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/placeholders/tokens.ts"],"names":[],"mappings":"AAgBA,MAAM,aAAa,GAAG,6CAA6C,CAAC;AAEpE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC;YACV,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI;YACvB,GAAG;YACH,KAAK;YACL,GAAG,EAAE,KAAK,GAAG,GAAG,CAAC,MAAM;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAA2B;IAClE,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9D,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,+BAA+B,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,GAAG,YAAY,aAAa,GAAG,CACzF,CAAC;YACF,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC;YACtB,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7C,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;QAC9B,CAAC;QACD,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;IACrB,CAAC;IACD,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACpD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC"}

package/dist/plugin/index.d.ts

@@ -0,0 +1,3 @@
+export { ContextEntrySchema, HookRequirementSchema, PluginSchema, definePlugin } from "./schema.js";
+export type { ContextEntry, HookRequirement, Plugin } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACpG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/plugin/index.js

@@ -0,0 +1,2 @@
+export { ContextEntrySchema, HookRequirementSchema, PluginSchema, definePlugin } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/plugin/schema.d.ts

@@ -0,0 +1,164 @@
+import { z } from "zod";
+export declare const ContextEntrySchema: z.ZodObject<{
+    file: z.ZodString;
+    summary: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    summary: string;
+}, {
+    file: string;
+    summary: string;
+}>;
+export type ContextEntry = z.infer<typeof ContextEntrySchema>;
+export declare const HookRequirementSchema: z.ZodEffects<z.ZodObject<{
+    event: z.ZodString;
+    skill: z.ZodOptional<z.ZodString>;
+    command: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    event: string;
+    skill?: string | undefined;
+    command?: string | undefined;
+    agent?: string | undefined;
+}, {
+    event: string;
+    skill?: string | undefined;
+    command?: string | undefined;
+    agent?: string | undefined;
+}>, {
+    event: string;
+    skill?: string | undefined;
+    command?: string | undefined;
+    agent?: string | undefined;
+}, {
+    event: string;
+    skill?: string | undefined;
+    command?: string | undefined;
+    agent?: string | undefined;
+}>;
+export type HookRequirement = z.infer<typeof HookRequirementSchema>;
+export declare const PluginSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodEffects<z.ZodString, string, string>;
+    author: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        email?: string | undefined;
+        url?: string | undefined;
+    }, {
+        name: string;
+        email?: string | undefined;
+        url?: string | undefined;
+    }>>;
+    homepage: z.ZodOptional<z.ZodString>;
+    repository: z.ZodOptional<z.ZodString>;
+    license: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    context: z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        summary: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        summary: string;
+    }, {
+        file: string;
+        summary: string;
+    }>, "many">>, {
+        file: string;
+        summary: string;
+    }[] | undefined, {
+        file: string;
+        summary: string;
+    }[] | undefined>;
+    commands: z.ZodOptional<z.ZodString>;
+    agents: z.ZodOptional<z.ZodString>;
+    hooks: z.ZodOptional<z.ZodString>;
+    hookRequires: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        event: z.ZodString;
+        skill: z.ZodOptional<z.ZodString>;
+        command: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        event: string;
+        skill?: string | undefined;
+        command?: string | undefined;
+        agent?: string | undefined;
+    }, {
+        event: string;
+        skill?: string | undefined;
+        command?: string | undefined;
+        agent?: string | undefined;
+    }>, {
+        event: string;
+        skill?: string | undefined;
+        command?: string | undefined;
+        agent?: string | undefined;
+    }, {
+        event: string;
+        skill?: string | undefined;
+        command?: string | undefined;
+        agent?: string | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    version: string;
+    author?: {
+        name: string;
+        email?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    homepage?: string | undefined;
+    repository?: string | undefined;
+    license?: string | undefined;
+    keywords?: string[] | undefined;
+    dependencies?: string[] | undefined;
+    context?: {
+        file: string;
+        summary: string;
+    }[] | undefined;
+    commands?: string | undefined;
+    agents?: string | undefined;
+    hooks?: string | undefined;
+    hookRequires?: {
+        event: string;
+        skill?: string | undefined;
+        command?: string | undefined;
+        agent?: string | undefined;
+    }[] | undefined;
+}, {
+    name: string;
+    description: string;
+    version: string;
+    author?: {
+        name: string;
+        email?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    homepage?: string | undefined;
+    repository?: string | undefined;
+    license?: string | undefined;
+    keywords?: string[] | undefined;
+    dependencies?: string[] | undefined;
+    context?: {
+        file: string;
+        summary: string;
+    }[] | undefined;
+    commands?: string | undefined;
+    agents?: string | undefined;
+    hooks?: string | undefined;
+    hookRequires?: {
+        event: string;
+        skill?: string | undefined;
+        command?: string | undefined;
+        agent?: string | undefined;
+    }[] | undefined;
+}>;
+export type Plugin = z.infer<typeof PluginSchema>;
+export declare function definePlugin(plugin: Plugin): Plugin;
+//# sourceMappingURL=schema.d.ts.map

package/dist/plugin/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/plugin/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kBAAkB;;;;;;;;;EAM7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAyB9D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;EAShC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBd,CAAC;AAEZ,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/plugin/schema.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { FQ_ID, PLUGIN_ID } from "../ids.js";
+export const ContextEntrySchema = z.object({
+    file: z.string().min(1).regex(/\.md$/, "file must be a .md path"),
+    summary: z
+        .string()
+        .min(1)
+        .refine((s) => !s.includes("\n"), "summary cannot contain newlines"),
+});
+const AuthorSchema = z.object({
+    name: z.string().min(1),
+    email: z.string().min(1).optional(),
+    url: z.string().min(1).optional(),
+});
+const contextListSchema = z
+    .array(ContextEntrySchema)
+    .optional()
+    .refine((arr) => !arr || new Set(arr.map((e) => e.file)).size === arr.length, "context files must be unique");
+const SLUG_REF = z.string().min(1).regex(FQ_ID, "must match <plugin>:<name> kebab-case");
+const HookRequirementBase = z.object({
+    event: z.string().min(1),
+    skill: SLUG_REF.optional(),
+    command: SLUG_REF.optional(),
+    agent: SLUG_REF.optional(),
+});
+export const HookRequirementSchema = HookRequirementBase.strict().superRefine((value, ctx) => {
+    const slugs = [value.skill, value.command, value.agent].filter((s) => s !== undefined);
+    if (slugs.length !== 1) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "exactly one of skill | command | agent must be set",
+            path: [],
+        });
+    }
+});
+export const PluginSchema = z
+    .object({
+    name: z.string().min(1).regex(PLUGIN_ID, "name must be lowercase kebab-case"),
+    version: z.string().min(1),
+    description: z
+        .string()
+        .min(1)
+        .max(1024)
+        .refine((s) => !s.includes("\n"), "description cannot contain newlines"),
+    author: AuthorSchema.optional(),
+    homepage: z.string().min(1).optional(),
+    repository: z.string().min(1).optional(),
+    license: z.string().min(1).optional(),
+    keywords: z.array(z.string().min(1)).optional(),
+    dependencies: z.array(z.string().min(1)).optional(),
+    context: contextListSchema,
+    commands: z.string().min(1).optional(),
+    agents: z.string().min(1).optional(),
+    hooks: z.string().min(1).optional(),
+    hookRequires: z.array(HookRequirementSchema).optional(),
+})
+    .strict();
+export function definePlugin(plugin) {
+    return PluginSchema.parse(plugin);
+}
+//# sourceMappingURL=schema.js.map

package/dist/plugin/schema.js.map

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

package/dist/readme/index.d.ts

@@ -0,0 +1,24 @@
+export interface LocalIds {
+    readonly skills: ReadonlySet<string>;
+    readonly commands: ReadonlySet<string>;
+    readonly agents: ReadonlySet<string>;
+}
+export interface OwningPlugin {
+    readonly name: string;
+    readonly dependencies: ReadonlySet<string>;
+}
+export type ReadmeViolationKind = "placeholder" | "link";
+export interface ReadmeViolation {
+    readonly kind: ReadmeViolationKind;
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+    readonly message: string;
+}
+export interface ValidateReadmeOptions {
+    readonly filePath: string;
+    readonly localIds: LocalIds;
+    readonly owner?: OwningPlugin;
+}
+export declare function validateReadme(options: ValidateReadmeOptions): Promise<readonly ReadmeViolation[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/readme/index.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAMD,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAQrC"}

package/dist/readme/index.js

@@ -0,0 +1,119 @@
+import { readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { pathExists } from "../fs.js";
+import { FQ_ID } from "../ids.js";
+import { offsetToLineCol, parsePlaceholders } from "../placeholders/index.js";
+const SENTINEL = "<!-- harness-kit:validate -->";
+const LINK_PATTERN = /!?\[[^\]]*\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g;
+const ABSOLUTE_URL_PATTERN = /^(?:[a-z][a-z0-9+.-]*:|\/\/|#)/i;
+export async function validateReadme(options) {
+    const text = await readFile(options.filePath, "utf8");
+    if (!text.includes(SENTINEL))
+        return [];
+    const violations = [];
+    for (const v of validatePlaceholders(text, options))
+        violations.push(v);
+    for (const v of await validateLinks(text, options.filePath))
+        violations.push(v);
+    return violations;
+}
+function validatePlaceholders(text, options) {
+    const violations = [];
+    for (const token of parsePlaceholders(text)) {
+        const message = placeholderViolation(token, options);
+        if (!message)
+            continue;
+        const { line, column } = offsetToLineCol(text, token.start);
+        violations.push({
+            kind: "placeholder",
+            file: options.filePath,
+            line,
+            column,
+            message: `${token.raw}: ${message}`,
+        });
+    }
+    return violations;
+}
+function placeholderViolation(token, options) {
+    const owner = options.owner ?? null;
+    switch (token.prefix) {
+        case "skill":
+            return localIdViolation(token.value, "skill", options.localIds.skills, owner);
+        case "command":
+            return localIdViolation(token.value, "command", options.localIds.commands, owner);
+        case "agent":
+            return localIdViolation(token.value, "agent", options.localIds.agents, owner);
+        case "ext":
+            return formatViolation(token.value, "ext", "skill");
+        case "ext-command":
+            return formatViolation(token.value, "ext-command", "command");
+        case "ext-agent":
+            return formatViolation(token.value, "ext-agent", "agent");
+        default:
+            return null;
+    }
+}
+function localIdViolation(value, kind, haystack, owner) {
+    if (value === null)
+        return `expected \`{{${kind}:<plugin>:<${kind}>}}\``;
+    if (!FQ_ID.test(value)) {
+        return `${kind} id "${value}" must match <plugin>:<${kind}> (kebab-case)`;
+    }
+    if (!haystack.has(value))
+        return `unknown ${kind} id "${value}" — not a local ${kind}`;
+    return crossPluginViolation(value, owner);
+}
+function formatViolation(value, prefix, noun) {
+    if (value === null)
+        return `expected \`{{${prefix}:<plugin>:<${noun}>}}\``;
+    if (!FQ_ID.test(value)) {
+        return `${prefix} id "${value}" must match <plugin>:<${noun}> (kebab-case)`;
+    }
+    return null;
+}
+function crossPluginViolation(id, owner) {
+    if (!owner)
+        return null;
+    const idx = id.indexOf(":");
+    if (idx === -1)
+        return null;
+    const otherPlugin = id.slice(0, idx);
+    if (otherPlugin === owner.name)
+        return null;
+    if (owner.dependencies.has(otherPlugin))
+        return null;
+    return `cross-plugin reference to "${otherPlugin}" requires "${otherPlugin}" in ${owner.name}'s dependencies`;
+}
+async function validateLinks(text, filePath) {
+    const dir = dirname(filePath);
+    const violations = [];
+    for (const match of text.matchAll(LINK_PATTERN)) {
+        const url = match[1];
+        if (!url)
+            continue;
+        if (ABSOLUTE_URL_PATTERN.test(url))
+            continue;
+        const pathPart = stripAnchor(url);
+        if (!pathPart)
+            continue;
+        const target = resolve(dir, pathPart);
+        if (await pathExists(target))
+            continue;
+        const { line, column } = offsetToLineCol(text, match.index);
+        violations.push({
+            kind: "link",
+            file: filePath,
+            line,
+            column,
+            message: `broken link: ${url}`,
+        });
+    }
+    return violations;
+}
+function stripAnchor(url) {
+    const hashIdx = url.indexOf("#");
+    if (hashIdx === -1)
+        return url;
+    return url.slice(0, hashIdx);
+}
+//# sourceMappingURL=index.js.map

package/dist/readme/index.js.map

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

package/dist/result.d.ts

@@ -0,0 +1,10 @@
+export type Result<T, E> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+export declare function ok<T>(value: T): Result<T, never>;
+export declare function err<E>(error: E): Result<never, E>;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE9C,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD"}

package/dist/result.js

@@ -0,0 +1,7 @@
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC"}

package/dist/skill/includes.d.ts

@@ -0,0 +1,29 @@
+import { type Result } from "../result.js";
+export type IncludeError = {
+    readonly tag: "include-cycle";
+    readonly chain: readonly string[];
+} | {
+    readonly tag: "include-missing";
+    readonly path: string;
+    readonly from: string;
+} | {
+    readonly tag: "include-escapes-skill";
+    readonly path: string;
+    readonly skillDir: string;
+} | {
+    readonly tag: "include-not-md";
+    readonly path: string;
+} | {
+    readonly tag: "include-absolute";
+    readonly raw: string;
+} | {
+    readonly tag: "include-empty";
+    readonly raw: string;
+};
+export interface ExpandedBody {
+    readonly body: string;
+    readonly resolvedIncludes: ReadonlySet<string>;
+}
+export declare function expandIncludes(body: string, fromFile: string, skillDir: string): Promise<Result<ExpandedBody, readonly IncludeError[]>>;
+export declare function formatIncludeError(error: IncludeError): string;
+//# sourceMappingURL=includes.d.ts.map

package/dist/skill/includes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"includes.d.ts","sourceRoot":"","sources":["../../src/skill/includes.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,GAAG,EAAE,uBAAuB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3F;IAAE,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChD;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,YAAY,EAAE,CAAC,CAAC,CAMxD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAe9D"}