@rsaglobaltech/specgate 0.27.9 → 1.0.0-rc.2

package/CHANGELOG.md

@@ -9,6 +9,63 @@ The release process is in [`docs/release-process.md`](docs/release-process.md).
 
 ## [Unreleased]
 
+## [1.0.0-rc.2] — 2026-10-30
+
+After the first microservices run of truck-flote (five repositories, one story across three of them, nine requirements delivered in parallel): the workspace takes the client's brief and drafts its stories, a story's intent and criteria reach every repository, the story is built in the order of its dependencies, and `init --yes` adopts the folder it is run in.
+
+### Breaking
+
+- **`specgate init --yes` adopts a folder that already has code** (REQ-249, modified): it scaffolded a separate project inside it (`my-spec-driven-app/`), so a scripted `init` in a repository made a second one. `--yes` now only skips the questions; `--new`, `--out`, `--config`, `--multi-stack` and `--forja` still scaffold.
+
+### Fixed
+
+- **`change validate` reports what `change approve` refuses** (REQ-350): a layered change validated, then approval refused it for requirements with no kind. Validation now fails with `change_not_approvable` for each finding approval would block on.
+- **The agent writing a change's requirements is told what they need** (REQ-351): `kind=`, `actor=`, and a feature file of its own.
+- **Two requirements naming one feature file are reported** (REQ-352): `change validate` and `change archive` refuse with `change_feature_shared`; archiving would have kept only one's scenarios.
+- **A delivered requirement ticks its tasks** (REQ-353): `done`, which the harness runs, ticks the tasks of the open change that name the requirement.
+- **`change --help` describes the three layers** (REQ-354), and docs/migrating-to-1.0.md says how to install a candidate just published (`--prefer-online`) and how to move a forja project to it.
+- **The workspace takes the client's brief** (REQ-339..341): `specgate workspace draft` puts a root `brief.md` below a front matter that names the brief's stories and their repositories, `workspace draft <story> --agent "<cmd>"` drafts a story's intent and criteria from the brief, confined to the story, and `specgate status` in a workspace repository shows the workspace and the next step instead of failing on a missing matrix.
+- **Every repository receives the story** (REQ-342..344): `workspace propose` takes a drafted story, copies its intent and criteria into each sub-change's `discover.md` and names the story's other repositories and how to write `depends=` and `api=`; `workspace check` warns `workspace_story_diverged` when a repository's criteria are not the story's; each harness is told the story's other parts.
+- **A story is built in dependency order** (REQ-345): `workspace harness run --story` starts a repository whose part waits on another's undelivered requirement after that repository has finished; the dry run shows the levels.
+- **The live view and the story's cost** (REQ-346, REQ-347): every JSON document of the studio says `charset=utf-8`, and a story's cost counts its archived parts.
+- **Short repository names, and the logs ignored** (REQ-348, REQ-349): `workspace init` names `truck-flote-fleet` as `fleet`, prints name, path and role in their own columns, and ignores `.specgate/workspace-runs/`.
+
+## [1.0.0-rc.1] — 2026-10-30
+
+The first candidate of the 1.0 line, for teams of several repositories and roles: a change in three layers with their owners, a workspace of repositories with stories across them and its own live view, approvals per layer and harness packages per role, the backlog following the phases, the two gaps measured, principles, drift and API contracts checked, and `specgate migrate 1.0` to move a 0.27 project. Published under the npm dist-tag `next`; `latest` stays 0.27. See [Migrating to 1.0](docs/migrating-to-1.0.md).
+
+### Breaking
+
+- **`depends=<repo>:REQ-NNN` is a dependency on another repository** (REQ-294): inside a repository it is no longer an `unknown_dependency`; the workspace judges it.
+- **A change has three layers, each with its owner** (REQ-282..REQ-289, ADR-0042): `change new`, `propose`, `propose --from-brief` and `--from-ticket` write `discover.md` (product: context, use case, acceptance criteria `- AC-1: …`), `design.md` (architect) and `tasks.md` (developer) under the new `layered` schema, and no longer write `proposal.md`. `change new --schema spec-driven` keeps the 0.27 layout. A change written with 0.27 stays valid: its `proposal.md` is read as its Discover, and a missing `design.md` is a warning naming `specgate migrate 1.0`.
+- **`depends=<repo>:REQ-NNN` is a dependency on another repository** (REQ-294): inside a repository it is no longer an `unknown_dependency`; the workspace judges it.
+- **A 1.0 change is built once it is approved** (REQ-315, ADR-0043): `harness run` skips a requirement of an open change of the `layered` schema until every written layer has its approvals, with `harness_not_approved`. `approvals: { required: never }` in `harness.config.yaml` keeps the 0.27 behaviour, `always` asks it of 0.27 changes too.
+- **A change has three layers, each with its owner** (REQ-282..REQ-289, ADR-0042): `change new`, `propose`, `propose --from-brief` and `--from-ticket` write `discover.md` (product: context, use case, acceptance criteria `- AC-1: …`), `design.md` (architect) and `tasks.md` (developer) under the new `layered` schema, and no longer write `proposal.md`. `change new --schema spec-driven` keeps the 0.27 layout. A change written with 0.27 stays valid: its `proposal.md` is read as its Discover, and a missing `design.md` is a warning naming `specgate migrate 1.0`.
+
+### Added
+
+- **`specgate migrate 1.0`** (REQ-325..REQ-329): on a committed 0.27 project, moves each open change into the three layers — `proposal.md` to `discover.md` word for word, a `design.md` drafted from it, `tasks.md` kept, `schema: layered` — never touching the archive, and writes `docs/specs/migration-1.0.md` with what it did and what is left to a person. `--dry-run` changes nothing and prints the same report; a second run does nothing; a dirty tree is refused. `specgate status` names the command while an open change is still written for 0.27. Every breaking change, and how to stay on 0.27: [Migrating to 1.0](docs/migrating-to-1.0.md).
+- **The workspace, live** (REQ-320..REQ-324): `specgate studio` in a workspace repository serves its `/live` — a panel per repository with the requirement in flight, its gate step and the agent's last step; each story with its parts open, building, archived or missing, and the parts waiting on another repository's undelivered requirement named; the cost per repository and per story. `specgate workspace harness run --story <id>` starts every repository's harness for its part at once, and none when one repository's base already fails the gate. `workspace live --json` prints the model.
+- **The organization's principles** (REQ-330..REQ-332): `docs/specs/principles.md` with `principles_version` and `source` (a principles file, or `pack:<pack_id>` when a domain pack delivers it). `specgate check` names the version and warns `principles_behind` when the source has a newer one; a principle with `run=` or `forbid=` … `in=` is checked by the gate (`principle_failed`; `level=warn` for advice).
+- **Behaviour changed without a specification** (REQ-333, REQ-334): `check` warns `spec_drift` for each commit since the base that changes production code and names no requirement in its message or in a test it changes; `specgate drift` reports it for CI, and `drift: gate` in harness.config.yaml fails both.
+- **A requirement points at an API operation** (REQ-335, REQ-336): `api=` in its trace comment, a JSON pointer or an operationId of an OpenAPI or AsyncAPI contract; `validate` fails when it does not resolve, and `specgate contract check` lists the operations no requirement cites.
+- **`specgate adopt --scope <path>`** (REQ-337, REQ-338): specify one area of a large repository; adoption warns `adopt_too_big` when it finds more areas than the eight it proposes.
+- **The two gaps** (REQ-300..REQ-304): `harness report` says, for each requirement that needed rework, whether the spec was clear and the code diverged (spec → implementation) or the spec missed part of the use case (intent → spec). It suggests one from what it recorded — a rejection the agent fixed, naming the check that caught it; an answered question, a review note or a modified delta — and a person sets it with `--classify REQ-NNN --gap spec-impl|intent-spec --reason "..."`. The report shows both shares overall and per module and what to strengthen; the studio's report shows both shares. The run ledger now records the gate stage that rejected each attempt.
+- **The board follows the change** (REQ-305): `alm sync` moves each change's ticket — its `ticket:` or `origin: alm:<key>` — to the state of its phase: `proposed`, `building` once a requirement has a `harness/REQ-NNN` branch or is Implemented, `archived`. Each provider has a default (Jira status category, Azure Boards state, a GitHub label or a closed issue, a Linear state type) and `phases:` in `alm.config.yaml` names a board's own. A move already made is not made again (`.specops/alm-phases.json`), and `--dry-run` prints each move. `mirror: false` keeps `alm sync` from creating an issue per requirement where the tickets are the source.
+- **What the ticket gains comes back as notes** (REQ-306): `alm pull` brings each open change's new comments, and a note when the ticket's description changed, into its `review.md` — never into the proposal or the delta.
+- **One sub-issue per repository** (REQ-307): a change that lists `repositories:` gets a sub-issue of its ticket for each, created once.
+- **Linear** (REQ-308), a fourth built-in provider through its GraphQL API: `team_key` and `token_env`.
+- **`alm phase` and `alm move`** (REQ-309): where a change stands, without the network, and its ticket moved there now; both are MCP tools (`specgate_alm_phase`, `specgate_alm_move`). New provider capabilities (`phase`, `subIssues`, `comments`, `readText`) are optional, so a community provider written for 0.27 still loads.
+- **A workspace of repositories** (REQ-290..298, ADR-0041): `specgate.workspace.yaml` names the repositories of one product, and `specgate workspace init|status|check|propose` say where the product stands, run every repository's gate at once, resolve ids qualified with their repository (`tracking:REQ-012`), hold a requirement back until the one it depends on in another repository is delivered, and split a business story into a change in each repository it touches — done when every one is archived. See [docs/workspace.md](docs/workspace.md).
+- **Roles and an approval per layer** (REQ-310..REQ-315, REQ-319, ADR-0043): `roles:` in `harness.config.yaml` names who holds each role; `change approve <id> --layer discover|design|tasks` records an approval by the layer's owner — product, architect, developer — with `approvals.quorum` for how many people a layer needs. Each approval goes in the change's `approvals.json` with a hash of the layer, kept in the archive; editing an approved layer asks for its approval again. The studio's Review shows each layer's approvals and approves the layer the viewer owns.
+- **Role packages** (REQ-316..REQ-318, ADR-0043): `harness/<role>.md`, with `applies-to` by kind, capability or tag, reaches the prompt of the requirements it concerns under "Role constraints"; the prompt event, the run record, the live view and `harness report` name each package as `role@version`, and the review check gives one line of advice per package.
+- **The layer rules** (REQ-284..REQ-287): `change validate` warns when the Discover names a technology, when the design does not answer an acceptance criterion, when a task names no requirement, and when the Discover differs from the version it was agreed at. `change validate --strict` fails on them.
+- **The layers are named where people look** (REQ-288, REQ-289): `change status` lists discover, specs, design and tasks with their owner ("Write discover.md (product)"), the drafting guides say which layer the agent writes, and the studio's review lists each layer with its owner and whether it is written.
+
+### Fixed
+
+- **A release candidate is never installed by default** (REQ-281): every publish workflow treated a pushed `v*` tag as `latest`, so a `v1.0.0-rc.1` would have become the default `npm install` and the `latest` image. A version with a prerelease part is now published under the dist-tag `next`, and its image is tagged with its version only.
+
 ## [0.27.9] — 2026-10-29
 
 After the seventh truck-flote run: the harness checks Docker before it starts, the report names scenarios as the spec does, a date is one value, and the kept agent is seen live.

package/dist/packages/core/src/application/ValidateChangeUseCase.js

@@ -37,6 +37,7 @@ exports.ValidateChangeUseCase = void 0;
 const path = __importStar(require("node:path"));
 const DeltaSpec_1 = require("../domain/DeltaSpec");
 const Diagnostic_1 = require("../domain/Diagnostic");
+const ChangeLayers_1 = require("../domain/ChangeLayers");
 /**
  * Is this change well-formed?
  *
@@ -55,10 +56,25 @@ class ValidateChangeUseCase {
         const paths = this.projectRepo.getPaths();
         const diagnostics = [];
         const config = this.projectRepo.readConfig(changeId);
-        if (this.projectRepo.readFile(path.join(paths.change(changeId), "proposal.md")) === null) {
-            diagnostics.push((0, Diagnostic_1.error)("missing_proposal", `Change "${changeId}" has no proposal.md.`, {
+        // ADR-0042: the Discover is discover.md; a 0.27 change's is its proposal.
+        const dir = paths.change(changeId);
+        const read = (f) => this.projectRepo.readFile(path.join(dir, f));
+        const discoverFile = read("discover.md") !== null ? "discover.md" : ChangeLayers_1.LEGACY_DISCOVER;
+        const discover = read(discoverFile);
+        if (discover === null) {
+            const wanted = config.schema === ChangeLayers_1.LAYERED_SCHEMA ? "discover.md" : ChangeLayers_1.LEGACY_DISCOVER;
+            diagnostics.push((0, Diagnostic_1.error)("missing_proposal", `Change "${changeId}" has no ${wanted}.`, {
                 target: changeId,
-                fix: `Create ${path.join("docs/specs/changes", changeId, "proposal.md")}.`,
+                fix: `Create ${path.join("docs/specs/changes", changeId, wanted)}.`,
+            }));
+        }
+        else {
+            diagnostics.push(...(0, ChangeLayers_1.checkLayers)({
+                changeId,
+                discover,
+                discoverFile,
+                design: read("design.md"),
+                tasks: read("tasks.md"),
             }));
         }
         const deltas = this.projectRepo.listDeltas(changeId);

package/dist/packages/core/src/application/ValidateChangeUseCase.js.map

@@ -1 +1 @@
-{"version":3,"file":"ValidateChangeUseCase.js","sourceRoot":"","sources":["../../../../../packages/core/src/application/ValidateChangeUseCase.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAElC,mDAAgD;AAChD,qDAAkE;AAclE;;;;;;;;GAQG;AACH,MAAa,qBAAqB;IACZ;IAApB,YAAoB,WAA+B;QAA/B,gBAAW,GAAX,WAAW,CAAoB;IAAG,CAAC;IAEhD,OAAO,CAAC,QAAgB,EAAE,OAA8B,EAAE;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAiB,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAErD,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzF,WAAW,CAAC,IAAI,CACd,IAAA,kBAAK,EAAC,kBAAkB,EAAE,WAAW,QAAQ,uBAAuB,EAAE;gBACpE,MAAM,EAAE,QAAQ;gBAChB,GAAG,EAAE,UAAU,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,EAAE,aAAa,CAAC,GAAG;aAC3E,CAAC,CACH,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC9C,WAAW,CAAC,IAAI,CACd,IAAA,oBAAO,EAAC,WAAW,EAAE,WAAW,QAAQ,2BAA2B,EAAE;gBACnE,MAAM,EAAE,QAAQ;gBAChB,GAAG,EAAE,wEAAwE;aAC9E,CAAC,CACH,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1D,IAAI,WAAW,KAAK,IAAI;gBAAE,SAAS;YACnC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,GAAG,qBAAS,CAAC,QAAQ,CAAC,WAAW,EAAE;gBACzD,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC7E,IAAI,EAAE,KAAK,CAAC,QAAQ;gBACpB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAC9D,CAAC;CACF;AAxCD,sDAwCC"}
+{"version":3,"file":"ValidateChangeUseCase.js","sourceRoot":"","sources":["../../../../../packages/core/src/application/ValidateChangeUseCase.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/domain/ApiContract.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * The operations of an interface contract, and how a requirement's `api=`
+ * reference resolves against them (REQ-335, REQ-336).
+ *
+ * OpenAPI (`paths:` → path → method, with its operationId) and AsyncAPI (2.x
+ * `channels:` → channel → publish/subscribe; 3.x `operations:`), in JSON or in
+ * YAML. The YAML is read by indentation for the few keys that matter, not by a
+ * full YAML parser: a contract is many things, and only its operations are ours.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pointerSegment = pointerSegment;
+exports.contractKind = contractKind;
+exports.contractOperations = contractOperations;
+exports.parseApiRef = parseApiRef;
+exports.resolveApiRef = resolveApiRef;
+const METHODS = new Set(["get", "put", "post", "delete", "patch", "options", "head", "trace"]);
+const ASYNC_OPS = new Set(["publish", "subscribe"]);
+/** A pointer segment: `~` and `/` escaped as RFC 6901 says. */
+function pointerSegment(key) {
+    return key.replace(/~/g, "~0").replace(/\//g, "~1");
+}
+/** `openapi`, `asyncapi`, or null when the text is neither. */
+function contractKind(text) {
+    if (/^\s*\{/.test(text)) {
+        try {
+            const doc = JSON.parse(text);
+            return doc.openapi || doc.swagger ? "openapi" : doc.asyncapi ? "asyncapi" : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    if (/^(openapi|swagger)\s*:/m.test(text))
+        return "openapi";
+    if (/^asyncapi\s*:/m.test(text))
+        return "asyncapi";
+    return null;
+}
+/** The mapping keys of a YAML document as a tree, by indentation. */
+function yamlTree(text) {
+    const root = { key: "", value: "", indent: -1, children: [] };
+    const stack = [root];
+    for (const raw of text.split(/\r?\n/)) {
+        if (!raw.trim() || /^\s*#/.test(raw) || /^\s*-/.test(raw))
+            continue;
+        const m = /^(\s*)("(?:[^"\\]|\\.)*"|'[^']*'|[^:#][^:]*?)\s*:(?:\s+(.*))?$/.exec(raw);
+        if (!m)
+            continue;
+        const indent = m[1].length;
+        const key = m[2].replace(/^"(.*)"$|^'(.*)'$/, (_s, a, b) => (a !== undefined ? a : b));
+        const node = {
+            key,
+            value: (m[3] || "").trim().replace(/^["']|["']$/g, ""),
+            indent,
+            children: [],
+        };
+        while (stack.length > 1 && stack[stack.length - 1].indent >= indent)
+            stack.pop();
+        stack[stack.length - 1].children.push(node);
+        stack.push(node);
+    }
+    return root.children;
+}
+function toTree(nodes) {
+    const out = {};
+    for (const n of nodes)
+        out[n.key] = n.children.length ? toTree(n.children) : n.value;
+    return out;
+}
+function asTree(v) {
+    return v && typeof v === "object" ? v : {};
+}
+/** Every operation the contract declares, in document order. */
+function contractOperations(text, _file = "") {
+    const kind = contractKind(text);
+    if (!kind)
+        return [];
+    let doc;
+    if (/^\s*\{/.test(text)) {
+        try {
+            doc = JSON.parse(text);
+        }
+        catch {
+            return [];
+        }
+    }
+    else {
+        doc = toTree(yamlTree(text));
+    }
+    const ops = [];
+    const id = (v) => typeof asTree(v).operationId === "string" ? String(asTree(v).operationId) : "";
+    if (kind === "openapi") {
+        for (const [p, item] of Object.entries(asTree(doc.paths))) {
+            for (const [method, op] of Object.entries(asTree(item))) {
+                if (!METHODS.has(method.toLowerCase()))
+                    continue;
+                ops.push({
+                    kind,
+                    pointer: `/paths/${pointerSegment(p)}/${method}`,
+                    label: `${method.toUpperCase()} ${p}`,
+                    operationId: id(op),
+                });
+            }
+        }
+        return ops;
+    }
+    for (const [channel, item] of Object.entries(asTree(doc.channels))) {
+        for (const [verb, op] of Object.entries(asTree(item))) {
+            if (!ASYNC_OPS.has(verb))
+                continue;
+            ops.push({
+                kind,
+                pointer: `/channels/${pointerSegment(channel)}/${verb}`,
+                label: `${verb} ${channel}`,
+                operationId: id(op),
+            });
+        }
+    }
+    for (const [key, op] of Object.entries(asTree(doc.operations))) {
+        ops.push({
+            kind,
+            pointer: `/operations/${pointerSegment(key)}`,
+            label: key,
+            operationId: id(op) || key,
+        });
+    }
+    return ops;
+}
+function parseApiRef(ref) {
+    const hash = ref.indexOf("#");
+    return hash < 0
+        ? { file: "", target: ref.trim() }
+        : { file: ref.slice(0, hash).trim(), target: ref.slice(hash + 1).trim() };
+}
+/** Resolve `ref` against the contracts, keyed by their project-relative path. */
+function resolveApiRef(ref, contracts) {
+    const { file, target } = parseApiRef(ref);
+    const matches = (op) => target.startsWith("/") ? op.pointer === target : op.operationId === target;
+    if (file) {
+        const norm = file.replace(/\\/g, "/").replace(/^\.\//, "");
+        const ops = contracts[norm];
+        if (!ops)
+            return { ok: false, reason: "contract_missing", file: norm };
+        const op = ops.find(matches);
+        return op
+            ? { ok: true, file: norm, operation: op }
+            : { ok: false, reason: "operation_missing", file: norm };
+    }
+    for (const [f, ops] of Object.entries(contracts)) {
+        const op = ops.find(matches);
+        if (op)
+            return { ok: true, file: f, operation: op };
+    }
+    return { ok: false, reason: "operation_missing", file: "" };
+}
+//# sourceMappingURL=ApiContract.js.map

package/dist/packages/core/src/domain/ApiContract.js.map

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

package/dist/packages/core/src/domain/Approvals.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Roles and approvals per layer (REQ-310..315, ADR-0043).
+ *
+ * Pure: who holds a role, what an approval of a layer is worth against the
+ * layer's current text, and whether a change is approved. Reading the config,
+ * the git identity and `approvals.json` is the caller's.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readApprovalSettings = readApprovalSettings;
+exports.holdsRole = holdsRole;
+exports.rolesHeld = rolesHeld;
+exports.contentHash = contentHash;
+exports.layerApprovals = layerApprovals;
+exports.approvalsRequired = approvalsRequired;
+exports.changeApproved = changeApproved;
+const node_crypto_1 = require("node:crypto");
+const ChangeLayers_1 = require("./ChangeLayers");
+const REQUIRED = ["layered", "always", "never"];
+const asList = (v) => Array.isArray(v)
+    ? v.map((x) => String(x).trim()).filter(Boolean)
+    : v === undefined || v === null || v === ""
+        ? []
+        : [String(v).trim()];
+/**
+ * The settings from the parsed `roles:` and `approvals:` of
+ * `harness.config.yaml`. Throws on a value it cannot read, naming it.
+ */
+function readApprovalSettings(parsed) {
+    const roles = {};
+    const rawRoles = parsed.roles;
+    if (rawRoles !== undefined && rawRoles !== null) {
+        if (typeof rawRoles !== "object" || Array.isArray(rawRoles)) {
+            throw new Error("roles: must map each role to the people who hold it");
+        }
+        for (const [role, who] of Object.entries(rawRoles)) {
+            roles[role.trim()] = asList(who);
+        }
+    }
+    const raw = (parsed.approvals || {});
+    if (typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error("approvals: must be a mapping (required, quorum)");
+    }
+    const required = String(raw.required ?? "layered").trim();
+    if (!REQUIRED.includes(required)) {
+        throw new Error(`approvals.required: '${required}' is not one of ${REQUIRED.join(", ")}`);
+    }
+    const quorum = {};
+    for (const [layer, n] of Object.entries((raw.quorum || {}))) {
+        if (!ChangeLayers_1.LAYERS.some((l) => l.id === layer)) {
+            throw new Error(`approvals.quorum.${layer}: not a layer (discover, design, tasks)`);
+        }
+        const count = Number(n);
+        if (!Number.isInteger(count) || count < 1) {
+            throw new Error(`approvals.quorum.${layer}: '${n}' is not a whole number of people`);
+        }
+        quorum[layer] = count;
+    }
+    return { roles, required, quorum };
+}
+const norm = (s) => s.trim().toLowerCase();
+/** Whether the person is one of a role's entries: their email or their name. */
+function named(entries, who) {
+    const mine = [who.email, who.name].filter(Boolean).map(norm);
+    return entries.some((e) => mine.includes(norm(e)));
+}
+/** Whether the person holds the role. A role nobody is named for is open to anyone. */
+function holdsRole(settings, role, who) {
+    const entries = settings.roles[role];
+    if (!entries || entries.length === 0)
+        return true;
+    return named(entries, who);
+}
+/** Every role the person holds: the ones naming them, and the ones naming nobody. */
+function rolesHeld(settings, who) {
+    const roles = new Set([...ChangeLayers_1.LAYERS.map((l) => l.owner), ...Object.keys(settings.roles)]);
+    return [...roles].filter((r) => holdsRole(settings, r, who)).sort();
+}
+/** The hash an approval is of: line endings do not count, the text does. */
+function contentHash(text) {
+    return `sha256:${(0, node_crypto_1.createHash)("sha256").update(text.replace(/\r\n/g, "\n")).digest("hex")}`;
+}
+const personKey = (who) => norm(who.email || who.name);
+/** What each layer's approvals are worth against its current text. */
+function layerApprovals(layers, records, settings) {
+    return layers.map((l) => {
+        const hash = l.text === null ? "" : contentHash(l.text);
+        const mine = records.filter((r) => r.layer === l.id);
+        const current = [];
+        const seen = new Set();
+        for (const r of mine) {
+            if (r.hash !== hash)
+                continue;
+            const key = personKey(r.by);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            current.push(r);
+        }
+        const stale = mine.filter((r) => r.hash !== hash);
+        const quorum = settings.quorum[l.id] || 1;
+        return {
+            layer: l.id,
+            owner: l.owner,
+            file: l.file,
+            present: l.text !== null,
+            quorum,
+            approvals: current,
+            stale,
+            approved: l.text !== null && current.length >= quorum,
+        };
+    });
+}
+/** Whether a change of this schema needs its approvals before it is built (REQ-315). */
+function approvalsRequired(schema, settings) {
+    if (settings.required === "never")
+        return false;
+    if (settings.required === "always")
+        return true;
+    return schema === "layered";
+}
+/** A change is approved when every written layer is, and at least one is written. */
+function changeApproved(layers) {
+    const present = layers.filter((l) => l.present);
+    return present.length > 0 && present.every((l) => l.approved);
+}
+//# sourceMappingURL=Approvals.js.map

package/dist/packages/core/src/domain/Approvals.js.map

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