imhcode 1.1.1 → 2.0.1

package/dist/orchestrator/modification-engine.d.ts

@@ -0,0 +1,12 @@
+export interface ModificationOptions {
+    agent?: string;
+    engine?: string;
+    model?: string;
+    dryRun?: boolean;
+    scope?: string;
+}
+/**
+ * Execute a targeted project modification.
+ */
+export declare function runModification(cwd: string, description: string, options?: ModificationOptions): Promise<any>;
+//# sourceMappingURL=modification-engine.d.ts.map

package/dist/orchestrator/modification-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modification-engine.d.ts","sourceRoot":"","sources":["../../src/orchestrator/modification-engine.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,CAsDd"}

package/dist/orchestrator/modification-engine.js

@@ -0,0 +1,109 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runModification = runModification;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const context_scanner_1 = require("./context-scanner");
+const registry_1 = require("./registry");
+const index_1 = require("./index");
+/**
+ * Execute a targeted project modification.
+ */
+async function runModification(cwd, description, options = {}) {
+    // 1. Scan context
+    const context = (0, context_scanner_1.scanProjectContext)(cwd);
+    // 2. Select agent
+    const selectedAgentId = options.agent || (0, context_scanner_1.detectBestAgent)(description, context);
+    console.log(`\n🛠️  [IMH-Code] Initializing Modification Engine`);
+    console.log(`   Task:  "${description}"`);
+    console.log(`   Agent:  ${selectedAgentId}`);
+    // Resolve agent manifests directory
+    const globalAgents = path.join(process.env.HOME || "", ".imhcode", "agents");
+    const localAgents = path.join(cwd, "agents");
+    const pkgAgents = path.join(__dirname, "..", "..", "agents");
+    const agentsDir = fs.existsSync(globalAgents) ? globalAgents :
+        fs.existsSync(localAgents) ? localAgents :
+            pkgAgents;
+    // 3. Load Registry
+    const { agents, errors } = await (0, registry_1.loadRegistry)(agentsDir, cwd);
+    if (errors.some(e => e.agentId === selectedAgentId)) {
+        throw new Error(`Failed to load agent "${selectedAgentId}": ${errors.find(e => e.agentId === selectedAgentId)?.error}`);
+    }
+    const agent = (0, registry_1.getAgent)(agents, selectedAgentId);
+    // 4. Build custom modification task
+    const modificationTask = (0, context_scanner_1.buildModificationPrompt)(context, description);
+    // 5. Run the agent
+    const result = await (0, index_1.runAgent)(agent, modificationTask, {
+        dryRun: options.dryRun !== false,
+        engine: options.engine,
+        model: options.model,
+        outputDir: path.join(cwd, ".imhcode", "sessions"),
+        cwd
+    });
+    // 6. Log changes if live and successful
+    if (!result.dryRun && result.errors.length === 0) {
+        logModification(cwd, {
+            task: description,
+            agentId: selectedAgentId,
+            model: result.model,
+            durationMs: result.durationMs
+        });
+    }
+    return result;
+}
+function logModification(cwd, entry) {
+    const docsDir = path.join(cwd, "docs");
+    if (!fs.existsSync(docsDir)) {
+        fs.mkdirSync(docsDir, { recursive: true });
+    }
+    const logPath = path.join(docsDir, "modifications.md");
+    const timestamp = new Date().toISOString().replace("T", " ").substring(0, 19);
+    let header = `# 🛠️ IMH-Code Project Modifications\n\n| Date | Task | Agent | Model | Duration |\n|------|------|-------|-------|----------|\n`;
+    if (fs.existsSync(logPath)) {
+        try {
+            const existing = fs.readFileSync(logPath, "utf-8");
+            if (existing.trim().length > 10) {
+                header = existing;
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    const row = `| ${timestamp} | ${entry.task} | \`${entry.agentId}\` | ${entry.model} | ${(entry.durationMs / 1000).toFixed(1)}s |\n`;
+    fs.writeFileSync(logPath, header.endsWith("\n") ? header + row : header + "\n" + row, "utf-8");
+}
+//# sourceMappingURL=modification-engine.js.map

package/dist/orchestrator/modification-engine.js.map

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

package/dist/orchestrator/project-scanner.d.ts

@@ -0,0 +1,16 @@
+export interface ScanResult {
+    detectedFrontend: string | null;
+    detectedBackend: string | null;
+    frontendPath: string | null;
+    backendPath: string | null;
+    database: string | null;
+    dockerized: boolean;
+    hasCICD: boolean;
+    packageJson?: any;
+    composerJson?: any;
+}
+/**
+ * Deep scan an existing codebase to detect stack and structure.
+ */
+export declare function scanProject(cwd: string): ScanResult;
+//# sourceMappingURL=project-scanner.d.ts.map

package/dist/orchestrator/project-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scanner.d.ts","sourceRoot":"","sources":["../../src/orchestrator/project-scanner.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAmHnD"}

package/dist/orchestrator/project-scanner.js

@@ -0,0 +1,164 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanProject = scanProject;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Deep scan an existing codebase to detect stack and structure.
+ */
+function scanProject(cwd) {
+    const result = {
+        detectedFrontend: null,
+        detectedBackend: null,
+        frontendPath: null,
+        backendPath: null,
+        database: null,
+        dockerized: false,
+        hasCICD: false,
+    };
+    // 1. Helper to search for files recursively with limits
+    function findFile(dir, name, depth = 0) {
+        if (depth > 3)
+            return null;
+        try {
+            const files = fs.readdirSync(dir);
+            if (files.includes(name)) {
+                return path.join(dir, name);
+            }
+            for (const file of files) {
+                if (file.startsWith(".") || file === "node_modules" || file === "dist" || file === "vendor")
+                    continue;
+                const fp = path.join(dir, file);
+                if (fs.statSync(fp).isDirectory()) {
+                    const found = findFile(fp, name, depth + 1);
+                    if (found)
+                        return found;
+                }
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return null;
+    }
+    // 2. Scan for package.json (Frontend detection)
+    const pkgJsonPath = findFile(cwd, "package.json");
+    if (pkgJsonPath) {
+        try {
+            const content = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
+            result.packageJson = content;
+            const deps = { ...(content.dependencies || {}), ...(content.devDependencies || {}) };
+            if (deps.next)
+                result.detectedFrontend = "Next.js";
+            else if (deps.nuxt || deps.nuxt3 || deps.nuxt4)
+                result.detectedFrontend = "Nuxt/Vue";
+            else if (deps.react)
+                result.detectedFrontend = "React SPA";
+            else if (deps.vue)
+                result.detectedFrontend = "Vue SPA";
+            else if (deps.svelte)
+                result.detectedFrontend = "Svelte";
+            else
+                result.detectedFrontend = "Node/JS";
+            // If package.json is in a subdirectory, use that subdirectory
+            const relative = path.relative(cwd, path.dirname(pkgJsonPath));
+            result.frontendPath = relative === "" ? "." : relative;
+        }
+        catch {
+            // Ignore
+        }
+    }
+    // 3. Scan for composer.json, requirements.txt, or pom.xml (Backend detection)
+    const composerPath = findFile(cwd, "composer.json");
+    if (composerPath) {
+        try {
+            const content = JSON.parse(fs.readFileSync(composerPath, "utf-8"));
+            result.composerJson = content;
+            if (content.require && (content.require["laravel/framework"] || content.require["laravel/lumen-framework"])) {
+                result.detectedBackend = "Laravel";
+            }
+            else {
+                result.detectedBackend = "PHP";
+            }
+            const relative = path.relative(cwd, path.dirname(composerPath));
+            result.backendPath = relative === "" ? "." : relative;
+        }
+        catch {
+            // Ignore
+        }
+    }
+    if (!result.detectedBackend) {
+        const reqsTxtPath = findFile(cwd, "requirements.txt");
+        const pyprojectPath = findFile(cwd, "pyproject.toml");
+        if (reqsTxtPath || pyprojectPath) {
+            result.detectedBackend = "Python (Django/FastAPI)";
+            const matchedPath = reqsTxtPath || pyprojectPath || "";
+            const relative = path.relative(cwd, path.dirname(matchedPath));
+            result.backendPath = relative === "" ? "." : relative;
+        }
+    }
+    // 4. Database Detection from env or configs
+    const envPath = findFile(cwd, ".env") || findFile(cwd, ".env.example");
+    if (envPath) {
+        try {
+            const content = fs.readFileSync(envPath, "utf-8");
+            if (content.includes("DB_CONNECTION=pgsql") || content.includes("postgresql://")) {
+                result.database = "PostgreSQL";
+            }
+            else if (content.includes("DB_CONNECTION=mysql") || content.includes("mysql://")) {
+                result.database = "MySQL";
+            }
+            else if (content.includes("DB_CONNECTION=sqlite") || content.includes("sqlite3")) {
+                result.database = "SQLite";
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    // 5. Infrastructure detection
+    const dockerCompose = findFile(cwd, "docker-compose.yml");
+    const dockerfile = findFile(cwd, "Dockerfile");
+    if (dockerCompose || dockerfile) {
+        result.dockerized = true;
+    }
+    const githubWorkflows = findFile(cwd, ".github/workflows");
+    if (githubWorkflows) {
+        result.hasCICD = true;
+    }
+    return result;
+}
+//# sourceMappingURL=project-scanner.js.map

package/dist/orchestrator/project-scanner.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imhcode",
-  "version": "1.1.1",
+  "version": "2.0.1",
   "description": "IMH-Code — Imam Hussain Coding Harness Platform. A fast-first multi-agent AI coding framework with intelligent model routing. 19 generic role-based agents (planner, nextjs-executor, laravel-executor, etc.), configurable testing strategy, and 7 token-saving optimizations for rapid MVP development.",
   "main": "index.js",
   "bin": {

package/skills/typeui-main/test/orchestrator.test.ts

@@ -3,55 +3,108 @@ import * as fs from "fs";
 import * as path from "path";
 import { loadMemoryFiles } from "../../../src/orchestrator/loader";
 import { getRoleKeyForAgent, resolveAgentIdAlias } from "../../../src/orchestrator/index";
+import { scanProjectContext, detectBestAgent } from "../../../src/orchestrator/context-scanner";
+import { scanProject, ScanResult } from "../../../src/orchestrator/project-scanner";
+import { importProject } from "../../../src/orchestrator/import-engine";
 
 describe("orchestrator resolveAgentIdAlias", () => {
-  it("resolves Zara aliases correctly", () => {
-    expect(resolveAgentIdAlias("zara-seo")).toBe("zara-content");
-    expect(resolveAgentIdAlias("Zara")).toBe("zara-content");
-  });
-
-  it("resolves Farhan aliases correctly", () => {
-    expect(resolveAgentIdAlias("farhan-growth")).toBe("farhan-marketing");
-    expect(resolveAgentIdAlias("farhan")).toBe("farhan-marketing");
-  });
-
-  it("resolves other mismatched agent aliases", () => {
-    expect(resolveAgentIdAlias("taha-slides")).toBe("taha-presentation");
-    expect(resolveAgentIdAlias("sami-spatial")).toBe("sami-computational");
-    expect(resolveAgentIdAlias("yahya-phd")).toBe("yahya-researcher");
-    expect(resolveAgentIdAlias("maryam-business")).toBe("maryam-ops");
-    expect(resolveAgentIdAlias("zainab-product-manager")).toBe("zainab-pm");
-    expect(resolveAgentIdAlias("gohar")).toBe("gohar-ceo");
+  it("resolves generic agent aliases correctly", () => {
+    expect(resolveAgentIdAlias("nextjs")).toBe("nextjs-executor");
+    expect(resolveAgentIdAlias("laravel")).toBe("laravel-executor");
+    expect(resolveAgentIdAlias("qa")).toBe("tester");
+    expect(resolveAgentIdAlias("security")).toBe("security-auditor");
+    expect(resolveAgentIdAlias("seo")).toBe("seo-optimizer");
+    expect(resolveAgentIdAlias("debug")).toBe("debugger");
   });
 
   it("returns canonical ID unchanged", () => {
-    expect(resolveAgentIdAlias("karar-frontend")).toBe("karar-frontend");
+    expect(resolveAgentIdAlias("laravel-executor")).toBe("laravel-executor");
   });
 });
 
 describe("orchestrator getRoleKeyForAgent", () => {
-  it("resolves security roles correctly", () => {
-    expect(getRoleKeyForAgent("hamid-security", "Audit the authentication code")).toBe("primary_security_reviewer");
-    expect(getRoleKeyForAgent("hamid-security", "Laravel security fallback audit")).toBe("security_fallback");
-  });
-
-  it("resolves debugger roles correctly", () => {
-    expect(getRoleKeyForAgent("sajjad-debugger", "Fix login bug")).toBe("fast_bug_fixing");
+  it("resolves generic executor roles correctly", () => {
+    expect(getRoleKeyForAgent("nextjs-executor", "Build a dashboard")).toBe("frontend");
+    expect(getRoleKeyForAgent("laravel-executor", "Create API route")).toBe("backend");
+    expect(getRoleKeyForAgent("planner", "Define architecture")).toBe("planning");
+    expect(getRoleKeyForAgent("tester", "Run E2E tests")).toBe("testing");
+    expect(getRoleKeyForAgent("debugger", "Fix authentication issue")).toBe("review");
   });
+});
 
-  it("resolves designer roles correctly", () => {
-    expect(getRoleKeyForAgent("mustafa-visual", "Create hero section")).toBe("primary_design_brain");
-    expect(getRoleKeyForAgent("mahdi-designer", "Polish the UX layout")).toBe("design_polish_ux_review");
-  });
+describe("project scanners and imports", () => {
+  const tempDir = path.join(process.cwd(), ".tmp-tests", `import-test-${Date.now()}`);
 
-  it("resolves frontend roles correctly", () => {
-    expect(getRoleKeyForAgent("karar-frontend", "Build button component")).toBe("frontend_builder");
-    expect(getRoleKeyForAgent("karar-frontend", "Verify and review final frontend")).toBe("frontend_final_review");
+  it("scans and imports project structures correctly", () => {
+    // 1. Create a dummy Next.js + Laravel project layout
+    fs.mkdirSync(tempDir, { recursive: true });
+    fs.mkdirSync(path.join(tempDir, "frontend"), { recursive: true });
+    fs.mkdirSync(path.join(tempDir, "backend"), { recursive: true });
+
+    // Write package.json
+    fs.writeFileSync(
+      path.join(tempDir, "frontend", "package.json"),
+      JSON.stringify({
+        name: "test-frontend",
+        dependencies: {
+          next: "^15.0.0",
+          react: "^19.0.0"
+        }
+      })
+    );
+
+    // Write composer.json
+    fs.writeFileSync(
+      path.join(tempDir, "backend", "composer.json"),
+      JSON.stringify({
+        name: "laravel/laravel",
+        require: {
+          "laravel/framework": "^11.0"
+        }
+      })
+    );
+
+    // Write .env with pgsql database config
+    fs.writeFileSync(
+      path.join(tempDir, ".env"),
+      "DB_CONNECTION=pgsql\nDATABASE_URL=postgresql://localhost:5432/test"
+    );
+
+    // 2. Test project scanner
+    const scanResult = scanProject(tempDir);
+    expect(scanResult.detectedFrontend).toBe("Next.js");
+    expect(scanResult.detectedBackend).toBe("Laravel");
+    expect(scanResult.frontendPath).toBe("frontend");
+    expect(scanResult.backendPath).toBe("backend");
+    expect(scanResult.database).toBe("PostgreSQL");
+
+    // 3. Test context scanner
+    const contextScan = scanProjectContext(tempDir);
+    expect(contextScan.hasFrontend).toBe(true);
+    expect(contextScan.hasBackend).toBe(true);
+    expect(contextScan.frontendFramework).toBe("Next.js");
+    expect(contextScan.backendFramework).toBe("Laravel");
+
+    // 4. Test best agent detection
+    expect(detectBestAgent("fix a bug in navbar component", contextScan)).toBe("nextjs-executor");
+    expect(detectBestAgent("create a database migration for comments table", contextScan)).toBe("laravel-executor");
+
+    // 5. Test import execution
+    const importResult = importProject(tempDir);
+    expect(importResult.success).toBe(true);
+    expect(importResult.importMap.frontend).toBe("frontend");
+    expect(importResult.importMap.backend).toBe("backend");
+
+    // Check generated files exist
+    expect(fs.existsSync(path.join(tempDir, ".imhcode", "import-map.json"))).toBe(true);
+    expect(fs.existsSync(path.join(tempDir, "PROJECT_BRIEF.md"))).toBe(true);
   });
 
-  it("resolves backend roles correctly", () => {
-    expect(getRoleKeyForAgent("tariq-backend", "Write DB migration")).toBe("primary_backend_builder");
-    expect(getRoleKeyForAgent("tariq-backend", "Refactor multiple files in Laravel")).toBe("backend_multi_file_builder");
+  // Clean up
+  afterAll(() => {
+    if (fs.existsSync(tempDir)) {
+      fs.rmSync(tempDir, { recursive: true, force: true });
+    }
   });
 });
 
@@ -59,14 +112,12 @@ describe("loadMemoryFiles exclusions and limits", () => {
   const tempDir = path.join(process.cwd(), ".tmp-tests", `mem-test-${Date.now()}`);
 
   it("filters out binary files, lockfiles, excluded directories, and large files", async () => {
-    // 1. Create temp structures
     fs.mkdirSync(tempDir, { recursive: true });
     fs.mkdirSync(path.join(tempDir, "docs"), { recursive: true });
     fs.mkdirSync(path.join(tempDir, "node_modules"), { recursive: true });
     fs.mkdirSync(path.join(tempDir, "frontend", ".next"), { recursive: true });
     fs.mkdirSync(path.join(tempDir, "backend", "build"), { recursive: true });
 
-    // 2. Write files
     fs.writeFileSync(path.join(tempDir, "docs", "test.md"), "hello docs");
     fs.writeFileSync(path.join(tempDir, "docs", "info.txt"), "hello info");
     fs.writeFileSync(path.join(tempDir, "node_modules", "bad.js"), "console.log('bad')");
@@ -75,7 +126,6 @@ describe("loadMemoryFiles exclusions and limits", () => {
     fs.writeFileSync(path.join(tempDir, "frontend", "image.png"), "binary png contents");
     fs.writeFileSync(path.join(tempDir, "package-lock.json"), "{}");
 
-    // Write a file larger than 1MB
     const largeFilePath = path.join(tempDir, "docs", "large.txt");
     const largeContent = "a".repeat(1024 * 1024 + 10);
     fs.writeFileSync(largeFilePath, largeContent);
@@ -86,10 +136,8 @@ describe("loadMemoryFiles exclusions and limits", () => {
       }
     };
 
-    // 3. Execute loadMemoryFiles
     const files = await loadMemoryFiles(mockManifest, tempDir);
 
-    // 4. Verify results
     const relativePaths = files.map(f => path.relative(tempDir, f.path).replace(/\\/g, "/"));
     expect(relativePaths).toContain("docs/test.md");
     expect(relativePaths).toContain("docs/info.txt");
@@ -104,7 +152,6 @@ describe("loadMemoryFiles exclusions and limits", () => {
     expect(files.find(f => f.path.endsWith("info.txt"))?.content).toBe("hello info");
   });
 
-  // Clean up
   afterAll(() => {
     if (fs.existsSync(tempDir)) {
       fs.rmSync(tempDir, { recursive: true, force: true });

package/src/orchestrator/builder.ts

@@ -222,7 +222,32 @@ export function buildPrompt(
   }
 
   // ── 9. Category-Specific Output Rules ────────────────────────────────────
-  const categoryRules = CATEGORY_OUTPUT_RULES[category] ?? CATEGORY_OUTPUT_RULES["backend"];
+  let frontendDir = "frontend/";
+  let backendDir = "backend/";
+
+  if (cwd) {
+    const mapPath = path.join(cwd, ".imhcode", "import-map.json");
+    if (fs.existsSync(mapPath)) {
+      try {
+        const importMap = JSON.parse(fs.readFileSync(mapPath, "utf-8"));
+        if (importMap.frontend) {
+          frontendDir = importMap.frontend === "." ? "project root (./)" : `${importMap.frontend}/`;
+        }
+        if (importMap.backend) {
+          backendDir = importMap.backend === "." ? "project root (./)" : `${importMap.backend}/`;
+        }
+      } catch {
+        // Ignore
+      }
+    }
+  }
+
+  let categoryRules = CATEGORY_OUTPUT_RULES[category] ?? CATEGORY_OUTPUT_RULES["backend"];
+  // Dynamically replace default folder names with actual mapped ones
+  categoryRules = categoryRules
+    .replace(/`frontend\/`/g, `\`${frontendDir}\``)
+    .replace(/`backend\/`/g, `\`${backendDir}\``);
+
   const outputLines = [
     `**Category**: ${category}`,
     `**Format**: ${manifest.output.format}`,
@@ -236,10 +261,10 @@ export function buildPrompt(
 
   // ── 10. Codebase Containment Rules ───────────────────────────────────────
   const containmentRules = [
-    `- All frontend source files, styles, assets, and components → \`frontend/\` directory ONLY.`,
-    `- All backend source files, APIs, migrations, schemas, and logic → \`backend/\` directory ONLY.`,
+    `- All frontend source files, styles, assets, and components → \`${frontendDir}\` directory ONLY.`,
+    `- All backend source files, APIs, migrations, schemas, and logic → \`${backendDir}\` directory ONLY.`,
     `- All planning and documentation → \`docs/\` directory ONLY.`,
-    `- NEVER create application code at the workspace root. Keep root clean.`,
+    `- NEVER create application code at the workspace root unless the mapped directory is root (./).`,
   ].join("\n");
   parts.push(section("Codebase Containment Rules", containmentRules));