@pixel613/spec 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pixel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+# @pixel613/spec (pxs)
+
+Spec-driven development CLI for Claude Code. Write a spec, refine a plan, implement task by task — all powered by AI.
+
+`@pixel613/spec` 是一套為 Claude Code 設計的規格驅動開發 CLI。撰寫規格、拆解計畫、逐步實作，全程 AI 驅動。
+
+> **Supported backend: Claude Code only**
+
+---
+
+## Installation / 安裝
+
+```bash
+npm install -g @pixel613/spec
+```
+
+## Quick Start / 快速開始
+
+```bash
+# 1. Initialize workflow in your project / 初始化工作流
+pxs init
+
+# 2. Create a spec / 建立規格
+pxs new login-feature --desc "Add JWT login endpoint"
+
+# 3. Refine spec into implementation plan / 拆解為實作計畫
+pxs refine login-feature
+
+# 4. Implement task by task / 逐步實作
+pxs implement login-feature
+
+# 5. Check status / 查看狀態
+pxs status login-feature
+```
+
+## Commands / 指令
+
+### `pxs init`
+
+Initialize `.workflow/` directory and Claude Code slash commands for your project.
+
+在專案中初始化 `.workflow/` 目錄與 Claude Code slash commands。
+
+| Option | Description |
+|--------|-------------|
+| `--force` | Overwrite existing `.workflow/` / 覆蓋現有目錄 |
+| `--arch <pattern>` | Architecture pattern: `clean` \| `hexagonal` \| `ddd` \| `layered` \| `modular` \| `custom` |
+| `--lang <lang>` | Language-framework override (e.g. `go`, `typescript`, `go-gin`) |
+
+### `pxs new <name>`
+
+Create a new spec file under `.workflow/specs/`.
+
+建立新的規格檔案。
+
+| Option | Description |
+|--------|-------------|
+| `--desc <text>` | Generate spec from text description / 從文字描述產生規格 |
+| `--jira <tickets...>` | Import from Jira tickets / 從 Jira ticket 匯入 |
+| `-i, --interactive` | Interactive Q&A mode / 互動問答模式 |
+
+### `pxs refine <name>`
+
+Refine spec and decompose into a step-by-step implementation plan.
+
+精煉規格並拆解為逐步實作計畫。
+
+| Option | Description |
+|--------|-------------|
+| `--skip-clarify` | Skip requirement clarification / 跳過需求釐清 |
+| `--clarify <n>` | Max clarification rounds / 最大釐清輪數 |
+| `@agent /skill` | Pass agents or skills to assist / 指定 agent 或 skill 協助 |
+
+### `pxs clarify <name>`
+
+Run requirement clarification on a spec independently.
+
+獨立執行需求釐清。
+
+### `pxs implement <name>`
+
+Implement code task by task with AI. Each task goes through: implement → commit → test (optional) → AI review → user approval.
+
+AI 逐步實作。每個 task 流程：實作 → commit → 測試（可選）→ AI review → 使用者審核。
+
+After all tasks complete, a **final branch code review** runs automatically against the full diff, spec, and plan.
+
+所有 task 完成後，自動執行**整個 branch 的完整 code review**。
+
+| Option | Description |
+|--------|-------------|
+| `--skip-review` | Skip final branch code review / 跳過最終 code review |
+| `@agent /skill` | Pass agents or skills to assist review / 指定 agent 或 skill 協助 review |
+
+**Test strategies / 測試策略:**
+
+| Flag | Behavior |
+|------|----------|
+| `--test tdd` | TDD: write failing tests → implement → pass → refactor |
+| `--test intg` | Post-hoc integration tests / 整合測試 |
+| `--test tdd intg` | TDD + integration tests |
+| `--test` | Post-hoc unit tests / 單元測試 |
+| *(none)* | No tests / 不產生測試 |
+
+### `pxs review <name>`
+
+View review records.
+
+查看 review 紀錄。
+
+| Option | Description |
+|--------|-------------|
+| `--step <n>` | View specific task review / 查看特定 task 的 review |
+| `--summary` | Summary overview of all tasks / 所有 task 的摘要 |
+| *(default)* | Shows final branch review if completed, otherwise latest task review / 預設顯示 final review 或最新的 task review |
+
+### `pxs status [name]`
+
+View workflow status. Without `<name>`, lists all features.
+
+查看工作流狀態。不帶 `<name>` 則列出所有 feature。
+
+## Workflow / 工作流程
+
+```
+pxs init → pxs new → pxs refine → pxs implement → merge
+                         │
+                     pxs clarify (optional)
+```
+
+```
+implement 流程：
+
+  Task 1 → commit → [test] → AI review → approve/skip
+  Task 2 → commit → [test] → AI review → approve/skip
+  ...
+  All tasks complete
+       ↓
+  Final Code Review (full branch diff vs spec + plan)
+       ↓
+  merge / squash-merge / keep-branch
+```
+
+## Claude Code Integration
+
+After `pxs init`, the following slash commands are available in Claude Code:
+
+執行 `pxs init` 後，可在 Claude Code 中使用以下 slash commands：
+
+| Slash Command | Description |
+|---------------|-------------|
+| `/pxs:new` | Create a new spec / 建立規格 |
+| `/pxs:refine` | Refine spec into plan / 拆解計畫 |
+| `/pxs:clarify` | Clarify requirements / 釐清需求 |
+| `/pxs:implement` | Implement task by task / 逐步實作 |
+| `/pxs:review` | View reviews / 查看 review |
+| `/pxs:status` | Check status / 查看狀態 |
+
+## Project Structure / 專案結構
+
+```
+.workflow/
+├── state.yaml          # Workflow state / 工作流狀態
+├── config.yaml         # Project config / 專案設定
+├── architecture.md     # Architecture constraints (if --arch) / 架構約束
+├── specs/              # Feature specs / 功能規格
+├── plans/              # Implementation plans / 實作計畫
+├── reviews/            # AI review records / AI review 紀錄
+└── prompts/            # Prompt templates / Prompt 模板
+```
+
+## License
+
+MIT

package/dist/bin/pxs.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/pxs.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { createProgram } from '../src/cli.js';
+const program = createProgram();
+program.parse(process.argv);
+//# sourceMappingURL=pxs.js.map

package/dist/bin/pxs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pxs.js","sourceRoot":"","sources":["../../bin/pxs.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/src/backends/claude.d.ts

@@ -0,0 +1,9 @@
+import type { AIBackend, ExecuteOptions, ExecuteResult } from './interface.js';
+export declare class ClaudeBackend implements AIBackend {
+    name: string;
+    isAvailable(): Promise<boolean>;
+    execute(prompt: string, opts?: ExecuteOptions): Promise<ExecuteResult>;
+    resume(sessionId: string, prompt: string, opts?: ExecuteOptions): Promise<ExecuteResult>;
+    private _run;
+    private _parseStreamJson;
+}

package/dist/src/backends/claude.js

@@ -0,0 +1,80 @@
+import { spawn, execFileSync } from 'node:child_process';
+export class ClaudeBackend {
+    name = 'claude';
+    async isAvailable() {
+        try {
+            execFileSync('which', ['claude'], { encoding: 'utf-8' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async execute(prompt, opts) {
+        return this._run(['claude', '-p', prompt, '--output-format', 'stream-json'], opts);
+    }
+    async resume(sessionId, prompt, opts) {
+        return this._run(['claude', '-p', prompt, '--resume', sessionId, '--output-format', 'stream-json'], opts);
+    }
+    _run(args, opts) {
+        const [cmd, ...cmdArgs] = args;
+        return new Promise((resolve, reject) => {
+            const child = spawn(cmd, cmdArgs, {
+                cwd: opts?.cwd ?? process.cwd(),
+                stdio: ['ignore', 'pipe', 'pipe'],
+                timeout: opts?.timeout,
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            child.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('close', (code) => {
+                const result = this._parseStreamJson(stdout);
+                resolve({
+                    output: result.output,
+                    sessionId: result.sessionId,
+                    exitCode: code ?? 1,
+                });
+            });
+            child.on('error', (err) => {
+                reject(new Error(`Claude CLI error: ${err.message}`));
+            });
+        });
+    }
+    _parseStreamJson(raw) {
+        let output = '';
+        let sessionId = '';
+        const lines = raw.split('\n').filter((l) => l.trim());
+        for (const line of lines) {
+            try {
+                const json = JSON.parse(line);
+                if (json.type === 'assistant' && json.message?.content) {
+                    for (const block of json.message.content) {
+                        if (block.type === 'text') {
+                            output += block.text;
+                        }
+                    }
+                }
+                if (json.session_id) {
+                    sessionId = json.session_id;
+                }
+                // Also check result message
+                if (json.type === 'result' && json.result) {
+                    output = json.result;
+                }
+                if (json.type === 'result' && json.session_id) {
+                    sessionId = json.session_id;
+                }
+            }
+            catch {
+                // Not JSON, skip
+            }
+        }
+        return { output, sessionId };
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/src/backends/claude.js.map

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

package/dist/src/backends/codex.d.ts

@@ -0,0 +1,9 @@
+import type { AIBackend, ExecuteOptions, ExecuteResult } from './interface.js';
+export declare class CodexBackend implements AIBackend {
+    name: string;
+    isAvailable(): Promise<boolean>;
+    execute(prompt: string, opts?: ExecuteOptions): Promise<ExecuteResult>;
+    resume(sessionId: string, prompt: string, opts?: ExecuteOptions): Promise<ExecuteResult>;
+    private _run;
+    private _parseJsonl;
+}

package/dist/src/backends/codex.js

@@ -0,0 +1,72 @@
+import { spawn, execFileSync } from 'node:child_process';
+export class CodexBackend {
+    name = 'codex';
+    async isAvailable() {
+        try {
+            execFileSync('which', ['codex'], { encoding: 'utf-8' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async execute(prompt, opts) {
+        return this._run(['codex', 'exec', prompt, '--json'], opts);
+    }
+    async resume(sessionId, prompt, opts) {
+        return this._run(['codex', 'exec', 'resume', sessionId, prompt], opts);
+    }
+    _run(args, opts) {
+        const [cmd, ...cmdArgs] = args;
+        return new Promise((resolve, reject) => {
+            const child = spawn(cmd, cmdArgs, {
+                cwd: opts?.cwd ?? process.cwd(),
+                stdio: ['ignore', 'pipe', 'pipe'],
+                timeout: opts?.timeout,
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            child.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('close', (code) => {
+                const result = this._parseJsonl(stdout);
+                resolve({
+                    output: result.output,
+                    sessionId: result.sessionId,
+                    exitCode: code ?? 1,
+                });
+            });
+            child.on('error', (err) => {
+                reject(new Error(`Codex CLI error: ${err.message}`));
+            });
+        });
+    }
+    _parseJsonl(raw) {
+        let output = '';
+        let sessionId = '';
+        const lines = raw.split('\n').filter((l) => l.trim());
+        for (const line of lines) {
+            try {
+                const json = JSON.parse(line);
+                if (json.output)
+                    output += json.output;
+                if (json.text)
+                    output += json.text;
+                if (json.session_id)
+                    sessionId = json.session_id;
+                if (json.id)
+                    sessionId = json.id;
+            }
+            catch {
+                // Plain text fallback
+                output += line + '\n';
+            }
+        }
+        return { output: output.trim(), sessionId };
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/src/backends/codex.js.map

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

package/dist/src/backends/factory.d.ts

@@ -0,0 +1,2 @@
+import type { AIBackend } from './interface.js';
+export declare function createBackend(name: string): AIBackend;

package/dist/src/backends/factory.js

@@ -0,0 +1,14 @@
+import { ClaudeBackend } from './claude.js';
+import { CodexBackend } from './codex.js';
+const backends = {
+    claude: () => new ClaudeBackend(),
+    codex: () => new CodexBackend(),
+};
+export function createBackend(name) {
+    const factory = backends[name];
+    if (!factory) {
+        throw new Error(`Unknown backend: "${name}". Available: ${Object.keys(backends).join(', ')}`);
+    }
+    return factory();
+}
+//# sourceMappingURL=factory.js.map

package/dist/src/backends/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/backends/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,QAAQ,GAAoC;IAChD,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;IACjC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;CAChC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,iBAAiB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC"}

package/dist/src/backends/interface.d.ts

@@ -0,0 +1,15 @@
+export interface ExecuteOptions {
+    cwd?: string;
+    timeout?: number;
+}
+export interface ExecuteResult {
+    output: string;
+    sessionId: string;
+    exitCode: number;
+}
+export interface AIBackend {
+    name: string;
+    isAvailable(): Promise<boolean>;
+    execute(prompt: string, opts?: ExecuteOptions): Promise<ExecuteResult>;
+    resume(sessionId: string, prompt: string, opts?: ExecuteOptions): Promise<ExecuteResult>;
+}

package/dist/src/backends/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/src/backends/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/backends/interface.ts"],"names":[],"mappings":""}

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function createProgram(): Command;

package/dist/src/cli.js

@@ -0,0 +1,79 @@
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { newCommand } from './commands/new.js';
+import { refineCommand } from './commands/refine.js';
+import { clarifyCommand } from './commands/clarify.js';
+import { implementCommand } from './commands/implement.js';
+import { reviewCommand } from './commands/review.js';
+import { statusCommand } from './commands/status.js';
+import { parseArgs } from './parsers/arguments.js';
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('pxs')
+        .description('Spec-driven development CLI')
+        .version('1.0.0');
+    program
+        .command('init')
+        .description('Initialize pxs workflow for this project')
+        .option('--force', 'Overwrite existing .workflow/')
+        .option('--arch <architecture>', 'Architecture pattern (clean|hexagonal|ddd|layered|modular|custom)')
+        .option('--lang <lang-framework>', 'Language-framework (overrides auto-detect)')
+        .action(initCommand);
+    program
+        .command('new <name>')
+        .description('Create a new spec file')
+        .option('--desc <text>', 'Generate spec from text description')
+        .option('--jira <tickets...>', 'Import from Jira tickets')
+        .option('-i, --interactive', 'Interactive Q&A mode')
+        .action(newCommand);
+    program
+        .command('refine <name>')
+        .description('Refine spec and decompose implementation plan')
+        .option('--skip-clarify', 'Skip requirement clarification')
+        .option('--clarify <n>', 'Max clarification rounds', parseInt)
+        .allowUnknownOption()
+        .action((name, options, cmd) => {
+        const rawArgs = cmd.args ?? [];
+        const parsed = parseArgs(rawArgs);
+        return refineCommand(name, parsed, options);
+    });
+    program
+        .command('clarify <name>')
+        .description('Run requirement clarification on a spec')
+        .allowUnknownOption()
+        .action((name, _options, cmd) => {
+        const rawArgs = cmd.args ?? [];
+        const parsed = parseArgs(rawArgs);
+        return clarifyCommand(name, parsed);
+    });
+    program
+        .command('implement <name>')
+        .description('Implement code task by task')
+        .option('--backend <name>', 'AI backend (claude | codex)')
+        .option('--test [types...]', 'Test strategy')
+        .option('--skip-review', 'Skip final branch code review')
+        .allowUnknownOption()
+        .action((name, options, cmd) => {
+        const rawArgs = cmd.args ?? [];
+        const parsed = parseArgs(rawArgs);
+        return implementCommand(name, parsed, options);
+    });
+    program
+        .command('review <name>')
+        .description('View review records')
+        .option('--step <n>', 'View specific task review', parseInt)
+        .option('--summary', 'Summary overview of all tasks')
+        .allowUnknownOption()
+        .action((name, options) => {
+        return reviewCommand(name, options);
+    });
+    program
+        .command('status [name]')
+        .description('View workflow status')
+        .action((name) => {
+        return statusCommand(name);
+    });
+    return program;
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,KAAK,CAAC;SACX,WAAW,CAAC,6BAA6B,CAAC;SAC1C,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;SAClD,MAAM,CAAC,uBAAuB,EAAE,mEAAmE,CAAC;SACpG,MAAM,CAAC,yBAAyB,EAAE,4CAA4C,CAAC;SAC/E,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvB,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,eAAe,EAAE,qCAAqC,CAAC;SAC9D,MAAM,CAAC,qBAAqB,EAAE,0BAA0B,CAAC;SACzD,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;SACnD,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtB,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,gBAAgB,EAAE,gCAAgC,CAAC;SAC1D,MAAM,CAAC,eAAe,EAAE,0BAA0B,EAAE,QAAQ,CAAC;SAC7D,kBAAkB,EAAE;SACpB,MAAM,CAAC,CAAC,IAAY,EAAE,OAAoD,EAAE,GAAY,EAAE,EAAE;QAC3F,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,yCAAyC,CAAC;SACtD,kBAAkB,EAAE;SACpB,MAAM,CAAC,CAAC,IAAY,EAAE,QAAiB,EAAE,GAAY,EAAE,EAAE;QACxD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,kBAAkB,EAAE,6BAA6B,CAAC;SACzD,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC;SAC5C,MAAM,CAAC,eAAe,EAAE,+BAA+B,CAAC;SACxD,kBAAkB,EAAE;SACpB,MAAM,CAAC,CAAC,IAAY,EAAE,OAA8E,EAAE,GAAY,EAAE,EAAE;QACrH,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,qBAAqB,CAAC;SAClC,MAAM,CAAC,YAAY,EAAE,2BAA2B,EAAE,QAAQ,CAAC;SAC3D,MAAM,CAAC,WAAW,EAAE,+BAA+B,CAAC;SACpD,kBAAkB,EAAE;SACpB,MAAM,CAAC,CAAC,IAAY,EAAE,OAA6C,EAAE,EAAE;QACtE,OAAO,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,sBAAsB,CAAC;SACnC,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE;QACxB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,5 @@
+export declare function clarifyCommand(name: string, args: {
+    agents: string[];
+    skills: string[];
+    text: string;
+}): Promise<void>;

package/dist/src/commands/clarify.js

@@ -0,0 +1,46 @@
+import fs from 'node:fs';
+import { StateManager } from '../state/manager.js';
+import { createBackend } from '../backends/factory.js';
+import { assemblePrompt } from '../utils/prompt.js';
+import * as display from '../utils/display.js';
+export async function clarifyCommand(name, args) {
+    const state = new StateManager();
+    state.ensureWorkflow();
+    state.checkPhaseGuard('clarify', name);
+    const specPath = state.specPath(name);
+    if (!fs.existsSync(specPath)) {
+        display.error(`Spec "${name}" not found. Run \`pxs new ${name}\` first.`);
+        return;
+    }
+    const specContent = fs.readFileSync(specPath, 'utf-8');
+    const config = state.readConfig();
+    const backend = createBackend(config.backend.default);
+    if (!(await backend.isAvailable())) {
+        display.error(`Backend "${config.backend.default}" not available.`);
+        return;
+    }
+    display.heading(`Clarifying: ${name}`);
+    const prompt = assemblePrompt({
+        templateName: 'clarify',
+        vars: { spec_content: specContent },
+        agents: args.agents,
+        skills: args.skills,
+        extraText: args.text,
+    });
+    const feature = state.getFeature(name);
+    let result;
+    if (feature?.session?.id) {
+        result = await backend.resume(feature.session.id, prompt);
+    }
+    else {
+        result = await backend.execute(prompt);
+    }
+    console.log('\n' + result.output);
+    // Update state
+    if (feature) {
+        feature.phase = 'clarifying';
+        feature.session = { backend: config.backend.default, id: result.sessionId };
+        state.upsertFeature(feature);
+    }
+}
+//# sourceMappingURL=clarify.js.map

package/dist/src/commands/clarify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarify.js","sourceRoot":"","sources":["../../../src/commands/clarify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAA0D;IAE1D,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;IACjC,KAAK,CAAC,cAAc,EAAE,CAAC;IACvB,KAAK,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,8BAA8B,IAAI,WAAW,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtD,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,OAAO,kBAAkB,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,MAAM,GAAG,cAAc,CAAC;QAC5B,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,IAAI;KACrB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC;IACX,IAAI,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACzB,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAElC,eAAe;IACf,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC;QAC7B,OAAO,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5E,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,9 @@
+export declare function implementCommand(name: string, args: {
+    agents: string[];
+    skills: string[];
+    text: string;
+}, options: {
+    backend?: string;
+    test?: string[] | boolean;
+    skipReview?: boolean;
+}): Promise<void>;