trinity-method-sdk 2.0.9 → 2.2.0

package/dist/templates/trinity/CLAUDE.md.template

@@ -39,7 +39,7 @@
 ### Session Initialization
 ```markdown
 ## Required Steps at Session Start:
-1. Load project context from ../CLAUDE.md
+1. Load project context from ../../CLAUDE.md
 2. Review outstanding tasks in knowledge-base/To-do.md
 3. Check system health and performance metrics
 4. Update dependencies if needed
@@ -63,7 +63,7 @@
 ### Session Artifacts Management
 ```yaml
 Session Artifacts:
-  Location: trinity/sessions/[YYYY-MM-DD]-[HHMMSS]/
+  Location: .claude/trinity/sessions/[YYYY-MM-DD]-[HHMMSS]/
   Required Files:
     - SESSION-SUMMARY.md         # Session overview and accomplishments
     - investigation-summary.md   # What was investigated
@@ -94,7 +94,7 @@ Session Artifacts:
 ```markdown
 ## Response for Performance Degradation:
 1. Measure current performance metrics
-2. Compare against established baselines in ../CLAUDE.md
+2. Compare against established baselines in ../../CLAUDE.md
 3. Identify performance bottlenecks
 4. Investigate using Trinity methodology
 5. Implement targeted optimizations
@@ -237,14 +237,14 @@ const trinityMetrics = {
 ### Knowledge Persistence Framework
 ```yaml
 Knowledge Base Structure:
-  trinity/knowledge-base/
+  .claude/trinity/knowledge-base/
     - ISSUES.md              # Common problems and solutions
     - Trinity.md             # Trinity Method project guide
     - ARCHITECTURE.md        # System architecture documentation
     - Technical-Debt.md      # Technical debt tracking
     - To-do.md               # Task tracking and planning
 
-  trinity/sessions/
+  .claude/trinity/sessions/
     - [YYYY-MM-DD]-[HHMMSS]/  # Session artifacts
       - SESSION-SUMMARY.md
       - investigation-summary.md
@@ -252,13 +252,13 @@ Knowledge Base Structure:
       - issues-resolved.md
       - performance-report.md
 
-  trinity/investigations/
+  .claude/trinity/investigations/
     - [investigation-name]/    # Investigation work products
 
-  trinity/patterns/
+  .claude/trinity/patterns/
     - [pattern-name].md        # Reusable solution patterns
 
-  trinity/work-orders/
+  .claude/trinity/work-orders/
     - WORKORDER-XXX.md         # Active work orders
 ```
 
@@ -326,9 +326,9 @@ Execute Framework Crisis Protocol
 
 ### Hierarchical Context Loading
 ```
-1. ../CLAUDE.md              → Global project context (load FIRST)
-2. trinity/CLAUDE.md (this file) → Trinity Method enforcement (load SECOND)
-3. ../{{SOURCE_DIR}}/CLAUDE.md   → Technology-specific rules (load THIRD)
+1. ../../CLAUDE.md              → Global project context (load FIRST)
+2. .claude/trinity/CLAUDE.md (this file) → Trinity Method enforcement (load SECOND)
+3. ../../{{SOURCE_DIR}}/CLAUDE.md   → Technology-specific rules (load THIRD)
 ```
 
 ### Context Priority Rules
@@ -341,7 +341,7 @@ Execute Framework Crisis Protocol
 
 ## Reference to Parent Context
 
-This file extends and enforces the global requirements defined in `../CLAUDE.md`. All Trinity Method protocols must comply with:
+This file extends and enforces the global requirements defined in `../../CLAUDE.md`. All Trinity Method protocols must comply with:
 - Global performance baselines
 - Project-wide behavioral requirements
 - Technology stack specifications
@@ -355,10 +355,10 @@ For technology-specific implementation details, see: `../src/CLAUDE.md`
 
 This file enforces Trinity Method protocols for all development work.
 
-**Parent Context**: [../CLAUDE.md](../CLAUDE.md) - Project overview and global requirements
+**Parent Context**: [../../CLAUDE.md](../../CLAUDE.md) - Project overview and global requirements
 **Child Context**: [../src/CLAUDE.md](../src/CLAUDE.md) - Framework-specific implementation rules
 **Related Resources**:
-- [Agent Directory](../.claude/EMPLOYEE-DIRECTORY.md) - 19-agent Trinity team guide
+- [Agent Directory](../EMPLOYEE-DIRECTORY.md) - 19-agent Trinity team guide
 - [Architecture Documentation](knowledge-base/ARCHITECTURE.md) - System architecture and patterns
 - [Known Issues](knowledge-base/ISSUES.md) - Issue patterns and resolutions
 - [Technical Debt](knowledge-base/Technical-Debt.md) - Debt tracking and reduction plans

package/dist/templates/{knowledge-base → trinity/knowledge-base}/AI-DEVELOPMENT-GUIDE.md.template

@@ -1,6 +1,6 @@
 # AI Development Guide
 
-** Trinity Version:** 2.0.9
+**Trinity Version:** 2.1.0
 **Last Updated**: {{date}}
 **Project**: {{projectName}}
 

package/dist/templates/{knowledge-base → trinity/knowledge-base}/ARCHITECTURE.md.template

@@ -1,5 +1,5 @@
 # {{PROJECT_NAME}} Architecture
-**Trinity Method v2.0**
+**Trinity Version:** 2.1.0
 **Technology Stack**: {{TECHNOLOGY_STACK}}
 **Framework**: {{PRIMARY_FRAMEWORK}}
 **Last Updated**: {{CURRENT_DATE}}
@@ -27,7 +27,7 @@ const {{PROJECT_VAR_NAME}}Stack = {
 ```
 {{PROJECT_NAME}}/
 ├── {{SOURCE_DIR}}/              # Main source code
-├── trinity/                     # Trinity Method implementation
+├── .claude/trinity/                     # Trinity Method implementation
 │   ├── knowledge-base/         # Architecture & documentation
 ├── tests/                      # Test suites
 └── docs/                       # Additional documentation
@@ -308,9 +308,9 @@ graph LR
 
 ### Knowledge Capture
 - Architecture decisions recorded here
-- Patterns documented in trinity/patterns/
-- Issues tracked in trinity/knowledge-base/ISSUES.md
-- Sessions archived in trinity/sessions/
+- Patterns documented in .claude/trinity/patterns/
+- Issues tracked in .claude/trinity/knowledge-base/ISSUES.md
+- Sessions archived in .claude/trinity/sessions/
 
 ---
 

package/dist/templates/{knowledge-base → trinity/knowledge-base}/CODING-PRINCIPLES.md.template

@@ -1,6 +1,6 @@
 # Coding Principles
 
-** Trinity Version:** 2.0.9
+**Trinity Version:** 2.1.0
 **Last Updated**: {{date}}
 **Project**: {{projectName}}
 

package/dist/templates/{knowledge-base → trinity/knowledge-base}/DOCUMENTATION-CRITERIA.md.template

@@ -1,6 +1,6 @@
 # Documentation Criteria
 
-** Trinity Version:** 2.0.9
+**Trinity Version:** 2.1.0
 **Last Updated**: {{date}}
 **Project**: {{projectName}}
 

package/dist/templates/{knowledge-base → trinity/knowledge-base}/ISSUES.md.template

@@ -1,5 +1,5 @@
 # ISSUES.md - {{PROJECT_NAME}}
-**Trinity Method v2.0 - Issue Intelligence System**
+**Trinity Version:** 2.1.0
 **Technology Stack**: {{TECHNOLOGY_STACK}}
 **Framework**: {{PRIMARY_FRAMEWORK}}
 **Last Updated**: {{CURRENT_DATE}}
@@ -225,8 +225,8 @@ Pattern_Prevention_Rate: {{PERCENTAGE}}%
    - Dependencies: {{DEPENDENCIES}}
 
 ### Completed Investigations (This Session)
-- [x] {{COMPLETED_1}} - See: trinity/investigations/{{DATE}}-{{INVESTIGATION}}.md
-- [x] {{COMPLETED_2}} - See: trinity/investigations/{{DATE}}-{{INVESTIGATION}}.md
+- [x] {{COMPLETED_1}} - See: .claude/trinity/investigations/{{DATE}}-{{INVESTIGATION}}.md
+- [x] {{COMPLETED_2}} - See: .claude/trinity/investigations/{{DATE}}-{{INVESTIGATION}}.md
 
 ---
 
@@ -285,7 +285,7 @@ Solution:
 
 Prevention:
   Pattern_Created: {{YES/NO}}
-  Pattern_Location: trinity/patterns/{{PATTERN_FILE}}
+  Pattern_Location: .claude/trinity/patterns/{{PATTERN_FILE}}
   Guidelines_Updated: {{YES/NO}}
 
 Metrics:
@@ -346,7 +346,7 @@ Metrics:
 - **ARCHITECTURE.md**: System design and components
 - **Trinity.md**: Methodology implementation
 - **To-do.md**: Pending fixes and improvements
-- **Pattern Library**: trinity/patterns/
+- **Pattern Library**: .claude/trinity/patterns/
 
 ---
 
@@ -417,7 +417,7 @@ Updates_Required:
   - Active_Issues: Add new issue with P0/P1/P2/P3 priority
   - Issue_Template: Fill with symptoms, root cause, solution
   - Pattern_Check: Is this a recurring issue? Create pattern if yes
-  - Investigation_Link: Link to trinity/investigations/ file if investigation done
+  - Investigation_Link: Link to .claude/trinity/investigations/ file if investigation done
   - Cross_References:
     - To-do.md: Add fix task with priority
     - Technical-Debt.md: Add debt if issue reveals shortcuts
@@ -442,7 +442,7 @@ Updates_Required:
   - Pattern_Frequency: Update occurrence count
   - Related_Issues: Link all issue IDs that match this pattern
   - Prevention_Measures: Document how to prevent this pattern
-  - Pattern_Library: Create pattern file in trinity/patterns/
+  - Pattern_Library: Create pattern file in .claude/trinity/patterns/
   - Cross_References:
     - Technical-Debt.md: Link pattern to debt if applicable
     - CODING-PRINCIPLES.md: Add principle if pattern reveals standard gap
@@ -481,7 +481,7 @@ Updates_Required:
 4. **Link Investigation**: If investigation file exists, link it
 5. **Update Metrics**: Increment counts, update averages
 6. **Cross-Reference**: Update related documents (To-do, Technical-Debt, etc.)
-7. **Pattern Library**: Create trinity/patterns/ file if reusable solution
+7. **Pattern Library**: Create .claude/trinity/patterns/ file if reusable solution
 8. **Update Timestamp**: Set `**Last Updated**: {{CURRENT_DATE}}` to actual date
 
 **Quality Checklist:**
@@ -530,7 +530,7 @@ Updates_Required:
 **Update Frequency**: Real-time (as issues discovered) + session-based
 **Maintained By**: Development team using Trinity Method
 **Referenced By**: `/trinity-end` command for session updates
-**Pattern Library**: Creates trinity/patterns/ files
+**Pattern Library**: Creates .claude/trinity/patterns/ files
 **Last Updated**: {{CURRENT_DATE}}
 
 ---

package/dist/templates/{knowledge-base → trinity/knowledge-base}/TESTING-PRINCIPLES.md.template

@@ -1,6 +1,6 @@
 # Testing Principles
 
-** Trinity Version:** 2.0.9
+**Trinity Version:** 2.1.0
 **Last Updated**: {{date}}
 **Project**: {{projectName}}
 

package/dist/templates/{knowledge-base → trinity/knowledge-base}/Technical-Debt.md.template

@@ -1,5 +1,5 @@
 # Technical Debt Tracking - {{PROJECT_NAME}}
-**Trinity Method v2.0**
+**Trinity Version:** 2.1.0
 **Technology Stack**: {{TECHNOLOGY_STACK}}
 **Framework**: {{PRIMARY_FRAMEWORK}}
 **Last Updated**: {{CURRENT_DATE}}
@@ -402,8 +402,6 @@ const calculateDebtScore = () => {
 - **ARCHITECTURE.md**: System design decisions
 - **Trinity.md**: Methodology implementation
 - **To-do.md**: Actionable task list
-- **Pattern Library**: trinity/patterns/
-
 ---
 
 ## 📝 WHEN TO UPDATE THIS DOCUMENT
@@ -512,7 +510,7 @@ Updates_Required:
   - Debt_Reduction_Plan: Add to Quick Wins or Strategic Improvements
   - Cross_References:
     - ISSUES.md: Link to duplication pattern if causes issues
-    - trinity/patterns/: Create pattern file
+    - Document pattern in Pattern Library section above
 ```
 
 **Scenario: Security Vulnerability Fixed**

package/dist/templates/{knowledge-base → trinity/knowledge-base}/To-do.md.template

@@ -1,5 +1,5 @@
 # To-do List - {{PROJECT_NAME}}
-**Trinity Method v2.0**
+**Trinity Version:** 2.1.0
 **Technology Stack**: {{TECHNOLOGY_STACK}}
 **Framework**: {{PRIMARY_FRAMEWORK}}
 **Last Updated**: {{CURRENT_DATE}}
@@ -29,7 +29,7 @@
 ### Feature Development
 - [ ] **{{FEATURE_1}}**
   - Investigation Required: YES
-  - Pattern Check: trinity/patterns/
+  - Pattern Check: Technical-Debt.md#pattern-library
   - Tests Required: Unit + Integration
   - Documentation: Update ARCHITECTURE.md
   - Estimated: {{TIME_ESTIMATE}}

package/dist/templates/{knowledge-base → trinity/knowledge-base}/Trinity.md.template

@@ -1,5 +1,5 @@
 # Trinity Method Implementation - {{PROJECT_NAME}}
-** Trinity Version:** 2.0.9
+**Trinity Version:** 2.1.0
 **Last Updated**: {{date}}
 **Technology Stack**: {{TECHNOLOGY_STACK}}
 **Framework**: {{PRIMARY_FRAMEWORK}}
@@ -30,12 +30,12 @@ Every feature/fix in {{PROJECT_NAME}} requires investigation:
    - Security considerations
 
 3. **Pattern Discovery** (5 minutes)
-   - Check trinity/patterns/ for existing solutions
+   - Check .claude/trinity/patterns/ for existing solutions
    - Document new patterns if discovered
    - Update pattern library
 
 4. **Documentation** (5 minutes)
-   - Save to trinity/investigations/[date]-[feature].md
+   - Save to .claude/trinity/investigations/[date]-[feature].md
    - Update relevant knowledge base files
    - Link to issues if applicable
 
@@ -103,7 +103,7 @@ Debug_Levels:
 
 ### Pre-Implementation Checklist
 - [ ] Investigation completed
-- [ ] Existing patterns reviewed (trinity/patterns/)
+- [ ] Existing patterns reviewed (.claude/trinity/patterns/)
 - [ ] Performance impact assessed
 - [ ] Security implications considered
 - [ ] Test plan created
@@ -233,7 +233,7 @@ Session_End:
     - Update metrics
 
   3_Archive:
-    - Move to trinity/sessions/[date]/
+    - Move to .claude/trinity/sessions/[date]/
     - Create session summary
     - Update project metrics
     - Plan next session
@@ -245,7 +245,7 @@ Session_End:
 
 ### Pattern Discovery Process
 1. **Identify**: Recognize recurring solutions
-2. **Document**: Create pattern file in trinity/patterns/
+2. **Document**: Create pattern file in .claude/trinity/patterns/
 3. **Validate**: Test pattern effectiveness
 4. **Share**: Update pattern index
 5. **Reuse**: Apply in future implementations

package/dist/templates/trinity/templates/documentation/api-docs/README.md.template

@@ -0,0 +1,218 @@
+# {{PROJECT_NAME}} API Documentation
+
+Complete REST API reference for {{PROJECT_NAME}}.
+
+---
+
+## Overview
+
+{{PROJECT_NAME}} provides **{{ENDPOINT_COUNT}} REST API endpoints** across **{{RESOURCE_COUNT}} resources**.
+
+**Base URL:** `{{API_BASE_URL}}`
+
+**API Version:** {{API_VERSION}}
+
+---
+
+## Authentication
+
+{{AUTHENTICATION}}
+
+---
+
+## Request Format
+
+All requests should include:
+
+```
+Content-Type: application/json
+{{AUTH_HEADER}}
+```
+
+---
+
+## Response Format
+
+All responses are returned in JSON format:
+
+### Success Response
+
+```json
+{
+  "data": { /* Response data */ },
+  "status": "success",
+  "timestamp": "2026-01-15T12:00:00Z"
+}
+```
+
+### Error Response
+
+```json
+{
+  "error": "Error message",
+  "statusCode": 400,
+  "timestamp": "2026-01-15T12:00:00Z",
+  "path": "/api/endpoint"
+}
+```
+
+---
+
+## Status Codes
+
+| Code | Meaning | Description |
+|------|---------|-------------|
+| 200 | OK | Request succeeded |
+| 201 | Created | Resource created successfully |
+| 204 | No Content | Request succeeded, no content to return |
+| 400 | Bad Request | Invalid request parameters |
+| 401 | Unauthorized | Authentication required |
+| 403 | Forbidden | Insufficient permissions |
+| 404 | Not Found | Resource not found |
+| 409 | Conflict | Resource conflict (e.g., duplicate) |
+| 422 | Unprocessable Entity | Validation error |
+| 429 | Too Many Requests | Rate limit exceeded |
+| 500 | Internal Server Error | Server error |
+
+---
+
+## Rate Limiting
+
+{{RATE_LIMITING}}
+
+---
+
+## Pagination
+
+List endpoints support pagination using query parameters:
+
+```
+GET /api/resource?page=1&limit=20
+```
+
+**Parameters:**
+- `page` (integer, default: 1) - Page number
+- `limit` (integer, default: 20, max: 100) - Items per page
+
+**Response includes pagination metadata:**
+
+```json
+{
+  "data": [ /* items */ ],
+  "pagination": {
+    "page": 1,
+    "limit": 20,
+    "total": 150,
+    "totalPages": 8
+  }
+}
+```
+
+---
+
+## Filtering & Sorting
+
+{{FILTERING_SORTING}}
+
+---
+
+## API Resources
+
+{{RESOURCES}}
+
+---
+
+## Endpoints
+
+{{ENDPOINT_DETAILS}}
+
+---
+
+## Error Codes
+
+### Common Errors
+
+{{ERROR_CODES}}
+
+---
+
+## Code Examples
+
+### JavaScript (Fetch)
+
+```javascript
+const response = await fetch('{{API_BASE_URL}}/{{EXAMPLE_ENDPOINT}}', {
+  method: 'GET',
+  headers: {
+    'Content-Type': 'application/json',
+    {{AUTH_HEADER_EXAMPLE}}
+  }
+});
+
+const data = await response.json();
+console.log(data);
+```
+
+### cURL
+
+```bash
+curl -X GET '{{API_BASE_URL}}/{{EXAMPLE_ENDPOINT}}' \
+  -H 'Content-Type: application/json' \
+  {{CURL_AUTH_EXAMPLE}}
+```
+
+### Python (Requests)
+
+```python
+import requests
+
+response = requests.get(
+    '{{API_BASE_URL}}/{{EXAMPLE_ENDPOINT}}',
+    headers={
+        'Content-Type': 'application/json',
+        {{PYTHON_AUTH_EXAMPLE}}
+    }
+)
+
+data = response.json()
+print(data)
+```
+
+---
+
+## Webhooks
+
+{{WEBHOOKS}}
+
+---
+
+## Versioning
+
+{{API_VERSIONING}}
+
+---
+
+## Changelog
+
+{{CHANGELOG}}
+
+---
+
+## Related Documentation
+
+- [Getting Started](../guides/getting-started.md) - Setup and installation
+- [API Development Guide](../guides/api-development.md) - Creating new endpoints
+- [Deployment Guide](../guides/deployment.md) - Production deployment
+
+---
+
+## Support
+
+For API support:
+- **Documentation:** [Full documentation](../README.md)
+- **Issues:** Report bugs via GitHub issues
+- **Questions:** GitHub Discussions
+
+---
+
+*Last updated: {{GENERATION_DATE}}*

package/dist/templates/trinity/templates/documentation/configuration/documentation-structure.md.template

@@ -0,0 +1,71 @@
+# Documentation Structure Configuration
+
+## Template Paths
+
+All documentation templates follow a consistent directory structure:
+
+### Core Templates
+- **Root README**: `src/templates/documentation/ROOT-README.md.template`
+- **Subdirectory README**: `src/templates/documentation/SUBDIRECTORY-README.md.template`
+
+### Mermaid Diagrams (`mermaid-diagrams/`)
+- `mvc-flow.md.template` - MVC architecture flow
+- `database-er.md.template` - Database entity relationships
+- `component-hierarchy.md.template` - Component dependency tree
+- `api-endpoint-map.md.template` - API endpoint organization
+
+### Guides (`guides/`)
+- `getting-started.md.template` - Initial setup and onboarding
+- `api-development.md.template` - API development patterns
+- `deployment.md.template` - Deployment procedures
+- `contributing.md.template` - Contribution guidelines
+
+### API Documentation (`api-docs/`)
+- `README.md.template` - API reference structure
+
+### Configuration (`config/`)
+- `env-example-generator.md.template` - Environment variable examples
+
+### Reports (`reports/`)
+- `juno-final-report.md.template` - Public documentation report
+- `juno-internal-report.md.template` - Internal audit report
+
+### Discovery (`discovery/`)
+- `framework-detection.md.template` - Framework identification patterns
+- `component-discovery.md.template` - Component scanning logic
+- `api-endpoint-scanner.md.template` - API endpoint detection
+- `env-variable-extraction.md.template` - Environment variable parsing
+
+### Validation (`validation/`)
+- `juno-quality-gates.md.template` - Quality gate criteria
+- `documentation-verification-rules.md.template` - Verification rules
+- `apo-self-validation.md.template` - APO self-check procedures
+
+### Processes (`processes/`)
+- `error-handling-protocol.md.template` - Error handling standards
+- `apo-workflow-common.md.template` - Common APO workflow steps
+- `apo-diagram-specific.md.template` - Diagram-specific workflow
+- `apo-guide-specific.md.template` - Guide-specific workflow
+- `apo-config-specific.md.template` - Configuration-specific workflow
+- `fallback-mechanism.md.template` - Fallback procedures
+
+## Component Discovery Patterns
+
+**Search patterns for framework components:**
+- Controllers: `**/*Controller.{js,ts,py,rb,go,java,cs,php}`
+- Models: `**/models/**/*.{js,ts,py,rb,go,java,cs,php}`
+- Services: `**/services/**/*.{js,ts,py,rb,go,java,cs,php}`
+- Routes: `**/routes/**/*.{js,ts,py,rb,go,java,cs,php}`
+
+## Verification Glob Patterns
+
+**Quality gate file checks:**
+```javascript
+const verification_globs = [
+  "docs/**/README.md",
+  "docs/diagrams/**/*.md",
+  "docs/guides/**/*.md",
+  "docs/api/**/*.md",
+  ".env.example"
+];
+```