forgepm 0.7.0

package/dist/src/github/pull.js

@@ -0,0 +1,51 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+import { validateGitHubName } from '../utils/validation.js';
+export class GitHubPullSync {
+    owner;
+    repo;
+    constructor(owner, repo) {
+        this.owner = owner;
+        this.repo = repo;
+        validateGitHubName(owner, repo);
+    }
+    async pull(store, bus) {
+        const result = { totalFetched: 0, tasksClosed: 0, errors: [] };
+        let issues;
+        try {
+            const { stdout } = await execFileAsync('gh', [
+                'issue', 'list',
+                '--repo', `${this.owner}/${this.repo}`,
+                '--label', 'forge:tracked',
+                '--state', 'all',
+                '--json', 'number,state,labels,title',
+                '--limit', '200',
+            ]);
+            issues = JSON.parse(stdout);
+        }
+        catch (err) {
+            result.errors.push(`Failed to fetch issues: ${err instanceof Error ? err.message : String(err)}`);
+            return result;
+        }
+        result.totalFetched = issues.length;
+        // Get all local tasks with github_issue_number
+        const localTasks = store.query('SELECT id, status, github_issue_number FROM tasks WHERE github_issue_number IS NOT NULL AND github_issue_number > 0');
+        const localByIssue = new Map(localTasks.map(t => [t.github_issue_number, t]));
+        for (const issue of issues) {
+            const localTask = localByIssue.get(issue.number);
+            if (!localTask)
+                continue; // Issue not tracked locally
+            // Conflict policy: SQLite wins — only process unidirectional events
+            // If GitHub issue is closed but local task is not done/blocked, mark it done
+            if (issue.state === 'closed' && localTask.status !== 'done' && localTask.status !== 'blocked') {
+                store.run('UPDATE tasks SET status = ?, updated_at = datetime("now") WHERE id = ?', ['done', localTask.id]);
+                bus.publish({ type: 'pull.task_closed', taskId: localTask.id, issueNumber: issue.number });
+                result.tasksClosed++;
+            }
+        }
+        bus.publish({ type: 'pull.completed', synced: result.tasksClosed });
+        return result;
+    }
+}
+//# sourceMappingURL=pull.js.map

package/dist/src/github/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../../src/github/pull.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAe1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,OAAO,cAAc;IAEf;IACA;IAFV,YACU,KAAa,EACb,IAAY;QADZ,UAAK,GAAL,KAAK,CAAQ;QACb,SAAI,GAAJ,IAAI,CAAQ;QAEpB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAmB,EAAE,GAAa;QAC3C,MAAM,MAAM,GAAe,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAE3E,IAAI,MAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE;gBAC3C,OAAO,EAAE,MAAM;gBACf,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE;gBACtC,SAAS,EAAE,eAAe;gBAC1B,SAAS,EAAE,KAAK;gBAChB,QAAQ,EAAE,2BAA2B;gBACrC,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAkB,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClG,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;QAEpC,+CAA+C;QAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAC5B,qHAAqH,CACtH,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,SAAS;gBAAE,SAAS,CAAC,4BAA4B;YAEtD,oEAAoE;YACpE,6EAA6E;YAC7E,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9F,KAAK,CAAC,GAAG,CAAC,wEAAwE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC5G,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC3F,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QAED,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/src/github/push.d.ts

@@ -0,0 +1,20 @@
+import type { OverlayStore } from '../core/store.js';
+interface PushTask {
+    id: string;
+    title: string;
+    status: string;
+    complexity: number;
+    github_issue_number?: number;
+}
+export declare class GitHubPushSync {
+    private owner;
+    private repo;
+    private projectNumber;
+    constructor(owner: string, repo: string, projectNumber: number);
+    pushTask(task: PushTask): Promise<number>;
+    closeTask(issueNumber: number): Promise<void>;
+    updateProjectField(_itemId: string, _fieldId: string, _value: string | number): Promise<void>;
+    processSyncOutbox(store: OverlayStore): Promise<number>;
+    private statusToLabel;
+}
+export {};

package/dist/src/github/push.js

@@ -0,0 +1,118 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+import { validateGitHubName } from '../utils/validation.js';
+export class GitHubPushSync {
+    owner;
+    repo;
+    projectNumber;
+    constructor(owner, repo, projectNumber) {
+        this.owner = owner;
+        this.repo = repo;
+        this.projectNumber = projectNumber;
+        validateGitHubName(owner, repo);
+    }
+    async pushTask(task) {
+        const repoFlag = `${this.owner}/${this.repo}`;
+        if (!task.github_issue_number) {
+            // Create new issue
+            const { stdout } = await execFileAsync('gh', [
+                'issue',
+                'create',
+                '--repo',
+                repoFlag,
+                '--title',
+                task.title,
+                '--body',
+                `ForgePM task \`${task.id}\`\nStatus: ${task.status}\nComplexity: ${task.complexity}`,
+                '--label',
+                'forge:tracked',
+            ]);
+            // gh issue create outputs the issue URL on stdout
+            const match = stdout.trim().match(/\/issues\/(\d+)/);
+            if (!match)
+                throw new Error(`Failed to parse issue URL from gh output: ${stdout.trim()}`);
+            return parseInt(match[1], 10);
+        }
+        else {
+            // Update existing issue — update title and labels via gh issue edit
+            const statusLabel = this.statusToLabel(task.status);
+            const editArgs = [
+                'issue',
+                'edit',
+                String(task.github_issue_number),
+                '--repo',
+                repoFlag,
+                '--title',
+                task.title,
+                '--body',
+                `ForgePM task \`${task.id}\`\nStatus: ${task.status}\nComplexity: ${task.complexity}`,
+            ];
+            if (statusLabel) {
+                editArgs.push('--add-label', statusLabel);
+            }
+            await execFileAsync('gh', editArgs);
+            return task.github_issue_number;
+        }
+    }
+    async closeTask(issueNumber) {
+        await execFileAsync('gh', [
+            'issue',
+            'close',
+            String(issueNumber),
+            '--repo',
+            `${this.owner}/${this.repo}`,
+        ]);
+    }
+    // TODO v0.2: implement full Projects V2 field updates using item IDs + field IDs
+    // For MVP, label-based updates are used in pushTask instead.
+    async updateProjectField(_itemId, _fieldId, _value) {
+        // Placeholder — Projects V2 field updates require resolving item node IDs
+        // and field node IDs via GraphQL, which is out of scope for MVP.
+        return;
+    }
+    async processSyncOutbox(store) {
+        const pending = store.query(`SELECT id, entity_type, entity_id, operation, payload
+       FROM sync_outbox
+       WHERE synced_at IS NULL
+       ORDER BY id ASC`);
+        let synced = 0;
+        for (const row of pending) {
+            try {
+                const payload = JSON.parse(row.payload);
+                if (row.entity_type === 'task') {
+                    if (row.operation === 'upsert') {
+                        await this.pushTask({
+                            id: row.entity_id,
+                            title: payload['title'] ?? row.entity_id,
+                            status: payload['status'] ?? 'backlog',
+                            complexity: payload['complexity'] ?? 1,
+                            github_issue_number: payload['github_issue_number'],
+                        });
+                    }
+                    else if (row.operation === 'close') {
+                        const issueNumber = payload['github_issue_number'];
+                        if (issueNumber) {
+                            await this.closeTask(issueNumber);
+                        }
+                    }
+                }
+                store.run(`UPDATE sync_outbox SET synced_at = datetime('now') WHERE id = ?`, [row.id]);
+                synced++;
+            }
+            catch (err) {
+                console.error(`[push] Failed to sync outbox item ${row.id}:`, err);
+            }
+        }
+        return synced;
+    }
+    statusToLabel(status) {
+        const map = {
+            in_progress: 'forge:tracked',
+            done: 'forge:tracked',
+            blocked: 'forge:breach',
+        };
+        return map[status] ?? null;
+    }
+}
+//# sourceMappingURL=push.js.map

package/dist/src/github/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/github/push.ts"],"names":[],"mappings":"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"}

package/dist/src/github/setup.d.ts

@@ -0,0 +1,10 @@
+export interface GitHubSetupResult {
+    projectNumber: number;
+    fieldsCreated: string[];
+    labelsCreated: string[];
+}
+export declare function setupGitHubProject(owner: string, repo: string): Promise<GitHubSetupResult>;
+export declare function detectGitHubRemote(): Promise<{
+    owner: string;
+    repo: string;
+} | null>;

package/dist/src/github/setup.js

@@ -0,0 +1,112 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+const CUSTOM_FIELDS = [
+    { name: 'Agent', type: 'SINGLE_SELECT', options: ['pm', 'dev-1', 'dev-2', 'qa'] },
+    { name: 'Complexity', type: 'NUMBER' },
+    { name: 'SPI', type: 'NUMBER' },
+    { name: 'CPI', type: 'NUMBER' },
+    { name: 'TokenBudget', type: 'NUMBER' },
+    { name: 'TokensSpent', type: 'NUMBER' },
+    {
+        name: 'PDCAPhase',
+        type: 'SINGLE_SELECT',
+        options: ['plan', 'do', 'check', 'act', 'done'],
+    },
+];
+const LABELS = [
+    { name: 'agent:pm', color: '0075ca' },
+    { name: 'agent:dev-1', color: '00b4d8' },
+    { name: 'agent:dev-2', color: '48cae4' },
+    { name: 'agent:qa', color: '90e0ef' },
+    { name: 'forge:tracked', color: '2ea44f' },
+    { name: 'forge:breach', color: 'd93f0b' },
+    { name: 'forge:escalated', color: 'e4e669' },
+    { name: 'priority:high', color: 'b60205' },
+    { name: 'priority:medium', color: 'fbca04' },
+    { name: 'priority:low', color: '0e8a16' },
+];
+import { validateGitHubName } from '../utils/validation.js';
+export async function setupGitHubProject(owner, repo) {
+    validateGitHubName(owner, repo);
+    // 1. Create GitHub Project V2
+    const { stdout: createOut } = await execFileAsync('gh', [
+        'project',
+        'create',
+        '--owner',
+        owner,
+        '--title',
+        `ForgePM: ${repo}`,
+        '--format',
+        'json',
+    ]);
+    const projectData = JSON.parse(createOut);
+    const projectNumber = projectData.number;
+    // 2. Create custom fields
+    const fieldsCreated = [];
+    for (const field of CUSTOM_FIELDS) {
+        try {
+            const args = [
+                'project',
+                'field-create',
+                String(projectNumber),
+                '--owner',
+                owner,
+                '--name',
+                field.name,
+                '--data-type',
+                field.type,
+            ];
+            if (field.options && field.options.length > 0) {
+                args.push('--single-select-options', field.options.join(','));
+            }
+            await execFileAsync('gh', args);
+            fieldsCreated.push(field.name);
+        }
+        catch (err) {
+            console.error(`[setup] Failed to create field ${field.name}:`, err);
+        }
+    }
+    // 3. Create labels
+    const labelsCreated = [];
+    for (const label of LABELS) {
+        try {
+            await execFileAsync('gh', [
+                'label',
+                'create',
+                label.name,
+                '--repo',
+                `${owner}/${repo}`,
+                '--color',
+                label.color,
+                '--force',
+            ]);
+            labelsCreated.push(label.name);
+        }
+        catch (err) {
+            console.error(`[setup] Failed to create label ${label.name}:`, err);
+        }
+    }
+    return { projectNumber, fieldsCreated, labelsCreated };
+}
+export async function detectGitHubRemote() {
+    try {
+        const { stdout } = await execFileAsync('git', ['remote', 'get-url', 'origin']);
+        const url = stdout.trim();
+        // SSH: git@github.com:owner/repo.git
+        const sshMatch = url.match(/^git@github\.com:([^/]+)\/([^.]+?)(?:\.git)?$/);
+        if (sshMatch) {
+            return { owner: sshMatch[1], repo: sshMatch[2] };
+        }
+        // HTTPS: https://github.com/owner/repo.git
+        const httpsMatch = url.match(/^https:\/\/github\.com\/([^/]+)\/([^.]+?)(?:\.git)?$/);
+        if (httpsMatch) {
+            return { owner: httpsMatch[1], repo: httpsMatch[2] };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/src/github/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/github/setup.ts"],"names":[],"mappings":"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"}

package/dist/src/github/slack.d.ts

@@ -0,0 +1,12 @@
+export interface SlackMessage {
+    text: string;
+    blocks?: unknown[];
+}
+export declare function postToSlack(webhookUrl: string, message: SlackMessage): Promise<boolean>;
+export declare function formatBreachAlert(taskId: string, dimension: string, actual: number, limit: number): SlackMessage;
+export declare function formatSessionSummary(summary: {
+    goal: string;
+    tasksCompleted: number;
+    tokensSpent: number;
+    velocityPoints: number;
+}): SlackMessage;

package/dist/src/github/slack.js

@@ -0,0 +1,33 @@
+export async function postToSlack(webhookUrl, message) {
+    try {
+        const response = await fetch(webhookUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(message),
+        });
+        if (!response.ok) {
+            console.error(`[slack] POST failed: ${response.status} ${response.statusText}`);
+            return false;
+        }
+        return true;
+    }
+    catch (err) {
+        console.error('[slack] POST error:', err);
+        return false;
+    }
+}
+export function formatBreachAlert(taskId, dimension, actual, limit) {
+    const text = `🚨 *Tolerance Breach* — task \`${taskId}\`\n` +
+        `  Dimension: *${dimension}*\n` +
+        `  Actual: ${actual}  |  Limit: ${limit}`;
+    return { text };
+}
+export function formatSessionSummary(summary) {
+    const text = `✅ *Session Complete*\n` +
+        `  Goal: ${summary.goal}\n` +
+        `  Tasks completed: ${summary.tasksCompleted}\n` +
+        `  Tokens spent: ${summary.tokensSpent}\n` +
+        `  Velocity points: ${summary.velocityPoints}`;
+    return { text };
+}
+//# sourceMappingURL=slack.js.map

package/dist/src/github/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../src/github/slack.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB,EAAE,OAAqB;IACzE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAChF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,KAAa;IAEb,MAAM,IAAI,GACR,kCAAkC,MAAM,MAAM;QAC9C,iBAAiB,SAAS,KAAK;QAC/B,aAAa,MAAM,eAAe,KAAK,EAAE,CAAC;IAC5C,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAKpC;IACC,MAAM,IAAI,GACR,wBAAwB;QACxB,WAAW,OAAO,CAAC,IAAI,IAAI;QAC3B,sBAAsB,OAAO,CAAC,cAAc,IAAI;QAChD,mBAAmB,OAAO,CAAC,WAAW,IAAI;QAC1C,sBAAsB,OAAO,CAAC,cAAc,EAAE,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,14 @@
+export { createForge } from './core/forge.js';
+export type { ForgeInstance } from './core/forge.js';
+export { startMcpServer, createMcpServer } from './mcp/server.js';
+export type { ForgeConfig, DomainEvent, Result, ModelTier, TaskStatus, PdcaPhase, ToleranceStatus, EvmHealth, TolerancePreset, } from './core/types.js';
+export { DEFAULT_CONFIG, getModelTier } from './core/types.js';
+export type { CallSheet, InternalMetrics } from './pm/callsheet.js';
+export type { Session, SessionSummary } from './pm/sessions.js';
+export { RecallEngine } from './pm/recall.js';
+export type { RecallResult, RecallParams } from './pm/recall.js';
+export type { EventPlugin } from './core/event-plugins.js';
+export { fetchWithRetry, HttpError } from './backends/http-utils.js';
+export type { BackendAdapter, TaskData, ExternalUpdate } from './backends/base.js';
+export { LinearBackend } from './backends/linear.js';
+export { JiraBackend } from './backends/jira.js';

package/dist/src/index.js

@@ -0,0 +1,9 @@
+// Public API — re-exports for consumers of the forgepm package
+export { createForge } from './core/forge.js';
+export { startMcpServer, createMcpServer } from './mcp/server.js';
+export { DEFAULT_CONFIG, getModelTier } from './core/types.js';
+export { RecallEngine } from './pm/recall.js';
+export { fetchWithRetry, HttpError } from './backends/http-utils.js';
+export { LinearBackend } from './backends/linear.js';
+export { JiraBackend } from './backends/jira.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAclE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/mcp/server.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ForgeInstance } from '../core/forge.js';
+import type { ForgeConfig } from '../core/types.js';
+export declare function createMcpServer(forge: ForgeInstance): McpServer;
+export declare function startMcpServer(dbPath: string, config?: Partial<ForgeConfig>): Promise<McpServer>;

package/dist/src/mcp/server.js

@@ -0,0 +1,69 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { createForge } from '../core/forge.js';
+import { VERSION } from '../core/version.js';
+import { handleStatus, handleStart, handleDone, handleSession, handleEscalate, handleCreate, handleDecompose, handleRecall, handleRetro } from './tool-handlers.js';
+function registerTools(server, forge) {
+    server.tool('forge_status', 'Get project status, progress, and next recommended action', {
+        include_internal: z.boolean().optional().describe('Include SPI/CPI metrics for agent use'),
+    }, async ({ include_internal }) => handleStatus(forge, include_internal));
+    server.tool('forge_start', 'Start a PDCA cycle on a task, initialising EVM baseline and model-tier selection', {
+        task_id: z.string().describe('The task ID to start (e.g. TASK-001)'),
+        complexity: z.number().int().min(1).max(10).optional().describe('Override complexity score 1-10'),
+    }, async ({ task_id, complexity }) => handleStart(forge, task_id, complexity));
+    server.tool('forge_done', 'Mark a task complete, record actual tokens, update EVM metrics', {
+        task_id: z.string().describe('The task ID to complete'),
+        actual_tokens: z.number().int().positive().optional().describe('Total tokens used (legacy). Prefer input_tokens + output_tokens.'),
+        input_tokens: z.number().int().nonnegative().optional().describe('Input tokens from LLM response usage field'),
+        output_tokens: z.number().int().nonnegative().optional().describe('Output tokens from LLM response usage field'),
+        notes: z.string().optional().describe('Optional completion notes'),
+    }, async ({ task_id, actual_tokens, input_tokens, output_tokens, notes }) => handleDone(forge, task_id, actual_tokens, input_tokens, output_tokens, notes));
+    server.tool('forge_session', 'Manage work sessions: start, end, or get current status', {
+        action: z.enum(['start', 'end', 'status']).describe('"start" | "end" | "status"'),
+        goal: z.string().optional().describe('Session goal (required for action=start)'),
+        token_budget: z.number().int().positive().optional().describe('Token budget for this session'),
+    }, async ({ action, goal, token_budget }) => handleSession(forge, action, goal, token_budget));
+    server.tool('forge_escalate', 'Report a tolerance breach or blocking issue, get exception report with options', {
+        task_id: z.string().describe('The task ID that encountered the issue'),
+        reason: z.string().describe('Description of what went wrong'),
+        failure_type: z.enum(['reasoning', 'prompt', 'task_definition', 'unknown']).optional().describe('Type of failure for PDCA routing'),
+    }, async ({ task_id, reason, failure_type }) => handleEscalate(forge, task_id, reason, failure_type));
+    server.tool('forge_create', 'Create a task, story, or epic in the project backlog', {
+        type: z.enum(['task', 'story', 'epic']).describe('"task" | "story" | "epic"'),
+        title: z.string().describe('Title of the item'),
+        complexity: z.number().int().min(1).max(10).optional().describe('Complexity 1-10 (tasks only, default 3)'),
+        why: z.string().optional().describe('Rationale / user value'),
+        story_id: z.string().optional().describe('Parent story ID for tasks'),
+        depends_on: z.array(z.string()).optional().describe('List of dependency task IDs'),
+    }, async ({ type, title, complexity, why, story_id, depends_on }) => handleCreate(forge, type, title, complexity, why, story_id, depends_on));
+    server.tool('forge_recall', 'Search project knowledge: tasks, sessions, failure patterns, lessons learned', {
+        query: z.string().min(1).describe('Free-text search query'),
+        entity_types: z.array(z.enum(['task', 'story', 'epic', 'session', 'pdca', 'lesson'])).optional().describe('Filter by entity type. Default: all'),
+        status_filter: z.string().optional().describe('Filter by task status (e.g. "done", "blocked"). Applies to tasks only.'),
+        limit: z.number().int().min(1).max(50).optional().describe('Max results (default 10)'),
+        include_failures: z.boolean().optional().describe('Include PDCA failure patterns'),
+    }, async ({ query, entity_types, status_filter, limit, include_failures }) => handleRecall(forge, query, entity_types, status_filter, limit, include_failures));
+    server.tool('forge_retro', 'Generate a retrospective report for a session: progress, EVM, lessons, recommendations', {
+        session_id: z.string().optional().describe('Session ID. Omit for most recent session.'),
+        format: z.enum(['json', 'markdown']).optional().describe('Output format (default: json)'),
+    }, async ({ session_id, format }) => handleRetro(forge, session_id, format));
+    server.tool('forge_decompose', 'Decompose a feature description into tasks — returns hints for agent to create sub-tasks', {
+        description: z.string().describe('Feature or work item description'),
+        max_complexity: z.number().int().min(1).max(10).optional().describe('Max complexity per task (default 5)'),
+        max_tasks: z.number().int().positive().optional().describe('Maximum number of tasks to create (default 5)'),
+    }, async ({ description, max_complexity, max_tasks }) => handleDecompose(forge, description, max_complexity, max_tasks));
+}
+export function createMcpServer(forge) {
+    const server = new McpServer({ name: 'forgepm', version: VERSION });
+    registerTools(server, forge);
+    return server;
+}
+export async function startMcpServer(dbPath, config) {
+    const forge = await createForge(dbPath, config);
+    const server = createMcpServer(forge);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/src/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/tool-handlers.d.ts

@@ -0,0 +1,19 @@
+import type { ForgeInstance } from '../core/forge.js';
+import type { FailureType } from '../pm/pdca.js';
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function handleStatus(forge: ForgeInstance, includeInternal?: boolean): ToolResult;
+export declare function handleStart(forge: ForgeInstance, taskId: string, complexity?: number): ToolResult;
+export declare function handleDone(forge: ForgeInstance, taskId: string, actualTokens?: number, inputTokens?: number, outputTokens?: number, notes?: string): ToolResult;
+export declare function handleSession(forge: ForgeInstance, action: string, goal?: string, tokenBudget?: number): ToolResult;
+export declare function handleEscalate(forge: ForgeInstance, taskId: string, reason: string, failureType?: FailureType): ToolResult;
+export declare function handleCreate(forge: ForgeInstance, type: string, title: string, complexity?: number, why?: string, storyId?: string, dependsOn?: string[]): ToolResult;
+export declare function handleRecall(forge: ForgeInstance, query: string, entityTypes?: string[], statusFilter?: string, limit?: number, includeFailures?: boolean): ToolResult;
+export declare function handleRetro(forge: ForgeInstance, sessionId?: string, format?: string): ToolResult;
+export declare function handleDecompose(_forge: ForgeInstance, description: string, maxComplexity?: number, _maxTasks?: number): ToolResult;