imhcode 1.0.0

package/skills/webapp-testing/examples/console_logging.py

@@ -0,0 +1,35 @@
+from playwright.sync_api import sync_playwright
+
+# Example: Capturing console logs during browser automation
+
+url = 'http://localhost:5173'  # Replace with your URL
+
+console_logs = []
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)
+    page = browser.new_page(viewport={'width': 1920, 'height': 1080})
+
+    # Set up console log capture
+    def handle_console_message(msg):
+        console_logs.append(f"[{msg.type}] {msg.text}")
+        print(f"Console: [{msg.type}] {msg.text}")
+
+    page.on("console", handle_console_message)
+
+    # Navigate to page
+    page.goto(url)
+    page.wait_for_load_state('networkidle')
+
+    # Interact with the page (triggers console logs)
+    page.click('text=Dashboard')
+    page.wait_for_timeout(1000)
+
+    browser.close()
+
+# Save console logs to file
+with open('/mnt/user-data/outputs/console.log', 'w') as f:
+    f.write('\n'.join(console_logs))
+
+print(f"\nCaptured {len(console_logs)} console messages")
+print(f"Logs saved to: /mnt/user-data/outputs/console.log")

package/skills/webapp-testing/examples/element_discovery.py

@@ -0,0 +1,40 @@
+from playwright.sync_api import sync_playwright
+
+# Example: Discovering buttons and other elements on a page
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)
+    page = browser.new_page()
+
+    # Navigate to page and wait for it to fully load
+    page.goto('http://localhost:5173')
+    page.wait_for_load_state('networkidle')
+
+    # Discover all buttons on the page
+    buttons = page.locator('button').all()
+    print(f"Found {len(buttons)} buttons:")
+    for i, button in enumerate(buttons):
+        text = button.inner_text() if button.is_visible() else "[hidden]"
+        print(f"  [{i}] {text}")
+
+    # Discover links
+    links = page.locator('a[href]').all()
+    print(f"\nFound {len(links)} links:")
+    for link in links[:5]:  # Show first 5
+        text = link.inner_text().strip()
+        href = link.get_attribute('href')
+        print(f"  - {text} -> {href}")
+
+    # Discover input fields
+    inputs = page.locator('input, textarea, select').all()
+    print(f"\nFound {len(inputs)} input fields:")
+    for input_elem in inputs:
+        name = input_elem.get_attribute('name') or input_elem.get_attribute('id') or "[unnamed]"
+        input_type = input_elem.get_attribute('type') or 'text'
+        print(f"  - {name} ({input_type})")
+
+    # Take screenshot for visual reference
+    page.screenshot(path='/tmp/page_discovery.png', full_page=True)
+    print("\nScreenshot saved to /tmp/page_discovery.png")
+
+    browser.close()

package/skills/webapp-testing/examples/static_html_automation.py

@@ -0,0 +1,33 @@
+from playwright.sync_api import sync_playwright
+import os
+
+# Example: Automating interaction with static HTML files using file:// URLs
+
+html_file_path = os.path.abspath('path/to/your/file.html')
+file_url = f'file://{html_file_path}'
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)
+    page = browser.new_page(viewport={'width': 1920, 'height': 1080})
+
+    # Navigate to local HTML file
+    page.goto(file_url)
+
+    # Take screenshot
+    page.screenshot(path='/mnt/user-data/outputs/static_page.png', full_page=True)
+
+    # Interact with elements
+    page.click('text=Click Me')
+    page.fill('#name', 'John Doe')
+    page.fill('#email', 'john@example.com')
+
+    # Submit form
+    page.click('button[type="submit"]')
+    page.wait_for_timeout(500)
+
+    # Take final screenshot
+    page.screenshot(path='/mnt/user-data/outputs/after_submit.png', full_page=True)
+
+    browser.close()
+
+print("Static HTML automation completed!")

package/skills/webapp-testing/scripts/with_server.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+"""
+Start one or more servers, wait for them to be ready, run a command, then clean up.
+
+Usage:
+    # Single server
+    python scripts/with_server.py --server "npm run dev" --port 5173 -- python automation.py
+    python scripts/with_server.py --server "npm start" --port 3000 -- python test.py
+
+    # Multiple servers
+    python scripts/with_server.py \
+      --server "cd backend && python server.py" --port 3000 \
+      --server "cd frontend && npm run dev" --port 5173 \
+      -- python test.py
+"""
+
+import subprocess
+import socket
+import time
+import sys
+import argparse
+
+def is_server_ready(port, timeout=30):
+    """Wait for server to be ready by polling the port."""
+    start_time = time.time()
+    while time.time() - start_time < timeout:
+        try:
+            with socket.create_connection(('localhost', port), timeout=1):
+                return True
+        except (socket.error, ConnectionRefusedError):
+            time.sleep(0.5)
+    return False
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Run command with one or more servers')
+    parser.add_argument('--server', action='append', dest='servers', required=True, help='Server command (can be repeated)')
+    parser.add_argument('--port', action='append', dest='ports', type=int, required=True, help='Port for each server (must match --server count)')
+    parser.add_argument('--timeout', type=int, default=30, help='Timeout in seconds per server (default: 30)')
+    parser.add_argument('command', nargs=argparse.REMAINDER, help='Command to run after server(s) ready')
+
+    args = parser.parse_args()
+
+    # Remove the '--' separator if present
+    if args.command and args.command[0] == '--':
+        args.command = args.command[1:]
+
+    if not args.command:
+        print("Error: No command specified to run")
+        sys.exit(1)
+
+    # Parse server configurations
+    if len(args.servers) != len(args.ports):
+        print("Error: Number of --server and --port arguments must match")
+        sys.exit(1)
+
+    servers = []
+    for cmd, port in zip(args.servers, args.ports):
+        servers.append({'cmd': cmd, 'port': port})
+
+    server_processes = []
+
+    try:
+        # Start all servers
+        for i, server in enumerate(servers):
+            print(f"Starting server {i+1}/{len(servers)}: {server['cmd']}")
+
+            # Use shell=True to support commands with cd and &&
+            process = subprocess.Popen(
+                server['cmd'],
+                shell=True,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE
+            )
+            server_processes.append(process)
+
+            # Wait for this server to be ready
+            print(f"Waiting for server on port {server['port']}...")
+            if not is_server_ready(server['port'], timeout=args.timeout):
+                raise RuntimeError(f"Server failed to start on port {server['port']} within {args.timeout}s")
+
+            print(f"Server ready on port {server['port']}")
+
+        print(f"\nAll {len(servers)} server(s) ready")
+
+        # Run the command
+        print(f"Running: {' '.join(args.command)}\n")
+        result = subprocess.run(args.command)
+        sys.exit(result.returncode)
+
+    finally:
+        # Clean up all servers
+        print(f"\nStopping {len(server_processes)} server(s)...")
+        for i, process in enumerate(server_processes):
+            try:
+                process.terminate()
+                process.wait(timeout=5)
+            except subprocess.TimeoutExpired:
+                process.kill()
+                process.wait()
+            print(f"Server {i+1} stopped")
+        print("All servers stopped")
+
+
+if __name__ == '__main__':
+    main()

package/src/orchestrator/builder.ts

@@ -0,0 +1,234 @@
+/**
+ * Prompt builder: assembles the final LLM prompt from all agent sources.
+ * IMH-Code — Imam Hussain Coding Harness Platform
+ *
+ * Assembly order (most authoritative first):
+ *  1. Agent SYSTEM.md
+ *  2. Core skill files (always loaded)
+ *  3. Extended skill files (loaded on demand by keyword match)
+ *  4. Compact project context (.imhcode/context.md if exists)
+ *  5. Task-scoped memory files (only files relevant to this task)
+ *  6. Task description
+ *  7. Acceptance criteria (if provided)
+ *  8. Permissions summary
+ *  9. Quality gates
+ * 10. Category-specific output format
+ */
+
+import * as fs from "fs";
+import * as path from "path";
+import type { LoadedAgent } from "./types";
+
+const DIVIDER = "─".repeat(72);
+
+function section(title: string, content: string): string {
+  return `\n${DIVIDER}\n## ${title}\n${DIVIDER}\n\n${content.trim()}\n`;
+}
+
+// ─── Agent Category → Task-Type Rules ────────────────────────────────────────
+
+/** Maps agent IDs to task categories for targeted prompt instructions */
+const AGENT_CATEGORY_MAP: Record<string, string> = {
+  "planner":              "planning",
+  "designer":             "frontend",
+  "nextjs-executor":      "frontend",
+  "react-executor":       "frontend",
+  "vue-executor":         "frontend",
+  "laravel-executor":     "backend",
+  "python-executor":      "backend",
+  "java-executor":        "backend",
+  "flutter-executor":     "backend",
+  "react-native-executor":"backend",
+  "ios-executor":         "backend",
+  "android-executor":     "backend",
+  "systems-executor":     "backend",
+  "web3-executor":        "backend",
+  "devops-executor":      "backend",
+  "tester":               "testing",
+  "security-auditor":     "testing",
+  "seo-optimizer":        "review",
+  "debugger":             "review",
+};
+
+/** Category-specific output instructions to keep prompts lean and focused */
+const CATEGORY_OUTPUT_RULES: Record<string, string> = {
+  frontend: [
+    "- Focus ONLY on UI/UX, components, styling, and frontend logic.",
+    "- Code MUST be written in `frontend/` directory only.",
+    "- Do NOT touch backend files unless explicitly asked.",
+    "- Produce working, visually excellent code on the first attempt.",
+    "- Use the design system and component library specified in the project.",
+  ].join("\n"),
+
+  backend: [
+    "- Focus ONLY on backend logic, APIs, database, and server-side code.",
+    "- Code MUST be written in `backend/` directory only.",
+    "- Do NOT touch frontend files unless explicitly asked.",
+    "- Follow RESTful conventions and input validation best practices.",
+    "- Write clean, production-ready code — no TODO stubs.",
+  ].join("\n"),
+
+  planning: [
+    "- Produce structured markdown documents only.",
+    "- Think deeply before generating sprint plans — consider dependencies.",
+    "- Generate realistic, achievable tasks (not over-scoped).",
+    "- Include dependency ordering and parallel task opportunities.",
+    "- Save all planning docs to `docs/` directory.",
+  ].join("\n"),
+
+  testing: [
+    "- Focus ONLY on test coverage, security findings, and audit reports.",
+    "- Be thorough and systematic — cover edge cases.",
+    "- Produce actionable reports with severity ratings.",
+    "- Write actual test code, not just descriptions.",
+  ].join("\n"),
+
+  review: [
+    "- Focus on code quality, performance, and correctness.",
+    "- Provide specific, actionable feedback with file references.",
+    "- Check for security issues, performance bottlenecks, and best practice violations.",
+  ].join("\n"),
+};
+
+// ─── Compact Context Loader ───────────────────────────────────────────────────
+
+/**
+ * Load the compact project context from .imhcode/context.md if it exists.
+ * This replaces loading all raw project files and saves ~40% tokens.
+ */
+function loadCompactContext(cwd: string): string | null {
+  const contextPath = path.join(cwd, ".imhcode", "context.md");
+  if (fs.existsSync(contextPath)) {
+    try {
+      return fs.readFileSync(contextPath, "utf-8");
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+// ─── Build Prompt ─────────────────────────────────────────────────────────────
+
+/**
+ * Build the final prompt string that will be sent to the execution engine.
+ * Uses category-specific templates to reduce prompt size by ~40%.
+ */
+export function buildPrompt(
+  agent: LoadedAgent,
+  task: string,
+  acceptanceCriteria?: string,
+  cwd?: string
+): string {
+  const { manifest, systemPrompt, skills, memoryFiles } = agent;
+  const parts: string[] = [];
+
+  // Determine agent category for targeted instructions
+  const category = AGENT_CATEGORY_MAP[manifest.id] ?? "backend";
+
+  // ── 1. Agent Identity Header ──────────────────────────────────────────────
+  parts.push(
+    `# IMH-Code Agent Execution\n\n` +
+      `**Agent**: \`${manifest.id}\`  \n` +
+      `**Role**: ${manifest.role}  \n` +
+      `**Category**: ${category}  \n` +
+      `**Version**: ${manifest.version}`
+  );
+
+  // ── 2. System Prompt ──────────────────────────────────────────────────────
+  parts.push(section("System Prompt", systemPrompt));
+
+  // ── 3. Skill Files (Core + Extended) ─────────────────────────────────────
+  if (skills.length > 0) {
+    const skillsBlock = skills
+      .map(
+        (skill) =>
+          `### Skill: \`${skill.id}\`\n\n${skill.content.trim()}`
+      )
+      .join("\n\n" + "─".repeat(48) + "\n\n");
+
+    parts.push(section(`Loaded Skills (${skills.length})`, skillsBlock));
+  }
+
+  // ── 4. Compact Project Context (token-efficient) ──────────────────────────
+  if (cwd) {
+    const compactContext = loadCompactContext(cwd);
+    if (compactContext) {
+      parts.push(section("Project Context (Compact)", compactContext.trim()));
+    } else if (memoryFiles.length > 0) {
+      // Fall back to memory files if no compact context exists
+      const memoryBlock = memoryFiles
+        .map((mf) => `### File: \`${mf.path}\`\n\n\`\`\`\n${mf.content.trim()}\n\`\`\``)
+        .join("\n\n");
+      parts.push(section(`Project Memory (${memoryFiles.length} files)`, memoryBlock));
+    }
+  } else if (memoryFiles.length > 0) {
+    const memoryBlock = memoryFiles
+      .map((mf) => `### File: \`${mf.path}\`\n\n\`\`\`\n${mf.content.trim()}\n\`\`\``)
+      .join("\n\n");
+    parts.push(section(`Project Memory (${memoryFiles.length} files)`, memoryBlock));
+  }
+
+  // ── 5. Task ───────────────────────────────────────────────────────────────
+  parts.push(section("Task", task));
+
+  // ── 6. Acceptance Criteria ────────────────────────────────────────────────
+  if (acceptanceCriteria && acceptanceCriteria.trim().length > 0) {
+    parts.push(section("Acceptance Criteria", acceptanceCriteria));
+  }
+
+  // ── 7. Permissions ────────────────────────────────────────────────────────
+  const { permissions, memory } = manifest;
+  const permLines = [
+    `- **Read files**: ${permissions.read_files ? "✅ Allowed" : "🚫 Denied"}`,
+    `- **Write files**: ${permissions.write_files ? "✅ Allowed" : "🚫 Denied"}`,
+    `- **Run commands**: ${permissions.run_commands ? "✅ Allowed" : "🚫 Denied"}`,
+    `- **Network access**: ${permissions.network_access ? "✅ Allowed" : "🚫 Denied"}`,
+    "",
+    `**Memory scopes**: ${memory.scopes.join(", ")}`,
+    memory.writable.length > 0
+      ? `**Writable paths**: ${memory.writable.map((p) => `\`${p}\``).join(", ")}`
+      : "",
+  ]
+    .filter(Boolean)
+    .join("\n");
+
+  parts.push(section("Permissions & Memory", permLines));
+
+  // ── 8. Quality Gates ─────────────────────────────────────────────────────
+  if (manifest.quality_gates.length > 0) {
+    const gateLines = manifest.quality_gates
+      .map((gate) =>
+        Object.entries(gate)
+          .map(([k, v]) => `- **${k}**: ${v}`)
+          .join("\n")
+      )
+      .join("\n");
+
+    parts.push(section("Quality Gates (all must pass)", gateLines));
+  }
+
+  // ── 9. Category-Specific Output Rules ────────────────────────────────────
+  const categoryRules = CATEGORY_OUTPUT_RULES[category] ?? CATEGORY_OUTPUT_RULES["backend"];
+  const outputLines = [
+    `**Category**: ${category}`,
+    `**Format**: ${manifest.output.format}`,
+    `**Task types**: ${manifest.supported_task_types.join(", ")}`,
+    "",
+    "**Rules for this task:**",
+    categoryRules,
+  ].join("\n");
+
+  parts.push(section("Output Requirements", outputLines));
+
+  // ── 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 planning and documentation → \`docs/\` directory ONLY.`,
+    `- NEVER create application code at the workspace root. Keep root clean.`,
+  ].join("\n");
+  parts.push(section("Codebase Containment Rules", containmentRules));
+
+  return parts.join("\n");
+}