sequant 1.20.2 → 2.0.0

package/.claude-plugin/marketplace.json

@@ -1,7 +1,5 @@
 {
-  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "sequant",
-  "description": "Sequant plugin marketplace - structured workflow system for Claude Code",
   "owner": {
     "name": "sequant-io",
     "email": "hello@sequant.io"
@@ -9,8 +7,8 @@
   "plugins": [
     {
       "name": "sequant",
-      "description": "Structured workflow system for Claude Code - GitHub issue resolution with spec, exec, test, and QA phases. Includes 16 skills for planning, implementation, testing, code review, and quality assurance.",
-      "version": "1.17.0",
+      "description": "Structured workflow system for Claude Code - GitHub issue resolution with spec, exec, test, and QA phases. Includes 17 skills, MCP server with workflow tools, and pre/post-tool hooks.",
+      "version": "1.20.3",
       "author": {
         "name": "sequant-io",
         "email": "hello@sequant.io"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "sequant",
   "description": "Structured workflow system for Claude Code - GitHub issue resolution with spec, exec, test, and QA phases",
-  "version": "1.20.2",
+  "version": "2.0.0",
   "author": {
     "name": "sequant-io",
     "email": "hello@sequant.io"

package/README.md

@@ -9,20 +9,41 @@ Solve GitHub issues with structured phases and quality gates — from issue to m
 [![npm version](https://img.shields.io/npm/v/sequant.svg)](https://www.npmjs.com/package/sequant)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
+### What's new in 2.0
+
+- **MCP server** — `sequant serve` exposes workflow orchestration as MCP tools (`sequant_run`, `sequant_status`, `sequant_logs`). Any MCP client can drive Sequant headlessly.
+- **`/assess` unification** — `/solve` is merged into `/assess` with a 6-action vocabulary (PROCEED, CLOSE, MERGE, REWRITE, CLARIFY, PARK). `/solve` still works as an alias.
+- **Parallel execution** — multi-issue runs are concurrent by default with `--concurrency`.
+- **Multi-agent** — `--agent aider` as an alternative backend, with a driver interface for future agents.
+- **GitHub Actions** — label-triggered and comment-triggered CI workflows out of the box.
+
+Upgrading from v1.x? See the [migration guide](CHANGELOG.md#migration-from-v1x).
+
 ## Quick Start
 
-### Install
+### Option A: Plugin (interactive users)
+
+In Claude Code:
+```
+/plugin install sequant@sequant-io/sequant
+/sequant:setup
+```
+
+You get skills, hooks, and MCP tools — no npm required.
+
+### Option B: Package install (power users / CI)
 
 ```bash
-# In your project directory
-npm install sequant
-npx sequant init     # Install skills to your project
-npx sequant doctor   # Verify setup
+npm install sequant          # npm
+pnpm add sequant             # pnpm
+yarn add sequant             # yarn
+bun add sequant              # bun
 ```
 
-To update:
+Then initialize:
 ```bash
-npm update sequant
+npx sequant init     # Install skills to your project
+npx sequant doctor   # Verify setup
 ```
 
 ### Start Using
@@ -151,7 +172,7 @@ npx sequant merge --check        # Verify batch before merging
 | Command | Purpose |
 |---------|---------|
 | `/fullsolve` | Complete pipeline in one command |
-| `/solve` | Recommend optimal workflow for issue |
+| `/assess` | Triage issue, recommend workflow (6-action vocabulary) |
 | `/loop` | Fix iteration when checks fail |
 
 ### Integration
@@ -167,7 +188,6 @@ npx sequant merge --check        # Verify batch before merging
 
 | Command | Purpose |
 |---------|---------|
-| `/assess` | Issue triage and status assessment |
 | `/docs` | Generate feature documentation |
 | `/clean` | Repository cleanup |
 | `/improve` | Codebase analysis and improvement discovery |

package/dist/bin/cli.js

@@ -13,6 +13,7 @@ import { initCommand } from "../src/commands/init.js";
 import { isLocalNodeModulesInstall } from "../src/lib/version-check.js";
 import { configureUI, banner } from "../src/lib/cli-ui.js";
 import { isCI, isStdoutTTY } from "../src/lib/tty.js";
+import { detectPackageManagerSync, getPackageManagerCommands, } from "../src/lib/stacks.js";
 // Read version from package.json dynamically
 // Works from both source (bin/) and compiled (dist/bin/) locations
 function getVersion() {
@@ -64,9 +65,10 @@ configureUI({
 // Warn if running from local node_modules (not npx cache or global)
 // This helps users who accidentally have a stale local install
 if (!process.argv.includes("--quiet") && isLocalNodeModulesInstall()) {
+    const pmCommands = getPackageManagerCommands(detectPackageManagerSync());
     console.warn(chalk.yellow("⚠️  Running sequant from local node_modules\n" +
         "   For latest version: npx sequant@latest\n" +
-        "   To remove local: npm uninstall sequant\n"));
+        `   To remove local: ${pmCommands.removePkg} sequant\n`));
 }
 program
     .name("sequant")
@@ -83,6 +85,7 @@ program
     .option("--skip-setup", "Skip the dependency setup wizard")
     .option("--no-symlinks", "Use copies instead of symlinks for scripts/dev/ files")
     .option("--no-agents-md", "Skip AGENTS.md generation")
+    .option("--mcp", "Add Sequant MCP server to detected clients (use with --yes)")
     .action(initCommand);
 program
     .command("update")
@@ -111,7 +114,8 @@ program
     .option("--cleanup", "Clean up stale/orphaned entries")
     .option("--dry-run", "Preview cleanup without changes")
     .option("--max-age <days>", "Remove entries older than N days", parseInt)
-    .option("--all", "Remove all orphaned entries (merged and abandoned)")
+    .option("--all", "Show all entries including expired; with --cleanup removes all orphaned")
+    .option("--offline", "Skip GitHub queries (pure local state)")
     .action((issue, options) => {
     // Support positional arg: `sequant status 42` → --issue 42
     if (issue) {
@@ -147,7 +151,9 @@ program
     .option("--no-rebase", "Skip pre-PR rebase onto origin/main (use when you want to handle rebasing manually)")
     .option("--no-pr", "Skip PR creation after successful QA (manual PR workflow)")
     .option("-f, --force", "Force re-execution of completed issues (bypass pre-flight state guard)")
+    .option("--concurrency <n>", "Max concurrent issues in parallel mode (default: 3)", parseInt)
     .option("--reflect", "Analyze run results and suggest improvements")
+    .option("--agent <name>", 'Agent driver for phase execution (default: "claude-code")')
     .action(runCommand);
 program
     .command("merge")
@@ -178,6 +184,7 @@ program
     .option("--failed", "Show only failed runs")
     .option("--rotate", "Rotate logs (delete oldest to meet thresholds)")
     .option("-d, --dry-run", "Show what would be rotated without deleting")
+    .option("-v, --verbose", "Show full error context (all stderr lines)")
     .action(logsCommand);
 program
     .command("stats")
@@ -185,6 +192,7 @@ program
     .option("-p, --path <path>", "Custom log directory path")
     .option("--csv", "Output as CSV")
     .option("--json", "Output as JSON")
+    .option("--detailed", "Show detailed analytics (QA verdicts, trends, label segmentation)")
     .action(statsCommand);
 program
     .command("dashboard")
@@ -193,6 +201,21 @@ program
     .option("--no-open", "Don't automatically open browser")
     .option("-v, --verbose", "Enable verbose logging")
     .action(dashboardCommand);
+program
+    .command("serve")
+    .description("Start MCP server for workflow orchestration")
+    .option("--transport <type>", "Transport type: stdio (default) or sse", "stdio")
+    .option("--port <port>", "Port for SSE transport (default: 3100)", parseInt)
+    .action(async (options) => {
+    const mod = await import("../src/commands/serve.js").catch(() => null);
+    if (!mod) {
+        const pmCmds = getPackageManagerCommands(detectPackageManagerSync());
+        console.error(chalk.red("Error: MCP server requires @modelcontextprotocol/sdk\n" +
+            `Install it with: ${pmCmds.addPkg} @modelcontextprotocol/sdk`));
+        process.exit(1);
+    }
+    return mod.serveCommand(options);
+});
 // State management command with subcommands
 const stateCmd = program
     .command("state")

package/dist/src/commands/doctor.js

@@ -4,9 +4,11 @@
 import chalk from "chalk";
 import { execSync } from "child_process";
 import { ui, colors } from "../lib/cli-ui.js";
+import { GitHubProvider } from "../lib/workflow/platforms/github.js";
 import { fileExists, isExecutable } from "../lib/fs.js";
 import { getManifest } from "../lib/manifest.js";
 import { commandExists, isGhAuthenticated, isNativeWindows, isWSL, checkOptionalMcpServers, getMcpServersConfig, OPTIONAL_MCP_SERVERS, } from "../lib/system.js";
+import { getSettings } from "../lib/settings.js";
 import { checkVersionThorough, getVersionWarning, } from "../lib/version-check.js";
 import { areSkillsOutdated } from "./sync.js";
 import { readAgentsMd, checkAgentsMdConsistency, AGENTS_MD_PATH, } from "../lib/agents-md.js";
@@ -33,15 +35,8 @@ export function checkClosedIssues() {
     sevenDaysAgo.setDate(sevenDaysAgo.getDate() - 7);
     const sevenDaysAgoISO = sevenDaysAgo.toISOString();
     // Fetch closed issues from last 7 days
-    let closedIssues;
-    try {
-        const output = execSync(`gh issue list --state closed --json number,title,closedAt,labels --limit 100`, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
-        closedIssues = JSON.parse(output);
-    }
-    catch {
-        // gh command failed - return empty (graceful degradation)
-        return [];
-    }
+    const github = new GitHubProvider();
+    const closedIssues = github.listClosedIssuesSync(100);
     // Filter to last 7 days
     const recentIssues = closedIssues.filter((issue) => issue.closedAt >= sevenDaysAgoISO);
     // Filter out issues with skip labels
@@ -335,6 +330,24 @@ export async function doctorCommand(options = {}) {
             message: "claude CLI not installed - see: https://docs.anthropic.com/en/docs/claude-code",
         });
     }
+    // Check: Aider CLI (when configured as agent)
+    const settings = await getSettings();
+    if (settings.run.agent === "aider") {
+        if (commandExists("aider")) {
+            checks.push({
+                name: "Aider CLI",
+                status: "pass",
+                message: "aider CLI is installed (configured as default agent)",
+            });
+        }
+        else {
+            checks.push({
+                name: "Aider CLI",
+                status: "fail",
+                message: "aider CLI not installed but configured as default agent - install: pip install aider-chat",
+            });
+        }
+    }
     // Check 12: jq installed (optional but recommended)
     if (commandExists("jq")) {
         checks.push({
@@ -415,6 +428,26 @@ export async function doctorCommand(options = {}) {
             message: "Not available for sequant run (no Claude Desktop config found or empty mcpServers)",
         });
     }
+    // Check: Sequant MCP server health
+    try {
+        // Verify MCP server can be created (validates SDK availability)
+        const { createServer } = await import("../mcp/server.js");
+        const { getVersion } = await import("../lib/version.js");
+        const mcpServerInstance = createServer(getVersion());
+        await mcpServerInstance.close();
+        checks.push({
+            name: "MCP Server",
+            status: "pass",
+            message: "Sequant MCP server can be started (sequant serve)",
+        });
+    }
+    catch (error) {
+        checks.push({
+            name: "MCP Server",
+            status: "warn",
+            message: `Sequant MCP server unavailable: ${error instanceof Error ? error.message : String(error)}`,
+        });
+    }
     // Check: Closed issue verification (only if gh available, authenticated, and not skipped)
     if (!options.skipIssueCheck && ghAvailable && ghAuthenticated && gitExists) {
         const missingCommitIssues = checkClosedIssues();

package/dist/src/commands/init.d.ts

@@ -9,6 +9,7 @@ interface InitOptions {
     skipSetup?: boolean;
     noSymlinks?: boolean;
     agentsMd?: boolean;
+    mcp?: boolean;
 }
 export declare function initCommand(options: InitOptions): Promise<void>;
 export {};

package/dist/src/commands/init.js

@@ -293,6 +293,7 @@ export async function initCommand(options) {
     if (options.agentsMd !== false) {
         console.log(chalk.gray("  AGENTS.md           (universal agent instructions)"));
     }
+    console.log(chalk.gray("  .mcp.json           (Claude Code MCP server config)"));
     if (!skipPrompts) {
         const { confirm } = await inquirer.prompt([
             {
@@ -423,6 +424,57 @@ export async function initCommand(options) {
     else {
         console.log(chalk.gray("Skipping AGENTS.md generation (--no-agents-md)"));
     }
+    // Create .mcp.json for Claude Code (always, regardless of --mcp flag)
+    const { createProjectMcpJson, detectMcpClients, addSequantToMcpConfig } = await import("../lib/mcp-config.js");
+    const mcpJsonResult = createProjectMcpJson();
+    if (mcpJsonResult.created) {
+        ui.printStatus("success", "Created .mcp.json (Claude Code MCP config)");
+    }
+    else if (mcpJsonResult.merged) {
+        ui.printStatus("success", "Added Sequant to existing .mcp.json");
+    }
+    else {
+        console.log(chalk.gray("   .mcp.json: sequant already configured (skipped)"));
+    }
+    // Offer MCP server configuration for detected clients (global configs)
+    const mcpClients = detectMcpClients();
+    const detectedClients = mcpClients.filter((c) => c.exists);
+    if (detectedClients.length > 0) {
+        console.log(chalk.blue(`\nDetected ${detectedClients.length} MCP-compatible client(s):`));
+        for (const client of detectedClients) {
+            console.log(chalk.gray(`   • ${client.name}`));
+        }
+        let addMcp = false;
+        if (skipPrompts) {
+            // --yes alone skips MCP config; --yes --mcp explicitly opts in
+            addMcp = !!options.mcp;
+            if (!addMcp) {
+                console.log(chalk.gray("   Skipping MCP config (use --mcp to auto-add in non-interactive mode)"));
+            }
+        }
+        else {
+            const { confirm } = await inquirer.prompt([
+                {
+                    type: "confirm",
+                    name: "confirm",
+                    message: "Add Sequant MCP server to detected clients? (enables AI tools to use Sequant)",
+                    default: true,
+                },
+            ]);
+            addMcp = confirm;
+        }
+        if (addMcp) {
+            for (const client of detectedClients) {
+                const added = addSequantToMcpConfig(client.configPath, client.clientType);
+                if (added) {
+                    ui.printStatus("success", `Added Sequant MCP to ${client.name}`);
+                }
+                else {
+                    console.log(chalk.gray(`   ${client.name}: already configured (skipped)`));
+                }
+            }
+        }
+    }
     // Build optional suggestions section
     const optionalSuggestions = suggestions.filter((s) => s.startsWith("Optional"));
     const optionalSection = optionalSuggestions.length > 0

package/dist/src/commands/logs.d.ts

@@ -11,6 +11,7 @@ interface LogsOptions {
     failed?: boolean;
     rotate?: boolean;
     dryRun?: boolean;
+    verbose?: boolean;
 }
 /**
  * Main logs command

package/dist/src/commands/logs.js

@@ -78,7 +78,7 @@ function formatTime(isoString) {
 /**
  * Display a single log summary
  */
-function displayLogSummary(log, filename) {
+function displayLogSummary(log, filename, options) {
     const passed = log.summary.passed;
     const failed = log.summary.failed;
     const total = log.summary.totalIssues;
@@ -112,6 +112,22 @@ function displayLogSummary(log, filename) {
             const phaseDuration = chalk.gray(`(${formatDuration(phase.durationSeconds)})`);
             const error = phase.error ? chalk.red(` - ${phase.error}`) : "";
             console.log(`      ${phaseStatus} ${phase.phase} ${phaseDuration}${error}`);
+            // Show error context when available (#447 AC-3)
+            if (phase.errorContext) {
+                const ctx = phase.errorContext;
+                console.log(chalk.gray(`        category: ${chalk.yellow(ctx.category)}`));
+                if (ctx.stderrTail && ctx.stderrTail.length > 0) {
+                    const maxLines = options?.verbose ? ctx.stderrTail.length : 5;
+                    const lines = ctx.stderrTail.slice(-maxLines);
+                    console.log(chalk.gray("        stderr tail:"));
+                    for (const line of lines) {
+                        console.log(chalk.gray(`          ${line}`));
+                    }
+                    if (!options?.verbose && ctx.stderrTail.length > 5) {
+                        console.log(chalk.gray(`          ... ${ctx.stderrTail.length - 5} more lines (use --verbose to see all)`));
+                    }
+                }
+            }
             // Show observability data (AC-9)
             if (phase.commitHash) {
                 console.log(chalk.gray(`        commit: ${phase.commitHash.slice(0, 8)}`));
@@ -228,7 +244,7 @@ export async function logsCommand(options) {
     else {
         // Human-readable output
         for (const { log, filename } of filteredLogs) {
-            displayLogSummary(log, filename);
+            displayLogSummary(log, filename, { verbose: options.verbose });
         }
         // Summary
         console.log("\n" + ui.divider());

package/dist/src/commands/run.d.ts

@@ -7,6 +7,8 @@
  * - phase-mapper: Label-to-phase detection and workflow parsing
  * - batch-executor: Batch execution, dependency sorting, issue logging
  */
+/** @internal Log a non-fatal warning: one-line summary always, detail in verbose. */
+export declare function logNonFatalWarning(message: string, error: unknown, verbose: boolean): void;
 import type { RunOptions } from "../lib/workflow/batch-executor.js";
 export { parseQaVerdict, formatDuration, executePhaseWithRetry, } from "../lib/workflow/phase-executor.js";
 export { detectDefaultBranch, checkWorktreeFreshness, removeStaleWorktree, listWorktrees, getWorktreeChangedFiles, getWorktreeDiffStats, readCacheMetrics, filterResumedPhases, ensureWorktree, createCheckpointCommit, reinstallIfLockfileChanged, rebaseBeforePR, createPR, } from "../lib/workflow/worktree-manager.js";
@@ -14,6 +16,11 @@ export type { WorktreeInfo, RebaseResult, PRCreationResult, } from "../lib/workf
 export { detectPhasesFromLabels, parseRecommendedWorkflow, determinePhasesForIssue, } from "../lib/workflow/phase-mapper.js";
 export { getIssueInfo, sortByDependencies, parseBatches, getEnvConfig, executeBatch, runIssueWithLogging, } from "../lib/workflow/batch-executor.js";
 export type { RunOptions } from "../lib/workflow/batch-executor.js";
+/**
+ * Normalize Commander.js --no-X flags into typed RunOptions fields.
+ * Replaces the `as any` cast (#402 AC-4).
+ */
+export declare function normalizeCommanderOptions(options: RunOptions): RunOptions;
 /**
  * Main run command
  */