Skip to content

docs(tui): unify help, anatomy, and preset operations#691

Merged
huangzesen merged 2 commits into
mainfrom
dev3/tui-help-runtime-anatomy-20260719
Jul 19, 2026
Merged

docs(tui): unify help, anatomy, and preset operations#691
huangzesen merged 2 commits into
mainfrom
dev3/tui-help-runtime-anatomy-20260719

Conversation

@huangzesen

@huangzesen huangzesen commented Jul 19, 2026

Copy link
Copy Markdown
Collaborator

Summary

This is the single combined documentation/skills PR requested for review.

Help and runtime anatomy

  • expand lingtai-tui-help into a thin discoverable umbrella for the stable TUI mental model and machine-readable + human feature routing
  • make the close-TUI boundary explicit: normal UI exit does not stop a running agent, lifecycle changes stay explicit, and ordinary persistence does not default to launchd
  • align lingtai-tui-anatomy with the repo-root ANATOMY.md as normative owner instead of duplicating the convention
  • add exact same-repo quit/launch/attach/lifecycle/inventory/Portal source anchors and focused population/routing tests

Preset guidance

  • keep lingtai-preset-skill as one thin dual-axis router: exactly 12 source-derived provider children plus 5 operation children (saved-presets, endpoint-capabilities, availability-save-gate, activation-session-refresh, troubleshooting-migration)
  • keep provider pages limited to provider/model/auth/API/capability facts while centralizing shared saved-preset, probe/save, activation, and troubleshooting behavior in the operation axis
  • expand codex-pool with v1/v2 pool semantics, sticky weighted selection, safe non-secret inspection, authorization/backup/compare/atomic-replace/parser-validation boundaries, and the explicit refresh/new-session activation step
  • document the real Codex app-server quota query route (initializeaccount/rateLimits/read with params: null), safe per-window fields, and the dated/model/route-qualified context-window evidence without treating it as timeless
  • update preset Anatomy and source-derived regression tests so the 12-provider/5-operation taxonomy, source anchors, optional-tier rule, conditional OpenRouter vision path, and volatile Codex contracts cannot drift silently

Validation

Parent final gate:

  • cd tui && go test ./... -timeout 300s — PASS, all 14 packages
  • focused preset router/vision tests — PASS
  • go build ./... — PASS
  • go vet ./... — PASS
  • gofmt / git diff --check — PASS
  • YAML frontmatter: 19 files PASS
  • parent catalogs: exactly 12 providers + 5 operations PASS
  • portable-path scan: PASS

Frozen independent final review:

  • exact base: 1dda8f4bb0cf0d80d6469f2d58557e3b37bb3d85
  • full result: 28 files, +1730/-317
  • frozen patch SHA256: 54ec5c88928716c53494b3ad375e2c998b989e22550e45f28251a3073ff40e35
  • byte manifest: all 28 paths verified
  • isolated reviewer: mechanically verified gpt-5.6-terra
  • snapshot go test ./...: PASS, all 14 packages
  • verdict: PASS — no P0, P1, or P2 findings

The three r1 findings are fixed and independently verified: OpenRouter vision is conditional on a user-owned saved preset advertising vision; no false canonical template-order promise remains; empty tier is accepted as source does.

Current main advanced after the frozen base only through Windows PowerShell installer PR #690 (3 upstream paths, zero overlap with this PR's 28 paths).

Scope

Documentation, bundled skills, Anatomy, and focused contract tests only. No runtime behavior, provider auto-routing, release, deploy, config, auth, cleanup, or lifecycle action.

@huangzesen huangzesen changed the title docs(tui): route help through runtime anatomy docs(tui): unify help, anatomy, and preset operations Jul 19, 2026
@huangzesen
huangzesen merged commit 0ed0b9d into main Jul 19, 2026
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