@epiccontext/mcp 0.1.17 → 0.1.19

package/dist/cli/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,EAAE,CAmCjE;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,GAAE,YAAiB,GACzB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAsC9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAkqB7D;AA4BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAO5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOpD"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,EAAE,CAmCjE;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,GAAE,YAAiB,GACzB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAsC9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAy3C7D;AA4BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAO5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOpD"}

package/dist/cli/files.js

@@ -203,6 +203,9 @@ Your content goes here after the frontmatter...
 
 ### technical/
 - \`text\` - Architecture, stack overview
+- \`frontend_stack\` - Frontend technology choices
+- \`backend_stack\` - Backend technology choices
+- \`architecture_diagram\` - C4 model system architecture diagrams
 - \`integration\` - Third-party integrations
 - \`constraint\` - Technical constraints
 
@@ -617,6 +620,730 @@ CORRECT: Always specify link type
 { "id": "link-1", "sourceId": "a", "targetId": "b", "type": "action" }
 \`\`\`
 
+### Architecture Diagram Block (C4 Model)
+
+Architecture diagram blocks document system architecture visually using the C4 model (Context, Container, Component). They use embedded JSON in a \`sync:data\` block with \`elements\` and \`connections\`.
+
+#### Purpose
+- Visualize system architecture at different abstraction levels
+- Show how systems, containers, and components interact
+- Document communication patterns and technologies
+- Provide clear diagrams for different audiences (technical, leadership)
+
+#### C4 Model Levels
+
+| Level | Purpose | Shows | Audience |
+|-------|---------|-------|----------|
+| **Context** | Big picture | Systems + external actors | Everyone |
+| **Container** | Applications & data stores | Apps, databases, services within your system | Technical + Leadership |
+| **Component** | Inside a container | Components, modules, classes | Developers, Architects |
+
+#### Data Structure
+
+The sync:data block contains:
+
+\`\`\`json
+{
+  "elements": [ ... ],      // Systems, containers, components, people
+  "connections": [ ... ],   // Communication paths between elements
+  "legend": [ ... ]         // Optional color legend
+}
+\`\`\`
+
+#### Element Structure (ArchitectureElement)
+
+| Property | Required | Description |
+|----------|----------|-------------|
+| \`id\` | Yes | Unique identifier (kebab-case, e.g., "web-app") |
+| \`label\` | Yes | Display name shown in the diagram |
+| \`type\` | Yes | Element type (see types below) |
+| \`description\` | No | Brief description of what this element does |
+| \`technology\` | No | Technology stack (e.g., "React", "Node.js", "PostgreSQL") |
+| \`isExternal\` | No | True if outside your system boundary |
+| \`position\` | Yes | Visual position: \`{ "x": number, "y": number }\` |
+| \`color\` | No | Override default color (hex code) |
+| \`icon\` | No | Lucide icon name for visual representation |
+
+#### Element Types
+
+| Type | Default Color | Description | Visual |
+|------|--------------|-------------|--------|
+| \`system\` | #438DD5 (blue) | Software system (yours or external) | Large box |
+| \`container\` | #438DD5 (blue) | Application, service, database | Medium box |
+| \`component\` | #85BBF0 (light blue) | Module, class, or logical component | Small box |
+| \`person\` | #08427B (dark blue) | User, actor, or role | Person shape |
+| \`database\` | #438DD5 (blue) | Data store (SQL, NoSQL, file) | Cylinder |
+| \`queue\` | #438DD5 (blue) | Message queue, event stream | Rounded box |
+| \`external\` | #999999 (gray) | External system you don't control | Dashed box |
+
+#### Connection Structure (ArchitectureConnection)
+
+| Property | Required | Description |
+|----------|----------|-------------|
+| \`id\` | Yes | Unique ID (e.g., "conn-web-to-api") |
+| \`sourceId\` | Yes | ID of the source element |
+| \`targetId\` | Yes | ID of the target element |
+| \`label\` | No | Description of what flows (e.g., "REST API", "Events") |
+| \`communicationType\` | No | Type of communication (see below) |
+| \`technology\` | No | Protocol or technology (e.g., "HTTPS", "gRPC", "WebSocket") |
+| \`description\` | No | Additional details about the connection |
+
+#### Communication Types
+
+| Type | Arrow Style | Description |
+|------|-------------|-------------|
+| \`sync\` | Solid → | Synchronous request/response |
+| \`async\` | Dashed → | Asynchronous messaging |
+| \`read\` | Solid → (read) | Data read operation |
+| \`write\` | Solid → (write) | Data write operation |
+| \`bidirectional\` | ↔ | Two-way communication |
+
+#### Complete Example
+
+\`\`\`markdown
+---
+type: architecture_diagram
+section: technical
+key: system-context
+name: System Context Diagram
+status: draft
+level: context
+audience: non-technical
+---
+
+# System Context Diagram
+
+High-level overview of how our application fits into the broader ecosystem.
+
+## Description
+This diagram shows our EpicContext application and how it interacts with external users and systems.
+
+<!-- sync:data -->
+\\\`\`\`json
+{
+  "elements": [
+    {
+      "id": "user",
+      "label": "Product Team",
+      "type": "person",
+      "description": "Uses EpicContext to manage product documentation",
+      "position": { "x": 400, "y": 50 }
+    },
+    {
+      "id": "epiccontext",
+      "label": "EpicContext",
+      "type": "system",
+      "description": "SaaS platform for managing design context documentation",
+      "technology": "Next.js, Supabase",
+      "position": { "x": 400, "y": 250 }
+    },
+    {
+      "id": "ai-agents",
+      "label": "AI Coding Agents",
+      "type": "person",
+      "description": "Claude Code, Cursor, etc. that consume context",
+      "position": { "x": 700, "y": 50 }
+    },
+    {
+      "id": "supabase",
+      "label": "Supabase",
+      "type": "external",
+      "description": "Backend-as-a-Service for auth and database",
+      "technology": "PostgreSQL",
+      "isExternal": true,
+      "position": { "x": 400, "y": 450 }
+    },
+    {
+      "id": "clerk",
+      "label": "Clerk",
+      "type": "external",
+      "description": "Authentication provider",
+      "isExternal": true,
+      "position": { "x": 150, "y": 250 }
+    },
+    {
+      "id": "mcp-server",
+      "label": "MCP Server",
+      "type": "system",
+      "description": "Local server that syncs context to codebase",
+      "technology": "Node.js",
+      "position": { "x": 700, "y": 250 }
+    }
+  ],
+  "connections": [
+    {
+      "id": "conn-user-to-app",
+      "sourceId": "user",
+      "targetId": "epiccontext",
+      "label": "Manages documentation",
+      "communicationType": "sync",
+      "technology": "HTTPS"
+    },
+    {
+      "id": "conn-app-to-supabase",
+      "sourceId": "epiccontext",
+      "targetId": "supabase",
+      "label": "Stores data",
+      "communicationType": "sync",
+      "technology": "PostgreSQL/REST"
+    },
+    {
+      "id": "conn-app-to-clerk",
+      "sourceId": "epiccontext",
+      "targetId": "clerk",
+      "label": "Authenticates users",
+      "communicationType": "sync",
+      "technology": "HTTPS"
+    },
+    {
+      "id": "conn-app-to-mcp",
+      "sourceId": "epiccontext",
+      "targetId": "mcp-server",
+      "label": "Syncs via API",
+      "communicationType": "sync",
+      "technology": "REST API"
+    },
+    {
+      "id": "conn-ai-to-mcp",
+      "sourceId": "ai-agents",
+      "targetId": "mcp-server",
+      "label": "Reads context",
+      "communicationType": "read",
+      "technology": "MCP Protocol"
+    }
+  ],
+  "legend": [
+    { "color": "#08427B", "label": "Person/User" },
+    { "color": "#438DD5", "label": "Our System" },
+    { "color": "#999999", "label": "External System" }
+  ]
+}
+\\\`\`\`
+<!-- /sync:data -->
+\`\`\`
+
+#### Container Level Example
+
+\`\`\`markdown
+---
+type: architecture_diagram
+section: technical
+key: container-diagram
+name: Container Diagram
+status: draft
+level: container
+audience: technical
+---
+
+# Container Diagram
+
+Applications and data stores that make up EpicContext.
+
+<!-- sync:data -->
+\\\`\`\`json
+{
+  "elements": [
+    {
+      "id": "web-app",
+      "label": "Web Application",
+      "type": "container",
+      "description": "SPA for managing context",
+      "technology": "Next.js 14, React, TypeScript",
+      "position": { "x": 200, "y": 100 }
+    },
+    {
+      "id": "api",
+      "label": "API Routes",
+      "type": "container",
+      "description": "Server-side API endpoints",
+      "technology": "Next.js API Routes",
+      "position": { "x": 500, "y": 100 }
+    },
+    {
+      "id": "database",
+      "label": "Database",
+      "type": "database",
+      "description": "Stores all application data",
+      "technology": "PostgreSQL (Supabase)",
+      "position": { "x": 500, "y": 300 }
+    },
+    {
+      "id": "file-storage",
+      "label": "File Storage",
+      "type": "database",
+      "description": "Stores uploaded assets",
+      "technology": "Supabase Storage",
+      "position": { "x": 200, "y": 300 }
+    },
+    {
+      "id": "mcp-package",
+      "label": "MCP Package",
+      "type": "container",
+      "description": "NPM package for local sync",
+      "technology": "Node.js, TypeScript",
+      "position": { "x": 750, "y": 200 }
+    }
+  ],
+  "connections": [
+    {
+      "id": "conn-web-to-api",
+      "sourceId": "web-app",
+      "targetId": "api",
+      "label": "API calls",
+      "communicationType": "sync",
+      "technology": "HTTPS/JSON"
+    },
+    {
+      "id": "conn-api-to-db",
+      "sourceId": "api",
+      "targetId": "database",
+      "label": "Queries",
+      "communicationType": "bidirectional",
+      "technology": "Supabase Client"
+    },
+    {
+      "id": "conn-web-to-storage",
+      "sourceId": "web-app",
+      "targetId": "file-storage",
+      "label": "Uploads/Downloads",
+      "communicationType": "bidirectional",
+      "technology": "Supabase Storage API"
+    },
+    {
+      "id": "conn-mcp-to-api",
+      "sourceId": "mcp-package",
+      "targetId": "api",
+      "label": "Syncs context",
+      "communicationType": "sync",
+      "technology": "REST API"
+    }
+  ]
+}
+\\\`\`\`
+<!-- /sync:data -->
+\`\`\`
+
+#### Best Practices
+
+1. **Choose the right level:**
+   - Start with Context for stakeholder communication
+   - Use Container for development planning
+   - Use Component for detailed design of complex containers
+
+2. **Position elements logically:**
+   - Users/actors at top
+   - Your system in the middle
+   - External dependencies at bottom or sides
+   - Space elements ~200-300px apart
+
+3. **Label connections clearly:**
+   - Use verbs: "Reads data", "Sends events", "Authenticates"
+   - Include technology when relevant: "REST API", "gRPC", "WebSocket"
+   - Keep labels concise but informative
+
+4. **Use consistent colors:**
+   - Blue (#438DD5) for your internal systems
+   - Gray (#999999) for external systems
+   - Dark blue (#08427B) for people/users
+   - Add legend for custom colors
+
+5. **Include technology details:**
+   - For Container level: framework, language, runtime
+   - For connections: protocol, message format
+   - Helps developers understand the stack
+
+6. **Keep diagrams focused:**
+   - Context: 3-6 systems maximum
+   - Container: 5-10 containers maximum
+   - Component: 5-15 components maximum
+   - Create multiple diagrams if needed
+
+#### Common Mistakes
+
+WRONG: Missing positions
+\`\`\`json
+{ "id": "api", "label": "API", "type": "container" }
+\`\`\`
+
+CORRECT: Always include positions
+\`\`\`json
+{ "id": "api", "label": "API", "type": "container", "position": { "x": 400, "y": 200 } }
+\`\`\`
+
+WRONG: Vague connection labels
+\`\`\`json
+{ "id": "conn-1", "sourceId": "a", "targetId": "b", "label": "uses" }
+\`\`\`
+
+CORRECT: Specific, actionable labels
+\`\`\`json
+{ "id": "conn-1", "sourceId": "a", "targetId": "b", "label": "Fetches user data", "technology": "REST API" }
+\`\`\`
+
+WRONG: Too many elements on one diagram
+Create separate diagrams for different aspects or zoom levels.
+
+CORRECT: Focused diagrams
+- One Context diagram for the big picture
+- Separate Container diagrams per major system
+- Component diagrams only for complex containers
+
+### Development Section Blocks (Epic → Story → Task)
+
+The development section uses a hierarchical structure to plan and track work. This creates a clear flow from high-level initiatives down to specific implementation tasks.
+
+#### Hierarchy Flow
+
+\`\`\`
+Epic (Large initiative)
+  └── User Story (User-facing feature)
+        └── Task / Agent Plan (Technical implementation)
+\`\`\`
+
+**How AI/Developers Should Use This:**
+1. **Product Owner/User** creates Epics for major initiatives
+2. **Product Owner/User** breaks Epics into User Stories
+3. **AI Agent/Developer** reads Stories and creates Tasks with implementation plans
+4. **AI Agent/Developer** executes Tasks and updates outcomes
+
+---
+
+#### Epic Block
+
+An Epic represents a large body of work that delivers significant value. It groups related User Stories.
+
+**Required Fields:**
+- \`summary\` - One-line description
+- \`status\` - todo, in_progress, done
+
+**Key Fields:**
+- \`description\` - Detailed explanation
+- \`priority\` - highest, high, medium, low, lowest
+- \`story_refs\` - Links to child User Stories
+- \`impact_score\` / \`effort_score\` - 1-5 scale for prioritization
+- \`start_date\` / \`due_date\` - Timeline
+- \`labels\` - Comma-separated tags
+
+**Example:**
+\`\`\`markdown
+---
+type: epic
+section: development
+key: user-authentication
+name: User Authentication System
+status: draft
+priority: high
+start_date: 2025-01-15
+due_date: 2025-02-28
+labels: security, mvp, phase-1
+story_refs:
+  - email-login
+  - oauth-integration
+  - password-reset
+---
+
+# User Authentication System
+
+Implement a complete authentication system allowing users to securely access their accounts.
+
+## Summary
+Build secure user authentication with email/password and OAuth support.
+
+## Description
+This epic covers all authentication-related features including registration, login, logout, password management, and third-party OAuth integration. The goal is to provide a frictionless yet secure authentication experience.
+
+### Goals
+- Enable secure user registration with email verification
+- Support login via email/password and OAuth (Google, GitHub)
+- Implement password reset flow with secure tokens
+- Add session management with JWT
+
+### Success Criteria
+- Users can create accounts and verify email
+- Login works with email/password and OAuth providers
+- Password reset emails arrive within 30 seconds
+- Sessions expire after 24 hours of inactivity
+
+### Out of Scope
+- Two-factor authentication (planned for Phase 2)
+- Social login beyond Google/GitHub
+\`\`\`
+
+---
+
+#### User Story Block
+
+A User Story describes a feature from the user's perspective. It belongs to an Epic and can have Tasks.
+
+**Required Fields:**
+- \`summary\` - Brief description
+- \`status\` - todo, in_progress, in_review, done
+
+**Key Fields:**
+- \`user_story\` - "As a [role], I want [goal], so that [benefit]" format
+- \`acceptance_criteria\` - Testable conditions (Given/When/Then)
+- \`epic_ref\` - Link to parent Epic
+- \`story_points\` - 1, 2, 3, 5, 8, 13, 21 (Fibonacci)
+- \`priority\` - highest, high, medium, low, lowest
+- \`impact_score\` / \`effort_score\` - 1-5 scale
+- \`sprint\` - Sprint assignment
+
+**Example:**
+\`\`\`markdown
+---
+type: user_story
+section: development
+key: email-login
+name: Email Login
+status: draft
+priority: high
+story_points: 5
+impact_score: 5
+effort_score: 3
+epic_ref: user-authentication
+sprint: Sprint 1
+---
+
+# Email Login
+
+Allow users to securely log in with their email and password.
+
+## Summary
+Implement email/password authentication with proper security measures.
+
+## User Story
+As a registered user, I want to log in with my email and password, so that I can access my account securely and quickly.
+
+## Description
+Users need a fast and secure way to access their accounts. The login form should validate input, show helpful error messages, and redirect to the dashboard on success.
+
+## Acceptance Criteria
+
+### Scenario: Successful login
+- Given I am on the login page
+- When I enter a valid email and correct password
+- Then I am redirected to the dashboard
+- And I see a welcome message with my name
+
+### Scenario: Invalid credentials
+- Given I am on the login page
+- When I enter an invalid email or wrong password
+- Then I see an error message "Invalid email or password"
+- And I remain on the login page
+- And the password field is cleared
+
+### Scenario: Rate limiting
+- Given I have failed login 5 times in 5 minutes
+- When I try to login again
+- Then I see "Too many attempts. Please try again in 15 minutes"
+
+## Technical Notes
+- Use bcrypt for password hashing (cost factor 12)
+- Implement rate limiting: 5 attempts per 5 minutes per IP
+- Generate JWT with 24h expiry
+- Store refresh token in httpOnly cookie
+\`\`\`
+
+---
+
+#### Task / Agent Plan Block
+
+A Task contains the technical implementation plan. AI coding agents (Claude Code, Cursor, etc.) should create Tasks when planning work.
+
+**Required Fields:**
+- \`description\` - What needs to be done
+- \`status\` - planned, todo, in_progress, in_review, done, abandoned
+
+**Key Fields:**
+- \`story_ref\` - Link to parent User Story
+- \`plan_steps\` - Step-by-step implementation plan
+- \`agent_source\` - manual, claude_code, cursor, copilot, windsurf, aider, other_ai
+- \`files_affected\` - List of files to create/modify
+- \`codebase_context\` - Relevant architecture notes
+- \`technical_notes\` - Implementation details
+- \`dependencies\` - Prerequisites or packages needed
+- \`estimated_hours\` - Time estimate
+- \`outcome\` - Results after completion
+
+**Example (AI Agent Plan):**
+\`\`\`markdown
+---
+type: task
+section: development
+key: implement-login-api
+name: Implement Login API Endpoint
+status: planned
+priority: high
+agent_source: claude_code
+story_ref: email-login
+estimated_hours: 4
+---
+
+# Implement Login API Endpoint
+
+Create the POST /api/auth/login endpoint that validates credentials and returns JWT tokens.
+
+## Description
+Implement the login API endpoint with proper validation, rate limiting, and token generation.
+
+## Implementation Plan
+
+### Step 1: Create Login Route Handler
+Create \`app/api/auth/login/route.ts\` with POST handler:
+- Accept email and password in request body
+- Validate input format using zod schema
+- Return 400 for invalid input with specific error messages
+
+### Step 2: Implement User Lookup
+Query the users table by email:
+- Use Supabase client with service role for server-side
+- Return generic "Invalid credentials" to prevent email enumeration
+- Handle case-insensitive email matching
+
+### Step 3: Password Verification
+Compare provided password with stored hash:
+- Use bcrypt.compare() for timing-safe comparison
+- Log failed attempts for security monitoring
+- Increment rate limit counter on failure
+
+### Step 4: Generate JWT Tokens
+On successful authentication:
+- Generate access token (24h expiry) with user ID and email
+- Generate refresh token (7d expiry) stored in httpOnly cookie
+- Include minimal claims to reduce token size
+
+### Step 5: Implement Rate Limiting
+Add rate limiting middleware:
+- Use Redis or in-memory store for attempt tracking
+- Key by IP address + email combination
+- Block after 5 failed attempts for 15 minutes
+- Return 429 with Retry-After header
+
+### Step 6: Add Tests
+Create \`app/api/auth/login/route.test.ts\`:
+- Test successful login returns tokens
+- Test invalid email format returns 400
+- Test wrong password returns 401
+- Test rate limiting blocks after 5 attempts
+
+## Files Affected
+- \`app/api/auth/login/route.ts\` (create)
+- \`lib/auth/jwt.ts\` (create)
+- \`lib/auth/password.ts\` (create)
+- \`lib/middleware/rate-limit.ts\` (create)
+- \`app/api/auth/login/route.test.ts\` (create)
+
+## Codebase Context
+- Using Next.js 14 App Router
+- Supabase for database and auth
+- JWT library: jose
+- Password hashing: bcrypt
+- Validation: zod
+
+## Dependencies
+- jose (JWT handling)
+- bcrypt (password hashing)
+- zod (validation)
+
+## Technical Notes
+- Follow existing API patterns in \`app/api/\` folder
+- Use \`@/lib/supabase/server\` for database access
+- Error responses should match the ErrorResponse type in \`types/api.ts\`
+\`\`\`
+
+---
+
+#### Roadmap Block
+
+A Roadmap provides a timeline view of Epics across time periods (quarters, months, sprints).
+
+**Key Fields:**
+- \`description\` - Purpose of this roadmap
+- \`timeline\` - Visual timeline data with columns and epic placements
+- \`notes\` - Additional context, risks, assumptions
+
+**Timeline Structure:**
+\`\`\`json
+{
+  "columns": [
+    { "id": "q1-2025", "name": "Q1 2025", "period": "quarter" },
+    { "id": "q2-2025", "name": "Q2 2025", "period": "quarter" }
+  ],
+  "items": [
+    {
+      "epicRef": "user-authentication",
+      "startColumn": "q1-2025",
+      "spanColumns": 1,
+      "row": 0
+    }
+  ],
+  "settings": { "defaultPeriod": "quarter" }
+}
+\`\`\`
+
+---
+
+#### Workflow: From User Request to Implementation
+
+**1. User/Product Owner Creates Epic:**
+\`\`\`
+"We need user authentication for the MVP"
+  → Create Epic: user-authentication
+  → Set priority: high
+  → Set dates: Q1 2025
+\`\`\`
+
+**2. User/Product Owner Breaks Down Stories:**
+\`\`\`
+Epic: user-authentication
+  → Story: email-login (5 points)
+  → Story: oauth-integration (8 points)
+  → Story: password-reset (3 points)
+\`\`\`
+
+**3. AI Agent Reads Story and Plans:**
+\`\`\`
+AI reads: email-login story
+  → Creates Task: implement-login-api (4 hours)
+  → Creates Task: build-login-form (3 hours)
+  → Creates Task: add-login-tests (2 hours)
+\`\`\`
+
+**4. AI Agent Executes and Documents:**
+\`\`\`
+Task: implement-login-api
+  → Status: in_progress
+  → [AI implements code]
+  → Status: done
+  → Outcome: "Completed. Added rate limiting as discussed."
+\`\`\`
+
+---
+
+#### Best Practices for AI Agents
+
+1. **Read the Story First**: Before creating tasks, fully understand the user story and acceptance criteria.
+
+2. **Break Down Thoughtfully**: Create tasks that are:
+   - Independently testable
+   - 2-8 hours of work each
+   - Clearly scoped with specific files
+
+3. **Document Your Plan**: In \`plan_steps\`, explain:
+   - What you'll do in each step
+   - Why you're making certain choices
+   - What files you'll touch
+
+4. **Track Codebase Context**: Note relevant:
+   - Existing patterns to follow
+   - Related code to reference
+   - Constraints or dependencies
+
+5. **Update Outcomes**: After completing a task, document:
+   - What was actually done
+   - Any deviations from the plan
+   - Issues encountered and how they were resolved
+
 ## Block References
 
 Some blocks can reference other blocks using reference fields in frontmatter:

package/dist/cli/files.js.map

@@ -1 +1 @@
-{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsvCnB,CAAC;QACE,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,+DAA+D;IAC/D,gBAAgB,CAAC,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE;;;;;;;;;;;;CAYxF,CAAC,CAAC;IAED,gBAAgB,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE;;;;;;;;;;;CAWxE,CAAC,CAAC;IAED,gBAAgB,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE;;;;;;;;;;;;CAY9E,CAAC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,WAAmB,EACnB,OAAe,EACf,GAAW,EACX,IAAY,EACZ,IAAY,EACZ,OAAe;IAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG;QAChB,IAAI;WACD,OAAO;OACX,GAAG;QACF,IAAI;;;;EAIV,OAAO,EAAE,CAAC;QACR,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epiccontext/mcp",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "MCP server and CLI for syncing EpicContext documentation with local codebases",
   "type": "module",
   "main": "dist/index.js",