@thebassclef/lite 1.9.16 → 1.9.18

package/dist/lite/standards/lite-manifest.json

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
-  "manifest_version": "1.16.10",
-  "generated_at": "2026-10-06T20:37:31Z",
+  "manifest_version": "1.17.4",
+  "generated_at": "2026-10-16T22:14:49Z",
   "entries": [
     {
       "slug": "029-release-pipeline",
@@ -64,7 +64,7 @@
       "type": "agent",
       "path": ".claude/agents/builder.md",
       "tier": "lite",
-      "content_hash": "sha256:0b24f89c111cfe255bb25a567718d073b22088c4d8b20fed9b405c3a797b1e9b",
+      "content_hash": "sha256:b0f279027867310b2fdab217b6a072133b0f35a5bf306a35a3c108cdb4d0d64c",
       "description": "Executes against spec. Respects ADR constraints. Commits with conventional commits. Doesn't redesign mid-build. Raises blockers immediately."
     },
     {
@@ -264,7 +264,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/83-install-written-paths-rebuild.sh",
       "tier": "lite",
-      "content_hash": "sha256:3b8268e67f0eb25b84dd8cb010cfa02912c50c3c8eba73302341e445d19f97c5",
+      "content_hash": "sha256:26afc563c1212ca472cb9c41af6d3cdbf95dd9d06ef634de95baf9337b39a28d",
       "description": "Session-start fragment: rebuild install-written-paths manifest when missing/stale."
     },
     {
@@ -328,7 +328,7 @@
       "type": "hook",
       "path": ".claude/hooks/artifact-ingestion-gate.sh",
       "tier": "lite",
-      "content_hash": "sha256:1d317b210ee902be6e60d47b94db5c265b24932e21d09623650a154cb5bda443",
+      "content_hash": "sha256:5946bdc740af1541e407aef397eb470166e00bef1ca87cdd47e7e08b7255cae1",
       "description": "Artifact Ingestion Gate — fires on Write/Edit to generative artifact paths."
     },
     {
@@ -336,7 +336,7 @@
       "type": "hook",
       "path": ".claude/hooks/assert-verify-steering.sh",
       "tier": "lite",
-      "content_hash": "sha256:7a421558661225ee7d6b3b0dcc45a1ca5171f530093a87420c8bd88b7ca0f620",
+      "content_hash": "sha256:a554079add7826aef3286ab28f8f1f28cb6d495c196aec002c15d4d1be425362",
       "description": "assert-verify-steering.sh — UserPromptSubmit hook that injects"
     },
     {
@@ -504,7 +504,7 @@
       "type": "hook",
       "path": ".claude/hooks/plain-english-steering.sh",
       "tier": "lite",
-      "content_hash": "sha256:4a6e092731d6d6e11618e6eb3557419b7e7d193c3f19bdacbf138d951d39f1a1",
+      "content_hash": "sha256:43c94eb70b04b1de950e0928b151b8a9ecc30b6dd23d65ae1f2175a3edf993f8",
       "description": "plain-english-steering.sh — UserPromptSubmit hook that injects"
     },
     {
@@ -552,7 +552,7 @@
       "type": "hook",
       "path": ".claude/hooks/pre-commit-gate.sh",
       "tier": "lite",
-      "content_hash": "sha256:5b0385b5c3ab415c522285e70c710ef2351e5843a86867bd4a73b138e0e12e02",
+      "content_hash": "sha256:44ee55c1c8ba834b0b1e99209cfd86659921ebade01f18981fae3461ed3574f3",
       "description": "Observable failure trap — closes bassclef-upstream#1075 (silent-stderr class)."
     },
     {
@@ -587,6 +587,22 @@
       "content_hash": "sha256:d1c01e63e69d5081812c6a689b881c318667152509383fa09feeddb72e997313",
       "description": "pre-gh-pr-title-scrub — PreToolUse hook that runs the body scrub logic"
     },
+    {
+      "slug": "pre-push-shellcheck",
+      "type": "hook",
+      "path": ".claude/hooks/pre-push-shellcheck.sh",
+      "tier": "lite",
+      "content_hash": "sha256:98d72340156ebafcdaf11aa2f20b79c377b10495016d6f7d9cb74c8a554e9592",
+      "description": "pre-push-shellcheck — PreToolUse Bash hook that scans .sh files going"
+    },
+    {
+      "slug": "reviewer-dispatch-check",
+      "type": "hook",
+      "path": ".claude/hooks/reviewer-dispatch-check.sh",
+      "tier": "lite",
+      "content_hash": "sha256:0b487dc434c96333aadbc4893c46a3aee07a4f51181fb3cec050acda82ed5b9a",
+      "description": "reviewer-dispatch-check.sh — Stop hook on code-shipping sessions"
+    },
     {
       "slug": "role-entry-gate",
       "type": "hook",
@@ -691,6 +707,14 @@
       "content_hash": "sha256:15c81bba2b25f8d975b806371f6ca71be59e6339bebd9afe2074505c9b9fb436",
       "description": "SDLC Trace Log helper — sourced by all hooks."
     },
+    {
+      "slug": "turn-prose-density-measure",
+      "type": "hook",
+      "path": ".claude/hooks/turn-prose-density-measure.sh",
+      "tier": "lite",
+      "content_hash": "sha256:5124aefce9ef1328364e38db13f0b3cb36df013d8b059bc94a57f972f3c8af80",
+      "description": "Turn-prose density measure — Stop hook that reads the last assistant message"
+    },
     {
       "slug": "turn-prose-grade-measure",
       "type": "hook",
@@ -704,7 +728,7 @@
       "type": "hook",
       "path": ".claude/hooks/turn-prose-kiss-check.sh",
       "tier": "lite",
-      "content_hash": "sha256:ac0ffe20336df8a4574da133cd4de6b7b8d5442e55893d4f8bdd2f4aea1aafbf",
+      "content_hash": "sha256:5e039dc5864f02193305a0c24ad4fb014f63e4979f57cd3364620cbea2029b75",
       "description": "Turn-prose /kiss check — Stop hook that scans the most recent assistant"
     },
     {
@@ -856,7 +880,7 @@
       "type": "lib",
       "path": "lib/install-written-paths.sh",
       "tier": "lite",
-      "content_hash": "sha256:38148e8de456928b13846c2999377c30ac303cf0369cc7755ecc0ba9a8f899fb",
+      "content_hash": "sha256:a05af07492ef548781b0f206d1d51cc0926a3957e61cded77e41d99a038d32ab",
       "description": "Install-written-paths manifest + accessor lib."
     },
     {
@@ -907,6 +931,14 @@
       "content_hash": "sha256:0e1e0765acfad9826b9a042eed2215eb0c71b8f5f077283a5abab7d8fd40e5e7",
       "description": "lib/preview-state.sh — typed accessor for docs/preview-state/<slug>.yml"
     },
+    {
+      "slug": "prose-marker",
+      "type": "lib",
+      "path": "lib/prose-marker.sh",
+      "tier": "lite",
+      "content_hash": "sha256:1ced5ff7c2156bf0168673476c9a1579d9572a5206f1305e5f447c2126e72b06",
+      "description": "lib/prose-marker.sh — shared marker write + read helpers for the bassclef"
+    },
     {
       "slug": "prose-scan-boundary",
       "type": "lib",
@@ -984,7 +1016,7 @@
       "type": "lib",
       "path": "lib/tier-dependency-audit.sh",
       "tier": "lite",
-      "content_hash": "sha256:aea0c465ff0699e68977e8ff4a80a1f0d3455b9a9f3108888bc82a2eb84a2ee2",
+      "content_hash": "sha256:9b65ecf00ff584c573e84ca9e7d980e492e9673a11669ba3e1c3ecb5cd1ef2da",
       "description": "lib/tier-dependency-audit.sh"
     },
     {
@@ -1367,7 +1399,7 @@
       "type": "presence-template",
       "path": "presence/install/bassclef-sync.template.sh",
       "tier": "lite",
-      "content_hash": "sha256:92fa84059bd69964a35887b9b77812bfb3acc58c9ca4c9618bacf11d56079c2a",
+      "content_hash": "sha256:a33dd77165b005cfe639ea5093e5af4620c49022bcef6ad5d8cb0670129814d8",
       "description": "description: BASSCLEF_SYNC_VERSION=2026-09-06-1496-sessionstart-heal-v1"
     },
     {
@@ -1398,7 +1430,7 @@
       "type": "root-doc",
       "path": ".claude/bassclef-orientation.md",
       "tier": "lite",
-      "content_hash": "sha256:25270e2b752a37c485b824c09b72352d264d5f2febc77b85ba5f8087db1d63b2"
+      "content_hash": "sha256:9e98b2a6fe7038d46642ef22061b22660ebf8fb0a0ae719af6b928655c997804"
     },
     {
       "slug": "claude-lite",
@@ -1429,7 +1461,7 @@
       "type": "root-doc",
       "path": "README.md",
       "tier": "lite",
-      "content_hash": "sha256:856e387d438bfc8c6094464ac457271039848ec1eda457bf5ba51a035c91b6a0",
+      "content_hash": "sha256:a27a7b9d211fc1cd92864d56bd05fe5912dcd27781bf8d5229844ac909421765",
       "description": "A shared substrate for working with AI coding agents."
     },
     {
@@ -1541,7 +1573,7 @@
       "type": "rule",
       "path": ".claude/rules/branching.md",
       "tier": "lite",
-      "content_hash": "sha256:292de9c9fda44c0c9e92bd2fd0551d04a686ed60607b094635bf5db74465c57d",
+      "content_hash": "sha256:ce380a635aa65ba6087e560bb29335e7011f855884c94702b3414aa51ea8e3d0",
       "description": "Trunk-based development — branch naming and flow"
     },
     {
@@ -1669,7 +1701,7 @@
       "type": "rule",
       "path": ".claude/rules/identifier-leak-prevention.md",
       "tier": "lite",
-      "content_hash": "sha256:31df845d034bbd756172ad7895ff561cbfeab38aa0b744f29862ff4095e4300b",
+      "content_hash": "sha256:5653d1e6449eb982b73ddad4f9e099a4eb5352423f955067887c60f2af9de2e5",
       "description": "Bassclef commits stay free of operator machine identifiers."
     },
     {
@@ -1699,7 +1731,7 @@
       "type": "rule",
       "path": ".claude/rules/lite-manifest-schema-change-discipline.md",
       "tier": "lite",
-      "content_hash": "sha256:730cde99f460fb259896e9f9aed268b4a116599a5a2b397a92196f95b9d4af5d",
+      "content_hash": "sha256:558817a99e902b35d6857129ce3b63ac3f1a66b9a7c97049a74f3b6c5ce2d6cc",
       "description": "Every lite-manifest schema change ships a migration-note ledger entry in the same PR. Adopters read the ledger before sync."
     },
     {
@@ -1870,6 +1902,14 @@
       "content_hash": "sha256:c6abf0895c5edb60c8b42c741f39c407b6145a63453fe584b7e63559d2bd7e7e",
       "description": "Bassclef MUST NOT create a skill (.claude/skills/<name>/SKILL.md) with a name Claude Code's harness already claims."
     },
+    {
+      "slug": "reviewer-dispatch",
+      "type": "rule",
+      "path": ".claude/rules/reviewer-dispatch.md",
+      "tier": "lite",
+      "content_hash": "sha256:78be083820e114ab2a940823ef47210bcdda7bed9b27d327a8724b4bbdd858f0",
+      "description": "Any session that ships source code (files under src/, apps/, packages/, lib/, app/) MUST invoke Reviewer responsibilities before the session ends."
+    },
     {
       "slug": "schema-management",
       "type": "rule",
@@ -2078,6 +2118,14 @@
       "content_hash": "sha256:d7a13ca4fb37283e50fc165bb5ebd6a65539d7dade005dcd38098e1d878c52b3",
       "description": "analyze-tier-dependencies.sh — orchestrator for the tier-dependency-audit subsystem"
     },
+    {
+      "slug": "concise-prompt",
+      "type": "script",
+      "path": ".claude/skills/onboard-repo/concise-prompt.sh",
+      "tier": "lite",
+      "content_hash": "sha256:75f0946c98992117722ea1f0839380f3aeb31f530aa823330a6129a660210d74",
+      "description": "concise-prompt.sh — handle Y/n/skip for Anthropic Concise output style."
+    },
     {
       "slug": "extract-repo",
       "type": "script",
@@ -2091,7 +2139,7 @@
       "type": "script",
       "path": "scripts/generate-lite-manifest.sh",
       "tier": "lite",
-      "content_hash": "sha256:8d2741d06181f41af3d30965cdfd655d20508807e3fc799877fa2564811e5608",
+      "content_hash": "sha256:f7c551500bdc4062993d50ca5ecb025491ca97980a7318047f6472a3fe091433",
       "description": "Generate lite-manifest.json at repo root."
     },
     {
@@ -2131,7 +2179,7 @@
       "type": "script",
       "path": "scripts/launch/local-serve.sh",
       "tier": "lite",
-      "content_hash": "sha256:5494f4b46308e4b799d4e3aa2accc1f0880c78280dc8e5f5bcb45537d40036ab",
+      "content_hash": "sha256:cb621e555f78862bf926f2ee5681be319f9f0308ca1726ff77f0f7e1237e5589",
       "description": "local-serve.sh — serve a /launch local-mode prototype gallery via python http.server"
     },
     {
@@ -2174,6 +2222,14 @@
       "content_hash": "sha256:9d9ad4a997e2820046802796f81a5d064b14f951cdade6f6c252db64d2afae89",
       "description": "CLI wrapper for lib/workflow-metrics.sh — Module B4 query helper."
     },
+    {
+      "slug": "write-state-marker",
+      "type": "script",
+      "path": ".claude/skills/onboard-repo/write-state-marker.sh",
+      "tier": "lite",
+      "content_hash": "sha256:1f99762804df32a74cb2b19e2930a96d8f8e206f0261795b26766a9cebf0a29a",
+      "description": "write-state-marker.sh — Phase 2.3.9 helper for /onboard-repo (bassclef-upstream#664)."
+    },
     {
       "slug": "agent-research-spawn",
       "type": "skill",
@@ -2272,7 +2328,7 @@
       "type": "skill",
       "path": ".claude/skills/build/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:739d409886adc42c0111d7fc21d6290ede7d4403d5b51a1050efd3799c9eb1c2",
+      "content_hash": "sha256:25931569f4d2aa77db69c03f2deb7cfe9cba3f03a4720fea2c4234a2b6d6918e",
       "description": "Take a plan from /launch and ship it. One builder per user story. Runs /verify. Opens PRs. Gates prod on a human. Refuses auth, schema, security, and tenant work. Two modes — full and degrade-with-note.",
       "inputs": [
         "A goal slug pointing to a spec on disk"
@@ -2429,7 +2485,7 @@
       "type": "skill",
       "path": ".claude/skills/eisenhower/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:b27bbd7433bce0a5c42650390615151c227d3c5f3e7b1d180b8a37e5b27664a9",
+      "content_hash": "sha256:cc8c006f3a40aa55d7572fb43c22f0403400cd2d86b82c84c244e7d2d94f2827",
       "description": "Turn open tickets and PRs into a scored Eisenhower matrix — do, schedule, delegate, delete. Anchors 'important' to a goal you name first, so the sort has meaning. Two modes: default (current repo) and --cross-repo.",
       "composes_with": [
         "value-prop",
@@ -2668,7 +2724,7 @@
       "type": "skill",
       "path": ".claude/skills/launch/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:2a950b16e8ef4cdfe2f7f418855c66f5566c48b392dd6e950f83a087669fcd6b",
+      "content_hash": "sha256:ff48cce4bffa2a7044fe009785f53b22a81a975fa8f3351eecb3947b4252a106",
       "description": "Compare variants of an idea. Get a mock gallery. Pick a direction. Get a spec, user stories, and a plan to build. Two sizes — medium and full. Three modes — full, local, scratch.",
       "inputs": [
         "A rough idea or ticket or canvas"
@@ -2791,7 +2847,7 @@
       "type": "skill",
       "path": ".claude/skills/onboard-repo/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:531b910cb45153b939b1f2a74dd1b214d2e87e4575ec3483624fe56510a4563c",
+      "content_hash": "sha256:649967ea7147b4f99b19f273c01d5a2dc976bea778c7ee7fd78a35c77e61505d",
       "description": "Bootstrap the bassclef framework in a new repo. Installs the sync hook. Scaffolds config, whereami, and CLAUDE.md. Modes: default, --with-deploy-host, --with-secrets, --full, --greenfield-from-intent (starts a new repo from a short intent paragraph).",
       "inputs": [
         "Optional flags — --with-deploy-host or --with-secrets or --full"
@@ -2862,7 +2918,7 @@
       "type": "skill",
       "path": ".claude/skills/pre-mortem/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:1fa9299b4f49e8266337bc0923ae49a9a60f29e600486c4f546dec0c06e80088",
+      "content_hash": "sha256:32dcece733673d449bc931a0dd6cacb9ab473c338d7516ff2587b3e35f34113e",
       "description": "Draft a Klein pre-mortem risk ledger for a scope (goal, feature, PR). Two modes: light (3 luminary lenses, 30 min) and full (5-8 lenses, 90 min). Always fires on auth, schema, payments, or compliance work.",
       "inputs": [
         "A goal or feature or PR ref",
@@ -3243,7 +3299,7 @@
       "type": "skill",
       "path": ".claude/skills/sprint/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:01f4217fc9a43008aad80727e45c64a37cbf536685781391473d4ba6397b06ed",
+      "content_hash": "sha256:f9a83bfeacd95de10699fb06bf91aade2200546d2d3511fac2fe780d76d5030f",
       "description": "Show what's in flight and what's next. Reads project state, open issues, and the active goal. Proposes the next sprint at thread level, not just the nearest leaf. Run at session start.",
       "composes_with": [
         "value-prop",
@@ -3380,7 +3436,7 @@
       "type": "skill",
       "path": ".claude/skills/temperance/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:54574fba4e37ffe835a6c97d3123467b284b772a45cf6aed3602651d4739b728",
+      "content_hash": "sha256:ab1dbcb1bfcdb94d590ab32de13af96a155a4fba2f381b57f828b00e257eb161",
       "description": "Pause and think before you code. Asks — am I building the right thing AND building it the right way? Fires before every non-trivial action.",
       "inputs": [
         "Optional scope decision context"
@@ -3871,7 +3927,7 @@
       "type": "standard",
       "path": "standards/lite-manifest-schema-changes.md",
       "tier": "lite",
-      "content_hash": "sha256:94cb2a396222954fed8bc29bbf13dd379c46ae49b983f8d546a83adbc89b1285",
+      "content_hash": "sha256:a9879f5482d3f672b85a519890d387b08f013943a3dd5cee45eacf1230428a3e",
       "description": "Chronological ledger of every lite-manifest schema change. Adopters read this before sync to know what shifted."
     },
     {
@@ -4034,6 +4090,13 @@
       "content_hash": "sha256:fec13744cd05f15144f313fe284c1d471be755bceb2b94e476e0629ffe231c50",
       "description": "Standard directory structure for sunj-labs repositories."
     },
+    {
+      "slug": "prose-marker-format",
+      "type": "standard",
+      "path": "standards/prose-marker-format.md",
+      "tier": "lite",
+      "content_hash": "sha256:8d31a3ddf3d728558650254b88d35552933d6539009faf264c793bc82559d9a8"
+    },
     {
       "slug": "prototype-gallery",
       "type": "standard",

package/dist/lite/standards/prose-marker-format.md

@@ -0,0 +1,105 @@
+---
+tier: lite
+name: prose-marker-format
+version: 1.0
+---
+
+# Prose marker format
+
+Shared marker shape for the bassclef prose scorer stack. Three producers write markers at Stop event. One consumer (`plain-english-steering.sh`) reads them at UserPromptSubmit and injects per-turn numbers.
+
+This standard pins the shape so each producer writes markers the steering injector reads cleanly. Hoare pre/postcondition contract makes the lib `lib/prose-marker.sh` verifiable per Tier 0 tests.
+
+## Sources read
+
+- `.claude/hooks/turn-prose-grade-measure.sh`:153-170 — existing marker shape for `state/markers/turn-grade/last-turn.json`
+- `.claude/hooks/turn-prose-grade-measure.sh`:171-217 — existing marker shape for `state/markers/turn-prose-flags/last-turn.json`
+- `docs/iteration-bets/2026-10-13-longrun-2-scorer-stack-v1.md` — Longrun 2 scope + 7-step plan + RFC folds
+- `docs/rfcs/2026-10-13-longrun-2-scorer-stack-v1-adversarial.md` — RFC O2 + O3 FOLDs (lib shape); N1 FOLD (glyph legend); F2 architect-review AMBER (Hoare contract fold)
+- `docs/audits/2026-10-13-plain-english-steering-baseline.md` — baseline numbers that pin the thresholds
+- `.claude/luminaries/tony-hoare.md` — pre/postcondition contract shape (anchor)
+- `.claude/luminaries/john-ousterhout.md` — deep module single interface (anchor)
+
+## Marker shape
+
+Each prose marker lands at `state/markers/<scorer-name>/last-turn.json` and conforms to this JSON shape:
+
+```json
+{
+  "metric": "<name>",
+  "value": <number>,
+  "measured_at": "<ISO-8601 UTC timestamp>",
+  "glyph": "🟢" | "🟡" | "🔴",
+  "threshold_green": <number>,
+  "threshold_amber": <number>,
+  "source": "<producer hook name>",
+  "notes": "<optional one-line note>"
+}
+```
+
+Required fields — `metric`, `value`, `measured_at`, `source`.
+Optional fields — `glyph`, `threshold_green`, `threshold_amber`, `notes`.
+
+## Hoare pre/postcondition contract
+
+Per `lib/prose-marker.sh`:
+
+### `write_prose_marker <scorer-name> <value> [notes]`
+
+- **Precondition** — `scorer-name` is a non-empty string matching `[a-z-]+`. `value` is a number (integer or float). Working directory is a bassclef repo root with `state/markers/` writable.
+- **Postcondition** — a file at `state/markers/<scorer-name>/last-turn.json` exists AND contains valid JSON matching the marker shape above AND has `measured_at` as a fresh ISO-8601 timestamp AND atomic write via `mv` from temp file (no partial writes visible).
+- **Invariant** — a prior marker at the same path is overwritten atomically; no race condition for concurrent writers (different scorer names write to different directories).
+
+### `read_prose_markers [--max-age-minutes N] <scorer-name> [<scorer-name> ...]`
+
+- **Precondition** — zero or more `scorer-name` arguments. Each is a non-empty string matching `[a-z-]+`. Working directory is a bassclef repo root.
+- **Postcondition** — stdout emits one JSON object. Keys are scorer names. Values are either the marker object (parsed from disk) OR `null` if the marker file does not exist OR is older than `max-age-minutes` (default 10) OR fails to parse as JSON.
+- **Invariant** — any read failure returns `null` for that scorer without crashing the whole call. Fail-soft per Nygard.
+
+## Scorer registry
+
+The initial scorer stack carries three metrics:
+
+| Scorer name | Metric | Marker path | Producer hook | Green threshold | Amber threshold |
+|---|---|---|---|---|---|
+| `grade` | Flesch-Kincaid grade level | `state/markers/turn-grade/last-turn.json` | `turn-prose-grade-measure.sh` | ≤8 | ≤10 |
+| `density` | Non-standard hyphenated-compound count per turn | `state/markers/turn-prose-density/last-turn.json` | `turn-prose-density-measure.sh` | 0 | ≤3 |
+| `appositive_misses` | Session-invented shorthand without adjacent appositive per turn | `state/markers/turn-prose-appositive/last-turn.json` | `turn-prose-kiss-check.sh` (Step 2c extension) | 0 | ≤2 |
+
+Thresholds grounded against baseline numbers at `docs/audits/2026-10-13-plain-english-steering-baseline.md`:
+
+- Grade — target band is 6-8; ceiling is 10 (baseline mean 7.6; 19% past ceiling)
+- Density — non-standard hyphen compounds; baseline mean 4.1/turn; green=0 reflects clean prose; amber=3 is the baseline mean floor
+- Appositive misses — baseline mean 0.95/turn; green=0 reflects every shorthand glossed; amber=2 picks up the 10-30% miss tail
+
+## Glyph legend
+
+- 🟢 — value at or below `threshold_green`; clean
+- 🟡 — value between `threshold_green` and `threshold_amber`; drift zone
+- 🔴 — value above `threshold_amber`; action needed
+
+Rendering at `plain-english-steering.sh` injection — one line per scorer:
+
+```
+[prose: grade 7.2 🟢 density 4 🟡 appositive 2 🟡]
+```
+
+Cap at 160 chars total per injection line. If a scorer marker reads `null` (missing or stale), its field omits from the injection line.
+
+## Density allowlist (standard-tech exclusions)
+
+The density scorer excludes 25 standard-tech hyphenated compounds. These never count toward density:
+
+```
+pre-commit, real-time, data-driven, end-to-end, fire-and-forget,
+run-time, compile-time, read-only, write-only, fail-soft,
+fail-fast, post-commit, pre-push, post-merge, op-ed,
+self-test, self-check, re-read, re-run, re-fire,
+op-cost, copy-paste, cut-off, set-up, built-in
+```
+
+**Follow-on refinement.** Architect-review AMBER F4 flagged this list as author-curated. Grounding sampled from top-20 hyphenated compounds across 10 session transcripts lands as a follow-on PR after `turn-prose-density-measure.sh` ships. Baseline list ships as above for V1.
+
+## Change log
+
+- 2026-10-12 — v1.0 initial format. Grade + density + appositive scorers. Hoare contract on lib. Glyph legend. Follow-on allowlist grounding.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebassclef/lite",
-  "version": "1.9.16",
+  "version": "1.9.18",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",