@theihtisham/agent-shadow-brain 6.0.3 → 6.3.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 (51) hide show
  1. package/CHANGELOG.md +59 -40
  2. package/README.md +438 -366
  3. package/dist/brain/brain-bus.d.ts +40 -0
  4. package/dist/brain/brain-bus.d.ts.map +1 -0
  5. package/dist/brain/brain-bus.js +94 -0
  6. package/dist/brain/brain-bus.js.map +1 -0
  7. package/dist/brain/collision-detective.d.ts.map +1 -1
  8. package/dist/brain/collision-detective.js +16 -0
  9. package/dist/brain/collision-detective.js.map +1 -1
  10. package/dist/brain/dream-engine.d.ts.map +1 -1
  11. package/dist/brain/dream-engine.js +12 -0
  12. package/dist/brain/dream-engine.js.map +1 -1
  13. package/dist/brain/forgetting-curve.d.ts.map +1 -1
  14. package/dist/brain/forgetting-curve.js +19 -0
  15. package/dist/brain/forgetting-curve.js.map +1 -1
  16. package/dist/brain/global-brain.d.ts +25 -1
  17. package/dist/brain/global-brain.d.ts.map +1 -1
  18. package/dist/brain/global-brain.js +116 -0
  19. package/dist/brain/global-brain.js.map +1 -1
  20. package/dist/brain/mcp-server.d.ts +1 -0
  21. package/dist/brain/mcp-server.d.ts.map +1 -1
  22. package/dist/brain/mcp-server.js +31 -0
  23. package/dist/brain/mcp-server.js.map +1 -1
  24. package/dist/brain/memory-graph.d.ts +51 -0
  25. package/dist/brain/memory-graph.d.ts.map +1 -0
  26. package/dist/brain/memory-graph.js +267 -0
  27. package/dist/brain/memory-graph.js.map +1 -0
  28. package/dist/brain/memory-seeder.d.ts.map +1 -1
  29. package/dist/brain/memory-seeder.js +23 -0
  30. package/dist/brain/memory-seeder.js.map +1 -1
  31. package/dist/brain/subagent-bridge.d.ts.map +1 -1
  32. package/dist/brain/subagent-bridge.js +12 -0
  33. package/dist/brain/subagent-bridge.js.map +1 -1
  34. package/dist/cli.js +1 -1
  35. package/dist/dashboard/server.d.ts +19 -0
  36. package/dist/dashboard/server.d.ts.map +1 -1
  37. package/dist/dashboard/server.js +171 -7
  38. package/dist/dashboard/server.js.map +1 -1
  39. package/dist/dashboard/v6-dashboard-html.d.ts +1 -1
  40. package/dist/dashboard/v6-dashboard-html.d.ts.map +1 -1
  41. package/dist/dashboard/v6-dashboard-html.js +2134 -942
  42. package/dist/dashboard/v6-dashboard-html.js.map +1 -1
  43. package/dist/types.d.ts +31 -0
  44. package/dist/types.d.ts.map +1 -1
  45. package/docs/launch/RELEASE_CHECKLIST_v6.0.3.md +102 -102
  46. package/docs/launch/RELEASE_NOTES_v6.0.3.md +111 -111
  47. package/docs/launch/RELEASE_NOTES_v6.1.0.md +38 -0
  48. package/docs/launch/RELEASE_NOTES_v6.2.0.md +54 -0
  49. package/package.json +27 -25
  50. package/tools/export-resume-pack.mjs +56 -56
  51. package/tools/record-global-memory.mjs +72 -72
package/CHANGELOG.md CHANGED
@@ -1,43 +1,62 @@
1
- # Changelog
2
-
3
- ## [6.0.3] - 2026-06-03 - Live Brain Release
4
-
5
- This release makes Shadow Brain more realistic and more useful for complex agent work. It focuses on source-backed long memory, live memory health, recall evals, agent briefings, and release-ready docs.
6
-
7
- ### Added
8
-
9
- - `src/brain/live-brain.ts`: Live Brain report engine for memory health, recall evals, hygiene actions, top memories, and agent briefings.
10
- - `src/brain/memory-seeder.ts`: verified memory seeding workflow with draft, user approval, agent approval, dual approval, reject, and seed-to-brain states.
11
- - `shadow-brain live-brain status`: shows memory quality, source coverage, recall health, and recommended actions.
12
- - `shadow-brain live-brain brief`: writes a markdown briefing for fresh sessions, handoffs, and context recovery.
13
- - `shadow-brain live-brain eval`: checks whether useful memory can be recalled for agent workflows.
14
- - `shadow-brain live-brain hygiene`: lists stale, duplicate, low-quality, and source-light memory issues.
15
- - `shadow-brain live-brain train-pack`: exports source-backed JSONL examples for evals, distillation, or local fine-tuning pipelines.
16
- - `/api/v6/live-brain` and the v6 dashboard Live Brain tab: dashboard/API route and UI for the same report and markdown briefing.
17
- - `/api/v6/memory-intelligence`: live memory data for source coverage, freshness, categories, agents, tags, recent writes, and approval queue counts.
18
- - `/api/v6/seed-*`: dashboard/API workflow for creating research drafts, approving/rejecting them, and committing approved drafts to global memory.
19
- - Dashboard Memory Seeder tab: select research agent, approval agent, approval mode, project path, sources, category, tags, and importance before writing durable memory.
20
- - Dashboard launch controls: `shadow-brain dash --host 127.0.0.1 --no-analysis` for fast UI/API startup on large repos.
21
- - MCP tools: `live_brain_status`, `live_brain_brief`, and `live_brain_train_pack`.
22
- - Focused tests for Live Brain scoring, briefing, recall eval, JSONL export, and memory seeding approval gates.
23
-
24
- ### Changed
25
-
26
- - README rewritten to be realistic about what the project does and does not do.
27
- - npm package version updated to `6.0.3`.
28
- - npm package description replaced with a practical local-first memory description.
29
- - Runtime-visible versions updated in CLI, auto-update, portability export, orchestrator status, and MCP server metadata.
30
- - Resume-pack source discovery now includes common repo docs such as `README.md`, `CHANGELOG.md`, `package.json`, and roadmap docs in addition to project-specific agent/progress files.
31
- - CLI config merging now honors explicit `watchMode: false` from one-shot commands.
32
- - Token Economy dashboard now separates the current runtime agent from historical model spend records, avoiding misleading labels such as an old Claude model appearing as the active Codex runtime.
33
-
34
- ### Notes
35
-
36
- - "Training" in this release means data export for user-run evals, distillation, or local fine-tuning. Shadow Brain does not modify remote model weights.
37
- - No new runtime dependencies were added.
38
- - Verification: TypeScript build passed; the full Vitest suite passed; `npm pack --dry-run` passed.
39
-
40
- ---
1
+ # Changelog
2
+
3
+ ## [6.3.0] - 2026-06-06 - Recall Confidence + Issue-Bot Spam Fix
4
+
5
+ This release adds per-memory recall confidence scoring and fixes a GitHub Actions
6
+ issue-bot that was opening duplicate milestone/spike issues.
7
+
8
+ ### Added
9
+
10
+ - `GlobalBrain.recallScored()`: recall enriched with a blended `RecallConfidence` per entry. Signals: keyword relevance, recency (30-day half-life decay), author-assigned importance, cross-agent corroboration, and prior usage. Results are ranked by confidence and support a `minConfidence` floor.
11
+ - `RecallConfidence` and `ScoredGlobalEntry` types in `src/types.ts`.
12
+ - MCP tool `global_recall_scored` exposing scored recall to compatible clients.
13
+ - Dashboard recall results now show a color-coded confidence badge (high/medium/low) with a per-signal breakdown on hover; the `/api/v6/ww2br-recall` endpoint now returns scored results.
14
+ - Focused tests in `tests/brain/global-recall-confidence.test.ts` for scoring, importance ranking, cross-agent corroboration, and `minConfidence` filtering.
15
+
16
+ ### Fixed
17
+
18
+ - Viral Amplifier bot opened dozens of duplicate `Milestone — 25 stars` and `Momentum spike` issues. Root causes: (1) the milestone job ran on every cron schedule (including the every-6h trending cron) instead of only the daily run, and (2) both scripts trusted local state files (`.github/.milestone-state.json`, `.github/.trending-state.json`) that the workflow never committed, so each fresh checkout reset state and re-fired.
19
+ - `milestone-notifier.mjs` and `trending-detector.mjs` are now idempotent: they verify against GitHub (open/closed issues for milestones, open issues within the 24h window for spikes) before posting, and treat lookup failures as "skip" to stay spam-safe.
20
+ - `viral-amplifier.yml`: milestone job restricted to the daily 14:00 UTC cron; `welcome-new-issue` now ignores bot-authored issues so the bot no longer triages its own issues.
21
+
22
+ ## [6.0.3] - 2026-06-03 - Live Brain Release
23
+
24
+ This release makes Shadow Brain more realistic and more useful for complex agent work. It focuses on source-backed long memory, live memory health, recall evals, agent briefings, and release-ready docs.
25
+
26
+ ### Added
27
+
28
+ - `src/brain/live-brain.ts`: Live Brain report engine for memory health, recall evals, hygiene actions, top memories, and agent briefings.
29
+ - `src/brain/memory-seeder.ts`: verified memory seeding workflow with draft, user approval, agent approval, dual approval, reject, and seed-to-brain states.
30
+ - `shadow-brain live-brain status`: shows memory quality, source coverage, recall health, and recommended actions.
31
+ - `shadow-brain live-brain brief`: writes a markdown briefing for fresh sessions, handoffs, and context recovery.
32
+ - `shadow-brain live-brain eval`: checks whether useful memory can be recalled for agent workflows.
33
+ - `shadow-brain live-brain hygiene`: lists stale, duplicate, low-quality, and source-light memory issues.
34
+ - `shadow-brain live-brain train-pack`: exports source-backed JSONL examples for evals, distillation, or local fine-tuning pipelines.
35
+ - `/api/v6/live-brain` and the v6 dashboard Live Brain tab: dashboard/API route and UI for the same report and markdown briefing.
36
+ - `/api/v6/memory-intelligence`: live memory data for source coverage, freshness, categories, agents, tags, recent writes, and approval queue counts.
37
+ - `/api/v6/seed-*`: dashboard/API workflow for creating research drafts, approving/rejecting them, and committing approved drafts to global memory.
38
+ - Dashboard Memory Seeder tab: select research agent, approval agent, approval mode, project path, sources, category, tags, and importance before writing durable memory.
39
+ - Dashboard launch controls: `shadow-brain dash --host 127.0.0.1 --no-analysis` for fast UI/API startup on large repos.
40
+ - MCP tools: `live_brain_status`, `live_brain_brief`, and `live_brain_train_pack`.
41
+ - Focused tests for Live Brain scoring, briefing, recall eval, JSONL export, and memory seeding approval gates.
42
+
43
+ ### Changed
44
+
45
+ - README rewritten to be realistic about what the project does and does not do.
46
+ - npm package version updated to `6.0.3`.
47
+ - npm package description replaced with a practical local-first memory description.
48
+ - Runtime-visible versions updated in CLI, auto-update, portability export, orchestrator status, and MCP server metadata.
49
+ - Resume-pack source discovery now includes common repo docs such as `README.md`, `CHANGELOG.md`, `package.json`, and roadmap docs in addition to project-specific agent/progress files.
50
+ - CLI config merging now honors explicit `watchMode: false` from one-shot commands.
51
+ - Token Economy dashboard now separates the current runtime agent from historical model spend records, avoiding misleading labels such as an old Claude model appearing as the active Codex runtime.
52
+
53
+ ### Notes
54
+
55
+ - "Training" in this release means data export for user-run evals, distillation, or local fine-tuning. Shadow Brain does not modify remote model weights.
56
+ - No new runtime dependencies were added.
57
+ - Verification: TypeScript build passed; the full Vitest suite passed; `npm pack --dry-run` passed.
58
+
59
+ ---
41
60
 
42
61
  All notable changes to `@theihtisham/agent-shadow-brain` are documented here.
43
62