Hands-on ergonomics for Bryan's Gundersen testing. All three changes are
backward-compatible — every old name still works.
1. `help` is now the canonical reference command (live, never-drifts table
from bin/ + each tool's help block). `cheat` kept as a thin alias.
2. Prefix-free short commands: nc-table→table, nc-parse→parse, nc-msgs→msgs,
nc-status→status, nc-engine→engine, nc-xlate→xlate, nc-inbound→inbound, plus
the write tools (create-thread, set-field, insert-protocol, make-jump,
provision-jumps, tclgen, document, revisions, diff-interface, smat-diff,
regression). COLLISION GUARD: nc-find→`nfind` (NOT `find` — would shadow the
system find on PATH); nc-paths keeps `paths`. Every nc-* name retained as a
backward-compat alias. Tab-completion + the help/cheat table updated.
3. HCISITEDIR auto-init in the shared preflight (bin/_nc_common.sh): HCIROOT +
HCISITE still required, but $HCIROOT/$HCISITE is created if missing rather
than erroring. Conservative + idempotent; respects an operator-set HCISITEDIR.
VERSION→0.9.6, MANIFEST regenerated (--check clean), bash -n clean.
Co-Authored-By: Clover (Claude Opus 4.8) <noreply@anthropic.com>
- bin/cheat: one-screen reference for ALL short commands, generated live from
the bin/ wrapper set + each tool's help block (description from the wrapper
header / backing lib line 1; ONE real example from the wrapper's example
block / lib Usage form). cheat <filter> + cheat -h. LC_ALL=C em-dash slicing.
- Wired into install-larry.sh symlink loop + MANIFEST (auto-synced on update).
- Proved the update path: simulated v0.9.0 install with populated config/auth/
site-data -> re-ran installer against v0.9.5 origin -> reached v0.9.5 with
bin/cheat on PATH + completion wired + fixtures present, ALL 8 state files
byte-identical (sha256), tbn adt + completion working after. Idempotent re-run
(no duplicate rc line). NO uninstall needed for an update.
- VERSION + LARRY_VERSION -> 0.9.5; MANIFEST regenerated (--check clean, 95
entries); bash -n clean. Deliverables: cheatsheet + update-procedure (myPKA).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Make the toolkit usable BY HAND without the `larry tools <name>` prefix.
- bin/ of thin wrappers (tbn/tbp/tbh/tbpr/where/paths/route_test + a full-name
passthrough per operator tool). Installer symlinks them into LARRY_BIN_DIR so
`tbn adt` runs directly. Each resolves lib/ via bin/_nc_common.sh
(LARRY_LIB_DIR -> ../lib -> $LARRY_HOME/lib) and execs the matching tool.
- -h/--help on every wrapper.
- bin/nc-completion.bash: dynamic bash completion, 3 levels (command / SITE /
THREAD) enumerated LIVE from the NetConfig tree under $HCIROOT via the same
lib/nc-parse.sh the tools use; cached per (HCIROOT, newest-NetConfig-mtime).
Installer appends a guarded source line to the user's bash rc.
- fixtures/integrator: durable 3-site demo (epic->ancout->codamx) with cross-
site fan-out + fan-in and a multi-route inbound. RESOLVES the v0.9.3 fixture
conflict: cross-site destination blocks are XS_*-prefixed so they never
collide with a local protocol name (a collision makes nc-paths
_xsite_down_targets suppress the cross-site hop, lib/nc-paths.sh:378).
- DEFERRED: fetch-token.sh broker wiring (broker contract still finalizing).
VERSION+LARRY_VERSION -> 0.9.4; MANIFEST regenerated (--check clean); bash -n
clean; verified live on .135 (short commands off PATH + all 3 completion levels).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
