brainclaw 1.9.0 → 1.9.1

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 (91) hide show
  1. package/README.md +585 -499
  2. package/dist/brainclaw-vscode.vsix +0 -0
  3. package/dist/commands/harvest.js +1 -1
  4. package/dist/commands/hooks.js +73 -73
  5. package/dist/commands/init.js +1 -1
  6. package/dist/commands/install-hooks.js +78 -78
  7. package/dist/commands/mcp-read-handlers.js +57 -14
  8. package/dist/commands/mcp.js +79 -13
  9. package/dist/commands/switch.js +26 -5
  10. package/dist/commands/version.js +1 -1
  11. package/dist/core/agent-capability.js +19 -4
  12. package/dist/core/agent-files.js +119 -119
  13. package/dist/core/codev-prompts.js +38 -38
  14. package/dist/core/default-profiles/doctor.yaml +11 -11
  15. package/dist/core/default-profiles/janitor.yaml +11 -11
  16. package/dist/core/default-profiles/onboarder.yaml +11 -11
  17. package/dist/core/default-profiles/reviewer.yaml +13 -13
  18. package/dist/core/dispatcher.js +1 -1
  19. package/dist/core/entity-operations.js +29 -3
  20. package/dist/core/execution.js +1 -1
  21. package/dist/core/loops/verbs.js +0 -1
  22. package/dist/core/messaging.js +2 -2
  23. package/dist/core/protocol-skills.js +164 -164
  24. package/dist/core/runtime-signals.js +1 -1
  25. package/dist/core/search.js +19 -2
  26. package/dist/core/security-guard.js +207 -207
  27. package/dist/core/spawn-check.js +16 -2
  28. package/dist/core/staleness.js +1 -1
  29. package/dist/core/store-resolution.js +26 -7
  30. package/dist/core/worktree.js +18 -18
  31. package/dist/facts.js +3 -3
  32. package/dist/facts.json +2 -2
  33. package/docs/PROTOCOL.md +1 -1
  34. package/docs/adapters/openclaw.md +43 -43
  35. package/docs/architecture/project-refs.md +328 -328
  36. package/docs/cli.md +2093 -2093
  37. package/docs/concepts/coordination.md +52 -52
  38. package/docs/concepts/coordinator-runbook.md +129 -129
  39. package/docs/concepts/dispatch-lifecycle.md +245 -245
  40. package/docs/concepts/event-log-store.md +928 -928
  41. package/docs/concepts/ideation-loop.md +317 -317
  42. package/docs/concepts/loop-engine.md +520 -511
  43. package/docs/concepts/mcp-governance.md +268 -268
  44. package/docs/concepts/memory.md +84 -84
  45. package/docs/concepts/multi-agent-workflows.md +167 -167
  46. package/docs/concepts/observer-protocol.md +361 -361
  47. package/docs/concepts/plans-and-claims.md +217 -217
  48. package/docs/concepts/project-md-convention.md +35 -35
  49. package/docs/concepts/runtime-notes.md +38 -38
  50. package/docs/concepts/troubleshooting.md +254 -254
  51. package/docs/concepts/workspace-bootstrapping.md +142 -142
  52. package/docs/context-format-changelog.md +35 -35
  53. package/docs/context-format.md +48 -48
  54. package/docs/index.md +65 -65
  55. package/docs/integrations/agents.md +158 -158
  56. package/docs/integrations/claude-code.md +23 -23
  57. package/docs/integrations/cline.md +77 -77
  58. package/docs/integrations/continue.md +55 -55
  59. package/docs/integrations/copilot.md +68 -68
  60. package/docs/integrations/cursor.md +23 -23
  61. package/docs/integrations/kilocode.md +72 -72
  62. package/docs/integrations/mcp.md +377 -377
  63. package/docs/integrations/mistral-vibe.md +122 -122
  64. package/docs/integrations/openclaw.md +92 -92
  65. package/docs/integrations/opencode.md +84 -84
  66. package/docs/integrations/overview.md +115 -115
  67. package/docs/integrations/roo.md +71 -71
  68. package/docs/integrations/windsurf.md +77 -77
  69. package/docs/mcp-schema-changelog.md +360 -356
  70. package/docs/playbooks/integration/index.md +121 -121
  71. package/docs/playbooks/orchestration.md +37 -0
  72. package/docs/playbooks/productivity/index.md +99 -99
  73. package/docs/playbooks/team/index.md +117 -117
  74. package/docs/product/agent-first-model.md +184 -184
  75. package/docs/product/entity-model-audit.md +462 -462
  76. package/docs/product/positioning.md +86 -86
  77. package/docs/quickstart-existing-project.md +107 -107
  78. package/docs/quickstart.md +183 -183
  79. package/docs/release-maintenance.md +79 -79
  80. package/docs/reputation.md +52 -52
  81. package/docs/review.md +45 -45
  82. package/docs/security.md +212 -212
  83. package/docs/server-operations.md +118 -118
  84. package/docs/storage.md +106 -106
  85. package/package.json +80 -65
  86. package/docs/concepts/event-log-store-critique-A.md +0 -333
  87. package/docs/concepts/event-log-store-critique-B.md +0 -353
  88. package/docs/concepts/event-log-store-phase0-measurements.md +0 -58
  89. package/docs/concepts/event-log-store-proposal-A.md +0 -365
  90. package/docs/concepts/event-log-store-proposal-B.md +0 -404
  91. package/docs/concepts/identity-model-proposal.md +0 -371
package/docs/adapters/openclaw.md CHANGED
@@ -1,43 +1,43 @@
1
- # OpenClaw Adapter Guide
2
-
3
- This adapter helps convert OpenClaw runtime traces into brainclaw candidates.
4
-
5
- ## Supported Inputs
6
-
7
- - Runtime event file: JSON array of events.
8
- - Runtime session import: events filtered by `metadata.session` from `.brainclaw/runtime/`.
9
-
10
- ## Basic Usage
11
-
12
- ```bash
13
- brainclaw adapter-openclaw-import ./openclaw-events.json
14
- brainclaw adapter-openclaw-import --session sess_42
15
- ```
16
-
17
- ## Dry-Run Workflow
18
-
19
- Use `--dry-run` to preview what would be ingested without writing any files:
20
-
21
- ```bash
22
- brainclaw adapter-openclaw-import ./openclaw-events.json --dry-run
23
- ```
24
-
25
- Dry-run is useful for CI checks and for validating mapping quality before modifying `.brainclaw/inbox/`.
26
-
27
- ## Event Mapping
28
-
29
- Current mapping converts events into reflective candidate types:
30
-
31
- - `risk_detected` -> `trap`
32
- - `handoff_requested` -> `handoff`
33
- - `observation` -> `decision`
34
- - `constraint_detected` -> `constraint`
35
-
36
- If an event type is unknown, it defaults to `decision`.
37
-
38
- ## Recommended Team Flow
39
-
40
- 1. Import events from file or session.
41
- 2. Run `brainclaw review --prioritized`.
42
- 3. Curators process with `brainclaw accept` or `brainclaw reject`.
43
- 4. Use `brainclaw doctor` or `brainclaw doctor --json` to monitor quality.
1
+ # OpenClaw Adapter Guide
2
+
3
+ This adapter helps convert OpenClaw runtime traces into brainclaw candidates.
4
+
5
+ ## Supported Inputs
6
+
7
+ - Runtime event file: JSON array of events.
8
+ - Runtime session import: events filtered by `metadata.session` from `.brainclaw/runtime/`.
9
+
10
+ ## Basic Usage
11
+
12
+ ```bash
13
+ brainclaw adapter-openclaw-import ./openclaw-events.json
14
+ brainclaw adapter-openclaw-import --session sess_42
15
+ ```
16
+
17
+ ## Dry-Run Workflow
18
+
19
+ Use `--dry-run` to preview what would be ingested without writing any files:
20
+
21
+ ```bash
22
+ brainclaw adapter-openclaw-import ./openclaw-events.json --dry-run
23
+ ```
24
+
25
+ Dry-run is useful for CI checks and for validating mapping quality before modifying `.brainclaw/inbox/`.
26
+
27
+ ## Event Mapping
28
+
29
+ Current mapping converts events into reflective candidate types:
30
+
31
+ - `risk_detected` -> `trap`
32
+ - `handoff_requested` -> `handoff`
33
+ - `observation` -> `decision`
34
+ - `constraint_detected` -> `constraint`
35
+
36
+ If an event type is unknown, it defaults to `decision`.
37
+
38
+ ## Recommended Team Flow
39
+
40
+ 1. Import events from file or session.
41
+ 2. Run `brainclaw review --prioritized`.
42
+ 3. Curators process with `brainclaw accept` or `brainclaw reject`.
43
+ 4. Use `brainclaw doctor` or `brainclaw doctor --json` to monitor quality.