@ybotok/loam 0.1.0-beta.3 → 0.2.0-alpha.13

package/dist/core/openspec/decide/capabilities.js

@@ -0,0 +1,244 @@
+/**
+ * Which service owns which capability, and which feature owns which change —
+ * the two decisions a human has to make, graded against what the scan found.
+ *
+ * The routing this produces is what everything downstream selects with, which
+ * is why `servicesForRequirement` is returned as a function rather than as a
+ * map: a split capability routes per REQUIREMENT and a single-service one
+ * routes wholesale, and a caller that reimplemented that choice would put a
+ * living requirement and its own delta in different services.
+ */
+import { resolve } from "node:path";
+import { dictionary, ownValue } from "../../kernel/records.js";
+import { FEATURE_ID_RULE, isFeatureId } from "../../kernel/ids/feature.js";
+import { compareIds } from "../../repo/entries.js";
+import { parseRequirements } from "../../document/parse.js";
+import {} from "../../document/spec.js";
+import {} from "../model/mapping.js";
+import {} from "../model/model.js";
+import { titleFromChangeId } from "../scan/changes.js";
+export function capabilityDecisions(scan) {
+    const { root, mapping, bound, inventoryDigest, livingRequirements, active, renamed } = scan;
+    // Capability ownership must cover the active horizon too: a brand-new
+    // capability may exist only under changes/<id>/specs until archive.
+    //
+    // `routedNames` is the subset a split capability must actually allocate. A
+    // renamed requirement is routed by its FROM — that is what keeps the delta in
+    // the same services as the living text it rewrites — so demanding an
+    // allocation for its TO as well asked a reviewer for a decision apply ignores.
+    const requirementNamesByCapability = new Map();
+    const routedNamesByCapability = new Map();
+    const activeChangesByCapability = new Map();
+    const activeRenamePairs = renamed.filter((rename) => rename.scope === "active"
+        && rename.from !== null && rename.from !== ""
+        && rename.to !== null && rename.to !== "");
+    for (const [capability, requirements] of livingRequirements) {
+        requirementNamesByCapability.set(capability, new Set(requirements.map((item) => item.name)));
+        routedNamesByCapability.set(capability, new Set(requirements.map((item) => item.name)));
+    }
+    for (const change of active) {
+        for (const spec of change.specs) {
+            const names = requirementNamesByCapability.get(spec.capability) ?? new Set();
+            const routed = routedNamesByCapability.get(spec.capability) ?? new Set();
+            for (const name of spec.requirementNames) {
+                names.add(name);
+                const pairs = activeRenamePairs.filter((rename) => rename.changeId === change.id
+                    && rename.capability === spec.capability
+                    && (name === rename.from || name === rename.to));
+                routed.add(pairs.length === 1 ? pairs[0].from : name);
+            }
+            requirementNamesByCapability.set(spec.capability, names);
+            routedNamesByCapability.set(spec.capability, routed);
+            const changes = activeChangesByCapability.get(spec.capability) ?? new Set();
+            changes.add(change.id);
+            activeChangesByCapability.set(spec.capability, changes);
+        }
+    }
+    const allCapabilityIds = [...requirementNamesByCapability.keys()].sort(compareIds);
+    const mappingIssues = [];
+    if (bound) {
+        if (mapping.source === null) {
+            mappingIssues.push({
+                code: "mapping.source-missing",
+                key: "source",
+                message: "Mapping is not bound to an audited source root and inventory digest.",
+            });
+        }
+        else {
+            if (resolve(mapping.source.root) !== root) {
+                mappingIssues.push({
+                    code: "mapping.source-root-mismatch",
+                    key: "source.root",
+                    message: `Mapping was created for ${mapping.source.root}, not ${root}.`,
+                });
+            }
+            if (mapping.source.inventoryDigest !== inventoryDigest) {
+                mappingIssues.push({
+                    code: "mapping.source-digest-mismatch",
+                    key: "source.inventoryDigest",
+                    message: `OpenSpec source changed after audit (${mapping.source.inventoryDigest} != ${inventoryDigest}).`,
+                });
+            }
+        }
+    }
+    const capabilityIds = new Set(allCapabilityIds);
+    for (const capability of Object.keys(mapping.capabilities)) {
+        if (!capabilityIds.has(capability)) {
+            mappingIssues.push({
+                code: "mapping.unknown-capability",
+                key: capability,
+                message: `Mapping names unknown capability '${capability}'.`,
+            });
+        }
+    }
+    const mappingDecisions = allCapabilityIds.map((capability) => {
+        const capabilityMapping = ownValue(mapping.capabilities, capability)
+            ?? { services: [], requirementServices: dictionary() };
+        const services = [...new Set(capabilityMapping.services)]
+            .filter((service) => service.trim() !== "")
+            .sort(compareIds);
+        const requirementNames = [...(requirementNamesByCapability.get(capability) ?? [])].sort(compareIds);
+        const requirementNameSet = new Set(requirementNames);
+        const routedNames = [...(routedNamesByCapability.get(capability) ?? [])].sort(compareIds);
+        const requirementServices = dictionary();
+        for (const [requirement, allocated] of Object.entries(capabilityMapping.requirementServices)) {
+            if (!requirementNameSet.has(requirement)) {
+                mappingIssues.push({
+                    code: "mapping.unknown-requirement",
+                    key: `${capability}:${requirement}`,
+                    message: `Capability '${capability}' mapping names unknown requirement '${requirement}'.`,
+                });
+                continue;
+            }
+            const selected = [...new Set(allocated)].filter(Boolean).sort(compareIds);
+            requirementServices[requirement] = selected;
+            for (const service of selected) {
+                if (!services.includes(service)) {
+                    mappingIssues.push({
+                        code: "mapping.requirement-service-unknown",
+                        key: `${capability}:${requirement}`,
+                        message: `Requirement '${requirement}' is allocated to '${service}', which is not in capability '${capability}' services.`,
+                    });
+                }
+            }
+        }
+        // Only routed names get an empty slot in the skeleton: an unroutable name
+        // offered for allocation is a decision that changes nothing.
+        for (const requirement of routedNames) {
+            if (ownValue(requirementServices, requirement) === undefined)
+                requirementServices[requirement] = [];
+        }
+        if (services.length > 1) {
+            for (const requirement of routedNames) {
+                if ((ownValue(requirementServices, requirement) ?? []).length === 0) {
+                    mappingIssues.push({
+                        code: "mapping.requirement-allocation-missing",
+                        key: `${capability}:${requirement}`,
+                        message: `Split capability '${capability}' must allocate requirement '${requirement}' to at least one selected service.`,
+                    });
+                }
+            }
+            for (const service of services) {
+                if (!Object.values(requirementServices).some((selected) => selected.includes(service))) {
+                    mappingIssues.push({
+                        code: "mapping.service-allocation-empty",
+                        key: `${capability}:${service}`,
+                        message: `Split capability '${capability}' selects service '${service}' but allocates no requirement to it.`,
+                    });
+                }
+            }
+        }
+        return {
+            capability,
+            service: services.length === 1 ? services[0] : null,
+            services,
+            requirementServices,
+            suggestedService: capability.split("/").at(-1) ?? capability,
+            hasLivingSpec: livingRequirements.has(capability),
+            activeChanges: [...(activeChangesByCapability.get(capability) ?? [])].sort(compareIds),
+            status: services.length === 0 ? "needsMapping" : "mapped",
+        };
+    });
+    const decisionsByCapability = new Map(mappingDecisions.map((decision) => [decision.capability, decision]));
+    const servicesForRequirement = (capability, requirement) => {
+        const decision = decisionsByCapability.get(capability);
+        if (decision === undefined)
+            return [];
+        return decision.services.length === 1
+            ? decision.services
+            : ownValue(decision.requirementServices, requirement) ?? [];
+    };
+    const livingByService = new Map();
+    for (const [capability, requirements] of livingRequirements) {
+        for (const requirement of requirements) {
+            for (const service of servicesForRequirement(capability, requirement.name)) {
+                const routed = livingByService.get(service) ?? [];
+                routed.push({ capability, requirement });
+                livingByService.set(service, routed);
+            }
+        }
+    }
+    const activeChangeIds = new Set(active.map((change) => change.id));
+    for (const change of Object.keys(mapping.changes)) {
+        if (!activeChangeIds.has(change)) {
+            mappingIssues.push({
+                code: "mapping.unknown-change",
+                key: change,
+                message: `Mapping names unknown active change '${change}'.`,
+            });
+        }
+    }
+    const changeDecisions = active.map((change, index) => {
+        const suggestedTitle = titleFromChangeId(change.id);
+        const selected = ownValue(mapping.changes, change.id);
+        const feature = selected?.feature ?? null;
+        const title = selected?.title?.trim() ?? suggestedTitle;
+        if (selected !== undefined && title === "") {
+            mappingIssues.push({
+                code: "mapping.change-title-missing",
+                key: change.id,
+                message: `Active change '${change.id}' needs a non-empty title.`,
+            });
+        }
+        if (feature !== null && !isFeatureId(feature)) {
+            mappingIssues.push({
+                code: "mapping.feature-id-invalid",
+                key: change.id,
+                message: `Active change '${change.id}' maps to invalid loam feature id '${feature}'. ${FEATURE_ID_RULE}`,
+            });
+        }
+        return {
+            change: change.id,
+            feature,
+            title,
+            suggestedFeature: `FEAT-${index + 1}`,
+            suggestedTitle,
+            status: feature === null || title === "" ? "needsFeature" : "mapped",
+        };
+    });
+    const featureOwners = new Map();
+    for (const decision of changeDecisions) {
+        if (decision.feature === null || !isFeatureId(decision.feature))
+            continue;
+        const key = decision.feature.toLowerCase();
+        const owners = featureOwners.get(key) ?? [];
+        owners.push(decision.change);
+        featureOwners.set(key, owners);
+    }
+    for (const [feature, owners] of featureOwners) {
+        if (owners.length > 1) {
+            mappingIssues.push({
+                code: "mapping.feature-id-duplicate",
+                key: feature,
+                message: `Loam feature id '${feature}' is assigned to multiple OpenSpec changes: ${owners.join(", ")}.`,
+            });
+        }
+    }
+    return {
+        mappingIssues,
+        mappingDecisions,
+        changeDecisions,
+        routing: { servicesForRequirement, livingByService },
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/core/openspec/decide/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../../src/core/openspec/decide/capabilities.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Which service owns which capability, and which feature owns which change —\n * the two decisions a human has to make, graded against what the scan found.\n *\n * The routing this produces is what everything downstream selects with, which\n * is why `servicesForRequirement` is returned as a function rather than as a\n * map: a split capability routes per REQUIREMENT and a single-service one\n * routes wholesale, and a caller that reimplemented that choice would put a\n * living requirement and its own delta in different services.\n */\nimport { resolve } from \"node:path\";\nimport { dictionary, ownValue } from \"../../kernel/records.js\";\nimport { FEATURE_ID_RULE, isFeatureId } from \"../../kernel/ids/feature.js\";\nimport { compareIds } from \"../../repo/entries.js\";\nimport { parseRequirements } from \"../../document/parse.js\";\nimport { type Requirement } from \"../../document/spec.js\";\nimport {\n  type OpenSpecMapping,\n  type CapabilityMappingDecision,\n  type OpenSpecChangeDecision,\n  type OpenSpecMappingIssue,\n} from \"../model/mapping.js\";\nimport { type OpenSpecChange, type OpenSpecRenamedUsage } from \"../model/model.js\";\nimport { titleFromChangeId } from \"../scan/changes.js\";\n\n/** Everything the workspace scan found, before any decision is graded. */\nexport interface Scan {\n  root: string;\n  mapping: OpenSpecMapping;\n  /** Whether a mapping was SUPPLIED — an audit grades no source binding. */\n  bound: boolean;\n  inventoryDigest: string;\n  livingRequirements: Map<string, Requirement[]>;\n  active: OpenSpecChange[];\n  renamed: OpenSpecRenamedUsage[];\n}\n\n/** How a requirement reaches a service, once the capability decisions are in. */\nexport interface Routing {\n  servicesForRequirement(capability: string, requirement: string): string[];\n  livingByService: Map<string, Array<{ capability: string; requirement: Requirement }>>;\n}\n\nexport interface Decisions {\n  mappingIssues: OpenSpecMappingIssue[];\n  mappingDecisions: CapabilityMappingDecision[];\n  changeDecisions: OpenSpecChangeDecision[];\n  routing: Routing;\n}\n\nexport function capabilityDecisions(scan: Scan): Decisions {\n  const { root, mapping, bound, inventoryDigest, livingRequirements, active, renamed } = scan;\n    // Capability ownership must cover the active horizon too: a brand-new\n    // capability may exist only under changes/<id>/specs until archive.\n    //\n    // `routedNames` is the subset a split capability must actually allocate. A\n    // renamed requirement is routed by its FROM — that is what keeps the delta in\n    // the same services as the living text it rewrites — so demanding an\n    // allocation for its TO as well asked a reviewer for a decision apply ignores.\n    const requirementNamesByCapability = new Map<string, Set<string>>();\n    const routedNamesByCapability = new Map<string, Set<string>>();\n    const activeChangesByCapability = new Map<string, Set<string>>();\n    const activeRenamePairs = renamed.filter((rename) =>\n      rename.scope === \"active\"\n      && rename.from !== null && rename.from !== \"\"\n      && rename.to !== null && rename.to !== \"\");\n    for (const [capability, requirements] of livingRequirements) {\n      requirementNamesByCapability.set(capability, new Set(requirements.map((item) => item.name)));\n      routedNamesByCapability.set(capability, new Set(requirements.map((item) => item.name)));\n    }\n    for (const change of active) {\n      for (const spec of change.specs) {\n        const names = requirementNamesByCapability.get(spec.capability) ?? new Set<string>();\n        const routed = routedNamesByCapability.get(spec.capability) ?? new Set<string>();\n        for (const name of spec.requirementNames) {\n          names.add(name);\n          const pairs = activeRenamePairs.filter((rename) =>\n            rename.changeId === change.id\n            && rename.capability === spec.capability\n            && (name === rename.from || name === rename.to));\n          routed.add(pairs.length === 1 ? pairs[0]!.from! : name);\n        }\n        requirementNamesByCapability.set(spec.capability, names);\n        routedNamesByCapability.set(spec.capability, routed);\n        const changes = activeChangesByCapability.get(spec.capability) ?? new Set<string>();\n        changes.add(change.id);\n        activeChangesByCapability.set(spec.capability, changes);\n      }\n    }\n    const allCapabilityIds = [...requirementNamesByCapability.keys()].sort(compareIds);\n\n    const mappingIssues: OpenSpecMappingIssue[] = [];\n    if (bound) {\n      if (mapping.source === null) {\n        mappingIssues.push({\n          code: \"mapping.source-missing\",\n          key: \"source\",\n          message: \"Mapping is not bound to an audited source root and inventory digest.\",\n        });\n      } else {\n        if (resolve(mapping.source.root) !== root) {\n          mappingIssues.push({\n            code: \"mapping.source-root-mismatch\",\n            key: \"source.root\",\n            message: `Mapping was created for ${mapping.source.root}, not ${root}.`,\n          });\n        }\n        if (mapping.source.inventoryDigest !== inventoryDigest) {\n          mappingIssues.push({\n            code: \"mapping.source-digest-mismatch\",\n            key: \"source.inventoryDigest\",\n            message: `OpenSpec source changed after audit (${mapping.source.inventoryDigest} != ${inventoryDigest}).`,\n          });\n        }\n      }\n    }\n    const capabilityIds = new Set(allCapabilityIds);\n    for (const capability of Object.keys(mapping.capabilities)) {\n      if (!capabilityIds.has(capability)) {\n        mappingIssues.push({\n          code: \"mapping.unknown-capability\",\n          key: capability,\n          message: `Mapping names unknown capability '${capability}'.`,\n        });\n      }\n    }\n    const mappingDecisions: CapabilityMappingDecision[] = allCapabilityIds.map((capability) => {\n      const capabilityMapping = ownValue(mapping.capabilities, capability)\n        ?? { services: [], requirementServices: dictionary<string[]>() };\n      const services = [...new Set(capabilityMapping.services)]\n        .filter((service) => service.trim() !== \"\")\n        .sort(compareIds);\n      const requirementNames = [...(requirementNamesByCapability.get(capability) ?? [])].sort(compareIds);\n      const requirementNameSet = new Set(requirementNames);\n      const routedNames = [...(routedNamesByCapability.get(capability) ?? [])].sort(compareIds);\n      const requirementServices = dictionary<string[]>();\n      for (const [requirement, allocated] of Object.entries(capabilityMapping.requirementServices)) {\n        if (!requirementNameSet.has(requirement)) {\n          mappingIssues.push({\n            code: \"mapping.unknown-requirement\",\n            key: `${capability}:${requirement}`,\n            message: `Capability '${capability}' mapping names unknown requirement '${requirement}'.`,\n          });\n          continue;\n        }\n        const selected = [...new Set(allocated)].filter(Boolean).sort(compareIds);\n        requirementServices[requirement] = selected;\n        for (const service of selected) {\n          if (!services.includes(service)) {\n            mappingIssues.push({\n              code: \"mapping.requirement-service-unknown\",\n              key: `${capability}:${requirement}`,\n              message: `Requirement '${requirement}' is allocated to '${service}', which is not in capability '${capability}' services.`,\n            });\n          }\n        }\n      }\n      // Only routed names get an empty slot in the skeleton: an unroutable name\n      // offered for allocation is a decision that changes nothing.\n      for (const requirement of routedNames) {\n        if (ownValue(requirementServices, requirement) === undefined) requirementServices[requirement] = [];\n      }\n      if (services.length > 1) {\n        for (const requirement of routedNames) {\n          if ((ownValue(requirementServices, requirement) ?? []).length === 0) {\n            mappingIssues.push({\n              code: \"mapping.requirement-allocation-missing\",\n              key: `${capability}:${requirement}`,\n              message: `Split capability '${capability}' must allocate requirement '${requirement}' to at least one selected service.`,\n            });\n          }\n        }\n        for (const service of services) {\n          if (!Object.values(requirementServices).some((selected) => selected.includes(service))) {\n            mappingIssues.push({\n              code: \"mapping.service-allocation-empty\",\n              key: `${capability}:${service}`,\n              message: `Split capability '${capability}' selects service '${service}' but allocates no requirement to it.`,\n            });\n          }\n        }\n      }\n      return {\n        capability,\n        service: services.length === 1 ? services[0]! : null,\n        services,\n        requirementServices,\n        suggestedService: capability.split(\"/\").at(-1) ?? capability,\n        hasLivingSpec: livingRequirements.has(capability),\n        activeChanges: [...(activeChangesByCapability.get(capability) ?? [])].sort(compareIds),\n        status: services.length === 0 ? \"needsMapping\" : \"mapped\",\n      };\n    });\n    const decisionsByCapability = new Map(mappingDecisions.map((decision) => [decision.capability, decision]));\n    const servicesForRequirement = (capability: string, requirement: string): string[] => {\n      const decision = decisionsByCapability.get(capability);\n      if (decision === undefined) return [];\n      return decision.services.length === 1\n        ? decision.services\n        : ownValue(decision.requirementServices, requirement) ?? [];\n    };\n    const livingByService = new Map<string, Array<{ capability: string; requirement: ReturnType<typeof parseRequirements>[number] }>>();\n    for (const [capability, requirements] of livingRequirements) {\n      for (const requirement of requirements) {\n        for (const service of servicesForRequirement(capability, requirement.name)) {\n          const routed = livingByService.get(service) ?? [];\n          routed.push({ capability, requirement });\n          livingByService.set(service, routed);\n        }\n      }\n    }\n\n    const activeChangeIds = new Set(active.map((change) => change.id));\n    for (const change of Object.keys(mapping.changes)) {\n      if (!activeChangeIds.has(change)) {\n        mappingIssues.push({\n          code: \"mapping.unknown-change\",\n          key: change,\n          message: `Mapping names unknown active change '${change}'.`,\n        });\n      }\n    }\n    const changeDecisions: OpenSpecChangeDecision[] = active.map((change, index) => {\n      const suggestedTitle = titleFromChangeId(change.id);\n      const selected = ownValue(mapping.changes, change.id);\n      const feature = selected?.feature ?? null;\n      const title = selected?.title?.trim() ?? suggestedTitle;\n      if (selected !== undefined && title === \"\") {\n        mappingIssues.push({\n          code: \"mapping.change-title-missing\",\n          key: change.id,\n          message: `Active change '${change.id}' needs a non-empty title.`,\n        });\n      }\n      if (feature !== null && !isFeatureId(feature)) {\n        mappingIssues.push({\n          code: \"mapping.feature-id-invalid\",\n          key: change.id,\n          message: `Active change '${change.id}' maps to invalid loam feature id '${feature}'. ${FEATURE_ID_RULE}`,\n        });\n      }\n      return {\n        change: change.id,\n        feature,\n        title,\n        suggestedFeature: `FEAT-${index + 1}`,\n        suggestedTitle,\n        status: feature === null || title === \"\" ? \"needsFeature\" : \"mapped\",\n      };\n    });\n    const featureOwners = new Map<string, string[]>();\n    for (const decision of changeDecisions) {\n      if (decision.feature === null || !isFeatureId(decision.feature)) continue;\n      const key = decision.feature.toLowerCase();\n      const owners = featureOwners.get(key) ?? [];\n      owners.push(decision.change);\n      featureOwners.set(key, owners);\n    }\n    for (const [feature, owners] of featureOwners) {\n      if (owners.length > 1) {\n        mappingIssues.push({\n          code: \"mapping.feature-id-duplicate\",\n          key: feature,\n          message: `Loam feature id '${feature}' is assigned to multiple OpenSpec changes: ${owners.join(\", \")}.`,\n        });\n      }\n    }\n  return {\n    mappingIssues,\n    mappingDecisions,\n    changeDecisions,\n    routing: { servicesForRequirement, livingByService },\n  };\n}\n"]}

package/dist/core/openspec/decide/dispositions.js

@@ -0,0 +1,63 @@
+/**
+ * What happens to each authored artifact loam has no equivalent for: a
+ * proposal, a task list, a design note.
+ *
+ * Every one of them is a decision rather than a default, because the honest
+ * answers differ per corpus — one team's `design.md` is an ADR, another's is a
+ * scratchpad. A disposition nobody chose is the one way this migration could
+ * quietly drop authored work, so an unset one blocks readiness.
+ */
+import { ownValue } from "../../kernel/records.js";
+import {} from "../model/mapping.js";
+import {} from "../model/model.js";
+export function artifactDispositions(artifacts, mapping, activeChangeIds, mappingIssues) {
+    const decisionKinds = new Set(["proposal", "tasks", "change-design"]);
+    const artifactDecisions = artifacts
+        // Never offer a disposition for an artifact no enumerated change owns —
+        // dot-prefixed change directories are refused, not migrated, and a
+        // `selectedDisposition` recorded for one is a decision about nothing.
+        .filter((artifact) => artifact.scope === "active"
+        && decisionKinds.has(artifact.kind)
+        && artifact.changeId !== undefined
+        && activeChangeIds.has(artifact.changeId))
+        .map((artifact) => {
+        const selected = ownValue(mapping.artifacts, artifact.path) ?? null;
+        return {
+            path: artifact.path,
+            kind: artifact.kind,
+            suggestedDisposition: artifact.disposition,
+            disposition: selected,
+            status: selected === null ? "needsDisposition" : "mapped",
+        };
+    });
+    const artifactPaths = new Set(artifactDecisions.map((decision) => decision.path));
+    // Sets of plain strings: the question being asked is "is this authored value
+    // one of the ones this kind accepts", and a set of the union could not be
+    // asked it without an assertion putting the answer back where it started.
+    const dispositionsByKind = {
+        proposal: new Set(["convert-to-intent", "retain-read-only", "manual-review"]),
+        tasks: new Set(["preserve-as-legacy-checklist", "retain-read-only", "manual-review"]),
+        "change-design": new Set(["review-as-feature-adr", "retain-read-only", "manual-review"]),
+    };
+    for (const [path, disposition] of Object.entries(mapping.artifacts)) {
+        if (!artifactPaths.has(path)) {
+            mappingIssues.push({
+                code: "mapping.unknown-artifact",
+                key: path,
+                message: `Mapping names unknown active authored artifact '${path}'.`,
+            });
+        }
+        else {
+            const decision = artifactDecisions.find((item) => item.path === path);
+            if (dispositionsByKind[decision.kind].has(disposition))
+                continue;
+            mappingIssues.push({
+                code: "mapping.invalid-artifact-disposition",
+                key: path,
+                message: `${decision.kind} artifact '${path}' has unsupported disposition '${disposition}'.`,
+            });
+        }
+    }
+    return artifactDecisions;
+}
+//# sourceMappingURL=dispositions.js.map

package/dist/core/openspec/decide/dispositions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispositions.js","sourceRoot":"","sources":["../../../../src/core/openspec/decide/dispositions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAmD,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAmF,MAAM,mBAAmB,CAAC;AAEpH,MAAM,UAAU,oBAAoB,CAClC,SAA6B,EAC7B,OAAwB,EACxB,eAAoC,EACpC,aAAqC;IAEnC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAuB,CAAC,UAAU,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5F,MAAM,iBAAiB,GAA+B,SAAS;QAC7D,wEAAwE;QACxE,mEAAmE;QACnE,sEAAsE;SACrE,MAAM,CAAC,CAAC,QAAQ,EAAmF,EAAE,CACpG,QAAQ,CAAC,KAAK,KAAK,QAAQ;WACxB,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;WAChC,QAAQ,CAAC,QAAQ,KAAK,SAAS;WAC/B,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChB,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QACpE,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,oBAAoB,EAAE,QAAQ,CAAC,WAAW;YAC1C,WAAW,EAAE,QAAQ;YACrB,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,kBAA2B,CAAC,CAAC,CAAC,QAAiB;SAC5E,CAAC;IACJ,CAAC,CAAC,CAAC;IACL,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAClF,6EAA6E;IAC7E,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,kBAAkB,GAAkE;QACxF,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;QAC7E,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,8BAA8B,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;QACrF,eAAe,EAAE,IAAI,GAAG,CAAC,CAAC,uBAAuB,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;KACzF,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,0BAA0B;gBAChC,GAAG,EAAE,IAAI;gBACT,OAAO,EAAE,mDAAmD,IAAI,IAAI;aACrE,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAE,CAAC;YACvE,IAAI,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;gBAAE,SAAS;YACjE,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,sCAAsC;gBAC5C,GAAG,EAAE,IAAI;gBACT,OAAO,EAAE,GAAG,QAAQ,CAAC,IAAI,cAAc,IAAI,kCAAkC,WAAW,IAAI;aAC7F,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACH,OAAO,iBAAiB,CAAC;AAC3B,CAAC","sourcesContent":["/**\n * What happens to each authored artifact loam has no equivalent for: a\n * proposal, a task list, a design note.\n *\n * Every one of them is a decision rather than a default, because the honest\n * answers differ per corpus — one team's `design.md` is an ADR, another's is a\n * scratchpad. A disposition nobody chose is the one way this migration could\n * quietly drop authored work, so an unset one blocks readiness.\n */\nimport { ownValue } from \"../../kernel/records.js\";\nimport { type OpenSpecMapping, type OpenSpecMappingIssue } from \"../model/mapping.js\";\nimport { type OpenSpecArtifact, type OpenSpecArtifactDecision, type OpenSpecArtifactKind } from \"../model/model.js\";\n\nexport function artifactDispositions(\n  artifacts: OpenSpecArtifact[],\n  mapping: OpenSpecMapping,\n  activeChangeIds: ReadonlySet<string>,\n  mappingIssues: OpenSpecMappingIssue[],\n): OpenSpecArtifactDecision[] {\n    const decisionKinds = new Set<OpenSpecArtifactKind>([\"proposal\", \"tasks\", \"change-design\"]);\n    const artifactDecisions: OpenSpecArtifactDecision[] = artifacts\n      // Never offer a disposition for an artifact no enumerated change owns —\n      // dot-prefixed change directories are refused, not migrated, and a\n      // `selectedDisposition` recorded for one is a decision about nothing.\n      .filter((artifact): artifact is OpenSpecArtifact & { kind: \"proposal\" | \"tasks\" | \"change-design\" } =>\n        artifact.scope === \"active\"\n        && decisionKinds.has(artifact.kind)\n        && artifact.changeId !== undefined\n        && activeChangeIds.has(artifact.changeId))\n      .map((artifact) => {\n        const selected = ownValue(mapping.artifacts, artifact.path) ?? null;\n        return {\n          path: artifact.path,\n          kind: artifact.kind,\n          suggestedDisposition: artifact.disposition,\n          disposition: selected,\n          status: selected === null ? \"needsDisposition\" as const : \"mapped\" as const,\n        };\n      });\n    const artifactPaths = new Set(artifactDecisions.map((decision) => decision.path));\n    // Sets of plain strings: the question being asked is \"is this authored value\n    // one of the ones this kind accepts\", and a set of the union could not be\n    // asked it without an assertion putting the answer back where it started.\n    const dispositionsByKind: Record<OpenSpecArtifactDecision[\"kind\"], ReadonlySet<string>> = {\n      proposal: new Set([\"convert-to-intent\", \"retain-read-only\", \"manual-review\"]),\n      tasks: new Set([\"preserve-as-legacy-checklist\", \"retain-read-only\", \"manual-review\"]),\n      \"change-design\": new Set([\"review-as-feature-adr\", \"retain-read-only\", \"manual-review\"]),\n    };\n    for (const [path, disposition] of Object.entries(mapping.artifacts)) {\n      if (!artifactPaths.has(path)) {\n        mappingIssues.push({\n          code: \"mapping.unknown-artifact\",\n          key: path,\n          message: `Mapping names unknown active authored artifact '${path}'.`,\n        });\n      } else {\n        const decision = artifactDecisions.find((item) => item.path === path)!;\n        if (dispositionsByKind[decision.kind].has(disposition)) continue;\n        mappingIssues.push({\n          code: \"mapping.invalid-artifact-disposition\",\n          key: path,\n          message: `${decision.kind} artifact '${path}' has unsupported disposition '${disposition}'.`,\n        });\n      }\n    }\n  return artifactDecisions;\n}\n"]}

package/dist/core/openspec/decide/renames.js

@@ -0,0 +1,179 @@
+/**
+ * Every active RENAMED pair resolved against the living source of truth.
+ *
+ * This is the identity problem the whole package exists for: OpenSpec renames
+ * by writing FROM/TO bullets, loam renames by carrying one stable
+ * `Requirement-ID` through a MODIFIED requirement, and nothing mechanical
+ * bridges the two. So each pair is either resolved to an id the living text
+ * already carries, or it becomes a decision a human has to make — never a
+ * guess, because a wrong identity silently merges one requirement's text over
+ * another's.
+ *
+ * It MUTATES the usages it resolves rather than returning new ones: a rename is
+ * one fact seen in one file, and two copies of it — one resolved, one not — is
+ * exactly the bug this resolution exists to prevent.
+ */
+import { ownValue } from "../../kernel/records.js";
+import { REQUIREMENT_ID_RE, requirementIdDeclarations } from "../../document/spec.js";
+import {} from "../model/mapping.js";
+import {} from "../model/model.js";
+import {} from "./capabilities.js";
+export function resolveRenames(scan, routing, mappingIssues) {
+    const { mapping, livingRequirements, renamed } = scan;
+    const { livingByService, servicesForRequirement } = routing;
+    const activeRenames = renamed.filter((rename) => rename.scope === "active");
+    const renameKeys = new Set(activeRenames.map((rename) => rename.key));
+    for (const [key, requirementId] of Object.entries(mapping.renames)) {
+        if (!renameKeys.has(key)) {
+            mappingIssues.push({
+                code: "mapping.unknown-rename",
+                key,
+                message: `Mapping names unknown RENAMED pair '${key}'.`,
+            });
+        }
+        else if (!REQUIREMENT_ID_RE.test(requirementId)) {
+            mappingIssues.push({
+                code: "mapping.invalid-requirement-id",
+                key,
+                message: `RENAMED pair '${key}' has invalid Requirement-ID '${requirementId}'.`,
+            });
+        }
+    }
+    // Resolve every rename against the living source of truth. A mapped id is
+    // only needed when the source requirement does not already carry one.
+    for (const rename of activeRenames) {
+        if (rename.from === null || rename.from === "" || rename.to === null || rename.to === "")
+            continue;
+        const living = livingRequirements.get(rename.capability) ?? [];
+        const matches = living.filter((requirement) => requirement.name === rename.from);
+        if (matches.length === 0) {
+            mappingIssues.push({
+                code: "mapping.rename-source-missing",
+                key: rename.key,
+                message: `RENAMED source '${rename.from}' does not exist in living capability '${rename.capability}'.`,
+            });
+            rename.requirementId = null;
+            rename.status = "needsIdentity";
+            continue;
+        }
+        if (matches.length > 1) {
+            mappingIssues.push({
+                code: "mapping.rename-source-ambiguous",
+                key: rename.key,
+                message: `RENAMED source '${rename.from}' matches ${matches.length} living requirements in '${rename.capability}'.`,
+            });
+            rename.requirementId = null;
+            rename.status = "needsIdentity";
+            continue;
+        }
+        const source = matches[0];
+        const declarations = requirementIdDeclarations(source);
+        if (declarations.length > 0
+            && (declarations.length !== 1 || !REQUIREMENT_ID_RE.test(declarations[0]))) {
+            rename.existingRequirementId = source.id ?? null;
+            rename.requirementId = null;
+            rename.status = "needsIdentity";
+            mappingIssues.push({
+                code: "mapping.rename-source-id-invalid",
+                key: rename.key,
+                message: `RENAMED source '${rename.from}' has ${declarations.length === 1 ? "an invalid" : "repeated"} Requirement-ID declaration; repair the living source before migration.`,
+            });
+            continue;
+        }
+        rename.existingRequirementId = source.id ?? null;
+        const requestedId = ownValue(mapping.renames, rename.key) ?? null;
+        if (source.id !== undefined && requestedId !== null && requestedId !== source.id) {
+            mappingIssues.push({
+                code: "mapping.rename-existing-id-conflict",
+                key: rename.key,
+                message: `RENAMED source '${rename.from}' already has Requirement-ID '${source.id}'; mapping cannot replace it with '${requestedId}'.`,
+            });
+        }
+        rename.requirementId = source.id ?? requestedId;
+        rename.status = rename.requirementId === null ? "needsIdentity" : "mapped";
+        const routedServices = servicesForRequirement(rename.capability, rename.from);
+        if (rename.requirementId !== null) {
+            const collisionServices = routedServices.filter((service) => (livingByService.get(service) ?? []).some((entry) => entry.requirement !== source && entry.requirement.id === rename.requirementId));
+            if (collisionServices.length > 0) {
+                mappingIssues.push({
+                    code: "mapping.rename-id-conflict",
+                    key: rename.key,
+                    message: `RENAMED identity '${rename.requirementId}' already belongs to another living requirement in mapped service(s): ${collisionServices.join(", ")}.`,
+                });
+            }
+        }
+        const targetCollisionServices = routedServices.filter((service) => (livingByService.get(service) ?? []).some((entry) => entry.requirement !== source && entry.requirement.name === rename.to));
+        if (rename.to === rename.from || targetCollisionServices.length > 0) {
+            mappingIssues.push({
+                code: "mapping.rename-target-conflict",
+                key: rename.key,
+                message: rename.to === rename.from
+                    ? `RENAMED target '${rename.to}' is the same as its living source.`
+                    : `RENAMED target '${rename.to}' conflicts in mapped service(s): ${targetCollisionServices.join(", ")}.`,
+            });
+        }
+    }
+    const renameSources = new Map();
+    const renameTargets = new Map();
+    for (const rename of activeRenames) {
+        if (rename.from === null || rename.to === null)
+            continue;
+        for (const service of servicesForRequirement(rename.capability, rename.from)) {
+            const sourceKey = `${service}\0${rename.from}`;
+            const targetKey = `${service}\0${rename.to}`;
+            const sources = renameSources.get(sourceKey) ?? [];
+            sources.push(rename);
+            renameSources.set(sourceKey, sources);
+            const targets = renameTargets.get(targetKey) ?? [];
+            targets.push(rename);
+            renameTargets.set(targetKey, targets);
+        }
+    }
+    for (const [key, uses] of renameSources) {
+        if (uses.length > 1) {
+            mappingIssues.push({
+                code: "mapping.rename-double-source",
+                key: key.replace("\0", ":"),
+                message: `Living requirement '${uses[0].from}' is renamed by multiple active changes: ${uses.map((item) => item.changeId).join(", ")}.`,
+            });
+        }
+    }
+    for (const [key, uses] of renameTargets) {
+        if (uses.length > 1) {
+            mappingIssues.push({
+                code: "mapping.rename-double-target",
+                key: key.replace("\0", ":"),
+                message: `Multiple active renames target '${uses[0].to}' in mapped service '${key.split("\0")[0]}'.`,
+            });
+        }
+        if (renameSources.has(key)) {
+            mappingIssues.push({
+                code: "mapping.rename-chain",
+                key: key.replace("\0", ":"),
+                message: `Active rename chain through '${uses[0].to}' must be collapsed into one reviewed rename.`,
+            });
+        }
+    }
+    const renameIdOwners = new Map();
+    for (const rename of activeRenames) {
+        if (rename.requirementId === null || rename.from === null)
+            continue;
+        for (const service of servicesForRequirement(rename.capability, rename.from)) {
+            const key = `${service}\0${rename.requirementId}`;
+            const owners = renameIdOwners.get(key) ?? new Set();
+            owners.add(`${rename.capability}:${rename.from}`);
+            renameIdOwners.set(key, owners);
+        }
+    }
+    for (const [key, owners] of renameIdOwners) {
+        if (owners.size > 1) {
+            const [service, requirementId] = key.split("\0");
+            mappingIssues.push({
+                code: "mapping.rename-id-conflict",
+                key,
+                message: `Requirement-ID '${requirementId}' is assigned to different RENAMED sources in mapped service '${service}': ${[...owners].join(", ")}.`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=renames.js.map

package/dist/core/openspec/decide/renames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renames.js","sourceRoot":"","sources":["../../../../src/core/openspec/decide/renames.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Every active RENAMED pair resolved against the living source of truth.\n *\n * This is the identity problem the whole package exists for: OpenSpec renames\n * by writing FROM/TO bullets, loam renames by carrying one stable\n * `Requirement-ID` through a MODIFIED requirement, and nothing mechanical\n * bridges the two. So each pair is either resolved to an id the living text\n * already carries, or it becomes a decision a human has to make — never a\n * guess, because a wrong identity silently merges one requirement's text over\n * another's.\n *\n * It MUTATES the usages it resolves rather than returning new ones: a rename is\n * one fact seen in one file, and two copies of it — one resolved, one not — is\n * exactly the bug this resolution exists to prevent.\n */\nimport { ownValue } from \"../../kernel/records.js\";\nimport { REQUIREMENT_ID_RE, requirementIdDeclarations } from \"../../document/spec.js\";\nimport { type OpenSpecMappingIssue } from \"../model/mapping.js\";\nimport { type OpenSpecRenamedUsage } from \"../model/model.js\";\nimport { type Scan, type Routing } from \"./capabilities.js\";\n\nexport function resolveRenames(scan: Scan, routing: Routing, mappingIssues: OpenSpecMappingIssue[]): void {\n  const { mapping, livingRequirements, renamed } = scan;\n  const { livingByService, servicesForRequirement } = routing;\n    const activeRenames = renamed.filter((rename) => rename.scope === \"active\");\n    const renameKeys = new Set(activeRenames.map((rename) => rename.key));\n    for (const [key, requirementId] of Object.entries(mapping.renames)) {\n      if (!renameKeys.has(key)) {\n        mappingIssues.push({\n          code: \"mapping.unknown-rename\",\n          key,\n          message: `Mapping names unknown RENAMED pair '${key}'.`,\n        });\n      } else if (!REQUIREMENT_ID_RE.test(requirementId)) {\n        mappingIssues.push({\n          code: \"mapping.invalid-requirement-id\",\n          key,\n          message: `RENAMED pair '${key}' has invalid Requirement-ID '${requirementId}'.`,\n        });\n      }\n    }\n\n    // Resolve every rename against the living source of truth. A mapped id is\n    // only needed when the source requirement does not already carry one.\n    for (const rename of activeRenames) {\n      if (rename.from === null || rename.from === \"\" || rename.to === null || rename.to === \"\") continue;\n      const living = livingRequirements.get(rename.capability) ?? [];\n      const matches = living.filter((requirement) => requirement.name === rename.from);\n      if (matches.length === 0) {\n        mappingIssues.push({\n          code: \"mapping.rename-source-missing\",\n          key: rename.key,\n          message: `RENAMED source '${rename.from}' does not exist in living capability '${rename.capability}'.`,\n        });\n        rename.requirementId = null;\n        rename.status = \"needsIdentity\";\n        continue;\n      }\n      if (matches.length > 1) {\n        mappingIssues.push({\n          code: \"mapping.rename-source-ambiguous\",\n          key: rename.key,\n          message: `RENAMED source '${rename.from}' matches ${matches.length} living requirements in '${rename.capability}'.`,\n        });\n        rename.requirementId = null;\n        rename.status = \"needsIdentity\";\n        continue;\n      }\n      const source = matches[0]!;\n      const declarations = requirementIdDeclarations(source);\n      if (declarations.length > 0\n        && (declarations.length !== 1 || !REQUIREMENT_ID_RE.test(declarations[0]!))) {\n        rename.existingRequirementId = source.id ?? null;\n        rename.requirementId = null;\n        rename.status = \"needsIdentity\";\n        mappingIssues.push({\n          code: \"mapping.rename-source-id-invalid\",\n          key: rename.key,\n          message: `RENAMED source '${rename.from}' has ${declarations.length === 1 ? \"an invalid\" : \"repeated\"} Requirement-ID declaration; repair the living source before migration.`,\n        });\n        continue;\n      }\n      rename.existingRequirementId = source.id ?? null;\n      const requestedId = ownValue(mapping.renames, rename.key) ?? null;\n      if (source.id !== undefined && requestedId !== null && requestedId !== source.id) {\n        mappingIssues.push({\n          code: \"mapping.rename-existing-id-conflict\",\n          key: rename.key,\n          message: `RENAMED source '${rename.from}' already has Requirement-ID '${source.id}'; mapping cannot replace it with '${requestedId}'.`,\n        });\n      }\n      rename.requirementId = source.id ?? requestedId;\n      rename.status = rename.requirementId === null ? \"needsIdentity\" : \"mapped\";\n      const routedServices = servicesForRequirement(rename.capability, rename.from);\n      if (rename.requirementId !== null) {\n        const collisionServices = routedServices.filter((service) =>\n          (livingByService.get(service) ?? []).some(\n            (entry) => entry.requirement !== source && entry.requirement.id === rename.requirementId,\n          ));\n        if (collisionServices.length > 0) {\n          mappingIssues.push({\n            code: \"mapping.rename-id-conflict\",\n            key: rename.key,\n            message: `RENAMED identity '${rename.requirementId}' already belongs to another living requirement in mapped service(s): ${collisionServices.join(\", \")}.`,\n          });\n        }\n      }\n      const targetCollisionServices = routedServices.filter((service) =>\n        (livingByService.get(service) ?? []).some(\n          (entry) => entry.requirement !== source && entry.requirement.name === rename.to,\n        ));\n      if (rename.to === rename.from || targetCollisionServices.length > 0) {\n        mappingIssues.push({\n          code: \"mapping.rename-target-conflict\",\n          key: rename.key,\n          message: rename.to === rename.from\n            ? `RENAMED target '${rename.to}' is the same as its living source.`\n            : `RENAMED target '${rename.to}' conflicts in mapped service(s): ${targetCollisionServices.join(\", \")}.`,\n        });\n      }\n    }\n\n    const renameSources = new Map<string, OpenSpecRenamedUsage[]>();\n    const renameTargets = new Map<string, OpenSpecRenamedUsage[]>();\n    for (const rename of activeRenames) {\n      if (rename.from === null || rename.to === null) continue;\n      for (const service of servicesForRequirement(rename.capability, rename.from)) {\n        const sourceKey = `${service}\\0${rename.from}`;\n        const targetKey = `${service}\\0${rename.to}`;\n        const sources = renameSources.get(sourceKey) ?? [];\n        sources.push(rename);\n        renameSources.set(sourceKey, sources);\n        const targets = renameTargets.get(targetKey) ?? [];\n        targets.push(rename);\n        renameTargets.set(targetKey, targets);\n      }\n    }\n    for (const [key, uses] of renameSources) {\n      if (uses.length > 1) {\n        mappingIssues.push({\n          code: \"mapping.rename-double-source\",\n          key: key.replace(\"\\0\", \":\"),\n          message: `Living requirement '${uses[0]!.from}' is renamed by multiple active changes: ${uses.map((item) => item.changeId).join(\", \")}.`,\n        });\n      }\n    }\n    for (const [key, uses] of renameTargets) {\n      if (uses.length > 1) {\n        mappingIssues.push({\n          code: \"mapping.rename-double-target\",\n          key: key.replace(\"\\0\", \":\"),\n          message: `Multiple active renames target '${uses[0]!.to}' in mapped service '${key.split(\"\\0\")[0]}'.`,\n        });\n      }\n      if (renameSources.has(key)) {\n        mappingIssues.push({\n          code: \"mapping.rename-chain\",\n          key: key.replace(\"\\0\", \":\"),\n          message: `Active rename chain through '${uses[0]!.to}' must be collapsed into one reviewed rename.`,\n        });\n      }\n    }\n    const renameIdOwners = new Map<string, Set<string>>();\n    for (const rename of activeRenames) {\n      if (rename.requirementId === null || rename.from === null) continue;\n      for (const service of servicesForRequirement(rename.capability, rename.from)) {\n        const key = `${service}\\0${rename.requirementId}`;\n        const owners = renameIdOwners.get(key) ?? new Set<string>();\n        owners.add(`${rename.capability}:${rename.from}`);\n        renameIdOwners.set(key, owners);\n      }\n    }\n    for (const [key, owners] of renameIdOwners) {\n      if (owners.size > 1) {\n        const [service, requirementId] = key.split(\"\\0\");\n        mappingIssues.push({\n          code: \"mapping.rename-id-conflict\",\n          key,\n          message: `Requirement-ID '${requirementId}' is assigned to different RENAMED sources in mapped service '${service}': ${[...owners].join(\", \")}.`,\n        });\n      }\n    }\n}\n"]}