sequant 1.1.2 → 1.1.3

package/dist/src/lib/workflow/types.d.ts

@@ -46,6 +46,8 @@ export interface PhaseResult {
     success: boolean;
     durationSeconds?: number;
     error?: string;
+    /** Captured output from the phase (used for parsing spec recommendations) */
+    output?: string;
 }
 /**
  * Result of executing all phases for an issue

package/dist/src/lib/workflow/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/workflow/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,EAA2B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,aAAa,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,eAW5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/workflow/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,EAA2B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,aAAa,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,eAW5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/package.json

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

package/templates/skills/solve/SKILL.md

@@ -58,7 +58,7 @@ Provide a clear, actionable response with:
 
 2. **Recommended Commands** in order
 
-3. **CLI Command** - ALWAYS include `sequant run <issue>` for terminal/CI usage
+3. **CLI Command** - ALWAYS include `npx sequant run <issue>` for terminal/CI usage
 
 4. **Explanation** of why this workflow was chosen
 
@@ -102,10 +102,12 @@ For comprehensive quality with automatic fix iterations:
 
 Run from terminal (useful for automation/CI):
 ```bash
-sequant run 152        # Single issue
-sequant run 152 153    # Multiple issues
+npx sequant run 152        # Single issue
+npx sequant run 152 153    # Multiple issues
 ```
 
+> **Tip:** For frequent use, install globally with `npm install -g sequant` to run `sequant` directly without `npx`.
+
 ### Notes
 - Issue #152 requires UI testing due to `ui` label
 - Issue #153 is a bug fix - simpler workflow recommended
@@ -114,6 +116,16 @@ sequant run 152 153    # Multiple issues
 
 ## Workflow Selection Logic
 
+**Note:** `npx sequant run` now uses **spec-driven phase detection**. It runs `/spec` first, which analyzes the issue and outputs a `## Recommended Workflow` section. The CLI then parses this to determine subsequent phases.
+
+### How It Works
+
+1. **Bug fixes** (labels: `bug`, `fix`) → Skip spec, run `exec → qa` directly
+2. **All other issues** → Run `/spec` first, which recommends phases based on:
+   - UI/frontend changes → Add `test` phase
+   - Complex refactors → Enable quality loop
+   - Security-sensitive → Add `security-review` phase
+
 ### Standard Workflow (Most Issues)
 ```
 /spec → /exec → /qa
@@ -148,25 +160,27 @@ Runs complete workflow with automatic fix iterations.
 
 ## CLI Alternative
 
-Use `sequant run` for batch execution from the command line:
+Use `npx sequant run` for batch execution from the command line:
 
 ```bash
 # Run workflow for single issue
-sequant run 152
+npx sequant run 152
 
 # Multiple issues in parallel
-sequant run 152 153 154
+npx sequant run 152 153 154
 
 # Sequential execution (respects dependencies)
-sequant run 152 153 --sequential
+npx sequant run 152 153 --sequential
 
 # Custom phases
-sequant run 152 --phases spec,exec,qa
+npx sequant run 152 --phases spec,exec,qa
 
 # Dry run (shows what would execute)
-sequant run 152 --dry-run
+npx sequant run 152 --dry-run
 ```
 
+> **Tip:** Install globally with `npm install -g sequant` to omit the `npx` prefix.
+
 ## Edge Cases
 
 ### Multiple Issues with Different Types
@@ -203,7 +217,7 @@ If issues depend on each other:
 
 - [ ] **Issue Summary Table** - Table with Issue, Title, Labels, Workflow columns
 - [ ] **Recommended Workflow** - Slash commands in order for each issue
-- [ ] **CLI Command** - `sequant run <issue-numbers>` command (REQUIRED)
+- [ ] **CLI Command** - `npx sequant run <issue-numbers>` command (REQUIRED)
 - [ ] **Explanation** - Brief notes explaining workflow choices
 
 **DO NOT respond until all items are verified.**
@@ -232,9 +246,11 @@ You MUST use this exact structure:
 
 Run from terminal (useful for automation/CI):
 \`\`\`bash
-sequant run <ISSUE_NUMBERS>
+npx sequant run <ISSUE_NUMBERS>
 \`\`\`
 
+> **Tip:** Install globally with `npm install -g sequant` to omit the `npx` prefix.
+
 ### Notes
 <!-- FILL: explanation of workflow choices -->
 ```

package/templates/skills/spec/SKILL.md

@@ -143,7 +143,26 @@ Ask the user to confirm or adjust:
 
 **Do NOT start implementation** - this is planning-only.
 
-### 4. Issue Comment Draft
+### 4. Recommended Workflow
+
+Analyze the issue and recommend the optimal workflow phases:
+
+```markdown
+## Recommended Workflow
+
+**Phases:** spec → exec → qa
+**Quality Loop:** disabled
+**Reasoning:** [Brief explanation of why these phases were chosen]
+```
+
+**Phase Selection Logic:**
+- **UI/Frontend changes** → Add `test` phase (browser testing)
+- **Bug fixes** → Skip `spec` if already well-defined
+- **Complex refactors** → Enable quality loop
+- **Security-sensitive** → Add `security-review` phase
+- **Documentation only** → Skip `spec`, just `exec → qa`
+
+### 5. Issue Comment Draft
 
 Generate a Markdown snippet with:
 - AC checklist with verification criteria
@@ -159,7 +178,7 @@ Label clearly as:
 --- DRAFT GITHUB ISSUE COMMENT (PLAN) ---
 ```
 
-### 5. Update GitHub Issue
+### 6. Update GitHub Issue
 
 Post the draft comment to GitHub:
 ```bash
@@ -176,6 +195,7 @@ gh issue edit <issue-number> --add-label "planned"
 - [ ] **AC Checklist** - Numbered AC items (AC-1, AC-2, etc.) with descriptions
 - [ ] **Verification Criteria** - Each AC has Verification Method and Test Scenario
 - [ ] **Implementation Plan** - 3-7 concrete steps with codebase references
+- [ ] **Recommended Workflow** - Phases, Quality Loop setting, and Reasoning
 - [ ] **Open Questions** - Any ambiguities with recommended defaults
 - [ ] **Issue Comment Draft** - Formatted for GitHub posting
 
@@ -221,6 +241,14 @@ You MUST include these sections in order:
 
 ---
 
+## Recommended Workflow
+
+**Phases:** exec → qa
+**Quality Loop:** disabled
+**Reasoning:** [Why these phases based on issue analysis]
+
+---
+
 --- DRAFT GITHUB ISSUE COMMENT (PLAN) ---
 
 [Complete formatted comment for GitHub]