Batch 17: --help, storage CLI cleanup, Linux restart survival, secret proxy, status KV

Merged
AF
1h ago
+19160-6637

Batch 17: 27 deliveries on main c322752a, assembled and gated together.

Fixes and features

  • aft --help / -h print usage and exit without starting the server; unknown options and commands exit 2 with usage (#1466).
  • migrate-storage and the plugins' pre-0.27 storage migration removed; clean-old-caches becomes aft cache clean-old.
  • Linux background commands survive an AFT restart in their own systemd scope (#1219, contributor commits kept; #1109).
  • grep names folders that ignore rules kept out of the search, best-effort (#1289); patch/edit diff previews capped at 128 KiB per response (#1291); honest plugin text for timed-out changes and reload refusals (#1292, #1295).
  • Secret proxy: approval completion and a verified reconnect start a fresh idle budget, so HTTP/2 clients keep their connection after a long approval; card filing and withdrawal are logged with a reason; the wait line no longer names a phone.
  • Runner capability probe uses an unscoped AFT-owned route, so Broca head plans can't refuse it; nudges ride the tool result instead of starting a turn.
  • Occipital's display.read admitted on its management route; scope.watch no longer re-describes live scopes on reopen or bind.
  • Fleet status segment written to the aft.status bus KV bucket for prefrontal's reader.
  • Health rollup: 30 s idle cadence, no timer-driven macOS allocator walk.
  • memory setting (lean / balanced, user config only); late_result_ready.v1 uses tool-provider 0.15.10's shared type; gh shim reads Actions logs with per-job refusals; LSP environment gaps log at WARN; crates.io refusals no longer block the GitHub release and npm.
  • Agents can read and edit the CortexKit settings folder; data folders stay blocked.
  • aft_inspect dedupes parse errors and shared gap lists; docs/config.md documents shell.env_provider (#1461).

Verification

  • Full Linux Rust suite: 15,406 of 15,420; the 13 known build-server sandbox gaps, plus one checkout-path guard since fixed (1/1).
  • Real-daemon TS lanes: bridge 1,183/0 failed, OpenCode e2e 377/0, CLI 500/0, Pi 1,238/0.
  • Whole OpenCode unit package: two failures that reproduce identically on main in the same job (environment baseline, logs kept).
  • Windows warnings-denied compile, rustfmt, Biome, typechecks, size pins, config parity (304 cases, zero diff).
  • Search-quality descriptor: engine_unwired (the only fence change removes the deleted migrate_storage module line).

Summary by cubic

Batch 17 assembles fixes and features on top of main into one gated release. The main user-visible changes are CLI help, Linux background-task scopes, a new memory-profile setting, capped diff previews, and secret-proxy idle handling.

  • aft --help / aft -h print usage and exit without opening storage or starting the server; unknown options and commands exit with a usage error (#1466).
  • Linux daemon background bash tasks run in their own systemd scopes, so they survive a module restart while the user manager stays active; kills write cgroup.kill, memory limits use the scope cgroup, and tasks stop after a 24-hour default limit (#1109, #1219).
  • The new user-only memory setting (lean or balanced) selects cache and callgraph thread limits; health output reports its choice, health rollups are demand-driven with child health probes reused for three seconds, and macOS allocator walks are no longer timer-driven.
  • Patch and edit diff previews are capped at 128 KiB per response with an explicit omission notice; GitHub comment diffs stay unbounded (#1291).
  • Secret proxy: approval completion and a verified reconnect restart the idle budget so held HTTP/2 requests keep their connection; card filing and withdrawal are logged, and the wait line no longer names a phone.
  • grep names the folders ignore rules kept out of its search, best-effort (#1289); aft_inspect dedupes parse errors and shared gap lists and retries failed .js/.cjs parses as scripts; hashline edits no longer refuse worker requests that carry the pipeline's envelope fields.
  • Agents can read and edit the CortexKit settings folder while data folders stay blocked; display.read is admitted on Occipital's management route; scope.watch no longer re-describes live scopes on reopen or bind, and prefrontal logs each scope continuity decision once per change.
  • gh shim reads Actions logs per job with refusals and retries transient reads within the existing deadline; LSP environment and TypeScript preflight refusal gaps log at WARN.
  • crates.io publication moves to its own workflow so refusals no longer block the GitHub release and npm; fleet status is written to the aft.status bus KV bucket; runner capability probes use an unscoped AFT-owned route, and nudges fire only when ordered delivery is confirmed.

Migration

  • callgraph_chunk_size is removed — it never had an effect — and is refused from 0.67; run npx @cortexkit/aft doctor --fix to drop it from user config.
  • Storage from before 0.27 is no longer migrated; upgrade through 0.66 first.
  • Old-cache cleanup moves from clean-old-caches to aft cache clean-old.