brainclaw 0.29.2 → 1.5.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 (197) hide show
  1. package/LICENSE +21 -74
  2. package/README.md +199 -176
  3. package/dist/brainclaw-vscode.vsix +0 -0
  4. package/dist/cli.js +710 -25
  5. package/dist/commands/accept.js +3 -0
  6. package/dist/commands/add-step.js +11 -26
  7. package/dist/commands/agent-board.js +70 -3
  8. package/dist/commands/audit.js +19 -0
  9. package/dist/commands/check-policy.js +54 -0
  10. package/dist/commands/check-security-mcp.js +145 -0
  11. package/dist/commands/check-security.js +106 -0
  12. package/dist/commands/claim-resource.js +1 -0
  13. package/dist/commands/codev.js +672 -0
  14. package/dist/commands/compact.js +74 -0
  15. package/dist/commands/complete-step.js +16 -26
  16. package/dist/commands/constraint.js +8 -20
  17. package/dist/commands/decision.js +9 -20
  18. package/dist/commands/delete-plan.js +10 -12
  19. package/dist/commands/delete-step.js +16 -0
  20. package/dist/commands/dispatch.js +163 -0
  21. package/dist/commands/doctor.js +1122 -49
  22. package/dist/commands/enable-agent.js +1 -0
  23. package/dist/commands/export.js +280 -22
  24. package/dist/commands/handoff.js +33 -0
  25. package/dist/commands/harvest.js +189 -0
  26. package/dist/commands/hooks.js +82 -25
  27. package/dist/commands/inbox.js +169 -0
  28. package/dist/commands/init.js +38 -31
  29. package/dist/commands/install-hooks.js +71 -44
  30. package/dist/commands/link.js +89 -0
  31. package/dist/commands/list-claims.js +48 -3
  32. package/dist/commands/list-plans.js +129 -25
  33. package/dist/commands/loops-handlers.js +409 -0
  34. package/dist/commands/mcp-read-handlers.js +1628 -0
  35. package/dist/commands/mcp-schemas.generated.js +269 -0
  36. package/dist/commands/mcp.js +4224 -1501
  37. package/dist/commands/plan-resource.js +64 -0
  38. package/dist/commands/plan.js +12 -26
  39. package/dist/commands/prune.js +37 -2
  40. package/dist/commands/reflect.js +20 -7
  41. package/dist/commands/release-claim.js +11 -6
  42. package/dist/commands/release-notes.js +170 -0
  43. package/dist/commands/repair.js +210 -0
  44. package/dist/commands/run-profile.js +57 -0
  45. package/dist/commands/sequence.js +113 -0
  46. package/dist/commands/session-end.js +423 -14
  47. package/dist/commands/session-start.js +214 -41
  48. package/dist/commands/setup-security.js +103 -0
  49. package/dist/commands/setup.js +42 -4
  50. package/dist/commands/stale.js +109 -0
  51. package/dist/commands/switch.js +100 -2
  52. package/dist/commands/trap.js +14 -31
  53. package/dist/commands/update-handoff.js +63 -4
  54. package/dist/commands/update-plan.js +21 -28
  55. package/dist/commands/update-step.js +37 -0
  56. package/dist/commands/upgrade.js +313 -6
  57. package/dist/commands/usage.js +102 -0
  58. package/dist/commands/version.js +20 -0
  59. package/dist/commands/who.js +33 -5
  60. package/dist/commands/worktree.js +105 -0
  61. package/dist/core/actions.js +315 -0
  62. package/dist/core/agent-capability.js +610 -17
  63. package/dist/core/agent-context.js +7 -1
  64. package/dist/core/agent-files.js +1169 -85
  65. package/dist/core/agent-integrations.js +160 -5
  66. package/dist/core/agent-inventory.js +2 -0
  67. package/dist/core/agent-profiles.js +93 -0
  68. package/dist/core/agent-registry.js +162 -30
  69. package/dist/core/agentrun-reconciler.js +345 -0
  70. package/dist/core/agentruns.js +424 -0
  71. package/dist/core/ai-agent-detection.js +31 -10
  72. package/dist/core/archival.js +77 -0
  73. package/dist/core/assignment-sweeper.js +82 -0
  74. package/dist/core/assignments.js +367 -0
  75. package/dist/core/audit.js +30 -0
  76. package/dist/core/brainclaw-version.js +94 -2
  77. package/dist/core/candidates.js +93 -2
  78. package/dist/core/claims.js +419 -0
  79. package/dist/core/codev-metrics.js +77 -0
  80. package/dist/core/codev-personas.js +31 -0
  81. package/dist/core/codev-plan-gen.js +35 -0
  82. package/dist/core/codev-prompts.js +74 -0
  83. package/dist/core/codev-responses.js +62 -0
  84. package/dist/core/codev-rounds.js +218 -0
  85. package/dist/core/config.js +4 -0
  86. package/dist/core/context.js +381 -34
  87. package/dist/core/coordination.js +201 -6
  88. package/dist/core/cross-project.js +230 -16
  89. package/dist/core/default-profiles/doctor.yaml +11 -0
  90. package/dist/core/default-profiles/janitor.yaml +11 -0
  91. package/dist/core/default-profiles/onboarder.yaml +11 -0
  92. package/dist/core/default-profiles/reviewer.yaml +13 -0
  93. package/dist/core/dispatcher.js +1189 -0
  94. package/dist/core/duplicates.js +2 -2
  95. package/dist/core/entity-operations.js +450 -0
  96. package/dist/core/entity-registry.js +344 -0
  97. package/dist/core/events.js +106 -2
  98. package/dist/core/execution-adapters.js +154 -0
  99. package/dist/core/execution-context.js +63 -0
  100. package/dist/core/execution-profile.js +270 -0
  101. package/dist/core/execution.js +255 -0
  102. package/dist/core/facade-schema.js +81 -0
  103. package/dist/core/federation-cloud.js +99 -0
  104. package/dist/core/federation-message.js +52 -0
  105. package/dist/core/federation-transport.js +65 -0
  106. package/dist/core/gc-semantic.js +482 -0
  107. package/dist/core/governance.js +247 -0
  108. package/dist/core/guards.js +19 -0
  109. package/dist/core/ideation.js +72 -0
  110. package/dist/core/identity.js +110 -25
  111. package/dist/core/ids.js +6 -0
  112. package/dist/core/input-validation.js +2 -2
  113. package/dist/core/instruction-templates.js +344 -136
  114. package/dist/core/io.js +90 -11
  115. package/dist/core/lock.js +6 -2
  116. package/dist/core/loops/brief-assembly.js +213 -0
  117. package/dist/core/loops/facade-schema.js +148 -0
  118. package/dist/core/loops/index.js +7 -0
  119. package/dist/core/loops/iteration-engine.js +139 -0
  120. package/dist/core/loops/lock.js +385 -0
  121. package/dist/core/loops/store.js +201 -0
  122. package/dist/core/loops/types.js +403 -0
  123. package/dist/core/loops/verbs.js +534 -0
  124. package/dist/core/markdown.js +15 -3
  125. package/dist/core/memory-compactor.js +432 -0
  126. package/dist/core/memory-git.js +152 -8
  127. package/dist/core/messaging.js +278 -0
  128. package/dist/core/migration.js +32 -1
  129. package/dist/core/mutation-pipeline.js +4 -2
  130. package/dist/core/operations/memory-mutation.js +129 -0
  131. package/dist/core/operations/memory-write.js +78 -0
  132. package/dist/core/operations/plan.js +190 -0
  133. package/dist/core/policy.js +169 -0
  134. package/dist/core/reputation.js +9 -3
  135. package/dist/core/schema.js +491 -6
  136. package/dist/core/search.js +21 -2
  137. package/dist/core/security-cache.js +71 -0
  138. package/dist/core/security-guard.js +152 -0
  139. package/dist/core/security-scoring.js +86 -0
  140. package/dist/core/sequence.js +130 -0
  141. package/dist/core/socket-client.js +113 -0
  142. package/dist/core/staleness.js +246 -0
  143. package/dist/core/state.js +98 -22
  144. package/dist/core/store-resolution.js +43 -11
  145. package/dist/core/toml-writer.js +76 -0
  146. package/dist/core/upgrades/backup.js +232 -0
  147. package/dist/core/upgrades/health-check.js +169 -0
  148. package/dist/core/upgrades/patches/candidate-archive.js +145 -0
  149. package/dist/core/upgrades/patches/handoff-review-strip.js +128 -0
  150. package/dist/core/upgrades/patches/provenance-rollout.js +136 -0
  151. package/dist/core/upgrades/schema-version.js +97 -0
  152. package/dist/core/worktree.js +606 -0
  153. package/dist/facts.js +114 -0
  154. package/dist/facts.json +111 -0
  155. package/docs/architecture/project-refs.md +5 -1
  156. package/docs/cli.md +690 -43
  157. package/docs/concepts/ideation-loop.md +317 -0
  158. package/docs/concepts/loop-engine.md +456 -0
  159. package/docs/concepts/mcp-governance.md +268 -0
  160. package/docs/concepts/memory-staleness.md +122 -0
  161. package/docs/concepts/multi-agent-workflows.md +166 -0
  162. package/docs/concepts/plans-and-claims.md +31 -6
  163. package/docs/concepts/project-md-convention.md +35 -0
  164. package/docs/concepts/troubleshooting.md +220 -0
  165. package/docs/concepts/upgrade-cli.md +202 -0
  166. package/docs/concepts/upgrade-dogfood-procedure.md +114 -0
  167. package/docs/context-format-changelog.md +2 -2
  168. package/docs/context-format.md +2 -2
  169. package/docs/index.md +68 -0
  170. package/docs/integrations/agents.md +15 -16
  171. package/docs/integrations/cline.md +88 -0
  172. package/docs/integrations/codex.md +75 -23
  173. package/docs/integrations/continue.md +60 -0
  174. package/docs/integrations/copilot.md +67 -9
  175. package/docs/integrations/kilocode.md +72 -0
  176. package/docs/integrations/mcp.md +304 -21
  177. package/docs/integrations/mistral-vibe.md +122 -0
  178. package/docs/integrations/opencode.md +84 -0
  179. package/docs/integrations/overview.md +23 -8
  180. package/docs/integrations/roo.md +74 -0
  181. package/docs/integrations/windsurf.md +83 -0
  182. package/docs/mcp-schema-changelog.md +191 -1
  183. package/docs/playbooks/integration/index.md +121 -0
  184. package/docs/playbooks/productivity/index.md +102 -0
  185. package/docs/playbooks/team/index.md +122 -0
  186. package/docs/product/agent-first-model.md +184 -0
  187. package/docs/product/entity-model-audit.md +462 -0
  188. package/docs/product/positioning.md +10 -10
  189. package/docs/quickstart-existing-project.md +135 -0
  190. package/docs/quickstart.md +124 -37
  191. package/docs/release-maintenance.md +79 -0
  192. package/docs/review.md +2 -0
  193. package/docs/server-operations.md +118 -0
  194. package/package.json +21 -13
  195. package/dist/commands/claude-desktop-extension.js +0 -18
  196. package/dist/commands/diff.js +0 -99
  197. package/dist/core/claude-desktop-extension.js +0 -224
package/dist/facts.js ADDED
@@ -0,0 +1,114 @@
1
+ // Generated by scripts/emit-site-facts.mjs at build time. Do not edit manually.
2
+ // Source: brainclaw v1.5.4 on 2026-05-10T22:45:47.168Z
3
+ export const FACTS = {
4
+ "version": "1.5.4",
5
+ "generated_at": "2026-05-10T22:45:47.168Z",
6
+ "tools": {
7
+ "count": 60,
8
+ "published_count": 59,
9
+ "names": [
10
+ "bclaw_bootstrap",
11
+ "bclaw_release_notes",
12
+ "bclaw_context",
13
+ "bclaw_search",
14
+ "bclaw_estimation_report",
15
+ "bclaw_list_sequences",
16
+ "bclaw_assignment_events",
17
+ "bclaw_list_agents",
18
+ "bclaw_list_instructions",
19
+ "bclaw_get_capabilities",
20
+ "bclaw_list_tools",
21
+ "bclaw_search_tools",
22
+ "bclaw_doctor",
23
+ "bclaw_history",
24
+ "bclaw_audit",
25
+ "bclaw_get_discovery",
26
+ "bclaw_conflict_check",
27
+ "bclaw_who",
28
+ "bclaw_switch",
29
+ "bclaw_check_policy",
30
+ "bclaw_check_security",
31
+ "bclaw_read_inbox",
32
+ "bclaw_get_thread",
33
+ "bclaw_dispatch",
34
+ "bclaw_send_message",
35
+ "bclaw_ack_message",
36
+ "bclaw_setup",
37
+ "bclaw_write_note",
38
+ "bclaw_quick_capture",
39
+ "bclaw_claim",
40
+ "bclaw_release_claim",
41
+ "bclaw_session_start",
42
+ "bclaw_session_end",
43
+ "bclaw_create_sequence",
44
+ "bclaw_update_sequence",
45
+ "bclaw_add_step",
46
+ "bclaw_complete_step",
47
+ "bclaw_update_step",
48
+ "bclaw_delete_step",
49
+ "bclaw_delete_plan",
50
+ "bclaw_delete_sequence",
51
+ "bclaw_delete_memory",
52
+ "bclaw_update_memory",
53
+ "bclaw_add_capability",
54
+ "bclaw_add_tool",
55
+ "bclaw_correct_handoff",
56
+ "bclaw_update_handoff",
57
+ "bclaw_compact",
58
+ "bclaw_work",
59
+ "bclaw_coordinate",
60
+ "bclaw_loop",
61
+ "bclaw_assignment_update",
62
+ "bclaw_assignment_action",
63
+ "bclaw_harvest_candidates",
64
+ "bclaw_find",
65
+ "bclaw_get",
66
+ "bclaw_create",
67
+ "bclaw_update",
68
+ "bclaw_remove",
69
+ "bclaw_transition"
70
+ ]
71
+ },
72
+ "entities": {
73
+ "count": 17,
74
+ "names": [
75
+ "plan",
76
+ "step",
77
+ "claim",
78
+ "session",
79
+ "handoff",
80
+ "decision",
81
+ "constraint",
82
+ "trap",
83
+ "candidate",
84
+ "runtime_note",
85
+ "sequence",
86
+ "inbox_message",
87
+ "instruction",
88
+ "assignment",
89
+ "agent_run",
90
+ "action",
91
+ "cross_project_link"
92
+ ],
93
+ "short_label_prefixes": {
94
+ "plan": "pln",
95
+ "step": "stp",
96
+ "claim": "clm",
97
+ "session": "sess",
98
+ "handoff": "hnd",
99
+ "decision": "dec",
100
+ "constraint": "cst",
101
+ "trap": "trp",
102
+ "candidate": "cnd",
103
+ "runtime_note": "rtn",
104
+ "sequence": "seq",
105
+ "inbox_message": "msg",
106
+ "instruction": "ins",
107
+ "assignment": "asgn",
108
+ "agent_run": "run",
109
+ "action": "act",
110
+ "cross_project_link": "xpl"
111
+ }
112
+ }
113
+ }
114
+ export default FACTS
@@ -0,0 +1,111 @@
1
+ {
2
+ "version": "1.5.4",
3
+ "generated_at": "2026-05-10T22:45:47.168Z",
4
+ "tools": {
5
+ "count": 60,
6
+ "published_count": 59,
7
+ "names": [
8
+ "bclaw_bootstrap",
9
+ "bclaw_release_notes",
10
+ "bclaw_context",
11
+ "bclaw_search",
12
+ "bclaw_estimation_report",
13
+ "bclaw_list_sequences",
14
+ "bclaw_assignment_events",
15
+ "bclaw_list_agents",
16
+ "bclaw_list_instructions",
17
+ "bclaw_get_capabilities",
18
+ "bclaw_list_tools",
19
+ "bclaw_search_tools",
20
+ "bclaw_doctor",
21
+ "bclaw_history",
22
+ "bclaw_audit",
23
+ "bclaw_get_discovery",
24
+ "bclaw_conflict_check",
25
+ "bclaw_who",
26
+ "bclaw_switch",
27
+ "bclaw_check_policy",
28
+ "bclaw_check_security",
29
+ "bclaw_read_inbox",
30
+ "bclaw_get_thread",
31
+ "bclaw_dispatch",
32
+ "bclaw_send_message",
33
+ "bclaw_ack_message",
34
+ "bclaw_setup",
35
+ "bclaw_write_note",
36
+ "bclaw_quick_capture",
37
+ "bclaw_claim",
38
+ "bclaw_release_claim",
39
+ "bclaw_session_start",
40
+ "bclaw_session_end",
41
+ "bclaw_create_sequence",
42
+ "bclaw_update_sequence",
43
+ "bclaw_add_step",
44
+ "bclaw_complete_step",
45
+ "bclaw_update_step",
46
+ "bclaw_delete_step",
47
+ "bclaw_delete_plan",
48
+ "bclaw_delete_sequence",
49
+ "bclaw_delete_memory",
50
+ "bclaw_update_memory",
51
+ "bclaw_add_capability",
52
+ "bclaw_add_tool",
53
+ "bclaw_correct_handoff",
54
+ "bclaw_update_handoff",
55
+ "bclaw_compact",
56
+ "bclaw_work",
57
+ "bclaw_coordinate",
58
+ "bclaw_loop",
59
+ "bclaw_assignment_update",
60
+ "bclaw_assignment_action",
61
+ "bclaw_harvest_candidates",
62
+ "bclaw_find",
63
+ "bclaw_get",
64
+ "bclaw_create",
65
+ "bclaw_update",
66
+ "bclaw_remove",
67
+ "bclaw_transition"
68
+ ]
69
+ },
70
+ "entities": {
71
+ "count": 17,
72
+ "names": [
73
+ "plan",
74
+ "step",
75
+ "claim",
76
+ "session",
77
+ "handoff",
78
+ "decision",
79
+ "constraint",
80
+ "trap",
81
+ "candidate",
82
+ "runtime_note",
83
+ "sequence",
84
+ "inbox_message",
85
+ "instruction",
86
+ "assignment",
87
+ "agent_run",
88
+ "action",
89
+ "cross_project_link"
90
+ ],
91
+ "short_label_prefixes": {
92
+ "plan": "pln",
93
+ "step": "stp",
94
+ "claim": "clm",
95
+ "session": "sess",
96
+ "handoff": "hnd",
97
+ "decision": "dec",
98
+ "constraint": "cst",
99
+ "trap": "trp",
100
+ "candidate": "cnd",
101
+ "runtime_note": "rtn",
102
+ "sequence": "seq",
103
+ "inbox_message": "msg",
104
+ "instruction": "ins",
105
+ "assignment": "asgn",
106
+ "agent_run": "run",
107
+ "action": "act",
108
+ "cross_project_link": "xpl"
109
+ }
110
+ }
111
+ }
@@ -1,5 +1,7 @@
1
1
  # Project Refs for Multi-Project Navigation
2
2
 
3
+ > Proposal / design note: this document describes a target navigation model, not the currently shipped CLI or MCP surface. For implemented multi-project commands today, use `brainclaw switch` and `brainclaw projects`.
4
+
3
5
  ## Goal
4
6
 
5
7
  In a multi-project workspace, agents should be able to address any known project from anywhere in the workspace without depending on the current working directory.
@@ -257,7 +259,9 @@ Likely persisted fields:
257
259
 
258
260
  This should stay clearly separate from canonical memory items such as decisions and constraints.
259
261
 
260
- ## Current Implementation (v0.23.0)
262
+ ## Implementation snapshot (v0.23.0, kept for design reference)
263
+
264
+ > This section reflects what was shipped at the time the proposal was written (v0.23.0). For the implemented multi-project navigation surface today, refer to [docs/cli.md](../cli.md) (`brainclaw switch`, `brainclaw projects`, `BRAINCLAW_PROJECT`, `--cwd`).
261
265
 
262
266
  `brainclaw switch` provides the first layer of project navigation:
263
267