@brunobracaioli/aibrain 0.0.0-stage → 0.1.0-beta.1

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# aibrain
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Assisted AI Brain context beta client for Linux/WSL with Node.js 22 or newer.
+
+The reviewed native compatibility set is Claude Code 2.1.294, 2.1.295, or
+2.1.296, and Codex CLI 0.161.0 or 0.162.0. Other versions require a new
+compatibility review before setup.
+
+```sh
+# After the reviewed artifact is published:
+npm install -g @brunobracaioli/aibrain@beta
+aibrain setup --client both
+aibrain doctor --json
+aibrain claude
+aibrain codex
+```
+
+Installation does not contact AI Brain, change native client configuration, or
+enable all paid accounts. Setup requires an existing AI Brain PAT, explicit
+versioned disclosure, and successful provider-free pilot access. Claude and
+Codex continue to own their own authentication. Windows native is unsupported;
+run the beta inside WSL. Pricing and general customer activation are outside
+this beta.
+
+For reviewed noninteractive automation only, use a private token file and
+explicitly acknowledge the displayed disclosure with
+`aibrain setup --client both --token-file /private/path/brain.pat
+--accept-disclosure`.
+
+Before registry publication, use the reviewed
+`brunobracaioli-aibrain-*.tgz` artifact from CI with
+`npm install -g ./brunobracaioli-aibrain-*.tgz`; registry installation is gated on
+the operator's npm review and authentication.
+
+For users of an earlier unscoped review tarball, close its client sessions,
+run `npm uninstall -g aibrain`, and install this scoped package. Local
+`~/.aibrain` state, notes, and checkpoints are retained.
+
+Read the [canonical subscriber beta guide](https://github.com/brunobracaioli/mcp-ai-brain/blob/main/docs/how-to/aibrain-subscriber-beta.md)
+for setup, support, disclosure, limits, and disable procedures.

package/dist/assets/claude/.claude-plugin/plugin.json

@@ -0,0 +1,45 @@
+{
+  "name": "ai-brain-context-compaction",
+  "version": "0.1.0",
+  "author": { "name": "AISAC" },
+  "description": "AI Brain paid-plan context monitoring with conservative Claude compaction fallback.",
+  "hooks": "./hooks/hooks.json",
+  "userConfig": {
+    "brainServer": {
+      "type": "string",
+      "title": "AI Brain MCP server",
+      "description": "The name of the already authenticated AI Brain MCP server. The hook uses that connection and never accepts a JEV key.",
+      "default": "brain"
+    },
+    "compactAtPercent": {
+      "type": "number",
+      "title": "Context threshold",
+      "description": "Request host compaction at or above this reported context percentage.",
+      "default": 85
+    },
+    "enabled": {
+      "type": "boolean",
+      "title": "Enable automatic compaction",
+      "description": "Requires explicit local opt-in and AI Brain disclosure; failures use Claude's built-in fallback.",
+      "default": false
+    },
+    "disclosed": {
+      "type": "boolean",
+      "title": "Projection disclosure acknowledged",
+      "description": "Allow the redacted projection to be sent to AI Brain for the paid-gated plan.",
+      "default": false
+    },
+    "preservationMode": {
+      "type": "string",
+      "title": "Claude preservation mode",
+      "description": "preserve_internal keeps handled messages intact. upstream_compatible rebuilds selected handled read messages from exposed fields and may lose hidden engine metadata.",
+      "default": "preserve_internal"
+    },
+    "diagnosticMode": {
+      "type": "boolean",
+      "title": "Emit runtime diagnostics",
+      "description": "Opt-in content-free hook entry diagnostics for local pilot verification.",
+      "default": false
+    }
+  }
+}