brainclaw 1.9.0 → 1.10.0
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/README.md +631 -499
- package/dist/brainclaw-vscode.vsix +0 -0
- package/dist/cli.js +18 -1
- package/dist/commands/code-map.js +129 -0
- package/dist/commands/codev.js +7 -0
- package/dist/commands/harvest.js +1 -1
- package/dist/commands/hooks.js +73 -73
- package/dist/commands/init.js +1 -1
- package/dist/commands/install-hooks.js +78 -78
- package/dist/commands/mcp-read-handlers.js +57 -14
- package/dist/commands/mcp.js +200 -13
- package/dist/commands/run-profile.js +3 -2
- package/dist/commands/switch.js +125 -93
- package/dist/commands/version.js +1 -1
- package/dist/core/agent-capability.js +19 -4
- package/dist/core/agent-files.js +131 -119
- package/dist/core/code-map/backend.js +123 -0
- package/dist/core/code-map/core.js +81 -0
- package/dist/core/code-map/drafts.js +2 -0
- package/dist/core/code-map/extractor.js +29 -0
- package/dist/core/code-map/finalizer.js +191 -0
- package/dist/core/code-map/freshness.js +108 -0
- package/dist/core/code-map/ids.js +0 -0
- package/dist/core/code-map/importable.js +35 -0
- package/dist/core/code-map/indexes.js +197 -0
- package/dist/core/code-map/lang/java/imports.scm +17 -0
- package/dist/core/code-map/lang/java/index.js +254 -0
- package/dist/core/code-map/lang/java/tags.scm +48 -0
- package/dist/core/code-map/lang/php/imports.scm +21 -0
- package/dist/core/code-map/lang/php/index.js +251 -0
- package/dist/core/code-map/lang/php/tags.scm +44 -0
- package/dist/core/code-map/lang/provider.js +9 -0
- package/dist/core/code-map/lang/providers.js +24 -0
- package/dist/core/code-map/lang/python/imports.scm +90 -0
- package/dist/core/code-map/lang/python/index.js +364 -0
- package/dist/core/code-map/lang/python/tags.scm +81 -0
- package/dist/core/code-map/lang/query-runtime.js +374 -0
- package/dist/core/code-map/lang/registry.js +125 -0
- package/dist/core/code-map/lang/typescript/imports.scm +90 -0
- package/dist/core/code-map/lang/typescript/index.js +306 -0
- package/dist/core/code-map/lang/typescript/tags.js.scm +106 -0
- package/dist/core/code-map/lang/typescript/tags.scm +151 -0
- package/dist/core/code-map/lock.js +210 -0
- package/dist/core/code-map/materialized.js +51 -0
- package/dist/core/code-map/memory-reader.js +59 -0
- package/dist/core/code-map/paths.js +53 -0
- package/dist/core/code-map/query.js +568 -0
- package/dist/core/code-map/refresh.js +0 -0
- package/dist/core/code-map/resolve.js +177 -0
- package/dist/core/code-map/store.js +206 -0
- package/dist/core/code-map/types.js +288 -0
- package/dist/core/code-map/vocabulary.js +57 -0
- package/dist/core/code-map/wasm-loader.js +294 -0
- package/dist/core/code-map/work-section.js +206 -0
- package/dist/core/codev-prompts.js +38 -38
- package/dist/core/codev-rounds.js +4 -0
- package/dist/core/default-profiles/doctor.yaml +11 -11
- package/dist/core/default-profiles/janitor.yaml +11 -11
- package/dist/core/default-profiles/onboarder.yaml +11 -11
- package/dist/core/default-profiles/reviewer.yaml +13 -13
- package/dist/core/dispatcher.js +1 -1
- package/dist/core/entity-operations.js +29 -3
- package/dist/core/execution-adapters.js +11 -10
- package/dist/core/execution-profile.js +58 -0
- package/dist/core/execution.js +1 -1
- package/dist/core/facade-schema.js +9 -0
- package/dist/core/instruction-templates.js +2 -0
- package/dist/core/loops/verbs.js +0 -1
- package/dist/core/mcp-command-resolution.js +3 -1
- package/dist/core/messaging.js +2 -2
- package/dist/core/protocol-skills.js +164 -164
- package/dist/core/runtime-signals.js +1 -1
- package/dist/core/search.js +19 -2
- package/dist/core/security-guard.js +207 -207
- package/dist/core/spawn-check.js +16 -2
- package/dist/core/staleness.js +1 -1
- package/dist/core/store-resolution.js +67 -11
- package/dist/core/worktree.js +18 -18
- package/dist/facts.js +9 -5
- package/dist/facts.json +8 -4
- package/dist/vendor/web-tree-sitter/tree-sitter.js +3980 -0
- package/dist/vendor/web-tree-sitter/tree-sitter.wasm +0 -0
- package/dist/wasm/tree-sitter-java.wasm +0 -0
- package/dist/wasm/tree-sitter-javascript.wasm +0 -0
- package/dist/wasm/tree-sitter-php.wasm +0 -0
- package/dist/wasm/tree-sitter-python.wasm +0 -0
- package/dist/wasm/tree-sitter-tsx.wasm +0 -0
- package/dist/wasm/tree-sitter-typescript.wasm +0 -0
- package/dist/wasm/tree-sitter.wasm +0 -0
- package/docs/PROTOCOL.md +1 -1
- package/docs/adapters/openclaw.md +43 -43
- package/docs/architecture/project-refs.md +328 -328
- package/docs/cli.md +2131 -2093
- package/docs/code-map.md +198 -0
- package/docs/concepts/coordination.md +52 -52
- package/docs/concepts/coordinator-runbook.md +129 -129
- package/docs/concepts/dispatch-lifecycle.md +245 -245
- package/docs/concepts/event-log-store.md +928 -928
- package/docs/concepts/ideation-loop.md +317 -317
- package/docs/concepts/loop-engine.md +520 -511
- package/docs/concepts/mcp-governance.md +268 -268
- package/docs/concepts/memory.md +84 -84
- package/docs/concepts/multi-agent-workflows.md +167 -167
- package/docs/concepts/observer-protocol.md +361 -361
- package/docs/concepts/plans-and-claims.md +217 -217
- package/docs/concepts/project-md-convention.md +35 -35
- package/docs/concepts/runtime-notes.md +38 -38
- package/docs/concepts/troubleshooting.md +254 -254
- package/docs/concepts/workspace-bootstrapping.md +142 -142
- package/docs/context-format-changelog.md +35 -35
- package/docs/context-format.md +48 -48
- package/docs/index.md +65 -65
- package/docs/integrations/agents.md +158 -158
- package/docs/integrations/claude-code.md +23 -23
- package/docs/integrations/cline.md +77 -77
- package/docs/integrations/continue.md +55 -55
- package/docs/integrations/copilot.md +68 -68
- package/docs/integrations/cursor.md +23 -23
- package/docs/integrations/kilocode.md +72 -72
- package/docs/integrations/mcp.md +385 -378
- package/docs/integrations/mistral-vibe.md +122 -122
- package/docs/integrations/openclaw.md +92 -92
- package/docs/integrations/opencode.md +84 -84
- package/docs/integrations/overview.md +115 -115
- package/docs/integrations/roo.md +71 -71
- package/docs/integrations/windsurf.md +77 -77
- package/docs/mcp-schema-changelog.md +364 -356
- package/docs/playbooks/integration/index.md +121 -121
- package/docs/playbooks/orchestration.md +37 -0
- package/docs/playbooks/productivity/index.md +99 -99
- package/docs/playbooks/team/index.md +117 -117
- package/docs/product/agent-first-model.md +184 -184
- package/docs/product/entity-model-audit.md +462 -462
- package/docs/product/positioning.md +86 -86
- package/docs/quickstart-existing-project.md +107 -107
- package/docs/quickstart.md +183 -183
- package/docs/release-maintenance.md +79 -79
- package/docs/reputation.md +52 -52
- package/docs/review.md +45 -45
- package/docs/security.md +212 -212
- package/docs/server-operations.md +118 -118
- package/docs/storage.md +106 -106
- package/package.json +86 -66
- package/docs/concepts/event-log-store-critique-A.md +0 -333
- package/docs/concepts/event-log-store-critique-B.md +0 -353
- package/docs/concepts/event-log-store-phase0-measurements.md +0 -58
- package/docs/concepts/event-log-store-proposal-A.md +0 -365
- package/docs/concepts/event-log-store-proposal-B.md +0 -404
- package/docs/concepts/identity-model-proposal.md +0 -371
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/docs/PROTOCOL.md
CHANGED
|
@@ -219,5 +219,5 @@ integrators before declaring any of them stable:
|
|
|
219
219
|
dependency) lower the adoption bar for OSS agents that don't speak MCP
|
|
220
220
|
yet?
|
|
221
221
|
|
|
222
|
-
Open an issue, ping `
|
|
222
|
+
Open an issue, ping `support@brainclaw.dev`, or comment on the brainclaw plan
|
|
223
223
|
tracking this draft (pln#546).
|
|
@@ -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.
|