Skip to content

Rebuild the Docket from its verdicts, with social previews - #6

Merged
nicobts merged 1 commit into
mainfrom
feat/docket-pipeline
Sep 23, 2026
Merged

nicobts merged 1 commit into
mainfrom
feat/docket-pipeline

Conversation

@nicobts

@nicobts nicobts commented Sep 23, 2026 •

Copy link
Copy Markdown
Owner

Published entries were frozen copies of an older page, so Docket #1
still carried the pre-redesign layout, and a shared verdict link had no
preview at all: no title, no description, no image.

  • tools/docket-build.js rebuilds every docket/*/index.html and card.svg
    (and card.png where a browser exists) from that entry's verdict.json,
    with absolute og:/twitter: metadata pointing at the entry and its card.
    --check fails when an entry is stale.
  • The verdict page's meta block is a marked region the builder fills, so
    a published entry carries one title, the tally and summary as its
    description, and the card as its preview image.
  • The helper exports its builders (it only runs the CLI when executed
    directly) so the tool shares one implementation of the page and card.
  • CI rebuilds the Docket in check mode, and rejects any change to a
    published verdict.json: the record stands, the page around it improves.
  • Rebuilt entry Restructure as a self-contained Agent Skill and Claude Code plugin #1 accordingly; its verdict.json and README are
    untouched.

Summary by CodeRabbit

  • New Features
    • Published verdict pages now provide titles and preview metadata for search engines and social platforms, including a large-image preview when available.
  • Documentation
    • Docket entry guidance now explains that published pages and preview cards are generated from verdicts and should not be edited manually.
  • Bug Fixes
    • Checks now catch outdated published pages and cards, and prevent changes to published verdicts.

Published entries were frozen copies of an older page, so Docket #1
still carried the pre-redesign layout, and a shared verdict link had no
preview at all: no title, no description, no image.

- tools/docket-build.js rebuilds every docket/*/index.html and card.svg
  (and card.png where a browser exists) from that entry's verdict.json,
  with absolute og:/twitter: metadata pointing at the entry and its card.
  --check fails when an entry is stale.
- The verdict page's meta block is a marked region the builder fills, so
  a published entry carries one title, the tally and summary as its
  description, and the card as its preview image.
- The helper exports its builders (it only runs the CLI when executed
  directly) so the tool shares one implementation of the page and card.
- CI rebuilds the Docket in check mode, and rejects any change to a
  published verdict.json: the record stands, the page around it improves.
- Rebuilt entry #1 accordingly; its verdict.json and README are
  untouched.
@coderabbitai

coderabbitai Bot commented Sep 23, 2026

Copy link
Copy Markdown

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: cc5a7f32-a8de-4e97-8394-c4da02f54dd2

📥 Commits

Reviewing files that changed from the base of the PR and between 8b5d117 and 61f5f02.

⛔ Files ignored due to path filters (2)
  • docket/001-shiproom/card.png is excluded by !**/*.png
  • docket/001-shiproom/card.svg is excluded by !**/*.svg
📒 Files selected for processing (8)
  • .github/workflows/validate.yml
  • AGENTS.md
  • CONTRIBUTING.md
  • docket/001-shiproom/index.html
  • skills/shiproom/assets/dashboard.html
  • skills/shiproom/scripts/shiproom.js
  • tests/shiproom.test.js
  • tools/docket-build.js
 ______________
< Bugs begone! >
 --------------
  \
   \   \
        \ /\
        ( )
      .( o ).
✨ Finishing Touches
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@nicobts
nicobts merged commit fe4bff2 into main Sep 23, 2026
5 of 6 checks passed
@nicobts
nicobts deleted the feat/docket-pipeline branch September 23, 2026 13:45
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