yarramate 1.31.0 → 1.33.0

package/catalogues/core-enrichment.yaml

@@ -830,6 +830,76 @@ questions:
       Add an owner reference to an accountable actor (evidence such as
       CODEOWNERS may propose it; a human confirms accountability).
 
+  - id: responsible-missing
+    wave: business
+    since: "1.33"
+    scope: subject
+    subjects:
+      kinds:
+        - yarramate/core@0.1#businessService
+        - yarramate/core@0.1#applicationService
+        - yarramate/core@0.1#applicationComponent
+        - yarramate/core@0.1#capability
+    trigger:
+      - condition: missing-linkage
+        kinds:
+          - yarramate/policy@0.2#responsible
+        direction: incoming
+        counterpartKinds:
+          - yarramate/core@0.1#businessActor
+          - yarramate/core@0.1#businessRole
+          - yarramate/core@0.1#businessCollaboration
+          - yarramate/core@0.1#stakeholder
+    question: >-
+      Who is responsible for {subject.name}?
+    askPlain: >-
+      Who actually builds, runs or delivers "{subject.name}" day to day?
+    materiality: >-
+      Accountability says whose desk a failure lands on; responsibility says
+      whose hands are on it. A subject with nobody responsible has nobody to
+      hand the work to, and a RACI row with no R is a gap the matrix reports.
+    authority: either
+    resolution: >-
+      Add a `responsible` relationship from the actor, role or collaboration
+      that does the work to the subject (a support contract or CODEOWNERS may
+      propose it; a person confirms it).
+  - id: role-idle
+    wave: business
+    since: "1.33"
+    scope: subject
+    subjects:
+      kinds:
+        - yarramate/core@0.1#businessActor
+        - yarramate/core@0.1#businessRole
+        - yarramate/core@0.1#businessCollaboration
+    trigger:
+      - condition: missing-reference
+        predicate: yarramate/ownership/owner
+        direction: incoming
+      - condition: missing-relationship
+        kinds:
+          - yarramate/policy@0.2#responsible
+          - yarramate/policy@0.2#consulted
+          - yarramate/policy@0.2#informed
+        direction: outgoing
+      - condition: missing-relationship
+        kinds:
+          - yarramate/core@0.1#serving
+        direction: incoming
+    question: >-
+      What does {subject.name} answer for?
+    askPlain: >-
+      "{subject.name}" is in the model but owns nothing, is responsible for
+      nothing, and is neither consulted nor informed about anything. What is
+      their part, or should they go?
+    materiality: >-
+      A person with no letter is either missing the edges a delivery depends
+      on or a name that outlived its role. A served actor is a consumer, not
+      a responsibility holder, and is not asked.
+    authority: human
+    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: actor-unassigned
     wave: business
     since: "0.1"

package/dist/adapters/likec4-export.d.ts

@@ -1,4 +1,5 @@
 import { type AdapterMapping } from '../adapter-mapping.js';
+import { type Branding } from '../branding.js';
 import type { StateComparison } from '../architecture-state.js';
 import type { ProjectionResult } from '../projection.js';
 import type { LikeC4KindMapping } from './likec4-kind-mapping.js';
@@ -21,6 +22,8 @@ export type LikeC4ExportResult = {
 };
 export interface LikeC4ExportOptions {
     readonly comparison?: StateComparison;
+    /** The banner names the host's product (#546, ADR 0158); absent, the engine. */
+    readonly branding?: Branding;
     /** Git-derived review overlay (ADR 0066): subjects new or changed in a
      *  ref range carry metadata and view styling; nothing is authored. */
     readonly gitChange?: GitChangeOverlay;

package/dist/adapters/likec4-export.js

@@ -1,4 +1,5 @@
 import { adapterMappingEntryLocation, adapterMappingLocation, } from '../adapter-mapping.js';
+import { resolveBranding } from '../branding.js';
 import { diagnosticOrder } from '../source-document.js';
 const identifier = /^[A-Za-z_][A-Za-z0-9_-]*$/;
 const valueFor = (claims, subject, predicate) => {
@@ -114,8 +115,10 @@ export function exportLikeC4(projection, mapping, kindMapping, options = {}) {
             diagnostics: diagnostics.sort(diagnosticOrder),
         };
     }
+    const brand = resolveBranding(options.branding);
     const lines = [
-        '// Generated by YarraMate. Edit the native documents, not this file.',
+        `// Generated by ${brand.productName}. Edit the native documents, not this file.`,
+        ...(brand.vendorLine === null ? [] : [`// ${brand.vendorLine}`]),
         'model {',
     ];
     for (const concept of concepts) {

package/dist/adapters/likec4-project-export.d.ts

@@ -1,4 +1,5 @@
 import type { WorkspaceSource } from '../compiler.js';
+import { type Branding } from '../branding.js';
 import { type LikeC4PreparationDiagnostic } from './likec4-prepare.js';
 import type { GitChangeOverlay } from './likec4-export.js';
 import { type LikeC4ProjectDefinition, type PreparedLikeC4ProjectView } from './likec4-project.js';
@@ -26,6 +27,12 @@ export interface LikeC4ProjectExportInput {
     readonly requireMappedRelationships: boolean;
     /** The git-derived review overlay, when the CLI derived one. */
     readonly gitChange?: GitChangeOverlay;
+    /**
+     * The host's branding (#546, ADR 0158): the model banner and the project
+     * name in `likec4.config.json`. The marker file and its digests are
+     * machinery and keep their names.
+     */
+    readonly branding?: Branding;
 }
 export interface LikeC4ProjectExported {
     readonly ok: true;
@@ -38,6 +45,8 @@ export interface LikeC4ProjectExported {
     readonly kindMappingIdentity?: string;
     /** Every source that fed the export, for the marker's input digests. */
     readonly inputs: readonly WorkspaceSource[];
+    /** Echoed from the input so `generatedProjectFiles` names the project for it. */
+    readonly branding?: Branding;
 }
 export type LikeC4ProjectExportResult = LikeC4ProjectExported | {
     readonly ok: false;
@@ -62,7 +71,7 @@ export interface GeneratedProjectOwnership {
 }
 export declare const ownershipOf: (exported: LikeC4ProjectExported) => GeneratedProjectOwnership;
 export declare const inputDigestsOf: (inputs: readonly WorkspaceSource[]) => Readonly<Record<string, string>>;
-export declare const projectNameOf: (projectIdentity: string) => string;
+export declare const projectNameOf: (projectIdentity: string, branding?: Branding) => string;
 /**
  * The four files a generated project holds, exactly as the CLI writes them
  * under its output directory: the config, the model, the specification the

package/dist/adapters/likec4-project-export.js

@@ -1,4 +1,5 @@
 import { parseDocument } from 'yaml';
+import { brandSlug, resolveBranding } from '../branding.js';
 import { sha256Hex } from '../digest.js';
 import { LIKEC4_SPECIFICATION_SOURCE } from '../likec4-specification.generated.js';
 import { locateSourcePath } from '../source-document.js';
@@ -165,7 +166,10 @@ export const exportLikeC4ProjectFromSources = (input) => {
         }
         renderedViewIds.add(renderedId);
     }
-    const exported = exportLikeC4Project(definition, successfulViews, input.gitChange === undefined ? {} : { gitChange: input.gitChange });
+    const exported = exportLikeC4Project(definition, successfulViews, {
+        ...(input.gitChange === undefined ? {} : { gitChange: input.gitChange }),
+        ...(input.branding === undefined ? {} : { branding: input.branding }),
+    });
     if (!exported.ok)
         return { ok: false, diagnostics: exported.diagnostics };
     const first = successfulViews[0];
@@ -182,6 +186,7 @@ export const exportLikeC4ProjectFromSources = (input) => {
                 kindMappingIdentity: `${first.prepared.kindMapping.id}@${first.prepared.kindMapping.version}`,
             }),
         inputs: [projectSource, ...sources, ...referencedSources.values()],
+        ...(input.branding === undefined ? {} : { branding: input.branding }),
     };
 };
 // ---------------------------------------------------------------------------
@@ -208,7 +213,7 @@ export const ownershipOf = (exported) => ({
 export const inputDigestsOf = (inputs) => Object.fromEntries(inputs
     .map(({ path, source }) => [path, sha256Hex(source)])
     .sort(([left], [right]) => left.localeCompare(right)));
-export const projectNameOf = (projectIdentity) => `yarramate-${projectIdentity}`.replaceAll(/[^A-Za-z0-9_-]/g, '-');
+export const projectNameOf = (projectIdentity, branding) => `${brandSlug(resolveBranding(branding))}-${projectIdentity}`.replaceAll(/[^A-Za-z0-9_-]/g, '-');
 /**
  * The four files a generated project holds, exactly as the CLI writes them
  * under its output directory: the config, the model, the specification the
@@ -218,7 +223,7 @@ export const projectNameOf = (projectIdentity) => `yarramate-${projectIdentity}`
 export const generatedProjectFiles = (exported) => {
     const configSource = `${JSON.stringify({
         $schema: 'https://likec4.dev/schemas/config.json',
-        name: projectNameOf(exported.projectIdentity),
+        name: projectNameOf(exported.projectIdentity, exported.branding),
         title: exported.project.title,
     }, null, 2)}\n`;
     const markerSource = `${JSON.stringify({

package/dist/adapters/likec4-project.d.ts

@@ -1,3 +1,4 @@
+import type { Branding } from '../branding.js';
 import type { WorkspaceSource } from '../compiler.js';
 import type { LikeC4PreparationResult } from './likec4-prepare.js';
 import { type GitChangeOverlay, type LikeC4ExportResult } from './likec4-export.js';
@@ -59,5 +60,7 @@ export interface PreparedLikeC4ProjectView {
 }
 export interface LikeC4ProjectExportOptions {
     readonly gitChange?: GitChangeOverlay;
+    /** Names the product in the model banner (#546, ADR 0158). */
+    readonly branding?: Branding;
 }
 export declare function exportLikeC4Project(project: LikeC4ProjectDefinition, views: readonly PreparedLikeC4ProjectView[], options?: LikeC4ProjectExportOptions): LikeC4ExportResult;

package/dist/adapters/likec4-project.js

@@ -236,9 +236,10 @@ export function exportLikeC4Project(project, views, options = {}) {
     if (first === undefined) {
         throw new Error('LikeC4 project requires at least one view');
     }
-    const model = exportLikeC4(unionProjection(project, views), first.prepared.subjectMapping, first.prepared.kindMapping, options.gitChange === undefined
-        ? {}
-        : { gitChange: options.gitChange });
+    const model = exportLikeC4(unionProjection(project, views), first.prepared.subjectMapping, first.prepared.kindMapping, {
+        ...(options.gitChange === undefined ? {} : { gitChange: options.gitChange }),
+        ...(options.branding === undefined ? {} : { branding: options.branding }),
+    });
     if (!model.ok)
         return model;
     const startToken = '\nviews {\n';

package/dist/adapters/mcp-cli.js

@@ -7,7 +7,7 @@ import { isMainModule, packageVersion, versionResult, } from '../cli-support.js'
 import { runCli } from '../cli.js';
 import { createFileSystemStore } from '../source-store.js';
 import { loadWorkspaceManifest } from '../workspace.js';
-import { LOOP, STDIO_PROPERTIES, TOOL_CATALOGUE, runTool, } from '../tools/table.js';
+import { STDIO_PROPERTIES, TOOL_CATALOGUE, instructionsFor, runTool, } from '../tools/table.js';
 /** The sentence the stdio rows add, because only here is there a `workspace` to name. */
 const WORKSPACE_SENTENCE = 'Every tool takes the same optional `workspace`; omit it to use the workspace this server was started with, or .yarramate/workspace.yaml under its working directory.';
 const CONVENTIONAL_WORKSPACE = join('.yarramate', 'workspace.yaml');
@@ -148,8 +148,8 @@ const runExport = (input, tool, root) => {
             stderr: '',
         };
     }
-    // A text kind under `out`: markdown and graph are one file, rtm and
-    // briefs a directory, as the CLI lays them out.
+    // A text kind under `out`: markdown and graph are one file, rtm,
+    // responsibility 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 === 'responsibility') {
+        const result = outcome.result;
+        mkdirSync(target, { recursive: true });
+        writeFileSync(join(target, 'RESPONSIBILITY.md'), outcome.text, 'utf8');
+        if (result !== undefined) {
+            writeFileSync(join(target, 'responsibility.json'), `${JSON.stringify(result.matrix, null, 2)}\n`, 'utf8');
+        }
+        return {
+            exitCode: 0,
+            stdout: `Wrote RESPONSIBILITY.md and responsibility.json to ${out}\n`,
+            stderr: '',
+        };
+    }
     if (kind === 'briefs') {
         const result = outcome.result;
         mkdirSync(target, { recursive: true });
@@ -236,7 +249,7 @@ export const handleRequest = (request, context = { cwd: process.cwd(), workspace
             protocolVersion: '2025-06-18',
             capabilities: { tools: {} },
             serverInfo: { name: 'yarramate', version: packageVersion },
-            instructions: `The architecture record of a YarraMate workspace. The native documents in the repository are canonical; every read renders them, and yarramate_apply is the one write, the same atomic batch the CLI lands. ${LOOP} ${WORKSPACE_SENTENCE}`,
+            instructions: `${instructionsFor()} ${WORKSPACE_SENTENCE}`,
         });
         return;
     }

package/dist/branding.d.ts

@@ -0,0 +1,86 @@
+/**
+ * White-labelling (#546, ADR 0158): one value, set once by a host, that
+ * names the product on every surface a consumer's users see - the editor
+ * shell, the tool list an agent reads, the workbook's cover sheet and the
+ * LikeC4 banner. Nothing else changes: record formats, diagnostic codes and
+ * the wire protocol are contracts, not branding, and stay `yarramate/...`
+ * and `YM...`. Absent, every surface reads exactly as it always has.
+ *
+ * Pure: no imports, so it sits under every entry (`yarramate/tools`,
+ * `yarramate/workbook`, `yarramate/visual-app`) without weight.
+ */
+export type BrandingLogo = 
+/** Inline markup the host wrote; rendered as the host's own SVG. */
+{
+    readonly svg: string;
+}
+/** An address the page fetches; rendered as an image. */
+ | {
+    readonly url: string;
+};
+export interface Branding {
+    /** "ApertureX", "Halcyon Architecture". Required: a brand without a name is not one. */
+    readonly productName: string;
+    /**
+     * For tight chrome: beside the logo in the brand mark, and in the
+     * authority line ("Checked Halcyon model"). Defaults to `productName`.
+     * `null` draws the logo alone, for a wordmark that already says the name.
+     */
+    readonly shortName?: string | null;
+    /** Beside the title in the editor shell. Nothing is drawn without one. */
+    readonly logo?: BrandingLogo;
+    /**
+     * One CSS colour for the chrome - the authority mark, the notices, the
+     * changeset controls - never the notation: what a node or an edge looks
+     * like is the style preset's, and a comparison's added/removed marks keep
+     * their own tokens.
+     */
+    readonly accent?: string;
+    /** Where the brand mark links. Without it the mark is text, not a link. */
+    readonly docsUrl?: string;
+    /**
+     * The line under the product name, on the editor strip, the workbook's
+     * cover sheet and the LikeC4 banner. Unset: "Powered by yarramate". A
+     * string replaces it; `null` removes it, and with it every other mention
+     * of the engine those surfaces make.
+     */
+    readonly vendorLine?: string | null;
+    /**
+     * The prefix of the tool names an agent reads: `acme` publishes
+     * `acme_design`, `acme_apply`, ... Default `yarramate`. An instruction
+     * written for `yarramate_design` will not find `acme_design`, so a host
+     * that re-prefixes owns its own agent instructions.
+     */
+    readonly toolPrefix?: string;
+}
+/** `Branding` with every default applied, which is what the surfaces read. */
+export interface ResolvedBranding {
+    readonly productName: string;
+    /** `null` when the mark is the logo alone; the authority line then says `productName`. */
+    readonly shortName: string | null;
+    readonly logo?: BrandingLogo;
+    readonly accent?: string;
+    readonly docsUrl?: string;
+    /** `null` when there is none to show. */
+    readonly vendorLine: string | null;
+    readonly toolPrefix: string;
+    /** False is the unbranded product: every surface as it was before #546. */
+    readonly branded: boolean;
+}
+export declare const YARRAMATE_PRODUCT_NAME = "YarraMate";
+export declare const YARRAMATE_TOOL_PREFIX = "yarramate";
+export declare const DEFAULT_VENDOR_LINE = "Powered by yarramate";
+/**
+ * Applies the defaults. `undefined` is the unbranded product. A value with
+ * a blank `productName` or a `toolPrefix` no MCP client could publish is a
+ * host's configuration error and throws, at mount or serve time, rather
+ * than reaching a person as a blank name or an agent as a broken tool list.
+ */
+export declare const resolveBranding: (branding?: Branding) => ResolvedBranding;
+/**
+ * The product name as an identifier segment: the LikeC4 project name is
+ * `<slug>-<project id>`, `yarramate-…` unbranded. Lower-case letters,
+ * digits and single hyphens; a name with nothing usable in it falls back
+ * to the engine's own slug rather than producing an empty segment.
+ */
+export declare const brandSlug: (branding: ResolvedBranding) => string;

package/dist/branding.js

@@ -0,0 +1,80 @@
+/**
+ * White-labelling (#546, ADR 0158): one value, set once by a host, that
+ * names the product on every surface a consumer's users see - the editor
+ * shell, the tool list an agent reads, the workbook's cover sheet and the
+ * LikeC4 banner. Nothing else changes: record formats, diagnostic codes and
+ * the wire protocol are contracts, not branding, and stay `yarramate/...`
+ * and `YM...`. Absent, every surface reads exactly as it always has.
+ *
+ * Pure: no imports, so it sits under every entry (`yarramate/tools`,
+ * `yarramate/workbook`, `yarramate/visual-app`) without weight.
+ */
+export const YARRAMATE_PRODUCT_NAME = 'YarraMate';
+export const YARRAMATE_TOOL_PREFIX = 'yarramate';
+export const DEFAULT_VENDOR_LINE = 'Powered by yarramate';
+/** What an MCP client accepts in a tool name, applied to the prefix alone. */
+const TOOL_PREFIX = /^[A-Za-z0-9][A-Za-z0-9-]*$/;
+const UNBRANDED = {
+    productName: YARRAMATE_PRODUCT_NAME,
+    shortName: YARRAMATE_PRODUCT_NAME,
+    vendorLine: null,
+    toolPrefix: YARRAMATE_TOOL_PREFIX,
+    branded: false,
+};
+/**
+ * Applies the defaults. `undefined` is the unbranded product. A value with
+ * a blank `productName` or a `toolPrefix` no MCP client could publish is a
+ * host's configuration error and throws, at mount or serve time, rather
+ * than reaching a person as a blank name or an agent as a broken tool list.
+ */
+export const resolveBranding = (branding) => {
+    if (branding === undefined)
+        return UNBRANDED;
+    const productName = branding.productName.trim();
+    if (productName === '') {
+        throw new TypeError('branding.productName must not be blank');
+    }
+    const toolPrefix = branding.toolPrefix ?? YARRAMATE_TOOL_PREFIX;
+    if (!TOOL_PREFIX.test(toolPrefix)) {
+        throw new TypeError(`branding.toolPrefix "${toolPrefix}" must be letters, digits and hyphens, starting with a letter or digit`);
+    }
+    const shortName = branding.shortName === null ? null : branding.shortName?.trim();
+    const vendorLine = branding.vendorLine === undefined
+        ? DEFAULT_VENDOR_LINE
+        : branding.vendorLine === null || branding.vendorLine.trim() === ''
+            ? null
+            : branding.vendorLine.trim();
+    return {
+        productName,
+        shortName: shortName === null
+            ? null
+            : shortName === undefined || shortName === ''
+                ? productName
+                : shortName,
+        ...(branding.logo === undefined ? {} : { logo: branding.logo }),
+        ...(branding.accent === undefined ? {} : { accent: branding.accent }),
+        ...(branding.docsUrl === undefined ? {} : { docsUrl: branding.docsUrl }),
+        vendorLine,
+        toolPrefix,
+        branded: true,
+    };
+};
+/**
+ * The product name as an identifier segment: the LikeC4 project name is
+ * `<slug>-<project id>`, `yarramate-…` unbranded. Lower-case letters,
+ * digits and single hyphens; a name with nothing usable in it falls back
+ * to the engine's own slug rather than producing an empty segment.
+ */
+export const brandSlug = (branding) => {
+    if (!branding.branded)
+        return YARRAMATE_TOOL_PREFIX;
+    // Split on the runs and join what is left: linear, where a trim by
+    // `^-+|-+$` is polynomial on a name that is mostly hyphens (CodeQL
+    // js/polynomial-redos, the rule that bit #547's walker too).
+    const slug = (branding.shortName ?? branding.productName)
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((part) => part !== '')
+        .join('-');
+    return slug === '' ? YARRAMATE_TOOL_PREFIX : slug;
+};

package/dist/brief.js

@@ -1,5 +1,5 @@
 import { conceptKinds } from './profile.js';
-import { RELATIONSHIP_READING, humanizeKind } from './relationship-reading.js';
+import { EXTENSION_READING, RELATIONSHIP_READING, humanizeKind } from './relationship-reading.js';
 const coreKindNames = new Map(conceptKinds.map(({ id, name }) => [id, name]));
 const motivationKindIds = new Set(conceptKinds
     .filter(({ layer }) => layer === 'motivation')
@@ -66,6 +66,9 @@ const relationshipPhrase = (coreKind, fallbackKind, mode, content) => {
     if (coreKind === 'flow') {
         return content === undefined ? 'flows to' : `sends ${content} to`;
     }
+    const extension = EXTENSION_READING[fallbackKind];
+    if (extension !== undefined)
+        return extension;
     const reading = coreKind === undefined ? undefined : RELATIONSHIP_READING[coreKind];
     return reading ?? humanizeKind(fallbackKind);
 };

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 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 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 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 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/compiler.js

@@ -3,7 +3,7 @@ import { conceptKinds, relationshipPolicies, } from './profile.js';
 import { isCoreConceptKindId, matrixEndpointAspects, permittedRelationshipKinds as tablePermittedKinds, } from './relationship-matrix.js';
 import { closestCandidate, describeSchemaViolation, } from './source-document.js';
 import { ATTESTATION_PREDICATE_PREFIX, attestationClaimValue } from './graph-claims.js';
-import { shippedPolicyIdentity, shippedPolicySource, } from './shipped-profile.js';
+import { shippedProfileOf } from './shipped-profile.js';
 import { validateDocument, validateProfile, validatePattern } from './schema-validation.js';
 const coreProfile = 'yarramate/core@0.1';
 /**
@@ -371,58 +371,78 @@ function compileWorkspaceResolved(parsed) {
         const identity = `${value.id}@${value.version}`;
         pendingProfiles.push({ input, value, identity, positionFor });
     }
-    const alreadyDeclaresPolicy = pendingProfiles.some(({ identity }) => identity === shippedPolicyIdentity);
-    if (!alreadyDeclaresPolicy) {
-        // This probe runs BEFORE the document gate that rejects a source whose
-        // schema check failed, so it has to hold its own precondition: a source
-        // that composes to anything but a mapping - an empty file, a comment-only
-        // one, a bare scalar - selects no profile at all. It used to read
-        // `.profile` through an `as` cast, which is what hid the null from the
-        // typechecker, and an empty document crashed the whole compile with a
-        // `TypeError` instead of the `YM201 must be object` its schema already
-        // produces. Every other consumer of a parsed entry checks its diagnostics
-        // first (the profile walk above, the pattern walk below); this one could
-        // not, because it runs before that gate exists, so it narrows instead.
-        const selected = documentInputs.some(({ entry }) => {
-            const value = entry.value;
-            return (typeof value === 'object' &&
-                value !== null &&
-                value.profile ===
-                    shippedPolicyIdentity);
-        });
-        const extended = pendingProfiles.some(({ value }) => value.extends === shippedPolicyIdentity);
-        if (selected || extended) {
-            const input = {
-                path: 'yarramate:profile:yarramate/policy@0.1',
-                source: shippedPolicySource,
-            };
-            const { entry, fresh } = parseWorkspaceSource(input);
-            const value = entry.value;
-            if (entry.schemaDiagnostics.length > 0) {
-                profileDiagnostics.push(...entry.schemaDiagnostics);
-            }
-            else if (!validateProfile(value)) {
-                for (const error of validateProfile.errors ?? []) {
-                    profileDiagnostics.push({
-                        severity: 'error',
-                        code: 'YM201',
-                        message: `Profile schema violation: ${describeSchemaViolation(error)}`,
-                        path: input.path,
-                        pointer: error.instancePath || '/',
-                        line: 1,
-                        column: 1,
-                    });
-                }
-            }
-            else {
-                pendingProfiles.push({
-                    input,
-                    value,
-                    identity: shippedPolicyIdentity,
-                    positionFor: positionReader(input.source, entry.positions, fresh),
+    // The shipped optional profiles (ADR 0095; policy@0.2 per ADR 0159). Each
+    // is injected when a document selects it or a profile extends it, and a
+    // shipped profile's own parent follows it in, so `extends:
+    // yarramate/policy@0.2` brings 0.1 along. A workspace file that declares
+    // the same identity wins; the shipped copy is not added beside it.
+    //
+    // This probe runs BEFORE the document gate that rejects a source whose
+    // schema check failed, so it has to hold its own precondition: a source
+    // that composes to anything but a mapping - an empty file, a comment-only
+    // one, a bare scalar - selects no profile at all. It used to read
+    // `.profile` through an `as` cast, which is what hid the null from the
+    // typechecker, and an empty document crashed the whole compile with a
+    // `TypeError` instead of the `YM201 must be object` its schema already
+    // produces. Every other consumer of a parsed entry checks its diagnostics
+    // first (the profile walk above, the pattern walk below); this one could
+    // not, because it runs before that gate exists, so it narrows instead.
+    const declaredIdentities = new Set(pendingProfiles.map(({ identity }) => identity));
+    const requestedIdentities = new Set();
+    for (const { entry } of documentInputs) {
+        const value = entry.value;
+        if (typeof value !== 'object' || value === null)
+            continue;
+        const profile = value.profile;
+        if (typeof profile === 'string')
+            requestedIdentities.add(profile);
+    }
+    for (const { value } of pendingProfiles)
+        requestedIdentities.add(value.extends);
+    const wantedShipped = [];
+    const want = (identity) => {
+        if (declaredIdentities.has(identity) || wantedShipped.includes(identity))
+            return;
+        const shipped = shippedProfileOf(identity);
+        if (shipped === undefined)
+            return;
+        wantedShipped.push(identity);
+        want(shipped.extends);
+    };
+    for (const identity of requestedIdentities)
+        want(identity);
+    for (const identity of wantedShipped) {
+        const shipped = shippedProfileOf(identity);
+        const input = {
+            path: `yarramate:profile:${identity}`,
+            source: shipped.source,
+        };
+        const { entry, fresh } = parseWorkspaceSource(input);
+        const value = entry.value;
+        if (entry.schemaDiagnostics.length > 0) {
+            profileDiagnostics.push(...entry.schemaDiagnostics);
+        }
+        else if (!validateProfile(value)) {
+            for (const error of validateProfile.errors ?? []) {
+                profileDiagnostics.push({
+                    severity: 'error',
+                    code: 'YM201',
+                    message: `Profile schema violation: ${describeSchemaViolation(error)}`,
+                    path: input.path,
+                    pointer: error.instancePath || '/',
+                    line: 1,
+                    column: 1,
                 });
             }
         }
+        else {
+            pendingProfiles.push({
+                input,
+                value,
+                identity,
+                positionFor: positionReader(input.source, entry.positions, fresh),
+            });
+        }
     }
     let unresolvedProfiles = pendingProfiles.sort((left, right) => left.identity.localeCompare(right.identity) ||
         left.input.path.localeCompare(right.input.path));