@theihtisham/agent-shadow-brain 7.1.0 → 7.1.3

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 (111) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +47 -407
  3. package/dist/activity-cli.d.ts +3 -0
  4. package/dist/activity-cli.d.ts.map +1 -0
  5. package/dist/activity-cli.js +78 -0
  6. package/dist/activity-cli.js.map +1 -0
  7. package/dist/adapters/index.d.ts +2 -1
  8. package/dist/adapters/index.d.ts.map +1 -1
  9. package/dist/adapters/index.js +3 -2
  10. package/dist/adapters/index.js.map +1 -1
  11. package/dist/brain/activity-journal.d.ts +82 -0
  12. package/dist/brain/activity-journal.d.ts.map +1 -0
  13. package/dist/brain/activity-journal.js +314 -0
  14. package/dist/brain/activity-journal.js.map +1 -0
  15. package/dist/brain/activity-reporting.d.ts +14 -0
  16. package/dist/brain/activity-reporting.d.ts.map +1 -0
  17. package/dist/brain/activity-reporting.js +17 -0
  18. package/dist/brain/activity-reporting.js.map +1 -0
  19. package/dist/brain/auto-update.js +1 -1
  20. package/dist/brain/brain-portability.js +1 -1
  21. package/dist/brain/client-integrations.d.ts +61 -0
  22. package/dist/brain/client-integrations.d.ts.map +1 -0
  23. package/dist/brain/client-integrations.js +98 -0
  24. package/dist/brain/client-integrations.js.map +1 -0
  25. package/dist/brain/context-assembly.d.ts +76 -0
  26. package/dist/brain/context-assembly.d.ts.map +1 -0
  27. package/dist/brain/context-assembly.js +305 -0
  28. package/dist/brain/context-assembly.js.map +1 -0
  29. package/dist/brain/feature-settings.d.ts +58 -0
  30. package/dist/brain/feature-settings.d.ts.map +1 -0
  31. package/dist/brain/feature-settings.js +241 -0
  32. package/dist/brain/feature-settings.js.map +1 -0
  33. package/dist/brain/global-brain.d.ts +7 -0
  34. package/dist/brain/global-brain.d.ts.map +1 -1
  35. package/dist/brain/global-brain.js +19 -4
  36. package/dist/brain/global-brain.js.map +1 -1
  37. package/dist/brain/mcp-server.d.ts +21 -1
  38. package/dist/brain/mcp-server.d.ts.map +1 -1
  39. package/dist/brain/mcp-server.js +191 -25
  40. package/dist/brain/mcp-server.js.map +1 -1
  41. package/dist/brain/mcp-stdio.d.ts +12 -0
  42. package/dist/brain/mcp-stdio.d.ts.map +1 -0
  43. package/dist/brain/mcp-stdio.js +134 -0
  44. package/dist/brain/mcp-stdio.js.map +1 -0
  45. package/dist/brain/memory-annotations.d.ts +97 -0
  46. package/dist/brain/memory-annotations.d.ts.map +1 -0
  47. package/dist/brain/memory-annotations.js +388 -0
  48. package/dist/brain/memory-annotations.js.map +1 -0
  49. package/dist/brain/memory-graph.d.ts.map +1 -1
  50. package/dist/brain/memory-graph.js +12 -23
  51. package/dist/brain/memory-graph.js.map +1 -1
  52. package/dist/brain/memory-sources.d.ts +8 -0
  53. package/dist/brain/memory-sources.d.ts.map +1 -0
  54. package/dist/brain/memory-sources.js +27 -0
  55. package/dist/brain/memory-sources.js.map +1 -0
  56. package/dist/brain/orchestrator.js +1 -1
  57. package/dist/brain/subconscious.d.ts +21 -24
  58. package/dist/brain/subconscious.d.ts.map +1 -1
  59. package/dist/brain/subconscious.js +82 -218
  60. package/dist/brain/subconscious.js.map +1 -1
  61. package/dist/brain/workflow-skills.d.ts +5 -5
  62. package/dist/cli.js +19 -2
  63. package/dist/cli.js.map +1 -1
  64. package/dist/context-cli.d.ts +3 -0
  65. package/dist/context-cli.d.ts.map +1 -0
  66. package/dist/context-cli.js +56 -0
  67. package/dist/context-cli.js.map +1 -0
  68. package/dist/curation-cli.d.ts +4 -0
  69. package/dist/curation-cli.d.ts.map +1 -0
  70. package/dist/curation-cli.js +118 -0
  71. package/dist/curation-cli.js.map +1 -0
  72. package/dist/dashboard/live-workspace-html.d.ts +2 -0
  73. package/dist/dashboard/live-workspace-html.d.ts.map +1 -0
  74. package/dist/dashboard/live-workspace-html.js +893 -0
  75. package/dist/dashboard/live-workspace-html.js.map +1 -0
  76. package/dist/dashboard/server.d.ts +1 -0
  77. package/dist/dashboard/server.d.ts.map +1 -1
  78. package/dist/dashboard/server.js +53 -18
  79. package/dist/dashboard/server.js.map +1 -1
  80. package/dist/dashboard/v6-dashboard-html.d.ts +1 -1
  81. package/dist/dashboard/v6-dashboard-html.d.ts.map +1 -1
  82. package/dist/dashboard/v6-dashboard-html.js +7 -29
  83. package/dist/dashboard/v6-dashboard-html.js.map +1 -1
  84. package/dist/dashboard/workspace-api.d.ts +16 -0
  85. package/dist/dashboard/workspace-api.d.ts.map +1 -0
  86. package/dist/dashboard/workspace-api.js +309 -0
  87. package/dist/dashboard/workspace-api.js.map +1 -0
  88. package/dist/dashboard/workspace-html.d.ts +2 -0
  89. package/dist/dashboard/workspace-html.d.ts.map +1 -0
  90. package/dist/dashboard/workspace-html.js +2132 -0
  91. package/dist/dashboard/workspace-html.js.map +1 -0
  92. package/dist/index.d.ts +10 -0
  93. package/dist/index.d.ts.map +1 -1
  94. package/dist/index.js +8 -0
  95. package/dist/index.js.map +1 -1
  96. package/dist/integration-cli.d.ts +3 -0
  97. package/dist/integration-cli.d.ts.map +1 -0
  98. package/dist/integration-cli.js +14 -0
  99. package/dist/integration-cli.js.map +1 -0
  100. package/dist/types.d.ts +12 -3
  101. package/dist/types.d.ts.map +1 -1
  102. package/docs/WORKSPACE.md +111 -0
  103. package/docs/assets/context-flow-v7.2.png +0 -0
  104. package/docs/assets/live-v7.1.3.png +0 -0
  105. package/docs/assets/memory-detail-v7.1.3.png +0 -0
  106. package/docs/assets/overview-v7.1.3.png +0 -0
  107. package/docs/assets/workspace-graph-v7.2.png +0 -0
  108. package/docs/assets/workspace-overview-v7.2.png +0 -0
  109. package/docs/launch/RELEASE_NOTES_v7.1.3.md +40 -0
  110. package/docs/launch/RELEASE_NOTES_v7.2.0.md +24 -0
  111. package/package.json +20 -121
@@ -0,0 +1,40 @@
1
+ # Agent Shadow Brain 7.1.3
2
+
3
+ Version 7.1.3 connects memory review, the workspace graph, and the context handed to an agent. The new live operations portal shows recorded agent activity and tool timing.
4
+
5
+ ## Live operations
6
+
7
+ Open `/live` on the dashboard address for the session list, activity network, charts, and event timeline. Measured activity comes from the local MCP service. Hosts can explicitly report task phases and tool spans. The portal labels the two sources and uses matched, measured calls for timing metrics.
8
+
9
+ The shared local journal keeps the latest 500 metadata events. It tracks sequence and journal identity so readers can continue from a cursor and detect gaps or a restarted journal. `activityRecording` controls new records and `liveActivity` controls visibility. Both are enabled by default and can be changed with the other three runtime controls. Use `activity report` to send a host report and `activity tail` to inspect the journal.
10
+
11
+ ## Memory review and relations
12
+
13
+ Open a memory in the workspace to see its content, recorded references, current review, and history. Set its state to active, archived, or contested. Record a same-project link of type related, supports, contradicts, or supersedes. Supersession links point from the replacement to the older memory.
14
+
15
+ Context assembly filters inactive memories before ranking, preserves relevant relation and source provenance when collapsing duplicates, and labels recorded contradictions. If a replacement disappears, its older memory stays superseded until you remove the relation. Manual reviews and links record decisions to inspect against the underlying evidence.
16
+
17
+ The `curate show`, `curate review`, `curate link`, and `curate unlink` commands use the same annotation store as the workspace. The store validates project identities, revisions, duplicate relations, and supersession cycles. It keeps an audit trail alongside the existing memory store.
18
+
19
+ ## Connect a client
20
+
21
+ The workspace's Integrations view shows project skill-file presence, supported client capabilities, and local runtime and storage checks. Codex, Claude Code, OpenCode, and DeepSeek Harness can use their documented project skill layouts. Host-side discovery depends on client configuration.
22
+
23
+ The standalone MCP service now runs over standard input and output.
24
+
25
+ ```bash
26
+ shadow-brain mcp --stdio
27
+ ```
28
+
29
+ Configure this command as the executable and arguments in a compatible client. The service exposes nine read-only memory, context, and workflow tools plus the explicit `activity_report` write tool. Activity recording uses a separate journal from the memory store. DeepSeek Harness needs its MCP client and filesystem skill plugins enabled. See the [workspace guide](../WORKSPACE.md) and [skill integration guide](../WORKFLOW_INTEGRATION.md).
30
+
31
+ ## Upgrade
32
+
33
+ ```bash
34
+ npm install -g @theihtisham/agent-shadow-brain@7.1.3
35
+ shadow-brain dash . --no-analysis
36
+ ```
37
+
38
+ Existing memories retain schema version 1. Keep `global.json` and the separate `memory-annotations.json` when backing up your memory and review state. Follow the [7.0 migration notes](RELEASE_NOTES_v7.0.0.md) if you are upgrading from 6.x.
39
+
40
+ This upgrade uses the maintainer-requested version **7.1.3**, published after 7.2.0. It is assigned the npm `latest` tag, but semver update tools may still prefer 7.2.0. Use the exact install command above.
@@ -0,0 +1,24 @@
1
+ # Agent Shadow Brain 7.2.0
2
+
3
+ Version 7.2 makes it easier to see what agents have saved and choose what to hand to a new session. The default local workspace has five views for overview, memory search, the project and agent graph, context assembly, and feature controls. The previous dashboard remains available at `/advanced`.
4
+
5
+ ## What changed
6
+
7
+ - Context packs rank memories for the selected project and task, collapse exact duplicates, retain recorded source provenance, and explain what fits the rendered budget. Cross-project context requires both a setting and explicit opt-in.
8
+ - Session briefings use the same assembler. Cached briefings follow the current task and feature settings. Disabling automatic briefings suppresses both new and cached output.
9
+ - Four persistent switches control context packs, cross-project access within context packs, automatic briefings, and dashboard activity. The settings store validates updates, detects revision conflicts, and replaces saved settings atomically.
10
+ - The CLI adds `context-pack` and `features list|set`. MCP clients can call `context_pack` and `feature_flags`. Library consumers can import the assembler and settings store directly.
11
+ - The README includes a conceptual memory-flow illustration and screenshots from the running workspace with synthetic data.
12
+
13
+ ## Start the workspace
14
+
15
+ ```bash
16
+ npm install -g @theihtisham/agent-shadow-brain@7.2.0
17
+ shadow-brain dash . --no-analysis
18
+ ```
19
+
20
+ From a second terminal, run `shadow-brain context-pack "import retry behavior" --project . --token-budget 1200` to inspect what an agent would receive for that task.
21
+
22
+ Memory storage keeps schema version 1. The six bundled skills and the existing skill install workflow remain available. If you are coming from 6.x, follow the [7.0 migration notes](RELEASE_NOTES_v7.0.0.md).
23
+
24
+ [Workspace guide](../WORKSPACE.md) · [Skill integration guide](../WORKFLOW_INTEGRATION.md)
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@theihtisham/agent-shadow-brain",
3
- "version": "7.1.0",
4
- "description": "Local-first memory, task workflows, and built-in skills for AI coding agents. Share source-backed lessons, install focused skills for Codex, Claude Code, OpenCode, and DeepSeek Harness, and access guidance through CLI, library, and MCP tools.",
3
+ "version": "7.1.3",
4
+ "description": "Local memory, focused skills, and a visual context workspace for coding agents. Explore memories, build project-scoped context, and control briefings across Codex, Claude Code, OpenCode, and DeepSeek Harness.",
5
5
  "main": "dist/index.js",
6
6
  "exports": {
7
7
  ".": "./dist/index.js"
@@ -22,131 +22,26 @@
22
22
  "test:package": "node tools/package-smoke.mjs"
23
23
  },
24
24
  "keywords": [
25
+ "ai",
26
+ "coding-agents",
27
+ "agent-memory",
28
+ "local-first",
29
+ "context",
30
+ "context-management",
25
31
  "agent-skills",
26
32
  "task-workflow",
27
- "deepseek-harness",
28
- "ai",
29
- "agent",
30
- "brain",
31
- "shadow",
32
- "shadow-brain",
33
- "agent-shadow-brain",
34
- "subconscious",
35
- "singleton-brain",
36
- "global-brain",
37
- "session-hook",
38
- "agent-handoff",
39
- "agent-firewall",
40
- "mcp-security",
41
- "prompt-injection",
42
- "secret-scanning",
43
- "auto-attach",
33
+ "codex",
44
34
  "claude-code",
45
- "claude",
46
- "cursor",
47
- "cursor-ai",
48
- "kilo-code",
49
- "cline",
50
35
  "opencode",
51
- "codex",
52
- "openai-codex",
53
- "roo-code",
54
- "rovodev",
55
- "aider",
56
- "copilot",
57
- "github-copilot",
58
- "windsurf",
59
- "codeium",
60
- "review",
61
- "intelligence",
36
+ "deepseek-harness",
62
37
  "mcp",
63
- "mcp-server",
64
- "model-context-protocol",
65
- "lsp",
66
- "language-server",
67
- "llm",
68
- "anthropic",
69
- "openai",
70
- "gemini",
71
- "ollama",
72
- "deepseek",
73
- "turbo-quant",
74
- "infinite-memory",
75
- "hierarchical-memory",
76
- "context-recall",
77
- "context-injection",
78
- "consensus-engine",
79
- "collective-learning",
80
- "cross-agent",
81
- "cross-project",
82
- "cross-session",
83
- "sssp",
84
- "self-evolution",
85
- "swarm-intelligence",
86
- "knowledge-graph",
87
- "adversarial-defense",
88
- "hallucination-defense",
89
- "bug-prediction",
90
- "pagerank",
91
- "neural-mesh",
92
- "multi-agent",
93
- "agentic",
94
- "agentic-ai",
95
- "zero-config",
96
- "auto-setup",
97
38
  "dashboard",
98
- "plugin-system",
99
- "brain-export",
100
- "code-analysis",
39
+ "knowledge-graph",
101
40
  "developer-tools",
102
- "ai-coding",
103
- "ai-pair-programming",
104
- "coding-assistant",
105
- "smart-fix",
106
- "health-score",
107
- "pattern-memory",
108
- "smart-cache",
109
- "predictive-prefetch",
110
- "code-dna",
111
- "temporal-intelligence",
112
- "fine-tuning",
113
- "intent-engine",
114
- "git-hooks",
115
- "ci-cd",
116
- "team-collaboration",
117
- "developer-productivity",
118
- "trending",
119
- "viral",
120
- "open-source",
121
- "hive-mind",
122
- "subagent-bridge",
123
- "sabb",
124
- "causal-chains",
125
- "dream-engine",
126
- "agent-reputation",
127
- "swarm-debate",
128
- "pre-mortem",
129
- "branch-brain",
130
- "attention-heatmap",
131
- "token-economy",
132
- "formal-verification",
133
- "calibration-monitor",
134
- "air-gap",
135
- "e2e-encryption",
136
- "voice-mode",
137
- "brain-garden",
138
- "pr-review",
139
- "team-brain",
140
- "brain-exchange",
141
- "local-first",
142
- "ollama",
143
- "forgetting-curve",
144
- "sleep-consolidation",
145
- "live-brain",
146
- "resume-pack",
147
- "memory-quality",
148
- "training-jsonl",
149
- "source-backed-memory"
41
+ "cross-agent",
42
+ "recall",
43
+ "typescript",
44
+ "cli"
150
45
  ],
151
46
  "author": "ihtisham",
152
47
  "license": "MIT",
@@ -196,7 +91,11 @@
196
91
  "docs/launch/RELEASE_CHECKLIST_v7.0.0.md",
197
92
  "skills/**/*",
198
93
  "docs/launch/RELEASE_NOTES_v7.1.0.md",
199
- "docs/WORKFLOW_INTEGRATION.md"
94
+ "docs/WORKFLOW_INTEGRATION.md",
95
+ "docs/assets/*.png",
96
+ "docs/WORKSPACE.md",
97
+ "docs/launch/RELEASE_NOTES_v7.2.0.md",
98
+ "docs/launch/RELEASE_NOTES_v7.1.3.md"
200
99
  ],
201
100
  "publishConfig": {
202
101
  "access": "public"