@clossys/writer 0.3.8 → 0.3.9

package/CHANGELOG.md

@@ -3,6 +3,29 @@
 All notable changes to this package are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.3.9] - 2026-09-18
+
+### Added
+
+- Documented installation against the public npm registry
+  (`https://registry.npmjs.org`) and that installing needs no authentication.
+- Stated the charter close condition in the README: independent consumer
+  evidence of `approved copy coverage rate`, computed by
+  `assessApprovedCopyCoverageRate()`. An empty evaluated set is
+  indeterminate, never a perfect rate of 1. `checkCopyRecord` and
+  `checkCopyTraceability` remain the gates they are; neither is this rate.
+- Declared `foundry.assessment` against a new mapped `writer-rate-check`
+  bin with `invocation: "single-json-input"`. `writer-check` remains the
+  multi-mode CLI and is not the assessment surface. Advisor remains the
+  only required first-day role.
+- `writer-rate-check assessment.json`: prints the `approved copy coverage
+  rate` report and exits on the `0` / `1` / `2` ternary.
+
+### Notes
+
+- This does not claim the position is closed. Qualification of `0.3.9` is
+  deferred under #833.
+
 ## [0.3.8] - 2026-09-16
 
 ### Added

package/README.md

@@ -16,6 +16,45 @@ template; each consumer supplies its own language and facts.
 npm install @clossys/writer
 ```
 
+This package is published to the public npm registry, `https://registry.npmjs.org`.
+Installing it needs no authentication: no npm token, no `.npmrc` registry
+override, and no GitHub credential of any kind.
+
+## Approved copy coverage rate
+
+Independent consumer evidence shows the position's owned metric meets its
+setpoint over the declared review cadence. The owned metric is `approved
+copy coverage rate`, computed by `assessApprovedCopyCoverageRate()`. An
+empty evaluated set is `indeterminate`, never a perfect rate of 1.
+`checkCopyRecord` and `checkCopyTraceability` remain the gates they are;
+neither is this rate. This package does not measure consumer evidence and
+does not close the loop. A green run of this package's tests is not a close.
+
+```ts
+import { assessApprovedCopyCoverageRate } from "@clossys/writer";
+
+const report = assessApprovedCopyCoverageRate(input);
+```
+
+```bash
+writer-rate-check assessment.json
+```
+
+The command prints JSON and exits `0` for satisfied, `1` for violated, and
+`2` for indeterminate, unreadable, or invalid input.
+
+This package declares that command as its first-day assessment surface in
+its own manifest:
+
+```json
+"foundry": { "assessment": { "bin": "writer-rate-check", "invocation": "single-json-input" } }
+```
+
+Onboarding discovers that declaration from the installed manifest and never
+infers a surface. `writer-check` remains the multi-mode CLI and is not the
+assessment surface. Writer is not a required first-day role; Advisor
+remains the only required first-day assessment.
+
 ## Public entry points
 
 - `@clossys/writer` exposes both voice and copy-record APIs.
@@ -613,6 +652,10 @@ The root entry point exports the copy registry and traceability surface:
   `PathExclusionFindingRule`, and `PathExclusionValidation`.
 - Traceability: `checkCopyTraceability`, `CopyGateFinding`,
   `CopyGateIgnored`, `CopyGateResult`, and `CopyGateRule`.
+- Charter close metric: `assessApprovedCopyCoverageRate`,
+  `ApprovedCopyCoverageRateAssessment`, `ApprovedCopyCoverageRateFinding`,
+  and `ApprovedCopyCoverageRateState`. Not `checkCopyRecord` or
+  `checkCopyTraceability`.
 - Addressability (see above): `scanAddressabilitySources`,
   `extractAddressabilityCandidates`, `checkAddressability`,
   `AddressabilityGateResult`, `AddressabilityPosition`,

package/dist/approved-copy-coverage-rate-cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+export declare class WriterRateCliInputError extends Error {
+}
+/** Reads caller-owned assessment evidence without treating it as validated. */
+export declare function readWriterAssessmentJson(path: string): unknown;
+/** Testable CLI dispatcher. Invalid arguments throw; the executable maps them to exit 2. */
+export declare function main(argv: readonly string[]): number;
+/** Resolves an npm/POSIX bin symlink before deciding whether this module is the entrypoint. */
+export declare function isDirectInvocation(moduleUrl: string, argvPath: string | undefined): boolean;
+//# sourceMappingURL=approved-copy-coverage-rate-cli.d.ts.map

package/dist/approved-copy-coverage-rate-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approved-copy-coverage-rate-cli.d.ts","sourceRoot":"","sources":["../src/approved-copy-coverage-rate-cli.ts"],"names":[],"mappings":";AAQA,qBAAa,uBAAwB,SAAQ,KAAK;CAAG;AAErD,+EAA+E;AAC/E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAU9D;AAED,4FAA4F;AAC5F,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CASpD;AAWD,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAO3F"}

package/dist/approved-copy-coverage-rate-cli.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { assessApprovedCopyCoverageRate } from "./approved-copy-coverage-rate.js";
+const USAGE = `Usage: writer-rate-check <assessment.json>\n\nAssess approved copy coverage rate from consumer-supplied independent observations.\nExit codes: 0 = satisfied, 1 = violated, 2 = indeterminate or unreadable.\nwriter-check remains the multi-mode CLI and is not this assessment.`;
+export class WriterRateCliInputError extends Error {
+}
+/** Reads caller-owned assessment evidence without treating it as validated. */
+export function readWriterAssessmentJson(path) {
+    const resolved = resolve(path);
+    if (!existsSync(resolved))
+        throw new WriterRateCliInputError(`assessment file "${path}" does not exist`);
+    try {
+        if (!statSync(resolved).isFile())
+            throw new WriterRateCliInputError(`assessment file "${path}" is not a file`);
+        return JSON.parse(readFileSync(resolved, "utf8"));
+    }
+    catch (cause) {
+        if (cause instanceof WriterRateCliInputError)
+            throw cause;
+        throw new WriterRateCliInputError(`assessment file "${path}" is unreadable JSON: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+}
+/** Testable CLI dispatcher. Invalid arguments throw; the executable maps them to exit 2. */
+export function main(argv) {
+    if (argv.length === 1 && (argv[0] === "--help" || argv[0] === "-h")) {
+        console.log(USAGE);
+        return 0;
+    }
+    if (argv.length !== 1)
+        throw new WriterRateCliInputError("exactly one assessment.json file is required");
+    const report = assessApprovedCopyCoverageRate(readWriterAssessmentJson(argv[0]));
+    console.log(JSON.stringify(report, null, 2));
+    return report.state === "satisfied" ? 0 : report.state === "violated" ? 1 : 2;
+}
+function run() {
+    try {
+        process.exitCode = main(process.argv.slice(2));
+    }
+    catch (cause) {
+        console.error(`writer-rate-check: ${cause instanceof Error ? cause.message : String(cause)}`);
+        process.exitCode = 2;
+    }
+}
+/** Resolves an npm/POSIX bin symlink before deciding whether this module is the entrypoint. */
+export function isDirectInvocation(moduleUrl, argvPath) {
+    if (argvPath === undefined)
+        return false;
+    try {
+        return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(resolve(argvPath));
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectInvocation(import.meta.url, process.argv[1]))
+    run();
+//# sourceMappingURL=approved-copy-coverage-rate-cli.js.map

package/dist/approved-copy-coverage-rate-cli.js.map

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

package/dist/approved-copy-coverage-rate.d.ts

@@ -0,0 +1,23 @@
+export type ApprovedCopyCoverageRateState = "satisfied" | "violated" | "indeterminate";
+export interface ApprovedCopyCoverageRateFinding {
+    readonly rule: string;
+    readonly severity: "error";
+    readonly message: string;
+    readonly path?: string;
+}
+export interface ApprovedCopyCoverageRateAssessment {
+    readonly metric: "approved copy coverage rate";
+    readonly state: ApprovedCopyCoverageRateState;
+    readonly rate: number | null;
+    readonly evaluatedCopy: number;
+    readonly approvedCoveredCopy: number;
+    readonly findings: readonly ApprovedCopyCoverageRateFinding[];
+    readonly proposedPositions: readonly unknown[];
+}
+/**
+ * Computes `approved copy coverage rate`: shipped audience-facing copy
+ * resolved from approved traceable registry entries / all shipped
+ * audience-facing copy evaluated.
+ */
+export declare function assessApprovedCopyCoverageRate(input: unknown): ApprovedCopyCoverageRateAssessment;
+//# sourceMappingURL=approved-copy-coverage-rate.d.ts.map

package/dist/approved-copy-coverage-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approved-copy-coverage-rate.d.ts","sourceRoot":"","sources":["../src/approved-copy-coverage-rate.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,6BAA6B,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,CAAC;AAEvF,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,6BAA6B,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAC9D,QAAQ,CAAC,iBAAiB,EAAE,SAAS,OAAO,EAAE,CAAC;CAChD;AAyDD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,kCAAkC,CA4GjG"}

package/dist/approved-copy-coverage-rate.js

@@ -0,0 +1,153 @@
+/**
+ * Computes the Writer charter metric `approved copy coverage rate` from
+ * consumer-supplied independent observations.
+ *
+ * This module does not invent observations and does not relabel
+ * `checkCopyRecord` or `checkCopyTraceability`. An empty evaluated set is
+ * indeterminate, never a perfect rate of 1. `writer-check` remains the
+ * multi-mode CLI.
+ */
+const METRIC = "approved copy coverage rate";
+const RESERVED_OBSERVERS = new Set(["writer", "@clossys/writer"]);
+const PROPOSED_POSITIONS = [];
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function text(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function timestamp(value) {
+    return text(value) && !Number.isNaN(Date.parse(value));
+}
+function finding(rule, message, path) {
+    return path === undefined ? { rule, severity: "error", message } : { rule, severity: "error", message, path };
+}
+function evidenceCounts(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return false;
+    return value.every((item) => record(item) && text(item.id) && text(item.description));
+}
+function reservedObserver(value) {
+    return RESERVED_OBSERVERS.has(value.trim().toLowerCase());
+}
+function report(state, evaluatedCopy, approvedCoveredCopy, rate, findings) {
+    return {
+        metric: METRIC,
+        state,
+        rate,
+        evaluatedCopy,
+        approvedCoveredCopy,
+        findings,
+        proposedPositions: PROPOSED_POSITIONS,
+    };
+}
+function isCovered(entry) {
+    return entry.approved && entry.traceable && entry.resolvedFromRegistry;
+}
+/**
+ * Computes `approved copy coverage rate`: shipped audience-facing copy
+ * resolved from approved traceable registry entries / all shipped
+ * audience-facing copy evaluated.
+ */
+export function assessApprovedCopyCoverageRate(input) {
+    if (!record(input)) {
+        return report("indeterminate", 0, 0, null, [finding("assessment-shape", "Assessment input must be an object.", "$")]);
+    }
+    const findings = [];
+    if (!timestamp(input.asOf)) {
+        findings.push(finding("assessment-as-of", "asOf must be an interpretable timestamp.", "asOf"));
+    }
+    const declaredCopy = input.declaredCopy;
+    if (!Array.isArray(declaredCopy)) {
+        findings.push(finding("declared-copy-required", "declaredCopy must be an array of { id } objects.", "declaredCopy"));
+        return report("indeterminate", 0, 0, null, findings);
+    }
+    const declaredIds = [];
+    const declaredSet = new Set();
+    declaredCopy.forEach((item, index) => {
+        const path = `declaredCopy[${index}]`;
+        if (!record(item) || !text(item.id)) {
+            findings.push(finding("copy-id-required", "id must be a non-empty string.", `${path}.id`));
+            return;
+        }
+        if (declaredSet.has(item.id)) {
+            findings.push(finding("duplicate-copy-id", `Duplicate id "${item.id}".`, `${path}.id`));
+            return;
+        }
+        declaredSet.add(item.id);
+        declaredIds.push(item.id);
+    });
+    if (declaredIds.length === 0) {
+        findings.push(finding("declared-copy-empty", "No declared copy is available for the approved-copy-coverage metric; the rate is indeterminate, never 1.", "declaredCopy"));
+    }
+    const observations = input.observations;
+    if (observations !== undefined && !Array.isArray(observations)) {
+        findings.push(finding("observations-shape", "observations must be an array.", "observations"));
+    }
+    const counting = new Map();
+    if (Array.isArray(observations)) {
+        observations.forEach((item, index) => {
+            const path = `observations[${index}]`;
+            if (!record(item)) {
+                findings.push(finding("observation-shape", "An observation must be an object.", path));
+                return;
+            }
+            if (text(item.observerRef) && reservedObserver(item.observerRef)) {
+                findings.push(finding("self-observation", "Writer cannot observe itself; reserved observerRef values are not independent.", `${path}.observerRef`));
+                return;
+            }
+            if (text(item.copyId) && !declaredSet.has(item.copyId)) {
+                findings.push(finding("unknown-copy", `Observation copyId "${item.copyId}" is not declared copy.`, `${path}.copyId`));
+                return;
+            }
+            if (item.independent !== true)
+                return;
+            if (typeof item.approved !== "boolean" ||
+                typeof item.traceable !== "boolean" ||
+                typeof item.resolvedFromRegistry !== "boolean")
+                return;
+            if (!text(item.observerRef) || !evidenceCounts(item.evidence) || !text(item.copyId) || !declaredSet.has(item.copyId))
+                return;
+            const bucket = counting.get(item.copyId) ?? [];
+            bucket.push({
+                approved: item.approved,
+                traceable: item.traceable,
+                resolvedFromRegistry: item.resolvedFromRegistry,
+            });
+            counting.set(item.copyId, bucket);
+        });
+    }
+    let evaluatedCopy = 0;
+    let approvedCoveredCopy = 0;
+    for (const id of declaredIds) {
+        const observed = counting.get(id) ?? [];
+        if (observed.length === 0) {
+            findings.push(finding("copy-unevaluated", `Declared copy "${id}" has no counting independent observation.`, `declaredCopy.${id}`));
+            continue;
+        }
+        evaluatedCopy += 1;
+        const allCovered = observed.every((entry) => isCovered(entry));
+        if (allCovered)
+            approvedCoveredCopy += 1;
+        else {
+            findings.push(finding("copy-not-covered", `Declared copy "${id}" was independently observed not resolved from an approved traceable registry entry.`, `declaredCopy.${id}`));
+        }
+        if (observed.length > 1) {
+            const first = observed[0];
+            const disagree = observed.some((entry) => entry.approved !== first.approved ||
+                entry.traceable !== first.traceable ||
+                entry.resolvedFromRegistry !== first.resolvedFromRegistry);
+            if (disagree) {
+                findings.push(finding("observation-disagreement", `Counting observations for "${id}" disagree.`, `observations.${id}`));
+            }
+        }
+    }
+    const rate = evaluatedCopy === 0 ? null : approvedCoveredCopy / evaluatedCopy;
+    if (evaluatedCopy === 0)
+        return report("indeterminate", 0, 0, null, findings);
+    const coverageComplete = evaluatedCopy === declaredIds.length;
+    const noErrorFindings = findings.length === 0;
+    const state = coverageComplete && approvedCoveredCopy === evaluatedCopy && noErrorFindings ? "satisfied" : "violated";
+    return report(state, evaluatedCopy, approvedCoveredCopy, rate, findings);
+}
+//# sourceMappingURL=approved-copy-coverage-rate.js.map

package/dist/approved-copy-coverage-rate.js.map

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

package/dist/index.d.ts

@@ -30,6 +30,8 @@ export type { CopyResolveIssue, CopyResolveIssueReason, CopyResolveResult } from
 export { readCopyRecord } from "./registry.js";
 export type { CopyRegistryReadIssue, CopyRegistryReadIssueReason, CopyRegistryReadResult } from "./registry.js";
 export { checkCopyRecord } from "./checker.js";
+export { assessApprovedCopyCoverageRate } from "./approved-copy-coverage-rate.js";
+export type { ApprovedCopyCoverageRateAssessment, ApprovedCopyCoverageRateFinding, ApprovedCopyCoverageRateState, } from "./approved-copy-coverage-rate.js";
 export type { CopyEntryCheckResult, CopyEntrySkip, CopyRecordCheckOptions, CopyRecordCheckReport, CopyRecordFinding, CopyRecordWaivedFinding, } from "./checker.js";
 export * from "./voice/index.js";
 export { extractCopyCandidates, PLACEHOLDER_SENTINEL, scanCopySourceTree } from "./scan.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EACV,SAAS,EACT,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,yBAAyB,EACzB,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAErH,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEhG,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEhH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAKtB,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC5F,YAAY,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAOnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMrG,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,OAAO,EACP,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EACV,SAAS,EACT,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,yBAAyB,EACzB,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAErH,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEhG,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEhH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,YAAY,EACV,kCAAkC,EAClC,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAKtB,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC5F,YAAY,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAOnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMrG,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,OAAO,EACP,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -30,6 +30,7 @@ export { parseCopyRecord, parseCopyRegistry, validateCopyRecordShape, validateCo
 export { createCopyResolver, resolveCopyRef } from "./resolve.js";
 export { readCopyRecord } from "./registry.js";
 export { checkCopyRecord } from "./checker.js";
+export { assessApprovedCopyCoverageRate } from "./approved-copy-coverage-rate.js";
 // Voice is a first-class part of copy. It is available from this root entry
 // point for a single-package experience and from the focused `copy/voice`
 // subpath for consumers that only need the verbal contract.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAmBH,kEAAkE;AAClE,0EAA0E;AAC1E,4EAA4E;AAC5E,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAErH,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU/C,4EAA4E;AAC5E,0EAA0E;AAC1E,4DAA4D;AAC5D,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAa5F,kEAAkE;AAClE,2EAA2E;AAC3E,mEAAmE;AACnE,sEAAsE;AACtE,aAAa;AACb,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAS9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,mEAAmE;AACnE,wEAAwE;AACxE,qEAAqE;AACrE,8BAA8B;AAC9B,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAW7B,2EAA2E;AAC3E,0EAA0E;AAC1E,0EAA0E;AAC1E,iEAAiE;AACjE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAQ3D,uEAAuE;AACvE,gEAAgE;AAChE,yEAAyE;AACzE,+DAA+D;AAC/D,sEAAsE;AACtE,kDAAkD;AAClD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAmBH,kEAAkE;AAClE,0EAA0E;AAC1E,4EAA4E;AAC5E,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAErH,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAelF,4EAA4E;AAC5E,0EAA0E;AAC1E,4DAA4D;AAC5D,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAa5F,kEAAkE;AAClE,2EAA2E;AAC3E,mEAAmE;AACnE,sEAAsE;AACtE,aAAa;AACb,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAS9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,mEAAmE;AACnE,wEAAwE;AACxE,qEAAqE;AACrE,8BAA8B;AAC9B,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAW7B,2EAA2E;AAC3E,0EAA0E;AAC1E,0EAA0E;AAC1E,iEAAiE;AACjE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAQ3D,uEAAuE;AACvE,gEAAgE;AAChE,yEAAyE;AACzE,+DAA+D;AAC/D,sEAAsE;AACtE,kDAAkD;AAClD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clossys/writer",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,8 @@
     "./voice-record.template.jsonc": "./templates/voice-record.template.jsonc"
   },
   "bin": {
-    "writer-check": "dist/cli.js"
+    "writer-check": "dist/cli.js",
+    "writer-rate-check": "dist/approved-copy-coverage-rate-cli.js"
   },
   "files": [
     "dist",
@@ -31,6 +32,12 @@
     "LICENSE"
   ],
   "sideEffects": false,
+  "foundry": {
+    "assessment": {
+      "bin": "writer-rate-check",
+      "invocation": "single-json-input"
+    }
+  },
   "description": "The writer role: is it well said? A consumer-owned language system: voice rules, glossary and claims validation, addressable copy records, source traceability, locale coverage, and passage-layer composition — five gates reachable from one bin. Ships machinery and templates, never a consumer's actual copy or voice.",
   "keywords": [
     "writer",

package/src/approved-copy-coverage-rate-cli.ts

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { assessApprovedCopyCoverageRate } from "./approved-copy-coverage-rate.js";
+
+const USAGE = `Usage: writer-rate-check <assessment.json>\n\nAssess approved copy coverage rate from consumer-supplied independent observations.\nExit codes: 0 = satisfied, 1 = violated, 2 = indeterminate or unreadable.\nwriter-check remains the multi-mode CLI and is not this assessment.`;
+
+export class WriterRateCliInputError extends Error {}
+
+/** Reads caller-owned assessment evidence without treating it as validated. */
+export function readWriterAssessmentJson(path: string): unknown {
+  const resolved = resolve(path);
+  if (!existsSync(resolved)) throw new WriterRateCliInputError(`assessment file "${path}" does not exist`);
+  try {
+    if (!statSync(resolved).isFile()) throw new WriterRateCliInputError(`assessment file "${path}" is not a file`);
+    return JSON.parse(readFileSync(resolved, "utf8"));
+  } catch (cause) {
+    if (cause instanceof WriterRateCliInputError) throw cause;
+    throw new WriterRateCliInputError(`assessment file "${path}" is unreadable JSON: ${cause instanceof Error ? cause.message : String(cause)}`);
+  }
+}
+
+/** Testable CLI dispatcher. Invalid arguments throw; the executable maps them to exit 2. */
+export function main(argv: readonly string[]): number {
+  if (argv.length === 1 && (argv[0] === "--help" || argv[0] === "-h")) {
+    console.log(USAGE);
+    return 0;
+  }
+  if (argv.length !== 1) throw new WriterRateCliInputError("exactly one assessment.json file is required");
+  const report = assessApprovedCopyCoverageRate(readWriterAssessmentJson(argv[0] as string));
+  console.log(JSON.stringify(report, null, 2));
+  return report.state === "satisfied" ? 0 : report.state === "violated" ? 1 : 2;
+}
+
+function run(): void {
+  try {
+    process.exitCode = main(process.argv.slice(2));
+  } catch (cause) {
+    console.error(`writer-rate-check: ${cause instanceof Error ? cause.message : String(cause)}`);
+    process.exitCode = 2;
+  }
+}
+
+/** Resolves an npm/POSIX bin symlink before deciding whether this module is the entrypoint. */
+export function isDirectInvocation(moduleUrl: string, argvPath: string | undefined): boolean {
+  if (argvPath === undefined) return false;
+  try {
+    return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(resolve(argvPath));
+  } catch {
+    return false;
+  }
+}
+
+if (isDirectInvocation(import.meta.url, process.argv[1])) run();

package/src/approved-copy-coverage-rate.ts

@@ -0,0 +1,201 @@
+/**
+ * Computes the Writer charter metric `approved copy coverage rate` from
+ * consumer-supplied independent observations.
+ *
+ * This module does not invent observations and does not relabel
+ * `checkCopyRecord` or `checkCopyTraceability`. An empty evaluated set is
+ * indeterminate, never a perfect rate of 1. `writer-check` remains the
+ * multi-mode CLI.
+ */
+const METRIC = "approved copy coverage rate" as const;
+const RESERVED_OBSERVERS = new Set(["writer", "@clossys/writer"]);
+const PROPOSED_POSITIONS: readonly unknown[] = [];
+
+export type ApprovedCopyCoverageRateState = "satisfied" | "violated" | "indeterminate";
+
+export interface ApprovedCopyCoverageRateFinding {
+  readonly rule: string;
+  readonly severity: "error";
+  readonly message: string;
+  readonly path?: string;
+}
+
+export interface ApprovedCopyCoverageRateAssessment {
+  readonly metric: "approved copy coverage rate";
+  readonly state: ApprovedCopyCoverageRateState;
+  readonly rate: number | null;
+  readonly evaluatedCopy: number;
+  readonly approvedCoveredCopy: number;
+  readonly findings: readonly ApprovedCopyCoverageRateFinding[];
+  readonly proposedPositions: readonly unknown[];
+}
+
+type UnknownRecord = Record<string, unknown>;
+
+function record(value: unknown): value is UnknownRecord {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function text(value: unknown): value is string {
+  return typeof value === "string" && value.trim().length > 0;
+}
+
+function timestamp(value: unknown): value is string {
+  return text(value) && !Number.isNaN(Date.parse(value));
+}
+
+function finding(rule: string, message: string, path?: string): ApprovedCopyCoverageRateFinding {
+  return path === undefined ? { rule, severity: "error", message } : { rule, severity: "error", message, path };
+}
+
+function evidenceCounts(value: unknown): boolean {
+  if (!Array.isArray(value) || value.length === 0) return false;
+  return value.every((item) => record(item) && text(item.id) && text(item.description));
+}
+
+function reservedObserver(value: string): boolean {
+  return RESERVED_OBSERVERS.has(value.trim().toLowerCase());
+}
+
+function report(
+  state: ApprovedCopyCoverageRateState,
+  evaluatedCopy: number,
+  approvedCoveredCopy: number,
+  rate: number | null,
+  findings: readonly ApprovedCopyCoverageRateFinding[],
+): ApprovedCopyCoverageRateAssessment {
+  return {
+    metric: METRIC,
+    state,
+    rate,
+    evaluatedCopy,
+    approvedCoveredCopy,
+    findings,
+    proposedPositions: PROPOSED_POSITIONS,
+  };
+}
+
+interface CountingObservation {
+  readonly approved: boolean;
+  readonly traceable: boolean;
+  readonly resolvedFromRegistry: boolean;
+}
+
+function isCovered(entry: CountingObservation): boolean {
+  return entry.approved && entry.traceable && entry.resolvedFromRegistry;
+}
+
+/**
+ * Computes `approved copy coverage rate`: shipped audience-facing copy
+ * resolved from approved traceable registry entries / all shipped
+ * audience-facing copy evaluated.
+ */
+export function assessApprovedCopyCoverageRate(input: unknown): ApprovedCopyCoverageRateAssessment {
+  if (!record(input)) {
+    return report("indeterminate", 0, 0, null, [finding("assessment-shape", "Assessment input must be an object.", "$")]);
+  }
+
+  const findings: ApprovedCopyCoverageRateFinding[] = [];
+  if (!timestamp(input.asOf)) {
+    findings.push(finding("assessment-as-of", "asOf must be an interpretable timestamp.", "asOf"));
+  }
+
+  const declaredCopy = input.declaredCopy;
+  if (!Array.isArray(declaredCopy)) {
+    findings.push(finding("declared-copy-required", "declaredCopy must be an array of { id } objects.", "declaredCopy"));
+    return report("indeterminate", 0, 0, null, findings);
+  }
+
+  const declaredIds: string[] = [];
+  const declaredSet = new Set<string>();
+  declaredCopy.forEach((item, index) => {
+    const path = `declaredCopy[${index}]`;
+    if (!record(item) || !text(item.id)) {
+      findings.push(finding("copy-id-required", "id must be a non-empty string.", `${path}.id`));
+      return;
+    }
+    if (declaredSet.has(item.id)) {
+      findings.push(finding("duplicate-copy-id", `Duplicate id "${item.id}".`, `${path}.id`));
+      return;
+    }
+    declaredSet.add(item.id);
+    declaredIds.push(item.id);
+  });
+
+  if (declaredIds.length === 0) {
+    findings.push(finding("declared-copy-empty", "No declared copy is available for the approved-copy-coverage metric; the rate is indeterminate, never 1.", "declaredCopy"));
+  }
+
+  const observations = input.observations;
+  if (observations !== undefined && !Array.isArray(observations)) {
+    findings.push(finding("observations-shape", "observations must be an array.", "observations"));
+  }
+
+  const counting = new Map<string, CountingObservation[]>();
+  if (Array.isArray(observations)) {
+    observations.forEach((item, index) => {
+      const path = `observations[${index}]`;
+      if (!record(item)) {
+        findings.push(finding("observation-shape", "An observation must be an object.", path));
+        return;
+      }
+      if (text(item.observerRef) && reservedObserver(item.observerRef)) {
+        findings.push(finding("self-observation", "Writer cannot observe itself; reserved observerRef values are not independent.", `${path}.observerRef`));
+        return;
+      }
+      if (text(item.copyId) && !declaredSet.has(item.copyId)) {
+        findings.push(finding("unknown-copy", `Observation copyId "${item.copyId}" is not declared copy.`, `${path}.copyId`));
+        return;
+      }
+      if (item.independent !== true) return;
+      if (
+        typeof item.approved !== "boolean" ||
+        typeof item.traceable !== "boolean" ||
+        typeof item.resolvedFromRegistry !== "boolean"
+      ) return;
+      if (!text(item.observerRef) || !evidenceCounts(item.evidence) || !text(item.copyId) || !declaredSet.has(item.copyId)) return;
+      const bucket = counting.get(item.copyId) ?? [];
+      bucket.push({
+        approved: item.approved,
+        traceable: item.traceable,
+        resolvedFromRegistry: item.resolvedFromRegistry,
+      });
+      counting.set(item.copyId, bucket);
+    });
+  }
+
+  let evaluatedCopy = 0;
+  let approvedCoveredCopy = 0;
+  for (const id of declaredIds) {
+    const observed = counting.get(id) ?? [];
+    if (observed.length === 0) {
+      findings.push(finding("copy-unevaluated", `Declared copy "${id}" has no counting independent observation.`, `declaredCopy.${id}`));
+      continue;
+    }
+    evaluatedCopy += 1;
+    const allCovered = observed.every((entry) => isCovered(entry));
+    if (allCovered) approvedCoveredCopy += 1;
+    else {
+      findings.push(finding("copy-not-covered", `Declared copy "${id}" was independently observed not resolved from an approved traceable registry entry.`, `declaredCopy.${id}`));
+    }
+    if (observed.length > 1) {
+      const first = observed[0]!;
+      const disagree = observed.some((entry) =>
+        entry.approved !== first.approved ||
+        entry.traceable !== first.traceable ||
+        entry.resolvedFromRegistry !== first.resolvedFromRegistry
+      );
+      if (disagree) {
+        findings.push(finding("observation-disagreement", `Counting observations for "${id}" disagree.`, `observations.${id}`));
+      }
+    }
+  }
+
+  const rate = evaluatedCopy === 0 ? null : approvedCoveredCopy / evaluatedCopy;
+  if (evaluatedCopy === 0) return report("indeterminate", 0, 0, null, findings);
+  const coverageComplete = evaluatedCopy === declaredIds.length;
+  const noErrorFindings = findings.length === 0;
+  const state: ApprovedCopyCoverageRateState =
+    coverageComplete && approvedCoveredCopy === evaluatedCopy && noErrorFindings ? "satisfied" : "violated";
+  return report(state, evaluatedCopy, approvedCoveredCopy, rate, findings);
+}

package/src/index.ts

@@ -54,6 +54,12 @@ export { readCopyRecord } from "./registry.js";
 export type { CopyRegistryReadIssue, CopyRegistryReadIssueReason, CopyRegistryReadResult } from "./registry.js";
 
 export { checkCopyRecord } from "./checker.js";
+export { assessApprovedCopyCoverageRate } from "./approved-copy-coverage-rate.js";
+export type {
+  ApprovedCopyCoverageRateAssessment,
+  ApprovedCopyCoverageRateFinding,
+  ApprovedCopyCoverageRateState,
+} from "./approved-copy-coverage-rate.js";
 export type {
   CopyEntryCheckResult,
   CopyEntrySkip,