@cashfreepayments/agent-skills 0.1.2 → 0.1.4

package/README.md

@@ -5,7 +5,7 @@ Add Cashfree Payments skills to your AI coding assistant projects — everything
 ## Quick Start
 
 ```bash
-npx @cashfreepayments/agent-skills@latest add skills
+npx @cashfreepayments/agent-skills add skills
 ```
 
 ![Cashfree Payments](https://github.com/user-attachments/assets/a0a36020-7eee-4fda-9d6b-4002ea4991c6)
@@ -16,20 +16,41 @@ This will prompt you to select which AI coding assistants to configure.
 
 ### Interactive Mode
 ```bash
-npx @cashfreepayments/agent-skills@latest add skills
+npx @cashfreepayments/agent-skills add skills
 ```
 You'll be prompted to select which AI assistants to configure.
 
 ### Specify Frameworks
 ```bash
-npx @cashfreepayments/agent-skills@latest add skills --frameworks cursor,claude-code,gemini-cli
+npx @cashfreepayments/agent-skills add skills --frameworks cursor,claude-code,gemini-cli
 ```
 
 ### Custom Project Path
 ```bash
-npx @cashfreepayments/agent-skills@latest add skills --path /path/to/project
+npx @cashfreepayments/agent-skills add skills --path /path/to/project
 ```
 
+### Updating Existing Skills
+
+If you've already installed skills in a project and a newer version of the package is published, you have two options:
+
+**Option 1 — Re-run `add skills`.** It auto-detects the installed version, compares against the latest published version on npm, and updates in place if outdated. No prompt.
+```bash
+npx @cashfreepayments/agent-skills add skills
+```
+
+**Option 2 — Use the dedicated `update` command.** Force-rewrites every skill file with the latest templates. Auto-detects which frameworks you have installed in the project; no need to re-select.
+```bash
+npx @cashfreepayments/agent-skills update
+```
+
+Target specific frameworks:
+```bash
+npx @cashfreepayments/agent-skills update --frameworks cursor,claude-code
+```
+
+Each skill file embeds its version in the YAML frontmatter (`cashfree-skills-version: …`), so the CLI can tell exactly what's installed and what needs refreshing.
+
 ## What Gets Created
 
 A single command creates all skill files + a manifest for each selected framework.

package/dist/cli-ui.d.ts

@@ -0,0 +1,4 @@
+export declare function printBanner(): void;
+export declare function printInstallSuccess(): void;
+export declare function printHelp(): void;
+//# sourceMappingURL=cli-ui.d.ts.map

package/dist/cli-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-ui.d.ts","sourceRoot":"","sources":["../src/cli-ui.ts"],"names":[],"mappings":"AAoBA,wBAAgB,WAAW,IAAI,IAAI,CAUlC;AAiCD,wBAAgB,mBAAmB,IAAI,IAAI,CAe1C;AAwCD,wBAAgB,SAAS,IAAI,IAAI,CA0BhC"}

package/dist/cli-ui.js

@@ -0,0 +1,124 @@
+import chalk from "chalk";
+const BANNER_TOP_LINES = [
+    "   ██████╗ █████╗ ███████╗██╗  ██╗███████╗██████╗ ███████╗███████╗",
+    "  ██╔════╝██╔══██╗██╔════╝██║  ██║██╔════╝██╔══██╗██╔════╝██╔════╝",
+    "  ██║     ███████║███████╗███████║█████╗  ██████╔╝█████╗  █████╗  ",
+    "  ██║     ██╔══██║╚════██║██╔══██║██╔══╝  ██╔══██╗██╔══╝  ██╔══╝  ",
+    "  ╚██████╗██║  ██║███████║██║  ██║██║     ██║  ██║███████╗███████╗",
+    "   ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝  ╚═╝╚══════╝╚══════╝",
+];
+const BANNER_BOTTOM_LINES = [
+    "  ██████╗  █████╗ ██╗   ██╗███╗   ███╗███████╗███╗   ██╗████████╗███████╗",
+    "  ██╔══██╗██╔══██╗╚██╗ ██╔╝████╗ ████║██╔════╝████╗  ██║╚══██╔══╝██╔════╝",
+    "  ██████╔╝███████║ ╚████╔╝ ██╔████╔██║█████╗  ██╔██╗ ██║   ██║   ███████╗",
+    "  ██╔═══╝ ██╔══██║  ╚██╔╝  ██║╚██╔╝██║██╔══╝  ██║╚██╗██║   ██║   ╚════██║",
+    "  ██║     ██║  ██║   ██║   ██║ ╚═╝ ██║███████╗██║ ╚████║   ██║   ███████║",
+    "  ╚═╝     ╚═╝  ╚═╝   ╚═╝   ╚═╝     ╚═╝╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝",
+];
+export function printBanner() {
+    console.log("\n");
+    for (const line of BANNER_TOP_LINES)
+        console.log(chalk.bold.hex("#10b981")(line));
+    for (const line of BANNER_BOTTOM_LINES)
+        console.log(chalk.bold.hex("#f59e0b")(line));
+    console.log("\n");
+    console.log(chalk.bold.cyan("  🎯 Agent Skills Setup - Add Cashfree Payments Integration Knowledge to AI Assistants\n"));
+}
+const INSTALLED_TREE_LINES = [
+    "  cashfree-skills/",
+    "  ├── getting-started/SKILL.md",
+    "  ├── eligible-payment-modes/SKILL.md",
+    "  ├── pg/",
+    "  │   ├── SKILL.md (overview)",
+    "  │   ├── apis/SKILL.md + references/SKILL.md",
+    "  │   ├── backend-sdks/SKILL.md + references/SKILL.md",
+    "  │   ├── mobile-sdks/SKILL.md + references/SKILL.md",
+    "  │   ├── webhooks/SKILL.md + references/REFERENCE.md",
+    "  │   ├── go-live/SKILL.md + references/REFERENCE.md",
+    "  │   ├── refunds/SKILL.md + references/REFERENCE.md",
+    "  │   ├── disputes/SKILL.md + references/REFERENCE.md",
+    "  │   ├── payment-links/SKILL.md + references/REFERENCE.md",
+    "  │   ├── token-vault/SKILL.md + references/REFERENCE.md",
+    "  │   ├── web-sdk/SKILL.md + references/REFERENCE.md",
+    "  │   ├── easy-split/SKILL.md + references/REFERENCE.md",
+    "  │   └── offers/SKILL.md + references/REFERENCE.md",
+    "  ├── secure-id/SKILL.md + references/REFERENCE.md",
+    "  ├── subscriptions/SKILL.md + references/REFERENCE.md",
+    "  ├── cross-border/SKILL.md + references/REFERENCE.md",
+    "  ├── payouts/SKILL.md + references/REFERENCE.md",
+    "  ├── settlements-and-reconciliation/SKILL.md + references/REFERENCE.md",
+    "  ├── auto-collect/SKILL.md + references/REFERENCE.md",
+    "  ├── migrate-from-razorpay/SKILL.md + references/REFERENCE.md",
+    "  ├── migrate-from-juspay/SKILL.md + references/REFERENCE.md",
+    "  ├── progress-and-skill-feedback/SKILL.md",
+    "  ├── validation-and-testing/SKILL.md",
+    "  └── common-mistakes/SKILL.md",
+];
+export function printInstallSuccess() {
+    console.log(chalk.bold.green("\n✅ Cashfree Payments skill configuration complete!\n"));
+    console.log(chalk.dim("Skills installed:"));
+    for (const line of INSTALLED_TREE_LINES)
+        console.log(chalk.dim(line));
+    console.log(chalk.dim("\nA manifest file has been created/updated to help your AI assistant discover these skills.\n"));
+    console.log(chalk.bold.cyan("👉 Try this in your AI assistant:"));
+    console.log(chalk.white('   "Integrate Cashfree Payments into my project"\n'));
+    console.log(chalk.hex("#fbbf24")("💡 ") +
+        chalk.bold.hex("#fbbf24")("More example prompts & next steps: ") +
+        chalk.bold.hex("#10b981")("npx @cashfreepayments/agent-skills help\n"));
+}
+const HELP_SECTIONS = [
+    {
+        title: "Getting started",
+        prompts: [
+            "Integrate Cashfree Payments into my project",
+            "What payment modes are enabled for my merchant account?",
+        ],
+    },
+    {
+        title: "Backend & SDK integration",
+        prompts: [
+            "Integrate Cashfree with my Express app using the Node SDK",
+            "Add Cashfree to my Django backend",
+        ],
+    },
+    {
+        title: "Frontend & mobile",
+        prompts: [
+            "Add Cashfree checkout to my Next.js app with the Web SDK",
+            "Integrate Cashfree into my Flutter app",
+        ],
+    },
+    {
+        title: "Migration & ops",
+        prompts: [
+            "Migrate my Express app from Razorpay to Cashfree",
+            "Replace Juspay Hypercheckout with Cashfree in my app",
+        ],
+    },
+    {
+        title: "Debugging",
+        prompts: [
+            "My webhook isn't firing — help me debug",
+            "I'm done coding — what should I test before going live?",
+        ],
+    },
+];
+export function printHelp() {
+    console.log("\n" + chalk.bold.hex("#10b981")("Cashfree Agent Skills — what to do next") + "\n");
+    console.log(chalk.dim("Skills are installed in your project. Open your AI coding assistant\n" +
+        "(Claude Code, Cursor, Copilot, Gemini CLI, etc.) and paste any of the\n" +
+        "prompts below to put them to work.\n"));
+    for (const { title, prompts } of HELP_SECTIONS) {
+        console.log(chalk.bold.hex("#f59e0b")(`▸ ${title}`));
+        for (const p of prompts)
+            console.log(chalk.white(`  • "${p}"`));
+        console.log("");
+    }
+    console.log(chalk.hex("#fbbf24")("💡 ") +
+        chalk.bold.hex("#fbbf24")("Tip: ") +
+        chalk.hex("#10b981")("skills are read on demand by your AI — ") +
+        chalk.hex("#f59e0b")("just ask in natural language.\n"));
+    console.log(chalk.dim("Re-run installation any time: ") +
+        chalk.bold("npx @cashfreepayments/agent-skills@latest add skills\n"));
+}
+//# sourceMappingURL=cli-ui.js.map

package/dist/cli-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-ui.js","sourceRoot":"","sources":["../src/cli-ui.ts"],"names":[],"mappings":"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"}

package/dist/cli-utils.d.ts

@@ -0,0 +1,11 @@
+import { type Framework } from "./config.js";
+export declare const VALID_ADD_TYPES: readonly ["skills"];
+/**
+ * Returns the closest match from `candidates` within `maxDistance` Levenshtein
+ * edits, or null if no candidate is close enough. Used for "did you mean"
+ * hints on mistyped subcommand arguments.
+ */
+export declare function findSimilar(input: string, candidates: readonly string[], maxDistance?: number): string | null;
+export declare function collectOptionValues(value: string, previous: string[]): string[];
+export declare function getFrameworkName(framework: Framework): string;
+//# sourceMappingURL=cli-utils.d.ts.map

package/dist/cli-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-utils.d.ts","sourceRoot":"","sources":["../src/cli-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,eAAe,qBAAsB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,WAAW,CACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,WAAW,SAAI,GAChB,MAAM,GAAG,IAAI,CAyBf;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAG/E;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAG7D"}

package/dist/cli-utils.js

@@ -0,0 +1,46 @@
+import { FRAMEWORKS } from "./config.js";
+export const VALID_ADD_TYPES = ["skills"];
+/**
+ * Returns the closest match from `candidates` within `maxDistance` Levenshtein
+ * edits, or null if no candidate is close enough. Used for "did you mean"
+ * hints on mistyped subcommand arguments.
+ */
+export function findSimilar(input, candidates, maxDistance = 2) {
+    const distance = (a, b) => {
+        const m = a.length;
+        const n = b.length;
+        const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+        for (let i = 0; i <= m; i++)
+            dp[i][0] = i;
+        for (let j = 0; j <= n; j++)
+            dp[0][j] = j;
+        for (let i = 1; i <= m; i++) {
+            for (let j = 1; j <= n; j++) {
+                if (a[i - 1] === b[j - 1])
+                    dp[i][j] = dp[i - 1][j - 1];
+                else
+                    dp[i][j] = 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+            }
+        }
+        return dp[m][n];
+    };
+    let best = null;
+    let bestDist = Infinity;
+    for (const c of candidates) {
+        const d = distance(input.toLowerCase(), c.toLowerCase());
+        if (d < bestDist) {
+            bestDist = d;
+            best = c;
+        }
+    }
+    return bestDist <= maxDistance ? best : null;
+}
+export function collectOptionValues(value, previous) {
+    previous.push(value);
+    return previous;
+}
+export function getFrameworkName(framework) {
+    const found = FRAMEWORKS.find((f) => f.value === framework);
+    return found?.name || framework;
+}
+//# sourceMappingURL=cli-utils.js.map

package/dist/cli-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-utils.js","sourceRoot":"","sources":["../src/cli-utils.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;EASb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAY9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAA;CAAE,CAYpG"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;EASb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAe9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAA;CAAE,CAepG"}

package/dist/config.js

@@ -25,7 +25,10 @@ export function getSkillsBasePath(framework) {
         case "gemini-cli": return ".gemini/skills/cashfree-skills";
         case "codex": return ".agents/skills/cashfree-skills";
         case "antigravity": return ".agent/skills/cashfree-skills";
-        default: return ".agent/skills/cashfree-skills";
+        default: {
+            const _exhaustive = framework;
+            throw new Error(`Unknown framework: ${_exhaustive}`);
+        }
     }
 }
 /**
@@ -42,7 +45,10 @@ export function getManifestConfig(framework) {
         case "gemini-cli": return { path: "GEMINI.md", format: "markdown" };
         case "codex": return { path: "AGENTS.md", format: "markdown" };
         case "antigravity": return { path: "AGENTS.md", format: "markdown" };
-        default: return { path: "AGENTS.md", format: "markdown" };
+        default: {
+            const _exhaustive = framework;
+            throw new Error(`Unknown framework: ${_exhaustive}`);
+        }
     }
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;IACnC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;IAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IACjC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;IACvC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,gBAAgB,EAAE;IACpD,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC3C,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;IAC7C,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,aAAa,EAAE;CAC9C,CAAC;AAIX;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IAClD,QAAQ,SAAS,EAAE,CAAC;QAChB,KAAK,aAAa,CAAC,CAAK,OAAO,gCAAgC,CAAC;QAChE,KAAK,QAAQ,CAAC,CAAU,OAAO,yBAAyB,CAAC;QACzD,KAAK,UAAU,CAAC,CAAQ,OAAO,kCAAkC,CAAC;QAClE,KAAK,gBAAgB,CAAC,CAAE,OAAO,gCAAgC,CAAC;QAChE,KAAK,aAAa,CAAC,CAAK,OAAO,gCAAgC,CAAC;QAChE,KAAK,YAAY,CAAC,CAAM,OAAO,gCAAgC,CAAC;QAChE,KAAK,OAAO,CAAC,CAAW,OAAO,gCAAgC,CAAC;QAChE,KAAK,aAAa,CAAC,CAAK,OAAO,+BAA+B,CAAC;QAC/D,OAAO,CAAC,CAAgB,OAAO,+BAA+B,CAAC;IACnE,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IAClD,QAAQ,SAAS,EAAE,CAAC;QAChB,KAAK,aAAa,CAAC,CAAK,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,KAAK,QAAQ,CAAC,CAAU,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACrF,KAAK,UAAU,CAAC,CAAQ,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,KAAK,gBAAgB,CAAC,CAAE,OAAO,EAAE,IAAI,EAAE,iCAAiC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC/F,KAAK,aAAa,CAAC,CAAK,OAAO,EAAE,IAAI,EAAE,iCAAiC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC/F,KAAK,YAAY,CAAC,CAAM,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,KAAK,OAAO,CAAC,CAAW,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,KAAK,aAAa,CAAC,CAAK,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,OAAO,CAAC,CAAgB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC7E,CAAC;AACL,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;IACnC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;IAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IACjC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;IACvC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,gBAAgB,EAAE;IACpD,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC3C,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;IAC7C,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,aAAa,EAAE;CAC9C,CAAC;AAIX;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IAClD,QAAQ,SAAS,EAAE,CAAC;QAChB,KAAK,aAAa,CAAC,CAAK,OAAO,gCAAgC,CAAC;QAChE,KAAK,QAAQ,CAAC,CAAU,OAAO,yBAAyB,CAAC;QACzD,KAAK,UAAU,CAAC,CAAQ,OAAO,kCAAkC,CAAC;QAClE,KAAK,gBAAgB,CAAC,CAAE,OAAO,gCAAgC,CAAC;QAChE,KAAK,aAAa,CAAC,CAAK,OAAO,gCAAgC,CAAC;QAChE,KAAK,YAAY,CAAC,CAAM,OAAO,gCAAgC,CAAC;QAChE,KAAK,OAAO,CAAC,CAAW,OAAO,gCAAgC,CAAC;QAChE,KAAK,aAAa,CAAC,CAAK,OAAO,+BAA+B,CAAC;QAC/D,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,WAAW,GAAU,SAAS,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IAClD,QAAQ,SAAS,EAAE,CAAC;QAChB,KAAK,aAAa,CAAC,CAAK,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,KAAK,QAAQ,CAAC,CAAU,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACrF,KAAK,UAAU,CAAC,CAAQ,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,KAAK,gBAAgB,CAAC,CAAE,OAAO,EAAE,IAAI,EAAE,iCAAiC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC/F,KAAK,aAAa,CAAC,CAAK,OAAO,EAAE,IAAI,EAAE,iCAAiC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC/F,KAAK,YAAY,CAAC,CAAM,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,KAAK,OAAO,CAAC,CAAW,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,KAAK,aAAa,CAAC,CAAK,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,WAAW,GAAU,SAAS,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/generators/utils.d.ts

@@ -11,11 +11,42 @@ export declare function writeTextFile(filePath: string, content: string, overwri
 export declare function logCreated(file: string): void;
 export declare function logUpdated(file: string): void;
 export declare function logSkipped(file: string): void;
+/**
+ * Fetches the latest published version from the npm registry.
+ * Returns null on network/parse errors or non-2xx responses so callers
+ * can gracefully fall back to the locally bundled version.
+ */
+export declare function fetchLatestPublishedVersion(): Promise<string | null>;
+/**
+ * Compares two semver-ish strings. Returns:
+ *   -1 if a < b, 0 if equal, 1 if a > b.
+ * Falls back to string compare for non-numeric segments.
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Injects (or updates) a `cashfree-skills-version: <v>` line inside the
+ * leading YAML frontmatter of a skill template. If the template lacks
+ * frontmatter, the version is prepended as one.
+ */
+export declare function injectVersionMarker(content: string, version: string): string;
+/**
+ * Reads the embedded skill version from a skill file's frontmatter.
+ * Returns null if the file doesn't exist or has no version marker.
+ */
+export declare function readInstalledSkillVersion(filePath: string): Promise<string | null>;
 /**
  * Creates a skill file at {projectPath}/{skillsBasePath}/{skillDir}/{fileName}
- * fileName defaults to 'SKILL.md'
+ * fileName defaults to 'SKILL.md'. Embeds the CLI version as a marker so
+ * subsequent runs can detect outdated installs.
+ */
+export declare function createSkillFile(projectPath: string, skillsBasePath: string, skillDir: string, getTemplate: () => string, fileName?: string, version?: string, overwrite?: boolean): Promise<void>;
+/**
+ * Ensures the given path is listed in the project's .gitignore.
+ * - Creates .gitignore if it doesn't exist.
+ * - Appends the entry if missing; preserves all existing content otherwise.
+ * - Idempotent: skips if the exact entry is already present.
  */
-export declare function createSkillFile(projectPath: string, skillsBasePath: string, skillDir: string, getTemplate: () => string, fileName?: string): Promise<void>;
+export declare function ensureGitignoreEntry(projectPath: string, entry: string): Promise<void>;
 /**
  * Creates or appends the Cashfree manifest to the framework's manifest file.
  * If the file already contains Cashfree config, it skips.

package/dist/generators/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,UAAQ,GAClB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACjC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,MAAM,EACzB,QAAQ,SAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,UAAQ,GAClB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAMD;;;;GAIG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAY1E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAc5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW5E;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKxF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACjC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,MAAM,EACzB,QAAQ,SAAa,EACrB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,UAAQ,GAClB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACtC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/generators/utils.js

@@ -23,23 +23,130 @@ export function logUpdated(file) {
 export function logSkipped(file) {
     console.log(chalk.dim(`  Skipped ${file} (already exists)`));
 }
+const VERSION_KEY = 'cashfree-skills-version';
+const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@cashfreepayments/agent-skills/latest';
+/**
+ * Fetches the latest published version from the npm registry.
+ * Returns null on network/parse errors or non-2xx responses so callers
+ * can gracefully fall back to the locally bundled version.
+ */
+export async function fetchLatestPublishedVersion() {
+    try {
+        const res = await fetch(NPM_REGISTRY_URL, {
+            signal: AbortSignal.timeout(2500),
+            headers: { accept: 'application/json' },
+        });
+        if (!res.ok)
+            return null;
+        const json = (await res.json());
+        return json.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Compares two semver-ish strings. Returns:
+ *   -1 if a < b, 0 if equal, 1 if a > b.
+ * Falls back to string compare for non-numeric segments.
+ */
+export function compareVersions(a, b) {
+    const pa = a.split('.').map((s) => parseInt(s, 10));
+    const pb = b.split('.').map((s) => parseInt(s, 10));
+    const len = Math.max(pa.length, pb.length);
+    for (let i = 0; i < len; i++) {
+        const x = pa[i] ?? 0;
+        const y = pb[i] ?? 0;
+        if (Number.isNaN(x) || Number.isNaN(y)) {
+            if (a === b)
+                return 0;
+            return a < b ? -1 : 1;
+        }
+        if (x !== y)
+            return x < y ? -1 : 1;
+    }
+    return 0;
+}
+/**
+ * Injects (or updates) a `cashfree-skills-version: <v>` line inside the
+ * leading YAML frontmatter of a skill template. If the template lacks
+ * frontmatter, the version is prepended as one.
+ */
+export function injectVersionMarker(content, version) {
+    const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!fmMatch) {
+        return `---\n${VERSION_KEY}: ${version}\n---\n\n${content}`;
+    }
+    const fm = fmMatch[1];
+    const re = new RegExp(`^${VERSION_KEY}:.*$`, 'm');
+    const updatedFm = re.test(fm)
+        ? fm.replace(re, `${VERSION_KEY}: ${version}`)
+        : `${fm}\n${VERSION_KEY}: ${version}`;
+    return content.replace(fmMatch[0], `---\n${updatedFm}\n---`);
+}
+/**
+ * Reads the embedded skill version from a skill file's frontmatter.
+ * Returns null if the file doesn't exist or has no version marker.
+ */
+export async function readInstalledSkillVersion(filePath) {
+    if (!(await fs.pathExists(filePath)))
+        return null;
+    const raw = await fs.readFile(filePath, 'utf8');
+    const m = raw.match(new RegExp(`^${VERSION_KEY}:\\s*(\\S+)`, 'm'));
+    return m ? m[1] : null;
+}
 /**
  * Creates a skill file at {projectPath}/{skillsBasePath}/{skillDir}/{fileName}
- * fileName defaults to 'SKILL.md'
+ * fileName defaults to 'SKILL.md'. Embeds the CLI version as a marker so
+ * subsequent runs can detect outdated installs.
  */
-export async function createSkillFile(projectPath, skillsBasePath, skillDir, getTemplate, fileName = 'SKILL.md') {
+export async function createSkillFile(projectPath, skillsBasePath, skillDir, getTemplate, fileName = 'SKILL.md', version, overwrite = false) {
     const path = await import('path');
     const skillPath = path.join(projectPath, skillsBasePath, skillDir, fileName);
     const relativePath = path.join(skillsBasePath, skillDir, fileName);
     await ensureDir(path.dirname(skillPath));
-    const created = await writeTextFile(skillPath, getTemplate());
+    const rendered = version ? injectVersionMarker(getTemplate(), version) : getTemplate();
+    const existed = await fs.pathExists(skillPath);
+    const created = await writeTextFile(skillPath, rendered, overwrite);
     if (created) {
         logCreated(relativePath);
     }
+    else if (existed && overwrite) {
+        logUpdated(relativePath);
+    }
     else {
         logSkipped(relativePath);
     }
 }
+/**
+ * Ensures the given path is listed in the project's .gitignore.
+ * - Creates .gitignore if it doesn't exist.
+ * - Appends the entry if missing; preserves all existing content otherwise.
+ * - Idempotent: skips if the exact entry is already present.
+ */
+export async function ensureGitignoreEntry(projectPath, entry) {
+    const path = await import('path');
+    const gitignorePath = path.join(projectPath, '.gitignore');
+    const normalized = entry.replace(/^\/+/, '').replace(/\/+$/, '') + '/';
+    const exists = await fs.pathExists(gitignorePath);
+    if (!exists) {
+        await fs.writeFile(gitignorePath, normalized + '\n');
+        return;
+    }
+    const existing = await fs.readFile(gitignorePath, 'utf8');
+    const lines = existing.split(/\r?\n/).map((l) => l.trim());
+    const candidates = new Set([
+        normalized,
+        normalized.replace(/\/$/, ''),
+        '/' + normalized,
+        '/' + normalized.replace(/\/$/, ''),
+    ]);
+    if (lines.some((l) => candidates.has(l))) {
+        return;
+    }
+    const needsLeadingNewline = existing.length > 0 && !existing.endsWith('\n');
+    await fs.appendFile(gitignorePath, (needsLeadingNewline ? '\n' : '') + normalized + '\n');
+}
 /**
  * Creates or appends the Cashfree manifest to the framework's manifest file.
  * If the file already contains Cashfree config, it skips.

package/dist/generators/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"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"}