@principled/cairn 1.0.0-beta

package/dist/validation/passes/traceability-pass.js.map

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

package/dist/validation/passes/user-rules-pass.d.ts

@@ -0,0 +1,9 @@
+import type { Catalog } from '../../catalog/catalog.js';
+import type { GVPConfig } from '../../config/schema.js';
+import type { Diagnostic } from '../diagnostic.js';
+/**
+ * User-defined validation rules (VAL-6, DEC-5.2, DEC-5.10).
+ * User diagnostic codes use U prefix (DEC-5.10).
+ */
+export declare function userRulesPass(catalog: Catalog, config: GVPConfig): Diagnostic[];
+//# sourceMappingURL=user-rules-pass.d.ts.map

package/dist/validation/passes/user-rules-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-rules-pass.d.ts","sourceRoot":"","sources":["../../../src/validation/passes/user-rules-pass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AA8BvE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,EAAE,CA4E/E"}

package/dist/validation/passes/user-rules-pass.js

@@ -0,0 +1,72 @@
+import { createDiagnostic } from '../diagnostic.js';
+const PASS_NAME = 'user_rules';
+let ruleCounter = 0;
+/**
+ * User-defined validation rules (VAL-6, DEC-5.2, DEC-5.10).
+ * User diagnostic codes use U prefix (DEC-5.10).
+ */
+export function userRulesPass(catalog, config) {
+    const diagnostics = [];
+    const rules = (config.validation_rules ?? []);
+    ruleCounter = 0;
+    for (const rule of rules) {
+        ruleCounter++;
+        const code = `U${String(ruleCounter).padStart(3, '0')}`;
+        const ruleName = rule.name ?? `rule_${ruleCounter}`;
+        const severity = rule.severity ?? 'warning';
+        if (!rule.require)
+            continue;
+        for (const element of catalog.getAllElements()) {
+            if (!matchesFilter(element, rule.match, catalog))
+                continue;
+            // Check min_tags
+            if (rule.require.min_tags !== undefined) {
+                if (element.tags.length < rule.require.min_tags) {
+                    diagnostics.push(createDiagnostic(code, `USER_RULE_${ruleName.toUpperCase()}`, `Element ${element.toLibraryId()} has ${element.tags.length} tag(s), minimum required: ${rule.require.min_tags} (rule: ${ruleName})`, severity, PASS_NAME, { elementId: element.id, documentPath: element.documentPath, categoryName: element.categoryName }));
+                }
+            }
+            // Check has_field
+            if (rule.require.has_field !== undefined) {
+                const fieldValue = element.get(rule.require.has_field);
+                if (fieldValue === undefined || fieldValue === null) {
+                    diagnostics.push(createDiagnostic(code, `USER_RULE_${ruleName.toUpperCase()}`, `Element ${element.toLibraryId()} is missing required field '${rule.require.has_field}' (rule: ${ruleName})`, severity, PASS_NAME, {
+                        elementId: element.id,
+                        documentPath: element.documentPath,
+                        categoryName: element.categoryName,
+                        fieldName: rule.require.has_field,
+                    }));
+                }
+            }
+            // Check maps_to_category
+            if (rule.require.maps_to_category !== undefined) {
+                const requiredCat = rule.require.maps_to_category;
+                const mapsToTarget = element.maps_to.some(ref => {
+                    const target = catalog.getAllElements().find(e => e.toLibraryId() === ref || e.hashKey() === ref);
+                    return target?.categoryName === requiredCat;
+                });
+                if (!mapsToTarget && element.maps_to.length > 0) {
+                    diagnostics.push(createDiagnostic(code, `USER_RULE_${ruleName.toUpperCase()}`, `Element ${element.toLibraryId()} does not map to any '${requiredCat}' element (rule: ${ruleName})`, severity, PASS_NAME, { elementId: element.id, documentPath: element.documentPath, categoryName: element.categoryName }));
+                }
+            }
+        }
+    }
+    return diagnostics;
+}
+/** Check if an element matches a rule's filter criteria */
+function matchesFilter(element, match, catalog) {
+    if (!match)
+        return true; // No filter = matches all
+    if (match.category && element.categoryName !== match.category)
+        return false;
+    if (match.tag && !element.tags.includes(match.tag))
+        return false;
+    if (match.status && element.status !== match.status)
+        return false;
+    if (match.scope) {
+        const doc = catalog.documents.find(d => d.documentPath === element.documentPath);
+        if (doc?.meta.scope !== match.scope)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=user-rules-pass.js.map

package/dist/validation/passes/user-rules-pass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-rules-pass.js","sourceRoot":"","sources":["../../../src/validation/passes/user-rules-pass.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,SAAS,GAAG,YAAY,CAAC;AAyB/B,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,MAAiB;IAC/D,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAe,CAAC;IAE5D,WAAW,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,WAAW,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,WAAW,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAuB,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC;QAEhE,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,SAAS;QAE5B,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;YAC/C,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;gBAAE,SAAS;YAE3D,iBAAiB;YACjB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACxC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;oBAChD,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAC/B,IAAI,EACJ,aAAa,QAAQ,CAAC,WAAW,EAAE,EAAE,EACrC,WAAW,OAAO,CAAC,WAAW,EAAE,QAAQ,OAAO,CAAC,IAAI,CAAC,MAAM,8BAA8B,IAAI,CAAC,OAAO,CAAC,QAAQ,WAAW,QAAQ,GAAG,EACpI,QAAQ,EACR,SAAS,EACT,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAClG,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,kBAAkB;YAClB,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACvD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;oBACpD,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAC/B,IAAI,EACJ,aAAa,QAAQ,CAAC,WAAW,EAAE,EAAE,EACrC,WAAW,OAAO,CAAC,WAAW,EAAE,+BAA+B,IAAI,CAAC,OAAO,CAAC,SAAS,YAAY,QAAQ,GAAG,EAC5G,QAAQ,EACR,SAAS,EACT;wBACE,SAAS,EAAE,OAAO,CAAC,EAAE;wBACrB,YAAY,EAAE,OAAO,CAAC,YAAY;wBAClC,YAAY,EAAE,OAAO,CAAC,YAAY;wBAClC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;qBAClC,CACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,yBAAyB;YACzB,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBAChD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;gBAClD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;oBAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAC1C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,GAAG,CACpD,CAAC;oBACF,OAAO,MAAM,EAAE,YAAY,KAAK,WAAW,CAAC;gBAC9C,CAAC,CAAC,CAAC;gBAEH,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChD,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAC/B,IAAI,EACJ,aAAa,QAAQ,CAAC,WAAW,EAAE,EAAE,EACrC,WAAW,OAAO,CAAC,WAAW,EAAE,yBAAyB,WAAW,oBAAoB,QAAQ,GAAG,EACnG,QAAQ,EACR,SAAS,EACT,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAClG,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,2DAA2D;AAC3D,SAAS,aAAa,CAAC,OAAgB,EAAE,KAA4B,EAAE,OAAgB;IACrF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,CAAC,0BAA0B;IAEnD,IAAI,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;QACjF,IAAI,GAAG,EAAE,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;IACpD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/validation/runner.d.ts

@@ -0,0 +1,17 @@
+import type { Catalog } from '../catalog/catalog.js';
+import type { GVPConfig } from '../config/schema.js';
+import type { Diagnostic } from './diagnostic.js';
+/** A validation pass function */
+export type ValidationPass = (catalog: Catalog, config: GVPConfig) => Diagnostic[];
+/**
+ * Run validation passes and apply suppression + strict mode (DEC-5.1, DEC-5.8).
+ *
+ * Processing order (DEC-5.8):
+ * 1. Passes produce Diagnostics
+ * 2. Suppressed codes are removed (exact-match, DEC-5.11)
+ * 3. Strict mode promotes remaining warnings to errors
+ */
+export declare function runValidation(catalog: Catalog, config: GVPConfig, passes: Map<string, ValidationPass>, passNames?: string[]): Diagnostic[];
+/** Check if any diagnostics are errors */
+export declare function hasErrors(diagnostics: Diagnostic[]): boolean;
+//# sourceMappingURL=runner.d.ts.map

package/dist/validation/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/validation/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,iCAAiC;AACjC,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,KAAK,UAAU,EAAE,CAAC;AAEnF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACnC,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,UAAU,EAAE,CAyBd;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAE5D"}

package/dist/validation/runner.js

@@ -0,0 +1,33 @@
+/**
+ * Run validation passes and apply suppression + strict mode (DEC-5.1, DEC-5.8).
+ *
+ * Processing order (DEC-5.8):
+ * 1. Passes produce Diagnostics
+ * 2. Suppressed codes are removed (exact-match, DEC-5.11)
+ * 3. Strict mode promotes remaining warnings to errors
+ */
+export function runValidation(catalog, config, passes, passNames) {
+    // Determine which passes to run
+    const names = passNames ?? [...passes.keys()];
+    // Step 1: Collect diagnostics from all passes
+    let diagnostics = [];
+    for (const name of names) {
+        const pass = passes.get(name);
+        if (pass) {
+            diagnostics.push(...pass(catalog, config));
+        }
+    }
+    // Step 2: Remove suppressed codes (DEC-5.8: suppression wins over strict)
+    const suppressed = new Set(config.suppress_diagnostics ?? []);
+    diagnostics = diagnostics.filter(d => !suppressed.has(d.code));
+    // Step 3: Strict mode promotes warnings to errors
+    if (config.strict) {
+        diagnostics = diagnostics.map(d => d.severity === 'warning' ? { ...d, severity: 'error' } : d);
+    }
+    return diagnostics;
+}
+/** Check if any diagnostics are errors */
+export function hasErrors(diagnostics) {
+    return diagnostics.some(d => d.severity === 'error');
+}
+//# sourceMappingURL=runner.js.map

package/dist/validation/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/validation/runner.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,MAAiB,EACjB,MAAmC,EACnC,SAAoB;IAEpB,gCAAgC;IAChC,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9C,8CAA8C;IAC9C,IAAI,WAAW,GAAiB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,EAAE,CAAC;YACT,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IAC9D,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/D,kDAAkD;IAClD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAChC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,CACpE,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,SAAS,CAAC,WAAyB;IACjD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AACvD,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@principled/cairn",
+  "version": "1.0.0-beta",
+  "description": "Cairn — decision traceability framework. Trace every decision back to what drives it.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "cairn": "./dist/cli/index.js",
+    "gvp": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "src/data/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["cairn", "gvp", "goals", "values", "principles", "traceability", "decisions", "rationale"],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
+    "eslint": "^10.1.0",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "js-yaml": "^4.1.1",
+    "zod": "^4.3.6"
+  }
+}

package/src/data/defaults.yaml

@@ -0,0 +1,101 @@
+# GVP v1 Built-in Category Definitions
+# Per DEC-9.4: loaded through same pipeline as user files (dogfooding)
+
+_all:
+  field_schemas:
+    priority:
+      type: number
+      required: false
+    refs:
+      type: list
+      required: false
+      items:
+        type: model
+        fields:
+          file:
+            type: string
+            required: true
+          identifier:
+            type: string
+            required: true
+          role:
+            type: enum
+            values: ["defines", "implements", "uses", "extends"]
+            required: true
+
+categories:
+  goal:
+    yaml_key: goals
+    id_prefix: G
+    primary_field: statement
+    is_root: true
+    color: "#4CAF50"
+
+  value:
+    yaml_key: values
+    id_prefix: V
+    primary_field: statement
+    is_root: true
+    color: "#2196F3"
+
+  constraint:
+    yaml_key: constraints
+    id_prefix: C
+    primary_field: impact
+    is_root: true
+    color: "#FF9800"
+
+  principle:
+    yaml_key: principles
+    id_prefix: P
+    primary_field: statement
+    mapping_rules:
+      - [goal, value]
+    color: "#9C27B0"
+
+  rule:
+    yaml_key: rules
+    id_prefix: R
+    primary_field: statement
+    mapping_rules:
+      - [goal, value]
+    color: "#F44336"
+
+  heuristic:
+    yaml_key: heuristics
+    id_prefix: H
+    primary_field: statement
+    mapping_rules:
+      - [goal, value]
+      - [principle]
+      - [rule]
+    color: "#00BCD4"
+
+  decision:
+    yaml_key: decisions
+    id_prefix: D
+    primary_field: rationale
+    mapping_rules:
+      - [goal, value]
+    field_schemas:
+      considered:
+        type: dict
+        required: false
+        values:
+          type: model
+          fields:
+            rationale:
+              type: string
+              required: true
+            description:
+              type: string
+              required: false
+    color: "#795548"
+
+  milestone:
+    yaml_key: milestones
+    id_prefix: M
+    primary_field: description
+    mapping_rules:
+      - [goal, value]
+    color: "#607D8B"