logicstamp-context 0.2.5 → 0.2.7

package/dist/utils/stampignore.js

@@ -0,0 +1,189 @@
+/**
+ * Utilities for managing .stampignore files
+ * Similar to .gitignore, but for LogicStamp context generation
+ */
+import { readFile, writeFile, access, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { debugError } from './debug.js';
+import { normalizeEntryId } from './fsx.js';
+/**
+ * Default .stampignore filename
+ */
+export const STAMPIGNORE_FILENAME = '.stampignore';
+/**
+ * Check if .stampignore exists in the given directory
+ */
+export async function stampignoreExists(targetDir) {
+    try {
+        await access(join(targetDir, STAMPIGNORE_FILENAME));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read .stampignore content
+ */
+export async function readStampignore(targetDir) {
+    const stampignorePath = join(targetDir, STAMPIGNORE_FILENAME);
+    try {
+        const content = await readFile(stampignorePath, 'utf-8');
+        const config = JSON.parse(content);
+        // Validate structure
+        if (!config || typeof config !== 'object') {
+            debugError('stampignore', 'readStampignore', {
+                stampignorePath,
+                message: 'Invalid config structure',
+            });
+            return null;
+        }
+        if (!Array.isArray(config.ignore)) {
+            debugError('stampignore', 'readStampignore', {
+                stampignorePath,
+                message: 'Config.ignore must be an array',
+            });
+            return null;
+        }
+        return config;
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            // File doesn't exist - that's fine, return null
+            return null;
+        }
+        debugError('stampignore', 'readStampignore', {
+            stampignorePath,
+            message: err.message,
+            code: err.code,
+        });
+        return null;
+    }
+}
+/**
+ * Write .stampignore content
+ */
+export async function writeStampignore(targetDir, config) {
+    const stampignorePath = join(targetDir, STAMPIGNORE_FILENAME);
+    try {
+        const content = JSON.stringify(config, null, 2);
+        await writeFile(stampignorePath, content, 'utf-8');
+    }
+    catch (error) {
+        const err = error;
+        debugError('stampignore', 'writeStampignore', {
+            stampignorePath,
+            targetDir,
+            message: err.message,
+            code: err.code,
+        });
+        let userMessage;
+        switch (err.code) {
+            case 'ENOENT':
+                userMessage = `Parent directory not found for: "${stampignorePath}"`;
+                break;
+            case 'EACCES':
+                userMessage = `Permission denied writing to: "${stampignorePath}"`;
+                break;
+            case 'ENOSPC':
+                userMessage = `No space left on device. Cannot write: "${stampignorePath}"`;
+                break;
+            default:
+                userMessage = `Failed to write .stampignore file "${stampignorePath}": ${err.message}`;
+        }
+        throw new Error(userMessage);
+    }
+}
+/**
+ * Add paths to .stampignore
+ * Creates the file if it doesn't exist
+ */
+export async function addToStampignore(targetDir, pathsToAdd) {
+    const exists = await stampignoreExists(targetDir);
+    const config = await readStampignore(targetDir);
+    const currentIgnore = config?.ignore || [];
+    const normalizedCurrent = currentIgnore.map(p => normalizeEntryId(p));
+    // Normalize paths to add and filter out duplicates
+    const normalizedToAdd = pathsToAdd
+        .map(p => normalizeEntryId(p))
+        .filter(p => !normalizedCurrent.includes(p));
+    if (normalizedToAdd.length === 0) {
+        return { added: false, created: false };
+    }
+    const newConfig = {
+        ignore: [...currentIgnore, ...normalizedToAdd],
+    };
+    await writeStampignore(targetDir, newConfig);
+    return { added: true, created: !exists };
+}
+/**
+ * Check if a file path matches any ignore pattern
+ * Supports glob patterns and exact paths
+ */
+export function matchesIgnorePattern(filePath, patterns, projectRoot) {
+    const normalizedPath = normalizeEntryId(filePath);
+    const normalizedRoot = normalizeEntryId(projectRoot);
+    // Make path relative to project root for matching
+    let relativePath = normalizedPath;
+    if (normalizedPath.startsWith(normalizedRoot)) {
+        relativePath = normalizedPath.slice(normalizedRoot.length).replace(/^\//, '');
+    }
+    for (const pattern of patterns) {
+        const normalizedPattern = normalizeEntryId(pattern);
+        // Exact match
+        if (normalizedPattern === relativePath || normalizedPattern === normalizedPath) {
+            return true;
+        }
+        // Glob pattern matching (simple implementation)
+        // Convert glob to regex
+        const regexPattern = normalizedPattern
+            .replace(/\./g, '\\.')
+            .replace(/\*\*/g, '.*')
+            .replace(/\*/g, '[^/]*')
+            .replace(/\?/g, '.');
+        const regex = new RegExp(`^${regexPattern}$`);
+        // Check against relative path
+        if (regex.test(relativePath)) {
+            return true;
+        }
+        // Also check against full normalized path
+        if (regex.test(normalizedPath)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Filter files based on .stampignore patterns
+ */
+export function filterIgnoredFiles(files, patterns, projectRoot) {
+    if (patterns.length === 0) {
+        return files;
+    }
+    return files.filter(file => !matchesIgnorePattern(file, patterns, projectRoot));
+}
+/**
+ * Delete .stampignore file
+ */
+export async function deleteStampignore(targetDir) {
+    const stampignorePath = join(targetDir, STAMPIGNORE_FILENAME);
+    try {
+        await unlink(stampignorePath);
+        return true;
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            // File doesn't exist - that's fine, return false
+            return false;
+        }
+        debugError('stampignore', 'deleteStampignore', {
+            stampignorePath,
+            message: err.message,
+            code: err.code,
+        });
+        throw new Error(`Failed to delete .stampignore: ${err.message}`);
+    }
+}
+//# sourceMappingURL=stampignore.js.map

package/dist/utils/stampignore.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logicstamp-context",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Generate AI-friendly context bundles from React codebases with LogicStamp contracts",
   "type": "module",
   "main": "./dist/index.js",

package/schema/logicstamp.context.schema.json

@@ -117,7 +117,7 @@
         "source": {
           "type": "string",
           "pattern": "^logicstamp-context@\\d+\\.\\d+\\.\\d+$",
-          "description": "Generator identifier with version (e.g., 'logicstamp-context@0.2.5'). Used for compatibility tracking and debugging."
+          "description": "Generator identifier with version (e.g., 'logicstamp-context@0.2.7'). Used for compatibility tracking and debugging."
         }
       },
       "additionalProperties": false
@@ -199,6 +199,31 @@
           "$ref": "#/definitions/StyleMetadata",
           "description": "Optional style metadata (only when --include-style is used)"
         },
+        "exports": {
+          "oneOf": [
+            {
+              "type": "string",
+              "enum": ["default", "named"],
+              "description": "Export type: 'default' for default export, 'named' for single named export"
+            },
+            {
+              "type": "object",
+              "required": ["named"],
+              "properties": {
+                "named": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Array of named export names (for multiple named exports)"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Multiple named exports with explicit list"
+            }
+          ],
+          "description": "Optional export metadata: export type and exported names"
+        },
         "semanticHash": {
           "type": "string",
           "pattern": "^uif:[a-f0-9]{24}$",