wogiflow 1.0.0

package/templates/context/constraints.md

@@ -0,0 +1,83 @@
+# Project Constraints
+
+**IMMUTABLE** - These rules cannot be changed without explicit human approval.
+AI assistants must follow these constraints absolutely.
+
+---
+
+## Architecture Constraints
+
+### AC-001: Template Constraint
+**Added**: {{date}}
+**Reason**: [why this constraint exists]
+**Rule**: [the specific constraint]
+
+<!-- Add more architecture constraints as needed -->
+
+---
+
+## Security Constraints
+
+### SC-001: No Secrets in Code
+**Added**: {{date}}
+**Reason**: Security best practice
+**Rule**: Never hardcode API keys, passwords, tokens, or secrets. Use environment variables.
+
+### SC-002: Input Validation Required
+**Added**: {{date}}
+**Reason**: Prevent injection attacks
+**Rule**: All user input must be validated and sanitized before use.
+
+<!-- Add more security constraints as needed -->
+
+---
+
+## Performance Constraints
+
+<!-- Add performance constraints here -->
+<!-- Example:
+### PC-001: Bundle Size Limit
+**Added**: {{date}}
+**Reason**: Performance budget
+**Rule**: Main bundle must not exceed 200KB gzipped.
+-->
+
+---
+
+## Compatibility Constraints
+
+<!-- Add compatibility constraints here -->
+<!-- Example:
+### CC-001: Browser Support
+**Added**: {{date}}
+**Reason**: User base requirements
+**Rule**: Must support last 2 versions of Chrome, Firefox, Safari, Edge.
+-->
+
+---
+
+## Process Constraints
+
+### PR-001: No Direct Main Commits
+**Added**: {{date}}
+**Reason**: Code review requirement
+**Rule**: All changes must go through pull requests. No direct commits to main/master.
+
+<!-- Add more process constraints as needed -->
+
+---
+
+## Data Constraints
+
+<!-- Add data constraints here -->
+<!-- Example:
+### DC-001: PII Handling
+**Added**: {{date}}
+**Reason**: Privacy compliance
+**Rule**: Personal identifiable information must be encrypted at rest and in transit.
+-->
+
+---
+
+*This file is append-only. To modify existing constraints, request explicit human review.*
+*Constraints can only be removed or modified by a human, never by AI.*

package/templates/context/conventions.md

@@ -0,0 +1,177 @@
+# Coding Conventions
+
+Patterns and conventions for this project. AI can propose updates via diff.
+
+---
+
+## Naming Conventions
+
+### Files & Directories
+| Type | Convention | Example |
+|------|------------|---------|
+| Components | PascalCase | `UserProfile.tsx` |
+| Hooks | camelCase with `use` prefix | `useAuth.ts` |
+| Utilities | camelCase | `formatDate.ts` |
+| Constants | SCREAMING_SNAKE_CASE file | `API_ENDPOINTS.ts` |
+| Types | PascalCase with `.types.ts` | `User.types.ts` |
+| Tests | Same name with `.test.ts` | `UserProfile.test.tsx` |
+
+### Variables & Functions
+| Type | Convention | Example |
+|------|------------|---------|
+| Variables | camelCase | `userName` |
+| Constants | SCREAMING_SNAKE_CASE | `MAX_RETRIES` |
+| Booleans | `is/has/should/can` prefix | `isLoading`, `hasError` |
+| Event handlers | `handle` prefix | `handleSubmit` |
+| Async functions | verb-noun pattern | `fetchUser`, `createPost` |
+| Private | underscore prefix (optional) | `_internalHelper` |
+
+### Components & Classes
+| Type | Convention | Example |
+|------|------------|---------|
+| React Components | PascalCase | `UserProfile` |
+| Classes | PascalCase | `ApiClient` |
+| Interfaces | PascalCase, no `I` prefix | `User`, `Config` |
+| Type aliases | PascalCase | `UserId`, `ApiResponse` |
+| Enums | PascalCase, UPPER members | `Status.ACTIVE` |
+
+---
+
+## Code Structure
+
+### File Organization
+```
+// 1. External imports (React, libraries)
+// 2. Internal imports (absolute paths)
+// 3. Relative imports
+// 4. Type imports
+// 5. Asset imports (styles, images)
+
+// Component/Module code
+
+// Exports
+```
+
+### Component Structure (React)
+```typescript
+// 1. Imports
+// 2. Types/Interfaces
+// 3. Constants
+// 4. Helper functions
+// 5. Component definition
+// 6. Styles (if CSS-in-JS)
+// 7. Export
+```
+
+---
+
+## Import Order
+
+1. React/framework core imports
+2. Third-party library imports
+3. Internal modules (absolute paths like `@/`)
+4. Relative imports (`./`, `../`)
+5. Type-only imports
+6. Style imports
+
+---
+
+## Code Patterns
+
+### Error Handling
+```typescript
+// Prefer try-catch with specific error handling
+try {
+  await riskyOperation();
+} catch (error) {
+  if (error instanceof SpecificError) {
+    // Handle specific case
+  }
+  throw error; // Re-throw if unhandled
+}
+```
+
+### Async/Await
+```typescript
+// Prefer async/await over .then() chains
+const data = await fetchData();
+
+// Use Promise.all for parallel operations
+const [users, posts] = await Promise.all([
+  fetchUsers(),
+  fetchPosts()
+]);
+```
+
+### Null Handling
+```typescript
+// Use optional chaining
+const name = user?.profile?.name;
+
+// Use nullish coalescing for defaults
+const value = input ?? defaultValue;
+```
+
+---
+
+## Documentation
+
+### Comments
+- Use JSDoc for public APIs
+- Explain "why" not "what"
+- Remove commented-out code
+- Keep comments up to date
+
+### Code Comments Example
+```typescript
+// BAD: Increments counter
+counter++;
+
+// GOOD: Track retry attempts for rate limit backoff
+retryCount++;
+```
+
+---
+
+## Testing Conventions
+
+### Test File Location
+- Co-located with source: `Component.test.tsx`
+- Or in `__tests__` directory
+
+### Test Structure
+```typescript
+describe('ComponentName', () => {
+  describe('methodName', () => {
+    it('should do expected behavior', () => {
+      // Arrange
+      // Act
+      // Assert
+    });
+  });
+});
+```
+
+---
+
+## Git Conventions
+
+### Commit Messages
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+Types: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
+
+### Branch Naming
+- Feature: `feature/description`
+- Bugfix: `fix/description`
+- Hotfix: `hotfix/description`
+
+---
+
+*AI can propose updates to this file via diff. Human approval required for changes.*

package/templates/context/stack.md

@@ -0,0 +1,60 @@
+# Technology Stack
+
+Auto-detected and human-verified technology stack for this project.
+
+---
+
+## Runtime
+- **Language**: [auto-detect or specify]
+- **Runtime**: [e.g., Node.js 20.x, Bun, Deno, Python 3.11]
+- **Package Manager**: [npm, yarn, pnpm, pip, cargo]
+
+## Frameworks
+- **Frontend**: [e.g., React 18, Vue 3, Svelte, Angular, None]
+- **Backend**: [e.g., Express, Fastify, NestJS, Django, None]
+- **Full-Stack**: [e.g., Next.js 14, Nuxt, SvelteKit, None]
+
+## Key Dependencies
+<!-- List important dependencies and their purposes -->
+| Dependency | Purpose |
+|------------|---------|
+| example | description |
+
+## Build & Tooling
+- **Bundler**: [e.g., Vite, Webpack, esbuild, Rollup]
+- **Testing**: [e.g., Jest, Vitest, Playwright, pytest]
+- **Linting**: [e.g., ESLint, Biome, Ruff]
+- **Formatting**: [e.g., Prettier, Biome, Black]
+- **Type Checking**: [e.g., TypeScript, mypy, None]
+
+## Infrastructure
+- **Database**: [e.g., PostgreSQL, MongoDB, SQLite, None]
+- **ORM/ODM**: [e.g., Prisma, Drizzle, TypeORM, SQLAlchemy]
+- **Cache**: [e.g., Redis, Memcached, None]
+- **Queue**: [e.g., BullMQ, Celery, None]
+- **Hosting**: [e.g., Vercel, AWS, GCP, Self-hosted]
+
+---
+
+## Version Requirements
+
+```json
+{
+  "node": ">=20.0.0",
+  "npm": ">=10.0.0"
+}
+```
+
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| DATABASE_URL | Yes | Database connection string |
+| API_KEY | No | External API key |
+
+---
+
+*Last updated: {{timestamp}}*
+*Updated by: {{author}}*

package/templates/correction-report.md

@@ -0,0 +1,90 @@
+# Correction Report: [wf-XXXXXXXX]-Correction-[N]
+
+## Meta
+
+| Field | Value |
+|-------|-------|
+| Task ID | [wf-XXXXXXXX] |
+| Correction # | [N] |
+| Date | [YYYY-MM-DD] |
+| Severity | [minor/moderate/critical] |
+
+---
+
+## Problem Description
+
+### What Was Expected
+
+[Describe the expected behavior]
+
+### What Actually Happened
+
+[Describe the actual behavior]
+
+### Error Message (if any)
+
+```
+[paste error message]
+```
+
+---
+
+## Root Cause Analysis
+
+### Investigation Steps
+
+1. [Step taken to investigate]
+2. [Step taken to investigate]
+
+### Identified Cause
+
+[Why did this happen - the actual root cause]
+
+---
+
+## Solution Applied
+
+### Changes Made
+
+| File | Change Description |
+|------|-------------------|
+| [path/to/file.ts] | [What was changed] |
+
+### Code Summary
+
+```diff
+- [old code]
++ [new code]
+```
+
+---
+
+## Verification
+
+### Test Result After Fix
+
+| Test | Before | After |
+|------|--------|-------|
+| [Test name] | FAIL | PASS |
+
+---
+
+## Prevention Measures
+
+### How to Avoid in Future
+
+1. [Preventive measure 1]
+2. [Preventive measure 2]
+
+### Documentation Updates
+
+- [ ] Update decisions.md with pattern
+- [ ] Update relevant agent instructions
+- [ ] Add test case to prevent regression
+
+---
+
+## Linked
+
+- **Request Log**: R-[XXX]
+- **Task**: [wf-XXXXXXXX]

package/templates/feature-proposal.md

@@ -0,0 +1,35 @@
+# Feature: [Name]
+
+## Summary
+[Brief description of the feature]
+
+## Problem
+[What problem does this solve?]
+
+## Solution
+[How will this feature solve the problem?]
+
+## User Stories
+- As a [user type], I want to [action] so that [benefit]
+
+## Acceptance Criteria
+- [ ] [Criterion 1]
+- [ ] [Criterion 2]
+- [ ] [Criterion 3]
+
+## Dependencies
+- [List any dependencies on other features or components]
+
+## Technical Notes
+[Any technical considerations, constraints, or decisions]
+
+## Components Needed
+Check app-map.md before listing:
+- [ ] [Component 1] - exists / needs variant / needs creation
+- [ ] [Component 2]
+
+## Estimated Effort
+[Small / Medium / Large]
+
+## Risks
+- [Potential risks or blockers]

package/templates/hybrid/_base.md

@@ -0,0 +1,254 @@
+## ⚠️ CRITICAL OUTPUT RULES (READ FIRST)
+
+**Your output will be written directly to a file. Follow these rules EXACTLY:**
+
+1. Output ONLY valid code - no explanations, no markdown
+2. Do NOT wrap code in ``` code blocks
+3. Do NOT include any text before the code
+4. Do NOT include any text after the code
+5. Start with imports (or 'use client' directive if needed)
+6. Do NOT include thinking or reasoning text in your output
+
+**WRONG OUTPUT:**
+```
+Here's the code you need:
+import React from 'react'
+```
+
+**CORRECT OUTPUT:**
+import { useState } from 'react';
+
+**You MAY use `<thinking>...</thinking>` tags to reason through complex problems.**
+Only the code OUTSIDE these tags will be extracted and written to the file.
+
+═══════════════════════════════════════════════════════════════════════════════
+
+# Project Context
+
+You are generating code for this project.
+
+{{#if uiFramework}}
+## Framework: {{uiFramework}}
+{{/if}}
+
+{{#if stylingApproach}}
+## Styling: {{stylingApproach}}
+{{/if}}
+
+## Import Rules
+
+{{#if doNotImport}}
+### Forbidden Imports (DO NOT USE)
+DO NOT import these: {{doNotImport}}
+{{/if}}
+
+### Available Project Imports
+
+**Use ONLY imports listed below for project code. Other paths are FORBIDDEN.**
+
+{{#if availableComponents}}
+#### Components
+```typescript
+{{availableComponents}}
+```
+{{/if}}
+
+{{#if availableHooks}}
+#### Hooks
+```typescript
+{{availableHooks}}
+```
+{{/if}}
+
+{{#if availableServices}}
+#### Services
+```typescript
+{{availableServices}}
+```
+{{/if}}
+
+{{#if availableTypes}}
+#### Types
+```typescript
+{{availableTypes}}
+```
+{{/if}}
+
+{{#if availableUtils}}
+#### Utilities
+```typescript
+{{availableUtils}}
+```
+{{/if}}
+
+{{#if typeLocations}}
+### Type Import Paths
+{{typeLocations}}
+{{/if}}
+
+### Standard Library Imports (Always Allowed)
+
+These imports are always safe to use without being listed above:
+
+**React:**
+- `useState`, `useEffect`, `useCallback`, `useMemo`, `useRef`, `useContext`
+- `useReducer`, `useLayoutEffect`, `useImperativeHandle`, `useDebugValue`
+- `forwardRef`, `memo`, `lazy`, `Suspense`, `Fragment`
+
+**Next.js:**
+- `Link`, `Image`, `Script` from `next/link`, `next/image`, `next/script`
+- `useRouter`, `usePathname`, `useSearchParams` from `next/navigation`
+- `notFound`, `redirect` from `next/navigation`
+- `headers`, `cookies` from `next/headers`
+
+**Node.js (for server code):**
+- `fs`, `path`, `os`, `crypto`, `util`, `stream`, `events`
+- `child_process`, `http`, `https`, `url`, `querystring`
+
+{{#if projectWarnings}}
+### Project-Specific Warnings
+{{projectWarnings}}
+{{/if}}
+
+**If you're unsure about a project import path:**
+- DON'T USE IT
+- Write the code inline instead
+- Use a TODO comment: `// TODO: import X from '?'`
+
+## Component Usage Rules
+
+These rules prevent the most common LLM mistakes:
+
+### 1. String Literals for Variants/Sizes (MANDATORY)
+
+**CORRECT:**
+```tsx
+<Button variant="primary" size="md">Click</Button>
+<Card variant="default">Content</Card>
+<Input size="lg" />
+```
+
+**WRONG (NEVER DO THIS):**
+```tsx
+<Button variant={buttonVariants.primary}>Click</Button>  // ❌ WRONG
+<Card variant={cardVariants.default}>Content</Card>      // ❌ WRONG
+<Input size={inputSizes.lg} />                           // ❌ WRONG
+```
+
+### 2. Exported Arrays Are for Iteration Only
+
+Constants like `buttonVariants`, `cardVariants`, `inputSizes` are **ARRAYS** like `['sm', 'md', 'lg']`:
+- ✅ Use them for: `buttonVariants.map(v => ...)` (iteration)
+- ❌ NOT for: `variant={buttonVariants.primary}` (object access)
+
+### 3. Hook Names ≠ File Names
+
+File: `use-auth-store.ts` might export: `useAuthState()`, NOT `useAuthStore()`
+- Always use the exact function name shown in the imports above
+- Never guess hook names based on file names
+
+### 4. When in Doubt, Use String Literals
+
+If you're unsure whether something is an array or object:
+```tsx
+// Always safe - string literals
+variant="primary"
+size="md"
+type="submit"
+```
+
+## Code Rules
+
+1. Use TypeScript with proper types.
+2. Follow the existing patterns shown in _patterns.md
+3. Include all necessary imports at the top.
+4. Add brief JSDoc comments for exported functions/components.
+5. Do NOT create files that weren't requested.
+6. Match the project's naming conventions exactly.
+7. Define types inline if unsure about import path.
+
+{{#if customRules}}
+### Project-Specific Rules
+{{customRules}}
+{{/if}}
+
+## Context Level: {{richnessLevel}}
+
+You have been given comprehensive context to ensure high success rate.
+All imports, types, and patterns above are accurate and verified.
+
+{{#if verbosityGuidance}}
+### Implementation Guidance
+{{verbosityGuidance}}
+{{/if}}
+
+Use ALL the context provided above. The imports, props, and types shown are
+the source of truth. Do not guess or invent alternatives.
+
+{{#if requiresPlan}}
+## Planning Requirement
+
+**IMPORTANT: This task requires explicit planning before implementation.**
+
+Task complexity: {{complexity}}
+
+Before writing any code, first output your plan inside `<thinking>` tags:
+1. What changes are needed
+2. Which imports you will use
+3. Key implementation decisions
+4. Any potential edge cases
+
+Example:
+```
+<thinking>
+Plan:
+1. Create UserCard component with name/email props
+2. Import Button from @/components/ui/Button
+3. Use useState for hover state
+4. Handle optional onEdit callback
+</thinking>
+```
+
+Then output ONLY the code (outside the thinking tags).
+{{/if}}
+
+## Validation
+
+After you output code, it will be automatically validated:
+- TypeScript compilation check
+- ESLint check
+
+If validation fails, you'll receive the error and must fix it.
+Fix the error and output ONLY the corrected code. No explanations.
+
+═══════════════════════════════════════════════════════════════════════════════
+                    TASK BOUNDARY - YOUR TASK STARTS BELOW
+═══════════════════════════════════════════════════════════════════════════════
+
+**CRITICAL**: Everything ABOVE this line is PROJECT CONTEXT for REFERENCE ONLY.
+- Do NOT implement types/components from the project context
+- Do NOT confuse project patterns with your actual task
+- ONLY implement what is described in YOUR TASK below
+
+## YOUR TASK (IMPLEMENT THIS)
+
+{{#if taskDescription}}
+{{taskDescription}}
+{{else}}
+[Task description will be inserted here by the orchestrator]
+{{/if}}
+
+{{#if targetFile}}
+**Target File**: `{{targetFile}}`
+{{/if}}
+
+{{#if existingContent}}
+**Current File Content**:
+```
+{{existingContent}}
+```
+{{/if}}
+
+═══════════════════════════════════════════════════════════════════════════════
+                              END OF TASK
+═══════════════════════════════════════════════════════════════════════════════