@rengler33/prov 0.1.1

package/dist/commands/impact.js

@@ -0,0 +1,319 @@
+/**
+ * prov impact and stale commands implementation.
+ *
+ * Commands for analyzing impact and staleness:
+ * - impact: Analyze impact of spec/constraint changes
+ * - stale: Find stale artifacts needing regeneration
+ *
+ * @see req:cli:impact
+ * @see req:cli:stale
+ */
+import { isInitialized, loadGraph } from '../storage.js';
+import { detectStaleness, formatStalenessReason, } from '../staleness.js';
+import { output, error, resolveFormat } from '../output.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Get description for a node based on its type.
+ */
+function getNodeDescription(node) {
+    const data = node.data;
+    if (data['title'] !== undefined && typeof data['title'] === 'string') {
+        return data['title'];
+    }
+    if (data['description'] !== undefined && typeof data['description'] === 'string') {
+        const desc = data['description'];
+        return desc.length > 60 ? desc.slice(0, 57) + '...' : desc;
+    }
+    if (data['action'] !== undefined && typeof data['action'] === 'string') {
+        return data['action'];
+    }
+    if (data['artifact'] !== undefined) {
+        const artifact = data['artifact'];
+        return artifact.path ?? '';
+    }
+    return '';
+}
+// ============================================================================
+// impact Command
+// ============================================================================
+/**
+ * Execute the impact command.
+ *
+ * Analyzes the impact of changes to a spec or constraint by finding all
+ * downstream dependent nodes.
+ *
+ * @see req:cli:impact
+ */
+export function runImpact(globalOpts, specId, _options) {
+    const projectRoot = globalOpts.dir ?? process.cwd();
+    const fmt = resolveFormat({ format: globalOpts.format });
+    // Check if prov is initialized
+    if (!isInitialized(projectRoot)) {
+        const result = {
+            success: false,
+            error: 'prov is not initialized. Run "prov init" first.',
+        };
+        if (fmt === 'json') {
+            output(result, { format: 'json' });
+        }
+        else if (fmt === 'yaml') {
+            output(result, { format: 'yaml' });
+        }
+        else {
+            error(result.error);
+        }
+        process.exit(1);
+    }
+    // Load graph
+    const loadResult = loadGraph(projectRoot);
+    if (!loadResult.success || loadResult.data === undefined) {
+        const result = {
+            success: false,
+            error: loadResult.error ?? 'Failed to load graph',
+        };
+        if (fmt === 'json') {
+            output(result, { format: 'json' });
+        }
+        else if (fmt === 'yaml') {
+            output(result, { format: 'yaml' });
+        }
+        else {
+            error(result.error);
+        }
+        process.exit(1);
+    }
+    const graph = loadResult.data;
+    // Check if the source node exists
+    const sourceNode = graph.getNode(specId);
+    if (sourceNode === undefined) {
+        const result = {
+            success: false,
+            error: `Entity not found: ${specId}`,
+        };
+        if (fmt === 'json') {
+            output(result, { format: 'json' });
+        }
+        else if (fmt === 'yaml') {
+            output(result, { format: 'yaml' });
+        }
+        else {
+            error(result.error);
+        }
+        process.exit(1);
+    }
+    // Build impact entries with depth info using BFS
+    const impacted = [];
+    const visited = new Set();
+    const queue = [{ id: specId, depth: 0 }];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (current === undefined)
+            break;
+        const { id, depth } = current;
+        if (visited.has(id))
+            continue;
+        visited.add(id);
+        // Skip the source node itself
+        if (id !== specId) {
+            const node = graph.getNode(id);
+            if (node !== undefined) {
+                impacted.push({
+                    id,
+                    type: node.type,
+                    description: getNodeDescription(node),
+                    depth,
+                });
+            }
+        }
+        // Get outgoing edges for next level
+        const outgoing = graph.getOutgoingEdges(id);
+        for (const edge of outgoing) {
+            if (!visited.has(edge.to)) {
+                queue.push({ id: edge.to, depth: depth + 1 });
+            }
+        }
+    }
+    // Sort by depth, then by ID
+    impacted.sort((a, b) => {
+        if (a.depth !== b.depth)
+            return a.depth - b.depth;
+        return a.id.localeCompare(b.id);
+    });
+    const result = {
+        success: true,
+        sourceId: specId,
+        impactedCount: impacted.length,
+        impacted,
+    };
+    if (fmt === 'json') {
+        output(result, { format: 'json' });
+    }
+    else if (fmt === 'yaml') {
+        output(result, { format: 'yaml' });
+    }
+    else {
+        process.stdout.write(`\nImpact Analysis for ${specId}\n`);
+        process.stdout.write('════════════════════════════════════════\n\n');
+        if (impacted.length === 0) {
+            process.stdout.write('No downstream dependencies found.\n');
+        }
+        else {
+            process.stdout.write(`${impacted.length} entities would be affected by changes:\n\n`);
+            // Group by type for cleaner display
+            const byType = new Map();
+            for (const entry of impacted) {
+                const entries = byType.get(entry.type) ?? [];
+                entries.push(entry);
+                byType.set(entry.type, entries);
+            }
+            for (const [type, entries] of byType) {
+                process.stdout.write(`${type.toUpperCase()} (${entries.length}):\n`);
+                for (const entry of entries) {
+                    const indent = '  '.repeat(entry.depth);
+                    process.stdout.write(`${indent}• ${entry.id}\n`);
+                    if (entry.description) {
+                        process.stdout.write(`${indent}  ${entry.description}\n`);
+                    }
+                }
+                process.stdout.write('\n');
+            }
+        }
+    }
+}
+// ============================================================================
+// stale Command
+// ============================================================================
+/**
+ * Execute the stale command.
+ *
+ * Finds all stale artifacts needing regeneration.
+ *
+ * @see req:cli:stale
+ */
+export function runStale(globalOpts, _options) {
+    const projectRoot = globalOpts.dir ?? process.cwd();
+    const fmt = resolveFormat({ format: globalOpts.format });
+    // Check if prov is initialized
+    if (!isInitialized(projectRoot)) {
+        const result = {
+            success: false,
+            error: 'prov is not initialized. Run "prov init" first.',
+        };
+        if (fmt === 'json') {
+            output(result, { format: 'json' });
+        }
+        else if (fmt === 'yaml') {
+            output(result, { format: 'yaml' });
+        }
+        else {
+            error(result.error);
+        }
+        process.exit(1);
+    }
+    // Load graph
+    const loadResult = loadGraph(projectRoot);
+    if (!loadResult.success || loadResult.data === undefined) {
+        const result = {
+            success: false,
+            error: loadResult.error ?? 'Failed to load graph',
+        };
+        if (fmt === 'json') {
+            output(result, { format: 'json' });
+        }
+        else if (fmt === 'yaml') {
+            output(result, { format: 'yaml' });
+        }
+        else {
+            error(result.error);
+        }
+        process.exit(1);
+    }
+    const graph = loadResult.data;
+    // Detect staleness
+    const stalenessResult = detectStaleness(graph, { projectRoot });
+    // Build stale entries
+    const directlyStale = [];
+    const transitivelyStale = [];
+    for (const id of stalenessResult.directlyStale) {
+        const node = graph.getNode(id);
+        const info = stalenessResult.nodes.get(id);
+        if (node !== undefined && info !== undefined) {
+            directlyStale.push({
+                id,
+                type: node.type,
+                description: getNodeDescription(node),
+                reasons: info.reasons.map(formatStalenessReason),
+                isTransitive: false,
+            });
+        }
+    }
+    for (const id of stalenessResult.transitivelyStale) {
+        const node = graph.getNode(id);
+        const info = stalenessResult.nodes.get(id);
+        if (node !== undefined && info !== undefined) {
+            transitivelyStale.push({
+                id,
+                type: node.type,
+                description: getNodeDescription(node),
+                reasons: info.reasons.map(formatStalenessReason),
+                isTransitive: true,
+            });
+        }
+    }
+    const result = {
+        success: true,
+        totalNodes: stalenessResult.totalNodes,
+        staleCount: stalenessResult.staleCount,
+        directlyStale,
+        transitivelyStale,
+    };
+    if (fmt === 'json') {
+        output(result, { format: 'json' });
+    }
+    else if (fmt === 'yaml') {
+        output(result, { format: 'yaml' });
+    }
+    else {
+        process.stdout.write('\nStaleness Report\n');
+        process.stdout.write('════════════════════════════════════════\n\n');
+        process.stdout.write(`Checked ${stalenessResult.totalNodes} nodes, found ${stalenessResult.staleCount} stale\n\n`);
+        if (directlyStale.length > 0) {
+            process.stdout.write(`Directly Stale (${directlyStale.length}):\n`);
+            process.stdout.write('─'.repeat(40) + '\n');
+            for (const entry of directlyStale) {
+                const icon = entry.type === 'plan' ? '📝' : '📄';
+                process.stdout.write(`${icon} ${entry.id}\n`);
+                if (entry.description) {
+                    process.stdout.write(`   ${entry.description}\n`);
+                }
+                for (const reason of entry.reasons) {
+                    process.stdout.write(`   ⚠ ${reason}\n`);
+                }
+            }
+            process.stdout.write('\n');
+        }
+        if (transitivelyStale.length > 0) {
+            process.stdout.write(`Transitively Stale (${transitivelyStale.length}):\n`);
+            process.stdout.write('─'.repeat(40) + '\n');
+            for (const entry of transitivelyStale) {
+                process.stdout.write(`   ${entry.id}\n`);
+                if (entry.description) {
+                    process.stdout.write(`      ${entry.description}\n`);
+                }
+                for (const reason of entry.reasons) {
+                    process.stdout.write(`      → ${reason}\n`);
+                }
+            }
+            process.stdout.write('\n');
+        }
+        if (stalenessResult.staleCount === 0) {
+            process.stdout.write('All artifacts are current. No regeneration needed.\n\n');
+        }
+        else {
+            process.stdout.write(`\nAction required: ${stalenessResult.staleCount} entities need attention.\n\n`);
+        }
+    }
+}
+//# sourceMappingURL=impact.js.map

package/dist/commands/impact.js.map

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

package/dist/commands/impact.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=impact.test.d.ts.map

package/dist/commands/impact.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.test.d.ts","sourceRoot":"","sources":["../../src/commands/impact.test.ts"],"names":[],"mappings":""}

package/dist/commands/impact.test.js

@@ -0,0 +1,234 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdirSync, rmSync, existsSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { runImpact, runStale } from './impact.js';
+import { initialize, saveGraph } from '../storage.js';
+import { IntentGraph, addSpecToGraph, addPlanToGraph, addTraceToGraph } from '../graph.js';
+describe('impact commands', () => {
+    let testDir;
+    let consoleOutput;
+    let processExitCode;
+    beforeEach(() => {
+        // Create a temporary test directory
+        testDir = join(tmpdir(), `prov-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        mkdirSync(testDir, { recursive: true });
+        // Capture stdout
+        consoleOutput = [];
+        vi.spyOn(process.stdout, 'write').mockImplementation((str) => {
+            consoleOutput.push(String(str));
+            return true;
+        });
+        // Capture process.exit
+        processExitCode = undefined;
+        vi.spyOn(process, 'exit').mockImplementation((code) => {
+            processExitCode = code;
+            throw new Error(`process.exit(${code})`);
+        });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        if (existsSync(testDir)) {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+    });
+    describe('impact', () => {
+        it('fails if prov is not initialized', () => {
+            expect(() => {
+                runImpact({ dir: testDir }, 'spec:test:v1', {});
+            }).toThrow('process.exit(1)');
+            expect(processExitCode).toBe(1);
+        });
+        it('fails if entity not found', () => {
+            initialize(testDir);
+            expect(() => {
+                runImpact({ dir: testDir }, 'spec:nonexistent:v1', {});
+            }).toThrow('process.exit(1)');
+            expect(processExitCode).toBe(1);
+        });
+        it('shows no dependencies for leaf node', () => {
+            initialize(testDir);
+            const graph = new IntentGraph();
+            const spec = {
+                id: 'spec:test:v1',
+                version: '1.0.0',
+                title: 'Test Spec',
+                status: 'active',
+                intent: 'Testing',
+                requirements: [],
+            };
+            addSpecToGraph(graph, spec);
+            saveGraph(graph, testDir);
+            runImpact({ dir: testDir, format: 'json' }, 'spec:test:v1', {});
+            const output = consoleOutput.join('');
+            const json = JSON.parse(output);
+            expect(json.success).toBe(true);
+            expect(json.impactedCount).toBe(0);
+        });
+        it('shows downstream dependencies', () => {
+            initialize(testDir);
+            const graph = new IntentGraph();
+            const spec = {
+                id: 'spec:test:v1',
+                version: '1.0.0',
+                title: 'Test Spec',
+                status: 'active',
+                intent: 'Testing',
+                requirements: [
+                    { id: 'req:test:first', description: 'First requirement', acceptance: [] },
+                ],
+            };
+            addSpecToGraph(graph, spec);
+            saveGraph(graph, testDir);
+            runImpact({ dir: testDir, format: 'json' }, 'spec:test:v1', {});
+            const output = consoleOutput.join('');
+            const json = JSON.parse(output);
+            expect(json.success).toBe(true);
+            // Spec contains requirement, so it's a downstream dependency
+            expect(json.impactedCount).toBeGreaterThan(0);
+            expect(json.impacted.some((e) => e.id === 'req:test:first')).toBe(true);
+        });
+        it('shows impact chain through plan', () => {
+            initialize(testDir);
+            const graph = new IntentGraph();
+            const spec = {
+                id: 'spec:test:v1',
+                version: '1.0.0',
+                title: 'Test Spec',
+                status: 'active',
+                intent: 'Testing',
+                requirements: [
+                    { id: 'req:test:first', description: 'First requirement', acceptance: [] },
+                ],
+            };
+            addSpecToGraph(graph, spec);
+            const specHash = graph.getNode('spec:test:v1').hash;
+            const plan = {
+                id: 'plan:impl:v1',
+                version: '1.0.0',
+                title: 'Implementation Plan',
+                status: 'active',
+                sources: [{ id: 'spec:test:v1', hash: specHash }],
+                decisions: [],
+                steps: [
+                    {
+                        id: 'step:impl:1',
+                        number: 1,
+                        action: 'Implement requirement',
+                        tracesTo: ['req:test:first'],
+                    },
+                ],
+            };
+            addPlanToGraph(graph, plan);
+            saveGraph(graph, testDir);
+            runImpact({ dir: testDir, format: 'json' }, 'spec:test:v1', {});
+            const output = consoleOutput.join('');
+            const json = JSON.parse(output);
+            expect(json.success).toBe(true);
+            expect(json.impactedCount).toBeGreaterThan(0);
+        });
+    });
+    describe('stale', () => {
+        it('fails if prov is not initialized', () => {
+            expect(() => {
+                runStale({ dir: testDir }, {});
+            }).toThrow('process.exit(1)');
+            expect(processExitCode).toBe(1);
+        });
+        it('reports no stale when graph is empty', () => {
+            initialize(testDir);
+            runStale({ dir: testDir, format: 'json' }, {});
+            const output = consoleOutput.join('');
+            const json = JSON.parse(output);
+            expect(json.success).toBe(true);
+            expect(json.staleCount).toBe(0);
+        });
+        it('reports no stale when all plans are current', () => {
+            initialize(testDir);
+            const graph = new IntentGraph();
+            const spec = {
+                id: 'spec:test:v1',
+                version: '1.0.0',
+                title: 'Test Spec',
+                status: 'active',
+                intent: 'Testing',
+                requirements: [],
+            };
+            addSpecToGraph(graph, spec);
+            const specHash = graph.getNode('spec:test:v1').hash;
+            const plan = {
+                id: 'plan:impl:v1',
+                version: '1.0.0',
+                title: 'Implementation Plan',
+                status: 'active',
+                sources: [{ id: 'spec:test:v1', hash: specHash }],
+                decisions: [],
+                steps: [],
+            };
+            addPlanToGraph(graph, plan);
+            saveGraph(graph, testDir);
+            runStale({ dir: testDir, format: 'json' }, {});
+            const output = consoleOutput.join('');
+            const json = JSON.parse(output);
+            expect(json.success).toBe(true);
+            expect(json.staleCount).toBe(0);
+        });
+        it('detects stale plans', () => {
+            initialize(testDir);
+            const graph = new IntentGraph();
+            const spec = {
+                id: 'spec:test:v1',
+                version: '1.0.0',
+                title: 'Test Spec',
+                status: 'active',
+                intent: 'Testing',
+                requirements: [],
+            };
+            addSpecToGraph(graph, spec);
+            // Plan with outdated source hash
+            const plan = {
+                id: 'plan:impl:v1',
+                version: '1.0.0',
+                title: 'Implementation Plan',
+                status: 'active',
+                sources: [{ id: 'spec:test:v1', hash: 'sha256:outdatedhash' }],
+                decisions: [],
+                steps: [],
+            };
+            addPlanToGraph(graph, plan);
+            saveGraph(graph, testDir);
+            runStale({ dir: testDir, format: 'json' }, {});
+            const output = consoleOutput.join('');
+            const json = JSON.parse(output);
+            expect(json.success).toBe(true);
+            expect(json.staleCount).toBeGreaterThan(0);
+            expect(json.directlyStale.some((e) => e.id === 'plan:impl:v1')).toBe(true);
+        });
+        it('detects stale traces', () => {
+            initialize(testDir);
+            // Create a test file
+            const testFile = join(testDir, 'test-artifact.ts');
+            writeFileSync(testFile, 'const x = 1;');
+            const graph = new IntentGraph();
+            // Add a step first
+            const step = { id: 'step:test:1', number: 1, action: 'Test', tracesTo: [] };
+            graph.addNode('step:test:1', 'step', step);
+            // Create trace with outdated hash
+            const trace = {
+                id: 'trace:abc123',
+                artifact: { path: 'test-artifact.ts' },
+                step: 'step:test:1',
+                artifactHash: 'sha256:outdatedhash',
+                createdAt: new Date().toISOString(),
+            };
+            addTraceToGraph(graph, trace);
+            saveGraph(graph, testDir);
+            runStale({ dir: testDir, format: 'json' }, {});
+            const output = consoleOutput.join('');
+            const json = JSON.parse(output);
+            expect(json.success).toBe(true);
+            expect(json.staleCount).toBeGreaterThan(0);
+        });
+    });
+});
+//# sourceMappingURL=impact.test.js.map

package/dist/commands/impact.test.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,45 @@
+/**
+ * prov init command implementation.
+ *
+ * Initializes provenance tracking in a directory by creating the
+ * .prov/ directory structure.
+ *
+ * @see req:cli:init
+ */
+import { type GlobalOptions } from '../cli.js';
+/**
+ * Options for the init command.
+ */
+export interface InitOptions {
+    /** Force reinitialization even if already initialized */
+    force?: boolean;
+}
+/**
+ * Result of init command.
+ */
+export interface InitResult {
+    /** Whether initialization was successful */
+    success: boolean;
+    /** Path to the created .prov directory */
+    provDir: string;
+    /** Whether this was a fresh initialization or already existed */
+    alreadyInitialized: boolean;
+    /** Any warning messages */
+    warnings?: string[];
+}
+/**
+ * Execute the init command.
+ *
+ * Creates .prov/ directory structure:
+ * - .prov/
+ * - .prov/graph.json (empty graph)
+ * - .prov/mappings/
+ * - .prov/cache/
+ *
+ * Idempotent - safe to run multiple times.
+ * Does not overwrite existing data.
+ *
+ * @see req:cli:init
+ */
+export declare function runInit(globalOpts: GlobalOptions, options: InitOptions): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAU/C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CACrB,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,WAAW,GACnB,IAAI,CAmEN"}