prelude-context 1.0.0 → 1.1.0

package/README.md

@@ -94,6 +94,7 @@ Here's what Prelude generates for a Next.js monorepo:
 | Machine-optimized | ✅ | ❌ | ✅ |
 | Version controlled | ✅ | ⚠️ | ❌ |
 | Zero configuration | ✅ | N/A | ❌ |
+| Preserves manual edits | ✅ | ✅ | ❌ |
 
 ---
 
@@ -116,6 +117,25 @@ Generates a markdown document optimized for LLMs:
 - Automatically copied to clipboard
 - Perfect for starting new AI conversations
 
+### `prelude update`
+Re-analyzes your codebase and intelligently updates context:
+```bash
+prelude update
+# Smart merge - preserves manual edits, updates inferred data
+
+prelude update --dry-run
+# Preview changes without applying them
+
+prelude update --force
+# Overwrite everything (except decisions/changelog)
+```
+
+**Key features:**
+- ✅ **Preserves manual edits** - Never loses your customizations
+- ✅ **Shows what changed** - Color-coded diff of updates
+- ✅ **Automatic backups** - Saves history before every update
+- ✅ **Smart merging** - Combines new inferred data with manual edits
+
 ### `prelude decision <title>`
 Logs architecture decisions:
 ```bash
@@ -174,6 +194,17 @@ Share your `.context/` directory with new team members so they can:
 - Learn architectural patterns
 - See past decisions and rationale
 
+### 🔄 Keeping Context Fresh
+```bash
+# After adding dependencies
+npm install @tanstack/react-query
+prelude update
+
+# After restructuring
+prelude update --dry-run  # Preview changes first
+prelude update            # Apply updates
+```
+
 ---
 
 ## The Prelude Format
@@ -213,6 +244,8 @@ The `.context/` files are human-readable JSON. Edit them directly:
 }
 ```
 
+**Manual edits are preserved** when you run `prelude update` - the smart merge system tracks what's inferred vs. what you've customized.
+
 ### Custom Fields
 Add project-specific fields - the schemas allow additional properties:
 
@@ -263,7 +296,10 @@ your-project/
 │   ├── architecture.json # Architecture patterns
 │   ├── constraints.json  # Development rules
 │   ├── decisions.json    # Architecture decisions
-│   └── changelog.md      # Project timeline
+│   ├── changelog.md      # Project timeline
+│   └── .prelude/         # State tracking (gitignore *.session.json)
+│       ├── state.json    # Tracks inferred vs manual fields
+│       └── history/      # Automatic backups
 ├── .gitignore            # Add .context/*.session.json
 └── ...
 ```
@@ -278,7 +314,10 @@ your-project/
 **Yes!** The context is part of your project documentation. Exception: `.context/*.session.json` should be gitignored (it's for local work tracking).
 
 ### How often should I update the context?
-Prelude auto-updates timestamps. Run `prelude export` whenever you need fresh context for an AI conversation. Update the JSON files manually when you make architectural changes.
+Run `prelude update` after major changes (new dependencies, restructuring). Run `prelude export` whenever you need fresh context for an AI conversation.
+
+### What happens to my manual edits?
+They're preserved! Prelude tracks which fields are inferred vs. manually edited. When you run `update`, it only changes auto-detected data while keeping your customizations.
 
 ### Can I use this with any LLM?
 Yes! The export format is optimized for Claude, ChatGPT, Gemini, and any text-based AI assistant.
@@ -293,6 +332,7 @@ Yes! While the CLI is built with Node.js, the Prelude format works with any lang
 
 ## Roadmap
 
+- [x] Smart context updates with manual edit preservation
 - [ ] Improved inference for Python, Rust, Go
 - [ ] VS Code extension for inline context
 - [ ] GitHub Action for automated updates
@@ -311,6 +351,7 @@ Want to contribute? See [CONTRIBUTING.md](./CONTRIBUTING.md)
 3. **Standards-based** - Open spec, not proprietary format
 4. **Zero lock-in** - Edit files manually, use any tool
 5. **Incremental adoption** - Works with partial information
+6. **Preserve intent** - Never lose manual customizations
 
 ---
 

package/dist/bin/prelude.js

@@ -24,12 +24,21 @@ import { registerExportCommand } from '../src/commands/export.js';
 import { registerShareCommand } from '../src/commands/share.js';
 import { registerDecisionCommand } from '../src/commands/decision.js';
 import { registerWatchCommand } from '../src/commands/watch.js';
+import { update } from '../src/commands/update.js';
 // Register all commands
 registerInitCommand(cli);
 registerExportCommand(cli);
 registerShareCommand(cli);
 registerDecisionCommand(cli);
 registerWatchCommand(cli);
+// Register update command
+cli
+    .command('update', 'Update context by re-analyzing the codebase')
+    .option('--force', 'Overwrite all inferred fields')
+    .option('--dry-run', 'Show what would change without applying')
+    .option('--interactive', 'Prompt for each change')
+    .option('--silent', 'Minimal output')
+    .action(update);
 // Parse and run
 cli.parse();
 //# sourceMappingURL=prelude.js.map

package/dist/bin/prelude.js.map

@@ -1 +1 @@
-{"version":3,"file":"prelude.js","sourceRoot":"","sources":["../../bin/prelude.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,0DAA0D;AAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,+DAA+D;AAC/D,IAAI,WAAgB,CAAC;AACrB,IAAI,CAAC;IACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACzF,CAAC;AAAC,MAAM,CAAC;IACP,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;AAE3B,GAAG;KACA,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,IAAI,EAAE,CAAC;AAEV,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,wBAAwB;AACxB,mBAAmB,CAAC,GAAG,CAAC,CAAC;AACzB,qBAAqB,CAAC,GAAG,CAAC,CAAC;AAC3B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAC1B,uBAAuB,CAAC,GAAG,CAAC,CAAC;AAC7B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAE1B,gBAAgB;AAChB,GAAG,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"prelude.js","sourceRoot":"","sources":["../../bin/prelude.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,0DAA0D;AAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,+DAA+D;AAC/D,IAAI,WAAgB,CAAC;AACrB,IAAI,CAAC;IACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACzF,CAAC;AAAC,MAAM,CAAC;IACP,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;AAE3B,GAAG;KACA,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,IAAI,EAAE,CAAC;AAEV,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD,wBAAwB;AACxB,mBAAmB,CAAC,GAAG,CAAC,CAAC;AACzB,qBAAqB,CAAC,GAAG,CAAC,CAAC;AAC3B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAC1B,uBAAuB,CAAC,GAAG,CAAC,CAAC;AAC7B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAE1B,0BAA0B;AAC1B,GAAG;KACA,OAAO,CAAC,QAAQ,EAAE,6CAA6C,CAAC;KAChE,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;KAClD,MAAM,CAAC,WAAW,EAAE,yCAAyC,CAAC;KAC9D,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC;KACjD,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC;KACpC,MAAM,CAAC,MAAM,CAAC,CAAC;AAElB,gBAAgB;AAChB,GAAG,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/commands/update.d.ts

@@ -0,0 +1,11 @@
+export interface UpdateOptions {
+    force?: boolean;
+    dryRun?: boolean;
+    interactive?: boolean;
+    silent?: boolean;
+}
+/**
+ * Update context by re-analyzing codebase
+ */
+export declare function update(options?: UpdateOptions): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/src/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,iBAiHvD"}

package/dist/src/commands/update.js

@@ -0,0 +1,183 @@
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { StateManager } from '../core/state-manager.js';
+import { ContextMerger } from '../core/merger.js';
+import { inferProjectMetadata, inferStack, inferArchitecture, inferConstraints } from '../core/infer.js';
+import { readJSON, writeJSON } from '../utils/fs.js';
+import { logger } from '../utils/log.js';
+/**
+ * Update context by re-analyzing codebase
+ */
+export async function update(options = {}) {
+    const contextDir = '.context';
+    // Check if context exists
+    if (!existsSync(contextDir)) {
+        logger.error('No .context directory found. Run `prelude init` first.');
+        process.exit(1);
+    }
+    if (!options.silent) {
+        logger.info('🔄 Updating context...\n');
+    }
+    try {
+        // Initialize state manager
+        const stateManager = new StateManager(contextDir);
+        // Create backup before updating
+        if (!options.dryRun) {
+            stateManager.backup();
+            if (!options.silent) {
+                logger.success('✓ Created backup of current state');
+            }
+        }
+        // Read existing context
+        const existing = {
+            project: await readJSON(join(contextDir, 'project.json')),
+            stack: await readJSON(join(contextDir, 'stack.json')),
+            architecture: await readJSON(join(contextDir, 'architecture.json')),
+            constraints: await readJSON(join(contextDir, 'constraints.json')),
+        };
+        // Re-infer from codebase
+        if (!options.silent) {
+            logger.info('Analyzing codebase...');
+        }
+        const inferred = {
+            project: await inferProjectMetadata(process.cwd()),
+            stack: await inferStack(process.cwd()),
+            architecture: await inferArchitecture(process.cwd()),
+            constraints: await inferConstraints(process.cwd()),
+        };
+        if (options.force) {
+            // Force mode: overwrite everything except decisions/changelog
+            return await forceUpdate(contextDir, inferred, options);
+        }
+        // Smart merge mode
+        const merger = new ContextMerger(stateManager);
+        const projectResult = merger.mergeProject(existing.project, inferred.project);
+        const stackResult = merger.mergeStack(existing.stack, inferred.stack);
+        const architectureResult = merger.mergeArchitecture(existing.architecture, inferred.architecture);
+        const constraintsResult = merger.mergeConstraints(existing.constraints, inferred.constraints);
+        const allChanges = [
+            ...projectResult.changes.map(c => ({ file: 'project.json', ...c })),
+            ...stackResult.changes.map(c => ({ file: 'stack.json', ...c })),
+            ...architectureResult.changes.map(c => ({ file: 'architecture.json', ...c })),
+            ...constraintsResult.changes.map(c => ({ file: 'constraints.json', ...c })),
+        ];
+        // Show changes
+        if (allChanges.length === 0) {
+            logger.success('✓ Context is up to date, no changes needed');
+            return;
+        }
+        if (!options.silent) {
+            console.log('');
+            displayChanges(allChanges);
+            console.log('');
+        }
+        // Dry run - don't apply changes
+        if (options.dryRun) {
+            logger.info('🔍 Dry run complete - no changes applied');
+            logger.info('Run `prelude update` to apply these changes');
+            return;
+        }
+        // Interactive mode - prompt for each change
+        if (options.interactive) {
+            logger.warn('Interactive mode not yet implemented - applying all changes');
+            // TODO: Implement interactive prompts
+        }
+        // Apply changes
+        await writeJSON(join(contextDir, 'project.json'), projectResult.merged);
+        await writeJSON(join(contextDir, 'stack.json'), stackResult.merged);
+        await writeJSON(join(contextDir, 'architecture.json'), architectureResult.merged);
+        await writeJSON(join(contextDir, 'constraints.json'), constraintsResult.merged);
+        // Update state tracking
+        trackAllFields(stateManager, 'project.json', projectResult.merged, inferred.project);
+        trackAllFields(stateManager, 'stack.json', stackResult.merged, inferred.stack);
+        trackAllFields(stateManager, 'architecture.json', architectureResult.merged, inferred.architecture);
+        trackAllFields(stateManager, 'constraints.json', constraintsResult.merged, inferred.constraints);
+        stateManager.save();
+        if (!options.silent) {
+            logger.success(`\n✅ Context updated successfully! (${allChanges.length} changes applied)`);
+            logger.info('ℹ️  Run `prelude export` to generate fresh output');
+        }
+    }
+    catch (error) {
+        logger.error(`Update failed: ${error.message}`);
+        process.exit(1);
+    }
+}
+/**
+ * Force update - overwrites everything
+ */
+async function forceUpdate(contextDir, inferred, options) {
+    if (options.dryRun) {
+        logger.info('🔍 Force mode would overwrite all context files');
+        logger.info('(decisions.json and changelog.md will be preserved)');
+        return;
+    }
+    // Write inferred context
+    await writeJSON(join(contextDir, 'project.json'), inferred.project);
+    await writeJSON(join(contextDir, 'stack.json'), inferred.stack);
+    await writeJSON(join(contextDir, 'architecture.json'), inferred.architecture);
+    await writeJSON(join(contextDir, 'constraints.json'), inferred.constraints);
+    // Preserve decisions and changelog (they're already on disk)
+    if (!options.silent) {
+        logger.success('✅ Force update complete');
+        logger.info('ℹ️  All context files overwritten (except decisions.json and changelog.md)');
+    }
+}
+/**
+ * Display changes in a readable format
+ */
+function displayChanges(changes) {
+    const grouped = changes.reduce((acc, change) => {
+        if (!acc[change.file])
+            acc[change.file] = [];
+        acc[change.file].push(change);
+        return acc;
+    }, {});
+    for (const [file, fileChanges] of Object.entries(grouped)) {
+        logger.info(`📄 ${file}:`);
+        for (const change of fileChanges) {
+            const icon = {
+                added: '  + ',
+                removed: '  - ',
+                modified: '  ~ ',
+                preserved: '  ✓ ',
+            }[change.type];
+            const color = {
+                added: '\x1b[32m', // Green
+                removed: '\x1b[31m', // Red
+                modified: '\x1b[33m', // Yellow
+                preserved: '\x1b[36m', // Cyan
+            }[change.type];
+            const reset = '\x1b[0m';
+            console.log(`${icon}${color}${change.field}${reset} - ${change.reason}`);
+            if (change.oldValue !== undefined) {
+                console.log(`    Old: ${JSON.stringify(change.oldValue)}`);
+            }
+            if (change.newValue !== undefined) {
+                console.log(`    New: ${JSON.stringify(change.newValue)}`);
+            }
+        }
+        console.log('');
+    }
+}
+/**
+ * Track all fields in state manager
+ */
+function trackAllFields(stateManager, file, merged, inferred) {
+    for (const key of Object.keys(merged)) {
+        const mergedValue = merged[key];
+        const inferredValue = inferred[key];
+        // Skip undefined values
+        if (mergedValue === undefined)
+            continue;
+        // If values are the same, track as inferred
+        if (JSON.stringify(mergedValue) === JSON.stringify(inferredValue)) {
+            stateManager.trackInferred(file, key, mergedValue);
+        }
+        else {
+            // Otherwise, track as manual
+            stateManager.trackManual(file, key, mergedValue);
+        }
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/src/commands/update.js.map

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

package/dist/src/core/merger.d.ts

@@ -0,0 +1,48 @@
+import type { StateManager } from './state-manager.js';
+import type { Project, Stack, Architecture, Constraints } from '../schema/index.js';
+/**
+ * Strategies for merging different types of content
+ */
+export interface MergeResult<T> {
+    merged: T;
+    changes: MergeChange[];
+}
+export interface MergeChange {
+    field: string;
+    type: 'added' | 'removed' | 'modified' | 'preserved';
+    oldValue?: any;
+    newValue?: any;
+    reason: string;
+}
+/**
+ * Intelligent merger for context updates
+ */
+export declare class ContextMerger {
+    private stateManager;
+    constructor(stateManager: StateManager);
+    /**
+     * Merge project context
+     */
+    mergeProject(existing: Project, inferred: Project): MergeResult<Project>;
+    /**
+     * Merge stack context
+     */
+    mergeStack(existing: Stack, inferred: Stack): MergeResult<Stack>;
+    /**
+     * Merge architecture context
+     */
+    mergeArchitecture(existing: Architecture, inferred: Architecture): MergeResult<Architecture>;
+    /**
+     * Merge constraints context
+     */
+    mergeConstraints(existing: Constraints, inferred: Constraints): MergeResult<Constraints>;
+    /**
+     * Helper to get nested value by path
+     */
+    private getNestedValue;
+    /**
+     * Helper to set nested value by path
+     */
+    private setNestedValue;
+}
+//# sourceMappingURL=merger.d.ts.map

package/dist/src/core/merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.d.ts","sourceRoot":"","sources":["../../../src/core/merger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEpF;;GAEG;AAEH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IACrD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAE9C;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAiFxE;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;IA4ChE;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC;IAkD5F;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;IA6CxF;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,cAAc;CASvB"}

package/dist/src/core/merger.js

@@ -0,0 +1,221 @@
+/**
+ * Intelligent merger for context updates
+ */
+export class ContextMerger {
+    stateManager;
+    constructor(stateManager) {
+        this.stateManager = stateManager;
+    }
+    /**
+     * Merge project context
+     */
+    mergeProject(existing, inferred) {
+        const changes = [];
+        const merged = { ...inferred };
+        // Always preserve manual fields
+        const manualFields = this.stateManager.getManualFields('project.json');
+        for (const field of manualFields) {
+            const existingValue = this.getNestedValue(existing, field);
+            const inferredValue = this.getNestedValue(inferred, field);
+            if (existingValue !== undefined) {
+                this.setNestedValue(merged, field, existingValue);
+                if (JSON.stringify(existingValue) !== JSON.stringify(inferredValue)) {
+                    changes.push({
+                        field,
+                        type: 'preserved',
+                        oldValue: inferredValue,
+                        newValue: existingValue,
+                        reason: 'Manually edited field preserved',
+                    });
+                }
+            }
+        }
+        // Always preserve certain fields (only if they actually exist)
+        const preserveFields = ['team', 'goals'];
+        for (const field of preserveFields) {
+            const existingValue = existing[field];
+            const inferredValue = inferred[field];
+            // Only preserve if it exists in existing AND is different from inferred
+            if (existingValue !== undefined && existingValue !== null &&
+                JSON.stringify(existingValue) !== JSON.stringify(inferredValue)) {
+                merged[field] = existingValue;
+                changes.push({
+                    field,
+                    type: 'preserved',
+                    newValue: existingValue,
+                    reason: 'User-maintained field',
+                });
+            }
+        }
+        // Check for new inferred changes
+        for (const key of Object.keys(inferred)) {
+            if (preserveFields.includes(key) || manualFields.includes(key)) {
+                continue;
+            }
+            const oldValue = existing[key];
+            const newValue = inferred[key];
+            if (JSON.stringify(oldValue) !== JSON.stringify(newValue)) {
+                if (oldValue === undefined) {
+                    changes.push({
+                        field: key,
+                        type: 'added',
+                        newValue,
+                        reason: 'New inferred value',
+                    });
+                }
+                else {
+                    changes.push({
+                        field: key,
+                        type: 'modified',
+                        oldValue,
+                        newValue,
+                        reason: 'Codebase changed',
+                    });
+                }
+            }
+        }
+        // Update timestamp
+        merged.updatedAt = new Date().toISOString();
+        return { merged, changes };
+    }
+    /**
+     * Merge stack context
+     */
+    mergeStack(existing, inferred) {
+        const changes = [];
+        const merged = { ...inferred };
+        // Check for removed dependencies
+        const existingDeps = new Set([
+            ...(existing.frameworks || []),
+            ...(existing.buildTools || []),
+            ...(existing.testingFrameworks || []),
+            ...(existing.styling || []),
+        ]);
+        const inferredDeps = new Set([
+            ...(inferred.frameworks || []),
+            ...(inferred.buildTools || []),
+            ...(inferred.testingFrameworks || []),
+            ...(inferred.styling || []),
+        ]);
+        for (const dep of existingDeps) {
+            if (!inferredDeps.has(dep)) {
+                changes.push({
+                    field: 'dependencies',
+                    type: 'removed',
+                    oldValue: dep,
+                    reason: 'No longer detected in project',
+                });
+            }
+        }
+        for (const dep of inferredDeps) {
+            if (!existingDeps.has(dep)) {
+                changes.push({
+                    field: 'dependencies',
+                    type: 'added',
+                    newValue: dep,
+                    reason: 'New dependency detected',
+                });
+            }
+        }
+        return { merged, changes };
+    }
+    /**
+     * Merge architecture context
+     */
+    mergeArchitecture(existing, inferred) {
+        const changes = [];
+        const merged = { ...inferred };
+        // Preserve manual patterns
+        const manualFields = this.stateManager.getManualFields('architecture.json');
+        if (manualFields.includes('patterns')) {
+            merged.patterns = existing.patterns;
+            changes.push({
+                field: 'patterns',
+                type: 'preserved',
+                newValue: existing.patterns,
+                reason: 'Manually specified patterns',
+            });
+        }
+        // Merge directories (new + preserved manual)
+        if (existing.directories && inferred.directories) {
+            const existingDirPaths = new Set(existing.directories.map(d => d.path));
+            const inferredDirPaths = new Set(inferred.directories.map(d => d.path));
+            // Find removed directories
+            for (const dir of existing.directories) {
+                if (!inferredDirPaths.has(dir.path)) {
+                    changes.push({
+                        field: 'directories',
+                        type: 'removed',
+                        oldValue: dir.path,
+                        reason: 'Directory no longer exists',
+                    });
+                }
+            }
+            // Find new directories
+            for (const dir of inferred.directories) {
+                if (!existingDirPaths.has(dir.path)) {
+                    changes.push({
+                        field: 'directories',
+                        type: 'added',
+                        newValue: dir.path,
+                        reason: 'New directory detected',
+                    });
+                }
+            }
+        }
+        return { merged, changes };
+    }
+    /**
+     * Merge constraints context
+     */
+    mergeConstraints(existing, inferred) {
+        const changes = [];
+        const merged = { ...inferred };
+        // Preserve user-added preferences
+        if (existing.preferences && existing.preferences.length > 0) {
+            const manualPreferences = existing.preferences.filter(pref => this.stateManager.isManuallyEdited('constraints.json', `preferences.${pref.category}`));
+            merged.preferences = [
+                ...(inferred.preferences || []),
+                ...manualPreferences,
+            ];
+            if (manualPreferences.length > 0) {
+                changes.push({
+                    field: 'preferences',
+                    type: 'preserved',
+                    newValue: manualPreferences,
+                    reason: 'User-defined preferences preserved',
+                });
+            }
+        }
+        // Merge mustUse/mustNotUse (combine inferred + manual)
+        if (existing.mustUse) {
+            const manual = existing.mustUse.filter(item => this.stateManager.isManuallyEdited('constraints.json', `mustUse.${item}`));
+            merged.mustUse = [...new Set([...(inferred.mustUse || []), ...manual])];
+        }
+        if (existing.mustNotUse) {
+            const manual = existing.mustNotUse.filter(item => this.stateManager.isManuallyEdited('constraints.json', `mustNotUse.${item}`));
+            merged.mustNotUse = [...new Set([...(inferred.mustNotUse || []), ...manual])];
+        }
+        return { merged, changes };
+    }
+    /**
+     * Helper to get nested value by path
+     */
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((curr, key) => curr?.[key], obj);
+    }
+    /**
+     * Helper to set nested value by path
+     */
+    setNestedValue(obj, path, value) {
+        const keys = path.split('.');
+        const lastKey = keys.pop();
+        const target = keys.reduce((curr, key) => {
+            if (!curr[key])
+                curr[key] = {};
+            return curr[key];
+        }, obj);
+        target[lastKey] = value;
+    }
+}
+//# sourceMappingURL=merger.js.map

package/dist/src/core/merger.js.map

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

package/dist/src/core/state-manager.d.ts

@@ -0,0 +1,62 @@
+import type { PreludeState, FieldState } from '../schema/state.js';
+/**
+ * Manages Prelude state tracking
+ */
+export declare class StateManager {
+    private state;
+    private contextDir;
+    constructor(contextDir?: string);
+    /**
+     * Load state from disk or create new
+     */
+    private loadState;
+    /**
+     * Save state to disk
+     */
+    save(): void;
+    /**
+     * Create backup of current state
+     */
+    backup(): void;
+    /**
+     * Hash a value for change detection
+     */
+    private hash;
+    /**
+     * Track a field as inferred
+     */
+    trackInferred(file: string, fieldPath: string, value: any): void;
+    /**
+     * Track a field as manually edited
+     */
+    trackManual(file: string, fieldPath: string, value: any): void;
+    /**
+     * Check if a field was manually edited
+     */
+    isManuallyEdited(file: string, fieldPath: string): boolean;
+    /**
+     * Check if inferred value changed
+     */
+    hasInferredChanged(file: string, fieldPath: string, newValue: any): boolean;
+    /**
+     * Get field state
+     */
+    getFieldState(file: string, fieldPath: string): FieldState | undefined;
+    /**
+     * Get file state
+     */
+    private getFileState;
+    /**
+     * Get or create file state
+     */
+    private getOrCreateFileState;
+    /**
+     * Get all manually edited fields for a file
+     */
+    getManualFields(file: string): string[];
+    /**
+     * Get current state
+     */
+    getState(): PreludeState;
+}
+//# sourceMappingURL=state-manager.d.ts.map

package/dist/src/core/state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../../src/core/state-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAa,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQ9E;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,GAAE,MAAmB;IAK3C;;OAEG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,IAAI,IAAI,IAAI;IAgBZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAad;;OAEG;IACH,OAAO,CAAC,IAAI;IAOZ;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAQhE;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAO9D;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAQ1D;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO;IAW3E;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAKtE;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IASvC;;OAEG;IACH,QAAQ,IAAI,YAAY;CAGzB"}

package/dist/src/core/state-manager.js

@@ -0,0 +1,156 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { createHash } from 'crypto';
+import { createInitialState, trackField } from '../schema/state.js';
+const STATE_DIR = '.context/.prelude';
+const STATE_FILE = join(STATE_DIR, 'state.json');
+const HISTORY_DIR = join(STATE_DIR, 'history');
+/**
+ * Manages Prelude state tracking
+ */
+export class StateManager {
+    state;
+    contextDir;
+    constructor(contextDir = '.context') {
+        this.contextDir = contextDir;
+        this.state = this.loadState();
+    }
+    /**
+     * Load state from disk or create new
+     */
+    loadState() {
+        const statePath = join(this.contextDir, '.prelude', 'state.json');
+        if (existsSync(statePath)) {
+            try {
+                const content = readFileSync(statePath, 'utf-8');
+                return JSON.parse(content);
+            }
+            catch (error) {
+                console.warn('Failed to load state, creating new:', error);
+            }
+        }
+        return createInitialState();
+    }
+    /**
+     * Save state to disk
+     */
+    save() {
+        const stateDir = join(this.contextDir, '.prelude');
+        const statePath = join(stateDir, 'state.json');
+        // Ensure directories exist
+        if (!existsSync(stateDir)) {
+            mkdirSync(stateDir, { recursive: true });
+        }
+        // Update timestamp
+        this.state.lastUpdate = new Date().toISOString();
+        // Write state
+        writeFileSync(statePath, JSON.stringify(this.state, null, 2));
+    }
+    /**
+     * Create backup of current state
+     */
+    backup() {
+        const historyDir = join(this.contextDir, '.prelude', 'history');
+        if (!existsSync(historyDir)) {
+            mkdirSync(historyDir, { recursive: true });
+        }
+        const timestamp = new Date().toISOString().replace(/:/g, '-').replace(/\..+/, '');
+        const backupPath = join(historyDir, `${timestamp}.json`);
+        writeFileSync(backupPath, JSON.stringify(this.state, null, 2));
+    }
+    /**
+     * Hash a value for change detection
+     */
+    hash(value) {
+        return createHash('sha256')
+            .update(JSON.stringify(value))
+            .digest('hex')
+            .substring(0, 16);
+    }
+    /**
+     * Track a field as inferred
+     */
+    trackInferred(file, fieldPath, value) {
+        const fileState = this.getOrCreateFileState(file);
+        const valueHash = this.hash(value);
+        fileState.fields[fieldPath] = trackField(value, 'inferred', valueHash);
+        fileState.lastUpdated = new Date().toISOString();
+    }
+    /**
+     * Track a field as manually edited
+     */
+    trackManual(file, fieldPath, value) {
+        const fileState = this.getOrCreateFileState(file);
+        fileState.fields[fieldPath] = trackField(value, 'manual');
+        fileState.lastUpdated = new Date().toISOString();
+    }
+    /**
+     * Check if a field was manually edited
+     */
+    isManuallyEdited(file, fieldPath) {
+        const fileState = this.getFileState(file);
+        if (!fileState)
+            return false;
+        const fieldState = fileState.fields[fieldPath];
+        return fieldState?.source === 'manual';
+    }
+    /**
+     * Check if inferred value changed
+     */
+    hasInferredChanged(file, fieldPath, newValue) {
+        const fileState = this.getFileState(file);
+        if (!fileState)
+            return true;
+        const fieldState = fileState.fields[fieldPath];
+        if (!fieldState)
+            return true;
+        const newHash = this.hash(newValue);
+        return fieldState.inferredHash !== newHash;
+    }
+    /**
+     * Get field state
+     */
+    getFieldState(file, fieldPath) {
+        const fileState = this.getFileState(file);
+        return fileState?.fields[fieldPath];
+    }
+    /**
+     * Get file state
+     */
+    getFileState(file) {
+        return this.state.files.find(f => f.file === file);
+    }
+    /**
+     * Get or create file state
+     */
+    getOrCreateFileState(file) {
+        let fileState = this.getFileState(file);
+        if (!fileState) {
+            fileState = {
+                file,
+                lastUpdated: new Date().toISOString(),
+                fields: {},
+            };
+            this.state.files.push(fileState);
+        }
+        return fileState;
+    }
+    /**
+     * Get all manually edited fields for a file
+     */
+    getManualFields(file) {
+        const fileState = this.getFileState(file);
+        if (!fileState)
+            return [];
+        return Object.entries(fileState.fields)
+            .filter(([_, state]) => state.source === 'manual')
+            .map(([path, _]) => path);
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+}
+//# sourceMappingURL=state-manager.js.map

package/dist/src/core/state-manager.js.map

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

package/dist/src/schema/state.d.ts

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+/**
+ * Tracks which fields are inferred vs manually edited
+ * Stored in .context/.prelude/state.json
+ */
+export declare const FieldStateSchema: z.ZodObject<{
+    value: z.ZodAny;
+    source: z.ZodEnum<["inferred", "manual", "merged"]>;
+    lastInferred: z.ZodOptional<z.ZodString>;
+    lastModified: z.ZodOptional<z.ZodString>;
+    inferredHash: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: "inferred" | "manual" | "merged";
+    value?: any;
+    lastInferred?: string | undefined;
+    lastModified?: string | undefined;
+    inferredHash?: string | undefined;
+}, {
+    source: "inferred" | "manual" | "merged";
+    value?: any;
+    lastInferred?: string | undefined;
+    lastModified?: string | undefined;
+    inferredHash?: string | undefined;
+}>;
+export declare const FileStateSchema: z.ZodObject<{
+    file: z.ZodString;
+    lastUpdated: z.ZodString;
+    fields: z.ZodRecord<z.ZodString, z.ZodObject<{
+        value: z.ZodAny;
+        source: z.ZodEnum<["inferred", "manual", "merged"]>;
+        lastInferred: z.ZodOptional<z.ZodString>;
+        lastModified: z.ZodOptional<z.ZodString>;
+        inferredHash: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "inferred" | "manual" | "merged";
+        value?: any;
+        lastInferred?: string | undefined;
+        lastModified?: string | undefined;
+        inferredHash?: string | undefined;
+    }, {
+        source: "inferred" | "manual" | "merged";
+        value?: any;
+        lastInferred?: string | undefined;
+        lastModified?: string | undefined;
+        inferredHash?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    lastUpdated: string;
+    fields: Record<string, {
+        source: "inferred" | "manual" | "merged";
+        value?: any;
+        lastInferred?: string | undefined;
+        lastModified?: string | undefined;
+        inferredHash?: string | undefined;
+    }>;
+}, {
+    file: string;
+    lastUpdated: string;
+    fields: Record<string, {
+        source: "inferred" | "manual" | "merged";
+        value?: any;
+        lastInferred?: string | undefined;
+        lastModified?: string | undefined;
+        inferredHash?: string | undefined;
+    }>;
+}>;
+export declare const PreludeStateSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    initialized: z.ZodString;
+    lastUpdate: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        lastUpdated: z.ZodString;
+        fields: z.ZodRecord<z.ZodString, z.ZodObject<{
+            value: z.ZodAny;
+            source: z.ZodEnum<["inferred", "manual", "merged"]>;
+            lastInferred: z.ZodOptional<z.ZodString>;
+            lastModified: z.ZodOptional<z.ZodString>;
+            inferredHash: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "inferred" | "manual" | "merged";
+            value?: any;
+            lastInferred?: string | undefined;
+            lastModified?: string | undefined;
+            inferredHash?: string | undefined;
+        }, {
+            source: "inferred" | "manual" | "merged";
+            value?: any;
+            lastInferred?: string | undefined;
+            lastModified?: string | undefined;
+            inferredHash?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        lastUpdated: string;
+        fields: Record<string, {
+            source: "inferred" | "manual" | "merged";
+            value?: any;
+            lastInferred?: string | undefined;
+            lastModified?: string | undefined;
+            inferredHash?: string | undefined;
+        }>;
+    }, {
+        file: string;
+        lastUpdated: string;
+        fields: Record<string, {
+            source: "inferred" | "manual" | "merged";
+            value?: any;
+            lastInferred?: string | undefined;
+            lastModified?: string | undefined;
+            inferredHash?: string | undefined;
+        }>;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    files: {
+        file: string;
+        lastUpdated: string;
+        fields: Record<string, {
+            source: "inferred" | "manual" | "merged";
+            value?: any;
+            lastInferred?: string | undefined;
+            lastModified?: string | undefined;
+            inferredHash?: string | undefined;
+        }>;
+    }[];
+    initialized: string;
+    lastUpdate: string;
+}, {
+    files: {
+        file: string;
+        lastUpdated: string;
+        fields: Record<string, {
+            source: "inferred" | "manual" | "merged";
+            value?: any;
+            lastInferred?: string | undefined;
+            lastModified?: string | undefined;
+            inferredHash?: string | undefined;
+        }>;
+    }[];
+    initialized: string;
+    lastUpdate: string;
+    version?: string | undefined;
+}>;
+export type FieldState = z.infer<typeof FieldStateSchema>;
+export type FileState = z.infer<typeof FileStateSchema>;
+export type PreludeState = z.infer<typeof PreludeStateSchema>;
+/**
+ * Helper to create initial state
+ */
+export declare function createInitialState(): PreludeState;
+/**
+ * Helper to track a field
+ */
+export declare function trackField(value: any, source: 'inferred' | 'manual' | 'merged', inferredHash?: string): FieldState;
+//# sourceMappingURL=state.d.ts.map

package/dist/src/schema/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/schema/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAM3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI1B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAQjD;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,EACxC,YAAY,CAAC,EAAE,MAAM,GACpB,UAAU,CASZ"}

package/dist/src/schema/state.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+/**
+ * Tracks which fields are inferred vs manually edited
+ * Stored in .context/.prelude/state.json
+ */
+export const FieldStateSchema = z.object({
+    value: z.any(), // The actual value
+    source: z.enum(['inferred', 'manual', 'merged']),
+    lastInferred: z.string().datetime().optional(), // When it was last inferred
+    lastModified: z.string().datetime().optional(), // When user last edited
+    inferredHash: z.string().optional(), // Hash of last inferred value
+});
+export const FileStateSchema = z.object({
+    file: z.string(), // e.g., "project.json"
+    lastUpdated: z.string().datetime(),
+    fields: z.record(z.string(), FieldStateSchema), // field path -> state
+});
+export const PreludeStateSchema = z.object({
+    version: z.string().default('1.0.0'),
+    initialized: z.string().datetime(),
+    lastUpdate: z.string().datetime(),
+    files: z.array(FileStateSchema),
+});
+/**
+ * Helper to create initial state
+ */
+export function createInitialState() {
+    const now = new Date().toISOString();
+    return {
+        version: '1.0.0',
+        initialized: now,
+        lastUpdate: now,
+        files: [],
+    };
+}
+/**
+ * Helper to track a field
+ */
+export function trackField(value, source, inferredHash) {
+    const now = new Date().toISOString();
+    return {
+        value,
+        source,
+        lastInferred: source === 'inferred' ? now : undefined,
+        lastModified: source === 'manual' ? now : undefined,
+        inferredHash,
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/src/schema/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/schema/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,mBAAmB;IACnC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,4BAA4B;IAC5E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,wBAAwB;IACxE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,8BAA8B;CACpE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,uBAAuB;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,EAAE,sBAAsB;CACvE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;CAChC,CAAC,CAAC;AAMH;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,GAAG;QAChB,UAAU,EAAE,GAAG;QACf,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,KAAU,EACV,MAAwC,EACxC,YAAqB;IAErB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,KAAK;QACL,MAAM;QACN,YAAY,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;QACrD,YAAY,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;QACnD,YAAY;KACb,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prelude-context",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "The open standard for expressing and maintaining machine-readable context about a codebase",
   "type": "module",
   "bin": {