@intentius/chant 0.85.0 → 0.86.0

package/src/workspace/composites.ts

@@ -28,6 +28,10 @@
  *
  * Each member runs under its own toolchain, as for `workspace graph`, and at
  * the same revision with `--at`. Nothing is written and no listener starts.
+ *
+ * Each component also lists the runtimes it can deploy on (#2674,
+ * `runtimes.ts`): `local`, and each lexicon its member configures that hosts
+ * `chant run --components`, with the command line for each.
  */
 
 import { formatError } from "../cli/format";
@@ -40,6 +44,7 @@ import type { LinkRow } from "./links";
 import { emitDocument, type UnitResult } from "./member-commands";
 import { readerVersion, type ErrorLocation, type WorkspaceErrorCode } from "./declaration";
 import type { ReasonCode } from "./reason-codes";
+import { componentRuntimes, readRuntimesIn, RUNTIME_REASON_CODES, type ComponentRuntime, type MemberRuntimes, type PluginLoader, type RuntimeReason } from "./runtimes";
 
 /** `$id` of the JSON Schema for the document, shipped beside this file. */
 export const COMPOSITES_OUTPUT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/composites/v1/composites.schema.json";
@@ -61,6 +66,9 @@ export const COMPOSITES_REASON_CODES = [
 ] as const satisfies readonly ReasonCode[];
 export type CompositesReasonCode = (typeof COMPOSITES_REASON_CODES)[number];
 
+/** Why a member's runtimes are only `local`, or leave out a lexicon its config lists (#2674). Closed. */
+export const COMPOSITES_RUNTIME_REASON_CODES = RUNTIME_REASON_CODES;
+
 export interface CompositesMember {
   name: string;
   dir: string;
@@ -69,6 +77,8 @@ export interface CompositesMember {
   status: "read" | "skipped" | "failed";
   reason: MemberReason | null;
   chant: string | null;
+  /** Why its components' runtimes leave something out: its config, or a lexicon, couldn't be read. Empty for a member not of kind chant. */
+  runtimeReasons: RuntimeReason[];
 }
 
 export interface ComponentEntry {
@@ -82,6 +92,8 @@ export interface ComponentEntry {
   composites: string[] | null;
   /** The component's file from the workspace root, when the member's chant names it. */
   file: string | null;
+  /** The runtimes it can deploy on: `local` first, then each hosting lexicon its member configures. */
+  runtimes: ComponentRuntime[];
 }
 
 export interface ComponentMatch {
@@ -133,7 +145,7 @@ export interface CompositesResult {
 }
 
 /** Read one member's component graph run into components, or the reason it can't be read. */
-function readComponents(member: string, dir: string, run: UnitResult): { components: ComponentEntry[] } | { reason: MemberReason } {
+function readComponents(member: string, dir: string, run: UnitResult, runtimes: MemberRuntimes | undefined): { components: ComponentEntry[] } | { reason: MemberReason } {
   if (run.exitCode !== 0) {
     const tail = run.stderr.trim().split("\n").slice(-5).join("\n");
     return { reason: { code: "command-failed", message: `chant graph --components exited ${run.exitCode}${tail ? `: ${tail}` : ""}` } };
@@ -153,6 +165,7 @@ function readComponents(member: string, dir: string, run: UnitResult): { compone
       archetype: typeof attrs.archetype === "string" ? attrs.archetype : null,
       composites: composites && composites.length > 0 ? composites : null,
       file: file ? (dir === "." ? file : `${dir}/${file}`) : null,
+      runtimes: componentRuntimes(n.id, runtimes),
     });
   }
   return { components };
@@ -220,16 +233,24 @@ export function joinComponents(instances: CompositeInstanceRow[], components: Co
   });
 }
 
-function memberEntry(m: ComposedMember, componentReason: MemberReason | null): CompositesMember {
+function memberEntry(m: ComposedMember, componentReason: MemberReason | null, runtimes: MemberRuntimes | undefined): CompositesMember {
   const reason = m.reason ?? componentReason;
   const status = m.status === "composed" ? (componentReason ? "failed" : "read") : m.status;
-  return { name: m.name, dir: m.dir, kind: m.kind, status, reason, chant: m.chant };
+  return { name: m.name, dir: m.dir, kind: m.kind, status, reason, chant: m.chant, runtimeReasons: runtimes?.reasons ?? [] };
 }
 
 /** Read the workspace's composites and components, and build the document. Never throws a `WorkspaceReadError`. */
-export async function workspaceComposites(query: Omit<GraphQuery, "kind" | "components">): Promise<CompositesResult> {
+export async function workspaceComposites(query: Omit<GraphQuery, "kind" | "components" | "inTree"> & { loadPlugin?: PluginLoader }): Promise<CompositesResult> {
   const head: Head = { $schema: COMPOSITES_OUTPUT_SCHEMA_ID, contract: COMPOSITES_CONTRACT_VERSION, chant: readerVersion() };
-  const { doc: graph, failed, components: runs } = await workspaceGraph({ ...query, components: true });
+  let runtimes = new Map<string, MemberRuntimes>();
+  const { loadPlugin, ...graphQuery } = query;
+  const { doc: graph, failed, components: runs } = await workspaceGraph({
+    ...graphQuery,
+    components: true,
+    inTree: async (root, members) => {
+      runtimes = await readRuntimesIn(root, members, loadPlugin);
+    },
+  });
   if ("error" in graph) return { doc: { ...head, error: graph.error }, failed: true };
 
   const byMember = new Map((runs ?? []).map((r) => [r.unit.member, r]));
@@ -240,13 +261,13 @@ export async function workspaceComposites(query: Omit<GraphQuery, "kind" | "comp
     const run = m.status === "composed" ? byMember.get(m.name) : undefined;
     let reason: MemberReason | null = null;
     if (run) {
-      const read = readComponents(m.name, m.dir, run);
+      const read = readComponents(m.name, m.dir, run, runtimes.get(m.name));
       if ("reason" in read) {
         reason = read.reason;
         componentsFailed = true;
       } else components.push(...read.components);
     }
-    members.push(memberEntry(m, reason));
+    members.push(memberEntry(m, reason, runtimes.get(m.name)));
   }
   components.sort((a, b) => a.id.localeCompare(b.id));
 

package/src/workspace/conformance/__fixture__/app/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "The reader conformance workspace's product: the handler of a small web app."
+}

package/src/workspace/conformance/__fixture__/app/src/server.mjs

@@ -0,0 +1,29 @@
+// The reader conformance workspace's product (#2679): the request handler of
+// a small web app, with no dependencies. The suite reads
+// `graph --intent app/src/server.mjs:19`, so line 19 is the home page's
+// status line, as it is in chant's reference-workspace/app/src/server.mjs.
+// Nothing here opens a port: chant's own packages never listen (#2657), and
+// this file ships in one.
+
+/** The app's display name. */
+export const APP_NAME = "Conformance app";
+
+/** The home page. */
+export const HOME = `<!doctype html>
+<html lang="en">
+<head><meta charset="utf-8"><title>${APP_NAME}</title></head>
+<body>
+<header><h1>${APP_NAME}</h1></header>
+<main>
+<!-- the status line -->
+<p id="status">Running.</p>
+</main>
+</body>
+</html>
+`;
+
+/** Answer one request with a status and a body. */
+export function handle(url) {
+  if (url === "/healthz") return { status: 200, type: "application/json", body: JSON.stringify({ ok: true }) };
+  return { status: 200, type: "text/html; charset=utf-8", body: HOME };
+}

package/src/workspace/conformance/__fixture__/decisions/decision.kind.mjs

@@ -0,0 +1,32 @@
+// The decision record kind (#2555), data only: no imports, no code.
+//
+// chant workspace records --kind decisions/decision.kind.mjs --current --json
+//
+// A copy of docs/design/decisions/decision.kind.mjs in the chant repo, with
+// decision.schema.json beside it, so a workspace made from this one reads its
+// decisions without the chant repo. chant's test/reference-workspace.test.ts fails
+// when this kind's data or the schema drifts from chant's.
+export const recordKind = {
+  name: "decision",
+  location: { dir: ".", match: "^[a-z][a-z0-9]{0,15}-[0-9]{3,}-.+\\.md$" },
+  format: "markdown-front-matter",
+  schema: { id: "urn:intentius:chant:decision:1", path: "decision.schema.json" },
+  idField: "id",
+  stateField: "state",
+  states: ["proposed", "decided", "ratified", "superseded", "withdrawn"],
+  // Sealed once reached (#2555).
+  closedStates: ["ratified", "superseded"],
+  supersedes: { field: "supersedes", key: "decision" },
+  // A supersedes link takes effect under an equal or stricter approval rule
+  // (#2524 D4): from a record ranked above 0 and at least as high as the one it
+  // names. A decided record supersedes a decided or proposed one, a ratified
+  // record supersedes any, and a proposed or withdrawn record none.
+  approval: { proposed: 0, withdrawn: 0, decided: 1, ratified: 2, superseded: 2 },
+  // Evidence entries with a path pin a workspace file by the hash of its bytes (#2549).
+  pins: { field: "evidence" },
+  // member:<name> and path:<path> entries are the record's links in workspace graph (#2549).
+  constrains: { field: "constrains" },
+  // Verdicts, and the field naming the decider, for each record's digest and
+  // quorum (#2671, #2672).
+  reviews: { field: "reviews", decider: "decided_by" },
+};

package/src/workspace/conformance/__fixture__/decisions/decision.schema.json

@@ -0,0 +1,364 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "urn:intentius:chant:decision:1",
+  "title": "Decision file front matter",
+  "description": "The front matter of one decision file in docs/design/decisions/. The format is described in README.md beside this file. Values stay within what YAML and JSON share, so a file can be sealed later (#2524 D4).",
+  "type": "object",
+  "additionalProperties": false,
+  "patternProperties": {
+    "^x-": {}
+  },
+  "required": [
+    "schema",
+    "id",
+    "title",
+    "state",
+    "area",
+    "source",
+    "question",
+    "options",
+    "choice",
+    "rejected",
+    "supersedes",
+    "evidence",
+    "decided_by",
+    "decided_on",
+    "reviews",
+    "constrains"
+  ],
+  "properties": {
+    "schema": {
+      "description": "Format version of this file. Bumped only by a change to this schema.",
+      "const": 1
+    },
+    "id": {
+      "description": "Stable id: a lowercase prefix per epic, a dash and three or more digits. Never reused, never renumbered.",
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]{0,15}-[0-9]{3,}$"
+    },
+    "title": {
+      "description": "Short topic, as the source table names it, without revision markers.",
+      "type": "string",
+      "minLength": 1
+    },
+    "state": {
+      "description": "Lifecycle state, from #2555.",
+      "enum": ["proposed", "decided", "ratified", "superseded", "withdrawn"]
+    },
+    "area": {
+      "description": "The design section the decision belongs to, such as \"D5\". Groups the review queue. Null only in an importer draft.",
+      "type": ["string", "null"]
+    },
+    "source": {
+      "description": "Where the decision was first recorded: a row of an issue's decisions table, or the workspace itself when no issue holds the decision (#2654).",
+      "oneOf": [{ "$ref": "#/definitions/sourceIssue" }, { "$ref": "#/definitions/sourceWorkspace" }]
+    },
+    "question": {
+      "description": "One sentence. Null only in an importer draft.",
+      "type": ["string", "null"]
+    },
+    "options": {
+      "description": "Every option considered, the chosen one included.",
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/definitions/option" }
+    },
+    "choice": {
+      "description": "The chosen option and why. Null in state proposed or withdrawn.",
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["option", "reason"],
+          "properties": {
+            "option": { "$ref": "#/definitions/optionId" },
+            "reason": { "type": ["string", "null"] }
+          }
+        }
+      ]
+    },
+    "rejected": {
+      "description": "The options not chosen, kept on the record.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["option", "why"],
+        "properties": {
+          "option": { "$ref": "#/definitions/optionId" },
+          "why": { "type": ["string", "null"] }
+        }
+      }
+    },
+    "supersedes": {
+      "description": "Earlier choices this decision replaced: another decision file, or an option chosen in an earlier revision of the same design before decision files existed.",
+      "type": "array",
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["decision"],
+            "properties": {
+              "decision": { "$ref": "#/definitions/decisionId" }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["revision", "option"],
+            "properties": {
+              "revision": { "type": "string", "pattern": "^v[0-9]+$" },
+              "option": { "$ref": "#/definitions/optionId" }
+            }
+          }
+        ]
+      }
+    },
+    "evidence": {
+      "description": "The research, audits, design sections and workspace files behind the decision. A public link carries a url; a file in the workspace carries a path and the hash of its bytes (#2549). May be empty when the decision cites nothing; chant workspace records then warns decision-no-evidence (#2654).",
+      "type": "array",
+      "items": {
+        "oneOf": [{ "$ref": "#/definitions/evidenceLink" }, { "$ref": "#/definitions/evidencePin" }]
+      }
+    },
+    "decided_by": {
+      "description": "Who chose. A forge login. Null in state proposed or withdrawn.",
+      "type": ["string", "null"]
+    },
+    "decided_on": {
+      "description": "When the choice was made, as YYYY-MM-DD. Quoted, so YAML reads it as a string.",
+      "type": ["string", "null"],
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "reviews": {
+      "description": "Each reviewer's verdict. Empty until a review happens.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["reviewer", "verdict", "on"],
+        "properties": {
+          "reviewer": { "type": "string", "minLength": 1 },
+          "verdict": { "enum": ["agree", "dissent", "abstain"] },
+          "note": { "type": ["string", "null"] },
+          "on": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+          "digest": {
+            "description": "The digest of the record text the verdict judged: the lowercase hex SHA-256 of the file with LF line endings and without its reviews block (#2672). A verdict whose digest is not the record's digest now stops counting toward the quorum. A verdict without one still counts, with the warning review-undigested.",
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$"
+          },
+          "session": {
+            "description": "The id of the review session the verdict was given in, as the session names it (#2650 C10). chant workspace records review --session writes it (#2670).",
+            "type": "string",
+            "minLength": 1
+          },
+          "proposes": {
+            "description": "With a dissent, the id of a new proposed decision the reviewer opened.",
+            "$ref": "#/definitions/decisionId"
+          },
+          "addressed_by": {
+            "description": "With a dissent, where the decider or the group answered the concern: a decision id, an issue or pull request (owner/repo#n) or an https link. An answer addresses a concern without necessarily accommodating it (RFC 7282, section 3).",
+            "anyOf": [
+              { "$ref": "#/definitions/decisionId" },
+              { "$ref": "#/definitions/issueRef" },
+              { "type": "string", "pattern": "^https://" }
+            ]
+          },
+          "withdrawn_on": {
+            "description": "With a dissent, the date its author withdrew the concern. Only the reviewer who raised a concern withdraws it.",
+            "type": "string",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+          }
+        },
+        "if": {
+          "required": ["verdict"],
+          "properties": { "verdict": { "const": "dissent" } }
+        },
+        "then": {
+          "description": "A dissent needs a reason: the dissent by {reviewer} has no note.",
+          "required": ["note"],
+          "properties": { "note": { "type": "string", "pattern": "\\S" } }
+        },
+        "else": {
+          "description": "Only a dissent is a concern: the {verdict} by {reviewer} cannot carry addressed_by or withdrawn_on.",
+          "properties": { "addressed_by": false, "withdrawn_on": false }
+        }
+      }
+    },
+    "constrains": {
+      "description": "What this decision governs: issues (owner/repo#n), other decisions (their ids), workspace members (member:<name>) or files and directories in the workspace (path:<path>, the grammar of an evidence path, #2549). At least one entry: a decision that governs nothing is refused.",
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^([A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+#[0-9]+|[a-z][a-z0-9]{0,15}-[0-9]{3,}|member:[a-z0-9][a-z0-9-]{0,39}|path:(?!/)(?!(?:[^/]*/)*\\.{1,2}(?:/|$))(?!.*//)[^\\\\\\u0000-\\u001f]*[^/\\\\\\u0000-\\u001f])$"
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "state": { "enum": ["decided", "ratified", "superseded"] } }
+      },
+      "then": {
+        "properties": {
+          "area": { "type": "string" },
+          "question": { "type": "string", "minLength": 1 },
+          "choice": {
+            "type": "object",
+            "properties": { "reason": { "type": "string", "minLength": 1 } }
+          },
+          "rejected": {
+            "items": { "properties": { "why": { "type": "string", "minLength": 1 } } }
+          },
+          "options": {
+            "items": {
+              "properties": {
+                "how": { "type": "string", "minLength": 1 },
+                "tradeoff": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "decided_by": { "type": "string" },
+          "decided_on": { "type": "string" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "state": { "enum": ["proposed", "withdrawn"] } }
+      },
+      "then": {
+        "properties": { "choice": { "type": "null" } }
+      }
+    }
+  ],
+  "definitions": {
+    "workspacePath": {
+      "description": "A path from the workspace root, with / separators: no leading /, no . or .. segment, no empty segment, no backslash and no trailing /.",
+      "type": "string",
+      "pattern": "^(?!/)(?!(?:[^/]*/)*\\.{1,2}(?:/|$))(?!.*//)[^\\\\\\u0000-\\u001f]*[^/\\\\\\u0000-\\u001f]$"
+    },
+    "evidenceLink": {
+      "description": "A public link.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["title", "url"],
+      "properties": {
+        "title": { "type": "string", "minLength": 1 },
+        "url": { "type": "string", "pattern": "^https://" },
+        "as_of": {
+          "description": "When the linked text was read, as an ISO 8601 timestamp. Lets a reader flag evidence that changed afterwards.",
+          "type": ["string", "null"]
+        },
+        "sha256": {
+          "description": "Hex SHA-256 of the linked content, once evidence is pinned by hash (#2555). Null until then.",
+          "type": ["string", "null"],
+          "pattern": "^[0-9a-f]{64}$"
+        }
+      }
+    },
+    "evidencePin": {
+      "description": "A file in the workspace, pinned by the hash of its bytes (#2524 D18, #2549). chant workspace records reports a file that changed or went missing since.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["title", "path", "sha256"],
+      "properties": {
+        "title": { "type": "string", "minLength": 1 },
+        "path": {
+          "description": "The file, from the workspace root. It sits inside a member, such as design/screens/home.json.",
+          "$ref": "#/definitions/workspacePath"
+        },
+        "sha256": {
+          "description": "Hex SHA-256 of the file's bytes when the decision was written. chant workspace records pin <path> prints it.",
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "as_of": {
+          "description": "When the file was read, as an ISO 8601 timestamp.",
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "sourceIssue": {
+      "description": "A row of the decisions table in an issue.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["issue", "row"],
+      "properties": {
+        "issue": { "$ref": "#/definitions/issueRef" },
+        "row": {
+          "description": "The row's topic cell, verbatim, including any revision marker.",
+          "type": "string"
+        },
+        "revision": {
+          "description": "The design revision that last changed this row, such as \"v8\". Null when the row carries no marker.",
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "sourceWorkspace": {
+      "description": "A decision made in the workspace, such as in a product's own design flow, with no issue behind it (#2654).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "member"],
+      "properties": {
+        "kind": { "const": "workspace" },
+        "member": {
+          "description": "The workspace member the decision was made in, by its name in the declaration.",
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]{0,39}$"
+        },
+        "session": {
+          "description": "The id of the session the decision was made in, as the member names it. Null or absent when there was none.",
+          "type": ["string", "null"],
+          "minLength": 1
+        },
+        "issue": {
+          "description": "An issue the decision relates to, when there is one.",
+          "$ref": "#/definitions/issueRef"
+        }
+      }
+    },
+    "issueRef": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+#[0-9]+$"
+    },
+    "decisionId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]{0,15}-[0-9]{3,}$"
+    },
+    "optionId": {
+      "type": "string",
+      "pattern": "^[a-z]$"
+    },
+    "option": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "label", "how", "tradeoff"],
+      "properties": {
+        "id": { "$ref": "#/definitions/optionId" },
+        "label": {
+          "description": "The option as the source table words it, without revision markers.",
+          "type": "string",
+          "minLength": 1
+        },
+        "how": {
+          "description": "How the option works.",
+          "type": ["string", "null"]
+        },
+        "tradeoff": {
+          "description": "What choosing it costs or gains.",
+          "type": ["string", "null"]
+        },
+        "chosen_in": {
+          "description": "The earlier design revision that had chosen this option, when a later revision replaced it.",
+          "type": "string",
+          "pattern": "^v[0-9]+$"
+        }
+      }
+    }
+  }
+}

package/src/workspace/conformance/__fixture__/decisions/fix-001-how-the-app-is-deployed.md

@@ -0,0 +1,40 @@
+---
+schema: 1
+id: "fix-001"
+title: "How the app is deployed"
+state: "decided"
+area: "delivery"
+source:
+  kind: "workspace"
+  member: "delivery"
+question: "What declares the app's deployment?"
+options:
+  - id: "a"
+    label: "a chant member with a composite and a component"
+    how: "The delivery member declares the app as a WebService composite instance, and a component whose contract names WebService deploys it."
+    tradeoff: "chant workspace graph --composites has a row to join, and the member needs no package beyond @intentius/chant."
+  - id: "b"
+    label: "no deployment member"
+    how: "The workspace holds the app and its decisions only."
+    tradeoff: "One member fewer, and the composites read has nothing to join."
+choice:
+  option: "a"
+  reason: "A reader of graph --composites is only tested when the join has a row."
+rejected:
+  - option: "b"
+    why: "It leaves graph --composites with an empty join."
+supersedes: []
+evidence:
+  - title: "INTENTIUS/chant#2679, the reader conformance suite outside the chant repo"
+    url: "https://github.com/INTENTIUS/chant/issues/2679"
+decided_by: "lex00"
+decided_on: "2026-09-24"
+reviews: []
+constrains:
+  - "member:app"
+  - "member:delivery"
+---
+
+# How the app is deployed
+
+This workspace is generated by `@intentius/chant/workspace/conformance` for a reader's conformance run. The delivery member declares the app as a composite, and a component deploys it.

package/src/workspace/conformance/__fixture__/delivery/chant.config.ts

@@ -0,0 +1,7 @@
+import type { ChantConfig } from "@intentius/chant";
+
+// The member's one lexicon is declared by path (#2520), so the workspace
+// needs no package beyond @intentius/chant.
+export default {
+  lexicons: [{ name: "fixture", module: "./lexicon/index.ts" }],
+} satisfies ChantConfig;

package/src/workspace/conformance/__fixture__/delivery/lexicon/index.ts

@@ -0,0 +1,26 @@
+/**
+ * A lexicon of one resource and one composite, declared by path in
+ * chant.config.ts, so the reader conformance workspace (#2679) has a
+ * composite instance without installing a lexicon package.
+ */
+import { Composite, createResource } from "@intentius/chant";
+
+export const Service = createResource("Fixture::Service", "fixture", {});
+
+export const WebService = Composite<{ port: number }>((props) => {
+  const service = new Service({ port: props.port });
+  return { service };
+}, "WebService");
+
+export const fixturePlugin = {
+  name: "fixture",
+  serializer: {
+    name: "fixture",
+    rulePrefix: "FIX",
+    serialize: (entities: Map<string, unknown>) => JSON.stringify(Array.from(entities.keys()).sort()),
+  },
+  generate: async () => {},
+  validate: async () => {},
+  coverage: async () => {},
+  package: async () => {},
+};

package/src/workspace/conformance/__fixture__/delivery/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "delivery",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Declares the reader conformance workspace's app as a composite, with the component that deploys it."
+}

package/src/workspace/conformance/__fixture__/delivery/src/app.component.ts

@@ -0,0 +1,14 @@
+/**
+ * The component that deploys the app. Its contract names the composite kind
+ * it deploys, so `chant workspace graph --composites` joins it to the `app`
+ * instance in app.ts.
+ */
+import type { Component } from "@intentius/chant/components/component";
+
+export const appComponent: Component = {
+  name: "app",
+  archetype: "service",
+  composites: ["WebService"],
+  dependsOn: [],
+  deploy: [],
+};

package/src/workspace/conformance/__fixture__/delivery/src/app.ts

@@ -0,0 +1,4 @@
+import { WebService } from "../lexicon/index";
+
+/** The app, as one WebService composite instance. */
+export const app = WebService({ port: 8080 });