@stigmer/plugin-package 3.15.3-dev.20260916211208

package/documents.js.map

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

package/files.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The reader the library is pure over, and the path discipline every path in
+ * a package obeys.
+ *
+ * `PluginFiles` is a sorted list of SIZED entries plus `read`. The size is
+ * declared up front so the library can refuse an over-cap document before a
+ * byte is read: an archive reader may hold a deflated entry whose declared
+ * size is the only defence against inflating a bomb, and a cap checked after
+ * `read` would be no defence at all. The reader's contract is that `read`
+ * never returns more than `size` bytes (a directory reader uses the file's
+ * stat size; an archive reader passes the central directory's declared size
+ * as its inflate limit). The library checks both sides anyway: the declared
+ * size before reading, the returned length after, refusing either as
+ * `document-too-large`. Nothing here touches the filesystem or any `node:*`
+ * module; the CLI's directory walker and the server's archive reader each
+ * implement this interface at their edge.
+ *
+ * Containment is lexical here and physical in each reader. A listed path
+ * that is absolute, contains `..` or a backslash, or has an empty segment is
+ * refused by the library; a reader never follows a symlink, and an archive
+ * has none. A path DECLARED in a manifest must begin with `./` (or be `.`),
+ * the open format's rule for every plugin-relative path.
+ */
+import type { PluginErrorKind } from "./outcome.js";
+export interface PluginFileEntry {
+    /** Plugin-relative POSIX path, no leading `./`, files only. */
+    readonly path: string;
+    /** The entry's declared size in bytes; `read` returns at most this many. */
+    readonly size: number;
+}
+export interface PluginFiles {
+    /** Sorted by path (code-point order), files only, every path contained. */
+    readonly entries: readonly PluginFileEntry[];
+    /** The bytes of one listed path. */
+    read(path: string): Uint8Array;
+}
+/**
+ * Per-document byte caps, checked from declared sizes. A plugin's documents
+ * are small by nature; the caps exist so no reader can be made to inflate
+ * a large entry through the library, not to bound legitimate content.
+ */
+export declare const PLUGIN_DOCUMENT_LIMITS: {
+    /** A manifest (`plugin.json` in any dialect). Real manifests are a few KB. */
+    readonly manifest: number;
+    /** An MCP configuration file. */
+    readonly mcpConfig: number;
+    /**
+     * A `SKILL.md`. The server's skill push gate inflates a `SKILL.md` alone
+     * under the same 1 MB cap, so a skill this library accepts is one the push
+     * gate accepts.
+     */
+    readonly skillMd: number;
+    /** A sub-agent file (`agents/*.md`): a prompt, so the `SKILL.md` cap. */
+    readonly subAgent: number;
+    /** A document under `ai.stigmer/`: a resource YAML. */
+    readonly overlay: number;
+};
+export type PluginDocumentClass = keyof typeof PLUGIN_DOCUMENT_LIMITS;
+/** An in-memory `PluginFiles` over path -> content; the testing builders' product. */
+export declare function inMemoryPluginFiles(files: ReadonlyMap<string, Uint8Array | string>): PluginFiles;
+/** Code-point order, the order `entries` is sorted in. */
+export declare function comparePaths(a: string, b: string): number;
+/** UTF-8 text with a leading byte-order mark removed (a manifest saved with a BOM was a known load failure elsewhere). */
+export declare function decodeUtf8(bytes: Uint8Array): string;
+/**
+ * Lexical containment of a LISTED path: relative, forward slashes only, no
+ * `.` or `..` segments, no empty segments. Readers produce such paths; the
+ * library refuses a reader that did not.
+ */
+export declare function isContainedPath(path: string): boolean;
+export type DeclaredPathOutcome = {
+    readonly ok: true;
+    readonly path: string;
+} | {
+    readonly ok: false;
+    readonly kind: Extract<PluginErrorKind, "path-not-relative" | "path-escapes-root" | "path-glob-unsupported">;
+};
+/**
+ * Normalise a path DECLARED in a manifest (`"./skills/"`, `"."`,
+ * `"./agents/reviewer.md"`) to a plugin-relative path with no leading `./`
+ * and no trailing slash; the plugin root itself is the empty string. The
+ * open format requires the `./` prefix; the vendor dialects document the
+ * same rule; a glob is refused because no plugin in the wild uses one and
+ * expanding globs is a second path language the library would then have
+ * to own.
+ */
+export declare function resolveDeclaredPath(value: string): DeclaredPathOutcome;
+/** `dir + "/" + name`, or `name` at the plugin root. */
+export declare function joinPath(dir: string, name: string): string;
+/** The last segment of a plugin-relative path. */
+export declare function basename(path: string): string;
+/** The path without its last segment; the empty string at the root. */
+export declare function dirname(path: string): string;
+/**
+ * Indexed access over a `PluginFiles`: membership, the files under a
+ * directory, a directory's immediate children. Built once per read; every
+ * lookup is a map or a prefix walk over the sorted entries.
+ */
+export declare class PluginFileIndex {
+    readonly files: PluginFiles;
+    private readonly byPath;
+    constructor(files: PluginFiles);
+    has(path: string): boolean;
+    entry(path: string): PluginFileEntry | undefined;
+    /** Every file under `dir` (recursively), in entry order; every file at the root when `dir` is empty. */
+    filesUnder(dir: string): readonly string[];
+    /** True when at least one file lives under `dir`. */
+    isDirectory(dir: string): boolean;
+    /** The immediate child directory names under `dir`, sorted, deduplicated. */
+    childDirectories(dir: string): readonly string[];
+    /** The immediate child FILE names under `dir`, sorted. */
+    childFiles(dir: string): readonly string[];
+}
+//# sourceMappingURL=files.d.ts.map

package/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,oCAAoC;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;CAChC;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;IACjC,8EAA8E;;IAE9E,iCAAiC;;IAEjC;;;;OAIG;;IAEH,yEAAyE;;IAEzE,uDAAuD;;CAE/C,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAQtE,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,GAAG,WAAW,CAkBhG;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,0HAA0H;AAC1H,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC,CAAA;CAAE,CAAC;AAIzI;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAQtE;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAGd,QAAQ,CAAC,KAAK,EAAE,WAAW;IAFvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;gBAEzC,KAAK,EAAE,WAAW;IAIvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIhD,wGAAwG;IACxG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAM1C,qDAAqD;IACrD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMjC,6EAA6E;IAC7E,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAYhD,0DAA0D;IAC1D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;CAU3C"}

package/files.js

@@ -0,0 +1,187 @@
+/**
+ * The reader the library is pure over, and the path discipline every path in
+ * a package obeys.
+ *
+ * `PluginFiles` is a sorted list of SIZED entries plus `read`. The size is
+ * declared up front so the library can refuse an over-cap document before a
+ * byte is read: an archive reader may hold a deflated entry whose declared
+ * size is the only defence against inflating a bomb, and a cap checked after
+ * `read` would be no defence at all. The reader's contract is that `read`
+ * never returns more than `size` bytes (a directory reader uses the file's
+ * stat size; an archive reader passes the central directory's declared size
+ * as its inflate limit). The library checks both sides anyway: the declared
+ * size before reading, the returned length after, refusing either as
+ * `document-too-large`. Nothing here touches the filesystem or any `node:*`
+ * module; the CLI's directory walker and the server's archive reader each
+ * implement this interface at their edge.
+ *
+ * Containment is lexical here and physical in each reader. A listed path
+ * that is absolute, contains `..` or a backslash, or has an empty segment is
+ * refused by the library; a reader never follows a symlink, and an archive
+ * has none. A path DECLARED in a manifest must begin with `./` (or be `.`),
+ * the open format's rule for every plugin-relative path.
+ */
+/**
+ * Per-document byte caps, checked from declared sizes. A plugin's documents
+ * are small by nature; the caps exist so no reader can be made to inflate
+ * a large entry through the library, not to bound legitimate content.
+ */
+export const PLUGIN_DOCUMENT_LIMITS = {
+    /** A manifest (`plugin.json` in any dialect). Real manifests are a few KB. */
+    manifest: 256 * 1024,
+    /** An MCP configuration file. */
+    mcpConfig: 256 * 1024,
+    /**
+     * A `SKILL.md`. The server's skill push gate inflates a `SKILL.md` alone
+     * under the same 1 MB cap, so a skill this library accepts is one the push
+     * gate accepts.
+     */
+    skillMd: 1024 * 1024,
+    /** A sub-agent file (`agents/*.md`): a prompt, so the `SKILL.md` cap. */
+    subAgent: 1024 * 1024,
+    /** A document under `ai.stigmer/`: a resource YAML. */
+    overlay: 1024 * 1024,
+};
+const encoder = new TextEncoder();
+// `fatal: false` keeps the decoder from throwing on a malformed sequence: a
+// document with bad UTF-8 reaches the JSON or YAML parser, which refuses it
+// with its own sentence, rather than crashing the read.
+const decoder = new TextDecoder("utf-8", { fatal: false });
+/** An in-memory `PluginFiles` over path -> content; the testing builders' product. */
+export function inMemoryPluginFiles(files) {
+    const bytes = new Map();
+    for (const [path, content] of files) {
+        bytes.set(path, typeof content === "string" ? encoder.encode(content) : content);
+    }
+    const entries = [...bytes.entries()]
+        .map(([path, content]) => ({ path, size: content.length }))
+        .sort((a, b) => comparePaths(a.path, b.path));
+    return {
+        entries,
+        read(path) {
+            const content = bytes.get(path);
+            if (content === undefined) {
+                throw new Error(`plugin file '${path}' is not listed`);
+            }
+            return content;
+        },
+    };
+}
+/** Code-point order, the order `entries` is sorted in. */
+export function comparePaths(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/** UTF-8 text with a leading byte-order mark removed (a manifest saved with a BOM was a known load failure elsewhere). */
+export function decodeUtf8(bytes) {
+    const text = decoder.decode(bytes);
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+/**
+ * Lexical containment of a LISTED path: relative, forward slashes only, no
+ * `.` or `..` segments, no empty segments. Readers produce such paths; the
+ * library refuses a reader that did not.
+ */
+export function isContainedPath(path) {
+    if (path === "" || path.startsWith("/") || path.includes("\\"))
+        return false;
+    return path.split("/").every((segment) => segment !== "" && segment !== "." && segment !== "..");
+}
+const GLOB_CHARACTERS = /[*?[\]{}]/;
+/**
+ * Normalise a path DECLARED in a manifest (`"./skills/"`, `"."`,
+ * `"./agents/reviewer.md"`) to a plugin-relative path with no leading `./`
+ * and no trailing slash; the plugin root itself is the empty string. The
+ * open format requires the `./` prefix; the vendor dialects document the
+ * same rule; a glob is refused because no plugin in the wild uses one and
+ * expanding globs is a second path language the library would then have
+ * to own.
+ */
+export function resolveDeclaredPath(value) {
+    if (GLOB_CHARACTERS.test(value))
+        return { ok: false, kind: "path-glob-unsupported" };
+    if (value === "." || value === "./")
+        return { ok: true, path: "" };
+    if (!value.startsWith("./"))
+        return { ok: false, kind: "path-not-relative" };
+    const trimmed = value.slice(2).replace(/\/+$/, "");
+    if (trimmed === "")
+        return { ok: true, path: "" };
+    if (!isContainedPath(trimmed))
+        return { ok: false, kind: "path-escapes-root" };
+    return { ok: true, path: trimmed };
+}
+/** `dir + "/" + name`, or `name` at the plugin root. */
+export function joinPath(dir, name) {
+    return dir === "" ? name : `${dir}/${name}`;
+}
+/** The last segment of a plugin-relative path. */
+export function basename(path) {
+    const slash = path.lastIndexOf("/");
+    return slash === -1 ? path : path.slice(slash + 1);
+}
+/** The path without its last segment; the empty string at the root. */
+export function dirname(path) {
+    const slash = path.lastIndexOf("/");
+    return slash === -1 ? "" : path.slice(0, slash);
+}
+/**
+ * Indexed access over a `PluginFiles`: membership, the files under a
+ * directory, a directory's immediate children. Built once per read; every
+ * lookup is a map or a prefix walk over the sorted entries.
+ */
+export class PluginFileIndex {
+    files;
+    byPath;
+    constructor(files) {
+        this.files = files;
+        this.byPath = new Map(files.entries.map((entry) => [entry.path, entry]));
+    }
+    has(path) {
+        return this.byPath.has(path);
+    }
+    entry(path) {
+        return this.byPath.get(path);
+    }
+    /** Every file under `dir` (recursively), in entry order; every file at the root when `dir` is empty. */
+    filesUnder(dir) {
+        if (dir === "")
+            return this.files.entries.map((entry) => entry.path);
+        const prefix = `${dir}/`;
+        return this.files.entries.filter((entry) => entry.path.startsWith(prefix)).map((entry) => entry.path);
+    }
+    /** True when at least one file lives under `dir`. */
+    isDirectory(dir) {
+        if (dir === "")
+            return this.files.entries.length > 0;
+        const prefix = `${dir}/`;
+        return this.files.entries.some((entry) => entry.path.startsWith(prefix));
+    }
+    /** The immediate child directory names under `dir`, sorted, deduplicated. */
+    childDirectories(dir) {
+        const prefix = dir === "" ? "" : `${dir}/`;
+        const names = new Set();
+        for (const entry of this.files.entries) {
+            if (!entry.path.startsWith(prefix))
+                continue;
+            const rest = entry.path.slice(prefix.length);
+            const slash = rest.indexOf("/");
+            if (slash !== -1)
+                names.add(rest.slice(0, slash));
+        }
+        return [...names].sort(comparePaths);
+    }
+    /** The immediate child FILE names under `dir`, sorted. */
+    childFiles(dir) {
+        const prefix = dir === "" ? "" : `${dir}/`;
+        const names = [];
+        for (const entry of this.files.entries) {
+            if (!entry.path.startsWith(prefix))
+                continue;
+            const rest = entry.path.slice(prefix.length);
+            if (!rest.includes("/"))
+                names.push(rest);
+        }
+        return names.sort(comparePaths);
+    }
+}
+//# sourceMappingURL=files.js.map

package/files.js.map

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

package/frontmatter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * YAML frontmatter extraction for `SKILL.md` and sub-agent files, and the
+ * skill name rule.
+ *
+ * The delimiter discipline is the server's skill push gate's: the file must
+ * open with `---` on its first line and close with `---` on a line of its
+ * own, both compared after trimming whitespace. Extraction and parsing are
+ * separate steps because the two callers differ on what a missing block
+ * means: a `SKILL.md` without frontmatter is refused (the Agent Skills
+ * format requires it), while a sub-agent file without frontmatter is a
+ * prompt named after its file (the Claude Code posture).
+ *
+ * `SKILL_NAME_PATTERN` is the server's rule for a skill name (kebab-case,
+ * optionally dot-scoped), a strict superset of the Agent Skills rule
+ * (lowercase alphanumerics and hyphens), so no skill valid under the open
+ * format is refused here. This module is meant to become the pattern's one
+ * home; the server's `frontmatter.ts` carries the same regex today.
+ */
+import { type JsonObject } from "./documents.js";
+/**
+ * Kebab-case, optionally scoped with dot-separated namespaces. Every
+ * segment between separators is alphanumeric, so a name cannot start or end
+ * with a separator or contain consecutive separators. The derived slug
+ * renders dots as hyphens.
+ */
+export declare const SKILL_NAME_PATTERN: RegExp;
+export type FrontmatterExtraction = {
+    readonly ok: true;
+    readonly yaml: string;
+    readonly body: string;
+} | {
+    readonly ok: false;
+    readonly reason: "missing" | "unclosed";
+};
+/** Split a document into its frontmatter YAML and its body. */
+export declare function extractFrontmatter(content: string): FrontmatterExtraction;
+export type FrontmatterParse = {
+    readonly ok: true;
+    readonly fields: JsonObject;
+} | {
+    readonly ok: false;
+    readonly detail: string;
+};
+/**
+ * Parse frontmatter YAML into a field map. An empty block is an empty map
+ * (the caller decides whether required fields are missing); a scalar or a
+ * list where a map was expected is a parse failure with its own detail.
+ * `yaml`'s defaults are the safe ones: no custom tags, aliases capped.
+ */
+export declare function parseFrontmatter(yaml: string): FrontmatterParse;
+//# sourceMappingURL=frontmatter.d.ts.map

package/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAgC,CAAC;AAEhE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAA;CAAE,CAAC;AAEpE,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAWzE;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAU/D"}

package/frontmatter.js

@@ -0,0 +1,61 @@
+/**
+ * YAML frontmatter extraction for `SKILL.md` and sub-agent files, and the
+ * skill name rule.
+ *
+ * The delimiter discipline is the server's skill push gate's: the file must
+ * open with `---` on its first line and close with `---` on a line of its
+ * own, both compared after trimming whitespace. Extraction and parsing are
+ * separate steps because the two callers differ on what a missing block
+ * means: a `SKILL.md` without frontmatter is refused (the Agent Skills
+ * format requires it), while a sub-agent file without frontmatter is a
+ * prompt named after its file (the Claude Code posture).
+ *
+ * `SKILL_NAME_PATTERN` is the server's rule for a skill name (kebab-case,
+ * optionally dot-scoped), a strict superset of the Agent Skills rule
+ * (lowercase alphanumerics and hyphens), so no skill valid under the open
+ * format is refused here. This module is meant to become the pattern's one
+ * home; the server's `frontmatter.ts` carries the same regex today.
+ */
+import { parse as parseYaml } from "yaml";
+import { isJsonObject } from "./documents.js";
+/**
+ * Kebab-case, optionally scoped with dot-separated namespaces. Every
+ * segment between separators is alphanumeric, so a name cannot start or end
+ * with a separator or contain consecutive separators. The derived slug
+ * renders dots as hyphens.
+ */
+export const SKILL_NAME_PATTERN = /^[a-z0-9]+([.-][a-z0-9]+)*$/;
+/** Split a document into its frontmatter YAML and its body. */
+export function extractFrontmatter(content) {
+    const lines = content.split(/\r?\n/);
+    if (lines.length === 0 || lines[0]?.trim() !== "---") {
+        return { ok: false, reason: "missing" };
+    }
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i]?.trim() === "---") {
+            return { ok: true, yaml: lines.slice(1, i).join("\n"), body: lines.slice(i + 1).join("\n") };
+        }
+    }
+    return { ok: false, reason: "unclosed" };
+}
+/**
+ * Parse frontmatter YAML into a field map. An empty block is an empty map
+ * (the caller decides whether required fields are missing); a scalar or a
+ * list where a map was expected is a parse failure with its own detail.
+ * `yaml`'s defaults are the safe ones: no custom tags, aliases capped.
+ */
+export function parseFrontmatter(yaml) {
+    let value;
+    try {
+        value = parseYaml(yaml);
+    }
+    catch (error) {
+        return { ok: false, detail: error instanceof Error ? error.message : String(error) };
+    }
+    if (value === null || value === undefined)
+        return { ok: true, fields: {} };
+    if (!isJsonObject(value))
+        return { ok: false, detail: "the frontmatter is not a mapping" };
+    return { ok: true, fields: value };
+}
+//# sourceMappingURL=frontmatter.js.map

package/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAmB,MAAM,gBAAgB,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,6BAA6B,CAAC;AAMhE,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QACrD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC1C,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC3C,CAAC;AAMD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACvF,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC3E,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;IAC3F,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@stigmer/plugin-package`: the public surface.
+ *
+ * `readPluginPackage` is the entry; everything else here is what a consumer
+ * needs to supply its input (`PluginFiles`, the caps), route a directory
+ * (`MANIFEST_LOCATIONS`, `hasPluginManifest`), or render the outcome (the
+ * finding kinds and `isErrorKind`). The dialect readers and normalisers are
+ * internal: a consumer never composes a partial read.
+ */
+export { hasPluginManifest, isValidPluginName } from "./detect.js";
+export { comparePaths, inMemoryPluginFiles, isContainedPath, PLUGIN_DOCUMENT_LIMITS, resolveDeclaredPath, type DeclaredPathOutcome, type PluginDocumentClass, type PluginFileEntry, type PluginFiles, } from "./files.js";
+export { SKILL_NAME_PATTERN } from "./frontmatter.js";
+export { AGENT_PLUGINS_MANIFEST_SCHEMA, AGENT_PLUGINS_MCP_SCHEMA, errorMessage, isErrorKind, MANIFEST_LOCATIONS, warningMessage, } from "./messages.js";
+export { SUB_AGENT_INSTRUCTIONS_MIN, classifyModel } from "./normalise/sub-agents.js";
+export { PLACEHOLDER_PATTERN, VARIABLE_NAME_PATTERN } from "./placeholders.js";
+export type { FindingContext, PluginErrorKind, PluginFinding, PluginFindingKind, PluginReadOutcome, PluginWarningKind, } from "./outcome.js";
+export { readPluginPackage } from "./read-plugin-package.js";
+export type { IgnoredComponent, IgnoredComponentKind, ModelAlias, ModelHint, OverlayDocument, OverlayNamedDocument, OverlayServerDocument, PluginAuthor, PluginDialect, PluginMcpServer, PluginPackage, PluginSkill, PluginSubAgent, PluginVariable, StigmerOverlay, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,6BAA6B,EAC7B,wBAAwB,EACxB,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC"}

package/index.js

@@ -0,0 +1,17 @@
+/**
+ * `@stigmer/plugin-package`: the public surface.
+ *
+ * `readPluginPackage` is the entry; everything else here is what a consumer
+ * needs to supply its input (`PluginFiles`, the caps), route a directory
+ * (`MANIFEST_LOCATIONS`, `hasPluginManifest`), or render the outcome (the
+ * finding kinds and `isErrorKind`). The dialect readers and normalisers are
+ * internal: a consumer never composes a partial read.
+ */
+export { hasPluginManifest, isValidPluginName } from "./detect.js";
+export { comparePaths, inMemoryPluginFiles, isContainedPath, PLUGIN_DOCUMENT_LIMITS, resolveDeclaredPath, } from "./files.js";
+export { SKILL_NAME_PATTERN } from "./frontmatter.js";
+export { AGENT_PLUGINS_MANIFEST_SCHEMA, AGENT_PLUGINS_MCP_SCHEMA, errorMessage, isErrorKind, MANIFEST_LOCATIONS, warningMessage, } from "./messages.js";
+export { SUB_AGENT_INSTRUCTIONS_MIN, classifyModel } from "./normalise/sub-agents.js";
+export { PLACEHOLDER_PATTERN, VARIABLE_NAME_PATTERN } from "./placeholders.js";
+export { readPluginPackage } from "./read-plugin-package.js";
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,GAKpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,6BAA6B,EAC7B,wBAAwB,EACxB,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAS/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/messages.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The one sentence for every finding kind, and the collector that composes
+ * findings from a kind and its context.
+ *
+ * Copy lives here and nowhere else: the CLI and the server print these
+ * sentences verbatim, so a plugin refused offline is refused by the server
+ * with the same words, and a consumer never composes refusal copy of its
+ * own. Every sentence says what is wrong and, where the fix is not obvious,
+ * what Stigmer needs instead. Identifiers are single-quoted (the ts-server
+ * quoting rule for new copy). The `Record` types are exhaustive over the
+ * kind unions, so a kind without a sentence does not compile.
+ */
+import type { FindingContext, PluginErrorKind, PluginFinding, PluginFindingKind, PluginWarningKind } from "./outcome.js";
+/** The canonical `$schema` identifiers the open format pins per version. */
+export declare const AGENT_PLUGINS_MANIFEST_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
+export declare const AGENT_PLUGINS_MCP_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
+/** The four manifest locations, in the precedence the reader applies when there is no root manifest. */
+export declare const MANIFEST_LOCATIONS: {
+    readonly "agent-plugins": "plugin.json";
+    readonly claude: ".claude-plugin/plugin.json";
+    readonly cursor: ".cursor-plugin/plugin.json";
+    readonly codex: ".codex-plugin/plugin.json";
+};
+export declare function errorMessage(kind: PluginErrorKind, ctx: FindingContext): string;
+export declare function warningMessage(kind: PluginWarningKind, ctx: FindingContext): string;
+/** True for the kinds that refuse a package. */
+export declare function isErrorKind(kind: PluginFindingKind): kind is PluginErrorKind;
+/**
+ * Collects findings while a read proceeds. The reader never throws on a
+ * plugin's content: every problem becomes a finding here, and the read
+ * continues so the outcome carries them all.
+ */
+export declare class Findings {
+    readonly errors: PluginFinding[];
+    readonly warnings: PluginFinding[];
+    error(kind: PluginErrorKind, ctx?: FindingContext): void;
+    warn(kind: PluginWarningKind, ctx?: FindingContext): void;
+}
+//# sourceMappingURL=messages.d.ts.map

package/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAEtB,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B,+DAA+D,CAAC;AAC1G,eAAO,MAAM,wBAAwB,4DAA4D,CAAC;AAElG,wGAAwG;AACxG,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAqIX,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAE/E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAEnF;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,IAAI,eAAe,CAE5E;AAED;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAM;IACtC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAM;IAExC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,GAAE,cAAmB,GAAG,IAAI;IAI5D,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,GAAE,cAAmB,GAAG,IAAI;CAG9D"}