@fluentcommerce/fc-connect-sdk 0.1.54 → 0.1.56

package/docs/template-loading-matrix.md

@@ -1,242 +1,242 @@
-# Template Loading Matrix
-
-**FC Connect SDK Documentation - Template Selection Guide**
-
-This matrix helps you quickly find the right template for your integration use case.
-
-## Quick Template Selection
-
-### By Integration Context
-
-| Context | Description | Templates Folder |
-|---------|-------------|------------------|
-| **Versori Webhooks** | HTTP-triggered event processing | `01-TEMPLATES/versori/webhooks/` |
-| **Versori Scheduled** | Cron/timer-based workflows | `01-TEMPLATES/versori/workflows/` |
-| **Versori Patterns** | Reusable Versori-specific patterns | `01-TEMPLATES/versori/patterns/` |
-| **Versori Business** | End-to-end business scenarios | `01-TEMPLATES/versori/business-examples/` |
-| **Standalone Scripts** | Node.js/Deno standalone scripts | `01-TEMPLATES/standalone/` |
-| **Reusable Patterns** | Cross-runtime patterns | `01-TEMPLATES/patterns/` |
-
-## Canonical Templates (High-Quality Reference)
-
-### Ingestion Templates
-
-**Versori Scheduled - Event API (XML)**
-- **Path**: `01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-sftp-xml-product-event.md`
-- **Complexity**: Medium
-- **Description**: SFTP XML product ingestion using Event API
-- **Estimated Tokens**: ~15K
-- **Key Features**: SFTP pooling, XML parsing, Event API mutations, state management
-
-**Versori Scheduled - Batch API (CSV)**
-- **Path**: `01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-s3-csv-inventory-batch.md`
-- **Complexity**: Low
-- **Description**: S3 CSV inventory ingestion using Batch API
-- **Estimated Tokens**: ~12K
-- **Key Features**: S3 streaming, CSV validation, batch processing, BPP
-
-### Extraction Templates
-
-**Versori Scheduled - GraphQL to SFTP XML**
-- **Path**: `01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-virtual-positions-to-sftp-xml.md`
-- **Complexity**: Medium
-- **Description**: Extract VirtualPositions via GraphQL, export to SFTP as XML
-- **Estimated Tokens**: ~14K
-- **Key Features**: Auto-pagination, GraphQL queries, XML generation, SFTP upload
-
-**Standalone - GraphQL to Parquet S3**
-- **Path**: `01-TEMPLATES/standalone/graphql-to-parquet-partitioned-s3.md`
-- **Complexity**: High
-- **Description**: Extract GraphQL data to partitioned Parquet files on S3
-- **Estimated Tokens**: ~18K
-- **Key Features**: ExtractionOrchestrator, Parquet writer, S3 partitioning
-
-## Template Matrix by Use Case
-
-### Ingestion (Data → Fluent)
-
-| Source Format | Target API | Versori Template | Standalone Template | Complexity |
-|---------------|-----------|------------------|---------------------|------------|
-| **CSV from S3** | Batch API | `versori/workflows/ingestion/batch-api/template-ingestion-s3-csv-inventory-batch.md` | `standalone/s3-csv-batch-api.md` | Low |
-| **CSV from SFTP** | Batch API | `versori/workflows/ingestion/batch-api/template-ingestion-sftp-csv-inventory-batch.md` | `standalone/multi-channel-inventory-sync.md` | Medium |
-| **XML from SFTP** | Event API | `versori/workflows/ingestion/event-api/template-ingestion-sftp-xml-product-event.md` | `standalone/asn-inbound-processing.md` | Medium |
-| **XML from HTTP** | GraphQL Mutations | `versori/webhooks/template-webhook-xml-order-ingestion.md` | N/A | Medium |
-| **JSON from HTTP** | GraphQL Mutations | `versori/webhooks/template-webhook-generic-xml-order.md` | N/A | Low |
-| **Payment Gateway** | Event API | `versori/webhooks/template-webhook-payment-gateway-integration.md` | N/A | Medium-High |
-
-### Extraction (Fluent → Output)
-
-| Query Type | Output Format | Versori Template | Standalone Template | Complexity |
-|------------|---------------|------------------|---------------------|------------|
-| **GraphQL Query** | CSV to S3 | `versori/workflows/extraction/graphql-queries/template-extraction-inventory-to-s3-csv.md` | `standalone/graphql-query-export.md` | Medium |
-| **GraphQL Query** | XML to SFTP | `versori/workflows/extraction/graphql-queries/template-extraction-virtual-positions-to-sftp-xml.md` | N/A | Medium |
-| **GraphQL Query** | Parquet to S3 | N/A | `standalone/graphql-to-parquet-partitioned-s3.md` | High |
-| **GraphQL Query** | JSON to S3 | `versori/workflows/extraction/graphql-queries/template-extraction-orders-to-s3-json.md` | `standalone/graphql-query-export.md` | Low |
-
-### Bidirectional Sync
-
-| Scenario | Versori Template | Standalone Template | Complexity |
-|----------|------------------|---------------------|------------|
-| **Multi-source aggregation** | N/A | `standalone/multi-source-aggregation.md` | High |
-| **Multi-channel sync** | `versori/business-examples/multi-channel-order-sync.md` | `standalone/multi-channel-inventory-sync.md` | High |
-
-## Loading Templates by Token Budget
-
-### Small Context Window (<30K tokens)
-
-Load individual templates:
-- Single ingestion: `~12-15K tokens`
-- Single extraction: `~14-18K tokens`
-- Single pattern: `~8-12K tokens`
-
-**Example**: Load `sftp-xml-product-event.md` + `error-handling-retry.md` = ~23K tokens
-
-### Medium Context Window (30K-100K tokens)
-
-Load template category + patterns:
-- Ingestion templates folder: `~40K tokens`
-- Extraction templates folder: `~35K tokens`
-- All patterns: `~25K tokens`
-
-**Example**: All ingestion templates + error handling patterns = ~65K tokens
-
-### Large Context Window (100K+ tokens)
-
-Load consolidated guides + templates:
-- All Versori templates: `~75K tokens`
-- All Standalone templates: `~50K tokens`
-- Core guides (ingestion + extraction): `~60K tokens`
-
-**Example**: All templates + core guides = ~185K tokens
-
-## Template Complexity Ratings
-
-### Low Complexity (Beginner-Friendly)
-- Single data source
-- Single API endpoint
-- Basic validation
-- Minimal error handling
-- ~100-200 lines of code
-
-**Examples**: S3 CSV to Batch API, JSON webhook to mutation
-
-### Medium Complexity (Production-Ready)
-- Multiple data sources possible
-- State management
-- Comprehensive error handling
-- Retry logic
-- ~200-400 lines of code
-
-**Examples**: SFTP XML ingestion, GraphQL extraction to SFTP
-
-### High Complexity (Advanced)
-- Complex orchestration
-- Multi-stage processing
-- Advanced error recovery
-- Performance optimization
-- ~400-600 lines of code
-
-**Examples**: Parquet partitioning, multi-source aggregation, master data ETL
-
-## Common Template Combinations
-
-### E-Commerce Order Flow
-1. **Webhook order ingestion**: `versori/webhooks/template-webhook-xml-order-ingestion.md` (~13K tokens)
-2. **Error handling**: `patterns/error-handling-retry.md` (~10K tokens)
-3. **Duplicate prevention**: `patterns/state-duplicate-prevention.md` (~9K tokens)
-**Total**: ~32K tokens
-
-### Inventory Sync Workflow
-1. **SFTP CSV ingestion**: `versori/workflows/ingestion/batch-api/template-ingestion-sftp-csv-inventory-batch.md` (~14K tokens)
-2. **Validation pattern**: `patterns/csv-schema-validation-and-rejection-report.md` (~11K tokens)
-3. **Batch processing**: Core guide ingestion/batch-api module (~20K tokens)
-**Total**: ~45K tokens
-
-### Data Warehouse ETL
-1. **GraphQL extraction**: `standalone/graphql-to-parquet-partitioned-s3.md` (~18K tokens)
-2. **Pagination pattern**: `patterns/pagination-streaming.md` (~10K tokens)
-3. **Master data ETL**: `patterns/master-data-etl.md` (~15K tokens)
-**Total**: ~43K tokens
-
-## Template File Paths Reference
-
-### Versori Templates
-
-**Webhooks** (`01-TEMPLATES/versori/webhooks/`):
-- `template-webhook-xml-order-ingestion.md` - XML order webhook processing
-- `template-webhook-payment-gateway-integration.md` - Payment gateway integration (Capture, Refund, Cancel, ReAuth)
-- `template-webhook-generic-xml-order.md` - Generic XML order webhook handling
-- `template-webhook-asn-purchase-order.md` - ASN/shipment webhook handling
-- `template-webhook-rma-returns-comprehensive.md` - Returns/RMA webhook processing
-
-**Scheduled - Ingestion** (`01-TEMPLATES/versori/workflows/ingestion/`):
-- `batch-api/template-ingestion-s3-csv-inventory-batch.md` - S3 CSV batch ingestion
-- `batch-api/template-ingestion-sftp-csv-inventory-batch.md` - SFTP CSV batch ingestion
-- `event-api/template-ingestion-sftp-xml-product-event.md` - SFTP XML event ingestion
-- `graphql-mutations/template-ingestion-sftp-csv-control-graphql.md` - JSON to GraphQL mutations
-
-**Scheduled - Extraction** (`01-TEMPLATES/versori/workflows/extraction/`):
-- `graphql-queries/template-extraction-virtual-positions-to-sftp-xml.md` - VirtualPositions to SFTP
-- `graphql-queries/template-extraction-inventory-to-s3-csv.md` - Inventory to S3 CSV
-- `graphql-queries/template-extraction-orders-to-s3-json.md` - Orders to JSON
-
-**Patterns** (`01-TEMPLATES/versori/patterns/`):
-- `kv-state-management.md` - Versori KV state tracking
-- `xml-response-generation.md` - XML webhook responses
-- `dual-workflow-pattern.md` - Combined ingestion/extraction
-
-**Business Examples** (`01-TEMPLATES/versori/business-examples/`):
-- `multi-channel-order-sync.md` - Multi-channel order synchronization
-- `returns-rma-processing.md` - Returns/RMA workflow
-
-### Standalone Templates
-
-**Node.js Scripts** (`01-TEMPLATES/standalone/`):
-- `s3-csv-inventory-batch.md` - S3 CSV standalone ingestion
-- `asn-inbound-processing.md` - ASN processing script
-- `graphql-query-export.md` - GraphQL to file export
-- `graphql-to-parquet-partitioned-s3.md` - GraphQL to Parquet ETL
-- `multi-channel-inventory-sync.md` - Multi-channel sync
-- `multi-source-aggregation.md` - Multi-source data aggregation
-
-### Pattern Templates
-
-**Reusable Patterns** (`01-TEMPLATES/patterns/`):
-- `field-mapping-universal.md` - Universal field mapping
-- `error-handling-retry.md` - Error handling and retry logic
-- `state-duplicate-prevention.md` - Duplicate prevention with state
-- `pagination-streaming.md` - Pagination and streaming
-- `csv-schema-validation-and-rejection-report.md` - CSV validation
-- `large-file-splitting.md` - Large file processing
-- `master-data-etl.md` - Master data ETL patterns
-- `custom-resolvers.md` - Custom resolver patterns
-
-## How to Use This Matrix
-
-1. **Identify your use case** - Ingestion, extraction, or bidirectional sync
-2. **Choose your context** - Versori platform or standalone Node.js/Deno
-3. **Find matching template** - Use the matrix tables above
-4. **Check token budget** - Ensure template fits your AI context window
-5. **Load template + patterns** - Combine base template with relevant patterns
-6. **Adapt to your needs** - Customize template for your specific requirements
-
-## Template Quality Indicators
-
-All templates include:
-- Complete, runnable code
-- Real Fluent entity schemas (Order, Inventory, Product)
-- Proper error handling
-- State management (where applicable)
-- Comprehensive comments
-- Testing guidance
-- Troubleshooting section
-
-**Canonical templates** (marked above) are the highest quality and most recently validated.
-
-## Need More Help?
-
-- **Decision tree**: See `00-START-HERE/DECISION-TREE.md` for SDK approach selection
-- **Getting started**: See `00-START-HERE/getting-started.md` for setup
-- **Troubleshooting**: See `00-START-HERE/troubleshooting-quick-reference.md`
-- **Template FAQ**: See `01-TEMPLATES/faq.md`
-- **Template index**: See `01-TEMPLATES/readme.md`
+# Template Loading Matrix
+
+**FC Connect SDK Documentation - Template Selection Guide**
+
+This matrix helps you quickly find the right template for your integration use case.
+
+## Quick Template Selection
+
+### By Integration Context
+
+| Context | Description | Templates Folder |
+|---------|-------------|------------------|
+| **Versori Webhooks** | HTTP-triggered event processing | `01-TEMPLATES/versori/webhooks/` |
+| **Versori Scheduled** | Cron/timer-based workflows | `01-TEMPLATES/versori/workflows/` |
+| **Versori Patterns** | Reusable Versori-specific patterns | `01-TEMPLATES/versori/patterns/` |
+| **Versori Business** | End-to-end business scenarios | `01-TEMPLATES/versori/business-examples/` |
+| **Standalone Scripts** | Node.js/Deno standalone scripts | `01-TEMPLATES/standalone/` |
+| **Reusable Patterns** | Cross-runtime patterns | `01-TEMPLATES/patterns/` |
+
+## Canonical Templates (High-Quality Reference)
+
+### Ingestion Templates
+
+**Versori Scheduled - Event API (XML)**
+- **Path**: `01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-sftp-xml-product-event.md`
+- **Complexity**: Medium
+- **Description**: SFTP XML product ingestion using Event API
+- **Estimated Tokens**: ~15K
+- **Key Features**: SFTP pooling, XML parsing, Event API mutations, state management
+
+**Versori Scheduled - Batch API (CSV)**
+- **Path**: `01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-s3-csv-inventory-batch.md`
+- **Complexity**: Low
+- **Description**: S3 CSV inventory ingestion using Batch API
+- **Estimated Tokens**: ~12K
+- **Key Features**: S3 streaming, CSV validation, batch processing, BPP
+
+### Extraction Templates
+
+**Versori Scheduled - GraphQL to SFTP XML**
+- **Path**: `01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-virtual-positions-to-sftp-xml.md`
+- **Complexity**: Medium
+- **Description**: Extract VirtualPositions via GraphQL, export to SFTP as XML
+- **Estimated Tokens**: ~14K
+- **Key Features**: Auto-pagination, GraphQL queries, XML generation, SFTP upload
+
+**Standalone - GraphQL to Parquet S3**
+- **Path**: `01-TEMPLATES/standalone/graphql-to-parquet-partitioned-s3.md`
+- **Complexity**: High
+- **Description**: Extract GraphQL data to partitioned Parquet files on S3
+- **Estimated Tokens**: ~18K
+- **Key Features**: ExtractionOrchestrator, Parquet writer, S3 partitioning
+
+## Template Matrix by Use Case
+
+### Ingestion (Data → Fluent)
+
+| Source Format | Target API | Versori Template | Standalone Template | Complexity |
+|---------------|-----------|------------------|---------------------|------------|
+| **CSV from S3** | Batch API | `versori/workflows/ingestion/batch-api/template-ingestion-s3-csv-inventory-batch.md` | `standalone/s3-csv-batch-api.md` | Low |
+| **CSV from SFTP** | Batch API | `versori/workflows/ingestion/batch-api/template-ingestion-sftp-csv-inventory-batch.md` | `standalone/multi-channel-inventory-sync.md` | Medium |
+| **XML from SFTP** | Event API | `versori/workflows/ingestion/event-api/template-ingestion-sftp-xml-product-event.md` | `standalone/asn-inbound-processing.md` | Medium |
+| **XML from HTTP** | GraphQL Mutations | `versori/webhooks/template-webhook-xml-order-ingestion.md` | N/A | Medium |
+| **JSON from HTTP** | GraphQL Mutations | `versori/webhooks/template-webhook-generic-xml-order.md` | N/A | Low |
+| **Payment Gateway** | Event API | `versori/webhooks/template-webhook-payment-gateway-integration.md` | N/A | Medium-High |
+
+### Extraction (Fluent → Output)
+
+| Query Type | Output Format | Versori Template | Standalone Template | Complexity |
+|------------|---------------|------------------|---------------------|------------|
+| **GraphQL Query** | CSV to S3 | `versori/workflows/extraction/graphql-queries/template-extraction-inventory-to-s3-csv.md` | `standalone/graphql-query-export.md` | Medium |
+| **GraphQL Query** | XML to SFTP | `versori/workflows/extraction/graphql-queries/template-extraction-virtual-positions-to-sftp-xml.md` | N/A | Medium |
+| **GraphQL Query** | Parquet to S3 | N/A | `standalone/graphql-to-parquet-partitioned-s3.md` | High |
+| **GraphQL Query** | JSON to S3 | `versori/workflows/extraction/graphql-queries/template-extraction-orders-to-s3-json.md` | `standalone/graphql-query-export.md` | Low |
+
+### Bidirectional Sync
+
+| Scenario | Versori Template | Standalone Template | Complexity |
+|----------|------------------|---------------------|------------|
+| **Multi-source aggregation** | N/A | `standalone/multi-source-aggregation.md` | High |
+| **Multi-channel sync** | `versori/business-examples/multi-channel-order-sync.md` | `standalone/multi-channel-inventory-sync.md` | High |
+
+## Loading Templates by Token Budget
+
+### Small Context Window (<30K tokens)
+
+Load individual templates:
+- Single ingestion: `~12-15K tokens`
+- Single extraction: `~14-18K tokens`
+- Single pattern: `~8-12K tokens`
+
+**Example**: Load `sftp-xml-product-event.md` + `error-handling-retry.md` = ~23K tokens
+
+### Medium Context Window (30K-100K tokens)
+
+Load template category + patterns:
+- Ingestion templates folder: `~40K tokens`
+- Extraction templates folder: `~35K tokens`
+- All patterns: `~25K tokens`
+
+**Example**: All ingestion templates + error handling patterns = ~65K tokens
+
+### Large Context Window (100K+ tokens)
+
+Load consolidated guides + templates:
+- All Versori templates: `~75K tokens`
+- All Standalone templates: `~50K tokens`
+- Core guides (ingestion + extraction): `~60K tokens`
+
+**Example**: All templates + core guides = ~185K tokens
+
+## Template Complexity Ratings
+
+### Low Complexity (Beginner-Friendly)
+- Single data source
+- Single API endpoint
+- Basic validation
+- Minimal error handling
+- ~100-200 lines of code
+
+**Examples**: S3 CSV to Batch API, JSON webhook to mutation
+
+### Medium Complexity (Production-Ready)
+- Multiple data sources possible
+- State management
+- Comprehensive error handling
+- Retry logic
+- ~200-400 lines of code
+
+**Examples**: SFTP XML ingestion, GraphQL extraction to SFTP
+
+### High Complexity (Advanced)
+- Complex orchestration
+- Multi-stage processing
+- Advanced error recovery
+- Performance optimization
+- ~400-600 lines of code
+
+**Examples**: Parquet partitioning, multi-source aggregation, master data ETL
+
+## Common Template Combinations
+
+### E-Commerce Order Flow
+1. **Webhook order ingestion**: `versori/webhooks/template-webhook-xml-order-ingestion.md` (~13K tokens)
+2. **Error handling**: `patterns/error-handling-retry.md` (~10K tokens)
+3. **Duplicate prevention**: `patterns/state-duplicate-prevention.md` (~9K tokens)
+**Total**: ~32K tokens
+
+### Inventory Sync Workflow
+1. **SFTP CSV ingestion**: `versori/workflows/ingestion/batch-api/template-ingestion-sftp-csv-inventory-batch.md` (~14K tokens)
+2. **Validation pattern**: `patterns/csv-schema-validation-and-rejection-report.md` (~11K tokens)
+3. **Batch processing**: Core guide ingestion/batch-api module (~20K tokens)
+**Total**: ~45K tokens
+
+### Data Warehouse ETL
+1. **GraphQL extraction**: `standalone/graphql-to-parquet-partitioned-s3.md` (~18K tokens)
+2. **Pagination pattern**: `patterns/pagination-streaming.md` (~10K tokens)
+3. **Master data ETL**: `patterns/master-data-etl.md` (~15K tokens)
+**Total**: ~43K tokens
+
+## Template File Paths Reference
+
+### Versori Templates
+
+**Webhooks** (`01-TEMPLATES/versori/webhooks/`):
+- `template-webhook-xml-order-ingestion.md` - XML order webhook processing
+- `template-webhook-payment-gateway-integration.md` - Payment gateway integration (Capture, Refund, Cancel, ReAuth)
+- `template-webhook-generic-xml-order.md` - Generic XML order webhook handling
+- `template-webhook-asn-purchase-order.md` - ASN/shipment webhook handling
+- `template-webhook-rma-returns-comprehensive.md` - Returns/RMA webhook processing
+
+**Scheduled - Ingestion** (`01-TEMPLATES/versori/workflows/ingestion/`):
+- `batch-api/template-ingestion-s3-csv-inventory-batch.md` - S3 CSV batch ingestion
+- `batch-api/template-ingestion-sftp-csv-inventory-batch.md` - SFTP CSV batch ingestion
+- `event-api/template-ingestion-sftp-xml-product-event.md` - SFTP XML event ingestion
+- `graphql-mutations/template-ingestion-sftp-csv-control-graphql.md` - JSON to GraphQL mutations
+
+**Scheduled - Extraction** (`01-TEMPLATES/versori/workflows/extraction/`):
+- `graphql-queries/template-extraction-virtual-positions-to-sftp-xml.md` - VirtualPositions to SFTP
+- `graphql-queries/template-extraction-inventory-to-s3-csv.md` - Inventory to S3 CSV
+- `graphql-queries/template-extraction-orders-to-s3-json.md` - Orders to JSON
+
+**Patterns** (`01-TEMPLATES/versori/patterns/`):
+- `kv-state-management.md` - Versori KV state tracking
+- `xml-response-generation.md` - XML webhook responses
+- `dual-workflow-pattern.md` - Combined ingestion/extraction
+
+**Business Examples** (`01-TEMPLATES/versori/business-examples/`):
+- `multi-channel-order-sync.md` - Multi-channel order synchronization
+- `returns-rma-processing.md` - Returns/RMA workflow
+
+### Standalone Templates
+
+**Node.js Scripts** (`01-TEMPLATES/standalone/`):
+- `s3-csv-inventory-batch.md` - S3 CSV standalone ingestion
+- `asn-inbound-processing.md` - ASN processing script
+- `graphql-query-export.md` - GraphQL to file export
+- `graphql-to-parquet-partitioned-s3.md` - GraphQL to Parquet ETL
+- `multi-channel-inventory-sync.md` - Multi-channel sync
+- `multi-source-aggregation.md` - Multi-source data aggregation
+
+### Pattern Templates
+
+**Reusable Patterns** (`01-TEMPLATES/patterns/`):
+- `field-mapping-universal.md` - Universal field mapping
+- `error-handling-retry.md` - Error handling and retry logic
+- `state-duplicate-prevention.md` - Duplicate prevention with state
+- `pagination-streaming.md` - Pagination and streaming
+- `csv-schema-validation-and-rejection-report.md` - CSV validation
+- `large-file-splitting.md` - Large file processing
+- `master-data-etl.md` - Master data ETL patterns
+- `custom-resolvers.md` - Custom resolver patterns
+
+## How to Use This Matrix
+
+1. **Identify your use case** - Ingestion, extraction, or bidirectional sync
+2. **Choose your context** - Versori platform or standalone Node.js/Deno
+3. **Find matching template** - Use the matrix tables above
+4. **Check token budget** - Ensure template fits your AI context window
+5. **Load template + patterns** - Combine base template with relevant patterns
+6. **Adapt to your needs** - Customize template for your specific requirements
+
+## Template Quality Indicators
+
+All templates include:
+- Complete, runnable code
+- Real Fluent entity schemas (Order, Inventory, Product)
+- Proper error handling
+- State management (where applicable)
+- Comprehensive comments
+- Testing guidance
+- Troubleshooting section
+
+**Canonical templates** (marked above) are the highest quality and most recently validated.
+
+## Need More Help?
+
+- **Decision tree**: See `00-START-HERE/DECISION-TREE.md` for SDK approach selection
+- **Getting started**: See `00-START-HERE/getting-started.md` for setup
+- **Troubleshooting**: See `00-START-HERE/troubleshooting-quick-reference.md`
+- **Template FAQ**: See `01-TEMPLATES/faq.md`
+- **Template index**: See `01-TEMPLATES/readme.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluentcommerce/fc-connect-sdk",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "description": "Fluent Commerce SDK - Deno & Node.js Compatible",
   "type": "module",
   "main": "dist/cjs/index.js",
@@ -103,13 +103,15 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
+    "@fluentcommerce/ai-skills": "^0.14.0",
+    "@fluentcommerce/fluent-mcp-extn": "^0.7.3",
     "@types/jest": "^29.5.0",
     "@types/node": "^20.0.0",
     "@types/ssh2": "^1.15.5",
     "@types/ssh2-sftp-client": "^9.0.5",
     "@typescript-eslint/eslint-plugin": "^7.0.0",
     "@typescript-eslint/parser": "^7.0.0",
-    "@versori/run": "^0.4.18",
+    "@versori/run": "^0.5.10",
     "chalk": "^4.1.2",
     "dotenv": "^17.2.2",
     "eslint": "^8.57.0",
@@ -119,7 +121,7 @@
     "highlight.js": "^11.11.1",
     "jest": "^29.7.0",
     "jest-junit": "^16.0.0",
-    "markdownlint-cli": "^0.46.0",
+    "markdownlint-cli": "^0.48.0",
     "marked": "^14.1.4",
     "ora": "^5.4.1",
     "p-limit": "^3.1.0",