@rengler33/prov 0.1.1

package/dist/commands/spec.test.js

@@ -0,0 +1,407 @@
+/**
+ * Tests for prov spec commands.
+ *
+ * @see req:cli:spec-add
+ * @see req:cli:spec-list
+ * @see req:cli:spec-validate
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { existsSync, rmSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { runSpecAdd, runSpecList, runSpecValidate } from './spec.js';
+import { runInit } from './init.js';
+import { PROV_DIR, GRAPH_FILE } from '../storage.js';
+// Sample valid spec YAML
+const VALID_SPEC = `id: spec:test-feature:v1
+version: 1.0.0
+title: Test Feature Specification
+status: draft
+
+intent: |
+  A test specification for unit testing.
+
+requirements:
+  - id: req:test-feature:init
+    description: Initialize the test feature
+    acceptance:
+      - Feature can be initialized
+      - Initialization is idempotent
+    depends_on: []
+
+  - id: req:test-feature:run
+    description: Run the test feature
+    acceptance:
+      - Feature can be executed
+    depends_on:
+      - req:test-feature:init
+`;
+// Sample spec with validation errors
+const INVALID_SPEC_NO_ID = `version: 1.0.0
+title: Missing ID Spec
+status: draft
+intent: A spec without an id field
+requirements: []
+`;
+const INVALID_SPEC_BAD_REQ_ID = `id: spec:bad-req:v1
+version: 1.0.0
+title: Bad Requirement ID
+status: draft
+intent: A spec with invalid requirement id format
+requirements:
+  - id: invalid-req-format
+    description: This has bad ID format
+    acceptance:
+      - Some acceptance criteria
+`;
+const VALID_SPEC_2 = `id: spec:another-feature:v1
+version: 1.0.0
+title: Another Feature Specification
+status: active
+
+intent: |
+  Another test specification.
+
+requirements:
+  - id: req:another-feature:setup
+    description: Setup the feature
+    acceptance:
+      - Feature is properly configured
+`;
+describe('spec add command', () => {
+    let testDir;
+    let mockStdout;
+    let mockStderr;
+    beforeEach(() => {
+        // Create a unique test directory
+        testDir = join(tmpdir(), `prov-spec-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        mkdirSync(testDir, { recursive: true });
+        mkdirSync(join(testDir, 'spec'), { recursive: true });
+        // Capture stdout/stderr
+        mockStdout = [];
+        mockStderr = [];
+        vi.spyOn(process.stdout, 'write').mockImplementation((msg) => {
+            mockStdout.push(String(msg));
+            return true;
+        });
+        vi.spyOn(process.stderr, 'write').mockImplementation((msg) => {
+            mockStderr.push(String(msg));
+            return true;
+        });
+        // Mock process.exit to throw instead of exiting
+        vi.spyOn(process, 'exit').mockImplementation((code) => {
+            throw new Error(`Process exited with code ${String(code)}`);
+        });
+        // Initialize prov
+        runInit({ dir: testDir }, {});
+        mockStdout = [];
+        mockStderr = [];
+    });
+    afterEach(() => {
+        // Clean up test directory
+        if (existsSync(testDir)) {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+        vi.restoreAllMocks();
+    });
+    describe('adding a valid spec', () => {
+        it('should add spec to graph', () => {
+            const specPath = join(testDir, 'spec', 'test.spec.yaml');
+            writeFileSync(specPath, VALID_SPEC);
+            const globalOpts = { dir: testDir, format: 'json' };
+            runSpecAdd(globalOpts, 'spec/test.spec.yaml', {});
+            const output = mockStdout.join('');
+            const result = JSON.parse(output);
+            expect(result.success).toBe(true);
+            expect(result.specId).toBe('spec:test-feature:v1');
+        });
+        it('should store spec and requirements in graph', () => {
+            const specPath = join(testDir, 'spec', 'test.spec.yaml');
+            writeFileSync(specPath, VALID_SPEC);
+            const globalOpts = { dir: testDir };
+            runSpecAdd(globalOpts, 'spec/test.spec.yaml', {});
+            // Verify graph contains spec and requirements
+            const graphPath = join(testDir, PROV_DIR, GRAPH_FILE);
+            const graph = JSON.parse(readFileSync(graphPath, 'utf8'));
+            expect(graph.nodes['spec:test-feature:v1']).toBeDefined();
+            expect(graph.nodes['req:test-feature:init']).toBeDefined();
+            expect(graph.nodes['req:test-feature:run']).toBeDefined();
+            // Verify edges exist
+            expect(graph.edges).toContainEqual({
+                from: 'spec:test-feature:v1',
+                to: 'req:test-feature:init',
+                type: 'contains',
+            });
+        });
+        it('should output JSON when format is json', () => {
+            const specPath = join(testDir, 'spec', 'test.spec.yaml');
+            writeFileSync(specPath, VALID_SPEC);
+            const globalOpts = { dir: testDir, format: 'json' };
+            runSpecAdd(globalOpts, 'spec/test.spec.yaml', {});
+            const output = mockStdout.join('');
+            const result = JSON.parse(output);
+            expect(result.success).toBe(true);
+            expect(result.specId).toBe('spec:test-feature:v1');
+            expect(result.requirementCount).toBe(2);
+            expect(result.hash).toMatch(/^sha256:/);
+        });
+        it('should be idempotent - adding same spec twice', () => {
+            const specPath = join(testDir, 'spec', 'test.spec.yaml');
+            writeFileSync(specPath, VALID_SPEC);
+            const globalOpts = { dir: testDir };
+            runSpecAdd(globalOpts, 'spec/test.spec.yaml', {});
+            mockStdout = [];
+            runSpecAdd(globalOpts, 'spec/test.spec.yaml', {});
+            const output = mockStdout.join('');
+            expect(output).toContain('unchanged');
+        });
+    });
+    describe('error handling', () => {
+        it('should fail if prov not initialized', () => {
+            // Use a directory without prov initialized
+            const uninitDir = join(testDir, 'uninit');
+            mkdirSync(uninitDir, { recursive: true });
+            mkdirSync(join(uninitDir, 'spec'), { recursive: true });
+            const specPath = join(uninitDir, 'spec', 'test.spec.yaml');
+            writeFileSync(specPath, VALID_SPEC);
+            const globalOpts = { dir: uninitDir, format: 'json' };
+            expect(() => {
+                runSpecAdd(globalOpts, 'spec/test.spec.yaml', {});
+            }).toThrow('Process exited with code 1');
+            const output = mockStdout.join('');
+            const result = JSON.parse(output);
+            expect(result.success).toBe(false);
+            expect(result.error).toContain('not initialized');
+        });
+        it('should fail if file not found', () => {
+            const globalOpts = { dir: testDir, format: 'json' };
+            expect(() => {
+                runSpecAdd(globalOpts, 'spec/nonexistent.yaml', {});
+            }).toThrow('Process exited with code 1');
+            const output = mockStdout.join('');
+            const result = JSON.parse(output);
+            expect(result.success).toBe(false);
+            expect(result.error).toContain('File not found');
+        });
+        it('should fail if spec has validation errors', () => {
+            const specPath = join(testDir, 'spec', 'invalid.spec.yaml');
+            writeFileSync(specPath, INVALID_SPEC_NO_ID);
+            const globalOpts = { dir: testDir, format: 'json' };
+            expect(() => {
+                runSpecAdd(globalOpts, 'spec/invalid.spec.yaml', {});
+            }).toThrow('Process exited with code 1');
+            const output = mockStdout.join('');
+            const result = JSON.parse(output);
+            expect(result.success).toBe(false);
+            expect(result.validationErrors).toContain('Missing required field: id');
+        });
+    });
+});
+describe('spec list command', () => {
+    let testDir;
+    let mockStdout;
+    let mockStderr;
+    beforeEach(() => {
+        testDir = join(tmpdir(), `prov-spec-list-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        mkdirSync(testDir, { recursive: true });
+        mkdirSync(join(testDir, 'spec'), { recursive: true });
+        mockStdout = [];
+        mockStderr = [];
+        vi.spyOn(process.stdout, 'write').mockImplementation((msg) => {
+            mockStdout.push(String(msg));
+            return true;
+        });
+        vi.spyOn(process.stderr, 'write').mockImplementation((msg) => {
+            mockStderr.push(String(msg));
+            return true;
+        });
+        vi.spyOn(process, 'exit').mockImplementation((code) => {
+            throw new Error(`Process exited with code ${String(code)}`);
+        });
+        // Initialize prov
+        runInit({ dir: testDir }, {});
+        mockStdout = [];
+        mockStderr = [];
+    });
+    afterEach(() => {
+        if (existsSync(testDir)) {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+        vi.restoreAllMocks();
+    });
+    it('should list no specs when none added', () => {
+        const globalOpts = { dir: testDir, format: 'json' };
+        runSpecList(globalOpts, {});
+        const output = mockStdout.join('');
+        const result = JSON.parse(output);
+        expect(result.specs).toHaveLength(0);
+    });
+    it('should list added specs in table format', () => {
+        // Add a spec first
+        const specPath = join(testDir, 'spec', 'test.spec.yaml');
+        writeFileSync(specPath, VALID_SPEC);
+        runSpecAdd({ dir: testDir }, 'spec/test.spec.yaml', {});
+        mockStdout = [];
+        const globalOpts = { dir: testDir };
+        runSpecList(globalOpts, {});
+        const output = mockStdout.join('');
+        expect(output).toContain('spec:test-feature:v1');
+        expect(output).toContain('Test Feature Specification');
+    });
+    it('should list multiple specs', () => {
+        // Add two specs
+        writeFileSync(join(testDir, 'spec', 'test1.spec.yaml'), VALID_SPEC);
+        writeFileSync(join(testDir, 'spec', 'test2.spec.yaml'), VALID_SPEC_2);
+        runSpecAdd({ dir: testDir }, 'spec/test1.spec.yaml', {});
+        runSpecAdd({ dir: testDir }, 'spec/test2.spec.yaml', {});
+        mockStdout = [];
+        const globalOpts = { dir: testDir, format: 'json' };
+        runSpecList(globalOpts, {});
+        const output = mockStdout.join('');
+        const result = JSON.parse(output);
+        expect(result.specs).toHaveLength(2);
+        const specIds = result.specs.map((s) => s.id);
+        expect(specIds).toContain('spec:test-feature:v1');
+        expect(specIds).toContain('spec:another-feature:v1');
+    });
+    it('should detect stale specs', () => {
+        const specPath = join(testDir, 'spec', 'test.spec.yaml');
+        writeFileSync(specPath, VALID_SPEC);
+        runSpecAdd({ dir: testDir }, 'spec/test.spec.yaml', {});
+        // Modify the spec file
+        const modifiedSpec = VALID_SPEC.replace('A test specification', 'A modified test specification');
+        writeFileSync(specPath, modifiedSpec);
+        mockStdout = [];
+        const globalOpts = { dir: testDir, format: 'json' };
+        runSpecList(globalOpts, {});
+        const output = mockStdout.join('');
+        const result = JSON.parse(output);
+        expect(result.specs[0].status).toBe('stale');
+    });
+    it('should detect missing spec files', () => {
+        const specPath = join(testDir, 'spec', 'test.spec.yaml');
+        writeFileSync(specPath, VALID_SPEC);
+        runSpecAdd({ dir: testDir }, 'spec/test.spec.yaml', {});
+        // Delete the spec file
+        rmSync(specPath);
+        mockStdout = [];
+        const globalOpts = { dir: testDir, format: 'json' };
+        runSpecList(globalOpts, {});
+        const output = mockStdout.join('');
+        const result = JSON.parse(output);
+        expect(result.specs[0].status).toBe('missing');
+    });
+});
+describe('spec validate command', () => {
+    let testDir;
+    let mockStdout;
+    let mockStderr;
+    beforeEach(() => {
+        testDir = join(tmpdir(), `prov-spec-validate-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        mkdirSync(testDir, { recursive: true });
+        mkdirSync(join(testDir, 'spec'), { recursive: true });
+        mockStdout = [];
+        mockStderr = [];
+        vi.spyOn(process.stdout, 'write').mockImplementation((msg) => {
+            mockStdout.push(String(msg));
+            return true;
+        });
+        vi.spyOn(process.stderr, 'write').mockImplementation((msg) => {
+            mockStderr.push(String(msg));
+            return true;
+        });
+        vi.spyOn(process, 'exit').mockImplementation((code) => {
+            throw new Error(`Process exited with code ${String(code)}`);
+        });
+    });
+    afterEach(() => {
+        if (existsSync(testDir)) {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+        vi.restoreAllMocks();
+    });
+    it('should validate with no errors for valid specs', () => {
+        writeFileSync(join(testDir, 'spec', 'test.spec.yaml'), VALID_SPEC);
+        const globalOpts = { dir: testDir, format: 'json' };
+        runSpecValidate(globalOpts, {});
+        const output = mockStdout.join('');
+        const result = JSON.parse(output);
+        expect(result.valid).toBe(true);
+        expect(result.issues).toHaveLength(0);
+        expect(result.specsChecked).toBe(1);
+    });
+    it('should report errors for invalid specs', () => {
+        writeFileSync(join(testDir, 'spec', 'invalid.spec.yaml'), INVALID_SPEC_NO_ID);
+        const globalOpts = { dir: testDir, format: 'json' };
+        expect(() => {
+            runSpecValidate(globalOpts, {});
+        }).toThrow('Process exited with code 1');
+        const output = mockStdout.join('');
+        const result = JSON.parse(output);
+        expect(result.valid).toBe(false);
+        expect(result.issues.some((i) => i.message.includes('Missing required field: id'))).toBe(true);
+    });
+    it('should report invalid requirement ID format', () => {
+        writeFileSync(join(testDir, 'spec', 'bad-req.spec.yaml'), INVALID_SPEC_BAD_REQ_ID);
+        const globalOpts = { dir: testDir, format: 'json' };
+        expect(() => {
+            runSpecValidate(globalOpts, {});
+        }).toThrow('Process exited with code 1');
+        const output = mockStdout.join('');
+        const result = JSON.parse(output);
+        expect(result.valid).toBe(false);
+        expect(result.issues.some((i) => i.message.includes('invalid ID format'))).toBe(true);
+    });
+    it('should detect duplicate spec IDs across files', () => {
+        writeFileSync(join(testDir, 'spec', 'spec1.yaml'), VALID_SPEC);
+        writeFileSync(join(testDir, 'spec', 'spec2.yaml'), VALID_SPEC); // Same spec ID!
+        const globalOpts = { dir: testDir };
+        expect(() => {
+            runSpecValidate(globalOpts, {});
+        }).toThrow('Process exited with code 1');
+        const output = mockStdout.join('') + mockStderr.join('');
+        expect(output).toContain('Duplicate spec ID');
+    });
+    it('should output JSON when format is json', () => {
+        writeFileSync(join(testDir, 'spec', 'test.spec.yaml'), VALID_SPEC);
+        const globalOpts = { dir: testDir, format: 'json' };
+        runSpecValidate(globalOpts, {});
+        const output = mockStdout.join('');
+        const result = JSON.parse(output);
+        expect(result.valid).toBe(true);
+        expect(result.issues).toHaveLength(0);
+        expect(result.specsChecked).toBe(1);
+    });
+    it('should report missing dependency references', () => {
+        const specWithMissingDep = `id: spec:missing-dep:v1
+version: 1.0.0
+title: Spec with Missing Dependency
+status: draft
+intent: Tests dependency validation
+requirements:
+  - id: req:missing-dep:main
+    description: Has a missing dependency
+    acceptance:
+      - Something
+    depends_on:
+      - req:nonexistent:feature
+`;
+        writeFileSync(join(testDir, 'spec', 'missing-dep.spec.yaml'), specWithMissingDep);
+        const globalOpts = { dir: testDir };
+        expect(() => {
+            runSpecValidate(globalOpts, {});
+        }).toThrow('Process exited with code 1');
+        const output = mockStdout.join('') + mockStderr.join('');
+        expect(output).toContain('unknown dependency');
+    });
+    it('should report empty result when no spec files found', () => {
+        // Empty spec directory
+        const globalOpts = { dir: testDir, format: 'json' };
+        runSpecValidate(globalOpts, {});
+        const output = mockStdout.join('');
+        const result = JSON.parse(output);
+        expect(result.valid).toBe(true);
+        expect(result.specsChecked).toBe(0);
+    });
+});
+//# sourceMappingURL=spec.test.js.map

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

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

package/dist/commands/trace.d.ts

@@ -0,0 +1,157 @@
+/**
+ * prov trace commands implementation.
+ *
+ * Commands for managing artifact traces:
+ * - trace add: Link an artifact to a plan step
+ * - trace show: Show provenance for an artifact
+ * - trace why: Show implementations of a requirement
+ *
+ * @see req:cli:trace-add
+ * @see req:cli:trace-show
+ * @see req:cli:trace-why
+ */
+import { type GlobalOptions } from '../cli.js';
+import type { TraceId, StepId, RequirementId, Hash } from '../types.js';
+/**
+ * Options for trace add command.
+ */
+export interface TraceAddOptions {
+    to: string;
+    autoHash?: boolean;
+}
+/**
+ * Result of trace add command.
+ */
+export interface TraceAddResult {
+    success: boolean;
+    traceId?: TraceId;
+    artifactPath?: string;
+    stepId?: StepId;
+    artifactHash?: Hash;
+    error?: string;
+}
+/**
+ * Options for trace show command.
+ */
+export interface TraceShowOptions {
+    format?: string;
+}
+/**
+ * Provenance chain entry.
+ */
+export interface ProvenanceEntry {
+    type: 'artifact' | 'step' | 'decision' | 'requirement' | 'spec';
+    id: string;
+    description?: string;
+}
+/**
+ * Result of trace show command.
+ */
+export interface TraceShowResult {
+    success: boolean;
+    artifact?: {
+        path: string;
+        hash: Hash;
+        stale: boolean;
+    };
+    trace?: {
+        id: TraceId;
+        stepId: StepId;
+        createdAt: string;
+    };
+    provenance?: ProvenanceEntry[];
+    error?: string;
+}
+/**
+ * Options for trace why command.
+ */
+export interface TraceWhyOptions {
+    format?: string;
+}
+/**
+ * Implementation entry for why command.
+ */
+export interface ImplementationEntry {
+    artifactPath: string;
+    stepId: StepId;
+    stepAction: string;
+    traceId: TraceId;
+    stale: boolean;
+}
+/**
+ * Result of trace why command.
+ */
+export interface TraceWhyResult {
+    success: boolean;
+    requirementId?: RequirementId;
+    requirement?: {
+        id: RequirementId;
+        description: string;
+    };
+    implementations?: ImplementationEntry[];
+    error?: string;
+}
+/**
+ * Execute the trace add command.
+ *
+ * Links an artifact (file) to a plan step, recording the current hash
+ * for staleness detection.
+ *
+ * @see req:cli:trace-add
+ */
+export declare function runTraceAdd(globalOpts: GlobalOptions, artifactPath: string, options: TraceAddOptions): void;
+/**
+ * Execute the trace show command.
+ *
+ * Shows the provenance chain for an artifact: artifact -> step -> decision/requirement -> spec.
+ *
+ * @see req:cli:trace-show
+ */
+export declare function runTraceShow(globalOpts: GlobalOptions, artifactPath: string, _options: TraceShowOptions): void;
+/**
+ * Execute the trace why command.
+ *
+ * Shows all artifacts that implement a requirement, traversing:
+ * requirement <- step <- artifact
+ *
+ * @see req:cli:trace-why
+ */
+export declare function runTraceWhy(globalOpts: GlobalOptions, reqIdStr: string, _options: TraceWhyOptions): void;
+/**
+ * Options for trace scan command.
+ */
+export interface TraceScanOptions {
+    dirs?: string[];
+    format?: string;
+}
+/**
+ * A scanned trace marker found in source code.
+ */
+export interface ScannedTrace {
+    file: string;
+    line: number;
+    stepId: StepId;
+    comment: string;
+}
+/**
+ * Result of trace scan command.
+ */
+export interface TraceScanResult {
+    success: boolean;
+    scannedFiles?: number;
+    tracesFound?: number;
+    tracesAdded?: number;
+    tracesUpdated?: number;
+    traces?: ScannedTrace[];
+    error?: string;
+}
+/**
+ * Execute the trace scan command.
+ *
+ * Scans source files for inline trace markers (// prov:step:xxx)
+ * and creates/updates traces automatically.
+ *
+ * @see req:agent:inline-tracing
+ */
+export declare function runTraceScan(globalOpts: GlobalOptions, options: TraceScanOptions): void;
+//# sourceMappingURL=trace.d.ts.map

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

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