ace-swarm 2.0.6 → 2.0.7

package/dist/skill-auditor.js

@@ -0,0 +1,184 @@
+import { safeWrite } from "./helpers.js";
+import { listSkillCatalogEntries, summarizeSkillCatalog, } from "./skill-catalog.js";
+function pushFinding(findings, severity, code, message) {
+    findings.push({ severity, code, message });
+}
+function clampScore(value) {
+    return Math.max(0, Math.min(100, value));
+}
+function auditSkillEntry(entry) {
+    const findings = [];
+    const strengths = [];
+    let score = 100;
+    if (entry.has_frontmatter) {
+        strengths.push("Portable frontmatter is present.");
+    }
+    else {
+        pushFinding(findings, "fail", "frontmatter", "Missing skill frontmatter.");
+        score -= 25;
+    }
+    if (entry.description.trim().length > 0) {
+        strengths.push("Description is present.");
+    }
+    else {
+        pushFinding(findings, "fail", "description", "Missing frontmatter description.");
+        score -= 15;
+    }
+    if (summarizeSkillCatalog([entry]).trigger_aware_descriptions > 0) {
+        strengths.push("Description is trigger-oriented.");
+    }
+    else {
+        pushFinding(findings, "fail", "trigger_description", "Description does not clearly say when to use the skill.");
+        score -= 15;
+    }
+    if (entry.has_use_cases_section) {
+        strengths.push("Canonical use cases are documented.");
+    }
+    else {
+        pushFinding(findings, "fail", "use_cases", "Missing canonical use cases/examples section.");
+        score -= 10;
+    }
+    if (entry.has_inputs_section && entry.has_workflow_section && entry.has_outputs_section) {
+        strengths.push("Core workflow contract sections are present.");
+    }
+    else {
+        if (!entry.has_inputs_section) {
+            pushFinding(findings, "fail", "inputs", "Missing Inputs section.");
+            score -= 10;
+        }
+        if (!entry.has_workflow_section) {
+            pushFinding(findings, "fail", "workflow", "Missing Workflow/Steps section.");
+            score -= 10;
+        }
+        if (!entry.has_outputs_section) {
+            pushFinding(findings, "fail", "outputs", "Missing Outputs/Artifacts section.");
+            score -= 10;
+        }
+    }
+    if (entry.has_failure_policy) {
+        strengths.push("Failure policy is explicit.");
+    }
+    else {
+        pushFinding(findings, "fail", "failure_policy", "Missing Failure Policy/Troubleshooting section.");
+        score -= 10;
+    }
+    if (entry.has_validation_surface) {
+        strengths.push("Validation or canary surface is documented.");
+    }
+    else {
+        pushFinding(findings, "warn", "validation_surface", "Validation/canary surface is not obvious from the portable skill contract.");
+        score -= 8;
+    }
+    if (entry.has_portability_notes) {
+        strengths.push("Vendor-neutral portability guidance is documented.");
+    }
+    else {
+        pushFinding(findings, "warn", "portability_notes", "Portability/cross-client guidance is missing from SKILL.md.");
+        score -= 6;
+    }
+    if (entry.line_count > 500 && !entry.has_references_dir) {
+        pushFinding(findings, "warn", "progressive_disclosure", "Long skill should move bulky detail into references/ for progressive disclosure.");
+        score -= 8;
+    }
+    else if (entry.line_count > 500 && entry.has_references_dir) {
+        strengths.push("Long skill already uses references/ for progressive disclosure.");
+    }
+    if (entry.has_optional_adapters) {
+        strengths.push(`Optional client adapters detected: ${entry.adapter_overlay_clients.join(", ")}.`);
+        if (!entry.has_portability_notes) {
+            pushFinding(findings, "warn", "adapter_parity", "Adapter overlays exist, but portable parity guidance is not explicit in SKILL.md.");
+            score -= 5;
+        }
+    }
+    const status = findings.some((finding) => finding.severity === "fail")
+        ? "fail"
+        : findings.length > 0
+            ? "warn"
+            : "pass";
+    return {
+        adapter_clients: entry.adapter_overlay_clients,
+        findings,
+        name: entry.name,
+        score: clampScore(score),
+        source: entry.source,
+        status,
+        strengths,
+    };
+}
+function buildRolloutBacklog(summary) {
+    const backlog = [];
+    if (summary.skills_missing_validation_surface.length > 0) {
+        backlog.push(`Add validation/canary surfaces for ${summary.skills_missing_validation_surface.length} skills.`);
+    }
+    if (summary.skills_missing_portability_notes.length > 0) {
+        backlog.push(`Add vendor-neutral portability notes for ${summary.skills_missing_portability_notes.length} skills.`);
+    }
+    if (summary.progressive_disclosure_gaps.length > 0) {
+        backlog.push(`Split ${summary.progressive_disclosure_gaps.length} long skills into slimmer SKILL.md + references/ layouts.`);
+    }
+    if (summary.skills_missing_core_sections.length > 0) {
+        backlog.push(`Repair core contract sections for ${summary.skills_missing_core_sections.length} skills.`);
+    }
+    if (summary.skills_missing_use_cases.length > 0) {
+        backlog.push(`Add canonical use cases for ${summary.skills_missing_use_cases.length} skills.`);
+    }
+    return backlog;
+}
+export function auditSkillCatalog(entries = listSkillCatalogEntries()) {
+    const summary = summarizeSkillCatalog(entries);
+    return {
+        entries: entries
+            .map((entry) => auditSkillEntry(entry))
+            .sort((a, b) => {
+            if (a.status !== b.status) {
+                const rank = { fail: 0, warn: 1, pass: 2 };
+                return rank[a.status] - rank[b.status];
+            }
+            return a.name.localeCompare(b.name);
+        }),
+        generated_at: new Date().toISOString(),
+        rollout_backlog: buildRolloutBacklog(summary),
+        summary,
+    };
+}
+export function renderSkillAuditReport(result) {
+    const passCount = result.entries.filter((entry) => entry.status === "pass").length;
+    const warnCount = result.entries.filter((entry) => entry.status === "warn").length;
+    const failCount = result.entries.filter((entry) => entry.status === "fail").length;
+    const lines = [
+        "# SKILL_AUDIT_REPORT",
+        "",
+        `Generated: ${result.generated_at}`,
+        "",
+        "## Summary",
+        `- total skills: \`${result.summary.total_skills}\``,
+        `- portable-contract-ready skills: \`${result.summary.portable_contract_ready_skills}\``,
+        `- pass/warn/fail: \`${passCount}\` / \`${warnCount}\` / \`${failCount}\``,
+        `- skills with validation surface: \`${result.summary.with_validation_surface}\``,
+        `- skills with portability notes: \`${result.summary.with_portability_notes}\``,
+        `- skills with optional adapters: \`${result.summary.with_adapter_overlays}\``,
+        `- adapter clients observed: \`${result.summary.adapter_clients.length > 0 ? result.summary.adapter_clients.join(", ") : "none"}\``,
+        `- legacy openai overlays observed: \`${result.summary.with_openai_yaml}\``,
+        "",
+    ];
+    if (result.rollout_backlog.length > 0) {
+        lines.push("## Rollout Backlog");
+        lines.push(...result.rollout_backlog.map((item) => `- ${item}`));
+        lines.push("");
+    }
+    lines.push("## Per Skill");
+    for (const entry of result.entries) {
+        lines.push(`- \`${entry.name}\` (${entry.source}) — status=\`${entry.status}\`, score=\`${entry.score}\`, adapters=\`${entry.adapter_clients.length > 0 ? entry.adapter_clients.join(", ") : "none"}\``);
+        if (entry.findings.length > 0) {
+            lines.push(...entry.findings.map((finding) => `  - [${finding.severity}] ${finding.code}: ${finding.message}`));
+        }
+        else {
+            lines.push("  - no blocking findings");
+        }
+    }
+    return lines.join("\n");
+}
+export function writeSkillAuditReport(result, targetPath = "agent-state/SKILL_AUDIT_REPORT.md") {
+    return safeWrite(targetPath, renderSkillAuditReport(result));
+}
+//# sourceMappingURL=skill-auditor.js.map

package/dist/skill-auditor.js.map

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

package/dist/skill-catalog.d.ts

@@ -0,0 +1,60 @@
+import { type SkillReference } from "./helpers.js";
+export interface SkillAdapterOverlay {
+    client: string;
+    format: string;
+    path: string;
+    relative_path: string;
+}
+export interface SkillCatalogEntry extends SkillReference {
+    description: string;
+    headings: string[];
+    normalized_headings: string[];
+    line_count: number;
+    has_frontmatter: boolean;
+    has_openai_yaml: boolean;
+    openai_yaml_path?: string;
+    openai_metadata: Record<string, string>;
+    has_inputs_section: boolean;
+    has_workflow_section: boolean;
+    has_outputs_section: boolean;
+    has_failure_policy: boolean;
+    has_use_cases_section: boolean;
+    has_references_dir: boolean;
+    has_validation_surface: boolean;
+    has_portability_notes: boolean;
+    has_optional_adapters: boolean;
+    adapter_overlay_clients: string[];
+    adapter_overlays: SkillAdapterOverlay[];
+}
+export interface SkillCatalogSummary {
+    total_skills: number;
+    with_openai_yaml: number;
+    with_adapter_overlays: number;
+    adapter_clients: string[];
+    with_frontmatter: number;
+    trigger_aware_descriptions: number;
+    with_validation_surface: number;
+    with_portability_notes: number;
+    portable_contract_ready_skills: number;
+    long_skills: Array<{
+        name: string;
+        line_count: number;
+    }>;
+    skills_missing_core_sections: string[];
+    skills_missing_use_cases: string[];
+    skills_missing_validation_surface: string[];
+    skills_missing_portability_notes: string[];
+    progressive_disclosure_gaps: string[];
+}
+interface ParsedFrontmatter {
+    attributes: Record<string, string>;
+    body: string;
+    has_frontmatter: boolean;
+}
+export declare function parseSkillFrontmatter(raw: string): ParsedFrontmatter;
+export declare function readSkillCatalogEntry(skill: SkillReference): SkillCatalogEntry;
+export declare function listSkillCatalogEntries(): SkillCatalogEntry[];
+export declare function summarizeSkillCatalog(entries?: SkillCatalogEntry[]): SkillCatalogSummary;
+export declare function findSkillCatalogEntry(name: string, entries?: SkillCatalogEntry[]): SkillCatalogEntry | undefined;
+export {};
+//# sourceMappingURL=skill-catalog.d.ts.map

package/dist/skill-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-catalog.d.ts","sourceRoot":"","sources":["../src/skill-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sBAAsB,EAAE,OAAO,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B,EAAE,MAAM,CAAC;IACnC,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,8BAA8B,EAAE,MAAM,CAAC;IACvC,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,iCAAiC,EAAE,MAAM,EAAE,CAAC;IAC5C,gCAAgC,EAAE,MAAM,EAAE,CAAC;IAC3C,2BAA2B,EAAE,MAAM,EAAE,CAAC;CACvC;AAED,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,OAAO,CAAC;CAC1B;AAgCD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAmBpE;AA4HD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAoD9E;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,EAAE,CAE7D;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,iBAAiB,EAA8B,GACvD,mBAAmB,CA0DrB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAiB,EAA8B,GACvD,iBAAiB,GAAG,SAAS,CAG/B"}

package/dist/skill-catalog.js

@@ -0,0 +1,263 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { basename, dirname, extname, relative, resolve } from "node:path";
+import { ALL_MCP_CLIENTS, listAvailableSkills, } from "./helpers.js";
+function stripQuotes(value) {
+    return value.replace(/^["']+|["']+$/g, "").trim();
+}
+function parseSimpleYamlBlock(raw) {
+    const result = {};
+    const lines = raw.replace(/\r\n/g, "\n").split("\n");
+    let currentKey;
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        const keyMatch = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (keyMatch) {
+            currentKey = keyMatch[1];
+            result[currentKey] = stripQuotes(keyMatch[2] ?? "");
+            continue;
+        }
+        if (currentKey && /^[ \t]+/.test(line)) {
+            const nextValue = stripQuotes(line.trim());
+            result[currentKey] = result[currentKey]
+                ? `${result[currentKey]} ${nextValue}`.trim()
+                : nextValue;
+        }
+    }
+    return result;
+}
+export function parseSkillFrontmatter(raw) {
+    const normalized = raw.replace(/\r\n/g, "\n");
+    if (!normalized.startsWith("---\n")) {
+        return { attributes: {}, body: normalized, has_frontmatter: false };
+    }
+    const endIndex = normalized.indexOf("\n---\n", 4);
+    if (endIndex === -1) {
+        return { attributes: {}, body: normalized, has_frontmatter: false };
+    }
+    const frontmatter = normalized.slice(4, endIndex);
+    const body = normalized.slice(endIndex + 5);
+    return {
+        attributes: parseSimpleYamlBlock(frontmatter),
+        body,
+        has_frontmatter: true,
+    };
+}
+function extractHeadings(markdown) {
+    return [...markdown.matchAll(/^##\s+(.+)$/gm)].map((match) => match[1].trim());
+}
+function normalizeHeading(heading) {
+    return heading
+        .toLowerCase()
+        .replace(/[`*_]/g, "")
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+function hasHeading(headings, terms) {
+    return headings.some((heading) => terms.some((term) => heading.includes(term)));
+}
+function bodyMentionsAny(markdown, terms) {
+    const text = markdown.toLowerCase();
+    return terms.some((term) => text.includes(term));
+}
+function descriptionLooksTriggerAware(description) {
+    const text = description.toLowerCase();
+    return [
+        "when the user",
+        "use when",
+        "use this",
+        "trigger when",
+        "asks for",
+        "when a task",
+    ].some((term) => text.includes(term));
+}
+function hasValidationSurface(markdown, headings) {
+    return (hasHeading(headings, ["validation", "verify", "verification", "test", "tests", "canary"]) ||
+        bodyMentionsAny(markdown, [
+            "validation command",
+            "expected evidence",
+            "trigger canary",
+            "functional canary",
+            "baseline comparison",
+            "verify by",
+            "run this check",
+        ]));
+}
+function hasPortabilityNotes(markdown, headings) {
+    return (hasHeading(headings, [
+        "compatibility",
+        "portability",
+        "portable",
+        "cross platform",
+        "cross-platform",
+        "client adapters",
+        "adapter policy",
+    ]) ||
+        bodyMentionsAny(markdown, [
+            "portable source of truth",
+            "portable contract",
+            "portable skill",
+            "vendor-neutral",
+            "cross-platform",
+            "cross platform",
+            "client-specific",
+            "optional overlay",
+            "optional adapter",
+            "works without",
+        ]));
+}
+function resolveOpenAiYamlPath(skillPath) {
+    const agentsPath = resolve(dirname(skillPath), "agents", "openai.yaml");
+    return existsSync(agentsPath) ? agentsPath : undefined;
+}
+const KNOWN_ADAPTER_CLIENTS = [...ALL_MCP_CLIENTS, "openai", "vscode"];
+const ADAPTER_EXTENSIONS = new Set([".yaml", ".yml", ".json", ".jsonc", ".toml", ".md"]);
+function detectAdapterClient(relativePath) {
+    const lower = relativePath.toLowerCase();
+    for (const client of KNOWN_ADAPTER_CLIENTS) {
+        if (lower.includes(client))
+            return client;
+    }
+    const stem = basename(lower, extname(lower)).replace(/[^a-z0-9]+/g, "-");
+    return stem || "generic";
+}
+function listSkillAdapterOverlays(skillPath) {
+    const agentsRoot = resolve(dirname(skillPath), "agents");
+    if (!existsSync(agentsRoot))
+        return [];
+    const overlays = [];
+    const walk = (dirPath) => {
+        const entries = readdirSync(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith("."))
+                continue;
+            const absolutePath = resolve(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                walk(absolutePath);
+                continue;
+            }
+            const extension = extname(entry.name).toLowerCase();
+            const relativePath = relative(agentsRoot, absolutePath).replace(/\\/g, "/");
+            if (!ADAPTER_EXTENSIONS.has(extension))
+                continue;
+            if (relativePath.toLowerCase() === "readme.md")
+                continue;
+            overlays.push({
+                client: detectAdapterClient(relativePath),
+                format: extension.slice(1) || "unknown",
+                path: absolutePath,
+                relative_path: relativePath,
+            });
+        }
+    };
+    walk(agentsRoot);
+    return overlays.sort((a, b) => a.relative_path.localeCompare(b.relative_path));
+}
+export function readSkillCatalogEntry(skill) {
+    const raw = readFileSync(skill.path, "utf-8");
+    const parsed = parseSkillFrontmatter(raw);
+    const headings = extractHeadings(parsed.body);
+    const normalizedHeadings = headings.map(normalizeHeading);
+    const openaiYamlPath = resolveOpenAiYamlPath(skill.path);
+    const openaiMetadata = openaiYamlPath
+        ? parseSimpleYamlBlock(readFileSync(openaiYamlPath, "utf-8"))
+        : {};
+    const adapterOverlays = listSkillAdapterOverlays(skill.path);
+    const adapterOverlayClients = [...new Set(adapterOverlays.map((overlay) => overlay.client))];
+    return {
+        ...skill,
+        description: parsed.attributes.description?.trim() ?? "",
+        headings,
+        normalized_headings: normalizedHeadings,
+        line_count: raw.replace(/\r\n/g, "\n").split("\n").length,
+        has_frontmatter: parsed.has_frontmatter,
+        has_openai_yaml: Boolean(openaiYamlPath),
+        openai_yaml_path: openaiYamlPath,
+        openai_metadata: openaiMetadata,
+        has_inputs_section: hasHeading(normalizedHeadings, ["inputs", "input"]),
+        has_workflow_section: hasHeading(normalizedHeadings, [
+            "workflow",
+            "steps",
+            "process",
+            "procedure",
+        ]),
+        has_outputs_section: hasHeading(normalizedHeadings, [
+            "outputs",
+            "output",
+            "artifacts",
+            "resulting artifacts",
+        ]),
+        has_failure_policy: hasHeading(normalizedHeadings, [
+            "failure",
+            "troubleshooting",
+            "fallback",
+        ]),
+        has_use_cases_section: hasHeading(normalizedHeadings, [
+            "use cases",
+            "canonical use cases",
+            "examples",
+        ]),
+        has_references_dir: existsSync(resolve(dirname(skill.path), "references")),
+        has_validation_surface: hasValidationSurface(parsed.body, normalizedHeadings),
+        has_portability_notes: hasPortabilityNotes(parsed.body, normalizedHeadings),
+        has_optional_adapters: adapterOverlays.length > 0,
+        adapter_overlay_clients: adapterOverlayClients,
+        adapter_overlays: adapterOverlays,
+    };
+}
+export function listSkillCatalogEntries() {
+    return listAvailableSkills().map((skill) => readSkillCatalogEntry(skill));
+}
+export function summarizeSkillCatalog(entries = listSkillCatalogEntries()) {
+    const longSkills = entries
+        .filter((entry) => entry.line_count > 500)
+        .map((entry) => ({ name: entry.name, line_count: entry.line_count }));
+    const missingCoreSections = entries
+        .filter((entry) => !entry.has_inputs_section ||
+        !entry.has_workflow_section ||
+        !entry.has_outputs_section ||
+        !entry.has_failure_policy)
+        .map((entry) => entry.name);
+    const missingUseCases = entries
+        .filter((entry) => !entry.has_use_cases_section)
+        .map((entry) => entry.name);
+    const missingValidationSurface = entries
+        .filter((entry) => !entry.has_validation_surface)
+        .map((entry) => entry.name);
+    const missingPortabilityNotes = entries
+        .filter((entry) => !entry.has_portability_notes)
+        .map((entry) => entry.name);
+    const progressiveDisclosureGaps = entries
+        .filter((entry) => entry.line_count > 500 && !entry.has_references_dir)
+        .map((entry) => entry.name);
+    const adapterClients = [...new Set(entries.flatMap((entry) => entry.adapter_overlay_clients))].sort((a, b) => a.localeCompare(b));
+    const portableContractReadySkills = entries.filter((entry) => entry.has_frontmatter &&
+        descriptionLooksTriggerAware(entry.description) &&
+        entry.has_use_cases_section &&
+        entry.has_inputs_section &&
+        entry.has_workflow_section &&
+        entry.has_outputs_section &&
+        entry.has_failure_policy).length;
+    return {
+        total_skills: entries.length,
+        with_openai_yaml: entries.filter((entry) => entry.has_openai_yaml).length,
+        with_adapter_overlays: entries.filter((entry) => entry.has_optional_adapters).length,
+        adapter_clients: adapterClients,
+        with_frontmatter: entries.filter((entry) => entry.has_frontmatter).length,
+        trigger_aware_descriptions: entries.filter((entry) => descriptionLooksTriggerAware(entry.description)).length,
+        with_validation_surface: entries.filter((entry) => entry.has_validation_surface).length,
+        with_portability_notes: entries.filter((entry) => entry.has_portability_notes).length,
+        portable_contract_ready_skills: portableContractReadySkills,
+        long_skills: longSkills,
+        skills_missing_core_sections: missingCoreSections,
+        skills_missing_use_cases: missingUseCases,
+        skills_missing_validation_surface: missingValidationSurface,
+        skills_missing_portability_notes: missingPortabilityNotes,
+        progressive_disclosure_gaps: progressiveDisclosureGaps,
+    };
+}
+export function findSkillCatalogEntry(name, entries = listSkillCatalogEntries()) {
+    const target = name.trim().toLowerCase();
+    return entries.find((entry) => entry.name.toLowerCase() === target);
+}
+//# sourceMappingURL=skill-catalog.js.map

package/dist/skill-catalog.js.map

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

package/dist/status-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-events.d.ts","sourceRoot":"","sources":["../src/status-events.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,sBAAsB,qCAAqC,CAAC;AAIzE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjG,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAyBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,iBAAiB,CAAC;CAC1B,CAsCA;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAErD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,SAAM,GAAG,iBAAiB,EAAE,CAoBjE;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}
+{"version":3,"file":"status-events.d.ts","sourceRoot":"","sources":["../src/status-events.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,sBAAsB,qCAAqC,CAAC;AAKzE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjG,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAoED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,iBAAiB,CAAC;CAC1B,CAsCA;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAErD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,SAAM,GAAG,iBAAiB,EAAE,CAoBjE;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/status-events.js

@@ -1,12 +1,55 @@
 import { randomUUID } from "node:crypto";
-import { safeRead, safeWrite, wsPath, withFileLock } from "./helpers.js";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { resolveWorkspaceRoot } from "./helpers.js";
 import { isReadError } from "./shared.js";
 import { validateStatusEventPayload, PROVENANCE_CRITICAL_EVENT_TYPES } from "./schemas.js";
 export const STATUS_EVENTS_REL_PATH = "agent-state/STATUS_EVENTS.ndjson";
 const STATUS_EVENTS_ARCHIVE_REL = "agent-state/STATUS_EVENTS-archive.ndjson";
 const MAX_EVENT_LINES = 2000;
+const _fileLocks = new Map();
+function resolveWorkspaceArtifactPath(filePath) {
+    return resolve(resolveWorkspaceRoot(), filePath);
+}
+function safeReadWorkspaceFile(filePath) {
+    try {
+        const abs = resolveWorkspaceArtifactPath(filePath);
+        if (!existsSync(abs))
+            return `[FILE NOT FOUND] ${abs}`;
+        return readFileSync(abs, "utf-8");
+    }
+    catch (error) {
+        return `[ACCESS DENIED] ${String(error)}`;
+    }
+}
+function safeWriteWorkspaceFile(filePath, content) {
+    const abs = resolveWorkspaceArtifactPath(filePath);
+    mkdirSync(dirname(abs), { recursive: true });
+    const tmpPath = `${abs}.${process.pid}.${Date.now()}.tmp`;
+    writeFileSync(tmpPath, content, "utf-8");
+    renameSync(tmpPath, abs);
+    return abs;
+}
+async function withDynamicFileLock(path, fn) {
+    const key = resolveWorkspaceArtifactPath(path);
+    const prev = _fileLocks.get(key) ?? Promise.resolve();
+    let releaseLock;
+    const next = new Promise((resolveLock) => {
+        releaseLock = resolveLock;
+    });
+    _fileLocks.set(key, next);
+    await prev;
+    try {
+        return await fn();
+    }
+    finally {
+        releaseLock();
+        if (_fileLocks.get(key) === next)
+            _fileLocks.delete(key);
+    }
+}
 function readExistingNdjson() {
-    const existing = safeRead(STATUS_EVENTS_REL_PATH);
+    const existing = safeReadWorkspaceFile(STATUS_EVENTS_REL_PATH);
     if (isReadError(existing)) {
         return "";
     }
@@ -18,11 +61,11 @@ function rotateIfNeeded(content) {
         return content;
     const excess = lines.splice(0, lines.length - MAX_EVENT_LINES);
     const archiveContent = excess.join("\n") + "\n";
-    const existingArchive = safeRead(STATUS_EVENTS_ARCHIVE_REL);
+    const existingArchive = safeReadWorkspaceFile(STATUS_EVENTS_ARCHIVE_REL);
     const archiveFull = isReadError(existingArchive)
         ? archiveContent
         : existingArchive.trimEnd() + "\n" + archiveContent;
-    safeWrite(STATUS_EVENTS_ARCHIVE_REL, archiveFull);
+    safeWriteWorkspaceFile(STATUS_EVENTS_ARCHIVE_REL, archiveFull);
     return lines.join("\n") + "\n";
 }
 export function appendStatusEvent(input) {
@@ -56,7 +99,7 @@ export function appendStatusEvent(input) {
     const line = JSON.stringify(event);
     const combined = existing.length > 0 ? `${existing}\n${line}\n` : `${line}\n`;
     const next = rotateIfNeeded(combined);
-    const path = safeWrite(STATUS_EVENTS_REL_PATH, next);
+    const path = safeWriteWorkspaceFile(STATUS_EVENTS_REL_PATH, next);
     return { path, event };
 }
 /**
@@ -64,10 +107,10 @@ export function appendStatusEvent(input) {
  * Use this from async tool handlers where parallel subagents may fire.
  */
 export async function appendStatusEventSafe(input) {
-    return withFileLock(STATUS_EVENTS_REL_PATH, () => appendStatusEvent(input));
+    return withDynamicFileLock(STATUS_EVENTS_REL_PATH, () => appendStatusEvent(input));
 }
 export function readStatusEvents(limit = 100) {
-    const raw = safeRead(STATUS_EVENTS_REL_PATH);
+    const raw = safeReadWorkspaceFile(STATUS_EVENTS_REL_PATH);
     if (raw.startsWith("[FILE NOT FOUND]") || raw.startsWith("[ACCESS DENIED]")) {
         return [];
     }
@@ -88,6 +131,6 @@ export function readStatusEvents(limit = 100) {
     return parsed;
 }
 export function getStatusEventsPath() {
-    return wsPath(STATUS_EVENTS_REL_PATH);
+    return resolveWorkspaceArtifactPath(STATUS_EVENTS_REL_PATH);
 }
 //# sourceMappingURL=status-events.js.map