edsger 0.32.0 → 0.33.0

package/dist/phases/chat-processor/product-tools.js

@@ -122,6 +122,241 @@ export function createProductChatMcpServer() {
                     ],
                 };
             }),
+            tool('list_checklists', 'List all checklists for the product. Each checklist can apply to multiple phases and is assigned to a specific role. Returns checklists with their items.', {
+                product_id: z.string().describe('Product ID'),
+                role: z
+                    .string()
+                    .optional()
+                    .describe('Filter by role (product_manager, developer, qa_engineer, technical_lead, ux_designer, devops_engineer, security_engineer)'),
+                phase: z
+                    .string()
+                    .optional()
+                    .describe('Filter by phase (e.g., code_implementation, code_review, technical_design)'),
+            }, async (args) => {
+                const params = {
+                    product_id: args.product_id,
+                };
+                if (args.role)
+                    params.role = args.role;
+                if (args.phase)
+                    params.phase = args.phase;
+                const result = await callMcpEndpoint('checklists/list', params);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }),
+            tool('manage_checklists', 'Create, update, or delete checklists. A checklist belongs to a product, is assigned to a role, and applies to one or more phases (phases is an array). When creating, you can include items inline.', {
+                product_id: z.string().describe('Product ID'),
+                actions: z.array(z.object({
+                    action: z.enum(['create', 'update', 'delete']),
+                    checklist_id: z
+                        .string()
+                        .optional()
+                        .describe('Required for update/delete'),
+                    name: z.string().optional().describe('Checklist name (for create/update)'),
+                    description: z
+                        .string()
+                        .optional()
+                        .describe('Checklist description'),
+                    role: z
+                        .string()
+                        .optional()
+                        .describe('Role: product_manager, developer, qa_engineer, technical_lead, ux_designer, devops_engineer, security_engineer'),
+                    phases: z
+                        .array(z.string())
+                        .optional()
+                        .describe('Array of phases this checklist applies to (e.g., ["code_implementation", "code_review"]). A checklist can apply to multiple phases.'),
+                    is_active: z.boolean().optional().describe('Whether the checklist is active'),
+                    sort_order: z.number().optional().describe('Sort order for display'),
+                    items: z
+                        .array(z.object({
+                        title: z.string(),
+                        description: z.string().optional(),
+                        item_type: z
+                            .enum(['boolean', 'text', 'number', 'select'])
+                            .optional(),
+                        is_required: z.boolean().optional(),
+                    }))
+                        .optional()
+                        .describe('Items to create with the checklist (only for create action)'),
+                })),
+            }, async (args) => {
+                const results = [];
+                for (const action of args.actions) {
+                    try {
+                        if (action.action === 'create') {
+                            if (!action.name || !action.role || !action.phases?.length) {
+                                results.push({
+                                    action: 'create',
+                                    success: false,
+                                    error: 'name, role, and phases are required for create',
+                                });
+                                continue;
+                            }
+                            const result = await callMcpEndpoint('checklists/create', {
+                                product_id: args.product_id,
+                                name: action.name,
+                                description: action.description || null,
+                                role: action.role,
+                                phases: action.phases,
+                                is_active: action.is_active ?? true,
+                                sort_order: action.sort_order ?? 0,
+                                items: action.items,
+                            });
+                            results.push({ action: 'create', success: true, data: result });
+                        }
+                        else if (action.action === 'update' && action.checklist_id) {
+                            const params = {
+                                checklist_id: action.checklist_id,
+                            };
+                            if (action.name !== undefined)
+                                params.name = action.name;
+                            if (action.description !== undefined)
+                                params.description = action.description;
+                            if (action.role !== undefined)
+                                params.role = action.role;
+                            if (action.phases !== undefined)
+                                params.phases = action.phases;
+                            if (action.is_active !== undefined)
+                                params.is_active = action.is_active;
+                            if (action.sort_order !== undefined)
+                                params.sort_order = action.sort_order;
+                            const result = await callMcpEndpoint('checklists/update', params);
+                            results.push({ action: 'update', success: true, data: result });
+                        }
+                        else if (action.action === 'delete' && action.checklist_id) {
+                            const result = await callMcpEndpoint('checklists/delete', {
+                                checklist_id: action.checklist_id,
+                            });
+                            results.push({ action: 'delete', success: true, data: result });
+                        }
+                        else {
+                            results.push({
+                                action: action.action,
+                                success: false,
+                                error: `Missing required checklist_id for ${action.action}`,
+                            });
+                        }
+                    }
+                    catch (error) {
+                        const msg = error instanceof Error ? error.message : String(error);
+                        results.push({
+                            action: action.action,
+                            success: false,
+                            error: msg,
+                        });
+                    }
+                }
+                return {
+                    content: [
+                        { type: 'text', text: JSON.stringify({ results }, null, 2) },
+                    ],
+                };
+            }),
+            tool('manage_checklist_items', 'Add, update, or delete items within a checklist. Each item has a title, type (boolean/text/number/select), and required flag.', {
+                actions: z.array(z.object({
+                    action: z.enum(['create', 'update', 'delete']),
+                    checklist_id: z
+                        .string()
+                        .optional()
+                        .describe('Checklist ID to add items to (required for create)'),
+                    item_id: z
+                        .string()
+                        .optional()
+                        .describe('Item ID (required for update/delete)'),
+                    title: z.string().optional().describe('Item title'),
+                    description: z.string().optional().describe('Item description'),
+                    item_type: z
+                        .enum(['boolean', 'text', 'number', 'select'])
+                        .optional()
+                        .describe('Item type (default: boolean)'),
+                    is_required: z
+                        .boolean()
+                        .optional()
+                        .describe('Whether this item is required'),
+                    sort_order: z.number().optional().describe('Sort order'),
+                    config: z
+                        .record(z.string(), z.unknown())
+                        .optional()
+                        .describe('Additional config (e.g., options for select type)'),
+                })),
+            }, async (args) => {
+                const results = [];
+                for (const action of args.actions) {
+                    try {
+                        if (action.action === 'create' && action.checklist_id) {
+                            if (!action.title) {
+                                results.push({
+                                    action: 'create',
+                                    success: false,
+                                    error: 'title is required for create',
+                                });
+                                continue;
+                            }
+                            const result = await callMcpEndpoint('checklist_items/create', {
+                                checklist_id: action.checklist_id,
+                                items: [
+                                    {
+                                        title: action.title,
+                                        description: action.description || null,
+                                        item_type: action.item_type || 'boolean',
+                                        is_required: action.is_required ?? true,
+                                        sort_order: action.sort_order,
+                                        config: action.config,
+                                    },
+                                ],
+                            });
+                            results.push({ action: 'create', success: true, data: result });
+                        }
+                        else if (action.action === 'update' && action.item_id) {
+                            const params = {
+                                item_id: action.item_id,
+                            };
+                            if (action.title !== undefined)
+                                params.title = action.title;
+                            if (action.description !== undefined)
+                                params.description = action.description;
+                            if (action.item_type !== undefined)
+                                params.item_type = action.item_type;
+                            if (action.is_required !== undefined)
+                                params.is_required = action.is_required;
+                            if (action.sort_order !== undefined)
+                                params.sort_order = action.sort_order;
+                            if (action.config !== undefined)
+                                params.config = action.config;
+                            const result = await callMcpEndpoint('checklist_items/update', params);
+                            results.push({ action: 'update', success: true, data: result });
+                        }
+                        else if (action.action === 'delete' && action.item_id) {
+                            const result = await callMcpEndpoint('checklist_items/delete', {
+                                item_id: action.item_id,
+                            });
+                            results.push({ action: 'delete', success: true, data: result });
+                        }
+                        else {
+                            const missing = action.action === 'create' ? 'checklist_id' : 'item_id';
+                            results.push({
+                                action: action.action,
+                                success: false,
+                                error: `Missing required ${missing} for ${action.action}`,
+                            });
+                        }
+                    }
+                    catch (error) {
+                        const msg = error instanceof Error ? error.message : String(error);
+                        results.push({
+                            action: action.action,
+                            success: false,
+                            error: msg,
+                        });
+                    }
+                }
+                return {
+                    content: [
+                        { type: 'text', text: JSON.stringify({ results }, null, 2) },
+                    ],
+                };
+            }),
             tool('send_chat_message', 'Send a follow-up message to the chat. Use for explanations, summaries, or asking clarifying questions.', {
                 channel_id: z.string().describe('Chat channel ID'),
                 content: z.string().describe('Message content (markdown)'),

package/dist/phases/chat-processor/prompts.d.ts

@@ -5,7 +5,7 @@
  * 1. CHAT_RESPONSE_PROMPT — responding to human messages
  * 2. NEXT_STEP_ADVISOR_PROMPT — proactive suggestions after phase completion
  */
-export declare const CHAT_RESPONSE_PROMPT = "You are an AI assistant embedded in Edsger, a software development platform. You are helping a team develop a feature.\n\n## Your Capabilities\nYou can see the feature's current state, user stories, test cases, workflow phases, and code. You have tools to:\n- Modify feature status, execution mode, and workflow phases\n- Create/update user stories and test cases\n- Read, search, edit, and write source code files (Bash, Glob, Grep, Read, Edit, Write)\n- Send follow-up messages and present options to the user\n- Trigger phase reruns\n- Create tasks for team members (human) or AI\n- Look up product team members by name\n\n## How to Respond\n1. **Understand the intent** \u2014 Is this feedback, a question, a request to change something, or just a comment?\n2. **Take action if needed** \u2014 Use the appropriate tools to make changes\n3. **Respond concisely** \u2014 Summarize what you understood and what you did (or why you didn't do anything)\n4. **Ask for clarification** \u2014 If the message is ambiguous, use provide_options to present choices\n\n## Communication Style\n- Respond in the same language the user writes in\n- Be concise but thorough \u2014 no filler text\n- Reference specific items by name (e.g., \"User Story #3: Login flow\")\n- When making changes, always explain what you changed and why\n\n## Phase Reference (know what each phase does before suggesting it)\n- **code-implementation**: Writes/updates production code (creates or modifies code)\n- **pr-execution**: Syncs already-written code from dev branch to split PR branches (does NOT write new code)\n- **bug-fixing**: Fixes code bugs and test failures\n- To fix bugs or update code \u2192 suggest **code-implementation** or **bug-fixing**, NOT pr-execution\n\n## Task Creation\nWhen the user asks to notify someone, assign a review, or request action from a team member:\n1. Use list_product_members to find the person by name\n2. Use create_task with executor=\"human\", the resolved user ID, and the correct action_url\n3. Confirm in chat what you created and who it's assigned to\n\nWhen the user describes work for AI to do (e.g., \"implement X\", \"fix Y\"):\n1. Use create_task with executor=\"ai\" \u2014 the task worker will pick it up automatically\n\n### Action URL Patterns\nAlways set action_url to link to the most relevant page. Available patterns:\n- Product page: `/products/{product_id}`\n- Feature details: `/products/{product_id}/features/{feature_id}`\n- Feature tab (append ?tab=): `/products/{product_id}/features/{feature_id}?tab={tab}`\n\nAvailable feature tabs:\n- `stories` \u2014 User Stories (use for: review user stories, update stories)\n- `test-cases` \u2014 Test Cases (use for: review test cases, verify tests)\n- `technical-design` \u2014 Technical Design (use for: review design, architecture review)\n- `checklists` \u2014 Checklists (use for: review checklists, quality checks)\n- `branches` \u2014 Branches (use for: code review, branch management)\n- `pull-requests` \u2014 Pull Requests (use for: review PRs, merge requests)\n- `test-reports` \u2014 Test Reports (use for: review test results)\n- `feedbacks` \u2014 Feedbacks (use for: provide feedback)\n- `chat` \u2014 Chat (use for: discussion)\n- `details` \u2014 Feature Details (default)\n\nChoose the tab that best matches the task content. For example:\n- \"review user stories\" \u2192 `?tab=stories`\n- \"review technical design\" \u2192 `?tab=technical-design`\n- \"check test results\" \u2192 `?tab=test-reports`\n\n## Code Implementation\nWhen the user asks you to implement code, fix bugs, or make code changes, you can do it directly using Bash, Read, Edit, and Write tools. Follow this workflow:\n\n### Git Workflow\n1. **Check current state**: `git status` and `git branch` to understand the current branch\n2. **Update base branch**: `git checkout main && git pull origin main --rebase` (use the repo's default branch)\n3. **Create a new branch**: Use the `edsger/` prefix followed by a descriptive name based on what you're implementing (e.g., `edsger/fix-login-validation`, `edsger/add-dark-mode`, `edsger/refactor-api-client`). Do NOT use the `dev/{feature_id}` pattern \u2014 that is reserved for the code-implementation workflow phase.\n4. **Analyze codebase**: Use Glob and Read to understand existing patterns and structure\n5. **Implement changes**: Use Edit/Write to modify or create files\n6. **Validate**: Run lint, build, or type checks as appropriate for the project\n7. **Commit**: `git add <files> && git commit -m \"feat: description\"` with conventional commit messages\n8. **Handle pre-commit hooks**: If hooks fail, fix the issues and retry (don't use --no-verify)\n\n### When to Implement Code Directly vs Suggest a Phase\n- **Implement directly**: Small to medium changes the user describes clearly (e.g., \"add a button\", \"fix this bug\", \"update the API endpoint\")\n- **Suggest code-implementation phase**: Large features requiring full user story/test case/technical design context \u2014 use update_feature_status to set ready_for_ai or trigger_phase_rerun for code_implementation\n- **Ask the user**: If unsure about scope, use provide_options to let them choose\n\n### After Implementation\nWhen you finish writing code, use send_chat_message to report the results. Include:\n- **Branch name** created or used\n- **Summary** of what was implemented or changed\n- **Files created/modified** (list key files)\n- **Commit hash** (short form)\n- **PR creation link** \u2014 construct a GitHub compare URL so the user can click to create a PR: `https://github.com/{owner}/{repo}/compare/{base}...{branch}?expand=1`. Get owner/repo from `git remote get-url origin`.\n- **Next steps** \u2014 e.g., review the changes, run tests, or merge the PR\n\n### Implementation Standards\n- Follow existing code patterns and conventions in the repository\n- Use proper TypeScript types and interfaces\n- Handle error cases appropriately\n- Write clean, maintainable code\n- Reference user stories and test cases from the feature context when implementing\n\n## Important Rules\n- Never make destructive changes without confirmation (deleting stories, resetting phases)\n- For ambiguous feedback, present options rather than guessing\n- If you can't do something, explain why clearly\n- When creating tasks for people, always confirm the person's identity if the name is ambiguous\n";
+export declare const CHAT_RESPONSE_PROMPT = "You are an AI assistant embedded in Edsger, a software development platform. You are helping a team develop a feature.\n\n## Your Capabilities\nYou can see the feature's current state, user stories, test cases, workflow phases, and code. You have tools to:\n- Modify feature status, execution mode, and workflow phases\n- Create/update user stories and test cases\n- List, create, update, and delete checklists and checklist items (a checklist can apply to multiple phases)\n- Read, search, edit, and write source code files (Bash, Glob, Grep, Read, Edit, Write)\n- Send follow-up messages and present options to the user\n- Trigger phase reruns\n- Create tasks for team members (human) or AI\n- Look up product team members by name\n\n## How to Respond\n1. **Understand the intent** \u2014 Is this feedback, a question, a request to change something, or just a comment?\n2. **Take action if needed** \u2014 Use the appropriate tools to make changes\n3. **Respond concisely** \u2014 Summarize what you understood and what you did (or why you didn't do anything)\n4. **Ask for clarification** \u2014 If the message is ambiguous, use provide_options to present choices\n\n## Communication Style\n- Respond in the same language the user writes in\n- Be concise but thorough \u2014 no filler text\n- Reference specific items by name (e.g., \"User Story #3: Login flow\")\n- When making changes, always explain what you changed and why\n\n## Phase Reference (know what each phase does before suggesting it)\n- **code-implementation**: Writes/updates production code (creates or modifies code)\n- **pr-execution**: Syncs already-written code from dev branch to split PR branches (does NOT write new code)\n- **bug-fixing**: Fixes code bugs and test failures\n- To fix bugs or update code \u2192 suggest **code-implementation** or **bug-fixing**, NOT pr-execution\n\n## Task Creation\nWhen the user asks to notify someone, assign a review, or request action from a team member:\n1. Use list_product_members to find the person by name\n2. Use create_task with executor=\"human\", the resolved user ID, and the correct action_url\n3. Confirm in chat what you created and who it's assigned to\n\nWhen the user describes work for AI to do (e.g., \"implement X\", \"fix Y\"):\n1. Use create_task with executor=\"ai\" \u2014 the task worker will pick it up automatically\n\n### Action URL Patterns\nAlways set action_url to link to the most relevant page. Available patterns:\n- Product page: `/products/{product_id}`\n- Feature details: `/products/{product_id}/features/{feature_id}`\n- Feature tab (append ?tab=): `/products/{product_id}/features/{feature_id}?tab={tab}`\n\nAvailable feature tabs:\n- `stories` \u2014 User Stories (use for: review user stories, update stories)\n- `test-cases` \u2014 Test Cases (use for: review test cases, verify tests)\n- `technical-design` \u2014 Technical Design (use for: review design, architecture review)\n- `checklists` \u2014 Checklists (use for: review checklists, quality checks)\n- `branches` \u2014 Branches (use for: code review, branch management)\n- `pull-requests` \u2014 Pull Requests (use for: review PRs, merge requests)\n- `test-reports` \u2014 Test Reports (use for: review test results)\n- `feedbacks` \u2014 Feedbacks (use for: provide feedback)\n- `chat` \u2014 Chat (use for: discussion)\n- `details` \u2014 Feature Details (default)\n\nChoose the tab that best matches the task content. For example:\n- \"review user stories\" \u2192 `?tab=stories`\n- \"review technical design\" \u2192 `?tab=technical-design`\n- \"check test results\" \u2192 `?tab=test-reports`\n\n## Code Implementation\nWhen the user asks you to implement code, fix bugs, or make code changes, you can do it directly using Bash, Read, Edit, and Write tools. Follow this workflow:\n\n### Git Workflow\n1. **Check current state**: `git status` and `git branch` to understand the current branch\n2. **Update base branch**: `git checkout main && git pull origin main --rebase` (use the repo's default branch)\n3. **Create a new branch**: Use the `edsger/` prefix followed by a descriptive name based on what you're implementing (e.g., `edsger/fix-login-validation`, `edsger/add-dark-mode`, `edsger/refactor-api-client`). Do NOT use the `dev/{feature_id}` pattern \u2014 that is reserved for the code-implementation workflow phase.\n4. **Analyze codebase**: Use Glob and Read to understand existing patterns and structure\n5. **Implement changes**: Use Edit/Write to modify or create files\n6. **Validate**: Run lint, build, or type checks as appropriate for the project\n7. **Commit**: `git add <files> && git commit -m \"feat: description\"` with conventional commit messages\n8. **Handle pre-commit hooks**: If hooks fail, fix the issues and retry (don't use --no-verify)\n\n### When to Implement Code Directly vs Suggest a Phase\n- **Implement directly**: Small to medium changes the user describes clearly (e.g., \"add a button\", \"fix this bug\", \"update the API endpoint\")\n- **Suggest code-implementation phase**: Large features requiring full user story/test case/technical design context \u2014 use update_feature_status to set ready_for_ai or trigger_phase_rerun for code_implementation\n- **Ask the user**: If unsure about scope, use provide_options to let them choose\n\n### After Implementation\nWhen you finish writing code, use send_chat_message to report the results. Include:\n- **Branch name** created or used\n- **Summary** of what was implemented or changed\n- **Files created/modified** (list key files)\n- **Commit hash** (short form)\n- **PR creation link** \u2014 construct a GitHub compare URL so the user can click to create a PR: `https://github.com/{owner}/{repo}/compare/{base}...{branch}?expand=1`. Get owner/repo from `git remote get-url origin`.\n- **Next steps** \u2014 e.g., review the changes, run tests, or merge the PR\n\n### Implementation Standards\n- Follow existing code patterns and conventions in the repository\n- Use proper TypeScript types and interfaces\n- Handle error cases appropriately\n- Write clean, maintainable code\n- Reference user stories and test cases from the feature context when implementing\n\n## Important Rules\n- Never make destructive changes without confirmation (deleting stories, resetting phases)\n- For ambiguous feedback, present options rather than guessing\n- If you can't do something, explain why clearly\n- When creating tasks for people, always confirm the person's identity if the name is ambiguous\n";
 export declare const NEXT_STEP_ADVISOR_PROMPT = "You are an AI advisor in Edsger, a software development platform. A workflow phase just completed for a feature you're helping develop.\n\n## Your Job\nAnalyze the completed phase output and the feature's current state, then give a concrete, data-backed suggestion for what to do next.\n\n## Critical Rules\n1. **Reference specific data** \u2014 \"8 user stories generated, 3 involve complex auth logic\" not \"several stories were created\"\n2. **Explain your reasoning** \u2014 \"Because Story #3 involves concurrent editing, I suggest writing test cases first to define edge cases before implementation\"\n3. **Present actionable options** \u2014 Always use the provide_options tool to give 2-4 choices the user can click\n4. **Do NOT follow a fixed phase order** \u2014 Adapt based on:\n   - Feature size and complexity\n   - What was just produced (quality, coverage, gaps)\n   - Previous human feedback in the chat\n   - Whether certain phases can be skipped for simple features\n5. **Flag issues proactively** \u2014 If the phase output has gaps, incomplete coverage, or potential problems, call them out\n\n## Phase Reference (know what each phase does before suggesting it)\n- **code-implementation**: Writes/updates production code (the phase that creates or modifies code)\n- **pr-splitting**: Plans how to split code changes into reviewable PRs\n- **pr-execution**: Syncs already-written code from the dev branch to split PR branches (does NOT write new code)\n- **code-testing**: Writes automated tests for implemented code\n- **functional-testing**: Runs end-to-end tests with Playwright\n- **bug-fixing**: Fixes code bugs and test failures\n- **code-review**: Reviews PR code for issues\n- **code-refine**: Updates code based on PR review feedback\n\n**Important distinctions:**\n- To fix bugs or update code \u2192 use **code-implementation** or **bug-fixing**, NOT pr-execution\n- pr-execution only moves existing code to PR branches \u2014 it never creates or modifies implementation code\n\n## Context You Receive\n- Feature description, size, and current state\n- The completed phase name and its full output\n- Remaining workflow phases (with descriptions)\n- User story and test case counts\n- Code change scope (if applicable)\n- Recent chat history (human feedback)\n\n## Communication Style\n- Respond in the same language as recent chat messages (default to the feature's language context)\n- Be specific and data-driven\n- Structure: brief summary \u2192 reasoning \u2192 options\n";
 /**
  * Phase descriptions so the AI advisor understands what each phase does.

package/dist/phases/chat-processor/prompts.js

@@ -11,6 +11,7 @@ export const CHAT_RESPONSE_PROMPT = `You are an AI assistant embedded in Edsger,
 You can see the feature's current state, user stories, test cases, workflow phases, and code. You have tools to:
 - Modify feature status, execution mode, and workflow phases
 - Create/update user stories and test cases
+- List, create, update, and delete checklists and checklist items (a checklist can apply to multiple phases)
 - Read, search, edit, and write source code files (Bash, Glob, Grep, Read, Edit, Write)
 - Send follow-up messages and present options to the user
 - Trigger phase reruns

package/dist/phases/chat-processor/tools.js

@@ -213,6 +213,241 @@ export function createChatMcpServer() {
                     ],
                 };
             }),
+            tool('list_checklists', 'List checklists for the product this feature belongs to. Each checklist can apply to multiple phases and is assigned to a specific role. Returns checklists with their items.', {
+                product_id: z.string().describe('Product ID'),
+                role: z
+                    .string()
+                    .optional()
+                    .describe('Filter by role (product_manager, developer, qa_engineer, technical_lead, ux_designer, devops_engineer, security_engineer)'),
+                phase: z
+                    .string()
+                    .optional()
+                    .describe('Filter by phase (e.g., code_implementation, code_review, technical_design)'),
+            }, async (args) => {
+                const params = {
+                    product_id: args.product_id,
+                };
+                if (args.role)
+                    params.role = args.role;
+                if (args.phase)
+                    params.phase = args.phase;
+                const result = await callMcpEndpoint('checklists/list', params);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }),
+            tool('manage_checklists', 'Create, update, or delete checklists. A checklist belongs to a product, is assigned to a role, and applies to one or more phases (phases is an array). When creating, you can include items inline.', {
+                product_id: z.string().describe('Product ID'),
+                actions: z.array(z.object({
+                    action: z.enum(['create', 'update', 'delete']),
+                    checklist_id: z
+                        .string()
+                        .optional()
+                        .describe('Required for update/delete'),
+                    name: z.string().optional().describe('Checklist name (for create/update)'),
+                    description: z
+                        .string()
+                        .optional()
+                        .describe('Checklist description'),
+                    role: z
+                        .string()
+                        .optional()
+                        .describe('Role: product_manager, developer, qa_engineer, technical_lead, ux_designer, devops_engineer, security_engineer'),
+                    phases: z
+                        .array(z.string())
+                        .optional()
+                        .describe('Array of phases this checklist applies to (e.g., ["code_implementation", "code_review"]). A checklist can apply to multiple phases.'),
+                    is_active: z.boolean().optional().describe('Whether the checklist is active'),
+                    sort_order: z.number().optional().describe('Sort order for display'),
+                    items: z
+                        .array(z.object({
+                        title: z.string(),
+                        description: z.string().optional(),
+                        item_type: z
+                            .enum(['boolean', 'text', 'number', 'select'])
+                            .optional(),
+                        is_required: z.boolean().optional(),
+                    }))
+                        .optional()
+                        .describe('Items to create with the checklist (only for create action)'),
+                })),
+            }, async (args) => {
+                const results = [];
+                for (const action of args.actions) {
+                    try {
+                        if (action.action === 'create') {
+                            if (!action.name || !action.role || !action.phases?.length) {
+                                results.push({
+                                    action: 'create',
+                                    success: false,
+                                    error: 'name, role, and phases are required for create',
+                                });
+                                continue;
+                            }
+                            const result = await callMcpEndpoint('checklists/create', {
+                                product_id: args.product_id,
+                                name: action.name,
+                                description: action.description || null,
+                                role: action.role,
+                                phases: action.phases,
+                                is_active: action.is_active ?? true,
+                                sort_order: action.sort_order ?? 0,
+                                items: action.items,
+                            });
+                            results.push({ action: 'create', success: true, data: result });
+                        }
+                        else if (action.action === 'update' && action.checklist_id) {
+                            const params = {
+                                checklist_id: action.checklist_id,
+                            };
+                            if (action.name !== undefined)
+                                params.name = action.name;
+                            if (action.description !== undefined)
+                                params.description = action.description;
+                            if (action.role !== undefined)
+                                params.role = action.role;
+                            if (action.phases !== undefined)
+                                params.phases = action.phases;
+                            if (action.is_active !== undefined)
+                                params.is_active = action.is_active;
+                            if (action.sort_order !== undefined)
+                                params.sort_order = action.sort_order;
+                            const result = await callMcpEndpoint('checklists/update', params);
+                            results.push({ action: 'update', success: true, data: result });
+                        }
+                        else if (action.action === 'delete' && action.checklist_id) {
+                            const result = await callMcpEndpoint('checklists/delete', {
+                                checklist_id: action.checklist_id,
+                            });
+                            results.push({ action: 'delete', success: true, data: result });
+                        }
+                        else {
+                            results.push({
+                                action: action.action,
+                                success: false,
+                                error: `Missing required checklist_id for ${action.action}`,
+                            });
+                        }
+                    }
+                    catch (error) {
+                        const msg = error instanceof Error ? error.message : String(error);
+                        results.push({
+                            action: action.action,
+                            success: false,
+                            error: msg,
+                        });
+                    }
+                }
+                return {
+                    content: [
+                        { type: 'text', text: JSON.stringify({ results }, null, 2) },
+                    ],
+                };
+            }),
+            tool('manage_checklist_items', 'Add, update, or delete items within a checklist. Each item has a title, type (boolean/text/number/select), and required flag.', {
+                actions: z.array(z.object({
+                    action: z.enum(['create', 'update', 'delete']),
+                    checklist_id: z
+                        .string()
+                        .optional()
+                        .describe('Checklist ID to add items to (required for create)'),
+                    item_id: z
+                        .string()
+                        .optional()
+                        .describe('Item ID (required for update/delete)'),
+                    title: z.string().optional().describe('Item title'),
+                    description: z.string().optional().describe('Item description'),
+                    item_type: z
+                        .enum(['boolean', 'text', 'number', 'select'])
+                        .optional()
+                        .describe('Item type (default: boolean)'),
+                    is_required: z
+                        .boolean()
+                        .optional()
+                        .describe('Whether this item is required'),
+                    sort_order: z.number().optional().describe('Sort order'),
+                    config: z
+                        .record(z.string(), z.unknown())
+                        .optional()
+                        .describe('Additional config (e.g., options for select type)'),
+                })),
+            }, async (args) => {
+                const results = [];
+                for (const action of args.actions) {
+                    try {
+                        if (action.action === 'create' && action.checklist_id) {
+                            if (!action.title) {
+                                results.push({
+                                    action: 'create',
+                                    success: false,
+                                    error: 'title is required for create',
+                                });
+                                continue;
+                            }
+                            const result = await callMcpEndpoint('checklist_items/create', {
+                                checklist_id: action.checklist_id,
+                                items: [
+                                    {
+                                        title: action.title,
+                                        description: action.description || null,
+                                        item_type: action.item_type || 'boolean',
+                                        is_required: action.is_required ?? true,
+                                        sort_order: action.sort_order,
+                                        config: action.config,
+                                    },
+                                ],
+                            });
+                            results.push({ action: 'create', success: true, data: result });
+                        }
+                        else if (action.action === 'update' && action.item_id) {
+                            const params = {
+                                item_id: action.item_id,
+                            };
+                            if (action.title !== undefined)
+                                params.title = action.title;
+                            if (action.description !== undefined)
+                                params.description = action.description;
+                            if (action.item_type !== undefined)
+                                params.item_type = action.item_type;
+                            if (action.is_required !== undefined)
+                                params.is_required = action.is_required;
+                            if (action.sort_order !== undefined)
+                                params.sort_order = action.sort_order;
+                            if (action.config !== undefined)
+                                params.config = action.config;
+                            const result = await callMcpEndpoint('checklist_items/update', params);
+                            results.push({ action: 'update', success: true, data: result });
+                        }
+                        else if (action.action === 'delete' && action.item_id) {
+                            const result = await callMcpEndpoint('checklist_items/delete', {
+                                item_id: action.item_id,
+                            });
+                            results.push({ action: 'delete', success: true, data: result });
+                        }
+                        else {
+                            const missing = action.action === 'create' ? 'checklist_id' : 'item_id';
+                            results.push({
+                                action: action.action,
+                                success: false,
+                                error: `Missing required ${missing} for ${action.action}`,
+                            });
+                        }
+                    }
+                    catch (error) {
+                        const msg = error instanceof Error ? error.message : String(error);
+                        results.push({
+                            action: action.action,
+                            success: false,
+                            error: msg,
+                        });
+                    }
+                }
+                return {
+                    content: [
+                        { type: 'text', text: JSON.stringify({ results }, null, 2) },
+                    ],
+                };
+            }),
             tool('send_chat_message', 'Send a follow-up message to the chat. Use for explanations, summaries, or asking clarifying questions.', {
                 channel_id: z.string().describe('Chat channel ID'),
                 content: z.string().describe('Message content (markdown)'),

package/dist/phases/code-implementation/index.js

@@ -720,7 +720,7 @@ This is a **multi-branch feature** - the feature has been split into multiple br
         logDebug(`Checklist info length: ${checklistInfo.length}`, verbose);
         logDebug(`Checklist info preview: ${checklistInfo.substring(0, 300)}`, verbose);
         checklistContext.checklists.forEach((checklist, index) => {
-            logDebug(`Checklist ${index + 1}: id=${checklist.id}, name=${checklist.name}, phase=${checklist.phase}, role=${checklist.role}, itemCount=${checklist.items?.length || 0}`, verbose);
+            logDebug(`Checklist ${index + 1}: id=${checklist.id}, name=${checklist.name}, phases=${checklist.phases?.join(',')}, role=${checklist.role}, itemCount=${checklist.items?.length || 0}`, verbose);
             if (checklist.items) {
                 checklist.items.forEach((item, itemIndex) => {
                     logDebug(`  Item ${itemIndex + 1}: id=${item.id}, title=${item.title?.substring(0, 50) || 'No title'}, description=${item.description?.substring(0, 50) || 'No description'}`, verbose);

package/dist/services/checklist.d.ts

@@ -19,7 +19,7 @@ export interface Checklist {
     name: string;
     description: string | null;
     role: string;
-    phase: string;
+    phases: string[];
     is_active: boolean;
     sort_order: number;
     created_at: string;

package/dist/services/checklist.js

@@ -243,7 +243,10 @@ export function formatChecklistsForContext(context) {
         const itemsText = checklist.items
             .map((item) => `  - **${item.title}** (ID: ${item.id})${item.is_required ? ' (required)' : ''}: ${item.description || 'No description'}`)
             .join('\n');
-        return `**${checklist.name}** (${checklist.role})
+        const phasesLabel = checklist.phases?.length > 0
+            ? ` [Phases: ${checklist.phases.join(', ')}]`
+            : '';
+        return `**${checklist.name}** (${checklist.role})${phasesLabel}
 ID: ${checklist.id}
 ${checklist.description || 'No description'}
 Items:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edsger",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "type": "module",
   "bin": {
     "edsger": "dist/index.js"