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

package/README.md

@@ -1,3 +1,58 @@
-# 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, 0.162.0 or 0.162.1. Other versions require a new
+compatibility review before setup.
+
+```sh
+# Install the published beta:
+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`.
+
+For a CI-reviewed tarball, use
+`brunobracaioli-aibrain-*.tgz` 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.
+
+This `0.2` client adds configurable context profiles. A fresh
+setup defaults to `upstream`: 60% trigger, 0.5 keep threshold, six recent items
+protected, and broader completed text-tool eligibility in Claude. Existing
+schema1 configurations keep their previous behavior. After a reviewed v2 backend
+and client release, opt in explicitly with:
+
+```sh
+aibrain setup --client both --context-profile upstream
+# Or retain conservative retention with the v2 protocol:
+aibrain setup --client both --context-profile conservative
+```
+
+Use `aibrain --help` for individual overrides. Claude-only flags are rejected for
+Codex-only setup. Status and doctor show effective settings without custom goal
+text; they do not claim that a live session is being monitored. Codex keeps native
+compaction and recovery notes in the same thread. The backend checks paid access
+and unchanged shared quotas before any JEV request.
+
+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,99 @@
+{
+  "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": {
+    "policyVersion": {
+      "type": "number",
+      "title": "Context policy version",
+      "description": "Use 2 for configurable broader parity; omit or use 1 to preserve legacy behavior.",
+      "default": 1
+    },
+    "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
+    },
+    "keepThreshold": {
+      "type": "number",
+      "title": "JEV keep threshold",
+      "description": "V2 score threshold for retaining eligible content.",
+      "default": 0.5
+    },
+    "preserveRecentMessages": {
+      "type": "number",
+      "title": "Recent messages to preserve",
+      "description": "Number of recent messages pinned before scoring.",
+      "default": 6
+    },
+    "minReductionRatio": {
+      "type": "number",
+      "title": "Minimum reduction ratio",
+      "description": "Minimum configured reduction required before returning a candidate.",
+      "default": 0.25
+    },
+    "truncateHeadChars": {
+      "type": "number",
+      "title": "Truncated result head characters",
+      "description": "Unicode-safe head size for eligible result truncation.",
+      "default": 300
+    },
+    "maxStateTokens": {
+      "type": "number",
+      "title": "Maximum scoring state units",
+      "description": "Upper bound for the provider scoring state.",
+      "default": 25000
+    },
+    "maxRequestTokens": {
+      "type": "number",
+      "title": "Maximum scoring request units",
+      "description": "Upper bound for the provider scoring request.",
+      "default": 30000
+    },
+    "toolPolicy": {
+      "type": "string",
+      "title": "Claude tool policy",
+      "description": "Use read_only or compatible v2 eligibility.",
+      "default": "compatible"
+    },
+    "goal": {
+      "type": "string",
+      "title": "Private task goal",
+      "description": "Optional bounded private task goal sent in the redacted projection.",
+      "default": ""
+    },
+    "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
+    }
+  }
+}