brainclaw 1.5.3 → 1.5.4

package/LICENSE

@@ -1,74 +1,21 @@
-Business Source License 1.1
-
-Licensor:             Juan Berdah
-Licensed Work:        brainclaw
-                      The Licensed Work is (c) 2024-2026 Juan Berdah
-Change Date:          Four years from the release date of each version
-Change License:       MIT License
-
-For information about alternative licensing arrangements, contact the Licensor.
-
----
-
-Parameters
-
-Licensor:             Juan Berdah
-Licensed Work:        brainclaw
-Additional Use Grant: You may make production use of the Licensed Work, including use
-                      for internal business operations, provided that you do not use the
-                      Licensed Work to build or offer a competing product or service that
-                      provides shared agent memory, coordination, or context management
-                      for coding agents or development teams.
-Change Date:          Four years after the release date of each version
-Change License:       MIT License
-
----
-
-Notice
-
-The Business Source License (this document, or the "License") is not an Open Source
-license. However, the Licensed Work will eventually be made available under an Open
-Source License, as stated in this License.
-
-Use Limitation: The additional use grant in the Parameters specifies the permitted
-production use. If your use case falls outside that grant, you need a separate
-commercial license from the Licensor.
-
-License text
-
-The Licensor hereby grants you the right to copy, modify, create derivative works,
-redistribute, and make non-production use of the Licensed Work. The Licensor may
-make an Additional Use Grant, above, permitting limited production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly available
-distribution of a specific version of the Licensed Work under this License, whichever
-comes first, the Licensor hereby grants you rights under the terms of the Change
-License, and the rights granted in the paragraph above terminate.
-
-If your use of the Licensed Work does not comply with the requirements currently in
-effect as described in this License, you must purchase a commercial license from the
-Licensor, its affiliated entities, or authorized resellers, or you must refrain from
-using the Licensed Work.
-
-All copies of the original and modified Licensed Work, and derivative works of the
-Licensed Work, are subject to this License. This License applies separately for each
-version of the Licensed Work and the Change Date may vary for each version of the
-Licensed Work released by the licensor.
-
-You must conspicuously display this License on each original or modified copy of the
-Licensed Work. If you receive the Licensed Work in original or modified form from a
-third party, the terms and conditions set forth in this License apply to your use of
-that work.
-
-Any use of the Licensed Work in violation of this License will automatically terminate
-your rights under this License for the current and all future versions of the Licensed
-Work.
-
-This License does not grant you any right in any trademark or logo of Licensor or its
-affiliates (provided that you may use a trademark or logo of Licensor as expressly
-required by this License).
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN "AS
-IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS OR
-IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+MIT License
+
+Copyright (c) 2024-2026 Juan Berdah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -380,15 +380,15 @@ For older releases (v0.x and the early v1.0 launch series), `git log` on `master
 
 ---
 
-## License
-
-Current releases of brainclaw are published under the [Business Source License 1.1](LICENSE) — (c) 2024-2026 Juan Berdah.
-
-The long-term direction is simpler than the current wording might suggest:
-
-- the local-first brainclaw core is intended to move to MIT after the closed beta
-- cloud shared-memory, remote collaboration services, advanced dashboards, and related hosted add-ons will live in separate commercial products
-
-The intended MIT core covers what makes brainclaw useful inside a repo today: local project memory, local MCP and CLI coordination, onboarding and bootstrap, plans, claims, handoffs, runtime notes, and local agent integrations.
+## License
+
+brainclaw core is published under the [MIT License](LICENSE) — (c) 2024-2026 Juan Berdah.
+
+The licensing split is simple:
+
+- the local-first brainclaw core is MIT
+- cloud shared-memory, remote collaboration services, advanced dashboards, and related hosted add-ons will live in separate commercial products
+
+The MIT core covers what makes brainclaw useful inside a repo today: local project memory, local MCP and CLI coordination, onboarding and bootstrap, plans, claims, handoffs, runtime notes, and local agent integrations.
 
 The goal is not to close brainclaw down. The goal is to keep the local-first core open and genuinely useful on its own, while keeping hosted collaboration features separate.

package/dist/cli.js

@@ -109,6 +109,42 @@ const program = new Command();
 function collect(value, previous) {
     return [...previous, value];
 }
+function parseLeadingGlobalOptions(argv) {
+    const result = {};
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (!token.startsWith('-')) {
+            break;
+        }
+        if (token === '--verbose') {
+            result.verbose = true;
+            continue;
+        }
+        if (token === '--debug') {
+            result.debug = true;
+            continue;
+        }
+        if (token === '--cwd') {
+            result.cwd = argv[i + 1];
+            i++;
+            continue;
+        }
+        if (token.startsWith('--cwd=')) {
+            result.cwd = token.slice('--cwd='.length);
+            continue;
+        }
+        if (token === '--project') {
+            result.project = argv[i + 1];
+            i++;
+            continue;
+        }
+        if (token.startsWith('--project=')) {
+            result.project = token.slice('--project='.length);
+            continue;
+        }
+    }
+    return result;
+}
 function isCodevEnabled() {
     return process.env.BRAINCLAW_ENABLE_CODEV === '1';
 }
@@ -121,7 +157,7 @@ program
     .option('--cwd <path>', 'Override working directory for this invocation')
     .option('--project <name>', 'Run the command against a linked project (cross_project_links or workspace store-chain child). Resolves via resolveProjectCwd; mutually exclusive with --cwd.')
     .hook('preAction', (_thisCommand, actionCommand) => {
-    const root = actionCommand.optsWithGlobals();
+    const root = parseLeadingGlobalOptions(process.argv.slice(2));
     initLogLevel({ verbose: root.verbose, debug: root.debug });
     // Skip effective cwd resolution for commands that create the store
     const cmdName = actionCommand.name();

package/dist/commands/mcp-schemas.generated.js

@@ -20,12 +20,207 @@ export const generatedSchemas = {
                     "all",
                     "any"
                 ]
+            },
+            "context_filter": {
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                    "type": "string",
+                    "enum": [
+                        "traps",
+                        "feedback",
+                        "runtime_notes",
+                        "decisions",
+                        "constraints",
+                        "handoffs",
+                        "plans",
+                        "candidates",
+                        "project_vision",
+                        "critique_history",
+                        "revision_history",
+                        "synthesis_artifact",
+                        "*"
+                    ]
+                }
+            },
+            "advance_gate": {
+                "$ref": "#/$defs/__schema0"
             }
         },
         "required": [
             "name"
         ],
-        "additionalProperties": false
+        "additionalProperties": false,
+        "$defs": {
+            "__schema0": {
+                "anyOf": [
+                    {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "type": "string",
+                                        "const": "phase_reached"
+                                    },
+                                    "phase": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "phase"
+                                ],
+                                "additionalProperties": false
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "type": "string",
+                                        "const": "reviewer_green"
+                                    }
+                                },
+                                "required": [
+                                    "kind"
+                                ],
+                                "additionalProperties": false
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "type": "string",
+                                        "const": "max_iterations"
+                                    },
+                                    "n": {
+                                        "type": "integer",
+                                        "exclusiveMinimum": 0,
+                                        "maximum": 9007199254740991
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "n"
+                                ],
+                                "additionalProperties": false
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "type": "string",
+                                        "const": "artifact_produced"
+                                    },
+                                    "phase": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    },
+                                    "type": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "phase",
+                                    "type"
+                                ],
+                                "additionalProperties": false
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "type": "string",
+                                        "const": "min_artifacts_by_type"
+                                    },
+                                    "type": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    },
+                                    "n": {
+                                        "type": "integer",
+                                        "exclusiveMinimum": 0,
+                                        "maximum": 9007199254740991
+                                    },
+                                    "scope": {
+                                        "type": "string",
+                                        "enum": [
+                                            "phase",
+                                            "loop"
+                                        ]
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "type",
+                                    "n",
+                                    "scope"
+                                ],
+                                "additionalProperties": false
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "type": "string",
+                                        "const": "manual"
+                                    }
+                                },
+                                "required": [
+                                    "kind"
+                                ],
+                                "additionalProperties": false
+                            }
+                        ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "kind": {
+                                "type": "string",
+                                "const": "any"
+                            },
+                            "conditions": {
+                                "minItems": 1,
+                                "type": "array",
+                                "items": {
+                                    "$ref": "#/$defs/__schema0"
+                                }
+                            }
+                        },
+                        "required": [
+                            "kind",
+                            "conditions"
+                        ],
+                        "additionalProperties": false
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "kind": {
+                                "type": "string",
+                                "const": "all"
+                            },
+                            "conditions": {
+                                "minItems": 1,
+                                "type": "array",
+                                "items": {
+                                    "$ref": "#/$defs/__schema0"
+                                }
+                            }
+                        },
+                        "required": [
+                            "kind",
+                            "conditions"
+                        ],
+                        "additionalProperties": false
+                    }
+                ]
+            }
+        }
     },
     "LoopSlotInput": {
         "type": "object",

package/dist/commands/mcp.js

@@ -54,6 +54,8 @@ export const SCHEMA_VERSION = '1.0.0';
 export const MCP_PROTOCOL_VERSIONS = ['2025-11-25', '2024-11-05'];
 export const MCP_SERVER_NOT_INITIALIZED = -32002;
 const MCP_RUNTIME_REPAIR_COMMAND = 'brainclaw doctor --repair';
+const { $defs: loopPhaseDefs, ...loopPhaseItemSchema } = generatedSchemas.LoopPhase;
+const loopSlotInputItemSchema = generatedSchemas.LoopSlotInput;
 export const MCP_READ_TOOLS = [
     {
         name: 'bclaw_bootstrap',
@@ -917,6 +919,7 @@ const MCP_WRITE_TOOLS = [
         annotations: { tier: 'facade', category: 'loops', headlessApproval: 'auto', experimental: true, schemaSource: 'zod-derived' },
         inputSchema: {
             type: 'object',
+            ...(loopPhaseDefs ? { $defs: loopPhaseDefs } : {}),
             properties: {
                 intent: {
                     type: 'string',
@@ -927,8 +930,8 @@ const MCP_WRITE_TOOLS = [
                 kind: { type: 'string', enum: ['review', 'ideation', 'implementation', 'research', 'debug'], description: 'Loop kind for open / list filter.' },
                 title: { type: 'string', description: 'Human-readable title (open).' },
                 goal: { type: 'string', description: 'Optional goal statement (open).' },
-                phases: { type: 'array', items: generatedSchemas.LoopPhase, description: 'Optional phase list override (open). Items derived from LoopPhaseSchema (zod source) — see mcp-schemas.generated.ts.' },
-                slots: { type: 'array', items: generatedSchemas.LoopSlotInput, description: 'Optional initial slot specs (open). Items derived from LoopSlotInputSchema (zod source). Each item carries at least { role }.' },
+                phases: { type: 'array', items: loopPhaseItemSchema, description: 'Optional phase list override (open). Items derived from LoopPhaseSchema (zod source) — see mcp-schemas.generated.ts.' },
+                slots: { type: 'array', items: loopSlotInputItemSchema, description: 'Optional initial slot specs (open). Items derived from LoopSlotInputSchema (zod source). Each item carries at least { role }.' },
                 linked: { type: 'object', description: 'Optional top-level plan/sequence refs (open).' },
                 stop_condition: { type: 'object', description: 'Optional stop_condition override (open). Composite any/all supported.' },
                 mode: { type: 'string', enum: ['asymmetric', 'symmetric'], description: 'Review mode selector for open (review kind only).' },

package/dist/facts.js

@@ -1,8 +1,8 @@
 // Generated by scripts/emit-site-facts.mjs at build time. Do not edit manually.
-// Source: brainclaw v1.5.3 on 2026-05-10T19:05:14.160Z
+// Source: brainclaw v1.5.4 on 2026-05-10T22:45:47.168Z
 export const FACTS = {
-  "version": "1.5.3",
-  "generated_at": "2026-05-10T19:05:14.160Z",
+  "version": "1.5.4",
+  "generated_at": "2026-05-10T22:45:47.168Z",
   "tools": {
     "count": 60,
     "published_count": 59,

package/dist/facts.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.5.3",
-  "generated_at": "2026-05-10T19:05:14.160Z",
+  "version": "1.5.4",
+  "generated_at": "2026-05-10T22:45:47.168Z",
   "tools": {
     "count": 60,
     "published_count": 59,

package/docs/mcp-schema-changelog.md

@@ -82,7 +82,7 @@ will still succeed. A follow-up PR will strip the dead handler code.
   changelog records the published MCP surface fingerprint. When a tool
   name, tier, category, or input schema changes, the test fails until
   this section is updated.
-- MCP public surface fingerprint: `sha256:860fbaa30a486093`
+- MCP public surface fingerprint: `sha256:724085642dc3e2d7`
 
 See `docs/integrations/mcp.md` for the full canonical surface + an
 example gallery per verb. See `docs/concepts/mcp-governance.md` for

package/docs/product/positioning.md

@@ -65,16 +65,16 @@ Local-first gives teams:
 - Git history for shared project state
 - compatibility with enterprise or offline environments
 
-## License direction
-
-Today, brainclaw is published under the **Business Source License 1.1 (BSL 1.1)**.
-
-The direction after the closed beta is simpler:
-
-- the local-first brainclaw core is intended to move to MIT
-- remote shared-memory, hosted collaboration, advanced dashboards, and related private add-ons will stay separate commercial products
-
-The intended MIT core covers the local coordination layer:
+## License
+
+brainclaw core is published under the **MIT License**.
+
+The product split is:
+
+- the local-first brainclaw core is MIT
+- remote shared-memory, hosted collaboration, advanced dashboards, and related private add-ons will stay separate commercial products
+
+The MIT core covers the local coordination layer:
 
 - local project memory
 - local MCP and CLI workflows

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainclaw",
-  "version": "1.5.3",
+  "version": "1.5.4",
   "description": "Shared project memory for humans and coding agents.",
   "type": "module",
   "bin": {
@@ -52,7 +52,7 @@
     "handoff",
     "local-first"
   ],
-  "license": "BUSL-1.1",
+  "license": "MIT",
   "homepage": "https://brainclaw.dev",
   "dependencies": {
     "commander": "^14.0.3",