@epiccontext/mcp 0.1.16 → 0.1.18

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,CAonB7D;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,CAsgC7D;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

@@ -364,57 +364,105 @@ A journey map showing how new users get started with our product.
 
 ### Information Architecture Block (ia_tree)
 
-IA tree blocks document the application's page hierarchy and navigation structure. They use embedded JSON in a \`sync:data\` block.
+IA tree blocks document the application's page hierarchy, navigation structure, and connections between pages. They use embedded JSON in a \`sync:data\` block with a \`tree\` (hierarchy) and \`links\` (connections) structure.
 
 #### Purpose
-- Map out the complete site/app structure
+- Map out the complete site/app structure visually
 - Show parent-child relationships between pages
 - Document modals, sections, and components within pages
-- Define cross-links between related pages
-- Track page types (navigable vs modal vs component)
+- **Define connections/links between pages and components**
+- Track page types with visual differentiation
 
-#### Node Structure
+#### Data Structure
 
-Each node in the IA tree has these properties:
+The sync:data block contains two top-level properties:
+
+\`\`\`json
+{
+  "tree": { ... },   // The page/node hierarchy (IATreeNode)
+  "links": [ ... ]   // Connections between nodes (IALink[])
+}
+\`\`\`
+
+#### Node Structure (IATreeNode)
 
 | Property | Required | Description |
 |----------|----------|-------------|
 | \`id\` | Yes | Unique identifier (use kebab-case, e.g., "user-settings") |
 | \`label\` | Yes | Display name shown in the UI |
-| \`type\` | Yes | Node type (see below) |
+| \`type\` | Yes | Node type: \`page\`, \`modal\`, \`external\`, or \`node\` |
 | \`url\` | No | Route path for navigable pages (e.g., "/dashboard") |
 | \`description\` | No | Brief description of the page/section purpose |
-| \`children\` | Yes | Array of child nodes (can be empty: \`[]\`) |
+| \`position\` | Yes | Visual position: \`{ "x": number, "y": number }\` |
+| \`children\` | No | Array of child nodes |
 | \`subNodes\` | No | Sections/components within this page |
-| \`isNew\` | No | Flag to show "New" badge on the node |
+| \`isNew\` | No | Flag to show "NEW" badge on the node |
+
+#### Node Types (Visual Shapes)
+
+| Type | Visual | Description |
+|------|--------|-------------|
+| \`page\` | Square (sharp corners) | A routable page/screen |
+| \`modal\` | Rounded (large radius) | Modal/dialog overlay |
+| \`external\` | Dashed border | External link |
+| \`node\` | Rounded corners | Generic structural node |
+
+#### Sub-Node Types (Content Areas Within Nodes)
 
-#### Node Types
+| Type | Description |
+|------|-------------|
+| \`section\` | A major content section |
+| \`component\` | A reusable UI component |
+| \`widget\` | Interactive widget/feature |
 
-| Type | Shape | Description | Example |
-|------|-------|-------------|---------|
-| \`page\` | Square | A navigable route/URL | Dashboard, Settings, Profile |
-| \`modal\` | Rounded | Overlay dialog (no direct URL) | Confirmation dialogs, Preferences popup |
-| \`external\` | Diamond | Link to external site | Documentation, Support portal |
+Sub-nodes appear inside their parent node and can be the source of links to other nodes.
 
-#### Sub-Nodes (Page Sections)
+#### Link Structure (IALink)
 
-Pages can have sub-nodes representing sections or components within them:
+Links define relationships and navigation paths between nodes. **IMPORTANT:** You MUST include the \`links\` array to show connections.
 
+| Property | Required | Description |
+|----------|----------|-------------|
+| \`id\` | Yes | Unique ID for the link (e.g., "link-login-to-dashboard") |
+| \`sourceId\` | Yes | ID of the source node |
+| \`targetId\` | Yes | ID of the target node |
+| \`sourceSubNodeId\` | No | If link starts from a sub-node, its ID |
+| \`type\` | Yes | Link type (see below) |
+| \`label\` | No | Description of the connection |
+
+#### Link Types
+
+| Type | Color | Style | Use Case |
+|------|-------|-------|----------|
+| \`action\` | Green (#22c55e) | Solid | User action that navigates (clicks, taps) |
+| \`related\` | Purple (#8b5cf6) | Solid | Related content connection |
+| \`parent\` | Blue (#3b82f6) | Solid | Parent-child hierarchy |
+| \`references\` | Amber (#f59e0b) | Dashed | Content reference/link |
+
+#### Connection Types
+
+**1. Node → Node Connection:**
 \`\`\`json
 {
-  "id": "dashboard",
-  "label": "Dashboard",
-  "type": "page",
-  "url": "/dashboard",
-  "subNodes": [
-    { "id": "metrics-panel", "label": "Metrics Panel", "type": "section" },
-    { "id": "quick-actions", "label": "Quick Actions", "type": "component" }
-  ],
-  "children": []
+  "id": "link-home-to-settings",
+  "sourceId": "home-page",
+  "targetId": "settings-modal",
+  "type": "action",
+  "label": "Opens settings"
 }
 \`\`\`
 
-Sub-node types: \`section\`, \`component\`, \`widget\`
+**2. Sub-Node → Node Connection:**
+\`\`\`json
+{
+  "id": "link-cta-to-signup",
+  "sourceId": "home-page",
+  "sourceSubNodeId": "hero-cta-button",
+  "targetId": "signup-page",
+  "type": "action",
+  "label": "Sign up CTA click"
+}
+\`\`\`
 
 #### Complete Example
 
@@ -429,109 +477,81 @@ status: draft
 
 # Application Structure
 
-Complete information architecture for our SaaS application, showing all pages, modals, and their relationships.
-
-## Design Principles
-- Maximum 3 levels of navigation depth
-- All key actions accessible within 2 clicks
-- Consistent navigation patterns across sections
+Complete information architecture showing pages, modals, and navigation flows.
 
 <!-- sync:data -->
 \\\`\`\`json
 {
-  "id": "root",
-  "label": "Home",
-  "type": "page",
-  "url": "/",
-  "description": "Landing page with dashboard overview",
-  "children": [
+  "tree": {
+    "id": "app-root",
+    "label": "Application",
+    "type": "node",
+    "description": "Root application node",
+    "position": { "x": 50, "y": 50 },
+    "children": [
+      {
+        "id": "login",
+        "label": "Login",
+        "type": "page",
+        "url": "/login",
+        "position": { "x": 50, "y": 200 },
+        "subNodes": [
+          { "id": "login-form", "name": "Login Form", "type": "component" },
+          { "id": "forgot-link", "name": "Forgot Password Link", "type": "component" }
+        ]
+      },
+      {
+        "id": "dashboard",
+        "label": "Dashboard",
+        "type": "page",
+        "url": "/dashboard",
+        "description": "Main workspace",
+        "position": { "x": 400, "y": 200 },
+        "subNodes": [
+          { "id": "project-grid", "name": "Project Grid", "type": "section" },
+          { "id": "create-btn", "name": "Create Project Button", "type": "component" }
+        ]
+      },
+      {
+        "id": "new-project",
+        "label": "New Project",
+        "type": "modal",
+        "description": "Create project dialog",
+        "position": { "x": 750, "y": 200 }
+      }
+    ]
+  },
+  "links": [
     {
-      "id": "dashboard",
-      "label": "Dashboard",
-      "type": "page",
-      "url": "/dashboard",
-      "description": "Main workspace showing key metrics and recent activity",
-      "subNodes": [
-        { "id": "metrics-overview", "label": "Metrics Overview", "type": "section" },
-        { "id": "recent-activity", "label": "Recent Activity", "type": "section" },
-        { "id": "quick-actions", "label": "Quick Actions", "type": "component" }
-      ],
-      "children": [
-        {
-          "id": "analytics",
-          "label": "Analytics",
-          "type": "page",
-          "url": "/dashboard/analytics",
-          "isNew": true,
-          "children": []
-        },
-        {
-          "id": "reports",
-          "label": "Reports",
-          "type": "page",
-          "url": "/dashboard/reports",
-          "children": []
-        }
-      ]
+      "id": "link-login-form-to-dashboard",
+      "sourceId": "login",
+      "sourceSubNodeId": "login-form",
+      "targetId": "dashboard",
+      "type": "action",
+      "label": "Successful login"
     },
     {
-      "id": "projects",
-      "label": "Projects",
-      "type": "page",
-      "url": "/projects",
-      "description": "Project management and collaboration",
-      "children": [
-        {
-          "id": "project-detail",
-          "label": "Project Detail",
-          "type": "page",
-          "url": "/projects/:id",
-          "children": []
-        },
-        {
-          "id": "create-project",
-          "label": "Create Project",
-          "type": "modal",
-          "description": "Modal dialog for creating new projects",
-          "children": []
-        }
-      ]
+      "id": "link-forgot-to-reset",
+      "sourceId": "login",
+      "sourceSubNodeId": "forgot-link",
+      "targetId": "password-reset",
+      "type": "action",
+      "label": "Forgot password flow"
     },
     {
-      "id": "settings",
-      "label": "Settings",
-      "type": "page",
-      "url": "/settings",
-      "children": [
-        {
-          "id": "profile",
-          "label": "Profile",
-          "type": "page",
-          "url": "/settings/profile",
-          "children": []
-        },
-        {
-          "id": "preferences",
-          "label": "Preferences",
-          "type": "modal",
-          "children": []
-        },
-        {
-          "id": "billing",
-          "label": "Billing",
-          "type": "page",
-          "url": "/settings/billing",
-          "children": []
-        }
-      ]
+      "id": "link-create-btn-to-modal",
+      "sourceId": "dashboard",
+      "sourceSubNodeId": "create-btn",
+      "targetId": "new-project",
+      "type": "action",
+      "label": "Opens create dialog"
     },
     {
-      "id": "help",
-      "label": "Help Center",
-      "type": "external",
-      "url": "https://help.example.com",
-      "description": "External documentation and support",
-      "children": []
+      "id": "link-modal-to-dashboard",
+      "sourceId": "new-project",
+      "targetId": "dashboard",
+      "type": "action",
+      "label": "After creation, returns to dashboard"
     }
   ]
 }
@@ -541,35 +561,417 @@ Complete information architecture for our SaaS application, showing all pages, m
 
 #### Best Practices
 
-1. **Use descriptive IDs**: \`user-profile\` not \`page1\`
-2. **Include URLs for all pages**: Helps developers map routes
-3. **Add descriptions for complex pages**: Clarifies purpose
-4. **Mark new features**: Use \`isNew: true\` for recently added pages
-5. **Group related pages**: Use hierarchy to show logical groupings
-6. **Document modals separately**: Don't nest modals under unrelated pages
-7. **Keep depth shallow**: Aim for max 3-4 levels of nesting
+1. **Always include positions for nodes:**
+   Space nodes ~300-400px apart horizontally, ~150-200px vertically to avoid overlap.
+
+2. **Create meaningful connections:**
+   - Every sub-node that leads somewhere should have a link
+   - Data flows should show input → processing → output
+   - User journeys should connect in logical sequence
+
+3. **Use descriptive IDs:**
+   - Node IDs: \`home-page\`, \`settings-modal\`, \`auth-flow\`
+   - Sub-node IDs: \`nav-menu\`, \`hero-cta\`, \`project-list\`
+   - Link IDs: \`link-nav-to-dashboard\`, \`link-cta-to-signup\`
+
+4. **Group related nodes visually:**
+   - Authentication pages together (x: 50-300)
+   - Dashboard pages together (x: 400-700)
+   - Settings/admin together (x: 800-1100)
+
+5. **Choose appropriate link types:**
+   - \`action\`: User clicks/taps to navigate
+   - \`related\`: Content is related but not direct navigation
+   - \`parent\`: Hierarchical relationship
+   - \`references\`: One content references another
 
 #### Common Mistakes
 
-WRONG: Missing children array
+WRONG: Missing links array
+\`\`\`json
+{ "tree": { "id": "root", ... } }
+\`\`\`
+
+CORRECT: Always include links (even if empty)
+\`\`\`json
+{ "tree": { "id": "root", ... }, "links": [] }
+\`\`\`
+
+WRONG: Missing position for nodes
 \`\`\`json
-{ "id": "page", "label": "Page", "type": "page" }
+{ "id": "dashboard", "label": "Dashboard", "type": "page" }
 \`\`\`
 
-CORRECT: Always include children (even if empty)
+CORRECT: Always include position
 \`\`\`json
-{ "id": "page", "label": "Page", "type": "page", "children": [] }
+{ "id": "dashboard", "label": "Dashboard", "type": "page", "position": { "x": 400, "y": 200 } }
 \`\`\`
 
-WRONG: Using generic IDs
+WRONG: Link without type
 \`\`\`json
-{ "id": "page1", "label": "Dashboard", "type": "page", "children": [] }
+{ "id": "link-1", "sourceId": "a", "targetId": "b" }
+\`\`\`
+
+CORRECT: Always specify link type
+\`\`\`json
+{ "id": "link-1", "sourceId": "a", "targetId": "b", "type": "action" }
+\`\`\`
+
+### 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
 \`\`\`
 
-CORRECT: Use meaningful kebab-case IDs
+---
+
+#### 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
-{ "id": "dashboard", "label": "Dashboard", "type": "page", "children": [] }
+{
+  "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
 

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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"}

package/package.json

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