@rnbsolucoes/axion-code 0.1.3 → 0.1.6

package/README.md

@@ -19,7 +19,9 @@ This MVP follows the PREVC-P documentation package in `.context/`:
 - Axion Desktop fallback provider presets, including OpenAI-compatible and Anthropic-compatible endpoints;
 - shared Axion Desktop/CLI provider, model and permission stores under `%USERPROFILE%\.axion`;
 - Pi Agent assets in inspect/import-only mode;
-- MCP probe/list/read-only posture.
+- native dotcontext and MCP management posture;
+- plan-scoped PREVC + A learning consolidation through `/learn`;
+- shared plugin and native isolated subagent catalogs.
 
 ## MVP Commands
 
@@ -29,6 +31,8 @@ axion-code ask "Explique este projeto"
 axion-code ask --provider openrouter --model google/gemini-2.5-flash-lite "Responda em uma linha"
 axion-code run --json
 axion-code doctor --json
+axion-code init --json
+axion-code init --project --json
 axion-code session list --json
 axion-code provider list --json
 axion-code provider profile init
@@ -45,6 +49,15 @@ axion-code graphics doctor
 axion-code graphics logo
 axion-code graphics logo --mode sixel --width 180
 axion-code mcp list --json
+axion-code mcp add sample --command node --arg server.js
+axion-code mcp enable sample
+axion-code mcp disable sample
+axion-code mcp remove sample
+axion-code mcp import .\mcp-servers.json
+axion-code plugins list --json
+axion-code agents list --json
+axion-code agents run bug-hunter "review this login flow"
+axion-code learn --json
 axion-code package inspect <path>
 ```
 
@@ -142,33 +155,115 @@ Without npm:
 go build -o "$env:LOCALAPPDATA\AxionCode\bin\axion-code.exe" ./cmd/axion-code
 ```
 
-Provider and model configuration is shared with Axion Desktop:
+Provider catalog/configuration is shared with Axion Desktop, while the active
+Axion Code selection is isolated:
 
 ```text
 %USERPROFILE%\.axion\harness\providers.json
-%USERPROFILE%\.axion\harness\active_profile
+%USERPROFILE%\.axion\harness\active_profile          # Axion Desktop active profile
+%USERPROFILE%\.axion\harness\active_profile_cli      # Axion Code active profile
+%USERPROFILE%\.axion\harness\selection_cli.json      # Axion Code active model/params
 %USERPROFILE%\.axion\axion-mode.json
 %USERPROFILE%\.axion\sessions\axion.db
+%USERPROFILE%\.axion\mcp-servers.json
+%USERPROFILE%\.axion\plugins.json
+%USERPROFILE%\.axion\sub-agents.json
 ```
 
 OpenRouter uses `OPENROUTER_API_KEY` from the environment or a `secret:<NAME>` reference stored in `C:\Israel\Pesoal\secrets.env` (override for tests: `AXION_SECRETS_ENV`). Provider profile config stores only references, never the key value.
 
-For test/dev isolation, set `AXION_HOME` to a temporary folder. In normal use, leave it unset so Desktop and CLI remain two surfaces of the same Axion harness.
+For test/dev isolation, set `AXION_HOME` to a temporary folder. In normal use,
+leave it unset so Desktop and CLI share the same provider catalog while keeping
+their active provider/model selections independent.
+
+## Project Bootstrap
+
+`axion-code init --json` bootstraps the shared user-level Axion home used by
+Axion Desktop and Axion Code. It creates missing files under
+`%USERPROFILE%\.axion` without overwriting Desktop-owned provider/model state.
+
+`axion-code init --project --json` bootstraps the current workspace. The same
+operation is available inside the TUI with `/init`. It creates only missing
+project scaffolding:
+
+```text
+.brv/       local operational memory and PREVC + A learning buffers
+.context/   workflow, plans, tasks, context snapshots and PREVC evidence
+.docs/      project documents, specs, reports and handoff material
+AGENTS.md   project-scoped instructions
+CLAUDE.md   Claude-compatible project instructions
+.gitignore  ignored local runtime, secrets, cache and build-output patterns
+```
+
+If a legacy `docs/` directory exists and `.docs/` does not, project bootstrap
+renames `docs/` to `.docs/`. If both exist, Axion Code leaves both untouched and
+does not attempt an automatic merge.
+
+Instruction layering is explicit: shared `%USERPROFILE%\.axion\AGENTS.md`
+contains global Axion Code agent rules, while the workspace root `AGENTS.md`
+contains project-specific rules. Provider runtime prompts read both layers when
+present, plus `CLAUDE.md` as a compatibility surface.
 
 The interactive TUI supports:
 
 ```text
 /             inline slash palette
+/init
 /provider
 /provider set <profile-id>
 /model
 /permission
+/mcp
+/learn
+/plugins
+/agents
+/agents run <id> <prompt>
 ```
 
 Slash palette behavior: `↑/↓` selects, `Tab` completes the selected command, `Enter` executes the selected command, `Esc` closes active menus/wizards.
 
 `/model` pulls the active provider's `/models` endpoint when credentials are configured. Reasoning and fast-mode steps appear only when the selected model metadata exposes those parameters.
 
+`/learn` consolidates plan-scoped learning from `.brv/plans/<plan-id>` and `.context/learning-candidates*.md`, filters low-signal material, deduplicates by content hash/summary and promotes relevant notes into native dotcontext at `<workspace>/.axion/context`.
+
+When the active plan comes from `.context/plans/*.md`, `/task add`, `/task done`
+and `/task progress` update the Markdown plan file directly. Axion Code rewrites
+only the target task line marker/progress and keeps the rest of the document
+unchanged.
+
+`/mcp` opens an inline MCP list. Enabled servers can be disabled, disabled servers can be enabled, and non-native servers can be uninstalled while preserving valid `mcp-servers.json` formatting.
+
+`/agents` lists the native isolated subagents. `/agents run <id> <prompt>` calls one with an isolated prompt while inheriting the active provider/model from the main agent. The subagent returns findings/action feedback instead of joining the main context by default.
+
+## MCP, Plugins And Subagents
+
+MCP import files use the same JSON array shape as `%USERPROFILE%\.axion\mcp-servers.json`:
+
+```json
+[
+  {
+    "id": "context7",
+    "name": "Context7",
+    "transport": "stdio",
+    "command": "npx",
+    "args": ["-y", "@upstash/context7-mcp"],
+    "enabled": false,
+    "read_only": true
+  }
+]
+```
+
+`axion mcp import <file.json>` merges by `id`, preserves `native` protection for built-ins, writes formatted JSON, and rejects entries without `id` or without the required `command`/`url` for the selected transport. Native MCPs such as `dotcontext` cannot be removed, only disabled.
+
+Plugins are read from the same shared Axion Desktop file, `%USERPROFILE%\.axion\plugins.json`. The CLI can list, enable, disable and remove plugin records, but executable plugin installation remains intentionally gated for the next trust-policy cycle.
+
+Subagents are stored in `%USERPROFILE%\.axion\sub-agents.json`. The initial catalog has 15 native entries:
+
+- Programming: `code-reviewer`, `bug-hunter`, `security-reviewer`, `performance-reviewer`, `frontend-ux-reviewer`.
+- Professional: `product-strategist`, `business-analyst`, `financial-analyst`, `legal-policy-reviewer`, `marketing-strategist`, `sales-ops-analyst`, `customer-success-advisor`, `data-analyst`, `operations-advisor`, `hr-talent-advisor`.
+
+Execution contract: subagents inherit the active provider/model, receive an isolated prompt containing only their role and the requested task, do not access the main hidden context unless explicitly included in the prompt, and return findings/evidence/actions back to the main timeline.
+
 Provider menu actions:
 
 ```text
@@ -204,4 +299,5 @@ This is a functional direction MVP, not the full harness:
 - initial chat splash shows the Axion logo and system name until the first interaction;
 - no tool execution yet;
 - no executable Pi RPC bridge yet;
-- no MCP transport execution yet.
+- no MCP transport execution yet;
+- native subagent execution is prompt-isolated and provider/model-inherited; richer multi-subagent orchestration, streaming and budget telemetry remain next-cycle items.

package/npm/bin/axion.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
-import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import https from "node:https";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -42,15 +42,49 @@ function sourceAvailable() {
   return existsSync(join(root, "go.mod")) && existsSync(join(root, "cmd", "axion-code"));
 }
 
+function sleep(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
+function markerMatches(expectedMarker) {
+  try {
+    return existsSync(exePath) && readFileSync(markerPath, "utf8").trim() === expectedMarker;
+  } catch {
+    return false;
+  }
+}
+
+function copyPackagedBinaryWithRetry(expectedMarker) {
+  for (let attempt = 0; attempt < 8; attempt += 1) {
+    try {
+      copyFileSync(packagedExePath, exePath);
+      return;
+    } catch (error) {
+      const retryable = error && (error.code === "EBUSY" || error.code === "EPERM");
+      if (!retryable) {
+        throw error;
+      }
+      if (markerMatches(expectedMarker)) {
+        return;
+      }
+      if (attempt === 7) {
+        throw error;
+      }
+      sleep(75 * (attempt + 1));
+    }
+  }
+}
+
 function installPackagedBinary() {
   if (!existsSync(packagedExePath)) {
     return false;
   }
-  copyFileSync(packagedExePath, exePath);
+  const marker = packagedBinaryMarker();
+  copyPackagedBinaryWithRetry(marker);
   if (!isWindows) {
     chmodSync(exePath, 0o755);
   }
-  writeFileSync(markerPath, `${packageJSON.version}\n`, "utf8");
+  writeFileSync(markerPath, `${marker}\n`, "utf8");
   return true;
 }
 
@@ -64,13 +98,14 @@ function buildFromSource() {
   if (result.status !== 0) {
     return false;
   }
-  writeFileSync(markerPath, `${packageJSON.version}\n`, "utf8");
+  writeFileSync(markerPath, `${sourceBinaryMarker()}\n`, "utf8");
   return true;
 }
 
 function ensureBinary() {
   const marker = existsSync(markerPath) ? readFileSync(markerPath, "utf8").trim() : "";
-  if (existsSync(exePath) && marker === packageJSON.version) {
+  const desiredMarker = existsSync(packagedExePath) ? packagedBinaryMarker() : sourceBinaryMarker();
+  if (existsSync(exePath) && marker === desiredMarker) {
     return;
   }
   mkdirSync(binDir, { recursive: true });
@@ -88,6 +123,19 @@ function ensureBinary() {
   process.exit(1);
 }
 
+function packagedBinaryMarker() {
+  try {
+    const stat = statSync(packagedExePath);
+    return `${packageJSON.version}|${platformKey}|pkg|${stat.size}|${Math.trunc(stat.mtimeMs)}`;
+  } catch {
+    return `${packageJSON.version}|${platformKey}|pkg`;
+  }
+}
+
+function sourceBinaryMarker() {
+  return `${packageJSON.version}|${platformKey}|source`;
+}
+
 function semverParts(value) {
   return String(value || "")
     .trim()
@@ -183,7 +231,12 @@ async function fetchLatestPackage() {
 async function readUpdateInfo({ force = false } = {}) {
   const cached = readJSON(updateCachePath);
   const now = Date.now();
-  if (!force && cached?.latestVersion && now - Number(cached.checkedAt || 0) < updateCacheTTL) {
+  if (
+    !force &&
+    cached?.latestVersion &&
+    compareVersions(cached.latestVersion, packageJSON.version) >= 0 &&
+    now - Number(cached.checkedAt || 0) < updateCacheTTL
+  ) {
     return {
       currentVersion: packageJSON.version,
       latestVersion: cached.latestVersion,
@@ -209,13 +262,17 @@ async function readUpdateInfo({ force = false } = {}) {
     }
     return info;
   } catch (error) {
+    const usableCachedVersion =
+      cached?.latestVersion && compareVersions(cached.latestVersion, packageJSON.version) >= 0
+        ? cached.latestVersion
+        : "";
     return {
       currentVersion: packageJSON.version,
-      latestVersion: cached?.latestVersion || "",
-      updateAvailable: cached?.latestVersion ? compareVersions(cached.latestVersion, packageJSON.version) > 0 : false,
+      latestVersion: usableCachedVersion,
+      updateAvailable: usableCachedVersion ? compareVersions(usableCachedVersion, packageJSON.version) > 0 : false,
       source: cached?.source || updateSource,
       checkedAt: cached?.checkedAt || 0,
-      fromCache: Boolean(cached?.latestVersion),
+      fromCache: Boolean(usableCachedVersion),
       error: error.message
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rnbsolucoes/axion-code",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "Axion Code CLI harness for the Axion ecosystem.",
   "type": "module",
   "repository": {