Skip to content

Shorten the CLI: top-level fix, purge and skills, a recommendation group, direct query graph and vector - #3024

Merged
HypForge merged 3 commits into
masterfrom
query-graph-vector-positional
Nov 18, 2026
Merged

HypForge merged 3 commits into
masterfrom
query-graph-vector-positional

Conversation

@bgmcmullen

Copy link
Copy Markdown
Contributor

Six changes to the command tree, each with its own decision doc. Every old spelling that still has a command behind it keeps working as a hidden compatibility alias (LLP 0248 #aliases), so existing scripts and installed skills keep running.

LLP New spelling Old spelling
0609 hyp query graph <node>, hyp query vector <query> query graph neighbors, query vector search (aliases)
0610 hyp fix [id], hyp purge <target> report fix, privacy purge (aliases)
0611 hyp skills install [client] client skills install (alias); --client still works
0613 hyp plugin new, hyp plugin doctor dev plugin new, dev plugin doctor (aliases)
0614 hyp recommendation list|get|publish|mark|delete, alias rec report recommend, report mark (aliases); report list --recommendations and a lone recommendation id on report get/delete stay accepted, undocumented
0612 removed client claude-desktop install|install-helper|profile|status|verify, client claude-account login|logout|status, claude-account credential

Behavior changes to know about

  • Removal (LLP 0612). @hypaware/claude-account and the Claude Desktop managed-profile commands are gone. These are the only commands with no alias. Desktop transcript capture (LLP 0358) is unchanged.
    • A config that names @hypaware/claude-account now fails hyp config validate with plugin_unknown.
    • A machine where hyp client claude-desktop install once completed still has the managed plist and a credential wrapper that calls a command that no longer exists. Desktop inference through that profile stops until the plist is removed with sudo rm.
  • dev is no longer a group (LLP 0613). Bare hyp dev is an unknown command. hyp smoke is the hidden runner and hyp dev smoke still reaches it.
  • Bare hyp query graph and hyp query vector are usage errors (exit 2) where they used to list subcommands. A search for the single bare word status, or a node literally named neighbors, needs another token.
  • Help listings. fix, purge, skills and recommendation appear in primary help; report --help, privacy --help and client --help no longer list the moved commands.
  • Output text. Messages, prompts and receipts print the new spellings, including the purge.command fields of the session ignore receipt and the cli equivalents in the MCP tool contracts. Anything that matched on the old text sees different text.
  • Telemetry vocabulary (LLP 0393). The finite command vocabulary follows the registered names. A receiver that validates against its own copy needs the new names added and should keep the retired ones for older clients. I have not checked whether hypaware-server needs that change.

Docs, the shared skills (bodies only, no description changes), the MCP reference and the smoke flows use the new spellings. LLP 0116, 0117 and 0133 are marked superseded by 0612; the other touched LLPs gain Extended-by lines.

Rebase. Rebased onto master after #3021 (Linear connection flow). Two conflicts, both resolved to keep the new linear group alongside this branch's changes: the group list in core_commands.js and the help-section assertion in cli-consistency-gate.test.js.

Overlaps with #3023. Both touch README.md, src/core/cli/wizard/index.js and src/core/cli/wizard/first_ask.js. Whichever merges second will need a small rebase.

Not in this PR

  • The hypaware.ai quickstart still teaches hyp report fix and hyp report recommend. Both keep working as aliases.

Checks. npm test passes on the rebased branch (9629 pass, 0 fail, 9 skipped), npm run typecheck is clean, and node scripts/llp-numbers.js check reports no collision for 0609 to 0614. I did not run the smoke battery or the sandbox install flows.

CPU and memory. No concern. The change is command registration, argument parsing and text; aliases share one registration and runner with their canonical command. Removing the claude-account and managed-profile code deletes about 3,200 lines of plugin source that loaded on activation.

🤖 Generated with Claude Code

…oup, direct query graph and vector

Six command-tree changes, each with its own decision doc. Every old
spelling that still has a command behind it keeps working as a hidden
compatibility alias (LLP 0248 #aliases).

- LLP 0609: `hyp query graph <node>` and `hyp query vector <query>` take
  their argument directly. `query graph neighbors` and
  `query vector search` become aliases.
- LLP 0610: `hyp fix` and `hyp purge` are top-level. `report fix` and
  `privacy purge` become aliases.
- LLP 0611: `hyp skills install [client]` is canonical again, and the
  client may be a positional. `client skills install` becomes the alias.
- LLP 0612: the Claude Desktop managed-profile commands and
  `@hypaware/claude-account` are removed. Desktop transcript capture
  (LLP 0358) is unchanged.
- LLP 0613: `hyp plugin new` and `hyp plugin doctor` drop the `dev`
  prefix. `dev` is no longer a group; `smoke` and `dev smoke` both run.
- LLP 0614: recommendations get their own group,
  `hyp recommendation list|get|publish|mark|delete` (alias `rec`).
  `report recommend` and `report mark` become aliases.

Docs, skills, MCP contracts, messages and receipts print the new
spellings. The telemetry command vocabulary follows the registered
names.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@bgmcmullen bgmcmullen added the neutral:adopt Foreign PR adopted into neutral's reconcile scope label Nov 17, 2026
@HypForge HypForge added the neutral:adopted Adoption completion record: merged while carrying neutral:adopt (LLP 0031) label Nov 17, 2026
# Conflicts:
#	src/core/cli/core_commands.js
#	test/core/cli-consistency-gate.test.js
@HypForge

Copy link
Copy Markdown
Contributor

Final review (HypForge steward) at head 2fdb3e9.

Rating: MEDIUM. No defect found. It is MEDIUM because it removes shipped commands with no alias (LLP 0612). The removal was decided and the leftovers are now documented. This PR renames many commands (old spellings stay as aliases) and removes the Claude Desktop managed profile and the claude-account plugin.

What was checked:

  • Aliases. Every old spelling with a command behind it still runs and resolves to the new usage: client discover nanoclaw, client skills, dev plugin doctor|new, dev smoke, privacy purge, report fix|mark|recommend, query graph neighbors and query vector search. Bare hyp dev and hyp dev plugin now give "unknown command", as LLP 0613 and the PR body say.

  • graph and vector parsing. A missing node and a bad --top-k give the right errors. Documented edge: a node or query literally named neighbors, search or status is taken by the alias, and the long spelling still works.

  • The removal (LLP 0612). Its leftovers are a managed-preferences plist, credential-helper.sh, and credentials.json. The last can hold a live refresh token, and the removed client claude-account logout was the only command that deleted it. LLP 0612 #consequences now names all three with the exact rm commands. The paths match the code being removed: credentials.json under <state>/plugins/@hypaware/claude-account/ (store.js:13, paths.js:141) and credential-helper.sh (claude-desktop inputs.js:23).

  • LLPs. 0609 to 0614 each carry a #telemetry section. LLP 0116 is now Superseded, matching 0117 and 0133.

  • Telemetry contract. The client COMMANDS adds the new names and keeps github connect from Add standalone GitHub connection flow #3026.

  • Merge of master 6282dc0 (with Add standalone GitHub connection flow #3026). A normal merge, no force. There were two list conflicts:

    • core_commands.js: keeps this PR's removal of the dev plugin group and adds github;
    • cli-consistency-gate.test.js: this PR's list plus github before linear.

    Nothing under hypaware-core/skills/ changes relative to the previous head.

  • CPU and memory: no concern. Registry, argument parsing and text only. Aliases share one registration, and about 3,200 lines of plugin code no longer load.

  • Privacy: MEDIUM (hypforge LLP 0015 scale). A refresh token left in credentials.json stays on disk until the user deletes it. LLP 0612 and the release note say how. No new exposure: the file is owner-only, as before. Security: no new input, spawn or route.

Gates:

For the release note: name the removed commands, the three leftover files with their rm commands, and removing @hypaware/claude-account from the config if listed. hyp config validate reports it as plugin_unknown until then.

Not blocking: src/reports/stages/report-read-tools.js:60 on the server still says hyp query graph neighbors. That spelling runs as an alias, and the line is prompt text, so it is not changed here.

@HypForge

Copy link
Copy Markdown
Contributor

Landing note (HypForge orchestrator): enqueuing at 2fdb3e9. The author handed this PR over with neutral:adopt at 23:24Z on 2026-11-17. It is rated MEDIUM, so it lands on the author's explicit merge word, given at 06:22Z on 2026-11-18.

  • Review: MEDIUM, no defect, at this exact head (final comment above, 6967087922). Privacy MEDIUM. Security: no new input, spawn or route. CPU and memory: no concern.
  • The removal (LLP 0612): the Claude Desktop managed profile and the claude-account plugin go, with no alias. The designer of that feature agreed to the removal. On the author's pick, LLP 0612 names the three leftovers (the managed plist, credential-helper.sh and credentials.json) with the exact cleanup commands.
  • What HypForge added, as normal pushes: the LLP 0612 cleanup lines and the LLP 0116 status line; then a merge of master, which resolved two list conflicts with Add standalone GitHub connection flow #3026. Nothing under hypaware-core/skills/ was changed by HypForge.
  • Server-suite gate: pass. The new command names needed hypaware-server Fix #1685: hypaware-privacy Step 1 ambiguity guard misses a reroute placed past its one-paragraph routing slice #1730, which is merged and live. Server master 5e8b8a4b against this head passes 749 of 749.
  • Guard: open, not a draft, CLEAN, all checks green including test-windows, master CI green on b5df306, no release PR open. The branch is 2 behind master (Docs: clarify GitHub connect sign-in, scope and managed config #3031, docs, and Fix Codex exec outcomes for content-item results #3033, the codex plugin); neither touches a file this PR changes, and the merge queue runs CI on the merged tree.
  • Every old spelling that still has a command behind it runs as an alias. Only bare hyp dev and hyp dev plugin stop.

For the release notes: the removed commands, the three leftover files with their rm commands, and removing @hypaware/claude-account from the config if it is listed (hyp config validate reports plugin_unknown until then).

A merge is not a release. Users get the new spellings and the removal with the next published version.

@HypForge
HypForge added this pull request to the merge queue Nov 18, 2026
Merged via the queue into master with commit d16a42a Nov 18, 2026
11 checks passed
@HypForge
HypForge deleted the query-graph-vector-positional branch November 18, 2026 06:29
@HypForge

Copy link
Copy Markdown
Contributor

Merged (HypForge orchestrator) as d16a42a at 06:29:56Z on 2026-11-18, on the first pass through the merge queue. CI on the merge commit is green.

  • This is on master only. The new spellings and the removal reach users with the next client release; the published 1.53.0 has neither.
  • The server already admits the new command names (hypaware-server Fix #1685: hypaware-privacy Step 1 ambiguity guard misses a reroute placed past its one-paragraph routing slice #1730, live since 01:55Z).
  • Docs check after the merge: no legal page or docs/PRIVACY.md sentence is made untrue. The 11 changed privacy lines swap hyp privacy purge for hyp purge and nothing else. CLI_REFERENCE.md and MCP_REFERENCE.md match the registered commands.
  • Still teaching an old spelling, all of which run as aliases: the site quickstart and two /privacy lines, one server report-tool description, and AGENTS.md (dev smoke).
  • The site publishes docs from master at its next deploy. That deploy is held until the release, since these pages now name commands that 1.53.0 lacks.
  • Release notes will carry: the removed commands, the three leftover files with their rm commands, and removing @hypaware/claude-account from the config if it is listed.

@HypForge HypForge mentioned this pull request Nov 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

neutral:adopt Foreign PR adopted into neutral's reconcile scope neutral:adopted Adoption completion record: merged while carrying neutral:adopt (LLP 0031)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants