imhcode 1.0.9 → 1.1.1

package/bin/imhcode.js

@@ -1747,9 +1747,10 @@ async function generateSprintPlans(cwd, userPrompt, brainstormContent, config) {
   console.log(`  ✅ Created PROJECT_BRIEF.md`);
 
   // Try LLM-powered sprint generation first (Fix 0)
+  const assetsSummary = getAssetsSummary(cwd);
   const llmSprintResult = await tryLLMSprintGeneration(
     cwd, userPrompt, brainstormContent, config,
-    { hasFrontend, hasBackend, hasMobile, hasPayments, hasRealtime, designStyle, colorStyle, darkmode, detectedTesting, needsWorktrees }
+    { hasFrontend, hasBackend, hasMobile, hasPayments, hasRealtime, designStyle, colorStyle, darkmode, detectedTesting, needsWorktrees, assetsSummary }
   );
 
   let lastSprintNum;
@@ -1786,7 +1787,7 @@ async function generateSprintPlans(cwd, userPrompt, brainstormContent, config) {
  * Attempt LLM-generated sprint plans. Returns { sprintCount } on success, null on failure.
  */
 async function tryLLMSprintGeneration(cwd, userPrompt, brainstormContent, config, scope) {
-  const { hasFrontend, hasBackend, hasMobile, hasPayments, hasRealtime, designStyle, colorStyle, darkmode, detectedTesting } = scope;
+  const { hasFrontend, hasBackend, hasMobile, hasPayments, hasRealtime, designStyle, colorStyle, darkmode, detectedTesting, assetsSummary } = scope;
 
   const agentList = [
     'planner (planning)', 'designer (frontend)', 'nextjs-executor (frontend)', 'react-executor (frontend)',
@@ -1812,6 +1813,9 @@ ${userPrompt}
 ## Brainstorming Answers
 ${brainstormContent}
 
+## Shared Assets & References
+${assetsSummary || 'None'}
+
 ## Scope
 - Frontend: ${hasFrontend ? 'YES' : 'NO'} (Design style: ${designStyle}, Colors: ${colorStyle}, Dark Mode Strategy: ${darkmode})
 - Backend:  ${hasBackend  ? 'YES' : 'NO'}
@@ -1864,7 +1868,9 @@ Return ONLY this JSON structure (no markdown, no explanation):
 9. If design style is Glassmorphism/Neumorphism — include a designer task for design tokens in Sprint 1
 10. If payments needed — include payment integration task in a sprint
 11. If realtime needed — include WebSocket/SSE task in a sprint
-12. Under Frontend, STRICTLY respect the Dark Mode Strategy: if strategy is "light only", do NOT generate any dark mode setups, variables, toggles or dark styles. If strategy is "always dark", design the UI strictly for dark backgrounds.`;
+12. Under Frontend, STRICTLY respect the Dark Mode Strategy: if strategy is "light only", do NOT generate any dark mode setups, variables, toggles or dark styles. If strategy is "always dark", design the UI strictly for dark backgrounds.
+13. If any shared assets or references are listed under "Shared Assets & References" (such as a backend folder, frontend theme components, config files, or stylesheets), you MUST generate sprint tasks that explicitly guide the agents to review, copy, integrate, or take implementation experience from these reference assets to build the new frontend/backend.
+14. When designing tasks for backend/frontend scaffolding, instruct the agents to use the LATEST stable dependencies, commands, and coding styles, starting by running the official command-line initializers (like npx create-next-app@latest or composer create-project laravel/laravel) directly in the target directories to build a clean architecture structure.`;
 
   const llmOutput = await invokePlanningLLM(llmPrompt, config, cwd);
   if (!llmOutput) return null;
@@ -2203,6 +2209,47 @@ function extractPromptFromStartMd(content) {
   return lines.join(' ').slice(0, 500);
 }
 
+function getAssetsSummary(cwd) {
+  const assetsDir = path.join(cwd, LOCAL_DIR_NAME, 'assets');
+  if (!fs.existsSync(assetsDir)) {
+    return 'None';
+  }
+
+  const summary = [];
+  try {
+    const files = fs.readdirSync(assetsDir);
+    if (files.length === 0) {
+      return 'None';
+    }
+
+    for (const file of files) {
+      const filePath = path.join(assetsDir, file);
+      const stat = fs.statSync(filePath);
+
+      if (stat.isDirectory()) {
+        const subfiles = fs.readdirSync(filePath);
+        summary.push(`- Directory \`${file}/\` containing ${subfiles.length} items (e.g. ${subfiles.slice(0, 5).map(f => "\`" + f + "\`").join(', ')}). This contains shared reference code/implementation for this category.`);
+      } else {
+        const ext = path.extname(file).toLowerCase();
+        if (['.txt', '.md', '.json', '.js', '.ts', '.css', '.html', '.php', '.py'].includes(ext)) {
+          try {
+            const content = fs.readFileSync(filePath, 'utf8').slice(0, 500);
+            summary.push(`- File \`${file}\` (\${stat.size} bytes). Preview of contents:\n\`\`\`\n\${content}\n\`\`\``);
+          } catch {
+            summary.push(`- File \`${file}\` (\${stat.size} bytes).`);
+          }
+        } else {
+          summary.push(`- File \`${file}\` (\${stat.size} bytes) - type: \`\${ext || 'binary'}\`.`);
+        }
+      }
+    }
+  } catch (err) {
+    return `Error scanning assets: \${err.message}`;
+  }
+
+  return summary.join('\n');
+}
+
 function resolveQuestionKey(content, keywords) {
   const regex = /\*\*(Q\d+):\s*([^\n*]+)\*\*/gi;
   let match;

package/dist/orchestrator/builder.js

@@ -176,12 +176,11 @@ function buildPrompt(agent, task, acceptanceCriteria, cwd) {
             .join("\n\n");
         parts.push(section(`Project Memory (${memoryFiles.length} files)`, memoryBlock));
     }
-    // ── 4b. Assets & Branding Instructions ────────────────────────────────────
-    if (cwd && category === "frontend") {
-        parts.push(section("Assets & Branding Integration", `IMPORTANT: Check the \`.imhcode/assets/\` directory at the project root for any uploaded assets (e.g. logos, brand assets, images, text files, or raw content). ` +
-            `If any such assets exist, you MUST:\n` +
-            `1. Copy or integrate them into the frontend (e.g., \`frontend/public/\` or \`frontend/src/assets/\`).\n` +
-            `2. Use their exact content, names, and images in the user interface (instead of placeholders or generic text).`));
+    // ── 4b. Assets & Shared References Integration ────────────────────────────
+    if (cwd) {
+        const partsList = [];
+        partsList.push(`IMPORTANT: Always inspect the \`.imhcode/assets/\` directory at the project root for any shared reference code, designs, or assets.`, `- **Logo & Branding Assets**: Look for logos (e.g. \`logo.svg\`, images) or styling files. You MUST copy/integrate them into the frontend (e.g. \`frontend/public/\` or \`frontend/src/assets/\`) and use them directly.`, `- **Shared Frontend/Theme References**: If a \`.imhcode/assets/frontend/\` or \`theme/\` folder exists, review the components, styling sheets, layouts, and pages inside it. Take exact design/coding patterns, or directly reuse the components in your new frontend implementation to match the requested look and feel.`, `- **Shared Backend References**: If a \`.imhcode/assets/backend/\` folder exists, review the database schemas, API routes, models, and business logic. Replicate the architecture, reuse logic patterns, and align your new backend code structure with this reference implementation.`, `- **Always Use Latest Stable Stacks**: When setting up the project structure, compile and install the LATEST stable versions of libraries/frameworks. If initializing the codebase, run official command-line initializers (e.g. \`npx create-next-app@latest ./ --ts --tailwind --eslint --app --src-dir --import-alias "@/*"\` or \`composer create-project laravel/laravel .\`) directly within the target directory (\`frontend/\` or \`backend/\`) to bootstrap proper settings, then organize into a clean architecture. Do NOT hardcode deprecated versions or patterns.`);
+        parts.push(section("Assets & Shared References Integration Guidelines", partsList.join("\n")));
     }
     // ── 5. Task ───────────────────────────────────────────────────────────────
     parts.push(section("Task", task));

package/dist/orchestrator/builder.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imhcode",
-  "version": "1.0.9",
+  "version": "1.1.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/src/orchestrator/builder.ts

@@ -169,17 +169,17 @@ export function buildPrompt(
     parts.push(section(`Project Memory (${memoryFiles.length} files)`, memoryBlock));
   }
 
-  // ── 4b. Assets & Branding Instructions ────────────────────────────────────
-  if (cwd && category === "frontend") {
-    parts.push(
-      section(
-        "Assets & Branding Integration",
-        `IMPORTANT: Check the \`.imhcode/assets/\` directory at the project root for any uploaded assets (e.g. logos, brand assets, images, text files, or raw content). ` +
-        `If any such assets exist, you MUST:\n` +
-        `1. Copy or integrate them into the frontend (e.g., \`frontend/public/\` or \`frontend/src/assets/\`).\n` +
-        `2. Use their exact content, names, and images in the user interface (instead of placeholders or generic text).`
-      )
+  // ── 4b. Assets & Shared References Integration ────────────────────────────
+  if (cwd) {
+    const partsList: string[] = [];
+    partsList.push(
+      `IMPORTANT: Always inspect the \`.imhcode/assets/\` directory at the project root for any shared reference code, designs, or assets.`,
+      `- **Logo & Branding Assets**: Look for logos (e.g. \`logo.svg\`, images) or styling files. You MUST copy/integrate them into the frontend (e.g. \`frontend/public/\` or \`frontend/src/assets/\`) and use them directly.`,
+      `- **Shared Frontend/Theme References**: If a \`.imhcode/assets/frontend/\` or \`theme/\` folder exists, review the components, styling sheets, layouts, and pages inside it. Take exact design/coding patterns, or directly reuse the components in your new frontend implementation to match the requested look and feel.`,
+      `- **Shared Backend References**: If a \`.imhcode/assets/backend/\` folder exists, review the database schemas, API routes, models, and business logic. Replicate the architecture, reuse logic patterns, and align your new backend code structure with this reference implementation.`,
+      `- **Always Use Latest Stable Stacks**: When setting up the project structure, compile and install the LATEST stable versions of libraries/frameworks. If initializing the codebase, run official command-line initializers (e.g. \`npx create-next-app@latest ./ --ts --tailwind --eslint --app --src-dir --import-alias "@/*"\` or \`composer create-project laravel/laravel .\`) directly within the target directory (\`frontend/\` or \`backend/\`) to bootstrap proper settings, then organize into a clean architecture. Do NOT hardcode deprecated versions or patterns.`
     );
+    parts.push(section("Assets & Shared References Integration Guidelines", partsList.join("\n")));
   }
 
   // ── 5. Task ───────────────────────────────────────────────────────────────