@evalops/maestro 0.10.51 → 0.10.53

package/dist/skills/artifact-metadata.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"artifact-metadata.d.ts","sourceRoot":"","sources":["../../src/skills/artifact-metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AA8DD,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,WAAW,GAChB,qBAAqB,CA6BvB;AAED,wBAAgB,mCAAmC,CAClD,OAAO,EAAE,OAAO,GACd,qBAAqB,GAAG,SAAS,CAOnC"}

package/dist/skills/artifact-metadata.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"artifact-metadata.js","sourceRoot":"","sources":["../../src/skills/artifact-metadata.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { LoadedSkill } from \"./loader.js\";\n\nexport type SkillArtifactSource = LoadedSkill[\"sourceType\"];\n\nexport interface SkillArtifactMetadata {\n\tname: string;\n\thash: string;\n\tsource: SkillArtifactSource;\n\tartifactId?: string;\n\tversion?: string;\n\tsourcePath?: string;\n\tscope?: string;\n\tworkspaceId?: string;\n\townerId?: string;\n}\n\nfunction hashSkillContent(content: string): string {\n\treturn createHash(\"sha256\").update(content).digest(\"hex\");\n}\n\nfunction readMetadataValue(\n\tmetadata: Record<string, string> | undefined,\n\tkey: string,\n): string | undefined {\n\tconst value = metadata?.[key]?.trim();\n\treturn value ? value : undefined;\n}\n\nfunction normalizeSkillArtifactMetadata(\n\tvalue: unknown,\n): SkillArtifactMetadata | undefined {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\treturn undefined;\n\t}\n\tconst candidate = value as Record<string, unknown>;\n\tif (\n\t\ttypeof candidate.name !== \"string\" ||\n\t\tcandidate.name.trim().length === 0 ||\n\t\ttypeof candidate.hash !== \"string\" ||\n\t\tcandidate.hash.trim().length === 0 ||\n\t\ttypeof candidate.source !== \"string\" ||\n\t\tcandidate.source.trim().length === 0\n\t) {\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\tname: candidate.name.trim(),\n\t\thash: candidate.hash.trim(),\n\t\tsource: candidate.source.trim() as SkillArtifactSource,\n\t\t...(typeof candidate.artifactId === \"string\" &&\n\t\tcandidate.artifactId.trim().length > 0\n\t\t\t? { artifactId: candidate.artifactId.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.version === \"string\" &&\n\t\tcandidate.version.trim().length > 0\n\t\t\t? { version: candidate.version.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.sourcePath === \"string\" &&\n\t\tcandidate.sourcePath.trim().length > 0\n\t\t\t? { sourcePath: candidate.sourcePath.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.scope === \"string\" && candidate.scope.trim().length > 0\n\t\t\t? { scope: candidate.scope.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.workspaceId === \"string\" &&\n\t\tcandidate.workspaceId.trim().length > 0\n\t\t\t? { workspaceId: candidate.workspaceId.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.ownerId === \"string\" &&\n\t\tcandidate.ownerId.trim().length > 0\n\t\t\t? { ownerId: candidate.ownerId.trim() }\n\t\t\t: {}),\n\t};\n}\n\nexport function buildSkillArtifactMetadata(\n\tskill: LoadedSkill,\n): SkillArtifactMetadata {\n\treturn {\n\t\tname: skill.name,\n\t\thash: hashSkillContent(skill.content),\n\t\tsource: skill.sourceType,\n\t\t...(readMetadataValue(skill.metadata, \"skillServiceId\")\n\t\t\t? { artifactId: readMetadataValue(skill.metadata, \"skillServiceId\") }\n\t\t\t: {}),\n\t\t...((readMetadataValue(skill.metadata, \"currentVersion\") ??\n\t\treadMetadataValue(skill.metadata, \"version\") ??\n\t\tskill.version)\n\t\t\t? {\n\t\t\t\t\tversion:\n\t\t\t\t\t\treadMetadataValue(skill.metadata, \"currentVersion\") ??\n\t\t\t\t\t\treadMetadataValue(skill.metadata, \"version\") ??\n\t\t\t\t\t\tskill.version,\n\t\t\t\t}\n\t\t\t: {}),\n\t\t...(skill.sourcePath ? { sourcePath: skill.sourcePath } : {}),\n\t\t...(readMetadataValue(skill.metadata, \"scope\")\n\t\t\t? { scope: readMetadataValue(skill.metadata, \"scope\") }\n\t\t\t: {}),\n\t\t...(readMetadataValue(skill.metadata, \"workspaceId\")\n\t\t\t? { workspaceId: readMetadataValue(skill.metadata, \"workspaceId\") }\n\t\t\t: {}),\n\t\t...(readMetadataValue(skill.metadata, \"ownerId\")\n\t\t\t? { ownerId: readMetadataValue(skill.metadata, \"ownerId\") }\n\t\t\t: {}),\n\t};\n}\n\nexport function getSkillArtifactMetadataFromDetails(\n\tdetails: unknown,\n): SkillArtifactMetadata | undefined {\n\tif (!details || typeof details !== \"object\" || Array.isArray(details)) {\n\t\treturn undefined;\n\t}\n\treturn normalizeSkillArtifactMetadata(\n\t\t(details as { skillMetadata?: unknown }).skillMetadata,\n\t);\n}\n"]}

package/dist/skills/composer-diagnostics.d.ts

@@ -1,69 +0,0 @@
-/**
- * Skill composer diagnostics
- *
- * Builds on the skill composition hook (part 1 of #2671, merged as
- * #2671). The composer module decides at activation time whether to
- * splice a partner skill's body into the active skill. When something
- * unexpected happens — a guidelines partner is missing, a composer
- * silently passes through — there's no good way to inspect *why*.
- *
- * This module owns the "why" report. Given a skill + all available
- * skills, return a structured `SkillCompositionDiagnostic` that lists:
- *
- *   - whether composition applied
- *   - which partner the composer looked for
- *   - what the verdict was (applied / partner-missing / no-composer)
- *
- * Pure function over the loader types. No I/O, no activation side
- * effects. The `/skills diagnose` slash command surface comes in a
- * follow-up PR that consumes this.
- */
-import type { LoadedSkill } from "./loader.js";
-/** Per-skill registry of known compositions. Mirrors `composer.ts`. */
-interface CompositionRule {
-    /** Parent skill name that triggers this rule. */
-    parent: string;
-    /** Partner skill name the composer splices in when present. */
-    partner: string;
-    /**
-     * Human-readable explanation of what splicing produces. Surfaced
-     * verbatim in the diagnostic, so reviewers reading
-     * `/skills diagnose <name>` immediately know what changed.
-     */
-    effect: string;
-}
-/** Possible verdicts for a composition diagnostic. */
-export type CompositionVerdict = "applied" | "partner-missing" | "no-composer";
-/** Outcome of a single composition rule against the input skill. */
-export interface SkillCompositionDiagnostic {
-    /** Parent skill name evaluated. */
-    skillName: string;
-    /** Verdict for this skill. */
-    verdict: CompositionVerdict;
-    /** Partner skill name the rule was looking for; absent for `no-composer`. */
-    expectedPartner?: string;
-    /** Human-readable explanation of what would have spliced in. */
-    effect?: string;
-}
-/**
- * Diagnose what `composeSkill` would do for `skill` given the
- * available skills. Returns a structured verdict instead of mutating
- * the input. Mirrors the composer module's matching logic.
- */
-export declare function diagnoseSkillComposition(skill: LoadedSkill, allSkills: readonly LoadedSkill[]): SkillCompositionDiagnostic;
-/**
- * Diagnose every skill in `allSkills`. Sorted by parent skill name
- * ascending for stable output. Skills without a registered composer
- * are included (verdict `no-composer`) so reviewers can see at a
- * glance which surface had no special handling.
- */
-export declare function diagnoseAllSkillCompositions(allSkills: readonly LoadedSkill[]): SkillCompositionDiagnostic[];
-/**
- * List the parent → partner rules the composer module currently
- * knows about. Useful for `/skills diagnose --rules` to surface what
- * composers are wired even when no skill triggers them in the
- * current repo.
- */
-export declare function listCompositionRules(): readonly CompositionRule[];
-export {};
-//# sourceMappingURL=composer-diagnostics.d.ts.map

package/dist/skills/composer-diagnostics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"composer-diagnostics.d.ts","sourceRoot":"","sources":["../../src/skills/composer-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,uEAAuE;AACvE,UAAU,eAAe;IACxB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CACf;AAWD,sDAAsD;AACtD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAE/E,oEAAoE;AACpE,MAAM,WAAW,0BAA0B;IAC1C,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,SAAS,WAAW,EAAE,GAC/B,0BAA0B,CAoB5B;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC3C,SAAS,EAAE,SAAS,WAAW,EAAE,GAC/B,0BAA0B,EAAE,CAO9B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,eAAe,EAAE,CAEjE"}

package/dist/skills/composer-diagnostics.js

@@ -1,78 +0,0 @@
-/**
- * Skill composer diagnostics
- *
- * Builds on the skill composition hook (part 1 of #2671, merged as
- * #2671). The composer module decides at activation time whether to
- * splice a partner skill's body into the active skill. When something
- * unexpected happens — a guidelines partner is missing, a composer
- * silently passes through — there's no good way to inspect *why*.
- *
- * This module owns the "why" report. Given a skill + all available
- * skills, return a structured `SkillCompositionDiagnostic` that lists:
- *
- *   - whether composition applied
- *   - which partner the composer looked for
- *   - what the verdict was (applied / partner-missing / no-composer)
- *
- * Pure function over the loader types. No I/O, no activation side
- * effects. The `/skills diagnose` slash command surface comes in a
- * follow-up PR that consumes this.
- */
-const RULES = [
-    {
-        parent: "review",
-        partner: "review-guidelines",
-        effect: "appends repo-specific review guidelines under a `## Repository-specific review guidelines` heading",
-    },
-];
-/**
- * Diagnose what `composeSkill` would do for `skill` given the
- * available skills. Returns a structured verdict instead of mutating
- * the input. Mirrors the composer module's matching logic.
- */
-export function diagnoseSkillComposition(skill, allSkills) {
-    const rule = RULES.find((r) => r.parent === skill.name);
-    if (!rule) {
-        return { skillName: skill.name, verdict: "no-composer" };
-    }
-    const hasPartner = allSkills.some((s) => s.name === rule.partner);
-    if (!hasPartner) {
-        return {
-            skillName: skill.name,
-            verdict: "partner-missing",
-            expectedPartner: rule.partner,
-            effect: rule.effect,
-        };
-    }
-    return {
-        skillName: skill.name,
-        verdict: "applied",
-        expectedPartner: rule.partner,
-        effect: rule.effect,
-    };
-}
-/**
- * Diagnose every skill in `allSkills`. Sorted by parent skill name
- * ascending for stable output. Skills without a registered composer
- * are included (verdict `no-composer`) so reviewers can see at a
- * glance which surface had no special handling.
- */
-export function diagnoseAllSkillCompositions(allSkills) {
-    return [...allSkills]
-        .map((skill) => diagnoseSkillComposition(skill, allSkills))
-        .sort((a, b) => {
-        if (a.skillName === b.skillName)
-            return 0;
-        return a.skillName < b.skillName ? -1 : 1;
-    });
-}
-/**
- * List the parent → partner rules the composer module currently
- * knows about. Useful for `/skills diagnose --rules` to surface what
- * composers are wired even when no skill triggers them in the
- * current repo.
- */
-export function listCompositionRules() {
-    return RULES;
-}
-//# sourceMappingURL=composer-diagnostics.js.map

package/dist/skills/composer-diagnostics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"composer-diagnostics.js","sourceRoot":"","sources":["../../src/skills/composer-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAkBH,MAAM,KAAK,GAA+B;IACzC;QACC,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,mBAAmB;QAC5B,MAAM,EACL,oGAAoG;KACrG;CACD,CAAC;AAiBF;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACvC,KAAkB,EAClB,SAAiC;IAEjC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO;YACN,SAAS,EAAE,KAAK,CAAC,IAAI;YACrB,OAAO,EAAE,iBAAiB;YAC1B,eAAe,EAAE,IAAI,CAAC,OAAO;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC;IACH,CAAC;IACD,OAAO;QACN,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,OAAO,EAAE,SAAS;QAClB,eAAe,EAAE,IAAI,CAAC,OAAO;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;KACnB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC3C,SAAiC;IAEjC,OAAO,CAAC,GAAG,SAAS,CAAC;SACnB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;SAC1D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACd,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IACnC,OAAO,KAAK,CAAC;AACd,CAAC","sourcesContent":["/**\n * Skill composer diagnostics\n *\n * Builds on the skill composition hook (part 1 of #2671, merged as\n * #2671). The composer module decides at activation time whether to\n * splice a partner skill's body into the active skill. When something\n * unexpected happens — a guidelines partner is missing, a composer\n * silently passes through — there's no good way to inspect *why*.\n *\n * This module owns the \"why\" report. Given a skill + all available\n * skills, return a structured `SkillCompositionDiagnostic` that lists:\n *\n *   - whether composition applied\n *   - which partner the composer looked for\n *   - what the verdict was (applied / partner-missing / no-composer)\n *\n * Pure function over the loader types. No I/O, no activation side\n * effects. The `/skills diagnose` slash command surface comes in a\n * follow-up PR that consumes this.\n */\n\nimport type { LoadedSkill } from \"./loader.js\";\n\n/** Per-skill registry of known compositions. Mirrors `composer.ts`. */\ninterface CompositionRule {\n\t/** Parent skill name that triggers this rule. */\n\tparent: string;\n\t/** Partner skill name the composer splices in when present. */\n\tpartner: string;\n\t/**\n\t * Human-readable explanation of what splicing produces. Surfaced\n\t * verbatim in the diagnostic, so reviewers reading\n\t * `/skills diagnose <name>` immediately know what changed.\n\t */\n\teffect: string;\n}\n\nconst RULES: readonly CompositionRule[] = [\n\t{\n\t\tparent: \"review\",\n\t\tpartner: \"review-guidelines\",\n\t\teffect:\n\t\t\t\"appends repo-specific review guidelines under a `## Repository-specific review guidelines` heading\",\n\t},\n];\n\n/** Possible verdicts for a composition diagnostic. */\nexport type CompositionVerdict = \"applied\" | \"partner-missing\" | \"no-composer\";\n\n/** Outcome of a single composition rule against the input skill. */\nexport interface SkillCompositionDiagnostic {\n\t/** Parent skill name evaluated. */\n\tskillName: string;\n\t/** Verdict for this skill. */\n\tverdict: CompositionVerdict;\n\t/** Partner skill name the rule was looking for; absent for `no-composer`. */\n\texpectedPartner?: string;\n\t/** Human-readable explanation of what would have spliced in. */\n\teffect?: string;\n}\n\n/**\n * Diagnose what `composeSkill` would do for `skill` given the\n * available skills. Returns a structured verdict instead of mutating\n * the input. Mirrors the composer module's matching logic.\n */\nexport function diagnoseSkillComposition(\n\tskill: LoadedSkill,\n\tallSkills: readonly LoadedSkill[],\n): SkillCompositionDiagnostic {\n\tconst rule = RULES.find((r) => r.parent === skill.name);\n\tif (!rule) {\n\t\treturn { skillName: skill.name, verdict: \"no-composer\" };\n\t}\n\tconst hasPartner = allSkills.some((s) => s.name === rule.partner);\n\tif (!hasPartner) {\n\t\treturn {\n\t\t\tskillName: skill.name,\n\t\t\tverdict: \"partner-missing\",\n\t\t\texpectedPartner: rule.partner,\n\t\t\teffect: rule.effect,\n\t\t};\n\t}\n\treturn {\n\t\tskillName: skill.name,\n\t\tverdict: \"applied\",\n\t\texpectedPartner: rule.partner,\n\t\teffect: rule.effect,\n\t};\n}\n\n/**\n * Diagnose every skill in `allSkills`. Sorted by parent skill name\n * ascending for stable output. Skills without a registered composer\n * are included (verdict `no-composer`) so reviewers can see at a\n * glance which surface had no special handling.\n */\nexport function diagnoseAllSkillCompositions(\n\tallSkills: readonly LoadedSkill[],\n): SkillCompositionDiagnostic[] {\n\treturn [...allSkills]\n\t\t.map((skill) => diagnoseSkillComposition(skill, allSkills))\n\t\t.sort((a, b) => {\n\t\t\tif (a.skillName === b.skillName) return 0;\n\t\t\treturn a.skillName < b.skillName ? -1 : 1;\n\t\t});\n}\n\n/**\n * List the parent → partner rules the composer module currently\n * knows about. Useful for `/skills diagnose --rules` to surface what\n * composers are wired even when no skill triggers them in the\n * current repo.\n */\nexport function listCompositionRules(): readonly CompositionRule[] {\n\treturn RULES;\n}\n"]}

package/dist/skills/composer.d.ts

@@ -1,19 +0,0 @@
-/**
- * Skill composition - splice content from one skill into another at activation time.
- *
- * When the agent activates a skill (e.g., `review`), a composer can splice in
- * the body of a companion skill defined in the repo (e.g., `review-guidelines`)
- * so the agent receives a single composed payload instead of having to invoke
- * two skills serially. Composition is opt-in per parent skill - skills without
- * a registered composer pass through unchanged.
- */
-import type { LoadedSkill } from "./loader.js";
-/**
- * Apply any registered composer for the active skill. Returns the input
- * unchanged if no composer matches or the partner skill is absent.
- *
- * Composition preserves `name`, `sourceType`, and other identity fields so
- * activation telemetry keyed on the parent skill remains correct.
- */
-export declare function composeSkill(skill: LoadedSkill, allSkills: LoadedSkill[]): LoadedSkill;
-//# sourceMappingURL=composer.d.ts.map

package/dist/skills/composer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../src/skills/composer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiD/C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,WAAW,EAAE,GACtB,WAAW,CAOb"}

package/dist/skills/composer.js

@@ -1,64 +0,0 @@
-/**
- * Skill composition - splice content from one skill into another at activation time.
- *
- * When the agent activates a skill (e.g., `review`), a composer can splice in
- * the body of a companion skill defined in the repo (e.g., `review-guidelines`)
- * so the agent receives a single composed payload instead of having to invoke
- * two skills serially. Composition is opt-in per parent skill - skills without
- * a registered composer pass through unchanged.
- */
-import { createHash } from "node:crypto";
-/**
- * Compose `review` with a repo-defined `review-guidelines` skill, if present.
- *
- * The guidelines body is appended to the review skill's content under a
- * `## Repository-specific review guidelines` heading. If the repo doesn't
- * define `review-guidelines`, the review skill passes through unchanged.
- */
-const REVIEW_COMPOSER = {
-    appliesTo: (skill) => skill.name === "review",
-    compose: (skill, allSkills) => {
-        const guidelines = allSkills.find((s) => s.name === "review-guidelines");
-        if (!guidelines) {
-            return skill;
-        }
-        const composed = [
-            skill.content,
-            "",
-            "## Repository-specific review guidelines",
-            "",
-            `_The following guidelines are defined by the \`review-guidelines\` skill in this repository (\`${guidelines.sourceType}\`)._`,
-            "",
-            guidelines.content,
-        ].join("\n");
-        const contentSha = createHash("sha256")
-            .update("composed-skill:v1")
-            .update("\0parent:")
-            .update(skill.contentSha)
-            .update("\0partner:")
-            .update(guidelines.name)
-            .update("\0partner-sha:")
-            .update(guidelines.contentSha)
-            .update("\0content:")
-            .update(composed)
-            .digest("hex");
-        return { ...skill, content: composed, contentSha };
-    },
-};
-const COMPOSERS = [REVIEW_COMPOSER];
-/**
- * Apply any registered composer for the active skill. Returns the input
- * unchanged if no composer matches or the partner skill is absent.
- *
- * Composition preserves `name`, `sourceType`, and other identity fields so
- * activation telemetry keyed on the parent skill remains correct.
- */
-export function composeSkill(skill, allSkills) {
-    for (const composer of COMPOSERS) {
-        if (composer.appliesTo(skill)) {
-            return composer.compose(skill, allSkills);
-        }
-    }
-    return skill;
-}
-//# sourceMappingURL=composer.js.map

package/dist/skills/composer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"composer.js","sourceRoot":"","sources":["../../src/skills/composer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC;;;;;;GAMG;AACH,MAAM,eAAe,GAAkB;IACtC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;IAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;QAC7B,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;QACzE,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACd,CAAC;QACD,MAAM,QAAQ,GAAG;YAChB,KAAK,CAAC,OAAO;YACb,EAAE;YACF,0CAA0C;YAC1C,EAAE;YACF,kGAAkG,UAAU,CAAC,UAAU,OAAO;YAC9H,EAAE;YACF,UAAU,CAAC,OAAO;SAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC;aACrC,MAAM,CAAC,mBAAmB,CAAC;aAC3B,MAAM,CAAC,WAAW,CAAC;aACnB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;aACxB,MAAM,CAAC,YAAY,CAAC;aACpB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;aACvB,MAAM,CAAC,gBAAgB,CAAC;aACxB,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;aAC7B,MAAM,CAAC,YAAY,CAAC;aACpB,MAAM,CAAC,QAAQ,CAAC;aAChB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACpD,CAAC;CACD,CAAC;AAEF,MAAM,SAAS,GAA6B,CAAC,eAAe,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC3B,KAAkB,EAClB,SAAwB;IAExB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC","sourcesContent":["/**\n * Skill composition - splice content from one skill into another at activation time.\n *\n * When the agent activates a skill (e.g., `review`), a composer can splice in\n * the body of a companion skill defined in the repo (e.g., `review-guidelines`)\n * so the agent receives a single composed payload instead of having to invoke\n * two skills serially. Composition is opt-in per parent skill - skills without\n * a registered composer pass through unchanged.\n */\n\nimport { createHash } from \"node:crypto\";\nimport type { LoadedSkill } from \"./loader.js\";\n\ninterface SkillComposer {\n\t/** Whether this composer applies to the active skill. */\n\tappliesTo(skill: LoadedSkill): boolean;\n\t/** Produce a composed skill, or return the input if the partner skill is absent. */\n\tcompose(skill: LoadedSkill, allSkills: LoadedSkill[]): LoadedSkill;\n}\n\n/**\n * Compose `review` with a repo-defined `review-guidelines` skill, if present.\n *\n * The guidelines body is appended to the review skill's content under a\n * `## Repository-specific review guidelines` heading. If the repo doesn't\n * define `review-guidelines`, the review skill passes through unchanged.\n */\nconst REVIEW_COMPOSER: SkillComposer = {\n\tappliesTo: (skill) => skill.name === \"review\",\n\tcompose: (skill, allSkills) => {\n\t\tconst guidelines = allSkills.find((s) => s.name === \"review-guidelines\");\n\t\tif (!guidelines) {\n\t\t\treturn skill;\n\t\t}\n\t\tconst composed = [\n\t\t\tskill.content,\n\t\t\t\"\",\n\t\t\t\"## Repository-specific review guidelines\",\n\t\t\t\"\",\n\t\t\t`_The following guidelines are defined by the \\`review-guidelines\\` skill in this repository (\\`${guidelines.sourceType}\\`)._`,\n\t\t\t\"\",\n\t\t\tguidelines.content,\n\t\t].join(\"\\n\");\n\t\tconst contentSha = createHash(\"sha256\")\n\t\t\t.update(\"composed-skill:v1\")\n\t\t\t.update(\"\\0parent:\")\n\t\t\t.update(skill.contentSha)\n\t\t\t.update(\"\\0partner:\")\n\t\t\t.update(guidelines.name)\n\t\t\t.update(\"\\0partner-sha:\")\n\t\t\t.update(guidelines.contentSha)\n\t\t\t.update(\"\\0content:\")\n\t\t\t.update(composed)\n\t\t\t.digest(\"hex\");\n\t\treturn { ...skill, content: composed, contentSha };\n\t},\n};\n\nconst COMPOSERS: readonly SkillComposer[] = [REVIEW_COMPOSER];\n\n/**\n * Apply any registered composer for the active skill. Returns the input\n * unchanged if no composer matches or the partner skill is absent.\n *\n * Composition preserves `name`, `sourceType`, and other identity fields so\n * activation telemetry keyed on the parent skill remains correct.\n */\nexport function composeSkill(\n\tskill: LoadedSkill,\n\tallSkills: LoadedSkill[],\n): LoadedSkill {\n\tfor (const composer of COMPOSERS) {\n\t\tif (composer.appliesTo(skill)) {\n\t\t\treturn composer.compose(skill, allSkills);\n\t\t}\n\t}\n\treturn skill;\n}\n"]}

package/dist/skills/eval-harness.d.ts

@@ -1,38 +0,0 @@
-import { type SkillLintIssue, lintSkillPaths } from "./linter.js";
-type SkillEvalOptions = NonNullable<Parameters<typeof lintSkillPaths>[1]>;
-export type SkillEvalOutcome = "pass" | "fail";
-export type SkillEvalAssertionStatus = "pass" | "fail";
-export interface SkillEvalCase {
-    id?: string;
-    path: string;
-    expectedOutcome?: SkillEvalOutcome;
-}
-export interface SkillEvalAssertion {
-    code: string;
-    status: SkillEvalAssertionStatus;
-    message: string;
-}
-export interface SkillEvalResult {
-    id: string;
-    path: string;
-    expectedOutcome: SkillEvalOutcome;
-    observedOutcome: SkillEvalOutcome;
-    matchedExpectation: boolean;
-    assertions: SkillEvalAssertion[];
-    issues: SkillLintIssue[];
-}
-export interface SkillEvalReport {
-    schemaVersion: "evalops.maestro.skill-package-eval.v1";
-    summary: {
-        total: number;
-        passed: number;
-        failed: number;
-        score: number;
-    };
-    results: SkillEvalResult[];
-}
-export declare function evaluateSkillPackages(cases: SkillEvalCase[], options?: SkillEvalOptions): Promise<SkillEvalReport>;
-export declare function hasSkillEvalFailures(report: SkillEvalReport): boolean;
-export declare function formatSkillEvalText(report: SkillEvalReport): string;
-export {};
-//# sourceMappingURL=eval-harness.d.ts.map

package/dist/skills/eval-harness.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"eval-harness.d.ts","sourceRoot":"","sources":["../../src/skills/eval-harness.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,cAAc,EAGnB,cAAc,EACd,MAAM,aAAa,CAAC;AAErB,KAAK,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC;AAC/C,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,wBAAwB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,gBAAgB,CAAC;IAClC,eAAe,EAAE,gBAAgB,CAAC;IAClC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,MAAM,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC/B,aAAa,EAAE,uCAAuC,CAAC;IACvD,OAAO,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,EAAE,eAAe,EAAE,CAAC;CAC3B;AA4FD,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAkC1B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAErE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAuBnE"}

package/dist/skills/eval-harness.js

@@ -1,112 +0,0 @@
-import { basename } from "node:path";
-import { hasSkillLintErrors, lintSkillPaths, } from "./linter.js";
-function assertion(code, status, message) {
-    return { code, status, message };
-}
-function hasIssue(result, codes) {
-    const wanted = new Set(codes);
-    return result.issues.some((issue) => wanted.has(issue.code));
-}
-function hasIssuePrefix(result, prefixes) {
-    return result.issues.some((issue) => prefixes.some((prefix) => issue.code.startsWith(prefix)));
-}
-function assertionsFor(result) {
-    const lintPasses = !hasSkillLintErrors([result]);
-    const loadable = !hasIssue(result, [
-        "missing_skill_md",
-        "invalid_skill_md",
-        "missing_name",
-        "invalid_name",
-        "name_mismatch",
-        "missing_description",
-    ]);
-    const boundedMcp = !hasIssue(result, [
-        "mcp_tools_unfiltered",
-        "invalid_mcp_include_tools",
-        "invalid_mcp_json",
-        "invalid_mcp_server",
-        "invalid_mcp_command",
-        "invalid_mcp_args",
-        "invalid_mcp_env",
-    ]);
-    const toolboxRunnable = !hasIssuePrefix(result, ["toolbox_"]);
-    const bodyWithinBudget = !hasIssue(result, ["skill_oversize"]);
-    return [
-        assertion("lint_passes", lintPasses ? "pass" : "fail", lintPasses
-            ? "Package has no blocking lint issues."
-            : "Package has blocking lint issues."),
-        assertion("skill_md_loadable", loadable ? "pass" : "fail", loadable
-            ? "SKILL.md frontmatter is loadable."
-            : "SKILL.md frontmatter is not loadable."),
-        assertion("mcp_tools_bounded", boundedMcp ? "pass" : "fail", boundedMcp
-            ? "Bundled MCP servers are filtered and well-formed."
-            : "Bundled MCP servers are missing bounded includeTools or are malformed."),
-        assertion("toolbox_runnable", toolboxRunnable ? "pass" : "fail", toolboxRunnable
-            ? "Toolbox entries are executable for the target platform."
-            : "Toolbox entries are not executable or fail describe checks."),
-        assertion("progressive_disclosure_budget", bodyWithinBudget ? "pass" : "fail", bodyWithinBudget
-            ? "SKILL.md stays within progressive-disclosure budget."
-            : "SKILL.md exceeds progressive-disclosure budget."),
-    ];
-}
-function resultId(evalCase, lintResult, resultCount) {
-    if (evalCase.id && resultCount === 1)
-        return evalCase.id;
-    if (evalCase.id)
-        return `${evalCase.id}:${basename(lintResult.path)}`;
-    return basename(lintResult.path);
-}
-export async function evaluateSkillPackages(cases, options = {}) {
-    const results = [];
-    for (const evalCase of cases) {
-        const lintResults = await lintSkillPaths([evalCase.path], options);
-        for (const lintResult of lintResults) {
-            const assertions = assertionsFor(lintResult);
-            const observedOutcome = assertions.some((item) => item.status === "fail")
-                ? "fail"
-                : "pass";
-            const expectedOutcome = evalCase.expectedOutcome ?? "pass";
-            results.push({
-                id: resultId(evalCase, lintResult, lintResults.length),
-                path: lintResult.path,
-                expectedOutcome,
-                observedOutcome,
-                matchedExpectation: observedOutcome === expectedOutcome,
-                assertions,
-                issues: lintResult.issues,
-            });
-        }
-    }
-    const passed = results.filter((result) => result.matchedExpectation).length;
-    const failed = results.length - passed;
-    return {
-        schemaVersion: "evalops.maestro.skill-package-eval.v1",
-        summary: {
-            total: results.length,
-            passed,
-            failed,
-            score: results.length === 0 ? 1 : passed / results.length,
-        },
-        results,
-    };
-}
-export function hasSkillEvalFailures(report) {
-    return report.summary.failed > 0;
-}
-export function formatSkillEvalText(report) {
-    const lines = [];
-    for (const result of report.results) {
-        const status = result.matchedExpectation ? "PASS" : "FAIL";
-        lines.push(`${status} ${result.id} expected=${result.expectedOutcome} observed=${result.observedOutcome}`);
-        for (const assertionResult of result.assertions) {
-            lines.push(`  ${assertionResult.status.toUpperCase()} ${assertionResult.code}: ${assertionResult.message}`);
-        }
-        for (const issue of result.issues) {
-            lines.push(`  ${issue.severity.toUpperCase()} ${issue.code}: ${issue.message}`);
-        }
-    }
-    lines.push("");
-    lines.push(`${report.summary.passed} passed, ${report.summary.failed} failed, score ${report.summary.score.toFixed(2)}`);
-    return lines.join("\n");
-}
-//# sourceMappingURL=eval-harness.js.map

package/dist/skills/eval-harness.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"eval-harness.js","sourceRoot":"","sources":["../../src/skills/eval-harness.ts"],"names":[],"mappings":"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","sourcesContent":["import { basename } from \"node:path\";\nimport {\n\ttype SkillLintIssue,\n\ttype SkillLintResult,\n\thasSkillLintErrors,\n\tlintSkillPaths,\n} from \"./linter.js\";\n\ntype SkillEvalOptions = NonNullable<Parameters<typeof lintSkillPaths>[1]>;\n\nexport type SkillEvalOutcome = \"pass\" | \"fail\";\nexport type SkillEvalAssertionStatus = \"pass\" | \"fail\";\n\nexport interface SkillEvalCase {\n\tid?: string;\n\tpath: string;\n\texpectedOutcome?: SkillEvalOutcome;\n}\n\nexport interface SkillEvalAssertion {\n\tcode: string;\n\tstatus: SkillEvalAssertionStatus;\n\tmessage: string;\n}\n\nexport interface SkillEvalResult {\n\tid: string;\n\tpath: string;\n\texpectedOutcome: SkillEvalOutcome;\n\tobservedOutcome: SkillEvalOutcome;\n\tmatchedExpectation: boolean;\n\tassertions: SkillEvalAssertion[];\n\tissues: SkillLintIssue[];\n}\n\nexport interface SkillEvalReport {\n\tschemaVersion: \"evalops.maestro.skill-package-eval.v1\";\n\tsummary: {\n\t\ttotal: number;\n\t\tpassed: number;\n\t\tfailed: number;\n\t\tscore: number;\n\t};\n\tresults: SkillEvalResult[];\n}\n\nfunction assertion(\n\tcode: string,\n\tstatus: SkillEvalAssertionStatus,\n\tmessage: string,\n): SkillEvalAssertion {\n\treturn { code, status, message };\n}\n\nfunction hasIssue(result: SkillLintResult, codes: string[]): boolean {\n\tconst wanted = new Set(codes);\n\treturn result.issues.some((issue) => wanted.has(issue.code));\n}\n\nfunction hasIssuePrefix(result: SkillLintResult, prefixes: string[]): boolean {\n\treturn result.issues.some((issue) =>\n\t\tprefixes.some((prefix) => issue.code.startsWith(prefix)),\n\t);\n}\n\nfunction assertionsFor(result: SkillLintResult): SkillEvalAssertion[] {\n\tconst lintPasses = !hasSkillLintErrors([result]);\n\tconst loadable = !hasIssue(result, [\n\t\t\"missing_skill_md\",\n\t\t\"invalid_skill_md\",\n\t\t\"missing_name\",\n\t\t\"invalid_name\",\n\t\t\"name_mismatch\",\n\t\t\"missing_description\",\n\t]);\n\tconst boundedMcp = !hasIssue(result, [\n\t\t\"mcp_tools_unfiltered\",\n\t\t\"invalid_mcp_include_tools\",\n\t\t\"invalid_mcp_json\",\n\t\t\"invalid_mcp_server\",\n\t\t\"invalid_mcp_command\",\n\t\t\"invalid_mcp_args\",\n\t\t\"invalid_mcp_env\",\n\t]);\n\tconst toolboxRunnable = !hasIssuePrefix(result, [\"toolbox_\"]);\n\tconst bodyWithinBudget = !hasIssue(result, [\"skill_oversize\"]);\n\n\treturn [\n\t\tassertion(\n\t\t\t\"lint_passes\",\n\t\t\tlintPasses ? \"pass\" : \"fail\",\n\t\t\tlintPasses\n\t\t\t\t? \"Package has no blocking lint issues.\"\n\t\t\t\t: \"Package has blocking lint issues.\",\n\t\t),\n\t\tassertion(\n\t\t\t\"skill_md_loadable\",\n\t\t\tloadable ? \"pass\" : \"fail\",\n\t\t\tloadable\n\t\t\t\t? \"SKILL.md frontmatter is loadable.\"\n\t\t\t\t: \"SKILL.md frontmatter is not loadable.\",\n\t\t),\n\t\tassertion(\n\t\t\t\"mcp_tools_bounded\",\n\t\t\tboundedMcp ? \"pass\" : \"fail\",\n\t\t\tboundedMcp\n\t\t\t\t? \"Bundled MCP servers are filtered and well-formed.\"\n\t\t\t\t: \"Bundled MCP servers are missing bounded includeTools or are malformed.\",\n\t\t),\n\t\tassertion(\n\t\t\t\"toolbox_runnable\",\n\t\t\ttoolboxRunnable ? \"pass\" : \"fail\",\n\t\t\ttoolboxRunnable\n\t\t\t\t? \"Toolbox entries are executable for the target platform.\"\n\t\t\t\t: \"Toolbox entries are not executable or fail describe checks.\",\n\t\t),\n\t\tassertion(\n\t\t\t\"progressive_disclosure_budget\",\n\t\t\tbodyWithinBudget ? \"pass\" : \"fail\",\n\t\t\tbodyWithinBudget\n\t\t\t\t? \"SKILL.md stays within progressive-disclosure budget.\"\n\t\t\t\t: \"SKILL.md exceeds progressive-disclosure budget.\",\n\t\t),\n\t];\n}\n\nfunction resultId(\n\tevalCase: SkillEvalCase,\n\tlintResult: SkillLintResult,\n\tresultCount: number,\n): string {\n\tif (evalCase.id && resultCount === 1) return evalCase.id;\n\tif (evalCase.id) return `${evalCase.id}:${basename(lintResult.path)}`;\n\treturn basename(lintResult.path);\n}\n\nexport async function evaluateSkillPackages(\n\tcases: SkillEvalCase[],\n\toptions: SkillEvalOptions = {},\n): Promise<SkillEvalReport> {\n\tconst results: SkillEvalResult[] = [];\n\tfor (const evalCase of cases) {\n\t\tconst lintResults = await lintSkillPaths([evalCase.path], options);\n\t\tfor (const lintResult of lintResults) {\n\t\t\tconst assertions = assertionsFor(lintResult);\n\t\t\tconst observedOutcome = assertions.some((item) => item.status === \"fail\")\n\t\t\t\t? \"fail\"\n\t\t\t\t: \"pass\";\n\t\t\tconst expectedOutcome = evalCase.expectedOutcome ?? \"pass\";\n\t\t\tresults.push({\n\t\t\t\tid: resultId(evalCase, lintResult, lintResults.length),\n\t\t\t\tpath: lintResult.path,\n\t\t\t\texpectedOutcome,\n\t\t\t\tobservedOutcome,\n\t\t\t\tmatchedExpectation: observedOutcome === expectedOutcome,\n\t\t\t\tassertions,\n\t\t\t\tissues: lintResult.issues,\n\t\t\t});\n\t\t}\n\t}\n\n\tconst passed = results.filter((result) => result.matchedExpectation).length;\n\tconst failed = results.length - passed;\n\treturn {\n\t\tschemaVersion: \"evalops.maestro.skill-package-eval.v1\",\n\t\tsummary: {\n\t\t\ttotal: results.length,\n\t\t\tpassed,\n\t\t\tfailed,\n\t\t\tscore: results.length === 0 ? 1 : passed / results.length,\n\t\t},\n\t\tresults,\n\t};\n}\n\nexport function hasSkillEvalFailures(report: SkillEvalReport): boolean {\n\treturn report.summary.failed > 0;\n}\n\nexport function formatSkillEvalText(report: SkillEvalReport): string {\n\tconst lines: string[] = [];\n\tfor (const result of report.results) {\n\t\tconst status = result.matchedExpectation ? \"PASS\" : \"FAIL\";\n\t\tlines.push(\n\t\t\t`${status} ${result.id} expected=${result.expectedOutcome} observed=${result.observedOutcome}`,\n\t\t);\n\t\tfor (const assertionResult of result.assertions) {\n\t\t\tlines.push(\n\t\t\t\t`  ${assertionResult.status.toUpperCase()} ${assertionResult.code}: ${assertionResult.message}`,\n\t\t\t);\n\t\t}\n\t\tfor (const issue of result.issues) {\n\t\t\tlines.push(\n\t\t\t\t`  ${issue.severity.toUpperCase()} ${issue.code}: ${issue.message}`,\n\t\t\t);\n\t\t}\n\t}\n\tlines.push(\"\");\n\tlines.push(\n\t\t`${report.summary.passed} passed, ${report.summary.failed} failed, score ${report.summary.score.toFixed(2)}`,\n\t);\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/skills/index.d.ts

@@ -1,41 +0,0 @@
-/**
- * Skills System - Dynamic skill discovery and loading.
- *
- * Skills are domain-specific instruction sets that can be loaded
- * dynamically by the agent when it recognizes a matching task.
- *
- * ## Progressive Skill Disclosure (#857)
- *
- * Skills use a two-phase loading system for context efficiency:
- *
- * 1. **System Prompt**: Only inject metadata (name + description) using
- *    `formatSkillsForSystemPrompt()` - ~10 tokens per skill
- * 2. **On-Demand**: Agent uses `read` tool to load full SKILL.md when needed
- *    - ~500+ tokens per skill, only when relevant
- *
- * This scales to 20+ skills without degrading conversation quality.
- *
- * @example
- * ```typescript
- * import { loadSkills, formatSkillsForSystemPrompt } from "./skills";
- *
- * // Load all available skills
- * const { skills } = loadSkills(process.cwd());
- *
- * // Get lightweight metadata for system prompt (progressive disclosure)
- * const systemPromptSkills = formatSkillsForSystemPrompt(skills);
- *
- * // Or use legacy full-content approach (not recommended)
- * const summary = getSkillsSummary(skills);
- * ```
- */
-export { type LoadedSkill, type SkillDefinition, type SkillResource, findSkill, findSkillMd, formatSkillForInjection, formatSkillListItem, formatSkillMetadataOnly, formatSkillsForSystemPrompt, getSkillsSummary, loadSkills, parseFrontmatter, searchSkills, skillToDict, skillToJson, skillsToPrompt, stringArrayValue, } from "./loader.js";
-export { composeSkill } from "./composer.js";
-export { appendLearnedGuideline, defaultUserSkillsDir, formatLearnedGuidelinesForPrompt, getLearnedGuidelinesPath, loadLearnedGuidelines, } from "./learned-guidelines.js";
-export { type ScaffoldSkillOptions, type ScaffoldSkillResult, scaffoldSkillWithBody, } from "./scaffolder.js";
-export { createSkillTool, invalidateSkillCache } from "./tool.js";
-export { type SkillRuntimeActivation, type SkillRuntimeActivationOptions, type SkillRuntimeMcpActivation, type SkillRuntimeMcpServer, type SkillRuntimeResource, type SkillRuntimeResourceDirectories, type SkillRuntimeToolboxActivation, type SkillRuntimeToolboxEntry, buildSkillRuntimeActivation, } from "./runtime-activation.js";
-export { type SkillLintIssue, type SkillLintResult, type SkillScaffoldOptions, SKILL_BODY_MAX_CHARS, SKILL_BODY_MAX_LINES, formatSkillLintText, hasSkillLintErrors, isWindowsRunnableToolboxEntry, lintSkillDirectory, lintSkillPaths, scaffoldSkill, shouldUseShellForToolboxDescribe, toolboxDescribeSpawnCommand, } from "./linter.js";
-export { type SkillEvalAssertion, type SkillEvalCase, type SkillEvalOutcome, type SkillEvalReport, type SkillEvalResult, evaluateSkillPackages, formatSkillEvalText, hasSkillEvalFailures, } from "./eval-harness.js";
-export { MAESTRO_PACKAGE_KEYWORD, MAESTRO_SKILL_PACKAGE_KEYWORD, SKILL_PACKAGE_CONTRACT_SCHEMA, type BuildSkillPackagePublishContractOptions, type SkillPackageContractIssue, type SkillPackageInstallCommandSet, type SkillPackagePublishContract, buildSkillPackagePublishContract, formatSkillPackageInstallSource, formatSkillPackagePublishContract, } from "./package-contract.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,gCAAgC,EAChC,wBAAwB,EACxB,qBAAqB,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,qBAAqB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EACN,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,2BAA2B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gCAAgC,EAChC,2BAA2B,GAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,KAAK,uCAAuC,EAC5C,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,gCAAgC,EAChC,+BAA+B,EAC/B,iCAAiC,GACjC,MAAM,uBAAuB,CAAC"}

package/dist/skills/index.js

@@ -1,41 +0,0 @@
-/**
- * Skills System - Dynamic skill discovery and loading.
- *
- * Skills are domain-specific instruction sets that can be loaded
- * dynamically by the agent when it recognizes a matching task.
- *
- * ## Progressive Skill Disclosure (#857)
- *
- * Skills use a two-phase loading system for context efficiency:
- *
- * 1. **System Prompt**: Only inject metadata (name + description) using
- *    `formatSkillsForSystemPrompt()` - ~10 tokens per skill
- * 2. **On-Demand**: Agent uses `read` tool to load full SKILL.md when needed
- *    - ~500+ tokens per skill, only when relevant
- *
- * This scales to 20+ skills without degrading conversation quality.
- *
- * @example
- * ```typescript
- * import { loadSkills, formatSkillsForSystemPrompt } from "./skills";
- *
- * // Load all available skills
- * const { skills } = loadSkills(process.cwd());
- *
- * // Get lightweight metadata for system prompt (progressive disclosure)
- * const systemPromptSkills = formatSkillsForSystemPrompt(skills);
- *
- * // Or use legacy full-content approach (not recommended)
- * const summary = getSkillsSummary(skills);
- * ```
- */
-export { findSkill, findSkillMd, formatSkillForInjection, formatSkillListItem, formatSkillMetadataOnly, formatSkillsForSystemPrompt, getSkillsSummary, loadSkills, parseFrontmatter, searchSkills, skillToDict, skillToJson, skillsToPrompt, stringArrayValue, } from "./loader.js";
-export { composeSkill } from "./composer.js";
-export { appendLearnedGuideline, defaultUserSkillsDir, formatLearnedGuidelinesForPrompt, getLearnedGuidelinesPath, loadLearnedGuidelines, } from "./learned-guidelines.js";
-export { scaffoldSkillWithBody, } from "./scaffolder.js";
-export { createSkillTool, invalidateSkillCache } from "./tool.js";
-export { buildSkillRuntimeActivation, } from "./runtime-activation.js";
-export { SKILL_BODY_MAX_CHARS, SKILL_BODY_MAX_LINES, formatSkillLintText, hasSkillLintErrors, isWindowsRunnableToolboxEntry, lintSkillDirectory, lintSkillPaths, scaffoldSkill, shouldUseShellForToolboxDescribe, toolboxDescribeSpawnCommand, } from "./linter.js";
-export { evaluateSkillPackages, formatSkillEvalText, hasSkillEvalFailures, } from "./eval-harness.js";
-export { MAESTRO_PACKAGE_KEYWORD, MAESTRO_SKILL_PACKAGE_KEYWORD, SKILL_PACKAGE_CONTRACT_SCHEMA, buildSkillPackagePublishContract, formatSkillPackageInstallSource, formatSkillPackagePublishContract, } from "./package-contract.js";
-//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAIN,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,gCAAgC,EAChC,wBAAwB,EACxB,qBAAqB,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGN,qBAAqB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EASN,2BAA2B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIN,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gCAAgC,EAChC,2BAA2B,GAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EAMN,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAK7B,gCAAgC,EAChC,+BAA+B,EAC/B,iCAAiC,GACjC,MAAM,uBAAuB,CAAC","sourcesContent":["/**\n * Skills System - Dynamic skill discovery and loading.\n *\n * Skills are domain-specific instruction sets that can be loaded\n * dynamically by the agent when it recognizes a matching task.\n *\n * ## Progressive Skill Disclosure (#857)\n *\n * Skills use a two-phase loading system for context efficiency:\n *\n * 1. **System Prompt**: Only inject metadata (name + description) using\n *    `formatSkillsForSystemPrompt()` - ~10 tokens per skill\n * 2. **On-Demand**: Agent uses `read` tool to load full SKILL.md when needed\n *    - ~500+ tokens per skill, only when relevant\n *\n * This scales to 20+ skills without degrading conversation quality.\n *\n * @example\n * ```typescript\n * import { loadSkills, formatSkillsForSystemPrompt } from \"./skills\";\n *\n * // Load all available skills\n * const { skills } = loadSkills(process.cwd());\n *\n * // Get lightweight metadata for system prompt (progressive disclosure)\n * const systemPromptSkills = formatSkillsForSystemPrompt(skills);\n *\n * // Or use legacy full-content approach (not recommended)\n * const summary = getSkillsSummary(skills);\n * ```\n */\n\nexport {\n\ttype LoadedSkill,\n\ttype SkillDefinition,\n\ttype SkillResource,\n\tfindSkill,\n\tfindSkillMd,\n\tformatSkillForInjection,\n\tformatSkillListItem,\n\tformatSkillMetadataOnly,\n\tformatSkillsForSystemPrompt,\n\tgetSkillsSummary,\n\tloadSkills,\n\tparseFrontmatter,\n\tsearchSkills,\n\tskillToDict,\n\tskillToJson,\n\tskillsToPrompt,\n\tstringArrayValue,\n} from \"./loader.js\";\n\nexport { composeSkill } from \"./composer.js\";\nexport {\n\tappendLearnedGuideline,\n\tdefaultUserSkillsDir,\n\tformatLearnedGuidelinesForPrompt,\n\tgetLearnedGuidelinesPath,\n\tloadLearnedGuidelines,\n} from \"./learned-guidelines.js\";\nexport {\n\ttype ScaffoldSkillOptions,\n\ttype ScaffoldSkillResult,\n\tscaffoldSkillWithBody,\n} from \"./scaffolder.js\";\nexport { createSkillTool, invalidateSkillCache } from \"./tool.js\";\nexport {\n\ttype SkillRuntimeActivation,\n\ttype SkillRuntimeActivationOptions,\n\ttype SkillRuntimeMcpActivation,\n\ttype SkillRuntimeMcpServer,\n\ttype SkillRuntimeResource,\n\ttype SkillRuntimeResourceDirectories,\n\ttype SkillRuntimeToolboxActivation,\n\ttype SkillRuntimeToolboxEntry,\n\tbuildSkillRuntimeActivation,\n} from \"./runtime-activation.js\";\nexport {\n\ttype SkillLintIssue,\n\ttype SkillLintResult,\n\ttype SkillScaffoldOptions,\n\tSKILL_BODY_MAX_CHARS,\n\tSKILL_BODY_MAX_LINES,\n\tformatSkillLintText,\n\thasSkillLintErrors,\n\tisWindowsRunnableToolboxEntry,\n\tlintSkillDirectory,\n\tlintSkillPaths,\n\tscaffoldSkill,\n\tshouldUseShellForToolboxDescribe,\n\ttoolboxDescribeSpawnCommand,\n} from \"./linter.js\";\n\nexport {\n\ttype SkillEvalAssertion,\n\ttype SkillEvalCase,\n\ttype SkillEvalOutcome,\n\ttype SkillEvalReport,\n\ttype SkillEvalResult,\n\tevaluateSkillPackages,\n\tformatSkillEvalText,\n\thasSkillEvalFailures,\n} from \"./eval-harness.js\";\nexport {\n\tMAESTRO_PACKAGE_KEYWORD,\n\tMAESTRO_SKILL_PACKAGE_KEYWORD,\n\tSKILL_PACKAGE_CONTRACT_SCHEMA,\n\ttype BuildSkillPackagePublishContractOptions,\n\ttype SkillPackageContractIssue,\n\ttype SkillPackageInstallCommandSet,\n\ttype SkillPackagePublishContract,\n\tbuildSkillPackagePublishContract,\n\tformatSkillPackageInstallSource,\n\tformatSkillPackagePublishContract,\n} from \"./package-contract.js\";\n"]}

package/dist/skills/learned-guidelines.d.ts

@@ -1,33 +0,0 @@
-/**
- * Learned guidelines for skills
- *
- * A skill can accumulate durable, plain-text guidance across runs — for
- * example, incident-triage learning which tools and interfaces a given alert
- * type needs. Learnings are stored as markdown at
- * `<userSkillsDir>/<skill>/guidelines.md` (default `~/.maestro/skills`), so a
- * later run of the same skill can load what earlier runs discovered.
- *
- * The file is markdown, not settings, and every function takes the skills root
- * as a parameter (defaulting to the sanctioned PATHS.MAESTRO_HOME), so this
- * module reads no environment directly and writes atomically.
- */
-/** Default per-user skills root (`~/.maestro/skills`). */
-export declare function defaultUserSkillsDir(): string;
-/** Absolute path to a skill's learned-guidelines file. */
-export declare function getLearnedGuidelinesPath(skillName: string, userSkillsDir?: string): string;
-/**
- * Load a skill's learned guidelines, or null when none have been recorded.
- */
-export declare function loadLearnedGuidelines(skillName: string, userSkillsDir?: string): string | null;
-/**
- * Render a skill's learned guidelines as a prompt-ready block, or null when
- * there are none. Suitable for injection alongside the skill's own content.
- */
-export declare function formatLearnedGuidelinesForPrompt(skillName: string, userSkillsDir?: string): string | null;
-/**
- * Append a learned-guideline entry to a skill's guidelines file, creating it on
- * first use. Entries are separated by a horizontal rule so the file stays a
- * readable, append-only log.
- */
-export declare function appendLearnedGuideline(skillName: string, entry: string, userSkillsDir?: string): string;
-//# sourceMappingURL=learned-guidelines.d.ts.map

package/dist/skills/learned-guidelines.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"learned-guidelines.d.ts","sourceRoot":"","sources":["../../src/skills/learned-guidelines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgCH,0DAA0D;AAC1D,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AASD,0DAA0D;AAC1D,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAA+B,GAC5C,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAA+B,GAC5C,MAAM,GAAG,IAAI,CAKf;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC/C,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAA+B,GAC5C,MAAM,GAAG,IAAI,CAaf;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,MAA+B,GAC5C,MAAM,CAcR"}