Skip to content

docs: README points at the chock.sh builder (RP-1) - #15

Draft
jothimani-rajendran wants to merge 3 commits into
mainfrom
rp-1-pointer-readme
Draft

jothimani-rajendran wants to merge 3 commits into
mainfrom
rp-1-pointer-readme

Conversation

@jothimani-rajendran

Copy link
Copy Markdown
Collaborator

RP-1 for chock-codex-plugins: README only. Replaces Install and "What you get" with the builder pointer, the Codex migration, the archive date line, and a 31-row table of builder links (one policy each, client codex).

Catalog pin: chock-catalog main e885f918a335e20dfddb4fad0331d4d5b4c5eb43 (2026-10-21). Rows use the catalog's current version of each policy, which is newer than PLUGINS.md lists for all 31.

Measured

  • Codes decoded: 31/31 passed selection.load(url) from the generator, and 31/31 again from the links committed in README.md (chock 0.15.2 installed from main).
  • Files changed: 1 (README.md). PLUGINS.md, plugin folders, workflows and lockfile untouched.
  • CI: unmeasured at PR creation.

Removal commands

  • Delete the [marketplaces.chock-codex] table from ~/.codex/config.toml: taken from this README's own Install section, not run (no Codex here): unverified.
  • Remove each plugin in the Codex Plugins UI: unverified.
  • Hooks trusted in /hooks: unverified.

Generator (not committed)

Run: python -I gen.py <catalog checkout> e885f918a335e20dfddb4fad0331d4d5b4c5eb43 PLUGINS.md

import base64, json, re, sys
from pathlib import Path
import yaml
from chock.scaffold.add import verified_pack
from chock.install import selection

CAT = Path(sys.argv[1]); REF = sys.argv[2]; PLUGINS = Path(sys.argv[3])
SRC = "https://github.com/open-coder-ai/chock-catalog"
BUILDER = "https://chock.sh/coding/builder/"
reg = {p["id"]: p for p in yaml.safe_load((CAT / "registry.yaml").read_text())["policies"]}
rows = []
for line in PLUGINS.read_text().splitlines():
    m = re.match(r"\| \[`([a-z0-9-]+)`\]\(\S+\) \| (\S+) \| (\S+) \|", line)
    if m: rows.append(m.groups())
out = []
for pid, published, mode in rows:
    _, _, sha = verified_pack(CAT, pid, None)
    sel = {"schema": 2, "client": "codex", "bundle": {"version": "1.0.0"},
           "catalog": {"source": SRC, "ref": REF},
           "policies": [{"from": "catalog", "id": pid, "version": str(reg[pid]["version"]), "sha256": sha}]}
    code = base64.urlsafe_b64encode(json.dumps(sel, separators=(",", ":")).encode()).decode().rstrip("=")
    url = f"{BUILDER}#s={code}"
    got = selection.load(url)
    assert [p["id"] for p in got["policies"]] == [pid] and got["client"] == "codex"
    out.append((pid, published, str(reg[pid]["version"]), mode, url))
print(f"PASSED {len(out)}/{len(rows)}", file=sys.stderr)
print("| policy | in Codex | builder |\n| :--- | :--- | :--- |")
for pid, pub, ver, mode, url in out:
    print(f"| `{pid}` | {mode} | [open in the builder]({url}) |")

Handoff

Draft org-plan PR from branch handoff-rp-1-codex (file handoff/2026-10-21-chock-codex-plugins-rp-1-pointer-readme.md).


Generated by Claude Code

Replace the Install and "What you get" sections with a pointer to the chock.sh
builder, the Codex migration steps, the archive date line and a per-policy
builder link table. PLUGINS.md, plugin folders, workflows and the lockfile are
unchanged.

Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com>

jothimani-rajendran commented Oct 21, 2026 •

Copy link
Copy Markdown
Collaborator Author

verify (Generated-only) fails in chock marketplace build, not in anything this PR changes: EvidenceError: claim table: agent='factory_droid' is not one of ('aider', ..., 'codex_cli', ...), raised from catalog_page.py while rendering PLUGINS.md. The same workflow was already red on main at b836866 (run 39344190493, 2026-10-19), so the base is red too; this PR only edits README.md, which the check does not compare.

No fix exists yet: it needs the catalog's .framework-ref and the engine's claim table to agree on factory_droid, and workflows and .framework-ref are outside RP-1. I re-ran the failed job once; if it fails again I will leave this PR as is and the orchestrator decides.


Generated by Claude Code

Copy link
Copy Markdown
Collaborator Author

Reviewed: README-only, 31 of 31 builder links decode with the engine's own loader, no generated file touched. Stays a draft until chock.sh launch day per org-plan plan/retire-plugin-repos.md.

The failing verify check (Generated-only) is not this PR's. It is red on main on every run since run 23 (2026-09-23): the job rebuilds the published tree against the catalog's moving main with the framework the catalog pins, and the catalog's claim table now names factory_droid, an agent the pinned framework's matrix does not know (chock.evidence.EvidenceError in the job log, before any diff is taken). A README change cannot affect it. No fix is ported: the only fix is a republish, and this repository is being retired instead (RP-4 removes the generated trees and this workflow after the grace period).


Generated by Claude Code

Replace "moved, stops publishing, archived" with the two routes: this
marketplace (no chock on the machine, republished with every chock
release) and the chock.sh builder (one plugin, needs pip install chock).
Never install the same policy by both, since each copy runs its hook.
README.md is hand-written, so no generator change is needed.

Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com>
cmd.exe passes single quotes literally, so print the selection command
unquoted. The plugins' hooks need git, a usable bash and Python 3.11+,
so say so instead of "nothing else".

Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com>
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