@clossys/writer 0.3.8 → 0.4.0

package/dist/treatment-word-budget.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Treatment-level word budgets for registry entries — display headings,
+ * eyebrows, button labels, and other short treatments that are not body
+ * measure. Pure gate: takes an already-validated `CopyRegistry`, never I/O.
+ */
+import type { CopyEntryId, CopyRegistry } from "./types.js";
+/** Known slot treatments with a default maximum word count when the entry omits `maxWords`. */
+export declare const DEFAULT_TREATMENT_WORD_BUDGETS: Readonly<Record<string, number>>;
+export type TreatmentWordBudgetRule = "word-budget-exceeded" | "unknown-treatment";
+export interface TreatmentWordBudgetFinding {
+    rule: TreatmentWordBudgetRule;
+    severity: "error";
+    entryId: CopyEntryId;
+    treatment: string;
+    maxWords: number;
+    actualWords: number;
+    message: string;
+}
+export interface TreatmentWordBudgetResult {
+    entriesChecked: number;
+    findings: TreatmentWordBudgetFinding[];
+}
+/** Counts words in resolved copy text (whitespace-separated tokens). */
+export declare function countCopyWords(text: string): number;
+/**
+ * Fails when an approved entry declares a `treatment` (or `maxWords`) and
+ * its `text` exceeds the applicable budget. Draft and retired entries are
+ * skipped — only copy that can resolve at render is measured.
+ */
+export declare function checkTreatmentWordBudgets(registry: CopyRegistry): TreatmentWordBudgetResult;
+//# sourceMappingURL=treatment-word-budget.d.ts.map

package/dist/treatment-word-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treatment-word-budget.d.ts","sourceRoot":"","sources":["../src/treatment-word-budget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AAE/E,+FAA+F;AAC/F,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3E,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;AAEnF,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;CACxC;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAiBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,yBAAyB,CAwC3F"}

package/dist/treatment-word-budget.js

@@ -0,0 +1,80 @@
+/**
+ * Treatment-level word budgets for registry entries — display headings,
+ * eyebrows, button labels, and other short treatments that are not body
+ * measure. Pure gate: takes an already-validated `CopyRegistry`, never I/O.
+ */
+/** Known slot treatments with a default maximum word count when the entry omits `maxWords`. */
+export const DEFAULT_TREATMENT_WORD_BUDGETS = {
+    "display-heading": 12,
+    eyebrow: 8,
+    button: 6,
+};
+/** Counts words in resolved copy text (whitespace-separated tokens). */
+export function countCopyWords(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return 0;
+    return trimmed.split(/\s+/u).length;
+}
+function budgetForEntry(entry) {
+    const treatment = entry.treatment;
+    if (typeof treatment !== "string" || treatment.trim().length === 0)
+        return undefined;
+    const normalized = treatment.trim();
+    if (entry.maxWords !== undefined) {
+        if (typeof entry.maxWords !== "number" || !Number.isFinite(entry.maxWords) || entry.maxWords < 1) {
+            return undefined;
+        }
+        return { treatment: normalized, maxWords: Math.floor(entry.maxWords) };
+    }
+    const defaultMax = DEFAULT_TREATMENT_WORD_BUDGETS[normalized];
+    if (defaultMax === undefined)
+        return undefined;
+    return { treatment: normalized, maxWords: defaultMax };
+}
+/**
+ * Fails when an approved entry declares a `treatment` (or `maxWords`) and
+ * its `text` exceeds the applicable budget. Draft and retired entries are
+ * skipped — only copy that can resolve at render is measured.
+ */
+export function checkTreatmentWordBudgets(registry) {
+    const findings = [];
+    let entriesChecked = 0;
+    for (const entry of registry.entries) {
+        if (entry.status !== "approved")
+            continue;
+        const budget = budgetForEntry(entry);
+        if (!budget) {
+            if (typeof entry.treatment === "string" && entry.treatment.trim().length > 0) {
+                const normalized = entry.treatment.trim();
+                if (entry.maxWords === undefined && DEFAULT_TREATMENT_WORD_BUDGETS[normalized] === undefined) {
+                    findings.push({
+                        rule: "unknown-treatment",
+                        severity: "error",
+                        entryId: entry.id,
+                        treatment: normalized,
+                        maxWords: 0,
+                        actualWords: countCopyWords(entry.text),
+                        message: `Entry "${entry.id}" declares treatment "${normalized}" with no maxWords and no built-in default — add maxWords or use a known treatment (${Object.keys(DEFAULT_TREATMENT_WORD_BUDGETS).join(", ")}).`,
+                    });
+                }
+            }
+            continue;
+        }
+        entriesChecked++;
+        const actualWords = countCopyWords(entry.text);
+        if (actualWords > budget.maxWords) {
+            findings.push({
+                rule: "word-budget-exceeded",
+                severity: "error",
+                entryId: entry.id,
+                treatment: budget.treatment,
+                maxWords: budget.maxWords,
+                actualWords,
+                message: `Entry "${entry.id}" (${budget.treatment}) has ${actualWords} word(s) but the budget is ${budget.maxWords}.`,
+            });
+        }
+    }
+    return { entriesChecked, findings };
+}
+//# sourceMappingURL=treatment-word-budget.js.map

package/dist/treatment-word-budget.js.map

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

package/dist/types.d.ts

@@ -147,6 +147,17 @@ export interface CopyEntry {
      * same seam, one layer over).
      */
     factRef?: string;
+    /**
+     * Named slot treatment for word-budget governance — e.g. `display-heading`,
+     * `eyebrow`, `button`. When set on an approved registry entry, `writer-check`
+     * applies `maxWords` or the built-in default for that treatment.
+     */
+    treatment?: string;
+    /**
+     * Maximum word count for this entry's `text` when `treatment` is set.
+     * Overrides the built-in default table when present.
+     */
+    maxWords?: number;
 }
 /**
  * Content-derived provenance for one target-locale translation. Present only

package/dist/types.d.ts.map

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

package/fit-signals.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "role": "@clossys/writer",
+  "signals": [
+    {
+      "id": "ships-audience-facing-copy",
+      "prompt": "The repository ships text a person outside the team reads: interface strings, page copy, or other audience-facing prose in its source.",
+      "evidenceKind": "repository-structure"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clossys/writer",
-  "version": "0.3.8",
+  "version": "0.4.0",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -19,19 +19,215 @@
     "./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",
     "src",
     "!src/**/*.test.ts",
     "templates",
-    "CHANGELOG.md",
+    "fit-signals.json",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "skill"
   ],
   "sideEffects": false,
-  "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.",
+  "foundry": {
+    "assessment": {
+      "bin": "writer-rate-check",
+      "invocation": "single-json-input"
+    },
+    "capabilities": [
+      {
+        "id": "voice-record",
+        "subQuestion": "Is the voice record itself complete — every field bound, every rule derived from a real brand attribute?",
+        "worldClass": "The voice record is fully bound (no unedited template placeholder) and every rule traces to a brand-derivation attribute — checked as a record, before any copy is ever measured against it.",
+        "inputs": [
+          {
+            "producerRole": "@clossys/strategist",
+            "artifact": "brand-derivation"
+          }
+        ],
+        "outputs": [
+          "clossys/writer/voice.json"
+        ],
+        "proofCase": "voice-derivation-violated",
+        "maturity": "partial",
+        "v0": true,
+        "businessLifecycleStage": "define"
+      },
+      {
+        "id": "copy-registry",
+        "subQuestion": "Is every registry entry itself schema-valid, unique, and free of unfilled placeholders?",
+        "worldClass": "Every registry entry is schema-valid, has a unique id, and every declared placeholder is present in its own text — registry validity only; whether a component actually USES the registry by id is addressability's own question.",
+        "inputs": [],
+        "outputs": [
+          "clossys/writer/copy-registry.json"
+        ],
+        "proofCase": "registry-placeholder-missing",
+        "maturity": "built",
+        "v0": true,
+        "businessLifecycleStage": "build"
+      },
+      {
+        "id": "copy-coverage",
+        "subQuestion": "Does every user-facing string in code trace to a registered copy entry, by literal match or citation?",
+        "worldClass": "Every component string either matches a registered CopyRecord entry's text/alias or carries a copy:<id> citation -- the \"approved copy coverage rate\" metric this role owns (docs/contracts/role-loop-archetypes.json), and what writer-check's default command (copy-clean) actually proves. Distinct from `copy-registry` (is the registry entry itself valid) and from `claims-to-copy-traceability` (does a claim-SHAPED sentence cite an approved Strategist claim).",
+        "inputs": [
+          {
+            "producerRole": "@clossys/writer",
+            "artifact": "copy-registry"
+          }
+        ],
+        "outputs": [
+          "clossys/writer/.generated/copy-coverage-report.json"
+        ],
+        "proofCase": "copy-clean",
+        "maturity": "built",
+        "v0": true,
+        "businessLifecycleStage": "build"
+      },
+      {
+        "id": "claims-to-copy-traceability",
+        "subQuestion": "Does every claim-shaped or numeric sentence in shipped copy trace to an approved registry claim, by citation?",
+        "worldClass": "A currency amount, percentage, multiplier, or superlative sentence in live copy either matches a registered claim's text or carries a claim:<id> citation to one -- checked on the COPY side. Whether Strategist's own facts/markers gate should stop scanning shipped surfaces at all (leaving this the one place that check happens) is a decision pending #1271, not yet a settled boundary -- today `strategist-check` still scans authored prose too (its own facts-clean fixture is an announcement.md).",
+        "inputs": [
+          {
+            "producerRole": "@clossys/strategist",
+            "artifact": "claims"
+          }
+        ],
+        "outputs": [
+          "clossys/writer/.generated/claim-citations-report.json"
+        ],
+        "proofCase": "live-magnitude-unmarked",
+        "maturity": "partial",
+        "v0": true,
+        "businessLifecycleStage": "build"
+      },
+      {
+        "id": "live-copy-conformance",
+        "subQuestion": "Does live, shipped copy still match its registry source and stay within its word-budget and fold rules?",
+        "worldClass": "Shipped copy never drifts silently from its registry source, and the above-the-fold word budget is enforced, not eyeballed.",
+        "inputs": [],
+        "outputs": [
+          "clossys/writer/.generated/live-copy-report.json"
+        ],
+        "proofCase": "live-fold-wallpaper",
+        "maturity": "partial",
+        "v0": false,
+        "businessLifecycleStage": "operate"
+      },
+      {
+        "id": "addressability",
+        "subQuestion": "Is every piece of user-facing prose resolved from the registry by id, never typed directly into a component?",
+        "worldClass": "A rename is always cheap: renaming a piece of copy means editing one registry entry, never hunting every component that typed the sentence — #1208's site template reads copy by id on this guarantee.",
+        "inputs": [],
+        "outputs": [
+          "clossys/writer/.generated/addressability-report.json"
+        ],
+        "proofCase": "addressability-violated",
+        "maturity": "built",
+        "v0": true,
+        "businessLifecycleStage": "build"
+      },
+      {
+        "id": "locale-coverage",
+        "subQuestion": "Does the whole set of a project's locales actually cover the same ground, current and correctly interpolating?",
+        "worldClass": "Every target locale covers what the source locale covers, with no orphaned or stale translation — governance over WHICH locales are covered, not runtime translation itself.",
+        "inputs": [],
+        "outputs": [
+          "clossys/writer/.generated/locale-coverage-report.json"
+        ],
+        "proofCase": "locale-coverage-missing",
+        "maturity": "built",
+        "v0": false,
+        "businessLifecycleStage": "operate"
+      },
+      {
+        "id": "voice-conformance",
+        "subQuestion": "Is shipped copy actually well said — in voice, in tense, in person, every claim supported?",
+        "worldClass": "Every mechanically detectable voice violation (forbidden term, wrong tense or person, an unsupported claim marked as requiring support) is caught against the bound voice record — the answer to \"is it well said\", not merely \"does it trace\".",
+        "inputs": [
+          {
+            "producerRole": "@clossys/writer",
+            "artifact": "voice-record"
+          }
+        ],
+        "outputs": [
+          "clossys/writer/.generated/voice-conformance-report.json"
+        ],
+        "proofCase": "live-claim-unsupported",
+        "maturity": "partial",
+        "v0": false,
+        "businessLifecycleStage": "operate"
+      },
+      {
+        "id": "messaging-kit",
+        "subQuestion": "Does the product have one governed tagline, pitch-length set, boilerplate, and FAQ that everything else derives from?",
+        "worldClass": "One governed messaging kit (tagline, short/medium/long pitch, short/medium/long boilerplate, FAQ) exists and every surface's short-form copy derives from it, per #1204's Identity layer, rather than being improvised per surface.",
+        "inputs": [
+          {
+            "producerRole": "@clossys/strategist",
+            "artifact": "positioning"
+          }
+        ],
+        "outputs": [
+          "clossys/writer/messaging-kit.json"
+        ],
+        "proofCase": null,
+        "maturity": "planned",
+        "v0": true,
+        "businessLifecycleStage": "launch"
+      },
+      {
+        "id": "privacy-and-terms-placeholders",
+        "subQuestion": "Do the placeholder privacy notice and terms say, in the brand's voice, only what the supplied data-holding facts support, and say plainly that they are not legal advice?",
+        "worldClass": "Placeholder privacy-notice and terms text is drafted in the brand's voice from the facts Keeper supplies (what data is held, why, and for how long), never from assumption, and each page is labelled clearly as not legal advice pending review by counsel (#1213). Legal work beyond placeholders is out of scope for this role.",
+        "inputs": [],
+        "outputs": [
+          "clossys/writer/policy-placeholders.json"
+        ],
+        "proofCase": null,
+        "maturity": "planned",
+        "v0": true,
+        "businessLifecycleStage": "launch"
+      }
+    ],
+    "outputs": [
+      "clossys/writer/copy-registry.json",
+      "clossys/writer/voice.json"
+    ],
+    "feeds": [
+      {
+        "artifact": "copy-registry",
+        "path": "clossys/writer/copy-registry.json"
+      }
+    ],
+    "needs": [
+      {
+        "producerRole": "@clossys/strategist",
+        "artifact": "brand-derivation"
+      },
+      {
+        "producerRole": "@clossys/strategist",
+        "artifact": "claims"
+      }
+    ],
+    "solves": [
+      {
+        "problem": "writer-unapproved-copy",
+        "statement": "We ship words nobody signed off on.",
+        "metric": "approved copy coverage rate",
+        "proofCase": "copy-violated",
+        "evidence": "designed",
+        "capability": "copy-coverage"
+      }
+    ],
+    "fit": "fit-signals.json"
+  },
+  "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 \u2014 five gates reachable from one bin. Ships machinery and templates, never a consumer's actual copy or voice.",
   "keywords": [
     "writer",
     "copy",
@@ -63,7 +259,7 @@
   "devDependencies": {
     "@types/node": "^26.5.1",
     "typescript": "~6.0.0",
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.1"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",

package/skill/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: clossys-writer
+description: Copy registry, voice conformance, and approved-language coverage. Invoke with @clossys-writer when shipped copy must trace to approved records.
+disable-model-invocation: true
+---
+# clossys-writer
+
+You are Writer. Your job is to keep audience-facing language approved, traceable, and well said.
+
+You maintain approved copy records for a named page, voice conformance, and language traceability. With Designer you supply the copy ids and block kinds the in-tree page document cites by reference, and iterate until a local render of that document is the page; Publisher authors and owns the surface document itself (#1205). You do not invent strategy facts, treat yourself as outline-only for Publisher to finish, or publish surfaces.
+
+
+## Foundry voices
+
+The same team is in every inventoried repo. Name another `@clossys-<package>` to talk to them. A missing mention is a bug, not a compatibility signal. Hiring and fit always go through `@clossys-advisor`.
+
+## Operating wave
+
+1. **Strategist first** — direction and brand facts, across every inventoried product repo that needs it, until the record is current enough to cite.
+2. **Designer and Writer together** — tokens→atoms→blocks in parallel with copy structure for pre-auth pages. Do not start if Strategist still has no citable direction.
+3. **Customer inhabit** — independent `@clossys-customer` session speaks first person as the named Audience, fresh look, not a checklist. That person can also be asked for lived feedback on any topic, comparison from their consideration set, what it would take to start or to refer, whether it is worth what it costs them, and what would make them leave. This role does not inhabit the user.
+4. **Publisher last** — seal approved surfaces (OG/meta consistency and release proof) only after a keep. Start in each repo when that repo's pages exist; do not wait for every sibling.
+
+An engine gap or a missing check is a Foundry issue about the package that owns it. Never dump a consumer's strategy. Never name a consumer.
+
+## Handoff citations
+
+Cite the strategist handoff: an audience id, approved strategist claim ids (`claim:<id>` in prose), applicable constraint ids (`constraint:<id>`), and the current direction id. Do not edit `clossys/strategist/`. Voice-glossary claims in this package are not strategist claims.
+
+## Pre-auth page
+
+Done is exceptional (5) as defined in PRE-AUTH-QUALITY (the brief that ships with `@clossys/designer`). `designer-hero-css-check`, `designer-fold-check`, and `writer-check --live` prove 3 only — never call 3 done or world class. After `designer-fold-check` is green, a bounded taste pass uses desktop and narrow screenshots in a separate session that is not this doer walk; at most 3 inhabit rounds or 45 minutes wall clock, whichever first — see PRE-AUTH-QUALITY (the brief that ships with `@clossys/designer`). This walk does not self-certify exceptional keep. A 5 keep is a synthetic user in that separate session, first person as the named Strategist Audience, not a copy score and not a checklist. This role does not author keep-review evidence and does not inhabit the persona. Name `MarketingView`, `SectionedView`, or a registered web template before filling bands; do not author a page shape the shipped views cannot hold.
+
+## When this package is installed
+
+If `node_modules/@clossys/writer` is present (or this package's bins are on PATH), use the exact pin in the tree. Read `package.json` `bin` for the real command names.
+- Assessment CLI: `writer-rate-check`
+- Additional gate CLI: `writer-check`
+
+Summarize gate results in human language; keep machine kinds for tooling, not as the default reply.
+
+## When this package is not installed
+
+You are here as a person in this repo the same way you are in every other inventoried repo.
+
+- Intro and quick questions are always in scope.
+- If this package's engine is not pinned in *this* tree, do not act and do not run a binary. Ask `@clossys-advisor` whether to hire you **in this repository**.
+- Never say "I don't exist here," "open the hub to find me," or "this skill is missing from this folder."
+- Never imply they should npm-install the whole catalogue.