logicstamp-context 0.1.1 → 0.2.1

package/dist/cli/parser/argumentParser.js

@@ -0,0 +1,194 @@
+/**
+ * Argument parsing utilities for CLI commands
+ */
+/**
+ * Parse context command arguments (for generate command)
+ */
+export function parseContextArgs(args) {
+    const options = {
+        depth: 1,
+        includeCode: 'header',
+        format: 'json',
+        out: 'context.json',
+        hashLock: false,
+        strict: false,
+        allowMissing: true,
+        maxNodes: 100,
+        profile: 'llm-chat',
+        predictBehavior: false,
+        dryRun: false,
+        stats: false,
+        strictMissing: false,
+        compareModes: false,
+        skipGitignore: false,
+        quiet: false,
+        includeStyle: false, // Default to false
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        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':
+                    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 'skip-gitignore':
+                    options.skipGitignore = true;
+                    break;
+                case 'quiet':
+                case 'q':
+                    options.quiet = true;
+                    break;
+                case 'include-style':
+                    options.includeStyle = true;
+                    break;
+                default:
+                    console.error(`❌ Unknown option: ${arg}`);
+                    process.exit(1);
+            }
+        }
+        else {
+            // First non-option argument is the entry path
+            if (!options.entry) {
+                options.entry = arg;
+            }
+        }
+    }
+    return options;
+}
+/**
+ * Parse compare command arguments
+ */
+export function parseCompareArgs(args) {
+    const stats = args.includes('--stats');
+    const approve = args.includes('--approve');
+    const cleanOrphaned = args.includes('--clean-orphaned');
+    const quiet = args.includes('--quiet') || args.includes('-q');
+    const skipGitignore = args.includes('--skip-gitignore');
+    // Filter out flag arguments to get positional args (including -q)
+    const positionalArgs = args.filter(arg => !arg.startsWith('--') && arg !== '-q');
+    return {
+        stats,
+        approve,
+        cleanOrphaned,
+        quiet,
+        skipGitignore,
+        positionalArgs,
+    };
+}
+/**
+ * Parse validate command arguments
+ */
+export function parseValidateArgs(args) {
+    const quiet = args.includes('--quiet') || args.includes('-q');
+    const filePath = args.filter(arg => arg !== '--quiet' && arg !== '-q')[0];
+    return {
+        quiet,
+        filePath,
+    };
+}
+/**
+ * Parse init command arguments
+ */
+export function parseInitArgs(args) {
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const key = arg.replace(/^--/, '');
+            switch (key) {
+                case 'skip-gitignore':
+                    options.skipGitignore = true;
+                    break;
+                case 'quiet':
+                    // Ignore --quiet for init (quiet mode not supported)
+                    break;
+                default:
+                    console.error(`❌ Unknown option: ${arg}`);
+                    process.exit(1);
+            }
+        }
+        else if (arg !== '-q') {
+            // First non-option argument is the target directory (ignore -q)
+            if (!options.targetDir) {
+                options.targetDir = arg;
+            }
+        }
+    }
+    return options;
+}
+/**
+ * Parse clean command arguments
+ */
+export function parseCleanArgs(args) {
+    const options = {
+        all: args.includes('--all'),
+        yes: args.includes('--yes'),
+        quiet: args.includes('--quiet') || args.includes('-q'),
+    };
+    // First non-option argument is the target directory
+    for (const arg of args) {
+        if (!arg.startsWith('--') && !options.projectRoot) {
+            options.projectRoot = arg;
+            break;
+        }
+    }
+    return options;
+}
+/**
+ * Parse style command arguments (same as context args but exclude includeStyle)
+ */
+export function parseStyleArgs(args) {
+    // Style command uses same parsing as context, but StyleOptions omits includeStyle
+    const contextOptions = parseContextArgs(args);
+    // Remove includeStyle since StyleOptions is Omit<ContextOptions, 'includeStyle'>
+    const { includeStyle, ...styleOptions } = contextOptions;
+    return styleOptions;
+}
+//# sourceMappingURL=argumentParser.js.map

package/dist/cli/parser/argumentParser.js.map

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

package/dist/cli/parser/helpText.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Help text for CLI commands
+ */
+export declare function getMainHelp(): string;
+export declare function getStyleHelp(): string;
+export declare function getGenerateHelp(): string;
+export declare function getValidateHelp(): string;
+export declare function getCompareHelp(): string;
+export declare function getCleanHelp(): string;
+export declare function getInitHelp(): string;
+//# sourceMappingURL=helpText.d.ts.map

package/dist/cli/parser/helpText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpText.d.ts","sourceRoot":"","sources":["../../../src/cli/parser/helpText.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,WAAW,IAAI,MAAM,CAoDpC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAkDrC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAqDxC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAgCxC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAuFvC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAgDrC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAwCpC"}

package/dist/cli/parser/helpText.js

@@ -0,0 +1,373 @@
+/**
+ * Help text for CLI commands
+ */
+export function getMainHelp() {
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp - LogicStamp Context CLI                 │
+│  AI-ready context generation for React/TS       │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp init [path]                    Initialize LogicStamp in a project
+  stamp context [path] [options]       Generate context
+  stamp context style [path] [options] Generate context with style metadata
+  stamp context validate [file]        Validate context file
+  stamp context compare [options]      Detect drift (auto-generates fresh context)
+  stamp context clean [path] [options] Remove all generated context artifacts
+
+OPTIONS:
+  -v, --version                       Show version number
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp init
+    Set up LogicStamp in current directory (creates/updates .gitignore)
+
+  stamp context
+    Generate context.json for current directory
+
+  stamp context style
+    Generate context with style metadata (Tailwind, SCSS, animations, layout)
+
+  stamp context --include-style
+    Same as 'stamp context style' (alternative syntax)
+
+  stamp context validate
+    Validate context.json in current directory
+
+  stamp context compare
+    Auto-detect drift by comparing with fresh context
+
+  stamp context clean
+    Show what would be removed (dry run)
+
+  stamp context clean --all --yes
+    Actually delete all context artifacts
+
+For detailed help on a specific command, run:
+  stamp init --help
+  stamp context --help
+  stamp context style --help
+  stamp context validate --help
+  stamp context compare --help
+  stamp context clean --help
+  `;
+}
+export function getStyleHelp() {
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context Style - Generate with Style      │
+│  Extract Tailwind, SCSS, animations & layout    │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context style [path] [options]
+
+ARGUMENTS:
+  [path]                              Directory to scan (default: current)
+
+OPTIONS:
+  --depth, -d <n>                     Dependency depth (default: 1)
+  --include-code, -c <mode>           Code inclusion: none|header|full (default: header)
+  --format, -f <format>                Output format: json|pretty|ndjson (default: json)
+  --out, -o <file>                    Output file (default: context.json)
+  --max-nodes, -m <n>                 Max nodes per bundle (default: 100)
+  --profile <profile>                 Preset profile: llm-safe|llm-chat|ci-strict
+  --strict, -s                        Fail on missing dependencies
+  --strict-missing                    Exit with error if any missing dependencies
+  --predict-behavior                  Include behavior predictions
+  --dry-run                           Skip writing output
+  --stats                             Emit JSON stats
+  --skip-gitignore                    Skip .gitignore setup (never prompt or modify)
+  --quiet, -q                         Suppress verbose output (show only errors)
+  -h, --help                          Show this help
+
+STYLE METADATA EXTRACTED:
+  • Styling Sources: Tailwind, SCSS modules, CSS modules, inline styles, styled-components
+  • Layout: Flex/grid patterns, hero sections, feature cards
+  • Visual: Colors, spacing, typography, border radius
+  • Animation: Framer Motion, CSS animations, scroll triggers
+
+EXAMPLES:
+  stamp context style
+    Generate context with style metadata for current directory
+
+  stamp context style ./src
+    Generate with style metadata for src directory
+
+  stamp context style --profile llm-safe
+    Use conservative profile with style metadata
+
+NOTES:
+  • This is equivalent to: stamp context --include-style
+  • Style extraction is optional and won't fail the build if errors occur
+  • Style metadata is added to the 'style' field in UIFContract
+  `;
+}
+export function getGenerateHelp() {
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context - Generate AI Context            │
+│  Scan and analyze React/TS codebase             │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context [path] [options]
+
+ARGUMENTS:
+  [path]                              Directory to scan (default: current)
+
+OPTIONS:
+  --depth, -d <n>                     Dependency depth (default: 1)
+  --include-code, -c <mode>           Code inclusion: none|header|full (default: header)
+  --include-style                     Extract style metadata (Tailwind, SCSS, animations, layout)
+  --format, -f <format>               Output format: json|pretty|ndjson (default: json)
+  --out, -o <file>                    Output file (default: context.json)
+  --max-nodes, -m <n>                 Max nodes per bundle (default: 100)
+  --profile <profile>                 Preset profile: llm-safe|llm-chat|ci-strict
+  --strict, -s                        Fail on missing dependencies
+  --strict-missing                    Exit with error if any missing dependencies
+  --predict-behavior                  Include behavior predictions
+  --dry-run                           Skip writing output
+  --stats                             Emit JSON stats
+  --compare-modes                     Show detailed mode comparison table
+  --skip-gitignore                    Skip .gitignore setup (never prompt or modify)
+  --quiet, -q                         Suppress verbose output (show only errors)
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp context
+    Generate context for current directory
+
+  stamp context style
+    Generate context with style metadata (Tailwind, SCSS, animations, layout)
+
+  stamp context --include-style
+    Alternative syntax for including style metadata
+
+  stamp context ./src --depth 2
+    Deep scan of src directory
+
+  stamp context --include-code none --out api.json
+    Generate API documentation only
+
+  stamp context --compare-modes
+    Show token cost comparison across modes
+
+  stamp context --quiet
+    Suppress verbose output (show only errors)
+  `;
+}
+export function getValidateHelp() {
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context Validate - Bundle Validator      │
+│  Validate context.json structure and schema     │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context validate [file]
+
+ARGUMENTS:
+  [file]                              Path to context.json (default: context.json)
+
+OPTIONS:
+  --quiet                             Show only errors (suppress summaries and valid folders)
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp context validate
+    Validate context.json in current directory
+
+  stamp context validate docs/api-context.json
+    Validate a specific context file
+
+  stamp context validate --quiet
+    Show only validation errors
+
+NOTES:
+  • Validates bundle structure and schema compliance
+  • Checks for required fields and hash formats
+  • Exits with code 0 on success, 1 on failure
+  `;
+}
+export function getCompareHelp() {
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context Compare - Drift Detection        │
+│  Compare context files for changes              │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context compare [options]                     Auto-compare all context files
+  stamp context compare <old.json> <new.json>         Compare two specific files
+  stamp context compare <old_main.json> <new_main.json>  Compare multi-file indices
+
+ARGUMENTS:
+  <old.json>                          Path to old context file or context_main.json
+  <new.json>                          Path to new context file or context_main.json
+
+OPTIONS:
+  --approve                           Auto-approve updates (non-interactive, CI-safe)
+  --clean-orphaned                    Auto-delete orphaned files with --approve
+  --quiet                             Show only diffs (suppress summaries, PASS folders, and token analysis)
+  -h, --help                          Show this help
+
+COMPARISON MODES:
+  Auto-Mode (Multi-File):
+    Compares ALL context files using context_main.json as index
+    → Detects ADDED, ORPHANED, DRIFT, and PASS status per folder
+    → Shows three-tier output: folder summary, component summary, details
+
+  Single-File Mode:
+    Compares two individual context.json files
+    → Detects added/removed/changed components
+
+  Multi-File Manual Mode:
+    Auto-detects when comparing context_main.json files
+    → Compares all referenced context files
+
+EXAMPLES:
+  stamp context compare
+    Auto-mode: generate fresh context, compare ALL files
+    → Shows folder-level and component-level changes
+    → Interactive: prompts Y/N to update if drift detected
+    → CI: exits with code 1 if drift detected (no prompt)
+
+  stamp context compare --approve
+    Auto-approve and update ALL context files if drift (like jest -u)
+
+  stamp context compare --approve --clean-orphaned
+    Auto-approve updates and delete orphaned context files
+
+  stamp context compare --stats
+    Show per-folder token count deltas
+
+  stamp context compare --quiet
+    Show only diffs (suppress summaries, PASS folders, and status headers)
+
+  stamp context compare old.json new.json
+    Compare two specific context files
+
+  stamp context compare old/context_main.json new/context_main.json
+    Compare all context files between two directories
+
+  stamp context compare || exit 1
+    CI validation: fail build if drift detected
+
+EXIT CODES:
+  0                                   PASS - No drift OR drift approved and updated
+  1                                   DRIFT - Changes detected but not approved
+
+BEHAVIOR:
+  • --approve: Non-interactive, deterministic, updates immediately if drift
+  • Interactive (TTY): Prompts "Update all context files? (y/N)" if drift
+  • CI (non-TTY): Never prompts, exits 1 if drift detected
+  • --clean-orphaned: Requires --approve, deletes orphaned files automatically
+  • --quiet: Shows only diffs - suppresses status headers (PASS), summaries, PASS folders, and token analysis
+
+DRIFT INDICATORS:
+  ➕ ADDED FILE         New folder with context file
+  🗑️  ORPHANED FILE     Folder removed (context file still exists)
+  ⚠️  DRIFT             Folder has component changes
+  ✅ PASS               Folder unchanged
+
+NOTES:
+  This matches Jest snapshot workflow:
+    jest          → prompts to update snapshots locally
+    jest -u       → updates snapshots without prompt
+    CI            → fails if snapshots don't match
+  `;
+}
+export function getCleanHelp() {
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context Clean - Remove Artifacts        │
+│  Delete all generated context files            │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context clean [path] [options]
+
+ARGUMENTS:
+  [path]                              Directory to clean (default: current)
+
+OPTIONS:
+  --all                               Include all context files
+  --yes                               Confirm deletion (required with --all)
+  --quiet, -q                         Suppress verbose output (show only errors)
+  -h, --help                          Show this help
+
+BEHAVIOR:
+  • Default (dry run): Shows what would be removed
+  • --all --yes: Actually deletes the files
+  • Automatically includes .logicstamp/ directory if it exists
+  • --quiet: Shows only ✓ on success, errors otherwise
+
+FILES REMOVED:
+  • context_main.json                 Main index file
+  • **/context.json                   All folder context files
+  • .logicstamp/                      Cache directory (if present)
+
+EXAMPLES:
+  stamp context clean
+    Show what would be removed (dry run)
+
+  stamp context clean --all --yes
+    Actually delete all context artifacts (includes .logicstamp/ if present)
+
+  stamp context clean --all --yes --quiet
+    Delete files silently (show only ✓)
+
+  stamp context clean ./src --all --yes
+    Clean context files in specific directory
+
+NOTES:
+  • Safe by default - requires --all --yes to actually delete
+  • Ignores node_modules, dist, build, .next directories
+  • Exits with code 0 on success
+  `;
+}
+export function getInitHelp() {
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Init - Initialize LogicStamp            │
+│  Set up LogicStamp in your project              │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp init [path] [options]
+
+ARGUMENTS:
+  [path]                              Target directory (default: current)
+
+OPTIONS:
+  --skip-gitignore                    Skip .gitignore setup
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp init
+    Set up LogicStamp in current directory
+
+  stamp init ./my-project
+    Set up LogicStamp in a specific directory
+
+  stamp init --skip-gitignore
+    Initialize without modifying .gitignore
+
+WHAT IT DOES:
+  • Creates or updates .gitignore with LogicStamp patterns:
+    - context.json
+    - context_*.json
+    - *.uif.json
+    - logicstamp.manifest.json
+    - .logicstamp/
+
+NOTES:
+  • Safe to run multiple times (idempotent)
+  • Won't duplicate patterns if they already exist
+  • Creates .gitignore if it doesn't exist
+  `;
+}
+//# sourceMappingURL=helpText.js.map

package/dist/cli/parser/helpText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpText.js","sourceRoot":"","sources":["../../../src/cli/parser/helpText.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,WAAW;IACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCN,CAAC;AACJ,CAAC"}