prelude-context 1.0.0

package/README.md

@@ -0,0 +1,354 @@
+# Prelude
+
+**The open standard for machine-readable codebase context.**
+
+Prelude transforms your codebase into structured, AI-optimized context that makes working with LLMs 10x more effective.
+
+[![npm version](https://badge.fury.io/js/prelude-context.svg)](https://www.npmjs.com/package/prelude-context)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Why Prelude?
+
+Every time you start a new conversation with an AI assistant, you're forced to explain:
+- What stack you're using
+- How your codebase is organized  
+- What patterns and constraints you follow
+- What decisions have been made
+
+**Prelude solves this.**
+
+Instead of repeating yourself, run `prelude export` and get a comprehensive, AI-optimized context document that captures:
+
+- ✅ Your technology stack
+- ✅ Project architecture and patterns
+- ✅ Development constraints and preferences
+- ✅ Key decisions and their rationale
+- ✅ Recent changes and work sessions
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g prelude-context
+
+# Initialize in your project
+cd your-project
+prelude init
+
+# Generate AI-optimized context
+prelude export
+```
+
+The export is automatically copied to your clipboard - just paste it into Claude, ChatGPT, or any LLM!
+
+---
+
+## Example Output
+
+Here's what Prelude generates for a Next.js monorepo:
+
+```markdown
+# Project Context
+> Generated by Prelude
+
+## 📋 Project Overview
+**Name:** lucem-monorepo
+**Description:** Universal operating system for verified work
+**Version:** 1.0.0
+
+## 🔧 Technology Stack
+**Language:** TypeScript/JavaScript
+**Runtime:** Node.js >=18.0.0
+**Package Manager:** pnpm
+**Frameworks:** Next.js, React
+**Database:** Supabase, PostgreSQL
+**ORM:** Drizzle ORM
+
+## 🏗️ Architecture
+**Type:** monorepo
+**Patterns:** Component-based architecture, Server Components
+**Key Directories:**
+- apps/web - Next.js application
+- packages/db - Database schemas and migrations
+
+## ⚠️ Constraints & Preferences
+**Must Use:**
+- Turborepo for monorepo management
+- TypeScript strict mode
+- Server Components by default
+```
+
+[See full example →](./examples/nextjs-monorepo)
+
+---
+
+## What Makes Prelude Different?
+
+| Feature | Prelude | Manual Context | Other Tools |
+|---------|---------|----------------|-------------|
+| Automatic inference | ✅ | ❌ | ⚠️ |
+| Standards-based | ✅ | ❌ | ❌ |
+| Human-readable | ✅ | ✅ | ❌ |
+| Machine-optimized | ✅ | ❌ | ✅ |
+| Version controlled | ✅ | ⚠️ | ❌ |
+| Zero configuration | ✅ | N/A | ❌ |
+
+---
+
+## Core Commands
+
+### `prelude init`
+Analyzes your codebase and creates a `.context/` directory with:
+- `project.json` - Project metadata
+- `stack.json` - Technology stack
+- `architecture.json` - Architecture patterns and structure
+- `constraints.json` - Development rules and preferences
+- `decisions.json` - Architecture decision records
+- `changelog.md` - Project timeline
+
+All files follow the [Prelude specification](./SPEC.md) and include JSON Schema validation.
+
+### `prelude export`
+Generates a markdown document optimized for LLMs:
+- Combines all context into a single, focused document
+- Automatically copied to clipboard
+- Perfect for starting new AI conversations
+
+### `prelude decision <title>`
+Logs architecture decisions:
+```bash
+prelude decision "Use Drizzle ORM instead of Prisma"
+# Opens editor for you to document the decision and rationale
+```
+
+### `prelude watch`
+Tracks development sessions:
+```bash
+prelude watch
+# Monitors file changes and logs your work session
+# Press Ctrl+C when done to save the session
+```
+
+---
+
+## Use Cases
+
+### 🎯 Starting New Conversations
+Paste your Prelude export to instantly give any LLM full context:
+
+```
+Here's my project context:
+
+[paste prelude export]
+
+I want to add user authentication. What's the best approach given our stack?
+```
+
+### 🐛 Debugging
+```
+Here's my project context:
+
+[paste prelude export]
+
+I'm seeing this error: [error]
+In file: apps/web/app/api/route.ts
+
+What's likely causing this?
+```
+
+### 🏗️ Architecture Decisions
+```
+Here's my project context:
+
+[paste prelude export]
+
+Should I use Server Actions or API routes for [feature]?
+Consider our existing patterns and constraints.
+```
+
+### 📚 Onboarding
+Share your `.context/` directory with new team members so they can:
+- Understand the stack instantly
+- Learn architectural patterns
+- See past decisions and rationale
+
+---
+
+## The Prelude Format
+
+Prelude is an **open standard** - not just a CLI tool. The format is:
+- **Versioned** - Semantic versioning for safe evolution
+- **Validated** - JSON Schema for every file type
+- **Extensible** - Add custom fields as needed
+- **Language-agnostic** - Implement in any language
+
+See the [full specification →](./SPEC.md)
+
+All schemas are hosted at: `https://adjective.us/prelude/schemas/v1/`
+
+---
+
+## Advanced Usage
+
+### Manual Edits
+The `.context/` files are human-readable JSON. Edit them directly:
+
+```json
+{
+  "$schema": "https://adjective.us/prelude/schemas/v1/constraints.json",
+  "version": "1.0.0",
+  "mustUse": [
+    "TypeScript strict mode",
+    "Server Components by default"
+  ],
+  "preferences": [
+    {
+      "category": "state-management",
+      "preference": "Prefer URL state over client state",
+      "rationale": "Improves sharability and reduces bugs"
+    }
+  ]
+}
+```
+
+### Custom Fields
+Add project-specific fields - the schemas allow additional properties:
+
+```json
+{
+  "$schema": "https://adjective.us/prelude/schemas/v1/project.json",
+  "version": "1.0.0",
+  "name": "my-app",
+  "customField": "your data",
+  "team": [
+    { "name": "Alice", "role": "Tech Lead" }
+  ]
+}
+```
+
+### Integration
+Use Prelude in your tools:
+
+```typescript
+import { readFileSync } from 'fs';
+import { join } from 'path';
+
+// Read project context
+const project = JSON.parse(
+  readFileSync(join(process.cwd(), '.context/project.json'), 'utf-8')
+);
+
+console.log(`Project: ${project.name}`);
+console.log(`Stack: ${project.stack?.language}`);
+```
+
+---
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Git (optional, for tracking changes)
+
+---
+
+## Project Structure
+
+```
+your-project/
+├── .context/              # Created by Prelude
+│   ├── project.json      # Project metadata
+│   ├── stack.json        # Technology stack  
+│   ├── architecture.json # Architecture patterns
+│   ├── constraints.json  # Development rules
+│   ├── decisions.json    # Architecture decisions
+│   └── changelog.md      # Project timeline
+├── .gitignore            # Add .context/*.session.json
+└── ...
+```
+
+**Note:** Commit `.context/` to version control (except `*.session.json` files).
+
+---
+
+## FAQ
+
+### Should I commit `.context/` to git?
+**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.
+
+### Can I use this with any LLM?
+Yes! The export format is optimized for Claude, ChatGPT, Gemini, and any text-based AI assistant.
+
+### What if my project structure is unusual?
+Prelude's inference is smart but not perfect. Just edit the `.context/` files directly - they're human-readable JSON.
+
+### Does this work with non-JavaScript projects?
+Yes! While the CLI is built with Node.js, the Prelude format works with any language. The inference currently focuses on JavaScript/TypeScript but the format is universal.
+
+---
+
+## Roadmap
+
+- [ ] Improved inference for Python, Rust, Go
+- [ ] VS Code extension for inline context
+- [ ] GitHub Action for automated updates
+- [ ] Plugin system for custom inference
+- [ ] CLI validation command
+- [ ] Context diff tool
+
+Want to contribute? See [CONTRIBUTING.md](./CONTRIBUTING.md)
+
+---
+
+## Design Principles
+
+1. **Human-readable first** - All files are readable JSON/Markdown
+2. **AI-optimized** - Structured for maximum LLM effectiveness  
+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
+
+---
+
+## Examples
+
+- [Next.js Monorepo](./examples/nextjs-monorepo) - Turborepo + Drizzle + Supabase
+- [Express API](./examples/express-api) - REST API with PostgreSQL
+- [Vite React App](./examples/vite-react) - Frontend SPA
+
+---
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) first.
+
+Areas we'd love help with:
+- Improved inference patterns
+- Support for more languages/frameworks  
+- Example projects
+- Documentation improvements
+- Bug reports and feature requests
+
+---
+
+## License
+
+MIT © [Adjective](https://adjective.us)
+
+---
+
+## Links
+
+- [Specification](./SPEC.md)
+- [Schema Documentation](./schemas/README.md)
+- [Examples](./examples/)
+- [NPM Package](https://www.npmjs.com/package/prelude-context)
+- [Issues & Feature Requests](https://github.com/adjective-rob/prelude/issues)
+
+---
+
+**Built by [Adjective](https://adjective.us) - Sovereign Software for AI-Native Teams**

package/dist/bin/prelude.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=prelude.d.ts.map

package/dist/bin/prelude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prelude.d.ts","sourceRoot":"","sources":["../../bin/prelude.ts"],"names":[],"mappings":""}

package/dist/bin/prelude.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { cac } from 'cac';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+// Get package.json - works in both dev and built versions
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Try built location first (dist/bin), then dev location (bin)
+let packageJson;
+try {
+    packageJson = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf-8'));
+}
+catch {
+    packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+}
+const cli = cac('prelude');
+cli
+    .version(packageJson.version)
+    .help();
+// Import commands
+import { registerInitCommand } from '../src/commands/init.js';
+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';
+// Register all commands
+registerInitCommand(cli);
+registerExportCommand(cli);
+registerShareCommand(cli);
+registerDecisionCommand(cli);
+registerWatchCommand(cli);
+// Parse and run
+cli.parse();
+//# sourceMappingURL=prelude.js.map

package/dist/bin/prelude.js.map

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+import type { CAC } from 'cac';
+export declare function registerDecisionCommand(cli: CAC): void;
+//# sourceMappingURL=decision.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../src/commands/decision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAY/B,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,QAoF/C"}

package/dist/src/commands/decision.js

@@ -0,0 +1,74 @@
+import { join } from 'path';
+import { readJSON, writeJSON, fileExists } from '../utils/fs.js';
+import { logger } from '../utils/log.js';
+import { getCurrentTimestamp, generateId } from '../utils/time.js';
+import { CONTEXT_DIR, CONTEXT_FILES } from '../constants.js';
+// Add these constants
+const PRELUDE_VERSION = "1.0.0";
+const SCHEMA_URL = "https://prelude.dev/schemas/v1";
+export function registerDecisionCommand(cli) {
+    cli
+        .command('decision <title>', 'Log an architectural decision')
+        .option('--rationale <text>', 'Decision rationale')
+        .option('--alternatives <items>', 'Comma-separated list of alternatives considered')
+        .option('--impact <text>', 'Impact of the decision')
+        .option('--status <status>', 'Decision status (proposed, accepted, rejected)', { default: 'accepted' })
+        .option('--author <name>', 'Decision author')
+        .option('--tags <items>', 'Comma-separated tags')
+        .action(async (title, options, dir = process.cwd()) => {
+        const rootDir = dir;
+        const contextDir = join(rootDir, CONTEXT_DIR);
+        const decisionsPath = join(contextDir, CONTEXT_FILES.DECISIONS);
+        // Check if .context exists
+        if (!(await fileExists(contextDir))) {
+            logger.error('.context/ directory not found. Run `prelude init` first.');
+            process.exit(1);
+        }
+        logger.decision(`Recording decision: ${title}`);
+        // Read existing decisions
+        // MODIFIED LINE: Add default $schema and version to the initial object
+        let decisions = {
+            $schema: `${SCHEMA_URL}/decisions.json`,
+            version: PRELUDE_VERSION,
+            decisions: []
+        };
+        if (await fileExists(decisionsPath)) {
+            decisions = await readJSON(decisionsPath);
+        }
+        // Prompt for rationale if not provided
+        let rationale = options.rationale;
+        if (!rationale) {
+            logger.warn('No rationale provided. Please provide a brief explanation:');
+            // In a real implementation, you'd use a prompt library like enquirer
+            // For now, we'll require it via the flag
+            logger.error('Please provide --rationale flag');
+            process.exit(1);
+        }
+        // Parse alternatives and tags
+        const alternatives = options.alternatives ? options.alternatives.split(',').map(s => s.trim()) : undefined;
+        const tags = options.tags ? options.tags.split(',').map(s => s.trim()) : undefined;
+        // Create new decision
+        const decision = {
+            id: generateId(),
+            timestamp: getCurrentTimestamp(),
+            title,
+            status: options.status || 'accepted',
+            rationale,
+            alternatives,
+            impact: options.impact,
+            author: options.author,
+            tags
+        };
+        // Add to decisions
+        decisions.decisions.push(decision);
+        // Write back
+        await writeJSON(decisionsPath, decisions);
+        logger.success('✓ Decision recorded successfully!');
+        logger.info(`\nDecision ID: ${decision.id}`);
+        logger.info(`Status: ${decision.status}`);
+        if (alternatives) {
+            logger.info(`Alternatives considered: ${alternatives.length}`);
+        }
+    });
+}
+//# sourceMappingURL=decision.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { CAC } from 'cac';
+export declare function registerExportCommand(cli: CAC): void;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AA0E/B,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,QA0E7C"}

package/dist/src/commands/export.js

@@ -0,0 +1,132 @@
+import { join } from 'path';
+import { readFile } from 'fs/promises';
+import { spawn, execSync } from 'child_process';
+import { platform } from 'os';
+import { fileExists } from '../utils/fs.js';
+import { logger, spinner } from '../utils/log.js';
+import { CONTEXT_DIR } from '../constants.js';
+import { saveExport } from '../core/exporter.js';
+// Check if a command exists
+function commandExists(command) {
+    try {
+        execSync(`which ${command}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// Native clipboard using shell commands (no dependencies!)
+async function copyToClipboard(text) {
+    return new Promise((resolve) => {
+        try {
+            const os = platform();
+            let command;
+            let args = [];
+            if (os === 'darwin') {
+                command = 'pbcopy';
+            }
+            else if (os === 'linux') {
+                // Check which clipboard tool is available
+                if (commandExists('xclip')) {
+                    command = 'xclip';
+                    args = ['-selection', 'clipboard'];
+                }
+                else if (commandExists('xsel')) {
+                    command = 'xsel';
+                    args = ['--clipboard', '--input'];
+                }
+                else {
+                    resolve(false);
+                    return;
+                }
+            }
+            else if (os === 'win32') {
+                command = 'clip.exe';
+            }
+            else {
+                resolve(false);
+                return;
+            }
+            const proc = spawn(command, args);
+            let errorOccurred = false;
+            proc.on('error', () => {
+                errorOccurred = true;
+                resolve(false);
+            });
+            // For clipboard commands, if stdin closes without error, assume success
+            proc.stdin.on('finish', () => {
+                if (!errorOccurred) {
+                    // Give it a tiny moment to process, then assume success
+                    setTimeout(() => resolve(true), 100);
+                }
+            });
+            proc.stdin.write(text);
+            proc.stdin.end();
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}
+export function registerExportCommand(cli) {
+    cli
+        .command('export [dir]', 'Generate LLM-optimized export')
+        .option('--format <format>', 'Output format (md or json)', { default: 'md' })
+        .option('--no-copy', 'Skip copying to clipboard')
+        .option('--print', 'Print to stdout after export')
+        .action(async (dir = process.cwd(), options) => {
+        const rootDir = dir;
+        const contextDir = join(rootDir, CONTEXT_DIR);
+        // Check if .context exists
+        if (!(await fileExists(contextDir))) {
+            logger.error('.context/ directory not found. Run `prelude init` first.');
+            process.exit(1);
+        }
+        logger.export('Exporting context...');
+        const format = options.format === 'json' ? 'json' : 'md';
+        const spin = spinner(`Generating ${format.toUpperCase()} export...`);
+        try {
+            const exportPath = await saveExport(rootDir, format);
+            spin.stop();
+            logger.success(`✓ Export generated: ${exportPath}`);
+            // Read the exported content
+            const content = await readFile(exportPath, 'utf-8');
+            // Auto-copy to clipboard by default (unless --no-copy is specified)
+            const shouldCopy = options.copy !== false;
+            if (shouldCopy) {
+                const copySpin = spinner('Copying to clipboard...');
+                const copied = await copyToClipboard(content);
+                copySpin.stop();
+                if (copied) {
+                    logger.success('✓ Copied to clipboard!');
+                    logger.info('📋 Ready to paste into your AI chat');
+                }
+                else {
+                    const os = platform();
+                    logger.warn('⚠ Clipboard tool not found');
+                    if (os === 'linux') {
+                        logger.info('\nInstall xclip or xsel:');
+                        logger.info('  sudo apt install xclip');
+                        logger.info('  # or');
+                        logger.info('  sudo apt install xsel');
+                    }
+                    logger.info('\nManual copy:');
+                    logger.info(`  cat ${exportPath}`);
+                }
+            }
+            // Handle --print flag
+            if (options.print) {
+                console.log('\n' + '─'.repeat(50));
+                console.log(content);
+                console.log('─'.repeat(50) + '\n');
+            }
+        }
+        catch (error) {
+            spin.stop();
+            logger.error(`Failed to generate export: ${error}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=export.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { CAC } from 'cac';
+export declare function registerInitCommand(cli: CAC): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAY/B,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,QA+E3C"}