@agent-teams/engineering-foundation 0.4.1 → 0.5.0

package/dist/scaffolding/cli-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.d.ts","sourceRoot":"","sources":["../../src/scaffolding/cli-command.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAkBD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAuDlB"}

package/dist/scaffolding/cli-command.js

@@ -0,0 +1,60 @@
+import { applyFilesystemScaffold, readScaffoldPlanFile, recoverFilesystemScaffold } from "./index.js";
+import { ScaffoldError } from "./scaffold-error.js";
+import { planScaffoldFromFile } from "./service.js";
+function renderPlan(plan) {
+    return `Scaffold Plan: ${plan.planDigest}\nProject: ${plan.projectId}\nComposition: ${plan.composition.id}\nTarget: ${plan.target.id} -> ${plan.target.path}\nOperations: ${plan.operations.length}\n`;
+}
+function renderReceipt(receipt) {
+    return `Scaffold Receipt: ${receipt.receiptDigest}\nPlan: ${receipt.planDigest}\nOutcome: ${receipt.outcome}\nOperations: ${receipt.operations.length}\n`;
+}
+function exitCode(receipt) {
+    return receipt.outcome === "applied" ||
+        receipt.outcome === "already-applied" ||
+        receipt.outcome === "failed-recovered"
+        ? 0
+        : 1;
+}
+export async function runScaffoldingCliCommand(parsed, json) {
+    switch (parsed.command) {
+        case "scaffold-apply": {
+            const planPath = parsed.positional[0];
+            if (planPath === undefined) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "scaffold-apply requires a repository-relative Plan path.");
+            }
+            const plan = await readScaffoldPlanFile(parsed.consumerRoot, planPath);
+            const receipt = await applyFilesystemScaffold(parsed.consumerRoot, plan);
+            process.stdout.write(json ? `${JSON.stringify(receipt, null, 2)}\n` : renderReceipt(receipt));
+            process.exitCode = exitCode(receipt);
+            return true;
+        }
+        case "scaffold-plan": {
+            const intentPath = parsed.positional[0];
+            if (intentPath === undefined) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "scaffold-plan requires a repository-relative Intent path.");
+            }
+            const plan = await planScaffoldFromFile({
+                consumerRoot: parsed.consumerRoot,
+                intentPath,
+                configPath: parsed.configPath
+            });
+            process.stdout.write(json ? `${JSON.stringify(plan, null, 2)}\n` : renderPlan(plan));
+            return true;
+        }
+        case "scaffold-recover": {
+            const receipt = await recoverFilesystemScaffold(parsed.consumerRoot);
+            if (receipt === undefined) {
+                process.stdout.write(json
+                    ? `${JSON.stringify({ outcome: "no-pending-transaction" }, null, 2)}\n`
+                    : "No pending scaffolding transaction.\n");
+            }
+            else {
+                process.stdout.write(json ? `${JSON.stringify(receipt, null, 2)}\n` : renderReceipt(receipt));
+                process.exitCode = exitCode(receipt);
+            }
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=cli-command.js.map

package/dist/scaffolding/cli-command.js.map

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

package/dist/scaffolding/contract/types.d.ts

@@ -0,0 +1,296 @@
+export type JsonPrimitive = boolean | null | number | string;
+export type JsonValue = JsonPrimitive | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+export type Sha256Digest = `sha256:${string}`;
+export type RepositoryPath = string;
+export interface DefinitionRef {
+    readonly id: string;
+    readonly contractVersion: number;
+}
+export interface ConfiguredDefinition {
+    readonly ref: DefinitionRef;
+    readonly parameters?: JsonObject;
+}
+export interface ScaffoldCompositionV1 {
+    readonly id: string;
+    readonly scaffoldProfile: ConfiguredDefinition;
+    readonly recipe: ConfiguredDefinition;
+    readonly targetRoles: readonly string[];
+    readonly fixedRecipeParameters?: JsonObject;
+    readonly defaultRecipeParameters?: JsonObject;
+    readonly facets?: {
+        readonly fixed?: readonly ConfiguredDefinition[];
+        readonly default?: readonly ConfiguredDefinition[];
+        readonly allowed?: readonly DefinitionRef[];
+    };
+    readonly policies: readonly ConfiguredDefinition[];
+}
+export interface ScaffoldingConfigV1 {
+    readonly schemaVersion: 1;
+    readonly projectId: string;
+    readonly targetCatalogPath: RepositoryPath;
+    readonly compositions: readonly ScaffoldCompositionV1[];
+}
+export interface ScaffoldIntentV1 {
+    readonly schemaVersion: 1;
+    readonly compositionId: string;
+    readonly targetRef: string;
+    readonly recipeParameters?: JsonObject;
+    readonly facets?: readonly ConfiguredDefinition[];
+}
+export interface ScaffoldTargetV1 {
+    readonly id: string;
+    readonly role: string;
+    readonly path: RepositoryPath;
+    readonly packageName: string;
+    readonly ownerDocument?: string;
+}
+export interface ScaffoldTargetCatalogV1 {
+    readonly version: 1;
+    readonly packages: readonly ScaffoldTargetV1[];
+}
+export interface ScaffoldDiagnosticV1 {
+    readonly ruleId: string;
+    readonly severity: "error" | "info" | "warning";
+    readonly phase: "apply" | "composition" | "input" | "planning" | "policy" | "recovery";
+    readonly subject: string;
+    readonly message: string;
+    readonly remediation: string;
+}
+export interface ScaffoldReadAssertionV1 {
+    readonly path: RepositoryPath;
+    readonly state: "file";
+    readonly digest: Sha256Digest;
+    readonly size: number;
+}
+export interface MaterializeFileOperationV1 {
+    readonly id: string;
+    readonly kind: "materialize-file";
+    readonly path: RepositoryPath;
+    readonly precondition: {
+        readonly state: "absent";
+    };
+    readonly after: {
+        readonly digest: Sha256Digest;
+        readonly size: number;
+        readonly mode: "0644";
+        readonly mediaType: string;
+        readonly contentBase64: string;
+    };
+    readonly causes: readonly string[];
+}
+export interface ScaffoldPlanV1 {
+    readonly schemaVersion: 1;
+    readonly protocolVersion: 1;
+    readonly compiler: {
+        readonly id: "@agent-teams/engineering-foundation";
+        readonly version: string;
+    };
+    readonly projectId: string;
+    readonly authority: {
+        readonly configPath: RepositoryPath;
+        readonly targetCatalogPath: RepositoryPath;
+    };
+    readonly intent: ScaffoldIntentV1;
+    readonly intentDigest: Sha256Digest;
+    readonly authoritySnapshotDigest: Sha256Digest;
+    readonly composition: {
+        readonly id: string;
+        readonly scaffoldProfile: DefinitionRef;
+        readonly recipe: DefinitionRef;
+        readonly facets: readonly DefinitionRef[];
+        readonly policies: readonly DefinitionRef[];
+    };
+    readonly definitions: readonly {
+        readonly kind: "facet" | "policy" | "recipe" | "scaffold-profile";
+        readonly ref: DefinitionRef;
+        readonly contractDigest: Sha256Digest;
+    }[];
+    readonly resolved: {
+        readonly profileParameters: JsonObject;
+        readonly recipeParameters: JsonObject;
+        readonly facets: readonly {
+            readonly ref: DefinitionRef;
+            readonly parameters: JsonObject;
+        }[];
+        readonly policies: readonly {
+            readonly ref: DefinitionRef;
+            readonly parameters: JsonObject;
+            readonly outcome: "passed";
+        }[];
+    };
+    readonly target: ScaffoldTargetV1;
+    readonly readSet: readonly ScaffoldReadAssertionV1[];
+    readonly requiredAdapterCapabilities: readonly ["materialize-file/v1"];
+    readonly operations: readonly MaterializeFileOperationV1[];
+    readonly diagnostics: readonly ScaffoldDiagnosticV1[];
+    readonly planDigest: Sha256Digest;
+}
+export type ScaffoldOperationOutcome = "already-satisfied" | "applied" | "conflict" | "not-applied" | "recovered";
+export interface ScaffoldOperationReceiptV1 {
+    readonly operationId: string;
+    readonly path: RepositoryPath;
+    readonly outcome: ScaffoldOperationOutcome;
+    readonly resultDigest?: Sha256Digest;
+}
+export type ScaffoldReceiptOutcome = "already-applied" | "applied" | "failed-recovered" | "recovery-required" | "rejected";
+export interface ScaffoldReceiptCommonV1 {
+    readonly schemaVersion: 1;
+    readonly protocolVersion: 1;
+    readonly planDigest: Sha256Digest;
+    readonly diagnostics: readonly ScaffoldDiagnosticV1[];
+    readonly receiptDigest: Sha256Digest;
+}
+export type ScaffoldReceiptV1 = (ScaffoldReceiptCommonV1 & {
+    readonly outcome: "applied";
+    readonly operations: readonly [
+        ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied" | "applied";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied" | "applied";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+} & ({
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "journaled-recoverable";
+    };
+} | {
+    readonly adapter: {
+        readonly id: "foundation.memory/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "memory-atomic";
+    };
+})) | (ScaffoldReceiptCommonV1 & {
+    readonly outcome: "already-applied";
+    readonly operations: readonly [
+        ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+} & ({
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "journaled-recoverable";
+    };
+} | {
+    readonly adapter: {
+        readonly id: "foundation.memory/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "memory-atomic";
+    };
+})) | (ScaffoldReceiptCommonV1 & {
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly outcome: "failed-recovered";
+    readonly commit: {
+        readonly state: "recovered";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied" | "recovered";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied" | "recovered";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+}) | (ScaffoldReceiptCommonV1 & {
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly outcome: "recovery-required";
+    readonly commit: {
+        readonly state: "recovery-required";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        (ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (ScaffoldOperationReceiptV1 & {
+            readonly outcome: "conflict" | "not-applied";
+            readonly resultDigest?: never;
+        }),
+        ...((ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (ScaffoldOperationReceiptV1 & {
+            readonly outcome: "conflict" | "not-applied";
+            readonly resultDigest?: never;
+        }))[]
+    ];
+}) | (ScaffoldReceiptCommonV1 & {
+    readonly outcome: "rejected";
+    readonly operations: readonly ((ScaffoldOperationReceiptV1 & {
+        readonly outcome: "already-satisfied";
+        readonly resultDigest: Sha256Digest;
+    }) | (ScaffoldOperationReceiptV1 & {
+        readonly outcome: "conflict" | "not-applied";
+        readonly resultDigest?: never;
+    }))[];
+} & ({
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "rejected";
+        readonly atomicity: "journaled-recoverable";
+    };
+} | {
+    readonly adapter: {
+        readonly id: "foundation.memory/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "rejected";
+        readonly atomicity: "memory-atomic";
+    };
+}));
+export interface ScaffoldCompilationInput {
+    readonly foundationVersion: string;
+    readonly configPath: RepositoryPath;
+    readonly config: ScaffoldingConfigV1;
+    readonly intent: ScaffoldIntentV1;
+    readonly catalog: ScaffoldTargetCatalogV1;
+    readonly authorityReadSet: readonly ScaffoldReadAssertionV1[];
+}
+export interface ScaffoldFileContribution {
+    readonly path: RepositoryPath;
+    readonly mediaType: string;
+    readonly content: string;
+    readonly causes: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scaffolding/contract/types.d.ts.map

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

package/dist/scaffolding/contract/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scaffolding/contract/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/scaffolding/contract/types.ts"],"names":[],"mappings":""}

package/dist/scaffolding/definitions/conformance-fixture.d.ts

@@ -0,0 +1,3 @@
+import type { ScaffoldDefinition } from "../kernel/definition-registry.js";
+export declare const CONFORMANCE_FIXTURE_DEFINITIONS: readonly ScaffoldDefinition[];
+//# sourceMappingURL=conformance-fixture.d.ts.map

package/dist/scaffolding/definitions/conformance-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance-fixture.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/definitions/conformance-fixture.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,kCAAkC,CAAC;AA0L1C,eAAO,MAAM,+BAA+B,EAAE,SAAS,kBAAkB,EAgGrE,CAAC"}

package/dist/scaffolding/definitions/conformance-fixture.js

@@ -0,0 +1,217 @@
+import { posix } from "node:path";
+import { ScaffoldError } from "../scaffold-error.js";
+const EMPTY_PARAMETERS_SCHEMA = Object.freeze({
+    type: "object",
+    additionalProperties: false
+});
+const PROFILE_PARAMETERS_SCHEMA = Object.freeze({
+    type: "object",
+    additionalProperties: false,
+    required: ["tsconfigBase"],
+    properties: {
+        tsconfigBase: {
+            type: "string",
+            minLength: 1,
+            maxLength: 512,
+            pattern: "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._@/-]+$"
+        }
+    }
+});
+const RECIPE_PARAMETERS_SCHEMA = Object.freeze({
+    type: "object",
+    additionalProperties: false,
+    required: ["featureId"],
+    properties: {
+        featureId: {
+            type: "string",
+            minLength: 1,
+            maxLength: 80,
+            pattern: "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        },
+        description: {
+            type: "string",
+            minLength: 1,
+            maxLength: 240
+        }
+    }
+});
+const TARGET_ROLE_POLICY_SCHEMA = Object.freeze({
+    type: "object",
+    additionalProperties: false,
+    required: ["allowedRoles"],
+    properties: {
+        allowedRoles: {
+            type: "array",
+            minItems: 1,
+            maxItems: 32,
+            uniqueItems: true,
+            items: {
+                type: "string",
+                minLength: 1,
+                maxLength: 80,
+                pattern: "^[a-z0-9][a-z0-9._/-]*$"
+            }
+        }
+    }
+});
+function requiredString(parameters, key) {
+    const value = parameters[key];
+    if (typeof value !== "string") {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Missing validated string parameter: ${key}.`);
+    }
+    return value;
+}
+function repositoryFile(context, relativePath, content, causes, mediaType = "text/plain") {
+    return Object.freeze({
+        path: posix.join(context.target.path, relativePath),
+        mediaType,
+        content,
+        causes
+    });
+}
+function recipeFiles(context) {
+    const featureId = requiredString(context.recipeParameters, "featureId");
+    const description = context.recipeParameters.description;
+    const tsconfigBase = requiredString(context.profileParameters, "tsconfigBase");
+    const extendsPath = posix.relative(context.target.path, tsconfigBase);
+    const packageManifest = {
+        name: context.target.packageName,
+        version: "0.0.0",
+        private: true,
+        ...(typeof description === "string" ? { description } : {}),
+        type: "module",
+        exports: {
+            ".": "./src/index.ts"
+        },
+        scripts: {
+            typecheck: "tsc --project tsconfig.json --noEmit --pretty false"
+        }
+    };
+    const tsconfig = {
+        extends: extendsPath.startsWith(".") ? extendsPath : `./${extendsPath}`,
+        compilerOptions: {
+            composite: true,
+            declaration: true,
+            declarationMap: true,
+            noEmit: false,
+            outDir: "dist",
+            rootDir: "src",
+            tsBuildInfoFile: "dist/.tsbuildinfo"
+        },
+        include: ["src/**/*.ts"]
+    };
+    const identitySource = `export const fixtureIdentity = Object.freeze({\n  featureId: ${JSON.stringify(featureId)},\n  packageName: ${JSON.stringify(context.target.packageName)}\n});\n`;
+    const entrypointSource = `export { fixtureIdentity } from "./features/${featureId}/index.js";\n`;
+    return Object.freeze([
+        repositoryFile(context, "package.json", `${JSON.stringify(packageManifest, null, 2)}\n`, ["foundation.conformance-fixture-package"], "application/json"),
+        repositoryFile(context, "tsconfig.json", `${JSON.stringify(tsconfig, null, 2)}\n`, ["foundation.conformance-fixture-package"], "application/json"),
+        repositoryFile(context, `src/features/${featureId}/index.ts`, identitySource, ["foundation.conformance-fixture-package"]),
+        repositoryFile(context, "src/index.ts", entrypointSource, ["foundation.conformance-fixture-package"])
+    ]);
+}
+function typecheckFixtureFiles(context) {
+    const featureId = requiredString(context.recipeParameters, "featureId");
+    const source = `import { fixtureIdentity } from "./index.js";\n\nexport const fixtureFeatureId: string = fixtureIdentity.featureId;\nexport const expectedFixtureFeatureId = ${JSON.stringify(featureId)};\n`;
+    return Object.freeze([
+        repositoryFile(context, `src/features/${featureId}/index.contract.ts`, source, ["foundation.typecheck-fixture"])
+    ]);
+}
+function fixtureReadmeFiles(context) {
+    const featureId = requiredString(context.recipeParameters, "featureId");
+    const source = `# ${context.target.packageName}\n\nDeterministic conformance fixture for \`${featureId}\`.\n`;
+    return Object.freeze([
+        repositoryFile(context, "README.md", source, ["foundation.fixture-readme"], "text/markdown")
+    ]);
+}
+export const CONFORMANCE_FIXTURE_DEFINITIONS = Object.freeze([
+    {
+        kind: "scaffold-profile",
+        ref: {
+            id: "foundation.node-typescript-fixture",
+            contractVersion: 1
+        },
+        descriptor: {
+            kind: "scaffold-profile",
+            id: "foundation.node-typescript-fixture",
+            contractVersion: 1,
+            semantics: "node-typescript-testing-only"
+        },
+        parameterSchema: PROFILE_PARAMETERS_SCHEMA,
+        allowedRecipeIds: ["foundation.conformance-fixture-package"],
+        requiredPolicies: [
+            {
+                ref: { id: "foundation.target-role", contractVersion: 1 },
+                parameters: { allowedRoles: ["testing"] }
+            }
+        ]
+    },
+    {
+        kind: "recipe",
+        ref: {
+            id: "foundation.conformance-fixture-package",
+            contractVersion: 1
+        },
+        descriptor: {
+            kind: "recipe",
+            id: "foundation.conformance-fixture-package",
+            contractVersion: 1,
+            semantics: "materialize-a-non-product-conformance-package"
+        },
+        parameterSchema: RECIPE_PARAMETERS_SCHEMA,
+        allowedProfileIds: ["foundation.node-typescript-fixture"],
+        allowedTargetRoles: ["testing"],
+        requiredPolicies: [],
+        compile: recipeFiles
+    },
+    {
+        kind: "facet",
+        ref: { id: "foundation.typecheck-fixture", contractVersion: 1 },
+        descriptor: {
+            kind: "facet",
+            id: "foundation.typecheck-fixture",
+            contractVersion: 1,
+            semantics: "compile-time-contract-for-conformance-fixture"
+        },
+        parameterSchema: EMPTY_PARAMETERS_SCHEMA,
+        allowedRecipeIds: ["foundation.conformance-fixture-package"],
+        requires: [],
+        conflicts: [],
+        requiredPolicies: [],
+        compile: typecheckFixtureFiles
+    },
+    {
+        kind: "facet",
+        ref: { id: "foundation.fixture-readme", contractVersion: 1 },
+        descriptor: {
+            kind: "facet",
+            id: "foundation.fixture-readme",
+            contractVersion: 1,
+            semantics: "readme-for-conformance-fixture"
+        },
+        parameterSchema: EMPTY_PARAMETERS_SCHEMA,
+        allowedRecipeIds: ["foundation.conformance-fixture-package"],
+        requires: [],
+        conflicts: [],
+        requiredPolicies: [],
+        compile: fixtureReadmeFiles
+    },
+    {
+        kind: "policy",
+        ref: { id: "foundation.target-role", contractVersion: 1 },
+        descriptor: {
+            kind: "policy",
+            id: "foundation.target-role",
+            contractVersion: 1,
+            semantics: "target-role-must-be-explicitly-allowed"
+        },
+        parameterSchema: TARGET_ROLE_POLICY_SCHEMA,
+        evaluate(context, parameters) {
+            const allowedRoles = parameters.allowedRoles;
+            if (!Array.isArray(allowedRoles) ||
+                !allowedRoles.includes(context.target.role)) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Target role ${context.target.role} is not allowed by the selected composition.`);
+            }
+        }
+    }
+]);
+//# sourceMappingURL=conformance-fixture.js.map

package/dist/scaffolding/definitions/conformance-fixture.js.map

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

package/dist/scaffolding/definitions/registry.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldDefinitionRegistry } from "../kernel/definition-registry.js";
+export declare function createDefaultScaffoldRegistry(): ScaffoldDefinitionRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/scaffolding/definitions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/definitions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAG9E,wBAAgB,6BAA6B,IAAI,0BAA0B,CAE1E"}

package/dist/scaffolding/definitions/registry.js

@@ -0,0 +1,6 @@
+import { ScaffoldDefinitionRegistry } from "../kernel/definition-registry.js";
+import { CONFORMANCE_FIXTURE_DEFINITIONS } from "./conformance-fixture.js";
+export function createDefaultScaffoldRegistry() {
+    return new ScaffoldDefinitionRegistry(CONFORMANCE_FIXTURE_DEFINITIONS);
+}
+//# sourceMappingURL=registry.js.map

package/dist/scaffolding/definitions/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/scaffolding/definitions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAE3E,MAAM,UAAU,6BAA6B;IAC3C,OAAO,IAAI,0BAA0B,CAAC,+BAA+B,CAAC,CAAC;AACzE,CAAC"}