@xemahq/xema 0.12.0 → 0.14.0

package/dist/runtime/biome-scaffold.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiomeScaffoldNameError = exports.BiomeScaffoldExistsError = exports.DEFAULT_SCAFFOLD_TARGET = exports.DEFAULT_SCAFFOLD_SCOPE = exports.ScaffoldScope = exports.ScaffoldTarget = void 0;
+exports.scaffoldBiome = scaffoldBiome;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const biome_1 = require("@xemahq/kernel-contracts/biome");
+var ScaffoldTarget;
+(function (ScaffoldTarget) {
+    ScaffoldTarget["Server"] = "server";
+    ScaffoldTarget["Web"] = "web";
+})(ScaffoldTarget || (exports.ScaffoldTarget = ScaffoldTarget = {}));
+var ScaffoldScope;
+(function (ScaffoldScope) {
+    ScaffoldScope["Kernel"] = "kernel";
+    ScaffoldScope["System"] = "system";
+    ScaffoldScope["Base"] = "base";
+    ScaffoldScope["Platform"] = "platform";
+})(ScaffoldScope || (exports.ScaffoldScope = ScaffoldScope = {}));
+exports.DEFAULT_SCAFFOLD_SCOPE = ScaffoldScope.Platform;
+exports.DEFAULT_SCAFFOLD_TARGET = ScaffoldTarget.Server;
+const DEFAULT_PACKAGE_SCOPE = '@xema-biomes';
+const DEFAULT_ENGINE_RANGE = '^1.0.0';
+const BIOME_ID_RE = /^[a-z][a-z0-9-]*$/;
+class BiomeScaffoldExistsError extends Error {
+    biomeDir;
+    constructor(biomeDir) {
+        super(`Refusing to scaffold: "${biomeDir}" already exists. ` +
+            'Pick another name or remove the existing directory first.');
+        this.biomeDir = biomeDir;
+        this.name = 'BiomeScaffoldExistsError';
+    }
+}
+exports.BiomeScaffoldExistsError = BiomeScaffoldExistsError;
+class BiomeScaffoldNameError extends Error {
+    constructor(name) {
+        super(`Invalid biome name "${name}" — expected lowercase kebab-case ` +
+            '(a leading letter, then letters/digits/dashes), e.g. "acme-tickets".');
+        this.name = 'BiomeScaffoldNameError';
+    }
+}
+exports.BiomeScaffoldNameError = BiomeScaffoldNameError;
+function scaffoldBiome(options) {
+    const { name } = options;
+    if (!BIOME_ID_RE.test(name)) {
+        throw new BiomeScaffoldNameError(name);
+    }
+    const scope = options.scope ?? exports.DEFAULT_SCAFFOLD_SCOPE;
+    const target = options.target ?? exports.DEFAULT_SCAFFOLD_TARGET;
+    const parentDir = (0, node_path_1.resolve)(options.dir ?? process.cwd());
+    const biomeDir = (0, node_path_1.join)(parentDir, name);
+    if ((0, node_fs_1.existsSync)(biomeDir)) {
+        throw new BiomeScaffoldExistsError(biomeDir);
+    }
+    const displayName = humanizeBiomeName(name);
+    const description = options.description !== undefined && options.description.length > 0
+        ? options.description
+        : `${displayName} — a Xema biome.`;
+    const manifestObject = buildManifestObject({ name, displayName, description, scope, target });
+    const manifestJson = `${JSON.stringify(manifestObject, null, 2)}\n`;
+    const files = [];
+    const write = (relativePath, contents) => {
+        const absolute = (0, node_path_1.join)(biomeDir, relativePath);
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(absolute), { recursive: true });
+        (0, node_fs_1.writeFileSync)(absolute, contents, 'utf8');
+        files.push(relativePath);
+    };
+    write(biome_1.BIOME_MANIFEST_FILENAME, manifestJson);
+    write('README.md', renderReadme({ name, displayName, description, target }));
+    write((0, node_path_1.join)('skills', 'hello', 'SKILL.md'), renderSampleSkill(displayName));
+    if (target === ScaffoldTarget.Server) {
+        write((0, node_path_1.join)('api', name, 'README.md'), renderServiceReadme(name, displayName));
+        write((0, node_path_1.join)('api', name, 'index.ts'), renderServicePlaceholder(name));
+    }
+    else {
+        write((0, node_path_1.join)('web', 'README.md'), renderWebReadme(displayName));
+    }
+    const manifestPath = (0, node_path_1.join)(biomeDir, biome_1.BIOME_MANIFEST_FILENAME);
+    const manifest = (0, biome_1.parseBiomeManifest)(JSON.parse((0, node_fs_1.readFileSync)(manifestPath, 'utf8')));
+    return { biomeDir, manifestPath, files, manifest };
+}
+function buildManifestObject(input) {
+    const xemaBase = {
+        id: input.name,
+        displayName: input.displayName,
+        description: input.description,
+        scope: input.scope,
+        target: input.target,
+        engines: { xema: DEFAULT_ENGINE_RANGE },
+        requiresCapabilities: [],
+        exposesCapabilities: [],
+    };
+    const xema = input.target === ScaffoldTarget.Server
+        ? {
+            ...xemaBase,
+            ships: {
+                apis: [{ name: input.name, path: `./api/${input.name}` }],
+            },
+        }
+        : xemaBase;
+    return {
+        name: `${DEFAULT_PACKAGE_SCOPE}/${input.name}`,
+        version: '0.1.0',
+        xema,
+    };
+}
+function humanizeBiomeName(name) {
+    return name
+        .split('-')
+        .filter((part) => part.length > 0)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(' ');
+}
+function renderReadme(input) {
+    const structure = input.target === ScaffoldTarget.Server
+        ? `- \`xema-biome.json\` — the biome manifest (identity + what it ships).\n` +
+            `- \`api/${input.name}/\` — the biome's server (NestJS) service placeholder.\n` +
+            `- \`skills/\` — Skill bundles this biome ships (one folder per skill).`
+        : `- \`xema-biome.json\` — the biome manifest (identity + what it ships).\n` +
+            `- \`web/\` — the biome's web surface placeholder.\n` +
+            `- \`skills/\` — Skill bundles this biome ships (one folder per skill).`;
+    return (`# ${input.displayName}\n\n` +
+        `${input.description}\n\n` +
+        `## Structure\n\n${structure}\n\n` +
+        `## Publish\n\n` +
+        `\`\`\`sh\nxema biome publish . --registry <host> --dry-run\n\`\`\`\n`);
+}
+function renderSampleSkill(displayName) {
+    return (`---\n` +
+        `name: hello\n` +
+        `description: A sample skill shipped by the ${displayName} biome. Replace this with a real skill.\n` +
+        `---\n\n` +
+        `# hello\n\n` +
+        `This is a placeholder Skill bundle. \`SKILL.md\` is the only required file; ` +
+        `add \`reference/\`, \`scripts/\`, or \`assets/\` alongside it as needed.\n`);
+}
+function renderServiceReadme(name, displayName) {
+    return (`# ${displayName} API\n\n` +
+        `Server (NestJS) service placeholder for the \`${name}\` biome. The manifest's ` +
+        `\`ships.apis[].path\` points here (\`./api/${name}\`). Replace this placeholder ` +
+        `with a real service tree before publishing a runnable biome.\n`);
+}
+function renderServicePlaceholder(name) {
+    return (`// Placeholder entrypoint for the "${name}" biome API service.\n` +
+        `// Replace with a real NestJS bootstrap (see @xemahq/biome-api-sdk).\n\n` +
+        `export const BIOME_ID = '${name}';\n`);
+}
+function renderWebReadme(displayName) {
+    return (`# ${displayName} Web\n\n` +
+        `Web surface placeholder for the ${displayName} biome. Replace with a real ` +
+        `web bundle (see the host-shell web-biome framework).\n`);
+}
+//# sourceMappingURL=biome-scaffold.js.map

package/dist/runtime/biome-scaffold.js.map

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

package/dist/runtime/biome-validate.d.ts

@@ -0,0 +1,28 @@
+import { type BiomeManifest } from '@xemahq/kernel-contracts/biome';
+export declare enum BiomeDevCheck {
+    Manifest = "manifest",
+    Agents = "agents",
+    Contributions = "contributions",
+    Skills = "skills",
+    Workflows = "workflows"
+}
+export declare enum BiomeCheckStatus {
+    Passed = "passed",
+    Failed = "failed",
+    Skipped = "skipped"
+}
+export interface BiomeCheckResult {
+    readonly check: BiomeDevCheck;
+    readonly status: BiomeCheckStatus;
+    readonly summary: string;
+    readonly issues: readonly string[];
+}
+export interface BiomeValidationReport {
+    readonly biomeRoot: string;
+    readonly manifest?: BiomeManifest;
+    readonly results: readonly BiomeCheckResult[];
+    readonly passed: boolean;
+    readonly contributionCounts: ReadonlyMap<string, number>;
+}
+export declare function validateBiomeDir(biomeRoot: string): BiomeValidationReport;
+//# sourceMappingURL=biome-validate.d.ts.map

package/dist/runtime/biome-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-validate.d.ts","sourceRoot":"","sources":["../../src/runtime/biome-validate.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AAyCxC,oBAAY,aAAa;IACvB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,aAAa,kBAAkB;IAC/B,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAGD,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,MAAM,WAAW;IAEjB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAElC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE9C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1D;AAuBD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,CAqCzE"}

package/dist/runtime/biome-validate.js

@@ -0,0 +1,450 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiomeCheckStatus = exports.BiomeDevCheck = void 0;
+exports.validateBiomeDir = validateBiomeDir;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const workflow_1 = require("@xemahq/dsl/workflow");
+const biome_1 = require("@xemahq/kernel-contracts/biome");
+const capability_1 = require("@xemahq/kernel-contracts/capability");
+const connector_1 = require("@xemahq/kernel-contracts/connector");
+const contribution_1 = require("@xemahq/kernel-contracts/contribution");
+const resource_1 = require("@xemahq/kernel-contracts/resource");
+const widget_1 = require("@xemahq/kernel-contracts/widget");
+var BiomeDevCheck;
+(function (BiomeDevCheck) {
+    BiomeDevCheck["Manifest"] = "manifest";
+    BiomeDevCheck["Agents"] = "agents";
+    BiomeDevCheck["Contributions"] = "contributions";
+    BiomeDevCheck["Skills"] = "skills";
+    BiomeDevCheck["Workflows"] = "workflows";
+})(BiomeDevCheck || (exports.BiomeDevCheck = BiomeDevCheck = {}));
+var BiomeCheckStatus;
+(function (BiomeCheckStatus) {
+    BiomeCheckStatus["Passed"] = "passed";
+    BiomeCheckStatus["Failed"] = "failed";
+    BiomeCheckStatus["Skipped"] = "skipped";
+})(BiomeCheckStatus || (exports.BiomeCheckStatus = BiomeCheckStatus = {}));
+const KIND_MANIFEST_SCHEMAS = new Map([
+    [contribution_1.ContributionKind.Capability, capability_1.CapabilityContributionManifestSchema],
+    [contribution_1.ContributionKind.ConnectorAdapter, connector_1.ConnectorAdapterContributionManifestSchema],
+    [contribution_1.ContributionKind.ResourceOwnership, resource_1.ResourceOwnershipContributionManifestSchema],
+    [contribution_1.ContributionKind.WidgetKind, widget_1.WidgetContributionManifestSchema],
+]);
+const CONTRIBUTION_FILE_SUFFIX = '.contribution.json';
+const WORKFLOW_EXTENSIONS = ['.yaml', '.yml'];
+function validateBiomeDir(biomeRoot) {
+    const results = [];
+    const contributionCounts = new Map();
+    const manifestOutcome = checkManifest(biomeRoot);
+    results.push(manifestOutcome.result);
+    const manifest = manifestOutcome.manifest;
+    if (manifest === undefined) {
+        for (const check of [
+            BiomeDevCheck.Agents,
+            BiomeDevCheck.Contributions,
+            BiomeDevCheck.Skills,
+            BiomeDevCheck.Workflows,
+        ]) {
+            results.push({
+                check,
+                status: BiomeCheckStatus.Skipped,
+                summary: 'skipped — manifest failed to parse',
+                issues: [],
+            });
+        }
+    }
+    else {
+        results.push(checkAgents(biomeRoot, manifest));
+        results.push(checkContributions(biomeRoot, manifest, contributionCounts));
+        results.push(checkSkills(biomeRoot));
+        results.push(checkWorkflows(biomeRoot));
+    }
+    return {
+        biomeRoot,
+        ...(manifest !== undefined ? { manifest } : {}),
+        results,
+        passed: results.every((r) => r.status !== BiomeCheckStatus.Failed),
+        contributionCounts,
+    };
+}
+function checkManifest(biomeRoot) {
+    const manifestPath = (0, node_path_1.join)(biomeRoot, biome_1.BIOME_MANIFEST_FILENAME);
+    let manifest;
+    try {
+        manifest = (0, biome_1.parseBiomeManifest)(JSON.parse((0, node_fs_1.readFileSync)(manifestPath, 'utf8')));
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        return {
+            result: {
+                check: BiomeDevCheck.Manifest,
+                status: BiomeCheckStatus.Failed,
+                summary: `${biome_1.BIOME_MANIFEST_FILENAME} is invalid`,
+                issues: [`${manifestPath}: ${detail}`],
+            },
+        };
+    }
+    const services = manifest.xema.target === 'server' ? (manifest.xema.ships?.apis ?? []).length : 0;
+    return {
+        result: {
+            check: BiomeDevCheck.Manifest,
+            status: BiomeCheckStatus.Passed,
+            summary: `"${manifest.xema.id}" v${manifest.version} (${manifest.xema.scope}, ` +
+                `${manifest.xema.target}${services > 0 ? `, ${String(services)} service(s)` : ''})`,
+            issues: [],
+        },
+        manifest,
+    };
+}
+function checkAgents(biomeRoot, manifest) {
+    if (manifest.xema.target !== 'server') {
+        return {
+            check: BiomeDevCheck.Agents,
+            status: BiomeCheckStatus.Skipped,
+            summary: 'skipped — web biomes ship no agents',
+            issues: [],
+        };
+    }
+    const declared = manifest.xema.agents ?? [];
+    const agentsDir = (0, node_path_1.join)(biomeRoot, (0, biome_1.contentKindToDir)('agents'));
+    const dirExists = (0, node_fs_1.existsSync)(agentsDir);
+    if (!dirExists) {
+        if (declared.length > 0) {
+            return {
+                check: BiomeDevCheck.Agents,
+                status: BiomeCheckStatus.Failed,
+                summary: 'agents[] declared but agents/ does not exist',
+                issues: [
+                    `agents[] declares ${String(declared.length)} agent(s) but ${agentsDir} does not ` +
+                        `exist — create agents/<slug>.md for each, or remove the agents[] block`,
+                ],
+            };
+        }
+        return {
+            check: BiomeDevCheck.Agents,
+            status: BiomeCheckStatus.Skipped,
+            summary: 'skipped — no agents/ directory',
+            issues: [],
+        };
+    }
+    const issues = [];
+    const onDiskSlugs = new Set();
+    for (const entry of (0, node_fs_1.readdirSync)(agentsDir)) {
+        if (entry.startsWith('.') || !entry.endsWith('.md')) {
+            continue;
+        }
+        if ((0, node_fs_1.statSync)((0, node_path_1.join)(agentsDir, entry)).isFile()) {
+            onDiskSlugs.add(entry.slice(0, -'.md'.length));
+        }
+    }
+    const declaredSlugs = new Set(declared.map((d) => d.slug));
+    for (const decl of declared) {
+        if (!onDiskSlugs.has(decl.slug)) {
+            issues.push(`declared agents[].slug="${decl.slug}" has no matching file at agents/${decl.slug}.md`);
+        }
+    }
+    for (const slug of onDiskSlugs) {
+        if (!declaredSlugs.has(slug)) {
+            issues.push(`agents/${slug}.md exists on disk but is not declared under agents[] — ` +
+                `add { "slug": "${slug}", "mode": "primary" | "subagent" }`);
+        }
+    }
+    for (const decl of declared) {
+        if (!onDiskSlugs.has(decl.slug)) {
+            continue;
+        }
+        const filePath = (0, node_path_1.join)(agentsDir, `${decl.slug}.md`);
+        const fm = readFrontmatter((0, node_fs_1.readFileSync)(filePath, 'utf8'));
+        if (fm === null) {
+            issues.push(`agents/${decl.slug}.md is missing YAML frontmatter (every agent .md must have one)`);
+            continue;
+        }
+        const mode = fm.get('mode');
+        if (mode === undefined) {
+            if (decl.mode !== 'primary') {
+                issues.push(`agents/${decl.slug}.md frontmatter has no "mode:" (treated as primary) but the ` +
+                    `manifest declares mode="${decl.mode}" — add "mode: ${decl.mode}" to the frontmatter`);
+            }
+        }
+        else if (mode !== decl.mode) {
+            issues.push(`agents/${decl.slug}.md frontmatter mode="${mode}" does not match manifest mode="${decl.mode}"`);
+        }
+        const descriptionIssue = validateAgentDescription(decl.slug, fm.get('description'));
+        if (descriptionIssue !== null) {
+            issues.push(descriptionIssue);
+        }
+    }
+    if (issues.length > 0) {
+        return {
+            check: BiomeDevCheck.Agents,
+            status: BiomeCheckStatus.Failed,
+            summary: `agent declaration parity failed (${String(issues.length)} issue(s))`,
+            issues,
+        };
+    }
+    return {
+        check: BiomeDevCheck.Agents,
+        status: BiomeCheckStatus.Passed,
+        summary: `${String(declared.length)} declared = ${String(onDiskSlugs.size)} on disk (mode parity OK)`,
+        issues: [],
+    };
+}
+const DESCRIPTION_MIN_LENGTH = 40;
+const BANNED_DESCRIPTION_OPENERS = [
+    /^\s*agent\s+(that|for|which|to)\b/i,
+    /^\s*an\s+agent\b/i,
+    /^\s*this\s+agent\b/i,
+];
+function validateAgentDescription(slug, description) {
+    if (description === undefined) {
+        return (`agents/${slug}.md frontmatter is missing "description:" — opencode's task tool uses it ` +
+            `as the "when to use" surface for delegate routing`);
+    }
+    const trimmed = description.trim();
+    if (trimmed.length < DESCRIPTION_MIN_LENGTH) {
+        return (`agents/${slug}.md description is too short (${String(trimmed.length)} chars, min ` +
+            `${String(DESCRIPTION_MIN_LENGTH)}) — describe the situation to delegate in, not a label`);
+    }
+    for (const banned of BANNED_DESCRIPTION_OPENERS) {
+        if (banned.test(trimmed)) {
+            return (`agents/${slug}.md description starts with "Agent that…"-style boilerplate — ` +
+                `lead with the situation/output instead`);
+        }
+    }
+    return null;
+}
+function checkContributions(biomeRoot, manifest, counts) {
+    const issues = [];
+    const knownKinds = new Set(Object.values(contribution_1.ContributionKind));
+    let deepValidated = 0;
+    let shapeOnly = 0;
+    const validateEntry = (kind, rawManifest, sourceRef) => {
+        counts.set(kind, (counts.get(kind) ?? 0) + 1);
+        const schema = KIND_MANIFEST_SCHEMAS.get(kind);
+        if (schema === undefined) {
+            shapeOnly += 1;
+            return;
+        }
+        const parsed = schema.safeParse(rawManifest);
+        if (!parsed.success) {
+            issues.push(`${sourceRef}: invalid ${kind} contribution manifest — ` +
+                parsed.error.issues
+                    .map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`)
+                    .join('; '));
+            return;
+        }
+        deepValidated += 1;
+    };
+    const dirName = manifest.xema.contributions?.directory ?? 'contributions';
+    const contribDir = (0, node_path_1.join)(biomeRoot, dirName);
+    if ((0, node_fs_1.existsSync)(contribDir) && (0, node_fs_1.statSync)(contribDir).isDirectory()) {
+        for (const file of (0, node_fs_1.readdirSync)(contribDir).sort()) {
+            if (!file.endsWith(CONTRIBUTION_FILE_SUFFIX)) {
+                continue;
+            }
+            const filePath = (0, node_path_1.join)(contribDir, file);
+            const fileRef = (0, node_path_1.join)(dirName, file);
+            const kindFromName = [...knownKinds].find((k) => file.endsWith(`.${k}${CONTRIBUTION_FILE_SUFFIX}`));
+            if (kindFromName === undefined) {
+                issues.push(`${fileRef}: filename does not end in a known \`.<kind>${CONTRIBUTION_FILE_SUFFIX}\` — ` +
+                    `no contribution parser would ingest it. Known kinds: ${[...knownKinds].sort().join(', ')}.`);
+                continue;
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse((0, node_fs_1.readFileSync)(filePath, 'utf8'));
+            }
+            catch (err) {
+                issues.push(`${fileRef}: not valid JSON — ${err instanceof Error ? err.message : String(err)}`);
+                continue;
+            }
+            if (parsed.kind !== kindFromName) {
+                issues.push(`${fileRef}: \`kind\` must be "${kindFromName}" (the file suffix says so) — ` +
+                    `got "${String(parsed.kind)}".`);
+                continue;
+            }
+            validateEntry(kindFromName, parsed.manifest, fileRef);
+        }
+    }
+    for (const entry of manifest.xema.contributions?.inline ?? []) {
+        validateEntry(entry.kind, entry.manifest, `${biome_1.BIOME_MANIFEST_FILENAME}#xema.contributions.inline[id=${entry.id}]`);
+    }
+    const total = [...counts.values()].reduce((a, b) => a + b, 0);
+    if (issues.length > 0) {
+        return {
+            check: BiomeDevCheck.Contributions,
+            status: BiomeCheckStatus.Failed,
+            summary: `${String(issues.length)} invalid contribution(s) of ${String(total)}`,
+            issues,
+        };
+    }
+    if (total === 0) {
+        return {
+            check: BiomeDevCheck.Contributions,
+            status: BiomeCheckStatus.Skipped,
+            summary: 'skipped — no contribution entries',
+            issues: [],
+        };
+    }
+    const byKind = [...counts.entries()].map(([k, n]) => `${k} ×${String(n)}`).join(', ');
+    return {
+        check: BiomeDevCheck.Contributions,
+        status: BiomeCheckStatus.Passed,
+        summary: `${String(total)} entr${total === 1 ? 'y' : 'ies'} (${byKind})` +
+            (shapeOnly > 0
+                ? ` — ${String(deepValidated)} schema-validated, ${String(shapeOnly)} envelope-only ` +
+                    `(kind schema owned by the ingesting service)`
+                : ''),
+        issues: [],
+    };
+}
+function checkSkills(biomeRoot) {
+    const skillsDir = (0, node_path_1.join)(biomeRoot, (0, biome_1.contentKindToDir)('openCodeSkills'));
+    if (!(0, node_fs_1.existsSync)(skillsDir) || !(0, node_fs_1.statSync)(skillsDir).isDirectory()) {
+        return {
+            check: BiomeDevCheck.Skills,
+            status: BiomeCheckStatus.Skipped,
+            summary: 'skipped — no skills/ directory',
+            issues: [],
+        };
+    }
+    const skillFiles = [];
+    collectFilesNamed(skillsDir, 'SKILL.md', skillFiles);
+    if (skillFiles.length === 0) {
+        return {
+            check: BiomeDevCheck.Skills,
+            status: BiomeCheckStatus.Skipped,
+            summary: 'skipped — skills/ has no SKILL.md bundles',
+            issues: [],
+        };
+    }
+    const issues = [];
+    for (const file of skillFiles.sort()) {
+        const ref = (0, node_path_1.relative)(biomeRoot, file);
+        const fm = readFrontmatter((0, node_fs_1.readFileSync)(file, 'utf8'));
+        if (fm === null) {
+            issues.push(`${ref}: missing YAML frontmatter (SKILL.md requires \`name\` + \`description\`)`);
+            continue;
+        }
+        for (const field of ['name', 'description']) {
+            const value = fm.get(field);
+            if (value === undefined || value.trim().length === 0) {
+                issues.push(`${ref}: frontmatter is missing required \`${field}\``);
+            }
+        }
+    }
+    if (issues.length > 0) {
+        return {
+            check: BiomeDevCheck.Skills,
+            status: BiomeCheckStatus.Failed,
+            summary: `${String(issues.length)} skill bundle issue(s)`,
+            issues,
+        };
+    }
+    return {
+        check: BiomeDevCheck.Skills,
+        status: BiomeCheckStatus.Passed,
+        summary: `${String(skillFiles.length)} skill bundle(s) (frontmatter OK)`,
+        issues: [],
+    };
+}
+function checkWorkflows(biomeRoot) {
+    const workflowsDir = (0, node_path_1.join)(biomeRoot, (0, biome_1.contentKindToDir)('workflowConfig'), 'workflows');
+    if (!(0, node_fs_1.existsSync)(workflowsDir) || !(0, node_fs_1.statSync)(workflowsDir).isDirectory()) {
+        return {
+            check: BiomeDevCheck.Workflows,
+            status: BiomeCheckStatus.Skipped,
+            summary: 'skipped — no workflow-config/workflows/ directory',
+            issues: [],
+        };
+    }
+    const issues = [];
+    let count = 0;
+    const validateDir = (dir, reusable) => {
+        for (const file of (0, node_fs_1.readdirSync)(dir).sort()) {
+            const path = (0, node_path_1.join)(dir, file);
+            if (!(0, node_fs_1.statSync)(path).isFile() || !WORKFLOW_EXTENSIONS.some((ext) => file.endsWith(ext))) {
+                continue;
+            }
+            count += 1;
+            try {
+                const raw = (0, node_fs_1.readFileSync)(path, 'utf8');
+                if (reusable) {
+                    (0, workflow_1.parseAndValidateReusableWorkflowYaml)(raw);
+                }
+                else {
+                    (0, workflow_1.parseAndValidateWorkflowYaml)(raw);
+                }
+            }
+            catch (err) {
+                const detail = err instanceof Error ? err.message : String(err);
+                issues.push(`${(0, node_path_1.relative)(biomeRoot, path)}: ${detail}`);
+            }
+        }
+    };
+    validateDir(workflowsDir, false);
+    const reusableDir = (0, node_path_1.join)(workflowsDir, 'reusable');
+    if ((0, node_fs_1.existsSync)(reusableDir) && (0, node_fs_1.statSync)(reusableDir).isDirectory()) {
+        validateDir(reusableDir, true);
+    }
+    if (issues.length > 0) {
+        return {
+            check: BiomeDevCheck.Workflows,
+            status: BiomeCheckStatus.Failed,
+            summary: `${String(issues.length)} of ${String(count)} workflow(s) failed schema validation`,
+            issues,
+        };
+    }
+    if (count === 0) {
+        return {
+            check: BiomeDevCheck.Workflows,
+            status: BiomeCheckStatus.Skipped,
+            summary: 'skipped — workflows/ has no YAML documents',
+            issues: [],
+        };
+    }
+    return {
+        check: BiomeDevCheck.Workflows,
+        status: BiomeCheckStatus.Passed,
+        summary: `${String(count)} workflow(s) validated against the DSL schema`,
+        issues: [],
+    };
+}
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
+function readFrontmatter(raw) {
+    const match = FRONTMATTER_RE.exec(raw);
+    if (!match) {
+        return null;
+    }
+    const out = new Map();
+    for (const line of (match[1] ?? '').split(/\r?\n/)) {
+        const kv = /^\s*([A-Za-z][A-Za-z0-9_-]*)\s*:\s*(.*?)\s*$/.exec(line);
+        if (!kv) {
+            continue;
+        }
+        const key = kv[1];
+        let value = kv[2] ?? '';
+        const quote = value[0];
+        if (value.length >= 2 && (quote === '"' || quote === "'") && value.endsWith(quote)) {
+            value = value.slice(1, -1);
+        }
+        out.set(key, value);
+    }
+    return out;
+}
+function collectFilesNamed(dir, basename, out) {
+    for (const entry of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })) {
+        if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+            continue;
+        }
+        const path = (0, node_path_1.join)(dir, entry.name);
+        if (entry.isDirectory()) {
+            collectFilesNamed(path, basename, out);
+        }
+        else if (entry.isFile() && entry.name === basename) {
+            out.push(path);
+        }
+    }
+}
+//# sourceMappingURL=biome-validate.js.map