@generacy-ai/orchestrator 0.0.0-preview-20260304013206

package/dist/worker/types.d.ts

@@ -0,0 +1,192 @@
+import type { QueueItem } from '../types/index.js';
+import type { GitHubClient } from '@generacy-ai/workflow-engine';
+/**
+ * Workflow phases in execution order
+ */
+export type WorkflowPhase = 'specify' | 'clarify' | 'plan' | 'tasks' | 'implement' | 'validate';
+/**
+ * Ordered sequence of all workflow phases (default for feature/bugfix workflows)
+ */
+export declare const PHASE_SEQUENCE: WorkflowPhase[];
+/**
+ * Phase sequences keyed by workflow name.
+ * Each workflow can define a subset of phases to execute.
+ */
+export declare const WORKFLOW_PHASE_SEQUENCES: Record<string, WorkflowPhase[]>;
+/**
+ * Get the phase sequence for a given workflow name.
+ * Falls back to PHASE_SEQUENCE for unknown workflows.
+ */
+export declare function getPhaseSequence(workflowName: string): WorkflowPhase[];
+/**
+ * Map each phase to its Claude CLI slash command (null = no CLI command)
+ */
+export declare const PHASE_TO_COMMAND: Record<WorkflowPhase, string | null>;
+/**
+ * Stage types for issue comments
+ */
+export type StageType = 'specification' | 'planning' | 'implementation';
+/**
+ * Map each phase to the stage it belongs to
+ */
+export declare const PHASE_TO_STAGE: Record<WorkflowPhase, StageType>;
+/**
+ * HTML markers used to identify stage comments on issues
+ */
+export declare const STAGE_MARKERS: Record<StageType, string>;
+/**
+ * Gate definition for pausing workflow at review checkpoints
+ */
+export interface GateDefinition {
+    /** Phase that triggers gate check */
+    phase: WorkflowPhase;
+    /** Label to add when gate is active */
+    gateLabel: string;
+    /** When to activate the gate */
+    condition: 'always' | 'on-questions' | 'on-failure';
+}
+/**
+ * Result from executing a single phase
+ */
+export interface PhaseResult {
+    /** Phase that was executed */
+    phase: WorkflowPhase;
+    /** Whether the phase completed successfully */
+    success: boolean;
+    /** CLI exit code (0 = success) */
+    exitCode: number;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Captured output chunks */
+    output: OutputChunk[];
+    /** Claude CLI session ID (for resuming conversation in subsequent phases) */
+    sessionId?: string;
+    /** Whether a gate was hit (stops the loop) */
+    gateHit?: {
+        gateLabel: string;
+        reason: string;
+    };
+    /** Error details if failed */
+    error?: {
+        message: string;
+        stderr: string;
+        phase: WorkflowPhase;
+    };
+}
+/**
+ * A single chunk of parsed output from Claude CLI
+ */
+export interface OutputChunk {
+    /** Event type from Claude CLI JSON output */
+    type: 'init' | 'tool_use' | 'tool_result' | 'text' | 'complete' | 'error';
+    /** Parsed JSON data */
+    data: unknown;
+    /** Metadata (e.g., filePath for tool_result) */
+    metadata?: Record<string, string>;
+    /** Timestamp */
+    timestamp: string;
+}
+/**
+ * Options for spawning a Claude CLI process
+ */
+export interface CliSpawnOptions {
+    /** The speckit command prompt */
+    prompt: string;
+    /** Working directory (repo checkout) */
+    cwd: string;
+    /** Environment variables to pass */
+    env: Record<string, string>;
+    /** Maximum turns */
+    maxTurns: number;
+    /** Timeout in milliseconds */
+    timeoutMs: number;
+    /** Abort signal for graceful shutdown */
+    signal: AbortSignal;
+    /** Session ID from a previous phase to resume (keeps MCP servers warm, carries context) */
+    resumeSessionId?: string;
+}
+/**
+ * Data for stage comment updates on issues
+ */
+export interface StageCommentData {
+    /** Stage type */
+    stage: StageType;
+    /** Current status */
+    status: 'in_progress' | 'complete' | 'error';
+    /** Phase progress within the stage */
+    phases: {
+        phase: WorkflowPhase;
+        status: 'pending' | 'in_progress' | 'complete' | 'error';
+        startedAt?: string;
+        completedAt?: string;
+    }[];
+    /** When the stage started */
+    startedAt: string;
+    /** When the stage completed */
+    completedAt?: string;
+    /** PR URL if available */
+    prUrl?: string;
+}
+/**
+ * Logger interface (pino-compatible subset)
+ */
+export interface Logger {
+    info(msg: string): void;
+    info(obj: Record<string, unknown>, msg: string): void;
+    warn(msg: string): void;
+    warn(obj: Record<string, unknown>, msg: string): void;
+    error(msg: string): void;
+    error(obj: Record<string, unknown>, msg: string): void;
+    debug(msg: string): void;
+    debug(obj: Record<string, unknown>, msg: string): void;
+    child(bindings: Record<string, unknown>): Logger;
+}
+/**
+ * Context passed through the worker during processing
+ */
+export interface WorkerContext {
+    /** Worker ID from dispatcher (UUID) */
+    workerId: string;
+    /** Queue item being processed */
+    item: QueueItem;
+    /** Resolved starting phase */
+    startPhase: WorkflowPhase;
+    /** GitHub client for API operations */
+    github: GitHubClient;
+    /** Logger instance */
+    logger: Logger;
+    /** Abort signal for graceful shutdown */
+    signal: AbortSignal;
+    /** Repository checkout path */
+    checkoutPath: string;
+    /** Issue URL for prompts */
+    issueUrl: string;
+    /** PR URL — set after draft PR is created, updated by PrManager */
+    prUrl?: string;
+}
+/**
+ * Factory for creating child processes (injectable for testing)
+ */
+export interface ProcessFactory {
+    spawn(command: string, args: string[], options: {
+        cwd: string;
+        env: Record<string, string>;
+        signal?: AbortSignal;
+    }): ChildProcessHandle;
+}
+/**
+ * Handle to a spawned child process
+ */
+export interface ChildProcessHandle {
+    /** Process stdout stream */
+    stdout: NodeJS.ReadableStream | null;
+    /** Process stderr stream */
+    stderr: NodeJS.ReadableStream | null;
+    /** Process PID */
+    pid: number | undefined;
+    /** Kill the process */
+    kill(signal?: NodeJS.Signals): boolean;
+    /** Promise that resolves with exit code when process exits */
+    exitPromise: Promise<number | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/worker/types.d.ts.map

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

package/dist/worker/types.js

@@ -0,0 +1,53 @@
+/**
+ * Ordered sequence of all workflow phases (default for feature/bugfix workflows)
+ */
+export const PHASE_SEQUENCE = [
+    'specify', 'clarify', 'plan', 'tasks', 'implement', 'validate',
+];
+/**
+ * Phase sequences keyed by workflow name.
+ * Each workflow can define a subset of phases to execute.
+ */
+export const WORKFLOW_PHASE_SEQUENCES = {
+    'speckit-feature': PHASE_SEQUENCE,
+    'speckit-bugfix': PHASE_SEQUENCE,
+    'speckit-epic': ['specify', 'clarify', 'plan', 'tasks'],
+};
+/**
+ * Get the phase sequence for a given workflow name.
+ * Falls back to PHASE_SEQUENCE for unknown workflows.
+ */
+export function getPhaseSequence(workflowName) {
+    return WORKFLOW_PHASE_SEQUENCES[workflowName] ?? PHASE_SEQUENCE;
+}
+/**
+ * Map each phase to its Claude CLI slash command (null = no CLI command)
+ */
+export const PHASE_TO_COMMAND = {
+    specify: '/speckit:specify',
+    clarify: '/speckit:clarify',
+    plan: '/speckit:plan',
+    tasks: '/speckit:tasks',
+    implement: '/speckit:implement',
+    validate: null,
+};
+/**
+ * Map each phase to the stage it belongs to
+ */
+export const PHASE_TO_STAGE = {
+    specify: 'specification',
+    clarify: 'specification',
+    plan: 'planning',
+    tasks: 'planning',
+    implement: 'implementation',
+    validate: 'implementation',
+};
+/**
+ * HTML markers used to identify stage comments on issues
+ */
+export const STAGE_MARKERS = {
+    specification: '<!-- generacy-stage:specification -->',
+    planning: '<!-- generacy-stage:planning -->',
+    implementation: '<!-- generacy-stage:implementation -->',
+};
+//# sourceMappingURL=types.js.map

package/dist/worker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/worker/types.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU;CAC/D,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoC;IACvE,iBAAiB,EAAE,cAAc;IACjC,gBAAgB,EAAE,cAAc;IAChC,cAAc,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC;CACxD,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB;IACnD,OAAO,wBAAwB,CAAC,YAAY,CAAC,IAAI,cAAc,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAyC;IACpE,OAAO,EAAE,kBAAkB;IAC3B,OAAO,EAAE,kBAAkB;IAC3B,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,gBAAgB;IACvB,SAAS,EAAE,oBAAoB;IAC/B,QAAQ,EAAE,IAAI;CACf,CAAC;AAOF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqC;IAC9D,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,SAAS,EAAE,gBAAgB;IAC3B,QAAQ,EAAE,gBAAgB;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAA8B;IACtD,aAAa,EAAE,uCAAuC;IACtD,QAAQ,EAAE,kCAAkC;IAC5C,cAAc,EAAE,wCAAwC;CACzD,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@generacy-ai/orchestrator",
+  "version": "0.0.0-preview-20260304013206",
+  "description": "Orchestrator service - main API server for Generacy workflow orchestration",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@fastify/cors": "^10.0.0",
+    "@fastify/helmet": "^12.0.0",
+    "@fastify/jwt": "^9.0.0",
+    "@fastify/oauth2": "^8.0.0",
+    "@fastify/rate-limit": "^10.0.0",
+    "fastify": "^5.0.0",
+    "ioredis": "^5.4.0",
+    "pino": "^9.0.0",
+    "prom-client": "^15.0.0",
+    "yaml": "^2.4.0",
+    "zod": "^3.23.0",
+    "@generacy-ai/workflow-engine": "^0.0.0-preview-20260304013206"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "orchestrator",
+    "api",
+    "fastify",
+    "generacy"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/generacy-ai/generacy.git",
+    "directory": "packages/orchestrator"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/server.ts",
+    "start": "node dist/server.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src tests --ext .ts",
+    "typecheck": "tsc --noEmit"
+  }
+}