@xemahq/xema 0.13.0 → 0.15.0

package/dist/runtime/biome-publish.js

@@ -0,0 +1,278 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingRuntimeToolError = exports.BiomePublishConfigError = exports.COSIGN_KEY_ENV = exports.BIOME_ARTIFACT_TYPE = void 0;
+exports.publishBiome = publishBiome;
+exports.attestArgsWithPredicate = attestArgsWithPredicate;
+exports.loadManifest = loadManifest;
+exports.buildOrasArgs = buildOrasArgs;
+exports.collectBiomeFiles = collectBiomeFiles;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const biome_1 = require("@xemahq/kernel-contracts/biome");
+const biome_provenance_1 = require("./biome-provenance");
+const loader_1 = require("./config/loader");
+const credentials_1 = require("./sources/credentials");
+const schema_1 = require("./sources/schema");
+exports.BIOME_ARTIFACT_TYPE = 'application/vnd.xema.biome.manifest.v1+json';
+exports.COSIGN_KEY_ENV = 'COSIGN_KEY';
+const EXCLUDE_DIRS = new Set([
+    'node_modules',
+    '.git',
+    '.turbo',
+    '.cache',
+    'coverage',
+    '.nyc_output',
+]);
+const EXCLUDE_FILES = new Set(['.DS_Store']);
+const DEFAULT_OCI_USERNAME = 'token';
+class BiomePublishConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BiomePublishConfigError';
+    }
+}
+exports.BiomePublishConfigError = BiomePublishConfigError;
+class MissingRuntimeToolError extends Error {
+    tool;
+    constructor(tool, message) {
+        super(message);
+        this.tool = tool;
+        this.name = 'MissingRuntimeToolError';
+    }
+}
+exports.MissingRuntimeToolError = MissingRuntimeToolError;
+function publishBiome(options) {
+    const biomeDir = (0, node_path_1.resolve)(options.path);
+    const manifest = loadManifest(biomeDir);
+    const biomeId = manifest.xema.id;
+    const version = manifest.version;
+    const tag = options.tag !== undefined && options.tag.length > 0 ? options.tag : version;
+    const credentials = new credentials_1.CredentialResolver();
+    const auth = resolveRegistryAndToken(options, credentials);
+    const ociRef = `${auth.registry.replace(/\/+$/, '')}/${biomeId}:${tag}`;
+    const files = collectBiomeFiles(biomeDir);
+    if (files.length === 0) {
+        throw new BiomePublishConfigError(`Biome at ${biomeDir} has no files to publish.`);
+    }
+    const username = options.username ?? DEFAULT_OCI_USERNAME;
+    const orasArgs = buildOrasArgs({
+        ociRef,
+        biomeId,
+        version,
+        files,
+        hasToken: auth.tokenEnv !== undefined,
+        username,
+    });
+    const cosignKey = process.env[exports.COSIGN_KEY_ENV];
+    const cosignArgs = buildCosignArgs(ociRef, cosignKey);
+    const cosignAttestArgs = buildCosignAttestArgs(ociRef, cosignKey);
+    const plan = {
+        biomeId,
+        version,
+        registry: auth.registry,
+        tag,
+        ociRef,
+        files,
+        orasArgs,
+        cosignArgs,
+        cosignAttestArgs,
+        ...(auth.tokenEnv !== undefined ? { tokenEnv: auth.tokenEnv } : {}),
+        tokenPresent: credentials.has(auth.tokenEnv),
+        cosignKeyResolved: cosignKey !== undefined && cosignKey.length > 0,
+    };
+    if (options.dryRun === true) {
+        printPlan(plan, biomeDir, username);
+        return plan;
+    }
+    ensureToolInstalled('oras');
+    ensureToolInstalled('cosign');
+    if (!plan.cosignKeyResolved) {
+        throw new BiomePublishConfigError(`${exports.COSIGN_KEY_ENV} is not set — a published biome MUST be cosign-signed AND carry a ` +
+            'SLSA provenance attestation (the fetcher refuses artifacts missing either). ' +
+            'Set COSIGN_KEY to your cosign private key ref.');
+    }
+    const token = auth.tokenEnv !== undefined ? credentials.resolve(auth.tokenEnv, auth.sourceName) : undefined;
+    const startedOn = new Date().toISOString();
+    runTool('oras', orasArgs, biomeDir, token);
+    runTool('cosign', cosignArgs, biomeDir, undefined);
+    attestProvenance({ plan, biomeDir, startedOn });
+    console.log(`Published, signed and attested ${ociRef}.`);
+    return plan;
+}
+function attestProvenance(input) {
+    const predicate = (0, biome_provenance_1.buildProvenancePredicate)({
+        biomeId: input.plan.biomeId,
+        version: input.plan.version,
+        tag: input.plan.tag,
+        ociRef: input.plan.ociRef,
+        biomeDir: input.biomeDir,
+        files: input.plan.files,
+        builder: (0, biome_provenance_1.resolveBuilder)(process.env),
+        startedOn: input.startedOn,
+        finishedOn: new Date().toISOString(),
+    });
+    const workDir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'xema-biome-provenance-'));
+    const predicatePath = (0, node_path_1.join)(workDir, 'slsa-provenance.json');
+    try {
+        (0, node_fs_1.writeFileSync)(predicatePath, `${JSON.stringify(predicate, null, 2)}\n`, {
+            mode: 0o600,
+        });
+        runTool('cosign', attestArgsWithPredicate(input.plan.cosignAttestArgs, predicatePath), input.biomeDir, undefined);
+    }
+    finally {
+        (0, node_fs_1.rmSync)(workDir, { recursive: true, force: true });
+    }
+}
+function attestArgsWithPredicate(attestArgs, predicatePath) {
+    return [...attestArgs, '--predicate', predicatePath];
+}
+function loadManifest(biomeDir) {
+    if (!(0, node_fs_1.existsSync)(biomeDir) || !(0, node_fs_1.statSync)(biomeDir).isDirectory()) {
+        throw new BiomePublishConfigError(`Biome path is not a directory: ${biomeDir}`);
+    }
+    const manifestPath = (0, node_path_1.join)(biomeDir, biome_1.BIOME_MANIFEST_FILENAME);
+    if (!(0, node_fs_1.existsSync)(manifestPath)) {
+        throw new BiomePublishConfigError(`No ${biome_1.BIOME_MANIFEST_FILENAME} at ${biomeDir} — is this a biome directory?`);
+    }
+    return (0, biome_1.parseBiomeManifest)(JSON.parse((0, node_fs_1.readFileSync)(manifestPath, 'utf8')));
+}
+function resolveRegistryAndToken(options, _credentials) {
+    if (options.registry !== undefined && options.registry.length > 0) {
+        return {
+            registry: options.registry,
+            ...(options.tokenEnv !== undefined ? { tokenEnv: options.tokenEnv } : {}),
+            sourceName: '--registry',
+        };
+    }
+    const { config } = (0, loader_1.loadXemaConfig)({ explicit: options.configPath });
+    const ociSources = config.sources.filter((s) => s.kind === schema_1.SourceKind.Oci);
+    if (ociSources.length === 0) {
+        throw new BiomePublishConfigError('No target registry: pass --registry <host>, or add an `oci` source to your ' +
+            'xema.config.yaml (`xema source add ...`).');
+    }
+    let chosen;
+    if (options.source !== undefined) {
+        const match = ociSources.find((s) => s.name === options.source);
+        if (match === undefined) {
+            throw new BiomePublishConfigError(`No oci source named "${options.source}". Configured oci sources: ` +
+                `${ociSources.map((s) => s.name).join(', ')}.`);
+        }
+        chosen = match;
+    }
+    else if (ociSources.length === 1) {
+        chosen = ociSources[0];
+    }
+    else {
+        throw new BiomePublishConfigError(`Multiple oci sources configured (${ociSources.map((s) => s.name).join(', ')}). ` +
+            'Pick one with --source <name>, or pass --registry <host>.');
+    }
+    return {
+        registry: chosen.registry,
+        ...(chosen.authTokenEnv !== undefined ? { tokenEnv: chosen.authTokenEnv } : {}),
+        sourceName: `source "${chosen.name}"`,
+    };
+}
+function buildOrasArgs(input) {
+    const args = ['push', input.ociRef, '--artifact-type', exports.BIOME_ARTIFACT_TYPE];
+    args.push('--annotation', `org.opencontainers.image.title=${input.biomeId}`);
+    args.push('--annotation', `org.opencontainers.image.version=${input.version}`);
+    if (input.hasToken) {
+        args.push('--username', input.username, '--password-stdin');
+    }
+    for (const file of input.files) {
+        args.push(file);
+    }
+    return args;
+}
+function buildCosignArgs(ociRef, cosignKey) {
+    const keyRef = resolveCosignKeyRef(cosignKey);
+    return ['sign', '--yes', '--key', keyRef, ociRef];
+}
+function buildCosignAttestArgs(ociRef, cosignKey) {
+    return [
+        'attest',
+        '--yes',
+        '--key',
+        resolveCosignKeyRef(cosignKey),
+        '--type',
+        biome_provenance_1.SLSA_PROVENANCE_PREDICATE_TYPE,
+        ociRef,
+    ];
+}
+function resolveCosignKeyRef(cosignKey) {
+    return cosignKey !== undefined && cosignKey.length > 0 ? cosignKey : `$${exports.COSIGN_KEY_ENV}`;
+}
+function collectBiomeFiles(root) {
+    const out = [];
+    const walk = (dir) => {
+        for (const entry of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                if (EXCLUDE_DIRS.has(entry.name)) {
+                    continue;
+                }
+                walk((0, node_path_1.join)(dir, entry.name));
+            }
+            else if (entry.isFile()) {
+                if (EXCLUDE_FILES.has(entry.name)) {
+                    continue;
+                }
+                out.push(toPosix((0, node_path_1.relative)(root, (0, node_path_1.join)(dir, entry.name))));
+            }
+        }
+    };
+    walk(root);
+    out.sort((a, b) => a.localeCompare(b));
+    return out;
+}
+function toPosix(p) {
+    return node_path_1.sep === '/' ? p : p.split(node_path_1.sep).join('/');
+}
+function ensureToolInstalled(tool) {
+    const probe = (0, node_child_process_1.spawnSync)(tool, ['version'], { stdio: 'ignore' });
+    if (probe.error !== undefined || probe.status === null) {
+        throw new MissingRuntimeToolError(tool, `"${tool}" CLI not found on PATH — install it to publish signed biome artifacts ` +
+            `(oras: https://oras.land, cosign: https://github.com/sigstore/cosign).`);
+    }
+}
+function runTool(tool, args, cwd, stdinInput) {
+    const result = (0, node_child_process_1.spawnSync)(tool, [...args], {
+        cwd,
+        stdio: [stdinInput !== undefined ? 'pipe' : 'ignore', 'inherit', 'inherit'],
+        ...(stdinInput !== undefined ? { input: `${stdinInput}\n` } : {}),
+    });
+    if (result.error !== undefined) {
+        throw new Error(`${tool} failed to start: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        throw new Error(`${tool} ${args.join(' ')} exited with code ${String(result.status)}.`);
+    }
+}
+function renderCommand(tool, args) {
+    const shown = args.map((a) => (/[\s"']/.test(a) ? JSON.stringify(a) : a));
+    return `${tool} ${shown.join(' ')}`;
+}
+function printPlan(plan, biomeDir, username) {
+    console.log(`biome publish (dry-run) — ${plan.biomeId} v${plan.version}`);
+    console.log(`  biome dir : ${biomeDir}`);
+    console.log(`  registry  : ${plan.registry}`);
+    console.log(`  tag       : ${plan.tag}`);
+    console.log(`  oci ref   : ${plan.ociRef}`);
+    console.log(`  files     : ${String(plan.files.length)} (${plan.files.join(', ')})`);
+    if (plan.tokenEnv !== undefined) {
+        console.log(`  auth      : --username ${username} --password-stdin ` +
+            `(token from $${plan.tokenEnv}, ${plan.tokenPresent ? 'present' : 'NOT SET'})`);
+    }
+    else {
+        console.log('  auth      : ambient oras credentials (run `oras login` first)');
+    }
+    if (!plan.cosignKeyResolved) {
+        console.log(`  cosign    : ${exports.COSIGN_KEY_ENV} not set — required for the real publish`);
+    }
+    console.log('');
+    console.log(`  ${renderCommand('oras', plan.orasArgs)}`);
+    console.log(`  ${renderCommand('cosign', plan.cosignArgs)}`);
+    console.log(`  ${renderCommand('cosign', attestArgsWithPredicate(plan.cosignAttestArgs, '<temp>/slsa-provenance.json'))}`);
+}
+//# sourceMappingURL=biome-publish.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"biome-publish.js","sourceRoot":"","sources":["../../src/runtime/biome-publish.ts"],"names":[],"mappings":";;;AA6KA,oCAqEC;AA+CD,0DAKC;AASD,oCAYC;AA8ED,sCAYC;AA0CD,8CAoBC;AAndD,2DAA+C;AAC/C,qCAQiB;AACjB,qCAAiC;AACjC,yCAAyD;AAEzD,0DAIwC;AAExC,yDAI4B;AAC5B,4CAAiD;AACjD,uDAA2D;AAC3D,6CAA8D;AAqCjD,QAAA,mBAAmB,GAAG,6CAA6C,CAAC;AAGpE,QAAA,cAAc,GAAG,YAAY,CAAC;AAuB3C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,cAAc;IACd,MAAM;IAGN,QAAQ;IACR,QAAQ;IAER,UAAU;IACV,aAAa;CACd,CAAC,CAAC;AAGH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAG7C,MAAM,oBAAoB,GAAG,OAAO,CAAC;AA6CrC,MAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AALD,0DAKC;AAGD,MAAa,uBAAwB,SAAQ,KAAK;IAE9B;IADlB,YACkB,IAAY,EAC5B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QAI5B,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AARD,0DAQC;AAOD,SAAgB,YAAY,CAAC,OAAuB;IAClD,MAAM,QAAQ,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IAExF,MAAM,WAAW,GAAG,IAAI,gCAAkB,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,uBAAuB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;IAExE,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,uBAAuB,CAAC,YAAY,QAAQ,2BAA2B,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,oBAAoB,CAAC;IAC1D,MAAM,QAAQ,GAAG,aAAa,CAAC;QAC7B,MAAM;QACN,OAAO;QACP,OAAO;QACP,KAAK;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,KAAK,SAAS;QACrC,QAAQ;KACT,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAc,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAElE,MAAM,IAAI,GAAgB;QACxB,OAAO;QACP,OAAO;QACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG;QACH,MAAM;QACN,KAAK;QACL,QAAQ;QACR,UAAU;QACV,gBAAgB;QAChB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC5C,iBAAiB,EAAE,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;KACnE,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5B,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC5B,MAAM,IAAI,uBAAuB,CAC/B,GAAG,sBAAc,oEAAoE;YACnF,8EAA8E;YAC9E,gDAAgD,CACnD,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GACT,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhG,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnD,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,kCAAkC,MAAM,GAAG,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAQD,SAAS,gBAAgB,CAAC,KAIzB;IACC,MAAM,SAAS,GAAG,IAAA,2CAAwB,EAAC;QACzC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;QAC3B,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;QAC3B,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG;QACnB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;QACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;QACvB,OAAO,EAAE,IAAA,iCAAc,EAAC,OAAO,CAAC,GAAG,CAAC;QACpC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAA,qBAAW,EAAC,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,IAAA,uBAAa,EAAC,aAAa,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YACtE,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,OAAO,CACL,QAAQ,EACR,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,EACnE,KAAK,CAAC,QAAQ,EACd,SAAS,CACV,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAA,gBAAM,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAQD,SAAgB,uBAAuB,CACrC,UAA6B,EAC7B,aAAqB;IAErB,OAAO,CAAC,GAAG,UAAU,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;AACvD,CAAC;AASD,SAAgB,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC,IAAA,oBAAU,EAAC,QAAQ,CAAC,IAAI,CAAC,IAAA,kBAAQ,EAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,uBAAuB,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,YAAY,GAAG,IAAA,gBAAI,EAAC,QAAQ,EAAE,+BAAuB,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAA,oBAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,uBAAuB,CAC/B,MAAM,+BAAuB,OAAO,QAAQ,+BAA+B,CAC5E,CAAC;IACJ,CAAC;IAED,OAAO,IAAA,0BAAkB,EAAC,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAgBD,SAAS,uBAAuB,CAC9B,OAAuB,EACvB,YAAgC;IAEhC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,UAAU,EAAE,YAAY;SACzB,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,uBAAc,EAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CACtC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAU,CAAC,GAAG,CACjD,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,uBAAuB,CAC/B,6EAA6E;YAC3E,2CAA2C,CAC9C,CAAC;IACJ,CAAC;IAED,IAAI,MAAiB,CAAC;IACtB,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAChE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,OAAO,CAAC,MAAM,6BAA6B;gBACjE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACjD,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;SAAM,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAc,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,uBAAuB,CAC/B,oCAAoC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YAC/E,2DAA2D,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,UAAU,EAAE,WAAW,MAAM,CAAC,IAAI,GAAG;KACtC,CAAC;AACJ,CAAC;AAgBD,SAAgB,aAAa,CAAC,KAAoB;IAChD,MAAM,IAAI,GAAa,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,iBAAiB,EAAE,2BAAmB,CAAC,CAAC;IACtF,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,oCAAoC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAEnB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAC9D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAOD,SAAS,eAAe,CAAC,MAAc,EAAE,SAA6B;IACpE,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAUD,SAAS,qBAAqB,CAAC,MAAc,EAAE,SAA6B;IAC1E,OAAO;QACL,QAAQ;QACR,OAAO;QACP,OAAO;QACP,mBAAmB,CAAC,SAAS,CAAC;QAC9B,QAAQ;QACR,iDAA8B;QAC9B,MAAM;KACP,CAAC;AACJ,CAAC;AAGD,SAAS,mBAAmB,CAAC,SAA6B;IACxD,OAAO,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,sBAAc,EAAE,CAAC;AAC5F,CAAC;AAOD,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,KAAK,MAAM,KAAK,IAAI,IAAA,qBAAW,EAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjC,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9B,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClC,SAAS;gBACX,CAAC;gBACD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAA,oBAAQ,EAAC,IAAI,EAAE,IAAA,gBAAI,EAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,eAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,eAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC;AAGD,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAA,8BAAS,EAAC,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,IAAI,uBAAuB,CAC/B,IAAI,EACJ,IAAI,IAAI,yEAAyE;YAC/E,wEAAwE,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC;AAGD,SAAS,OAAO,CACd,IAAY,EACZ,IAAuB,EACvB,GAAW,EACX,UAA8B;IAE9B,MAAM,MAAM,GAAG,IAAA,8BAAS,EAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;QACxC,GAAG;QACH,KAAK,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;QAC3E,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qBAAqB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAGD,SAAS,aAAa,CAAC,IAAY,EAAE,IAAuB;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,SAAS,CAAC,IAAiB,EAAE,QAAgB,EAAE,QAAgB;IACtE,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrF,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CACT,4BAA4B,QAAQ,oBAAoB;YACtD,gBAAgB,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,CACjF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,iBAAiB,sBAAc,0CAA0C,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,KAAK,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CACT,KAAK,aAAa,CAChB,QAAQ,EACR,uBAAuB,CAAC,IAAI,CAAC,gBAAgB,EAAE,6BAA6B,CAAC,CAC9E,EAAE,CACJ,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,35 @@
+import { type BiomeManifest } from '@xemahq/kernel-contracts/biome';
+export declare enum ScaffoldTarget {
+    Server = "server",
+    Web = "web"
+}
+export declare enum ScaffoldScope {
+    Kernel = "kernel",
+    System = "system",
+    Base = "base",
+    Platform = "platform"
+}
+export declare const DEFAULT_SCAFFOLD_SCOPE = ScaffoldScope.Platform;
+export declare const DEFAULT_SCAFFOLD_TARGET = ScaffoldTarget.Server;
+export interface ScaffoldOptions {
+    readonly name: string;
+    readonly dir?: string;
+    readonly scope?: ScaffoldScope;
+    readonly target?: ScaffoldTarget;
+    readonly description?: string;
+}
+export interface ScaffoldResult {
+    readonly biomeDir: string;
+    readonly manifestPath: string;
+    readonly files: readonly string[];
+    readonly manifest: BiomeManifest;
+}
+export declare class BiomeScaffoldExistsError extends Error {
+    readonly biomeDir: string;
+    constructor(biomeDir: string);
+}
+export declare class BiomeScaffoldNameError extends Error {
+    constructor(name: string);
+}
+export declare function scaffoldBiome(options: ScaffoldOptions): ScaffoldResult;
+//# sourceMappingURL=biome-scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"biome-scaffold.d.ts","sourceRoot":"","sources":["../../src/runtime/biome-scaffold.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AAexC,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAUD,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,QAAQ,aAAa;CACtB;AAGD,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAQ7D,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAEjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAE7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAGD,qBAAa,wBAAyB,SAAQ,KAAK;aACrB,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAO7C;AAGD,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,IAAI,EAAE,MAAM;CAOzB;AAOD,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA8CtE"}

package/dist/runtime/biome-scaffold.js

@@ -0,0 +1,151 @@
+"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 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,
+        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,EAML,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"}