@theihtisham/agent-shadow-brain 7.1.3 → 7.1.4

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 (254) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +125 -90
  3. package/dist/adapters/index.d.ts +1 -1
  4. package/dist/adapters/index.d.ts.map +1 -1
  5. package/dist/adapters/index.js.map +1 -1
  6. package/dist/brain/activity-journal.d.ts.map +1 -1
  7. package/dist/brain/activity-journal.js +2 -1
  8. package/dist/brain/activity-journal.js.map +1 -1
  9. package/dist/brain/auto-update.js +1 -1
  10. package/dist/brain/brain-portability.js +1 -1
  11. package/dist/brain/client-config.d.ts +19 -0
  12. package/dist/brain/client-config.d.ts.map +1 -0
  13. package/dist/brain/client-config.js +40 -0
  14. package/dist/brain/client-config.js.map +1 -0
  15. package/dist/brain/client-integrations.d.ts +2 -0
  16. package/dist/brain/client-integrations.d.ts.map +1 -1
  17. package/dist/brain/client-integrations.js +8 -27
  18. package/dist/brain/client-integrations.js.map +1 -1
  19. package/dist/brain/context-assembly.d.ts +10 -2
  20. package/dist/brain/context-assembly.d.ts.map +1 -1
  21. package/dist/brain/context-assembly.js +238 -14
  22. package/dist/brain/context-assembly.js.map +1 -1
  23. package/dist/brain/context-request.d.ts +4 -0
  24. package/dist/brain/context-request.d.ts.map +1 -0
  25. package/dist/brain/context-request.js +22 -0
  26. package/dist/brain/context-request.js.map +1 -0
  27. package/dist/brain/context-retrieval.d.ts +88 -0
  28. package/dist/brain/context-retrieval.d.ts.map +1 -0
  29. package/dist/brain/context-retrieval.js +300 -0
  30. package/dist/brain/context-retrieval.js.map +1 -0
  31. package/dist/brain/feature-settings.d.ts.map +1 -1
  32. package/dist/brain/feature-settings.js +2 -1
  33. package/dist/brain/feature-settings.js.map +1 -1
  34. package/dist/brain/file-identity.d.ts +4 -0
  35. package/dist/brain/file-identity.d.ts.map +1 -0
  36. package/dist/brain/file-identity.js +27 -0
  37. package/dist/brain/file-identity.js.map +1 -0
  38. package/dist/brain/global-brain.d.ts +11 -1
  39. package/dist/brain/global-brain.d.ts.map +1 -1
  40. package/dist/brain/global-brain.js +58 -6
  41. package/dist/brain/global-brain.js.map +1 -1
  42. package/dist/brain/mcp-server.d.ts +9 -0
  43. package/dist/brain/mcp-server.d.ts.map +1 -1
  44. package/dist/brain/mcp-server.js +237 -53
  45. package/dist/brain/mcp-server.js.map +1 -1
  46. package/dist/brain/mcp-stdio.d.ts.map +1 -1
  47. package/dist/brain/mcp-stdio.js +10 -4
  48. package/dist/brain/mcp-stdio.js.map +1 -1
  49. package/dist/brain/memory-annotations.d.ts.map +1 -1
  50. package/dist/brain/memory-annotations.js +2 -1
  51. package/dist/brain/memory-annotations.js.map +1 -1
  52. package/dist/brain/memory-inspection.d.ts +72 -0
  53. package/dist/brain/memory-inspection.d.ts.map +1 -0
  54. package/dist/brain/memory-inspection.js +131 -0
  55. package/dist/brain/memory-inspection.js.map +1 -0
  56. package/dist/brain/memory-mcp-content.d.ts +44 -0
  57. package/dist/brain/memory-mcp-content.d.ts.map +1 -0
  58. package/dist/brain/memory-mcp-content.js +91 -0
  59. package/dist/brain/memory-mcp-content.js.map +1 -0
  60. package/dist/brain/orchestrator.js +1 -1
  61. package/dist/brain/project-feedback.d.ts +63 -0
  62. package/dist/brain/project-feedback.d.ts.map +1 -0
  63. package/dist/brain/project-feedback.js +289 -0
  64. package/dist/brain/project-feedback.js.map +1 -0
  65. package/dist/brain/project-hub-contract.d.ts +326 -0
  66. package/dist/brain/project-hub-contract.d.ts.map +1 -0
  67. package/dist/brain/project-hub-contract.js +56 -0
  68. package/dist/brain/project-hub-contract.js.map +1 -0
  69. package/dist/brain/project-hub-mcp.d.ts +168 -0
  70. package/dist/brain/project-hub-mcp.d.ts.map +1 -0
  71. package/dist/brain/project-hub-mcp.js +41 -0
  72. package/dist/brain/project-hub-mcp.js.map +1 -0
  73. package/dist/brain/project-hub-pdf-worker.d.ts +13 -0
  74. package/dist/brain/project-hub-pdf-worker.d.ts.map +1 -0
  75. package/dist/brain/project-hub-pdf-worker.js +84 -0
  76. package/dist/brain/project-hub-pdf-worker.js.map +1 -0
  77. package/dist/brain/project-hub-store.d.ts +38 -0
  78. package/dist/brain/project-hub-store.d.ts.map +1 -0
  79. package/dist/brain/project-hub-store.js +189 -0
  80. package/dist/brain/project-hub-store.js.map +1 -0
  81. package/dist/brain/project-hub.d.ts +127 -0
  82. package/dist/brain/project-hub.d.ts.map +1 -0
  83. package/dist/brain/project-hub.js +381 -0
  84. package/dist/brain/project-hub.js.map +1 -0
  85. package/dist/brain/project-kit-inspection.d.ts +28 -0
  86. package/dist/brain/project-kit-inspection.d.ts.map +1 -0
  87. package/dist/brain/project-kit-inspection.js +200 -0
  88. package/dist/brain/project-kit-inspection.js.map +1 -0
  89. package/dist/brain/project-kit-paths.d.ts +13 -0
  90. package/dist/brain/project-kit-paths.d.ts.map +1 -0
  91. package/dist/brain/project-kit-paths.js +141 -0
  92. package/dist/brain/project-kit-paths.js.map +1 -0
  93. package/dist/brain/project-kit.d.ts +41 -0
  94. package/dist/brain/project-kit.d.ts.map +1 -0
  95. package/dist/brain/project-kit.js +255 -0
  96. package/dist/brain/project-kit.js.map +1 -0
  97. package/dist/brain/project-memory.d.ts +38 -0
  98. package/dist/brain/project-memory.d.ts.map +1 -0
  99. package/dist/brain/project-memory.js +76 -0
  100. package/dist/brain/project-memory.js.map +1 -0
  101. package/dist/brain/subconscious.js +2 -2
  102. package/dist/brain/subconscious.js.map +1 -1
  103. package/dist/brain/workflow-skills.d.ts.map +1 -1
  104. package/dist/brain/workflow-skills.js +3 -2
  105. package/dist/brain/workflow-skills.js.map +1 -1
  106. package/dist/cli.js +22 -3
  107. package/dist/cli.js.map +1 -1
  108. package/dist/context-cli.d.ts.map +1 -1
  109. package/dist/context-cli.js +39 -5
  110. package/dist/context-cli.js.map +1 -1
  111. package/dist/dashboard/brain-hub-actions.d.ts +2 -0
  112. package/dist/dashboard/brain-hub-actions.d.ts.map +1 -0
  113. package/dist/dashboard/brain-hub-actions.js +137 -0
  114. package/dist/dashboard/brain-hub-actions.js.map +1 -0
  115. package/dist/dashboard/brain-hub-client.d.ts +2 -0
  116. package/dist/dashboard/brain-hub-client.d.ts.map +1 -0
  117. package/dist/dashboard/brain-hub-client.js +335 -0
  118. package/dist/dashboard/brain-hub-client.js.map +1 -0
  119. package/dist/dashboard/brain-hub-graph.d.ts +2 -0
  120. package/dist/dashboard/brain-hub-graph.d.ts.map +1 -0
  121. package/dist/dashboard/brain-hub-graph.js +176 -0
  122. package/dist/dashboard/brain-hub-graph.js.map +1 -0
  123. package/dist/dashboard/brain-hub-html.d.ts +2 -0
  124. package/dist/dashboard/brain-hub-html.d.ts.map +1 -0
  125. package/dist/dashboard/brain-hub-html.js +30 -0
  126. package/dist/dashboard/brain-hub-html.js.map +1 -0
  127. package/dist/dashboard/brain-hub-project-views.d.ts +2 -0
  128. package/dist/dashboard/brain-hub-project-views.d.ts.map +1 -0
  129. package/dist/dashboard/brain-hub-project-views.js +79 -0
  130. package/dist/dashboard/brain-hub-project-views.js.map +1 -0
  131. package/dist/dashboard/brain-hub-views.d.ts +2 -0
  132. package/dist/dashboard/brain-hub-views.d.ts.map +1 -0
  133. package/dist/dashboard/brain-hub-views.js +150 -0
  134. package/dist/dashboard/brain-hub-views.js.map +1 -0
  135. package/dist/dashboard/demo-workspace.d.ts +11 -0
  136. package/dist/dashboard/demo-workspace.d.ts.map +1 -0
  137. package/dist/dashboard/demo-workspace.js +178 -0
  138. package/dist/dashboard/demo-workspace.js.map +1 -0
  139. package/dist/dashboard/live-workspace-html.d.ts.map +1 -1
  140. package/dist/dashboard/live-workspace-html.js +177 -28
  141. package/dist/dashboard/live-workspace-html.js.map +1 -1
  142. package/dist/dashboard/project-feedback-html.d.ts +5 -0
  143. package/dist/dashboard/project-feedback-html.d.ts.map +1 -0
  144. package/dist/dashboard/project-feedback-html.js +216 -0
  145. package/dist/dashboard/project-feedback-html.js.map +1 -0
  146. package/dist/dashboard/project-hub-api.d.ts +5 -0
  147. package/dist/dashboard/project-hub-api.d.ts.map +1 -0
  148. package/dist/dashboard/project-hub-api.js +121 -0
  149. package/dist/dashboard/project-hub-api.js.map +1 -0
  150. package/dist/dashboard/project-kit-html.d.ts +4 -0
  151. package/dist/dashboard/project-kit-html.d.ts.map +1 -0
  152. package/dist/dashboard/project-kit-html.js +359 -0
  153. package/dist/dashboard/project-kit-html.js.map +1 -0
  154. package/dist/dashboard/project-workspace.d.ts +16 -0
  155. package/dist/dashboard/project-workspace.d.ts.map +1 -0
  156. package/dist/dashboard/project-workspace.js +106 -0
  157. package/dist/dashboard/project-workspace.js.map +1 -0
  158. package/dist/dashboard/server.d.ts +1 -0
  159. package/dist/dashboard/server.d.ts.map +1 -1
  160. package/dist/dashboard/server.js +15 -4
  161. package/dist/dashboard/server.js.map +1 -1
  162. package/dist/dashboard/v6-dashboard-html.d.ts +1 -1
  163. package/dist/dashboard/v6-dashboard-html.d.ts.map +1 -1
  164. package/dist/dashboard/v6-dashboard-html.js +27 -27
  165. package/dist/dashboard/workspace-api.d.ts +6 -0
  166. package/dist/dashboard/workspace-api.d.ts.map +1 -1
  167. package/dist/dashboard/workspace-api.js +154 -34
  168. package/dist/dashboard/workspace-api.js.map +1 -1
  169. package/dist/dashboard/workspace-html.d.ts.map +1 -1
  170. package/dist/dashboard/workspace-html.js +487 -81
  171. package/dist/dashboard/workspace-html.js.map +1 -1
  172. package/dist/dashboard/workspace-status.d.ts +50 -0
  173. package/dist/dashboard/workspace-status.d.ts.map +1 -0
  174. package/dist/dashboard/workspace-status.js +22 -0
  175. package/dist/dashboard/workspace-status.js.map +1 -0
  176. package/dist/index.d.ts +10 -0
  177. package/dist/index.d.ts.map +1 -1
  178. package/dist/index.js +7 -0
  179. package/dist/index.js.map +1 -1
  180. package/dist/integration-cli.d.ts.map +1 -1
  181. package/dist/integration-cli.js +6 -4
  182. package/dist/integration-cli.js.map +1 -1
  183. package/dist/project-cli.d.ts +3 -0
  184. package/dist/project-cli.d.ts.map +1 -0
  185. package/dist/project-cli.js +100 -0
  186. package/dist/project-cli.js.map +1 -0
  187. package/dist/types.d.ts +1 -1
  188. package/dist/types.d.ts.map +1 -1
  189. package/docs/COMPARISON.md +22 -0
  190. package/docs/COMPONENTS.md +66 -0
  191. package/docs/CONTEXT_LAB.md +79 -0
  192. package/docs/FEATURES_AND_LIMITS.md +24 -0
  193. package/docs/INTEGRATIONS.md +68 -0
  194. package/docs/LEARNING.md +46 -0
  195. package/docs/PROJECT_KIT.md +93 -0
  196. package/docs/QUICKSTART.md +44 -0
  197. package/docs/README.md +33 -0
  198. package/docs/ROADMAP-v7.md +147 -0
  199. package/docs/SHARING.md +13 -0
  200. package/docs/SHOWCASE.md +87 -0
  201. package/docs/STATS.md +21 -0
  202. package/docs/TROUBLESHOOTING.md +42 -0
  203. package/docs/UPGRADE_PLAN_v7.0.0.md +203 -0
  204. package/docs/VIRAL-PLAYBOOK.md +259 -0
  205. package/docs/VISUAL_GUIDE_v7.1.4.md +70 -0
  206. package/docs/WORKFLOW_INTEGRATION.md +19 -1
  207. package/docs/WORKSPACE.md +17 -91
  208. package/docs/assets/7.1.4-collaboration-design-preview.png +0 -0
  209. package/docs/assets/7.1.4-comparison.png +0 -0
  210. package/docs/assets/7.1.4-context-lab.png +0 -0
  211. package/docs/assets/7.1.4-control-room-dense-preview.png +0 -0
  212. package/docs/assets/7.1.4-control-room-focus-preview.png +0 -0
  213. package/docs/assets/7.1.4-features.png +0 -0
  214. package/docs/assets/7.1.4-graph.png +0 -0
  215. package/docs/assets/7.1.4-hub-control-room.png +0 -0
  216. package/docs/assets/7.1.4-hub-empty.png +0 -0
  217. package/docs/assets/7.1.4-hub-knowledge.png +0 -0
  218. package/docs/assets/7.1.4-hub-learning.png +0 -0
  219. package/docs/assets/7.1.4-hub-mobile.png +0 -0
  220. package/docs/assets/7.1.4-hub-public-docs-source.png +0 -0
  221. package/docs/assets/7.1.4-hub-public-docs.gif +0 -0
  222. package/docs/assets/7.1.4-hub-public-docs.png +0 -0
  223. package/docs/assets/7.1.4-hub-setup.png +0 -0
  224. package/docs/assets/7.1.4-hub-walkthrough.gif +0 -0
  225. package/docs/assets/7.1.4-integrations.png +0 -0
  226. package/docs/assets/7.1.4-knowledge-design-preview.png +0 -0
  227. package/docs/assets/7.1.4-learning-design-preview.png +0 -0
  228. package/docs/assets/7.1.4-learning.png +0 -0
  229. package/docs/assets/7.1.4-live.png +0 -0
  230. package/docs/assets/7.1.4-memory-review.png +0 -0
  231. package/docs/assets/7.1.4-mobile.png +0 -0
  232. package/docs/assets/7.1.4-models-design-preview.png +0 -0
  233. package/docs/assets/7.1.4-outcome-ranking.png +0 -0
  234. package/docs/assets/7.1.4-overview.png +0 -0
  235. package/docs/assets/7.1.4-project-kit.png +0 -0
  236. package/docs/assets/7.1.4-project-skill-preview.png +0 -0
  237. package/docs/assets/7.1.4-replay.png +0 -0
  238. package/docs/assets/7.1.4-setup-design-preview.png +0 -0
  239. package/docs/assets/7.1.4-usage-design-preview.png +0 -0
  240. package/docs/assets/context-v7.1.3.png +0 -0
  241. package/docs/assets/features-v7.1.3.png +0 -0
  242. package/docs/assets/graph-v7.1.3.png +0 -0
  243. package/docs/assets/integrations-v7.1.3.png +0 -0
  244. package/docs/assets/live-v7.1.4.gif +0 -0
  245. package/docs/evaluation/CONTEXT_EVALUATION_v7.1.4.json +1818 -0
  246. package/docs/evaluation/CONTEXT_EVALUATION_v7.1.4.md +36 -0
  247. package/docs/launch/COMPONENT_MAP_v7.1.4.md +307 -0
  248. package/docs/launch/PROJECT_KIT_PLAN_v7.1.4.md +110 -0
  249. package/docs/launch/PROJECT_LEARNING_PLAN_v7.1.4.md +63 -0
  250. package/docs/launch/RELEASE_NOTES_v7.1.4.md +30 -0
  251. package/docs/launch/RESEARCH_AND_PLAN_v7.1.4.md +255 -0
  252. package/package.json +25 -7
  253. package/skills/shadow-research/SKILL.md +2 -0
  254. package/skills/shadow-workflow/SKILL.md +6 -0
package/dist/cli.js CHANGED
@@ -13,7 +13,8 @@ import { registerContextCommands } from './context-cli.js';
13
13
  import { registerCurationCommands } from './curation-cli.js';
14
14
  import { registerIntegrationCommands } from './integration-cli.js';
15
15
  import { registerActivityCommands } from './activity-cli.js';
16
- const VERSION = '7.1.3';
16
+ import { registerProjectCommands } from './project-cli.js';
17
+ const VERSION = '7.1.4';
17
18
  // Defer config reads until a command actually needs provider settings.
18
19
  let savedConfig;
19
20
  function getConfig() {
@@ -584,8 +585,8 @@ const doctorCmd = new Command('doctor')
584
585
  }
585
586
  const nodeVersion = process.version;
586
587
  const [major, minor] = nodeVersion.slice(1).split('.').map(Number);
587
- const nodeSupported = (major === 22 && minor >= 12) || major === 24 || major >= 26;
588
- checks.push({ name: 'Node.js', status: nodeSupported ? 'ok' : 'warn', detail: `${nodeVersion} ${nodeSupported ? '(supported)' : '(requires Node 22.12+, 24.x, or 26+)'}` });
588
+ const nodeSupported = (major === 22 && minor >= 13) || major === 24 || major >= 26;
589
+ checks.push({ name: 'Node.js', status: nodeSupported ? 'ok' : 'warn', detail: `${nodeVersion} ${nodeSupported ? '(supported)' : '(requires Node 22.13+, 24.x, or 26+)'}` });
589
590
  const projectDir = getConfig().get('projectDir') || process.cwd();
590
591
  try {
591
592
  const stat = fs.statSync(projectDir);
@@ -5084,10 +5085,28 @@ const recallExplainCmd = new Command('recall-explain')
5084
5085
  program.addCommand(storageHealthCmd);
5085
5086
  program.addCommand(recallExplainCmd);
5086
5087
  registerWorkflowCommands(program);
5088
+ demoCmd.enablePositionalOptions().command('workspace').description('Open an isolated synthetic workspace tour without providers or your saved memory')
5089
+ .option('--port <number>', 'Loopback port, 0 selects an available port', '0')
5090
+ .option('--no-activity', 'Keep the initial recorded snapshot without generating further synthetic calls')
5091
+ .action(async (opts) => {
5092
+ const { startDemoWorkspace } = await import('./dashboard/demo-workspace.js');
5093
+ // Commander may consume this shared flag on the legacy parent command.
5094
+ const port = demoCmd.getOptionValueSource('port') === 'cli' ? demoCmd.opts().port : opts.port;
5095
+ const demo = await startDemoWorkspace({ port: Number(port), activity: opts.activity });
5096
+ console.log('Agent Shadow Brain ' + VERSION + ' · SYNTHETIC DEMO');
5097
+ console.log('Brain Hub: ' + demo.url + '/hub');
5098
+ console.log('Memory workspace: ' + demo.url + '/workspace');
5099
+ console.log('Live view: ' + demo.url + '/live');
5100
+ console.log('Scripted local MCP calls, not connected coding-agent work. Press Ctrl+C to stop and remove this temporary demo.');
5101
+ const stop = () => { void demo.close().then(() => process.exit(0), () => { console.error('Demo stopped; temporary cleanup failed.'); process.exit(1); }); };
5102
+ process.once('SIGINT', stop);
5103
+ process.once('SIGTERM', stop);
5104
+ });
5087
5105
  registerContextCommands(program);
5088
5106
  registerCurationCommands(program);
5089
5107
  registerIntegrationCommands(program);
5090
5108
  registerActivityCommands(program);
5109
+ registerProjectCommands(program);
5091
5110
  program.parseAsync().catch((error) => {
5092
5111
  console.error(error instanceof Error ? error.message : 'Command failed.');
5093
5112
  process.exitCode = 1;