@brunobracaioli/aibrain 0.3.0-beta.7 → 0.4.0-beta.2

package/README.md

@@ -1,20 +1,69 @@
-# aibrain
-
-Assisted AI Brain context beta client for Linux/WSL with Node.js 22 or newer.
+# aisac
+
+The AISAC client for Claude Code and Codex on Linux/WSL with Node.js 22 or newer:
+AI Brain memory, context management and, for AISAC Founding Cohort members,
+AISAC Engineering.
+
+The command is `aisac`. `aibrain` is an alias for the same program, so existing
+scripts and habits keep working. The same files are published as `@aisac/cli`
+and, for existing installs, `@brunobracaioli/aibrain`. Install only one of them:
+both provide the `aisac` and `aibrain` commands. State stays in `~/.aibrain`.
+
+`aisac setup` and `aisac doctor` report the AISAC Engineering license
+(`active`, `inactive` or `unavailable`). The server decides; the client only
+shows the answer and sends the request only to the configured AI Brain address.
+`aisac status` stays offline.
+
+For licensed accounts, `aisac claude` downloads the AISAC Engineering pack for
+the session, verifies its Ed25519 signature against the key pinned in this
+release, and loads it as the `aisac-engineering` plugin from the session's
+private folder, which is deleted on exit. Any failure starts Claude without the
+pack. `aisac setup --lang pt-BR|en` picks the pack language without a network
+call. The pack is never part of this npm package.
+
+Codex capture also requires the `flock` utility from `util-linux`, normally
+included in Linux/WSL. The launcher and doctor check availability before a
+monitored Codex session starts. Capture coordination is released by the kernel
+after a process exits unexpectedly. An unidentifiable empty lock left by an
+older client requires a verified support migration; do not delete checkpoints,
+notes or lock files to work around a reported storage error.
 
 The reviewed native compatibility set is Claude Code 2.1.294, 2.1.295, 2.1.296,
-2.1.299 or 2.1.300, and Codex CLI 0.161.0,
-0.162.0 or 0.162.1. Other versions require a new compatibility review before setup.
+2.1.299, 2.1.300, 2.1.301, 2.1.302 or 2.1.303, and Codex CLI 0.161.0,
+0.162.0, 0.162.1, 0.163.0 or 0.164.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. Starting with beta14, newer stable Claude 2.1 patches can
+continue after isolated strict plugin validation, required hook/API checks and
+an enabled-hook test in the native offline runner. Doctor distinguishes
+`host_checked` from `qualified`; this check does not establish full behavioral
+equivalence with a tested native release. Unknown older patches, prereleases
+and other major/minor families remain rejected. No credentials, conversations,
+model requests or JEV calls are used by these compatibility probes.
+
+Beta17 refreshes the Codex contract to 0.164.0, including its image-generation
+record formats. Native launch/resume qualification is separate from a new
+model/JEV compaction qualification. A later native release that changes the
+consumed contract can still require an AI Brain compatibility update.
+
+The Codex terminal bridge permits the native session picker's separate read-only
+connection while keeping the primary conversation and monitor intact. A picker
+cannot compact, start a turn, inject history or take ownership of the primary
+connection. Its failure or timeout closes only that auxiliary connection.
 
 ```sh
 # Install the published beta:
-npm install -g @brunobracaioli/aibrain@beta
-aibrain setup --client both
-aibrain doctor --json
-aibrain claude
-aibrain codex
+npm install -g @aisac/cli@beta
+aisac setup --client both
+aisac doctor --json
+aisac claude
+aisac codex
 ```
 
+To move from `@brunobracaioli/aibrain` to `@aisac/cli`, close running sessions,
+then run `npm uninstall -g @brunobracaioli/aibrain` before
+`npm install -g @aisac/cli@beta`. Setup, notes and checkpoints are kept.
+
 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
@@ -27,10 +76,10 @@ 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 a CI-reviewed tarball, use `aisac-cli-*.tgz` with
+`npm install -g ./aisac-cli-*.tgz` (the same files are also packed as
+`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
@@ -54,7 +103,8 @@ text; they do not claim that a live session is being monitored. Codex keeps nati
 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.7` Claude launcher uses the durable context strategy:
+The `0.3.0-beta.14` 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.
@@ -80,6 +130,21 @@ 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:
 

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

@@ -1,6 +1,6 @@
 {
   "name": "ai-brain-context-compaction",
-  "version": "0.1.0",
+  "version": "0.3.0-beta.14",
   "author": { "name": "AISAC" },
   "description": "AI Brain paid-plan context monitoring with conservative Claude compaction fallback.",
   "hooks": "./hooks/hooks.json",