trinity-method-sdk 2.0.0

package/dist/templates/knowledge-base/Trinity.md.template

@@ -0,0 +1,464 @@
+# Trinity Method Implementation - {{PROJECT_NAME}}
+**Version**: 7.0
+**Technology Stack**: {{TECHNOLOGY_STACK}}
+**Framework**: {{PRIMARY_FRAMEWORK}}
+**Last Updated**: {{CURRENT_DATE}}
+
+---
+
+## PROJECT-SPECIFIC TRINITY PROTOCOLS
+
+### {{FRAMEWORK}} Investigation Procedures
+
+#### Pre-Implementation Investigation
+Every feature/fix in {{PROJECT_NAME}} requires investigation:
+
+1. **Scope Definition** (5 minutes)
+   ```yaml
+   Investigation_Scope:
+     Feature: {{FEATURE_NAME}}
+     Components_Affected: [List components]
+     Success_Criteria: [Define clear criteria]
+     Time_Box: 30 minutes maximum
+   ```
+
+2. **{{FRAMEWORK}}-Specific Analysis** (15 minutes)
+   - Component dependencies in {{FRAMEWORK}}
+   - State management implications
+   - Performance impact assessment
+   - Security considerations
+
+3. **Pattern Discovery** (5 minutes)
+   - Check trinity/patterns/ for existing solutions
+   - Document new patterns if discovered
+   - Update pattern library
+
+4. **Documentation** (5 minutes)
+   - Save to trinity/investigations/[date]-[feature].md
+   - Update relevant knowledge base files
+   - Link to issues if applicable
+
+---
+
+## {{PROJECT_NAME}} DEBUGGING STANDARDS
+
+### Mandatory Debug Implementation
+
+#### {{LANGUAGE}} Debug Pattern
+```{{LANGUAGE}}
+{{DEBUG_ENTRY_PATTERN}}
+
+// Function logic here
+
+{{DEBUG_EXIT_PATTERN}}
+```
+
+#### Framework-Specific Debug Points
+1. **Component Lifecycle** ({{FRAMEWORK}}):
+   {{LIFECYCLE_DEBUG_POINTS}}
+
+2. **State Changes**:
+   {{STATE_DEBUG_POINTS}}
+
+3. **API Calls**:
+   {{API_DEBUG_POINTS}}
+
+4. **Error Boundaries**:
+   {{ERROR_DEBUG_POINTS}}
+
+### Debug Levels
+```yaml
+Debug_Levels:
+  VERBOSE: All entry/exit points
+  INFO: Key operations only
+  WARN: Potential issues
+  ERROR: Failures only
+  SILENT: Production mode
+```
+
+---
+
+## PERFORMANCE STANDARDS
+
+### {{PROJECT_NAME}} Performance Baselines
+
+| Metric | Target | Warning | Critical | {{FRAMEWORK}} Notes |
+|--------|--------|---------|----------|---------------------|
+| Initial Load | <{{LOAD_TARGET}}ms | >{{LOAD_WARNING}}ms | >{{LOAD_CRITICAL}}ms | {{LOAD_NOTES}} |
+| Interaction | <{{INTERACTION_TARGET}}ms | >{{INTERACTION_WARNING}}ms | >{{INTERACTION_CRITICAL}}ms | {{INTERACTION_NOTES}} |
+| API Response | <{{API_TARGET}}ms | >{{API_WARNING}}ms | >{{API_CRITICAL}}ms | {{API_NOTES}} |
+| Memory Usage | <{{MEMORY_TARGET}}MB | >{{MEMORY_WARNING}}MB | >{{MEMORY_CRITICAL}}MB | {{MEMORY_NOTES}} |
+| Bundle Size | <{{BUNDLE_TARGET}}KB | >{{BUNDLE_WARNING}}KB | >{{BUNDLE_CRITICAL}}KB | {{BUNDLE_NOTES}} |
+
+### Performance Monitoring
+```{{LANGUAGE}}
+// Performance monitoring wrapper
+{{PERFORMANCE_MONITORING_PATTERN}}
+```
+
+---
+
+## QUALITY GATES
+
+### Pre-Implementation Checklist
+- [ ] Investigation completed
+- [ ] Existing patterns reviewed (trinity/patterns/)
+- [ ] Performance impact assessed
+- [ ] Security implications considered
+- [ ] Test plan created
+- [ ] Documentation plan defined
+
+### Pre-Commit Checklist
+- [ ] All tests passing
+- [ ] Debug logging implemented
+- [ ] Performance baselines met
+- [ ] No console errors
+- [ ] Code review completed
+- [ ] Documentation updated
+
+### Pre-Deploy Checklist
+- [ ] Integration tests passing
+- [ ] Performance tests passing
+- [ ] Security scan clean
+- [ ] Rollback plan defined
+- [ ] Monitoring configured
+- [ ] Team notified
+
+---
+
+## CRISIS MANAGEMENT PROTOCOLS
+
+### {{FRAMEWORK}}-Specific Quality Indicators
+
+#### Console Error Monitoring
+**Trigger**: >{{ERROR_THRESHOLD}} console errors
+**Response Protocol**:
+1. Screenshot all errors
+2. Enable verbose debugging
+3. Trace error sources
+4. Document in ISSUES.md with error pattern analysis
+5. Implement fixes with full debugging
+6. Update error handling patterns
+
+#### Performance Monitoring
+**Trigger**: Performance degradation >{{PERF_DEGRADATION_THRESHOLD}}%
+**Response Protocol**:
+1. Profile current performance
+2. Compare with baselines
+3. Identify bottlenecks
+4. Document in Technical-Debt.md
+5. Implement optimizations
+6. Update performance baselines
+
+#### Security Monitoring
+**Trigger**: Security vulnerability discovered
+**Response Protocol**:
+1. Isolate vulnerability
+2. Assess impact scope
+3. Implement immediate patch
+4. Full security audit
+5. Update security protocols
+6. Document in ISSUES.md
+
+#### Data Integrity Monitoring
+**Trigger**: Data inconsistency detected
+**Response Protocol**:
+1. Halt write operations
+2. Backup current state
+3. Audit data sources
+4. Identify corruption point
+5. Restore integrity
+6. Implement validation checks
+
+---
+
+## SESSION WORKFLOW
+
+### Session Initialization Protocol
+```yaml
+Session_Start:
+  1_Load_Context:
+    - Read CLAUDE.md hierarchy
+    - Review To-do.md
+    - Check Technical-Debt.md
+    - Load recent investigations
+
+  2_Health_Check:
+    - Run test suite
+    - Check build system
+    - Verify dependencies
+    - Check performance baselines
+
+  3_Session_Setup:
+    - Create session folder
+    - Initialize session log
+    - Set session goals
+    - Start time tracking
+```
+
+### Session Work Protocol
+```yaml
+Session_Work:
+  Investigation_First:
+    - Always investigate before implementing
+    - Document findings
+    - Check for patterns
+
+  Implementation:
+    - Follow {{FRAMEWORK}} best practices
+    - Implement debugging
+    - Write tests alongside code
+    - Monitor performance
+
+  Validation:
+    - Run tests frequently
+    - Check performance impact
+    - Verify no console errors
+```
+
+### Session Completion Protocol
+```yaml
+Session_End:
+  1_Documentation:
+    - Update ARCHITECTURE.md
+    - Update To-do.md
+    - Document issues in ISSUES.md
+    - Archive investigations
+
+  2_Knowledge_Capture:
+    - Save new patterns
+    - Update Technical-Debt.md
+    - Record decisions
+    - Update metrics
+
+  3_Archive:
+    - Move to trinity/sessions/[date]/
+    - Create session summary
+    - Update project metrics
+    - Plan next session
+```
+
+---
+
+## PATTERN LIBRARY INTEGRATION
+
+### Pattern Discovery Process
+1. **Identify**: Recognize recurring solutions
+2. **Document**: Create pattern file in trinity/patterns/
+3. **Validate**: Test pattern effectiveness
+4. **Share**: Update pattern index
+5. **Reuse**: Apply in future implementations
+
+### Pattern Template
+```markdown
+# Pattern: {{PATTERN_NAME}}
+**Category**: {{CATEGORY}}
+**Framework**: {{FRAMEWORK}}
+**Frequency**: {{FREQUENCY}}
+
+## Problem
+{{PROBLEM_DESCRIPTION}}
+
+## Solution
+\```{{LANGUAGE}}
+{{SOLUTION_CODE}}
+\```
+
+## Usage
+{{USAGE_INSTRUCTIONS}}
+
+## Trade-offs
+{{TRADE_OFFS}}
+```
+
+---
+
+## SUCCESS METRICS
+
+### Trinity Method Metrics
+```javascript
+const trinityMetrics = {
+  // Investigation effectiveness
+  investigationSuccessRate: 0,      // Issues prevented by investigation
+  averageInvestigationTime: 0,      // Minutes per investigation
+
+  // Pattern library growth
+  patternsDiscovered: 0,            // New patterns this period
+  patternReuseRate: 0,              // Patterns reused vs created
+
+  // Issue prevention
+  issuesPreventedByPatterns: 0,     // Issues avoided through patterns
+  issueRecurrenceRate: 0,           // Issues that reappear
+
+  // Quality metrics
+  firstTimeFixRate: 0,              // Fixes that work first time
+  qualityGatePassRate: 0,           // Commits passing all gates
+
+  // Performance maintenance
+  performanceRegressions: 0,        // Times performance degraded
+  performanceImprovements: 0,       // Times performance improved
+
+  // Crisis management
+  crisisesAvoided: 0,               // Crises prevented by protocols
+  crisisResolutionTime: 0,          // Average crisis resolution time
+};
+```
+
+### Reporting Schedule
+- **Daily**: Update session metrics
+- **Weekly**: Review success metrics
+- **Monthly**: Full Trinity Method audit
+
+---
+
+## CONTINUOUS IMPROVEMENT
+
+### Methodology Evolution
+1. **Feedback Loop**: Collect team feedback weekly
+2. **Pattern Analysis**: Review pattern effectiveness monthly
+3. **Process Refinement**: Update protocols based on learnings
+4. **Tool Enhancement**: Improve tooling and automation
+
+### Knowledge Growth Strategy
+- Document every investigation
+- Capture every pattern
+- Track every issue resolution
+- Archive every session
+
+---
+
+## TEAM PROTOCOLS
+
+### Role Definitions
+- **TRINITY CTO**: Methodology enforcement and evolution
+- **Developers**: Investigation-first implementation
+- **Reviewers**: Quality gate verification
+
+### Communication Standards
+- Investigation findings shared immediately
+- Patterns documented within session
+- Issues reported as discovered
+- Metrics reviewed weekly
+
+---
+
+## TECHNOLOGY-SPECIFIC ADAPTATIONS
+
+### {{FRAMEWORK}} Specific Rules
+{{FRAMEWORK_SPECIFIC_RULES}}
+
+### {{LANGUAGE}} Specific Patterns
+{{LANGUAGE_SPECIFIC_PATTERNS}}
+
+### {{PROJECT_NAME}} Custom Protocols
+{{CUSTOM_PROTOCOLS}}
+
+---
+
+## 📝 WHEN TO UPDATE THIS DOCUMENT
+
+This is a **living methodology document** that evolves as the team learns better development practices.
+
+### Immediate Updates Required ⚠️
+
+Update **when protocols change** (rare):
+
+- ✅ **Investigation Protocol Changed**: Update investigation procedures if team finds better approach
+- ✅ **Debugging Standard Modified**: Update debug patterns if framework/tools change
+- ✅ **Performance Baseline Changed**: Update targets after major optimization or framework upgrade
+- ✅ **Quality Gate Modified**: Update BAS phases if team adjusts quality criteria
+- ✅ **Crisis Protocol Triggered**: Document new crisis management procedures after incident
+
+### Session Updates (Via `/trinity-end`) 🔄
+
+Update at end of sessions **only if** methodology improved:
+
+- Success metrics (add session statistics)
+- Pattern library updates (new patterns discovered)
+- Session workflow improvements (better process found)
+- Investigation time adjustments (if team getting faster/slower)
+
+### Monthly Reviews 📅
+
+Trinity Method effectiveness assessment:
+
+- Review success metrics trends
+- Evaluate investigation-first effectiveness
+- Assess pattern library growth
+- Analyze crisis prevention success rate
+- Update methodology based on learnings
+
+### Cross-Document Update Triggers 🔗
+
+**When updating Trinity.md, also check:**
+
+- **[AI-DEVELOPMENT-GUIDE.md](./AI-DEVELOPMENT-GUIDE.md)**: Update workflows if Trinity protocols change
+- **[ISSUES.md](./ISSUES.md)**: Add Trinity Method pattern if process issue discovered
+
+### Update Scenarios - What to Change
+
+**Scenario: Investigation Time Box Changed**
+```yaml
+Updates_Required:
+  - Investigation_Procedures: Update time box (e.g., 30min → 45min)
+  - Rationale: Document why change made
+  - Success_Metrics: Track if change improves outcomes
+```
+
+**Scenario: New Debug Pattern Discovered**
+```yaml
+Updates_Required:
+  - Debugging_Standards: Add new pattern to framework-specific section
+  - Debug_Example: Provide code example
+  - Cross_References:
+    - CODING-PRINCIPLES.md: Add if pattern reveals coding standard
+```
+
+**Scenario: Performance Baseline Adjusted**
+```yaml
+Updates_Required:
+  - Performance_Standards: Update baseline metrics
+  - Baseline_Rationale: Document why targets changed
+  - Cross_References:
+    - ARCHITECTURE.md: Update Performance Architecture section
+```
+
+### How to Update
+
+**Step-by-step process:**
+
+1. **Validate Change**: Is this improving methodology or just project-specific?
+2. **Update Section**: Modify protocols, baselines, or workflows
+3. **Document Rationale**: Why was this change made?
+4. **Update Metrics**: Adjust success criteria if needed
+5. **Update Timestamp**: Set `Last Updated: {{CURRENT_DATE}}`
+
+**Quality Checklist:**
+- [ ] Change improves methodology (not just one-off adjustment)
+- [ ] Rationale documented (why change made)
+- [ ] Examples match project's framework/language
+- [ ] Success metrics updated to measure improvement
+- [ ] Related documents updated (AI-DEV-GUIDE, ISSUES)
+
+### When NOT to Update ❌
+
+**Don't update if:**
+- Project-specific change (belongs in ARCHITECTURE or ISSUES)
+- One-time exception (not a protocol change)
+- Framework-specific issue (document in ISSUES.md instead)
+- Only updating placeholders with project values (done during /trinity-init)
+
+**This document changes infrequently** - only update when methodology itself improves.
+
+---
+
+**Document Status**: Living Methodology Document
+**Update Frequency**: Rare (only when methodology improves)
+**Maintained By**: Development team using Trinity Method
+**Referenced By**: `/trinity-end` for success metrics only
+**Last Updated**: {{CURRENT_DATE}}
+
+---
+
+*Trinity Method implementation specific to {{PROJECT_NAME}}*
+*Continuously evolved based on project learnings*

package/dist/templates/linting/flutter/.pre-commit-config.yaml.template

@@ -0,0 +1,27 @@
+# {{PROJECT_NAME}} - Pre-commit Configuration
+# Trinity Method v{{TRINITY_VERSION}}
+
+repos:
+  - repo: local
+    hooks:
+      - id: dart-format
+        name: dart format
+        entry: dart format
+        language: system
+        files: \.dart$
+        pass_filenames: true
+
+      - id: dart-analyze
+        name: dart analyze
+        entry: dart analyze
+        language: system
+        files: \.dart$
+        pass_filenames: false
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-merge-conflict

package/dist/templates/linting/flutter/analysis_options.yaml.template

@@ -0,0 +1,26 @@
+# {{PROJECT_NAME}} - Dart Analysis Options
+# Trinity Method v{{TRINITY_VERSION}}
+
+include: package:flutter_lints/flutter.yaml
+
+analyzer:
+  exclude:
+    - "**/*.g.dart"
+    - "**/*.freezed.dart"
+  errors:
+    invalid_annotation_target: ignore
+  strong-mode:
+    implicit-casts: false
+    implicit-dynamic: false
+
+linter:
+  rules:
+    - always_declare_return_types
+    - avoid_print
+    - avoid_unnecessary_containers
+    - prefer_const_constructors
+    - prefer_const_literals_to_create_immutables
+    - prefer_final_fields
+    - prefer_final_locals
+    - sort_child_properties_last
+    - use_key_in_widget_constructors

package/dist/templates/linting/nodejs/.eslintrc-commonjs.json.template

@@ -0,0 +1,19 @@
+{
+  "env": {
+    "es2021": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended"
+  ],
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "script"
+  },
+  "rules": {
+    "no-console": "off",
+    "no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "prefer-const": "warn",
+    "no-var": "error"
+  }
+}

package/dist/templates/linting/nodejs/.eslintrc-esm.json.template

@@ -0,0 +1,19 @@
+{
+  "env": {
+    "es2021": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended"
+  ],
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "rules": {
+    "no-console": "off",
+    "no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "prefer-const": "warn",
+    "no-var": "error"
+  }
+}

package/dist/templates/linting/nodejs/.eslintrc-typescript.json.template

@@ -0,0 +1,22 @@
+{
+  "env": {
+    "es2021": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint"],
+  "rules": {
+    "no-console": "off",
+    "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-explicit-any": "warn"
+  }
+}

package/dist/templates/linting/nodejs/.pre-commit-config.yaml.template

@@ -0,0 +1,51 @@
+# {{PROJECT_NAME}} - Trinity Method Pre-commit Hooks
+# Trinity Method v{{TRINITY_VERSION}}
+# Framework: {{FRAMEWORK}}
+# Generated by: EIN (CI/CD Specialist)
+# Install: pip install pre-commit && pre-commit install
+
+repos:
+  # Linting and Formatting
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-added-large-files
+        args: ['--maxkb=500']
+      - id: check-merge-conflict
+      - id: detect-private-key
+
+  # ESLint for JavaScript/TypeScript
+  - repo: https://github.com/pre-commit/mirrors-eslint
+    rev: v8.56.0
+    hooks:
+      - id: eslint
+        files: \.(js|jsx|ts|tsx)$
+        args: ['--fix']
+        additional_dependencies:
+          - eslint
+          - '@typescript-eslint/eslint-plugin'
+          - '@typescript-eslint/parser'
+
+  # TypeScript type checking
+  - repo: local
+    hooks:
+      - id: tsc
+        name: TypeScript Compiler
+        entry: npx tsc --noEmit
+        language: system
+        types: [typescript]
+        pass_filenames: false
+
+  # Run tests for modified files
+  - repo: local
+    hooks:
+      - id: jest-changed
+        name: Jest (Changed Files)
+        entry: npm test -- --findRelatedTests --passWithNoTests
+        language: system
+        types: [javascript, typescript]
+        pass_filenames: true

package/dist/templates/linting/nodejs/.prettierrc.json.template

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/dist/templates/linting/python/.flake8.template

@@ -0,0 +1,16 @@
+# {{PROJECT_NAME}} - Flake8 Configuration
+# Trinity Method v{{TRINITY_VERSION}}
+
+[flake8]
+max-line-length = 100
+extend-ignore = E203, E266, E501, W503
+exclude =
+    .git,
+    __pycache__,
+    .venv,
+    venv,
+    build,
+    dist,
+    *.egg-info
+per-file-ignores =
+    __init__.py:F401

package/dist/templates/linting/python/.pre-commit-config.yaml.template

@@ -0,0 +1,30 @@
+# {{PROJECT_NAME}} - Pre-commit Configuration
+# Trinity Method v{{TRINITY_VERSION}}
+
+repos:
+  - repo: https://github.com/psf/black
+    rev: 23.9.1
+    hooks:
+      - id: black
+        language_version: python3
+
+  - repo: https://github.com/pycqa/flake8
+    rev: 6.1.0
+    hooks:
+      - id: flake8
+
+  - repo: https://github.com/pycqa/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+        args: ["--profile", "black"]
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-ast