@fabricorg/archetypes 2.0.2 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @fabricorg/archetypes
 
+## 2.1.0
+
+### Minor Changes
+
+- 4c358ad: The archetype set was closed: a module annotated with an id outside the six shipped ones reported `unknown_archetype` and could not be certified. A platform meant for verticals nobody has named yet cannot ship their nouns, so the seam is now the definition. `defineArchetype` validates a vertical's own archetype structurally, and `createArchetypeConformance` builds `validate`, `assert`, and a manifest conformance adapter over that set, including the six reference archetypes by default and carrying an adapter id distinct from the shipped adapter's. The `fabric.` namespace is reserved for the reference set. `validateArchetypeConformance` and `assertArchetypeConformance` accept an optional definition set and behave exactly as before without one.
+
+  Two validator corrections found on the way: the exception-guard check compared a state's name to the literal `exception` rather than its class, so a vertical that named its exception state anything else was never checked; it now checks the class. And every shipped archetype now passes `defineArchetype`, which required the rule "a state to start in" to admit an active state, since `fabric.Offering` is born available.
+
+  Disclosed as a type change: `ArchetypeId` stays the closed reference union, and `ArchetypeReference.id` and `ArchetypeDefinition.id` widen to `AnyArchetypeId`, the union with any string, so code that switched exhaustively on a reference's id will see a wider type.
+
 ## 2.0.2
 
 ### Patch Changes

package/README.md

@@ -26,3 +26,18 @@ const registry = createModuleRegistry([module]);
 Use `validateArchetypeConformance` for report-only build tooling. Use
 `assertArchetypeConformance` explicitly before Platform registration when startup enforcement is
 required. Base Platform registration never interprets archetype annotations.
+
+## Your own archetypes
+
+The six shipped archetypes are a reference vocabulary, not the whole set. A vertical defines its own
+with `defineArchetype` and certifies against it with `createArchetypeConformance`, which includes the
+reference set by default so one assembly certifies both:
+
+```ts
+const conformance = createArchetypeConformance([defineArchetype({ id: "outdoor.Relationship", /* ... */ })]);
+conformance.assert(module);
+```
+
+Ids are `<namespace>.<PascalName>`. A definition is validated structurally before it can certify
+anything, and an id that collides with a reference archetype under a different meaning is refused.
+

package/dist/index.cjs

@@ -21,16 +21,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ARCHETYPES: () => ARCHETYPES,
+  ARCHETYPE_ID: () => ARCHETYPE_ID,
   ARCHETYPE_SEMANTIC_KEY: () => ARCHETYPE_SEMANTIC_KEY,
   archetypeConformanceAdapter: () => archetypeConformanceAdapter,
   archetypeSemantics: () => archetypeSemantics,
   assertArchetypeConformance: () => assertArchetypeConformance,
+  createArchetypeConformance: () => createArchetypeConformance,
+  defineArchetype: () => defineArchetype,
   readArchetypeReference: () => readArchetypeReference,
   validateArchetypeConformance: () => validateArchetypeConformance
 });
 module.exports = __toCommonJS(index_exports);
 var import_platform = require("@fabricorg/platform");
 var ARCHETYPE_SEMANTIC_KEY = "fabric.archetype";
+var ARCHETYPE_ID = /^[a-z][a-z0-9-]*\.[A-Z][A-Za-z0-9]*$/;
+var RESERVED_NAMESPACE = "fabric.";
 var states = (definitions) => Object.fromEntries(definitions.map(([id, stateClass]) => [id, { id, stateClass }]));
 var ARCHETYPES = {
   "fabric.Party": {
@@ -82,6 +87,99 @@ var ARCHETYPES = {
     obligations: ["value and currency are explicit", "settlement is attributable to an agreement"]
   }
 };
+var STATE_CLASSES = /* @__PURE__ */ new Set(["initial", "active", "waiting", "terminal", "exception"]);
+function defineArchetype(definition) {
+  if (typeof definition.id !== "string" || !ARCHETYPE_ID.test(definition.id)) {
+    throw new Error(`Archetype id "${String(definition.id)}" must be <namespace>.<PascalName>.`);
+  }
+  if (typeof definition.version !== "string" || definition.version.trim() === "") {
+    throw new Error(`Archetype "${definition.id}" must declare a version.`);
+  }
+  if (typeof definition.description !== "string" || definition.description.trim() === "") {
+    throw new Error(`Archetype "${definition.id}" must describe what it classifies.`);
+  }
+  if (!definition.states || typeof definition.states !== "object" || Array.isArray(definition.states)) {
+    throw new Error(`Archetype "${definition.id}" must declare its states as a record keyed by id.`);
+  }
+  const stateIds = Object.keys(definition.states);
+  if (stateIds.length === 0) throw new Error(`Archetype "${definition.id}" must declare at least one state.`);
+  for (const [key, state] of Object.entries(definition.states)) {
+    if (!state || state.id !== key) throw new Error(`Archetype "${definition.id}" state "${key}" must be keyed by its own id.`);
+    if (!STATE_CLASSES.has(state.stateClass)) throw new Error(`Archetype "${definition.id}" state "${key}" has unknown state class "${String(state.stateClass)}".`);
+  }
+  if (!Object.values(definition.states).some((state) => state.stateClass === "initial" || state.stateClass === "active")) {
+    throw new Error(`Archetype "${definition.id}" must declare an initial or active state to start in.`);
+  }
+  if (!Object.values(definition.states).some((state) => state.stateClass === "terminal" || state.stateClass === "exception")) {
+    throw new Error(`Archetype "${definition.id}" must declare a terminal or exception state, or nothing ever ends.`);
+  }
+  if (!Array.isArray(definition.transitions)) {
+    throw new Error(`Archetype "${definition.id}" must declare its transitions as an array.`);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const transition of definition.transitions) {
+    if (!Object.hasOwn(definition.states, transition.from) || !Object.hasOwn(definition.states, transition.to)) {
+      throw new Error(`Archetype "${definition.id}" transition "${transition.from}" -> "${transition.to}" names an undeclared state.`);
+    }
+    if (transition.from === transition.to) throw new Error(`Archetype "${definition.id}" transition "${transition.from}" -> "${transition.to}" is a self-loop.`);
+    const key = transitionKey(transition.from, transition.to);
+    if (seen.has(key)) throw new Error(`Archetype "${definition.id}" declares transition "${transition.from}" -> "${transition.to}" twice.`);
+    seen.add(key);
+  }
+  if (!Array.isArray(definition.obligations) || definition.obligations.some((item) => typeof item !== "string" || item.trim() === "")) {
+    throw new Error(`Archetype "${definition.id}" obligations must be non-empty strings.`);
+  }
+  if (definition.id.startsWith(RESERVED_NAMESPACE)) {
+    const reference = Object.hasOwn(ARCHETYPES, definition.id) ? ARCHETYPES[definition.id] : void 0;
+    if (!reference || !sameArchetype(reference, definition)) {
+      throw new Error(`Archetype "${definition.id}" uses the reserved "fabric." namespace; choose a namespace of your own.`);
+    }
+  }
+  return Object.freeze({
+    id: definition.id,
+    version: definition.version,
+    description: definition.description,
+    states: Object.freeze(Object.fromEntries(Object.entries(definition.states).map(([key, state]) => [key, Object.freeze({ ...state })]))),
+    transitions: Object.freeze(definition.transitions.map((transition) => Object.freeze({ ...transition }))),
+    obligations: Object.freeze([...definition.obligations])
+  });
+}
+function createArchetypeConformance(definitions, options = {}) {
+  const merged = options.includeReference === false ? {} : { ...ARCHETYPES };
+  for (const definition of definitions) {
+    const defined = defineArchetype(definition);
+    const existing = merged[defined.id];
+    if (existing && !sameArchetype(existing, defined)) {
+      throw new Error(`Archetype "${defined.id}" is defined twice.`);
+    }
+    merged[defined.id] = existing ?? defined;
+  }
+  const frozen = Object.freeze(merged);
+  const validate = (manifest) => validateArchetypeConformance(manifest, frozen);
+  const adapterId = options.id ?? `@fabricorg/archetypes:${[
+    ...options.includeReference === false ? [] : ["reference"],
+    ...definitions.map((definition) => definition.id).sort()
+  ].join("+") || "none"}`;
+  return {
+    definitions: frozen,
+    validate,
+    assert(module2) {
+      assertArchetypeConformance(module2, frozen);
+    },
+    adapter: { id: adapterId, evaluate: validate }
+  };
+}
+function sameArchetype(left, right) {
+  const canonical = (definition) => JSON.stringify({
+    id: definition.id,
+    version: definition.version,
+    description: definition.description,
+    states: Object.keys(definition.states).sort().map((key) => [key, definition.states[key].stateClass]),
+    transitions: definition.transitions.map((transition) => JSON.stringify([transition.from, transition.to, transition.required === true])).sort(),
+    obligations: [...definition.obligations].sort()
+  });
+  return canonical(left) === canonical(right);
+}
 function archetypeSemantics(reference) {
   return { [ARCHETYPE_SEMANTIC_KEY]: reference };
 }
@@ -95,17 +193,17 @@ function readArchetypeReference(objectType) {
   return { id: record.id, version: record.version, stateMap: record.stateMap };
 }
 var transitionKey = (from, to) => `${from}->${to}`;
-function validateArchetypeConformance(manifest) {
-  return manifest.objectTypes.filter((objectType) => objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY] !== void 0).map((objectType) => validateObject(manifest, objectType));
+function validateArchetypeConformance(manifest, definitions = ARCHETYPES) {
+  return manifest.objectTypes.filter((objectType) => objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY] !== void 0).map((objectType) => validateObject(manifest, objectType, definitions));
 }
-function validateObject(manifest, objectType) {
+function validateObject(manifest, objectType, definitions) {
   const findings = [];
   const reference = readArchetypeReference(objectType);
   if (!reference) {
     findings.push({ code: "invalid_annotation", objectType: objectType.type, message: `Object "${objectType.type}" has an invalid ${ARCHETYPE_SEMANTIC_KEY} annotation.` });
     return { conforms: false, objectType: objectType.type, findings };
   }
-  const definition = ARCHETYPES[reference.id];
+  const definition = Object.hasOwn(definitions, reference.id) ? definitions[reference.id] : void 0;
   if (!definition) {
     findings.push({ code: "unknown_archetype", objectType: objectType.type, message: `Unknown archetype "${reference.id}".` });
     return { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };
@@ -128,7 +226,7 @@ function validateObject(manifest, objectType) {
       findings.push({ code: "unmapped_state", objectType: objectType.type, state: state.id, message: `State "${state.id}" is not mapped.` });
       continue;
     }
-    const base = definition.states[mapped];
+    const base = Object.hasOwn(definition.states, mapped) ? definition.states[mapped] : void 0;
     if (!base) {
       findings.push({ code: "unknown_archetype_state", objectType: objectType.type, state: state.id, target: mapped, message: `State "${state.id}" maps to unknown archetype state "${mapped}".` });
     } else if (base.stateClass !== state.stateClass) {
@@ -141,7 +239,7 @@ function validateObject(manifest, objectType) {
     const from = reference.stateMap[transition.from];
     const to = reference.stateMap[transition.to];
     if (!from || !to) continue;
-    if (to === "exception" && !transition.hasGuard) {
+    if (Object.hasOwn(definition.states, to) && definition.states[to].stateClass === "exception" && !transition.hasGuard) {
       findings.push({ code: "exception_transition_unguarded", objectType: objectType.type, state: transition.from, target: transition.to, message: `Exception transition "${transition.from}" -> "${transition.to}" must declare a governance guard.` });
     }
     if (from !== to && !permitted.has(transitionKey(from, to))) {
@@ -157,8 +255,8 @@ function validateObject(manifest, objectType) {
   }
   return { conforms: findings.length === 0, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };
 }
-function assertArchetypeConformance(module2) {
-  const failures = validateArchetypeConformance((0, import_platform.exportModuleManifest)(module2)).filter((report) => !report.conforms);
+function assertArchetypeConformance(module2, definitions = ARCHETYPES) {
+  const failures = validateArchetypeConformance((0, import_platform.exportModuleManifest)(module2), definitions).filter((report) => !report.conforms);
   if (failures.length > 0) {
     throw new Error(`Archetype conformance failed:
 ${failures.flatMap((report) => report.findings.map((finding) => `- ${report.objectType}: ${finding.message}`)).join("\n")}`);
@@ -171,10 +269,13 @@ var archetypeConformanceAdapter = {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ARCHETYPES,
+  ARCHETYPE_ID,
   ARCHETYPE_SEMANTIC_KEY,
   archetypeConformanceAdapter,
   archetypeSemantics,
   assertArchetypeConformance,
+  createArchetypeConformance,
+  defineArchetype,
   readArchetypeReference,
   validateArchetypeConformance
 });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts"],"sourcesContent":["import {\n\texportModuleManifest,\n\ttype FabricModule,\n\ttype JsonValue,\n\ttype ModuleManifest,\n\ttype ModuleManifestObjectType,\n\ttype StateClass,\n} from \"@fabricorg/platform\";\n\nexport const ARCHETYPE_SEMANTIC_KEY = \"fabric.archetype\" as const;\n\nexport type ArchetypeId =\n\t| \"fabric.Party\"\n\t| \"fabric.Offering\"\n\t| \"fabric.Agreement\"\n\t| \"fabric.Resource\"\n\t| \"fabric.Activity\"\n\t| \"fabric.Settlement\";\n\nexport interface ArchetypeReference {\n\tid: ArchetypeId;\n\tversion: string;\n\tstateMap: Record<string, string>;\n}\n\nexport interface ArchetypeState {\n\tid: string;\n\tstateClass: StateClass;\n}\n\nexport interface ArchetypeTransition {\n\tfrom: string;\n\tto: string;\n\trequired?: boolean;\n}\n\nexport interface ArchetypeDefinition {\n\tid: ArchetypeId;\n\tversion: string;\n\tdescription: string;\n\tstates: Record<string, ArchetypeState>;\n\ttransitions: ArchetypeTransition[];\n\tobligations: string[];\n}\n\nexport type ConformanceFindingCode =\n\t| \"invalid_annotation\"\n\t| \"unknown_archetype\"\n\t| \"unsupported_archetype_version\"\n\t| \"missing_state_machine\"\n\t| \"unmapped_state\"\n\t| \"unknown_mapped_state\"\n\t| \"unknown_archetype_state\"\n\t| \"incompatible_state_class\"\n\t| \"transition_not_permitted\"\n\t| \"exception_transition_unguarded\"\n\t| \"required_transition_unreachable\";\n\nexport interface ConformanceFinding {\n\tcode: ConformanceFindingCode;\n\tmessage: string;\n\tobjectType: string;\n\tstate?: string;\n\ttarget?: string;\n}\n\nexport interface ArchetypeConformanceReport {\n\tconforms: boolean;\n\tobjectType: string;\n\tarchetype?: string;\n\tfindings: ConformanceFinding[];\n}\n\nexport interface ManifestConformanceAdapter {\n\tid: string;\n\tevaluate(manifest: ModuleManifest): ArchetypeConformanceReport[];\n}\n\nconst states = (definitions: Array<[string, StateClass]>): Record<string, ArchetypeState> =>\n\tObject.fromEntries(definitions.map(([id, stateClass]) => [id, { id, stateClass }]));\n\nexport const ARCHETYPES: Readonly<Record<ArchetypeId, ArchetypeDefinition>> = {\n\t\"fabric.Party\": {\n\t\tid: \"fabric.Party\", version: \"0.1\", description: \"A person or organization participating in business relationships.\",\n\t\tstates: states([[\"prospective\", \"initial\"], [\"active\", \"active\"], [\"inactive\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"prospective\", to: \"active\", required: true }, { from: \"active\", to: \"inactive\" }, { from: \"prospective\", to: \"exception\" }, { from: \"active\", to: \"exception\" }],\n\t\tobligations: [\"identity is tenant-scoped\", \"participation is attributable\"],\n\t},\n\t\"fabric.Offering\": {\n\t\tid: \"fabric.Offering\", version: \"0.1\", description: \"Something a party makes available under defined terms.\",\n\t\tstates: states([[\"available\", \"active\"], [\"retired\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"available\", to: \"retired\" }, { from: \"available\", to: \"exception\" }],\n\t\tobligations: [\"terms are identifiable\", \"availability is explicit\"],\n\t},\n\t\"fabric.Agreement\": {\n\t\tid: \"fabric.Agreement\", version: \"0.1\", description: \"A governed commitment between parties.\",\n\t\tstates: states([[\"proposed\", \"initial\"], [\"committed\", \"active\"], [\"resolved\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"proposed\", to: \"committed\", required: true }, { from: \"committed\", to: \"resolved\", required: true }, { from: \"proposed\", to: \"exception\" }, { from: \"committed\", to: \"exception\" }],\n\t\tobligations: [\"participating parties are attributable\", \"commitment and resolution are auditable\"],\n\t},\n\t\"fabric.Resource\": {\n\t\tid: \"fabric.Resource\", version: \"0.1\", description: \"A capacity or asset allocated by activities.\",\n\t\tstates: states([[\"available\", \"initial\"], [\"allocated\", \"active\"], [\"retired\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"available\", to: \"allocated\", required: true }, { from: \"allocated\", to: \"available\" }, { from: \"available\", to: \"retired\" }, { from: \"allocated\", to: \"exception\" }],\n\t\tobligations: [\"allocation is identifiable\", \"conflicting allocation is governed\"],\n\t},\n\t\"fabric.Activity\": {\n\t\tid: \"fabric.Activity\", version: \"0.1\", description: \"Work planned and performed toward an outcome.\",\n\t\tstates: states([[\"planned\", \"initial\"], [\"executing\", \"active\"], [\"waiting\", \"waiting\"], [\"completed\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"planned\", to: \"executing\", required: true }, { from: \"executing\", to: \"waiting\" }, { from: \"waiting\", to: \"executing\" }, { from: \"executing\", to: \"completed\", required: true }, { from: \"waiting\", to: \"completed\" }, { from: \"planned\", to: \"exception\" }, { from: \"executing\", to: \"exception\" }, { from: \"waiting\", to: \"exception\" }],\n\t\tobligations: [\"responsible party is attributable\", \"resource use and outcome are auditable\"],\n\t},\n\t\"fabric.Settlement\": {\n\t\tid: \"fabric.Settlement\", version: \"0.1\", description: \"Resolution of value exchange associated with an agreement.\",\n\t\tstates: states([[\"pending\", \"initial\"], [\"settled\", \"terminal\"], [\"reversed\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"pending\", to: \"settled\", required: true }, { from: \"settled\", to: \"reversed\" }, { from: \"pending\", to: \"exception\" }],\n\t\tobligations: [\"value and currency are explicit\", \"settlement is attributable to an agreement\"],\n\t},\n};\n\nexport function archetypeSemantics(reference: ArchetypeReference): Record<string, JsonValue> {\n\treturn { [ARCHETYPE_SEMANTIC_KEY]: reference as unknown as JsonValue };\n}\n\nexport function readArchetypeReference(\n\tobjectType: ModuleManifestObjectType,\n): ArchetypeReference | undefined {\n\tconst value = objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY];\n\tif (value === undefined) return undefined;\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst record = value as Record<string, JsonValue>;\n\tif (typeof record.id !== \"string\" || typeof record.version !== \"string\" || !record.stateMap || typeof record.stateMap !== \"object\" || Array.isArray(record.stateMap)) return undefined;\n\tif (!Object.values(record.stateMap).every((state) => typeof state === \"string\")) return undefined;\n\treturn { id: record.id as ArchetypeId, version: record.version, stateMap: record.stateMap as Record<string, string> };\n}\n\nconst transitionKey = (from: string, to: string) => `${from}->${to}`;\n\nexport function validateArchetypeConformance(\n\tmanifest: ModuleManifest,\n): ArchetypeConformanceReport[] {\n\treturn manifest.objectTypes\n\t\t.filter((objectType) => objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY] !== undefined)\n\t\t.map((objectType) => validateObject(manifest, objectType));\n}\n\nfunction validateObject(\n\tmanifest: ModuleManifest,\n\tobjectType: ModuleManifestObjectType,\n): ArchetypeConformanceReport {\n\tconst findings: ConformanceFinding[] = [];\n\tconst reference = readArchetypeReference(objectType);\n\tif (!reference) {\n\t\tfindings.push({ code: \"invalid_annotation\", objectType: objectType.type, message: `Object \"${objectType.type}\" has an invalid ${ARCHETYPE_SEMANTIC_KEY} annotation.` });\n\t\treturn { conforms: false, objectType: objectType.type, findings };\n\t}\n\tconst definition = ARCHETYPES[reference.id];\n\tif (!definition) {\n\t\tfindings.push({ code: \"unknown_archetype\", objectType: objectType.type, message: `Unknown archetype \"${reference.id}\".` });\n\t\treturn { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n\t}\n\tif (reference.version !== definition.version) {\n\t\tfindings.push({ code: \"unsupported_archetype_version\", objectType: objectType.type, message: `Archetype \"${reference.id}\" supports version ${definition.version}, received ${reference.version}.` });\n\t}\n\tconst machine = (manifest.stateMachines ?? []).find((candidate) => candidate.entityType === objectType.type);\n\tif (!machine) {\n\t\tfindings.push({ code: \"missing_state_machine\", objectType: objectType.type, message: `Object \"${objectType.type}\" needs a state machine for archetype conformance.` });\n\t\treturn { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n\t}\n\tconst declaredStates = new Set(machine.states.map((state) => state.id));\n\tfor (const state of Object.keys(reference.stateMap)) {\n\t\tif (!declaredStates.has(state)) findings.push({ code: \"unknown_mapped_state\", objectType: objectType.type, state, message: `State mapping \"${state}\" does not name a declared state.` });\n\t}\n\tfor (const state of machine.states) {\n\t\tconst mapped = reference.stateMap[state.id];\n\t\tif (!mapped) {\n\t\t\tfindings.push({ code: \"unmapped_state\", objectType: objectType.type, state: state.id, message: `State \"${state.id}\" is not mapped.` });\n\t\t\tcontinue;\n\t\t}\n\t\tconst base = definition.states[mapped];\n\t\tif (!base) {\n\t\t\tfindings.push({ code: \"unknown_archetype_state\", objectType: objectType.type, state: state.id, target: mapped, message: `State \"${state.id}\" maps to unknown archetype state \"${mapped}\".` });\n\t\t} else if (base.stateClass !== state.stateClass) {\n\t\t\tfindings.push({ code: \"incompatible_state_class\", objectType: objectType.type, state: state.id, target: mapped, message: `State \"${state.id}\" (${state.stateClass}) is incompatible with \"${mapped}\" (${base.stateClass}).` });\n\t\t}\n\t}\n\tconst permitted = new Set(definition.transitions.map((transition) => transitionKey(transition.from, transition.to)));\n\tconst realized = new Set<string>();\n\tfor (const transition of machine.transitions) {\n\t\tconst from = reference.stateMap[transition.from];\n\t\tconst to = reference.stateMap[transition.to];\n\t\tif (!from || !to) continue;\n\t\tif (to === \"exception\" && !transition.hasGuard) {\n\t\t\tfindings.push({ code: \"exception_transition_unguarded\", objectType: objectType.type, state: transition.from, target: transition.to, message: `Exception transition \"${transition.from}\" -> \"${transition.to}\" must declare a governance guard.` });\n\t\t}\n\t\tif (from !== to && !permitted.has(transitionKey(from, to))) {\n\t\t\tfindings.push({ code: \"transition_not_permitted\", objectType: objectType.type, state: transition.from, target: transition.to, message: `Transition \"${transition.from}\" -> \"${transition.to}\" maps to disallowed archetype transition \"${from}\" -> \"${to}\".` });\n\t\t} else if (from !== to) {\n\t\t\trealized.add(transitionKey(from, to));\n\t\t}\n\t}\n\tfor (const required of definition.transitions.filter((transition) => transition.required)) {\n\t\tif (!realized.has(transitionKey(required.from, required.to))) {\n\t\t\tfindings.push({ code: \"required_transition_unreachable\", objectType: objectType.type, state: required.from, target: required.to, message: `Required archetype transition \"${required.from}\" -> \"${required.to}\" is not realized.` });\n\t\t}\n\t}\n\treturn { conforms: findings.length === 0, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n}\n\nexport function assertArchetypeConformance(module: FabricModule<unknown>): void {\n\tconst failures = validateArchetypeConformance(exportModuleManifest(module)).filter((report) => !report.conforms);\n\tif (failures.length > 0) {\n\t\tthrow new Error(`Archetype conformance failed:\\n${failures.flatMap((report) => report.findings.map((finding) => `- ${report.objectType}: ${finding.message}`)).join(\"\\n\")}`);\n\t}\n}\n\nexport const archetypeConformanceAdapter: ManifestConformanceAdapter = {\n\tid: \"@fabricorg/archetypes\",\n\tevaluate: validateArchetypeConformance,\n};\n"],"mappings":"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","names":["module"]}
+{"version":3,"sources":["../index.ts"],"sourcesContent":["import {\n\texportModuleManifest,\n\ttype FabricModule,\n\ttype JsonValue,\n\ttype ModuleManifest,\n\ttype ModuleManifestObjectType,\n\ttype StateClass,\n} from \"@fabricorg/platform\";\n\nexport const ARCHETYPE_SEMANTIC_KEY = \"fabric.archetype\" as const;\n\n/** The six archetypes this package ships. A reference vocabulary, not the whole vocabulary. */\nexport type ArchetypeId =\n\t| \"fabric.Party\"\n\t| \"fabric.Offering\"\n\t| \"fabric.Agreement\"\n\t| \"fabric.Resource\"\n\t| \"fabric.Activity\"\n\t| \"fabric.Settlement\";\n\n/** The same set under the name that says what it is. */\nexport type ReferenceArchetypeId = ArchetypeId;\n\n/**\n * Any archetype id a reference may name: a shipped one, or one a vertical\n * defined with `defineArchetype`. The intersection keeps editor completion for\n * the shipped ids without closing the set.\n */\nexport type AnyArchetypeId = ArchetypeId | (string & {});\n\n/** `<namespace>.<PascalName>`, so a vertical's vocabulary cannot be mistaken for the reference set. */\nexport const ARCHETYPE_ID = /^[a-z][a-z0-9-]*\\.[A-Z][A-Za-z0-9]*$/;\n\n/** Only the reference set may live under this namespace. */\nconst RESERVED_NAMESPACE = \"fabric.\";\n\nexport interface ArchetypeReference {\n\tid: AnyArchetypeId;\n\tversion: string;\n\tstateMap: Record<string, string>;\n}\n\nexport interface ArchetypeState {\n\tid: string;\n\tstateClass: StateClass;\n}\n\nexport interface ArchetypeTransition {\n\tfrom: string;\n\tto: string;\n\trequired?: boolean;\n}\n\nexport interface ArchetypeDefinition {\n\tid: AnyArchetypeId;\n\tversion: string;\n\tdescription: string;\n\tstates: Record<string, ArchetypeState>;\n\ttransitions: ArchetypeTransition[];\n\tobligations: string[];\n}\n\nexport type ConformanceFindingCode =\n\t| \"invalid_annotation\"\n\t| \"unknown_archetype\"\n\t| \"unsupported_archetype_version\"\n\t| \"missing_state_machine\"\n\t| \"unmapped_state\"\n\t| \"unknown_mapped_state\"\n\t| \"unknown_archetype_state\"\n\t| \"incompatible_state_class\"\n\t| \"transition_not_permitted\"\n\t| \"exception_transition_unguarded\"\n\t| \"required_transition_unreachable\";\n\nexport interface ConformanceFinding {\n\tcode: ConformanceFindingCode;\n\tmessage: string;\n\tobjectType: string;\n\tstate?: string;\n\ttarget?: string;\n}\n\nexport interface ArchetypeConformanceReport {\n\tconforms: boolean;\n\tobjectType: string;\n\tarchetype?: string;\n\tfindings: ConformanceFinding[];\n}\n\nexport interface ManifestConformanceAdapter {\n\tid: string;\n\tevaluate(manifest: ModuleManifest): ArchetypeConformanceReport[];\n}\n\nconst states = (definitions: Array<[string, StateClass]>): Record<string, ArchetypeState> =>\n\tObject.fromEntries(definitions.map(([id, stateClass]) => [id, { id, stateClass }]));\n\nexport const ARCHETYPES: Readonly<Record<ArchetypeId, ArchetypeDefinition>> = {\n\t\"fabric.Party\": {\n\t\tid: \"fabric.Party\", version: \"0.1\", description: \"A person or organization participating in business relationships.\",\n\t\tstates: states([[\"prospective\", \"initial\"], [\"active\", \"active\"], [\"inactive\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"prospective\", to: \"active\", required: true }, { from: \"active\", to: \"inactive\" }, { from: \"prospective\", to: \"exception\" }, { from: \"active\", to: \"exception\" }],\n\t\tobligations: [\"identity is tenant-scoped\", \"participation is attributable\"],\n\t},\n\t\"fabric.Offering\": {\n\t\tid: \"fabric.Offering\", version: \"0.1\", description: \"Something a party makes available under defined terms.\",\n\t\tstates: states([[\"available\", \"active\"], [\"retired\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"available\", to: \"retired\" }, { from: \"available\", to: \"exception\" }],\n\t\tobligations: [\"terms are identifiable\", \"availability is explicit\"],\n\t},\n\t\"fabric.Agreement\": {\n\t\tid: \"fabric.Agreement\", version: \"0.1\", description: \"A governed commitment between parties.\",\n\t\tstates: states([[\"proposed\", \"initial\"], [\"committed\", \"active\"], [\"resolved\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"proposed\", to: \"committed\", required: true }, { from: \"committed\", to: \"resolved\", required: true }, { from: \"proposed\", to: \"exception\" }, { from: \"committed\", to: \"exception\" }],\n\t\tobligations: [\"participating parties are attributable\", \"commitment and resolution are auditable\"],\n\t},\n\t\"fabric.Resource\": {\n\t\tid: \"fabric.Resource\", version: \"0.1\", description: \"A capacity or asset allocated by activities.\",\n\t\tstates: states([[\"available\", \"initial\"], [\"allocated\", \"active\"], [\"retired\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"available\", to: \"allocated\", required: true }, { from: \"allocated\", to: \"available\" }, { from: \"available\", to: \"retired\" }, { from: \"allocated\", to: \"exception\" }],\n\t\tobligations: [\"allocation is identifiable\", \"conflicting allocation is governed\"],\n\t},\n\t\"fabric.Activity\": {\n\t\tid: \"fabric.Activity\", version: \"0.1\", description: \"Work planned and performed toward an outcome.\",\n\t\tstates: states([[\"planned\", \"initial\"], [\"executing\", \"active\"], [\"waiting\", \"waiting\"], [\"completed\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"planned\", to: \"executing\", required: true }, { from: \"executing\", to: \"waiting\" }, { from: \"waiting\", to: \"executing\" }, { from: \"executing\", to: \"completed\", required: true }, { from: \"waiting\", to: \"completed\" }, { from: \"planned\", to: \"exception\" }, { from: \"executing\", to: \"exception\" }, { from: \"waiting\", to: \"exception\" }],\n\t\tobligations: [\"responsible party is attributable\", \"resource use and outcome are auditable\"],\n\t},\n\t\"fabric.Settlement\": {\n\t\tid: \"fabric.Settlement\", version: \"0.1\", description: \"Resolution of value exchange associated with an agreement.\",\n\t\tstates: states([[\"pending\", \"initial\"], [\"settled\", \"terminal\"], [\"reversed\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"pending\", to: \"settled\", required: true }, { from: \"settled\", to: \"reversed\" }, { from: \"pending\", to: \"exception\" }],\n\t\tobligations: [\"value and currency are explicit\", \"settlement is attributable to an agreement\"],\n\t},\n};\n\nconst STATE_CLASSES: ReadonlySet<string> = new Set([\"initial\", \"active\", \"waiting\", \"terminal\", \"exception\"]);\n\n/**\n * Define an archetype a vertical owns.\n *\n * The shipped six are a reference vocabulary. A platform that has to support\n * verticals nobody has thought of yet cannot ship their nouns, so the seam is\n * the definition itself: a vertical declares its lifecycle classes, permitted\n * refinements, and obligations, and gets the same conformance the reference\n * set gets. Validation here is structural — a definition that names a state\n * its transitions never reach, or a required transition it never declared,\n * would certify nothing and fail nothing.\n */\nexport function defineArchetype(definition: ArchetypeDefinition): ArchetypeDefinition {\n\tif (typeof definition.id !== \"string\" || !ARCHETYPE_ID.test(definition.id)) {\n\t\tthrow new Error(`Archetype id \"${String(definition.id)}\" must be <namespace>.<PascalName>.`);\n\t}\n\tif (typeof definition.version !== \"string\" || definition.version.trim() === \"\") {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare a version.`);\n\t}\n\tif (typeof definition.description !== \"string\" || definition.description.trim() === \"\") {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must describe what it classifies.`);\n\t}\n\tif (!definition.states || typeof definition.states !== \"object\" || Array.isArray(definition.states)) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare its states as a record keyed by id.`);\n\t}\n\tconst stateIds = Object.keys(definition.states);\n\tif (stateIds.length === 0) throw new Error(`Archetype \"${definition.id}\" must declare at least one state.`);\n\tfor (const [key, state] of Object.entries(definition.states)) {\n\t\tif (!state || state.id !== key) throw new Error(`Archetype \"${definition.id}\" state \"${key}\" must be keyed by its own id.`);\n\t\tif (!STATE_CLASSES.has(state.stateClass)) throw new Error(`Archetype \"${definition.id}\" state \"${key}\" has unknown state class \"${String(state.stateClass)}\".`);\n\t}\n\t// A place to start: an initial state, or an active one an object can be\n\t// born into. fabric.Offering has no initial state and is born available.\n\tif (!Object.values(definition.states).some((state) => state.stateClass === \"initial\" || state.stateClass === \"active\")) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare an initial or active state to start in.`);\n\t}\n\tif (!Object.values(definition.states).some((state) => state.stateClass === \"terminal\" || state.stateClass === \"exception\")) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare a terminal or exception state, or nothing ever ends.`);\n\t}\n\tif (!Array.isArray(definition.transitions)) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare its transitions as an array.`);\n\t}\n\tconst seen = new Set<string>();\n\tfor (const transition of definition.transitions) {\n\t\tif (!Object.hasOwn(definition.states, transition.from) || !Object.hasOwn(definition.states, transition.to)) {\n\t\t\tthrow new Error(`Archetype \"${definition.id}\" transition \"${transition.from}\" -> \"${transition.to}\" names an undeclared state.`);\n\t\t}\n\t\tif (transition.from === transition.to) throw new Error(`Archetype \"${definition.id}\" transition \"${transition.from}\" -> \"${transition.to}\" is a self-loop.`);\n\t\tconst key = transitionKey(transition.from, transition.to);\n\t\tif (seen.has(key)) throw new Error(`Archetype \"${definition.id}\" declares transition \"${transition.from}\" -> \"${transition.to}\" twice.`);\n\t\tseen.add(key);\n\t}\n\tif (!Array.isArray(definition.obligations) || definition.obligations.some((item) => typeof item !== \"string\" || item.trim() === \"\")) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" obligations must be non-empty strings.`);\n\t}\n\t// Shape first, then name: a malformed definition gets the named error for\n\t// its shape, and only a well-formed one is compared to the reference set.\n\tif (definition.id.startsWith(RESERVED_NAMESPACE)) {\n\t\tconst reference = Object.hasOwn(ARCHETYPES, definition.id) ? ARCHETYPES[definition.id as ArchetypeId] : undefined;\n\t\tif (!reference || !sameArchetype(reference, definition)) {\n\t\t\tthrow new Error(`Archetype \"${definition.id}\" uses the reserved \"fabric.\" namespace; choose a namespace of your own.`);\n\t\t}\n\t}\n\treturn Object.freeze({\n\t\tid: definition.id,\n\t\tversion: definition.version,\n\t\tdescription: definition.description,\n\t\tstates: Object.freeze(Object.fromEntries(Object.entries(definition.states).map(([key, state]) => [key, Object.freeze({ ...state })]))),\n\t\ttransitions: Object.freeze(definition.transitions.map((transition) => Object.freeze({ ...transition }))) as ArchetypeTransition[],\n\t\tobligations: Object.freeze([...definition.obligations]) as string[],\n\t});\n}\n\nexport interface ArchetypeConformance {\n\t/** Every archetype this conformance recognises, by id. */\n\treadonly definitions: Readonly<Record<string, ArchetypeDefinition>>;\n\tvalidate(manifest: ModuleManifest): ArchetypeConformanceReport[];\n\tassert(module: FabricModule<unknown>): void;\n\t/** For certification tooling; the compiler never learns an archetype name. */\n\treadonly adapter: ManifestConformanceAdapter;\n}\n\n/**\n * Conformance over a vertical's archetypes plus, by default, the reference set.\n *\n * An id the reference set already uses is accepted only when it is the very\n * same definition. Two meanings of `fabric.Party` in one assembly is not an\n * extension, it is a collision, and it is refused here rather than discovered\n * when two modules disagree at registration.\n */\nexport function createArchetypeConformance(\n\tdefinitions: readonly ArchetypeDefinition[],\n\toptions: { includeReference?: boolean; id?: string } = {},\n): ArchetypeConformance {\n\tconst merged: Record<string, ArchetypeDefinition> = options.includeReference === false ? {} : { ...ARCHETYPES };\n\tfor (const definition of definitions) {\n\t\tconst defined = defineArchetype(definition);\n\t\tconst existing = merged[defined.id];\n\t\tif (existing && !sameArchetype(existing, defined)) {\n\t\t\tthrow new Error(`Archetype \"${defined.id}\" is defined twice.`);\n\t\t}\n\t\tmerged[defined.id] = existing ?? defined;\n\t}\n\tconst frozen = Object.freeze(merged);\n\tconst validate = (manifest: ModuleManifest) => validateArchetypeConformance(manifest, frozen);\n\t// A distinct default id: certification tooling keys results by adapter id\n\t// and does not dedupe, so this must not collide with the shipped adapter.\n\tconst adapterId = options.id ?? `@fabricorg/archetypes:${[\n\t\t...(options.includeReference === false ? [] : [\"reference\"]),\n\t\t...definitions.map((definition) => definition.id).sort(),\n\t].join(\"+\") || \"none\"}`;\n\treturn {\n\t\tdefinitions: frozen,\n\t\tvalidate,\n\t\tassert(module) { assertArchetypeConformance(module, frozen); },\n\t\tadapter: { id: adapterId, evaluate: validate },\n\t};\n}\n\n/** Same meaning, whatever the object identity: a definition repeated verbatim is not a collision. */\nfunction sameArchetype(left: ArchetypeDefinition, right: ArchetypeDefinition): boolean {\n\tconst canonical = (definition: ArchetypeDefinition) => JSON.stringify({\n\t\tid: definition.id,\n\t\tversion: definition.version,\n\t\tdescription: definition.description,\n\t\tstates: Object.keys(definition.states).sort().map((key) => [key, definition.states[key]!.stateClass]),\n\t\ttransitions: definition.transitions\n\t\t\t.map((transition) => JSON.stringify([transition.from, transition.to, transition.required === true]))\n\t\t\t.sort(),\n\t\tobligations: [...definition.obligations].sort(),\n\t});\n\treturn canonical(left) === canonical(right);\n}\n\nexport function archetypeSemantics(reference: ArchetypeReference): Record<string, JsonValue> {\n\treturn { [ARCHETYPE_SEMANTIC_KEY]: reference as unknown as JsonValue };\n}\n\nexport function readArchetypeReference(\n\tobjectType: ModuleManifestObjectType,\n): ArchetypeReference | undefined {\n\tconst value = objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY];\n\tif (value === undefined) return undefined;\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst record = value as Record<string, JsonValue>;\n\tif (typeof record.id !== \"string\" || typeof record.version !== \"string\" || !record.stateMap || typeof record.stateMap !== \"object\" || Array.isArray(record.stateMap)) return undefined;\n\tif (!Object.values(record.stateMap).every((state) => typeof state === \"string\")) return undefined;\n\treturn { id: record.id as AnyArchetypeId, version: record.version, stateMap: record.stateMap as Record<string, string> };\n}\n\nconst transitionKey = (from: string, to: string) => `${from}->${to}`;\n\nexport function validateArchetypeConformance(\n\tmanifest: ModuleManifest,\n\tdefinitions: Readonly<Record<string, ArchetypeDefinition>> = ARCHETYPES,\n): ArchetypeConformanceReport[] {\n\treturn manifest.objectTypes\n\t\t.filter((objectType) => objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY] !== undefined)\n\t\t.map((objectType) => validateObject(manifest, objectType, definitions));\n}\n\nfunction validateObject(\n\tmanifest: ModuleManifest,\n\tobjectType: ModuleManifestObjectType,\n\tdefinitions: Readonly<Record<string, ArchetypeDefinition>>,\n): ArchetypeConformanceReport {\n\tconst findings: ConformanceFinding[] = [];\n\tconst reference = readArchetypeReference(objectType);\n\tif (!reference) {\n\t\tfindings.push({ code: \"invalid_annotation\", objectType: objectType.type, message: `Object \"${objectType.type}\" has an invalid ${ARCHETYPE_SEMANTIC_KEY} annotation.` });\n\t\treturn { conforms: false, objectType: objectType.type, findings };\n\t}\n\tconst definition = Object.hasOwn(definitions, reference.id) ? definitions[reference.id] : undefined;\n\tif (!definition) {\n\t\tfindings.push({ code: \"unknown_archetype\", objectType: objectType.type, message: `Unknown archetype \"${reference.id}\".` });\n\t\treturn { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n\t}\n\tif (reference.version !== definition.version) {\n\t\tfindings.push({ code: \"unsupported_archetype_version\", objectType: objectType.type, message: `Archetype \"${reference.id}\" supports version ${definition.version}, received ${reference.version}.` });\n\t}\n\tconst machine = (manifest.stateMachines ?? []).find((candidate) => candidate.entityType === objectType.type);\n\tif (!machine) {\n\t\tfindings.push({ code: \"missing_state_machine\", objectType: objectType.type, message: `Object \"${objectType.type}\" needs a state machine for archetype conformance.` });\n\t\treturn { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n\t}\n\tconst declaredStates = new Set(machine.states.map((state) => state.id));\n\tfor (const state of Object.keys(reference.stateMap)) {\n\t\tif (!declaredStates.has(state)) findings.push({ code: \"unknown_mapped_state\", objectType: objectType.type, state, message: `State mapping \"${state}\" does not name a declared state.` });\n\t}\n\tfor (const state of machine.states) {\n\t\tconst mapped = reference.stateMap[state.id];\n\t\tif (!mapped) {\n\t\t\tfindings.push({ code: \"unmapped_state\", objectType: objectType.type, state: state.id, message: `State \"${state.id}\" is not mapped.` });\n\t\t\tcontinue;\n\t\t}\n\t\tconst base = Object.hasOwn(definition.states, mapped) ? definition.states[mapped] : undefined;\n\t\tif (!base) {\n\t\t\tfindings.push({ code: \"unknown_archetype_state\", objectType: objectType.type, state: state.id, target: mapped, message: `State \"${state.id}\" maps to unknown archetype state \"${mapped}\".` });\n\t\t} else if (base.stateClass !== state.stateClass) {\n\t\t\tfindings.push({ code: \"incompatible_state_class\", objectType: objectType.type, state: state.id, target: mapped, message: `State \"${state.id}\" (${state.stateClass}) is incompatible with \"${mapped}\" (${base.stateClass}).` });\n\t\t}\n\t}\n\tconst permitted = new Set(definition.transitions.map((transition) => transitionKey(transition.from, transition.to)));\n\tconst realized = new Set<string>();\n\tfor (const transition of machine.transitions) {\n\t\tconst from = reference.stateMap[transition.from];\n\t\tconst to = reference.stateMap[transition.to];\n\t\tif (!from || !to) continue;\n\t\t// By class, never by name: a vertical calls its exception state whatever it likes.\n\t\tif (Object.hasOwn(definition.states, to) && definition.states[to]!.stateClass === \"exception\" && !transition.hasGuard) {\n\t\t\tfindings.push({ code: \"exception_transition_unguarded\", objectType: objectType.type, state: transition.from, target: transition.to, message: `Exception transition \"${transition.from}\" -> \"${transition.to}\" must declare a governance guard.` });\n\t\t}\n\t\tif (from !== to && !permitted.has(transitionKey(from, to))) {\n\t\t\tfindings.push({ code: \"transition_not_permitted\", objectType: objectType.type, state: transition.from, target: transition.to, message: `Transition \"${transition.from}\" -> \"${transition.to}\" maps to disallowed archetype transition \"${from}\" -> \"${to}\".` });\n\t\t} else if (from !== to) {\n\t\t\trealized.add(transitionKey(from, to));\n\t\t}\n\t}\n\tfor (const required of definition.transitions.filter((transition) => transition.required)) {\n\t\tif (!realized.has(transitionKey(required.from, required.to))) {\n\t\t\tfindings.push({ code: \"required_transition_unreachable\", objectType: objectType.type, state: required.from, target: required.to, message: `Required archetype transition \"${required.from}\" -> \"${required.to}\" is not realized.` });\n\t\t}\n\t}\n\treturn { conforms: findings.length === 0, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n}\n\nexport function assertArchetypeConformance(\n\tmodule: FabricModule<unknown>,\n\tdefinitions: Readonly<Record<string, ArchetypeDefinition>> = ARCHETYPES,\n): void {\n\tconst failures = validateArchetypeConformance(exportModuleManifest(module), definitions).filter((report) => !report.conforms);\n\tif (failures.length > 0) {\n\t\tthrow new Error(`Archetype conformance failed:\\n${failures.flatMap((report) => report.findings.map((finding) => `- ${report.objectType}: ${finding.message}`)).join(\"\\n\")}`);\n\t}\n}\n\nexport const archetypeConformanceAdapter: ManifestConformanceAdapter = {\n\tid: \"@fabricorg/archetypes\",\n\tevaluate: validateArchetypeConformance,\n};\n"],"mappings":"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","names":["module"]}

package/dist/index.d.cts

@@ -1,9 +1,20 @@
-import { StateClass, ModuleManifest, JsonValue, FabricModule, ModuleManifestObjectType } from '@fabricorg/platform';
+import { StateClass, ModuleManifest, FabricModule, JsonValue, ModuleManifestObjectType } from '@fabricorg/platform';
 
 declare const ARCHETYPE_SEMANTIC_KEY: "fabric.archetype";
+/** The six archetypes this package ships. A reference vocabulary, not the whole vocabulary. */
 type ArchetypeId = "fabric.Party" | "fabric.Offering" | "fabric.Agreement" | "fabric.Resource" | "fabric.Activity" | "fabric.Settlement";
+/** The same set under the name that says what it is. */
+type ReferenceArchetypeId = ArchetypeId;
+/**
+ * Any archetype id a reference may name: a shipped one, or one a vertical
+ * defined with `defineArchetype`. The intersection keeps editor completion for
+ * the shipped ids without closing the set.
+ */
+type AnyArchetypeId = ArchetypeId | (string & {});
+/** `<namespace>.<PascalName>`, so a vertical's vocabulary cannot be mistaken for the reference set. */
+declare const ARCHETYPE_ID: RegExp;
 interface ArchetypeReference {
-    id: ArchetypeId;
+    id: AnyArchetypeId;
     version: string;
     stateMap: Record<string, string>;
 }
@@ -17,7 +28,7 @@ interface ArchetypeTransition {
     required?: boolean;
 }
 interface ArchetypeDefinition {
-    id: ArchetypeId;
+    id: AnyArchetypeId;
     version: string;
     description: string;
     states: Record<string, ArchetypeState>;
@@ -43,10 +54,42 @@ interface ManifestConformanceAdapter {
     evaluate(manifest: ModuleManifest): ArchetypeConformanceReport[];
 }
 declare const ARCHETYPES: Readonly<Record<ArchetypeId, ArchetypeDefinition>>;
+/**
+ * Define an archetype a vertical owns.
+ *
+ * The shipped six are a reference vocabulary. A platform that has to support
+ * verticals nobody has thought of yet cannot ship their nouns, so the seam is
+ * the definition itself: a vertical declares its lifecycle classes, permitted
+ * refinements, and obligations, and gets the same conformance the reference
+ * set gets. Validation here is structural — a definition that names a state
+ * its transitions never reach, or a required transition it never declared,
+ * would certify nothing and fail nothing.
+ */
+declare function defineArchetype(definition: ArchetypeDefinition): ArchetypeDefinition;
+interface ArchetypeConformance {
+    /** Every archetype this conformance recognises, by id. */
+    readonly definitions: Readonly<Record<string, ArchetypeDefinition>>;
+    validate(manifest: ModuleManifest): ArchetypeConformanceReport[];
+    assert(module: FabricModule<unknown>): void;
+    /** For certification tooling; the compiler never learns an archetype name. */
+    readonly adapter: ManifestConformanceAdapter;
+}
+/**
+ * Conformance over a vertical's archetypes plus, by default, the reference set.
+ *
+ * An id the reference set already uses is accepted only when it is the very
+ * same definition. Two meanings of `fabric.Party` in one assembly is not an
+ * extension, it is a collision, and it is refused here rather than discovered
+ * when two modules disagree at registration.
+ */
+declare function createArchetypeConformance(definitions: readonly ArchetypeDefinition[], options?: {
+    includeReference?: boolean;
+    id?: string;
+}): ArchetypeConformance;
 declare function archetypeSemantics(reference: ArchetypeReference): Record<string, JsonValue>;
 declare function readArchetypeReference(objectType: ModuleManifestObjectType): ArchetypeReference | undefined;
-declare function validateArchetypeConformance(manifest: ModuleManifest): ArchetypeConformanceReport[];
-declare function assertArchetypeConformance(module: FabricModule<unknown>): void;
+declare function validateArchetypeConformance(manifest: ModuleManifest, definitions?: Readonly<Record<string, ArchetypeDefinition>>): ArchetypeConformanceReport[];
+declare function assertArchetypeConformance(module: FabricModule<unknown>, definitions?: Readonly<Record<string, ArchetypeDefinition>>): void;
 declare const archetypeConformanceAdapter: ManifestConformanceAdapter;
 
-export { ARCHETYPES, ARCHETYPE_SEMANTIC_KEY, type ArchetypeConformanceReport, type ArchetypeDefinition, type ArchetypeId, type ArchetypeReference, type ArchetypeState, type ArchetypeTransition, type ConformanceFinding, type ConformanceFindingCode, type ManifestConformanceAdapter, archetypeConformanceAdapter, archetypeSemantics, assertArchetypeConformance, readArchetypeReference, validateArchetypeConformance };
+export { ARCHETYPES, ARCHETYPE_ID, ARCHETYPE_SEMANTIC_KEY, type AnyArchetypeId, type ArchetypeConformance, type ArchetypeConformanceReport, type ArchetypeDefinition, type ArchetypeId, type ArchetypeReference, type ArchetypeState, type ArchetypeTransition, type ConformanceFinding, type ConformanceFindingCode, type ManifestConformanceAdapter, type ReferenceArchetypeId, archetypeConformanceAdapter, archetypeSemantics, assertArchetypeConformance, createArchetypeConformance, defineArchetype, readArchetypeReference, validateArchetypeConformance };

package/dist/index.d.ts

@@ -1,9 +1,20 @@
-import { StateClass, ModuleManifest, JsonValue, FabricModule, ModuleManifestObjectType } from '@fabricorg/platform';
+import { StateClass, ModuleManifest, FabricModule, JsonValue, ModuleManifestObjectType } from '@fabricorg/platform';
 
 declare const ARCHETYPE_SEMANTIC_KEY: "fabric.archetype";
+/** The six archetypes this package ships. A reference vocabulary, not the whole vocabulary. */
 type ArchetypeId = "fabric.Party" | "fabric.Offering" | "fabric.Agreement" | "fabric.Resource" | "fabric.Activity" | "fabric.Settlement";
+/** The same set under the name that says what it is. */
+type ReferenceArchetypeId = ArchetypeId;
+/**
+ * Any archetype id a reference may name: a shipped one, or one a vertical
+ * defined with `defineArchetype`. The intersection keeps editor completion for
+ * the shipped ids without closing the set.
+ */
+type AnyArchetypeId = ArchetypeId | (string & {});
+/** `<namespace>.<PascalName>`, so a vertical's vocabulary cannot be mistaken for the reference set. */
+declare const ARCHETYPE_ID: RegExp;
 interface ArchetypeReference {
-    id: ArchetypeId;
+    id: AnyArchetypeId;
     version: string;
     stateMap: Record<string, string>;
 }
@@ -17,7 +28,7 @@ interface ArchetypeTransition {
     required?: boolean;
 }
 interface ArchetypeDefinition {
-    id: ArchetypeId;
+    id: AnyArchetypeId;
     version: string;
     description: string;
     states: Record<string, ArchetypeState>;
@@ -43,10 +54,42 @@ interface ManifestConformanceAdapter {
     evaluate(manifest: ModuleManifest): ArchetypeConformanceReport[];
 }
 declare const ARCHETYPES: Readonly<Record<ArchetypeId, ArchetypeDefinition>>;
+/**
+ * Define an archetype a vertical owns.
+ *
+ * The shipped six are a reference vocabulary. A platform that has to support
+ * verticals nobody has thought of yet cannot ship their nouns, so the seam is
+ * the definition itself: a vertical declares its lifecycle classes, permitted
+ * refinements, and obligations, and gets the same conformance the reference
+ * set gets. Validation here is structural — a definition that names a state
+ * its transitions never reach, or a required transition it never declared,
+ * would certify nothing and fail nothing.
+ */
+declare function defineArchetype(definition: ArchetypeDefinition): ArchetypeDefinition;
+interface ArchetypeConformance {
+    /** Every archetype this conformance recognises, by id. */
+    readonly definitions: Readonly<Record<string, ArchetypeDefinition>>;
+    validate(manifest: ModuleManifest): ArchetypeConformanceReport[];
+    assert(module: FabricModule<unknown>): void;
+    /** For certification tooling; the compiler never learns an archetype name. */
+    readonly adapter: ManifestConformanceAdapter;
+}
+/**
+ * Conformance over a vertical's archetypes plus, by default, the reference set.
+ *
+ * An id the reference set already uses is accepted only when it is the very
+ * same definition. Two meanings of `fabric.Party` in one assembly is not an
+ * extension, it is a collision, and it is refused here rather than discovered
+ * when two modules disagree at registration.
+ */
+declare function createArchetypeConformance(definitions: readonly ArchetypeDefinition[], options?: {
+    includeReference?: boolean;
+    id?: string;
+}): ArchetypeConformance;
 declare function archetypeSemantics(reference: ArchetypeReference): Record<string, JsonValue>;
 declare function readArchetypeReference(objectType: ModuleManifestObjectType): ArchetypeReference | undefined;
-declare function validateArchetypeConformance(manifest: ModuleManifest): ArchetypeConformanceReport[];
-declare function assertArchetypeConformance(module: FabricModule<unknown>): void;
+declare function validateArchetypeConformance(manifest: ModuleManifest, definitions?: Readonly<Record<string, ArchetypeDefinition>>): ArchetypeConformanceReport[];
+declare function assertArchetypeConformance(module: FabricModule<unknown>, definitions?: Readonly<Record<string, ArchetypeDefinition>>): void;
 declare const archetypeConformanceAdapter: ManifestConformanceAdapter;
 
-export { ARCHETYPES, ARCHETYPE_SEMANTIC_KEY, type ArchetypeConformanceReport, type ArchetypeDefinition, type ArchetypeId, type ArchetypeReference, type ArchetypeState, type ArchetypeTransition, type ConformanceFinding, type ConformanceFindingCode, type ManifestConformanceAdapter, archetypeConformanceAdapter, archetypeSemantics, assertArchetypeConformance, readArchetypeReference, validateArchetypeConformance };
+export { ARCHETYPES, ARCHETYPE_ID, ARCHETYPE_SEMANTIC_KEY, type AnyArchetypeId, type ArchetypeConformance, type ArchetypeConformanceReport, type ArchetypeDefinition, type ArchetypeId, type ArchetypeReference, type ArchetypeState, type ArchetypeTransition, type ConformanceFinding, type ConformanceFindingCode, type ManifestConformanceAdapter, type ReferenceArchetypeId, archetypeConformanceAdapter, archetypeSemantics, assertArchetypeConformance, createArchetypeConformance, defineArchetype, readArchetypeReference, validateArchetypeConformance };

package/dist/index.js

@@ -3,6 +3,8 @@ import {
   exportModuleManifest
 } from "@fabricorg/platform";
 var ARCHETYPE_SEMANTIC_KEY = "fabric.archetype";
+var ARCHETYPE_ID = /^[a-z][a-z0-9-]*\.[A-Z][A-Za-z0-9]*$/;
+var RESERVED_NAMESPACE = "fabric.";
 var states = (definitions) => Object.fromEntries(definitions.map(([id, stateClass]) => [id, { id, stateClass }]));
 var ARCHETYPES = {
   "fabric.Party": {
@@ -54,6 +56,99 @@ var ARCHETYPES = {
     obligations: ["value and currency are explicit", "settlement is attributable to an agreement"]
   }
 };
+var STATE_CLASSES = /* @__PURE__ */ new Set(["initial", "active", "waiting", "terminal", "exception"]);
+function defineArchetype(definition) {
+  if (typeof definition.id !== "string" || !ARCHETYPE_ID.test(definition.id)) {
+    throw new Error(`Archetype id "${String(definition.id)}" must be <namespace>.<PascalName>.`);
+  }
+  if (typeof definition.version !== "string" || definition.version.trim() === "") {
+    throw new Error(`Archetype "${definition.id}" must declare a version.`);
+  }
+  if (typeof definition.description !== "string" || definition.description.trim() === "") {
+    throw new Error(`Archetype "${definition.id}" must describe what it classifies.`);
+  }
+  if (!definition.states || typeof definition.states !== "object" || Array.isArray(definition.states)) {
+    throw new Error(`Archetype "${definition.id}" must declare its states as a record keyed by id.`);
+  }
+  const stateIds = Object.keys(definition.states);
+  if (stateIds.length === 0) throw new Error(`Archetype "${definition.id}" must declare at least one state.`);
+  for (const [key, state] of Object.entries(definition.states)) {
+    if (!state || state.id !== key) throw new Error(`Archetype "${definition.id}" state "${key}" must be keyed by its own id.`);
+    if (!STATE_CLASSES.has(state.stateClass)) throw new Error(`Archetype "${definition.id}" state "${key}" has unknown state class "${String(state.stateClass)}".`);
+  }
+  if (!Object.values(definition.states).some((state) => state.stateClass === "initial" || state.stateClass === "active")) {
+    throw new Error(`Archetype "${definition.id}" must declare an initial or active state to start in.`);
+  }
+  if (!Object.values(definition.states).some((state) => state.stateClass === "terminal" || state.stateClass === "exception")) {
+    throw new Error(`Archetype "${definition.id}" must declare a terminal or exception state, or nothing ever ends.`);
+  }
+  if (!Array.isArray(definition.transitions)) {
+    throw new Error(`Archetype "${definition.id}" must declare its transitions as an array.`);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const transition of definition.transitions) {
+    if (!Object.hasOwn(definition.states, transition.from) || !Object.hasOwn(definition.states, transition.to)) {
+      throw new Error(`Archetype "${definition.id}" transition "${transition.from}" -> "${transition.to}" names an undeclared state.`);
+    }
+    if (transition.from === transition.to) throw new Error(`Archetype "${definition.id}" transition "${transition.from}" -> "${transition.to}" is a self-loop.`);
+    const key = transitionKey(transition.from, transition.to);
+    if (seen.has(key)) throw new Error(`Archetype "${definition.id}" declares transition "${transition.from}" -> "${transition.to}" twice.`);
+    seen.add(key);
+  }
+  if (!Array.isArray(definition.obligations) || definition.obligations.some((item) => typeof item !== "string" || item.trim() === "")) {
+    throw new Error(`Archetype "${definition.id}" obligations must be non-empty strings.`);
+  }
+  if (definition.id.startsWith(RESERVED_NAMESPACE)) {
+    const reference = Object.hasOwn(ARCHETYPES, definition.id) ? ARCHETYPES[definition.id] : void 0;
+    if (!reference || !sameArchetype(reference, definition)) {
+      throw new Error(`Archetype "${definition.id}" uses the reserved "fabric." namespace; choose a namespace of your own.`);
+    }
+  }
+  return Object.freeze({
+    id: definition.id,
+    version: definition.version,
+    description: definition.description,
+    states: Object.freeze(Object.fromEntries(Object.entries(definition.states).map(([key, state]) => [key, Object.freeze({ ...state })]))),
+    transitions: Object.freeze(definition.transitions.map((transition) => Object.freeze({ ...transition }))),
+    obligations: Object.freeze([...definition.obligations])
+  });
+}
+function createArchetypeConformance(definitions, options = {}) {
+  const merged = options.includeReference === false ? {} : { ...ARCHETYPES };
+  for (const definition of definitions) {
+    const defined = defineArchetype(definition);
+    const existing = merged[defined.id];
+    if (existing && !sameArchetype(existing, defined)) {
+      throw new Error(`Archetype "${defined.id}" is defined twice.`);
+    }
+    merged[defined.id] = existing ?? defined;
+  }
+  const frozen = Object.freeze(merged);
+  const validate = (manifest) => validateArchetypeConformance(manifest, frozen);
+  const adapterId = options.id ?? `@fabricorg/archetypes:${[
+    ...options.includeReference === false ? [] : ["reference"],
+    ...definitions.map((definition) => definition.id).sort()
+  ].join("+") || "none"}`;
+  return {
+    definitions: frozen,
+    validate,
+    assert(module) {
+      assertArchetypeConformance(module, frozen);
+    },
+    adapter: { id: adapterId, evaluate: validate }
+  };
+}
+function sameArchetype(left, right) {
+  const canonical = (definition) => JSON.stringify({
+    id: definition.id,
+    version: definition.version,
+    description: definition.description,
+    states: Object.keys(definition.states).sort().map((key) => [key, definition.states[key].stateClass]),
+    transitions: definition.transitions.map((transition) => JSON.stringify([transition.from, transition.to, transition.required === true])).sort(),
+    obligations: [...definition.obligations].sort()
+  });
+  return canonical(left) === canonical(right);
+}
 function archetypeSemantics(reference) {
   return { [ARCHETYPE_SEMANTIC_KEY]: reference };
 }
@@ -67,17 +162,17 @@ function readArchetypeReference(objectType) {
   return { id: record.id, version: record.version, stateMap: record.stateMap };
 }
 var transitionKey = (from, to) => `${from}->${to}`;
-function validateArchetypeConformance(manifest) {
-  return manifest.objectTypes.filter((objectType) => objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY] !== void 0).map((objectType) => validateObject(manifest, objectType));
+function validateArchetypeConformance(manifest, definitions = ARCHETYPES) {
+  return manifest.objectTypes.filter((objectType) => objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY] !== void 0).map((objectType) => validateObject(manifest, objectType, definitions));
 }
-function validateObject(manifest, objectType) {
+function validateObject(manifest, objectType, definitions) {
   const findings = [];
   const reference = readArchetypeReference(objectType);
   if (!reference) {
     findings.push({ code: "invalid_annotation", objectType: objectType.type, message: `Object "${objectType.type}" has an invalid ${ARCHETYPE_SEMANTIC_KEY} annotation.` });
     return { conforms: false, objectType: objectType.type, findings };
   }
-  const definition = ARCHETYPES[reference.id];
+  const definition = Object.hasOwn(definitions, reference.id) ? definitions[reference.id] : void 0;
   if (!definition) {
     findings.push({ code: "unknown_archetype", objectType: objectType.type, message: `Unknown archetype "${reference.id}".` });
     return { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };
@@ -100,7 +195,7 @@ function validateObject(manifest, objectType) {
       findings.push({ code: "unmapped_state", objectType: objectType.type, state: state.id, message: `State "${state.id}" is not mapped.` });
       continue;
     }
-    const base = definition.states[mapped];
+    const base = Object.hasOwn(definition.states, mapped) ? definition.states[mapped] : void 0;
     if (!base) {
       findings.push({ code: "unknown_archetype_state", objectType: objectType.type, state: state.id, target: mapped, message: `State "${state.id}" maps to unknown archetype state "${mapped}".` });
     } else if (base.stateClass !== state.stateClass) {
@@ -113,7 +208,7 @@ function validateObject(manifest, objectType) {
     const from = reference.stateMap[transition.from];
     const to = reference.stateMap[transition.to];
     if (!from || !to) continue;
-    if (to === "exception" && !transition.hasGuard) {
+    if (Object.hasOwn(definition.states, to) && definition.states[to].stateClass === "exception" && !transition.hasGuard) {
       findings.push({ code: "exception_transition_unguarded", objectType: objectType.type, state: transition.from, target: transition.to, message: `Exception transition "${transition.from}" -> "${transition.to}" must declare a governance guard.` });
     }
     if (from !== to && !permitted.has(transitionKey(from, to))) {
@@ -129,8 +224,8 @@ function validateObject(manifest, objectType) {
   }
   return { conforms: findings.length === 0, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };
 }
-function assertArchetypeConformance(module) {
-  const failures = validateArchetypeConformance(exportModuleManifest(module)).filter((report) => !report.conforms);
+function assertArchetypeConformance(module, definitions = ARCHETYPES) {
+  const failures = validateArchetypeConformance(exportModuleManifest(module), definitions).filter((report) => !report.conforms);
   if (failures.length > 0) {
     throw new Error(`Archetype conformance failed:
 ${failures.flatMap((report) => report.findings.map((finding) => `- ${report.objectType}: ${finding.message}`)).join("\n")}`);
@@ -142,10 +237,13 @@ var archetypeConformanceAdapter = {
 };
 export {
   ARCHETYPES,
+  ARCHETYPE_ID,
   ARCHETYPE_SEMANTIC_KEY,
   archetypeConformanceAdapter,
   archetypeSemantics,
   assertArchetypeConformance,
+  createArchetypeConformance,
+  defineArchetype,
   readArchetypeReference,
   validateArchetypeConformance
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts"],"sourcesContent":["import {\n\texportModuleManifest,\n\ttype FabricModule,\n\ttype JsonValue,\n\ttype ModuleManifest,\n\ttype ModuleManifestObjectType,\n\ttype StateClass,\n} from \"@fabricorg/platform\";\n\nexport const ARCHETYPE_SEMANTIC_KEY = \"fabric.archetype\" as const;\n\nexport type ArchetypeId =\n\t| \"fabric.Party\"\n\t| \"fabric.Offering\"\n\t| \"fabric.Agreement\"\n\t| \"fabric.Resource\"\n\t| \"fabric.Activity\"\n\t| \"fabric.Settlement\";\n\nexport interface ArchetypeReference {\n\tid: ArchetypeId;\n\tversion: string;\n\tstateMap: Record<string, string>;\n}\n\nexport interface ArchetypeState {\n\tid: string;\n\tstateClass: StateClass;\n}\n\nexport interface ArchetypeTransition {\n\tfrom: string;\n\tto: string;\n\trequired?: boolean;\n}\n\nexport interface ArchetypeDefinition {\n\tid: ArchetypeId;\n\tversion: string;\n\tdescription: string;\n\tstates: Record<string, ArchetypeState>;\n\ttransitions: ArchetypeTransition[];\n\tobligations: string[];\n}\n\nexport type ConformanceFindingCode =\n\t| \"invalid_annotation\"\n\t| \"unknown_archetype\"\n\t| \"unsupported_archetype_version\"\n\t| \"missing_state_machine\"\n\t| \"unmapped_state\"\n\t| \"unknown_mapped_state\"\n\t| \"unknown_archetype_state\"\n\t| \"incompatible_state_class\"\n\t| \"transition_not_permitted\"\n\t| \"exception_transition_unguarded\"\n\t| \"required_transition_unreachable\";\n\nexport interface ConformanceFinding {\n\tcode: ConformanceFindingCode;\n\tmessage: string;\n\tobjectType: string;\n\tstate?: string;\n\ttarget?: string;\n}\n\nexport interface ArchetypeConformanceReport {\n\tconforms: boolean;\n\tobjectType: string;\n\tarchetype?: string;\n\tfindings: ConformanceFinding[];\n}\n\nexport interface ManifestConformanceAdapter {\n\tid: string;\n\tevaluate(manifest: ModuleManifest): ArchetypeConformanceReport[];\n}\n\nconst states = (definitions: Array<[string, StateClass]>): Record<string, ArchetypeState> =>\n\tObject.fromEntries(definitions.map(([id, stateClass]) => [id, { id, stateClass }]));\n\nexport const ARCHETYPES: Readonly<Record<ArchetypeId, ArchetypeDefinition>> = {\n\t\"fabric.Party\": {\n\t\tid: \"fabric.Party\", version: \"0.1\", description: \"A person or organization participating in business relationships.\",\n\t\tstates: states([[\"prospective\", \"initial\"], [\"active\", \"active\"], [\"inactive\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"prospective\", to: \"active\", required: true }, { from: \"active\", to: \"inactive\" }, { from: \"prospective\", to: \"exception\" }, { from: \"active\", to: \"exception\" }],\n\t\tobligations: [\"identity is tenant-scoped\", \"participation is attributable\"],\n\t},\n\t\"fabric.Offering\": {\n\t\tid: \"fabric.Offering\", version: \"0.1\", description: \"Something a party makes available under defined terms.\",\n\t\tstates: states([[\"available\", \"active\"], [\"retired\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"available\", to: \"retired\" }, { from: \"available\", to: \"exception\" }],\n\t\tobligations: [\"terms are identifiable\", \"availability is explicit\"],\n\t},\n\t\"fabric.Agreement\": {\n\t\tid: \"fabric.Agreement\", version: \"0.1\", description: \"A governed commitment between parties.\",\n\t\tstates: states([[\"proposed\", \"initial\"], [\"committed\", \"active\"], [\"resolved\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"proposed\", to: \"committed\", required: true }, { from: \"committed\", to: \"resolved\", required: true }, { from: \"proposed\", to: \"exception\" }, { from: \"committed\", to: \"exception\" }],\n\t\tobligations: [\"participating parties are attributable\", \"commitment and resolution are auditable\"],\n\t},\n\t\"fabric.Resource\": {\n\t\tid: \"fabric.Resource\", version: \"0.1\", description: \"A capacity or asset allocated by activities.\",\n\t\tstates: states([[\"available\", \"initial\"], [\"allocated\", \"active\"], [\"retired\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"available\", to: \"allocated\", required: true }, { from: \"allocated\", to: \"available\" }, { from: \"available\", to: \"retired\" }, { from: \"allocated\", to: \"exception\" }],\n\t\tobligations: [\"allocation is identifiable\", \"conflicting allocation is governed\"],\n\t},\n\t\"fabric.Activity\": {\n\t\tid: \"fabric.Activity\", version: \"0.1\", description: \"Work planned and performed toward an outcome.\",\n\t\tstates: states([[\"planned\", \"initial\"], [\"executing\", \"active\"], [\"waiting\", \"waiting\"], [\"completed\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"planned\", to: \"executing\", required: true }, { from: \"executing\", to: \"waiting\" }, { from: \"waiting\", to: \"executing\" }, { from: \"executing\", to: \"completed\", required: true }, { from: \"waiting\", to: \"completed\" }, { from: \"planned\", to: \"exception\" }, { from: \"executing\", to: \"exception\" }, { from: \"waiting\", to: \"exception\" }],\n\t\tobligations: [\"responsible party is attributable\", \"resource use and outcome are auditable\"],\n\t},\n\t\"fabric.Settlement\": {\n\t\tid: \"fabric.Settlement\", version: \"0.1\", description: \"Resolution of value exchange associated with an agreement.\",\n\t\tstates: states([[\"pending\", \"initial\"], [\"settled\", \"terminal\"], [\"reversed\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"pending\", to: \"settled\", required: true }, { from: \"settled\", to: \"reversed\" }, { from: \"pending\", to: \"exception\" }],\n\t\tobligations: [\"value and currency are explicit\", \"settlement is attributable to an agreement\"],\n\t},\n};\n\nexport function archetypeSemantics(reference: ArchetypeReference): Record<string, JsonValue> {\n\treturn { [ARCHETYPE_SEMANTIC_KEY]: reference as unknown as JsonValue };\n}\n\nexport function readArchetypeReference(\n\tobjectType: ModuleManifestObjectType,\n): ArchetypeReference | undefined {\n\tconst value = objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY];\n\tif (value === undefined) return undefined;\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst record = value as Record<string, JsonValue>;\n\tif (typeof record.id !== \"string\" || typeof record.version !== \"string\" || !record.stateMap || typeof record.stateMap !== \"object\" || Array.isArray(record.stateMap)) return undefined;\n\tif (!Object.values(record.stateMap).every((state) => typeof state === \"string\")) return undefined;\n\treturn { id: record.id as ArchetypeId, version: record.version, stateMap: record.stateMap as Record<string, string> };\n}\n\nconst transitionKey = (from: string, to: string) => `${from}->${to}`;\n\nexport function validateArchetypeConformance(\n\tmanifest: ModuleManifest,\n): ArchetypeConformanceReport[] {\n\treturn manifest.objectTypes\n\t\t.filter((objectType) => objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY] !== undefined)\n\t\t.map((objectType) => validateObject(manifest, objectType));\n}\n\nfunction validateObject(\n\tmanifest: ModuleManifest,\n\tobjectType: ModuleManifestObjectType,\n): ArchetypeConformanceReport {\n\tconst findings: ConformanceFinding[] = [];\n\tconst reference = readArchetypeReference(objectType);\n\tif (!reference) {\n\t\tfindings.push({ code: \"invalid_annotation\", objectType: objectType.type, message: `Object \"${objectType.type}\" has an invalid ${ARCHETYPE_SEMANTIC_KEY} annotation.` });\n\t\treturn { conforms: false, objectType: objectType.type, findings };\n\t}\n\tconst definition = ARCHETYPES[reference.id];\n\tif (!definition) {\n\t\tfindings.push({ code: \"unknown_archetype\", objectType: objectType.type, message: `Unknown archetype \"${reference.id}\".` });\n\t\treturn { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n\t}\n\tif (reference.version !== definition.version) {\n\t\tfindings.push({ code: \"unsupported_archetype_version\", objectType: objectType.type, message: `Archetype \"${reference.id}\" supports version ${definition.version}, received ${reference.version}.` });\n\t}\n\tconst machine = (manifest.stateMachines ?? []).find((candidate) => candidate.entityType === objectType.type);\n\tif (!machine) {\n\t\tfindings.push({ code: \"missing_state_machine\", objectType: objectType.type, message: `Object \"${objectType.type}\" needs a state machine for archetype conformance.` });\n\t\treturn { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n\t}\n\tconst declaredStates = new Set(machine.states.map((state) => state.id));\n\tfor (const state of Object.keys(reference.stateMap)) {\n\t\tif (!declaredStates.has(state)) findings.push({ code: \"unknown_mapped_state\", objectType: objectType.type, state, message: `State mapping \"${state}\" does not name a declared state.` });\n\t}\n\tfor (const state of machine.states) {\n\t\tconst mapped = reference.stateMap[state.id];\n\t\tif (!mapped) {\n\t\t\tfindings.push({ code: \"unmapped_state\", objectType: objectType.type, state: state.id, message: `State \"${state.id}\" is not mapped.` });\n\t\t\tcontinue;\n\t\t}\n\t\tconst base = definition.states[mapped];\n\t\tif (!base) {\n\t\t\tfindings.push({ code: \"unknown_archetype_state\", objectType: objectType.type, state: state.id, target: mapped, message: `State \"${state.id}\" maps to unknown archetype state \"${mapped}\".` });\n\t\t} else if (base.stateClass !== state.stateClass) {\n\t\t\tfindings.push({ code: \"incompatible_state_class\", objectType: objectType.type, state: state.id, target: mapped, message: `State \"${state.id}\" (${state.stateClass}) is incompatible with \"${mapped}\" (${base.stateClass}).` });\n\t\t}\n\t}\n\tconst permitted = new Set(definition.transitions.map((transition) => transitionKey(transition.from, transition.to)));\n\tconst realized = new Set<string>();\n\tfor (const transition of machine.transitions) {\n\t\tconst from = reference.stateMap[transition.from];\n\t\tconst to = reference.stateMap[transition.to];\n\t\tif (!from || !to) continue;\n\t\tif (to === \"exception\" && !transition.hasGuard) {\n\t\t\tfindings.push({ code: \"exception_transition_unguarded\", objectType: objectType.type, state: transition.from, target: transition.to, message: `Exception transition \"${transition.from}\" -> \"${transition.to}\" must declare a governance guard.` });\n\t\t}\n\t\tif (from !== to && !permitted.has(transitionKey(from, to))) {\n\t\t\tfindings.push({ code: \"transition_not_permitted\", objectType: objectType.type, state: transition.from, target: transition.to, message: `Transition \"${transition.from}\" -> \"${transition.to}\" maps to disallowed archetype transition \"${from}\" -> \"${to}\".` });\n\t\t} else if (from !== to) {\n\t\t\trealized.add(transitionKey(from, to));\n\t\t}\n\t}\n\tfor (const required of definition.transitions.filter((transition) => transition.required)) {\n\t\tif (!realized.has(transitionKey(required.from, required.to))) {\n\t\t\tfindings.push({ code: \"required_transition_unreachable\", objectType: objectType.type, state: required.from, target: required.to, message: `Required archetype transition \"${required.from}\" -> \"${required.to}\" is not realized.` });\n\t\t}\n\t}\n\treturn { conforms: findings.length === 0, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n}\n\nexport function assertArchetypeConformance(module: FabricModule<unknown>): void {\n\tconst failures = validateArchetypeConformance(exportModuleManifest(module)).filter((report) => !report.conforms);\n\tif (failures.length > 0) {\n\t\tthrow new Error(`Archetype conformance failed:\\n${failures.flatMap((report) => report.findings.map((finding) => `- ${report.objectType}: ${finding.message}`)).join(\"\\n\")}`);\n\t}\n}\n\nexport const archetypeConformanceAdapter: ManifestConformanceAdapter = {\n\tid: \"@fabricorg/archetypes\",\n\tevaluate: validateArchetypeConformance,\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../index.ts"],"sourcesContent":["import {\n\texportModuleManifest,\n\ttype FabricModule,\n\ttype JsonValue,\n\ttype ModuleManifest,\n\ttype ModuleManifestObjectType,\n\ttype StateClass,\n} from \"@fabricorg/platform\";\n\nexport const ARCHETYPE_SEMANTIC_KEY = \"fabric.archetype\" as const;\n\n/** The six archetypes this package ships. A reference vocabulary, not the whole vocabulary. */\nexport type ArchetypeId =\n\t| \"fabric.Party\"\n\t| \"fabric.Offering\"\n\t| \"fabric.Agreement\"\n\t| \"fabric.Resource\"\n\t| \"fabric.Activity\"\n\t| \"fabric.Settlement\";\n\n/** The same set under the name that says what it is. */\nexport type ReferenceArchetypeId = ArchetypeId;\n\n/**\n * Any archetype id a reference may name: a shipped one, or one a vertical\n * defined with `defineArchetype`. The intersection keeps editor completion for\n * the shipped ids without closing the set.\n */\nexport type AnyArchetypeId = ArchetypeId | (string & {});\n\n/** `<namespace>.<PascalName>`, so a vertical's vocabulary cannot be mistaken for the reference set. */\nexport const ARCHETYPE_ID = /^[a-z][a-z0-9-]*\\.[A-Z][A-Za-z0-9]*$/;\n\n/** Only the reference set may live under this namespace. */\nconst RESERVED_NAMESPACE = \"fabric.\";\n\nexport interface ArchetypeReference {\n\tid: AnyArchetypeId;\n\tversion: string;\n\tstateMap: Record<string, string>;\n}\n\nexport interface ArchetypeState {\n\tid: string;\n\tstateClass: StateClass;\n}\n\nexport interface ArchetypeTransition {\n\tfrom: string;\n\tto: string;\n\trequired?: boolean;\n}\n\nexport interface ArchetypeDefinition {\n\tid: AnyArchetypeId;\n\tversion: string;\n\tdescription: string;\n\tstates: Record<string, ArchetypeState>;\n\ttransitions: ArchetypeTransition[];\n\tobligations: string[];\n}\n\nexport type ConformanceFindingCode =\n\t| \"invalid_annotation\"\n\t| \"unknown_archetype\"\n\t| \"unsupported_archetype_version\"\n\t| \"missing_state_machine\"\n\t| \"unmapped_state\"\n\t| \"unknown_mapped_state\"\n\t| \"unknown_archetype_state\"\n\t| \"incompatible_state_class\"\n\t| \"transition_not_permitted\"\n\t| \"exception_transition_unguarded\"\n\t| \"required_transition_unreachable\";\n\nexport interface ConformanceFinding {\n\tcode: ConformanceFindingCode;\n\tmessage: string;\n\tobjectType: string;\n\tstate?: string;\n\ttarget?: string;\n}\n\nexport interface ArchetypeConformanceReport {\n\tconforms: boolean;\n\tobjectType: string;\n\tarchetype?: string;\n\tfindings: ConformanceFinding[];\n}\n\nexport interface ManifestConformanceAdapter {\n\tid: string;\n\tevaluate(manifest: ModuleManifest): ArchetypeConformanceReport[];\n}\n\nconst states = (definitions: Array<[string, StateClass]>): Record<string, ArchetypeState> =>\n\tObject.fromEntries(definitions.map(([id, stateClass]) => [id, { id, stateClass }]));\n\nexport const ARCHETYPES: Readonly<Record<ArchetypeId, ArchetypeDefinition>> = {\n\t\"fabric.Party\": {\n\t\tid: \"fabric.Party\", version: \"0.1\", description: \"A person or organization participating in business relationships.\",\n\t\tstates: states([[\"prospective\", \"initial\"], [\"active\", \"active\"], [\"inactive\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"prospective\", to: \"active\", required: true }, { from: \"active\", to: \"inactive\" }, { from: \"prospective\", to: \"exception\" }, { from: \"active\", to: \"exception\" }],\n\t\tobligations: [\"identity is tenant-scoped\", \"participation is attributable\"],\n\t},\n\t\"fabric.Offering\": {\n\t\tid: \"fabric.Offering\", version: \"0.1\", description: \"Something a party makes available under defined terms.\",\n\t\tstates: states([[\"available\", \"active\"], [\"retired\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"available\", to: \"retired\" }, { from: \"available\", to: \"exception\" }],\n\t\tobligations: [\"terms are identifiable\", \"availability is explicit\"],\n\t},\n\t\"fabric.Agreement\": {\n\t\tid: \"fabric.Agreement\", version: \"0.1\", description: \"A governed commitment between parties.\",\n\t\tstates: states([[\"proposed\", \"initial\"], [\"committed\", \"active\"], [\"resolved\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"proposed\", to: \"committed\", required: true }, { from: \"committed\", to: \"resolved\", required: true }, { from: \"proposed\", to: \"exception\" }, { from: \"committed\", to: \"exception\" }],\n\t\tobligations: [\"participating parties are attributable\", \"commitment and resolution are auditable\"],\n\t},\n\t\"fabric.Resource\": {\n\t\tid: \"fabric.Resource\", version: \"0.1\", description: \"A capacity or asset allocated by activities.\",\n\t\tstates: states([[\"available\", \"initial\"], [\"allocated\", \"active\"], [\"retired\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"available\", to: \"allocated\", required: true }, { from: \"allocated\", to: \"available\" }, { from: \"available\", to: \"retired\" }, { from: \"allocated\", to: \"exception\" }],\n\t\tobligations: [\"allocation is identifiable\", \"conflicting allocation is governed\"],\n\t},\n\t\"fabric.Activity\": {\n\t\tid: \"fabric.Activity\", version: \"0.1\", description: \"Work planned and performed toward an outcome.\",\n\t\tstates: states([[\"planned\", \"initial\"], [\"executing\", \"active\"], [\"waiting\", \"waiting\"], [\"completed\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"planned\", to: \"executing\", required: true }, { from: \"executing\", to: \"waiting\" }, { from: \"waiting\", to: \"executing\" }, { from: \"executing\", to: \"completed\", required: true }, { from: \"waiting\", to: \"completed\" }, { from: \"planned\", to: \"exception\" }, { from: \"executing\", to: \"exception\" }, { from: \"waiting\", to: \"exception\" }],\n\t\tobligations: [\"responsible party is attributable\", \"resource use and outcome are auditable\"],\n\t},\n\t\"fabric.Settlement\": {\n\t\tid: \"fabric.Settlement\", version: \"0.1\", description: \"Resolution of value exchange associated with an agreement.\",\n\t\tstates: states([[\"pending\", \"initial\"], [\"settled\", \"terminal\"], [\"reversed\", \"terminal\"], [\"exception\", \"exception\"]]),\n\t\ttransitions: [{ from: \"pending\", to: \"settled\", required: true }, { from: \"settled\", to: \"reversed\" }, { from: \"pending\", to: \"exception\" }],\n\t\tobligations: [\"value and currency are explicit\", \"settlement is attributable to an agreement\"],\n\t},\n};\n\nconst STATE_CLASSES: ReadonlySet<string> = new Set([\"initial\", \"active\", \"waiting\", \"terminal\", \"exception\"]);\n\n/**\n * Define an archetype a vertical owns.\n *\n * The shipped six are a reference vocabulary. A platform that has to support\n * verticals nobody has thought of yet cannot ship their nouns, so the seam is\n * the definition itself: a vertical declares its lifecycle classes, permitted\n * refinements, and obligations, and gets the same conformance the reference\n * set gets. Validation here is structural — a definition that names a state\n * its transitions never reach, or a required transition it never declared,\n * would certify nothing and fail nothing.\n */\nexport function defineArchetype(definition: ArchetypeDefinition): ArchetypeDefinition {\n\tif (typeof definition.id !== \"string\" || !ARCHETYPE_ID.test(definition.id)) {\n\t\tthrow new Error(`Archetype id \"${String(definition.id)}\" must be <namespace>.<PascalName>.`);\n\t}\n\tif (typeof definition.version !== \"string\" || definition.version.trim() === \"\") {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare a version.`);\n\t}\n\tif (typeof definition.description !== \"string\" || definition.description.trim() === \"\") {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must describe what it classifies.`);\n\t}\n\tif (!definition.states || typeof definition.states !== \"object\" || Array.isArray(definition.states)) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare its states as a record keyed by id.`);\n\t}\n\tconst stateIds = Object.keys(definition.states);\n\tif (stateIds.length === 0) throw new Error(`Archetype \"${definition.id}\" must declare at least one state.`);\n\tfor (const [key, state] of Object.entries(definition.states)) {\n\t\tif (!state || state.id !== key) throw new Error(`Archetype \"${definition.id}\" state \"${key}\" must be keyed by its own id.`);\n\t\tif (!STATE_CLASSES.has(state.stateClass)) throw new Error(`Archetype \"${definition.id}\" state \"${key}\" has unknown state class \"${String(state.stateClass)}\".`);\n\t}\n\t// A place to start: an initial state, or an active one an object can be\n\t// born into. fabric.Offering has no initial state and is born available.\n\tif (!Object.values(definition.states).some((state) => state.stateClass === \"initial\" || state.stateClass === \"active\")) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare an initial or active state to start in.`);\n\t}\n\tif (!Object.values(definition.states).some((state) => state.stateClass === \"terminal\" || state.stateClass === \"exception\")) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare a terminal or exception state, or nothing ever ends.`);\n\t}\n\tif (!Array.isArray(definition.transitions)) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" must declare its transitions as an array.`);\n\t}\n\tconst seen = new Set<string>();\n\tfor (const transition of definition.transitions) {\n\t\tif (!Object.hasOwn(definition.states, transition.from) || !Object.hasOwn(definition.states, transition.to)) {\n\t\t\tthrow new Error(`Archetype \"${definition.id}\" transition \"${transition.from}\" -> \"${transition.to}\" names an undeclared state.`);\n\t\t}\n\t\tif (transition.from === transition.to) throw new Error(`Archetype \"${definition.id}\" transition \"${transition.from}\" -> \"${transition.to}\" is a self-loop.`);\n\t\tconst key = transitionKey(transition.from, transition.to);\n\t\tif (seen.has(key)) throw new Error(`Archetype \"${definition.id}\" declares transition \"${transition.from}\" -> \"${transition.to}\" twice.`);\n\t\tseen.add(key);\n\t}\n\tif (!Array.isArray(definition.obligations) || definition.obligations.some((item) => typeof item !== \"string\" || item.trim() === \"\")) {\n\t\tthrow new Error(`Archetype \"${definition.id}\" obligations must be non-empty strings.`);\n\t}\n\t// Shape first, then name: a malformed definition gets the named error for\n\t// its shape, and only a well-formed one is compared to the reference set.\n\tif (definition.id.startsWith(RESERVED_NAMESPACE)) {\n\t\tconst reference = Object.hasOwn(ARCHETYPES, definition.id) ? ARCHETYPES[definition.id as ArchetypeId] : undefined;\n\t\tif (!reference || !sameArchetype(reference, definition)) {\n\t\t\tthrow new Error(`Archetype \"${definition.id}\" uses the reserved \"fabric.\" namespace; choose a namespace of your own.`);\n\t\t}\n\t}\n\treturn Object.freeze({\n\t\tid: definition.id,\n\t\tversion: definition.version,\n\t\tdescription: definition.description,\n\t\tstates: Object.freeze(Object.fromEntries(Object.entries(definition.states).map(([key, state]) => [key, Object.freeze({ ...state })]))),\n\t\ttransitions: Object.freeze(definition.transitions.map((transition) => Object.freeze({ ...transition }))) as ArchetypeTransition[],\n\t\tobligations: Object.freeze([...definition.obligations]) as string[],\n\t});\n}\n\nexport interface ArchetypeConformance {\n\t/** Every archetype this conformance recognises, by id. */\n\treadonly definitions: Readonly<Record<string, ArchetypeDefinition>>;\n\tvalidate(manifest: ModuleManifest): ArchetypeConformanceReport[];\n\tassert(module: FabricModule<unknown>): void;\n\t/** For certification tooling; the compiler never learns an archetype name. */\n\treadonly adapter: ManifestConformanceAdapter;\n}\n\n/**\n * Conformance over a vertical's archetypes plus, by default, the reference set.\n *\n * An id the reference set already uses is accepted only when it is the very\n * same definition. Two meanings of `fabric.Party` in one assembly is not an\n * extension, it is a collision, and it is refused here rather than discovered\n * when two modules disagree at registration.\n */\nexport function createArchetypeConformance(\n\tdefinitions: readonly ArchetypeDefinition[],\n\toptions: { includeReference?: boolean; id?: string } = {},\n): ArchetypeConformance {\n\tconst merged: Record<string, ArchetypeDefinition> = options.includeReference === false ? {} : { ...ARCHETYPES };\n\tfor (const definition of definitions) {\n\t\tconst defined = defineArchetype(definition);\n\t\tconst existing = merged[defined.id];\n\t\tif (existing && !sameArchetype(existing, defined)) {\n\t\t\tthrow new Error(`Archetype \"${defined.id}\" is defined twice.`);\n\t\t}\n\t\tmerged[defined.id] = existing ?? defined;\n\t}\n\tconst frozen = Object.freeze(merged);\n\tconst validate = (manifest: ModuleManifest) => validateArchetypeConformance(manifest, frozen);\n\t// A distinct default id: certification tooling keys results by adapter id\n\t// and does not dedupe, so this must not collide with the shipped adapter.\n\tconst adapterId = options.id ?? `@fabricorg/archetypes:${[\n\t\t...(options.includeReference === false ? [] : [\"reference\"]),\n\t\t...definitions.map((definition) => definition.id).sort(),\n\t].join(\"+\") || \"none\"}`;\n\treturn {\n\t\tdefinitions: frozen,\n\t\tvalidate,\n\t\tassert(module) { assertArchetypeConformance(module, frozen); },\n\t\tadapter: { id: adapterId, evaluate: validate },\n\t};\n}\n\n/** Same meaning, whatever the object identity: a definition repeated verbatim is not a collision. */\nfunction sameArchetype(left: ArchetypeDefinition, right: ArchetypeDefinition): boolean {\n\tconst canonical = (definition: ArchetypeDefinition) => JSON.stringify({\n\t\tid: definition.id,\n\t\tversion: definition.version,\n\t\tdescription: definition.description,\n\t\tstates: Object.keys(definition.states).sort().map((key) => [key, definition.states[key]!.stateClass]),\n\t\ttransitions: definition.transitions\n\t\t\t.map((transition) => JSON.stringify([transition.from, transition.to, transition.required === true]))\n\t\t\t.sort(),\n\t\tobligations: [...definition.obligations].sort(),\n\t});\n\treturn canonical(left) === canonical(right);\n}\n\nexport function archetypeSemantics(reference: ArchetypeReference): Record<string, JsonValue> {\n\treturn { [ARCHETYPE_SEMANTIC_KEY]: reference as unknown as JsonValue };\n}\n\nexport function readArchetypeReference(\n\tobjectType: ModuleManifestObjectType,\n): ArchetypeReference | undefined {\n\tconst value = objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY];\n\tif (value === undefined) return undefined;\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst record = value as Record<string, JsonValue>;\n\tif (typeof record.id !== \"string\" || typeof record.version !== \"string\" || !record.stateMap || typeof record.stateMap !== \"object\" || Array.isArray(record.stateMap)) return undefined;\n\tif (!Object.values(record.stateMap).every((state) => typeof state === \"string\")) return undefined;\n\treturn { id: record.id as AnyArchetypeId, version: record.version, stateMap: record.stateMap as Record<string, string> };\n}\n\nconst transitionKey = (from: string, to: string) => `${from}->${to}`;\n\nexport function validateArchetypeConformance(\n\tmanifest: ModuleManifest,\n\tdefinitions: Readonly<Record<string, ArchetypeDefinition>> = ARCHETYPES,\n): ArchetypeConformanceReport[] {\n\treturn manifest.objectTypes\n\t\t.filter((objectType) => objectType.semantics?.[ARCHETYPE_SEMANTIC_KEY] !== undefined)\n\t\t.map((objectType) => validateObject(manifest, objectType, definitions));\n}\n\nfunction validateObject(\n\tmanifest: ModuleManifest,\n\tobjectType: ModuleManifestObjectType,\n\tdefinitions: Readonly<Record<string, ArchetypeDefinition>>,\n): ArchetypeConformanceReport {\n\tconst findings: ConformanceFinding[] = [];\n\tconst reference = readArchetypeReference(objectType);\n\tif (!reference) {\n\t\tfindings.push({ code: \"invalid_annotation\", objectType: objectType.type, message: `Object \"${objectType.type}\" has an invalid ${ARCHETYPE_SEMANTIC_KEY} annotation.` });\n\t\treturn { conforms: false, objectType: objectType.type, findings };\n\t}\n\tconst definition = Object.hasOwn(definitions, reference.id) ? definitions[reference.id] : undefined;\n\tif (!definition) {\n\t\tfindings.push({ code: \"unknown_archetype\", objectType: objectType.type, message: `Unknown archetype \"${reference.id}\".` });\n\t\treturn { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n\t}\n\tif (reference.version !== definition.version) {\n\t\tfindings.push({ code: \"unsupported_archetype_version\", objectType: objectType.type, message: `Archetype \"${reference.id}\" supports version ${definition.version}, received ${reference.version}.` });\n\t}\n\tconst machine = (manifest.stateMachines ?? []).find((candidate) => candidate.entityType === objectType.type);\n\tif (!machine) {\n\t\tfindings.push({ code: \"missing_state_machine\", objectType: objectType.type, message: `Object \"${objectType.type}\" needs a state machine for archetype conformance.` });\n\t\treturn { conforms: false, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n\t}\n\tconst declaredStates = new Set(machine.states.map((state) => state.id));\n\tfor (const state of Object.keys(reference.stateMap)) {\n\t\tif (!declaredStates.has(state)) findings.push({ code: \"unknown_mapped_state\", objectType: objectType.type, state, message: `State mapping \"${state}\" does not name a declared state.` });\n\t}\n\tfor (const state of machine.states) {\n\t\tconst mapped = reference.stateMap[state.id];\n\t\tif (!mapped) {\n\t\t\tfindings.push({ code: \"unmapped_state\", objectType: objectType.type, state: state.id, message: `State \"${state.id}\" is not mapped.` });\n\t\t\tcontinue;\n\t\t}\n\t\tconst base = Object.hasOwn(definition.states, mapped) ? definition.states[mapped] : undefined;\n\t\tif (!base) {\n\t\t\tfindings.push({ code: \"unknown_archetype_state\", objectType: objectType.type, state: state.id, target: mapped, message: `State \"${state.id}\" maps to unknown archetype state \"${mapped}\".` });\n\t\t} else if (base.stateClass !== state.stateClass) {\n\t\t\tfindings.push({ code: \"incompatible_state_class\", objectType: objectType.type, state: state.id, target: mapped, message: `State \"${state.id}\" (${state.stateClass}) is incompatible with \"${mapped}\" (${base.stateClass}).` });\n\t\t}\n\t}\n\tconst permitted = new Set(definition.transitions.map((transition) => transitionKey(transition.from, transition.to)));\n\tconst realized = new Set<string>();\n\tfor (const transition of machine.transitions) {\n\t\tconst from = reference.stateMap[transition.from];\n\t\tconst to = reference.stateMap[transition.to];\n\t\tif (!from || !to) continue;\n\t\t// By class, never by name: a vertical calls its exception state whatever it likes.\n\t\tif (Object.hasOwn(definition.states, to) && definition.states[to]!.stateClass === \"exception\" && !transition.hasGuard) {\n\t\t\tfindings.push({ code: \"exception_transition_unguarded\", objectType: objectType.type, state: transition.from, target: transition.to, message: `Exception transition \"${transition.from}\" -> \"${transition.to}\" must declare a governance guard.` });\n\t\t}\n\t\tif (from !== to && !permitted.has(transitionKey(from, to))) {\n\t\t\tfindings.push({ code: \"transition_not_permitted\", objectType: objectType.type, state: transition.from, target: transition.to, message: `Transition \"${transition.from}\" -> \"${transition.to}\" maps to disallowed archetype transition \"${from}\" -> \"${to}\".` });\n\t\t} else if (from !== to) {\n\t\t\trealized.add(transitionKey(from, to));\n\t\t}\n\t}\n\tfor (const required of definition.transitions.filter((transition) => transition.required)) {\n\t\tif (!realized.has(transitionKey(required.from, required.to))) {\n\t\t\tfindings.push({ code: \"required_transition_unreachable\", objectType: objectType.type, state: required.from, target: required.to, message: `Required archetype transition \"${required.from}\" -> \"${required.to}\" is not realized.` });\n\t\t}\n\t}\n\treturn { conforms: findings.length === 0, objectType: objectType.type, archetype: `${reference.id}@${reference.version}`, findings };\n}\n\nexport function assertArchetypeConformance(\n\tmodule: FabricModule<unknown>,\n\tdefinitions: Readonly<Record<string, ArchetypeDefinition>> = ARCHETYPES,\n): void {\n\tconst failures = validateArchetypeConformance(exportModuleManifest(module), definitions).filter((report) => !report.conforms);\n\tif (failures.length > 0) {\n\t\tthrow new Error(`Archetype conformance failed:\\n${failures.flatMap((report) => report.findings.map((finding) => `- ${report.objectType}: ${finding.message}`)).join(\"\\n\")}`);\n\t}\n}\n\nexport const archetypeConformanceAdapter: ManifestConformanceAdapter = {\n\tid: \"@fabricorg/archetypes\",\n\tevaluate: validateArchetypeConformance,\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabricorg/archetypes",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "Optional cross-industry archetype vocabulary and conformance tools for Fabric module manifests.",
   "license": "MIT",
   "type": "module",
@@ -25,14 +25,14 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
-    "@fabricorg/platform": "^1.3.0"
+    "@fabricorg/platform": "^1.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "tsup": "^8.5.0",
     "typescript": "^5.7.3",
     "vitest": "^4.1.5",
-    "@fabricorg/platform": "^1.3.0"
+    "@fabricorg/platform": "^1.4.0"
   },
   "engines": {
     "node": ">=20"