imlil 1.0.1

package/.eslintrc.cjs

@@ -0,0 +1,40 @@
+module.exports = {
+  env: {
+    browser: true,
+    es2021: true,
+    node: true,
+  },
+  extends: 'airbnb-base',
+  overrides: [
+    {
+      env: {
+        node: true,
+      },
+      files: [
+        '.eslintrc.{js,cjs}',
+      ],
+      parserOptions: {
+        sourceType: 'script',
+      },
+    },
+    {
+      files: ['src/**/*.test.js'],
+      env: {
+        jest: true,
+      },
+    },
+  ],
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+  },
+  rules: {
+    'import/extensions': ['error', 'ignorePackages'],
+    'max-len': 'off',
+    'no-console': 'off',
+    'no-restricted-syntax': 'off',
+    'no-await-in-loop': 'off',
+    'no-continue': 'off',
+    'prefer-destructuring': 'off',
+  },
+};

package/DOCS.md

@@ -0,0 +1,63 @@
+# `imlil` Documentation
+
+This document provides a deeper dive into the architecture and functionality of `imlil`.
+
+## Architecture
+
+`imlil` uses a multi-agent system to build projects. The main agents are:
+
+-   **Supervisor Agent**: This is the project manager. It takes the user's initial prompt, creates a plan, and delegates tasks to Operator agents.
+-   **Operator Agent**: This agent is responsible for executing a specific task from the plan. It uses the AI model to generate the code or commands needed to complete the task.
+-   **Coder Agent**: This agent is specialized in writing and modifying code. It receives instructions from the Operator and performs file system operations.
+
+### The Flow
+
+1.  The user runs `imlil make "..."`.
+2.  The `SupervisorAgent` is instantiated.
+3.  The `SupervisorAgent` creates a high-level plan using the AI model.
+4.  The plan is broken down into a series of tasks.
+5.  The `SupervisorAgent` assigns tasks to `Operator` agents, up to `maxAgents`.
+6.  Each `Operator` agent uses the AI model to generate a sequence of actions (like `writeFile`, `gitCommit`, etc.) to complete its task.
+7.  The actions are executed by the `Coder` agent.
+8.  The process continues until all tasks are completed.
+
+## Configuration (`imlil.config.js`)
+
+-   **`mode`**: Can be `'yolo'` or `'safe'`. In `yolo` mode, the agents are given more freedom to experiment. `'safe'` mode will be more conservative. (Note: `'safe'` mode is not yet fully implemented).
+-   **`maxAgents`**: An integer that determines how many agents can run in parallel. This is useful for controlling API usage and resource consumption.
+-   **`cliPersonality`**: A system prompt that is prepended to every call to the AI model. This allows you to customize the personality and tone of the CLI's output and behavior.
+
+## Agents in Detail
+
+### `SupervisorAgent.js`
+
+-   **Purpose**: To manage the overall project creation process.
+-   **Key Methods**:
+    -   `run()`: The main entry point. It creates a plan and starts assigning tasks.
+    -   `createPlan()`: Interacts with the AI to get a structured plan.
+    -   `assignTask()`: Creates and dispatches an `Operator` agent for a task.
+
+### `Operator.js`
+
+-   **Purpose**: To execute a single task from the plan.
+-   **Key Methods**:
+    -   `run()`: Takes a task and generates a series of actions to complete it.
+    -   `executeAction()`: Executes a single action, like writing a file or running a command.
+
+### `coder.js`
+
+-   **Purpose**: A specialized agent for code generation and modification.
+-   **Key Methods**:
+    -   `run()`: Takes a task and generates code.
+    -   `executeAction()`: Interacts with the `Action.js` toolkit to modify the filesystem.
+
+## The Action Toolkit (`Action.js`)
+
+This class provides a set of methods that agents can use to interact with the user's system. It's a layer of abstraction over the filesystem and git.
+
+-   `writeFile(filePath, content)`
+-   `readFile(filePath)`
+-   `gitAdd(files)`
+-   `gitCommit(message)`
+
+This architecture allows for extending the tool's capabilities by adding new actions and new types of agents.

package/README.md

@@ -0,0 +1,160 @@
+# imlil.dev: Your CTO in a box.
+
+
+### 🚀 100+ Agents. 60 Seconds. Zero Limits.
+
+**One CLI. One API Key. Infinite Staff.**
+
+[![npm version](https://img.shields.io/npm/v/imlil.svg?style=flat-square)](https://www.npmjs.com/package/imlil)
+[![Methodology: TDD](https://img.shields.io/badge/Methodology-TDD%20Strict-red.svg?style=flat-square)](https://imlil.dev/docs/tdd)
+[![SaaS: Premium](https://img.shields.io/badge/Model-Pay%20As%20You%20Go-green.svg?style=flat-square)](https://imlil.dev/pricing)
+[![Concurrency: Unlimited](https://img.shields.io/badge/Staffing-Unlimited-blue.svg?style=flat-square)](https://imlil.dev/docs)
+
+---
+
+**imlil.dev is the first High-Velocity AI Firm that lives in your terminal.**
+
+Forget "coding assistants." You need a **team**.
+**imlil** gives you a **CTO, Engineering Managers, Scrum Masters, Senior Devs, and QA Leads**—all working in parallel.
+
+**10 Agents? 100 Agents? 1,000 Agents?**
+There is no limit. If you have the tokens, we have the staff.
+Build a full-stack SaaS (Backend + Frontend + Infra) in **60 seconds flat**.
+
+---
+
+## 👥 Meet Your New Employees
+
+When you run `imlil make`, you are hiring a specialized, autonomous workforce:
+
+### 1. **The Supervisor (CTO)**
+*   **Role:** Architect & Planner.
+*   **Job:** Designs the system, selects the stack (e.g., Next.js, Rust, Python), and maps out the entire project structure.
+*   **Output:** A master architectural plan.
+
+### 2. **The Operator (Engineering Manager)**
+*   **Role:** Task Orchestrator.
+*   **Job:** Breaks the CTO's plan into hundreds of parallel tickets. Assigns them to the worker pool.
+
+### 3. **The Scrum Master (Agile Coach)**
+*   **Role:** Flow Optimizer.
+*   **Job:** Unblocks agents, manages retries, and ensures velocity remains high.
+
+### 4. **The Coder (Senior Developer)**
+*   **Role:** Implementation Specialist.
+*   **Job:** Writes clean, idiomatic code.
+*   **Superpower:** **Surgical Precision.** Unlike other tools that overwrite files blindly, The Coder reads your codebase's structure and inserts changes without breaking existing logic.
+
+### 5. **The Validator (QA Lead)**
+*   **Role:** The Gatekeeper.
+*   **Job:** Enforces **Strict TDD**.
+    1.  Writes a failing test.
+    2.  Verifies the failure.
+    3.  Approves the Coder's work *only* if the test passes.
+
+---
+
+## ⚡ Why Hire This Team?
+
+### 1. **Unlimited Parallel Concurrency**
+Why wait for one developer? **imlil** spawns an army.
+*   **Scale:** Run **50+ agents** simultaneously.
+*   **Speed:** Build a full-stack SaaS in minutes, not weeks.
+*   **Infrastructure:** True multi-threaded execution for maximum throughput.
+
+### 2. **Bleeding-Edge Intelligence (EmbedAPI)**
+Your team uses the absolute latest research models, updated automatically.
+
+**Currently Supported (2026):**
+*   ⚡ **Gemini 3 Flash** (The fastest inference engine on the market)
+*   🧠 **Gemini 3 Pro** (Unmatched reasoning and context)
+*   🤖 **Claude 4.6 (Opus/Sonnet)** (Best-in-class coding & agentic behavior)
+*   🚀 **GPT-5.3-Codex** (The new gold standard for software engineering)
+
+### 3. **Context-Aware Memory**
+Your team never forgets. They map your entire project's DNA before writing a single line of code, ensuring every file fits the architecture perfectly.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install -g imlil
+```
+
+## 🔑 Setup
+
+1.  **Get your Universal API Key:**
+    Sign up at [https://imlil.dev](https://imlil.dev).
+    > **⚠️ Note:** There is **no free plan**. This is enterprise-grade tooling.
+
+2.  **Authenticate:**
+    ```bash
+    export EMBED_API_KEY="your-key-here"
+    ```
+
+---
+
+## 🛠️ Usage
+
+### The `make` Command
+Issue a contract to your new digital firm.
+
+```bash
+# Contract: Build a SaaS Dashboard with 20 staff members
+imlil make "A modern SaaS dashboard with Next.js 14, Tailwind, Supabase, and Stripe integration" --max-agents 20
+```
+
+### Options
+*   `--max-agents <number>`: Staffing level. Default `10`. Increase for speed, decrease for cost efficiency.
+*   `--debug`: Audit the internal Slack channels (logs) of your agents.
+
+---
+
+## 💻 Development
+
+### Scripts
+
+*   `npm test`: Runs the test suite.
+*   `npm run lint`: Lints the codebase.
+
+---
+
+## 💎 Pricing: Pay-As-You-Go
+
+**imlil** operates on a transparent, usage-based model via **EmbedAPI**.
+
+*   **No Salaries:** You don't pay fixed monthly costs.
+*   **Token-Based:** Pay only for the compute (tokens) your team consumes.
+*   **Direct Pass-Through:** We provide the infrastructure; you provide the fuel.
+
+*Check [imlil.dev/pricing](https://imlil.dev/pricing) for current rates.*
+
+---
+
+## 🏗️ The Org Chart
+
+```mermaid
+graph TD;
+    Client[User] -->|Goal| Supervisor[Supervisor (CTO)];
+    Supervisor -->|Plan| Operator[Operator (Manager)];
+    Operator -->|Tasks| Backlog[Task Queue];
+    
+    subgraph Swarm [The Worker Pool]
+        Scrum[Scrum Master] -->|Assigns| Coder[Coder];
+        Coder -->|Code| Validator[QA Lead];
+        Validator -->|TDD Check| Coder;
+        Validator -->|Pass| Done[Done];
+    end
+    
+    Backlog --> Scrum;
+```
+
+---
+
+## 📜 License
+
+Copyright © 2026 **imlil.dev**. All rights reserved.
+Released under the MIT License.
+
+> *"You define the product. We build the company that builds it."*

package/agentTestSandbox/cli-test-zone/imlil.blueprint.json

@@ -0,0 +1,5 @@
+{
+  "fileStructure": "src/\n  ├── components/\n  │   ├── TodoList/\n  │   ├── TodoItem/\n  │   ├── AddTodo/\n  │   └── Navigation/\n  ├── store/\n  │   └── todoSlice/\n  ├── utils/\n  └── styles/",
+  "conventions": "- Components: PascalCase (e.g., TodoList.jsx)\n- Hooks: camelCase prefixed with 'use' (e.g., useLocalStorage)\n- Utils: camelCase\n- CSS Modules: ComponentName.module.css\n- Tests: ComponentName.test.jsx in same directory as component",
+  "techStack": "- React 18\n- React Router DOM\n- Local Storage for state persistence\n- CSS Modules for styling\n- PropTypes for type checking"
+}

package/agentTestSandbox/cli-test-zone/notes-warning.md

@@ -0,0 +1,3 @@
+# IMLIL Supervisor Notes
+
+This is where I'll drop any warnings or important notes for you.

package/agentTestSandbox/cli-test-zone/src/App.jsx

@@ -0,0 +1,29 @@
+import React from 'react';
+import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';
+import Navigation from './components/Navigation/Navigation';
+import TodoList from './components/TodoList/TodoList';
+
+const Home = () => (
+  <div>
+    <h1>Welcome to Todo App</h1>
+    <p>Manage your tasks efficiently</p>
+  </div>
+);
+
+const App = () => {
+  return (
+    <Router>
+      <div>
+        <Navigation />
+        <main>
+          <Routes>
+            <Route path="/" element={<Home />} />
+            <Route path="/todos" element={<TodoList />} />
+          </Routes>
+        </main>
+      </div>
+    </Router>
+  );
+};
+
+export default App;

package/agentTestSandbox/cli-test-zone/src/__tests__/App.test.jsx

@@ -0,0 +1,48 @@
+
+import { render, screen } from '@testing-library/react';
+import { BrowserRouter as Router, Routes, Route, MemoryRouter } from 'react-router-dom';
+import { viretest } from 'vitest';
+import App from '../App';
+
+describe('App Router Configuration', () => {
+  it('should render the home page by default', () => {
+    render(
+      <MemoryRouter initialEntries={['/']}>
+        <App />
+      </MemoryRouter>
+    );
+    expect(screen.getByTestId('home-page')).toBeInTheDocument();
+  });
+
+  it('should render the todo list page when navigating to /todos', () => {
+    render(
+      <MemoryRouter initialEntries={['/todos']}>
+        <App />
+      </MemoryRouter>
+    );
+    expect(screen.getByTestId('todo-list-page')).toBeInTheDocument();
+  });
+
+  it('should display 404 page for unknown routes', () => {
+    render(
+      <MemoryRouter initialEntries={[/invalid-route/]}>
+        <App />
+      </MemoryRouter>
+    );
+    expect(screen.getByTestId('not-found-page')).toBeInTheDocument();
+  });
+
+  it('should have navigation links for home and todo list', () => {
+    render(
+      <MemoryRouter>
+        <App />
+      </MemoryRouter>
+    );
+
+    const homeLink = screen.getByRole('link', { name: /home/i });
+    const todosLink = screen.getByRole('link', { name: /todos/i });
+
+    expect(homeLink).toBeInTheDocument();
+    expect(todosLink).toBeInTheDocument();
+  });
+});

package/agentTestSandbox/cli-test-zone/src/components/Navigation/Navigation.jsx

@@ -0,0 +1,48 @@
+import React from 'react';
+import { NavLink } from 'react-router-dom';
+import PropTypes from 'prop-types';
+import styles from './Navigation.module.css';
+
+const Navigation = () => {
+  return (
+    <nav className={styles.navigation}>
+      <ul className={styles.navList}>
+        <li>
+          <NavLink
+            to="/"
+            className={({ isActive }) =>
+              `${styles.navLink} ${isActive ? styles.active : ''}`
+            }
+            end={true}
+          >
+            Home
+          </NavLink>
+        </li>
+        <li>
+          <NavLink
+            to="/active"
+            className={({ isActive }) =>
+              `${styles.navLink} ${isActive ? styles.active : ''}`
+            }
+          >
+            Active
+          </NavLink>
+        </li>
+        <li>
+          <NavLink
+            to="/completed"
+            className={({ isActive }) =>
+              `${styles.navLink} ${isActive ? styles.active : ''}`
+            }
+          >
+            Completed
+          </NavLink>
+        </li>
+      </ul>
+    </nav>
+  );
+};
+
+Navigation.propTypes = {};
+
+export default Navigation;

package/agentTestSandbox/cli-test-zone/src/components/Navigation/__tests__/Navigation.module.test.js

@@ -0,0 +1,45 @@
+import React from 'react';
+import { render } from '@testing-library/react';
+import styles from '../Navigation.module.css';
+
+// Mock the CSS module
+jest.mock('../Navigation.module.css', () => ({
+  nav: 'nav',
+  link: 'link',
+  active: 'active'
+}));
+
+describe('CSS Modules - Navigation Styles', () => {
+  it('should have the correct CSS module styles', () => {
+    // Verify that the styles object has the expected properties
+    expect(styles).toHaveProperty('nav');
+    expect(styles).toHaveProperty('link');
+    expect(styles).toHaveProperty('active');
+  });
+
+  it('should apply styles properly to Navigation component', () => {
+    const { container } = render(
+      <nav className={styles.nav}>
+        <a className={styles.link}>Link</a>
+      </nav>
+    );
+
+    // Verify that the classes are applied
+    const navElement = container.querySelector('nav');
+    const linkElement = container.querySelector('a');
+
+    expect(navElement).toHaveClass(styles.nav);
+    expect(linkElement).toHaveClass(styles.link);
+  });
+
+  it('should apply active styles when active class is added', () => {
+    const { container } = render(
+      <nav className={styles.nav}>
+        <a className={`${styles.link} ${styles.active}`}>Active Link</a>
+      </nav>
+    );
+
+    const activeLink = container.querySelector('a');
+    expect(activeLink).toHaveClass(styles.active);
+  });
+});

package/agentTestSandbox/cli-test-zone/src/components/Navigation/__tests__/Navigation.test.jsx

@@ -0,0 +1,47 @@
+import { render, screen } from '@testing-library/react';
+import { BrowserRouter as Router } from 'react-router-dom';
+import Navigation from '../Navigation';
+
+describe('Navigation Component', () => {
+  const renderWithRouter = () => {
+    render(
+      <Router>
+        <Navigation />
+      </Router>
+    );
+  };
+
+  it('renders without crashing', () => {
+    expect(() => renderWithRouter()).not.toThrow();
+  });
+
+  it('displays the home link', () => {
+    renderWithRouter();
+    const homeLink = screen.getByRole('link', { name: /Home/i });
+    expect(homeLink).toBeInTheDocument();
+  });
+
+  it('displays the active todos link', () => {
+    renderWithRouter();
+    const activeLink = screen.getByRole('link', { name: /Active/i });
+    expect(activeLink).toBeInTheDocument();
+  });
+
+  it('displays the completed todos link', () => {
+    renderWithRouter();
+    const completedLink = screen.getByRole('link', { name: /Completed/i });
+    expect(completedLink).toBeInTheDocument();
+  });
+
+  it('has accessible navigation', () => {
+    renderWithRouter();
+    const nav = screen.getByRole('navigation');
+    expect(nav).toBeInTheDocument();
+  });
+
+  it('has accessible landmark', () => {
+    renderWithRouter();
+    const nav = screen.getByRole('navigation');
+    expect(nav).toHaveAttribute('aria-label', 'main navigation');
+  });
+});

package/agentTestSandbox/cli-test-zone/src/components/TodoItem/TodoItem.jsx

@@ -0,0 +1,41 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+import styles from './TodoItem.module.css';
+
+const TodoItem = ({ id, text, completed, onToggle, onDelete }) => {
+  return (
+    <div className={styles.todoItem}>
+      <div className={styles.content}>
+        <label className={styles.checkboxLabel}>
+          <input
+            type="checkbox"
+            checked={completed}
+            onChange={() => onToggle(id)}
+            className={styles.checkbox}
+          />
+          <span className={`${styles.text} ${completed ? styles.completed : ''}`}>
+            {text}
+          </span>
+        </label>
+      </div>
+      <button
+        type="button"
+        onClick={() => onDelete(id)}
+        className={styles.deleteButton}
+        aria-label="Delete todo"
+      >
+        <span aria-hidden="true">×</span>
+      </button>
+    </div>
+  );
+};
+
+TodoItem.propTypes = {
+  id: PropTypes.string.isRequired,
+  text: PropTypes.string.isRequired,
+  completed: PropTypes.bool.isRequired,
+  onToggle: PropTypes.func.isRequired,
+  onDelete: PropTypes.func.isRequired
+};
+
+export default TodoItem;

package/agentTestSandbox/cli-test-zone/src/components/TodoItem/__tests__/TodoItem.test.jsx

@@ -0,0 +1,65 @@
+import React from 'react';
+import { render, screen, fireEvent } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import TodoItem from '../TodoItem';
+
+const mockTodo = {
+  id: '123',  
+  text: 'Buy groceries',
+  completed: false
+};
+
+const mockOnToggle = jest.fn();
+const mockOnDelete = jest.fn();
+
+const setup = (props = {}) => {
+  return render(
+    <TodoItem
+      todo={mockTodo}
+      onToggle={mockOnToggle}
+      onDelete={mockOnDelete}
+      {...props}
+    />
+  });
+};
+
+describe('TodoItem', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('renders todo text', () => {
+    setup();
+    expect(screen.getByText('Buy groceries')).toBeInTheDocument();
+  });
+
+  it('renders checkbox with correct checked state', () => {
+    setup();
+    const checkbox = screen.getByRole('checkbox');
+    expect(checkbox).toBeInTheDocument();
+    expect(checkbox).not.toBeChecked();
+  });
+
+  it('calls onToggle when checkbox is clicked', async () => {
+    setup();
+    const checkbox = screen.getByRole('checkbox');
+    await userEvent.click(checkbox);
+    expect(mockOnToggle).toHaveBeenCalledWith('123');
+  });
+
+  it('calls onDelete when delete button is clicked', async () => {
+    setup();
+    const deleteButton = screen.getByRole('button', { name: /delete/i });
+    await userEvent.click(deleteButton);
+    expect(mockOnDelete).toHaveBeenCalledWith('123');
+  });
+
+  it('applies completed style when todo is completed', () => {
+    const completedTodo = { ...mockTodo, completed: true };
+    setup({ todo: completedTodo });
+    const todoText = screen.getByText('Buy groceries');
+    expect(todoText).toHaveStyle({
+      textDecoration: 'line-through'
+    });
+  });
+});

package/agentTestSandbox/cli-test-zone/src/components/TodoList/TodoList.module.css

@@ -0,0 +1,62 @@
+.listContainer {
+  width: 100%;
+  max-width: 600px;
+  margin: 0 auto;
+  padding: 20px;
+}
+
+.todoList {
+  list-style: none;
+  padding: 0;
+  margin: 20px 0;
+}
+
+.todoItem {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 10px 15px;
+  margin-bottom: 8px;
+  background-color: #fff;
+  border-radius: 4px;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+  transition: all 0.3s ease;
+}
+
+.todoItem:hover {
+  box-shadow: 0 4px 8px rgba(0, 0, 0, 0.15);
+  transform: translateY(-1px);
+}
+
+.completed {
+  background-color: #f0f0f0;
+  text-decoration: line-through;
+  color: #888;
+}
+
+.actions {
+  display: flex;
+  gap: 10px;
+}
+
+.button {
+  padding: 6px 12px;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  transition: background-color 0.2s ease;
+}
+
+.deleteButton {
+  background-color: #ff4444;
+  color: white;
+}
+
+.deleteButton:hover {
+  background-color: #ee2222;
+}
+
+.checkbox {
+  margin-right: 10px;
+  cursor: pointer;
+}