@xemahq/biome-sdk 0.1.1

package/dist/builder/lib/contribution-schemas.js

@@ -0,0 +1,301 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContributionParseError = exports.WorkflowPhaseConfigSchema = exports.WorkflowPhaseSchema = exports.WorkflowPhaseCategorySchema = exports.ProjectKitDefinitionSchema = exports.ProjectKitSourceSchema = exports.RegistryVisibilityTierSchema = exports.ProjectKitPurposeSchema = exports.ProjectKitKindSchema = exports.SkillFrontmatterSchema = exports.AgentFrontmatterSchema = exports.ModelClassSchema = exports.RoleCapabilityProfileSchema = exports.WritePolicySchema = exports.InvocationSurfaceSchema = exports.ToolProfileSchema = exports.ServiceToolAccessSchema = exports.McpCatalogServiceSchema = exports.McpCatalogConnectionSchema = exports.McpCatalogServerTypeSchema = exports.McpCatalogToolSchema = exports.ToolGroupSchema = void 0;
+exports.parseContribution = parseContribution;
+const zod_1 = require("zod");
+exports.ToolGroupSchema = zod_1.z.enum([
+    'read',
+    'write',
+    'search',
+    'manage',
+    'execute',
+]);
+exports.McpCatalogToolSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1),
+    description: zod_1.z.string().min(1),
+    group: exports.ToolGroupSchema,
+})
+    .strict();
+exports.McpCatalogServerTypeSchema = zod_1.z.enum([
+    'native_mcp',
+    'openapi_bridge',
+]);
+exports.McpCatalogConnectionSchema = zod_1.z
+    .object({
+    serverType: exports.McpCatalogServerTypeSchema,
+    envVar: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[A-Z][A-Z0-9_]*$/, 'envVar must be UPPER_SNAKE_CASE'),
+    path: zod_1.z.string().min(1).default('/mcp'),
+})
+    .strict();
+exports.McpCatalogServiceSchema = zod_1.z
+    .object({
+    key: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[a-z][a-z0-9-]*$/, 'service key must be kebab-case'),
+    displayName: zod_1.z.string().min(1),
+    purpose: zod_1.z.string().min(1),
+    tools: zod_1.z.array(exports.McpCatalogToolSchema).min(1),
+    connection: exports.McpCatalogConnectionSchema.optional(),
+})
+    .strict();
+exports.ServiceToolAccessSchema = zod_1.z.union([
+    zod_1.z.literal('*'),
+    zod_1.z.array(exports.ToolGroupSchema),
+    zod_1.z
+        .object({
+        groups: zod_1.z.union([zod_1.z.literal('*'), zod_1.z.array(exports.ToolGroupSchema)]),
+        allowedTools: zod_1.z.array(zod_1.z.string()).optional(),
+        optional: zod_1.z.boolean().optional(),
+    })
+        .strict(),
+]);
+exports.ToolProfileSchema = zod_1.z
+    .object({
+    agentSlug: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[a-z][a-z0-9-_]*$/, 'agent slug must be kebab-case'),
+    access: zod_1.z.record(zod_1.z.string(), exports.ServiceToolAccessSchema),
+})
+    .strict();
+exports.InvocationSurfaceSchema = zod_1.z.enum([
+    'pipeline-run',
+    'agent-session',
+    'design-system-builder',
+    'gate-review',
+]);
+exports.WritePolicySchema = zod_1.z.enum([
+    'read-only',
+    'own-pages-only',
+    'full-write',
+]);
+exports.RoleCapabilityProfileSchema = zod_1.z
+    .object({
+    role: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[a-z][a-z0-9-]*$/, 'role must be kebab-case'),
+    surface: exports.InvocationSurfaceSchema,
+    writePolicy: exports.WritePolicySchema,
+    mayEditRepos: zod_1.z.enum(['never', 'when-granted']),
+    mayWriteKnowledgeBase: zod_1.z.boolean(),
+    allowedXemaTools: zod_1.z.array(zod_1.z.string().min(1)),
+})
+    .strict();
+exports.ModelClassSchema = zod_1.z.enum([
+    'utility',
+    'planning',
+    'creative',
+    'coding',
+    'review',
+]);
+exports.AgentFrontmatterSchema = zod_1.z
+    .object({
+    slug: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[a-z][a-z0-9-_]*$/, 'agent slug must be kebab-case')
+        .optional(),
+    description: zod_1.z.string().min(1),
+    mode: zod_1.z.enum(['primary', 'subagent', 'all']).optional(),
+    color: zod_1.z.string().optional(),
+    temperature: zod_1.z.number().min(0).max(2).optional(),
+    steps: zod_1.z.number().int().positive().optional(),
+    hidden: zod_1.z.boolean().optional(),
+    displayName: zod_1.z.string(),
+    modelClass: exports.ModelClassSchema,
+    skills: zod_1.z.array(zod_1.z.string()).optional(),
+    mcpServices: zod_1.z.array(zod_1.z.string()).optional(),
+    tools: zod_1.z.unknown().optional(),
+    permission: zod_1.z.unknown().optional(),
+})
+    .passthrough();
+exports.SkillFrontmatterSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1),
+    description: zod_1.z.string().min(1),
+    category: zod_1.z.string().optional(),
+    phases: zod_1.z.array(zod_1.z.string()).optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    surfaces: zod_1.z.array(zod_1.z.enum(['workflow', 'agent-session'])).optional(),
+})
+    .passthrough();
+exports.ProjectKitKindSchema = zod_1.z.enum(['npm-dependency', 'shadcn-registry']);
+exports.ProjectKitPurposeSchema = zod_1.z.enum([
+    'component-library',
+    'generic-dependency',
+]);
+exports.RegistryVisibilityTierSchema = zod_1.z.enum([
+    'system',
+    'system-shareable',
+    'org',
+    'external',
+]);
+const ProjectKitAuthSchema = zod_1.z
+    .object({
+    walletName: zod_1.z
+        .string()
+        .regex(/^[a-z][a-z0-9-]{0,62}$/, 'walletName must be a kebab-case wallet name'),
+    tokenEnvVar: zod_1.z
+        .string()
+        .regex(/^[A-Z][A-Z0-9_]*$/, 'tokenEnvVar must be a SCREAMING_SNAKE_CASE env-var name'),
+})
+    .strict();
+const ProjectKitNpmRegistrySourceSchema = zod_1.z
+    .object({
+    kind: zod_1.z.literal('npm-registry'),
+    package: zod_1.z.string().min(1),
+    versionRange: zod_1.z.string().min(1),
+    registryUrl: zod_1.z.string().url().optional(),
+    scope: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^@[a-z0-9-]+$/, 'scope must be a lowercase npm scope like @acme')
+        .optional(),
+    auth: ProjectKitAuthSchema.optional(),
+})
+    .strict()
+    .refine((s) => (s.registryUrl ? Boolean(s.scope) : true), {
+    message: 'scope is required when registryUrl is set',
+    path: ['scope'],
+});
+const ProjectKitGitSourceSchema = zod_1.z
+    .object({
+    kind: zod_1.z.literal('git'),
+    gitUrl: zod_1.z.string().url(),
+    ref: zod_1.z.string().min(1).optional(),
+    packageName: zod_1.z.string().min(1).optional(),
+    auth: ProjectKitAuthSchema.optional(),
+})
+    .strict();
+const ShadcnStyleSchema = zod_1.z.enum(['default', 'new-york']);
+const ShadcnBaseColorSchema = zod_1.z.enum([
+    'neutral',
+    'stone',
+    'zinc',
+    'mauve',
+    'olive',
+    'mist',
+    'taupe',
+]);
+const ShadcnIconLibrarySchema = zod_1.z.enum(['lucide', 'radix']);
+const ShadcnCustomRegistrySchema = zod_1.z
+    .object({
+    scope: zod_1.z
+        .string()
+        .regex(/^@[a-z0-9-]+$/, 'shadcn custom-registry scope must be a lowercase npm scope like @acme'),
+    url: zod_1.z
+        .string()
+        .url()
+        .refine((u) => u.includes('{name}'), {
+        message: 'shadcn custom-registry url must contain {name} substitution token',
+    }),
+    auth: ProjectKitAuthSchema.optional(),
+})
+    .strict();
+const ProjectKitShadcnRegistrySourceSchema = zod_1.z
+    .object({
+    kind: zod_1.z.literal('shadcn-registry'),
+    style: ShadcnStyleSchema,
+    baseColor: ShadcnBaseColorSchema,
+    components: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+    iconLibrary: ShadcnIconLibrarySchema.optional(),
+    customRegistries: zod_1.z.array(ShadcnCustomRegistrySchema).optional(),
+    typescript: zod_1.z.boolean().optional(),
+    rsc: zod_1.z.boolean().optional(),
+})
+    .strict();
+exports.ProjectKitSourceSchema = zod_1.z.discriminatedUnion('kind', [
+    ProjectKitNpmRegistrySourceSchema,
+    ProjectKitGitSourceSchema,
+    ProjectKitShadcnRegistrySourceSchema,
+]);
+exports.ProjectKitDefinitionSchema = zod_1.z
+    .object({
+    slug: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[a-z][a-z0-9-]*$/, 'kit slug must be kebab-case'),
+    displayName: zod_1.z.string().min(1),
+    description: zod_1.z.string().optional(),
+    kitKind: exports.ProjectKitKindSchema,
+    purpose: exports.ProjectKitPurposeSchema,
+    visibilityTier: exports.RegistryVisibilityTierSchema.optional(),
+    compatibleTargets: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+    defaultForTargets: zod_1.z.array(zod_1.z.string().min(1)).default([]),
+    source: exports.ProjectKitSourceSchema,
+    enrichmentSkillSlug: zod_1.z.string().min(1).optional(),
+})
+    .strict()
+    .refine((k) => k.defaultForTargets.every((t) => k.compatibleTargets.includes(t)), {
+    message: 'defaultForTargets must be a subset of compatibleTargets',
+    path: ['defaultForTargets'],
+});
+exports.WorkflowPhaseCategorySchema = zod_1.z.enum(['lifecycle', 'delivery']);
+exports.WorkflowPhaseSchema = zod_1.z
+    .object({
+    key: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[a-z][a-z0-9_]*$/, 'phase key must be lower_snake_case'),
+    category: exports.WorkflowPhaseCategorySchema,
+})
+    .strict();
+exports.WorkflowPhaseConfigSchema = zod_1.z
+    .object({
+    schemaVersion: zod_1.z.string().min(1),
+    phases: zod_1.z.array(exports.WorkflowPhaseSchema).min(1),
+    directAgentPhases: zod_1.z.array(zod_1.z.string().min(1)).default([]),
+    subPhaseToParent: zod_1.z.record(zod_1.z.string(), zod_1.z.string().min(1)).default({}),
+    reviewCapabilities: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.array(zod_1.z.string().min(1)))
+        .default({}),
+})
+    .strict()
+    .superRefine((cfg, ctx) => {
+    const phaseKeys = new Set(cfg.phases.map((p) => p.key));
+    for (const key of Object.keys(cfg.reviewCapabilities)) {
+        if (!phaseKeys.has(key)) {
+            ctx.addIssue({
+                code: 'custom',
+                message: `reviewCapabilities references unknown phase "${key}"`,
+                path: ['reviewCapabilities', key],
+            });
+        }
+    }
+    for (const [slug, parent] of Object.entries(cfg.subPhaseToParent)) {
+        if (!phaseKeys.has(parent)) {
+            ctx.addIssue({
+                code: 'custom',
+                message: `subPhaseToParent["${slug}"] references unknown phase "${parent}"`,
+                path: ['subPhaseToParent', slug],
+            });
+        }
+    }
+});
+class ContributionParseError extends Error {
+    contributionPath;
+    issues;
+    constructor(contributionPath, issues) {
+        super(`Invalid contribution file ${contributionPath}: ${issues
+            .map((i) => `[${i.path.join('.')}] ${i.message}`)
+            .join('; ')}`);
+        this.contributionPath = contributionPath;
+        this.issues = issues;
+        this.name = 'ContributionParseError';
+    }
+}
+exports.ContributionParseError = ContributionParseError;
+function parseContribution(schema, raw, contributionPath) {
+    const result = schema.safeParse(raw);
+    if (!result.success) {
+        throw new ContributionParseError(contributionPath, result.error.issues);
+    }
+    return result.data;
+}
+//# sourceMappingURL=contribution-schemas.js.map

package/dist/builder/lib/contribution-schemas.js.map

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

package/dist/builder/lib/define-biome.d.ts

@@ -0,0 +1,17 @@
+import type { BiomeManifest } from '../../host';
+export interface BiomeInstallContext {
+    readonly manifest: BiomeManifest;
+    readonly biomeRoot: string;
+    [registryKey: string]: unknown;
+}
+export type BiomeInstallFn = (ctx: BiomeInstallContext) => void | Promise<void>;
+export interface BiomeDefinition {
+    readonly manifest: BiomeManifest;
+    readonly install: BiomeInstallFn;
+}
+export interface DefineBiomeOptions {
+    readonly manifest: BiomeManifest;
+    readonly install?: BiomeInstallFn;
+}
+export declare function defineBiome(opts: DefineBiomeOptions): BiomeDefinition;
+//# sourceMappingURL=define-biome.d.ts.map

package/dist/builder/lib/define-biome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-biome.d.ts","sourceRoot":"","sources":["../../../src/builder/lib/define-biome.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUhD,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,mBAAmB,KACrB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAOjC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAuBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,CAMrE"}

package/dist/builder/lib/define-biome.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineBiome = defineBiome;
+function defineBiome(opts) {
+    const noop = () => undefined;
+    return {
+        manifest: opts.manifest,
+        install: opts.install ?? noop,
+    };
+}
+//# sourceMappingURL=define-biome.js.map

package/dist/builder/lib/define-biome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-biome.js","sourceRoot":"","sources":["../../../src/builder/lib/define-biome.ts"],"names":[],"mappings":";;AA6EA,kCAMC;AAND,SAAgB,WAAW,CAAC,IAAwB;IAClD,MAAM,IAAI,GAAmB,GAAG,EAAE,CAAC,SAAS,CAAC;IAC7C,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;KAC9B,CAAC;AACJ,CAAC"}

package/dist/builder/lib/define-helpers.d.ts

@@ -0,0 +1,6 @@
+import { type AgentFrontmatter, type McpCatalogService, type RoleCapabilityProfile, type ToolProfile } from './contribution-schemas';
+export declare function defineAgent(input: AgentFrontmatter): AgentFrontmatter;
+export declare function defineToolProfile(input: ToolProfile): ToolProfile;
+export declare function defineMcpService(input: McpCatalogService): McpCatalogService;
+export declare function defineRoleCapability(input: RoleCapabilityProfile): RoleCapabilityProfile;
+//# sourceMappingURL=define-helpers.d.ts.map

package/dist/builder/lib/define-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-helpers.d.ts","sourceRoot":"","sources":["../../../src/builder/lib/define-helpers.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,iBAAiB,EAEtB,KAAK,qBAAqB,EAE1B,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEjE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAE5E;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,qBAAqB,GAC3B,qBAAqB,CAEvB"}

package/dist/builder/lib/define-helpers.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineAgent = defineAgent;
+exports.defineToolProfile = defineToolProfile;
+exports.defineMcpService = defineMcpService;
+exports.defineRoleCapability = defineRoleCapability;
+const contribution_schemas_1 = require("./contribution-schemas");
+function defineAgent(input) {
+    return contribution_schemas_1.AgentFrontmatterSchema.parse(input);
+}
+function defineToolProfile(input) {
+    return contribution_schemas_1.ToolProfileSchema.parse(input);
+}
+function defineMcpService(input) {
+    return contribution_schemas_1.McpCatalogServiceSchema.parse(input);
+}
+function defineRoleCapability(input) {
+    return contribution_schemas_1.RoleCapabilityProfileSchema.parse(input);
+}
+//# sourceMappingURL=define-helpers.js.map

package/dist/builder/lib/define-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-helpers.js","sourceRoot":"","sources":["../../../src/builder/lib/define-helpers.ts"],"names":[],"mappings":";;AAyBA,kCAEC;AAED,8CAEC;AAED,4CAEC;AAED,oDAIC;AA3BD,iEASgC;AAEhC,SAAgB,WAAW,CAAC,KAAuB;IACjD,OAAO,6CAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAkB;IAClD,OAAO,wCAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAwB;IACvD,OAAO,8CAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,oBAAoB,CAClC,KAA4B;IAE5B,OAAO,kDAA2B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC"}

package/dist/builder/lib/extends-precedence.d.ts

@@ -0,0 +1,14 @@
+export interface BiomeExtendsIndex {
+    extendsTransitively(descendant: string, ancestor: string): boolean;
+    readonly directTargets: ReadonlyMap<string, ReadonlySet<string>>;
+}
+export declare function buildBiomeExtendsIndex(scanRoots: readonly string[]): BiomeExtendsIndex;
+export type ExtendsPrecedence = 'keep-existing' | 'replace' | 'conflict';
+export declare function resolveExtendsPrecedence(index: BiomeExtendsIndex, existingBiomeId: string, incomingBiomeId: string): ExtendsPrecedence;
+export declare function dedupeBySlugWithExtends<T>(items: readonly T[], opts: {
+    readonly index: BiomeExtendsIndex;
+    readonly slugOf: (item: T) => string;
+    readonly biomeIdOf: (item: T) => string;
+    readonly onConflict: (slug: string, existing: T, incoming: T) => never;
+}): T[];
+//# sourceMappingURL=extends-precedence.d.ts.map

package/dist/builder/lib/extends-precedence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extends-precedence.d.ts","sourceRoot":"","sources":["../../../src/builder/lib/extends-precedence.ts"],"names":[],"mappings":"AA6CA,MAAM,WAAW,iBAAiB;IAMhC,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAEnE,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;CAClE;AAaD,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,iBAAiB,CAmDnB;AAED,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,SAAS,GAAG,UAAU,CAAC;AAQzE,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,iBAAiB,EACxB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,GACtB,iBAAiB,CASnB;AAUD,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,IAAI,EAAE;IACJ,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,KAAK,CAAC;CACxE,GACA,CAAC,EAAE,CAiCL"}

package/dist/builder/lib/extends-precedence.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBiomeExtendsIndex = buildBiomeExtendsIndex;
+exports.resolveExtendsPrecedence = resolveExtendsPrecedence;
+exports.dedupeBySlugWithExtends = dedupeBySlugWithExtends;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function readExtendsTargets(raw) {
+    const ext = raw?.xema
+        ?.extends;
+    if (Array.isArray(ext)) {
+        return ext.filter((x) => typeof x === 'string');
+    }
+    if (typeof ext === 'string') {
+        return [ext];
+    }
+    return [];
+}
+function buildBiomeExtendsIndex(scanRoots) {
+    const directTargets = new Map();
+    for (const root of scanRoots) {
+        if (!(0, node_fs_1.existsSync)(root))
+            continue;
+        let entries;
+        try {
+            entries = (0, node_fs_1.readdirSync)(root, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const manifestPath = (0, node_path_1.join)(root, entry.name, 'xema-biome.json');
+            if (!(0, node_fs_1.existsSync)(manifestPath))
+                continue;
+            let raw;
+            try {
+                raw = JSON.parse((0, node_fs_1.readFileSync)(manifestPath, 'utf-8'));
+            }
+            catch {
+                continue;
+            }
+            const id = raw?.xema
+                ?.id;
+            if (typeof id !== 'string')
+                continue;
+            const existing = directTargets.get(id) ?? new Set();
+            for (const t of readExtendsTargets(raw))
+                existing.add(t);
+            directTargets.set(id, existing);
+        }
+    }
+    const extendsTransitively = (descendant, ancestor) => {
+        if (descendant === ancestor)
+            return false;
+        const seen = new Set();
+        const stack = [...(directTargets.get(descendant) ?? [])];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            if (current === undefined)
+                break;
+            if (current === ancestor)
+                return true;
+            if (seen.has(current))
+                continue;
+            seen.add(current);
+            for (const next of directTargets.get(current) ?? [])
+                stack.push(next);
+        }
+        return false;
+    };
+    return { extendsTransitively, directTargets };
+}
+function resolveExtendsPrecedence(index, existingBiomeId, incomingBiomeId) {
+    if (existingBiomeId === incomingBiomeId)
+        return 'conflict';
+    if (index.extendsTransitively(incomingBiomeId, existingBiomeId)) {
+        return 'replace';
+    }
+    if (index.extendsTransitively(existingBiomeId, incomingBiomeId)) {
+        return 'keep-existing';
+    }
+    return 'conflict';
+}
+function dedupeBySlugWithExtends(items, opts) {
+    const winners = new Map();
+    const order = [];
+    for (const item of items) {
+        const slug = opts.slugOf(item);
+        const existing = winners.get(slug);
+        if (existing === undefined) {
+            winners.set(slug, item);
+            order.push(slug);
+            continue;
+        }
+        const decision = resolveExtendsPrecedence(opts.index, opts.biomeIdOf(existing), opts.biomeIdOf(item));
+        if (decision === 'replace') {
+            winners.set(slug, item);
+        }
+        else if (decision === 'conflict') {
+            opts.onConflict(slug, existing, item);
+        }
+    }
+    return order.map((slug) => {
+        const winner = winners.get(slug);
+        if (winner === undefined) {
+            throw new Error(`dedupeBySlugWithExtends: lost winner for slug "${slug}"`);
+        }
+        return winner;
+    });
+}
+//# sourceMappingURL=extends-precedence.js.map

package/dist/builder/lib/extends-precedence.js.map

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

package/dist/builder/lib/workflow-phase-config-loader.d.ts

@@ -0,0 +1,18 @@
+import { type WorkflowPhaseConfig } from './contribution-schemas';
+export interface LoadedWorkflowPhaseConfig {
+    readonly biomeId: string;
+    readonly config: WorkflowPhaseConfig;
+}
+export interface MergedWorkflowPhaseConfig {
+    readonly orderedPhaseKeys: readonly string[];
+    readonly phaseCategory: ReadonlyMap<string, 'lifecycle' | 'delivery'>;
+    readonly directAgentPhases: readonly string[];
+    readonly allConfigurablePhases: readonly string[];
+    readonly subPhaseToParent: ReadonlyMap<string, string>;
+    readonly reviewCapabilities: ReadonlyMap<string, readonly string[]>;
+    readonly allReviewCapabilities: readonly string[];
+}
+export declare function loadWorkflowPhaseConfigs(scanRoots: readonly string[]): LoadedWorkflowPhaseConfig[];
+export declare function loadMergedWorkflowPhaseConfig(scanRoots: readonly string[]): MergedWorkflowPhaseConfig;
+export declare function resolveParentPhaseKey(merged: MergedWorkflowPhaseConfig, agentSlug: string): string;
+//# sourceMappingURL=workflow-phase-config-loader.d.ts.map

package/dist/builder/lib/workflow-phase-config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-phase-config-loader.d.ts","sourceRoot":"","sources":["../../../src/builder/lib/workflow-phase-config-loader.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAWhC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC;AAOD,MAAM,WAAW,yBAAyB;IAExC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAE7C,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC,CAAC;IAEtE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAK9C,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IAElD,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvD,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAEpE,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD;AAQD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,yBAAyB,EAAE,CAqB7B;AAOD,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,yBAAyB,CAiD3B;AAOD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,yBAAyB,EACjC,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}

package/dist/builder/lib/workflow-phase-config-loader.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadWorkflowPhaseConfigs = loadWorkflowPhaseConfigs;
+exports.loadMergedWorkflowPhaseConfig = loadMergedWorkflowPhaseConfig;
+exports.resolveParentPhaseKey = resolveParentPhaseKey;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const contribution_schemas_1 = require("./contribution-schemas");
+const contribution_schemas_2 = require("./contribution-schemas");
+const content_walker_1 = require("./content-walker");
+const PHASE_CONFIG_FILENAME = 'phase-config.json';
+function loadWorkflowPhaseConfigs(scanRoots) {
+    const out = [];
+    for (const binding of (0, content_walker_1.enumerateBiomesWithContent)(scanRoots, 'workflowConfig')) {
+        const path = (0, node_path_1.join)(binding.contentDir, PHASE_CONFIG_FILENAME);
+        if (!(0, node_fs_1.existsSync)(path)) {
+            continue;
+        }
+        let raw;
+        try {
+            raw = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf-8'));
+        }
+        catch (err) {
+            throw new Error(`Biome "${binding.biomeId}" ships a malformed ${PHASE_CONFIG_FILENAME}: ${err.message}`);
+        }
+        const config = (0, contribution_schemas_1.parseContribution)(contribution_schemas_2.WorkflowPhaseConfigSchema, raw, path);
+        out.push({ biomeId: binding.biomeId, config });
+    }
+    return out;
+}
+function loadMergedWorkflowPhaseConfig(scanRoots) {
+    const loaded = loadWorkflowPhaseConfigs(scanRoots);
+    const orderedPhaseKeys = [];
+    const phaseCategory = new Map();
+    const directAgentPhases = [];
+    const subPhaseToParent = new Map();
+    const reviewCapabilities = new Map();
+    const phaseOwner = new Map();
+    for (const { biomeId, config } of loaded) {
+        for (const phase of config.phases) {
+            const existingOwner = phaseOwner.get(phase.key);
+            if (existingOwner !== undefined) {
+                throw new Error(`Workflow phase key "${phase.key}" is declared by both biome ` +
+                    `"${existingOwner}" and biome "${biomeId}". Phase keys must be ` +
+                    `globally unique — they flow onto the artifact natural key.`);
+            }
+            phaseOwner.set(phase.key, biomeId);
+            orderedPhaseKeys.push(phase.key);
+            phaseCategory.set(phase.key, phase.category);
+        }
+        for (const direct of config.directAgentPhases) {
+            directAgentPhases.push(direct);
+        }
+        for (const [slug, parent] of Object.entries(config.subPhaseToParent)) {
+            subPhaseToParent.set(slug, parent);
+        }
+        for (const [key, caps] of Object.entries(config.reviewCapabilities)) {
+            reviewCapabilities.set(key, caps);
+        }
+    }
+    const allConfigurablePhases = [...orderedPhaseKeys, ...directAgentPhases];
+    const allReviewCapabilities = [
+        ...new Set([...reviewCapabilities.values()].flat()),
+    ];
+    return {
+        orderedPhaseKeys,
+        phaseCategory,
+        directAgentPhases,
+        allConfigurablePhases,
+        subPhaseToParent,
+        reviewCapabilities,
+        allReviewCapabilities,
+    };
+}
+function resolveParentPhaseKey(merged, agentSlug) {
+    return merged.subPhaseToParent.get(agentSlug) ?? agentSlug;
+}
+//# sourceMappingURL=workflow-phase-config-loader.js.map

package/dist/builder/lib/workflow-phase-config-loader.js.map

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