@rnbsolucoes/axion-code 0.1.5 → 0.1.7

package/README.md

@@ -31,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
@@ -174,10 +176,39 @@ 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
@@ -195,6 +226,11 @@ Slash palette behavior: `↑/↓` selects, `Tab` completes the selected command,
 
 `/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.

package/npm/bin/axion.mjs

@@ -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, `${packagedBinaryMarker()}\n`, "utf8");
+  writeFileSync(markerPath, `${marker}\n`, "utf8");
   return true;
 }
 
@@ -197,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,
@@ -223,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.5",
+  "version": "0.1.7",
   "description": "Axion Code CLI harness for the Axion ecosystem.",
   "type": "module",
   "repository": {