logicstamp-context 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+/**
+ * LogicStamp Context CLI - Standalone context generator
+ * Scans React/TypeScript files and generates AI-friendly context bundles
+ */
+import { contextCommand } from './commands/context.js';
+import { compareCommand } from './commands/compare.js';
+async function main() {
+    const args = process.argv.slice(2);
+    // Check for compare subcommand
+    if (args[0] === 'compare') {
+        // Handle compare command
+        if (args.length < 3 || args[1] === '--help' || args[1] === '-h') {
+            printCompareHelp();
+            process.exit(args[1] === '--help' || args[1] === '-h' ? 0 : 1);
+        }
+        const compareOptions = {
+            oldFile: args[1],
+            newFile: args[2],
+            stats: args.includes('--stats'),
+            quiet: args.includes('--quiet') || args.includes('-q'),
+        };
+        try {
+            await compareCommand(compareOptions);
+        }
+        catch (error) {
+            console.error('❌ Compare failed:', error.message);
+            process.exit(1);
+        }
+        return;
+    }
+    // Parse arguments for context command
+    const options = {
+        depth: 1,
+        includeCode: 'header',
+        format: 'json',
+        out: 'context.json',
+        hashLock: false, // No hash lock for standalone (no sidecars)
+        strict: false,
+        allowMissing: true,
+        maxNodes: 100,
+        profile: 'llm-chat',
+        predictBehavior: false,
+        dryRun: false,
+        stats: false,
+        strictMissing: false,
+        compareModes: false,
+        quiet: false,
+    };
+    // Parse command line arguments
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+        if (arg.startsWith('--') || arg.startsWith('-')) {
+            const key = arg.replace(/^--?/, '');
+            const value = args[i + 1];
+            switch (key) {
+                case 'depth':
+                case 'd':
+                    options.depth = parseInt(value, 10);
+                    i++;
+                    break;
+                case 'include-code':
+                case 'c':
+                    options.includeCode = value;
+                    i++;
+                    break;
+                case 'format':
+                case 'f':
+                    options.format = value;
+                    i++;
+                    break;
+                case 'out':
+                case 'o':
+                    options.out = value;
+                    i++;
+                    break;
+                case 'max-nodes':
+                case 'm':
+                    options.maxNodes = parseInt(value, 10);
+                    i++;
+                    break;
+                case 'profile':
+                    options.profile = value;
+                    i++;
+                    break;
+                case 'strict':
+                case 's':
+                    options.strict = true;
+                    break;
+                case 'predict-behavior':
+                case 'predict':
+                    options.predictBehavior = true;
+                    break;
+                case 'dry-run':
+                    options.dryRun = true;
+                    break;
+                case 'stats':
+                    options.stats = true;
+                    break;
+                case 'strict-missing':
+                    options.strictMissing = true;
+                    break;
+                case 'compare-modes':
+                    options.compareModes = true;
+                    break;
+                case 'quiet':
+                case 'q':
+                    options.quiet = true;
+                    break;
+            }
+        }
+        else if (!arg.startsWith('-') && !options.entry) {
+            options.entry = arg;
+        }
+    }
+    try {
+        await contextCommand(options);
+    }
+    catch (error) {
+        console.error('❌ Context generation failed:', error.message);
+        console.error(error.stack);
+        process.exit(1);
+    }
+}
+function printHelp() {
+    console.log(`
+╭─────────────────────────────────────────────────╮
+│  LogicStamp Context - AI-Ready Documentation    │
+│  Generate context bundles from React codebases  │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  logicstamp-context [path] [options]
+  logicstamp-context compare <old.json> <new.json> [--stats]
+
+ARGUMENTS:
+  [path]               Directory to scan (default: current directory)
+
+OPTIONS:
+  -d, --depth <n>           Dependency depth (default: 1)
+  -c, --include-code <mode> Code: none|header|full (default: header)
+  -f, --format <format>     Format: json|pretty|ndjson (default: json)
+  -o, --out <file>          Output file (default: context.json)
+  -m, --max-nodes <n>       Max nodes per bundle (default: 100)
+  --profile <profile>       Profile: llm-safe|llm-chat|ci-strict
+  -s, --strict              Fail on missing dependencies
+  --predict-behavior        Enable behavioral predictions
+  --dry-run                 Show stats without writing file
+  --stats                   Output one-line JSON stats for CI
+  --strict-missing          Exit with error if missing dependencies found
+  --compare-modes           Show detailed token comparison table
+  --quiet, -q               Suppress verbose output (show only errors)
+  -h, --help                Show this help
+
+PROFILES:
+  llm-safe    Conservative (depth=1, header, max 30 nodes)
+  llm-chat    Balanced (depth=1, header, max 100 nodes) [default]
+  ci-strict   Strict validation (no code, strict deps)
+
+EXAMPLES:
+  logicstamp-context
+    Generate context for entire project
+
+  logicstamp-context ./src
+    Generate context for src directory
+
+  logicstamp-context --profile llm-safe --out ai-context.json
+    Use conservative profile with custom output
+
+  logicstamp-context --depth 2 --include-code full
+    Include full source code with deeper traversal
+
+VALIDATION:
+  Use logicstamp-validate to check generated bundles:
+    logicstamp-validate context.json
+
+NOTES:
+  • Scans for .ts/.tsx files automatically
+  • Generates context on-the-fly (no pre-compilation needed)
+  • Output is ready for Claude, ChatGPT, or other AI tools
+  `);
+}
+function printCompareHelp() {
+    console.log(`
+╭─────────────────────────────────────────────────╮
+│  LogicStamp Context Compare                     │
+│  Diff two context.json files                    │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  logicstamp-context compare <old.json> <new.json> [options]
+
+ARGUMENTS:
+  <old.json>           Path to old context file
+  <new.json>           Path to new context file
+
+OPTIONS:
+  --stats              Show token count statistics
+  --quiet, -q          Suppress verbose output (show only errors)
+  -h, --help           Show this help
+
+OUTPUT:
+  PASS                 No changes detected
+  DRIFT                Components added/removed/changed
+
+EXIT CODES:
+  0                    No drift (PASS)
+  1                    Drift detected or error
+
+EXAMPLES:
+  logicstamp-context compare old.json new.json
+    Compare two context files
+
+  logicstamp-context compare old.json new.json --stats
+    Compare with token statistics
+  `);
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/stamp.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Stamp CLI - Main entry point for LogicStamp Context tools
+ * Routes to context operations: generate, validate, compare
+ */
+export {};
+//# sourceMappingURL=stamp.d.ts.map

package/dist/cli/stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../src/cli/stamp.ts"],"names":[],"mappings":";AAEA;;;GAGG"}