@cashfreepayments/agent-skills 0.0.4 → 0.0.7

package/README.md

@@ -1,214 +1,216 @@
 # Cashfree Agent Skills CLI
 
-Add Cashfree Payments product-specific skills to your AI coding assistant projects.
+Add Cashfree Payments skills to your AI coding assistant projects — everything in one command.
 
 ## Quick Start
 
 ```bash
-# Add Payment Gateway skills
-npx @cashfreepayments/agent-skills add pg
-
-# Add Secure ID skills
-npx @cashfreepayments/agent-skills add secure-id
-
-# Add Subscriptions skills
-npx @cashfreepayments/agent-skills add subscriptions
-
-# Add Cross Border skills
-npx @cashfreepayments/agent-skills add cross-border
-
-# Add Payouts skills
-npx @cashfreepayments/agent-skills add payouts
+npx @cashfreepayments/agent-skills add skills
 ```
 
-![Cashfree Payments](https://raw.githubusercontent.com/cashfree/agent-skills/refs/heads/main/src/templates/image.png)
+![Cashfree Payments](https://github.com/user-attachments/assets/a0a36020-7eee-4fda-9d6b-4002ea4991c6)
 
-This will prompt you to select which AI coding assistants to configure:
-- **Cursor** - Creates `.cursor/skills/cashfree/<product>.md`
-- **Claude Code** - Creates `.claude/skills/cashfree/<product>.md`
-- **OpenCode** - Creates `.opencode/skills/cashfree/<product>.md`
-- **VS Code Copilot** - Creates `.github/skills/cashfree/<product>.md`
-- **Gemini CLI** - Creates `.gemini/skills/cashfree/<product>.md`
-- **Antigravity** - Creates `.agent/skills/cashfree/<product>.md`
-- **GitHub Copilot CLI** - Creates `.github/skills/cashfree/<product>.md`
-- **OpenAI Codex CLI** - Creates `.codex/skills/cashfree/<product>.md`
+This will prompt you to select which AI coding assistants to configure.
 
-## Products
-
-### Payment Gateway (PG)
-Payment gateway integration, order creation, refunds, payment links, and webhooks.
+## Usage
 
+### Interactive Mode
 ```bash
-npx @cashfreepayments/agent-skills add pg
+npx @cashfreepayments/agent-skills add skills
 ```
+You'll be prompted to select which AI assistants to configure.
 
-### Secure ID
-Bank account verification, penny drop, UPI verification, and settlement reconciliation.
-
+### Specify Frameworks
 ```bash
-npx @cashfreepayments/agent-skills add secure-id
+npx @cashfreepayments/agent-skills add skills --frameworks cursor,claude-code,gemini-cli
 ```
 
-### Subscriptions
-Recurring payments, subscription plans, authorization, and customer management.
-
+### Custom Project Path
 ```bash
-npx @cashfreepayments/agent-skills add subscriptions
+npx @cashfreepayments/agent-skills add skills --path /path/to/project
 ```
 
-### Cross Border
-International payments, currency conversion, and cross-border transactions.
+## What Gets Created
 
-```bash
-npx @cashfreepayments/agent-skills add cross-border
-```
+A single command creates all skill files + a manifest for each selected framework.
+
+### Skills Directory Structure
+
+Each skill is split into two files: **SKILL.md** (core happy path) and **references/REFERENCE.md** (advanced topics, full API reference, additional code examples). The AI reads SKILL.md first and pulls from REFERENCE.md only when deeper detail is needed.
+
+```
+cashfree-skills/
+├── getting-started/
+│   └── SKILL.md                     ← Setup, auth, environment config
+├── eligible-payment-modes/
+│   └── SKILL.md                     ← Check enabled payment modes for a merchant
+├── pg/
+│   ├── SKILL.md                     ← Payment Gateway overview & sub-skill index
+│   ├── apis/
+│   │   ├── SKILL.md                 ← S2S REST API integration (core flow)
+│   │   └── references/REFERENCE.md  ← Full endpoint map, idempotency, edge cases
+│   ├── backend-sdks/
+│   │   ├── SKILL.md                 ← Backend SDK (Node.js, Python, Java, Go)
+│   │   └── references/REFERENCE.md  ← Refunds, settlements, pre-auth, S2S, token vault, .NET TLS fix
+│   ├── mobile-sdks/
+│   │   ├── SKILL.md                 ← Mobile SDKs (Android, iOS, React Native, Flutter, Cordova)
+│   │   └── references/REFERENCE.md  ← Per-platform payment status verification, all SDK options
+│   ├── webhooks/
+│   │   ├── SKILL.md                 ← Webhook setup, signature verification, event bifurcation
+│   │   └── references/REFERENCE.md  ← Full webhook payload schemas for all event types
+│   ├── go-live/
+│   │   ├── SKILL.md                 ← Production checklist & go-live steps
+│   │   └── references/REFERENCE.md  ← Advanced production config & compliance details
+│   ├── refunds/
+│   │   ├── SKILL.md                 ← Refunds lifecycle, INSTANT vs STANDARD, partial/multi-refunds
+│   │   └── references/REFERENCE.md  ← Full schema, eligibility, per-language SDK code, troubleshooting
+│   ├── disputes/
+│   │   ├── SKILL.md                 ← Dispute lifecycle, accept/contest, evidence, SLAs
+│   │   └── references/REFERENCE.md  ← 24 status values, reason codes, evidence limits, per-language code
+│   ├── payment-links/
+│   │   ├── SKILL.md                 ← Hosted payment URLs, partial payments, auto-reminders
+│   │   └── references/REFERENCE.md  ← Full schema, PAYMENT_LINK_EVENT, per-language SDK code
+│   ├── token-vault/
+│   │   ├── SKILL.md                 ← RBI card tokenization, saved cards, CoF, cryptograms
+│   │   └── references/REFERENCE.md  ← Instrument + cryptogram schemas, network behaviour
+│   ├── web-sdk/
+│   │   ├── SKILL.md                 ← Cashfree.js v3 — Drop-in, Elements, SPA wiring
+│   │   └── references/REFERENCE.md  ← Full API, per-framework (React/Vue/Next/Angular), CSP
+│   ├── easy-split/
+│   │   ├── SKILL.md                 ← Marketplace splits, vendor management, static vs dynamic
+│   │   └── references/REFERENCE.md  ← Vendor KYC schema, on-demand transfer, vendor recon
+│   └── offers/
+│       ├── SKILL.md                 ← Bank/BIN offers, discounts, cashback, no-cost EMI recipe
+│       └── references/REFERENCE.md  ← payment_method filter variants, stacking rules, tenure table
+├── secure-id/
+│   ├── SKILL.md                     ← Bank account verification, PAN, GSTIN, DigiLocker
+│   └── references/REFERENCE.md      ← All 39+ API endpoints, webhook payloads, frontend SDKs
+├── subscriptions/
+│   ├── SKILL.md                     ← Recurring payments, plans, mandates, charge lifecycle
+│   └── references/REFERENCE.md      ← Cut-off timelines, mobile SDKs, full webhook payloads
+├── cross-border/
+│   ├── SKILL.md                     ← International payments & currency conversion (core flow)
+│   └── references/REFERENCE.md      ← Verification parameters, order tags, full webhook payloads
+├── payouts/
+│   ├── SKILL.md                     ← Bulk payouts, disbursements, beneficiary management
+│   └── references/REFERENCE.md      ← 2FA RSA setup, batch transfers, V1 APIs, all webhook payloads
+├── settlements-and-reconciliation/
+│   ├── SKILL.md                     ← Settlement cycle, recon APIs, UTR matching, finance ops
+│   └── references/REFERENCE.md      ← Full recon row schema, event types, sample Python reconciler
+├── auto-collect/
+│   ├── SKILL.md                     ← Virtual bank accounts, static UPI VPAs, QR codes
+│   └── references/REFERENCE.md      ← VBA schema, bank rails (Axis/ICICI/Yes), credit webhook
+├── migrate-from-razorpay/
+│   ├── SKILL.md                     ← Razorpay → Cashfree migration: concept map, 7-step cutover, code diffs
+│   └── references/REFERENCE.md      ← Endpoint map, per-language SDK rewrites, webhook payload diff, RazorpayX → Payouts
+├── migrate-from-juspay/
+│   ├── SKILL.md                     ← Juspay → Cashfree migration: orchestrator exit, session/payment_session mapping, webhook/status rewrites
+│   └── references/REFERENCE.md      ← Endpoint map, field diffs, mobile/mandate mapping, orchestrator feature checklist
+├── validation-and-testing/
+│   └── SKILL.md                     ← Post-integration validation & testing
+└── common-mistakes/
+    └── SKILL.md                     ← Debugging guide: signature mismatches, IP whitelisting, mobile SDK errors, rate limits, go-live checklist
+```
+
+### Framework-Specific Locations
+
+| Framework | Skills Location | Manifest File |
+|-----------|----------------|---------------|
+| Claude Code | `.claude/skills/cashfree-skills/` | `CLAUDE.md` (project root) |
+| Cursor | `.cursor/cashfree-skills/` | `.cursor/rules/cashfree.mdc` |
+| OpenCode | `.opencode/skills/cashfree-skills/` | `AGENTS.md` (project root) |
+| VS Code Copilot | `.github/skills/cashfree-skills/` | `.github/copilot-instructions.md` |
+| Gemini CLI | `.gemini/skills/cashfree-skills/` | `GEMINI.md` (project root) |
+| Antigravity | `.agent/skills/cashfree-skills/` | `AGENTS.md` (project root) |
+| GitHub Copilot CLI | `.github/skills/cashfree-skills/` | `.github/copilot-instructions.md` |
+| OpenAI Codex CLI | `.agents/skills/cashfree-skills/` | `AGENTS.md` (project root) |
+
+### Manifest File
+
+The manifest is auto-generated with framework-specific paths. It tells the AI assistant:
+1. Always read `getting-started/SKILL.md` first for new users
+2. A skill map routing user intents to the correct skill file
+3. After any integration code, always read `validation-and-testing/SKILL.md`
+
+For Cursor, the manifest uses `.mdc` format with frontmatter. For all other frameworks, it's plain markdown.
 
-### Payouts
-Bulk payouts, vendor payments, and disbursement management.
+## How AI Assistants Use Skills
 
-```bash
-npx @cashfreepayments/agent-skills add payouts
-```
+1. The AI reads the manifest to understand what skills are available
+2. Based on the user's request, it reads the matching `SKILL.md` (core happy path)
+3. If deeper detail is needed, it reads `references/REFERENCE.md` for that skill
+4. Uses the guidance to provide accurate, product-specific code
+5. After integration, reads the validation skill for testing steps
 
-## Usage
+### Example Interactions
 
-### Interactive Mode
-```bash
-npx @cashfreepayments/agent-skills add pg
 ```
-You'll be prompted to select which AI assistants to configure.
+You: "I want to integrate Cashfree Payments"
+AI: *reads manifest → getting-started/SKILL.md* → Walks through setup and API keys
 
-### Specify Frameworks
-```bash
-npx @cashfreepayments/agent-skills add pg --frameworks cursor,claude-code,gemini-cli
-```
+You: "What payment modes can my merchant use?"
+AI: *reads eligible-payment-modes/SKILL.md* → Shows how to check enabled methods
 
-### Custom Project Path
-```bash
-npx @cashfreepayments/agent-skills add secure-id --path /path/to/project
-```
+You: "Integrate Cashfree with my Express app"
+AI: *reads pg/SKILL.md → pg/backend-sdks/SKILL.md* → Provides Node.js SDK setup
 
-### Add Multiple Products
-```bash
-npx @cashfreepayments/agent-skills add pg
-npx @cashfreepayments/agent-skills add secure-id
-npx @cashfreepayments/agent-skills add subscriptions
-npx @cashfreepayments/agent-skills add cross-border
-npx @cashfreepayments/agent-skills add payouts
-```
+You: "How do I issue a refund or handle pre-authorization?"
+AI: *reads pg/backend-sdks/references/REFERENCE.md* → Full refund/pre-auth API with code
 
-## What Gets Created
+You: "Add Cashfree to my Flutter app"
+AI: *reads pg/SKILL.md → pg/mobile-sdks/SKILL.md* → Provides Flutter SDK integration
 
-For each product and framework combination, a skill file is created:
+You: "How do I verify payment status from the mobile SDK callback?"
+AI: *reads pg/mobile-sdks/references/REFERENCE.md* → Per-platform callback → backend verify flow
 
-### Example: Gemini CLI + Payment Gateway
-```
-.gemini/skills/cashfree/pg.md
-```
+You: "Set up webhooks for payment confirmation"
+AI: *reads pg/webhooks/SKILL.md* → Webhook handler with two-layer bifurcation by type + status
 
-### Example: Cursor + All Products
-```
-.cursor/skills/cashfree/pg.md
-.cursor/skills/cashfree/secure-id.md
-.cursor/skills/cashfree/subscriptions.md
-.cursor/skills/cashfree/cross-border.md
-.cursor/skills/cashfree/payouts.md
-```
+You: "My .NET app fails with SSL/TLS error when calling Cashfree"
+AI: *reads pg/backend-sdks/references/REFERENCE.md* → .NET TLS 1.2 fix with ServicePointManager
 
-## Skill Files
-
-Each skill file contains:
-- Product-specific documentation references
-- Common API patterns and use cases
-- Example queries for the AI assistant
-- Best practices for integration
-
-### Payment Gateway (pg.md)
-Guides your AI assistant on:
-- Creating orders and processing payments
-- Handling refunds and settlements
-- Payment links and QR codes
-- Webhook integration
-
-### secure-id (secure-id.md)
-Guides your AI assistant on:
-- Bank account verification APIs
-- Penny drop verification
-- UPI ID verification
-- Transaction reconciliation
-
-### Subscriptions (subscriptions.md)
-Guides your AI assistant on:
-- Creating subscription plans
-- Managing recurring payments
-- Subscription authorization flows
-- Customer subscription lifecycle
-
-### Cross Border (cross-border.md)
-Guides your AI assistant on:
-- International payment processing
-- Currency conversion and rates
-- Cross-border compliance
-- Multi-currency transactions
-
-### Payouts (payouts.md)
-Guides your AI assistant on:
-- Bulk payout processing
-- Vendor payment management
-- Disbursement APIs
-- Payout status tracking
-
-## Framework-Specific Locations
-
-| Framework | Skill Location |
-|-----------|----------------|
-| Cursor | `.cursor/skills/cashfree/` |
-| Claude Code | `.claude/skills/cashfree/` |
-| OpenCode | `.opencode/skills/cashfree/` |
-| VS Code Copilot | `.github/skills/cashfree/` |
-| Gemini CLI | `.gemini/skills/cashfree/` |
-| Antigravity | `.agent/skills/cashfree/` |
-| GitHub Copilot CLI | `.github/skills/cashfree/` |
-| OpenAI Codex CLI | `.codex/skills/cashfree/` |
+You: "Set up recurring subscriptions"
+AI: *reads subscriptions/SKILL.md → subscriptions/references/REFERENCE.md* → Plan/mandate/charge flow
 
-## How AI Assistants Use Skills
+You: "I'm done coding, what should I test?"
+AI: *reads validation-and-testing/SKILL.md* → Provides validation checklist and test data
 
-When you ask your AI coding assistant about Cashfree integration:
+You: "Build a marketplace where each order splits 85% to vendor, 10% to logistics, 5% commission"
+AI: *reads pg/easy-split/SKILL.md → references/REFERENCE.md* → Creates vendors, adds order_splits on POST /pg/orders, sets refund_splits on refunds
 
-1. The assistant reads the relevant skill file
-2. Uses the guidance to understand your product context
-3. Provides accurate, product-specific code examples
-4. References correct API endpoints and parameters
+You: "Run a 10% HDFC credit card offer + no-cost EMI on 3/6 month tenures"
+AI: *reads pg/offers/SKILL.md → references/REFERENCE.md* → Creates two offers (DISCOUNT + NO_COST_EMI), attaches offer_id at Order Pay, validates redemption_status
 
-### Example Interactions
+You: "Give each dealer a virtual bank account number for monthly invoice collection"
+AI: *reads auto-collect/SKILL.md → references/REFERENCE.md* → POST /pg/vba with remitter lock, subscribes to VBA_CREDIT webhook, reconciles by virtual_account_id
 
-**With PG skill:**
-```
-You: "How do I create a payment order?"
-AI: *reads pg.md skill* → Provides order creation API code
-```
+You: "Send this customer a payment link for ₹5000, allow partial payments, expire in 7 days"
+AI: *reads pg/payment-links/SKILL.md → references/REFERENCE.md* → POST /pg/links with link_partial_payments, wires PAYMENT_LINK_EVENT webhook
 
-**With secure-id skill:**
-```
-You: "Verify a bank account"
-AI: *reads secure-id.md skill* → Provides bank verification API code
-```
+You: "Add save-card / OneClick checkout — RBI-compliant"
+AI: *reads pg/token-vault/SKILL.md → references/REFERENCE.md* → save_instrument consent, INSTRUMENT_ACTIVE_WEBHOOK ingest, pay-with-instrument_id flow
 
-**With Subscriptions skill:**
-```
-You: "Set up a monthly subscription"
-AI: *reads subscriptions.md skill* → Provides subscription plan creation code
-```
+You: "Integrate Cashfree into my Next.js app with a custom-styled card form"
+AI: *reads pg/web-sdk/SKILL.md → references/REFERENCE.md* → Cashfree.js v3 Elements, mount cardNumber/Cvv/Expiry/Holder, backend re-verify
 
-**With Cross Border skill:**
-```
-You: "How do I process an international payment?"
-AI: *reads cross-border.md skill* → Provides cross-border payment API code
-```
+You: "Customer wants a partial refund on order 42 — issue ₹50 back, instant if possible"
+AI: *reads pg/refunds/SKILL.md → pg/refunds/references/REFERENCE.md* → Creates refund via SDK, checks INSTANT eligibility, subscribes to REFUND_STATUS_WEBHOOK
 
-**With Payouts skill:**
-```
-You: "How do I send bulk payouts?"
-AI: *reads payouts.md skill* → Provides bulk payout API code
-```
+You: "We got a chargeback on cf_payment_id 789 — help me respond"
+AI: *reads pg/disputes/SKILL.md → pg/disputes/references/REFERENCE.md* → Fetches dispute, covers preferred_evidence categories, POSTs contest with evidence URLs before respond_by
+
+You: "Match this UTR on our bank statement back to a Cashfree settlement"
+AI: *reads settlements-and-reconciliation/SKILL.md → references/REFERENCE.md* → Calls GET /pg/settlements by UTR, walks recon events, reconciles fees/TDS
+
+You: "Migrate my Express app from Razorpay to Cashfree"
+AI: *reads migrate-from-razorpay/SKILL.md → migrate-from-razorpay/references/REFERENCE.md* → Maps keys/amounts/signatures, rewrites orders/checkout/webhook with Cashfree SDK, plans parallel-run cutover
 
+You: "Replace Juspay Hypercheckout with Cashfree in my app"
+AI: *reads migrate-from-juspay/SKILL.md → migrate-from-juspay/references/REFERENCE.md* → Maps sdk_payload/client_auth_token to payment_session_id, rewrites auth/webhooks/status handling, and calls out lost orchestration features early
+
+You: "My Payout API keeps returning signature mismatch even though IP is whitelisted"
+AI: *reads common-mistakes/SKILL.md* → Multiple account IP mismatch + dynamic IP explanation + fix
+
+You: "Why isn't my webhook firing / payment not being fulfilled?"
+AI: *reads common-mistakes/SKILL.md* → Diagnostic tree narrows to exact cause and fix
+```

package/dist/config.d.ts

@@ -7,6 +7,9 @@ export declare const FRAMEWORKS: readonly [{
 }, {
     readonly name: "Claude Code";
     readonly value: "claude-code";
+}, {
+    readonly name: "Codex";
+    readonly value: "codex";
 }, {
     readonly name: "OpenCode";
     readonly value: "opencode";
@@ -22,29 +25,19 @@ export declare const FRAMEWORKS: readonly [{
 }, {
     readonly name: "GitHub Copilot CLI";
     readonly value: "copilot-cli";
-}, {
-    readonly name: "OpenAI Codex CLI";
-    readonly value: "codex";
 }];
 export type Framework = typeof FRAMEWORKS[number]['value'];
 /**
- * Supported Cashfree products
+ * Returns the path (from project root) to the cashfree-skills directory.
+ * Based on each framework's official skills convention.
  */
-export declare const PRODUCTS: readonly [{
-    readonly name: "Payment Gateway (PG)";
-    readonly value: "pg";
-}, {
-    readonly name: "Secure ID";
-    readonly value: "secure-id";
-}, {
-    readonly name: "Subscriptions";
-    readonly value: "subscriptions";
-}, {
-    readonly name: "Cross Border";
-    readonly value: "cross-border";
-}, {
-    readonly name: "Payouts";
-    readonly value: "payouts";
-}];
-export type Product = typeof PRODUCTS[number]['value'];
+export declare function getSkillsBasePath(framework: Framework): string;
+/**
+ * Returns the manifest file path (from project root) and format.
+ * Based on each framework's official manifest convention.
+ */
+export declare function getManifestConfig(framework: Framework): {
+    path: string;
+    format: 'markdown' | 'mdc';
+};
 //# sourceMappingURL=config.d.ts.map

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;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;EAMX,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC"}
+{"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"}

package/dist/config.js

@@ -4,21 +4,45 @@
 export const FRAMEWORKS = [
     { name: 'Cursor', value: 'cursor' },
     { name: 'Claude Code', value: 'claude-code' },
+    { name: 'Codex', value: 'codex' },
     { name: 'OpenCode', value: 'opencode' },
     { name: 'VS Code Copilot', value: 'vscode-copilot' },
     { name: 'Gemini CLI', value: 'gemini-cli' },
     { name: 'Antigravity', value: 'antigravity' },
-    { name: 'GitHub Copilot CLI', value: 'copilot-cli' },
-    { name: 'OpenAI Codex CLI', value: 'codex' }
+    { name: 'GitHub Copilot CLI', value: 'copilot-cli' }
 ];
 /**
- * Supported Cashfree products
+ * Returns the path (from project root) to the cashfree-skills directory.
+ * Based on each framework's official skills convention.
  */
-export const PRODUCTS = [
-    { name: 'Payment Gateway (PG)', value: 'pg' },
-    { name: 'Secure ID', value: 'secure-id' },
-    { name: 'Subscriptions', value: 'subscriptions' },
-    { name: 'Cross Border', value: 'cross-border' },
-    { name: 'Payouts', value: 'payouts' },
-];
+export function getSkillsBasePath(framework) {
+    switch (framework) {
+        case "claude-code": return ".claude/skills/cashfree-skills";
+        case "cursor": return ".cursor/cashfree-skills";
+        case "opencode": return ".opencode/skills/cashfree-skills";
+        case "vscode-copilot": return ".github/skills/cashfree-skills";
+        case "copilot-cli": return ".github/skills/cashfree-skills";
+        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";
+    }
+}
+/**
+ * Returns the manifest file path (from project root) and format.
+ * Based on each framework's official manifest convention.
+ */
+export function getManifestConfig(framework) {
+    switch (framework) {
+        case "claude-code": return { path: "CLAUDE.md", format: "markdown" };
+        case "cursor": return { path: ".cursor/rules/cashfree.mdc", format: "mdc" };
+        case "opencode": return { path: "AGENTS.md", format: "markdown" };
+        case "vscode-copilot": return { path: ".github/copilot-instructions.md", format: "markdown" };
+        case "copilot-cli": return { path: ".github/copilot-instructions.md", format: "markdown" };
+        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" };
+    }
+}
 //# 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,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;IACpD,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE;CACtC,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,IAAI,EAAE;IAC7C,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;IACzC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE;IACjD,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;IAC/C,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;CAC/B,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,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"}

package/dist/generators/utils.d.ts

@@ -10,5 +10,17 @@ export declare function ensureDir(dirPath: string): Promise<void>;
 export declare function writeTextFile(filePath: string, content: string, overwrite?: boolean): Promise<boolean>;
 export declare function logCreated(file: string): void;
 export declare function logUpdated(file: string): void;
-export declare function createSkillFile(projectPath: string, baseDir: string, productName: string, getTemplate: () => string): Promise<void>;
+export declare function logSkipped(file: string): void;
+/**
+ * Creates a skill file at {projectPath}/{skillsBasePath}/{skillDir}/{fileName}
+ * fileName defaults to 'SKILL.md'
+ */
+export declare function createSkillFile(projectPath: string, skillsBasePath: string, skillDir: string, getTemplate: () => string, fileName?: string): Promise<void>;
+/**
+ * Creates or appends the Cashfree manifest to the framework's manifest file.
+ * If the file already contains Cashfree config, it skips.
+ * If the file exists but has no Cashfree config, it appends.
+ * If the file doesn't exist, it creates it.
+ */
+export declare function createManifestFile(projectPath: string, manifestPath: string, content: string): Promise<void>;
 //# sourceMappingURL=utils.d.ts.map

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,wBAAsB,eAAe,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,MAAM,GAC1B,OAAO,CAAC,IAAI,CAAC,CAYf"}
+{"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"}

package/dist/generators/utils.js

@@ -20,15 +20,50 @@ export function logCreated(file) {
 export function logUpdated(file) {
     console.log(chalk.yellow(`  Updated ${file}`));
 }
-export async function createSkillFile(projectPath, baseDir, productName, getTemplate) {
+export function logSkipped(file) {
+    console.log(chalk.dim(`  Skipped ${file} (already exists)`));
+}
+/**
+ * Creates a skill file at {projectPath}/{skillsBasePath}/{skillDir}/{fileName}
+ * fileName defaults to 'SKILL.md'
+ */
+export async function createSkillFile(projectPath, skillsBasePath, skillDir, getTemplate, fileName = 'SKILL.md') {
     const path = await import('path');
-    const skillsDir = path.join(projectPath, baseDir, 'skills', 'cashfree');
-    const skillPath = path.join(skillsDir, `${productName}.md`);
-    await ensureDir(skillsDir);
+    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());
     if (created) {
-        const relativePath = path.join(baseDir, 'skills', 'cashfree', `${productName}.md`);
         logCreated(relativePath);
     }
+    else {
+        logSkipped(relativePath);
+    }
+}
+/**
+ * Creates or appends the Cashfree manifest to the framework's manifest file.
+ * If the file already contains Cashfree config, it skips.
+ * If the file exists but has no Cashfree config, it appends.
+ * If the file doesn't exist, it creates it.
+ */
+export async function createManifestFile(projectPath, manifestPath, content) {
+    const path = await import('path');
+    const fullPath = path.join(projectPath, manifestPath);
+    await ensureDir(path.dirname(fullPath));
+    const exists = await fs.pathExists(fullPath);
+    if (exists) {
+        const existing = await fs.readFile(fullPath, 'utf8');
+        if (existing.includes('Cashfree Payments')) {
+            logSkipped(manifestPath + ' (Cashfree already configured)');
+            return;
+        }
+        // Append Cashfree section to existing manifest with a separator
+        await fs.appendFile(fullPath, '\n\n---\n\n' + content);
+        logUpdated(manifestPath);
+    }
+    else {
+        await fs.writeFile(fullPath, content);
+        logCreated(manifestPath);
+    }
 }
 //# sourceMappingURL=utils.js.map

package/dist/generators/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,QAAgB,EAChB,OAAe,EACf,SAAS,GAAG,KAAK;IAEjB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,MAAM,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,WAAmB,EACnB,OAAe,EACf,WAAmB,EACnB,WAAyB;IAEzB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,WAAW,KAAK,CAAC,CAAC;IAE5D,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAE3B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9D,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,WAAW,KAAK,CAAC,CAAC;QACnF,UAAU,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;AACL,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"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"}