yarramate 0.8.0 → 0.9.0

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/ask-command.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from 'node:url';
 import { parseDocument } from 'yaml';
 import { compareArchitectureStates, } from './architecture-state.js';
 import { renderBrief } from './brief.js';
+import { deriveChangedSubjects } from './changed.js';
 import { runCheckCommand } from './check-command.js';
 import { diagnosticJson, humanDiagnostics, usage, } from './cli-support.js';
 import { compileWorkspaceWithProfileContext, } from './compiler.js';
@@ -124,6 +125,7 @@ export function runAskCommand(options, cwd) {
     let kinds = false;
     let advise = false;
     let compare;
+    let changed;
     let budget;
     let kindFilter;
     let statusFilter;
@@ -172,7 +174,8 @@ export function runAskCommand(options, cwd) {
         if (option === '--budget' ||
             option === '--kind' ||
             option === '--status' ||
-            option === '--catalogue') {
+            option === '--catalogue' ||
+            option === '--changed') {
             const value = options[index + 1];
             if (value === undefined || value.startsWith('-')) {
                 return { exitCode: 2, stdout: '', stderr: usage };
@@ -183,6 +186,12 @@ export function runAskCommand(options, cwd) {
                 }
                 budget = Number(value);
             }
+            else if (option === '--changed') {
+                if (changed !== undefined) {
+                    return { exitCode: 2, stdout: '', stderr: usage };
+                }
+                changed = value;
+            }
             else if (option === '--kind') {
                 if (kindFilter !== undefined) {
                     return { exitCode: 2, stdout: '', stderr: usage };
@@ -223,9 +232,12 @@ export function runAskCommand(options, cwd) {
         (advise && exclusiveModes > 0) ||
         (advise && query.length === 0) ||
         (query.length > 0 && exclusiveModes > 0) ||
+        (changed !== undefined &&
+            (query.length > 0 || exclusiveModes > 0 || advise)) ||
         ((kindFilter !== undefined || statusFilter !== undefined) && !subjects) ||
         (cataloguePath !== undefined && !open && !advise) ||
-        (budget !== undefined && (json || (query.length === 0 && !advise)))) {
+        (budget !== undefined &&
+            (json || (query.length === 0 && !advise && changed === undefined)))) {
         return { exitCode: 2, stdout: '', stderr: usage };
     }
     try {
@@ -263,7 +275,8 @@ export function runAskCommand(options, cwd) {
             !open &&
             !kinds &&
             !advise &&
-            compare === undefined) {
+            compare === undefined &&
+            changed === undefined) {
             const checked = runCheckCommand([workspacePath, '--json'], cwd);
             const checkPayload = JSON.parse(checked.stdout);
             if (!checkPayload.ok) {
@@ -544,6 +557,83 @@ export function runAskCommand(options, cwd) {
             };
             return emit(result, renderInterrogationReport(ordered));
         }
+        // --changed: the review slice (ADR 0065). Git says what changed; the
+        // engine maps changed lines to subjects and renders their connected
+        // neighbourhood, plus a coverage note when a changed subject appears
+        // in no authored projection.
+        if (changed !== undefined) {
+            const documentIdByPath = new Map(graph.documents.map(({ id, source }) => [source, id]));
+            const derived = deriveChangedSubjects(cwd, changed, workspace.documents.map((path) => ({
+                path,
+                source: readFileSync(resolve(cwd, path), 'utf8'),
+                documentId: documentIdByPath.get(path) ?? path,
+            })));
+            if (!derived.ok) {
+                return { exitCode: 2, stdout: '', stderr: `${derived.message}\n` };
+            }
+            const endpoints = new Set();
+            for (const relationshipId of derived.changed.relationships) {
+                const claim = graph.claims.find((candidate) => candidate.id === relationshipId && 'ref' in candidate.object);
+                if (claim !== undefined && 'ref' in claim.object) {
+                    endpoints.add(claim.subject);
+                    endpoints.add(claim.object.ref);
+                }
+            }
+            const seeds = [
+                ...new Set([...derived.changed.concepts, ...endpoints]),
+            ].sort();
+            const changedIds = [
+                ...derived.changed.concepts,
+                ...derived.changed.relationships,
+            ];
+            const covered = new Set();
+            for (const projectionPath of workspace.projections) {
+                const loaded = loadProjection({
+                    path: projectionPath,
+                    source: readFileSync(resolve(cwd, projectionPath), 'utf8'),
+                });
+                if (!loaded.ok)
+                    continue;
+                const membership = evaluateProjection(graph, loaded.projection, compilation.profileContext);
+                for (const subject of membership.subjects) {
+                    covered.add(subject.id);
+                }
+            }
+            const uncovered = changedIds.filter((id) => !covered.has(id));
+            const coverage = {
+                projections: workspace.projections.length,
+                uncovered,
+            };
+            const evaluated = sliceProjection(graph, seeds, `Review slice ${changed}`, compilation.profileContext);
+            const result = {
+                format: 'yarramate/ask-result/v1',
+                workspace: workspace.id,
+                mode: 'slice',
+                addressing: 'changed',
+                seeds,
+                changed: derived.changed,
+                coverage,
+                result: evaluated,
+            };
+            if (changedIds.length === 0) {
+                return emit(result, `No model subjects changed in ${changed}.\n`);
+            }
+            const rendered = budget === undefined
+                ? renderBrief(evaluated, compilation.profileContext)
+                : renderBudgetedContext(evaluated, budget);
+            const lines = [
+                `Review slice ${changed} — ${plural(derived.changed.concepts.length, 'concept')}, ` +
+                    `${plural(derived.changed.relationships.length, 'relationship')} changed (workspace ${workspace.id})`,
+                '',
+                rendered.trimEnd(),
+                '',
+                uncovered.length === 0
+                    ? `Review coverage: every changed subject appears in at least one of the ${coverage.projections} authored projections.`
+                    : `Review coverage: ${uncovered.length} of ${changedIds.length} changed subjects appear in no authored projection:` +
+                        `\n${uncovered.map((id) => `  ${id}`).join('\n')}`,
+            ];
+            return emit(result, `${lines.join('\n')}\n`);
+        }
         // Slice and advice both start from seeds. A single query term that
         // names a projection file is precise addressing; anything else runs
         // through free-text seeding, where exact subject ids win.

package/dist/changed.d.ts

@@ -0,0 +1,17 @@
+export interface ChangedSubjects {
+    readonly range: string;
+    readonly concepts: readonly string[];
+    readonly relationships: readonly string[];
+}
+export type ChangedResult = {
+    readonly ok: true;
+    readonly changed: ChangedSubjects;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+export declare function deriveChangedSubjects(cwd: string, range: string, documents: ReadonlyArray<{
+    readonly path: string;
+    readonly source: string;
+    readonly documentId: string;
+}>): ChangedResult;

package/dist/changed.js

@@ -0,0 +1,111 @@
+import { spawnSync } from 'node:child_process';
+import { isMap, isScalar, isSeq, parseDocument } from 'yaml';
+const lineOfOffset = (lineStarts, offset) => {
+    let low = 0;
+    let high = lineStarts.length - 1;
+    while (low < high) {
+        const mid = (low + high + 1) >> 1;
+        if (lineStarts[mid] <= offset)
+            low = mid;
+        else
+            high = mid - 1;
+    }
+    return low + 1;
+};
+const itemSpans = (source) => {
+    const lineStarts = [0];
+    for (let index = 0; index < source.length; index += 1) {
+        if (source[index] === '\n')
+            lineStarts.push(index + 1);
+    }
+    const document = parseDocument(source);
+    const root = document.contents;
+    if (!isMap(root))
+        return [];
+    const spans = [];
+    for (const collection of ['concepts', 'relationships', 'states']) {
+        const pair = root.items.find((candidate) => isScalar(candidate.key) && candidate.key.value === collection);
+        if (pair === undefined || !isSeq(pair.value))
+            continue;
+        for (const item of pair.value.items) {
+            if (!isMap(item))
+                continue;
+            const idPair = item.items.find((field) => isScalar(field.key) && field.key.value === 'id');
+            if (idPair === undefined ||
+                !isScalar(idPair.value) ||
+                typeof idPair.value.value !== 'string') {
+                continue;
+            }
+            const range = item
+                .range;
+            if (range === undefined)
+                continue;
+            spans.push({
+                id: idPair.value.value,
+                collection,
+                startLine: lineOfOffset(lineStarts, range[0]),
+                // range[1] can extend past the trailing newline; anchor the end
+                // on the last content character instead.
+                endLine: lineOfOffset(lineStarts, Math.max(range[0], range[1] - 1)),
+            });
+        }
+    }
+    return spans;
+};
+// New-side line ranges from `git diff --unified=0`. A pure deletion has a
+// zero count; it still touches the position it collapsed onto.
+const changedLineRanges = (diff) => {
+    const ranges = [];
+    for (const match of diff.matchAll(/^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/gm)) {
+        const start = Number(match[1]);
+        const count = match[2] === undefined ? 1 : Number(match[2]);
+        ranges.push(count === 0 ? [Math.max(start, 1), Math.max(start, 1)] : [start, start + count - 1]);
+    }
+    return ranges;
+};
+export function deriveChangedSubjects(cwd, range, documents) {
+    const probe = spawnSync('git', ['-C', cwd, 'rev-parse', '--git-dir'], {
+        encoding: 'utf8',
+    });
+    if (probe.status !== 0) {
+        return {
+            ok: false,
+            message: '--changed requires the workspace to live in a git repository',
+        };
+    }
+    const concepts = new Set();
+    const relationships = new Set();
+    for (const document of documents) {
+        const diffed = spawnSync('git', ['-C', cwd, 'diff', '--unified=0', range, '--', document.path], { encoding: 'utf8' });
+        if (diffed.status !== 0) {
+            return {
+                ok: false,
+                message: `git diff failed for range "${range}": ${(diffed.stderr ?? '').trim()}`,
+            };
+        }
+        const ranges = changedLineRanges(diffed.stdout ?? '');
+        if (ranges.length === 0)
+            continue;
+        const spans = itemSpans(document.source);
+        for (const span of spans) {
+            if (span.collection === 'states')
+                continue;
+            const touched = ranges.some(([from, to]) => from <= span.endLine && to >= span.startLine);
+            if (!touched)
+                continue;
+            const qualified = `${document.documentId}#${span.id}`;
+            if (span.collection === 'concepts')
+                concepts.add(qualified);
+            else
+                relationships.add(qualified);
+        }
+    }
+    return {
+        ok: true,
+        changed: {
+            range,
+            concepts: [...concepts].sort(),
+            relationships: [...relationships].sort(),
+        },
+    };
+}

package/dist/cli-support.d.ts

@@ -7,7 +7,7 @@ export interface CliResult {
 export declare const isMainModule: (moduleUrl: string, entrypoint: string | undefined) => boolean;
 export declare const packageVersion: string;
 export declare const versionResult: (binary: string) => CliResult;
-export declare const usage = "Usage:\n  yarramate init <directory> [--no-pointer]\n  yarramate design <workspace.yaml> [--subject <document-id>#<local-id>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate apply <operations.yaml> <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> \"<free text>\" | <document-id>#<local-id> ... | <projection.yaml> [--budget <tokens>] [--json]\n  yarramate ask <workspace.yaml> --subjects [--kind <term>] [--status <status>] [--json]\n  yarramate ask <workspace.yaml> --kinds [--json]\n  yarramate ask <workspace.yaml> --advise \"<topic>\" [--budget <tokens>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --next [--json]\n  yarramate ask <workspace.yaml> --open [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --compare <from-state> <to-state> [--json]\n  yarramate check <source.yaml> [source.yaml ...] [--json] [--strict]\n  yarramate reconcile <workspace.yaml>\n  yarramate export graph <workspace.yaml> [--out <file>]\n  yarramate export markdown <projection.yaml> <workspace.yaml> [--out <file>]\n  yarramate export briefs <projection.yaml> <workspace.yaml> --out <directory> [--budget <tokens>]\n  yarramate export likec4 <likec4-project.yaml> <output-dir> <workspace.yaml>\n";
+export declare const usage = "Usage:\n  yarramate init <directory> [--no-pointer]\n  yarramate design <workspace.yaml> [--subject <document-id>#<local-id>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate apply <operations.yaml> <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> \"<free text>\" | <document-id>#<local-id> ... | <projection.yaml> [--budget <tokens>] [--json]\n  yarramate ask <workspace.yaml> --subjects [--kind <term>] [--status <status>] [--json]\n  yarramate ask <workspace.yaml> --kinds [--json]\n  yarramate ask <workspace.yaml> --advise \"<topic>\" [--budget <tokens>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --next [--json]\n  yarramate ask <workspace.yaml> --open [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --compare <from-state> <to-state> [--json]\n  yarramate ask <workspace.yaml> --changed <git-range> [--budget <tokens>] [--json]\n  yarramate check <source.yaml> [source.yaml ...] [--json] [--strict]\n  yarramate reconcile <workspace.yaml>\n  yarramate export graph <workspace.yaml> [--out <file>]\n  yarramate export markdown <projection.yaml> <workspace.yaml> [--out <file>]\n  yarramate export markdown --changed <git-range> <workspace.yaml> [--out <file>]\n  yarramate export briefs <projection.yaml> <workspace.yaml> --out <directory> [--budget <tokens>]\n  yarramate export briefs --changed <git-range> <workspace.yaml> --out <directory> [--budget <tokens>]\n  yarramate export likec4 <likec4-project.yaml> <output-dir> <workspace.yaml>\n";
 export declare const diagnosticJson: (diagnostics: unknown) => string;
 export declare const checkResultJson: (ok: boolean, diagnostics: unknown, counted?: {
     readonly documents: number;

package/dist/cli-support.js

@@ -23,7 +23,7 @@ export const versionResult = (binary) => ({
     stdout: `${binary} ${packageVersion}\n`,
     stderr: '',
 });
-export const usage = 'Usage:\n  yarramate init <directory> [--no-pointer]\n  yarramate design <workspace.yaml> [--subject <document-id>#<local-id>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate apply <operations.yaml> <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> "<free text>" | <document-id>#<local-id> ... | <projection.yaml> [--budget <tokens>] [--json]\n  yarramate ask <workspace.yaml> --subjects [--kind <term>] [--status <status>] [--json]\n  yarramate ask <workspace.yaml> --kinds [--json]\n  yarramate ask <workspace.yaml> --advise "<topic>" [--budget <tokens>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --next [--json]\n  yarramate ask <workspace.yaml> --open [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --compare <from-state> <to-state> [--json]\n  yarramate check <source.yaml> [source.yaml ...] [--json] [--strict]\n  yarramate reconcile <workspace.yaml>\n  yarramate export graph <workspace.yaml> [--out <file>]\n  yarramate export markdown <projection.yaml> <workspace.yaml> [--out <file>]\n  yarramate export briefs <projection.yaml> <workspace.yaml> --out <directory> [--budget <tokens>]\n  yarramate export likec4 <likec4-project.yaml> <output-dir> <workspace.yaml>\n';
+export const usage = 'Usage:\n  yarramate init <directory> [--no-pointer]\n  yarramate design <workspace.yaml> [--subject <document-id>#<local-id>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate apply <operations.yaml> <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> "<free text>" | <document-id>#<local-id> ... | <projection.yaml> [--budget <tokens>] [--json]\n  yarramate ask <workspace.yaml> --subjects [--kind <term>] [--status <status>] [--json]\n  yarramate ask <workspace.yaml> --kinds [--json]\n  yarramate ask <workspace.yaml> --advise "<topic>" [--budget <tokens>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --next [--json]\n  yarramate ask <workspace.yaml> --open [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --compare <from-state> <to-state> [--json]\n  yarramate ask <workspace.yaml> --changed <git-range> [--budget <tokens>] [--json]\n  yarramate check <source.yaml> [source.yaml ...] [--json] [--strict]\n  yarramate reconcile <workspace.yaml>\n  yarramate export graph <workspace.yaml> [--out <file>]\n  yarramate export markdown <projection.yaml> <workspace.yaml> [--out <file>]\n  yarramate export markdown --changed <git-range> <workspace.yaml> [--out <file>]\n  yarramate export briefs <projection.yaml> <workspace.yaml> --out <directory> [--budget <tokens>]\n  yarramate export briefs --changed <git-range> <workspace.yaml> --out <directory> [--budget <tokens>]\n  yarramate export likec4 <likec4-project.yaml> <output-dir> <workspace.yaml>\n';
 export const diagnosticJson = (diagnostics) => `${JSON.stringify({
     format: 'yarramate/diagnostic-result/v1',
     diagnostics,

package/dist/export-command.js

@@ -4,6 +4,7 @@ import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { parseDocument } from 'yaml';
 import { renderBrief } from './brief.js';
+import { deriveChangedSubjects } from './changed.js';
 import { humanDiagnostics, usage } from './cli-support.js';
 import { compileWorkspaceWithProfileContext, } from './compiler.js';
 import { serializeSemanticGraph } from './graph.js';
@@ -23,6 +24,7 @@ const parseExportOptions = (options) => {
     const positionals = [];
     let out;
     let budget;
+    let changed;
     let json = false;
     for (let index = 0; index < options.length; index += 1) {
         const option = options[index];
@@ -30,7 +32,9 @@ const parseExportOptions = (options) => {
             json = true;
             continue;
         }
-        if (option === '--out' || option === '--budget') {
+        if (option === '--out' ||
+            option === '--budget' ||
+            option === '--changed') {
             const value = options[index + 1];
             if (value === undefined || value.startsWith('-'))
                 return undefined;
@@ -39,6 +43,11 @@ const parseExportOptions = (options) => {
                     return undefined;
                 out = value;
             }
+            else if (option === '--changed') {
+                if (changed !== undefined)
+                    return undefined;
+                changed = value;
+            }
             else {
                 if (budget !== undefined || !/^[1-9][0-9]*$/.test(value)) {
                     return undefined;
@@ -56,6 +65,7 @@ const parseExportOptions = (options) => {
         positionals,
         ...(out === undefined ? {} : { out }),
         ...(budget === undefined ? {} : { budget }),
+        ...(changed === undefined ? {} : { changed }),
         json,
     };
 };
@@ -103,12 +113,14 @@ export function runExportCommand(options, cwd) {
             stderr: delegated.stderr ?? '',
         };
     }
-    const expectedPositionals = kind === 'graph' ? 1 : 2;
+    const usesChanged = parsed.changed !== undefined;
+    const expectedPositionals = kind === 'graph' || usesChanged ? 1 : 2;
     const workspacePath = parsed.positionals[expectedPositionals - 1];
-    const projectionPath = kind === 'graph' ? undefined : parsed.positionals[0];
+    const projectionPath = kind === 'graph' || usesChanged ? undefined : parsed.positionals[0];
     if (parsed.positionals.length !== expectedPositionals ||
         workspacePath === undefined ||
         parsed.json ||
+        (usesChanged && kind === 'graph') ||
         (parsed.budget !== undefined && kind !== 'briefs') ||
         (kind === 'briefs' && parsed.out === undefined)) {
         return { exitCode: 2, stdout: '', stderr: usage };
@@ -151,13 +163,51 @@ export function runExportCommand(options, cwd) {
                 stderr: '',
             };
         }
-        const loadedProjection = loadProjection({
-            path: projectionPath,
-            source: readFileSync(resolve(cwd, projectionPath), 'utf8'),
-        });
-        if (!loadedProjection.ok)
-            return failed(loadedProjection.diagnostics);
-        const result = evaluateProjection(compilation.graph, loadedProjection.projection, compilation.profileContext);
+        let result;
+        if (parsed.changed !== undefined) {
+            // Review slices derive from git (ADR 0065): changed subjects seed
+            // the connected neighbourhood the reviewer inspects.
+            const documentIdByPath = new Map(compilation.graph.documents.map(({ id, source }) => [source, id]));
+            const derived = deriveChangedSubjects(cwd, parsed.changed, workspace.documents.map((path) => ({
+                path,
+                source: readFileSync(resolve(cwd, path), 'utf8'),
+                documentId: documentIdByPath.get(path) ?? path,
+            })));
+            if (!derived.ok) {
+                return { exitCode: 2, stdout: '', stderr: `${derived.message}\n` };
+            }
+            const endpoints = new Set();
+            for (const relationshipId of derived.changed.relationships) {
+                const claim = compilation.graph.claims.find((candidate) => candidate.id === relationshipId && 'ref' in candidate.object);
+                if (claim !== undefined && 'ref' in claim.object) {
+                    endpoints.add(claim.subject);
+                    endpoints.add(claim.object.ref);
+                }
+            }
+            const seeds = [
+                ...new Set([...derived.changed.concepts, ...endpoints]),
+            ].sort();
+            result = evaluateProjection(compilation.graph, {
+                format: 'yarramate/projection/v1',
+                id: 'review-slice',
+                version: '0.0',
+                query: { subjects: seeds, relationships: 'connected' },
+                presentation: {
+                    title: `Review slice ${parsed.changed}`,
+                    description: `Connected neighbourhood of the subjects changed in ` +
+                        `${parsed.changed}.`,
+                },
+            }, compilation.profileContext);
+        }
+        else {
+            const loadedProjection = loadProjection({
+                path: projectionPath,
+                source: readFileSync(resolve(cwd, projectionPath), 'utf8'),
+            });
+            if (!loadedProjection.ok)
+                return failed(loadedProjection.diagnostics);
+            result = evaluateProjection(compilation.graph, loadedProjection.projection, compilation.profileContext);
+        }
         if (kind === 'markdown') {
             const rendered = renderProjectionMarkdown(result);
             if (parsed.out === undefined) {

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.9.0",
   "description": "Tool-neutral semantic architecture engine and guided methodology",
   "license": "MIT",
   "repository": {