yarramate 0.8.0 → 0.8.1

package/catalogues/core-enrichment.yaml

@@ -1,6 +1,6 @@
 format: yarramate/question-catalogue/v1
 id: core-enrichment
-version: "0.4"
+version: "0.5"
 profile: yarramate/core@0.1
 presentation:
   title: Core enrichment interview
@@ -122,7 +122,9 @@ questions:
     authority: either
     resolution: >-
       Add realization relationships from the fulfilling capability or
-      service, or record the aspirational status in the goal's description.
+      service, record the aspirational status in the goal's description,
+      or retire the goal (status: retired) to record that it no longer
+      steers design.
 
 
   - id: goal-no-driver
@@ -219,8 +221,11 @@ questions:
       roadmap.
     authority: either
     resolution: >-
-      Add realization from the fulfilling service, component, or behavior,
-      or record the descoping decision and remove the requirement.
+      Add realization from the fulfilling service, component, or
+      behavior; to descope instead, retire the requirement (status:
+      retired) — retirement preserves the decision on record and closes
+      the question (ADR 0064). Delete only when the history itself is
+      noise.
 
   - id: principle-unapplied
     wave: motivation

package/dist/apply-command.js

@@ -123,7 +123,24 @@ const itemMap = (source, collection, id) => {
 };
 // The indent item fields sit at, read off the item's own first field.
 const fieldIndentOf = (source, map) => indentAt(source, nodeRange(map.items[0].key)[0]);
+// A flow-style item (`- { id: x, ... }`) cannot take block field lines;
+// splicing them after it corrupts the sequence (Codex dogfood finding,
+// 2026-08-01). The whole item is rewritten as a block mapping with the
+// mutation applied — churn confined to the item being edited.
+const rewriteFlowItem = (source, map, mutate) => {
+    const mutated = mutate(map.toJSON());
+    const [start, valueEnd] = nodeRange(map);
+    const fieldIndent = indentAt(source, start);
+    const rendered = reindent(stringify(mutated, { lineWidth: 0 }).trimEnd(), fieldIndent);
+    return splice(source, start, valueEnd, rendered);
+};
 const setScalarField = (source, map, key, value) => {
+    if (map.flow) {
+        return rewriteFlowItem(source, map, (fields) => ({
+            ...fields,
+            [key]: value,
+        }));
+    }
     const indent = fieldIndentOf(source, map);
     const rendered = reindent(valueText(value), indent + 2);
     const pair = pairFor(map, key);
@@ -134,6 +151,15 @@ const setScalarField = (source, map, key, value) => {
     return splice(source, start, valueEnd, rendered);
 };
 const appendListField = (source, map, key, additions) => {
+    if (map.flow) {
+        return rewriteFlowItem(source, map, (fields) => ({
+            ...fields,
+            [key]: [
+                ...(fields[key] ?? []),
+                ...additions,
+            ],
+        }));
+    }
     const indent = fieldIndentOf(source, map);
     const pair = pairFor(map, key);
     if (pair === undefined) {
@@ -163,11 +189,19 @@ const appendListField = (source, map, key, additions) => {
     return splice(source, start, valueEnd, `\n${sequenceEntries(merged, indent + 2)}`);
 };
 // Retraction (#115): delete the field's whole entry, from the start of its
-// key line through the end of its value's last line.
+// key line through the end of its value's last line. A flow item is
+// rewritten instead — line-based deletion there would take the whole item
+// with it.
 const removeField = (source, map, key) => {
     const pair = pairFor(map, key);
     if (pair === undefined)
         return undefined;
+    if (map.flow) {
+        return rewriteFlowItem(source, map, (fields) => {
+            const { [key]: _removed, ...rest } = fields;
+            return rest;
+        });
+    }
     const start = lineStartOf(source, nodeRange(pair.key)[0]);
     const valueEnd = pair.value === null || pair.value === undefined
         ? nodeRange(pair.key)[2]

package/dist/interrogate-command.js

@@ -12,12 +12,6 @@ const indexGraph = (graph) => {
     const stateSubjects = new Set(graph.claims
         .filter(({ predicate }) => predicate === 'yarramate/state/type')
         .map(({ subject }) => subject));
-    // Architecture states carry concept subjects in the graph but are not
-    // enrichment targets; the catalogue interrogates the model, not the
-    // planning overlay.
-    const concepts = new Set(graph.subjects
-        .filter(({ id, type }) => type === 'concept' && !stateSubjects.has(id))
-        .map(({ id }) => id));
     const claimsBySubject = new Map();
     const kindOf = new Map();
     const nameOf = new Map();
@@ -50,6 +44,16 @@ const indexGraph = (graph) => {
             }
         }
     }
+    // Architecture states carry concept subjects in the graph but are not
+    // enrichment targets; the catalogue interrogates the model, not the
+    // planning overlay. Retired concepts are excluded for the same reason
+    // (ADR 0064): retirement is the recorded decision that a subject left
+    // the design conversation, so no question stays open against it.
+    const concepts = new Set(graph.subjects
+        .filter(({ id, type }) => type === 'concept' &&
+        !stateSubjects.has(id) &&
+        statusOf.get(id) !== 'retired')
+        .map(({ id }) => id));
     return {
         concepts,
         claimsBySubject,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yarramate",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Tool-neutral semantic architecture engine and guided methodology",
   "license": "MIT",
   "repository": {