@brunobracaioli/aibrain 0.1.0-beta.1 → 0.3.0-beta.13

package/README.md

@@ -2,12 +2,15 @@
 
 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.
+The reviewed native compatibility set is Claude Code 2.1.294, 2.1.295, 2.1.296,
+2.1.299, 2.1.300, 2.1.301 or 2.1.302, and Codex CLI 0.161.0,
+0.162.0, 0.162.1 or 0.163.0. A newer stable Codex 0.x release may continue only
+after its locally generated experimental protocol schemas and transport flags
+match the bundled adapter contract; prereleases, older releases and new majors
+remain rejected.
 
 ```sh
-# After the reviewed artifact is published:
+# Install the published beta:
 npm install -g @brunobracaioli/aibrain@beta
 aibrain setup --client both
 aibrain doctor --json
@@ -27,8 +30,8 @@ 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
+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.
 
@@ -36,5 +39,83 @@ 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.3` 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.
+
+The `0.3.0-beta.13` Claude launcher uses the durable context strategy and
+records bounded recovery reasons when native summary proof cannot be confirmed:
+JEV selects compatible historical tool evidence, bounded private notes retain
+the selected text, and Claude core summarizes the reduced input. The next
+prompt restores those notes in the same session after verifying native state.
+The final native context contains a summary; this is not summary-free transcript
+replacement. Direct hook-owned history replacement remains experimental because
+resume can replay older content in affected Claude versions.
+
+The notes preserve only the selected retained text that fits the local bound;
+oversized entries are omitted as whole entries and counted. The separate full
+checkpoint has its own retention. Neither path guarantees perfect preservation
+of every internal host field. Shadow prefiltering continues to observe without
+changing tool results. Native qualification and publication evidence is tracked
+in the [release record](https://github.com/brunobracaioli/mcp-ai-brain/blob/main/docs/reference/claude-durable-context-2026-10-14.md).
+
+The launcher grants the native clients the provider-free `brain_context_budget`
+read alongside the existing context tools. It is a short-lived advisory snapshot,
+not a billing meter, reservation, or provider authorization; atomic admission
+remains authoritative.
+
+Codex diagnostics are kept in the launched adapter's private state directory.
+`aibrain diagnostics --client codex --json` shows only bounded stages, closed
+reasons, pseudonymous session identifiers, client versions, and small numeric
+counters. Prompts, notes, paths, credentials, raw errors, and app-server stdout
+are excluded.
+
+Beta12 reads large Codex histories in bounded pages and keeps their complete
+contents in verified private capture segments. It checks history again before
+selection and before native compaction; notes and recovery stay in the same
+thread. Older captures remain readable. A single turn exceeding 8 MiB, a capture
+exceeding the bounded page/item/128 MiB limits, or exhausted private storage is
+reported explicitly. Such a failure does not authorize discarding protected
+history or retrying a paid operation. The private capture directory remains
+bounded to 256 MiB and 128 managed files, with current recovery references
+protected from cleanup.
+
+Claude plan diagnostics distinguish response parsing, identity, expiry and
+history changes. A text JSON plan can use the same 256 KiB limit as structured
+plans; smaller budget/error envelopes retain their separate limits. These local
+diagnostics contain format names and numeric sizes, never plan contents.
+
+Context dashboard telemetry is disabled for fresh and existing configurations.
+Enable it only after reviewing the extended disclosure:
+
+```sh
+aibrain setup --client both --telemetry on --accept-disclosure
+```
+
+Omit `--telemetry` to preserve the stored choice, or use `--telemetry off` to stop
+future-launch reports. Settings are captured when a client starts, so close and
+restart currently monitored sessions after opting out to stop their reporting.
+Enabled reports use the existing authenticated MCP transport and
+contain only a hashed native session key, random lifecycle identifiers, native
+client version, phase, timestamps, numeric counts, and allowed measurements or
+reasons. Prompts, notes, paths, tool names, credentials, and raw errors are not
+reported. The dashboard shows a 30-day visible window; physical cleanup runs on
+the next successful daily cleanup. Delivery failure never fails or triggers a
+context operation.
+
 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

@@ -1,10 +1,16 @@
 {
   "name": "ai-brain-context-compaction",
-  "version": "0.1.0",
+  "version": "0.3.0-beta.13",
   "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",
@@ -17,6 +23,54 @@
       "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",
@@ -35,11 +89,59 @@
       "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"
     },
+    "compactionStrategy": {
+      "type": "string",
+      "title": "Compaction strategy",
+      "description": "direct_experimental returns a hook-owned transcript; native_summary_notes delegates the final summary to Claude core and keeps selected evidence in private notes.",
+      "default": "direct_experimental"
+    },
     "diagnosticMode": {
       "type": "boolean",
       "title": "Emit runtime diagnostics",
       "description": "Opt-in content-free hook entry diagnostics for local pilot verification.",
       "default": false
+    },
+    "telemetryEnabled": {
+      "type": "boolean",
+      "title": "Enable context dashboard telemetry",
+      "description": "Opt-in operational telemetry for the authenticated Contexto dashboard. The launcher enables this only after the extended AI Brain disclosure.",
+      "default": false
+    },
+    "telemetryDisclosed": {
+      "type": "boolean",
+      "title": "Context telemetry disclosure acknowledged",
+      "description": "Permit content-free lifecycle reports containing a hashed session key, bounded measurements, counts, phases and reasons.",
+      "default": false
+    },
+    "telemetryClientVersion": {
+      "type": "string",
+      "title": "Native Claude version",
+      "description": "Launcher-provided native semver used to label telemetry; empty values keep telemetry inactive.",
+      "default": ""
+    },
+    "telemetryNodePath": {
+      "type": "string",
+      "title": "Owned telemetry Node path",
+      "description": "Launcher-provided absolute Node executable path for the report helper.",
+      "default": ""
+    },
+    "telemetryHelperPath": {
+      "type": "string",
+      "title": "Owned telemetry helper path",
+      "description": "Launcher-provided absolute report-only helper path.",
+      "default": ""
+    },
+    "telemetryStateDir": {
+      "type": "string",
+      "title": "Owned telemetry state path",
+      "description": "Launcher-provided private aibrain state directory for the helper.",
+      "default": ""
+    },
+    "telemetryConfigDigest": {
+      "type": "string",
+      "title": "Owned telemetry configuration binding",
+      "description": "Launcher-provided binding for the private endpoint, token and disclosure state.",
+      "default": ""
     }
   }
 }