@hanv89/azure-arch-skill 0.1.0 → 0.2.0

package/README.md

@@ -1,9 +1,9 @@
 # @hanv89/azure-arch-skill
 
-> **Status**: pre-publish. The package is not yet on npmjs.com — the `npx` command below works once the first release ships.
-
 CLI installer for the Azure architecture diagram skill. Drops the skill bundle (`SKILL.md` + worked PlantUML examples) into your AI coding agent's skill folder so that prompts like *"draw an Azure context diagram"* produce diagrams that use official Microsoft Azure architecture icons.
 
+Published with Sigstore provenance via npm Trusted Publishing — verify with `npm view @hanv89/azure-arch-skill@latest dist.attestations`.
+
 ## Requirements
 
 - Node.js ≥ 20

package/dist/adapters/claude-code.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.claudeCodeAdapter = exports.parseFrontmatter = void 0;
+exports.claudeCodeAdapter = exports.parseFrontmatter = exports.fetchWithTimeout = void 0;
 const fs = __importStar(require("node:fs/promises"));
 const path = __importStar(require("node:path"));
 const os = __importStar(require("node:os"));
@@ -37,9 +37,12 @@ const DEFAULT_BASE_RAW_URL = "https://raw.githubusercontent.com/hanv89/azure-ico
 // existing installs become un-uninstallable until users upgrade the CLI
 // (uninstall's allow-list refuses folders whose SKILL.md `name` differs).
 const SKILL_NAME = "azure-architecture-diagram";
+// Hard-coded bundle list. Keep SKILL.md as index 0 — install() relies on
+// BUNDLE_FILES[0] for the frontmatter-parsing precheck.
 const BUNDLE_FILES = [
     { src: "dist/skill/SKILL.md", dest: "SKILL.md" },
     { src: "dist/skill/examples/01-context.puml", dest: "examples/01-context.puml" },
+    { src: "dist/skill/examples/02-fabric-data-pipeline.puml", dest: "examples/02-fabric-data-pipeline.puml" },
 ];
 const CANARY_ICON_PATH = "dist/Azure/Compute/AzureVirtualMachine.png";
 const FETCH_TIMEOUT_MS = 30_000;
@@ -128,20 +131,50 @@ async function safeResolveTarget(target) {
     }
     return realResolved;
 }
-async function fetchWithTimeout(url, init = {}) {
-    const ctrl = new AbortController();
-    const t = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
-    try {
-        return await fetch(url, {
-            ...init,
-            signal: ctrl.signal,
-            headers: { ...(init.headers || {}), "User-Agent": USER_AGENT },
-        });
-    }
-    finally {
-        clearTimeout(t);
+/**
+ * Fetch with timeout and 2-retry exponential backoff on transient 5xx
+ * responses. Used by `fetchText` and `headOk`; both inherit the retry
+ * behavior. Default `retries = 2` matches the R30 fix (Phase 1.0) —
+ * future agent adapters reusing this helper get the retry path for free.
+ *
+ * Backoff schedule: 500ms after attempt 0, 1s after attempt 1, 2s after
+ * attempt 2. Network errors (AbortError, DNS failures) re-throw only
+ * after the final attempt.
+ *
+ * @internal — exported only so unit tests can mock `globalThis.fetch`
+ *             around it. Not part of the public adapter API.
+ */
+async function fetchWithTimeout(url, init = {}, retries = 2) {
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
+        try {
+            const res = await fetch(url, {
+                ...init,
+                signal: ctrl.signal,
+                headers: { ...(init.headers || {}), "User-Agent": USER_AGENT },
+            });
+            if (res.status < 500 || attempt === retries) {
+                return res;
+            }
+            // 5xx with retries remaining: fall through to backoff.
+        }
+        catch (e) {
+            lastError = e;
+            if (attempt === retries)
+                throw e;
+        }
+        finally {
+            clearTimeout(t);
+        }
+        // Exponential backoff: 500ms, 1s, 2s.
+        await new Promise((r) => setTimeout(r, 2 ** attempt * 500));
     }
+    // Unreachable: the loop body always returns or throws on the final attempt.
+    throw lastError ?? new Error("fetchWithTimeout: exhausted retries");
 }
+exports.fetchWithTimeout = fetchWithTimeout;
 async function fetchText(url) {
     const res = await fetchWithTimeout(url);
     if (!res.ok)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanv89/azure-arch-skill",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Install the Azure architecture diagram skill into your AI coding agent (Claude Code, Codex CLI, Cursor).",
   "bin": {
     "azure-arch-skill": "dist/index.js"