@ai-coders/context 0.3.1 → 0.4.0

package/dist/generators/documentation/documentationGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentationGenerator.js","sourceRoot":"","sources":["../../../src/generators/documentation/documentationGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAE7B,sCAA2C;AAC3C,2CAYqB;AACrB,mDAAmE;AAWnE,MAAa,sBAAsB;IAGjC,YAAY,GAAG,WAAsB;QAFpB,WAAM,GAAgB,+BAAe,CAAC;IAEf,CAAC;IAEzC,KAAK,CAAC,qBAAqB,CACzB,aAA4B,EAC5B,SAAiB,EACjB,SAAwC,EAAE,EAC1C,UAAmB,KAAK;QAExB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,uBAAc,CAAC,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,sCAAsC,CAAC,CAAC;QAErG,MAAM,gBAAgB,GAAG,IAAA,+BAAe,EAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;QAEvD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,uBAAc,CAAC,oBAAoB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACvG,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,YAAY,CAClB,aAA4B,EAC5B,MAAmB;QAEnB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QAEvC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACtC,MAAM,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvE,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,mBAAmB,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,MAAM,cAAc,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtD,IAAI;YACJ,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM;SAC/F,CAAC,CAAC,CAAC;QACJ,MAAM,gBAAgB,GAAG,uBAAc,CAAC,oBAAoB,CAAC,aAAa,EAAE,CAAC,CAAC;aAC3E,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;aACxB,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAEvD,OAAO;YACL,aAAa;YACb,mBAAmB;YACnB,gBAAgB;YAChB,cAAc;YACd,MAAM;SACP,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,MAAmB;QACxC,MAAM,QAAQ,GAAiB;YAC7B;gBACE,QAAQ,EAAE,WAAW;gBACrB,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,IAAA,uBAAW,EAAC,OAAO,CAAC;aACzC;SACF,CAAC;QAEF,MAAM,SAAS,GAAsE;YACnF,kBAAkB,EAAE,iCAAqB;YACzC,YAAY,EAAE,mCAAuB;YACrC,sBAAsB,EAAE,GAAG,EAAE,CAAC,IAAA,qCAAyB,GAAE;YACzD,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAA,iCAAqB,GAAE;YACjD,QAAQ,EAAE,0BAAc;YACxB,WAAW,EAAE,0BAAc;YAC3B,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAA,0BAAc,GAAE;YAChC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAA,8BAAkB,GAAE;SACpC,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACrB,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,KAAK,CAAC,IAAI;gBACpB,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA7FD,wDA6FC"}
+{"version":3,"file":"documentationGenerator.js","sourceRoot":"","sources":["../../../src/generators/documentation/documentationGenerator.ts"],"names":[],"mappings":"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"}

package/dist/generators/documentation/guideRegistry.js

@@ -8,56 +8,56 @@ exports.DOCUMENT_GUIDES = [
         key: 'project-overview',
         title: 'Project Overview',
         file: 'project-overview.md',
-        marker: 'ai-task:project-overview',
+        marker: 'agent-update:project-overview',
         primaryInputs: 'Roadmap, README, stakeholder notes'
     },
     {
         key: 'architecture',
         title: 'Architecture Notes',
         file: 'architecture.md',
-        marker: 'ai-task:architecture-notes',
+        marker: 'agent-update:architecture-notes',
         primaryInputs: 'ADRs, service boundaries, dependency graphs'
     },
     {
         key: 'development-workflow',
         title: 'Development Workflow',
         file: 'development-workflow.md',
-        marker: 'ai-task:development-workflow',
+        marker: 'agent-update:development-workflow',
         primaryInputs: 'Branching rules, CI config, contributing guide'
     },
     {
         key: 'testing-strategy',
         title: 'Testing Strategy',
         file: 'testing-strategy.md',
-        marker: 'ai-task:testing-strategy',
+        marker: 'agent-update:testing-strategy',
         primaryInputs: 'Test configs, CI gates, known flaky suites'
     },
     {
         key: 'glossary',
         title: 'Glossary & Domain Concepts',
         file: 'glossary.md',
-        marker: 'ai-task:glossary',
+        marker: 'agent-update:glossary',
         primaryInputs: 'Business terminology, user personas, domain rules'
     },
     {
         key: 'data-flow',
         title: 'Data Flow & Integrations',
         file: 'data-flow.md',
-        marker: 'ai-task:data-flow',
+        marker: 'agent-update:data-flow',
         primaryInputs: 'System diagrams, integration specs, queue topics'
     },
     {
         key: 'security',
         title: 'Security & Compliance Notes',
         file: 'security.md',
-        marker: 'ai-task:security',
+        marker: 'agent-update:security',
         primaryInputs: 'Auth model, secrets management, compliance requirements'
     },
     {
         key: 'tooling',
         title: 'Tooling & Productivity Guide',
         file: 'tooling.md',
-        marker: 'ai-task:tooling',
+        marker: 'agent-update:tooling',
         primaryInputs: 'CLI scripts, IDE configs, automation workflows'
     }
 ];

package/dist/generators/documentation/guideRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"guideRegistry.js","sourceRoot":"","sources":["../../../src/generators/documentation/guideRegistry.ts"],"names":[],"mappings":";;;AA+DA,0CAQC;AAED,8CAQC;AA/EY,QAAA,eAAe,GAAgB;IAC1C;QACE,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,0BAA0B;QAClC,aAAa,EAAE,oCAAoC;KACpD;IACD;QACE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,4BAA4B;QACpC,aAAa,EAAE,6CAA6C;KAC7D;IACD;QACE,GAAG,EAAE,sBAAsB;QAC3B,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,yBAAyB;QAC/B,MAAM,EAAE,8BAA8B;QACtC,aAAa,EAAE,gDAAgD;KAChE;IACD;QACE,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,0BAA0B;QAClC,aAAa,EAAE,4CAA4C;KAC5D;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,4BAA4B;QACnC,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,kBAAkB;QAC1B,aAAa,EAAE,mDAAmD;KACnE;IACD;QACE,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,0BAA0B;QACjC,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,mBAAmB;QAC3B,aAAa,EAAE,kDAAkD;KAClE;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,6BAA6B;QACpC,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,kBAAkB;QAC1B,aAAa,EAAE,yDAAyD;KACzE;IACD;QACE,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,8BAA8B;QACrC,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,iBAAiB;QACzB,aAAa,EAAE,gDAAgD;KAChE;CACF,CAAC;AAEW,QAAA,mBAAmB,GAAG,uBAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAE3E,SAAgB,eAAe,CAAC,IAAe;IAC7C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,uBAAe,CAAC;IACzB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAG,uBAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAe,CAAC;AAC1D,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAe;IAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,uBAAe;SAC1B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACzC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC"}
+{"version":3,"file":"guideRegistry.js","sourceRoot":"","sources":["../../../src/generators/documentation/guideRegistry.ts"],"names":[],"mappings":";;;AA+DA,0CAQC;AAED,8CAQC;AA/EY,QAAA,eAAe,GAAgB;IAC1C;QACE,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,+BAA+B;QACvC,aAAa,EAAE,oCAAoC;KACpD;IACD;QACE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,iCAAiC;QACzC,aAAa,EAAE,6CAA6C;KAC7D;IACD;QACE,GAAG,EAAE,sBAAsB;QAC3B,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,yBAAyB;QAC/B,MAAM,EAAE,mCAAmC;QAC3C,aAAa,EAAE,gDAAgD;KAChE;IACD;QACE,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,+BAA+B;QACvC,aAAa,EAAE,4CAA4C;KAC5D;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,4BAA4B;QACnC,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,uBAAuB;QAC/B,aAAa,EAAE,mDAAmD;KACnE;IACD;QACE,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,0BAA0B;QACjC,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,wBAAwB;QAChC,aAAa,EAAE,kDAAkD;KAClE;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,6BAA6B;QACpC,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,uBAAuB;QAC/B,aAAa,EAAE,yDAAyD;KACzE;IACD;QACE,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,8BAA8B;QACrC,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,sBAAsB;QAC9B,aAAa,EAAE,gDAAgD;KAChE;CACF,CAAC;AAEW,QAAA,mBAAmB,GAAG,uBAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAE3E,SAAgB,eAAe,CAAC,IAAe;IAC7C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,uBAAe,CAAC;IACzB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAG,uBAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAe,CAAC;AAC1D,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAe;IAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,uBAAe;SAC1B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACzC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC"}

package/dist/generators/documentation/templates/apiReferenceTemplate.d.ts

@@ -0,0 +1,2 @@
+export declare function renderApiReference(): string;
+//# sourceMappingURL=apiReferenceTemplate.d.ts.map

package/dist/generators/documentation/templates/apiReferenceTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiReferenceTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/apiReferenceTemplate.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,IAAI,MAAM,CAqe3C"}

package/dist/generators/documentation/templates/apiReferenceTemplate.js

@@ -0,0 +1,490 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderApiReference = renderApiReference;
+function renderApiReference() {
+    return `<!-- agent-update:start:api-reference -->
+# API Reference
+
+**Purpose:** Enable AI agents to programmatically interact with all API endpoints.
+
+**Agent Usage Instructions:**
+- Use documented curl commands as templates for requests
+- Verify expected response codes match actual responses
+- Handle authentication token expiration automatically
+- Parse error responses to determine retry strategy
+- Log all API interactions for debugging
+
+## Base URLs
+
+**Agent Configuration:**
+\`\`\`bash
+# Set as environment variables for easier switching
+export API_BASE_DEV="http://localhost:3000/api"
+export API_BASE_STAGING="https://staging-api.example.com"  # TODO: Update
+export API_BASE_PROD="https://api.example.com"              # TODO: Update
+
+# Agent uses based on context
+API_BASE=$API_BASE_STAGING  # Change as needed
+\`\`\`
+
+## Authentication
+
+**Agent Authentication Flow:**
+
+### Step 1: Obtain Token
+\`\`\`bash
+# Agent executes login
+TOKEN_RESPONSE=$(curl -s -X POST "\${API_BASE}/auth/login" \\
+  -H "Content-Type: application/json" \\
+  -d '{
+    "email": "agent@example.com",
+    "password": "'\${AGENT_PASSWORD}'"
+  }')
+
+# Agent extracts token
+TOKEN=$(echo \$TOKEN_RESPONSE | jq -r '.token')
+EXPIRES_IN=$(echo \$TOKEN_RESPONSE | jq -r '.expiresIn')
+
+# Agent stores token with expiration
+echo "\$TOKEN" > .api-token
+echo \$((\$(date +%s) + \$EXPIRES_IN)) > .api-token-expires
+
+# Expected response structure
+# {
+#   "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+#   "expiresIn": 3600,
+#   "refreshToken": "refresh_token_here",
+#   "user": {"id": "123", "email": "agent@example.com"}
+# }
+\`\`\`
+
+### Step 2: Use Token in Requests
+\`\`\`bash
+# Agent includes token in all authenticated requests
+curl -X GET "\${API_BASE}/resources" \\
+  -H "Authorization: Bearer \$TOKEN" \\
+  -H "Content-Type: application/json"
+\`\`\`
+
+### Step 3: Handle Token Expiration
+\`\`\`bash
+# Agent checks token expiration before each request
+function check_token() {
+  if [ ! -f .api-token ] || [ ! -f .api-token-expires ]; then
+    return 1  # Token missing, need to authenticate
+  fi
+
+  EXPIRES=$(cat .api-token-expires)
+  NOW=$(date +%s)
+
+  if [ $NOW -ge $EXPIRES ]; then
+    return 1  # Token expired
+  fi
+
+  return 0  # Token valid
+}
+
+# Agent refresh flow (if 401 received)
+if ! check_token; then
+  echo "Token expired or missing, re-authenticating..."
+  # Re-run Step 1
+fi
+\`\`\`
+
+**Agent Error Handling:**
+- 401 response → Token invalid/expired, re-authenticate
+- 403 response → Permission denied, check agent has required role
+- 429 response → Rate limited, wait and retry (see Rate Limiting section)
+
+### Authorization & Permissions
+- Document role-based access control (RBAC) if applicable
+- List permission levels and their capabilities
+- Explain scope-based authorization for OAuth
+
+## API Versioning
+- **Current Version:** v1
+- **Versioning Strategy:** TODO: URL path (/v1/), header, or query parameter
+- **Deprecation Policy:** TODO: Document how versions are deprecated
+
+## Rate Limiting
+
+**Agent Must Implement:** Check rate limit headers and back off when necessary.
+
+\`\`\`bash
+# Agent rate limit handler
+function make_api_request() {
+  local url=$1
+  local method=$2
+  local data=$3
+
+  RESPONSE=$(curl -i -X "$method" "$url" \\
+    -H "Authorization: Bearer $TOKEN" \\
+    -H "Content-Type: application/json" \\
+    -d "$data" 2>&1)
+
+  # Agent extracts rate limit headers
+  LIMIT=$(echo "$RESPONSE" | grep -i "x-ratelimit-limit" | cut -d: -f2 | tr -d ' \\r')
+  REMAINING=$(echo "$RESPONSE" | grep -i "x-ratelimit-remaining" | cut -d: -f2 | tr -d ' \\r')
+  RESET=$(echo "$RESPONSE" | grep -i "x-ratelimit-reset" | cut -d: -f2 | tr -d ' \\r')
+
+  # Agent checks if approaching limit
+  if [ "\$REMAINING" -lt "10" ]; then
+    NOW=$(date +%s)
+    WAIT=\$((RESET - NOW))
+    echo "Rate limit low (\$REMAINING remaining), waiting \${WAIT}s until reset..."
+    sleep \$WAIT
+  fi
+
+  # Agent handles 429 (rate limited)
+  HTTP_CODE=$(echo "\$RESPONSE" | grep "HTTP/" | awk '{print \$2}')
+  if [ "\$HTTP_CODE" == "429" ]; then
+    RETRY_AFTER=$(echo "\$RESPONSE" | grep -i "retry-after" | cut -d: -f2 | tr -d ' \\r')
+    echo "Rate limited, retrying after \${RETRY_AFTER}s..."
+    sleep "\$RETRY_AFTER"
+    make_api_request "\$url" "\$method" "\$data"  # Retry
+  fi
+
+  echo "$RESPONSE"
+}
+\`\`\`
+
+**Rate Limit:** TODO: e.g., 1000 requests per hour
+**Headers Agent Should Monitor:**
+- \`X-RateLimit-Limit\`: Maximum allowed
+- \`X-RateLimit-Remaining\`: Remaining in window
+- \`X-RateLimit-Reset\`: Reset time (Unix timestamp)
+- \`Retry-After\`: Seconds to wait (when 429 received)
+
+## Common Headers
+### Request Headers
+- \`Content-Type: application/json\` - Required for POST/PUT/PATCH
+- \`Authorization: Bearer <token>\` - Authentication token
+- \`X-Request-ID: <uuid>\` - Optional request tracking ID
+
+### Response Headers
+- \`Content-Type: application/json\`
+- \`X-Request-ID: <uuid>\` - Echo of request ID for tracking
+- \`X-Response-Time: <ms>\` - Server processing time
+
+## Endpoints
+
+### Authentication Endpoints
+
+#### POST /auth/register
+Register a new user account.
+
+**Request:**
+\`\`\`json
+{
+  "email": "user@example.com",
+  "password": "securePassword123",
+  "name": "John Doe"
+}
+\`\`\`
+
+**Response (201 Created):**
+\`\`\`json
+{
+  "id": "user_123",
+  "email": "user@example.com",
+  "name": "John Doe",
+  "createdAt": "2024-01-15T10:30:00Z"
+}
+\`\`\`
+
+**Errors:**
+- \`400\`: Validation error (invalid email, weak password)
+- \`409\`: Email already registered
+
+---
+
+#### POST /auth/login
+Authenticate user and receive access token.
+
+**Request:**
+\`\`\`json
+{
+  "email": "user@example.com",
+  "password": "securePassword123"
+}
+\`\`\`
+
+**Response (200 OK):**
+\`\`\`json
+{
+  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+  "refreshToken": "refresh_token_here",
+  "expiresIn": 3600,
+  "user": {
+    "id": "user_123",
+    "email": "user@example.com",
+    "name": "John Doe"
+  }
+}
+\`\`\`
+
+**Errors:**
+- \`401\`: Invalid credentials
+- \`429\`: Too many failed attempts
+
+---
+
+### Resource Endpoints
+
+#### GET /api/resources
+List all resources with pagination.
+
+**Query Parameters:**
+- \`page\` (integer, default: 1): Page number
+- \`limit\` (integer, default: 20, max: 100): Items per page
+- \`sort\` (string): Sort field (e.g., "createdAt", "-name" for desc)
+- \`filter\` (string): Filter criteria (implementation-specific)
+
+**Response (200 OK):**
+\`\`\`json
+{
+  "data": [
+    {
+      "id": "res_123",
+      "name": "Resource Name",
+      "status": "active",
+      "createdAt": "2024-01-15T10:30:00Z",
+      "updatedAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "page": 1,
+    "limit": 20,
+    "total": 100,
+    "pages": 5
+  }
+}
+\`\`\`
+
+**Errors:**
+- \`401\`: Unauthorized (missing or invalid token)
+- \`403\`: Forbidden (insufficient permissions)
+
+---
+
+#### GET /api/resources/:id
+Get a specific resource by ID.
+
+**Path Parameters:**
+- \`id\` (string, required): Resource identifier
+
+**Response (200 OK):**
+\`\`\`json
+{
+  "id": "res_123",
+  "name": "Resource Name",
+  "description": "Detailed description",
+  "status": "active",
+  "metadata": {
+    "key": "value"
+  },
+  "createdAt": "2024-01-15T10:30:00Z",
+  "updatedAt": "2024-01-15T10:30:00Z"
+}
+\`\`\`
+
+**Errors:**
+- \`401\`: Unauthorized
+- \`404\`: Resource not found
+
+---
+
+#### POST /api/resources
+Create a new resource.
+
+**Request:**
+\`\`\`json
+{
+  "name": "New Resource",
+  "description": "Resource description",
+  "status": "active",
+  "metadata": {
+    "key": "value"
+  }
+}
+\`\`\`
+
+**Response (201 Created):**
+\`\`\`json
+{
+  "id": "res_124",
+  "name": "New Resource",
+  "description": "Resource description",
+  "status": "active",
+  "metadata": {
+    "key": "value"
+  },
+  "createdAt": "2024-01-15T11:00:00Z",
+  "updatedAt": "2024-01-15T11:00:00Z"
+}
+\`\`\`
+
+**Errors:**
+- \`400\`: Validation error
+- \`401\`: Unauthorized
+- \`403\`: Forbidden
+
+---
+
+#### PUT /api/resources/:id
+Update an existing resource (full replacement).
+
+**Path Parameters:**
+- \`id\` (string, required): Resource identifier
+
+**Request:**
+\`\`\`json
+{
+  "name": "Updated Resource",
+  "description": "Updated description",
+  "status": "inactive",
+  "metadata": {
+    "key": "newValue"
+  }
+}
+\`\`\`
+
+**Response (200 OK):**
+Returns updated resource object.
+
+**Errors:**
+- \`400\`: Validation error
+- \`401\`: Unauthorized
+- \`404\`: Resource not found
+
+---
+
+#### PATCH /api/resources/:id
+Partially update a resource.
+
+**Path Parameters:**
+- \`id\` (string, required): Resource identifier
+
+**Request:**
+\`\`\`json
+{
+  "status": "inactive"
+}
+\`\`\`
+
+**Response (200 OK):**
+Returns updated resource object.
+
+---
+
+#### DELETE /api/resources/:id
+Delete a resource.
+
+**Path Parameters:**
+- \`id\` (string, required): Resource identifier
+
+**Response (204 No Content)**
+
+**Errors:**
+- \`401\`: Unauthorized
+- \`404\`: Resource not found
+- \`409\`: Conflict (resource has dependencies)
+
+---
+
+## Webhooks
+### Registering Webhooks
+Document webhook registration process if applicable.
+
+### Webhook Events
+- \`resource.created\` - Fired when a new resource is created
+- \`resource.updated\` - Fired when a resource is updated
+- \`resource.deleted\` - Fired when a resource is deleted
+
+### Webhook Payload Example
+\`\`\`json
+{
+  "event": "resource.created",
+  "timestamp": "2024-01-15T11:00:00Z",
+  "data": {
+    "id": "res_124",
+    "name": "New Resource"
+  }
+}
+\`\`\`
+
+### Webhook Security
+- Document signature verification mechanism
+- Explain retry logic for failed deliveries
+
+## Error Responses
+### Standard Error Format
+\`\`\`json
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Invalid input data",
+    "details": [
+      {
+        "field": "email",
+        "message": "Invalid email format"
+      }
+    ],
+    "requestId": "req_abc123"
+  }
+}
+\`\`\`
+
+### HTTP Status Codes
+- \`200 OK\`: Successful request
+- \`201 Created\`: Resource created successfully
+- \`204 No Content\`: Successful deletion
+- \`400 Bad Request\`: Invalid input or validation error
+- \`401 Unauthorized\`: Missing or invalid authentication
+- \`403 Forbidden\`: Insufficient permissions
+- \`404 Not Found\`: Resource not found
+- \`409 Conflict\`: Resource conflict (duplicate, dependencies)
+- \`422 Unprocessable Entity\`: Valid syntax but semantic errors
+- \`429 Too Many Requests\`: Rate limit exceeded
+- \`500 Internal Server Error\`: Server error
+- \`503 Service Unavailable\`: Service temporarily unavailable
+
+### Common Error Codes
+- \`VALIDATION_ERROR\`: Input validation failed
+- \`AUTHENTICATION_REQUIRED\`: No authentication provided
+- \`AUTHENTICATION_FAILED\`: Invalid credentials
+- \`PERMISSION_DENIED\`: Insufficient permissions
+- \`RESOURCE_NOT_FOUND\`: Requested resource doesn't exist
+- \`RATE_LIMIT_EXCEEDED\`: Too many requests
+- \`INTERNAL_ERROR\`: Server-side error
+
+## SDK & Client Libraries
+- Document available SDKs (JavaScript, Python, Ruby, etc.)
+- Link to SDK documentation and examples
+
+## Postman/OpenAPI Collection
+- Link to Postman collection for easy testing
+- Link to OpenAPI/Swagger specification if available
+
+<!-- agent-readonly:guidance -->
+## AI Update Checklist
+1. Review route definitions and controller implementations for new or changed endpoints
+2. Verify authentication flows match current implementation
+3. Update rate limiting policies if thresholds changed
+4. Document new error codes and response formats
+5. Ensure all examples use realistic data and current API structure
+6. Validate that webhook event types are current
+7. Update SDK links and availability
+
+<!-- agent-readonly:sources -->
+## Acceptable Sources
+- API route files and controller implementations
+- Authentication middleware and JWT/OAuth configurations
+- OpenAPI/Swagger specifications
+- Integration tests that demonstrate API usage
+- Postman collections or API testing suites
+
+<!-- agent-update:end -->
+`;
+}
+//# sourceMappingURL=apiReferenceTemplate.js.map

package/dist/generators/documentation/templates/apiReferenceTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiReferenceTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/apiReferenceTemplate.ts"],"names":[],"mappings":";;AAAA,gDAqeC;AAreD,SAAgB,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmeR,CAAC;AACF,CAAC"}

package/dist/generators/documentation/templates/architectureTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"architectureTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/architectureTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CA8DrF"}
+{"version":3,"file":"architectureTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/architectureTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CA6DrF"}