arcane-cli 0.22.6 → 0.22.8

package/dist/assets/.arcane/governance/universal-agent-rules.md

@@ -33,7 +33,7 @@ See also: [[README]], [[DECISIONS]], [[governance/git-conventions|Git Convention
 
 7. **Use wiki-links for cross-references** (e.g., `[[DECISIONS#ADR-NNN|Short Title]]`, `[[journal/YYYY-MM-DD-topic-slug|Session Label]]`). This enables knowledge graph visualization.
 
-8. **Use Mermaid for diagrams** (` ```mermaid ` blocks) for all flow charts, architecture diagrams, and sequence diagrams. Directory trees stay as plain code blocks.
+8. **Use Mermaid for diagrams** (` ```mermaid ` blocks) for all flow charts, architecture diagrams, and sequence diagrams. Directory trees stay as plain code blocks. Spell output describing state the spell already computed — not authored, freehand explanatory content — additionally follows the **generated state diagrams** convention ([ARC-036](https://github.com/codemagicianhq/arcane/blob/main/DECISIONS.md#arc-036--generated-state-diagrams-deterministic-mermaid-for-computed-spell-state)): a deterministic, data-derived Mermaid diagram built only from values already in scope, never modeled or invented. Skip it for one-line outputs, speed-rule spells, or any state with only a single reading — the diagram exists to make relationships between multiple already-computed values legible, not to decorate simple output.
 
 9. **Journal files use date-prefix naming:** `journal/YYYY-MM-DD-topic-slug.md` for chronological sorting.
 

package/dist/assets/.github/prompts/spell-arcane-version.prompt.md

@@ -40,23 +40,27 @@ Produce output in this exact structure:
 | **Installed At** | `{installedAt}`               |
 | **Components**   | `{count}` installed           |
 
-### Update Check
+### Update Check (two-axis)
 
-- Fetch the latest published version from the npm registry: `https://registry.npmjs.org/arcane-cli/latest`
-- Extract the `version` field from the JSON response.
-- Compare to the installed version.
+This repo's `.arcane.json` version is one of three readings — check both axes, the same two as
+`spell-open-session`'s own version check:
 
-If up to date:
+- **Repo-files version** — already read in Step 1 (`.arcane.json`'s `version` field).
+- **Installed CLI version** — determine the version of the installed `arcane-cli` CLI (for example,
+  `npx arcane-cli --version`, or the locally installed package version).
+- **Npm-latest version** — fetch `https://registry.npmjs.org/arcane-cli/latest` and extract the
+  `version` field.
 
-```
-✔ You are on the latest version ({version}).
-```
-
-If behind:
+- **(a) Repo-files behind the installed CLI:** `⚠ Managed files out of date: files at {version} → CLI at {cli}. Run spell update to resync files.`
+- **(b) Installed CLI behind npm-latest:** `⚠ Update available: CLI at {cli} → latest {latest}. Upgrade the CLI, then run spell update.`
+- **If either axis drifts, emit the canonical version-drift diagram** — same template, same collapsing/
+  branching rule, same `:::mermaid`-for-ADO-wikis fencing as `spell-open-session.prompt.md`'s own
+  "Arcane version check (two-axis)" step; that file holds the canonical shape, referenced here rather
+  than repeated.
+- If both axes are current:
 
 ```
-⚠ Update available: {installed} → {latest}
-Run `spell update` to upgrade.
+✔ You are on the latest version ({version}).
 ```
 
 If the npm registry is unreachable, report:

package/dist/assets/.github/prompts/spell-open-session.prompt.md

@@ -96,7 +96,19 @@ Before anything else, check:
   - Run `npm view arcane-cli version` to get the latest published version.
   - **(a) Managed files behind the installed CLI** (installed CLI version is newer than the version recorded in `.arcane.json`): surface a warning: `⚠️ Managed files out of date: files at <installed> → CLI at <cli>. Run spell update to resync files.`
   - **(b) Installed CLI behind the latest published version** (latest published is newer than the installed CLI): surface a warning: `⚠️ Arcane CLI update available: CLI at <cli> → latest <latest>. Upgrade the CLI, then run spell update.`
-  - If both axes are current, report current and continue.
+  - **If either axis shows drift, emit the canonical version-drift diagram beside the warning(s)** — per the generated state diagrams convention (rule 8, ARC-036). One commit per *distinct* version value among the three readings, in the order repo-files → installed-CLI → npm-latest; collapse consecutive identical values into a single shared commit rather than repeating it. Branch off immediately after the commit for each axis that drifts — `repo-files` after the repo-files-version commit if axis A drifts, `installed-cli` after the installed-CLI-version commit if axis B drifts. Tag the final commit `"latest"`. The dangling branch(es) *are* the drifting axis/axes — no legend needed:
+    ```mermaid
+    gitGraph
+       commit id: "<repo-files version>"
+       branch repo-files
+       checkout main
+       commit id: "<installed-CLI version>"
+       branch installed-cli
+       checkout main
+       commit id: "<npm-latest version>" tag: "latest"
+    ```
+    (Shown here with both axes drifting — omit whichever `branch`/`checkout` pair belongs to a non-drifting axis, and collapse its commit into its neighbor's if the values are equal.) Use `:::mermaid` fencing instead of ` ```mermaid ` when the output surface is an Azure DevOps wiki — resolve `external_provider` from `.arcane.json` rather than assuming, the same as every other tracker-conditional step in this file; note for bare terminals that the fenced source is still readable without a renderer.
+  - If both axes are current, report current and continue — no diagram (the applicability guard: a single, matching reading has nothing to visualize).
   - If no `.arcane.json` exists, skip silently.
 
 ## State Snapshot

package/dist/index.js

@@ -3371,6 +3371,33 @@ async function checkForUpdate(currentVersion, feedUrl, cachePath = DEFAULT_CACHE
   }
 }
 
+// src/modules/diagram-generator.ts
+function generateVersionDriftDiagram(repoFilesVersion, installedCliVersion, npmLatestVersion) {
+  if (repoFilesVersion === installedCliVersion && installedCliVersion === npmLatestVersion) {
+    return null;
+  }
+  const lines = ["gitGraph", `   commit id: "${repoFilesVersion}"`];
+  let lastDistinctVersion = repoFilesVersion;
+  if (installedCliVersion !== repoFilesVersion) {
+    lines.push(
+      "   branch repo-files",
+      "   checkout main",
+      `   commit id: "${installedCliVersion}"`
+    );
+    lastDistinctVersion = installedCliVersion;
+  }
+  if (npmLatestVersion !== lastDistinctVersion) {
+    lines.push(
+      "   branch installed-cli",
+      "   checkout main",
+      `   commit id: "${npmLatestVersion}" tag: "latest"`
+    );
+  } else {
+    lines[lines.length - 1] += ' tag: "latest"';
+  }
+  return lines.join("\n");
+}
+
 // src/commands/status.ts
 async function runStatus(targetDir, packageVersion) {
   let manifest;
@@ -3429,6 +3456,26 @@ async function runStatus(targetDir, packageVersion) {
     footer += "  (spell update available)";
   }
   console.log(footer);
+  if (versionResult.latest !== null) {
+    const diagram = generateVersionDriftDiagram(
+      manifest.version,
+      packageVersion,
+      versionResult.latest
+    );
+    if (diagram !== null) {
+      console.log("");
+      if (process.stdout.isTTY) {
+        console.log("  Version drift:");
+        console.log(`    repo-files:    ${manifest.version}`);
+        console.log(`    installed-cli: ${packageVersion}`);
+        console.log(`    latest (npm):  ${versionResult.latest}`);
+      } else {
+        console.log("```mermaid");
+        console.log(diagram);
+        console.log("```");
+      }
+    }
+  }
 }
 
 // src/commands/uninstall.ts