mycontext-cli 4.2.0 → 4.2.1

package/dist/services/ProjectScanner.js

@@ -0,0 +1,343 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectScanner = void 0;
+/**
+ * ProjectScanner — Scans the real file structure and compares against context.json
+ *
+ * This is the "eyes" of the Living Brain:
+ * 1. Walks the actual project file tree
+ * 2. Reads key files (package.json, route files, components, schemas)
+ * 3. Builds a structured ProjectSnapshot
+ * 4. Passes snapshot + context.json to LLM for progress assessment
+ * 5. Returns a ContextDiffReport with suggested merges/updates
+ */
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const AICore_1 = require("../core/ai/AICore");
+// --- Scanner ---
+const IGNORE_DIRS = new Set([
+    "node_modules", ".next", ".git", "dist", "build", ".turbo",
+    ".pnpm-store", "coverage", ".cache", ".vercel", "__pycache__",
+]);
+const IGNORE_EXTENSIONS = new Set([
+    ".png", ".jpg", ".jpeg", ".gif", ".svg", ".ico", ".woff", ".woff2",
+    ".ttf", ".eot", ".mp4", ".webm", ".mp3", ".wav", ".pdf", ".lock",
+    ".map",
+]);
+const KEY_FILE_PATTERNS = [
+    /package\.json$/,
+    /tsconfig\.json$/,
+    /instant\.schema\.(ts|js)$/,
+    /instant\.perms\.(ts|js)$/,
+    /\.env\.example$/,
+    /layout\.(tsx|jsx|ts|js)$/,
+    /page\.(tsx|jsx|ts|js)$/,
+    /route\.(tsx|jsx|ts|js)$/,
+    /schema\.(ts|js|prisma)$/,
+    /globals\.css$/,
+];
+const MAX_FILE_READ_SIZE = 3000; // chars per file
+const MAX_KEY_FILES = 30; // cap to keep prompt manageable
+const MAX_TREE_DEPTH = 6; // don't go too deep
+class ProjectScanner {
+    constructor(projectRoot = process.cwd()) {
+        this.ai = null;
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Full scan: walk tree + read key files + build snapshot
+     */
+    async scan() {
+        const fileTree = [];
+        const keyFiles = [];
+        const stats = {
+            totalFiles: 0,
+            totalDirs: 0,
+            routeFiles: 0,
+            componentFiles: 0,
+            apiFiles: 0,
+            schemaFiles: 0,
+            testFiles: 0,
+        };
+        // Walk the tree
+        await this.walkDirectory("", fileTree, stats, 0);
+        // Read key files (truncated)
+        for (const entry of fileTree) {
+            if (entry.type !== "file")
+                continue;
+            if (keyFiles.length >= MAX_KEY_FILES)
+                break;
+            const isKeyFile = KEY_FILE_PATTERNS.some((p) => p.test(entry.path));
+            if (isKeyFile) {
+                const snippet = await this.readFileSnippet(entry.path);
+                if (snippet)
+                    keyFiles.push(snippet);
+            }
+        }
+        return {
+            scannedAt: new Date().toISOString(),
+            projectRoot: this.projectRoot,
+            fileTree,
+            keyFiles,
+            stats,
+        };
+    }
+    /**
+     * Recursively walk a directory
+     */
+    async walkDirectory(relativePath, entries, stats, depth) {
+        if (depth > MAX_TREE_DEPTH)
+            return;
+        const fullPath = path.join(this.projectRoot, relativePath);
+        let items;
+        try {
+            items = await fs.readdir(fullPath);
+        }
+        catch {
+            return;
+        }
+        for (const item of items) {
+            if (IGNORE_DIRS.has(item) && depth < 2)
+                continue; // Allow nested dirs with same name
+            if (item.startsWith(".") && item !== ".env.example")
+                continue;
+            const itemRelPath = relativePath ? `${relativePath}/${item}` : item;
+            const itemFullPath = path.join(this.projectRoot, itemRelPath);
+            let stat;
+            try {
+                stat = await fs.stat(itemFullPath);
+            }
+            catch {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                if (IGNORE_DIRS.has(item))
+                    continue;
+                stats.totalDirs++;
+                entries.push({ path: itemRelPath, type: "dir" });
+                await this.walkDirectory(itemRelPath, entries, stats, depth + 1);
+            }
+            else if (stat.isFile()) {
+                const ext = path.extname(item);
+                if (IGNORE_EXTENSIONS.has(ext))
+                    continue;
+                stats.totalFiles++;
+                entries.push({
+                    path: itemRelPath,
+                    type: "file",
+                    size: stat.size,
+                    extension: ext,
+                });
+                // Categorize
+                if (/page\.(tsx|jsx)$/.test(item) || /route\.(tsx|jsx|ts)$/.test(item))
+                    stats.routeFiles++;
+                if (/^[A-Z].*\.(tsx|jsx)$/.test(item))
+                    stats.componentFiles++;
+                if (itemRelPath.includes("/api/"))
+                    stats.apiFiles++;
+                if (/schema|model|entity/i.test(item))
+                    stats.schemaFiles++;
+                if (/\.(test|spec)\.(ts|tsx|js|jsx)$/.test(item))
+                    stats.testFiles++;
+            }
+        }
+    }
+    /**
+     * Read a file, truncated to MAX_FILE_READ_SIZE
+     */
+    async readFileSnippet(relativePath) {
+        try {
+            const fullPath = path.join(this.projectRoot, relativePath);
+            const content = await fs.readFile(fullPath, "utf-8");
+            const lines = content.split("\n").length;
+            return {
+                path: relativePath,
+                content: content.substring(0, MAX_FILE_READ_SIZE),
+                lines,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Compare a snapshot against context.json and get LLM assessment
+     */
+    async assessProgress(snapshot, existingContext) {
+        // Build a compact representation for the LLM
+        const treeCompact = snapshot.fileTree
+            .filter((f) => f.type === "file")
+            .map((f) => f.path)
+            .join("\n");
+        const keyFilesCompact = snapshot.keyFiles
+            .map((f) => `--- ${f.path} (${f.lines} lines) ---\n${f.content}`)
+            .join("\n\n");
+        const contextStr = JSON.stringify(existingContext, null, 2).substring(0, 5000);
+        const prompt = `You are the Living Brain's Assessment Engine for a MyContext-managed project.
+
+TASK: Compare the ACTUAL project file structure against the project's PLANNED context (context.json) and provide a progress assessment.
+
+## ACTUAL FILE STRUCTURE (${snapshot.stats.totalFiles} files, ${snapshot.stats.totalDirs} dirs)
+Stats: ${snapshot.stats.routeFiles} route files, ${snapshot.stats.componentFiles} components, ${snapshot.stats.apiFiles} API routes, ${snapshot.stats.schemaFiles} schema files, ${snapshot.stats.testFiles} test files
+
+File tree:
+${treeCompact.substring(0, 3000)}
+
+## KEY FILES CONTENT
+${keyFilesCompact.substring(0, 4000)}
+
+## PLANNED CONTEXT (context.json)
+${contextStr}
+
+## INSTRUCTIONS
+Analyze the gap between PLANNED and ACTUAL. Return valid JSON:
+{
+  "overallProgress": <0-100 int>,
+  "progressSummary": "<2-3 sentence summary of current state>",
+  "diffs": [
+    {
+      "type": "missing_in_context" | "missing_in_code" | "outdated" | "suggestion",
+      "category": "route" | "component" | "entity" | "config" | "general",
+      "description": "<what's missing/outdated>",
+      "suggestion": "<concrete fix>"
+    }
+  ],
+  "suggestedContextMerge": {
+    // Partial context.json structure with suggested additions/updates
+    // Only include NEW items that should be added to context.json
+  }
+}
+
+Rules:
+- "missing_in_context": Code exists but context.json doesn't know about it
+- "missing_in_code": context.json plans it but code doesn't have it yet
+- "outdated": Code has evolved beyond what context.json describes
+- Focus on actionable, specific findings. Max 10 diffs.`;
+        try {
+            const ai = this.getAICore();
+            const report = await ai.generateStructuredText(prompt, "ContextDiffReport");
+            return {
+                assessedAt: new Date().toISOString(),
+                overallProgress: report.overallProgress || 0,
+                progressSummary: report.progressSummary || "Assessment complete.",
+                diffs: report.diffs || [],
+                suggestedContextMerge: report.suggestedContextMerge || {},
+            };
+        }
+        catch (error) {
+            return {
+                assessedAt: new Date().toISOString(),
+                overallProgress: -1,
+                progressSummary: `LLM assessment failed: ${error.message}`,
+                diffs: [],
+                suggestedContextMerge: {},
+            };
+        }
+    }
+    /**
+     * Display the scan results nicely
+     */
+    displaySnapshot(snapshot) {
+        console.log(chalk_1.default.cyan("\n┌──────────────────────────────────────────────┐"));
+        console.log(chalk_1.default.cyan("│") + chalk_1.default.bold.white("  📂 Project Scan Results") + " ".repeat(22) + chalk_1.default.cyan("│"));
+        console.log(chalk_1.default.cyan("├──────────────────────────────────────────────┤"));
+        console.log(chalk_1.default.cyan("│") + chalk_1.default.gray(`  Files:      ${String(snapshot.stats.totalFiles).padEnd(6)} Dirs: ${snapshot.stats.totalDirs}`.padEnd(45)) + chalk_1.default.cyan("│"));
+        console.log(chalk_1.default.cyan("│") + chalk_1.default.gray(`  Routes:     ${String(snapshot.stats.routeFiles).padEnd(6)} Components: ${snapshot.stats.componentFiles}`.padEnd(45)) + chalk_1.default.cyan("│"));
+        console.log(chalk_1.default.cyan("│") + chalk_1.default.gray(`  API Routes: ${String(snapshot.stats.apiFiles).padEnd(6)} Schemas: ${snapshot.stats.schemaFiles}`.padEnd(45)) + chalk_1.default.cyan("│"));
+        console.log(chalk_1.default.cyan("│") + chalk_1.default.gray(`  Tests:      ${String(snapshot.stats.testFiles).padEnd(6)}`.padEnd(45)) + chalk_1.default.cyan("│"));
+        console.log(chalk_1.default.cyan("│") + chalk_1.default.gray(`  Key Files:  ${snapshot.keyFiles.length} read for analysis`.padEnd(45)) + chalk_1.default.cyan("│"));
+        console.log(chalk_1.default.cyan("└──────────────────────────────────────────────┘"));
+    }
+    /**
+     * Display the diff report nicely
+     */
+    displayReport(report) {
+        const progressBar = this.makeProgressBar(report.overallProgress, 20);
+        console.log(chalk_1.default.cyan("\n┌──────────────────────────────────────────────┐"));
+        console.log(chalk_1.default.cyan("│") + chalk_1.default.bold.white("  🧠 Context Sync Assessment") + " ".repeat(18) + chalk_1.default.cyan("│"));
+        console.log(chalk_1.default.cyan("├──────────────────────────────────────────────┤"));
+        console.log(chalk_1.default.cyan("│") + chalk_1.default.white(`  Progress: ${progressBar} ${report.overallProgress}%`.padEnd(45)) + chalk_1.default.cyan("│"));
+        console.log(chalk_1.default.cyan("│") + chalk_1.default.gray(`  ${report.progressSummary.substring(0, 43)}`.padEnd(45)) + chalk_1.default.cyan("│"));
+        console.log(chalk_1.default.cyan("└──────────────────────────────────────────────┘"));
+        if (report.diffs.length > 0) {
+            console.log(chalk_1.default.yellow(`\n📋 Found ${report.diffs.length} items to sync:\n`));
+            for (const diff of report.diffs) {
+                const icon = {
+                    missing_in_context: "🔵",
+                    missing_in_code: "🔴",
+                    outdated: "🟡",
+                    suggestion: "💡",
+                }[diff.type];
+                console.log(`  ${icon} [${diff.category}] ${diff.description}`);
+                console.log(chalk_1.default.gray(`     → ${diff.suggestion}\n`));
+            }
+        }
+        if (Object.keys(report.suggestedContextMerge).length > 0) {
+            console.log(chalk_1.default.green("📦 Suggested context.json merge:"));
+            console.log(chalk_1.default.gray(JSON.stringify(report.suggestedContextMerge, null, 2).substring(0, 500)));
+        }
+    }
+    /**
+     * Get or initialize AICore safely
+     */
+    getAICore() {
+        if (this.ai)
+            return this.ai;
+        try {
+            this.ai = AICore_1.AICore.getInstance();
+        }
+        catch {
+            this.ai = AICore_1.AICore.getInstance({
+                fallbackEnabled: true,
+                workingDirectory: this.projectRoot,
+            });
+        }
+        return this.ai;
+    }
+    makeProgressBar(percent, width) {
+        if (percent < 0)
+            return "❌".padEnd(width);
+        const filled = Math.round((percent / 100) * width);
+        const empty = width - filled;
+        return "█".repeat(filled) + "░".repeat(empty);
+    }
+}
+exports.ProjectScanner = ProjectScanner;
+//# sourceMappingURL=ProjectScanner.js.map

package/dist/services/ProjectScanner.js.map

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

package/dist/services/ScaffoldAgent.d.ts

@@ -0,0 +1,35 @@
+import { MegaContext } from "../types/mega-context";
+export declare class ScaffoldAgent {
+    private fs;
+    private spinner;
+    constructor();
+    /**
+     * Deterministically scaffold the project from the MegaContext
+     */
+    scaffold(context: MegaContext): Promise<void>;
+    /**
+     * Generate instant.schema.ts
+     */
+    private generateSchemaFile;
+    /**
+     * Generate Next.js App Router structure
+     */
+    private generateRoutes;
+    /**
+     * Create .env file with API keys
+     */
+    private createEnvFile;
+    /**
+     * Save the MegaContext to .mycontext/context.json
+     */
+    private saveContext;
+    /**
+     * Create the .mycontext/ALIGN file
+     */
+    private createAlign;
+    /**
+     * Generate a README.md based on the context
+     */
+    private createReadme;
+}
+//# sourceMappingURL=ScaffoldAgent.d.ts.map

package/dist/services/ScaffoldAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScaffoldAgent.d.ts","sourceRoot":"","sources":["../../src/services/ScaffoldAgent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOpD,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAA2B;IACrC,OAAO,CAAC,OAAO,CAAkB;;IAMjC;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAsDnD;;OAEG;YACW,kBAAkB;IAoBhC;;OAEG;YACW,cAAc;IA2B5B;;OAEG;YACW,aAAa;IAmB3B;;OAEG;YACW,WAAW;IAMzB;;OAEG;YACW,WAAW;IAqBzB;;OAEG;YACW,YAAY;CA0B3B"}

package/dist/services/ScaffoldAgent.js

@@ -0,0 +1,228 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScaffoldAgent = void 0;
+const spinner_1 = require("../utils/spinner");
+const fileSystem_1 = require("../utils/fileSystem");
+const chalk_1 = __importDefault(require("chalk"));
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+class ScaffoldAgent {
+    constructor() {
+        this.fs = new fileSystem_1.FileSystemManager();
+        this.spinner = new spinner_1.EnhancedSpinner("Refining architecture...");
+    }
+    /**
+     * Deterministically scaffold the project from the MegaContext
+     */
+    async scaffold(context) {
+        console.log(chalk_1.default.blue(`\n🚀 Scaling up to 100% deterministic scaffold for: ${context.project.name}\n`));
+        const projectPath = path.resolve(process.cwd(), context.project.name);
+        // 1. Framework Scaffold (Next.js)
+        if (!fs.existsSync(projectPath)) {
+            this.spinner.updateText("Bootstrapping Next.js + InstantDB...");
+            this.spinner.start();
+            try {
+                // Using a more deterministic install command (pnpm dlx create-next-app)
+                // We use --no-eslint --no-tailwind --no-src-dir etc to have full control? 
+                // For now, let's stick to standard recommended setup but fast
+                (0, child_process_1.execSync)(`pnpm dlx create-next-app@latest ${context.project.name} --typescript --tailwind --eslint --app --no-src-dir --import-alias "@/*" --use-pnpm`, {
+                    stdio: "ignore"
+                });
+                this.spinner.success({ text: "Next.js shell created." });
+            }
+            catch (e) {
+                this.spinner.error({ text: "Failed to scaffold Next.js app." });
+                throw e;
+            }
+        }
+        // 2. Install InstantDB
+        this.spinner.updateText("Installing InstantDB SDK...");
+        this.spinner.start();
+        (0, child_process_1.execSync)("pnpm add @instantdb/react @instantdb/admin", { cwd: projectPath, stdio: "ignore" });
+        this.spinner.success({ text: "InstantDB SDK installed." });
+        // 3. Generate Schema
+        this.spinner.updateText("Generating InstantDB Schema...");
+        this.spinner.start();
+        await this.generateSchemaFile(projectPath, context);
+        this.spinner.success({ text: "Schema generated from MegaContext." });
+        // 4. Generate Routes & Pages
+        this.spinner.updateText("Generating Route Structure...");
+        this.spinner.start();
+        await this.generateRoutes(projectPath, context);
+        this.spinner.success({ text: "Routes & Layouts generated." });
+        // 5. Persist "Living Brain"
+        this.spinner.updateText("Initializing Living Brain (.mycontext)...");
+        this.spinner.start();
+        await this.saveContext(projectPath, context);
+        await this.createAlign(projectPath);
+        await this.createReadme(projectPath, context);
+        await this.createEnvFile(projectPath);
+        this.spinner.success({ text: "Context, Utils, & .env saved." });
+        console.log(chalk_1.default.green(`\n✅ Project "${context.project.name}" is ready!`));
+        console.log(chalk_1.default.gray(`   cd ${context.project.name} && pnpm dev`));
+    }
+    /**
+     * Generate instant.schema.ts
+     */
+    async generateSchemaFile(projectPath, context) {
+        // This would actually generate the full TS file content based on context.database.entities
+        // For prototype, we generate a stub
+        const schemaContent = `
+import { i } from "@instantdb/react";
+
+export const graph = i.graph(
+  "${context.project.id}",
+  {
+    ${Object.entries(context.database.entities).map(([name, def]) => `${name}: i.entity({
+      ${Object.keys(def.fields).map(f => `${f}: i.string()`).join(",\n      ")}
+    })`).join(",\n    ")}
+  }
+);
+    `;
+        await fs.ensureDir(path.join(projectPath, "lib"));
+        await fs.writeFile(path.join(projectPath, "lib", "instant.schema.ts"), schemaContent);
+    }
+    /**
+     * Generate Next.js App Router structure
+     */
+    async generateRoutes(projectPath, context) {
+        const appDir = path.join(projectPath, "app");
+        for (const [routePath, routeNode] of Object.entries(context.routing.routes)) {
+            if (routeNode.type === "page") {
+                const relativePath = routePath === "/" ? "" : routePath.slice(1); // remove leading slash
+                const targetDir = path.join(appDir, relativePath);
+                await fs.ensureDir(targetDir);
+                const pageContent = `
+export default function Page() {
+  return (
+    <div className="container mx-auto py-10">
+      <h1 className="text-4xl font-bold">${routeNode.ui?.title || "Page"}</h1>
+      <p className="mt-4 text-muted-foreground">${routeNode.ui?.description || ""}</p>
+      {/* Components: ${routeNode.ui?.components?.map(c => c.name).join(", ")} */}
+    </div>
+  );
+}
+            `;
+                await fs.writeFile(path.join(targetDir, "page.tsx"), pageContent);
+            }
+        }
+    }
+    // ... existing methods ...
+    /**
+     * Create .env file with API keys
+     */
+    async createEnvFile(projectPath) {
+        // Collect specific keys we care about
+        const keys = [];
+        if (process.env.GEMINI_API_KEY)
+            keys.push(`GEMINI_API_KEY=${process.env.GEMINI_API_KEY}`);
+        if (process.env.GOOGLE_API_KEY)
+            keys.push(`GOOGLE_API_KEY=${process.env.GOOGLE_API_KEY}`);
+        if (process.env.OPENROUTER_API_KEY)
+            keys.push(`OPENROUTER_API_KEY=${process.env.OPENROUTER_API_KEY}`);
+        // Default InstantDB App ID (Placeholder)
+        keys.push(`NEXT_PUBLIC_INSTANT_APP_ID=${process.env.NEXT_PUBLIC_INSTANT_APP_ID || "YOUR_APP_ID_HERE"}`);
+        if (keys.length > 0) {
+            await fs.writeFile(path.join(projectPath, ".env"), keys.join("\n"));
+        }
+    }
+    /**
+     * Save the MegaContext to .mycontext/context.json
+     */
+    async saveContext(projectPath, context) {
+        const contextDir = path.join(projectPath, ".mycontext");
+        await fs.ensureDir(contextDir);
+        await fs.writeJSON(path.join(contextDir, "context.json"), context, { spaces: 2 });
+    }
+    /**
+     * Create the .mycontext/ALIGN file
+     */
+    async createAlign(projectPath) {
+        const alignContent = `# MyContext Alignment Guard [SYNC]
+Any changes to code, architecture, or features MUST be synchronized with:
+1. \`.mycontext/context.json\` (Source of Truth / Living Brain)
+2. \`README.md\` (Human-facing orientation & usage)
+
+[PHILOSOPHY: DETERMINISTIC SCAFFOLDING]:
+- **Next.js + InstantDB First**: We are built for Next.js full-stack projects using InstantDB as the backend.
+- **Mega Context (100% Knowledge)**:
+- Before ANY code is generated, the MegaContext must be 100% populated.
+
+[PROJECT SCANNER — CONTEXT SYNC]:
+- Run \`mycontext scan --assess\` to compare actual code against planned context.json.
+- Identifies routes/components/entities in code but missing from context, and vice versa.
+- Use during development to keep context.json aligned with reality.
+`;
+        const contextDir = path.join(projectPath, ".mycontext");
+        await fs.ensureDir(contextDir);
+        await fs.writeFile(path.join(contextDir, "ALIGN"), alignContent);
+    }
+    /**
+     * Generate a README.md based on the context
+     */
+    async createReadme(projectPath, context) {
+        const readmeContent = `# ${context.project.name}
+
+${context.project.description}
+
+## Tech Stack
+- **Framework**: Next.js (App Router)
+- **Backend**: InstantDB
+- **Styling**: TailwindCSS + ShadCN
+
+## Computed Architecture
+- **Roles**: ${context.auth.roles.map(r => r.name).join(", ")}
+- **Entities**: ${Object.keys(context.database.entities).join(", ")}
+- **Routes**: ${Object.keys(context.routing.routes).join(", ")}
+
+## Getting Started
+
+\`\`\`bash
+pnpm install
+pnpm dev
+\`\`\`
+
+Generated by MyContext CLI 🚀
+`;
+        await fs.writeFile(path.join(projectPath, "README.md"), readmeContent);
+    }
+}
+exports.ScaffoldAgent = ScaffoldAgent;
+//# sourceMappingURL=ScaffoldAgent.js.map

package/dist/services/ScaffoldAgent.js.map

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