@kynetic-ai/spec 0.1.0

package/dist/parser/assess.js.map

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

package/dist/parser/convention-validation.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Convention validation module.
+ *
+ * Validates content against convention rules with domain-specific strategies.
+ */
+import type { Convention } from '../schema/meta.js';
+/**
+ * Convention validation error
+ */
+export interface ConventionValidationError {
+    domain: string;
+    message: string;
+    location?: string;
+    expected?: string;
+}
+/**
+ * Convention validation result
+ */
+export interface ConventionValidationResult {
+    valid: boolean;
+    errors: ConventionValidationError[];
+    skipped: string[];
+    stats: {
+        conventionsChecked: number;
+        conventionsSkipped: number;
+    };
+}
+/**
+ * Validate content against a single convention
+ *
+ * @param content - The content to validate
+ * @param convention - The convention to validate against
+ * @returns Validation error if validation fails, null otherwise
+ */
+export declare function validateConvention(content: string, convention: Convention): ConventionValidationError | null;
+/**
+ * Validate multiple conventions
+ *
+ * This is a lower-level API that validates content against a list of conventions.
+ * For full validation of a project's conventions against actual content,
+ * use the higher-level validateProjectConventions function.
+ *
+ * @param conventions - Array of conventions to check
+ * @param contentMap - Map of domain to content (e.g., { commits: "feat: add feature" })
+ * @returns Validation result
+ */
+export declare function validateConventions(conventions: Convention[], contentMap: Record<string, string>): ConventionValidationResult;
+//# sourceMappingURL=convention-validation.d.ts.map

package/dist/parser/convention-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-validation.d.ts","sourceRoot":"","sources":["../../src/parser/convention-validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,mBAAmB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE;QACL,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AA8GD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACrB,yBAAyB,GAAG,IAAI,CAyBlC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,UAAU,EAAE,EACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,0BAA0B,CAsC5B"}

package/dist/parser/convention-validation.js

@@ -0,0 +1,167 @@
+/**
+ * Convention validation module.
+ *
+ * Validates content against convention rules with domain-specific strategies.
+ */
+/**
+ * Validate content against a regex pattern
+ */
+function validateRegex(content, validation, domain) {
+    if (!validation.pattern) {
+        return {
+            domain,
+            message: 'Regex validation requires a pattern',
+        };
+    }
+    try {
+        const regex = new RegExp(validation.pattern);
+        if (!regex.test(content)) {
+            return {
+                domain,
+                message: validation.message || `Content does not match required pattern`,
+                expected: validation.pattern,
+            };
+        }
+    }
+    catch (err) {
+        return {
+            domain,
+            message: `Invalid regex pattern: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    return null;
+}
+/**
+ * Validate content against an enum of allowed values
+ */
+function validateEnum(content, validation, domain) {
+    if (!validation.allowed || validation.allowed.length === 0) {
+        return {
+            domain,
+            message: 'Enum validation requires an allowed list',
+        };
+    }
+    if (!validation.allowed.includes(content.trim())) {
+        return {
+            domain,
+            message: validation.message || `Value not in allowed list`,
+            expected: `One of: ${validation.allowed.join(', ')}`,
+        };
+    }
+    return null;
+}
+/**
+ * Validate content against a range (word count, character count, or line count)
+ */
+function validateRange(content, validation, domain) {
+    const unit = validation.unit || 'words';
+    let count;
+    switch (unit) {
+        case 'words':
+            count = content.trim().split(/\s+/).filter(w => w.length > 0).length;
+            break;
+        case 'chars':
+            count = content.length;
+            break;
+        case 'lines':
+            count = content.split('\n').length;
+            break;
+        default:
+            return {
+                domain,
+                message: `Unknown unit: ${unit}`,
+            };
+    }
+    const min = validation.min;
+    const max = validation.max;
+    if (min !== undefined && count < min) {
+        return {
+            domain,
+            message: validation.message || `Content too short: ${count} ${unit}, minimum ${min} ${unit}`,
+        };
+    }
+    if (max !== undefined && count > max) {
+        return {
+            domain,
+            message: validation.message || `Content too long: ${count} ${unit}, maximum ${max} ${unit}`,
+        };
+    }
+    return null;
+}
+/**
+ * Validate content against a single convention
+ *
+ * @param content - The content to validate
+ * @param convention - The convention to validate against
+ * @returns Validation error if validation fails, null otherwise
+ */
+export function validateConvention(content, convention) {
+    if (!convention.validation) {
+        // Convention has no validation config - it's advisory only
+        return null;
+    }
+    const { validation } = convention;
+    const domain = convention.domain;
+    switch (validation.type) {
+        case 'regex':
+            return validateRegex(content, validation, domain);
+        case 'enum':
+            return validateEnum(content, validation, domain);
+        case 'range':
+            return validateRange(content, validation, domain);
+        case 'prose':
+            // Prose conventions are advisory only - no validation
+            return null;
+        default:
+            return {
+                domain,
+                message: `Unknown validation type: ${validation.type}`,
+            };
+    }
+}
+/**
+ * Validate multiple conventions
+ *
+ * This is a lower-level API that validates content against a list of conventions.
+ * For full validation of a project's conventions against actual content,
+ * use the higher-level validateProjectConventions function.
+ *
+ * @param conventions - Array of conventions to check
+ * @param contentMap - Map of domain to content (e.g., { commits: "feat: add feature" })
+ * @returns Validation result
+ */
+export function validateConventions(conventions, contentMap) {
+    const errors = [];
+    const skipped = [];
+    let checked = 0;
+    for (const convention of conventions) {
+        if (!convention.validation) {
+            skipped.push(convention.domain);
+            continue;
+        }
+        if (convention.validation.type === 'prose') {
+            skipped.push(convention.domain);
+            continue;
+        }
+        const content = contentMap[convention.domain];
+        if (content === undefined) {
+            // No content provided for this domain - skip
+            continue;
+        }
+        checked++;
+        const error = validateConvention(content, convention);
+        if (error) {
+            errors.push(error);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        skipped,
+        stats: {
+            conventionsChecked: checked,
+            conventionsSkipped: skipped.length,
+        },
+    };
+}
+//# sourceMappingURL=convention-validation.js.map

package/dist/parser/convention-validation.js.map

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

package/dist/parser/fix.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Auto-fix module for kspec validation issues.
+ *
+ * Provides automatic fixes for common validation problems:
+ * - Invalid ULIDs (regenerate)
+ * - Missing timestamps (add current time)
+ * - Missing status objects (add defaults)
+ */
+/**
+ * A single fix that was applied
+ */
+export interface AppliedFix {
+    file: string;
+    path: string;
+    type: 'ulid_regenerated' | 'timestamp_added' | 'status_added';
+    oldValue?: unknown;
+    newValue: unknown;
+}
+/**
+ * Result of running fixes on a project
+ */
+export interface FixResult {
+    filesModified: number;
+    fixesApplied: AppliedFix[];
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/**
+ * Fix issues in a single file
+ */
+export declare function fixFile(filePath: string): Promise<AppliedFix[]>;
+/**
+ * Fix issues across multiple files
+ */
+export declare function fixFiles(filePaths: string[]): Promise<FixResult>;
+//# sourceMappingURL=fix.d.ts.map

package/dist/parser/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../src/parser/fix.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,cAAc,CAAC;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AA+GD;;GAEG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoDrE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAuBtE"}

package/dist/parser/fix.js

@@ -0,0 +1,185 @@
+/**
+ * Auto-fix module for kspec validation issues.
+ *
+ * Provides automatic fixes for common validation problems:
+ * - Invalid ULIDs (regenerate)
+ * - Missing timestamps (add current time)
+ * - Missing status objects (add defaults)
+ */
+import { ulid } from 'ulid';
+import { ulidPattern } from '../schema/common.js';
+import { readYamlFile, writeYamlFilePreserveFormat } from './yaml.js';
+// ============================================================
+// ULID VALIDATION
+// ============================================================
+/**
+ * Check if a string is a valid ULID
+ */
+function isValidUlid(value) {
+    return typeof value === 'string' && ulidPattern.test(value);
+}
+// ============================================================
+// FIX FUNCTIONS
+// ============================================================
+/**
+ * Recursively fix issues in a data structure
+ * Returns the number of fixes applied
+ */
+function fixObject(obj, file, pathPrefix, fixes) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    let modified = false;
+    const record = obj;
+    // Fix invalid _ulid
+    if ('_ulid' in record) {
+        if (!isValidUlid(record._ulid)) {
+            const oldValue = record._ulid;
+            const newValue = ulid();
+            record._ulid = newValue;
+            fixes.push({
+                file,
+                path: pathPrefix ? `${pathPrefix}._ulid` : '_ulid',
+                type: 'ulid_regenerated',
+                oldValue,
+                newValue,
+            });
+            modified = true;
+        }
+    }
+    // Fix missing created timestamp on items that have _ulid (spec items, tasks)
+    // Tasks use created_at, spec items use created - check for both
+    if ('_ulid' in record && !('created' in record) && !('created_at' in record)) {
+        const newValue = new Date().toISOString();
+        record.created = newValue;
+        fixes.push({
+            file,
+            path: pathPrefix ? `${pathPrefix}.created` : 'created',
+            type: 'timestamp_added',
+            newValue,
+        });
+        modified = true;
+    }
+    // Fix notes with invalid _ulid
+    if ('notes' in record && Array.isArray(record.notes)) {
+        for (let i = 0; i < record.notes.length; i++) {
+            const note = record.notes[i];
+            if (note && typeof note === 'object' && '_ulid' in note) {
+                if (!isValidUlid(note._ulid)) {
+                    const oldValue = note._ulid;
+                    const newValue = ulid();
+                    note._ulid = newValue;
+                    fixes.push({
+                        file,
+                        path: `${pathPrefix}.notes[${i}]._ulid`,
+                        type: 'ulid_regenerated',
+                        oldValue,
+                        newValue,
+                    });
+                    modified = true;
+                }
+            }
+        }
+    }
+    // Recurse into nested structures
+    const nestedFields = [
+        'modules',
+        'features',
+        'requirements',
+        'constraints',
+        'decisions',
+        'items',
+        'tasks',
+    ];
+    for (const field of nestedFields) {
+        if (field in record && Array.isArray(record[field])) {
+            const arr = record[field];
+            for (let i = 0; i < arr.length; i++) {
+                const newPath = pathPrefix ? `${pathPrefix}.${field}[${i}]` : `${field}[${i}]`;
+                if (fixObject(arr[i], file, newPath, fixes)) {
+                    modified = true;
+                }
+            }
+        }
+    }
+    return modified;
+}
+/**
+ * Fix issues in a single file
+ */
+export async function fixFile(filePath) {
+    const fixes = [];
+    const data = await readYamlFile(filePath);
+    // Handle task files (array or { tasks: [...] })
+    if (Array.isArray(data)) {
+        let modified = false;
+        for (let i = 0; i < data.length; i++) {
+            if (fixObject(data[i], filePath, `[${i}]`, fixes)) {
+                modified = true;
+            }
+        }
+        if (modified) {
+            await writeYamlFilePreserveFormat(filePath, data);
+        }
+    }
+    else if (data && typeof data === 'object') {
+        const record = data;
+        // Check for tasks file format
+        if ('tasks' in record && Array.isArray(record.tasks)) {
+            let modified = false;
+            for (let i = 0; i < record.tasks.length; i++) {
+                if (fixObject(record.tasks[i], filePath, `tasks[${i}]`, fixes)) {
+                    modified = true;
+                }
+            }
+            if (modified) {
+                await writeYamlFilePreserveFormat(filePath, data);
+            }
+        }
+        // Check for inbox file format
+        else if ('inbox' in record && Array.isArray(record.inbox)) {
+            let modified = false;
+            for (let i = 0; i < record.inbox.length; i++) {
+                if (fixObject(record.inbox[i], filePath, `inbox[${i}]`, fixes)) {
+                    modified = true;
+                }
+            }
+            if (modified) {
+                await writeYamlFilePreserveFormat(filePath, data);
+            }
+        }
+        // Spec file (root is a spec item)
+        else if ('_ulid' in record) {
+            if (fixObject(data, filePath, '', fixes)) {
+                await writeYamlFilePreserveFormat(filePath, data);
+            }
+        }
+    }
+    return fixes;
+}
+/**
+ * Fix issues across multiple files
+ */
+export async function fixFiles(filePaths) {
+    const result = {
+        filesModified: 0,
+        fixesApplied: [],
+        errors: [],
+    };
+    for (const filePath of filePaths) {
+        try {
+            const fixes = await fixFile(filePath);
+            if (fixes.length > 0) {
+                result.filesModified++;
+                result.fixesApplied.push(...fixes);
+            }
+        }
+        catch (err) {
+            result.errors.push({
+                file: filePath,
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=fix.js.map

package/dist/parser/fix.js.map

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

package/dist/parser/index.d.ts

@@ -0,0 +1,12 @@
+export * from './yaml.js';
+export * from './refs.js';
+export * from './items.js';
+export * from './validate.js';
+export * from './alignment.js';
+export * from './traits.js';
+export * from './fix.js';
+export * from './shadow.js';
+export * from './meta.js';
+export * from './convention-validation.js';
+export * from './assess.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC"}

package/dist/parser/index.js

@@ -0,0 +1,13 @@
+// Re-export parser utilities
+export * from './yaml.js';
+export * from './refs.js';
+export * from './items.js';
+export * from './validate.js';
+export * from './alignment.js';
+export * from './traits.js';
+export * from './fix.js';
+export * from './shadow.js';
+export * from './meta.js';
+export * from './convention-validation.js';
+export * from './assess.js';
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAE7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC"}

package/dist/parser/items.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Item index for efficient queries across spec items and tasks.
+ *
+ * Provides filtering by type, tags, status, and field presence.
+ * Complements ReferenceIndex which handles @reference resolution.
+ */
+import type { LoadedSpecItem, LoadedTask, AnyLoadedItem } from './yaml.js';
+import type { ItemType, TaskStatus, Maturity, ImplementationStatus } from '../schema/index.js';
+/**
+ * Filter criteria for item queries
+ */
+export interface ItemFilter {
+    /** Filter by item type (module, feature, requirement, etc.) */
+    type?: ItemType | ItemType[];
+    /** Filter by tags (matches if item has ANY of these tags) */
+    tags?: string[];
+    /** Filter by tags (matches if item has ALL of these tags) */
+    allTags?: string[];
+    /** Filter by task status (for tasks only) */
+    status?: TaskStatus | TaskStatus[];
+    /** Filter by maturity status (for spec items) */
+    maturity?: Maturity | Maturity[];
+    /** Filter by implementation status (for spec items) */
+    implementation?: ImplementationStatus | ImplementationStatus[];
+    /** Filter items that have these fields present (non-null/undefined) */
+    hasFields?: string[];
+    /** Filter items that have a specific field value */
+    fieldEquals?: {
+        field: string;
+        value: unknown;
+    }[];
+    /** Text search in title */
+    titleContains?: string;
+    /** Include only tasks */
+    tasksOnly?: boolean;
+    /** Include only spec items (non-tasks) */
+    specItemsOnly?: boolean;
+    /** Grep-like regex search across all text content */
+    grepSearch?: string;
+}
+/**
+ * Query result with pagination info
+ */
+export interface QueryResult<T> {
+    items: T[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+/**
+ * Index for efficient item queries.
+ * Build once when loading the spec, then query many times.
+ */
+export declare class ItemIndex {
+    /** All items (tasks + spec items) */
+    private allItems;
+    /** Tasks only */
+    private tasks;
+    /** Spec items only (non-tasks) */
+    private specItems;
+    /** Index by type */
+    private typeIndex;
+    /** Index by tag */
+    private tagIndex;
+    /** Index by task status */
+    private statusIndex;
+    /** Index by maturity */
+    private maturityIndex;
+    /** Index by implementation status */
+    private implementationIndex;
+    /**
+     * Build index from loaded items
+     */
+    constructor(tasks: LoadedTask[], items: LoadedSpecItem[]);
+    private indexItem;
+    /**
+     * Query items with filters
+     */
+    query(filter?: ItemFilter): AnyLoadedItem[];
+    /**
+     * Query with pagination
+     */
+    queryPaginated(filter?: ItemFilter, offset?: number, limit?: number): QueryResult<AnyLoadedItem>;
+    /**
+     * Get items by type
+     */
+    getByType(type: ItemType): AnyLoadedItem[];
+    /**
+     * Get items by tag
+     */
+    getByTag(tag: string): AnyLoadedItem[];
+    /**
+     * Get tasks by status
+     */
+    getTasksByStatus(status: TaskStatus): LoadedTask[];
+    /**
+     * Get spec items by maturity
+     */
+    getByMaturity(maturity: Maturity): LoadedSpecItem[];
+    /**
+     * Get spec items by implementation status
+     */
+    getByImplementation(impl: ImplementationStatus): LoadedSpecItem[];
+    /**
+     * Get all unique types in the index
+     */
+    getTypes(): string[];
+    /**
+     * Get all unique tags in the index
+     */
+    getTags(): string[];
+    /**
+     * Get count by type
+     */
+    getTypeCounts(): Map<string, number>;
+    /**
+     * Get count by tag
+     */
+    getTagCounts(): Map<string, number>;
+    /**
+     * Get total item count
+     */
+    get size(): number;
+    /**
+     * Get task count
+     */
+    get taskCount(): number;
+    /**
+     * Get spec item count
+     */
+    get specItemCount(): number;
+}
+/**
+ * Find direct child items of a parent item based on _path
+ * Children have paths like "parent_path.field[N]"
+ */
+export declare function findChildItems(parent: LoadedSpecItem, allItems: LoadedSpecItem[]): LoadedSpecItem[];
+//# sourceMappingURL=items.d.ts.map

package/dist/parser/items.d.ts.map

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