@principled/cairn 1.0.0-beta

package/dist/inheritance/reference-parser.js.map

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

package/dist/inheritance/source-resolver.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Interface for resolving source identifiers to local filesystem paths.
+ */
+export interface SourceResolver {
+    resolve(source: string): string;
+}
+/**
+ * Resolves local filesystem source paths (DEC-1.7).
+ * Supports relative and absolute paths with dual lookup (DEC-1.2, DEC-1.10):
+ * 1. Check <path>/gvp/ (standalone GVP repo)
+ * 2. Check <path>/.gvp/library/ (embedded in a project)
+ */
+export declare class LocalSourceResolver implements SourceResolver {
+    private readonly baseDir;
+    constructor(baseDir: string);
+    resolve(source: string): string;
+}
+/**
+ * Stub resolver for git-based sources (DEC-1.9).
+ * Validates commit-ish is present. Full git fetching deferred for alpha.
+ */
+export declare class GitSourceResolver implements SourceResolver {
+    resolve(source: string): string;
+}
+/**
+ * Factory that creates the appropriate resolver based on source format.
+ */
+export declare function createSourceResolver(libraryDir: string): SourceResolver;
+//# sourceMappingURL=source-resolver.d.ts.map

package/dist/inheritance/source-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-resolver.d.ts","sourceRoot":"","sources":["../../src/inheritance/source-resolver.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE5C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAmChC;AAED;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAiChC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAYvE"}

package/dist/inheritance/source-resolver.js

@@ -0,0 +1,87 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { InheritanceError } from '../errors.js';
+/**
+ * Resolves local filesystem source paths (DEC-1.7).
+ * Supports relative and absolute paths with dual lookup (DEC-1.2, DEC-1.10):
+ * 1. Check <path>/gvp/ (standalone GVP repo)
+ * 2. Check <path>/.gvp/library/ (embedded in a project)
+ */
+export class LocalSourceResolver {
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+    }
+    resolve(source) {
+        // Skip non-local sources
+        if (source.startsWith('@') && source !== '@local') {
+            throw new InheritanceError(`LocalSourceResolver cannot resolve remote source '${source}'. Use GitSourceResolver.`);
+        }
+        const resolved = source === '@local'
+            ? this.baseDir
+            : path.isAbsolute(source)
+                ? source
+                : path.resolve(this.baseDir, source);
+        // Dual lookup (DEC-1.2, DEC-1.10): gvp/ wins over .gvp/library/
+        const gvpDir = path.join(resolved, 'gvp');
+        if (fs.existsSync(gvpDir) && fs.statSync(gvpDir).isDirectory()) {
+            return gvpDir;
+        }
+        const dotGvpLibrary = path.join(resolved, '.gvp', 'library');
+        if (fs.existsSync(dotGvpLibrary) && fs.statSync(dotGvpLibrary).isDirectory()) {
+            return dotGvpLibrary;
+        }
+        // If path itself looks like a library directory (contains YAML files)
+        if (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {
+            return resolved;
+        }
+        throw new InheritanceError(`Cannot resolve source '${source}': no library directory found at '${resolved}'. ` +
+            `Checked: ${gvpDir}, ${dotGvpLibrary}, ${resolved}`);
+    }
+}
+/**
+ * Stub resolver for git-based sources (DEC-1.9).
+ * Validates commit-ish is present. Full git fetching deferred for alpha.
+ */
+export class GitSourceResolver {
+    resolve(source) {
+        // Parse @github:user/repo@commitish or @azure:org/project@commitish
+        const match = source.match(/^@(\w+):(.+?)@(.+)$/);
+        if (!match) {
+            // Check if it's a git source without commit-ish
+            const noVersion = source.match(/^@(\w+):(.+)$/);
+            if (noVersion) {
+                throw new InheritanceError(`Git source '${source}' requires an immutable commit-ish (tag or SHA). ` +
+                    `Use '${source}@v1.0.0' or '${source}@abc1234'. Branches are not allowed (DEC-1.9).`);
+            }
+            throw new InheritanceError(`Invalid git source format: '${source}'`);
+        }
+        const [, provider, repoPath, commitish] = match;
+        // Reject branch-like references (no slashes, starts with letter, no dots)
+        // This is a heuristic — exact validation would require git
+        // For alpha, just ensure something is there
+        if (!commitish || commitish.length === 0) {
+            throw new InheritanceError(`Git source '${source}' requires a commit-ish after '@'`);
+        }
+        // For alpha: throw not-implemented
+        throw new InheritanceError(`Git source resolution not yet implemented. ` +
+            `Source: @${provider}:${repoPath}@${commitish}. ` +
+            `For now, use local filesystem paths or clone the repo manually.`);
+    }
+}
+/**
+ * Factory that creates the appropriate resolver based on source format.
+ */
+export function createSourceResolver(libraryDir) {
+    const local = new LocalSourceResolver(libraryDir);
+    const git = new GitSourceResolver();
+    return {
+        resolve(source) {
+            if (source.startsWith('@') && source !== '@local') {
+                return git.resolve(source);
+            }
+            return local.resolve(source);
+        },
+    };
+}
+//# sourceMappingURL=source-resolver.js.map

package/dist/inheritance/source-resolver.js.map

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

package/dist/model/category-registry.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import type { CategoryDefinition, AllFieldSchemas, DefaultsFile } from '../schema/category-definition.js';
+import type { FieldSchemaEntry } from '../schema/field-schema.js';
+/**
+ * Registry of category definitions with lookup and schema caching.
+ * Built from defaults + optional user-defined categories.
+ */
+export declare class CategoryRegistry {
+    private readonly _categories;
+    private readonly _allFieldSchemas;
+    private readonly _schemaCache;
+    constructor(categories: Record<string, CategoryDefinition>, allFieldSchemas?: Record<string, FieldSchemaEntry>);
+    /** Create registry from a DefaultsFile (loaded defaults.yaml) */
+    static fromDefaults(defaults: DefaultsFile): CategoryRegistry;
+    /** Get category definition by name */
+    getByName(name: string): CategoryDefinition | undefined;
+    /** Get category by yaml_key */
+    getByYamlKey(yamlKey: string): {
+        name: string;
+        def: CategoryDefinition;
+    } | undefined;
+    /** Get category by id_prefix */
+    getByIdPrefix(prefix: string): {
+        name: string;
+        def: CategoryDefinition;
+    } | undefined;
+    /** Get all category names */
+    get categoryNames(): string[];
+    /** Get all yaml_keys (used by document parser to identify element sections) */
+    get allYamlKeys(): string[];
+    /** Get all categories as a plain record */
+    get categories(): Record<string, CategoryDefinition>;
+    /** Get the _all field schemas */
+    get allFieldSchemas(): Record<string, FieldSchemaEntry>;
+    /**
+     * Get the element Zod schema for a category (cached).
+     * Merges _all + per-category field_schemas, builds combined reserved+dynamic schema.
+     */
+    getElementSchema(categoryName: string, options?: {
+        defaultTimezone?: string;
+    }): z.ZodObject<Record<string, z.ZodType>>;
+    /**
+     * Create a new registry with additional user categories merged on top.
+     * Per-category wins on collision (DEC-2.8, DEC-3.9).
+     */
+    merge(userCategories: Record<string, CategoryDefinition>, userAll?: AllFieldSchemas): CategoryRegistry;
+}
+//# sourceMappingURL=category-registry.d.ts.map

package/dist/model/category-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-registry.d.ts","sourceRoot":"","sources":["../../src/model/category-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGlE;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmC;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkE;gBAG7F,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC9C,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAM;IAMxD,iEAAiE;IACjE,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB;IAO7D,sCAAsC;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIvD,+BAA+B;IAC/B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,kBAAkB,CAAA;KAAE,GAAG,SAAS;IAOpF,gCAAgC;IAChC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,kBAAkB,CAAA;KAAE,GAAG,SAAS;IAOpF,6BAA6B;IAC7B,IAAI,aAAa,IAAI,MAAM,EAAE,CAE5B;IAED,+EAA+E;IAC/E,IAAI,WAAW,IAAI,MAAM,EAAE,CAE1B;IAED,2CAA2C;IAC3C,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAEnD;IAED,iCAAiC;IACjC,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAEtD;IAED;;;OAGG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAetH;;;OAGG;IACH,KAAK,CACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAClD,OAAO,CAAC,EAAE,eAAe,GACxB,gBAAgB;CAOpB"}

package/dist/model/category-registry.js

@@ -0,0 +1,83 @@
+import { buildCategoryElementSchema } from '../schema/defaults-loader.js';
+/**
+ * Registry of category definitions with lookup and schema caching.
+ * Built from defaults + optional user-defined categories.
+ */
+export class CategoryRegistry {
+    _categories;
+    _allFieldSchemas;
+    _schemaCache = new Map();
+    constructor(categories, allFieldSchemas = {}) {
+        this._categories = new Map(Object.entries(categories));
+        this._allFieldSchemas = allFieldSchemas;
+    }
+    /** Create registry from a DefaultsFile (loaded defaults.yaml) */
+    static fromDefaults(defaults) {
+        return new CategoryRegistry(defaults.categories, defaults._all?.field_schemas ?? {});
+    }
+    /** Get category definition by name */
+    getByName(name) {
+        return this._categories.get(name);
+    }
+    /** Get category by yaml_key */
+    getByYamlKey(yamlKey) {
+        for (const [name, def] of this._categories) {
+            if (def.yaml_key === yamlKey)
+                return { name, def };
+        }
+        return undefined;
+    }
+    /** Get category by id_prefix */
+    getByIdPrefix(prefix) {
+        for (const [name, def] of this._categories) {
+            if (def.id_prefix === prefix)
+                return { name, def };
+        }
+        return undefined;
+    }
+    /** Get all category names */
+    get categoryNames() {
+        return [...this._categories.keys()];
+    }
+    /** Get all yaml_keys (used by document parser to identify element sections) */
+    get allYamlKeys() {
+        return [...this._categories.values()].map(c => c.yaml_key);
+    }
+    /** Get all categories as a plain record */
+    get categories() {
+        return Object.fromEntries(this._categories);
+    }
+    /** Get the _all field schemas */
+    get allFieldSchemas() {
+        return this._allFieldSchemas;
+    }
+    /**
+     * Get the element Zod schema for a category (cached).
+     * Merges _all + per-category field_schemas, builds combined reserved+dynamic schema.
+     */
+    getElementSchema(categoryName, options) {
+        const cacheKey = `${categoryName}:${options?.defaultTimezone ?? ''}`;
+        const cached = this._schemaCache.get(cacheKey);
+        if (cached)
+            return cached;
+        const def = this._categories.get(categoryName);
+        if (!def) {
+            throw new Error(`Unknown category: '${categoryName}'`);
+        }
+        const schema = buildCategoryElementSchema(def, this._allFieldSchemas, options);
+        this._schemaCache.set(cacheKey, schema);
+        return schema;
+    }
+    /**
+     * Create a new registry with additional user categories merged on top.
+     * Per-category wins on collision (DEC-2.8, DEC-3.9).
+     */
+    merge(userCategories, userAll) {
+        const mergedCategories = { ...this.categories, ...userCategories };
+        const mergedAll = userAll?.field_schemas
+            ? { ...this._allFieldSchemas, ...userAll.field_schemas }
+            : this._allFieldSchemas;
+        return new CategoryRegistry(mergedCategories, mergedAll);
+    }
+}
+//# sourceMappingURL=category-registry.js.map

package/dist/model/category-registry.js.map

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

package/dist/model/document-meta.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+/** Config override entry (DEC-2.4, DEC-2.13) */
+export declare const configOverrideEntrySchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        replace: "replace";
+        additive: "additive";
+    }>;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+/** Document meta schema */
+export declare const documentMetaSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    id_prefix: z.ZodOptional<z.ZodString>;
+    inherits: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        as: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        source: z.ZodString;
+        as: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>>;
+    scope: z.ZodOptional<z.ZodString>;
+    defaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    definitions: z.ZodOptional<z.ZodObject<{
+        tags: z.ZodOptional<z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodTransform<Record<string, {
+            description: string;
+        }>, Record<string, unknown>>>>;
+        categories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../schema/category-definition.js").CategoryDefinition, unknown, z.core.$ZodTypeInternals<import("../schema/category-definition.js").CategoryDefinition, unknown>>>>;
+    }, z.core.$strip>>;
+    config_overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        mode: z.ZodEnum<{
+            replace: "replace";
+            additive: "additive";
+        }>;
+        value: z.ZodUnknown;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
+export type DocumentMeta = z.infer<typeof documentMetaSchema>;
+//# sourceMappingURL=document-meta.d.ts.map

package/dist/model/document-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-meta.d.ts","sourceRoot":"","sources":["../../src/model/document-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsCxB,gDAAgD;AAChD,eAAO,MAAM,yBAAyB;;;;;;iBAGpC,CAAC;AAEH,2BAA2B;AAC3B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;yBA9Ba,MAAM;;;;;;;;;;;iBAiDlC,CAAC;AAEjB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/model/document-meta.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { categoryDefinitionSchema } from '../schema/category-definition.js';
+/** Single tag definition */
+const tagEntrySchema = z.object({
+    description: z.string(),
+});
+/**
+ * Tag definitions: accepts both flat format (DEC-2.14) and nested v0 format.
+ * Flat: { framework: { description: ... }, tooling: { description: ... } }
+ * Nested: { domains: { framework: { description: ... } }, concerns: { ... } }
+ * Nested format is flattened during parsing.
+ */
+const tagDefinitionSchema = z.record(z.string(), z.unknown()).transform((raw) => {
+    const flat = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (value && typeof value === 'object' && 'description' in value) {
+            // Flat format: { tagname: { description: "..." } }
+            flat[key] = value;
+        }
+        else if (value && typeof value === 'object') {
+            // Nested format: { groupname: { tagname: { description: "..." }, ... } }
+            for (const [innerKey, innerValue] of Object.entries(value)) {
+                if (innerValue && typeof innerValue === 'object' && 'description' in innerValue) {
+                    flat[innerKey] = innerValue;
+                }
+            }
+        }
+    }
+    return flat;
+});
+/** Document definitions block */
+const definitionsSchema = z.object({
+    tags: tagDefinitionSchema.optional(),
+    categories: z.record(z.string(), categoryDefinitionSchema).optional(),
+}).optional();
+/** Config override entry (DEC-2.4, DEC-2.13) */
+export const configOverrideEntrySchema = z.object({
+    mode: z.enum(['replace', 'additive']),
+    value: z.unknown(),
+});
+/** Document meta schema */
+export const documentMetaSchema = z.object({
+    name: z.string().optional(),
+    id_prefix: z.string().optional(), // DOM-2: per-document id prefix
+    inherits: z.union([
+        z.string().transform(s => [s]), // bare string -> array
+        z.array(z.string()),
+        z.array(z.object({
+            source: z.string(),
+            as: z.string().optional(),
+        })),
+        z.array(z.union([
+            z.string(),
+            z.object({ source: z.string(), as: z.string().optional() }),
+        ])),
+    ]).optional(),
+    scope: z.string().optional(),
+    defaults: z.record(z.string(), z.unknown()).optional(),
+    definitions: definitionsSchema,
+    config_overrides: z.record(z.string(), configOverrideEntrySchema).optional(), // DEC-2.4, DEC-2.13
+}).passthrough();
+//# sourceMappingURL=document-meta.js.map

package/dist/model/document-meta.js.map

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

package/dist/model/document-parser.d.ts

@@ -0,0 +1,17 @@
+import { Document } from './document.js';
+import type { CategoryRegistry } from './category-registry.js';
+/**
+ * Parse a GVP YAML document string into a Document object.
+ *
+ * Steps:
+ * 1. Parse YAML
+ * 2. Extract and validate meta block
+ * 3. For each recognized yaml_key, parse elements against category schema
+ * 4. Apply document-level defaults (DEC-2.5: per-document only, no cascade)
+ */
+export declare function parseDocument(yamlContent: string, filePath: string, documentPath: string, source: string, registry: CategoryRegistry): Document;
+/**
+ * Load and parse a GVP YAML document from a file path.
+ */
+export declare function loadDocumentFromFile(filePath: string, documentPath: string, source: string, registry: CategoryRegistry): Document;
+//# sourceMappingURL=document-parser.d.ts.map

package/dist/model/document-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-parser.d.ts","sourceRoot":"","sources":["../../src/model/document-parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,GACzB,QAAQ,CAqDV;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,GACzB,QAAQ,CAIV"}

package/dist/model/document-parser.js

@@ -0,0 +1,66 @@
+import * as yaml from 'js-yaml';
+import { documentMetaSchema } from './document-meta.js';
+import { Document } from './document.js';
+import { Element } from './element.js';
+import { ValidationError } from '../errors.js';
+/**
+ * Parse a GVP YAML document string into a Document object.
+ *
+ * Steps:
+ * 1. Parse YAML
+ * 2. Extract and validate meta block
+ * 3. For each recognized yaml_key, parse elements against category schema
+ * 4. Apply document-level defaults (DEC-2.5: per-document only, no cascade)
+ */
+export function parseDocument(yamlContent, filePath, documentPath, source, registry) {
+    const raw = yaml.load(yamlContent);
+    if (!raw || typeof raw !== 'object') {
+        throw new ValidationError(`Document at ${filePath} must be a YAML mapping`);
+    }
+    const data = raw;
+    // Extract and validate meta
+    const rawMeta = data.meta ?? {};
+    const meta = documentMetaSchema.parse(rawMeta);
+    // Parse elements by category
+    const elementsByCategory = new Map();
+    for (const yamlKey of registry.allYamlKeys) {
+        const rawElements = data[yamlKey];
+        if (!rawElements || !Array.isArray(rawElements))
+            continue;
+        const categoryLookup = registry.getByYamlKey(yamlKey);
+        if (!categoryLookup)
+            continue;
+        const { name: categoryName } = categoryLookup;
+        const schema = registry.getElementSchema(categoryName);
+        const elements = [];
+        for (let i = 0; i < rawElements.length; i++) {
+            const rawElement = rawElements[i];
+            if (!rawElement || typeof rawElement !== 'object') {
+                throw new ValidationError(`Element at ${filePath}:${yamlKey}[${i}] must be a YAML mapping`);
+            }
+            // Apply document-level defaults (DEC-2.5: element fields win)
+            const withDefaults = meta.defaults
+                ? { ...meta.defaults, ...rawElement }
+                : rawElement;
+            // Validate against category schema
+            try {
+                const validated = schema.parse(withDefaults);
+                elements.push(new Element(validated, categoryName, source, documentPath));
+            }
+            catch (e) {
+                throw new ValidationError(`Invalid element at ${filePath}:${yamlKey}[${i}] (${rawElement.id ?? 'unknown'}): ${e.message}`);
+            }
+        }
+        elementsByCategory.set(categoryName, elements);
+    }
+    return new Document(meta, elementsByCategory, filePath, documentPath, source);
+}
+/**
+ * Load and parse a GVP YAML document from a file path.
+ */
+export function loadDocumentFromFile(filePath, documentPath, source, registry) {
+    const fs = require('fs');
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return parseDocument(content, filePath, documentPath, source, registry);
+}
+//# sourceMappingURL=document-parser.js.map

package/dist/model/document-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-parser.js","sourceRoot":"","sources":["../../src/model/document-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,QAAgB,EAChB,YAAoB,EACpB,MAAc,EACd,QAA0B;IAE1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,eAAe,CAAC,eAAe,QAAQ,yBAAyB,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,IAAI,GAAG,GAA8B,CAAC;IAE5C,4BAA4B;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE/C,6BAA6B;IAC7B,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAqB,CAAC;IAExD,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAAE,SAAS;QAE1D,MAAM,cAAc,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,cAAc;YAAE,SAAS;QAE9B,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,cAAc,CAAC;QAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAClD,MAAM,IAAI,eAAe,CACvB,cAAc,QAAQ,IAAI,OAAO,IAAI,CAAC,0BAA0B,CACjE,CAAC;YACJ,CAAC;YAED,8DAA8D;YAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ;gBAChC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,UAAU,EAAE;gBACrC,CAAC,CAAC,UAAU,CAAC;YAEf,mCAAmC;YACnC,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBAC7C,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,SAAoC,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;YACvG,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,eAAe,CACvB,sBAAsB,QAAQ,IAAI,OAAO,IAAI,CAAC,MAAO,UAAsC,CAAC,EAAE,IAAI,SAAS,MAAO,CAAW,CAAC,OAAO,EAAE,CACxI,CAAC;YACJ,CAAC;QACH,CAAC;QAED,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,YAAoB,EACpB,MAAc,EACd,QAA0B;IAE1B,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAwB,CAAC;IAChD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/model/document.d.ts

@@ -0,0 +1,27 @@
+import type { DocumentMeta } from './document-meta.js';
+import type { Element } from './element.js';
+import type { CategoryDefinition } from '../schema/category-definition.js';
+/**
+ * A loaded GVP YAML document.
+ */
+export declare class Document {
+    readonly meta: DocumentMeta;
+    readonly filePath: string;
+    readonly documentPath: string;
+    readonly source: string;
+    private readonly _elementsByCategory;
+    constructor(meta: DocumentMeta, elementsByCategory: Map<string, Element[]>, filePath: string, documentPath: string, source: string);
+    /** Get elements for a specific category */
+    getElementsByCategory(categoryName: string): Element[];
+    /** Get all elements across all categories */
+    getAllElements(): Element[];
+    /** Get tag definitions from meta.definitions.tags */
+    getTagDefinitions(): Record<string, {
+        description: string;
+    }>;
+    /** Get user-defined category definitions from meta.definitions.categories */
+    getCategoryDefinitions(): Record<string, CategoryDefinition>;
+    /** Get document name (from meta.name, falls back to documentPath) */
+    get name(): string;
+}
+//# sourceMappingURL=document.d.ts.map

package/dist/model/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/model/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E;;GAEG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;gBAG3D,IAAI,EAAE,YAAY,EAClB,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAC1C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM;IAShB,2CAA2C;IAC3C,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,EAAE;IAItD,6CAA6C;IAC7C,cAAc,IAAI,OAAO,EAAE;IAQ3B,qDAAqD;IACrD,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAI5D,6EAA6E;IAC7E,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAI5D,qEAAqE;IACrE,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/model/document.js

@@ -0,0 +1,42 @@
+/**
+ * A loaded GVP YAML document.
+ */
+export class Document {
+    meta;
+    filePath;
+    documentPath; // relative path without extension
+    source;
+    _elementsByCategory;
+    constructor(meta, elementsByCategory, filePath, documentPath, source) {
+        this.meta = meta;
+        this._elementsByCategory = elementsByCategory;
+        this.filePath = filePath;
+        this.documentPath = documentPath;
+        this.source = source;
+    }
+    /** Get elements for a specific category */
+    getElementsByCategory(categoryName) {
+        return this._elementsByCategory.get(categoryName) ?? [];
+    }
+    /** Get all elements across all categories */
+    getAllElements() {
+        const all = [];
+        for (const elements of this._elementsByCategory.values()) {
+            all.push(...elements);
+        }
+        return all;
+    }
+    /** Get tag definitions from meta.definitions.tags */
+    getTagDefinitions() {
+        return this.meta.definitions?.tags ?? {};
+    }
+    /** Get user-defined category definitions from meta.definitions.categories */
+    getCategoryDefinitions() {
+        return (this.meta.definitions?.categories ?? {});
+    }
+    /** Get document name (from meta.name, falls back to documentPath) */
+    get name() {
+        return this.meta.name ?? this.documentPath;
+    }
+}
+//# sourceMappingURL=document.js.map

package/dist/model/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/model/document.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,QAAQ;IACV,IAAI,CAAe;IACnB,QAAQ,CAAS;IACjB,YAAY,CAAS,CAAC,kCAAkC;IACxD,MAAM,CAAS;IACP,mBAAmB,CAAyB;IAE7D,YACE,IAAkB,EAClB,kBAA0C,EAC1C,QAAgB,EAChB,YAAoB,EACpB,MAAc;QAEd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,2CAA2C;IAC3C,qBAAqB,CAAC,YAAoB;QACxC,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,6CAA6C;IAC7C,cAAc;QACZ,MAAM,GAAG,GAAc,EAAE,CAAC;QAC1B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC;YACzD,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,qDAAqD;IACrD,iBAAiB;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,6EAA6E;IAC7E,sBAAsB;QACpB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,IAAI,EAAE,CAAuC,CAAC;IACzF,CAAC;IAED,qEAAqE;IACrE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC;IAC7C,CAAC;CACF"}

package/dist/model/element.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A single GVP element (DEC-6.2, DEC-6.3, DEC-6.4).
+ *
+ * Identity: (source, documentPath, id)
+ * Equality: equals() compares identity tuple
+ * String reps: toString(), toLibraryId(), toCanonicalId()
+ */
+export declare class Element {
+    readonly id: string;
+    readonly name: string;
+    readonly status: string;
+    readonly tags: string[];
+    readonly maps_to: string[];
+    readonly priority: number | undefined;
+    readonly categoryName: string;
+    readonly source: string;
+    readonly documentPath: string;
+    /** All data including reserved + dynamic fields */
+    private readonly _data;
+    constructor(data: Record<string, unknown>, categoryName: string, source: string, documentPath: string);
+    /** Get a dynamic field value by name */
+    get(fieldName: string): unknown;
+    /** Get all data as a plain record */
+    get data(): Record<string, unknown>;
+    /**
+     * Human-readable display form (DEC-6.4).
+     * E.g., 'V1: "Alignment"'
+     */
+    toString(): string;
+    /**
+     * Within-library qualified reference (DEC-6.4, DEC-1.1c 2-segment).
+     * E.g., 'values:V1'
+     */
+    toLibraryId(): string;
+    /**
+     * Fully qualified canonical ID (DEC-6.4, DEC-1.1b).
+     * E.g., '@github:company/org-gvp:values:V1'
+     */
+    toCanonicalId(): string;
+    /**
+     * Stable hash key for use as Map key (DEC-6.2).
+     * Based on (source, documentPath, id) tuple.
+     */
+    hashKey(): string;
+    /**
+     * Identity equality (DEC-6.2, DEC-6.3).
+     * Based on (source, documentPath, id). Priority does NOT affect equality.
+     */
+    equals(other: Element): boolean;
+}
+//# sourceMappingURL=element.d.ts.map

package/dist/model/element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../src/model/element.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;gBAG9C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM;IActB,wCAAwC;IACxC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,qCAAqC;IACrC,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC;IAED;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAIjB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAOhC"}