Skip to content

chore(docs): advance terminal docs pin (CTX-1318) - #2214

Merged
Xuepoo merged 1 commit into
mainfrom
ctx-1318/chore-docs-pin
Oct 18, 2026
Merged

Xuepoo merged 1 commit into
mainfrom
ctx-1318/chore-docs-pin

Conversation

@Xuepoo

@Xuepoo Xuepoo commented Oct 18, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Advance the docs gitlink pin to Terminal Docs main
2b027ccddc318e882e19af0b81d48b355bb8eb9d, the head that includes the
specification-spine repair for interfaces/provider-contracts.md (docs PR
bitty-terminal/bitty-terminal-docs#244).

Re-audit (CTX-1318 method)

Re-audit of the pin range 14da6142..2b027ccdd against product base
c432da86 returns CLEAN. All named findings are repaired at the target:

Finding Defect Verdict
F1 specifications/ligature-decision.md promoted draft RFC / PB-6 claim REPAIRED
F2 architecture/extension-execution-mediation.md stale confinement/spawn-ledger REPAIRED
F3 interfaces/cli.md documented removed --no-splash REPAIRED
F4 specifications/small-core-capability-floor.md stale piccolo dependency REPAIRED
F5 interfaces/cli.md residual pending-merge wording REPAIRED
F6 IME status index row over-declaration (specifications/README.md) REPAIRED
F7 interfaces/provider-contracts.md missing specification spine REPAIRED (docs #244)

Between 6ff51249 (prior audit target) and 2b027ccdd, the only changed file
is interfaces/provider-contracts.md, which now carries the full specification
spine.

Change

Single docs gitlink entry: 14da6142 -> 2b027ccdd.

Closes #2207

Summary by CodeRabbit

  • Documentation
    • Updated the documentation reference. No application features or behavior changes are noted in this update.

Advance the `docs` gitlink from 14da6142 to Terminal Docs main
2b027ccddc318e882e19af0b81d48b355bb8eb9d, the head that includes the
specification-spine repair for interfaces/provider-contracts.md (docs PR #244).

Re-audit of the pin range 14da6142..2b027ccdd against product base c432da8
returns CLEAN: findings F1 (ligature-decision draft/PB-6), F2
(extension-execution-mediation confinement/spawn-ledger), F3 (cli --no-splash),
F4 (small-core-capability-floor piccolo), F5 (cli pending-merge wording), F6
(IME status index row), and F7 (provider-contracts specification spine) are all
repaired at the target.

Closes #2207
@Xuepoo Xuepoo added chore Chore / maintenance P1 Priority: high area:docs Area: documentation labels Oct 18, 2026
@Xuepoo Xuepoo added this to the 0.0.24 milestone Oct 18, 2026
@coderabbitai

coderabbitai Bot commented Oct 18, 2026

Copy link
Copy Markdown

Review in Change Stack →

Note

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

⚙️ Run configuration
  • Configuration used: Repository UI (base), Organization UI (inherited)
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 2148b5b7-8890-4370-9697-ab94298a02cc
📥 Commits

Reviewing files that changed from the base of the PR and between c432da8 and e1166db.

📒 Files selected for processing: 1
  • docs
+-------------------------------------------+
| I am a verified code reviewer on Twitter. |
+-------------------------------------------+
  \
   \   (\__/)
       (•ㅅ•)
       /   づ
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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.

@Xuepoo Xuepoo left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Independent review — LGTM (separate agent, not the author)

Reviewed head: e1166db477f2fafa576df2f5bfe88cbd10fab4aa (branch ctx-1318/chore-docs-pin).

Checks performed (numbered, exit codes captured directly — not through a pipe):

  1. gh pr view 2214 --json ... — files = docs only (+1/-1, MODIFIED); labels chore,P1,area:docs; milestone 0.0.24; body closes #2207.
  2. gh pr diff 2214 — the single gitlink line index 14da6142..2b027ccd 160000; no other path touched.
  3. bitty-terminal-docs origin/main = 2b027ccddc318e882e19af0b81d48b355bb8eb9d — exact match to the new pin.
  4. git ls-tree e1166db4 -- docs → 160000 commit 2b027ccddc318e882e19af0b81d48b355bb8eb9d docs — new pin is a real reachable commit in the gitlink slot (a gitlink cannot be cat-ed as a blob; git show :docs = 128 is expected, not a defect).
  5. git merge-base --is-ancestor 14da6142 origin/main → RC=0 — the old pin is a true ancestor of the new pin (forward range advance, no rewind).

All judgements pass: diff is gitlink-only; new pin == current Terminal Docs main; forward advance only; real commit; labels/milestone present. Cumulative pin audit (CTX-1318 method) verdict at 2b027cc was CLEAN for F1–F7. Docs mount is an unbuilt submodule pin, so this change cannot affect build or test outcomes.

Verdict: LGTM — merge gate: green checks + this verdict (docs/gitlink-only, --admin).

@Xuepoo
Xuepoo merged commit 0316190 into main Oct 18, 2026
14 of 15 checks passed
@Xuepoo
Xuepoo deleted the ctx-1318/chore-docs-pin branch October 18, 2026 03:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Area: documentation chore Chore / maintenance P1 Priority: high

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Synchronize terminal documentation pin for 0.0.24 after cumulative audit

1 participant