logicstamp-context 0.1.0

package/dist/cli/commands/clean.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Clean command - Removes all generated context artifacts
+ * Deletes context_main.json, all folder context.json files, and optionally .logicstamp/ cache
+ */
+export interface CleanOptions {
+    projectRoot?: string;
+    all?: boolean;
+    yes?: boolean;
+    quiet?: boolean;
+}
+/**
+ * Clean command - removes all generated context artifacts
+ */
+export declare function cleanCommand(options: CleanOptions): Promise<void>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/cli/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clean.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiDD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAyFvE"}

package/dist/cli/commands/clean.js

@@ -0,0 +1,142 @@
+/**
+ * Clean command - Removes all generated context artifacts
+ * Deletes context_main.json, all folder context.json files, and optionally .logicstamp/ cache
+ */
+import { glob } from 'glob';
+import { unlink, rm, stat } from 'node:fs/promises';
+import { resolve, join, relative } from 'node:path';
+import { fileExists } from '../../utils/fsx.js';
+/**
+ * Normalize path for display (convert backslashes to forward slashes)
+ */
+function displayPath(path) {
+    return path.replace(/\\/g, '/');
+}
+/**
+ * Find all context.json files in the project
+ */
+async function findContextFiles(projectRoot) {
+    const contextFiles = await glob('**/context.json', {
+        cwd: projectRoot,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**'],
+    });
+    return contextFiles.sort();
+}
+/**
+ * Find context_main.json in the project root
+ */
+async function findMainContextFile(projectRoot) {
+    const mainContextPath = join(projectRoot, 'context_main.json');
+    if (await fileExists(mainContextPath)) {
+        return mainContextPath;
+    }
+    return null;
+}
+/**
+ * Find .logicstamp directory
+ */
+async function findLogicStampDir(projectRoot) {
+    const logicStampPath = join(projectRoot, '.logicstamp');
+    try {
+        const stats = await stat(logicStampPath);
+        if (stats.isDirectory()) {
+            return logicStampPath;
+        }
+    }
+    catch {
+        // Directory doesn't exist
+    }
+    return null;
+}
+/**
+ * Clean command - removes all generated context artifacts
+ */
+export async function cleanCommand(options) {
+    const projectRoot = resolve(options.projectRoot || '.');
+    // Find all files to remove
+    const contextFiles = await findContextFiles(projectRoot);
+    const mainContextFile = await findMainContextFile(projectRoot);
+    const logicStampDir = await findLogicStampDir(projectRoot);
+    // Collect all files to remove
+    const filesToRemove = [];
+    if (mainContextFile) {
+        filesToRemove.push(mainContextFile);
+    }
+    filesToRemove.push(...contextFiles);
+    // If no files found, exit early
+    if (filesToRemove.length === 0 && !logicStampDir) {
+        if (options.quiet) {
+            process.stdout.write('✓\n');
+        }
+        else {
+            console.log('✅ No context artifacts found to clean');
+        }
+        return;
+    }
+    // Display what will be removed
+    if (!options.quiet) {
+        console.log('\n🧹 This will remove:');
+        if (mainContextFile) {
+            const relPath = relative(projectRoot, mainContextFile);
+            console.log(`  - ${displayPath(relPath === 'context_main.json' ? 'context_main.json' : relPath)}`);
+        }
+        for (const file of contextFiles) {
+            const relPath = relative(projectRoot, file);
+            console.log(`  - ${displayPath(relPath)}`);
+        }
+        if (logicStampDir) {
+            const relPath = relative(projectRoot, logicStampDir);
+            console.log(`  - ${displayPath(relPath)}/`);
+        }
+    }
+    // If --all and --yes flags are provided, proceed with deletion
+    if (options.all && options.yes) {
+        if (!options.quiet) {
+            console.log('\n🗑️  Removing files...\n');
+        }
+        // Delete all context.json files
+        for (const file of filesToRemove) {
+            try {
+                await unlink(file);
+                if (!options.quiet) {
+                    const relPath = relative(projectRoot, file);
+                    console.log(`   ✓ Removed ${displayPath(relPath)}`);
+                }
+            }
+            catch (error) {
+                // Always show errors
+                const relPath = relative(projectRoot, file);
+                console.error(`   ✗ Failed to remove ${displayPath(relPath)}: ${error.message}`);
+            }
+        }
+        // Delete .logicstamp directory if it exists
+        if (logicStampDir) {
+            try {
+                await rm(logicStampDir, { recursive: true, force: true });
+                if (!options.quiet) {
+                    const relPath = relative(projectRoot, logicStampDir);
+                    console.log(`   ✓ Removed ${displayPath(relPath)}/`);
+                }
+            }
+            catch (error) {
+                // Always show errors
+                const relPath = relative(projectRoot, logicStampDir);
+                console.error(`   ✗ Failed to remove ${displayPath(relPath)}/: ${error.message}`);
+            }
+        }
+        if (options.quiet) {
+            process.stdout.write('✓\n');
+        }
+        else {
+            console.log(`\n✅ Cleaned ${filesToRemove.length} file(s)${logicStampDir ? ' and 1 directory' : ''}`);
+        }
+    }
+    else {
+        // Dry run mode - just show what would be removed
+        if (!options.quiet) {
+            console.log('\n💡 Run with --all --yes to confirm and delete these files.');
+        }
+    }
+}
+//# sourceMappingURL=clean.js.map

package/dist/cli/commands/clean.js.map

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

package/dist/cli/commands/compare.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Compare command - Diffs two context.json files
+ * Detects added/removed components and changed signatures
+ */
+export interface CompareResult {
+    status: 'PASS' | 'DRIFT';
+    added: string[];
+    removed: string[];
+    changed: Array<{
+        id: string;
+        deltas: Array<{
+            type: 'hash' | 'imports' | 'hooks' | 'exports' | 'functions' | 'components' | 'props' | 'emits';
+            old: any;
+            new: any;
+        }>;
+    }>;
+}
+/**
+ * Result for a single folder's context file comparison
+ */
+export interface FolderCompareResult {
+    folderPath: string;
+    contextFile: string;
+    status: 'PASS' | 'DRIFT' | 'ADDED' | 'ORPHANED';
+    componentResult?: CompareResult;
+    tokenDelta?: {
+        gpt4: number;
+        claude: number;
+    };
+}
+/**
+ * Result for multi-file comparison (compares all context files)
+ */
+export interface MultiFileCompareResult {
+    status: 'PASS' | 'DRIFT';
+    folders: FolderCompareResult[];
+    summary: {
+        totalFolders: number;
+        addedFolders: number;
+        orphanedFolders: number;
+        driftFolders: number;
+        passFolders: number;
+        totalComponentsAdded: number;
+        totalComponentsRemoved: number;
+        totalComponentsChanged: number;
+    };
+    orphanedFiles?: string[];
+}
+export interface CompareOptions {
+    oldFile: string;
+    newFile: string;
+    stats?: boolean;
+    approve?: boolean;
+    quiet?: boolean;
+}
+export interface MultiFileCompareOptions {
+    oldIndexFile: string;
+    newIndexFile: string;
+    stats?: boolean;
+    approve?: boolean;
+    autoCleanOrphaned?: boolean;
+    quiet?: boolean;
+}
+/**
+ * Main compare command
+ * Returns the comparison result instead of exiting, allowing caller to handle approval logic
+ */
+export declare function compareCommand(options: CompareOptions): Promise<CompareResult>;
+/**
+ * Multi-file comparison - compares all context files using context_main.json indices
+ * This is the comprehensive comparison that handles:
+ * 1. context_main.json as root index
+ * 2. All folder context.json files
+ * 3. ADDED FILE detection (new folders)
+ * 4. ORPHANED FILE detection (deleted folders)
+ * 5. DRIFT detection (changed files)
+ * 6. PASS detection (unchanged files)
+ */
+export declare function multiFileCompare(options: MultiFileCompareOptions): Promise<MultiFileCompareResult>;
+/**
+ * Format and display multi-file comparison results
+ */
+export declare function displayMultiFileCompareResult(result: MultiFileCompareResult, stats: boolean, quiet?: boolean): void;
+/**
+ * Clean up orphaned files
+ */
+export declare function cleanOrphanedFiles(orphanedFiles: string[], baseDir: string, quiet?: boolean): Promise<number>;
+//# sourceMappingURL=compare.d.ts.map

package/dist/cli/commands/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/compare.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC;YAChG,GAAG,EAAE,GAAG,CAAC;YACT,GAAG,EAAE,GAAG,CAAC;SACV,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IAChD,eAAe,CAAC,EAAE,aAAa,CAAC;IAChC,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA+GD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAqGpF;AAqFD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAyGxG;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAqInH;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBnH"}