specweave 1.0.253 → 1.0.255

package/plugins/specweave/templates/coding-standards.md.template

@@ -1,535 +0,0 @@
-# Coding Standards
-
-**Auto-Generated**: {{timestamp}}
-**Codebase**: {{project_name}}
-**Analysis**: {{file_count}} files, {{line_count}} lines of code
-**Overall Confidence**: {{overall_confidence}}%
-
-> 📊 This document combines:
-> - ✅ **Explicit Standards** - Declared in ESLint, Prettier, CLAUDE.md
-> - 📈 **Implicit Standards** - Detected from codebase analysis ({{file_count}} files)
-> - 🚨 **Issues** - Anti-patterns and security concerns
-
----
-
-## Table of Contents
-
-1. [Summary](#summary)
-2. [Naming Conventions](#naming-conventions)
-3. [Import Patterns](#import-patterns)
-4. [Function Guidelines](#function-guidelines)
-5. [Type Safety](#type-safety)
-6. [Error Handling](#error-handling)
-7. [Security](#security)
-8. [Performance](#performance)
-9. [SpecWeave-Specific Rules](#specweave-specific-rules)
-10. [Anti-Patterns & Issues](#anti-patterns--issues)
-11. [Next Steps](#next-steps)
-12. [Appendix](#appendix)
-
----
-
-## Summary
-
-### Confidence Levels
-
-| Level | Criteria | Meaning |
-|-------|----------|---------|
-| **ENFORCED** | 100% | Linter/compiler enforced |
-| **HIGH** | 90%+ | Overwhelming compliance |
-| **MEDIUM** | 70-89% | Majority compliance |
-| **LOW** | 50-69% | Weak pattern |
-| **CONFLICT** | <50% | Inconsistent, needs decision |
-
-### Overall Health
-
-{{overall_health_summary}}
-
----
-
-## 1. Naming Conventions
-
-### Variables
-
-**Standard**: {{variable_naming_standard}}
-**Confidence**: {{variable_naming_confidence}}
-**Compliance**: {{variable_naming_compliance}}%
-**Samples**: {{variable_naming_samples}}
-
-**Enforced by**: {{variable_naming_enforcement}}
-
-**Examples**:
-```typescript
-// ✅ Good ({{variable_naming_good_percent}}% of codebase)
-{{variable_naming_good_examples}}
-
-// ❌ Bad ({{variable_naming_bad_percent}}% of codebase)
-{{variable_naming_bad_examples}}
-```
-
-**Recommendation**: {{variable_naming_recommendation}}
-
----
-
-### Functions
-
-**Standard**: {{function_naming_standard}}
-**Confidence**: {{function_naming_confidence}}
-**Compliance**: {{function_naming_compliance}}%
-**Samples**: {{function_naming_samples}}
-
-**Examples**:
-```typescript
-// ✅ Good
-{{function_naming_good_examples}}
-
-// ❌ Bad
-{{function_naming_bad_examples}}
-```
-
-**Recommendation**: {{function_naming_recommendation}}
-
----
-
-### Classes
-
-**Standard**: {{class_naming_standard}}
-**Confidence**: {{class_naming_confidence}}
-**Compliance**: {{class_naming_compliance}}%
-**Samples**: {{class_naming_samples}}
-
-**Examples**:
-```typescript
-// ✅ Good
-{{class_naming_good_examples}}
-
-// ❌ Bad (if any)
-{{class_naming_bad_examples}}
-```
-
-**Recommendation**: {{class_naming_recommendation}}
-
----
-
-### Constants
-
-**Standard**: {{constant_naming_standard}}
-**Confidence**: {{constant_naming_confidence}}
-**Compliance**: {{constant_naming_compliance}}%
-**Samples**: {{constant_naming_samples}}
-
-**Examples**:
-```typescript
-// ✅ Good
-{{constant_naming_good_examples}}
-
-// ⚠️  Inconsistent ({{constant_naming_bad_percent}}% use different convention)
-{{constant_naming_bad_examples}}
-```
-
-**Recommendation**: {{constant_naming_recommendation}}
-
----
-
-## 2. Import Patterns
-
-### File Extensions
-
-**Standard**: {{import_extension_standard}}
-**Confidence**: {{import_extension_confidence}}
-**Compliance**: {{import_extension_compliance}}%
-
-**Enforced by**: {{import_extension_enforcement}}
-
-**Examples**:
-```typescript
-// ✅ Good ({{import_extension_good_percent}}% compliance)
-{{import_extension_good_examples}}
-
-// ❌ Bad ({{import_extension_bad_percent}}% if any)
-{{import_extension_bad_examples}}
-```
-
-**Recommendation**: {{import_extension_recommendation}}
-
----
-
-### Import Ordering
-
-**Standard**: {{import_ordering_standard}}
-**Confidence**: {{import_ordering_confidence}}
-**Compliance**: {{import_ordering_compliance}}%
-
-**Examples**:
-```typescript
-// ✅ Good ({{import_ordering_good_percent}}% of files)
-{{import_ordering_good_examples}}
-
-// ⚠️  Not followed ({{import_ordering_bad_percent}}% of files)
-{{import_ordering_bad_examples}}
-```
-
-**Recommendation**: {{import_ordering_recommendation}}
-
----
-
-## 3. Function Guidelines
-
-### Function Length
-
-**Detected Pattern**:
-- **Average**: {{function_length_avg}} lines
-- **Median**: {{function_length_median}} lines
-- **90th percentile**: {{function_length_p90}} lines
-- **Max**: {{function_length_max}} lines ({{function_length_max_location}})
-
-**Recommended**: <50 lines (ideal), <100 lines (max)
-
-**Violations** ({{function_length_violations}} functions >100 lines):
-{{function_length_violations_list}}
-
-**Recommendation**: {{function_length_recommendation}}
-
----
-
-### File Size Limits
-
-**Critical for AI-assisted development** - Large files cause context overflow crashes.
-
-| Lines | Status | Action Required |
-|-------|--------|-----------------|
-| 0-500 | ✅ OK | Normal development |
-| 500-1000 | ⚠️ Watch | Review before adding major features |
-| 1000-1500 | 🔶 Large | Extract modules before adding 100+ lines |
-| 1500-2000 | 🔴 Critical | **MUST SPLIT** before any changes |
-| 2000+ | ⛔ Forbidden | Immediate refactor required |
-
-**Current Large Files** ({{large_file_count}} files >1000 lines):
-{{large_files_list}}
-
-**How to Split Large Files**:
-```
-src/feature/module.ts              ← Orchestrator only (300-500 lines)
-src/feature/module/
-├── index.ts                       ← Barrel exports (re-export public API)
-├── types.ts                       ← Interfaces and types
-├── domain-logic-a.ts              ← Single responsibility
-├── domain-logic-b.ts              ← Single responsibility
-└── internal-utils.ts              ← Private helpers
-```
-
-**Split Triggers**:
-- File has 3+ distinct responsibilities
-- Multiple unrelated import groups
-- Testing requires mocking large portions
-- Functions within file don't share state
-
-**Recommendation**: {{file_size_recommendation}}
-
----
-
-### Function Style
-
-**Detected Pattern**:
-- Arrow functions: {{arrow_function_percent}}%
-- Regular functions: {{regular_function_percent}}%
-
-**Examples**:
-```typescript
-// Preferred ({{arrow_function_percent}}% of codebase)
-{{arrow_function_examples}}
-
-// Also acceptable ({{regular_function_percent}}% of codebase)
-{{regular_function_examples}}
-```
-
-**Recommendation**: {{function_style_recommendation}}
-
----
-
-## 4. Type Safety
-
-### Avoid `any` Type
-
-**Detected**: {{any_type_count}} instances of `any` type
-
-**Enforced by**: {{any_type_enforcement}}
-
-**Violations**:
-{{any_type_violations_list}}
-
-**Recommendation**: {{any_type_recommendation}}
-
----
-
-### Interface vs Type
-
-**Detected Pattern**:
-- Interfaces: {{interface_percent}}%
-- Types: {{type_percent}}%
-
-**Examples**:
-```typescript
-// Preferred for objects ({{interface_percent}}% of codebase)
-{{interface_examples}}
-
-// Preferred for unions/aliases ({{type_percent}}% of codebase)
-{{type_examples}}
-```
-
-**Recommendation**: {{interface_type_recommendation}}
-
----
-
-## 5. Error Handling
-
-### Custom Error Types
-
-**Detected**: {{custom_error_count}} custom error classes
-
-**Examples**:
-```typescript
-{{custom_error_examples}}
-```
-
-**Recommendation**: {{custom_error_recommendation}}
-
----
-
-### Try/Catch Usage
-
-**Detected**: {{try_catch_percent}}% of async functions have try/catch
-
-**Examples**:
-```typescript
-// ✅ Good ({{try_catch_good_count}} functions)
-{{try_catch_good_examples}}
-
-// ⚠️  Missing error handling ({{try_catch_missing_count}} functions)
-{{try_catch_missing_list}}
-```
-
-**Recommendation**: {{try_catch_recommendation}}
-
----
-
-## 6. Security
-
-### No Hardcoded Secrets
-
-**Status**: {{hardcoded_secrets_status}}
-
-**Violations** ({{hardcoded_secrets_count}} instances):
-{{hardcoded_secrets_list}}
-
-**Recommendation**: {{hardcoded_secrets_recommendation}}
-
----
-
-### No console.* in Production
-
-**Status**: {{console_usage_status}}
-
-**Violations** ({{console_usage_count}} instances):
-{{console_usage_list}}
-
-**Recommendation**: {{console_usage_recommendation}}
-
----
-
-## 7. Performance
-
-### No N+1 Queries
-
-**Status**: {{n_plus_one_status}}
-
-{{n_plus_one_details}}
-
-**Recommendation**: {{n_plus_one_recommendation}}
-
----
-
-## 8. SpecWeave-Specific Rules
-
-### 1. Logger Abstraction
-
-**Rule**: NEVER use console.* in src/
-
-**Compliance**: {{logger_compliance}}%
-
-**Violations**: {{logger_violations_count}} instances
-
-**Correct usage**:
-```typescript
-import { logger } from '../utils/logger.js';
-logger.info('Message');
-logger.error('Error', error);
-```
-
----
-
-### 2. Test File Naming
-
-**Rule**: Use .test.ts suffix (NEVER .spec.ts)
-
-**Compliance**: {{test_naming_compliance}}%
-
----
-
-### 3. Import Extensions
-
-**Rule**: ALWAYS use .js extensions for ESM compatibility
-
-**Compliance**: {{import_extension_compliance}}%
-
----
-
-### 4. Root Directory Cleanliness
-
-**Rule**: NEVER create files in project root - use increment folders
-
-**Critical**: Project root MUST stay clean. All AI-generated files belong in increment folders.
-
-**Allowed root files ONLY**:
-- `README.md`, `CLAUDE.md`, `AGENTS.md`, `CHANGELOG.md`
-- `LICENSE`, `CODE_OF_CONDUCT.md`, `SECURITY.md`
-- `IMPLEMENTATION-SUMMARY.md`, `IMPLEMENTATION-COMPLETE.md` (project docs only)
-- `package.json`, `tsconfig*.json`, config files
-
-**Increment folder structure**:
-```
-✅ CORRECT - organized increment folder
-.specweave/increments/0001-feature/
-├── metadata.json                  # REQUIRED
-├── spec.md                        # WHAT & WHY
-├── plan.md                        # HOW (optional)
-├── tasks.md                       # Task checklist
-├── reports/                       # ALL other .md files
-│   ├── analysis.md
-│   ├── validation-report.md
-│   └── completion-report.md
-├── scripts/                       # Helper scripts
-└── logs/                          # Execution logs
-    └── 2026-01-04/
-
-❌ WRONG - polluted increment folder
-.specweave/increments/0001-feature/
-├── metadata.json
-├── spec.md
-├── tasks.md
-├── analysis.md                   # WRONG! → reports/
-├── some-report.md                # WRONG! → reports/
-└── helper.sh                     # WRONG! → scripts/
-```
-
-**File destination rules**:
-| File Type | Destination |
-|-----------|-------------|
-| Reports, analysis, summaries (*.md) | `reports/` |
-| Validation/QA/completion reports | `reports/` |
-| Auto-session summaries | `reports/` |
-| Logs, execution output | `logs/{YYYY-MM-DD}/` |
-| Helper scripts | `scripts/` |
-| Domain docs | `docs/domain/` |
-
-**Enforcement**: Pre-commit hook #13 blocks staging root pollution files
-
----
-
-## 9. Anti-Patterns & Issues
-
-### 🔴 CRITICAL ({{critical_issues_count}} issues)
-
-{{critical_issues_list}}
-
----
-
-### 🟠 HIGH ({{high_issues_count}} issues)
-
-{{high_issues_list}}
-
----
-
-### 🟡 MEDIUM ({{medium_issues_count}} issues)
-
-{{medium_issues_list}}
-
----
-
-### 🟢 LOW
-
-{{low_issues_summary}}
-
----
-
-## 10. Next Steps
-
-### Critical (Fix Immediately)
-{{critical_next_steps}}
-
-### High Priority (This Sprint)
-{{high_priority_next_steps}}
-
-### Medium Priority (Next Sprint)
-{{medium_priority_next_steps}}
-
-### Documentation
-{{documentation_next_steps}}
-
----
-
-## 11. Appendix
-
-### Configuration Files
-
-#### .eslintrc.json
-```json
-{{eslint_config}}
-```
-
-#### .prettierrc
-```json
-{{prettier_config}}
-```
-
-#### tsconfig.json (relevant sections)
-```json
-{{tsconfig_config}}
-```
-
----
-
-### Statistics
-
-| Metric | Value |
-|--------|-------|
-| Total Files | {{file_count}} |
-| Total LOC | {{line_count}} |
-| Variables Analyzed | {{variable_count}} |
-| Functions Analyzed | {{function_count}} |
-| Classes Analyzed | {{class_count}} |
-| Imports Analyzed | {{import_count}} |
-| Analysis Duration | {{analysis_duration}} |
-
----
-
-### Change Log
-
-**Previous Analysis**: {{previous_analysis_date}}
-**This Analysis**: {{current_analysis_date}}
-
-**Changes Since Last Analysis**:
-{{change_log}}
-
----
-
-## Metadata
-
-**Generated by**: SpecWeave code-standards-detective agent
-**Version**: {{specweave_version}}
-**Analysis Date**: {{analysis_date}}
-**Next Review**: {{next_review_date}} (recommended: quarterly)
-
----
-
-*This document is auto-generated. For questions or updates, consult the development team.*

package/plugins/specweave/templates/hookify/README.md

@@ -1,47 +0,0 @@
-# SpecWeave Hookify Templates
-
-Pre-configured [Hookify](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/hookify) rules for SpecWeave conventions.
-
-## Installation
-
-Copy desired templates to your project's `.claude/` directory:
-
-```bash
-# Copy all templates
-cp plugins/specweave/templates/hookify/*.local.md .claude/
-
-# Or copy specific templates
-cp plugins/specweave/templates/hookify/hookify.block-metadata-status.local.md .claude/
-```
-
-## Available Templates
-
-| Template | Action | Purpose |
-|----------|--------|---------|
-| `hookify.block-metadata-status.local.md` | block | Prevents direct metadata.json edits to status |
-| `hookify.warn-root-files.local.md` | warn | Warns when creating markdown files at project root |
-| `hookify.block-force-push.local.md` | block | Blocks force push to main/master branches |
-| `hookify.block-secrets.local.md` | block | Blocks hardcoded API keys and tokens |
-| `hookify.warn-dangerous-rm.local.md` | warn | Warns on dangerous rm -rf commands |
-| `hookify.require-tests.local.md` | warn | Reminds to run tests before commit (disabled by default) |
-
-## Customization
-
-Edit any template to adjust:
-- `enabled: true/false` - Turn rule on/off
-- `action: warn/block` - Warning vs hard block
-- `pattern:` - Regex pattern to match
-
-## Hookify Commands
-
-| Command | Purpose |
-|---------|---------|
-| `/hookify` | Analyze conversation for patterns to create rules |
-| `/hookify [description]` | Create rule from description |
-| `/hookify:list` | List all active rules |
-| `/hookify:configure` | Enable/disable rules interactively |
-
-## Learn More
-
-- [Hookify Plugin Documentation](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/hookify)
-- [ADR-0226: Claude Code Plugin Integration](../../.specweave/docs/internal/architecture/adr/0226-claude-code-official-plugin-integration.md)

package/plugins/specweave/templates/hookify/hookify.block-force-push.local.md

@@ -1,19 +0,0 @@
----
-name: block-force-push-main
-enabled: true
-event: bash
-action: block
-conditions:
-  - field: command
-    operator: regex_match
-    pattern: git\s+push.*--force.*main|git\s+push.*-f.*main|git\s+push.*--force.*master|git\s+push.*-f.*master
----
-
-**Force push to main/master branch blocked!**
-
-This is a destructive operation that can cause data loss.
-
-If you really need to force push:
-1. Create a backup branch first: `git branch backup-$(date +%Y%m%d)`
-2. Get explicit user confirmation
-3. Consider using `--force-with-lease` instead (safer)

package/plugins/specweave/templates/hookify/hookify.block-metadata-status.local.md

@@ -1,18 +0,0 @@
----
-name: block-metadata-status
-enabled: true
-event: file
-action: block
-conditions:
-  - field: file_path
-    operator: regex_match
-    pattern: metadata\.json$
-  - field: new_text
-    operator: regex_match
-    pattern: "status":\s*"completed"
----
-
-**Direct metadata.json status edit blocked!**
-
-Use `/sw:done <increment-id>` to properly close increments.
-This ensures all quality gates are validated before marking complete.

package/plugins/specweave/templates/hookify/hookify.block-secrets.local.md

@@ -1,26 +0,0 @@
----
-name: block-hardcoded-secrets
-enabled: true
-event: file
-action: block
-conditions:
-  - field: file_path
-    operator: not_contains
-    pattern: \.env
-  - field: new_text
-    operator: regex_match
-    pattern: (sk-[a-zA-Z0-9]{20,}|ghp_[a-zA-Z0-9]{36}|AKIA[A-Z0-9]{16}|xox[baprs]-[a-zA-Z0-9-]+)
----
-
-**Potential secret detected in code!**
-
-Never hardcode API keys or tokens in source files. Use:
-- `.env` files (ensure added to .gitignore)
-- Environment variables
-- Secret management services (Vault, AWS Secrets Manager, etc.)
-
-Detected patterns:
-- OpenAI API keys (sk-...)
-- GitHub Personal Access Tokens (ghp_...)
-- AWS Access Key IDs (AKIA...)
-- Slack tokens (xox...)

package/plugins/specweave/templates/hookify/hookify.require-tests.local.md

@@ -1,22 +0,0 @@
----
-name: require-tests-before-commit
-enabled: false
-event: bash
-action: warn
-conditions:
-  - field: command
-    operator: regex_match
-    pattern: git\s+commit
----
-
-**Committing without running tests?**
-
-Best practice is to run tests before committing:
-- `npm test` - Unit tests
-- `npx vitest run` - Vitest
-- `npx playwright test` - E2E tests
-
-To enable strict enforcement:
-1. Edit this file
-2. Change `enabled: false` to `enabled: true`
-3. Change `action: warn` to `action: block`

package/plugins/specweave/templates/hookify/hookify.warn-dangerous-rm.local.md

@@ -1,23 +0,0 @@
----
-name: warn-dangerous-rm
-enabled: true
-event: bash
-action: warn
-conditions:
-  - field: command
-    operator: regex_match
-    pattern: rm\s+-rf\s+(/|~|\$HOME|\*|\.\./)
----
-
-**Dangerous rm command detected!**
-
-This command could delete important files or entire directories.
-
-Please verify:
-- The path is correct
-- You have backups if needed
-- This is intentional
-
-Consider using safer alternatives:
-- `trash` command (moves to trash instead of permanent delete)
-- `rm -i` (interactive mode, confirms each file)

package/plugins/specweave/templates/hookify/hookify.warn-root-files.local.md

@@ -1,21 +0,0 @@
----
-name: warn-root-files
-enabled: true
-event: file
-action: warn
-conditions:
-  - field: file_path
-    operator: regex_match
-    pattern: ^[^/]+\.md$
-  - field: file_path
-    operator: not_contains
-    pattern: README|CLAUDE|AGENTS|CHANGELOG|LICENSE|CODE_OF_CONDUCT|SECURITY
----
-
-**Root-level markdown file detected!**
-
-SpecWeave files should go in:
-- `.specweave/increments/<id>/` for increment docs
-- `.specweave/docs/internal/` for living docs
-
-Only README.md, CLAUDE.md, AGENTS.md, CHANGELOG.md allowed at root.