Skip to content

feat: --note on claims, carried wherever the lock is named (0.6.0) - #30

Merged
flyingrobots merged 1 commit into
mainfrom
feat/claim-note
Sep 16, 2026
Merged

flyingrobots merged 1 commit into
mainfrom
feat/claim-note

Conversation

@flyingrobots

Copy link
Copy Markdown
Member

Roadmap item 4 (#8).

claim --note <text>, with --note <text>, and note: in a batch record store one line saying why the lock is held. It is carried on every line that names the lock: the claim line, show, list, check on a held or expired path, and the refusal another claimant gets, which can now read "held by alice: building the release bundle" rather than just "held by alice". extend and a child admission (the parent's family bump rewrites its record) keep it.

  • One optional field in the record (note: after acquisition:, before paths:) and one optional note property in the schema on claim_line, list_line, check_line (held and expired only; the free branch forbids it) and the held variant of refusal_line. No new refs.
  • A note is one line; a newline is a usage error (exit 2, nothing claimed). An empty --note is no note. When there is no note the key is absent from every line, which the tests assert.
  • describe exposes D_NOTE_JSON, an empty string or ,"note":"…", spliced after the holder wherever a lock is rendered, so the render paths stay fork-free.

Tests written first: fifteen RED, then 392 green, lint clean. Version 0.6.0.

Closes #8

claim --note <text>, with --note, and note: in a batch record store one
line saying why the lock is held. It rides on the claim line, show,
list, check on a held or expired path, and the refusal another claimant
gets, which can now read "held by alice: building the release bundle"
rather than just "held by alice". extend and a child admission keep it
through the record rewrite. A note is one line; empty means none, and
the key is absent from every line when there is none. Optional in the
schema. Version 0.6.0.

Closes #8
@coderabbitai

coderabbitai Bot commented Sep 16, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 10 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: ef18ae46-e2dd-4c7f-8f8f-6e8d91871b16

📥 Commits

Reviewing files that changed from the base of the PR and between 450c4f7 and f1670bb.

📒 Files selected for processing (16)
  • CHANGELOG.md
  • README.md
  • bin/git-locks
  • lib/000-prelude.sh
  • lib/030-time-refs-records.sh
  • lib/050-the-snapshot.sh
  • lib/070-refusals.sh
  • lib/080-families.sh
  • lib/090-claim-planning.sh
  • lib/100-batch.sh
  • lib/120-check.sh
  • lib/130-list-show-ttl.sh
  • lib/140-extend.sh
  • lib/160-with.sh
  • schema/git-locks.schema.json
  • test/test.sh

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.

@flyingrobots
flyingrobots merged commit cddcd6e into main Sep 16, 2026
3 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.

A --note on claims, shown in refusals

1 participant