@nova286/nova-workflow 0.2.0

package/dist/cli-core/types.d.ts

@@ -0,0 +1,141 @@
+export declare enum AgentType {
+    PLANNER = "planner",
+    ARCHITECT = "architect",
+    CODER = "coder",
+    TDD_GUIDE = "tdd_guide",
+    CODE_REVIEWER = "code_reviewer",
+    SECURITY_REVIEWER = "security_reviewer"
+}
+export interface TaskContext {
+    taskId: string;
+    parentTaskId?: string;
+    title: string;
+    description: string;
+    taskType: 'design' | 'implementation' | 'review' | 'testing' | 'security' | 'other';
+    designContext: {
+        designDocRef: string;
+        relevantSpecs: string[];
+        architectureNotes: string;
+    };
+    input: {
+        files: {
+            path: string;
+            content?: string;
+            action: string;
+        }[];
+        dependencies: string[];
+        environment: {
+            language: string;
+            framework: string;
+            buildTool: string;
+            testFramework: string;
+        };
+    };
+    output: {
+        expectedArtifacts: {
+            type: string;
+            description: string;
+            pathHint?: string;
+            validation?: any;
+        }[];
+        constraints: {
+            maxFilesChanged?: number;
+            mustPassTests: boolean;
+            codeStyle?: string;
+        };
+    };
+    acceptanceCriteria: string[];
+    guardConditions: {
+        requireReview: boolean;
+        requireTests: boolean;
+        blocking: boolean;
+    };
+    metadata: {
+        createdBy: string;
+        createdAt: string;
+        priority: string;
+        estimatedComplexity: number;
+    };
+    iteration?: {
+        round: number;
+        reason?: string;
+        previousTraceId?: string;
+    };
+}
+export interface NovaState {
+    version: number;
+    project: string;
+    environment: string[];
+    currentPhase: string;
+    phases: Record<string, any>;
+    metadata: {
+        stateVersion: number;
+        lastModified: string;
+        history: any[];
+    };
+}
+export interface DispatchRequest {
+    agent: AgentType;
+    context: TaskContext;
+    model?: string;
+    timeout?: number;
+    effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    retry?: {
+        maxAttempts: number;
+        backoff: string;
+    };
+    outputSchema?: string;
+}
+export interface DispatchResult {
+    traceId: string;
+    agent: AgentType;
+    status: 'success' | 'failed' | 'timeout' | 'validation_error';
+    output?: any;
+    rawOutput?: string;
+    metadata: {
+        startTime: Date;
+        endTime: Date;
+        attempts: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+        };
+    };
+    errors?: ErrorDetail[];
+}
+export interface ErrorDetail {
+    message: string;
+    code?: string;
+}
+export interface EnvironmentAdapter {
+    name: string;
+    setup(cwd: string): Promise<void>;
+}
+export interface PipelineTask {
+    id: string;
+    agent: AgentType;
+    context: TaskContext;
+    timeout?: number;
+    retry?: {
+        maxAttempts: number;
+        backoff: 'fixed' | 'exponential';
+    };
+}
+export interface Stage {
+    id: string;
+    tasks: PipelineTask[];
+    dependsOn?: string[];
+    onStageFailure?: 'fail_fast' | 'continue';
+}
+export interface Pipeline {
+    stages: Stage[];
+}
+export interface StageResult {
+    stageId: string;
+    status: 'success' | 'partial' | 'failed';
+    taskResults: DispatchResult[];
+}
+export interface PipelineResult {
+    status: 'success' | 'partial' | 'failed';
+    stages: StageResult[];
+}

package/dist/cli-core/types.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentType = void 0;
+var AgentType;
+(function (AgentType) {
+    AgentType["PLANNER"] = "planner";
+    AgentType["ARCHITECT"] = "architect";
+    AgentType["CODER"] = "coder";
+    AgentType["TDD_GUIDE"] = "tdd_guide";
+    AgentType["CODE_REVIEWER"] = "code_reviewer";
+    AgentType["SECURITY_REVIEWER"] = "security_reviewer";
+})(AgentType || (exports.AgentType = AgentType = {}));
+//# sourceMappingURL=types.js.map

package/dist/cli-core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli-core/types.ts"],"names":[],"mappings":";;;AAAA,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,oCAAuB,CAAA;IACvB,4BAAe,CAAA;IACf,oCAAuB,CAAA;IACvB,4CAA+B,CAAA;IAC/B,oDAAuC,CAAA;AACzC,CAAC,EAPW,SAAS,yBAAT,SAAS,QAOpB"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@nova286/nova-workflow",
+  "version": "0.2.0",
+  "description": "Nova: AI workflow orchestration — a thin shell for disciplined AI-assisted development",
+  "main": "dist/cli/index.js",
+  "bin": { "nova": "dist/cli/index.js" },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/cli/index.ts",
+    "test": "jest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "files": ["dist/", "templates/", "README.md"],
+  "keywords": ["nova", "ai-workflow", "orchestration", "claude-code", "skill-based", "process-automation"],
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^7.0.0",
+    "yaml": "^2.3.0",
+    "inquirer": "^9.0.0",
+    "async-mutex": "^0.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/inquirer": "^9.0.0",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.9.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
+    "ts-jest": "^29.0.0"
+  }
+}

package/templates/docs/design.md

@@ -0,0 +1,41 @@
+# Design
+
+## Architecture Overview
+
+<!-- High-level architecture, patterns, and system structure -->
+
+## Tech Stack
+
+<!-- Languages, frameworks, key dependencies -->
+
+## Component Breakdown
+
+<!-- Each module/component and its responsibility -->
+
+## Data Flow
+
+<!-- How data moves through the system, key interfaces -->
+
+## Implementation Plan
+
+<!-- Ordered list of tasks defined in YAML below -->
+
+```yaml
+tasks:
+  - id: task-1
+    title: Example task
+    type: implementation
+    description: What needs to be done
+    files:
+      - {path: src/example.ts, action: create}
+    expectedArtifacts:
+      - {type: file, description: Example module, pathHint: src/example.ts}
+    acceptance:
+      - Acceptance criterion 1
+    priority: medium
+    estimatedComplexity: 3
+```
+
+## Risks & Mitigations
+
+<!-- Known risks, what could go wrong, and how to handle it -->

package/templates/docs/proposal.md

@@ -0,0 +1,25 @@
+# Proposal: {title}
+
+## Problem Statement
+
+<!-- What problem exists, and why does it matter? -->
+
+## Proposed Solution
+
+<!-- High-level approach — what are we building, and how? -->
+
+## User Stories
+
+<!-- Who needs what, in priority order -->
+
+## Scope & Deliverables
+
+<!-- What is in scope, what is out, and what concrete outputs will we produce? -->
+
+## Success Criteria
+
+<!-- Measurable outcomes that define success -->
+
+## Risks & Constraints
+
+<!-- Known risks, limitations, dependencies, or constraints -->