@laurentenhoor/devclaw 0.1.0 → 1.0.0

package/README.md

@@ -6,7 +6,20 @@
 
 **Turn any group chat into a dev team that ships.**
 
-DevClaw is a plugin for [OpenClaw](https://openclaw.ai) that turns your orchestrator agent into a development manager. It hires developers, assigns tasks, reviews code, and keeps the pipeline moving — across as many projects as you have group chats. [Get started →](#getting-started)
+DevClaw is a plugin for [OpenClaw](https://openclaw.ai) that turns your orchestrator agent into a development manager. It hires developers, assigns tasks, reviews code, and keeps the pipeline moving — across as many projects as you have group chats.
+
+**Prerequisites:** [OpenClaw](https://openclaw.ai) must be installed and running.
+
+```bash
+openclaw plugins install @laurentenhoor/devclaw
+```
+
+Then start onboarding by chatting with your agent in any channel:
+```
+"Hey, can you help me set up DevClaw?"
+```
+
+[Read more on onboarding →](#getting-started)
 
 ---
 
@@ -320,6 +333,49 @@ Deployment steps, test commands, coding standards, acceptance criteria — all i
 
 ---
 
+## The orchestrator's role
+
+The orchestrator is a **planner and dispatcher** — not a coder. This separation is intentional and enforced.
+
+### What the orchestrator does
+
+- **Plans**: Analyzes requirements, breaks down work, decides priorities
+- **Dispatches**: Creates issues, assigns developer levels, starts workers
+- **Coordinates**: Monitors queue, handles status checks, answers questions
+- **Reads**: Can inspect code to understand context (but never writes)
+
+### What goes through workers
+
+All implementation work flows through the issue → worker pipeline:
+
+| Action | Goes through worker? | Why |
+|---|---|---|
+| Writing or editing code | ✅ Yes | Audit trail, tier selection |
+| Git operations (commits, branches, PRs) | ✅ Yes | Workers own their worktrees |
+| Running tests | ✅ Yes | Part of the dev/QA workflow |
+| Fixing bugs | ✅ Yes | Even quick fixes need tracking |
+| Refactoring | ✅ Yes | Sonnet/Opus for complexity |
+| Reading code to answer questions | ❌ No | Orchestrator can read |
+| Creating issues | ❌ No | Orchestrator's job |
+| Status checks | ❌ No | Orchestrator's job |
+| Architecture discussions | ❌ No | Orchestrator's job |
+
+### Why this boundary exists
+
+1. **Audit trail** — Every code change links to an issue. You can trace any line of code back to a tracked task.
+
+2. **Right model for the job** — A typo fix uses Haiku (~$0.001). A migration uses Opus (~$0.20). Without tier selection, you're either overpaying or underperforming on every task.
+
+3. **Parallelization** — While workers code, the orchestrator stays free to handle new requests, answer questions, create more issues. No bottleneck.
+
+4. **QA pipeline** — Code goes through review before merging. Skip the worker pipeline, skip QA.
+
+5. **Session reuse** — Workers accumulate codebase context over multiple tasks. The orchestrator starting fresh every time wastes tokens.
+
+The orchestrator saying "I'll just make this quick fix myself" is like a manager saying "I'll just write that feature instead of assigning it." Technically possible, but it breaks the system that makes everything else work.
+
+---
+
 ## Getting started
 
 ### Prerequisites
@@ -331,7 +387,17 @@ Deployment steps, test commands, coding standards, acceptance criteria — all i
 ### Install
 
 ```bash
-cp -r devclaw ~/.openclaw/extensions/
+openclaw plugins install @laurentenhoor/devclaw
+```
+
+Or for local development:
+```bash
+openclaw plugins install -l ./devclaw
+```
+
+Start onboarding:
+```bash
+openclaw chat "Help me set up DevClaw"
 ```
 
 ### Set up through conversation

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAc7D,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwEI,iBAAiB;CAgChC,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAe7D,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwEI,iBAAiB;CAmChC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -8,6 +8,7 @@ import { createHealthTool } from "./lib/tools/health.js";
 import { createProjectRegisterTool } from "./lib/tools/project-register.js";
 import { createSetupTool } from "./lib/tools/setup.js";
 import { createOnboardTool } from "./lib/tools/onboard.js";
+import { createAutoConfigureModelsTool } from "./lib/tools/autoconfigure-models.js";
 import { registerCli } from "./lib/cli.js";
 import { registerHeartbeatService } from "./lib/services/heartbeat.js";
 const plugin = {
@@ -94,13 +95,16 @@ const plugin = {
         });
         api.registerTool(createSetupTool(api), { names: ["setup"] });
         api.registerTool(createOnboardTool(api), { names: ["onboard"] });
+        api.registerTool(createAutoConfigureModelsTool(api), {
+            names: ["autoconfigure_models"],
+        });
         // CLI
         api.registerCli(({ program }) => registerCli(program, api), {
             commands: ["devclaw"],
         });
         // Services
         registerHeartbeatService(api);
-        api.logger.info("DevClaw plugin registered (10 tools, 1 CLI command group, 1 service)");
+        api.logger.info("DevClaw plugin registered (11 tools, 1 CLI command group, 1 service)");
     },
 };
 export default plugin;

package/dist/index.js.map

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

package/dist/lib/onboarding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../lib/onboarding.ts"],"names":[],"mappings":"AAaA,wBAAgB,kBAAkB,CAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAGT;AAED,wBAAsB,iBAAiB,CACrC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAkBD,wBAAgB,oBAAoB,CAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,CAgBR;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAkEhD"}
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../lib/onboarding.ts"],"names":[],"mappings":"AAaA,wBAAgB,kBAAkB,CAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAGT;AAED,wBAAsB,iBAAiB,CACrC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAwBD,wBAAgB,oBAAoB,CAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,CAgBR;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAmHhD"}

package/dist/lib/onboarding.js

@@ -96,13 +96,29 @@ Ask: "Do you want to configure DevClaw for the current agent, or create a new de
      - If none selected, user can add bindings manually later via openclaw.json
 
 **Step 2: Model Configuration**
-Show the default level-to-model mapping and ask if they want to customize:
 
-| Role | Level | Default Model | Purpose |
-|------|-------|---------------|---------|
-${modelTable}
+1. **Call \`autoconfigure_models\`** to automatically discover and assign models:
+   - Discovers all authenticated models in OpenClaw
+   - Uses AI to intelligently assign them to DevClaw roles
+   - Returns a ready-to-use model configuration
+
+2. **Handle the result**:
+   - If \`success: false\` and \`modelCount: 0\`:
+     - **BLOCK setup** - show the authentication instructions from the message
+     - **DO NOT proceed** - exit onboarding until user configures API keys
+   - If \`success: true\`:
+     - Present the model assignment table to the user
+     - Store the \`models\` object for Step 3
+
+3. **Optional: Prefer specific provider**
+   - If user wants only models from one provider (e.g., "only use Anthropic"):
+   - Call \`autoconfigure_models({ preferProvider: "anthropic" })\`
 
-If the defaults are fine, proceed. If customizing, ask which levels to change.
+4. **Confirm with user**
+   - Ask: "Does this look good, or would you like to customize any roles?"
+   - If approved → proceed to Step 3 with the \`models\` configuration
+   - If they want changes → ask which specific roles to modify
+   - If they want different provider → go back to step 3
 
 **Step 3: Run Setup**
 Call \`setup\` with the collected answers:
@@ -110,11 +126,44 @@ Call \`setup\` with the collected answers:
 - New agent: \`setup({ newAgentName: "<name>", channelBinding: "telegram"|"whatsapp"|null, migrateFrom: "<agentId>"|null, models: { ... } })\`
   - \`migrateFrom\`: Include if user wants to migrate an existing channel-wide binding
 
-**Step 4: Optional Project Registration**
-After setup, ask: "Would you like to register a project now?"
+**Step 4: Telegram Group Setup (IMPORTANT)**
+After setup completes, explain project isolation best practices:
+
+📱 **Telegram Group Guidance:**
+DevClaw uses **one Telegram group per project** for isolation and clean backlogs.
+
+**Recommended Setup:**
+1. **Create a new Telegram group** for each project
+2. **Add your bot** to the group
+3. **Use mentions** to interact: "@botname status", "@botname pick up #42"
+4. Each group gets its own queue, workers, and audit log
+
+**Why separate groups?**
+- Clean issue backlogs per project
+- Isolated worker state (no cross-project confusion)
+- Clear audit trails
+- Team-specific access control
+
+**Single-project mode:**
+If you REALLY want all projects in one group (not recommended):
+- You can register multiple projects to the same group ID
+- ⚠️ WARNING: Shared queues, workers will see all issues
+- Only use this for personal/solo projects
+
+Ask: "Do you understand the group-per-project model, or do you want single-project mode?"
+- Most users should proceed with the recommended approach
+- Only force single-project if they insist
+
+**Step 5: Project Registration**
+Ask: "Would you like to register a project now?"
 If yes, collect: project name, repo path, Telegram group ID, group name, base branch.
 Then call \`project_register\`.
 
+💡 **Tip**: For the Telegram group ID:
+- Add the bot to your group
+- Send any message with the bot mentioned
+- Bot can tell you the group ID
+
 ## Guidelines
 - Be conversational and friendly. Ask one question at a time.
 - Show defaults so the user can accept them quickly.

package/dist/lib/onboarding.js.map

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

package/dist/lib/setup/llm-model-selector.d.ts

@@ -0,0 +1,19 @@
+export type ModelAssignment = {
+    dev: {
+        junior: string;
+        medior: string;
+        senior: string;
+    };
+    qa: {
+        reviewer: string;
+        tester: string;
+    };
+};
+/**
+ * Use an LLM to intelligently select and assign models to DevClaw roles.
+ */
+export declare function selectModelsWithLLM(availableModels: Array<{
+    model: string;
+    provider: string;
+}>, sessionKey?: string): Promise<ModelAssignment | null>;
+//# sourceMappingURL=llm-model-selector.d.ts.map

package/dist/lib/setup/llm-model-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-model-selector.d.ts","sourceRoot":"","sources":["../../../lib/setup/llm-model-selector.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,EAAE,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAC3D,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAgIjC"}

package/dist/lib/setup/llm-model-selector.js

@@ -0,0 +1,123 @@
+/**
+ * llm-model-selector.ts — LLM-powered intelligent model selection.
+ *
+ * Uses an LLM to understand model capabilities and assign optimal models to DevClaw roles.
+ */
+import { execSync } from "node:child_process";
+import { writeFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+/**
+ * Use an LLM to intelligently select and assign models to DevClaw roles.
+ */
+export async function selectModelsWithLLM(availableModels, sessionKey) {
+    if (availableModels.length === 0) {
+        return null;
+    }
+    // If only one model, assign it to all roles
+    if (availableModels.length === 1) {
+        const model = availableModels[0].model;
+        return {
+            dev: { junior: model, medior: model, senior: model },
+            qa: { reviewer: model, tester: model },
+        };
+    }
+    // Create a prompt for the LLM
+    const modelList = availableModels.map((m) => m.model).join("\n");
+    const prompt = `You are an AI model expert. Analyze the following authenticated AI models and assign them to DevClaw development roles based on their capabilities.
+
+Available models:
+${modelList}
+
+Assign models to these roles based on capability:
+- **senior** (most capable): Complex architecture, refactoring, critical decisions
+- **medior** (balanced): Features, bug fixes, code review
+- **junior** (fast/efficient): Simple fixes, testing, routine tasks
+- **reviewer** (same as medior): Code review
+- **tester** (same as junior): Testing
+
+Rules:
+1. Prefer same provider for consistency
+2. Assign most capable model to senior
+3. Assign mid-tier model to medior/reviewer
+4. Assign fastest/cheapest model to junior/tester
+5. Consider model version numbers (higher = newer/better)
+6. Stable versions (no date) > snapshot versions (with date like 20250514)
+
+Return ONLY a JSON object in this exact format (no markdown, no explanation):
+{
+  "dev": {
+    "junior": "provider/model-name",
+    "medior": "provider/model-name",
+    "senior": "provider/model-name"
+  },
+  "qa": {
+    "reviewer": "provider/model-name",
+    "tester": "provider/model-name"
+  }
+}`;
+    // Write prompt to temp file for safe passing to shell
+    const tmpFile = join(tmpdir(), `devclaw-model-select-${Date.now()}.txt`);
+    writeFileSync(tmpFile, prompt, "utf-8");
+    try {
+        // Call openclaw agent using current session context if available
+        const sessionFlag = sessionKey
+            ? `--session-id "${sessionKey}"`
+            : `--session-id devclaw-model-selection`;
+        const result = execSync(`openclaw agent --local ${sessionFlag} --message "$(cat ${tmpFile})" --json`, {
+            encoding: "utf-8",
+            timeout: 30000,
+            stdio: ["pipe", "pipe", "ignore"],
+        }).trim();
+        // Parse the response from openclaw agent --json
+        const lines = result.split("\n");
+        const jsonStartIndex = lines.findIndex((line) => line.trim().startsWith("{"));
+        if (jsonStartIndex === -1) {
+            throw new Error("No JSON found in LLM response");
+        }
+        const jsonString = lines.slice(jsonStartIndex).join("\n");
+        // openclaw agent --json returns: { payloads: [{ text: "```json\n{...}\n```" }], meta: {...} }
+        const response = JSON.parse(jsonString);
+        if (!response.payloads || !Array.isArray(response.payloads) || response.payloads.length === 0) {
+            throw new Error("Invalid openclaw agent response structure - missing payloads");
+        }
+        // Extract text from first payload
+        const textContent = response.payloads[0].text;
+        if (!textContent) {
+            throw new Error("Empty text content in openclaw agent payload");
+        }
+        // Strip markdown code blocks (```json and ```)
+        const cleanJson = textContent
+            .replace(/```json\n?/g, '')
+            .replace(/```\n?/g, '')
+            .trim();
+        // Parse the actual model assignment JSON
+        const assignment = JSON.parse(cleanJson);
+        // Log what we got for debugging
+        console.log("LLM returned:", JSON.stringify(assignment, null, 2));
+        // Validate the structure
+        if (!assignment.dev?.junior ||
+            !assignment.dev?.medior ||
+            !assignment.dev?.senior ||
+            !assignment.qa?.reviewer ||
+            !assignment.qa?.tester) {
+            console.error("Invalid assignment structure. Got:", assignment);
+            throw new Error(`Invalid assignment structure from LLM. Missing fields in: ${JSON.stringify(Object.keys(assignment))}`);
+        }
+        return assignment;
+    }
+    catch (err) {
+        console.error("LLM model selection failed:", err.message);
+        return null;
+    }
+    finally {
+        // Clean up temp file
+        try {
+            unlinkSync(tmpFile);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+//# sourceMappingURL=llm-model-selector.js.map

package/dist/lib/setup/llm-model-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-model-selector.js","sourceRoot":"","sources":["../../../lib/setup/llm-model-selector.ts"],"names":[],"mappings":"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"}

package/dist/lib/setup/model-fetcher.d.ts

@@ -0,0 +1,22 @@
+export type OpenClawModelRow = {
+    key: string;
+    name?: string;
+    input: string;
+    contextWindow: number | null;
+    local: boolean;
+    available: boolean;
+    tags: string[];
+    missing?: boolean;
+};
+/**
+ * Fetch all models from OpenClaw without logging.
+ *
+ * @param allModels - If true, fetches all models (--all flag). If false, only authenticated models.
+ * @returns Array of model objects from OpenClaw's model registry
+ */
+export declare function fetchModels(allModels?: boolean): OpenClawModelRow[];
+/**
+ * Fetch only authenticated models (available: true).
+ */
+export declare function fetchAuthenticatedModels(): OpenClawModelRow[];
+//# sourceMappingURL=model-fetcher.d.ts.map

package/dist/lib/setup/model-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-fetcher.d.ts","sourceRoot":"","sources":["../../../lib/setup/model-fetcher.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,UAAO,GAAG,gBAAgB,EAAE,CAgDhE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,gBAAgB,EAAE,CAG7D"}

package/dist/lib/setup/model-fetcher.js

@@ -0,0 +1,59 @@
+/**
+ * model-fetcher.ts — Shared helper for fetching OpenClaw models without logging.
+ *
+ * Uses execSync to bypass OpenClaw's command logging infrastructure.
+ */
+import { execSync } from "node:child_process";
+/**
+ * Fetch all models from OpenClaw without logging.
+ *
+ * @param allModels - If true, fetches all models (--all flag). If false, only authenticated models.
+ * @returns Array of model objects from OpenClaw's model registry
+ */
+export function fetchModels(allModels = true) {
+    try {
+        const command = allModels
+            ? "openclaw models list --all --json"
+            : "openclaw models list --json";
+        // Use execSync directly to bypass OpenClaw's command logging
+        const output = execSync(command, {
+            encoding: "utf-8",
+            timeout: 10000,
+            cwd: process.cwd(),
+            // Suppress stderr to avoid any error messages
+            stdio: ["pipe", "pipe", "ignore"],
+        }).trim();
+        if (!output) {
+            throw new Error("Empty output from openclaw models list");
+        }
+        // Parse JSON (skip any log lines like "[plugins] ...")
+        const lines = output.split("\n");
+        // Find the first line that starts with { (the beginning of JSON)
+        const jsonStartIndex = lines.findIndex((line) => {
+            const trimmed = line.trim();
+            return trimmed.startsWith("{");
+        });
+        if (jsonStartIndex === -1) {
+            throw new Error(`No JSON object found in output. Got: ${output.substring(0, 200)}...`);
+        }
+        // Join all lines from the JSON start to the end
+        const jsonString = lines.slice(jsonStartIndex).join("\n");
+        const data = JSON.parse(jsonString);
+        const models = data.models;
+        if (!Array.isArray(models)) {
+            throw new Error(`Expected array of models, got: ${typeof models}`);
+        }
+        return models;
+    }
+    catch (err) {
+        throw new Error(`Failed to fetch models: ${err.message}`);
+    }
+}
+/**
+ * Fetch only authenticated models (available: true).
+ */
+export function fetchAuthenticatedModels() {
+    // Use --all flag but suppress logging via stdio in fetchModels()
+    return fetchModels(true).filter((m) => m.available === true);
+}
+//# sourceMappingURL=model-fetcher.js.map

package/dist/lib/setup/model-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-fetcher.js","sourceRoot":"","sources":["../../../lib/setup/model-fetcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAa9C;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,SAAS,GAAG,IAAI;IAC1C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,SAAS;YACvB,CAAC,CAAC,mCAAmC;YACrC,CAAC,CAAC,6BAA6B,CAAC;QAElC,6DAA6D;QAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE;YAC/B,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK;YACd,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,8CAA8C;YAC9C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,uDAAuD;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjC,iEAAiE;QACjE,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAY,EAAE,EAAE;YACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CACtE,CAAC;QACJ,CAAC;QAED,gDAAgD;QAChD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4B,CAAC;QAEjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA4B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,iEAAiE;IACjE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/lib/setup/smart-model-selector.d.ts

@@ -0,0 +1,38 @@
+/**
+ * smart-model-selector.ts — LLM-powered model selection for DevClaw roles.
+ *
+ * Uses an LLM to intelligently analyze and assign models to DevClaw roles.
+ */
+export type ModelAssignment = {
+    dev: {
+        junior: string;
+        medior: string;
+        senior: string;
+    };
+    qa: {
+        reviewer: string;
+        tester: string;
+    };
+};
+/**
+ * Intelligently assign available models to DevClaw roles using an LLM.
+ *
+ * Strategy:
+ * 1. If 0 models → return null (setup should be blocked)
+ * 2. If 1 model → assign it to all roles
+ * 3. If multiple models → use LLM to intelligently assign
+ */
+export declare function assignModels(availableModels: Array<{
+    model: string;
+    provider: string;
+    authenticated: boolean;
+}>, sessionKey?: string): Promise<ModelAssignment | null>;
+/**
+ * Format model assignment as a readable table.
+ */
+export declare function formatAssignment(assignment: ModelAssignment): string;
+/**
+ * Generate setup instructions when no models are available.
+ */
+export declare function generateSetupInstructions(): string;
+//# sourceMappingURL=smart-model-selector.d.ts.map

package/dist/lib/setup/smart-model-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-model-selector.d.ts","sourceRoot":"","sources":["../../../lib/setup/smart-model-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,EAAE,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,eAAe,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC,EACnF,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA0BjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAWpE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAqBlD"}

package/dist/lib/setup/smart-model-selector.js

@@ -0,0 +1,76 @@
+/**
+ * smart-model-selector.ts — LLM-powered model selection for DevClaw roles.
+ *
+ * Uses an LLM to intelligently analyze and assign models to DevClaw roles.
+ */
+/**
+ * Intelligently assign available models to DevClaw roles using an LLM.
+ *
+ * Strategy:
+ * 1. If 0 models → return null (setup should be blocked)
+ * 2. If 1 model → assign it to all roles
+ * 3. If multiple models → use LLM to intelligently assign
+ */
+export async function assignModels(availableModels, sessionKey) {
+    // Filter to only authenticated models
+    const authenticated = availableModels.filter((m) => m.authenticated);
+    if (authenticated.length === 0) {
+        return null; // No models available - setup should be blocked
+    }
+    // If only one model, use it for everything
+    if (authenticated.length === 1) {
+        const model = authenticated[0].model;
+        return {
+            dev: { junior: model, medior: model, senior: model },
+            qa: { reviewer: model, tester: model },
+        };
+    }
+    // Multiple models: use LLM-based selection
+    const { selectModelsWithLLM } = await import("./llm-model-selector.js");
+    const llmResult = await selectModelsWithLLM(authenticated, sessionKey);
+    if (!llmResult) {
+        throw new Error("LLM-based model selection failed. Please try again or configure models manually.");
+    }
+    return llmResult;
+}
+/**
+ * Format model assignment as a readable table.
+ */
+export function formatAssignment(assignment) {
+    const lines = [
+        "| Role | Level    | Model                    |",
+        "|------|----------|--------------------------|",
+        `| DEV  | senior   | ${assignment.dev.senior.padEnd(24)} |`,
+        `| DEV  | medior   | ${assignment.dev.medior.padEnd(24)} |`,
+        `| DEV  | junior   | ${assignment.dev.junior.padEnd(24)} |`,
+        `| QA   | reviewer | ${assignment.qa.reviewer.padEnd(24)} |`,
+        `| QA   | tester   | ${assignment.qa.tester.padEnd(24)} |`,
+    ];
+    return lines.join("\n");
+}
+/**
+ * Generate setup instructions when no models are available.
+ */
+export function generateSetupInstructions() {
+    return `❌ No authenticated models found. DevClaw needs at least one model to work.
+
+To configure model authentication:
+
+**For Anthropic Claude:**
+  export ANTHROPIC_API_KEY=your-api-key
+  # or: openclaw auth add --provider anthropic
+
+**For OpenAI:**
+  export OPENAI_API_KEY=your-api-key
+  # or: openclaw auth add --provider openai
+
+**For other providers:**
+  openclaw auth add --provider <provider>
+
+**Verify authentication:**
+  openclaw models list
+  (Look for "Auth: yes" in the output)
+
+Once you see authenticated models, re-run: onboard`;
+}
+//# sourceMappingURL=smart-model-selector.js.map

package/dist/lib/setup/smart-model-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-model-selector.js","sourceRoot":"","sources":["../../../lib/setup/smart-model-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,eAAmF,EACnF,UAAmB;IAEnB,sCAAsC;IACtC,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAErE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,CAAC,gDAAgD;IAC/D,CAAC;IAED,2CAA2C;IAC3C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACrC,OAAO;YACL,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;YACpD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;SACvC,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAEvE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;IACtG,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA2B;IAC1D,MAAM,KAAK,GAAG;QACZ,gDAAgD;QAChD,gDAAgD;QAChD,uBAAuB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI;QAC3D,uBAAuB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI;QAC3D,uBAAuB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI;QAC3D,uBAAuB,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI;QAC5D,uBAAuB,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI;KAC3D,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;;;;;;;mDAmB0C,CAAC;AACpD,CAAC"}

package/dist/lib/templates.d.ts

@@ -4,6 +4,6 @@
  */
 export declare const DEFAULT_DEV_INSTRUCTIONS = "# DEV Worker Instructions\n\n## Context You Receive\n\nWhen you start work, you're given:\n\n- **Issue:** number, title, body, URL, labels, state\n- **Comments:** full discussion thread on the issue\n- **Assignees:** who's assigned\n- **Timestamps:** created, updated dates\n- **Project:** repo path, base branch, project name\n\nRead the comments carefully \u2014 they often contain clarifications, decisions, or scope changes that aren't in the original issue body.\n\n## Your Job\n\n- Work in a git worktree (never switch branches in the main repo)\n- Run tests before completing\n- Create an MR/PR to the base branch and merge it\n- **IMPORTANT:** Do NOT use closing keywords in PR/MR descriptions (no \"Closes #X\", \"Fixes #X\", \"Resolves #X\"). Use \"As described in issue #X\" or \"Addresses issue #X\" instead. DevClaw manages issue state \u2014 auto-closing bypasses QA.\n- Clean up the worktree after merging\n- When done, call work_finish with role \"dev\", result \"done\", and a brief summary\n- If you discover unrelated bugs, call task_create to file them\n- Do NOT call work_start, status, health, or project_register\n";
 export declare const DEFAULT_QA_INSTRUCTIONS = "# QA Worker Instructions\n\n- Pull latest from the base branch\n- Run tests and linting\n- Verify the changes address the issue requirements\n- Check for regressions in related functionality\n- **Always** call task_comment with your review findings \u2014 even if everything looks good, leave a brief summary of what you checked\n- When done, call work_finish with role \"qa\" and one of:\n  - result \"pass\" if everything looks good\n  - result \"fail\" with specific issues if problems found\n  - result \"refine\" if you need human input to decide\n- If you discover unrelated bugs, call task_create to file them\n- Do NOT call work_start, status, health, or project_register\n";
-export declare const AGENTS_MD_TEMPLATE = "# AGENTS.md - Development Orchestration (DevClaw)\n\n## If You Are a Sub-Agent (DEV/QA Worker)\n\nSkip the orchestrator section. Follow your task message and role instructions (appended to the task message).\n\n### Conventions\n\n- Conventional commits: `feat:`, `fix:`, `chore:`, `refactor:`, `test:`, `docs:`\n- Include issue number: `feat: add user authentication (#12)`\n- Branch naming: `feature/<id>-<slug>` or `fix/<id>-<slug>`\n- **DEV always works in a git worktree** (never switch branches in the main repo)\n- **DEV must merge to base branch** before announcing completion\n- **Do NOT use closing keywords in PR/MR descriptions** (no \"Closes #X\", \"Fixes #X\", \"Resolves #X\"). Use \"As described in issue #X\" or \"Addresses issue #X\". DevClaw manages issue state \u2014 auto-closing bypasses QA.\n- **QA tests on the deployed version** and inspects code on the base branch\n- **QA always calls task_comment** with review findings before completing\n- Always run tests before completing\n\n### Completing Your Task\n\nWhen you are done, **call `work_finish` yourself** \u2014 do not just announce in text.\n\n- **DEV done:** `work_finish({ role: \"dev\", result: \"done\", projectGroupId: \"<from task message>\", summary: \"<brief summary>\" })`\n- **QA pass:** `work_finish({ role: \"qa\", result: \"pass\", projectGroupId: \"<from task message>\", summary: \"<brief summary>\" })`\n- **QA fail:** `work_finish({ role: \"qa\", result: \"fail\", projectGroupId: \"<from task message>\", summary: \"<specific issues>\" })`\n- **QA refine:** `work_finish({ role: \"qa\", result: \"refine\", projectGroupId: \"<from task message>\", summary: \"<what needs human input>\" })`\n\nThe `projectGroupId` is included in your task message.\n\n### Filing Follow-Up Issues\n\nIf you discover unrelated bugs or needed improvements during your work, call `task_create` to file them:\n\n`task_create({ projectGroupId: \"<from task message>\", title: \"Bug: ...\", description: \"...\" })`\n\n### Tools You Should NOT Use\n\nThese are orchestrator-only tools. Do not call them:\n- `work_start`, `status`, `health`, `project_register`\n\n---\n\n## Orchestrator\n\nYou are a **development orchestrator**. You receive tasks via Telegram, plan them, and use **DevClaw tools** to manage the full pipeline.\n\n### DevClaw Tools\n\nAll orchestration goes through these tools. You do NOT manually manage sessions, labels, or projects.json.\n\n| Tool | What it does |\n|---|---|\n| `project_register` | One-time project setup: creates labels, scaffolds role files, adds to projects.json |\n| `task_create` | Create issues from chat (bugs, features, tasks) |\n| `task_update` | Update issue title, description, or labels |\n| `status` | Task queue and worker state per project (lightweight dashboard) |\n| `health` | Scan worker health: zombies, stale workers, orphaned state. Pass fix=true to auto-fix |\n| `work_start` | End-to-end: label transition, level assignment, session create/reuse, dispatch with role instructions |\n| `work_finish` | End-to-end: label transition, state update, issue close/reopen. Ticks scheduler after completion. |\n\n### Pipeline Flow\n\n```\nPlanning \u2192 To Do \u2192 Doing \u2192 To Test \u2192 Testing \u2192 Done\n                               \u2193\n                           To Improve \u2192 Doing (fix cycle)\n                               \u2193\n                           Refining (human decision)\n```\n\nIssue labels are the single source of truth for task state.\n\n### Developer Assignment\n\nEvaluate each task and pass the appropriate developer level to `work_start`:\n\n- **junior** \u2014 trivial: typos, single-file fix, quick change\n- **medior** \u2014 standard: features, bug fixes, multi-file changes\n- **senior** \u2014 complex: architecture, system-wide refactoring, 5+ services\n- **reviewer** \u2014 QA: code inspection, validation, test runs\n\n### Picking Up Work\n\n1. Use `status` to see what's available\n2. Priority: `To Improve` (fix failures) > `To Test` (QA) > `To Do` (new work)\n3. Evaluate complexity, choose developer level\n4. Call `work_start` with `issueId`, `role`, `projectGroupId`, `level`\n5. Post the `announcement` from the tool response to Telegram\n\n### When Work Completes\n\nWorkers call `work_finish` themselves \u2014 the label transition, state update, and audit log happen atomically. After completion, `work_finish` ticks the scheduler to fill free slots:\n\n- DEV \"done\" \u2192 issue moves to \"To Test\" \u2192 scheduler dispatches QA\n- QA \"fail\" \u2192 issue moves to \"To Improve\" \u2192 scheduler dispatches DEV\n- QA \"pass\" \u2192 Done, no further dispatch\n- QA \"refine\" / blocked \u2192 needs human input\n\nThe response includes `tickPickups` showing any tasks that were auto-dispatched. Post announcements from the tool response to Telegram.\n\n### Prompt Instructions\n\nWorkers receive role-specific instructions appended to their task message. These are loaded from `projects/roles/<project-name>/<role>.md` in the workspace, falling back to `projects/roles/default/<role>.md` if no project-specific file exists. `project_register` scaffolds these files automatically \u2014 edit them to customize worker behavior per project.\n\n### Heartbeats\n\n**Do nothing.** The heartbeat service runs automatically as an internal interval-based process \u2014 zero LLM tokens. It handles health checks (zombie detection, stale workers) and queue dispatch (filling free worker slots by priority) every 60 seconds by default. Configure via `plugins.entries.devclaw.config.work_heartbeat` in openclaw.json.\n\n### Safety\n\n- Don't push to main directly\n- Don't force-push\n- Don't close issues without QA pass\n- Ask before architectural decisions affecting multiple projects\n";
+export declare const AGENTS_MD_TEMPLATE = "# AGENTS.md - Development Orchestration (DevClaw)\n\n## If You Are a Sub-Agent (DEV/QA Worker)\n\nSkip the orchestrator section. Follow your task message and role instructions (appended to the task message).\n\n### Conventions\n\n- Conventional commits: `feat:`, `fix:`, `chore:`, `refactor:`, `test:`, `docs:`\n- Include issue number: `feat: add user authentication (#12)`\n- Branch naming: `feature/<id>-<slug>` or `fix/<id>-<slug>`\n- **DEV always works in a git worktree** (never switch branches in the main repo)\n- **DEV must merge to base branch** before announcing completion\n- **Do NOT use closing keywords in PR/MR descriptions** (no \"Closes #X\", \"Fixes #X\", \"Resolves #X\"). Use \"As described in issue #X\" or \"Addresses issue #X\". DevClaw manages issue state \u2014 auto-closing bypasses QA.\n- **QA tests on the deployed version** and inspects code on the base branch\n- **QA always calls task_comment** with review findings before completing\n- Always run tests before completing\n\n### Completing Your Task\n\nWhen you are done, **call `work_finish` yourself** \u2014 do not just announce in text.\n\n- **DEV done:** `work_finish({ role: \"dev\", result: \"done\", projectGroupId: \"<from task message>\", summary: \"<brief summary>\" })`\n- **QA pass:** `work_finish({ role: \"qa\", result: \"pass\", projectGroupId: \"<from task message>\", summary: \"<brief summary>\" })`\n- **QA fail:** `work_finish({ role: \"qa\", result: \"fail\", projectGroupId: \"<from task message>\", summary: \"<specific issues>\" })`\n- **QA refine:** `work_finish({ role: \"qa\", result: \"refine\", projectGroupId: \"<from task message>\", summary: \"<what needs human input>\" })`\n\nThe `projectGroupId` is included in your task message.\n\n### Filing Follow-Up Issues\n\nIf you discover unrelated bugs or needed improvements during your work, call `task_create` to file them:\n\n`task_create({ projectGroupId: \"<from task message>\", title: \"Bug: ...\", description: \"...\" })`\n\n### Tools You Should NOT Use\n\nThese are orchestrator-only tools. Do not call them:\n- `work_start`, `status`, `health`, `project_register`\n\n---\n\n## Orchestrator\n\nYou are a **development orchestrator** \u2014 a planner and dispatcher, not a coder. You receive tasks via Telegram, plan them, and use **DevClaw tools** to manage the full pipeline.\n\n### \u26A0\uFE0F Critical: You Do NOT Write Code\n\n**Never write code yourself.** All implementation work MUST go through the issue \u2192 worker pipeline:\n\n1. Create an issue via `task_create`\n2. Dispatch a DEV worker via `work_start`\n3. Let the worker handle implementation, git, and PRs\n\n**Why this matters:**\n- **Audit trail** \u2014 Every code change is tracked to an issue\n- **Tier selection** \u2014 Junior/medior/senior models match task complexity\n- **Parallelization** \u2014 Workers run in parallel, you stay free to plan\n- **QA pipeline** \u2014 Code goes through review before closing\n\n**What you CAN do directly:**\n- Planning, analysis, architecture discussions\n- Requirements gathering, clarifying scope\n- Creating and updating issues\n- Status checks and queue management\n- Answering questions about the codebase (reading, not writing)\n\n**What MUST go through a worker:**\n- Any code changes (edits, new files, refactoring)\n- Git operations (commits, branches, PRs)\n- Running tests in the codebase\n- Debugging that requires code changes\n\n### DevClaw Tools\n\nAll orchestration goes through these tools. You do NOT manually manage sessions, labels, or projects.json.\n\n| Tool | What it does |\n|---|---|\n| `project_register` | One-time project setup: creates labels, scaffolds role files, adds to projects.json |\n| `task_create` | Create issues from chat (bugs, features, tasks) |\n| `task_update` | Update issue title, description, or labels |\n| `status` | Task queue and worker state per project (lightweight dashboard) |\n| `health` | Scan worker health: zombies, stale workers, orphaned state. Pass fix=true to auto-fix |\n| `work_start` | End-to-end: label transition, level assignment, session create/reuse, dispatch with role instructions |\n| `work_finish` | End-to-end: label transition, state update, issue close/reopen. Ticks scheduler after completion. |\n\n### Pipeline Flow\n\n```\nPlanning \u2192 To Do \u2192 Doing \u2192 To Test \u2192 Testing \u2192 Done\n                               \u2193\n                           To Improve \u2192 Doing (fix cycle)\n                               \u2193\n                           Refining (human decision)\n```\n\nIssue labels are the single source of truth for task state.\n\n### Developer Assignment\n\nEvaluate each task and pass the appropriate developer level to `work_start`:\n\n- **junior** \u2014 trivial: typos, single-file fix, quick change\n- **medior** \u2014 standard: features, bug fixes, multi-file changes\n- **senior** \u2014 complex: architecture, system-wide refactoring, 5+ services\n- **reviewer** \u2014 QA: code inspection, validation, test runs\n\n### Picking Up Work\n\n1. Use `status` to see what's available\n2. Priority: `To Improve` (fix failures) > `To Test` (QA) > `To Do` (new work)\n3. Evaluate complexity, choose developer level\n4. Call `work_start` with `issueId`, `role`, `projectGroupId`, `level`\n5. Post the `announcement` from the tool response to Telegram\n\n### When Work Completes\n\nWorkers call `work_finish` themselves \u2014 the label transition, state update, and audit log happen atomically. After completion, `work_finish` ticks the scheduler to fill free slots:\n\n- DEV \"done\" \u2192 issue moves to \"To Test\" \u2192 scheduler dispatches QA\n- QA \"fail\" \u2192 issue moves to \"To Improve\" \u2192 scheduler dispatches DEV\n- QA \"pass\" \u2192 Done, no further dispatch\n- QA \"refine\" / blocked \u2192 needs human input\n\nThe response includes `tickPickups` showing any tasks that were auto-dispatched. Post announcements from the tool response to Telegram.\n\n### Prompt Instructions\n\nWorkers receive role-specific instructions appended to their task message. These are loaded from `projects/roles/<project-name>/<role>.md` in the workspace, falling back to `projects/roles/default/<role>.md` if no project-specific file exists. `project_register` scaffolds these files automatically \u2014 edit them to customize worker behavior per project.\n\n### Heartbeats\n\n**Do nothing.** The heartbeat service runs automatically as an internal interval-based process \u2014 zero LLM tokens. It handles health checks (zombie detection, stale workers) and queue dispatch (filling free worker slots by priority) every 60 seconds by default. Configure via `plugins.entries.devclaw.config.work_heartbeat` in openclaw.json.\n\n### Safety\n\n- **Never write code yourself** \u2014 always dispatch a DEV worker\n- Don't push to main directly\n- Don't force-push\n- Don't close issues without QA pass\n- Ask before architectural decisions affecting multiple projects\n";
 export declare const HEARTBEAT_MD_TEMPLATE = "# HEARTBEAT.md\n\nDo nothing. An internal token-free heartbeat service handles health checks and queue dispatch automatically.\n";
 //# sourceMappingURL=templates.d.ts.map

package/dist/lib/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../lib/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,wBAAwB,snCAwBpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,8qBAanC,CAAC;AAEF,eAAO,MAAM,kBAAkB,ypLAkH9B,CAAC;AAEF,eAAO,MAAM,qBAAqB,qIAGjC,CAAC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../lib/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,wBAAwB,snCAwBpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,8qBAanC,CAAC;AAEF,eAAO,MAAM,kBAAkB,i0NA8I9B,CAAC;AAEF,eAAO,MAAM,qBAAqB,qIAGjC,CAAC"}

package/dist/lib/templates.js

@@ -85,7 +85,34 @@ These are orchestrator-only tools. Do not call them:
 
 ## Orchestrator
 
-You are a **development orchestrator**. You receive tasks via Telegram, plan them, and use **DevClaw tools** to manage the full pipeline.
+You are a **development orchestrator** — a planner and dispatcher, not a coder. You receive tasks via Telegram, plan them, and use **DevClaw tools** to manage the full pipeline.
+
+### ⚠️ Critical: You Do NOT Write Code
+
+**Never write code yourself.** All implementation work MUST go through the issue → worker pipeline:
+
+1. Create an issue via \`task_create\`
+2. Dispatch a DEV worker via \`work_start\`
+3. Let the worker handle implementation, git, and PRs
+
+**Why this matters:**
+- **Audit trail** — Every code change is tracked to an issue
+- **Tier selection** — Junior/medior/senior models match task complexity
+- **Parallelization** — Workers run in parallel, you stay free to plan
+- **QA pipeline** — Code goes through review before closing
+
+**What you CAN do directly:**
+- Planning, analysis, architecture discussions
+- Requirements gathering, clarifying scope
+- Creating and updating issues
+- Status checks and queue management
+- Answering questions about the codebase (reading, not writing)
+
+**What MUST go through a worker:**
+- Any code changes (edits, new files, refactoring)
+- Git operations (commits, branches, PRs)
+- Running tests in the codebase
+- Debugging that requires code changes
 
 ### DevClaw Tools
 
@@ -151,6 +178,7 @@ Workers receive role-specific instructions appended to their task message. These
 
 ### Safety
 
+- **Never write code yourself** — always dispatch a DEV worker
 - Don't push to main directly
 - Don't force-push
 - Don't close issues without QA pass

package/dist/lib/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../lib/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBvC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;CAatC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHjC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;CAGpC,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../lib/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBvC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;CAatC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8IjC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;CAGpC,CAAC"}

package/dist/lib/tools/autoconfigure-models.d.ts

@@ -0,0 +1,26 @@
+/**
+ * autoconfigure-models.ts — Tool for automatically configuring model assignments.
+ *
+ * Queries available authenticated models and intelligently assigns them to DevClaw roles.
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { ToolContext } from "../types.js";
+/**
+ * Create the autoconfigure_models tool.
+ */
+export declare function createAutoConfigureModelsTool(api: OpenClawPluginApi): (ctx: ToolContext) => {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            preferProvider: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    execute(_id: string, params: Record<string, unknown>): Promise<import("@mariozechner/pi-agent-core").AgentToolResult<unknown>>;
+};
+//# sourceMappingURL=autoconfigure-models.d.ts.map

package/dist/lib/tools/autoconfigure-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoconfigure-models.d.ts","sourceRoot":"","sources":["../../../lib/tools/autoconfigure-models.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiC/C;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,iBAAiB,IAC1D,KAAK,WAAW;;;;;;;;;;;;;iBAeH,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EA4E7D"}

package/dist/lib/tools/autoconfigure-models.js

@@ -0,0 +1,110 @@
+import { jsonResult } from "openclaw/plugin-sdk";
+import { assignModels, formatAssignment, generateSetupInstructions, } from "../setup/smart-model-selector.js";
+import { fetchAuthenticatedModels } from "../setup/model-fetcher.js";
+/**
+ * Get available authenticated models from OpenClaw.
+ */
+async function getAuthenticatedModels(api) {
+    try {
+        const models = fetchAuthenticatedModels();
+        // Map to the format expected by assignModels()
+        return models.map((m) => {
+            // Extract provider from key (format: provider/model-name)
+            const provider = m.key.split("/")[0] || "unknown";
+            return {
+                model: m.key,
+                provider,
+                authenticated: true,
+            };
+        });
+    }
+    catch (err) {
+        throw new Error(`Failed to get authenticated models: ${err.message}`);
+    }
+}
+/**
+ * Create the autoconfigure_models tool.
+ */
+export function createAutoConfigureModelsTool(api) {
+    return (ctx) => ({
+        name: "autoconfigure_models",
+        label: "Auto-Configure Models",
+        description: "Automatically discover authenticated models and intelligently assign them to DevClaw roles based on capability tiers",
+        parameters: {
+            type: "object",
+            properties: {
+                preferProvider: {
+                    type: "string",
+                    description: "Optional: Prefer models from this provider (e.g., 'anthropic', 'openai')",
+                },
+            },
+        },
+        async execute(_id, params) {
+            try {
+                // Get all authenticated models
+                let authenticatedModels = await getAuthenticatedModels(api);
+                // Filter by preferred provider if specified
+                const preferProvider = params?.preferProvider;
+                if (preferProvider) {
+                    const filtered = authenticatedModels.filter((m) => m.provider.toLowerCase() === preferProvider.toLowerCase());
+                    if (filtered.length === 0) {
+                        return jsonResult({
+                            success: false,
+                            error: `No authenticated models found for provider: ${preferProvider}`,
+                            message: `❌ No authenticated models found for provider "${preferProvider}".\n\nAvailable providers: ${[...new Set(authenticatedModels.map((m) => m.provider))].join(", ")}`,
+                        });
+                    }
+                    authenticatedModels = filtered;
+                }
+                // Intelligently assign models using current session context
+                const assignment = await assignModels(authenticatedModels, ctx.sessionKey);
+                if (!assignment) {
+                    // No models available
+                    const instructions = generateSetupInstructions();
+                    return jsonResult({
+                        success: false,
+                        modelCount: 0,
+                        message: instructions,
+                    });
+                }
+                // Format the assignment
+                const table = formatAssignment(assignment);
+                const modelCount = authenticatedModels.length;
+                let message = `✅ Auto-configured models based on ${modelCount} authenticated model${modelCount === 1 ? "" : "s"}:\n\n`;
+                message += table;
+                message += "\n\n";
+                if (modelCount === 1) {
+                    message += "ℹ️  Only one authenticated model found — assigned to all roles.";
+                }
+                else {
+                    message += "ℹ️  Models assigned by capability tier (Tier 1 → senior, Tier 2 → medior/reviewer, Tier 3 → junior/tester).";
+                }
+                if (preferProvider) {
+                    message += `\n📌 Filtered to provider: ${preferProvider}`;
+                }
+                message += "\n\n**Next step:** Pass this configuration to `setup` tool:\n";
+                message += "```javascript\n";
+                message += "setup({ models: <this-configuration> })\n";
+                message += "```";
+                return jsonResult({
+                    success: true,
+                    modelCount,
+                    assignment,
+                    models: assignment,
+                    provider: preferProvider || "auto",
+                    message,
+                });
+            }
+            catch (err) {
+                const errorMsg = err.message;
+                api.logger.error(`Auto-configure models error: ${errorMsg}`);
+                return jsonResult({
+                    success: false,
+                    error: errorMsg,
+                    message: `❌ Failed to auto-configure models: ${errorMsg}`,
+                });
+            }
+        },
+    });
+}
+//# sourceMappingURL=autoconfigure-models.js.map

package/dist/lib/tools/autoconfigure-models.js.map

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

package/dist/lib/tools/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../lib/tools/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,IAC5C,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoEH,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAkD7D"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../lib/tools/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,IAC5C,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoEH,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAmD7D"}

package/dist/lib/tools/setup.js

@@ -87,7 +87,8 @@ export function createSetupTool(api) {
             if (result.bindingMigrated) {
                 lines.push(`✅ Binding migrated: ${result.bindingMigrated.channel} (${result.bindingMigrated.from} → ${result.agentId})`, "");
             }
-            lines.push("Models:", ...DEV_LEVELS.map((t) => `  dev.${t}: ${result.models.dev[t]}`), ...QA_LEVELS.map((t) => `  qa.${t}: ${result.models.qa[t]}`), "", "Files:", ...result.filesWritten.map((f) => `  ${f}`));
+            lines.push("Models:", ...DEV_LEVELS.map((t) => `  dev.${t}: ${result.models.dev[t]}`), ...QA_LEVELS.map((t) => `  qa.${t}: ${result.models.qa[t]}`), "");
+            lines.push("Files:", ...result.filesWritten.map((f) => `  ${f}`));
             if (result.warnings.length > 0)
                 lines.push("", "Warnings:", ...result.warnings.map((w) => `  ${w}`));
             lines.push("", "Next: register a project, then create issues and pick them up.");

package/dist/lib/tools/setup.js.map

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

package/docs/ARCHITECTURE.md

@@ -589,11 +589,13 @@ graph LR
         Z[Zombie cleanup]
     end
 
-    subgraph "Orchestrator handles"
+    subgraph "Orchestrator handles (planning only)"
         MSG[Telegram announcements]
         HB[Heartbeat scheduling]
         DEC[Task prioritization]
         M[Developer assignment<br/>junior/medior/senior]
+        READ[Code reading for context]
+        PLAN[Requirements & planning]
     end
 
     subgraph "Sub-agent sessions handle"
@@ -609,6 +611,8 @@ graph LR
     end
 ```
 
+**Key boundary:** The orchestrator is a planner and dispatcher — it never writes code. All implementation work (code edits, git operations, tests) must go through sub-agent sessions via the `task_create` → `work_start` pipeline. This ensures audit trails, tier selection, and QA review for every code change.
+
 ## IssueProvider abstraction
 
 All issue tracker operations go through the `IssueProvider` interface, defined in `lib/providers/provider.ts`. This abstraction allows DevClaw to support multiple issue trackers without changing tool logic.

package/docs/ONBOARDING.md

@@ -15,8 +15,12 @@ Step-by-step setup: install the plugin, configure an agent, register projects, a
 ## Step 1: Install the plugin
 
 ```bash
-# Copy to extensions directory (auto-discovered on next restart)
-cp -r devclaw ~/.openclaw/extensions/
+openclaw plugins install @laurentenhoor/devclaw
+```
+
+Or for local development:
+```bash
+openclaw plugins install -l ./devclaw
 ```
 
 Verify:
@@ -232,7 +236,7 @@ Change which model powers each level in `openclaw.json` — see [Configuration](
 
 | Responsibility | Who | Details |
 |---|---|---|
-| Plugin installation | You (once) | `cp -r devclaw ~/.openclaw/extensions/` |
+| Plugin installation | You (once) | `openclaw plugins install @laurentenhoor/devclaw` |
 | Agent + workspace setup | Plugin (`setup`) | Creates agent, configures models, writes workspace files |
 | Channel binding migration | Plugin (`setup` with `migrateFrom`) | Automatically moves channel-wide bindings between agents |
 | Label setup | Plugin (`project_register`) | 8 labels, created idempotently via IssueProvider |

package/openclaw.plugin.json

@@ -0,0 +1,55 @@
+{
+  "id": "devclaw",
+  "name": "DevClaw",
+  "description": "Multi-project dev/qa pipeline orchestration for OpenClaw. Developer tiers, atomic task management, session health, and audit logging.",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "models": {
+        "type": "object",
+        "description": "Model mapping per role and tier",
+        "properties": {
+          "dev": {
+            "type": "object",
+            "description": "Developer tier models",
+            "properties": {
+              "junior": { "type": "string" },
+              "medior": { "type": "string" },
+              "senior": { "type": "string" }
+            }
+          },
+          "qa": {
+            "type": "object",
+            "description": "QA tier models",
+            "properties": {
+              "reviewer": { "type": "string" },
+              "tester": { "type": "string" }
+            }
+          }
+        }
+      },
+      "projectExecution": {
+        "type": "string",
+        "enum": ["parallel", "sequential"],
+        "description": "Project execution mode. Default: parallel."
+      },
+      "notifications": {
+        "type": "object",
+        "description": "Per-event-type notification toggles. All default to true — set to false to suppress.",
+        "properties": {
+          "workerStart": { "type": "boolean" },
+          "workerComplete": { "type": "boolean" }
+        }
+      },
+      "work_heartbeat": {
+        "type": "object",
+        "description": "Token-free interval-based heartbeat service.",
+        "properties": {
+          "enabled": { "type": "boolean" },
+          "intervalSeconds": { "type": "number" },
+          "maxPickupsPerTick": { "type": "number" }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laurentenhoor/devclaw",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Multi-project dev/qa pipeline orchestration for OpenClaw",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,7 @@
   },
   "openclaw": {
     "extensions": [
-      "./index.ts"
+      "./dist/index.js"
     ]
   },
   "main": "./dist/index.js",
@@ -35,7 +35,8 @@
   "files": [
     "dist/",
     "roles/",
-    "docs/"
+    "docs/",
+    "openclaw.plugin.json"
   ],
   "publishConfig": {
     "access": "public"
@@ -50,6 +51,7 @@
     "openclaw": ">=2026.0.0"
   },
   "devDependencies": {
-    "typescript": "^5.8"
+    "@types/node": "^25.2.3",
+    "typescript": "^5.9.3"
   }
 }