@rengler33/prov 0.1.1

package/dist/hash.js

@@ -0,0 +1,137 @@
+/**
+ * Canonical YAML serialization and SHA-256 content hashing.
+ *
+ * All entities in prov are content-addressable via their hash.
+ * This module provides deterministic serialization and hashing.
+ *
+ * @see req:hashing
+ */
+import { createHash } from 'node:crypto';
+import YAML from 'yaml';
+/**
+ * Default fields to exclude from hash computation.
+ * These are computed/derived fields that shouldn't affect identity.
+ */
+const DEFAULT_EXCLUDE_FIELDS = ['hash', 'stale', 'status'];
+/**
+ * Recursively sort object keys for deterministic serialization.
+ */
+function sortKeys(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(sortKeys);
+    }
+    if (typeof value === 'object') {
+        const sorted = {};
+        const keys = Object.keys(value).sort();
+        for (const key of keys) {
+            sorted[key] = sortKeys(value[key]);
+        }
+        return sorted;
+    }
+    return value;
+}
+/**
+ * Remove specified fields from an object (shallow copy).
+ */
+function excludeFields(obj, fields) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (!fields.includes(key)) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Serialize an object to canonical YAML format.
+ *
+ * Canonical format guarantees:
+ * - Keys are sorted alphabetically at all levels
+ * - Consistent whitespace (2-space indent, no trailing spaces)
+ * - No document markers (---)
+ * - Strings are quoted only when necessary
+ *
+ * @param value - The value to serialize
+ * @param options - Serialization options
+ * @returns Canonical YAML string
+ */
+export function serializeCanonical(value, options = {}) {
+    const { excludeFields: exclude = [] } = options;
+    // Remove excluded fields if value is an object
+    let processedValue = value;
+    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+        processedValue = excludeFields(value, [...DEFAULT_EXCLUDE_FIELDS, ...exclude]);
+    }
+    // Sort keys recursively for deterministic output
+    const sorted = sortKeys(processedValue);
+    // Serialize to YAML with consistent formatting
+    return YAML.stringify(sorted, {
+        indent: 2,
+        lineWidth: 0, // Don't wrap lines
+        minContentWidth: 0,
+        singleQuote: false,
+    }).trim();
+}
+/**
+ * Compute SHA-256 hash of content.
+ *
+ * @param content - String content to hash
+ * @returns Full SHA-256 hash as hex string
+ */
+export function sha256(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex');
+}
+/**
+ * Compute content hash for an entity.
+ *
+ * The hash is computed from the canonical YAML representation,
+ * excluding computed fields (hash, stale, status).
+ *
+ * @param entity - The entity to hash
+ * @param options - Serialization options
+ * @returns Hash in format `sha256:{first-12-hex-chars}`
+ */
+export function computeHash(entity, options = {}) {
+    const canonical = serializeCanonical(entity, options);
+    const fullHash = sha256(canonical);
+    // Use first 12 hex characters (48 bits) - enough for practical uniqueness
+    return `sha256:${fullHash.slice(0, 12)}`;
+}
+/**
+ * Verify that an entity's stored hash matches its computed hash.
+ *
+ * @param entity - The entity with a hash field
+ * @returns true if hash matches or no hash is stored, false if mismatch
+ */
+export function verifyHash(entity) {
+    if (entity.hash === undefined || entity.hash === null) {
+        return true; // No hash to verify
+    }
+    const computed = computeHash(entity);
+    return computed === entity.hash;
+}
+/**
+ * Parse YAML content to an object.
+ *
+ * @param content - YAML string to parse
+ * @returns Parsed object
+ */
+export function parseYaml(content) {
+    return YAML.parse(content);
+}
+/**
+ * Serialize an object to YAML (non-canonical, for human readability).
+ *
+ * @param value - The value to serialize
+ * @returns YAML string
+ */
+export function toYaml(value) {
+    return YAML.stringify(value, {
+        indent: 2,
+        lineWidth: 80,
+    }).trim();
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

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

package/dist/hash.test.d.ts

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

package/dist/hash.test.d.ts.map

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

package/dist/hash.test.js

@@ -0,0 +1,227 @@
+import { describe, it, expect } from 'vitest';
+import { serializeCanonical, sha256, computeHash, verifyHash, parseYaml, toYaml, } from './hash.js';
+describe('hash module', () => {
+    describe('serializeCanonical', () => {
+        it('sorts object keys alphabetically', () => {
+            const yaml = serializeCanonical({ zebra: 1, apple: 2, mango: 3 });
+            const lines = yaml.split('\n');
+            expect(lines[0]).toBe('apple: 2');
+            expect(lines[1]).toBe('mango: 3');
+            expect(lines[2]).toBe('zebra: 1');
+        });
+        it('sorts nested object keys', () => {
+            const yaml = serializeCanonical({
+                outer: { zebra: 1, apple: 2 },
+            });
+            expect(yaml).toContain('apple: 2');
+            expect(yaml.indexOf('apple')).toBeLessThan(yaml.indexOf('zebra'));
+        });
+        it('handles arrays preserving order', () => {
+            const yaml = serializeCanonical({ items: ['c', 'a', 'b'] });
+            // Arrays should maintain their order
+            expect(yaml).toBe('items:\n  - c\n  - a\n  - b');
+        });
+        it('sorts keys within array objects', () => {
+            const yaml = serializeCanonical({
+                items: [{ z: 1, a: 2 }],
+            });
+            // Object keys within arrays should still be sorted
+            expect(yaml.indexOf('a: 2')).toBeLessThan(yaml.indexOf('z: 1'));
+        });
+        it('excludes default computed fields', () => {
+            const yaml = serializeCanonical({
+                id: 'test',
+                hash: 'sha256:should-be-excluded',
+                stale: true,
+                status: 'draft',
+            });
+            expect(yaml).not.toContain('hash');
+            expect(yaml).not.toContain('stale');
+            expect(yaml).not.toContain('status');
+            expect(yaml).toContain('id: test');
+        });
+        it('excludes custom fields when specified', () => {
+            const yaml = serializeCanonical({ id: 'test', custom: 'value', keep: 'this' }, { excludeFields: ['custom'] });
+            expect(yaml).not.toContain('custom');
+            expect(yaml).toContain('id: test');
+            expect(yaml).toContain('keep: this');
+        });
+        it('handles null and undefined values', () => {
+            const yaml = serializeCanonical({ a: null, b: undefined });
+            expect(yaml).toContain('a: null');
+            // undefined values are typically omitted in YAML
+        });
+        it('produces consistent output for same input', () => {
+            const obj = { b: 2, a: 1, c: { z: 26, y: 25 } };
+            const yaml1 = serializeCanonical(obj);
+            const yaml2 = serializeCanonical(obj);
+            expect(yaml1).toBe(yaml2);
+        });
+        it('produces same output regardless of input key order', () => {
+            const obj1 = { a: 1, b: 2, c: 3 };
+            const obj2 = { c: 3, a: 1, b: 2 };
+            const obj3 = { b: 2, c: 3, a: 1 };
+            const yaml1 = serializeCanonical(obj1);
+            const yaml2 = serializeCanonical(obj2);
+            const yaml3 = serializeCanonical(obj3);
+            expect(yaml1).toBe(yaml2);
+            expect(yaml2).toBe(yaml3);
+        });
+    });
+    describe('sha256', () => {
+        it('computes correct SHA-256 hash', () => {
+            // Known test vector
+            const hash = sha256('hello');
+            expect(hash).toBe('2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824');
+        });
+        it('produces different hashes for different inputs', () => {
+            const hash1 = sha256('hello');
+            const hash2 = sha256('world');
+            expect(hash1).not.toBe(hash2);
+        });
+        it('produces same hash for same input', () => {
+            const hash1 = sha256('test input');
+            const hash2 = sha256('test input');
+            expect(hash1).toBe(hash2);
+        });
+        it('is sensitive to whitespace', () => {
+            const hash1 = sha256('hello');
+            const hash2 = sha256('hello ');
+            const hash3 = sha256(' hello');
+            expect(hash1).not.toBe(hash2);
+            expect(hash1).not.toBe(hash3);
+            expect(hash2).not.toBe(hash3);
+        });
+    });
+    describe('computeHash', () => {
+        it('returns hash in sha256:{12-chars} format', () => {
+            const hash = computeHash({ id: 'test' });
+            expect(hash).toMatch(/^sha256:[a-f0-9]{12}$/);
+        });
+        it('produces consistent hash for same entity', () => {
+            const entity = { id: 'spec:test:v1', title: 'Test' };
+            const hash1 = computeHash(entity);
+            const hash2 = computeHash(entity);
+            expect(hash1).toBe(hash2);
+        });
+        it('produces same hash regardless of property order', () => {
+            const entity1 = { id: 'test', title: 'Test', version: '1.0' };
+            const entity2 = { version: '1.0', id: 'test', title: 'Test' };
+            expect(computeHash(entity1)).toBe(computeHash(entity2));
+        });
+        it('produces different hash for different content', () => {
+            const entity1 = { id: 'test', value: 1 };
+            const entity2 = { id: 'test', value: 2 };
+            expect(computeHash(entity1)).not.toBe(computeHash(entity2));
+        });
+        it('ignores hash field in computation', () => {
+            const entity = { id: 'test', hash: 'sha256:old-hash-val' };
+            const entityWithoutHash = { id: 'test' };
+            expect(computeHash(entity)).toBe(computeHash(entityWithoutHash));
+        });
+        it('ignores status field in computation', () => {
+            const entity1 = { id: 'test', title: 'Test' };
+            const entity2 = { id: 'test', title: 'Test', status: 'draft' };
+            const entity3 = { id: 'test', title: 'Test', status: 'active' };
+            expect(computeHash(entity1)).toBe(computeHash(entity2));
+            expect(computeHash(entity2)).toBe(computeHash(entity3));
+        });
+    });
+    describe('verifyHash', () => {
+        it('returns true when hash matches', () => {
+            const entity = { id: 'test', title: 'Test' };
+            const hash = computeHash(entity);
+            const entityWithHash = { ...entity, hash };
+            expect(verifyHash(entityWithHash)).toBe(true);
+        });
+        it('returns false when hash does not match', () => {
+            const entity = {
+                id: 'test',
+                title: 'Test',
+                hash: 'sha256:wrong-hash00',
+            };
+            expect(verifyHash(entity)).toBe(false);
+        });
+        it('returns true when no hash is present', () => {
+            const entity = {
+                id: 'test',
+                title: 'Test',
+            };
+            expect(verifyHash(entity)).toBe(true);
+        });
+    });
+    describe('parseYaml and toYaml', () => {
+        it('round-trips objects correctly', () => {
+            const original = {
+                id: 'spec:test:v1',
+                title: 'Test Spec',
+                requirements: [{ id: 'req:test:1', description: 'First' }],
+            };
+            const yaml = toYaml(original);
+            const parsed = parseYaml(yaml);
+            expect(parsed).toEqual(original);
+        });
+        it('parses YAML strings', () => {
+            const yaml = `
+id: spec:test:v1
+title: Test
+      `.trim();
+            const parsed = parseYaml(yaml);
+            expect(parsed.id).toBe('spec:test:v1');
+            expect(parsed.title).toBe('Test');
+        });
+    });
+    describe('real-world entity hashing', () => {
+        it('computes stable hash for Spec entity', () => {
+            const spec = {
+                id: 'spec:core-model:v1',
+                version: '1.0.0',
+                title: 'Core Data Model',
+                status: 'draft',
+                intent: 'Define the fundamental entities',
+                requirements: [
+                    {
+                        id: 'req:core-model:entity-spec',
+                        description: 'Specification entity represents declarative intent',
+                        acceptance: ['Specs have a unique id'],
+                    },
+                ],
+            };
+            const hash1 = computeHash(spec);
+            const hash2 = computeHash(spec);
+            expect(hash1).toBe(hash2);
+            expect(hash1).toMatch(/^sha256:[a-f0-9]{12}$/);
+        });
+        it('detects changes in Spec content', () => {
+            const spec1 = {
+                id: 'spec:test:v1',
+                version: '1.0.0',
+                title: 'Original',
+                status: 'draft',
+                intent: 'Original intent',
+                requirements: [],
+            };
+            const spec2 = {
+                ...spec1,
+                title: 'Modified',
+            };
+            expect(computeHash(spec1)).not.toBe(computeHash(spec2));
+        });
+        it('ignores status changes for hash computation', () => {
+            const specDraft = {
+                id: 'spec:test:v1',
+                version: '1.0.0',
+                title: 'Test',
+                status: 'draft',
+                intent: 'Test intent',
+                requirements: [],
+            };
+            const specActive = {
+                ...specDraft,
+                status: 'active',
+            };
+            expect(computeHash(specDraft)).toBe(computeHash(specActive));
+        });
+    });
+});
+//# sourceMappingURL=hash.test.js.map

package/dist/hash.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.test.js","sourceRoot":"","sources":["../src/hash.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,GACP,MAAM,WAAW,CAAC;AAGnB,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,IAAI,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAE/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,IAAI,GAAG,kBAAkB,CAAC;gBAC9B,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;aAC9B,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAE5D,qCAAqC;YACrC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC;gBAC9B,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;aACxB,CAAC,CAAC;YAEH,mDAAmD;YACnD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,IAAI,GAAG,kBAAkB,CAAC;gBAC9B,EAAE,EAAE,MAAM;gBACV,IAAI,EAAE,2BAA2B;gBACjC,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,OAAO;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,IAAI,GAAG,kBAAkB,CAC7B,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAC7C,EAAE,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,CAC9B,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,IAAI,GAAG,kBAAkB,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YAE3D,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAClC,iDAAiD;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;YAEhD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAEtC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YAElC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,oBAAoB;YACpB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CACf,kEAAkE,CACnE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAE9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;YAEnC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAE/B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAEzC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAErD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YAElC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC9D,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAE9D,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAEzC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;YAC3D,MAAM,iBAAiB,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;YAEzC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC/D,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAEhE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;YACxD,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,cAAc,GAAG,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;YAE3C,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,MAAM,GAAG;gBACb,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,qBAA8B;aACrC,CAAC;YAEF,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,MAAM,GAA6D;gBACvE,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,MAAM;aACd,CAAC;YAEF,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,QAAQ,GAAG;gBACf,EAAE,EAAE,cAAc;gBAClB,KAAK,EAAE,WAAW;gBAClB,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;aAC3D,CAAC;YAEF,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAE/B,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,IAAI,GAAG;;;OAGZ,CAAC,IAAI,EAAE,CAAC;YAET,MAAM,MAAM,GAAG,SAAS,CAAgC,IAAI,CAAC,CAAC;YAE9D,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,IAAI,GAAS;gBACjB,EAAE,EAAE,oBAAoB;gBACxB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,iBAAiB;gBACxB,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,iCAAiC;gBACzC,YAAY,EAAE;oBACZ;wBACE,EAAE,EAAE,4BAA4B;wBAChC,WAAW,EAAE,oDAAoD;wBACjE,UAAU,EAAE,CAAC,wBAAwB,CAAC;qBACvC;iBACF;aACF,CAAC;YAEF,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAEhC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,KAAK,GAAS;gBAClB,EAAE,EAAE,cAAc;gBAClB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,UAAU;gBACjB,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,iBAAiB;gBACzB,YAAY,EAAE,EAAE;aACjB,CAAC;YAEF,MAAM,KAAK,GAAS;gBAClB,GAAG,KAAK;gBACR,KAAK,EAAE,UAAU;aAClB,CAAC;YAEF,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,SAAS,GAAS;gBACtB,EAAE,EAAE,cAAc;gBAClB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,aAAa;gBACrB,YAAY,EAAE,EAAE;aACjB,CAAC;YAEF,MAAM,UAAU,GAAS;gBACvB,GAAG,SAAS;gBACZ,MAAM,EAAE,QAAQ;aACjB,CAAC;YAEF,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * prov - Provenance-first planning CLI for AI agent workflows
+ *
+ * This module exports the core prov API for programmatic usage.
+ */
+export declare const VERSION = "0.1.0";
+export type { Hash, Timestamp, EntityId, EntityStatus, SpecId, RequirementId, ConstraintId, InvariantId, PlanId, DecisionId, StepId, TraceId, AcceptanceCriterion, Requirement, Spec, VerificationMethod, Invariant, Constraint, Decision, Step, SourceReference, Plan, FileLocation, Trace, NodeType, EdgeType, GraphNode, GraphEdge, } from './types.js';
+export { serializeCanonical, sha256, computeHash, verifyHash, parseYaml, toYaml, type SerializeOptions, } from './hash.js';
+export { IntentGraph, addSpecToGraph, addConstraintToGraph, addPlanToGraph, addTraceToGraph, type EntityData, type TraversalOptions, type ValidationResult, } from './graph.js';
+export { PROV_DIR, GRAPH_FILE, MAPPINGS_DIR, CACHE_DIR, SCHEMA_VERSION, getProvDir, getGraphPath, getMappingsDir, getCacheDir, getMappingPath, isInitialized, initialize, acquireLock, releaseLock, withLock, atomicWrite, saveGraph, loadGraph, saveMapping, loadMapping, deleteMapping, listMappings, getCachedHash, setCachedHash, clearCache, Storage, type GraphFile, type SerializedNode, type SerializedEdge, type LineMapping, type FileMapping, type StorageOptions, type StorageResult, } from './storage.js';
+export { getFileType, extractEntityId, computeFileHash, hasFileChanged, getTrackedFiles, scanForChanges, updateHashes, getStaleEntities, FileWatcher, type TrackedFileType, type TrackedFile, type ChangeResult, type WatcherEvents, type WatcherOptions, } from './watcher.js';
+export { computeArtifactHash, checkPlanStaleness, checkTraceStaleness, findTransitivelyStale, detectStaleness, isNodeStale, getStaleNodes, getStalePlans, getStaleTraces, formatStalenessReason, type StalenessReason, type StalenessInfo, type StalenessResult, type StalenessOptions, } from './staleness.js';
+/**
+ * Placeholder for core prov functionality.
+ * Will be implemented in subsequent steps.
+ */
+export declare function getVersion(): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EAEV,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,YAAY,EAEZ,MAAM,EACN,aAAa,EACb,YAAY,EACZ,WAAW,EACX,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,EAEP,mBAAmB,EACnB,WAAW,EACX,IAAI,EAEJ,kBAAkB,EAClB,SAAS,EACT,UAAU,EAEV,QAAQ,EACR,IAAI,EACJ,eAAe,EACf,IAAI,EAEJ,YAAY,EACZ,KAAK,EAEL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,EACN,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAEL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EAEd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EAEd,aAAa,EACb,UAAU,EAEV,WAAW,EACX,WAAW,EACX,QAAQ,EAER,WAAW,EAEX,SAAS,EACT,SAAS,EAET,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EAEZ,aAAa,EACb,aAAa,EACb,UAAU,EAEV,OAAO,EAEP,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,WAAW,EACX,eAAe,EAEf,eAAe,EACf,cAAc,EAEd,eAAe,EACf,cAAc,EACd,YAAY,EAEZ,gBAAgB,EAEhB,WAAW,EAEX,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,mBAAmB,EAEnB,kBAAkB,EAClB,mBAAmB,EAEnB,qBAAqB,EAErB,eAAe,EAEf,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EAEd,qBAAqB,EAErB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/index.js

@@ -0,0 +1,64 @@
+/**
+ * prov - Provenance-first planning CLI for AI agent workflows
+ *
+ * This module exports the core prov API for programmatic usage.
+ */
+export const VERSION = '0.1.0';
+// Hash and serialization utilities
+export { serializeCanonical, sha256, computeHash, verifyHash, parseYaml, toYaml, } from './hash.js';
+// Intent graph
+export { IntentGraph, addSpecToGraph, addConstraintToGraph, addPlanToGraph, addTraceToGraph, } from './graph.js';
+// Storage layer
+export { 
+// Constants
+PROV_DIR, GRAPH_FILE, MAPPINGS_DIR, CACHE_DIR, SCHEMA_VERSION, 
+// Path utilities
+getProvDir, getGraphPath, getMappingsDir, getCacheDir, getMappingPath, 
+// Directory management
+isInitialized, initialize, 
+// Lock management
+acquireLock, releaseLock, withLock, 
+// Atomic write
+atomicWrite, 
+// Graph persistence
+saveGraph, loadGraph, 
+// Mapping persistence
+saveMapping, loadMapping, deleteMapping, listMappings, 
+// Cache management
+getCachedHash, setCachedHash, clearCache, 
+// High-level interface
+Storage, } from './storage.js';
+// File watching and change detection
+export { 
+// File type detection
+getFileType, extractEntityId, 
+// Hash utilities
+computeFileHash, hasFileChanged, 
+// File scanning
+getTrackedFiles, scanForChanges, updateHashes, 
+// Staleness detection
+getStaleEntities, 
+// Watch mode
+FileWatcher, } from './watcher.js';
+// Staleness detection
+export { 
+// File hash utilities
+computeArtifactHash, 
+// Direct staleness checks
+checkPlanStaleness, checkTraceStaleness, 
+// Transitive staleness
+findTransitivelyStale, 
+// Full graph detection
+detectStaleness, 
+// Convenience functions
+isNodeStale, getStaleNodes, getStalePlans, getStaleTraces, 
+// Formatting
+formatStalenessReason, } from './staleness.js';
+/**
+ * Placeholder for core prov functionality.
+ * Will be implemented in subsequent steps.
+ */
+export function getVersion() {
+    return VERSION;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAyC/B,mCAAmC;AACnC,OAAO,EACL,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,GAEP,MAAM,WAAW,CAAC;AAEnB,eAAe;AACf,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,GAIhB,MAAM,YAAY,CAAC;AAEpB,gBAAgB;AAChB,OAAO;AACL,YAAY;AACZ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,cAAc;AACd,iBAAiB;AACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc;AACd,uBAAuB;AACvB,aAAa,EACb,UAAU;AACV,kBAAkB;AAClB,WAAW,EACX,WAAW,EACX,QAAQ;AACR,eAAe;AACf,WAAW;AACX,oBAAoB;AACpB,SAAS,EACT,SAAS;AACT,sBAAsB;AACtB,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY;AACZ,mBAAmB;AACnB,aAAa,EACb,aAAa,EACb,UAAU;AACV,uBAAuB;AACvB,OAAO,GASR,MAAM,cAAc,CAAC;AAEtB,qCAAqC;AACrC,OAAO;AACL,sBAAsB;AACtB,WAAW,EACX,eAAe;AACf,iBAAiB;AACjB,eAAe,EACf,cAAc;AACd,gBAAgB;AAChB,eAAe,EACf,cAAc,EACd,YAAY;AACZ,sBAAsB;AACtB,gBAAgB;AAChB,aAAa;AACb,WAAW,GAOZ,MAAM,cAAc,CAAC;AAEtB,sBAAsB;AACtB,OAAO;AACL,sBAAsB;AACtB,mBAAmB;AACnB,0BAA0B;AAC1B,kBAAkB,EAClB,mBAAmB;AACnB,uBAAuB;AACvB,qBAAqB;AACrB,uBAAuB;AACvB,eAAe;AACf,wBAAwB;AACxB,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc;AACd,aAAa;AACb,qBAAqB,GAMtB,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.test.d.ts

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

package/dist/index.test.d.ts.map

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

package/dist/index.test.js

@@ -0,0 +1,11 @@
+import { describe, it, expect } from 'vitest';
+import { getVersion, VERSION } from './index.js';
+describe('prov core', () => {
+    it('exports VERSION constant', () => {
+        expect(VERSION).toBe('0.1.0');
+    });
+    it('getVersion returns the version string', () => {
+        expect(getVersion()).toBe('0.1.0');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEjD,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Output formatting utilities for CLI commands.
+ *
+ * Supports multiple output formats:
+ * - table: Human-readable columnar format (default for TTY)
+ * - yaml: YAML format (default for pipes)
+ * - json: Machine-parseable JSON format
+ *
+ * @see req:cli:output-formats
+ */
+/**
+ * Supported output format types.
+ */
+export type OutputFormat = 'table' | 'yaml' | 'json';
+/**
+ * Column definition for table output.
+ */
+export interface TableColumn {
+    /** Column header text */
+    header: string;
+    /** Key to extract from row data */
+    key: string;
+    /** Minimum width (defaults to header length) */
+    minWidth?: number;
+    /** Maximum width (truncates with ellipsis) */
+    maxWidth?: number;
+    /** Alignment: left, right, center (defaults to left) */
+    align?: 'left' | 'right' | 'center';
+}
+/**
+ * Options for output formatting.
+ */
+export interface OutputOptions {
+    /** Output format to use */
+    format?: OutputFormat | undefined;
+    /** Whether output is to a TTY (auto-detected if not specified) */
+    isTty?: boolean | undefined;
+    /** Custom table columns (for table format) */
+    columns?: TableColumn[] | undefined;
+    /** Whether to include headers in table output */
+    headers?: boolean | undefined;
+}
+/**
+ * Detect the default output format based on environment.
+ * Returns 'table' for TTY, 'yaml' for pipes/redirects.
+ */
+export declare function detectFormat(isTty?: boolean): OutputFormat;
+/**
+ * Resolve the format to use, considering explicit format and TTY detection.
+ */
+export declare function resolveFormat(options?: OutputOptions): OutputFormat;
+/**
+ * Format data as a table.
+ */
+export declare function formatTable(data: readonly Record<string, unknown>[], columns: TableColumn[], includeHeaders?: boolean): string;
+/**
+ * Format data as YAML.
+ */
+export declare function formatYaml(data: unknown): string;
+/**
+ * Format data as JSON.
+ */
+export declare function formatJson(data: unknown): string;
+/**
+ * Format data in the specified format.
+ */
+export declare function format(data: unknown, options?: OutputOptions): string;
+/**
+ * Output data to stdout in the specified format.
+ */
+export declare function output(data: unknown, options?: OutputOptions): void;
+/**
+ * Output an error message to stderr.
+ */
+export declare function error(message: string): void;
+/**
+ * Output a success message to stdout.
+ */
+export declare function success(message: string): void;
+/**
+ * Output a warning message to stderr.
+ */
+export declare function warn(message: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IACpC,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,YAAY,CAG1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAKvE;AA4BD;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACxC,OAAO,EAAE,WAAW,EAAE,EACtB,cAAc,UAAO,GACpB,MAAM,CA6CR;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAmCR;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAOvE;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C"}