Skip to content

feat(labels): plain-sentence policy labels, install warnings and witness notes (VOICE-3a) - #305

Merged
jothimani-rajendran merged 3 commits into
mainfrom
voice-3a-plain-labels
Oct 19, 2026
Merged

jothimani-rajendran merged 3 commits into
mainfrom
voice-3a-plain-labels

Conversation

@jothimani-rajendran

Copy link
Copy Markdown
Collaborator

What

VOICE-3a (org-plan plan/site-plain-voice.md). This PR rewrites the label and warning text that the site and chock install show, following the voice style guide in org-plan discovery/2026-10-18-site-voice-audit.md. The new text has no semicolon chains, no colon chains, and no jargon such as "judged", "fails open" or "witnessed". No label claims more than it did before, every caveat is kept, and "tested" (seen in a live run) stays separate from "vendor docs only".

  • plugin/bundle_grade.py: changes the advisory text and the Stop-only gate reach ("blocks at turn end only. It does not check a file write when it happens"). A guard next to a gate is now joined with ". " instead of "; ".
  • install/package.py and install.json: the tier-table prefix now reads "best-effort, and a hook error lets the action through (agentseam vendor-docs): " instead of "fail mode open". The words for each fail mode now live in data. The unasked note becomes ". The ask is not enforced here (…)".
  • Devin's prefix (install.json and bundle_build._QUALIFIER) is rewritten the same way.
  • install/data/warnings.json: 15 warnings, install/data/claude_plugin.json: 6 strings, and data/witnesses.json: 6 plugin-hook witness notes. Quoted output, ids, record paths and commits are unchanged.
  • Tests that assert exact copy now assert the new text, just as strictly. The plugin_targets goldens were regenerated with CHOCK_REGEN_GOLDENS=1 on Python 3.13.
  • CHANGELOG.md is not edited. A changelog.d/ fragment is added instead.

The words the site's label tags match on ("shell command", "file writes", "turn end", "advisory") are kept. chock-catalog's tools/label_honesty.py is updated in the companion catalog PR so it reads both the old and the new wording.

Definition of done

  • chock sync --repo . --check clean
  • pytest -q (Python 3.13): 4683 passed, 97 skipped, 1 failed on the first run (the 300-line budget in test_plugin_install_targets.py). That is fixed in the third commit, and the file and test_repo_standards.py were re-run: 44 passed.
  • Touched manifests: none. A changelog.d/voice-3a-plain-labels.md fragment is added.
  • ruff check and ruff format --check clean on src and tests. tools/check_literal_duplication.py is clean.
  • chock check and the acceptance suite were not run locally. CI runs them.

Claims

  • No surface is described as enforcing more than it installs. Only wording changed. Grades and keywords are unchanged.

Owner approval gate: this PR stays in draft until the owner approves the wording list in the org-plan handoff.


Generated by Claude Code

jothimani-rajendran and others added 3 commits October 19, 2026 00:28
…ess notes (VOICE-3a)

Rewrites the label text chock install prints and the catalog registry reads
(bundle_grade grade texts, the Devin and tier-table prefixes, the unasked
note), the client warnings in install/data/warnings.json, the Claude Code
plugin offer text, and the plugin-hook witness notes, per the org-plan voice
style guide: no semicolon chains, no "judged" or "fails open". No label
claims more than before and every caveat stays. Tests asserting exact copy
move to the new text; plugin_targets goldens regenerated with
CHOCK_REGEN_GOLDENS=1 on Python 3.13.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com>
…(VOICE-3a)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com>
…OICE-3a review)

"no live run has shown a chock install working" claimed more than the
original "chock has not witnessed"; it now reads "chock has not seen an
install work in this client in a live run".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com>
@jothimani-rajendran
jothimani-rajendran marked this pull request as ready for review October 19, 2026 01:10
@jothimani-rajendran
jothimani-rajendran merged commit 368f581 into main Oct 19, 2026
26 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant