Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 15 additions & 1 deletion .ledger/entries/0195-prepare-v0-9-4.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,17 @@ files:
- "package-lock.json"
- ".ledger/releases/v0.9.4.md"
- "docs/HANDOFF.md"
- "README.md"
- "assets/readme/adopt.svg"
docs:
- "docs/HANDOFF.md"
- "README.md"
docsImpact:
status: "updated"
reason: "The handoff records the prepared release, what the stale fix changes for adopters, and the Kore pin bump and record cleanup that follow it."
reason: "The handoff records the prepared release and what follows it, and the README's pinned npx commands, action version, and adopt card move to the new version."
docs:
- "docs/HANDOFF.md"
- "README.md"
commits: []
related:
- "0192"
Expand Down Expand Up @@ -56,6 +60,16 @@ pin moves, so the slice is prepared for the tag-driven workflow.
- On conflict: The tag must match the package version or the release workflow
fails its version check.

### Pinned version in the README

- Files: `README.md`, `assets/readme/adopt.svg`
- Changed: the quick start's pinned `npx` commands, the global install line,
the action reference, and the version the adopt card shows, which
`scripts/readme-assets.mjs` takes from `package.json`.
- Anchor: `In any other repository`
- On conflict: The README's pinned version and the card must match
`package.json`, which the `readme:check` job enforces.

### Handoff

- Files: `docs/HANDOFF.md`
Expand Down
18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -224,12 +224,12 @@ Run the published package through npx, pinned to a version, so an agent never
reaches a different program named `ledger` on its `PATH`:

```bash
npx --yes @kylebegeman/ledger@0.9.3 adopt
npx --yes @kylebegeman/ledger@0.9.3 hooks install --host claude-code \
--command "npx --yes @kylebegeman/ledger@0.9.3" --import-agents
npx --yes @kylebegeman/ledger@0.9.3 hooks install --host codex --launcher
npx --yes @kylebegeman/ledger@0.9.3 skills install
npx --yes @kylebegeman/ledger@0.9.3 agents --write
npx --yes @kylebegeman/ledger@0.9.4 adopt
npx --yes @kylebegeman/ledger@0.9.4 hooks install --host claude-code \
--command "npx --yes @kylebegeman/ledger@0.9.4" --import-agents
npx --yes @kylebegeman/ledger@0.9.4 hooks install --host codex --launcher
npx --yes @kylebegeman/ledger@0.9.4 skills install
npx --yes @kylebegeman/ledger@0.9.4 agents --write
```

`adopt` reads the tracked tree and writes a configuration that fits it: which
Expand All @@ -243,7 +243,7 @@ Starting the pinned package through npx costs about 0.3 seconds per hook. On
an Apple silicon Mac, a PostToolUse hook took 0.47 seconds through npx and
0.17 seconds from an installed copy. The first call after a version change
also downloads the package. On a machine where no other program is named
`ledger`, `npm install --global @kylebegeman/ledger@0.9.3` and
`ledger`, `npm install --global @kylebegeman/ledger@0.9.4` and
`--command ledger` save that time. The hooks are committed, though, so every
contributor then needs the same install. The npx pin works on any machine
with Node.
Expand Down Expand Up @@ -306,9 +306,9 @@ jobs:
- uses: actions/checkout@v6
with:
fetch-depth: 0
- uses: kylebegeman/ledger@v0.9.3
- uses: kylebegeman/ledger@v0.9.4
with:
command: npx --yes @kylebegeman/ledger@0.9.3
command: npx --yes @kylebegeman/ledger@0.9.4
```

The action runs the latest published CLI unless `command` pins it. Set
Expand Down
2 changes: 1 addition & 1 deletion assets/readme/adopt.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 8 additions & 6 deletions docs/HANDOFF.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,12 +21,14 @@ fixes. "Next slices" lists what is left.
scratch repository, passed a SessionStart payload through it, and passed
doctor's hooks check. Receipt 0192 is unreleased.
`@kylebegeman/dossier` (0.7.2) publishes the same way from its own repo.
- Prepared, not published: 0.9.4 on branch `stale-patterns`,
kylebegeman/ledger#35, gate green and checks passing. It carries receipts
0193 and 0194, which stop `ledger stale` from reading a record as drift when
it points at files by pattern, by directory, or by path, plus 0192 and the
prepare receipt 0195. Publishing waits on Kyle: merge, then
`git tag v0.9.4 && git push origin v0.9.4`.
- Merged, not published: 0.9.4 is on `master` from kylebegeman/ledger#35. It
carries receipts 0193 and 0194, which stop `ledger stale` from reading a
record as drift when it points at files by pattern, by directory, or by
path, plus 0192 and the prepare receipt 0195. Publishing waits on Kyle:
`git tag v0.9.4 && git push origin v0.9.4` on the merged `master`. The
README's pinned version and the adopt card follow `package.json`, so they
move in the same slice; kylebegeman/ledger#36 carries that move and the
`readme:check` job is red on `master` until it lands.
- First outside adopter: Kore runs Ledger 0.9.3 with Claude Code and Codex
hooks since kylebegeman/forge#33 (Kore receipt 0011). Before that it ran
0.9.2 from kylebegeman/forge#32, 0.9.1 from #31, 0.9.0 from #30, 0.8.2
Expand Down
Loading