musubix3 0.1.15 → 0.1.17

package/.github/plugin/marketplace.json

@@ -3,13 +3,13 @@
   "owner": { "name": "nahisaho" },
   "metadata": {
     "description": "GitHub Copilot CLI specification-driven development skills",
-    "version": "0.1.15"
+    "version": "0.1.17"
   },
   "plugins": [
     {
       "name": "musubix3",
       "source": ".",
-      "version": "0.1.15",
+      "version": "0.1.17",
       "description": "Evidence-driven SDD without duplicating native Copilot capabilities."
     }
   ]

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 0.1.17 - 2026-09-13
+
+`gate --changed` remediation for the change-evidence-waiver feature
+(CHANGE-0012, GitHub Issue #1 item):
+
+- Fixed a `TRACE_DUPLICATE` diagnostic caused by a duplicate trace `@id` on
+  two distinct annotations in `order.ts`.
+- Added a missing `@implements REQ-TDD-CYCLE-VOID-013` trace annotation on
+  the voided-cycle handling in `tdd.ts`, closing a `CHANGE_COMPLETENESS_CODE`
+  gap for CHANGE-0011.
+- Retroactively waived 166 historical `change-history`/`change-completeness`
+  diagnostics predating the CHANGE-0012 waiver mechanism as reviewed legacy
+  debt (CHANGE-0005, 0006, 0009, 0010, 0011).
+- Performed a full retroactive TDD Red-Green ceremony (18 test/requirement
+  pairs across 15 tests in `tests/change-evidence-waiver.test.ts`), resolving
+  all `TDD_TEST_STALE`/`TDD_REQUIREMENT_UNCOVERED` diagnostics.
+
+## 0.1.16 - 2026-09-12
+
+New feature: scaffold starter `requirements.md`/`design.md` files for a new
+feature slug (GitHub Issue #18).
+
+- `musubix3 requirements scaffold <slug> [--title <text>]` creates
+  `.musubix/features/<slug>/requirements.md` from a fixed placeholder
+  template.
+- `musubix3 design scaffold <slug>` creates
+  `.musubix/features/<slug>/design.md` from a fixed placeholder template; it
+  does not require a matching `requirements.md` to already exist.
+- Both commands validate the slug (`^[a-z0-9]+(-[a-z0-9]+)*$`, matching
+  `install()`'s existing convention) and refuse to overwrite an existing
+  target file, using an OS-level exclusive create (`wx`) so a concurrent
+  create is never silently clobbered (see `ADR-0020`).
+- Spec: `REQ-REQUIREMENTS-DESIGN-SCAFFOLD-001..006`,
+  `DES-REQUIREMENTS-DESIGN-SCAFFOLD-001`, tracked end-to-end in `CHANGE-0008`.
+
 ## 0.1.15 - 2026-09-11
 
 Documentation/workflow update: AI-generated documentation deliverables now go

package/README-ja.md

@@ -1,6 +1,6 @@
 # musubix3
 
-**最新リリース v0.1.14 · GitHub Copilot CLI 専用 · Node.js ≥20 · TypeScript · MIT**
+**最新リリース v0.1.17 · GitHub Copilot CLI 専用 · Node.js ≥20 · TypeScript · MIT**
 
 [English](README.md)
 

package/README.md

@@ -1,6 +1,6 @@
 # musubix3
 
-**Latest release v0.1.14 · GitHub Copilot CLI only · Node.js ≥20 · TypeScript · MIT**
+**Latest release v0.1.17 · GitHub Copilot CLI only · Node.js ≥20 · TypeScript · MIT**
 
 [日本語](README-ja.md)
 
@@ -384,8 +384,10 @@ validation/gate or requested solver failure, **2** usage, I/O or malformed confi
 | `upgrade [--dry-run]` | Refresh bundled skill files only; never touches config, constitution, or feature artifacts |
 | `plugin-install` | Invoke native Copilot installer (no internal config edits) |
 | `requirements validate <file>` | IDs, priorities, declared/detected EARS pattern |
+| `requirements scaffold <slug> [--title <text>]` | Create `.musubix/features/<slug>/requirements.md` from a fixed placeholder template; never overwrites an existing file |
 | `constitution validate [file]` | Versioned principles and measurable rule definitions |
 | `design validate <file>` | Fields, global requirement IDs, existing ADR references |
+| `design scaffold <slug>` | Create `.musubix/features/<slug>/design.md` from a fixed placeholder template; never overwrites an existing file, and does not require a pre-existing `requirements.md` |
 | `design c4 <file>` | Mermaid component/dependency diagram from explicit fields |
 | `approval prepare <requirements\|design\|release>` | Display the exact deterministic manifest and hash for human review |
 | `approval record <stage> --approver <name> --artifact-sha256 <hash> --confirm` | Record approval only if the reviewed hash is still current |
@@ -415,7 +417,7 @@ validation/gate or requested solver failure, **2** usage, I/O or malformed confi
 | `attestation oidc-audience --key-id <id> [--public-key-file <pem>]` | Derive the GitHub custom audience that authorizes a signing key |
 | `attestation payload --provider <name> --run-id <id> --key-id <id> [--public-key-file <pem>] [--github-oidc-token-file <jwt>]` | Emit canonical unsigned CI payload for external signing |
 | `attestation verify` | Verify static-key or GitHub OIDC-authorized Ed25519 provenance |
-| `change-record <CHANGE-ID> <phase> --requirement <REQ-ID...>` | Record ordered artifact/TDD fingerprints for a staged change. `impact`/`requirements`/`design`/`quality` require the change's full requirement ID set; `red`/`implementation`/`green` also accept a proper non-empty subset, recorded as an independent per-requirement batch, so a multi-requirement change can be completed with an interleaved per-requirement Red-Implementation-Green loop instead of one global batch |
+| `change-record <CHANGE-ID> <phase> --requirement <REQ-ID...> [--allow-unchanged] [--dry-run]` | Record ordered artifact/TDD fingerprints for a staged change. `impact`/`requirements`/`design`/`quality` require the change's full requirement ID set; `red`/`implementation`/`green` also accept a proper non-empty subset, recorded as an independent per-requirement batch, so a multi-requirement change can be completed with an interleaved per-requirement Red-Implementation-Green loop instead of one global batch. Rejects with a non-zero exit and a stable `*_UNCHANGED_AT_RECORD` diagnostic (leaving `changes.json`/`order.json` untouched) when a phase's fingerprint is byte-identical to the immediately preceding phase's, since that mistake is otherwise only caught much later by `trace check --strict`/`gate`, at which point the append-only evidence store makes it unfixable. `--allow-unchanged` bypasses this check for the `requirements` phase only (the one case `sdd-change` documents as legitimate: a defect fix that intentionally leaves its requirement unchanged) and persists a durable marker so later validation does not re-flag it. `--dry-run` previews the exact success/rejection outcome, including every existing check, without persisting anything |
 | `config lint` | Report configured commands whose `args` reference repository-relative paths that do not exist |
 | `config scaffold` | Propose native test-command entries for detected Go/Rust/Maven/Python/Node toolchains without writing `.musubix/config.json` |
 | `gate [--changed] [--feature <name>]` | Fresh full checks plus actual configured commands; persist evidence. `--feature` scopes requirements/design/trace/tdd/change-history/change-completeness checks to one feature as a diagnostic view; never a substitute for the repository-wide gate |

package/dist/packages/analysis/src/approval-domains.d.ts

@@ -0,0 +1,22 @@
+import type { ApprovalConfig } from './config.js';
+export interface ResolvedDomain {
+    name: string;
+    features: string[];
+}
+export declare function domainsConfigured(config: ApprovalConfig): boolean;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-002
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-002 REQ-APPROVAL-DOMAIN-SCOPING-003 REQ-APPROVAL-DOMAIN-SCOPING-004
+ * @design DES-APPROVAL-DOMAIN-SCOPING-002
+ */
+export declare function resolveDomains(root: string, config: ApprovalConfig): Promise<ResolvedDomain[]>;
+export declare function domainOwning(resolved: ResolvedDomain[], slug: string): string | null;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-014
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-016
+ * @design DES-APPROVAL-DOMAIN-SCOPING-005
+ */
+export declare function featureOwningRequirement(root: string, requirementId: string): Promise<string>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-015
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-017
+ * @design DES-APPROVAL-DOMAIN-SCOPING-005
+ */
+export declare function featureOwningDesignFile(file: string): string | null;

package/dist/packages/analysis/src/approval-domains.js

@@ -0,0 +1,75 @@
+import { validateRequirements } from '../../domain/src/index.js';
+import { matchGlob } from './graph.js';
+import { files, readText } from './files.js';
+const featureRequirementsPattern = /^\.musubix\/features\/([^/]+)\/requirements\.md$/;
+const featureDesignPattern = /^\.musubix\/features\/([^/]+)\/design\.md$/;
+export function domainsConfigured(config) {
+    return config.domains.length > 0;
+}
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-002
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-002 REQ-APPROVAL-DOMAIN-SCOPING-003 REQ-APPROVAL-DOMAIN-SCOPING-004
+ * @design DES-APPROVAL-DOMAIN-SCOPING-002
+ */
+export async function resolveDomains(root, config) {
+    const domains = config.domains;
+    if (domains.length === 0)
+        return [];
+    const slugs = [...new Set((await files(root))
+            .map((path) => featureRequirementsPattern.exec(path)?.[1])
+            .filter((slug) => !!slug))].sort();
+    const owners = new Map();
+    for (const slug of slugs) {
+        const matching = domains.filter((domain) => domain.featureGlobs.some((glob) => matchGlob(slug, glob)));
+        owners.set(slug, matching.map((domain) => domain.name).sort());
+    }
+    for (const slug of slugs) {
+        const matching = owners.get(slug);
+        if (matching.length === 0) {
+            throw new Error(`Feature "${slug}" is not owned by any configured approval domain; every feature directory must match exactly one domain's featureGlobs.`);
+        }
+        if (matching.length > 1) {
+            throw new Error(`Feature "${slug}" matches more than one configured approval domain: ${matching.join(', ')}; every feature directory must match exactly one domain.`);
+        }
+    }
+    const resolved = domains.map((domain) => ({
+        name: domain.name,
+        features: slugs.filter((slug) => owners.get(slug)[0] === domain.name).sort(),
+    }));
+    for (const domain of resolved) {
+        if (domain.features.length === 0) {
+            throw new Error(`Approval domain "${domain.name}" matches zero existing feature directories; remove it or add a matching feature.`);
+        }
+    }
+    return resolved;
+}
+export function domainOwning(resolved, slug) {
+    return resolved.find((domain) => domain.features.includes(slug))?.name ?? null;
+}
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-014
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-016
+ * @design DES-APPROVAL-DOMAIN-SCOPING-005
+ */
+export async function featureOwningRequirement(root, requirementId) {
+    const paths = (await files(root)).filter((path) => featureRequirementsPattern.test(path));
+    const owners = [];
+    for (const path of paths) {
+        const slug = featureRequirementsPattern.exec(path)[1];
+        const result = validateRequirements(await readText(root, path), path);
+        if (result.value.some((requirement) => requirement.id === requirementId))
+            owners.push(slug);
+    }
+    if (owners.length === 0)
+        throw new Error(`Requirement ${requirementId} was not found in any feature's requirements.md.`);
+    if (owners.length > 1)
+        throw new Error(`Requirement ${requirementId} is defined in more than one feature: ${owners.join(', ')}.`);
+    return owners[0];
+}
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-015
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-017
+ * @design DES-APPROVAL-DOMAIN-SCOPING-005
+ */
+export function featureOwningDesignFile(file) {
+    const match = featureDesignPattern.exec(file);
+    return match ? match[1] : null;
+}
+//# sourceMappingURL=approval-domains.js.map

package/dist/packages/analysis/src/approval-domains.js.map

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

package/dist/packages/analysis/src/approval-record.d.ts

@@ -1,6 +1,12 @@
+import type { ApprovalConfig } from './config.js';
 import { type ApprovalEvidence, type ApprovalStage } from './approval.js';
 /** @id CODE-HUMAN-APPROVAL-GATES-002
  * @implements REQ-HUMAN-APPROVAL-GATES-001 REQ-HUMAN-APPROVAL-GATES-006
  * @design DES-APPROVAL-002 DES-APPROVAL-003
  */
-export declare function recordApproval(root: string, stage: ApprovalStage, approver: string, expectedArtifactSha256: string): Promise<ApprovalEvidence>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-016
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-005 REQ-APPROVAL-DOMAIN-SCOPING-006 REQ-APPROVAL-DOMAIN-SCOPING-007
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-013 REQ-APPROVAL-DOMAIN-SCOPING-014 REQ-APPROVAL-DOMAIN-SCOPING-015
+ * @design DES-APPROVAL-DOMAIN-SCOPING-004
+ */
+export declare function recordApproval(root: string, stage: ApprovalStage, approver: string, expectedArtifactSha256: string, config: ApprovalConfig, domainName?: string): Promise<ApprovalEvidence>;

package/dist/packages/analysis/src/approval-record.js

@@ -1,11 +1,16 @@
-import { approvalManifest, requireApproval, validateStageArtifacts, } from './approval.js';
+import { approvalManifest, approvalPath, domainsConfigured, requireApproval, requireDomainOption, resolveDomains, validateStageArtifacts, } from './approval.js';
 import { writeJson } from './files.js';
 import { runGate } from './gate.js';
 /** @id CODE-HUMAN-APPROVAL-GATES-002
  * @implements REQ-HUMAN-APPROVAL-GATES-001 REQ-HUMAN-APPROVAL-GATES-006
  * @design DES-APPROVAL-002 DES-APPROVAL-003
  */
-export async function recordApproval(root, stage, approver, expectedArtifactSha256) {
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-016
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-005 REQ-APPROVAL-DOMAIN-SCOPING-006 REQ-APPROVAL-DOMAIN-SCOPING-007
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-013 REQ-APPROVAL-DOMAIN-SCOPING-014 REQ-APPROVAL-DOMAIN-SCOPING-015
+ * @design DES-APPROVAL-DOMAIN-SCOPING-004
+ */
+export async function recordApproval(root, stage, approver, expectedArtifactSha256, config, domainName) {
     const normalizedApprover = approver.trim();
     if (!normalizedApprover || normalizedApprover.includes('\0')) {
         throw new Error('Approver must be a nonempty name without NUL bytes.');
@@ -13,19 +18,28 @@ export async function recordApproval(root, stage, approver, expectedArtifactSha2
     if (!/^[a-f0-9]{64}$/.test(expectedArtifactSha256)) {
         throw new Error('Expected approval artifact SHA-256 must be 64 lowercase hexadecimal characters.');
     }
-    await validateStageArtifacts(root, stage);
-    const requiredApproval = { mode: 'required' };
-    if (stage === 'design' || stage === 'release')
-        await requireApproval(root, 'requirements', requiredApproval);
+    requireDomainOption(config, stage, domainName);
+    const resolved = domainsConfigured(config) ? await resolveDomains(root, config) : [];
+    const domain = domainName ? resolved.find((d) => d.name === domainName) : undefined;
+    await validateStageArtifacts(root, stage, domain);
+    const requiredApproval = { mode: 'required', domains: [] };
+    if (stage === 'design') {
+        await requireApproval(root, 'requirements', requiredApproval, domain);
+    }
     if (stage === 'release') {
-        await requireApproval(root, 'design', requiredApproval);
+        for (const d of resolved) {
+            await requireApproval(root, 'requirements', requiredApproval, d);
+            await requireApproval(root, 'design', requiredApproval, d);
+        }
+        if (!resolved.length)
+            await requireApproval(root, 'design', requiredApproval);
         const quality = await runGate(root);
         const blockers = quality.checks.filter((check) => check.name !== 'approval' && check.required && check.status !== 'pass');
         if (blockers.length) {
             throw new Error(`Release approval requires passing non-approval quality checks: ${blockers.map((check) => check.name).join(', ')}.`);
         }
     }
-    const manifest = await approvalManifest(root, stage);
+    const manifest = await approvalManifest(root, stage, domain);
     if (!Object.keys(manifest.artifacts).length)
         throw new Error(`No artifacts are available for ${stage} approval.`);
     if (manifest.artifactSha256 !== expectedArtifactSha256) {
@@ -37,7 +51,7 @@ export async function recordApproval(root, stage, approver, expectedArtifactSha2
         approver: normalizedApprover,
         approvedAt: new Date().toISOString(),
     };
-    await writeJson(root, `.musubix/evidence/approvals/${stage}.json`, evidence);
+    await writeJson(root, approvalPath(stage, domainName), evidence);
     return evidence;
 }
 //# sourceMappingURL=approval-record.js.map

package/dist/packages/analysis/src/approval-record.js.map

@@ -1 +1 @@
-{"version":3,"file":"approval-record.js","sourceRoot":"","sources":["../../../../packages/analysis/src/approval-record.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,GAE1D,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,KAAoB,EACpB,QAAgB,EAChB,sBAA8B;IAE9B,MAAM,kBAAkB,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1C,MAAM,gBAAgB,GAAmB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9D,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC7G,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC/C,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAC1E,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,kEAAkE,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvI,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,YAAY,CAAC,CAAC;IAClH,IAAI,QAAQ,CAAC,cAAc,KAAK,sBAAsB,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,gDAAgD,sBAAsB,aAAa,QAAQ,CAAC,cAAc,iDAAiD,CAAC,CAAC;IAC/K,CAAC;IACD,MAAM,QAAQ,GAAqB;QACjC,aAAa,EAAE,CAAC;QAChB,GAAG,QAAQ;QACX,QAAQ,EAAE,kBAAkB;QAC5B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;IACF,MAAM,SAAS,CAAC,IAAI,EAAE,+BAA+B,KAAK,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7E,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"approval-record.js","sourceRoot":"","sources":["../../../../packages/analysis/src/approval-record.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EACvF,cAAc,EAAE,sBAAsB,GAEvC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,KAAoB,EACpB,QAAgB,EAChB,sBAA8B,EAC9B,MAAsB,EACtB,UAAmB;IAEnB,MAAM,kBAAkB,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IACD,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,MAAM,MAAM,GAA+B,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChH,MAAM,sBAAsB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAmB,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC3E,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;YACjE,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAC9E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC/C,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAC1E,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,kEAAkE,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvI,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,YAAY,CAAC,CAAC;IAClH,IAAI,QAAQ,CAAC,cAAc,KAAK,sBAAsB,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,gDAAgD,sBAAsB,aAAa,QAAQ,CAAC,cAAc,iDAAiD,CAAC,CAAC;IAC/K,CAAC;IACD,MAAM,QAAQ,GAAqB;QACjC,aAAa,EAAE,CAAC;QAChB,GAAG,QAAQ;QACX,QAAQ,EAAE,kBAAkB;QAC5B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;IACF,MAAM,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/packages/analysis/src/approval.d.ts

@@ -1,10 +1,14 @@
 import { type Diagnostic } from '../../domain/src/index.js';
 import type { ApprovalConfig } from './config.js';
+import { type ResolvedDomain } from './approval-domains.js';
+export { domainsConfigured, domainOwning, featureOwningDesignFile, featureOwningRequirement, resolveDomains, type ResolvedDomain, } from './approval-domains.js';
 export declare const approvalStages: readonly ["requirements", "design", "release"];
 export type ApprovalStage = typeof approvalStages[number];
 export type ApprovalStatus = 'approved' | 'missing' | 'stale';
 export interface ApprovalManifest {
     stage: ApprovalStage;
+    domain?: string;
+    features?: string[];
     artifacts: Record<string, string>;
     artifactSha256: string;
 }
@@ -15,6 +19,7 @@ export interface ApprovalEvidence extends ApprovalManifest {
 }
 export interface ApprovalStageValidation {
     stage: ApprovalStage;
+    domain?: string;
     required: boolean;
     present: boolean;
     status: ApprovalStatus;
@@ -22,27 +27,84 @@ export interface ApprovalStageValidation {
     currentArtifactSha256: string;
     diagnostics: Diagnostic[];
 }
+export interface DomainApprovalValidation {
+    name: string;
+    stages: ApprovalStageValidation[];
+}
 export interface ApprovalValidation {
     schemaVersion: 1;
     mode: ApprovalConfig['mode'];
     present: boolean;
     valid: boolean;
     stages: ApprovalStageValidation[];
+    domain?: string;
+    domains?: DomainApprovalValidation[];
+    release?: ApprovalStageValidation;
     diagnostics: Diagnostic[];
 }
+export declare function approvalPath(stage: ApprovalStage, domain?: string): string;
 /** @id CODE-HUMAN-APPROVAL-GATES-001
  * @implements REQ-HUMAN-APPROVAL-GATES-001 REQ-HUMAN-APPROVAL-GATES-002 REQ-HUMAN-APPROVAL-GATES-003
  * @implements REQ-HUMAN-APPROVAL-GATES-004 REQ-HUMAN-APPROVAL-GATES-005 REQ-HUMAN-APPROVAL-GATES-006
  * @implements REQ-HUMAN-APPROVAL-GATES-007 REQ-HUMAN-APPROVAL-GATES-008
  * @design DES-APPROVAL-001 DES-APPROVAL-002 DES-APPROVAL-003
  */
-export declare function approvalManifest(root: string, stage: ApprovalStage): Promise<ApprovalManifest>;
-export declare function loadApproval(root: string, stage: ApprovalStage): Promise<ApprovalEvidence | null>;
-export declare function validateApprovalStage(root: string, stage: ApprovalStage, config: ApprovalConfig): Promise<ApprovalStageValidation>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-007
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-011 REQ-APPROVAL-DOMAIN-SCOPING-012 REQ-APPROVAL-DOMAIN-SCOPING-013
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-014 REQ-APPROVAL-DOMAIN-SCOPING-023 REQ-APPROVAL-DOMAIN-SCOPING-024
+ * @design DES-APPROVAL-DOMAIN-SCOPING-003
+ */
+export declare function approvalManifest(root: string, stage: ApprovalStage, domain?: ResolvedDomain): Promise<ApprovalManifest>;
+export declare function loadApproval(root: string, stage: ApprovalStage, domain?: string): Promise<ApprovalEvidence | null>;
+export declare function validateApprovalStage(root: string, stage: ApprovalStage, config: ApprovalConfig, domain?: ResolvedDomain): Promise<ApprovalStageValidation>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-004
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-008 REQ-APPROVAL-DOMAIN-SCOPING-021 REQ-APPROVAL-DOMAIN-SCOPING-022
+ * @design DES-APPROVAL-DOMAIN-SCOPING-004
+ */
 export declare function validateApprovals(root: string, config: ApprovalConfig): Promise<ApprovalValidation>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-008
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-009 REQ-APPROVAL-DOMAIN-SCOPING-010
+ * @design DES-APPROVAL-DOMAIN-SCOPING-004
+ */
+export declare function validateApprovalsForDomain(root: string, config: ApprovalConfig, domainName: string): Promise<ApprovalValidation>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-006
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-019 REQ-APPROVAL-DOMAIN-SCOPING-020
+ * @design DES-APPROVAL-DOMAIN-SCOPING-006
+ */
+export declare function validateApprovalsForFeatureGate(root: string, config: ApprovalConfig, domainName: string): Promise<ApprovalValidation>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-009
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-005 REQ-APPROVAL-DOMAIN-SCOPING-006 REQ-APPROVAL-DOMAIN-SCOPING-007
+ * @design DES-APPROVAL-DOMAIN-SCOPING-004
+ */
+export declare function requireDomainOption(config: ApprovalConfig, stage: ApprovalStage, domain: string | undefined): void;
+export declare function requireValidateDomainOption(config: ApprovalConfig, domain: string | undefined): void;
 /** @id CODE-CLI-WORKFLOW-UX-003
  * @implements REQ-CLI-WORKFLOW-UX-003
  * @design DES-CLI-WORKFLOW-UX-003
  */
-export declare function requireApproval(root: string, stage: ApprovalStage, config: ApprovalConfig): Promise<void>;
-export declare function validateStageArtifacts(root: string, stage: ApprovalStage): Promise<void>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-005
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-016 REQ-APPROVAL-DOMAIN-SCOPING-017 REQ-APPROVAL-DOMAIN-SCOPING-018
+ * @design DES-APPROVAL-DOMAIN-SCOPING-005
+ */
+export declare function requireApproval(root: string, stage: ApprovalStage, config: ApprovalConfig, domain?: ResolvedDomain): Promise<void>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-010
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-016 REQ-APPROVAL-DOMAIN-SCOPING-017 REQ-APPROVAL-DOMAIN-SCOPING-018
+ * @design DES-APPROVAL-DOMAIN-SCOPING-005
+ */
+export declare function resolveOwningDomainOrThrow(root: string, config: ApprovalConfig, slug: string): Promise<ResolvedDomain | undefined>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-011
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-005 REQ-APPROVAL-DOMAIN-SCOPING-013
+ * @design DES-APPROVAL-DOMAIN-SCOPING-004
+ */
+export declare function resolveNamedDomain(root: string, config: ApprovalConfig, domainName: string): Promise<ResolvedDomain>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-012
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-017
+ * @design DES-APPROVAL-DOMAIN-SCOPING-005
+ */
+export declare function resolveDesignFileDomain(root: string, config: ApprovalConfig, file: string): Promise<ResolvedDomain | undefined>;
+/** @id CODE-APPROVAL-DOMAIN-SCOPING-013
+ * @implements REQ-APPROVAL-DOMAIN-SCOPING-016
+ * @design DES-APPROVAL-DOMAIN-SCOPING-005
+ */
+export declare function resolveRequirementDomain(root: string, config: ApprovalConfig, requirementId: string): Promise<ResolvedDomain | undefined>;
+export declare function validateStageArtifacts(root: string, stage: ApprovalStage, domain?: ResolvedDomain): Promise<void>;