@prodara/compiler 0.1.0

package/dist/workflow/index.js

@@ -0,0 +1,7 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Workflow (public API)
+// ---------------------------------------------------------------------------
+export { PHASE_KINDS } from './types.js';
+export { runClarifyPhase, autoResolveClarifications } from './clarify.js';
+export { runWorkflow, runSpecifyPhase, runPlanPhase, runTasksPhase, runAnalyzePhase, runImplementPhase, } from './engine.js';
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAsB9E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/workflow/types.d.ts

@@ -0,0 +1,95 @@
+import type { QuestionPriority } from '../config/config.js';
+export declare const PHASE_KINDS: readonly ["specify", "clarify", "plan", "tasks", "analyze", "implement"];
+export type PhaseKind = (typeof PHASE_KINDS)[number];
+export interface PhaseResult<T = unknown> {
+    readonly phase: PhaseKind;
+    readonly ok: boolean;
+    readonly data: T;
+    readonly warnings: readonly string[];
+}
+export interface SpecifyOutput {
+    readonly affectedModules: readonly string[];
+    readonly addedNodes: readonly SpecifyNodeEntry[];
+    readonly removedNodes: readonly SpecifyNodeEntry[];
+    readonly modifiedNodes: readonly SpecifyNodeEntry[];
+    readonly impactedNodes: readonly SpecifyNodeEntry[];
+}
+export interface SpecifyNodeEntry {
+    readonly nodeId: string;
+    readonly nodeKind: string;
+    readonly module: string;
+    readonly description: string;
+}
+export interface ClarifyOutput {
+    readonly questions: readonly ClarifyQuestion[];
+    readonly filteredCount: number;
+    readonly totalCount: number;
+}
+export interface ClarifyQuestion {
+    readonly id: string;
+    readonly priority: QuestionPriority;
+    readonly category: ClarifyCategory;
+    readonly nodeId: string | null;
+    readonly question: string;
+    readonly confidence: ClarifyConfidence;
+}
+export type ClarifyConfidence = 'low' | 'medium' | 'high';
+export interface AutoClarifyResult {
+    readonly autoResolved: readonly ResolvedQuestion[];
+    readonly needsInput: readonly ClarifyQuestion[];
+}
+export interface ResolvedQuestion {
+    readonly question: ClarifyQuestion;
+    readonly answer: string;
+    readonly reason: string;
+}
+export type ClarifyCategory = 'ambiguous_type' | 'missing_rule' | 'unresolved_import' | 'empty_module' | 'missing_authorization' | 'missing_field' | 'missing_action';
+export interface PlanOutput {
+    readonly steps: readonly PlanStep[];
+}
+export interface PlanStep {
+    readonly stepId: string;
+    readonly taskId: string;
+    readonly nodeId: string;
+    readonly action: string;
+    readonly module: string;
+    readonly nodeKind: string;
+    readonly description: string;
+    readonly dependsOn: readonly string[];
+}
+export interface TasksOutput {
+    readonly orderedTasks: readonly OrderedTask[];
+}
+export interface OrderedTask {
+    readonly taskId: string;
+    readonly order: number;
+    readonly nodeId: string;
+    readonly action: string;
+    readonly module: string;
+    readonly blocked: boolean;
+    readonly blockedBy: readonly string[];
+}
+export interface AnalyzeOutput {
+    readonly analyses: readonly TaskAnalysis[];
+}
+export interface TaskAnalysis {
+    readonly taskId: string;
+    readonly nodeId: string;
+    readonly riskLevel: 'low' | 'medium' | 'high';
+    readonly riskFactors: readonly string[];
+    readonly dependencyCount: number;
+    readonly dependentCount: number;
+}
+export interface ImplementOutput {
+    readonly instructions: readonly ImplementInstruction[];
+}
+export interface ImplementInstruction {
+    readonly taskId: string;
+    readonly nodeId: string;
+    readonly module: string;
+    readonly action: string;
+    readonly nodeKind: string;
+    readonly context: string;
+    readonly relatedEdges: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workflow/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,eAAO,MAAM,WAAW,0EAOd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAMrD,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAOD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAED,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,cAAc,GACd,mBAAmB,GACnB,cAAc,GACd,uBAAuB,GACvB,eAAe,GACf,gBAAgB,CAAC;AAOrB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAMD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAMD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C"}

package/dist/workflow/types.js

@@ -0,0 +1,18 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Workflow Phase Types
+// ---------------------------------------------------------------------------
+// Each workflow phase produces a deterministic, structured output from the
+// Product Graph and IncrementalSpec. External agents consume these outputs —
+// the compiler itself performs no AI or generative work.
+// ---------------------------------------------------------------------------
+// Phase identifiers
+// ---------------------------------------------------------------------------
+export const PHASE_KINDS = [
+    'specify',
+    'clarify',
+    'plan',
+    'tasks',
+    'analyze',
+    'implement',
+];
+//# sourceMappingURL=types.js.map

package/dist/workflow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflow/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAC9E,2EAA2E;AAC3E,6EAA6E;AAC7E,yDAAyD;AAIzD,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,SAAS;IACT,MAAM;IACN,OAAO;IACP,SAAS;IACT,WAAW;CACH,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@prodara/compiler",
+  "version": "0.1.0",
+  "description": "The Prodara compiler — transforms .prd specification files into a validated Product Graph",
+  "author": "Prodara Contributors",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prodara-ai/prodara.git",
+    "directory": "packages/compiler"
+  },
+  "homepage": "https://github.com/prodara-ai/prodara/tree/main/packages/compiler#readme",
+  "bugs": {
+    "url": "https://github.com/prodara-ai/prodara/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "prodara": "dist/cli/main.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ test/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "prodara",
+    "compiler",
+    "specification",
+    "product-graph",
+    "declarative"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  }
+}