sequant 1.14.1 → 1.15.0

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.14.1",
+  "version": "1.15.0",
   "author": {
     "name": "admarble",
     "email": "github@admarble.com"

package/README.md

@@ -223,6 +223,7 @@ See [Customization Guide](docs/guides/customization.md) for all options.
 - [Complete Workflow](docs/guides/workflow.md) — Full workflow including post-QA patterns
 - [Getting Started](docs/getting-started/installation.md)
 - [What We've Built](docs/internal/what-weve-built.md) — Comprehensive project overview
+- [What Is Sequant](docs/concepts/what-is-sequant.md) — Elevator pitch, pipeline diagram, architecture
 - [Workflow Concepts](docs/concepts/workflow-phases.md)
 - [Run Command](docs/reference/run-command.md)
 - [Git Workflows](docs/guides/git-workflows.md)

package/dist/bin/cli.js

@@ -43,7 +43,8 @@ import { logsCommand } from "../src/commands/logs.js";
 import { statsCommand } from "../src/commands/stats.js";
 import { dashboardCommand } from "../src/commands/dashboard.js";
 import { stateInitCommand, stateRebuildCommand, stateCleanCommand, } from "../src/commands/state.js";
-import { syncCommand } from "../src/commands/sync.js";
+import { syncCommand, areSkillsOutdated } from "../src/commands/sync.js";
+import { getManifest } from "../src/lib/manifest.js";
 const program = new Command();
 // Handle --no-color before parsing
 if (process.argv.includes("--no-color")) {
@@ -191,6 +192,21 @@ stateCmd
     .option("--max-age <days>", "Remove entries older than N days", parseInt)
     .option("--all", "Remove all orphaned entries (merged and abandoned)")
     .action(stateCleanCommand);
+// Auto-sync skills after npm upgrade (version mismatch detection)
+// Only triggers when skills were previously synced (has .sequant-version marker).
+// Projects that manage skills manually (no marker) are not affected.
+program.hook("preAction", async (thisCommand) => {
+    const cmd = thisCommand.name();
+    if (cmd === "init" || cmd === "sync")
+        return;
+    const manifest = await getManifest();
+    if (!manifest)
+        return;
+    const { outdated, currentVersion } = await areSkillsOutdated();
+    if (outdated && currentVersion !== null) {
+        await syncCommand({ quiet: true });
+    }
+});
 // Parse and execute
 program.parse();
 // Show help if no command provided

package/dist/src/commands/run.js

@@ -835,6 +835,37 @@ async function executePhase(issueNumber, phase, config, sessionId, worktreePath,
         };
     }
 }
+/**
+ * Cold-start retry threshold in seconds.
+ * Failures under this duration are likely Claude Code subprocess initialization
+ * issues rather than genuine phase failures (based on empirical data: cold-start
+ * failures consistently complete in 15-39s vs 150-310s for real work).
+ */
+const COLD_START_THRESHOLD_SECONDS = 60;
+const COLD_START_MAX_RETRIES = 2;
+/**
+ * Execute a phase with automatic retry for cold-start failures.
+ * If a phase fails within COLD_START_THRESHOLD_SECONDS, it's likely a subprocess
+ * initialization issue — retry up to COLD_START_MAX_RETRIES times before giving up.
+ */
+async function executePhaseWithRetry(issueNumber, phase, config, sessionId, worktreePath, shutdownManager, spinner) {
+    let lastResult;
+    for (let attempt = 0; attempt <= COLD_START_MAX_RETRIES; attempt++) {
+        lastResult = await executePhase(issueNumber, phase, config, sessionId, worktreePath, shutdownManager, spinner);
+        const duration = lastResult.durationSeconds ?? 0;
+        // Success or genuine failure (took long enough to be real work)
+        if (lastResult.success || duration >= COLD_START_THRESHOLD_SECONDS) {
+            return lastResult;
+        }
+        // Cold-start failure detected — retry
+        if (attempt < COLD_START_MAX_RETRIES) {
+            if (config.verbose) {
+                console.log(chalk.yellow(`\n    ⟳ Cold-start failure detected (${duration.toFixed(1)}s), retrying... (attempt ${attempt + 2}/${COLD_START_MAX_RETRIES + 1})`));
+            }
+        }
+    }
+    return lastResult;
+}
 /**
  * Fetch issue info from GitHub
  */
@@ -1575,7 +1606,7 @@ async function runIssueWithLogging(issueNumber, config, logWriter, stateManager,
             }
             const specStartTime = new Date();
             // Note: spec runs in main repo (not worktree) for planning
-            const specResult = await executePhase(issueNumber, "spec", config, sessionId, worktreePath, // Will be ignored for spec (non-isolated phase)
+            const specResult = await executePhaseWithRetry(issueNumber, "spec", config, sessionId, worktreePath, // Will be ignored for spec (non-isolated phase)
             shutdownManager, specSpinner);
             const specEndTime = new Date();
             if (specResult.sessionId) {
@@ -1718,7 +1749,7 @@ async function runIssueWithLogging(issueNumber, config, logWriter, stateManager,
                 }
             }
             const phaseStartTime = new Date();
-            const result = await executePhase(issueNumber, phase, config, sessionId, worktreePath, shutdownManager, phaseSpinner);
+            const result = await executePhaseWithRetry(issueNumber, phase, config, sessionId, worktreePath, shutdownManager, phaseSpinner);
             const phaseEndTime = new Date();
             // Capture session ID for subsequent phases
             if (result.sessionId) {
@@ -1778,7 +1809,7 @@ async function runIssueWithLogging(issueNumber, config, logWriter, stateManager,
                         iteration,
                     });
                     loopSpinner.start();
-                    const loopResult = await executePhase(issueNumber, "loop", config, sessionId, worktreePath, shutdownManager, loopSpinner);
+                    const loopResult = await executePhaseWithRetry(issueNumber, "loop", config, sessionId, worktreePath, shutdownManager, loopSpinner);
                     phaseResults.push(loopResult);
                     if (loopResult.sessionId) {
                         sessionId = loopResult.sessionId;

package/dist/src/commands/status.js

@@ -7,7 +7,23 @@ import { getManifest, getPackageVersion } from "../lib/manifest.js";
 import { fileExists } from "../lib/fs.js";
 import { readdir } from "fs/promises";
 import { StateManager } from "../lib/workflow/state-manager.js";
-import { rebuildStateFromLogs, cleanupStaleEntries, } from "../lib/workflow/state-utils.js";
+import { rebuildStateFromLogs, cleanupStaleEntries, checkPRMergeStatus, } from "../lib/workflow/state-utils.js";
+/**
+ * Auto-detect merged PRs and update state for issues stuck at ready_for_merge.
+ * Queries GitHub for each ready_for_merge issue that has a PR number.
+ */
+async function refreshMergedStatuses(stateManager, issues) {
+    const readyIssues = issues.filter((i) => i.status === "ready_for_merge" && i.pr?.number);
+    if (readyIssues.length === 0)
+        return;
+    for (const issue of readyIssues) {
+        const prStatus = checkPRMergeStatus(issue.pr.number);
+        if (prStatus === "MERGED") {
+            issue.status = "merged";
+            await stateManager.updateIssueStatus(issue.number, "merged");
+        }
+    }
+}
 /**
  * Color-code issue status
  */
@@ -220,7 +236,7 @@ export async function statusCommand(options = {}) {
         return;
     }
     console.log(chalk.green("Status: Initialized"));
-    console.log(chalk.gray(`Installed version: ${manifest.version}`));
+    console.log(chalk.gray(`Skills version: ${manifest.version}`));
     console.log(chalk.gray(`Stack: ${manifest.stack}`));
     console.log(chalk.gray(`Installed: ${manifest.installedAt}`));
     if (manifest.updatedAt) {
@@ -250,6 +266,7 @@ export async function statusCommand(options = {}) {
             const allIssues = await stateManager.getAllIssueStates();
             const issues = Object.values(allIssues);
             if (issues.length > 0) {
+                await refreshMergedStatuses(stateManager, issues);
                 displayIssueSummary(issues);
             }
         }
@@ -279,6 +296,9 @@ async function displayIssueState(options) {
         if (options.issue !== undefined) {
             // Show single issue details
             const issueState = await stateManager.getIssueState(options.issue);
+            if (issueState) {
+                await refreshMergedStatuses(stateManager, [issueState]);
+            }
             if (options.json) {
                 console.log(JSON.stringify(issueState, null, 2));
             }
@@ -294,6 +314,7 @@ async function displayIssueState(options) {
             // Show all issues
             const allIssues = await stateManager.getAllIssueStates();
             const issues = Object.values(allIssues);
+            await refreshMergedStatuses(stateManager, issues);
             if (options.json) {
                 console.log(JSON.stringify({ issues: allIssues }, null, 2));
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sequant",
-  "version": "1.14.1",
+  "version": "1.15.0",
   "description": "Quantize your development workflow - Sequential AI phases with quality gates",
   "type": "module",
   "bin": {