@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.
- package/README.md +24 -7
- package/dist/antigravity-hook.js +205 -81
- package/dist/antigravity-statusline.js +32 -22
- package/dist/antigravity-stop-hook.js +216 -79
- package/dist/claude-hook.js +205 -81
- package/dist/claude-sessionstart-hook.js +167 -105
- package/dist/claude-stop-hook.js +216 -79
- package/dist/cline.js +279 -86
- package/dist/codex-hook.js +205 -81
- package/dist/codex-sessionstart-hook.js +167 -105
- package/dist/codex-stop-hook.js +216 -79
- package/dist/copilot-hook.js +205 -81
- package/dist/copilot-sessionstart-hook.js +167 -105
- package/dist/copilot-stop-hook.js +216 -79
- package/dist/cursor-hook.js +205 -81
- package/dist/cursor-sessionstart-hook.js +167 -105
- package/dist/cursor-stop-hook.js +216 -79
- package/dist/daemon-start.js +28 -18
- package/dist/dcode-hook.js +205 -81
- package/dist/dcode-sessionstart-hook.js +167 -105
- package/dist/dcode-stop-hook.js +216 -79
- package/dist/deepen.js +98 -40
- package/dist/devin-hook.js +205 -81
- package/dist/devin-sessionstart-hook.js +167 -105
- package/dist/devin-stop-hook.js +216 -79
- package/dist/droid-hook.js +205 -81
- package/dist/droid-sessionstart-hook.js +167 -105
- package/dist/droid-stop-hook.js +216 -79
- package/dist/dsh.js +277 -85
- package/dist/grok-hook.js +205 -81
- package/dist/grok-sessionstart-hook.js +167 -105
- package/dist/grok-stop-hook.js +216 -79
- package/dist/hindsight-seed.js +32 -22
- package/dist/index.js +280 -88
- package/dist/installer.js +308 -214
- package/dist/kilo.js +280 -88
- package/dist/mcp-server.js +97 -39
- package/dist/opencode2.js +279 -87
- package/dist/pi.js +279 -87
- package/dist/prime-agent.js +279 -87
- package/dist/qwen-hook.js +205 -81
- package/dist/qwen-sessionstart-hook.js +167 -105
- package/dist/qwen-stop-hook.js +216 -79
- package/dist/status.js +94 -36
- package/dist/zcode-hook.js +205 -81
- package/dist/zcode-sessionstart-hook.js +167 -105
- package/dist/zcode-stop-hook.js +216 -79
- package/package.json +1 -1
- package/plugin.json +1 -1
- 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
|
|
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
|
-
|
|
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):
|
|
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
|
|
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.
|
|
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
|