yarramate 1.33.0 → 1.35.0

package/catalogues/core-enrichment.yaml

@@ -900,6 +900,132 @@ questions:
     resolution: >-
       Give the person a letter (an owner claim on what they answer for, or a
       responsible, consulted or informed relationship) or retire the subject.
+  - id: risk-threatens-nothing
+    wave: motivation
+    since: "1.34"
+    scope: subject
+    subjects:
+      kinds:
+        - yarramate/policy@0.3#risk
+    trigger:
+      - condition: missing-linkage
+        kinds:
+          - yarramate/core@0.1#influence
+        direction: outgoing
+        counterpartKinds:
+          - yarramate/core@0.1#goal
+          - yarramate/core@0.1#requirement
+          - yarramate/core@0.1#constraint
+    question: >-
+      What does {subject.name} threaten?
+    askPlain: >-
+      If "{subject.name}" comes true, which goal, requirement or constraint
+      takes the hit?
+    materiality: >-
+      A risk that threatens nothing named cannot be prioritised or retired:
+      its severity has nothing to be measured against, and nobody can say
+      when it has passed.
+    authority: either
+    resolution: >-
+      Add an `influence` relationship from the risk to the goal, requirement
+      or constraint it threatens.
+  - id: risk-unmitigated
+    wave: motivation
+    since: "1.34"
+    scope: subject
+    subjects:
+      kinds:
+        - yarramate/policy@0.3#risk
+    trigger:
+      - condition: missing-linkage
+        kinds:
+          - yarramate/core@0.1#influence
+          - yarramate/core@0.1#association
+        direction: incoming
+        counterpartKinds:
+          - yarramate/core@0.1#workPackage
+          - yarramate/core@0.1#deliverable
+          - yarramate/core@0.1#constraint
+          - yarramate/core@0.1#courseOfAction
+    question: >-
+      What mitigates {subject.name}?
+    askPlain: >-
+      "{subject.name}" is on the log. What work, deliverable, rule or decision
+      is in place, or planned, to reduce it?
+    materiality: >-
+      A risk on the log with no mitigation is a bet the engagement is making
+      without saying so; the log exists to make that visible.
+    authority: either
+    resolution: >-
+      Add an `influence` relationship from the work package, deliverable,
+      constraint or decision that mitigates it to the risk, or retire the risk.
+  - id: risk-unowned
+    wave: motivation
+    since: "1.34"
+    scope: subject
+    subjects:
+      kinds:
+        - yarramate/policy@0.3#risk
+    trigger:
+      - condition: missing-claim
+        predicate: yarramate/ownership/owner
+    question: >-
+      Who owns {subject.name}?
+    askPlain: >-
+      Whose name is on "{subject.name}": who reviews it and decides when it
+      has passed?
+    materiality: >-
+      The risk owner is who a review date is asked of; without one,
+      risk-reviewed has no authority to sign it.
+    authority: either
+    resolution: >-
+      Add an owner reference to the actor or role that carries the risk.
+  - id: assumption-unconfirmed
+    wave: motivation
+    since: "1.34"
+    scope: subject
+    subjects:
+      kinds:
+        - yarramate/policy@0.3#assumption
+    trigger:
+      - condition: missing-attestation
+        topic: assumption-confirmed
+    question: >-
+      Has anyone confirmed {subject.name}?
+    askPlain: >-
+      "{subject.name}" is being built on. Has the person who can confirm it
+      said so, and when?
+    materiality: >-
+      An unconfirmed assumption is a risk wearing a calmer name; the
+      confirmation, with its date, is what turns it into a fact the delivery
+      can rest on.
+    authority: human
+    resolution: >-
+      Record an `assumption-confirmed` attestation by the role or actor that
+      can confirm it, dated; or retire the assumption.
+  - id: assumption-bears-on-nothing
+    wave: motivation
+    since: "1.34"
+    scope: subject
+    subjects:
+      kinds:
+        - yarramate/policy@0.3#assumption
+    trigger:
+      - condition: missing-relationship
+        kinds:
+          - yarramate/core@0.1#association
+        direction: outgoing
+    question: >-
+      What does {subject.name} bear on?
+    askPlain: >-
+      If "{subject.name}" turned out false, what in this design would change?
+    materiality: >-
+      An assumption that bears on nothing named is either decorative or
+      missing its edges, and the log cannot say which.
+    authority: either
+    resolution: >-
+      Add an `association` relationship from the assumption to the goal,
+      requirement, constraint or subject it bears on, or retire it.
   - id: actor-unassigned
     wave: business
     since: "0.1"

package/dist/adapters/mcp-cli.js

@@ -149,7 +149,7 @@ const runExport = (input, tool, root) => {
         };
     }
     // A text kind under `out`: markdown and graph are one file, rtm,
-    // responsibility and briefs a directory, as the CLI lays them out.
+    // responsibility, governance and briefs a directory, as the CLI lays them out.
     if (kind === 'markdown' || kind === 'graph') {
         mkdirSync(dirname(target), { recursive: true });
         writeFileSync(target, outcome.text, 'utf8');
@@ -172,6 +172,19 @@ const runExport = (input, tool, root) => {
             stderr: '',
         };
     }
+    if (kind === 'governance') {
+        const result = outcome.result;
+        mkdirSync(target, { recursive: true });
+        writeFileSync(join(target, 'GOVERNANCE.md'), outcome.text, 'utf8');
+        if (result !== undefined) {
+            writeFileSync(join(target, 'governance.json'), `${JSON.stringify(result.log, null, 2)}\n`, 'utf8');
+        }
+        return {
+            exitCode: 0,
+            stdout: `Wrote GOVERNANCE.md and governance.json to ${out}\n`,
+            stderr: '',
+        };
+    }
     if (kind === 'responsibility') {
         const result = outcome.result;
         mkdirSync(target, { recursive: true });

package/dist/adapters/visual/protocol-contract.d.ts

@@ -255,6 +255,16 @@ export interface VisualFilterQueryPayload {
      * exactly as it did before.
      */
     readonly nesting?: readonly NestingKind[];
+    /**
+     * Whether the view shows responsibility edges (#563, ADR 0161).
+     *
+     * Only the `connected` walk reads it: a responsibility edge the canvas hides
+     * must not bring a person into the picture, and one the canvas shows must.
+     * Optional, so an older browser and every filter that does not send it
+     * evaluate as a view with the flag off, which is what the canvas draws by
+     * default.
+     */
+    readonly showResponsibility?: boolean;
 }
 export interface VisualFilterResultPayload {
     readonly query: ProjectionQuery;

package/dist/adapters/visual/session-server.js

@@ -680,7 +680,7 @@ export const startVisualServer = async (options) => {
         if (!started.ok)
             standingDiagnostics = started.diagnostics;
     }
-    const filterMatchedIds = (query, nesting) => compiledWorkspace === undefined
+    const filterMatchedIds = (query, nesting, showResponsibility) => compiledWorkspace === undefined
         ? []
         : matchedIdsOf(compiledWorkspace.graph, query, compiledWorkspace.profileContext, 
         // A view's query can name `instances`, and the facet resolves to the
@@ -688,7 +688,9 @@ export const startVisualServer = async (options) => {
         compiledWorkspace.patternMemberships, 
         // And it resolves the WRONG closure without the nesting the canvas is
         // drawing with, which is a wrong number rather than a missing one.
-        nesting);
+        nesting, 
+        // And the walk reads the responsibility flag (#563).
+        showResponsibility);
     /**
      * Why a query dropped what it dropped, as the editor's "excluded, and why"
      * list reads it (#248).
@@ -700,9 +702,9 @@ export const startVisualServer = async (options) => {
      * the reason the editor shows and the set the canvas draws cannot come from
      * two readings of the same query.
      */
-    const filterExclusions = (query, nesting) => compiledWorkspace === undefined
+    const filterExclusions = (query, nesting, showResponsibility) => compiledWorkspace === undefined
         ? []
-        : exclusionsOf(compiledWorkspace.graph, query, compiledWorkspace.profileContext, compiledWorkspace.patternMemberships, nesting);
+        : exclusionsOf(compiledWorkspace.graph, query, compiledWorkspace.profileContext, compiledWorkspace.patternMemberships, nesting, showResponsibility);
     let listening = false;
     let bootstrapSpent = false;
     let agentAttached = false;
@@ -1255,8 +1257,8 @@ export const startVisualServer = async (options) => {
                     kind: "filter-result",
                     result: {
                         query: event.payload.query,
-                        matchedIds: filterMatchedIds(event.payload.query, event.payload.nesting),
-                        excluded: filterExclusions(event.payload.query, event.payload.nesting),
+                        matchedIds: filterMatchedIds(event.payload.query, event.payload.nesting, event.payload.showResponsibility),
+                        excluded: filterExclusions(event.payload.query, event.payload.nesting, event.payload.showResponsibility),
                     },
                 });
                 return;

package/dist/adapters/visual/workspace-model.d.ts

@@ -57,7 +57,7 @@ export declare const patternOptionsOf: (patterns: readonly PatternShape[], linea
  * subject count. A view over three components with two relationships between
  * them would read as five, and the reviewer counting boxes would find three.
  */
-export declare const conceptCountOf: (graph: SemanticGraph, query: ProjectionQuery, profileContext: ResolvedProfileContext, memberships?: readonly CataloguePatternMembership[], nesting?: readonly NestingKind[]) => number;
+export declare const conceptCountOf: (graph: SemanticGraph, query: ProjectionQuery, profileContext: ResolvedProfileContext, memberships?: readonly CataloguePatternMembership[], nesting?: readonly NestingKind[], showResponsibility?: boolean) => number;
 /**
  * Folds one interrogation report into what the canvas draws (#292).
  *
@@ -125,9 +125,9 @@ export declare const renderedWorkspaceOf: (compiled: {
     readonly views: readonly VisualViewSummary[];
 };
 /** Every subject a query draws, concepts and relationships alike. */
-export declare const matchedIdsOf: (graph: SemanticGraph, query: ProjectionQuery, profileContext: ResolvedProfileContext, memberships?: readonly CataloguePatternMembership[], nesting?: readonly NestingKind[]) => readonly string[];
+export declare const matchedIdsOf: (graph: SemanticGraph, query: ProjectionQuery, profileContext: ResolvedProfileContext, memberships?: readonly CataloguePatternMembership[], nesting?: readonly NestingKind[], showResponsibility?: boolean) => readonly string[];
 /** Every concept a query dropped, and the facet that dropped it (#248). */
-export declare const exclusionsOf: (graph: SemanticGraph, query: ProjectionQuery, profileContext: ResolvedProfileContext, memberships?: readonly CataloguePatternMembership[], nesting?: readonly NestingKind[]) => readonly ProjectionExclusion[];
+export declare const exclusionsOf: (graph: SemanticGraph, query: ProjectionQuery, profileContext: ResolvedProfileContext, memberships?: readonly CataloguePatternMembership[], nesting?: readonly NestingKind[], showResponsibility?: boolean) => readonly ProjectionExclusion[];
 /**
  * One saved view, as the rail reads it. `subjectCount` is the caller's,
  * because counting needs a compiled graph and a session builds its first list

package/dist/adapters/visual/workspace-model.js

@@ -104,7 +104,7 @@ const wiringOf = (pattern, slot) => {
  * subject count. A view over three components with two relationships between
  * them would read as five, and the reviewer counting boxes would find three.
  */
-export const conceptCountOf = (graph, query, profileContext, memberships, nesting) => evaluateProjection(graph, adHoc(query, nesting), profileContext, memberships).subjects.filter(({ type }) => type === "concept").length;
+export const conceptCountOf = (graph, query, profileContext, memberships, nesting, showResponsibility) => evaluateProjection(graph, adHoc(query, nesting, showResponsibility), profileContext, memberships).subjects.filter(({ type }) => type === "concept").length;
 export const interrogationOverlayOf = (compiled, 
 /**
  * The catalogue, or the composed SET a workspace carries (#345, ADR 0129).
@@ -209,7 +209,10 @@ export const renderedWorkspaceOf = (compiled, views, metadata, catalogue, dismis
         // Each view's OWN nesting, because each view's closure is its own. A rail
         // sitting beside the canvas must not count a different tree than the
         // canvas draws.
-        view.presentation?.nesting),
+        view.presentation?.nesting, 
+        // And each view's own responsibility flag, for the same reason: the
+        // walk reads it (#563), and the rail must count what the canvas draws.
+        view.presentation?.showResponsibility),
     }));
     const interrogation = catalogue === undefined
         ? undefined
@@ -250,24 +253,33 @@ export const renderedWorkspaceOf = (compiled, views, metadata, catalogue, dismis
     };
 };
 /** Every subject a query draws, concepts and relationships alike. */
-export const matchedIdsOf = (graph, query, profileContext, memberships, nesting) => evaluateProjection(graph, adHoc(query, nesting), profileContext, memberships).subjects.map(({ id }) => id);
+export const matchedIdsOf = (graph, query, profileContext, memberships, nesting, showResponsibility) => evaluateProjection(graph, adHoc(query, nesting, showResponsibility), profileContext, memberships).subjects.map(({ id }) => id);
 /** Every concept a query dropped, and the facet that dropped it (#248). */
-export const exclusionsOf = (graph, query, profileContext, memberships, nesting) => explainProjection(graph, adHoc(query, nesting), profileContext, memberships);
+export const exclusionsOf = (graph, query, profileContext, memberships, nesting, showResponsibility) => explainProjection(graph, adHoc(query, nesting, showResponsibility), profileContext, memberships);
 /**
  * A query on its own is not a projection, and every evaluator here wants one.
  * The id is a placeholder that never reaches a document.
  */
-const adHoc = (query, nesting) => ({
-    format: "yarramate/projection/v1",
-    id: "ad-hoc",
-    version: "0",
-    query,
-    // `query.instances` resolves its closure through the view's nesting, so an
-    // ad-hoc projection that dropped the nesting would answer a DIFFERENT
-    // question than the canvas is drawing: 2 subjects against 15 on the
-    // ApertureX reference, with nothing to say it had (#473 phase 2).
-    ...(nesting === undefined ? {} : { presentation: { nesting } }),
-});
+const adHoc = (query, nesting, showResponsibility) => {
+    const presentation = {
+        // `query.instances` resolves its closure through the view's nesting, so an
+        // ad-hoc projection that dropped the nesting would answer a DIFFERENT
+        // question than the canvas is drawing: 2 subjects against 15 on the
+        // ApertureX reference, with nothing to say it had (#473 phase 2).
+        ...(nesting === undefined ? {} : { nesting }),
+        // And the `connected` walk reads this flag (#563, ADR 0161): dropped, the
+        // evaluation would walk a responsibility edge the canvas hides and stand a
+        // person in the picture with no line to anything.
+        ...(showResponsibility === undefined ? {} : { showResponsibility }),
+    };
+    return {
+        format: "yarramate/projection/v1",
+        id: "ad-hoc",
+        version: "0",
+        query,
+        ...(Object.keys(presentation).length === 0 ? {} : { presentation }),
+    };
+};
 /**
  * One saved view, as the rail reads it. `subjectCount` is the caller's,
  * because counting needs a compiled graph and a session builds its first list

package/dist/brief.js

@@ -1,5 +1,5 @@
 import { conceptKinds } from './profile.js';
-import { EXTENSION_READING, RELATIONSHIP_READING, humanizeKind } from './relationship-reading.js';
+import { EXTENSION_READING, RELATIONSHIP_READING, contextualReading, humanizeKind } from './relationship-reading.js';
 const coreKindNames = new Map(conceptKinds.map(({ id, name }) => [id, name]));
 const motivationKindIds = new Set(conceptKinds
     .filter(({ layer }) => layer === 'motivation')
@@ -110,8 +110,18 @@ workspaceClaims) {
         if (claim === undefined || !('ref' in claim.object))
             continue;
         const description = claimValue(result.claims, subject.id, 'yarramate/relationship/description');
+        const coreKind = coreLocalKind(claim.predicate, profileContext?.relationshipKindLineages);
+        // A reading the endpoints decide (ADR 0160) speaks before the kind's own.
+        const endpointLineage = (id) => {
+            const kind = claimValue(result.claims, id, 'yarramate/concept/kind');
+            return kind === undefined ? undefined : profileContext?.conceptKindLineages.get(kind);
+        };
+        const contextual = coreKind === undefined
+            ? undefined
+            : contextualReading(endpointLineage(claim.subject), endpointLineage(claim.object.ref), coreKind);
         const entry = {
-            phrase: relationshipPhrase(coreLocalKind(claim.predicate, profileContext?.relationshipKindLineages), claim.predicate, claimValue(result.claims, subject.id, 'yarramate/access/mode'), claimValue(result.claims, subject.id, 'yarramate/flow/content')),
+            phrase: contextual ??
+                relationshipPhrase(coreKind, claim.predicate, claimValue(result.claims, subject.id, 'yarramate/access/mode'), claimValue(result.claims, subject.id, 'yarramate/flow/content')),
             target: claim.object.ref,
             ...(description === undefined ? {} : { description }),
         };

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 <subject-id>] [--catalogue <catalogue.yaml>] [--facilitate] [--json]\n  yarramate apply <operations.yaml> <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> \"<free text>\" | <subject-id> ... | <projection.yaml> [--budget <tokens>] [--neighbours <n>] [--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>] [--neighbours <n>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --where \"<free text>\" | <subject-id> ... [--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>] [--neighbours <n>] [--json]\n  yarramate check <source.yaml> [source.yaml ...] [--json] [--strict]\n  yarramate reconcile <workspace.yaml> [--json | --text]\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 rtm <workspace.yaml> --out <directory>\n  yarramate export responsibility <projection.yaml> <workspace.yaml> --out <directory>\n  yarramate export xlsx <projection.yaml> <workspace.yaml> --out <file>\n  yarramate import xlsx <workbook.xlsx> <workspace.yaml> [--json]\n  yarramate export likec4 <likec4-project.yaml> <output-dir> <workspace.yaml> [--changed <git-range>]\n";
+export declare const usage = "Usage:\n  yarramate init <directory> [--no-pointer]\n  yarramate design <workspace.yaml> [--subject <subject-id>] [--catalogue <catalogue.yaml>] [--facilitate] [--json]\n  yarramate apply <operations.yaml> <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> \"<free text>\" | <subject-id> ... | <projection.yaml> [--budget <tokens>] [--neighbours <n>] [--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>] [--neighbours <n>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --where \"<free text>\" | <subject-id> ... [--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>] [--neighbours <n>] [--json]\n  yarramate check <source.yaml> [source.yaml ...] [--json] [--strict]\n  yarramate reconcile <workspace.yaml> [--json | --text]\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 rtm <workspace.yaml> --out <directory>\n  yarramate export responsibility <projection.yaml> <workspace.yaml> --out <directory>\n  yarramate export governance <workspace.yaml> --out <directory>\n  yarramate export xlsx <projection.yaml> <workspace.yaml> --out <file>\n  yarramate import xlsx <workbook.xlsx> <workspace.yaml> [--json]\n  yarramate export likec4 <likec4-project.yaml> <output-dir> <workspace.yaml> [--changed <git-range>]\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

@@ -22,7 +22,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 <subject-id>] [--catalogue <catalogue.yaml>] [--facilitate] [--json]\n  yarramate apply <operations.yaml> <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> "<free text>" | <subject-id> ... | <projection.yaml> [--budget <tokens>] [--neighbours <n>] [--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>] [--neighbours <n>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --where "<free text>" | <subject-id> ... [--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>] [--neighbours <n>] [--json]\n  yarramate check <source.yaml> [source.yaml ...] [--json] [--strict]\n  yarramate reconcile <workspace.yaml> [--json | --text]\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 rtm <workspace.yaml> --out <directory>\n  yarramate export responsibility <projection.yaml> <workspace.yaml> --out <directory>\n  yarramate export xlsx <projection.yaml> <workspace.yaml> --out <file>\n  yarramate import xlsx <workbook.xlsx> <workspace.yaml> [--json]\n  yarramate export likec4 <likec4-project.yaml> <output-dir> <workspace.yaml> [--changed <git-range>]\n';
+export const usage = 'Usage:\n  yarramate init <directory> [--no-pointer]\n  yarramate design <workspace.yaml> [--subject <subject-id>] [--catalogue <catalogue.yaml>] [--facilitate] [--json]\n  yarramate apply <operations.yaml> <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> [--json]\n  yarramate ask <workspace.yaml> "<free text>" | <subject-id> ... | <projection.yaml> [--budget <tokens>] [--neighbours <n>] [--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>] [--neighbours <n>] [--catalogue <catalogue.yaml>] [--json]\n  yarramate ask <workspace.yaml> --where "<free text>" | <subject-id> ... [--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>] [--neighbours <n>] [--json]\n  yarramate check <source.yaml> [source.yaml ...] [--json] [--strict]\n  yarramate reconcile <workspace.yaml> [--json | --text]\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 rtm <workspace.yaml> --out <directory>\n  yarramate export responsibility <projection.yaml> <workspace.yaml> --out <directory>\n  yarramate export governance <workspace.yaml> --out <directory>\n  yarramate export xlsx <projection.yaml> <workspace.yaml> --out <file>\n  yarramate import xlsx <workbook.xlsx> <workspace.yaml> [--json]\n  yarramate export likec4 <likec4-project.yaml> <output-dir> <workspace.yaml> [--changed <git-range>]\n';
 export const diagnosticJson = (diagnostics) => `${JSON.stringify({
     format: 'yarramate/diagnostic-result/v1',
     diagnostics,

package/dist/export-command.js

@@ -8,7 +8,7 @@ import { humanDiagnostics, usage, } from './cli-support.js';
 import { evaluateProjection, renderProjectionMarkdown } from './projection.js';
 import { createFileSystemStore } from './source-store.js';
 import { posixDirectoryOf } from './apply-command.js';
-import { briefsFromResult, exportBriefs, exportGraph, exportMarkdown, exportResponsibility, exportRtm, exportWorkbook, } from './tools/export.js';
+import { briefsFromResult, exportBriefs, exportGraph, exportMarkdown, exportGovernance, exportResponsibility, exportRtm, exportWorkbook, } from './tools/export.js';
 import { compileOf, readSource, } from './tools/workspace.js';
 import { loadWorkspaceManifest } from './workspace.js';
 // Every kind is derived in `tools/export.ts` (ADR 0156): this command
@@ -76,6 +76,7 @@ export function runExportCommand(options, cwd) {
             'briefs',
             'rtm',
             'responsibility',
+            'governance',
             'likec4',
             'xlsx',
         ].includes(kind)) {
@@ -121,20 +122,19 @@ export function runExportCommand(options, cwd) {
         };
     }
     const usesChanged = parsed.changed !== undefined;
-    const expectedPositionals = kind === 'graph' || kind === 'rtm' || usesChanged ? 1 : 2;
+    const wholeWorkspace = kind === 'graph' || kind === 'rtm' || kind === 'governance';
+    const expectedPositionals = wholeWorkspace || usesChanged ? 1 : 2;
     const workspacePath = parsed.positionals[expectedPositionals - 1];
-    const projectionPath = kind === 'graph' || kind === 'rtm' || usesChanged
-        ? undefined
-        : parsed.positionals[0];
+    const projectionPath = wholeWorkspace || usesChanged ? undefined : parsed.positionals[0];
     if (parsed.positionals.length !== expectedPositionals ||
         workspacePath === undefined ||
         parsed.json ||
-        (usesChanged &&
-            (kind === 'graph' || kind === 'rtm' || kind === 'responsibility')) ||
+        (usesChanged && (wholeWorkspace || kind === 'responsibility')) ||
         (parsed.budget !== undefined && kind !== 'briefs') ||
         ((kind === 'briefs' ||
             kind === 'rtm' ||
             kind === 'responsibility' ||
+            kind === 'governance' ||
             kind === 'xlsx') &&
             parsed.out === undefined)) {
         return { exitCode: 2, stdout: '', stderr: usage };
@@ -183,6 +183,20 @@ export function runExportCommand(options, cwd) {
                 stderr: '',
             };
         }
+        if (kind === 'governance') {
+            const exported = exportGovernance(tool);
+            if (!exported.ok)
+                return failedTool(exported);
+            const { markdown, log } = exported.result;
+            writeText(join(parsed.out, 'GOVERNANCE.md'), markdown);
+            writeText(join(parsed.out, 'governance.json'), `${JSON.stringify(log, null, 2)}\n`);
+            const gaps = log.summary.unowned + log.summary.unmitigated + log.summary.unconfirmed + log.summary.unreviewed;
+            return {
+                exitCode: 0,
+                stdout: `Wrote GOVERNANCE.md and governance.json (${log.summary.rows} row${log.summary.rows === 1 ? '' : 's'}, ${gaps} gap${gaps === 1 ? '' : 's'}) to ${parsed.out}\n`,
+                stderr: '',
+            };
+        }
         if (kind === 'responsibility') {
             const exported = exportResponsibility(tool, projectionPath);
             if (!exported.ok)

package/dist/governance-kinds.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The governance concept kinds (#560, ADR 0160): `yarramate/policy@0.3#risk`
+ * and `#assumption`, each a subkind of core `assessment`. A decision is the
+ * adopter's trial kind under `courseOfAction` until the trial reports, so
+ * it is not here. Review dates are attestations on the shipped topics
+ * below. Pure, so the canvas projection, the log builder and the brief read
+ * one table.
+ */
+export declare const GOVERNANCE_PROFILE = "yarramate/policy@0.3";
+export type GovernanceType = 'risk' | 'assumption';
+export declare const GOVERNANCE_KINDS: Readonly<Record<GovernanceType, string>>;
+/**
+ * The attestation topic that records a review of each type: a risk owner
+ * or the client role attests `risk-reviewed` on a risk, and the client
+ * confirms an assumption with `assumption-confirmed`. How old is too old is
+ * the adopter's threshold, not the engine's.
+ */
+export declare const REVIEW_TOPICS: Readonly<Record<GovernanceType, string>>;
+/**
+ * Whether a concept kind is a risk or an assumption, read through its
+ * lineage (ancestor-first) so a profile's own subkind counts; null for
+ * every other kind.
+ */
+export declare const governanceTypeOf: (lineage: readonly string[] | undefined, kind: string) => GovernanceType | null;

package/dist/governance-kinds.js

@@ -0,0 +1,40 @@
+/**
+ * The governance concept kinds (#560, ADR 0160): `yarramate/policy@0.3#risk`
+ * and `#assumption`, each a subkind of core `assessment`. A decision is the
+ * adopter's trial kind under `courseOfAction` until the trial reports, so
+ * it is not here. Review dates are attestations on the shipped topics
+ * below. Pure, so the canvas projection, the log builder and the brief read
+ * one table.
+ */
+export const GOVERNANCE_PROFILE = 'yarramate/policy@0.3';
+export const GOVERNANCE_KINDS = {
+    risk: `${GOVERNANCE_PROFILE}#risk`,
+    assumption: `${GOVERNANCE_PROFILE}#assumption`,
+};
+/**
+ * The attestation topic that records a review of each type: a risk owner
+ * or the client role attests `risk-reviewed` on a risk, and the client
+ * confirms an assumption with `assumption-confirmed`. How old is too old is
+ * the adopter's threshold, not the engine's.
+ */
+export const REVIEW_TOPICS = {
+    risk: 'risk-reviewed',
+    assumption: 'assumption-confirmed',
+};
+const TYPE_BY_KIND = {
+    [GOVERNANCE_KINDS.risk]: 'risk',
+    [GOVERNANCE_KINDS.assumption]: 'assumption',
+};
+/**
+ * Whether a concept kind is a risk or an assumption, read through its
+ * lineage (ancestor-first) so a profile's own subkind counts; null for
+ * every other kind.
+ */
+export const governanceTypeOf = (lineage, kind) => {
+    for (const member of lineage ?? [kind]) {
+        const type = TYPE_BY_KIND[member];
+        if (type !== undefined)
+            return type;
+    }
+    return TYPE_BY_KIND[kind] ?? null;
+};

package/dist/governance.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The governance log (#560, ADR 0160): the RAID log's risks and
+ * assumptions as the model holds them, derived the way the responsibility
+ * matrix is derived and never authored. One row per risk or assumption:
+ * its owner and status, what it threatens or bears on, what mitigates it,
+ * the latest review attestation, what it supersedes, and the groupings it
+ * aggregates into (an adopter's severity or likelihood classes, which the
+ * engine carries without knowing the scale). Issues and open questions are
+ * the adopter's and the interrogation's; the engine never sees an issue.
+ *
+ * Deterministic: identical inputs give identical bytes, so CI can diff it.
+ */
+import type { ResolvedProfileContext, SemanticGraph } from './compiler.js';
+import { type GovernanceType } from './governance-kinds.js';
+export interface GovernanceSource {
+    readonly path: string;
+    readonly line: number;
+}
+export interface GovernanceRef {
+    readonly id: string;
+    readonly name: string;
+}
+/** The latest review attestation on a row, by date. */
+export interface GovernanceReview {
+    readonly topic: string;
+    readonly on: string;
+    readonly by: string;
+    readonly source: GovernanceSource;
+}
+export interface GovernanceRow {
+    readonly subject: string;
+    readonly name: string;
+    readonly kind: string;
+    readonly type: GovernanceType;
+    readonly status: string | null;
+    readonly description?: string;
+    readonly owner: GovernanceRef | null;
+    /** A risk's outgoing `influence` targets: what it threatens. */
+    readonly threatens: readonly GovernanceRef[];
+    /** An assumption's outgoing `association` targets: what it bears on. */
+    readonly bearsOn: readonly GovernanceRef[];
+    /** Incoming `influence` or `association` sources on a risk: what mitigates it. */
+    readonly mitigatedBy: readonly GovernanceRef[];
+    readonly review: GovernanceReview | null;
+    readonly supersedes: readonly string[];
+    /** The groupings that aggregate this row: an adopter's rating classes. */
+    readonly groupedBy: readonly GovernanceRef[];
+}
+export interface GovernanceLog {
+    readonly format: 'yarramate/governance/v1';
+    readonly workspace: string;
+    readonly summary: {
+        readonly rows: number;
+        readonly risks: number;
+        readonly assumptions: number;
+        readonly unowned: number;
+        readonly unmitigated: number;
+        readonly unconfirmed: number;
+        readonly unreviewed: number;
+    };
+    readonly rows: readonly GovernanceRow[];
+    readonly gaps: {
+        /** Rows with no owner. */
+        readonly unowned: readonly string[];
+        /** Current risks nothing mitigates. */
+        readonly unmitigated: readonly string[];
+        /** Assumptions with no `assumption-confirmed` attestation. */
+        readonly unconfirmed: readonly string[];
+        /** Risks with no `risk-reviewed` attestation. How old is too old is the adopter's. */
+        readonly unreviewed: readonly string[];
+    };
+}
+export interface GovernanceOptions {
+    /** The subjects that may get a row; absent, every risk and assumption. */
+    readonly rows?: readonly string[];
+}
+export declare function buildGovernanceLog(workspace: string, graph: SemanticGraph, profileContext: ResolvedProfileContext, options?: GovernanceOptions): GovernanceLog;
+/** The log as one markdown table a person reads, with the gaps under it. */
+export declare function renderGovernanceMarkdown(log: GovernanceLog): string;