logicstamp-context 0.5.5 → 0.7.0

package/dist/utils/fileLock.js

@@ -35,7 +35,18 @@ function isProcessAlive(pid) {
 async function isLockStale(lockPath, staleThreshold) {
     try {
         const content = await readFile(lockPath, 'utf-8');
-        const lockData = JSON.parse(content);
+        // If file is empty, another process just created it and is writing - not stale
+        if (!content.trim()) {
+            return false;
+        }
+        let lockData;
+        try {
+            lockData = JSON.parse(content);
+        }
+        catch {
+            // Can't parse JSON - likely another process is mid-write, not stale
+            return false;
+        }
         // Check if the process that created the lock is still alive
         const alive = isProcessAlive(lockData.pid);
         if (alive === 'unknown') {
@@ -54,9 +65,14 @@ async function isLockStale(lockPath, staleThreshold) {
         }
         return false;
     }
-    catch {
-        // If we can't read the lock file, assume it's stale
-        return true;
+    catch (error) {
+        const err = error;
+        // File doesn't exist - either never created or already removed
+        if (err.code === 'ENOENT') {
+            return true;
+        }
+        // Other read errors - be conservative, assume not stale
+        return false;
     }
 }
 /**
@@ -126,6 +142,9 @@ export async function acquireLock(filePath, options = {}) {
                 // Lock file exists - check if it's stale
                 if (await isLockStale(lockPath, staleThreshold)) {
                     await removeStale(lockPath);
+                    // Small delay after removing stale lock to let filesystem catch up
+                    // Especially important on Windows where file deletion can be asynchronous
+                    await new Promise(resolve => setTimeout(resolve, 10));
                     // Retry immediately after removing stale lock
                     continue;
                 }

package/dist/utils/fileLock.js.map

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

package/dist/utils/schemaValidator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Schema validation utilities using AJV
+ * Validates JSON data against LogicStamp schemas at runtime
+ */
+import type { UIFContract } from '../types/UIFContract.js';
+/**
+ * Validate data against the UIFContract schema
+ * Returns validation result with detailed errors if invalid
+ */
+export declare function validateUIFContract(data: unknown): {
+    valid: boolean;
+    errors: string[];
+    data: UIFContract | null;
+};
+/**
+ * Type guard that validates and narrows type
+ * Use when you just need a boolean check
+ */
+export declare function isValidUIFContract(data: unknown): data is UIFContract;
+/**
+ * Clear the cached validator (useful for testing)
+ */
+export declare function clearValidatorCache(): void;
+//# sourceMappingURL=schemaValidator.d.ts.map

package/dist/utils/schemaValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaValidator.d.ts","sourceRoot":"","sources":["../../src/utils/schemaValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAwD3D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1B,CA+BA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAErE;AAqCD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}

package/dist/utils/schemaValidator.js

@@ -0,0 +1,137 @@
+/**
+ * Schema validation utilities using AJV
+ * Validates JSON data against LogicStamp schemas at runtime
+ */
+import Ajv from 'ajv';
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { debugError } from './debug.js';
+// Resolve schema path relative to this module
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const schemaPath = join(__dirname, '../../schema/logicstamp.context.schema.json');
+// Lazy-load schema and validator to avoid startup cost if validation isn't used
+let ajv = null;
+let contractValidator = null;
+let schemaLoadError = null;
+/**
+ * Initialize AJV and compile the UIFContract schema
+ * Called lazily on first validation attempt
+ */
+function initializeValidator() {
+    if (contractValidator)
+        return contractValidator;
+    if (schemaLoadError)
+        return null;
+    try {
+        const schemaContent = readFileSync(schemaPath, 'utf8');
+        const schema = JSON.parse(schemaContent);
+        // Guard against malformed schema file
+        if (!schema?.definitions?.UIFContract) {
+            throw new Error('UIFContract definition not found in schema');
+        }
+        ajv = new Ajv({
+            allErrors: true, // Collect all errors, not just the first
+            strict: false, // Allow schema features that aren't strictly spec-compliant
+            verbose: true, // Ensures `data` field is present in errors for typeof reporting
+        });
+        // Compile the UIFContract definition specifically
+        // The schema file has definitions at the root level
+        contractValidator = ajv.compile({
+            $ref: '#/definitions/UIFContract',
+            definitions: schema.definitions,
+        });
+        return contractValidator;
+    }
+    catch (error) {
+        // Clean up on failure
+        ajv = null;
+        contractValidator = null;
+        schemaLoadError = error;
+        debugError('schemaValidator', 'initializeValidator', {
+            error: schemaLoadError.message,
+            note: 'Schema validation disabled, contracts will not be validated',
+        });
+        return null;
+    }
+}
+/**
+ * Validate data against the UIFContract schema
+ * Returns validation result with detailed errors if invalid
+ */
+export function validateUIFContract(data) {
+    const validator = initializeValidator();
+    // If schema failed to load, reject validation
+    // This ensures corrupted or invalid contracts are never silently accepted
+    if (!validator) {
+        return {
+            valid: false,
+            errors: ['Schema validation unavailable: ' + (schemaLoadError?.message || 'failed to load schema')],
+            data: null,
+        };
+    }
+    const valid = validator(data);
+    if (valid) {
+        return {
+            valid: true,
+            errors: [],
+            data: data,
+        };
+    }
+    // Format errors for readability
+    const errors = formatValidationErrors(validator.errors);
+    return {
+        valid: false,
+        errors,
+        data: null,
+    };
+}
+/**
+ * Type guard that validates and narrows type
+ * Use when you just need a boolean check
+ */
+export function isValidUIFContract(data) {
+    return validateUIFContract(data).valid;
+}
+/**
+ * Format AJV errors into human-readable strings
+ */
+function formatValidationErrors(errors) {
+    if (!errors || errors.length === 0)
+        return [];
+    return errors.map((err) => {
+        const path = err.instancePath || '(root)';
+        const message = err.message || 'unknown error';
+        // Add context for common error types
+        switch (err.keyword) {
+            case 'required':
+                return `${path}: missing required property '${err.params.missingProperty}'`;
+            case 'type': {
+                // typeof null === 'object' and typeof [] === 'object', so handle explicitly
+                const got = err.data === null ? 'null' : Array.isArray(err.data) ? 'array' : typeof err.data;
+                return `${path}: ${message} (got ${got})`;
+            }
+            case 'enum':
+                return `${path}: ${message}. Allowed: ${err.params.allowedValues?.join(', ')}`;
+            case 'const':
+                return `${path}: ${message}. Expected: ${err.params.allowedValue}`;
+            case 'additionalProperties':
+                return `${path}: unexpected property '${err.params.additionalProperty}'`;
+            case 'anyOf':
+            case 'oneOf':
+                // These are notoriously noisy - simplify the message
+                return `${path}: ${message} (schema union mismatch)`;
+            default:
+                return `${path}: ${message}`;
+        }
+    });
+}
+/**
+ * Clear the cached validator (useful for testing)
+ */
+export function clearValidatorCache() {
+    ajv = null;
+    contractValidator = null;
+    schemaLoadError = null;
+}
+//# sourceMappingURL=schemaValidator.js.map

package/dist/utils/schemaValidator.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "logicstamp-context",
-  "version": "0.5.5",
- "description": "Deterministic architectural context for TypeScript codebases. Generates explicit component contracts and dependency graphs for AI workflows.",
+  "version": "0.7.0",
+  "description": "The context compiler for TypeScript. Compile your codebase into deterministic architectural contracts and dependency graphs for AI coding workflows.",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
@@ -60,10 +60,11 @@
   },
   "dependencies": {
     "@toon-format/toon": "^1.0.0",
+    "ajv": "^8.18.0",
     "chokidar": "^4.0.3",
     "css-tree": "^3.1.0",
-    "glob": "^10.5.0",
-    "ts-morph": "^21.0.1"
+    "glob": "^13.0.6",
+    "ts-morph": "^27.0.2"
   },
   "optionalDependencies": {
     "@anthropic-ai/tokenizer": "^0.0.4",
@@ -77,6 +78,6 @@
     "vitest": "^4.0.16"
   },
   "engines": {
-    "node": ">=18.18.0"
+    "node": ">=20"
   }
 }

package/schema/logicstamp.context.schema.json

@@ -551,6 +551,9 @@
         },
         "pageLayout": {
           "$ref": "#/definitions/PageLayoutMetadata"
+        },
+        "summary": {
+          "$ref": "#/definitions/StyleSummary"
         }
       },
       "additionalProperties": false
@@ -569,7 +572,14 @@
                   "type": "string"
                 }
               },
-              "description": "Tailwind classes categorized by type (layout, spacing, colors, typography, borders, effects)"
+              "description": "Tailwind classes categorized by type (layout, spacing, colors, typography, borders, effects) - full mode only"
+            },
+            "categoriesUsed": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Category names used (e.g., ['layout', 'spacing', 'colors']) - lean mode only"
             },
             "breakpoints": {
               "type": "array",
@@ -684,7 +694,7 @@
           "properties": {
             "css": {
               "type": "string",
-              "description": "Extracted CSS content from <style jsx> blocks"
+              "description": "Extracted CSS content from <style jsx> blocks - full mode only"
             },
             "global": {
               "type": "boolean",
@@ -695,14 +705,22 @@
               "items": {
                 "type": "string"
               },
-              "description": "CSS selectors found in the extracted CSS"
+              "description": "CSS selectors found in the extracted CSS - full mode only"
+            },
+            "selectorCount": {
+              "type": "number",
+              "description": "Number of CSS selectors found - lean mode only"
             },
             "properties": {
               "type": "array",
               "items": {
                 "type": "string"
               },
-              "description": "CSS properties found in the extracted CSS"
+              "description": "CSS properties found in the extracted CSS - full mode only"
+            },
+            "propertyCount": {
+              "type": "number",
+              "description": "Number of CSS properties found - lean mode only"
             }
           },
           "additionalProperties": false
@@ -715,7 +733,11 @@
               "items": {
                 "type": "string"
               },
-              "description": "Styled component names (e.g., ['div', 'Button'])"
+              "description": "Styled component names (e.g., ['div', 'Button']) - full mode only"
+            },
+            "componentCount": {
+              "type": "number",
+              "description": "Number of styled components - lean mode only"
             },
             "usesTheme": {
               "type": "boolean",
@@ -1067,7 +1089,11 @@
           "items": {
             "type": "string"
           },
-          "description": "Identified page sections"
+          "description": "Identified page sections - full mode only"
+        },
+        "sectionCount": {
+          "type": "number",
+          "description": "Number of identified page sections - lean mode only"
         }
       },
       "additionalProperties": false
@@ -1080,14 +1106,22 @@
           "items": {
             "type": "string"
           },
-          "description": "Color utility classes (sorted, limited to top 10)"
+          "description": "Color utility classes (sorted, limited to top 10) - full mode only"
+        },
+        "colorCount": {
+          "type": "number",
+          "description": "Number of color utility classes - lean mode only"
         },
         "spacing": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "Spacing utility classes (sorted, limited to top 10)"
+          "description": "Spacing utility classes (sorted, limited to top 10) - full mode only"
+        },
+        "spacingCount": {
+          "type": "number",
+          "description": "Number of spacing utility classes - lean mode only"
         },
         "radius": {
           "type": "string",
@@ -1098,7 +1132,11 @@
           "items": {
             "type": "string"
           },
-          "description": "Typography classes (sorted, limited to top 10)"
+          "description": "Typography classes (sorted, limited to top 10) - full mode only"
+        },
+        "typographyCount": {
+          "type": "number",
+          "description": "Number of typography classes - lean mode only"
         }
       },
       "additionalProperties": false
@@ -1143,6 +1181,29 @@
       },
       "additionalProperties": false
     },
+    "StyleSummary": {
+      "type": "object",
+      "required": ["mode", "sources"],
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["lean", "full"],
+          "description": "Style extraction mode: 'lean' (compact with counts/flags) or 'full' (verbose with arrays)"
+        },
+        "sources": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Style sources detected (e.g., ['tailwind', 'shadcn', 'scss'])"
+        },
+        "fullModeBytes": {
+          "type": "number",
+          "description": "Estimated byte size of full mode output (only present in lean mode)"
+        }
+      },
+      "additionalProperties": false
+    },
     "NextJSMetadata": {
       "type": "object",
       "properties": {