arcane-cli 0.22.7 → 0.22.9

package/dist/assets/.github/prompts/spell-commit-work.prompt.md

@@ -243,4 +243,21 @@ Author: Display Name <email>
 
 **Pull Request:** [full PR URL](https://github.com/{org}/{repo}/pull/{id} or https://dev.azure.com/{org}/{project}/_git/{repo}/pullrequest/{id})
 
+**Branch topology** — per the generated state diagrams convention (rule 8, ARC-036), built only from
+data Step 1/9 already gathered (current branch name, commits ahead of target via
+`git log origin/<target>..HEAD --format="%h %s" --reverse`). Skip entirely — this is the applicability
+guard — when there is no separate topic branch (the local-only-checkpoint path, committing directly on
+trunk) or no usable remote (nothing to compare against):
+
+```mermaid
+gitGraph
+   commit id: "<target HEAD short-sha>"
+   branch <branch-name>
+   commit id: "<short-sha 1>"
+   commit id: "<short-sha 2>"
+```
+
+One commit per entry in the gathered commit list, in the same order; omit the diagram (not just the
+commits) if that list is empty. Use `<target>`'s short SHA as the fork-point commit id.
+
 **Next:** Continue work or run `spell-close-session` to finalize journal and session docs.

package/dist/assets/.github/prompts/spell-create-pull-request.prompt.md

@@ -168,6 +168,22 @@ Documentation-only PR. No functional code changed.
 - If no reviewers were resolved (none passed, or names the provider could not match): `⚠ No reviewers assigned — add them in the PR or re-run with --reviewers`.
 - If `--draft`: note it was created as a draft.
 - Delete the body temp file (`<git-dir>/arcane-pr-body.md`) once the PR is confirmed created and verified.
+- **Branch topology** — per the generated state diagrams convention (rule 8, ARC-036), built only from
+  Step 1's already-gathered branch name and commit list (`git log origin/<target>..HEAD --format="%h %s" --reverse`).
+  Skip entirely (the applicability guard) if that commit list is empty — Step 0.4 already stops before
+  reaching here in that case, so this only re-states the same guard for anyone reading this step in
+  isolation:
+
+  ```mermaid
+  gitGraph
+     commit id: "<target HEAD short-sha>"
+     branch <branch-name>
+     commit id: "<short-sha 1>"
+     commit id: "<short-sha 2>"
+  ```
+
+  Same shape `spell-commit-work` uses for the identical concept — reference it rather than re-deriving
+  the rule (D8): one commit per gathered log entry, target's short SHA as the fork point.
 
 ## Rules
 

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