@vectorize-io/hindsight-coding-agents 0.5.4 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/README.md +24 -7
  2. package/dist/antigravity-hook.js +205 -81
  3. package/dist/antigravity-statusline.js +32 -22
  4. package/dist/antigravity-stop-hook.js +216 -79
  5. package/dist/claude-hook.js +205 -81
  6. package/dist/claude-sessionstart-hook.js +167 -105
  7. package/dist/claude-stop-hook.js +216 -79
  8. package/dist/cline.js +279 -86
  9. package/dist/codex-hook.js +205 -81
  10. package/dist/codex-sessionstart-hook.js +167 -105
  11. package/dist/codex-stop-hook.js +216 -79
  12. package/dist/copilot-hook.js +205 -81
  13. package/dist/copilot-sessionstart-hook.js +167 -105
  14. package/dist/copilot-stop-hook.js +216 -79
  15. package/dist/cursor-hook.js +205 -81
  16. package/dist/cursor-sessionstart-hook.js +167 -105
  17. package/dist/cursor-stop-hook.js +216 -79
  18. package/dist/daemon-start.js +28 -18
  19. package/dist/dcode-hook.js +205 -81
  20. package/dist/dcode-sessionstart-hook.js +167 -105
  21. package/dist/dcode-stop-hook.js +216 -79
  22. package/dist/deepen.js +98 -40
  23. package/dist/devin-hook.js +205 -81
  24. package/dist/devin-sessionstart-hook.js +167 -105
  25. package/dist/devin-stop-hook.js +216 -79
  26. package/dist/droid-hook.js +205 -81
  27. package/dist/droid-sessionstart-hook.js +167 -105
  28. package/dist/droid-stop-hook.js +216 -79
  29. package/dist/dsh.js +277 -85
  30. package/dist/grok-hook.js +205 -81
  31. package/dist/grok-sessionstart-hook.js +167 -105
  32. package/dist/grok-stop-hook.js +216 -79
  33. package/dist/hindsight-seed.js +32 -22
  34. package/dist/index.js +280 -88
  35. package/dist/installer.js +308 -214
  36. package/dist/kilo.js +280 -88
  37. package/dist/mcp-server.js +97 -39
  38. package/dist/opencode2.js +279 -87
  39. package/dist/pi.js +279 -87
  40. package/dist/prime-agent.js +279 -87
  41. package/dist/qwen-hook.js +205 -81
  42. package/dist/qwen-sessionstart-hook.js +167 -105
  43. package/dist/qwen-stop-hook.js +216 -79
  44. package/dist/status.js +94 -36
  45. package/dist/zcode-hook.js +205 -81
  46. package/dist/zcode-sessionstart-hook.js +167 -105
  47. package/dist/zcode-stop-hook.js +216 -79
  48. package/package.json +1 -1
  49. package/plugin.json +1 -1
  50. package/skill/SKILL.md +24 -7
package/README.md CHANGED
@@ -23,6 +23,7 @@ npx @vectorize-io/hindsight-coding-agents install all # every detected
23
23
  npx @vectorize-io/hindsight-coding-agents install claude-code # or just one
24
24
  npx @vectorize-io/hindsight-coding-agents uninstall all # removes exactly what install added
25
25
  npx @vectorize-io/hindsight-coding-agents update # refresh the runtime only, no rewiring
26
+ npx @vectorize-io/hindsight-coding-agents stats # how often each agent uses Hindsight
26
27
  ```
27
28
 
28
29
  `install` takes an explicit target — `all`, or one or more harness names. A bare
@@ -439,8 +440,8 @@ as `HINDSIGHT_MAX_PARALLEL_RETAINS` for containers and CI.
439
440
 
440
441
  `HINDSIGHT_CONFIG` moves the file itself — point it at another path for a container or a test
441
442
  harness where `$HOME` is not the right anchor. It is still exactly one file; only its location
442
- changes. (The other variables that are not settings are `HINDSIGHT_LOG_FILE`, `HINDSIGHT_DIAG_FILE`
443
- and `HINDSIGHT_LOG_LEVEL` — see [Diagnostics & logging](#diagnostics--logging).)
443
+ changes. (The other variables that are not settings are `HINDSIGHT_LOG_FILE`, `HINDSIGHT_DIAG_FILE`,
444
+ `HINDSIGHT_USAGE_FILE` and `HINDSIGHT_LOG_LEVEL` — see [Diagnostics & logging](#diagnostics--logging).)
444
445
 
445
446
  ### When a change takes effect
446
447
 
@@ -522,7 +523,7 @@ hook by Codex...), so one shared config serves several agents side by side:
522
523
  | `manageBankConfig` | `true` | let the plugin shape the bank's own configuration — the retain strategies it writes under, the `knowledge` entity-label group, and, on a bank that has none, the missions. Writing is strictly **additive**: it adds what the bank does not define and never overwrites what is there, so your control-plane edits survive. Set `false` to keep it out of the bank config entirely — see **A bank you shape yourself** below |
523
524
  | `observationScopes` | `"shared"` | how consolidation groups observations: `"shared"` (default) = ONE global scope per bank, so every agent on a repo builds one set of beliefs; also `"combined"` (the server default), `"per_tag"`, `"all_combinations"`, `[["t"]]`; `"per_source"` adds a scope per `source:` kind alongside the global one, so commit knowledge and conversation knowledge consolidate apart |
524
525
  | `disabled` | `false` | hard off-switch (inert plugin/hook — a no-memory baseline) |
525
- | `reflectTimeoutMs` | `120000` | **automatic** session-reflect timeout (hook harnesses additionally cap it at 25s to fit the host's hook window); on timeout the session runs without reflect (recorded) |
526
+ | `reflectTimeoutMs` | `120000` | **automatic** session-reflect timeout (hook harnesses additionally cap it at 20s to fit the host's hook window); on timeout or a 5xx the hook falls back to knowledge-page search, then to a raw recall of observations (recorded) |
526
527
  | `reflectToolTimeoutMs` | `330000` | timeout for the agent-invoked `hindsight_reflect` tool — a call the agent waits on, whose high-budget synthesis on a populated bank runs for minutes. Defaults above the server's own reflect wall timeout (`HINDSIGHT_API_REFLECT_WALL_TIMEOUT`, 300s) so the server decides when to give up. Unset, it inherits an explicitly raised `reflectTimeoutMs`, but a short one never lowers it |
527
528
  | `reflectBudget` | `"high"` | reflect budget for the `hindsight_reflect` tool: `"low"`, `"mid"` or `"high"`. Drop it on a large bank where high-budget synthesis exceeds the server's wall timeout. The automatic session-start reflect always uses `"low"` to fit its hook window and is unaffected |
528
529
  | `autoReflect` | `true` | inject a one-time reflect synthesis on the session's **first prompt**. `false` = tool-only reflect: nothing is injected; the agent searches knowledge pages first and reflects only when they are too shallow |
@@ -822,16 +823,18 @@ drops the markers along with the contributor-only sections.
822
823
 
823
824
  ## Diagnostics & logging
824
825
 
825
- Two files, two audiences:
826
+ All logs live in `~/.hindsight/coding-agents-logs/` (owner-only). Each file rotates to `<file>.1`
827
+ at 10 MB.
826
828
 
827
- **Leveled plugin log** (humans debugging): `$TMPDIR/hindsight-coding-agent/plugin.log` (override
829
+ **Leveled plugin log** (humans debugging): `~/.hindsight/coding-agents-logs/plugin.log` (override
828
830
  `HINDSIGHT_LOG_FILE`) — timestamped `LEVEL [scope] message` lines from every component, including
829
831
  the ingestion engine. Level defaults to `info`; set `"logLevel": "debug"` in config or
830
832
  `HINDSIGHT_LOG_LEVEL=debug` for ad-hoc debugging (at `debug`, every diag event below is mirrored
831
833
  here too, so one file tells the whole story).
832
834
 
833
835
  **Structured diag events** (machines/harnesses): every reflect and page-fetch outcome is appended
834
- as a JSON line to `/tmp/hindsight-plugin.log` (override with `HINDSIGHT_DIAG_FILE`):
836
+ as a JSON line to `~/.hindsight/coding-agents-logs/diag.jsonl` (override with
837
+ `HINDSIGHT_DIAG_FILE`):
835
838
 
836
839
  ```json
837
840
  {
@@ -845,9 +848,23 @@ as a JSON line to `/tmp/hindsight-plugin.log` (override with `HINDSIGHT_DIAG_FIL
845
848
  ```
846
849
 
847
850
  `reflect_failed` / `pages_failed` record the error; if you're comparing memory-on vs memory-off,
848
- check this file — a run whose reflects failed is a no-memory run. Seed starts are logged as
851
+ check this file — a run whose reflects failed is a no-memory run. When the failure was a timeout or
852
+ a 5xx, the hook falls back to knowledge-page search and, if no page matches, to a raw recall of the
853
+ bank's observations: `reflect_fallback_pages` / `reflect_fallback_observations` record what each
854
+ step returned (`*_failed` when it errored). Seed starts are logged as
849
855
  `seed_started`.
850
856
 
857
+ **Tool usage** (is the agent using Hindsight?): one JSON line per finished user turn in
858
+ `~/.hindsight/coding-agents-logs/usage.jsonl` (override `HINDSIGHT_USAGE_FILE`) — the `hindsight_*`
859
+ tools the agent called during that turn, and whether its reply credited Hindsight memory ("From
860
+ Hindsight memory"). The credit rate counts only turns that called a retrieval tool (search, list,
861
+ read, reflect); saving a document is not expected to be credited. Recorded when the session is written back, so a scope with
862
+ `retainSessions: false` records none. It never leaves your machine. Summarize it per agent with:
863
+
864
+ ```bash
865
+ npx @vectorize-io/hindsight-coding-agents stats
866
+ ```
867
+
851
868
  ### Is the memory ready yet?
852
869
 
853
870
  `hindsight_sync_status` — the agent-facing tool, `dist/status.js` for scripts — answers exactly