@rnbsolucoes/axion-code 0.1.3 → 0.1.5

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
 
@@ -45,6 +47,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,18 +153,26 @@ 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.
 
 The interactive TUI supports:
 
@@ -163,12 +182,52 @@ The interactive TUI supports:
 /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`.
+
+`/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 +263,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";
@@ -50,7 +50,7 @@ function installPackagedBinary() {
   if (!isWindows) {
     chmodSync(exePath, 0o755);
   }
-  writeFileSync(markerPath, `${packageJSON.version}\n`, "utf8");
+  writeFileSync(markerPath, `${packagedBinaryMarker()}\n`, "utf8");
   return true;
 }
 
@@ -64,13 +64,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 +89,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()

package/package.json

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