docs: migrate legacy h5i commands to noun-verb API forms#139
Conversation
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.
|
Caution 🚨 BLOCK MERGE — 3 credential leaks detectedRotate 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.
🪙 4% AI-authored · 1 file
💬 The ask
📍 What shipped
Warning Duplicate code introduced in 4 files — consider extracting a helper before this lands.
🧠 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;
Note 🪙 Token reduction — 13 captured tool outputs kept out of context: 25818 → 13064 tokens (49% saved, 12754 tokens). Full output is recoverable with By tool
📜 Per-commit provenance
|
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.