@hanv89/azure-arch-skill 0.4.0 → 0.5.0

package/dist/adapters/_shared.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.withFatalReturn = exports.parseFrontmatter = exports.fetchManifest = exports.headOk = exports.fetchText = exports.fetchWithTimeout = exports.safeResolveTarget = exports.baseUrl = exports.USER_AGENT = exports.FETCH_TIMEOUT_MS = exports.CANARY_ICON_PATH = exports.MANIFEST_PATH = exports.SKILL_NAME = exports.DEFAULT_BASE_RAW_URL = void 0;
+exports.withFatalReturn = exports.stripFrontmatter = exports.parseFrontmatter = exports.fetchManifest = exports.headOk = exports.fetchText = exports.fetchWithTimeout = exports.safeResolveTarget = exports.baseUrl = exports.USER_AGENT = exports.FETCH_TIMEOUT_MS = exports.CANARY_ICON_PATH = exports.MANIFEST_PATH = exports.SKILL_NAME = exports.DEFAULT_BASE_RAW_URL = void 0;
 const fs = __importStar(require("node:fs/promises"));
 const path = __importStar(require("node:path"));
 const package_json_1 = __importDefault(require("../../package.json"));
@@ -258,6 +258,20 @@ function parseFrontmatter(md) {
     return out;
 }
 exports.parseFrontmatter = parseFrontmatter;
+/**
+ * Strip the leading `---\n...\n---\n` YAML frontmatter block from a markdown
+ * string. Returns the body unchanged if no frontmatter is detected.
+ *
+ * Used by adapters that re-render the upstream SKILL.md for a different host
+ * (e.g. Cursor's `.mdc` rule files, which carry their own frontmatter shape
+ * and embed the SKILL.md body without its original frontmatter).
+ */
+function stripFrontmatter(md) {
+    const text = md.replace(/^/, "");
+    const match = text.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
+    return match ? text.slice(match[0].length) : text;
+}
+exports.stripFrontmatter = stripFrontmatter;
 async function withFatalReturn(fn) {
     try {
         return await fn();

package/dist/adapters/cursor.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cursorAdapter = exports.parseFrontmatter = exports.fetchWithTimeout = void 0;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const _shared_1 = require("./_shared");
+Object.defineProperty(exports, "fetchWithTimeout", { enumerable: true, get: function () { return _shared_1.fetchWithTimeout; } });
+Object.defineProperty(exports, "parseFrontmatter", { enumerable: true, get: function () { return _shared_1.parseFrontmatter; } });
+const RULE_BASENAME = "azure-arch-skill.mdc";
+const RULE_DESCRIPTION = "Use this rule when drawing Microsoft Azure or Microsoft Fabric architecture diagrams using PlantUML. " +
+    "Triggers on \"draw Azure architecture\", \"create deployment diagram\", \"Lakehouse + Notebook + Warehouse diagram\", " +
+    "\"vẽ Azure\", \"PlantUML diagram for [project]\".";
+function defaultTarget() {
+    return path.join(process.cwd(), ".cursor", "rules");
+}
+const CWD_DISPLAY = "<cwd>/.cursor/rules";
+async function resolveTarget(target) {
+    return (0, _shared_1.safeResolveTarget)(target, process.cwd(), CWD_DISPLAY);
+}
+/**
+ * Provenance marker emitted into the rendered .mdc body so `list` / `uninstall`
+ * can recognise our rule without re-fetching upstream. The marker is the first
+ * non-frontmatter line after the closing `---`.
+ */
+function provenanceMarker(version, requiresIcons) {
+    return `<!-- ${_shared_1.SKILL_NAME} v${version} (requires_icons: ${requiresIcons}) -->`;
+}
+const PROVENANCE_RE = new RegExp(`<!--\\s*${_shared_1.SKILL_NAME}\\s+v([^\\s]+)\\s+\\(requires_icons:\\s*([^)]+)\\)\\s*-->`);
+function renderRule(skillBody, version, requiresIcons) {
+    return [
+        "---",
+        `description: ${RULE_DESCRIPTION}`,
+        "alwaysApply: false",
+        "---",
+        "",
+        provenanceMarker(version, requiresIcons),
+        "",
+        skillBody.trimStart(),
+    ].join("\n");
+}
+async function isOurRuleFile(file) {
+    try {
+        const body = await fs.readFile(file, "utf8");
+        const match = body.match(PROVENANCE_RE);
+        if (!match)
+            return { ours: false };
+        return { ours: true, version: match[1] };
+    }
+    catch {
+        return { ours: false };
+    }
+}
+async function install(opts) {
+    return (0, _shared_1.withFatalReturn)(async () => {
+        const targetDir = await resolveTarget(opts.target ?? defaultTarget());
+        const base = (0, _shared_1.baseUrl)();
+        const ruleFile = path.join(targetDir, RULE_BASENAME);
+        // Fetch manifest first so we know which file is the canonical SKILL.md
+        // and what version / requires_icons to embed in the provenance marker.
+        const manifest = await (0, _shared_1.fetchManifest)(base);
+        if (manifest.name !== _shared_1.SKILL_NAME) {
+            throw new Error(`manifest name mismatch: expected '${_shared_1.SKILL_NAME}', got '${manifest.name}'. CLI and bundle are out of sync.`);
+        }
+        const skillUrl = `${base}/${manifest.files[0].src}`;
+        const skillMd = await (0, _shared_1.fetchText)(skillUrl);
+        const fm = (0, _shared_1.parseFrontmatter)(skillMd);
+        if (!fm.requires_icons) {
+            throw new Error("SKILL.md missing requires_icons frontmatter");
+        }
+        const canaryUrl = `${base}/${_shared_1.CANARY_ICON_PATH}`;
+        const reachable = await (0, _shared_1.headOk)(canaryUrl);
+        if (!reachable) {
+            throw new Error(`icon-set unreachable - HEAD ${canaryUrl} failed (skill declares requires_icons=${fm.requires_icons}; this release verifies reachability only, strict semver match planned)`);
+        }
+        const exists = await fs.stat(ruleFile).then(() => true).catch(() => false);
+        if (exists && !opts.overwrite) {
+            const probe = await isOurRuleFile(ruleFile);
+            throw new Error(probe.ours
+                ? `${ruleFile} already contains an install. Run 'azure-arch-skill update --agent=cursor' to refresh.`
+                : `${ruleFile} exists but is not one of ours (no '${_shared_1.SKILL_NAME}' provenance marker). Move/rename the file or remove it manually if intentional.`);
+        }
+        await fs.mkdir(targetDir, { recursive: true });
+        const body = (0, _shared_1.stripFrontmatter)(skillMd);
+        const rendered = renderRule(body, fm.version ?? manifest.version, fm.requires_icons);
+        await fs.writeFile(ruleFile, rendered, "utf8");
+        process.stdout.write(`installed ${_shared_1.SKILL_NAME} to ${ruleFile}\n`);
+        return 0;
+    });
+}
+async function uninstall(opts) {
+    return (0, _shared_1.withFatalReturn)(async () => {
+        const targetDir = await resolveTarget(opts.target ?? defaultTarget());
+        const ruleFile = path.join(targetDir, RULE_BASENAME);
+        const exists = await fs.stat(ruleFile).then(() => true).catch(() => false);
+        if (!exists) {
+            process.stdout.write(`(nothing to uninstall at ${ruleFile})\n`);
+            return 0;
+        }
+        const probe = await isOurRuleFile(ruleFile);
+        if (!probe.ours) {
+            throw new Error(`refusing to remove ${ruleFile} - missing '${_shared_1.SKILL_NAME}' provenance marker. Move/rename the file or remove it manually if intentional.`);
+        }
+        await fs.unlink(ruleFile);
+        process.stdout.write(`uninstalled ${_shared_1.SKILL_NAME} from ${ruleFile}\n`);
+        return 0;
+    });
+}
+async function update(opts) {
+    return install({ ...opts, overwrite: true });
+}
+async function list(opts) {
+    return (0, _shared_1.withFatalReturn)(async () => {
+        const targetDir = await resolveTarget(opts.target ?? defaultTarget());
+        const ruleFile = path.join(targetDir, RULE_BASENAME);
+        const probe = await isOurRuleFile(ruleFile);
+        if (!probe.ours) {
+            process.stdout.write("(no skills installed)\n");
+            return 0;
+        }
+        process.stdout.write(`${_shared_1.SKILL_NAME}\t${probe.version ?? "?"}\n`);
+        return 0;
+    });
+}
+exports.cursorAdapter = { install, uninstall, update, list };

package/dist/adapters/registry.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_AGENTS = exports.ADAPTERS = void 0;
+const claude_code_1 = require("./claude-code");
+const codex_1 = require("./codex");
+const cursor_1 = require("./cursor");
+// Single source of truth for the supported-agent set. Add a new adapter by
+// importing it here and adding one entry below; both `src/index.ts` (CLI
+// dispatch + --agent help text) and `adapters-roundtrip.test.ts` (test loop)
+// read from this map directly.
+exports.ADAPTERS = {
+    "claude-code": claude_code_1.claudeCodeAdapter,
+    "codex": codex_1.codexAdapter,
+    "cursor": cursor_1.cursorAdapter,
+};
+exports.SUPPORTED_AGENTS = Object.keys(exports.ADAPTERS);

package/dist/index.js

@@ -6,18 +6,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const package_json_1 = __importDefault(require("../package.json"));
-const claude_code_1 = require("./adapters/claude-code");
-const codex_1 = require("./adapters/codex");
-const ADAPTERS = {
-    "claude-code": claude_code_1.claudeCodeAdapter,
-    "codex": codex_1.codexAdapter,
-};
-const SUPPORTED_AGENTS = Object.keys(ADAPTERS);
+const registry_1 = require("./adapters/registry");
 function pickAdapter(agent) {
-    if (!(agent in ADAPTERS)) {
-        throw new Error(`unknown agent: ${agent} (supported: ${SUPPORTED_AGENTS.join(", ")})`);
+    if (!(agent in registry_1.ADAPTERS)) {
+        throw new Error(`unknown agent: ${agent} (supported: ${registry_1.SUPPORTED_AGENTS.join(", ")})`);
     }
-    return ADAPTERS[agent];
+    return registry_1.ADAPTERS[agent];
 }
 const program = new commander_1.Command()
     .name("azure-arch-skill")
@@ -27,7 +21,7 @@ function defineSubcommand(name, description) {
     program
         .command(name)
         .description(description)
-        .requiredOption("--agent <name>", `target AI agent (${SUPPORTED_AGENTS.join("|")})`)
+        .requiredOption("--agent <name>", `target AI agent (${registry_1.SUPPORTED_AGENTS.join("|")})`)
         .option("--target <dir>", "override target directory (validation use)")
         .action(async (opts) => {
         // Set process.exitCode so any pending async cleanup (file handles, the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanv89/azure-arch-skill",
-  "version": "0.4.0",
+  "version": "0.5.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"