prelude-context 1.0.0

package/dist/src/schema/stack.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+const PRELUDE_VERSION = "1.0.0";
+const SCHEMA_URL = "https://adjective.us/prelude/schemas/v1";
+export const StackSchema = z.object({
+    $schema: z.string().url().default(`${SCHEMA_URL}/stack.json`),
+    version: z.string().default(PRELUDE_VERSION),
+    language: z.string(),
+    runtime: z.string().optional(),
+    packageManager: z.enum(['npm', 'pnpm', 'yarn', 'bun', 'pip', 'poetry', 'cargo', 'go']).optional(),
+    framework: z.string().optional(),
+    frameworks: z.array(z.string()).optional(),
+    dependencies: z.record(z.string()).optional(),
+    devDependencies: z.record(z.string()).optional(),
+    buildTools: z.array(z.string()).optional(),
+    testingFrameworks: z.array(z.string()).optional(),
+    styling: z.array(z.string()).optional(),
+    database: z.string().optional(),
+    orm: z.string().optional(),
+    stateManagement: z.string().optional(),
+    deployment: z.string().optional(),
+    cicd: z.array(z.string()).optional()
+});
+//# sourceMappingURL=stack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../../src/schema/stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,eAAe,GAAG,OAAO,CAAC;AAChC,MAAM,UAAU,GAAG,yCAAyC,CAAC;AAE7D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,UAAU,aAAa,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACjD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}

package/dist/src/utils/fs.d.ts

@@ -0,0 +1,10 @@
+export declare function readJSON<T>(path: string): Promise<T>;
+export declare function writeJSON(path: string, data: unknown): Promise<void>;
+export declare function readMarkdown(path: string): Promise<string>;
+export declare function writeMarkdown(path: string, content: string): Promise<void>;
+export declare function ensureDir(path: string): Promise<void>;
+export declare function fileExists(path: string): Promise<boolean>;
+export declare function isDirectory(path: string): Promise<boolean>;
+export declare function listFiles(dir: string): Promise<string[]>;
+export declare function getDirectoryTree(rootDir: string, maxDepth?: number, currentDepth?: number): Promise<string[]>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/src/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/utils/fs.ts"],"names":[],"mappings":"AAIA,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAG1D;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhE;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAM9D;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,EAAE,YAAY,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBzH"}

package/dist/src/utils/fs.js

@@ -0,0 +1,63 @@
+import { readFile, writeFile, mkdir, access, readdir, stat } from 'fs/promises';
+import { dirname, join } from 'path';
+import { constants } from 'fs';
+export async function readJSON(path) {
+    const content = await readFile(path, 'utf-8');
+    return JSON.parse(content);
+}
+export async function writeJSON(path, data) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(data, null, 2), 'utf-8');
+}
+export async function readMarkdown(path) {
+    return await readFile(path, 'utf-8');
+}
+export async function writeMarkdown(path, content) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, content, 'utf-8');
+}
+export async function ensureDir(path) {
+    await mkdir(path, { recursive: true });
+}
+export async function fileExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function isDirectory(path) {
+    try {
+        const stats = await stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export async function listFiles(dir) {
+    try {
+        return await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+}
+export async function getDirectoryTree(rootDir, maxDepth = 2, currentDepth = 0) {
+    if (currentDepth >= maxDepth)
+        return [];
+    const dirs = [];
+    const entries = await readdir(rootDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+            const fullPath = join(rootDir, entry.name);
+            dirs.push(fullPath);
+            const subDirs = await getDirectoryTree(fullPath, maxDepth, currentDepth + 1);
+            dirs.push(...subDirs);
+        }
+    }
+    return dirs;
+}
+//# sourceMappingURL=fs.js.map

package/dist/src/utils/fs.js.map

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

package/dist/src/utils/log.d.ts

@@ -0,0 +1,20 @@
+export declare const logger: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    debug: (msg: string) => void;
+    step: (msg: string) => void;
+    heading: (msg: string) => void;
+    init: (msg: string) => void;
+    export: (msg: string) => void;
+    decision: (msg: string) => void;
+    watch: (msg: string) => void;
+    scan: (msg: string) => void;
+    write: (msg: string) => void;
+};
+export declare function logTable(data: Record<string, string | number | boolean>): void;
+export declare function spinner(text: string): {
+    stop: (finalText?: string) => void;
+};
+//# sourceMappingURL=log.d.ts.map

package/dist/src/utils/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/utils/log.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM;gBACL,MAAM;mBACH,MAAM;gBACT,MAAM;iBACL,MAAM;iBACN,MAAM;gBACP,MAAM;mBACH,MAAM;gBAGT,MAAM;kBACJ,MAAM;oBACJ,MAAM;iBACT,MAAM;gBACP,MAAM;iBACL,MAAM;CACpB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,QASvE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM;uBAUb,MAAM;EAQ5B"}

package/dist/src/utils/log.js

@@ -0,0 +1,45 @@
+import { blue, green, red, yellow, cyan, magenta, gray } from 'colorette';
+import logSymbols from 'log-symbols';
+export const logger = {
+    info: (msg) => console.log(logSymbols.info, blue(msg)),
+    success: (msg) => console.log(logSymbols.success, green(msg)),
+    warn: (msg) => console.log(logSymbols.warning, yellow(msg)),
+    error: (msg) => console.log(logSymbols.error, red(msg)),
+    debug: (msg) => console.log(gray('→'), gray(msg)),
+    step: (msg) => console.log(cyan('◆'), cyan(msg)),
+    heading: (msg) => console.log('\n' + magenta('━'.repeat(50))),
+    // Custom emojis for Prelude-specific actions
+    init: (msg) => console.log('🎯', blue(msg)),
+    export: (msg) => console.log('📤', green(msg)),
+    decision: (msg) => console.log('🧠', cyan(msg)),
+    watch: (msg) => console.log('👀', yellow(msg)),
+    scan: (msg) => console.log('🔍', blue(msg)),
+    write: (msg) => console.log('✍️ ', green(msg))
+};
+export function logTable(data) {
+    const maxKeyLength = Math.max(...Object.keys(data).map(k => k.length));
+    console.log();
+    for (const [key, value] of Object.entries(data)) {
+        const paddedKey = key.padEnd(maxKeyLength);
+        console.log(`  ${gray(paddedKey)} ${cyan('→')} ${value}`);
+    }
+    console.log();
+}
+export function spinner(text) {
+    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    let i = 0;
+    const interval = setInterval(() => {
+        process.stdout.write(`\r${cyan(frames[i])} ${text}`);
+        i = (i + 1) % frames.length;
+    }, 80);
+    return {
+        stop: (finalText) => {
+            clearInterval(interval);
+            process.stdout.write('\r');
+            if (finalText) {
+                logger.success(finalText);
+            }
+        }
+    };
+}
+//# sourceMappingURL=log.js.map

package/dist/src/utils/log.js.map

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

package/dist/src/utils/time.d.ts

@@ -0,0 +1,5 @@
+export declare function getCurrentTimestamp(): string;
+export declare function formatTimestamp(isoString: string): string;
+export declare function getRelativeTime(isoString: string): string;
+export declare function generateId(): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/src/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/utils/time.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASzD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAczD;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/src/utils/time.js

@@ -0,0 +1,33 @@
+export function getCurrentTimestamp() {
+    return new Date().toISOString();
+}
+export function formatTimestamp(isoString) {
+    const date = new Date(isoString);
+    return date.toLocaleString('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit'
+    });
+}
+export function getRelativeTime(isoString) {
+    const now = Date.now();
+    const then = new Date(isoString).getTime();
+    const diff = now - then;
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d ago`;
+    if (hours > 0)
+        return `${hours}h ago`;
+    if (minutes > 0)
+        return `${minutes}m ago`;
+    return 'just now';
+}
+export function generateId() {
+    return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+//# sourceMappingURL=time.js.map

package/dist/src/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/utils/time.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAClC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IAExB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAEpC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,OAAO,CAAC;IACpC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,KAAK,OAAO,CAAC;IACtC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,GAAG,OAAO,OAAO,CAAC;IAC1C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "prelude-context",
+  "version": "1.0.0",
+  "description": "The open standard for expressing and maintaining machine-readable context about a codebase",
+  "type": "module",
+  "bin": {
+    "prelude": "./dist/bin/prelude.js"
+  },
+  "files": [
+    "dist/**/*",
+    "schemas/**/*",
+    "README.md",
+    "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",
+    "ai",
+    "agents",
+    "llm",
+    "codebase",
+    "prelude",
+    "machine-readable",
+    "developer-tools"
+  ],
+  "author": "Rob Hocking <rob@useadjective.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adjective-rob/prelude.git"
+  },
+  "homepage": "https://github.com/adjective-rob/prelude#readme",
+  "bugs": {
+    "url": "https://github.com/adjective-rob/prelude/issues"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "cac": "^6.7.14",
+    "chokidar": "^3.6.0",
+    "colorette": "^2.0.20",
+    "log-symbols": "^6.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "eslint": "^9.5.0",
+    "prettier": "^3.3.2",
+    "tsx": "^4.15.7",
+    "typescript": "^5.5.2",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/schemas/architecture.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://adjective.us/prelude/schemas/v1/architecture.schema.json",
+  "title": "Prelude Architecture Schema",
+  "description": "Schema for Prelude architecture.json file containing codebase structure",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "URI of the JSON Schema for this file",
+      "format": "uri"
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version of Prelude format",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["monolith", "monorepo", "microservices", "library", "cli", "fullstack", "backend", "frontend"],
+      "description": "Project architecture type"
+    },
+    "directories": {
+      "type": "array",
+      "description": "Key directories with metadata",
+      "items": {
+        "type": "object",
+        "required": ["path"],
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Directory path relative to project root"
+          },
+          "purpose": {
+            "type": "string",
+            "description": "Purpose or description of directory"
+          },
+          "fileCount": {
+            "type": "integer",
+            "description": "Number of files in directory",
+            "minimum": 0
+          }
+        }
+      }
+    },
+    "patterns": {
+      "type": "array",
+      "description": "Architectural patterns used",
+      "items": {
+        "type": "string"
+      }
+    },
+    "conventions": {
+      "type": "array",
+      "description": "Code conventions",
+      "items": {
+        "type": "string"
+      }
+    },
+    "entryPoints": {
+      "type": "array",
+      "description": "Application entry points",
+      "items": {
+        "type": "object",
+        "required": ["file", "purpose"],
+        "properties": {
+          "file": {
+            "type": "string",
+            "description": "File path"
+          },
+          "purpose": {
+            "type": "string",
+            "description": "Purpose of entry point"
+          }
+        }
+      }
+    },
+    "routing": {
+      "type": "string",
+      "enum": ["file-based", "config-based", "none"],
+      "description": "Routing style"
+    },
+    "stateManagement": {
+      "type": "string",
+      "description": "State management approach"
+    },
+    "apiStyle": {
+      "type": "string",
+      "enum": ["REST", "GraphQL", "tRPC", "gRPC", "mixed", "none"],
+      "description": "API architectural style"
+    },
+    "dataFlow": {
+      "type": "string",
+      "description": "Data flow description"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/constraints.schema.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://adjective.us/prelude/schemas/v1/constraints.schema.json",
+  "title": "Prelude Constraints Schema",
+  "description": "Schema for Prelude constraints.json file containing development rules and preferences",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "URI of the JSON Schema for this file",
+      "format": "uri"
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version of Prelude format",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "mustUse": {
+      "type": "array",
+      "description": "Required technologies or practices",
+      "items": {
+        "type": "string"
+      }
+    },
+    "mustNotUse": {
+      "type": "array",
+      "description": "Prohibited technologies or practices",
+      "items": {
+        "type": "string"
+      }
+    },
+    "preferences": {
+      "type": "array",
+      "description": "Preferred approaches with rationale",
+      "items": {
+        "type": "object",
+        "required": ["category", "preference"],
+        "properties": {
+          "category": {
+            "type": "string",
+            "description": "Category of preference"
+          },
+          "preference": {
+            "type": "string",
+            "description": "Preferred approach"
+          },
+          "rationale": {
+            "type": "string",
+            "description": "Reason for preference"
+          }
+        }
+      }
+    },
+    "codeStyle": {
+      "type": "object",
+      "description": "Code style configuration",
+      "properties": {
+        "formatter": {
+          "type": "string",
+          "description": "Code formatter (e.g., Prettier)"
+        },
+        "linter": {
+          "type": "string",
+          "description": "Code linter (e.g., ESLint)"
+        },
+        "rules": {
+          "type": "array",
+          "description": "Linting rules or configurations",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "naming": {
+      "type": "object",
+      "description": "Naming conventions",
+      "properties": {
+        "files": {
+          "type": "string",
+          "description": "File naming convention"
+        },
+        "components": {
+          "type": "string",
+          "description": "Component naming convention"
+        },
+        "functions": {
+          "type": "string",
+          "description": "Function naming convention"
+        },
+        "variables": {
+          "type": "string",
+          "description": "Variable naming convention"
+        }
+      }
+    },
+    "fileOrganization": {
+      "type": "array",
+      "description": "File organization rules",
+      "items": {
+        "type": "string"
+      }
+    },
+    "testing": {
+      "type": "object",
+      "description": "Testing requirements",
+      "properties": {
+        "required": {
+          "type": "boolean",
+          "description": "Whether testing is required"
+        },
+        "coverage": {
+          "type": "number",
+          "description": "Required test coverage percentage",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "strategy": {
+          "type": "string",
+          "description": "Testing strategy description"
+        }
+      }
+    },
+    "documentation": {
+      "type": "object",
+      "description": "Documentation requirements",
+      "properties": {
+        "required": {
+          "type": "boolean",
+          "description": "Whether documentation is required"
+        },
+        "style": {
+          "type": "string",
+          "description": "Documentation style or format"
+        }
+      }
+    },
+    "performance": {
+      "type": "array",
+      "description": "Performance constraints",
+      "items": {
+        "type": "string"
+      }
+    },
+    "security": {
+      "type": "array",
+      "description": "Security requirements",
+      "items": {
+        "type": "string"
+      }
+    },
+    "accessibility": {
+      "type": "array",
+      "description": "Accessibility requirements",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/decisions.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://adjective.us/prelude/schemas/v1/decisions.schema.json",
+  "title": "Prelude Decisions Schema",
+  "description": "Schema for Prelude decisions.json file containing architectural decision records",
+  "type": "object",
+  "required": ["decisions"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "URI of the JSON Schema for this file",
+      "format": "uri"
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version of Prelude format",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "decisions": {
+      "type": "array",
+      "description": "List of architectural decisions",
+      "items": {
+        "type": "object",
+        "required": ["id", "timestamp", "title", "status", "rationale"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique decision identifier"
+          },
+          "timestamp": {
+            "type": "string",
+            "description": "ISO 8601 datetime when decision was made",
+            "format": "date-time"
+          },
+          "title": {
+            "type": "string",
+            "description": "Brief decision title",
+            "minLength": 1
+          },
+          "status": {
+            "type": "string",
+            "enum": ["proposed", "accepted", "rejected", "deprecated", "superseded"],
+            "description": "Decision status"
+          },
+          "rationale": {
+            "type": "string",
+            "description": "Reasoning behind the decision",
+            "minLength": 1
+          },
+          "alternatives": {
+            "type": "array",
+            "description": "Alternative approaches considered",
+            "items": {
+              "type": "string"
+            }
+          },
+          "consequences": {
+            "type": "array",
+            "description": "Consequences of the decision",
+            "items": {
+              "type": "string"
+            }
+          },
+          "impact": {
+            "type": "string",
+            "description": "Impact assessment"
+          },
+          "author": {
+            "type": "string",
+            "description": "Decision author"
+          },
+          "tags": {
+            "type": "array",
+            "description": "Decision tags for categorization",
+            "items": {
+              "type": "string"
+            }
+          },
+          "references": {
+            "type": "array",
+            "description": "References or supporting documentation",
+            "items": {
+              "type": "string"
+            }
+          },
+          "supersededBy": {
+            "type": "string",
+            "description": "ID of decision that supersedes this one"
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": true
+}