Skip to content

docs: migrate legacy h5i commands to noun-verb API forms#139

Merged
Koukyosyumei merged 1 commit into
mainfrom
update-manuals
Jun 15, 2026
Merged

docs: migrate legacy h5i commands to noun-verb API forms#139
Koukyosyumei merged 1 commit into
mainfrom
update-manuals

Conversation

@Koukyosyumei

Copy link
Copy Markdown
Collaborator

Rewrite legacy top-level command invocations (h5i context/commit/claims/ log/blame/notes/memory/push/pull/...) to the canonical noun-verb forms (h5i recall/capture/audit/share ...) across all markdown, the man page, HTML docs/blog/guides, and the auto-generated agent prompts. Keep the H5I_CLAUDE/CODEX_INSTRUCTIONS constants byte-identical to their checked-in copies (.claude/h5i.md, AGENTS.md). Fully migrate MANUAL.md's reference catalog (headings + TOC anchors + synopses) and fix a pre-existing broken [h5i hooks] TOC anchor. Deprecation prose, MCP tool names, ref paths, SEO keywords, and no-equivalent commands left intentionally unchanged.

Rewrite legacy top-level command invocations (h5i context/commit/claims/
log/blame/notes/memory/push/pull/...) to the canonical noun-verb forms
(h5i recall/capture/audit/share ...) across all markdown, the man page,
HTML docs/blog/guides, and the auto-generated agent prompts. Keep the
H5I_CLAUDE/CODEX_INSTRUCTIONS constants byte-identical to their checked-in
copies (.claude/h5i.md, AGENTS.md). Fully migrate MANUAL.md's reference
catalog (headings + TOC anchors + synopses) and fix a pre-existing broken
[h5i hooks] TOC anchor. Deprecation prose, MCP tool names, ref paths,
SEO keywords, and no-equivalent commands left intentionally unchanged.
@Koukyosyumei

Copy link
Copy Markdown
Collaborator Author

Caution

🚨 BLOCK MERGE — 3 credential leaks detected

Rotate the exposed secrets and remove them from history before merging. The h5i audit found 3 findings in this branch's diff. Full details in the table below.

Caution

3 credential leaks across 1 commit — rotate the exposed secrets before merging.

Rule File Line Preview Commit
CREDENTIAL_LEAK src/objects.rs 120 ghp_… c5cdfe77
CREDENTIAL_LEAK src/objects.rs 141 ghp_… c5cdfe77
CREDENTIAL_LEAK tests/env_integration.rs 1295 ghp_… c5cdfe77

🪙 4% AI-authored · 1 file

1 AI commit · 🔒 3 secrets · 🔁 13 duplicates

1 / 2511 : 15.01 / 2
AI commitsfiles touchedREAD : EDITTHINKs / ops

💬 The ask

"Update all markdown, man, docs (md+html), and auto-generated system prompts to use new APIs like 'h5i recall context' instead of legacy 'h5i context'."

📍 What shipped

  • ✓ Fixed Stop hook protocol output: auto-checkpoint status is quiet under h5i hook stop, with regression coverage.
  • ✓ Patched env sandbox Cargo support: parent Cargo.toml discovery grant, in-work Cargo target/install dirs, and narrow Cargo cache grants.
  • ✓ Tightened Cargo sandbox patch: keep parent Cargo.toml read and in-work CARGO_TARGET_DIR, remove Cargo install/root and host Cargo cache writ…
  • ✓ Added h5i env propose/apply integration tests for no-op proposals and patch-mode apply
  • ✓ Added env propose integration tests for no-op proposals and idempotent re-propose behavior

Warning

Duplicate code introduced in 4 files — consider extracting a helper before this lands.

File Block First → Repeat Commit
src/container.rs 10 lines L259 → L299 2dc79de3
src/container.rs 10 lines L330 → L355 2dc79de3
src/container.rs 10 lines L261 → L401 2dc79de3
src/container.rs 10 lines L195 → L277 d7f52dfe
src/container.rs 10 lines L576 → L651 c5cdfe77
src/env.rs 10 lines L453 → L512 2dc79de3
src/env.rs 10 lines L478 → L537 2dc79de3
src/env.rs 10 lines L996 → L1080 c5cdfe77
src/env.rs 10 lines L1766 → L1905 c5cdfe77
src/main.rs 10 lines L1254 → L1297 e9cc08b1
src/structured.rs 10 lines L486 → L616 e9cc08b1
src/structured.rs 10 lines L486 → L888 e9cc08b1
src/structured.rs 10 lines L486 → L977 e9cc08b1
🧠 Reasoning by file — 5847 nodes across 2 lanes, latest 24 only
%%{init: {"flowchart": {"nodeSpacing": 42, "rankSpacing": 48, "diagramPadding": 14}, "themeVariables": {"fontSize": "18px"}} }%%
flowchart TB
  subgraph lane_0["💭 Reasoning · 8 steps"]
    direction LR
    n_lane_0_0["THINK · I'll start by understanding the actual current CLI structure (to know th…"]:::t
    n_lane_0_1["THINK · Now I'll verify correctness: (1) the Rust constants still compile, (2) c…"]:::t
    n_lane_0_2["THINK · But I need to confirm cargo check actually passed (the exit code came fr…"]:::t
    n_lane_0_3["THINK · Now let me scan for any *missed* legacy invocations — focusing on forms …"]:::t
    n_lane_0_4["THINK · I need to know whether that reference design (per-command pages under le…"]:::t
    n_lane_0_5["THINK · To fully honor ”use new APIs” and match the man page, I should migrate t…"]:::t
    n_lane_0_6["THINK · This is the one remaining decision I can't infer — and it's a large, lin…"]:::t
    n_lane_0_7["THINK · Let me confirm the single `h5i-hooks` anchor orphan is pre-existing (not…"]:::t
    n_lane_0_0 --> n_lane_0_1
    n_lane_0_1 --> n_lane_0_2
    n_lane_0_2 --> n_lane_0_3
    n_lane_0_3 --> n_lane_0_4
    n_lane_0_4 --> n_lane_0_5
    n_lane_0_5 --> n_lane_0_6
    n_lane_0_6 --> n_lane_0_7
  end
  subgraph lane_1["📄 MANUAL.md · 16 ops"]
    direction LR
    n_lane_1_0["EDIT × 14"]:::a
    n_lane_1_1["READ"]:::o
    n_lane_1_2["EDIT"]:::a
    n_lane_1_0 --> n_lane_1_1
    n_lane_1_1 --> n_lane_1_2
  end
  classDef o fill:#dbeafe,stroke:#1e3a8a,color:#0b1c4a;
  classDef t fill:#fef3c7,stroke:#92400e,color:#3f2d05;
  classDef a fill:#dcfce7,stroke:#166534,color:#0a2e16;
  classDef n fill:#ede9fe,stroke:#5b21b6,color:#221251;
  classDef m fill:#e5e7eb,stroke:#374151,color:#0b0f17;
Loading

Note

🪙 Token reduction — 13 captured tool outputs kept out of context: 25818 → 13064 tokens (49% saved, 12754 tokens). Full output is recoverable with h5i recall object.

By tool
Tool Captures Raw Summary Saved
bash 12 16221 8630 46%
git 1 9597 4434 53%

📜 Per-commit provenance

0f95f5d5 docs: migrate legacy h5i commands to noun-verb API forms

  • promptUpdate all markdown, man, docs (md+html), and auto-generated system prompts to use new APIs like 'h5i recall context' instead of legacy 'h5i context'.
  • model claude-opus-4-8 · agent claude-code

Generated by h5i · re-run h5i share pr post to refresh.

@Koukyosyumei Koukyosyumei merged commit 6869924 into main Jun 15, 2026
5 checks passed
@Koukyosyumei Koukyosyumei deleted the update-manuals branch June 15, 2026 02:02
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