@ai-coders/context 0.6.1 → 0.7.0

package/dist/services/mcp/gateway/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Gateway Tool Types
+ *
+ * Type definitions for MCP gateway tool parameters and responses.
+ *
+ * Note: Some gateways use dedicated tools instead of action-based routing:
+ * - Workflow: Split into workflow-init, workflow-status, workflow-advance, workflow-manage
+ * - Project: Removed - use context init + workflow-init instead
+ */
+import type { PrevcPhase, PrevcRole, AgentType } from '../../../workflow';
+export type ExploreAction = 'read' | 'list' | 'analyze' | 'search' | 'getStructure';
+export type ContextAction = 'check' | 'init' | 'fill' | 'fillSingle' | 'listToFill' | 'getMap' | 'buildSemantic' | 'scaffoldPlan' | 'searchQA' | 'generateQA' | 'getFlow' | 'detectPatterns';
+export type SyncAction = 'exportRules' | 'exportDocs' | 'exportAgents' | 'exportContext' | 'exportSkills' | 'reverseSync' | 'importDocs' | 'importAgents' | 'importSkills';
+export type PlanAction = 'link' | 'getLinked' | 'getDetails' | 'getForPhase' | 'updatePhase' | 'recordDecision' | 'updateStep' | 'getStatus' | 'syncMarkdown' | 'commitPhase';
+export type AgentAction = 'discover' | 'getInfo' | 'orchestrate' | 'getSequence' | 'getDocs' | 'getPhaseDocs' | 'listTypes';
+export type SkillAction = 'list' | 'getContent' | 'getForPhase' | 'scaffold' | 'export' | 'fill';
+export interface ExploreParams {
+    action: ExploreAction;
+    filePath?: string;
+    pattern?: string;
+    cwd?: string;
+    encoding?: 'utf-8' | 'ascii' | 'binary';
+    ignore?: string[];
+    symbolTypes?: Array<'class' | 'interface' | 'function' | 'type' | 'enum'>;
+    fileGlob?: string;
+    maxResults?: number;
+    rootPath?: string;
+    maxDepth?: number;
+    includePatterns?: string[];
+}
+export interface ContextParams {
+    action: ContextAction;
+    repoPath?: string;
+    outputDir?: string;
+    type?: 'docs' | 'agents' | 'both';
+    semantic?: boolean;
+    include?: string[];
+    exclude?: string[];
+    autoFill?: boolean;
+    skipContentGeneration?: boolean;
+    target?: 'docs' | 'agents' | 'plans' | 'all';
+    offset?: number;
+    limit?: number;
+    filePath?: string;
+    section?: string;
+    contextType?: 'documentation' | 'playbook' | 'plan' | 'compact';
+    targetFile?: string;
+    options?: {
+        useLSP?: boolean;
+        maxContextLength?: number;
+        includeDocumentation?: boolean;
+        includeSignatures?: boolean;
+    };
+    planName?: string;
+    title?: string;
+    summary?: string;
+    query?: string;
+    entryFile?: string;
+    entryFunction?: string;
+}
+export interface SyncParams {
+    action: SyncAction;
+    preset?: string;
+    force?: boolean;
+    dryRun?: boolean;
+    indexMode?: 'readme' | 'all';
+    mode?: 'symlink' | 'markdown';
+    skipDocs?: boolean;
+    skipAgents?: boolean;
+    skipSkills?: boolean;
+    skipRules?: boolean;
+    docsIndexMode?: 'readme' | 'all';
+    agentMode?: 'symlink' | 'markdown';
+    includeBuiltInSkills?: boolean;
+    mergeStrategy?: 'skip' | 'overwrite' | 'merge' | 'rename';
+    autoDetect?: boolean;
+    addMetadata?: boolean;
+    repoPath?: string;
+    includeBuiltIn?: boolean;
+}
+export interface PlanParams {
+    action: PlanAction;
+    planSlug?: string;
+    phaseId?: string;
+    status?: 'pending' | 'in_progress' | 'completed' | 'skipped';
+    phase?: PrevcPhase;
+    title?: string;
+    description?: string;
+    alternatives?: string[];
+    stepIndex?: number;
+    output?: string;
+    notes?: string;
+    coAuthor?: string;
+    stagePatterns?: string[];
+    dryRun?: boolean;
+}
+export interface AgentParams {
+    action: AgentAction;
+    agentType?: string;
+    task?: string;
+    phase?: PrevcPhase;
+    role?: PrevcRole;
+    includeReview?: boolean;
+    phases?: PrevcPhase[];
+    agent?: AgentType;
+}
+export interface SkillParams {
+    action: SkillAction;
+    skillSlug?: string;
+    phase?: PrevcPhase;
+    skills?: string[];
+    includeContent?: boolean;
+    includeBuiltIn?: boolean;
+    preset?: 'claude' | 'gemini' | 'codex' | 'antigravity' | 'all';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/mcp/gateway/types.d.ts.map

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

package/dist/services/mcp/gateway/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Gateway Tool Types
+ *
+ * Type definitions for MCP gateway tool parameters and responses.
+ *
+ * Note: Some gateways use dedicated tools instead of action-based routing:
+ * - Workflow: Split into workflow-init, workflow-status, workflow-advance, workflow-manage
+ * - Project: Removed - use context init + workflow-init instead
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/services/mcp/gateway/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/services/mcp/gateway/workflow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Workflow Gateway Handler
+ *
+ * Handles PREVC workflow management operations.
+ * Replaces: workflowInit, workflowStatus, workflowAdvance, workflowHandoff,
+ *           workflowCollaborate, workflowCreateDoc, workflowGetGates,
+ *           workflowApprovePlan, workflowSetAutonomous
+ */
+import type { WorkflowParams } from './types';
+import type { MCPToolResponse } from './response';
+export interface WorkflowOptions {
+    repoPath: string;
+}
+/**
+ * Handles workflow gateway actions for PREVC workflow management.
+ */
+export declare function handleWorkflow(params: WorkflowParams, options: WorkflowOptions): Promise<MCPToolResponse>;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/services/mcp/gateway/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC,CAgT1B"}

package/dist/services/mcp/gateway/workflow.js

@@ -0,0 +1,317 @@
+"use strict";
+/**
+ * Workflow Gateway Handler
+ *
+ * Handles PREVC workflow management operations.
+ * Replaces: workflowInit, workflowStatus, workflowAdvance, workflowHandoff,
+ *           workflowCollaborate, workflowCreateDoc, workflowGetGates,
+ *           workflowApprovePlan, workflowSetAutonomous
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleWorkflow = handleWorkflow;
+const path = __importStar(require("path"));
+const workflow_1 = require("../../workflow");
+const workflow_2 = require("../../../workflow");
+const response_1 = require("./response");
+/**
+ * Handles workflow gateway actions for PREVC workflow management.
+ */
+async function handleWorkflow(params, options) {
+    const repoPath = path.resolve(options.repoPath);
+    try {
+        const service = new workflow_1.WorkflowService(repoPath);
+        switch (params.action) {
+            case 'init': {
+                const status = await service.init({
+                    name: params.name,
+                    description: params.description,
+                    scale: params.scale,
+                    autonomous: params.autonomous,
+                    requirePlan: params.require_plan,
+                    requireApproval: params.require_approval,
+                    archivePrevious: params.archive_previous,
+                });
+                const contextPath = path.join(repoPath, '.context');
+                const statusFilePath = path.join(contextPath, 'workflow', 'status.yaml');
+                const settings = await service.getSettings();
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: `Workflow initialized: ${params.name}`,
+                    scale: (0, workflow_2.getScaleName)(status.project.scale),
+                    currentPhase: status.project.current_phase,
+                    phases: Object.keys(status.phases).filter((p) => status.phases[p].status !== 'skipped'),
+                    settings: {
+                        autonomous_mode: settings.autonomous_mode,
+                        require_plan: settings.require_plan,
+                        require_approval: settings.require_approval,
+                    },
+                    statusFilePath,
+                    contextPath,
+                });
+            }
+            case 'status': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Run workflow({ action: "init" }) first.',
+                        statusFilePath: path.join(repoPath, '.context', 'workflow', 'status.yaml')
+                    });
+                }
+                const summary = await service.getSummary();
+                const status = await service.getStatus();
+                const statusFilePath = path.join(repoPath, '.context', 'workflow', 'status.yaml');
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    name: summary.name,
+                    scale: (0, workflow_2.getScaleName)(summary.scale),
+                    currentPhase: {
+                        code: summary.currentPhase,
+                        name: workflow_2.PHASE_NAMES_EN[summary.currentPhase],
+                    },
+                    progress: summary.progress,
+                    isComplete: summary.isComplete,
+                    phases: status.phases,
+                    agents: status.agents,
+                    roles: status.roles,
+                    statusFilePath,
+                });
+            }
+            case 'advance': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Run workflow({ action: "init" }) first.'
+                    });
+                }
+                try {
+                    const nextPhase = await service.advance(params.outputs, { force: params.force });
+                    if (nextPhase) {
+                        const response = {
+                            success: true,
+                            message: `Advanced to ${workflow_2.PHASE_NAMES_EN[nextPhase]} phase`,
+                            nextPhase: {
+                                code: nextPhase,
+                                name: workflow_2.PHASE_NAMES_EN[nextPhase],
+                            }
+                        };
+                        // Add orchestration guidance when advancing to Execution phase
+                        if (nextPhase === 'E') {
+                            response.orchestration = service.getPhaseOrchestration(nextPhase);
+                        }
+                        return (0, response_1.createJsonResponse)(response);
+                    }
+                    else {
+                        return (0, response_1.createJsonResponse)({
+                            success: true,
+                            message: 'Workflow completed!',
+                            isComplete: true
+                        });
+                    }
+                }
+                catch (error) {
+                    if (error instanceof workflow_2.WorkflowGateError) {
+                        return (0, response_1.createJsonResponse)({
+                            success: false,
+                            error: error.message,
+                            gate: error.gate,
+                            transition: error.transition,
+                            hint: error.hint,
+                        });
+                    }
+                    throw error;
+                }
+            }
+            case 'handoff': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Run workflow({ action: "init" }) first.'
+                    });
+                }
+                // Validate required parameters for agent handoff
+                if (!params.from || !params.to) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'handoff requires from and to agent names',
+                    });
+                }
+                await service.handoff(params.from, params.to, params.artifacts || []);
+                // Get next agent suggestion
+                const nextSuggestion = service.getNextAgentSuggestion(params.to);
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: `Handoff complete: ${params.from} → ${params.to}`,
+                    handoff: {
+                        from: params.from,
+                        to: params.to,
+                        artifacts: params.artifacts || [],
+                    },
+                    nextSuggestion,
+                });
+            }
+            case 'collaborate': {
+                const session = await service.startCollaboration(params.topic, params.participants);
+                const sessionStatus = session.getStatus();
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: `Collaboration session started: ${params.topic}`,
+                    sessionId: sessionStatus.id,
+                    topic: sessionStatus.topic,
+                    participants: sessionStatus.participants.map((p) => ({
+                        role: p,
+                        displayName: workflow_2.ROLE_DISPLAY_NAMES[p],
+                    })),
+                });
+            }
+            case 'createDoc': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Run workflow({ action: "init" }) first.'
+                    });
+                }
+                const docPath = `.context/workflow/docs/${params.type}-${params.docName?.toLowerCase().replace(/\s+/g, '-')}.md`;
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: `Document template ready: ${params.type}`,
+                    documentType: params.type,
+                    suggestedPath: docPath,
+                    name: params.docName,
+                });
+            }
+            case 'getGates': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Run workflow({ action: "init" }) first.'
+                    });
+                }
+                const gateResult = await service.checkGates();
+                const settings = await service.getSettings();
+                const approval = await service.getApproval();
+                const summary = await service.getSummary();
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    currentPhase: {
+                        code: summary.currentPhase,
+                        name: workflow_2.PHASE_NAMES_EN[summary.currentPhase],
+                    },
+                    canAdvance: gateResult.canAdvance,
+                    gates: gateResult.gates,
+                    blockingReason: gateResult.blockingReason,
+                    hint: gateResult.hint,
+                    settings: {
+                        autonomous_mode: settings.autonomous_mode,
+                        require_plan: settings.require_plan,
+                        require_approval: settings.require_approval,
+                    },
+                    approval: approval ? {
+                        plan_created: approval.plan_created,
+                        plan_approved: approval.plan_approved,
+                        approved_by: approval.approved_by,
+                        approved_at: approval.approved_at,
+                    } : null,
+                });
+            }
+            case 'approvePlan': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Run workflow({ action: "init" }) first.'
+                    });
+                }
+                const currentApproval = await service.getApproval();
+                if (!currentApproval?.plan_created) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No plan is linked to approve. Link a plan first using plan({ action: "link" }).',
+                        hint: 'Use context({ action: "scaffoldPlan" }) to create a plan, then plan({ action: "link" }) to link it.'
+                    });
+                }
+                const approval = await service.approvePlan(params.approver || 'reviewer', params.notes);
+                if (params.planSlug) {
+                    const planLinker = (0, workflow_2.createPlanLinker)(repoPath);
+                    const plans = await planLinker.getLinkedPlans();
+                    const planRef = plans.active.find(p => p.slug === params.planSlug);
+                    if (planRef) {
+                        planRef.approval_status = 'approved';
+                        planRef.approved_at = approval.approved_at;
+                        planRef.approved_by = approval.approved_by;
+                    }
+                }
+                const gateResult = await service.checkGates();
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: 'Plan approved successfully',
+                    approval: {
+                        plan_approved: approval.plan_approved,
+                        approved_by: approval.approved_by,
+                        approved_at: approval.approved_at,
+                        approval_notes: approval.approval_notes,
+                    },
+                    canAdvanceToExecution: gateResult.gates.approval_required.passed,
+                });
+            }
+            case 'setAutonomous': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Run workflow({ action: "init" }) first.'
+                    });
+                }
+                const settings = await service.setAutonomousMode(params.enabled);
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: `Autonomous mode ${params.enabled ? 'enabled' : 'disabled'}${params.reason ? `: ${params.reason}` : ''}`,
+                    settings: {
+                        autonomous_mode: settings.autonomous_mode,
+                        require_plan: settings.require_plan,
+                        require_approval: settings.require_approval,
+                    },
+                    effect: params.enabled
+                        ? 'All workflow gates are now bypassed. Use workflow({ action: "advance" }) freely.'
+                        : 'Workflow gates are now enforced based on settings.',
+                });
+            }
+            default:
+                return (0, response_1.createErrorResponse)(`Unknown workflow action: ${params.action}`);
+        }
+    }
+    catch (error) {
+        return (0, response_1.createErrorResponse)(error);
+    }
+}
+//# sourceMappingURL=workflow.js.map

package/dist/services/mcp/gateway/workflow.js.map

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

package/dist/services/mcp/gateway/workflowAdvance.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Workflow Advance Handler
+ *
+ * Handles advancing PREVC workflow to the next phase.
+ */
+import type { MCPToolResponse } from './response';
+export interface WorkflowAdvanceParams {
+    outputs?: string[];
+    force?: boolean;
+    repoPath?: string;
+}
+export interface WorkflowAdvanceOptions {
+    repoPath: string;
+}
+/**
+ * Advance workflow to the next PREVC phase (P→R→E→V→C).
+ *
+ * Enforces gates:
+ * - P→R: Requires plan if require_plan=true
+ * - R→E: Requires approval if require_approval=true
+ *
+ * Use force=true to bypass gates, or use workflow-manage({ action: 'setAutonomous' }).
+ */
+export declare function handleWorkflowAdvance(params: WorkflowAdvanceParams, options: WorkflowAdvanceOptions): Promise<MCPToolResponse>;
+//# sourceMappingURL=workflowAdvance.d.ts.map

package/dist/services/mcp/gateway/workflowAdvance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowAdvance.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/workflowAdvance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAiF1B"}

package/dist/services/mcp/gateway/workflowAdvance.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Workflow Advance Handler
+ *
+ * Handles advancing PREVC workflow to the next phase.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleWorkflowAdvance = handleWorkflowAdvance;
+const path = __importStar(require("path"));
+const workflow_1 = require("../../workflow");
+const workflow_2 = require("../../../workflow");
+const response_1 = require("./response");
+/**
+ * Advance workflow to the next PREVC phase (P→R→E→V→C).
+ *
+ * Enforces gates:
+ * - P→R: Requires plan if require_plan=true
+ * - R→E: Requires approval if require_approval=true
+ *
+ * Use force=true to bypass gates, or use workflow-manage({ action: 'setAutonomous' }).
+ */
+async function handleWorkflowAdvance(params, options) {
+    try {
+        // Resolve repo path: use explicit param, then options
+        // options.repoPath is guaranteed to be valid by MCP server initialization
+        const repoPath = path.resolve(params.repoPath || options.repoPath);
+        const contextPath = path.join(repoPath, '.context');
+        // Create service
+        const service = await workflow_1.WorkflowService.create(repoPath);
+        if (!(await service.hasWorkflow())) {
+            return (0, response_1.createJsonResponse)({
+                success: false,
+                error: 'No workflow found. Initialize a workflow first.',
+                suggestion: 'Use workflow-init({ name: "feature-name" }) to start.',
+                statusFilePath: path.join(contextPath, 'workflow', 'status.yaml')
+            });
+        }
+        try {
+            const nextPhase = await service.advance(params.outputs, { force: params.force });
+            if (nextPhase) {
+                const orchestration = await service.getPhaseOrchestration(nextPhase);
+                const phaseName = workflow_2.PHASE_NAMES_EN[nextPhase];
+                const startAgent = orchestration.startWith;
+                const response = {
+                    success: true,
+                    message: `Advanced to ${phaseName} phase`,
+                    nextPhase: {
+                        code: nextPhase,
+                        name: phaseName,
+                    },
+                    orchestration,
+                    // NEW: Quick start guidance for immediate action
+                    quickStart: {
+                        message: `Ready to start ${phaseName} phase`,
+                        firstStep: `Call agent({ action: "orchestrate", phase: "${nextPhase}" }) to discover agents`,
+                        agentPlaybook: `.context/agents/${startAgent}.md`,
+                        nextActions: [
+                            `1. Discover agents: agent({ action: "orchestrate", phase: "${nextPhase}" })`,
+                            `2. Review sequence: agent({ action: "getSequence", phases: ["${nextPhase}"] })`,
+                            `3. Begin with ${startAgent} - follow playbook at .context/agents/${startAgent}.md`,
+                            `4. Use workflow-manage to execute handoffs between agents`,
+                            `5. Call workflow-advance when phase is complete`,
+                        ],
+                    },
+                };
+                return (0, response_1.createJsonResponse)(response);
+            }
+            else {
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: 'Workflow completed!',
+                    isComplete: true
+                });
+            }
+        }
+        catch (error) {
+            if (error instanceof workflow_2.WorkflowGateError) {
+                const blockedGate = error.message.includes('plan') ? 'plan_required' : 'approval_required';
+                return (0, response_1.createJsonResponse)({
+                    success: false,
+                    error: error.message,
+                    gate: error.gate,
+                    transition: error.transition,
+                    blockedGate,
+                    hint: error.hint,
+                    resolution: blockedGate === 'plan_required'
+                        ? 'Create and link a plan: plan({ action: "link", planSlug: "plan-name" })'
+                        : 'Approve plan: workflow-manage({ action: "approvePlan", planSlug: "plan-name" })',
+                    alternative: 'Use workflow-advance({ force: true }) to bypass gate',
+                    autonomousMode: 'Or use workflow-manage({ action: "setAutonomous", enabled: true })'
+                });
+            }
+            throw error;
+        }
+    }
+    catch (error) {
+        return (0, response_1.createErrorResponse)(error);
+    }
+}
+//# sourceMappingURL=workflowAdvance.js.map