cargo-hauler 0.9.7 → 0.9.8

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.9.8
+
+### Patch Changes
+
+- 1c3691f: Build against agent-bundle main (`1d661b4`). The `hauler_*` MCP tools are `defineTool` definitions, which agent-bundle now requires. Tool names, inputs, results, and `hauler` CLI commands are unchanged. Built artifacts no longer embed the checkout path, so the same commit builds to the same bytes in any directory.
+- 1ba9a1d: The daemon scans the kache index in a worker thread, so a large index no longer stalls `hauler status`, ticket reads, or pings while it refreshes. A 4.5 GB index held the socket for about 590 ms per refresh; it now answers within a few milliseconds. The kache section names why the index could not be read (`not detected`, `index unreadable`, or `index read timed out` after 30 s) instead of reporting every failure as not detected.
+
 ## 0.9.7
 
 ### Patch Changes

package/dist/.claude-plugin/marketplace.json

@@ -1 +1 @@
-{"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","name":"cargo-hauler-marketplace","owner":{"name":"cargo-hauler"},"plugins":[{"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","keywords":["cargo","rust","agent","mcp","claude-code","codex","cursor","build-orchestration"],"license":"MIT","name":"cargo-hauler","repository":"https://github.com/ScriptedAlchemy/cargo-hauler","source":"./","version":"0.9.7"}]}
+{"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","name":"cargo-hauler-marketplace","owner":{"name":"cargo-hauler"},"plugins":[{"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","keywords":["cargo","rust","agent","mcp","claude-code","codex","cursor","build-orchestration"],"license":"MIT","name":"cargo-hauler","repository":"https://github.com/ScriptedAlchemy/cargo-hauler","source":"./","version":"0.9.8"}]}

package/dist/.claude-plugin/plugin.json

@@ -1 +1 @@
-{"author":{"name":"cargo-hauler"},"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","name":"cargo-hauler","version":"0.9.7"}
+{"author":{"name":"cargo-hauler"},"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","name":"cargo-hauler","version":"0.9.8"}

package/dist/.codex-plugin/plugin.json

@@ -1 +1 @@
-{"author":{"name":"cargo-hauler"},"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","hooks":"./.codex-plugin/hooks.json","interface":{"capabilities":["mcp","hooks","skills"],"category":"Productivity","defaultPrompt":["Help me use cargo-hauler."],"developerName":"cargo-hauler","displayName":"cargo-hauler","longDescription":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","shortDescription":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks."},"keywords":["cargo","rust","agent","mcp","claude-code","codex","cursor","build-orchestration"],"license":"MIT","mcpServers":"./.codex-plugin/mcp.json","name":"cargo-hauler","repository":"https://github.com/ScriptedAlchemy/cargo-hauler","skills":"./skills/","version":"0.9.7"}
+{"author":{"name":"cargo-hauler"},"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","hooks":"./.codex-plugin/hooks.json","interface":{"capabilities":["mcp","hooks","skills"],"category":"Productivity","defaultPrompt":["Help me use cargo-hauler."],"developerName":"cargo-hauler","displayName":"cargo-hauler","longDescription":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","shortDescription":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks."},"keywords":["cargo","rust","agent","mcp","claude-code","codex","cursor","build-orchestration"],"license":"MIT","mcpServers":"./.codex-plugin/mcp.json","name":"cargo-hauler","repository":"https://github.com/ScriptedAlchemy/cargo-hauler","skills":"./skills/","version":"0.9.8"}

package/dist/.cursor-plugin/plugin.json

@@ -1 +1 @@
-{"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","displayName":"cargo-hauler","hooks":"./.cursor-plugin/hooks.json","keywords":["cargo","rust","agent","mcp","claude-code","codex","cursor","build-orchestration"],"license":"MIT","mcpServers":"./.cursor-plugin/mcp.json","name":"cargo-hauler","repository":"https://github.com/ScriptedAlchemy/cargo-hauler","skills":"./skills/","version":"0.9.7"}
+{"description":"Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.","displayName":"cargo-hauler","hooks":"./.cursor-plugin/hooks.json","keywords":["cargo","rust","agent","mcp","claude-code","codex","cursor","build-orchestration"],"license":"MIT","mcpServers":"./.cursor-plugin/mcp.json","name":"cargo-hauler","repository":"https://github.com/ScriptedAlchemy/cargo-hauler","skills":"./skills/","version":"0.9.8"}

package/dist/INSTALL.md

@@ -2,7 +2,7 @@
 
 Coalesce, schedule, and stream cargo so concurrent agent sessions share compiles instead of fighting locks.
 
-Version: `0.9.7`
+Version: `0.9.8`
 
 Run these commands from this bundle directory. The bundle is self-contained: every command below is
 a host command or the bundled installer, and nothing requires the `agent-bundle` CLI. Where that CLI is
@@ -33,7 +33,7 @@ claude plugin install cargo-hauler@cargo-hauler-marketplace --scope user
 
 With the optional `agent-bundle` CLI, `agent-bundle install claude --from ./` runs this sequence
 automatically when the installed copy has the same version but a different content hash; `--replace`
-(alias `--force`) forces it.
+forces it.
 
 ### Uninstall
 
@@ -42,7 +42,7 @@ claude plugin uninstall cargo-hauler@cargo-hauler-marketplace --scope user --kee
 ```
 
 Match the scope the plugin was installed with (`user`, `project`, or `local`). `--keep-data` keeps durable
-runtime state (Claude orphans the cached copy, `state/` included, for its ~14-day grace period); omit it to
+runtime state (Claude orphans the cached copy for its ~14-day grace period); omit it to
 remove `~/.claude/plugins/data/<id>/` immediately.
 
 The marketplace `cargo-hauler-marketplace` stays registered. Remove it only when nothing else installs from it:
@@ -61,8 +61,8 @@ would be removed and `agent-bundle uninstall claude --from ./` reverses the reco
 (or under `$CLAUDE_CONFIG_DIR`; `user` is the install scope, pass `--scope project` or `--scope local` to match
 a scoped install), and `uninstall` consumes it, running the two commands above in order and retaining the
 marketplace while any other plugin, scope, or project still installs from it. Durable runtime state
-is kept by default; `--purge-data --confirm-purge` removes `state/` and `~/.claude/plugins/data/<id>/`
-immediately. A missing receipt or a cached copy that no longer matches it is refused unless `--force`; a
+is kept by default; `--purge-data --confirm-purge` removes the receipt-owned state roots and
+`~/.claude/plugins/data/<id>/` immediately. A missing receipt or a cached copy that no longer matches it is refused unless `--force`; a
 second run is a `not-installed` no-op.
 
 ## Codex
@@ -92,7 +92,7 @@ or omits `enabled` (`AB7004`) and leaves that install unchanged. Enable the plug
 
 With the optional `agent-bundle` CLI, `agent-bundle install codex --from ./` runs this sequence
 automatically when the installed copy has the same version but a different content hash; `--replace`
-(alias `--force`) forces it.
+forces it.
 
 ### Uninstall
 
@@ -100,8 +100,7 @@ automatically when the installed copy has the same version but a different conte
 codex plugin remove cargo-hauler@cargo-hauler-marketplace
 ```
 
-Codex 0.147.0 deletes the cached plugin tree, `state/` included, on `plugin remove` and has no keep-data
-option.
+Codex 0.147.0 deletes the cached plugin tree on `plugin remove` and has no keep-data option.
 
 The marketplace `cargo-hauler-marketplace` stays registered. Remove it only when nothing else installs from it:
 `codex plugin list` shows every other plugin from it.
@@ -114,7 +113,8 @@ With the optional `agent-bundle` CLI, `agent-bundle uninstall codex --from ./ --
 would be removed and `agent-bundle uninstall codex --from ./` reverses the recorded registrations.
 `agent-bundle install codex` records a receipt at `~/.codex/agent-bundle/receipts/cargo-hauler.cargo-hauler-marketplace.user.json` (or
 under `$CODEX_HOME`), and `uninstall` consumes it, running the two commands above in order. `--keep-data`
-cannot preserve durable state on Codex; the result says so (`unavailable`). A missing receipt or a cached
+keeps the framework state roots the receipt records outside the cached tree (`kept`); with nothing there the
+result says so (`unavailable`). A missing receipt or a cached
 copy that no longer matches it is refused unless `--force`; a second run is a `not-installed` no-op.
 
 ## Cursor
@@ -137,37 +137,38 @@ manifest-declared `hooks/hooks.json` from that directory; plugin hooks run from
 The installer writes an install receipt (`.agent-bundle-install.json`: plugin, version, content hash,
 owned files) beside the plugin manifest. Re-running `node ./install.mjs` on an identical artifact
 is a no-op that says so. When the installed copy has the same version but different content, the
-installer replaces its owned files in place and leaves runtime state (`state/`) untouched:
+installer replaces its owned files in place and leaves unowned entries untouched:
 
 ```sh
 node ./install.mjs            # same-version content drift of a receipt-managed copy is replaced
-node ./install.mjs --replace  # also replace a different installed version, or adopt a pre-receipt copy
+node ./install.mjs --replace  # also replace a different installed version
 ```
 
-`--force` is an alias for `--replace`. A directory that is not an agent-bundle install of this
-plugin is always refused with an installed-versus-artifact content-hash comparison; remove it
-manually. The optional `agent-bundle` CLI applies the same policy through
+A directory without a receipt naming this plugin (including a copy placed before install receipts
+existed) is foreign and always refused with an installed-versus-artifact content-hash comparison;
+remove it manually and reinstall. The optional `agent-bundle` CLI applies the same policy through
 `agent-bundle install cursor --from ./ [--replace]`.
 
 ### Uninstall
 
 ```sh
 node ./install.mjs --uninstall --plan                        # print exactly what would be removed
-node ./install.mjs --uninstall                               # remove the receipt-owned files; keep state/
-node ./install.mjs --uninstall --purge-data --confirm-purge  # also remove durable runtime state
+node ./install.mjs --uninstall                               # remove the receipt-owned files; keep durable state
+node ./install.mjs --uninstall --purge-data --confirm-purge  # also remove receipt-owned durable runtime state
 node ./install.mjs --uninstall --mode marketplace            # remove a staged marketplace repository
 ```
 
 Uninstall removes exactly what the receipt owns: the listed files, the directories the installer
 created (including `~/.cursor/plugins/local` when the installer made it), and nothing else. Durable
-runtime state under `state/` (state kernel, notices journal) — and, for an Agent Plugins pack with a stdio
-server, the `~/.cursor/agent-bundle/plugin-data/<name>` directory the receipt records as `PLUGIN_DATA` — is kept
-unless `--purge-data --confirm-purge` is passed (a kept data directory leaves a remnant receipt behind so a later
-purge still finds it; an empty one is pruned); unowned files are left in place and listed. A supported older
-receipt with no recorded state location retains the current environment's default as unproven; a keep-data run
-cannot turn that observation into later purge authority. A directory without a receipt is refused unless
-`--force` (which removes a pre-receipt legacy copy by its inventory); owned content that no longer matches
-the receipt is refused unless `--force`; a directory that is not this plugin's install is always refused.
+runtime state (the framework state roots the receipt records with ownership evidence) — and, for an Agent
+Plugins pack with a stdio server, the `~/.cursor/agent-bundle/plugin-data/<name>` directory the receipt records
+as `PLUGIN_DATA` — is kept unless `--purge-data --confirm-purge` is passed (a kept data directory leaves a
+remnant receipt behind so a later purge still finds it; an empty one is pruned); unowned entries, including a
+`state/` directory beside the plugin, are left in place and listed. A receipt with no recorded state location
+(written before the install could record it) retains the current environment's default as unproven; a
+keep-data run cannot turn that observation into later purge authority. A directory without a receipt naming
+this plugin is foreign and always refused, with or without `--force`; owned content that no longer matches
+the receipt is refused unless `--force`.
 A second run is a `Not installed` no-op. With the optional `agent-bundle` CLI,
 `agent-bundle uninstall cursor --from ./ [--mode marketplace]` applies the same policy, and
 `agent-bundle doctor --from ./` shows the lifecycle stage (placed, registered, enabled, active) with
@@ -254,21 +255,21 @@ other clients; the recorded clients above name which of them expand the placehol
 ### Reinstall after a same-version rebuild
 
 The installer records an install receipt (`.agent-bundle-install.json`) and replaces its owned files in
-place when the same version was rebuilt with different content; runtime state (`state/`) is never
-touched. Pass `--replace` (alias `--force`) to replace a different installed version or to adopt a
-copy installed before receipts existed. Foreign directories are refused with a content-hash
-comparison. For a client that manages its own copy, remove and re-add the plugin through that client
-when only content changed at the same version.
+place when the same version was rebuilt with different content; unowned entries are never
+touched. Pass `--replace` to replace a different installed version. A directory without a receipt
+naming this plugin (including a copy installed before receipts existed) is foreign and refused with a
+content-hash comparison; remove it manually. For a client that manages its own copy, remove and re-add
+the plugin through that client when only content changed at the same version.
 
 ### Uninstall
 
 ```sh
 node ./install.mjs --uninstall --plan                        # print exactly what would be removed
-node ./install.mjs --uninstall                               # remove the receipt-owned files; keep state/
-node ./install.mjs --uninstall --purge-data --confirm-purge  # also remove durable runtime state
+node ./install.mjs --uninstall                               # remove the receipt-owned files; keep durable state
+node ./install.mjs --uninstall --purge-data --confirm-purge  # also remove receipt-owned durable runtime state
 ```
 
 Uninstall removes exactly what the receipt owns (files, installer-created directories) and keeps
-durable runtime state under `state/` (and the recorded `PLUGIN_DATA` directory of an Agent Plugins pack)
-unless `--purge-data --confirm-purge` is passed. A missing
-receipt or modified owned content is refused unless `--force`; foreign directories are always refused.
+the durable runtime state the receipt records (and the recorded `PLUGIN_DATA` directory of an Agent Plugins
+pack) unless `--purge-data --confirm-purge` is passed. Modified owned content is refused unless `--force`;
+a directory without a receipt naming this plugin is foreign and always refused.