@prodara/compiler 0.1.0

package/dist/cli/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/cli/dashboard.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAOlD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACvD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,aAAa,CAuBvF;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAiC3D"}

package/dist/cli/dashboard.js

@@ -0,0 +1,73 @@
+// ---------------------------------------------------------------------------
+// Prodara CLI — Interactive Dashboard
+// ---------------------------------------------------------------------------
+// A simple text-based dashboard showing project overview, build status,
+// active proposals, and quick stats. Unlike a full TUI (ink), this renders
+// a snapshot and exits — no external dependencies required.
+import { listProposals } from '../proposal/proposal.js';
+// ---------------------------------------------------------------------------
+// Data collection
+// ---------------------------------------------------------------------------
+/**
+ * Collect dashboard data from a compile result and root directory.
+ */
+export function collectDashboardData(root, result) {
+    const graph = result.graph;
+    let nodeCount = 0;
+    if (graph) {
+        for (const mod of graph.modules) {
+            for (const [key, value] of Object.entries(mod)) {
+                if (key === 'id' || key === 'kind' || key === 'name' || key === 'imports')
+                    continue;
+                if (Array.isArray(value))
+                    nodeCount += value.length;
+            }
+        }
+    }
+    const proposals = listProposals(root);
+    return {
+        productName: graph?.product.name ?? 'unknown',
+        moduleCount: graph?.modules.length ?? 0,
+        nodeCount,
+        edgeCount: graph?.edges.length ?? 0,
+        lastBuildStatus: result.diagnostics.all.length > 0 ? 'error' : graph ? 'success' : 'none',
+        diagnosticCount: result.diagnostics.all.length,
+        activeProposals: proposals.length,
+    };
+}
+// ---------------------------------------------------------------------------
+// Rendering
+// ---------------------------------------------------------------------------
+/**
+ * Render dashboard data as a formatted text panel.
+ */
+export function formatDashboard(data) {
+    const lines = [];
+    const bar = '━'.repeat(52);
+    lines.push(`┏${bar}┓`);
+    lines.push(`┃  Prodara Dashboard${' '.repeat(33)}┃`);
+    lines.push(`┣${bar}┫`);
+    lines.push(`┃  Product: ${data.productName.padEnd(40)}┃`);
+    lines.push(`┃  Modules: ${String(data.moduleCount).padEnd(40)}┃`);
+    lines.push(`┃  Nodes:   ${String(data.nodeCount).padEnd(40)}┃`);
+    lines.push(`┃  Edges:   ${String(data.edgeCount).padEnd(40)}┃`);
+    lines.push(`┣${bar}┫`);
+    const statusIcon = data.lastBuildStatus === 'success' ? '✓'
+        /* v8 ignore next -- error status icon */
+        : data.lastBuildStatus === 'error' ? '✗' : '—';
+    const statusText = `${statusIcon} Build: ${data.lastBuildStatus}`;
+    lines.push(`┃  ${statusText.padEnd(49)}┃`);
+    if (data.diagnosticCount > 0) {
+        lines.push(`┃  Diagnostics: ${String(data.diagnosticCount).padEnd(36)}┃`);
+    }
+    lines.push(`┃  Active proposals: ${String(data.activeProposals).padEnd(31)}┃`);
+    lines.push(`┣${bar}┫`);
+    lines.push(`┃  Quick Commands:${' '.repeat(34)}┃`);
+    lines.push(`┃    prodara build      — full build${' '.repeat(16)}┃`);
+    lines.push(`┃    prodara validate   — check specs${' '.repeat(15)}┃`);
+    lines.push(`┃    prodara drift      — detect drift${' '.repeat(14)}┃`);
+    lines.push(`┃    prodara changes    — list proposals${' '.repeat(12)}┃`);
+    lines.push(`┗${bar}┛`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/cli/dashboard.js.map

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

package/dist/cli/explain.d.ts

@@ -0,0 +1,23 @@
+import type { ProductGraph, GraphEdge } from '../graph/graph-types.js';
+import { collectAllNodeIds } from '../graph/graph-types.js';
+export interface NodeExplanation {
+    readonly id: string;
+    readonly kind: string;
+    readonly name: string;
+    readonly module: string | null;
+    readonly properties: Record<string, unknown>;
+    readonly incomingEdges: readonly GraphEdge[];
+    readonly outgoingEdges: readonly GraphEdge[];
+}
+export { collectAllNodeIds };
+export declare function explainNode(graph: ProductGraph, nodeId: string): NodeExplanation | null;
+export declare function formatExplanation(explanation: NodeExplanation): string;
+export interface DiagnosticCodeInfo {
+    readonly code: string;
+    readonly title: string;
+    readonly phase: string;
+    readonly severity: string;
+    readonly description: string;
+}
+export declare function getDiagnosticInfo(code: string): DiagnosticCodeInfo | null;
+//# sourceMappingURL=explain.d.ts.map

package/dist/cli/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/cli/explain.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAM5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,SAAS,SAAS,EAAE,CAAC;CAC9C;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAoDvF;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAiDtE;AAMD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AA0CD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAGzE"}

package/dist/cli/explain.js

@@ -0,0 +1,144 @@
+// ---------------------------------------------------------------------------
+// Prodara CLI — Explain & Why Helpers
+// ---------------------------------------------------------------------------
+// Utilities for the `explain` and `why` debugging CLI commands.
+import { collectAllNodeIds } from '../graph/graph-types.js';
+export { collectAllNodeIds };
+export function explainNode(graph, nodeId) {
+    // Check product node
+    if (nodeId === 'product') {
+        return {
+            id: 'product',
+            kind: 'product',
+            name: graph.product.name,
+            module: null,
+            properties: { ...graph.product },
+            incomingEdges: graph.edges.filter(e => e.to === 'product'),
+            outgoingEdges: graph.edges.filter(e => e.from === 'product'),
+        };
+    }
+    // Search modules
+    for (const mod of graph.modules) {
+        if (mod.id === nodeId) {
+            return {
+                id: mod.id,
+                kind: 'module',
+                name: mod.name,
+                module: null,
+                properties: { name: mod.name, imports: mod.imports },
+                incomingEdges: graph.edges.filter(e => e.to === mod.id),
+                outgoingEdges: graph.edges.filter(e => e.from === mod.id),
+            };
+        }
+        // Search nodes inside module
+        for (const [category, value] of Object.entries(mod)) {
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    if (typeof item === 'object' && item !== null && 'id' in item) {
+                        const node = item;
+                        if (node.id === nodeId) {
+                            return {
+                                id: node.id,
+                                kind: node.kind,
+                                name: node.name,
+                                module: mod.name,
+                                properties: { ...node },
+                                incomingEdges: graph.edges.filter(e => e.to === node.id),
+                                outgoingEdges: graph.edges.filter(e => e.from === node.id),
+                            };
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}
+export function formatExplanation(explanation) {
+    const lines = [];
+    lines.push(`Node: ${explanation.id}`);
+    lines.push(`  Kind: ${explanation.kind}`);
+    lines.push(`  Name: ${explanation.name}`);
+    if (explanation.module) {
+        lines.push(`  Module: ${explanation.module}`);
+    }
+    // Show relevant properties (skip id, kind, name which are already shown)
+    const skipKeys = new Set(['id', 'kind', 'name']);
+    for (const [key, value] of Object.entries(explanation.properties)) {
+        if (skipKeys.has(key))
+            continue;
+        if (value === null || value === undefined)
+            continue;
+        if (Array.isArray(value) && value.length === 0)
+            continue;
+        if (Array.isArray(value)) {
+            if (value.length > 0 && typeof value[0] === 'object') {
+                lines.push(`  ${key}:`);
+                for (const item of value) {
+                    /* v8 ignore next -- items always have name or id */
+                    const itemName = item['name'] ?? item['id'] ?? JSON.stringify(item);
+                    lines.push(`    - ${itemName}`);
+                }
+            }
+            else {
+                lines.push(`  ${key}: ${value.join(', ')}`);
+            }
+        }
+        else if (typeof value === 'object') {
+            lines.push(`  ${key}: ${JSON.stringify(value)}`);
+        }
+        else {
+            lines.push(`  ${key}: ${value}`);
+        }
+    }
+    if (explanation.incomingEdges.length > 0) {
+        lines.push(`  Incoming edges:`);
+        for (const e of explanation.incomingEdges) {
+            lines.push(`    ${e.from} --[${e.kind}]--> ${e.to}`);
+        }
+    }
+    if (explanation.outgoingEdges.length > 0) {
+        lines.push(`  Outgoing edges:`);
+        for (const e of explanation.outgoingEdges) {
+            lines.push(`    ${e.from} --[${e.kind}]--> ${e.to}`);
+        }
+    }
+    return lines.join('\n');
+}
+const DIAGNOSTIC_CATALOG = [
+    // Lexer
+    { code: 'PRD0001', title: 'Unexpected character', phase: 'lexer', severity: 'error', description: 'The lexer encountered a character that is not valid in any token position.' },
+    { code: 'PRD0002', title: 'Unterminated string literal', phase: 'lexer', severity: 'error', description: 'A string literal was opened with a quote but never closed.' },
+    { code: 'PRD0010', title: 'No .prd files found', phase: 'discovery', severity: 'error', description: 'No .prd specification files were found in the given directory.' },
+    { code: 'PRD0011', title: 'Cannot read file', phase: 'discovery', severity: 'error', description: 'A .prd file was discovered but could not be read from disk.' },
+    // Parser
+    { code: 'PRD0100', title: 'Syntax error', phase: 'parser', severity: 'error', description: 'The parser expected a different token at this position. Check for missing braces, keywords, or punctuation.' },
+    // Binder
+    { code: 'PRD0200', title: 'Duplicate product declaration', phase: 'binder', severity: 'error', description: 'Multiple product declarations found. Only one product block is allowed per project.' },
+    { code: 'PRD0201', title: 'Duplicate module declaration', phase: 'binder', severity: 'error', description: 'A module with this name is already declared. Module names must be unique.' },
+    { code: 'PRD0202', title: 'Duplicate symbol in module', phase: 'binder', severity: 'error', description: 'A symbol (entity, workflow, enum, etc.) with this name already exists in the same module.' },
+    { code: 'PRD0203', title: 'Import resolution failure', phase: 'binder', severity: 'error', description: 'An imported symbol could not be resolved. Check that the source module exists and exports the symbol.' },
+    // Type checker
+    { code: 'PRD0300', title: 'Type mismatch', phase: 'checker', severity: 'error', description: 'A type reference does not match the expected type at this position.' },
+    { code: 'PRD0301', title: 'Unknown type reference', phase: 'checker', severity: 'error', description: 'A type reference could not be resolved. The referenced entity, enum, or type does not exist.' },
+    { code: 'PRD0302', title: 'Invalid type usage', phase: 'checker', severity: 'error', description: 'A type is used in a position where it is not valid (e.g., using an enum where an entity is expected).' },
+    // Validator
+    { code: 'PRD0400', title: 'Validation error', phase: 'validator', severity: 'error', description: 'A general validation rule was violated. Check the specific message for details.' },
+    { code: 'PRD0401', title: 'Missing required field', phase: 'validator', severity: 'error', description: 'A required field is missing from the declaration.' },
+    { code: 'PRD0402', title: 'Invalid value', phase: 'validator', severity: 'error', description: 'A field value does not meet validation constraints.' },
+    // Graph validator
+    { code: 'PRD0500', title: 'Graph integrity error', phase: 'graph', severity: 'error', description: 'The product graph has an integrity issue (e.g., orphan node, missing edge target).' },
+    { code: 'PRD0501', title: 'Orphan node', phase: 'graph', severity: 'warning', description: 'A node in the graph is not connected to any other node.' },
+    { code: 'PRD0502', title: 'Dangling edge', phase: 'graph', severity: 'error', description: 'An edge references a node that does not exist in the graph.' },
+    { code: 'PRD0503', title: 'Cycle detected', phase: 'graph', severity: 'warning', description: 'A dependency cycle was detected in the graph.' },
+    // Registry
+    { code: 'PRD0601', title: 'Constitution resolution error', phase: 'registry', severity: 'error', description: 'A referenced constitution package could not be resolved.' },
+    // Testing
+    { code: 'PRD0800', title: 'Test target not found', phase: 'testing', severity: 'error', description: 'A test references a node that does not exist in the compiled graph.' },
+    { code: 'PRD0801', title: 'Test assertion failed', phase: 'testing', severity: 'error', description: 'A test assertion did not pass. Review the specific failure message.' },
+];
+export function getDiagnosticInfo(code) {
+    const normalized = code.toUpperCase();
+    return DIAGNOSTIC_CATALOG.find(d => d.code === normalized) ?? null;
+}
+//# sourceMappingURL=explain.js.map

package/dist/cli/explain.js.map

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

package/dist/cli/git.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Check if the working directory is inside a git repository.
+ */
+export declare function isGitRepo(cwd: string): boolean;
+/**
+ * Check if there are uncommitted changes in the working tree.
+ */
+export declare function hasChanges(cwd: string): boolean;
+/**
+ * Stage all changes and create a conventional commit.
+ * Returns the commit hash on success, or null if nothing to commit.
+ */
+export declare function autoCommit(cwd: string, productName: string, changeCount: number): string | null;
+//# sourceMappingURL=git.d.ts.map

package/dist/cli/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/cli/git.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW/F"}

package/dist/cli/git.js

@@ -0,0 +1,44 @@
+// ---------------------------------------------------------------------------
+// Prodara CLI — Git Helpers (Auto-Commit)
+// ---------------------------------------------------------------------------
+import { execSync } from 'node:child_process';
+/**
+ * Check if the working directory is inside a git repository.
+ */
+export function isGitRepo(cwd) {
+    try {
+        execSync('git rev-parse --is-inside-work-tree', { cwd, stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if there are uncommitted changes in the working tree.
+ */
+export function hasChanges(cwd) {
+    try {
+        const status = execSync('git status --porcelain', { cwd, stdio: 'pipe', encoding: 'utf-8' });
+        return status.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Stage all changes and create a conventional commit.
+ * Returns the commit hash on success, or null if nothing to commit.
+ */
+export function autoCommit(cwd, productName, changeCount) {
+    if (!isGitRepo(cwd))
+        return null;
+    if (!hasChanges(cwd))
+        return null;
+    const message = `chore(prodara): build ${productName} [${changeCount} change${changeCount !== 1 ? 's' : ''}]`;
+    execSync('git add .', { cwd, stdio: 'pipe' });
+    execSync(`git commit -m ${JSON.stringify(message)}`, { cwd, stdio: 'pipe' });
+    const hash = execSync('git rev-parse --short HEAD', { cwd, stdio: 'pipe', encoding: 'utf-8' }).trim();
+    return hash;
+}
+//# sourceMappingURL=git.js.map

package/dist/cli/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/cli/git.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,QAAQ,CAAC,qCAAqC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7F,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,WAAmB,EAAE,WAAmB;IAC9E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,OAAO,GAAG,yBAAyB,WAAW,KAAK,WAAW,UAAU,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IAE9G,QAAQ,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAE7E,MAAM,IAAI,GAAG,QAAQ,CAAC,4BAA4B,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtG,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/lifecycle.d.ts

@@ -0,0 +1,28 @@
+export type ShutdownCallback = () => void;
+/**
+ * Register signal handlers for graceful shutdown.
+ * Call once at CLI startup. Safe to call multiple times (idempotent).
+ */
+export declare function registerShutdownHandlers(): void;
+/**
+ * Set the active build root so cleanup knows which directory to clean.
+ */
+export declare function setActiveRoot(root: string): void;
+/**
+ * Clear the active root after a successful build completes.
+ */
+export declare function clearActiveRoot(): void;
+/**
+ * Register an additional cleanup callback to run during shutdown.
+ */
+export declare function onShutdown(callback: ShutdownCallback): void;
+/**
+ * Run all cleanup actions. Called by signal handlers.
+ * Also exported for testing.
+ */
+export declare function performCleanup(): void;
+/**
+ * Reset all state. Used in tests only.
+ */
+export declare function resetLifecycle(): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/cli/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/cli/lifecycle.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC;AAM1C;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAmB/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CASrC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAIrC"}

package/dist/cli/lifecycle.js

@@ -0,0 +1,82 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Process Lifecycle & Signal Handling
+// ---------------------------------------------------------------------------
+// Registers signal handlers for graceful shutdown. On SIGINT/SIGTERM,
+// releases the build lock and cleans up temp files before exiting.
+import { releaseLock, cleanupTempFiles } from '../build-state/build-state.js';
+let activeRoot = null;
+let extraCallbacks = [];
+let registered = false;
+/**
+ * Register signal handlers for graceful shutdown.
+ * Call once at CLI startup. Safe to call multiple times (idempotent).
+ */
+export function registerShutdownHandlers() {
+    if (registered)
+        return;
+    registered = true;
+    /* v8 ignore start -- signal handlers call process.exit; tested via integration */
+    const handler = (signal) => {
+        performCleanup();
+        const code = signal === 'SIGINT' ? 130 : 143;
+        process.exit(code);
+    };
+    process.on('SIGINT', () => handler('SIGINT'));
+    process.on('SIGTERM', () => handler('SIGTERM'));
+    process.on('uncaughtException', (err) => {
+        process.stderr.write(`Prodara: uncaught exception — ${err.message}\n`);
+        performCleanup();
+        process.exit(1);
+    });
+    /* v8 ignore stop */
+}
+/**
+ * Set the active build root so cleanup knows which directory to clean.
+ */
+export function setActiveRoot(root) {
+    activeRoot = root;
+}
+/**
+ * Clear the active root after a successful build completes.
+ */
+export function clearActiveRoot() {
+    activeRoot = null;
+}
+/**
+ * Register an additional cleanup callback to run during shutdown.
+ */
+export function onShutdown(callback) {
+    extraCallbacks.push(callback);
+}
+/**
+ * Run all cleanup actions. Called by signal handlers.
+ * Also exported for testing.
+ */
+export function performCleanup() {
+    if (activeRoot) {
+        /* v8 ignore next 2 -- releaseLock/cleanupTempFiles handle errors internally */
+        try {
+            releaseLock(activeRoot);
+        }
+        catch { /* best-effort */ }
+        try {
+            cleanupTempFiles(activeRoot);
+        }
+        catch { /* best-effort */ }
+    }
+    for (const cb of extraCallbacks) {
+        try {
+            cb();
+        }
+        catch { /* best-effort */ }
+    }
+}
+/**
+ * Reset all state. Used in tests only.
+ */
+export function resetLifecycle() {
+    activeRoot = null;
+    extraCallbacks = [];
+    registered = false;
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/cli/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/cli/lifecycle.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAC9E,sEAAsE;AACtE,mEAAmE;AAEnE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAI9E,IAAI,UAAU,GAAkB,IAAI,CAAC;AACrC,IAAI,cAAc,GAAuB,EAAE,CAAC;AAC5C,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAElB,kFAAkF;IAClF,MAAM,OAAO,GAAG,CAAC,MAAc,EAAQ,EAAE;QACvC,cAAc,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QACvE,cAAc,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,oBAAoB;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAA0B;IACnD,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,UAAU,EAAE,CAAC;QACf,+EAA+E;QAC/E,IAAI,CAAC;YAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC5D,IAAI,CAAC;YAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACnE,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;QAChC,IAAI,CAAC;YAAC,EAAE,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,UAAU,GAAG,IAAI,CAAC;IAClB,cAAc,GAAG,EAAE,CAAC;IACpB,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import type { ResolvedConfig } from '../config/config.js';
+export declare function createProgram(): Command;
+export declare function outputDiagnostics(bag: import('../diagnostics/diagnostic.js').DiagnosticBag, format: string): void;
+export declare function applyCliOverrides(config: ResolvedConfig, opts: {
+    maxReviewLoops?: number;
+    autoClarify?: boolean;
+}): ResolvedConfig;
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAyB1D,wBAAgB,aAAa,IAAI,OAAO,CAokCvC;AAWD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,8BAA8B,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASjH;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD,cAAc,CAkBhB"}