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.
- package/LICENSE +21 -74
- package/README.md +199 -176
- package/dist/brainclaw-vscode.vsix +0 -0
- package/dist/cli.js +710 -25
- package/dist/commands/accept.js +3 -0
- package/dist/commands/add-step.js +11 -26
- package/dist/commands/agent-board.js +70 -3
- package/dist/commands/audit.js +19 -0
- package/dist/commands/check-policy.js +54 -0
- package/dist/commands/check-security-mcp.js +145 -0
- package/dist/commands/check-security.js +106 -0
- package/dist/commands/claim-resource.js +1 -0
- package/dist/commands/codev.js +672 -0
- package/dist/commands/compact.js +74 -0
- package/dist/commands/complete-step.js +16 -26
- package/dist/commands/constraint.js +8 -20
- package/dist/commands/decision.js +9 -20
- package/dist/commands/delete-plan.js +10 -12
- package/dist/commands/delete-step.js +16 -0
- package/dist/commands/dispatch.js +163 -0
- package/dist/commands/doctor.js +1122 -49
- package/dist/commands/enable-agent.js +1 -0
- package/dist/commands/export.js +280 -22
- package/dist/commands/handoff.js +33 -0
- package/dist/commands/harvest.js +189 -0
- package/dist/commands/hooks.js +82 -25
- package/dist/commands/inbox.js +169 -0
- package/dist/commands/init.js +38 -31
- package/dist/commands/install-hooks.js +71 -44
- package/dist/commands/link.js +89 -0
- package/dist/commands/list-claims.js +48 -3
- package/dist/commands/list-plans.js +129 -25
- package/dist/commands/loops-handlers.js +409 -0
- package/dist/commands/mcp-read-handlers.js +1628 -0
- package/dist/commands/mcp-schemas.generated.js +269 -0
- package/dist/commands/mcp.js +4224 -1501
- package/dist/commands/plan-resource.js +64 -0
- package/dist/commands/plan.js +12 -26
- package/dist/commands/prune.js +37 -2
- package/dist/commands/reflect.js +20 -7
- package/dist/commands/release-claim.js +11 -6
- package/dist/commands/release-notes.js +170 -0
- package/dist/commands/repair.js +210 -0
- package/dist/commands/run-profile.js +57 -0
- package/dist/commands/sequence.js +113 -0
- package/dist/commands/session-end.js +423 -14
- package/dist/commands/session-start.js +214 -41
- package/dist/commands/setup-security.js +103 -0
- package/dist/commands/setup.js +42 -4
- package/dist/commands/stale.js +109 -0
- package/dist/commands/switch.js +100 -2
- package/dist/commands/trap.js +14 -31
- package/dist/commands/update-handoff.js +63 -4
- package/dist/commands/update-plan.js +21 -28
- package/dist/commands/update-step.js +37 -0
- package/dist/commands/upgrade.js +313 -6
- package/dist/commands/usage.js +102 -0
- package/dist/commands/version.js +20 -0
- package/dist/commands/who.js +33 -5
- package/dist/commands/worktree.js +105 -0
- package/dist/core/actions.js +315 -0
- package/dist/core/agent-capability.js +610 -17
- package/dist/core/agent-context.js +7 -1
- package/dist/core/agent-files.js +1169 -85
- package/dist/core/agent-integrations.js +160 -5
- package/dist/core/agent-inventory.js +2 -0
- package/dist/core/agent-profiles.js +93 -0
- package/dist/core/agent-registry.js +162 -30
- package/dist/core/agentrun-reconciler.js +345 -0
- package/dist/core/agentruns.js +424 -0
- package/dist/core/ai-agent-detection.js +31 -10
- package/dist/core/archival.js +77 -0
- package/dist/core/assignment-sweeper.js +82 -0
- package/dist/core/assignments.js +367 -0
- package/dist/core/audit.js +30 -0
- package/dist/core/brainclaw-version.js +94 -2
- package/dist/core/candidates.js +93 -2
- package/dist/core/claims.js +419 -0
- package/dist/core/codev-metrics.js +77 -0
- package/dist/core/codev-personas.js +31 -0
- package/dist/core/codev-plan-gen.js +35 -0
- package/dist/core/codev-prompts.js +74 -0
- package/dist/core/codev-responses.js +62 -0
- package/dist/core/codev-rounds.js +218 -0
- package/dist/core/config.js +4 -0
- package/dist/core/context.js +381 -34
- package/dist/core/coordination.js +201 -6
- package/dist/core/cross-project.js +230 -16
- package/dist/core/default-profiles/doctor.yaml +11 -0
- package/dist/core/default-profiles/janitor.yaml +11 -0
- package/dist/core/default-profiles/onboarder.yaml +11 -0
- package/dist/core/default-profiles/reviewer.yaml +13 -0
- package/dist/core/dispatcher.js +1189 -0
- package/dist/core/duplicates.js +2 -2
- package/dist/core/entity-operations.js +450 -0
- package/dist/core/entity-registry.js +344 -0
- package/dist/core/events.js +106 -2
- package/dist/core/execution-adapters.js +154 -0
- package/dist/core/execution-context.js +63 -0
- package/dist/core/execution-profile.js +270 -0
- package/dist/core/execution.js +255 -0
- package/dist/core/facade-schema.js +81 -0
- package/dist/core/federation-cloud.js +99 -0
- package/dist/core/federation-message.js +52 -0
- package/dist/core/federation-transport.js +65 -0
- package/dist/core/gc-semantic.js +482 -0
- package/dist/core/governance.js +247 -0
- package/dist/core/guards.js +19 -0
- package/dist/core/ideation.js +72 -0
- package/dist/core/identity.js +110 -25
- package/dist/core/ids.js +6 -0
- package/dist/core/input-validation.js +2 -2
- package/dist/core/instruction-templates.js +344 -136
- package/dist/core/io.js +90 -11
- package/dist/core/lock.js +6 -2
- package/dist/core/loops/brief-assembly.js +213 -0
- package/dist/core/loops/facade-schema.js +148 -0
- package/dist/core/loops/index.js +7 -0
- package/dist/core/loops/iteration-engine.js +139 -0
- package/dist/core/loops/lock.js +385 -0
- package/dist/core/loops/store.js +201 -0
- package/dist/core/loops/types.js +403 -0
- package/dist/core/loops/verbs.js +534 -0
- package/dist/core/markdown.js +15 -3
- package/dist/core/memory-compactor.js +432 -0
- package/dist/core/memory-git.js +152 -8
- package/dist/core/messaging.js +278 -0
- package/dist/core/migration.js +32 -1
- package/dist/core/mutation-pipeline.js +4 -2
- package/dist/core/operations/memory-mutation.js +129 -0
- package/dist/core/operations/memory-write.js +78 -0
- package/dist/core/operations/plan.js +190 -0
- package/dist/core/policy.js +169 -0
- package/dist/core/reputation.js +9 -3
- package/dist/core/schema.js +491 -6
- package/dist/core/search.js +21 -2
- package/dist/core/security-cache.js +71 -0
- package/dist/core/security-guard.js +152 -0
- package/dist/core/security-scoring.js +86 -0
- package/dist/core/sequence.js +130 -0
- package/dist/core/socket-client.js +113 -0
- package/dist/core/staleness.js +246 -0
- package/dist/core/state.js +98 -22
- package/dist/core/store-resolution.js +43 -11
- package/dist/core/toml-writer.js +76 -0
- package/dist/core/upgrades/backup.js +232 -0
- package/dist/core/upgrades/health-check.js +169 -0
- package/dist/core/upgrades/patches/candidate-archive.js +145 -0
- package/dist/core/upgrades/patches/handoff-review-strip.js +128 -0
- package/dist/core/upgrades/patches/provenance-rollout.js +136 -0
- package/dist/core/upgrades/schema-version.js +97 -0
- package/dist/core/worktree.js +606 -0
- package/dist/facts.js +114 -0
- package/dist/facts.json +111 -0
- package/docs/architecture/project-refs.md +5 -1
- package/docs/cli.md +690 -43
- package/docs/concepts/ideation-loop.md +317 -0
- package/docs/concepts/loop-engine.md +456 -0
- package/docs/concepts/mcp-governance.md +268 -0
- package/docs/concepts/memory-staleness.md +122 -0
- package/docs/concepts/multi-agent-workflows.md +166 -0
- package/docs/concepts/plans-and-claims.md +31 -6
- package/docs/concepts/project-md-convention.md +35 -0
- package/docs/concepts/troubleshooting.md +220 -0
- package/docs/concepts/upgrade-cli.md +202 -0
- package/docs/concepts/upgrade-dogfood-procedure.md +114 -0
- package/docs/context-format-changelog.md +2 -2
- package/docs/context-format.md +2 -2
- package/docs/index.md +68 -0
- package/docs/integrations/agents.md +15 -16
- package/docs/integrations/cline.md +88 -0
- package/docs/integrations/codex.md +75 -23
- package/docs/integrations/continue.md +60 -0
- package/docs/integrations/copilot.md +67 -9
- package/docs/integrations/kilocode.md +72 -0
- package/docs/integrations/mcp.md +304 -21
- package/docs/integrations/mistral-vibe.md +122 -0
- package/docs/integrations/opencode.md +84 -0
- package/docs/integrations/overview.md +23 -8
- package/docs/integrations/roo.md +74 -0
- package/docs/integrations/windsurf.md +83 -0
- package/docs/mcp-schema-changelog.md +191 -1
- package/docs/playbooks/integration/index.md +121 -0
- package/docs/playbooks/productivity/index.md +102 -0
- package/docs/playbooks/team/index.md +122 -0
- package/docs/product/agent-first-model.md +184 -0
- package/docs/product/entity-model-audit.md +462 -0
- package/docs/product/positioning.md +10 -10
- package/docs/quickstart-existing-project.md +135 -0
- package/docs/quickstart.md +124 -37
- package/docs/release-maintenance.md +79 -0
- package/docs/review.md +2 -0
- package/docs/server-operations.md +118 -0
- package/package.json +21 -13
- package/dist/commands/claude-desktop-extension.js +0 -18
- package/dist/commands/diff.js +0 -99
- 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
|
package/dist/facts.json
ADDED
|
@@ -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
|
-
##
|
|
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
|
|