prelude-context 1.2.0 → 1.3.0

package/README.md

@@ -143,6 +143,26 @@ prelude decision "Use Drizzle ORM instead of Prisma"
 # Opens editor for you to document the decision and rationale
 ```
 
+### `prelude query <topic> [options]`
+Scoped context lookup — search and filter your project context without exporting everything:
+```bash
+prelude query "error handling"              # topic search across everything
+prelude query --scope src/api/              # architecture + constraints for a directory
+prelude query --type constraints            # just constraints
+prelude query "prisma" --type decisions --format json   # combined filters
+prelude query --type stack --max-tokens 500 # budget-capped output
+```
+
+| Flag | Description |
+|------|-------------|
+| `<topic>` | Deep-search keyword across all context files |
+| `--scope <path>` | Filter to architecture/constraints relevant to a directory |
+| `--type <type>` | Return only one context type: `project`, `stack`, `architecture`, `constraints`, or `decisions` |
+| `--format <md\|json>` | Output format (default: `md`) |
+| `--max-tokens <n>` | Truncate output to fit a token budget |
+
+Output goes to stdout (pipe-friendly), token estimate to stderr. At least one filter (topic, scope, or type) is required.
+
 ### `prelude watch`
 Tracks development sessions:
 ```bash
@@ -188,6 +208,15 @@ Should I use Server Actions or API routes for [feature]?
 Consider our existing patterns and constraints.
 ```
 
+### 🔍 Scoped Context for AI Agents
+```bash
+# Feed only relevant context to an AI agent working on a specific directory
+prelude query --scope src/api/ --format json | my-agent
+
+# Quick lookup before asking an LLM about a topic
+prelude query "authentication" --max-tokens 500
+```
+
 ### 📚 Onboarding
 Share your `.context/` directory with new team members so they can:
 - Understand the stack instantly
@@ -333,6 +362,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
+- [x] Scoped context query engine (`prelude query`)
 - [ ] Improved inference for Python, Rust, Go
 - [ ] VS Code extension for inline context
 - [ ] GitHub Action for automated updates

package/dist/bin/prelude.js

@@ -24,6 +24,7 @@ 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 { registerQueryCommand } from '../src/commands/query.js';
 import { update } from '../src/commands/update.js';
 // Register all commands
 registerInitCommand(cli);
@@ -31,6 +32,7 @@ registerExportCommand(cli);
 registerShareCommand(cli);
 registerDecisionCommand(cli);
 registerWatchCommand(cli);
+registerQueryCommand(cli);
 // Register update command
 cli
     .command('update', 'Update context by re-analyzing the codebase')

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;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"}
+{"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,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;AAC1B,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/query.d.ts

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

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

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

package/dist/src/commands/query.js

@@ -0,0 +1,59 @@
+import { join } from 'path';
+import { fileExists } from '../utils/fs.js';
+import { logger } from '../utils/log.js';
+import { CONTEXT_DIR } from '../constants.js';
+import { executeQuery, VALID_TYPES } from '../core/query-engine.js';
+export function registerQueryCommand(cli) {
+    cli
+        .command('query [topic]', 'Query project context by topic, scope, or type')
+        .option('--scope <path>', 'Filter results to a specific directory scope')
+        .option('--type <type>', 'Filter by context type (project, stack, architecture, constraints, decisions)')
+        .option('--format <format>', 'Output format (md or json)', { default: 'md' })
+        .option('--max-tokens <n>', 'Limit output to approximate token budget')
+        .action(async (topic, options) => {
+        const rootDir = process.cwd();
+        const externalRoot = process.env.PRELUDE_ROOT;
+        const contextDir = externalRoot
+            ? join(externalRoot, rootDir.split('/').pop())
+            : join(rootDir, CONTEXT_DIR);
+        if (!(await fileExists(contextDir))) {
+            logger.error('.context/ directory not found. Run `prelude init` first.');
+            process.exit(1);
+        }
+        // Validate --type
+        if (options.type && !VALID_TYPES.includes(options.type)) {
+            logger.error(`Invalid type: "${options.type}". Valid types: ${VALID_TYPES.join(', ')}`);
+            process.exit(1);
+        }
+        // Must provide at least one filter
+        if (!topic && !options.scope && !options.type) {
+            logger.error('Provide a topic, --scope, or --type to query. Run `prelude query --help` for usage.');
+            process.exit(1);
+        }
+        const format = options.format === 'json' ? 'json' : 'md';
+        const maxTokens = options.maxTokens ? parseInt(options.maxTokens, 10) : undefined;
+        if (maxTokens !== undefined && (isNaN(maxTokens) || maxTokens <= 0)) {
+            logger.error('--max-tokens must be a positive number.');
+            process.exit(1);
+        }
+        try {
+            const { output, tokenEstimate } = await executeQuery(rootDir, {
+                topic,
+                scope: options.scope,
+                type: options.type,
+                format,
+                maxTokens,
+            });
+            // Print results to stdout (machine-friendly, no decoration)
+            console.log(output);
+            // Print token estimate to stderr so it doesn't pollute piped output
+            const budgetNote = maxTokens ? ` (budget: ${maxTokens})` : '';
+            process.stderr.write(`\n~${tokenEstimate} tokens${budgetNote}\n`);
+        }
+        catch (error) {
+            logger.error(`Query failed: ${error}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=query.js.map

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

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

package/dist/src/core/query-engine.d.ts

@@ -0,0 +1,18 @@
+export type ContextType = 'project' | 'stack' | 'architecture' | 'constraints' | 'decisions';
+export declare const VALID_TYPES: ContextType[];
+export interface QueryOptions {
+    topic?: string;
+    scope?: string;
+    type?: ContextType;
+    format: 'md' | 'json';
+    maxTokens?: number;
+}
+export interface QueryResult {
+    sections: Record<string, unknown>;
+    tokenEstimate: number;
+}
+export declare function executeQuery(rootDir: string, options: QueryOptions): Promise<{
+    output: string;
+    tokenEstimate: number;
+}>;
+//# sourceMappingURL=query-engine.d.ts.map

package/dist/src/core/query-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-engine.d.ts","sourceRoot":"","sources":["../../../src/core/query-engine.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,CAAC;AAE7F,eAAO,MAAM,WAAW,EAAE,WAAW,EAAqE,CAAC;AAU3G,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AA2SD,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CA4D7H"}

package/dist/src/core/query-engine.js

@@ -0,0 +1,364 @@
+import { join } from 'path';
+import { readJSON, fileExists } from '../utils/fs.js';
+import { CONTEXT_DIR, CONTEXT_FILES } from '../constants.js';
+// Roughly estimate tokens (1 token ≈ 4 characters for English text)
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function truncateToTokenBudget(text, maxTokens) {
+    const maxChars = maxTokens * 4;
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars) + '\n\n[... truncated to fit token budget]';
+}
+export const VALID_TYPES = ['project', 'stack', 'architecture', 'constraints', 'decisions'];
+// Load all context data from .context/ directory
+async function loadContext(rootDir) {
+    const externalRoot = process.env.PRELUDE_ROOT;
+    const contextDir = externalRoot
+        ? join(externalRoot, rootDir.split('/').pop())
+        : join(rootDir, CONTEXT_DIR);
+    const data = {};
+    const loaders = [
+        { key: 'project', file: CONTEXT_FILES.PROJECT },
+        { key: 'stack', file: CONTEXT_FILES.STACK },
+        { key: 'architecture', file: CONTEXT_FILES.ARCHITECTURE },
+        { key: 'constraints', file: CONTEXT_FILES.CONSTRAINTS },
+        { key: 'decisions', file: CONTEXT_FILES.DECISIONS },
+    ];
+    for (const { key, file } of loaders) {
+        const filePath = join(contextDir, file);
+        if (await fileExists(filePath)) {
+            data[key] = await readJSON(filePath);
+        }
+    }
+    return data;
+}
+// Deep-search an object for a keyword match (case-insensitive)
+function objectContainsTopic(obj, topic) {
+    if (obj === null || obj === undefined)
+        return false;
+    if (typeof obj === 'string') {
+        return obj.toLowerCase().includes(topic);
+    }
+    if (typeof obj === 'number' || typeof obj === 'boolean') {
+        return String(obj).toLowerCase().includes(topic);
+    }
+    if (Array.isArray(obj)) {
+        return obj.some(item => objectContainsTopic(item, topic));
+    }
+    if (typeof obj === 'object') {
+        return Object.values(obj).some(val => objectContainsTopic(val, topic));
+    }
+    return false;
+}
+// Extract matching sub-fields from an object for a given topic
+function extractMatchingFields(obj, topic) {
+    const matches = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (key === '$schema' || key === 'version')
+            continue;
+        if (key.toLowerCase().includes(topic) || objectContainsTopic(value, topic)) {
+            matches[key] = value;
+        }
+    }
+    return matches;
+}
+// Filter architecture directories by scope path
+function filterArchitectureByScope(arch, scope) {
+    const normalizedScope = scope.replace(/\/+$/, '').replace(/^\.\//, '');
+    const filteredDirs = (arch.directories || []).filter(dir => {
+        const normalizedDir = dir.path.replace(/\/+$/, '').replace(/^\.\//, '');
+        return normalizedDir.startsWith(normalizedScope) ||
+            normalizedScope.startsWith(normalizedDir);
+    });
+    // Find patterns/conventions relevant to the scoped directories
+    const scopeSegments = normalizedScope.toLowerCase().split('/');
+    const filteredPatterns = (arch.patterns || []).filter(p => {
+        const lower = p.toLowerCase();
+        return scopeSegments.some(seg => lower.includes(seg));
+    });
+    const filteredConventions = (arch.conventions || []).filter(c => {
+        const lower = c.toLowerCase();
+        return scopeSegments.some(seg => lower.includes(seg));
+    });
+    const filteredEntryPoints = (arch.entryPoints || []).filter(ep => ep.file.replace(/^\.\//, '').startsWith(normalizedScope));
+    return {
+        ...arch,
+        directories: filteredDirs,
+        patterns: filteredPatterns.length > 0 ? filteredPatterns : arch.patterns,
+        conventions: filteredConventions.length > 0 ? filteredConventions : arch.conventions,
+        entryPoints: filteredEntryPoints.length > 0 ? filteredEntryPoints : undefined,
+    };
+}
+// Filter constraints relevant to a scope (keeps all constraints since they apply globally,
+// but highlights relevant directory organization rules)
+function filterConstraintsByScope(constraints, scope) {
+    const normalizedScope = scope.replace(/\/+$/, '').replace(/^\.\//, '').toLowerCase();
+    const scopeSegments = normalizedScope.split('/');
+    const filteredFileOrg = (constraints.fileOrganization || []).filter(rule => {
+        const lower = rule.toLowerCase();
+        return scopeSegments.some(seg => lower.includes(seg));
+    });
+    return {
+        ...constraints,
+        fileOrganization: filteredFileOrg.length > 0 ? filteredFileOrg : constraints.fileOrganization,
+    };
+}
+// Format query results as markdown
+function formatAsMarkdown(sections) {
+    let md = '# Prelude Query Results\n\n';
+    if (sections.project) {
+        md += formatProjectSection(sections.project);
+    }
+    if (sections.stack) {
+        md += formatStackSection(sections.stack);
+    }
+    if (sections.architecture) {
+        md += formatArchitectureSection(sections.architecture);
+    }
+    if (sections.constraints) {
+        md += formatConstraintsSection(sections.constraints);
+    }
+    if (sections.decisions) {
+        md += formatDecisionsSection(sections.decisions);
+    }
+    if (md === '# Prelude Query Results\n\n') {
+        md += '_No matching context found._\n';
+    }
+    return md;
+}
+function formatProjectSection(project) {
+    let md = '## Project\n\n';
+    if (project.name)
+        md += `**Name:** ${project.name}\n`;
+    if (project.description)
+        md += `**Description:** ${project.description}\n`;
+    if (project.version)
+        md += `**Version:** ${project.version}\n`;
+    if (project.repository)
+        md += `**Repository:** ${project.repository}\n`;
+    if (project.license)
+        md += `**License:** ${project.license}\n`;
+    if (project.goals && project.goals.length > 0) {
+        md += '**Goals:**\n';
+        project.goals.forEach(g => { md += `- ${g}\n`; });
+    }
+    md += '\n';
+    return md;
+}
+function formatStackSection(stack) {
+    let md = '## Stack\n\n';
+    if (stack.language)
+        md += `**Language:** ${stack.language}\n`;
+    if (stack.runtime)
+        md += `**Runtime:** ${stack.runtime}\n`;
+    if (stack.packageManager)
+        md += `**Package Manager:** ${stack.packageManager}\n`;
+    if (stack.frameworks?.length) {
+        md += '**Frameworks:** ' + stack.frameworks.join(', ') + '\n';
+    }
+    if (stack.testingFrameworks?.length) {
+        md += '**Testing:** ' + stack.testingFrameworks.join(', ') + '\n';
+    }
+    if (stack.database)
+        md += `**Database:** ${stack.database}\n`;
+    if (stack.orm)
+        md += `**ORM:** ${stack.orm}\n`;
+    md += '\n';
+    return md;
+}
+function formatArchitectureSection(arch) {
+    let md = '## Architecture\n\n';
+    if (arch.type)
+        md += `**Type:** ${arch.type}\n`;
+    if (arch.routing)
+        md += `**Routing:** ${arch.routing}\n`;
+    if (arch.apiStyle)
+        md += `**API Style:** ${arch.apiStyle}\n`;
+    if (arch.patterns?.length) {
+        md += '**Patterns:**\n';
+        arch.patterns.forEach(p => { md += `- ${p}\n`; });
+    }
+    if (arch.conventions?.length) {
+        md += '**Conventions:**\n';
+        arch.conventions.forEach(c => { md += `- ${c}\n`; });
+    }
+    if (arch.directories?.length) {
+        md += '**Directories:**\n';
+        arch.directories.forEach(d => {
+            md += `- \`${d.path}\``;
+            if (d.purpose)
+                md += ` - ${d.purpose}`;
+            md += '\n';
+        });
+    }
+    if (arch.entryPoints?.length) {
+        md += '**Entry Points:**\n';
+        arch.entryPoints.forEach(ep => {
+            md += `- \`${ep.file}\` - ${ep.purpose}\n`;
+        });
+    }
+    md += '\n';
+    return md;
+}
+function formatConstraintsSection(constraints) {
+    let md = '## Constraints\n\n';
+    if (constraints.mustUse?.length) {
+        md += '**Must Use:**\n';
+        constraints.mustUse.forEach(item => { md += `- ${item}\n`; });
+    }
+    if (constraints.mustNotUse?.length) {
+        md += '**Must Not Use:**\n';
+        constraints.mustNotUse.forEach(item => { md += `- ${item}\n`; });
+    }
+    if (constraints.preferences?.length) {
+        md += '**Preferences:**\n';
+        constraints.preferences.forEach(p => {
+            md += `- [${p.category}] ${p.preference}`;
+            if (p.rationale)
+                md += ` _(${p.rationale})_`;
+            md += '\n';
+        });
+    }
+    if (constraints.codeStyle) {
+        md += '**Code Style:**\n';
+        if (constraints.codeStyle.formatter)
+            md += `- Formatter: ${constraints.codeStyle.formatter}\n`;
+        if (constraints.codeStyle.linter)
+            md += `- Linter: ${constraints.codeStyle.linter}\n`;
+        if (constraints.codeStyle.rules?.length) {
+            constraints.codeStyle.rules.forEach(r => { md += `- ${r}\n`; });
+        }
+    }
+    if (constraints.naming) {
+        md += '**Naming:**\n';
+        const naming = constraints.naming;
+        if (naming.files)
+            md += `- Files: ${naming.files}\n`;
+        if (naming.components)
+            md += `- Components: ${naming.components}\n`;
+        if (naming.functions)
+            md += `- Functions: ${naming.functions}\n`;
+        if (naming.variables)
+            md += `- Variables: ${naming.variables}\n`;
+    }
+    if (constraints.testing) {
+        md += '**Testing:**\n';
+        md += `- Required: ${constraints.testing.required ? 'Yes' : 'No'}\n`;
+        if (constraints.testing.strategy)
+            md += `- Strategy: ${constraints.testing.strategy}\n`;
+        if (constraints.testing.coverage)
+            md += `- Coverage: ${constraints.testing.coverage}%\n`;
+    }
+    if (constraints.fileOrganization?.length) {
+        md += '**File Organization:**\n';
+        constraints.fileOrganization.forEach(r => { md += `- ${r}\n`; });
+    }
+    if (constraints.security?.length) {
+        md += '**Security:**\n';
+        constraints.security.forEach(s => { md += `- ${s}\n`; });
+    }
+    if (constraints.performance?.length) {
+        md += '**Performance:**\n';
+        constraints.performance.forEach(p => { md += `- ${p}\n`; });
+    }
+    if (constraints.accessibility?.length) {
+        md += '**Accessibility:**\n';
+        constraints.accessibility.forEach(a => { md += `- ${a}\n`; });
+    }
+    md += '\n';
+    return md;
+}
+function formatDecisionsSection(decisions) {
+    let md = '## Decisions\n\n';
+    const items = decisions.decisions || [];
+    if (items.length === 0)
+        return '';
+    items.forEach(d => {
+        md += `### ${d.title}\n`;
+        md += `**Status:** ${d.status}\n`;
+        md += `**Rationale:** ${d.rationale}\n`;
+        if (d.alternatives?.length) {
+            md += '**Alternatives:** ' + d.alternatives.join(', ') + '\n';
+        }
+        if (d.impact)
+            md += `**Impact:** ${d.impact}\n`;
+        if (d.tags?.length)
+            md += `**Tags:** ${d.tags.join(', ')}\n`;
+        md += '\n';
+    });
+    return md;
+}
+// Strip $schema and version from output
+function cleanMetadata(obj) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (typeof obj !== 'object')
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(cleanMetadata);
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (key === '$schema' || key === 'version')
+            continue;
+        cleaned[key] = value;
+    }
+    return cleaned;
+}
+export async function executeQuery(rootDir, options) {
+    const data = await loadContext(rootDir);
+    const sections = {};
+    const topic = options.topic?.toLowerCase();
+    // Determine which types to include
+    const typesToInclude = options.type
+        ? [options.type]
+        : VALID_TYPES;
+    for (const type of typesToInclude) {
+        const raw = data[type];
+        if (!raw)
+            continue;
+        let section;
+        if (topic) {
+            // Topic-based filtering: extract only matching fields
+            const matches = extractMatchingFields(raw, topic);
+            if (Object.keys(matches).length > 0) {
+                section = matches;
+            }
+        }
+        else {
+            section = raw;
+        }
+        // Apply scope filtering for architecture and constraints
+        if (options.scope && section) {
+            if (type === 'architecture') {
+                section = filterArchitectureByScope(section, options.scope);
+            }
+            else if (type === 'constraints') {
+                section = filterConstraintsByScope(section, options.scope);
+            }
+        }
+        if (section && Object.keys(section).length > 0) {
+            sections[type] = section;
+        }
+    }
+    // Format output
+    let output;
+    if (options.format === 'json') {
+        const cleaned = {};
+        for (const [key, value] of Object.entries(sections)) {
+            cleaned[key] = cleanMetadata(value);
+        }
+        output = JSON.stringify(cleaned, null, 2);
+    }
+    else {
+        output = formatAsMarkdown(sections);
+    }
+    const tokenEstimate = estimateTokens(output);
+    // Apply token budget
+    if (options.maxTokens && tokenEstimate > options.maxTokens) {
+        output = truncateToTokenBudget(output, options.maxTokens);
+    }
+    return { output, tokenEstimate };
+}
+//# sourceMappingURL=query-engine.js.map

package/dist/src/core/query-engine.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prelude-context",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "The open standard for expressing and maintaining machine-readable context about a codebase",
   "type": "module",
   "bin": {
@@ -13,6 +13,15 @@
     "SPEC.md",
     "LICENSE"
   ],
+  "scripts": {
+    "dev": "tsx watch bin/prelude.ts",
+    "build": "tsc",
+    "prepublishOnly": "pnpm build",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "lint": "eslint . --ext .ts",
+    "format": "prettier --write \"**/*.{ts,json,md}\""
+  },
   "keywords": [
     "cli",
     "context",
@@ -51,13 +60,5 @@
   },
   "engines": {
     "node": ">=18.0.0"
-  },
-  "scripts": {
-    "dev": "tsx watch bin/prelude.ts",
-    "build": "tsc",
-    "test": "vitest",
-    "test:watch": "vitest --watch",
-    "lint": "eslint . --ext .ts",
-    "format": "prettier --write \"**/*.{ts,json,md}\""
   }
-}
+}