@sdd-method/sdd-cli 0.21.0 → 0.22.0

package/README.md

@@ -3,7 +3,8 @@
 Method-layer CLI for the SDD method's SDD repository lifecycle.
 
 **Status:** v0.3.0. All four verbs shipped across all three profiles; the
-companion `generate-claude-md` verb lands alongside.
+companion `generate-briefing` verb lands alongside (replaces the v0.3–v0.21
+`generate-claude-md` per ADR 0148).
 
 ## What this is
 
@@ -12,11 +13,11 @@ uses to manage SDD repositories. It has four verbs and three profiles:
 
 | Verb | Behaviour | v0.3.0 |
 |---|---|---|
-| `init --profile {platform\|application\|integration}` | Scaffold a new SDD repository: render profile-specific manifests, apply the method baseline, write CLAUDE.md, `git init`, run post-bootstrap validation | Native TS |
-| `sync` | Pull the latest upstream method baseline into an existing SDD repository | Native TS |
+| `init --profile {platform\|application\|integration}` | Scaffold a new SDD repository: render profile-specific manifests, apply the method baseline, emit `agent-instructions.md` + harness wrapper (per ADR 0148), `git init`, run post-bootstrap validation | Native TS |
+| `sync` | Pull the latest upstream method baseline into an existing SDD repository (refreshes `agent-instructions.md` + the harness wrapper's method-managed block) | Native TS |
 | `validate` | Run the method-level validation suite for this SDD repository (profile-aware dispatch; platform suite = 7 core + optional `docs-all` wrapper) | TS dispatch over bundled + target-repo bash validators |
 | `list` | Enumerate SDD repositories discoverable in the workspace (text or JSON output; profile filter) | Native TS |
-| `generate-claude-md` | Regenerate CLAUDE.md for an existing SDD repo using the v0.3.0 native renderer | Native TS |
+| `generate-briefing` | Regenerate `agent-instructions.md` + the harness wrapper for an existing SDD repo (no bundle sync) | Native TS |
 | `mcp serve` | Start a local stdio Model Context Protocol (MCP) server exposing the SDD as resources and tools (ADR 0128, Phase 1) | Native TS |
 
 Every verb is local git + filesystem. No authentication, no network calls,
@@ -71,14 +72,33 @@ sdd-cli list --workspace-root ~/Projects/contextua-applications \
              --workspace-root ~/Projects/contextua-integrations
 sdd-cli list --profile integration --format json
 
-# Regenerate CLAUDE.md for an existing repo
-sdd-cli generate-claude-md --app-id self-service-admin \
-                           --platform-name "Contextua" --allow-existing
+# Regenerate the briefing files (agent-instructions.md + CLAUDE.md / AGENTS.md)
+sdd-cli generate-briefing --agent-harness claude-code --allow-overwrite
 ```
 
-### CLAUDE.md output scope
+### Briefing layer (`agent-instructions.md` + harness wrapper)
 
-`sdd-cli init` and `sdd-cli generate-claude-md` ship a **native TypeScript renderer** for CLAUDE.md. Output is a minimal, stable subset focused on repo identity, lifecycle commands, and the managed-path reminder. It is deliberately narrower than the upstream bash generators (`generate-app-claude-md.sh`, `generate-integration-claude-md.sh`) — this keeps the `commander`-only runtime-dep promise by avoiding `yq` as a host prerequisite. Partners who want the richer bash output can still run those scripts directly from an sdd-method clone.
+Per [ADR 0148](https://github.com/tomfosteruk/sdd-method/blob/main/docs/method/adr/ADR%200148:%20Method-Defined%20Agent%20Briefing%20Layer.md), `sdd-cli init` and `sdd-cli sync` emit two files at the SDD root:
+
+- **`agent-instructions.md`** — fully method-managed, harness-neutral briefing. Overwritten unconditionally on every sync.
+- **The harness wrapper** — `CLAUDE.md` under `--agent-harness claude-code`, `AGENTS.md` under `--agent-harness github-copilot-cli`. Thin pointer with `<!-- method-managed: begin/end -->` markers. The method-managed block is refreshed on sync; adopter content below survives.
+
+Templates ship in the bundle at `orchestration/templates/briefing/`. Older bundles that pre-date ADR 0148 sync without emitting these files (graceful skip with a log line).
+
+**Migration note (v0.21.x → v0.22.0):** the legacy `generate-claude-md` verb retired in favour of `generate-briefing`. The v0.3–v0.21 native CLAUDE.md renderer is gone — its rich-content shape is replaced by the upstream template-driven thin-pointer shape. Adopters with hand-edited CLAUDE.md files will see sync refuse the wrapper rewrite without `--allow-overwrite` on first run; rehome any custom content below the `method-managed: end` marker before sync, or pass `--allow-overwrite` after backing up.
+
+### Agent-harness selection (`--agent-harness`)
+
+Per [ADR 0141](https://github.com/tomfosteruk/sdd-method/blob/main/docs/method/adr/ADR%200141:%20Agent-Harness-Neutral%20Skills%20and%20Hooks.md), `sdd-cli init` and `sdd-cli sync` accept `--agent-harness <name>` to drive which hook configuration gets emitted. Supported values:
+
+| Value | Hooks surface | MCP surface |
+|---|---|---|
+| `claude-code` (default, reference) | `.claude/settings.json` `hooks` block — `PreToolUse` method-guard + `SessionStart` ADR-structure check | `.claude/settings.json` `mcpServers` block |
+| `github-copilot-cli` | `.github/hooks/pre-tool-use.json` + `.github/hooks/session-start.json` (per `docs/method/methods/hook-contracts.md`) | not yet wired — ADR 0150 Phase 3 lands the Copilot-CLI MCP surface |
+
+Adopters using Cursor / Cline / Aider / custom harnesses implement the portable contracts themselves per ADR 0141 §4.5 — see `docs/method/onboarding/agent-harness-adopter-responsibility.md` in the method baseline.
+
+**Behavioural delta:** the flag now defaults to `claude-code` when omitted, where previous versions left it unset (no hooks seeded). The first `sdd-cli sync` after upgrading on an existing repo will start refreshing the Claude hooks block. The dedupe pre-pass shipped in v0.12.2 collapses any unmarked hand-rolled entries that match the method shape, so adopters on v0.12.2+ get sentinel-tagged-in-place rather than duplicates. Adopters on sdd-cli &lt; v0.12.2 should `npm install -g @sdd-method/sdd-cli@latest` before re-syncing.
 
 ## MCP server (Phase 1)
 
@@ -137,7 +157,7 @@ npm install -g @sdd-method/sdd-cli
 npm install
 npm run build          # tsc -> dist/
 npm run typecheck      # tsc --noEmit
-npm run test           # vitest: unit + parity + sync + init + validate + list + generate-claude-md + credential-free
+npm run test           # vitest: unit + parity + sync + init + validate + list + generate-briefing + briefing + credential-free
 ```
 
 Node.js 20 LTS or later is required.

package/dist/index.js

@@ -1,7 +1,7 @@
 import { Command, CommanderError } from "commander";
 import { getPackageVersion } from "./lib/package-version.js";
 import { registerCatalogue } from "./verbs/catalogue.js";
-import { registerGenerateClaudeMd } from "./verbs/generate-claude-md.js";
+import { registerGenerateBriefing } from "./verbs/generate-briefing.js";
 import { registerInit } from "./verbs/init.js";
 import { registerList } from "./verbs/list.js";
 import { registerMcp } from "./verbs/mcp.js";
@@ -29,7 +29,7 @@ function buildProgram() {
     const program = new Command();
     program
         .name("sdd-cli")
-        .description("Method-layer CLI for SDD repository lifecycle — init, sync, validate, list, plan, generate-claude-md.")
+        .description("Method-layer CLI for SDD repository lifecycle — init, sync, validate, list, plan, generate-briefing.")
         .version(getPackageVersion(), "-v, --version")
         .addHelpText("after", `\nSpec: ${SPEC_URL}`)
         .exitOverride()
@@ -42,7 +42,7 @@ function buildProgram() {
     registerValidate(program);
     registerList(program);
     registerPlan(program);
-    registerGenerateClaudeMd(program);
+    registerGenerateBriefing(program);
     registerMcp(program);
     registerCatalogue(program);
     for (const { verb, summary } of NOT_YET_IMPLEMENTED) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/agent-harness.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Agent-harness identifiers — the value space of `--agent-harness` on
+ * `sdd-cli init` and `sdd-cli sync` per ADR 0141 §4.6.
+ *
+ * Claude Code is the reference implementation per ADR 0141 §4.4 and
+ * the default. GitHub Copilot CLI is the second reference per
+ * `docs/method/methods/hook-contracts.md`. Adopters using a different
+ * harness implement the portable contracts themselves per ADR 0141 §4.5.
+ */
+export declare const AGENT_HARNESSES: readonly ["claude-code", "github-copilot-cli"];
+export type AgentHarness = (typeof AGENT_HARNESSES)[number];
+export declare const DEFAULT_AGENT_HARNESS: AgentHarness;
+export declare function isAgentHarness(value: string): value is AgentHarness;
+/**
+ * Resolve an optional CLI input to a concrete harness, falling back to
+ * the reference default when unset. Throws on an unsupported value so
+ * the CLI can surface a clear error to the caller.
+ */
+export declare function resolveAgentHarness(input: string | undefined): AgentHarness;
+//# sourceMappingURL=agent-harness.d.ts.map

package/dist/lib/agent-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-harness.d.ts","sourceRoot":"","sources":["../../src/lib/agent-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,eAAe,gDAAiD,CAAC;AAE9E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,eAAO,MAAM,qBAAqB,EAAE,YAA4B,CAAC;AAEjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAQ3E"}

package/dist/lib/agent-harness.js

@@ -0,0 +1,28 @@
+/**
+ * Agent-harness identifiers — the value space of `--agent-harness` on
+ * `sdd-cli init` and `sdd-cli sync` per ADR 0141 §4.6.
+ *
+ * Claude Code is the reference implementation per ADR 0141 §4.4 and
+ * the default. GitHub Copilot CLI is the second reference per
+ * `docs/method/methods/hook-contracts.md`. Adopters using a different
+ * harness implement the portable contracts themselves per ADR 0141 §4.5.
+ */
+export const AGENT_HARNESSES = ["claude-code", "github-copilot-cli"];
+export const DEFAULT_AGENT_HARNESS = "claude-code";
+export function isAgentHarness(value) {
+    return AGENT_HARNESSES.includes(value);
+}
+/**
+ * Resolve an optional CLI input to a concrete harness, falling back to
+ * the reference default when unset. Throws on an unsupported value so
+ * the CLI can surface a clear error to the caller.
+ */
+export function resolveAgentHarness(input) {
+    if (input === undefined)
+        return DEFAULT_AGENT_HARNESS;
+    if (!isAgentHarness(input)) {
+        throw new Error(`Unsupported --agent-harness "${input}". Supported: ${AGENT_HARNESSES.join(", ")}.`);
+    }
+    return input;
+}
+//# sourceMappingURL=agent-harness.js.map

package/dist/lib/agent-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-harness.js","sourceRoot":"","sources":["../../src/lib/agent-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,oBAAoB,CAAU,CAAC;AAI9E,MAAM,CAAC,MAAM,qBAAqB,GAAiB,aAAa,CAAC;AAEjE,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAQ,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,qBAAqB,CAAC;IACtD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,gCAAgC,KAAK,iBAAiB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/briefing/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Public facade for the briefing layer (ADR 0148).
+ *
+ * `agent-instructions.md` is the harness-neutral canonical briefing
+ * (fully method-managed; sync overwrites unconditionally). Harness
+ * wrappers (`CLAUDE.md`, `AGENTS.md`, …) are thin pointers with a
+ * `<!-- method-managed: begin/end -->` block at the top; adopter
+ * content below survives sync via the existing `writeMarkedBlockFile`
+ * machinery.
+ */
+export { AGENT_INSTRUCTIONS_REL_PATH, BRIEFING_TEMPLATE_ROOT, WRAPPER_BLOCK_BEGIN, WRAPPER_BLOCK_END, extractWrapperBlock, findUnresolvedPlaceholders, harnessWrapperOutputPath, renderAgentInstructions, renderHarnessWrapper, substitute, } from "./render.js";
+export type { RenderResult } from "./render.js";
+export { resolveBriefingVariables } from "./variables.js";
+export type { BriefingVariables, ResolveVariablesOptions } from "./variables.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/briefing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/briefing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lib/briefing/index.js

@@ -0,0 +1,13 @@
+/**
+ * Public facade for the briefing layer (ADR 0148).
+ *
+ * `agent-instructions.md` is the harness-neutral canonical briefing
+ * (fully method-managed; sync overwrites unconditionally). Harness
+ * wrappers (`CLAUDE.md`, `AGENTS.md`, …) are thin pointers with a
+ * `<!-- method-managed: begin/end -->` block at the top; adopter
+ * content below survives sync via the existing `writeMarkedBlockFile`
+ * machinery.
+ */
+export { AGENT_INSTRUCTIONS_REL_PATH, BRIEFING_TEMPLATE_ROOT, WRAPPER_BLOCK_BEGIN, WRAPPER_BLOCK_END, extractWrapperBlock, findUnresolvedPlaceholders, harnessWrapperOutputPath, renderAgentInstructions, renderHarnessWrapper, substitute, } from "./render.js";
+export { resolveBriefingVariables } from "./variables.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/briefing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/briefing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lib/briefing/render.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Renderer for the briefing-layer templates per ADR 0148 + Phase 4 of
+ * `adopt-agent-instructions-briefing-layer.md`.
+ *
+ * Templates ship via the method baseline bundle and land at
+ * `<target>/orchestration/templates/briefing/...` after sync's
+ * `copyManagedFiles` step. Both `sdd-cli init` and `sdd-cli sync` read
+ * the on-disk templates and substitute the four canonical variables.
+ *
+ * Substitution is a deliberate Handlebars *subset* — `{{var}}` only,
+ * no helpers / conditionals / partials. Keeps the runtime-dep
+ * allowlist clean (no Handlebars package) and matches the template
+ * shapes shipped upstream.
+ */
+import type { AgentHarness } from "../agent-harness.js";
+import type { BriefingVariables } from "./variables.js";
+export declare const BRIEFING_TEMPLATE_ROOT = "orchestration/templates/briefing";
+export declare const AGENT_INSTRUCTIONS_REL_PATH = "agent-instructions.md";
+/** Output filename per harness — e.g. `CLAUDE.md` or `AGENTS.md`. */
+export declare function harnessWrapperOutputPath(harness: AgentHarness): string;
+/**
+ * Marker pair the wrapper templates use to delimit the method-managed
+ * region. The wrapper sync path slices this region out of the freshly
+ * rendered template and hands it to `writeMarkedBlockFile`.
+ */
+export declare const WRAPPER_BLOCK_BEGIN = "<!-- method-managed: begin -->";
+export declare const WRAPPER_BLOCK_END = "<!-- method-managed: end -->";
+/**
+ * Substitute the four canonical variables into a template string. Any
+ * `{{var}}` placeholder whose name is not in the variable set is left
+ * verbatim — callers may pre-check for leftovers if strict rendering
+ * is desired.
+ */
+export declare function substitute(template: string, vars: BriefingVariables): string;
+/**
+ * Find any unresolved `{{var}}` placeholders. Returns the set of
+ * placeholder names (de-duplicated). Callers use this to decide
+ * whether to warn or hard-fail on a stale template.
+ */
+export declare function findUnresolvedPlaceholders(rendered: string): string[];
+export interface RenderResult {
+    readonly content: string;
+    readonly unresolved: readonly string[];
+}
+export declare function renderAgentInstructions(targetRepo: string, vars: BriefingVariables): Promise<RenderResult | null>;
+export declare function renderHarnessWrapper(targetRepo: string, harness: AgentHarness, vars: BriefingVariables): Promise<RenderResult | null>;
+/**
+ * Extract the method-managed slice (begin marker through end marker,
+ * inclusive) from a fully-rendered wrapper template. Used by the sync
+ * flow to drive marker-aware merge while preserving adopter content
+ * around the block.
+ *
+ * Throws when the markers aren't both found — that's a template-
+ * authoring bug, not an adopter-side issue.
+ */
+export declare function extractWrapperBlock(rendered: string): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/lib/briefing/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/lib/briefing/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,eAAO,MAAM,sBAAsB,qCAAqC,CAAC;AACzE,eAAO,MAAM,2BAA2B,0BAA0B,CAAC;AAenE,qEAAqE;AACrE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,mCAAmC,CAAC;AACpE,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,iBAAiB,GACtB,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAMrE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAO9B;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAI9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU5D"}

package/dist/lib/briefing/render.js

@@ -0,0 +1,112 @@
+/**
+ * Renderer for the briefing-layer templates per ADR 0148 + Phase 4 of
+ * `adopt-agent-instructions-briefing-layer.md`.
+ *
+ * Templates ship via the method baseline bundle and land at
+ * `<target>/orchestration/templates/briefing/...` after sync's
+ * `copyManagedFiles` step. Both `sdd-cli init` and `sdd-cli sync` read
+ * the on-disk templates and substitute the four canonical variables.
+ *
+ * Substitution is a deliberate Handlebars *subset* — `{{var}}` only,
+ * no helpers / conditionals / partials. Keeps the runtime-dep
+ * allowlist clean (no Handlebars package) and matches the template
+ * shapes shipped upstream.
+ */
+import { access, readFile } from "node:fs/promises";
+import { join } from "node:path";
+export const BRIEFING_TEMPLATE_ROOT = "orchestration/templates/briefing";
+export const AGENT_INSTRUCTIONS_REL_PATH = "agent-instructions.md";
+const HARNESS_WRAPPER_TEMPLATE = {
+    "claude-code": {
+        templateRel: "claude-code/CLAUDE.md.hbs",
+        outputRel: "CLAUDE.md",
+    },
+    "github-copilot-cli": {
+        templateRel: "github-copilot-cli/AGENTS.md.hbs",
+        outputRel: "AGENTS.md",
+    },
+};
+/** Output filename per harness — e.g. `CLAUDE.md` or `AGENTS.md`. */
+export function harnessWrapperOutputPath(harness) {
+    return HARNESS_WRAPPER_TEMPLATE[harness].outputRel;
+}
+/**
+ * Marker pair the wrapper templates use to delimit the method-managed
+ * region. The wrapper sync path slices this region out of the freshly
+ * rendered template and hands it to `writeMarkedBlockFile`.
+ */
+export const WRAPPER_BLOCK_BEGIN = "<!-- method-managed: begin -->";
+export const WRAPPER_BLOCK_END = "<!-- method-managed: end -->";
+/**
+ * Substitute the four canonical variables into a template string. Any
+ * `{{var}}` placeholder whose name is not in the variable set is left
+ * verbatim — callers may pre-check for leftovers if strict rendering
+ * is desired.
+ */
+export function substitute(template, vars) {
+    const map = {
+        sdd_name: vars.sdd_name,
+        repo_kind: vars.repo_kind,
+        baseline_version: vars.baseline_version,
+        sync_date: vars.sync_date,
+    };
+    return template.replace(/\{\{\s*([a-z_][a-z0-9_]*)\s*\}\}/g, (full, key) => {
+        return key in map ? map[key] : full;
+    });
+}
+/**
+ * Find any unresolved `{{var}}` placeholders. Returns the set of
+ * placeholder names (de-duplicated). Callers use this to decide
+ * whether to warn or hard-fail on a stale template.
+ */
+export function findUnresolvedPlaceholders(rendered) {
+    const found = new Set();
+    for (const m of rendered.matchAll(/\{\{\s*([a-z_][a-z0-9_]*)\s*\}\}/g)) {
+        found.add(m[1]);
+    }
+    return [...found];
+}
+export async function renderAgentInstructions(targetRepo, vars) {
+    const templatePath = join(targetRepo, BRIEFING_TEMPLATE_ROOT, "agent-instructions.md.hbs");
+    return renderFromPath(templatePath, vars);
+}
+export async function renderHarnessWrapper(targetRepo, harness, vars) {
+    const { templateRel } = HARNESS_WRAPPER_TEMPLATE[harness];
+    const templatePath = join(targetRepo, BRIEFING_TEMPLATE_ROOT, templateRel);
+    return renderFromPath(templatePath, vars);
+}
+/**
+ * Extract the method-managed slice (begin marker through end marker,
+ * inclusive) from a fully-rendered wrapper template. Used by the sync
+ * flow to drive marker-aware merge while preserving adopter content
+ * around the block.
+ *
+ * Throws when the markers aren't both found — that's a template-
+ * authoring bug, not an adopter-side issue.
+ */
+export function extractWrapperBlock(rendered) {
+    const beginIdx = rendered.indexOf(WRAPPER_BLOCK_BEGIN);
+    const endIdx = rendered.indexOf(WRAPPER_BLOCK_END, beginIdx);
+    if (beginIdx === -1 || endIdx === -1) {
+        throw new Error("Wrapper template missing method-managed markers: " +
+            `expected ${WRAPPER_BLOCK_BEGIN} ... ${WRAPPER_BLOCK_END} (template-authoring bug)`);
+    }
+    return rendered.slice(beginIdx, endIdx + WRAPPER_BLOCK_END.length);
+}
+async function renderFromPath(templatePath, vars) {
+    if (!(await fileExists(templatePath)))
+        return null;
+    const raw = await readFile(templatePath, "utf8");
+    const content = substitute(raw, vars);
+    return { content, unresolved: findUnresolvedPlaceholders(content) };
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/lib/briefing/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/lib/briefing/render.ts"],"names":[],"mappings":"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"}

package/dist/lib/briefing/variables.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Variable resolution for the briefing layer per ADR 0148 §4.1 + the
+ * Phase 4 setup notes in `adopt-agent-instructions-briefing-layer.md`.
+ *
+ * The four variables are sourced from target-repo state:
+ *
+ *   sdd_name         basename(targetRepo) — overridden by
+ *                    `.sdd/sdd-manifest.yaml::sdd_id` when present.
+ *   repo_kind        `.sdd-repo-kind` content (platform-product /
+ *                    application-product / integration-product /
+ *                    reverse-corpus).
+ *   baseline_version forward-base bundle's `bundle_version` from
+ *                    `method-baseline.lock`.
+ *   sync_date        caller-supplied ISO date (today for init/sync).
+ *
+ * No new YAML parser added — the manifest is a single optional scalar
+ * read; existing scalar-line parser in src/lib/bundle.ts is the
+ * precedent for this style.
+ */
+import { type RepoKind } from "../repo-kind.js";
+export interface BriefingVariables {
+    readonly sdd_name: string;
+    readonly repo_kind: RepoKind;
+    readonly baseline_version: string;
+    readonly sync_date: string;
+}
+export interface ResolveVariablesOptions {
+    readonly targetRepo: string;
+    /**
+     * ISO date (YYYY-MM-DD) to record in the rendered briefing as the
+     * sync_date. Caller passes the canonical timestamp for the operation
+     * (init's or sync's now). Defaults to today's date in UTC.
+     */
+    readonly syncDate?: string;
+    /**
+     * Optional repo_kind override for init flows where the marker file
+     * may not exist yet at resolve time. When set, skips the
+     * `.sdd-repo-kind` read.
+     */
+    readonly repoKindOverride?: RepoKind;
+    /**
+     * Optional baseline_version override. Sync uses this to pass the
+     * incoming bundle's version directly so the renderer doesn't have
+     * to wait for `method-baseline.lock` to be updated.
+     */
+    readonly baselineVersionOverride?: string;
+}
+export declare function resolveBriefingVariables(opts: ResolveVariablesOptions): Promise<BriefingVariables>;
+//# sourceMappingURL=variables.d.ts.map

package/dist/lib/briefing/variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../../src/lib/briefing/variables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAS5B"}

package/dist/lib/briefing/variables.js

@@ -0,0 +1,92 @@
+/**
+ * Variable resolution for the briefing layer per ADR 0148 §4.1 + the
+ * Phase 4 setup notes in `adopt-agent-instructions-briefing-layer.md`.
+ *
+ * The four variables are sourced from target-repo state:
+ *
+ *   sdd_name         basename(targetRepo) — overridden by
+ *                    `.sdd/sdd-manifest.yaml::sdd_id` when present.
+ *   repo_kind        `.sdd-repo-kind` content (platform-product /
+ *                    application-product / integration-product /
+ *                    reverse-corpus).
+ *   baseline_version forward-base bundle's `bundle_version` from
+ *                    `method-baseline.lock`.
+ *   sync_date        caller-supplied ISO date (today for init/sync).
+ *
+ * No new YAML parser added — the manifest is a single optional scalar
+ * read; existing scalar-line parser in src/lib/bundle.ts is the
+ * precedent for this style.
+ */
+import { access, readFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { readLockFile } from "../lock-file.js";
+import { readRepoKind } from "../repo-kind.js";
+export async function resolveBriefingVariables(opts) {
+    const sdd_name = await resolveSddName(opts.targetRepo);
+    const repo_kind = opts.repoKindOverride ?? (await requireRepoKind(opts.targetRepo));
+    const baseline_version = opts.baselineVersionOverride ??
+        (await resolveBaselineVersion(opts.targetRepo));
+    const sync_date = opts.syncDate ?? todayIso();
+    return { sdd_name, repo_kind, baseline_version, sync_date };
+}
+async function resolveSddName(targetRepo) {
+    const fromManifest = await tryReadSddManifestId(targetRepo);
+    if (fromManifest !== null)
+        return fromManifest;
+    return basename(targetRepo);
+}
+async function tryReadSddManifestId(targetRepo) {
+    const path = join(targetRepo, ".sdd", "sdd-manifest.yaml");
+    if (!(await fileExists(path)))
+        return null;
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    // Single-scalar line parse, matching bundle.ts style. The catalogue
+    // surface uses a full YAML loader elsewhere; here we only want one
+    // optional field, so this stays dependency-light.
+    for (const line of raw.split("\n")) {
+        const m = /^sdd_id: (.+)$/.exec(line.trim());
+        if (m) {
+            const value = m[1].trim().replace(/^["']|["']$/g, "");
+            if (value.length > 0)
+                return value;
+        }
+    }
+    return null;
+}
+async function requireRepoKind(targetRepo) {
+    const kind = await readRepoKind(targetRepo);
+    if (!kind) {
+        throw new Error(`Cannot resolve briefing variables: .sdd-repo-kind missing at ${targetRepo}`);
+    }
+    return kind;
+}
+async function resolveBaselineVersion(targetRepo) {
+    const lock = await readLockFile(targetRepo);
+    if (!lock) {
+        throw new Error(`Cannot resolve baseline_version: method-baseline.lock missing at ${targetRepo}`);
+    }
+    const forwardBase = lock.bundles.find((b) => b.isForwardBase);
+    if (!forwardBase) {
+        throw new Error(`Cannot resolve baseline_version: no forward-base bundle in method-baseline.lock at ${targetRepo}`);
+    }
+    return forwardBase.bundleVersion;
+}
+function todayIso() {
+    return new Date().toISOString().slice(0, 10);
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=variables.js.map

package/dist/lib/briefing/variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.js","sourceRoot":"","sources":["../../../src/lib/briefing/variables.ts"],"names":[],"mappings":"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"}

package/dist/lib/catalogue/aggregate.d.ts

@@ -1,6 +1,7 @@
 import { type CatalogueDef } from "./schema-loader.js";
 import { parseCatalogueCsv } from "./csv-reader.js";
 import { type CatalogueRow } from "./csv-writer.js";
+import { FindingsLog } from "./findings.js";
 export interface AggregateInputs {
     /** Path to the ecosystem-root SDD repo (defaults to cwd). */
     readonly sddPath?: string;
@@ -31,6 +32,24 @@ export interface AggregateResult {
 export type Writer = (s: string) => void;
 export declare function runCatalogueAggregate(inputs: AggregateInputs, write: Writer): Promise<AggregateResult>;
 declare function stampSourceSddId(catalogue: CatalogueDef, rows: readonly Record<string, string>[], sourceSddId: string): CatalogueRow[];
+/**
+ * Derive `cross_sdd_platform_capability` rows by joining each consuming
+ * SDD's `product_platform_dependencies` rows against every platform SDD's
+ * `capability_service` rows on `target_service_id == service_id`.
+ *
+ * Emits one row per resolved (consuming-product, platform-capability)
+ * pair. A consuming dependency whose `target_service_id` doesn't resolve
+ * against any `capability_service` row is logged as an `orphan` finding
+ * and produces no row.
+ *
+ * Duplicate composite ids (same consuming-product → same platform-capability
+ * → same service) are deduped silently — they would arise only when the
+ * same service belongs to multiple capabilities on the platform side,
+ * which is itself a platform-side data quality concern surfaced elsewhere.
+ *
+ * Exported for testing.
+ */
+export declare function deriveCrossSddPlatformCapability(productPlatformDeps: readonly CatalogueRow[], capabilityServices: readonly CatalogueRow[], findings: FindingsLog): CatalogueRow[];
 export declare const __test_only__: {
     stampSourceSddId: typeof stampSourceSddId;
     parseCatalogueCsv: typeof parseCatalogueCsv;

package/dist/lib/catalogue/aggregate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/aggregate.ts"],"names":[],"mappings":"AA+BA,OAAO,EAA6C,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAoB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpE,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,mEAAmE;IACnE,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzC,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAoK1B;AAiFD,iBAAS,gBAAgB,CACvB,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACvC,WAAW,EAAE,MAAM,GAClB,YAAY,EAAE,CAUhB;AA4LD,eAAO,MAAM,aAAa;;;CAA0C,CAAC"}
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/aggregate.ts"],"names":[],"mappings":"AA+BA,OAAO,EAA6C,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAoB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,mEAAmE;IACnE,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzC,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAmL1B;AAiFD,iBAAS,gBAAgB,CACvB,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACvC,WAAW,EAAE,MAAM,GAClB,YAAY,EAAE,CAUhB;AA0LD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gCAAgC,CAC9C,mBAAmB,EAAE,SAAS,YAAY,EAAE,EAC5C,kBAAkB,EAAE,SAAS,YAAY,EAAE,EAC3C,QAAQ,EAAE,WAAW,GACpB,YAAY,EAAE,CA6DhB;AAID,eAAO,MAAM,aAAa;;;CAA0C,CAAC"}