@nova286/nova-workflow 0.2.0

package/README.md

@@ -0,0 +1,246 @@
+# Nova
+
+<p align="center">
+  <strong>THE AI Workflow is All You Need</strong>
+</p>
+
+<p align="center">
+  A thin orchestration shell for AI-assisted software development.<br/>
+  <strong>Don't neuter your skills. Orchestrate them.</strong>
+</p>
+
+---
+
+## What is Nova?
+
+Nova adds **process discipline** to AI-assisted development without restricting
+what your AI can do. It sequences your existing skills through a structured
+5-phase workflow — think of it as a state machine that sits between you and
+your AI tools, ensuring nothing gets skipped and everything gets recorded.
+
+### The Core Insight
+
+AI coding tools are powerful but undisciplined. Developers jump straight to
+implementation, skip design, forget to review. Nova fixes this not by
+**restricting** your AI skills (the old way), but by **orchestrating** them:
+
+| Old Way (V1) | New Way (V2) |
+|---|---|
+| "You are forbidden to write code" (HTML comment) | "Your goal in this phase is to produce a design doc" |
+| Replace real skills with thin 25-line templates | Call real skills (brainstorming, writing-plans, TDD...) in sequence |
+| 5 stub platform adapters nobody uses | 1 adapter for Claude Code — the one you actually use |
+| Remember slash commands for each phase | Just say "start designing" — or type `/nova` |
+
+### How It Feels to Use
+
+```
+You: "帮我设计一下用户登录模块"
+Nova: → Reads .nova.yaml, checks guards → Calls brainstorming → Calls writing-plans
+      → Generates design.md + 6 tasks → Updates state → "Design complete."
+
+You: "继续实现"
+Nova: → Routes each task by type → implementation tasks run TDD → tests pass after each
+      → Records traceId per task → "4/6 done. Continue?"
+
+You: "审查一下代码"
+Nova: → Parallel pipeline: code-review + security-review → Report with file:line references
+```
+
+**No slash commands needed.** Nova understands phase context from `.nova.yaml` and
+invokes the right skills automatically. If you prefer explicit control, `/nova`
+gives you a one-glance overview and suggested next action.
+
+---
+
+## Installation
+
+```bash
+npm install -g nova-workflow
+```
+
+## Quick Start
+
+```bash
+nova init          # Initialize Nova in your project
+```
+
+Then, inside Claude Code:
+
+```
+/nova              # See where you are and what's next
+
+# Or just talk naturally — Nova detects the phase and acts accordingly:
+"帮我做一个用户认证功能"
+"继续实现"
+"审查代码"
+"回退到设计阶段，组件拆分需要调整"
+```
+
+---
+
+## The Five Phases
+
+```
+propose ──→ design ──→ implement ──→ verify ──→ archive
+   │            │           │           │           │
+   │    brainstorming    TDD skill    ECC review    CLI
+   │   writing-plans   direct impl   pipeline     command
+   │
+   └── /nova-iterate ←── can roll back from any phase
+```
+
+Each phase has a **clear goal** and a **structured output**. Phase guards prevent
+skipping: you can't implement without a design. You can't verify without a build.
+And you can always iterate back — real development is not a waterfall.
+
+---
+
+## Commands
+
+### Skill Commands (inside Claude Code)
+
+| Command | What it does |
+|---------|-------------|
+| `/nova` | **One entry point.** Shows progress, suggests next action. |
+| `/nova-propose` | Explore requirements via brainstorming → proposal.md |
+| `/nova-design` | Explore architecture via brainstorming + writing-plans → design.md + YAML tasks |
+| `/nova-implement` | Execute tasks with type routing (implementation / TDD / testing) |
+| `/nova-verify` | Parallel pipeline: code review + security review via ECC skills |
+| `/nova-iterate` | Roll back to a previous phase for iteration |
+
+### CLI Commands (in terminal)
+
+| Command | What it does |
+|---------|-------------|
+| `nova init` | Initialize Nova: creates `.nova.yaml`, installs skill files |
+| `nova status` | Display phase progress and task completion |
+| `nova archive` | Clean up and finalize |
+| `nova context --task-id <id>` | Print structured TaskContext JSON for a task |
+| `nova guard <from> <to>` | Validate a phase transition |
+
+---
+
+## Design Philosophy
+
+### 1. Orchestrate, Don't Replace
+
+Nova does not write a single line of content. It does not come with its own prompt
+templates. It sequences **your** skills — Superpowers for methodology, ECC for
+quality — through a disciplined workflow. Each skill runs at full capability.
+
+### 2. Structured Handoff, Not Natural Language
+
+The handoff between design and implementation is the moment where most AI workflows
+break down. Nova solves this with `TaskContext` — a structured JSON contract:
+
+```json
+{
+  "taskId": "build-login",
+  "title": "Implement login endpoint",
+  "taskType": "implementation",
+  "input": {
+    "files": [{ "path": "src/login.ts", "action": "create" }],
+    "environment": { "language": "TypeScript", "framework": "Express.js" }
+  },
+  "acceptanceCriteria": ["Returns JWT on success"],
+  "guardConditions": { "requireReview": true, "requireTests": true }
+}
+```
+
+No ambiguity. No "I think the designer meant...". The implement phase knows exactly
+what to build, which files to touch, and what "done" looks like.
+
+### 3. State Machine, Not Wishful Thinking
+
+```
+open ──[proposal done]──→ design ──[tasks ready]──→ build
+build ──[all tasks done]──→ verify ──[review passed]──→ archive
+build ←──[iterate]── design    verify ←──[iterate]── build
+```
+
+Forward transitions are **gated** — the guard system enforces preconditions.
+Reverse transitions are **always allowed** — because iteration is real development.
+
+### 4. Every Invocation, Tracked
+
+Every AI call generates a `traceId`. Every task records its status, output
+artifacts, and completion time. The `.nova.yaml` state file is the single source
+of truth — atomic writes, mutex-guarded, crash-safe.
+
+### 5. Convention, Not Coercion
+
+Role separation comes from **phase structure**, not from fake security boundaries.
+The design phase says "your goal is a design doc" — that's enough. No HTML comments
+pretending to be access control. No skill neutering. Just clear goals and a state
+machine that keeps you honest.
+
+---
+
+## Architecture
+
+```
+src/
+├── cli/                        # Terminal commands (5 commands)
+│   ├── index.ts                # init, status, archive, context, guard
+│   ├── ui.ts                   # Spinners, colors
+│   └── error-handler.ts        # Unified error boundary
+├── cli-core/                   # Business logic
+│   ├── types.ts                # Core interfaces (TaskContext, NovaState, etc.)
+│   ├── state.ts                # Atomic .nova.yaml state manager (mutex + temp/rename)
+│   ├── guard.ts                # Phase transition rule engine (forward + rollback)
+│   ├── dispatcher.ts           # Single-agent execution with retry & traceId
+│   ├── context-generator.ts    # Task → TaskContext JSON mapper (11 languages)
+│   ├── pipeline.ts             # Multi-stage parallel orchestrator
+│   ├── platform-client.ts      # Claude Code client
+│   ├── init-manager.ts         # Init flow with transactional rollback
+│   ├── project-detect.ts       # Auto-detect project type
+│   └── adapters/               # Claude Code command generator
+└── templates/                  # Document templates (proposal.md, design.md)
+```
+
+---
+
+## State File
+
+Everything Nova knows lives in `.nova.yaml`:
+
+```yaml
+version: 2
+project: my-app
+environment: [claude-code]
+phases:
+  open:    { status: done, proposal: docs/proposals/proposal.md }
+  design:  { status: done, designDoc: docs/designs/design.md, tasks: [...] }
+  build:   { status: in-progress, tasks: { task-1: { status: done, traceId: nova-xxx } } }
+  verify:  { status: pending }
+  archive: { status: pending }
+metadata:
+  stateVersion: 12
+  lastModified: "2026-05-28T12:00:00.000Z"
+  history:
+    - { version: 8, change: "Task login-impl completed" }
+    - { version: 10, change: "Iterated build→design: component split needs rethinking" }
+```
+
+---
+
+## Testing
+
+```
+Test Suites: 7 passed
+Tests:       41 passed
+
+✓ state-manager     — load / atomic update / getTask / phase duration
+✓ guard             — 4 forward + 4 rollback transitions
+✓ dispatcher        — success / retry / max retries
+✓ context-generator — task → TaskContext mapping / 11 languages
+✓ pipeline          — success / fail / dependsOn / continue
+✓ project-detect    — 11 project type detection
+✓ init-manager      — fresh init / force re-init / dir creation / ECC install / templates
+```
+
+---
+
+## License
+
+MIT

package/dist/cli/commands/archive.d.ts

@@ -0,0 +1 @@
+export declare const archiveCommand: (...args: any[]) => Promise<void>;

package/dist/cli/commands/archive.js

@@ -0,0 +1,120 @@
+"use strict";
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.archiveCommand = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const ui_1 = require("../ui");
+const state_1 = require("../../cli-core/state");
+const guard_1 = require("../../cli-core/guard");
+const error_handler_1 = require("../error-handler");
+exports.archiveCommand = (0, error_handler_1.withErrorHandling)(async (options) => {
+    if (options.rollback) {
+        const { confirm } = await inquirer_1.default.prompt([{
+                type: 'confirm',
+                name: 'confirm',
+                message: 'Rollback archive phase: reset to pending. Continue?',
+                default: false,
+            }]);
+        if (!confirm) {
+            ui_1.ui.info('Cancelled.');
+            return;
+        }
+        await state_1.StateManager.update((s) => {
+            s.phases.archive = { status: 'pending' };
+            return s;
+        });
+        ui_1.ui.success('Archive phase rolled back to pending.');
+        return;
+    }
+    const passed = await (0, guard_1.guardPhaseTransition)('verify', 'archive');
+    if (!passed) {
+        ui_1.ui.error('Cannot archive. Complete the verify phase first.');
+        process.exit(1);
+    }
+    const state = await state_1.StateManager.load();
+    const cwd = process.cwd();
+    // 合并规格到 docs/specs/ 归档
+    const specsDir = path.join(cwd, 'docs', 'specs');
+    await fs.mkdir(specsDir, { recursive: true });
+    let mergedCount = 0;
+    // 归档 proposal
+    const proposalSrc = state.phases.open?.proposal;
+    if (proposalSrc) {
+        const src = path.join(cwd, proposalSrc);
+        try {
+            const content = await fs.readFile(src, 'utf-8');
+            const dest = path.join(specsDir, `proposal-${Date.now()}.md`);
+            await fs.writeFile(dest, content);
+            mergedCount++;
+        }
+        catch { /* 源文件不存在则跳过 */ }
+    }
+    // 归档 design
+    const designSrc = state.phases.design?.designDoc;
+    if (designSrc) {
+        const src = path.join(cwd, designSrc);
+        try {
+            const content = await fs.readFile(src, 'utf-8');
+            const dest = path.join(specsDir, `design-${Date.now()}.md`);
+            await fs.writeFile(dest, content);
+            mergedCount++;
+        }
+        catch { /* 源文件不存在则跳过 */ }
+    }
+    // 归档 verify 结果
+    if (state.phases.verify?.pipelineResult) {
+        const dest = path.join(specsDir, `verify-result-${Date.now()}.json`);
+        await fs.writeFile(dest, JSON.stringify(state.phases.verify.pipelineResult, null, 2));
+        mergedCount++;
+    }
+    // 清理临时文件
+    const contextsDir = path.join(cwd, '.nova', 'contexts');
+    try {
+        const files = await fs.readdir(contextsDir);
+        for (const f of files)
+            await fs.unlink(path.join(contextsDir, f));
+    }
+    catch { /* nothing to clean */ }
+    await state_1.StateManager.setPhaseField('archive', 'status', 'done');
+    ui_1.ui.success('Project archived. All phases complete.');
+    ui_1.ui.info(`Merged ${mergedCount} artifact(s) to docs/specs/.`);
+    ui_1.ui.info('Temporary context files cleaned up.');
+});
+//# sourceMappingURL=archive.js.map

package/dist/cli/commands/archive.js.map

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

package/dist/cli/commands/context.d.ts

@@ -0,0 +1 @@
+export declare const contextCommand: (...args: any[]) => Promise<void>;

package/dist/cli/commands/context.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextCommand = void 0;
+const ui_1 = require("../ui");
+const state_1 = require("../../cli-core/state");
+const context_generator_1 = require("../../cli-core/context-generator");
+const error_handler_1 = require("../error-handler");
+exports.contextCommand = (0, error_handler_1.withErrorHandling)(async (options) => {
+    if (!options.taskId) {
+        ui_1.ui.error('--task-id is required.');
+        process.exit(1);
+    }
+    const state = await state_1.StateManager.load();
+    const tasks = state.phases.design?.tasks || [];
+    const task = tasks.find((t) => t.id === options.taskId);
+    if (!task) {
+        ui_1.ui.error(`Task "${options.taskId}" not found in design phase.`);
+        process.exit(1);
+    }
+    const context = await context_generator_1.ContextGenerator.generateFromTask(task);
+    console.log(JSON.stringify(context, null, 2));
+});
+//# sourceMappingURL=context.js.map

package/dist/cli/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/cli/commands/context.ts"],"names":[],"mappings":";;;AAAA,8BAA2B;AAC3B,gDAAoD;AACpD,wEAAoE;AACpE,oDAAqD;AAExC,QAAA,cAAc,GAAG,IAAA,iCAAiB,EAAC,KAAK,EAAE,OAA4B,EAAE,EAAE;IACrF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,oBAAY,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,KAAK,GAAU,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAExD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAE,CAAC,KAAK,CAAC,SAAS,OAAO,CAAC,MAAM,8BAA8B,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,oCAAgB,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC"}

package/dist/cli/commands/guard.d.ts

@@ -0,0 +1 @@
+export declare const guardCommand: (...args: any[]) => Promise<void>;

package/dist/cli/commands/guard.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guardCommand = void 0;
+const ui_1 = require("../ui");
+const guard_1 = require("../../cli-core/guard");
+const error_handler_1 = require("../error-handler");
+exports.guardCommand = (0, error_handler_1.withErrorHandling)(async (from, to) => {
+    if (!from || !to) {
+        ui_1.ui.error('Usage: nova guard <from> <to>');
+        process.exit(1);
+    }
+    const passed = await (0, guard_1.guardPhaseTransition)(from, to);
+    if (passed) {
+        ui_1.ui.success(`Guard passed: ${from} → ${to}`);
+    }
+    else {
+        ui_1.ui.error(`Guard failed: ${from} → ${to}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=guard.js.map

package/dist/cli/commands/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../../src/cli/commands/guard.ts"],"names":[],"mappings":";;;AAAA,8BAA2B;AAC3B,gDAA4D;AAC5D,oDAAqD;AAExC,QAAA,YAAY,GAAG,IAAA,iCAAiB,EAAC,KAAK,EAAE,IAAY,EAAE,EAAU,EAAE,EAAE;IAC/E,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QACjB,OAAE,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,4BAAoB,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpD,IAAI,MAAM,EAAE,CAAC;QACX,OAAE,CAAC,OAAO,CAAC,iBAAiB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,OAAE,CAAC,KAAK,CAAC,iBAAiB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1 @@
+export declare const initCommand: (...args: any[]) => Promise<void>;

package/dist/cli/commands/init.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = void 0;
+const ui_1 = require("../ui");
+const init_manager_1 = require("../../cli-core/init-manager");
+const error_handler_1 = require("../error-handler");
+exports.initCommand = (0, error_handler_1.withErrorHandling)(async (options) => {
+    ui_1.ui.step('Welcome to Nova! Initializing your project...');
+    const manager = new init_manager_1.InitManager(process.cwd(), {
+        eccPath: options.withEcc,
+        force: options.force
+    });
+    try {
+        await manager.run();
+        ui_1.ui.success('Nova initialized successfully!');
+    }
+    catch (err) {
+        ui_1.ui.error(`Initialization failed: ${err.message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":";;;AAAA,8BAA2B;AAC3B,8DAA0D;AAC1D,oDAAqD;AAExC,QAAA,WAAW,GAAG,IAAA,iCAAiB,EAAC,KAAK,EAAE,OAA8C,EAAE,EAAE;IACpG,OAAE,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,0BAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE;QAC7C,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QACpB,OAAE,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAE,CAAC,KAAK,CAAC,0BAA0B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1 @@
+export declare const statusCommand: (...args: any[]) => Promise<void>;

package/dist/cli/commands/status.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusCommand = void 0;
+const ui_1 = require("../ui");
+const state_1 = require("../../cli-core/state");
+const error_handler_1 = require("../error-handler");
+const PHASE_ORDER = ['open', 'design', 'build', 'verify', 'archive'];
+const PHASE_LABEL = {
+    open: 'propose',
+    design: 'design',
+    build: 'implement',
+    verify: 'verify',
+    archive: 'archive',
+};
+const STATUS_ICON = {
+    done: '✅',
+    'in-progress': '🔄',
+    pending: '⬜',
+};
+// 超时阈值（毫秒）
+const STUCK_THRESHOLDS = {
+    open: 30 * 60 * 1000, // 30 min
+    design: 60 * 60 * 1000, // 1 hour
+    build: 120 * 60 * 1000, // 2 hours
+    verify: 30 * 60 * 1000, // 30 min
+    archive: 15 * 60 * 1000, // 15 min
+};
+const STUCK_MESSAGE = {
+    open: 'Proposal has been in progress for a while. Consider running "nova propose --done" or "--rollback".',
+    design: 'Design has been in progress for a while. Consider running "nova design --done" or "--rollback".',
+    build: 'Implementation has been in progress for a while. Check task status and consider "--rollback" if stuck.',
+    verify: 'Verification has been in progress for a while. Consider running "nova verify --rollback" if needed.',
+    archive: 'Archive has been in progress. Run "nova archive --done" to finish or "--rollback" to reset.',
+};
+exports.statusCommand = (0, error_handler_1.withErrorHandling)(async () => {
+    const state = await state_1.StateManager.load();
+    ui_1.ui.step(`Project: ${state.project}`);
+    ui_1.ui.info(`Environment: ${state.environment.join(', ') || '(none)'}`);
+    ui_1.ui.info('');
+    const warnings = [];
+    for (const phase of PHASE_ORDER) {
+        const data = state.phases[phase] || {};
+        const status = data.status || 'pending';
+        const icon = STATUS_ICON[status] || '⬜';
+        const label = PHASE_LABEL[phase] || phase;
+        const extra = [];
+        // 耗时统计
+        const duration = state_1.StateManager.getPhaseDuration(data);
+        if (duration)
+            extra.push(duration);
+        if (phase === 'build' && data.tasks) {
+            const entries = Object.entries(data.tasks);
+            const done = entries.filter(([, t]) => t.status === 'done').length;
+            extra.push(`tasks: ${done}/${entries.length} done`);
+        }
+        ui_1.ui.info(`  ${icon} ${label}: ${status}${extra.length ? ` (${extra.join(', ')})` : ''}`);
+        // 卡住检测
+        if (status === 'in-progress' && data.startedAt) {
+            const elapsed = Date.now() - new Date(data.startedAt).getTime();
+            const threshold = STUCK_THRESHOLDS[phase] || 60 * 60 * 1000;
+            if (elapsed > threshold) {
+                warnings.push(`${label}: ${STUCK_MESSAGE[phase]}`);
+            }
+        }
+    }
+    if (warnings.length > 0) {
+        ui_1.ui.warn('');
+        for (const w of warnings)
+            ui_1.ui.warn(w);
+    }
+});
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

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

package/dist/cli/error-handler.d.ts

@@ -0,0 +1 @@
+export declare function withErrorHandling(fn: (...args: any[]) => Promise<void>): (...args: any[]) => Promise<void>;

package/dist/cli/error-handler.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withErrorHandling = withErrorHandling;
+const ui_1 = require("./ui");
+function withErrorHandling(fn) {
+    return async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (err) {
+            ui_1.ui.error(err.message || 'Unknown error');
+            if (process.env.DEBUG)
+                console.error(err);
+            process.exit(1);
+        }
+    };
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/cli/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/cli/error-handler.ts"],"names":[],"mappings":";;AAEA,8CAUC;AAZD,6BAA0B;AAE1B,SAAgB,iBAAiB,CAAC,EAAqC;IACrE,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC;YACzC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK;gBAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/cli/index.d.ts

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

package/dist/cli/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_1 = require("./commands/init");
+const archive_1 = require("./commands/archive");
+const status_1 = require("./commands/status");
+const context_1 = require("./commands/context");
+const guard_1 = require("./commands/guard");
+const program = new commander_1.Command();
+program
+    .name('nova')
+    .description('Nova: AI workflow orchestration — init, status, archive')
+    .version('0.1.0');
+program
+    .command('init')
+    .option('--with-ecc <path>', 'Path to ECC skills')
+    .option('--force', 'Overwrite existing configuration')
+    .action(init_1.initCommand);
+program
+    .command('archive')
+    .option('--rollback', 'Rollback archive phase to pending')
+    .action(archive_1.archiveCommand);
+program
+    .command('status')
+    .action(status_1.statusCommand);
+program
+    .command('context')
+    .requiredOption('--task-id <id>', 'Task identifier')
+    .action(context_1.contextCommand);
+program
+    .command('guard <from> <to>')
+    .action(guard_1.guardCommand);
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AACA,yCAAoC;AACpC,0CAA8C;AAC9C,gDAAoD;AACpD,8CAAkD;AAClD,gDAAoD;AACpD,4CAAgD;AAEhD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,MAAM,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;KACjD,MAAM,CAAC,SAAS,EAAE,kCAAkC,CAAC;KACrD,MAAM,CAAC,kBAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,MAAM,CAAC,YAAY,EAAE,mCAAmC,CAAC;KACzD,MAAM,CAAC,wBAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,MAAM,CAAC,sBAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,cAAc,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;KACnD,MAAM,CAAC,wBAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,MAAM,CAAC,oBAAY,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/cli/ui.d.ts

@@ -0,0 +1,10 @@
+import { Ora } from 'ora';
+export declare const ui: {
+    spinner: (text: string) => Ora;
+    success: (text: string) => void;
+    error: (text: string) => void;
+    warn: (text: string) => void;
+    info: (text: string) => void;
+    step: (text: string) => void;
+    guardResult: (passed: boolean, msg: string) => void;
+};

package/dist/cli/ui.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ui = void 0;
+const ora_1 = __importDefault(require("ora"));
+const chalk_1 = __importDefault(require("chalk"));
+exports.ui = {
+    spinner: (text) => (0, ora_1.default)(text).start(),
+    success: (text) => console.log(chalk_1.default.green('✔ ' + text)),
+    error: (text) => console.error(chalk_1.default.red('✖ ' + text)),
+    warn: (text) => console.warn(chalk_1.default.yellow('⚠ ' + text)),
+    info: (text) => console.log(chalk_1.default.blue('ℹ ' + text)),
+    step: (text) => console.log(chalk_1.default.cyan('● ' + text)),
+    guardResult: (passed, msg) => {
+        const icon = passed ? chalk_1.default.green('✅') : chalk_1.default.red('❌');
+        console.log(`   ${icon} ${msg}`);
+    }
+};
+//# sourceMappingURL=ui.js.map