@principled/cairn 1.0.0-beta

package/dist/catalog/category-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-merger.js","sourceRoot":"","sources":["../../src/catalog/category-merger.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,SAAS,qBAAqB,CAC5B,IAAsC,EACtC,QAA0C;IAE1C,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,gBAA4B,EAC5B,sBAAiD,YAAY;IAE7D,MAAM,gBAAgB,GAAuC,EAAE,CAAC;IAChE,MAAM,UAAU,GAA4C,EAAE,CAAC;IAC/D,MAAM,SAAS,GAAqC,EAAE,CAAC;IACvD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAqC,CAAC;IAEtE,uDAAuD;IACvD,kEAAkE;IAClE,gEAAgE;IAChE,MAAM,IAAI,GACR,mBAAmB,KAAK,YAAY;QAClC,CAAC,CAAC,gBAAgB,CAAC,yCAAyC;QAC5D,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,yCAAyC;IAEhF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,gDAAgD;QAChD,MAAM,aAAa,GAAG,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YACxD,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,2BAA2B;gBAC3B,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,CAAE,CAAC,aAAa,IAAI,EAAE,CAAC;gBACpE,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;gBAC3C,gBAAgB,CAAC,IAAI,CAAC,GAAG;oBACvB,GAAG,gBAAgB,CAAC,IAAI,CAAE;oBAC1B,GAAG,GAAG;oBACN,aAAa,EACX,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM;wBACnE,CAAC,CAAC,qBAAqB,CAAC,eAAe,EAAE,UAAU,CAAC;wBACpD,CAAC,CAAC,SAAS;iBAChB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;YACtC,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,MAAM,OAAO,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAClD,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;QACzB,CAAC;QAED,yDAAyD;QACzD,MAAM,aAAa,GAAI,GAAG,CAAC,IAAI,CAAC,WAAmD,EAAE,IAAI,CAAC;QAC1F,IACE,aAAa;YACb,OAAO,aAAa,KAAK,QAAQ;YACjC,eAAe,IAAI,aAAa,EAChC,CAAC;YACD,MAAM,OAAO,GAAI,aAAsE;iBACpF,aAAa,CAAC;YACjB,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE;gBAC/B,UAAU,EAAE,EAAE,GAAG,gBAAgB,EAAE;gBACnC,IAAI,EAAE,EAAE,GAAG,UAAU,EAAE;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,gBAAgB;QAC5B,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,SAAS;QAC1B,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/catalog/index.d.ts

@@ -0,0 +1,4 @@
+export { Catalog } from './catalog.js';
+export { mergeDefinitions, type MergedDefinitions, type LibraryDefinitionSnapshot, } from './category-merger.js';
+export { validateMergedCategories } from './post-merge-validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/catalog/index.js

@@ -0,0 +1,4 @@
+export { Catalog } from './catalog.js';
+export { mergeDefinitions, } from './category-merger.js';
+export { validateMergedCategories } from './post-merge-validation.js';
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,gBAAgB,GAGjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/catalog/post-merge-validation.d.ts

@@ -0,0 +1,7 @@
+import type { CategoryDefinition } from '../schema/category-definition.js';
+/**
+ * Run post-merge validation on a set of category definitions (DEC-3.6).
+ * All checks are per-library. Throws on first error (DEC-5.7: fail-fast).
+ */
+export declare function validateMergedCategories(categories: Record<string, CategoryDefinition>, context?: string): void;
+//# sourceMappingURL=post-merge-validation.d.ts.map

package/dist/catalog/post-merge-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-merge-validation.d.ts","sourceRoot":"","sources":["../../src/catalog/post-merge-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAS3E;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC9C,OAAO,GAAE,MAAkB,GAC1B,IAAI,CAkEN"}

package/dist/catalog/post-merge-validation.js

@@ -0,0 +1,59 @@
+import { checkReservedFieldCollision } from '../schema/reserved-fields.js';
+import { DuplicateIdPrefixError, DuplicateYamlKeyError, InvalidMappingRuleRefError, CatalogError, } from '../errors.js';
+/**
+ * Run post-merge validation on a set of category definitions (DEC-3.6).
+ * All checks are per-library. Throws on first error (DEC-5.7: fail-fast).
+ */
+export function validateMergedCategories(categories, context = 'catalog') {
+    const entries = Object.entries(categories);
+    // 1. id_prefix uniqueness
+    const prefixes = new Map();
+    for (const [name, def] of entries) {
+        const existing = prefixes.get(def.id_prefix);
+        if (existing) {
+            throw new DuplicateIdPrefixError(`Duplicate id_prefix '${def.id_prefix}' in ${context}: used by both '${existing}' and '${name}'`);
+        }
+        prefixes.set(def.id_prefix, name);
+    }
+    // 2. yaml_key uniqueness
+    const yamlKeys = new Map();
+    for (const [name, def] of entries) {
+        const existing = yamlKeys.get(def.yaml_key);
+        if (existing) {
+            throw new DuplicateYamlKeyError(`Duplicate yaml_key '${def.yaml_key}' in ${context}: used by both '${existing}' and '${name}'`);
+        }
+        yamlKeys.set(def.yaml_key, name);
+    }
+    // 3. mapping_rules references exist
+    const categoryNames = new Set(entries.map(([name]) => name));
+    for (const [name, def] of entries) {
+        if (!def.mapping_rules)
+            continue;
+        for (const ruleGroup of def.mapping_rules) {
+            for (const ref of ruleGroup) {
+                if (!categoryNames.has(ref)) {
+                    throw new InvalidMappingRuleRefError(`Category '${name}' references unknown category '${ref}' in mapping_rules in ${context}`);
+                }
+            }
+        }
+    }
+    // 4. Reserved field collisions in field_schemas
+    for (const [, def] of entries) {
+        if (def.field_schemas) {
+            checkReservedFieldCollision(def.field_schemas);
+        }
+    }
+    // 5. Root categories must NOT have mapping_rules (DEC-3.5)
+    for (const [name, def] of entries) {
+        if (def.is_root && def.mapping_rules && def.mapping_rules.length > 0) {
+            throw new CatalogError(`Root category '${name}' must not have mapping_rules in ${context}`);
+        }
+    }
+    // 6. Non-root categories MUST have mapping_rules (DEC-3.5)
+    for (const [name, def] of entries) {
+        if (!def.is_root && (!def.mapping_rules || def.mapping_rules.length === 0)) {
+            throw new CatalogError(`Non-root category '${name}' must have mapping_rules in ${context}`);
+        }
+    }
+}
+//# sourceMappingURL=post-merge-validation.js.map

package/dist/catalog/post-merge-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-merge-validation.js","sourceRoot":"","sources":["../../src/catalog/post-merge-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAA8C,EAC9C,UAAkB,SAAS;IAE3B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAE3C,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,sBAAsB,CAC9B,wBAAwB,GAAG,CAAC,SAAS,QAAQ,OAAO,mBAAmB,QAAQ,UAAU,IAAI,GAAG,CACjG,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,yBAAyB;IACzB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,qBAAqB,CAC7B,uBAAuB,GAAG,CAAC,QAAQ,QAAQ,OAAO,mBAAmB,QAAQ,UAAU,IAAI,GAAG,CAC/F,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,oCAAoC;IACpC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,aAAa;YAAE,SAAS;QACjC,KAAK,MAAM,SAAS,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,IAAI,0BAA0B,CAClC,aAAa,IAAI,kCAAkC,GAAG,yBAAyB,OAAO,EAAE,CACzF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YACtB,2BAA2B,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,YAAY,CACpB,kBAAkB,IAAI,oCAAoC,OAAO,EAAE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,YAAY,CACpB,sBAAsB,IAAI,gCAAgC,OAAO,EAAE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/commands/add.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function addCommand(): Command;
+//# sourceMappingURL=add.d.ts.map

package/dist/cli/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,UAAU,IAAI,OAAO,CAwGpC"}

package/dist/cli/commands/add.js

@@ -0,0 +1,107 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as yaml from 'js-yaml';
+import { randomUUID } from 'crypto';
+import { parseConfigOptions, buildCatalog, requireUserIdentity } from '../helpers.js';
+import { resolveTimezone } from '../../schema/datetime.js';
+export function addCommand() {
+    const cmd = new Command('add')
+        .description('Add a new element to a GVP document')
+        .argument('<category>', 'Element category (e.g., goal, value, decision)')
+        .argument('<name>', 'Element name')
+        .option('-d, --document <path>', 'Target document (default: last/leaf document in library)')
+        .option('-f, --field <key=value...>', 'Set field values')
+        .option('--skip-review', 'Mark provenance as skip-review (DEC-4.6)')
+        .option('--no-provenance', 'Legacy alias for --skip-review')
+        .action(async (category, name) => {
+        try {
+            const { config } = parseConfigOptions(cmd);
+            const catalog = buildCatalog(config);
+            const opts = cmd.opts();
+            // Verify category exists
+            const catDef = catalog.registry.getByName(category);
+            if (!catDef) {
+                const available = catalog.registry.categoryNames.join(', ');
+                console.error(`Unknown category '${category}'. Available: ${available}`);
+                process.exit(1);
+            }
+            // Find target document
+            const docs = catalog.documents;
+            const targetDoc = opts.document
+                ? docs.find(d => d.documentPath === opts.document || d.name === opts.document)
+                : docs[docs.length - 1]; // Last doc = leaf = most specific
+            if (!targetDoc) {
+                console.error(`Document '${opts.document}' not found`);
+                process.exit(1);
+            }
+            // Generate next ID (DEC-9.5): find max numeric suffix, increment by 1
+            const prefix = catDef.id_prefix;
+            const existingIds = catalog.getElementsByCategory(category).map(e => e.id);
+            const maxNum = existingIds.reduce((max, id) => {
+                const num = parseInt(id.replace(prefix, ''), 10);
+                return isNaN(num) ? max : Math.max(max, num);
+            }, 0);
+            const newId = `${prefix}${maxNum + 1}`;
+            // Build element data
+            const elementData = {
+                id: newId,
+                name,
+                status: 'active',
+                tags: [],
+                maps_to: [],
+            };
+            // Apply field values from --field flags
+            if (opts.field) {
+                for (const entry of opts.field) {
+                    const eqIdx = entry.indexOf('=');
+                    if (eqIdx > 0) {
+                        const key = entry.substring(0, eqIdx);
+                        const value = entry.substring(eqIdx + 1);
+                        // Try to parse as JSON, fall back to string
+                        try {
+                            elementData[key] = JSON.parse(value);
+                        }
+                        catch {
+                            elementData[key] = value;
+                        }
+                    }
+                }
+            }
+            // Add origin provenance (DEC-4.7)
+            const skipReview = opts.skipReview || opts.provenance === false;
+            const tz = resolveTimezone(config.default_timezone);
+            const user = requireUserIdentity(config);
+            const originEntry = {
+                id: randomUUID(),
+                date: new Date().toISOString(),
+                by: user,
+            };
+            if (skipReview) {
+                originEntry.skip_review = true;
+            }
+            elementData.origin = [originEntry];
+            // Write to YAML file
+            const filePath = targetDoc.filePath;
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const data = yaml.load(content) ?? {};
+            const yamlKey = catDef.yaml_key;
+            if (!data[yamlKey])
+                data[yamlKey] = [];
+            data[yamlKey].push(elementData);
+            fs.writeFileSync(filePath, yaml.dump(data, {
+                lineWidth: -1,
+                noRefs: true,
+                sortKeys: false,
+            }));
+            console.error(`Added ${newId}: "${name}" to ${targetDoc.name} (${yamlKey})`);
+            // Output the new ID to stdout for scripting
+            process.stdout.write(newId);
+        }
+        catch (e) {
+            console.error(`Error: ${e.message}`);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=add.js.map

package/dist/cli/commands/add.js.map

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

package/dist/cli/commands/analyze.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function analyzeCommand(): Command;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/cli/commands/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,cAAc,IAAI,OAAO,CA4CxC"}

package/dist/cli/commands/analyze.js

@@ -0,0 +1,44 @@
+import { Command } from 'commander';
+import { parseConfigOptions, buildCatalog } from '../helpers.js';
+import { StubEmbeddingProvider } from '../../analysis/stub-provider.js';
+import { findUnmappedRelationships } from '../../analysis/analyzer.js';
+export function analyzeCommand() {
+    const cmd = new Command('analyze')
+        .description('Analyze the GVP catalog for unmapped relationships and potential conflicts')
+        .option('--threshold <number>', 'Similarity threshold (0-1)', '0.7')
+        .action(async () => {
+        try {
+            const { config } = parseConfigOptions(cmd);
+            const catalog = buildCatalog(config);
+            const opts = cmd.opts();
+            const provider = new StubEmbeddingProvider();
+            const threshold = parseFloat(opts.threshold);
+            const elements = catalog.getAllElements().filter(e => e.status === 'active');
+            console.error(`Analyzing ${elements.length} elements for unmapped relationships (threshold: ${threshold})...\n`);
+            const results = await findUnmappedRelationships(elements, provider, threshold);
+            if (results.length === 0) {
+                console.error('No unmapped relationships found above threshold.');
+                process.exit(0);
+            }
+            console.error(`Found ${results.length} potential relationship(s):\n`);
+            for (const r of results) {
+                console.error(`  ${r.elementA.toLibraryId()} <-> ${r.elementB.toLibraryId()}  (similarity: ${r.similarity.toFixed(3)})`);
+                console.error(`    "${r.elementA.name}" ~ "${r.elementB.name}"`);
+                console.error('');
+            }
+            // JSON to stdout (DEC-5.12: structured output to stdout, human to stderr)
+            const jsonOutput = results.map(r => ({
+                elementA: { id: r.elementA.id, name: r.elementA.name, libraryId: r.elementA.toLibraryId() },
+                elementB: { id: r.elementB.id, name: r.elementB.name, libraryId: r.elementB.toLibraryId() },
+                similarity: r.similarity,
+            }));
+            process.stdout.write(JSON.stringify(jsonOutput, null, 2) + '\n');
+        }
+        catch (e) {
+            console.error(`Error: ${e.message}`);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=analyze.js.map

package/dist/cli/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;SAC/B,WAAW,CAAC,4EAA4E,CAAC;SACzF,MAAM,CAAC,sBAAsB,EAAE,4BAA4B,EAAE,KAAK,CAAC;SACnE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YAExB,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;YAC7C,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAmB,CAAC,CAAC;YAEvD,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;YAC7E,OAAO,CAAC,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,oDAAoD,SAAS,QAAQ,CAAC,CAAC;YAEjH,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE/E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;gBAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,SAAS,OAAO,CAAC,MAAM,+BAA+B,CAAC,CAAC;YACtE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACzH,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;gBACjE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpB,CAAC;YAED,0EAA0E;YAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACnC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE;gBAC3F,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE;gBAC3F,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC,CAAC,CAAC;YACJ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,UAAW,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/commands/diff.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function diffCommand(): Command;
+//# sourceMappingURL=diff.d.ts.map

package/dist/cli/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,WAAW,IAAI,OAAO,CAiErC"}

package/dist/cli/commands/diff.js

@@ -0,0 +1,69 @@
+import { Command } from 'commander';
+import { parseConfigOptions, buildCatalog } from '../helpers.js';
+import { traceGitDiff, formatDiffTrace } from '../../refs/git-diff-tracer.js';
+import * as path from 'path';
+export function diffCommand() {
+    const cmd = new Command('diff')
+        .description('Trace code changes back to GVP decisions via refs')
+        .argument('[commitA]', 'Start commit (default: HEAD~1)')
+        .argument('[commitB]', 'End commit (default: HEAD)')
+        .option('--scope <scope>', 'Scope: staged, working, or commit range')
+        .option('--format <format>', 'Output format: text (default) or json', 'text')
+        .action(async (commitA, commitB) => {
+        try {
+            const { config } = parseConfigOptions(cmd);
+            const catalog = buildCatalog(config);
+            const opts = cmd.opts();
+            let a;
+            let b;
+            if (opts.scope === 'staged') {
+                a = 'HEAD';
+                b = '--cached'; // git diff --cached
+            }
+            else if (opts.scope === 'working') {
+                a = 'HEAD';
+                b = ''; // git diff (working tree)
+            }
+            else {
+                a = commitA ?? 'HEAD~1';
+                b = commitB ?? 'HEAD';
+            }
+            // Find the worktree root (where .git is)
+            const cwd = process.cwd();
+            let root = cwd;
+            const fs = await import('fs');
+            while (root !== path.dirname(root)) {
+                if (fs.existsSync(path.join(root, '.git')))
+                    break;
+                root = path.dirname(root);
+            }
+            const result = traceGitDiff(catalog, a, b, root);
+            if (opts.format === 'json') {
+                // JSON to stdout for programmatic consumption
+                const jsonOutput = result.refChanges.map(c => ({
+                    element: {
+                        id: c.element.id,
+                        name: c.element.name,
+                        category: c.element.categoryName,
+                        libraryId: c.element.toLibraryId(),
+                    },
+                    ref: c.ref,
+                    changeType: c.changeType,
+                }));
+                process.stdout.write(JSON.stringify(jsonOutput, null, 2) + '\n');
+            }
+            else {
+                // Human-readable output to stderr
+                const output = formatDiffTrace(result, catalog);
+                console.error(output);
+            }
+            process.exit(0);
+        }
+        catch (e) {
+            console.error(`Error: ${e.message}`);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=diff.js.map

package/dist/cli/commands/diff.js.map

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

package/dist/cli/commands/edit.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function editCommand(): Command;
+//# sourceMappingURL=edit.d.ts.map

package/dist/cli/commands/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,WAAW,IAAI,OAAO,CAuFrC"}

package/dist/cli/commands/edit.js

@@ -0,0 +1,93 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as yaml from 'js-yaml';
+import { randomUUID } from 'crypto';
+import { parseConfigOptions, buildCatalog, requireUserIdentity } from '../helpers.js';
+export function editCommand() {
+    const cmd = new Command('edit')
+        .description('Edit an existing element')
+        .argument('<element>', 'Element ID (e.g., P1, gvp:P1)')
+        .option('-f, --field <key=value...>', 'Set field values')
+        .option('--rationale <text>', 'Rationale for the change (required unless --skip-review)')
+        .option('--skip-review', 'Mark this update as skip-review (DEC-4.6)')
+        .action(async (elementArg) => {
+        try {
+            const { config } = parseConfigOptions(cmd);
+            const catalog = buildCatalog(config);
+            const opts = cmd.opts();
+            const element = catalog.getAllElements().find(e => e.id === elementArg || e.toLibraryId() === elementArg || e.hashKey() === elementArg);
+            if (!element) {
+                console.error(`Element '${elementArg}' not found`);
+                process.exit(1);
+            }
+            if (!opts.field || opts.field.length === 0) {
+                console.error('No fields specified. Use --field key=value to set fields.');
+                process.exit(1);
+            }
+            // Require rationale unless skip-review
+            if (!opts.skipReview && !opts.rationale) {
+                console.error('--rationale is required unless --skip-review is set');
+                process.exit(1);
+            }
+            // Find the document containing this element
+            const doc = catalog.documents.find(d => d.getAllElements().some(e => e.hashKey() === element.hashKey()));
+            if (!doc) {
+                console.error('Document not found');
+                process.exit(1);
+            }
+            const catDef = catalog.registry.getByName(element.categoryName);
+            if (!catDef) {
+                console.error('Category not found');
+                process.exit(1);
+            }
+            // Read and modify YAML
+            const content = fs.readFileSync(doc.filePath, 'utf-8');
+            const data = yaml.load(content);
+            const items = data[catDef.yaml_key];
+            const target = items?.find(item => item.id === element.id);
+            if (!target) {
+                console.error('Element not found in YAML');
+                process.exit(1);
+            }
+            // Apply field changes
+            for (const entry of opts.field) {
+                const eqIdx = entry.indexOf('=');
+                if (eqIdx > 0) {
+                    const key = entry.substring(0, eqIdx);
+                    const value = entry.substring(eqIdx + 1);
+                    try {
+                        target[key] = JSON.parse(value);
+                    }
+                    catch {
+                        target[key] = value;
+                    }
+                }
+            }
+            // Add updated_by provenance (DEC-4.7)
+            const user = requireUserIdentity(config);
+            const updateEntry = {
+                id: randomUUID(),
+                date: new Date().toISOString(),
+                rationale: opts.rationale ?? 'skip-review update',
+                by: user,
+            };
+            if (opts.skipReview)
+                updateEntry.skip_review = true;
+            if (!target.updated_by)
+                target.updated_by = [];
+            target.updated_by.push(updateEntry);
+            // Write back
+            fs.writeFileSync(doc.filePath, yaml.dump(data, {
+                lineWidth: -1, noRefs: true, sortKeys: false,
+            }));
+            const skipLabel = opts.skipReview ? ' [skip-review]' : '';
+            console.error(`Updated ${element.toLibraryId()}${skipLabel}`);
+        }
+        catch (e) {
+            console.error(`Error: ${e.message}`);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=edit.js.map

package/dist/cli/commands/edit.js.map

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

package/dist/cli/commands/export.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function exportCommand(): Command;
+//# sourceMappingURL=export.d.ts.map

package/dist/cli/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,aAAa,IAAI,OAAO,CA0CvC"}

package/dist/cli/commands/export.js

@@ -0,0 +1,46 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { parseConfigOptions, buildCatalog } from '../helpers.js';
+import { createExporterRegistry } from '../../exporters/registry.js';
+export function exportCommand() {
+    const cmd = new Command('export')
+        .description('Export the GVP catalog to a format')
+        .option('-f, --format <format>', 'Output format (json, csv, markdown)', 'json')
+        .option('-o, --output <path>', 'Output file path (default: stdout)')
+        .option('--include-deprecated', 'Include deprecated/rejected elements')
+        .action(async () => {
+        try {
+            const { config } = parseConfigOptions(cmd);
+            const catalog = buildCatalog(config);
+            const registry = createExporterRegistry();
+            const opts = cmd.opts();
+            const format = opts.format;
+            const exporter = registry.get(format);
+            if (!exporter) {
+                const available = [...registry.keys()].join(', ');
+                console.error(`Unknown format '${format}'. Available: ${available}`);
+                process.exit(1);
+            }
+            const output = exporter.export(catalog, {
+                includeDeprecated: opts.includeDeprecated,
+            });
+            if (opts.output) {
+                const outPath = path.resolve(opts.output);
+                fs.mkdirSync(path.dirname(outPath), { recursive: true });
+                fs.writeFileSync(outPath, output);
+                console.error(`Exported to ${outPath}`);
+            }
+            else {
+                // stdout for structured output (DEC-5.12)
+                process.stdout.write(output);
+            }
+        }
+        catch (e) {
+            console.error(`Error: ${e.message}`);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;SAC9B,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,uBAAuB,EAAE,qCAAqC,EAAE,MAAM,CAAC;SAC9E,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;SACnE,MAAM,CAAC,sBAAsB,EAAE,sCAAsC,CAAC;SACtE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;YAE1C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgB,CAAC;YACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClD,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,iBAAiB,SAAS,EAAE,CAAC,CAAC;gBACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE;gBACtC,iBAAiB,EAAE,IAAI,CAAC,iBAA4B;aACrD,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAgB,CAAC,CAAC;gBACpD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzD,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAClC,OAAO,CAAC,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,0CAA0C;gBAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,UAAW,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function initCommand(): Command;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,WAAW,IAAI,OAAO,CAgBrC"}

package/dist/cli/commands/init.js

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+export function initCommand() {
+    const cmd = new Command('init')
+        .description('Initialize a GVP library in the current project')
+        .action(async () => {
+        const libDir = path.join(process.cwd(), '.gvp', 'library');
+        if (fs.existsSync(libDir)) {
+            console.error('.gvp/library/ already exists');
+            process.exit(1);
+        }
+        fs.mkdirSync(libDir, { recursive: true });
+        const projectName = path.basename(process.cwd());
+        const starter = `meta:\n  name: ${projectName}\n  scope: project\n\ngoals:\n  - id: G1\n    name: \n    statement: \n    tags: []\n    maps_to: []\n`;
+        fs.writeFileSync(path.join(libDir, 'project.yaml'), starter);
+        console.error(`Initialized GVP library at ${libDir}. Run 'cairn validate' to check it.`);
+    });
+    return cmd;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;SAC5B,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3D,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,kBAAkB,WAAW,wGAAwG,CAAC;QACtJ,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,8BAA8B,MAAM,qCAAqC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IACL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/commands/inspect.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function inspectCommand(): Command;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/cli/commands/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,cAAc,IAAI,OAAO,CAgKxC"}