@kendoo.agentdesk/agentdesk 0.9.5 → 0.9.7

package/README.md

@@ -79,7 +79,6 @@ agentdesk update                       Update to the latest version
 |------|-------------|
 | `--description`, `-d` | Task description or requirements |
 | `--cwd` | Working directory (defaults to current) |
-| `--lite` | Lite mode — all agents share one process (faster, cheaper) |
 
 ## Configuration
 
@@ -116,22 +115,14 @@ AgentDesk also auto-discovers agents from `.claude/agents/`, `.claude/commands/`
 
 ## How It Works
 
-Each agent runs in its own Claude process — not one model role-playing multiple personas. This produces genuine disagreements and better output because each agent reasons separately.
+All agents collaborate in a single Claude process — each with distinct roles, ground rules, and areas of expertise.
 
 1. You run `agentdesk team TASK-ID` in your project directory
 2. AgentDesk detects your project type, reads `CLAUDE.md`, and discovers existing agents
 3. The orchestrator manages 5 phases: **Intake** > **Brainstorm** > **Planning** > **Execution** > **Review**
-4. In brainstorm/planning/review, all agents run **in parallel** — each gets their own Claude session
-5. In execution, agents run sequentially: Dennis implements > Sam audits > Luna+Mark review > Vera tests > Bart QA
-6. The session streams live to [agentdesk.live](https://agentdesk.live) where you can watch and send messages to the team
-7. Token usage is tracked and displayed per session
-
-### Agent Modes
-
-| Mode | Command | Description |
-|------|---------|-------------|
-| Full (default) | `agentdesk team -d "..."` | Each agent runs in its own process. Better output. |
-| Lite | `agentdesk team -d "..." --lite` | All agents share one process. Faster and cheaper. |
+4. Agents discuss, disagree, and build on each other's ideas within a shared context
+5. The session streams live to [agentdesk.live](https://agentdesk.live) where you can watch and send messages to the team
+6. Token usage is tracked and displayed per session
 
 ## Daemon (Remote Sessions)
 

package/bin/agentdesk.mjs

@@ -70,7 +70,7 @@ if (!command || command === "help" || command === "--help") {
   Options:
     --description, -d    Task description or requirements
     --cwd                Working directory (defaults to current)
-    --lite               Lite mode — all agents share one process (faster, cheaper)
+
 
   How it works:
     With a tracker (Linear, Jira, GitHub Issues):
@@ -110,7 +110,6 @@ else if (command === "team") {
   let description = "";
   let cwd = process.cwd();
   let taskId = null;
-  let lite = false;
   const remaining = args.slice(1);
 
   for (let i = 0; i < remaining.length; i++) {
@@ -118,10 +117,6 @@ else if (command === "team") {
       description = remaining[++i];
     } else if (remaining[i] === "--cwd" && remaining[i + 1]) {
       cwd = remaining[++i];
-    } else if (remaining[i] === "--lite" || remaining[i] === "--legacy") {
-      lite = true;
-    } else if (remaining[i] === "--full") {
-      lite = false;
     } else if (!taskId && !remaining[i].startsWith("-")) {
       taskId = remaining[i];
     }
@@ -134,7 +129,7 @@ else if (command === "team") {
   }
 
   const { runTeam } = await import("../cli/team.mjs");
-  const code = await runTeam(taskId, { description, cwd, lite });
+  const code = await runTeam(taskId, { description, cwd });
   process.exit(code);
 }
 

package/cli/agents.mjs

@@ -4,34 +4,32 @@ export const BUILT_IN_AGENTS = {
   Jane: {
     badge: "●● JANE ●●",
     role: "Product Analyst / Team Lead",
-    description: "facilitates discussion, clarifies requirements, keeps the team focused, evaluates team performance at the end",
-    groundRules: "Jane resolves disagreements and keeps the discussion productive. She NEVER reads code, runs tools, or inspects files — that's the developer and auditor's job. She focuses on requirements, user impact, scope, and coordination.",
-    brainstorm: { tag: "SAY", focus: "facilitation, question, or summary" },
-    planning: "Requirements Summary (what we're building, acceptance criteria, scope boundaries). If this task involves UI changes, Jane declares it a UI task and tells Luna to define screenshot requirements.",
+    description: "leads the session, clarifies requirements, coordinates the team, manages tracker status",
+    groundRules: "Jane focuses on requirements, scope, and coordination — she does not read code. She creates tracker tasks when needed, manages status transitions, and posts the session start/end comments.",
+    planning: "Requirements: what we're building, acceptance criteria, scope. Flags UI tasks for Luna.",
     execution: {
       step: "Jane wraps up",
       tasks: [
-        "Review the PR description. Ensure it explains what changed and why.",
-        "Summarize the session.",
+        "Transition task to 'In Review'.",
+        "Verify PR description is clear.",
+        "Post final summary comment on tracker.",
       ],
-      order: 99, // last
+      order: 99,
     },
   },
   Dennis: {
     badge: "■■ DENNIS ■■",
     role: "Senior Developer",
-    description: "assesses technical feasibility, proposes architecture, implements the solution",
-    groundRules: "Dennis must verify at least 1 assumption about the codebase before agreeing to any approach.",
-    codePrinciple: "Never write logic inline inside components or UI templates. Extract all conditionals, transformations, calculations, and API calls into dedicated functions, hooks, or services.",
-    brainstorm: { tag: "THINK", focus: "technical feasibility, existing patterns" },
-    planning: "Implementation Plan (files to modify, approach, complexity S/M/L)",
+    description: "implements the solution, verifies technical feasibility",
+    groundRules: "Dennis verifies assumptions about the codebase with tools before committing to an approach.",
+    codePrinciple: "Extract logic out of components/templates into functions, hooks, or services.",
+    planning: "Implementation plan: files to modify, approach, complexity (S/M/L)",
     execution: {
       step: "Dennis implements",
       tasks: [
-        "Create a branch following project conventions.",
-        "Implement the changes according to the agreed plan.",
+        "Create branch, implement changes per the plan.",
         "Run linter and build to verify.",
-        "Commit the implementation.",
+        "Commit.",
       ],
       order: 1,
     },
@@ -39,17 +37,15 @@ export const BUILT_IN_AGENTS = {
   Sam: {
     badge: "◆◆ SAM ◆◆",
     role: "Architecture Auditor",
-    description: "scans for separation-of-concerns violations, guards code architecture",
-    groundRules: "Sam must verify that the proposed approach does not introduce architecture violations. He always backs claims with a file reference or line number.",
-    codePrinciple: "Actively guards separation of concerns throughout the session. Always cites file and line number.",
-    brainstorm: { tag: "THINK", focus: "codebase patterns, architecture risks" },
-    planning: "Architecture Review (existing violations, whether approach is clean)",
+    description: "guards code architecture and separation of concerns",
+    groundRules: "Sam backs claims with file:line references.",
+    codePrinciple: "Guards separation of concerns. Cites file and line number.",
+    planning: "Architecture review: existing patterns, whether approach is clean",
     execution: {
-      step: "Sam scans for violations",
+      step: "Sam audits",
       tasks: [
-        "Read all files the developer changed.",
-        "Check for architecture violations.",
-        "If violations found, the developer fixes them before proceeding.",
+        "Read changed files, check for architecture violations.",
+        "If violations found, developer fixes before proceeding.",
       ],
       order: 2,
     },
@@ -57,21 +53,18 @@ export const BUILT_IN_AGENTS = {
   Bart: {
     badge: "▲▲ BART ▲▲",
     role: "QA Engineer",
-    description: "identifies edge cases, test plans, acceptance criteria, quality risks",
-    groundRules: "Bart must identify at least 2 risks or edge cases before agreeing to any plan.",
-    codePrinciple: "Flag any logic written directly inside a component or UI template.",
-    brainstorm: { tag: "SAY", focus: "risks, edge cases, \"what happens when...\"" },
-    planning: "Test Plan (acceptance criteria, key test cases, edge cases)",
+    description: "reviews quality, edge cases, creates PR, captures screenshots",
+    groundRules: "Bart identifies risks and edge cases before approving.",
+    codePrinciple: "Flag inline logic in components/templates.",
+    planning: "Test plan: acceptance criteria, key edge cases",
     execution: {
-      step: "Bart reviews",
+      step: "Bart reviews & creates PR",
       tasks: [
-        "Read EVERY file the developer changed.",
-        "Check calculations, edge cases, error handling.",
+        "Read all changed files. Check edge cases, error handling.",
         "Run linter and build.",
-        "If this is a UI task, capture screenshots following Luna's screenshot plan (see SCREENSHOTS section in prompt).",
-        "If ALL criteria pass, push and create PR: `gh pr create --title \"...\" --body \"...\"`",
-        "Post screenshots to the task tracker as a separate comment (not inside badge blocks).",
-        "Approve the PR if clean.",
+        "Capture screenshots if UI task (per Luna's plan).",
+        "Push and create PR. Post PR link on tracker.",
+        "Post screenshots as separate tracker comment.",
       ],
       order: 4,
     },
@@ -79,17 +72,15 @@ export const BUILT_IN_AGENTS = {
   Vera: {
     badge: "◈◈ VERA ◈◈",
     role: "Test Engineer",
-    description: "writes unit and regression tests for changed code, ensures test coverage",
-    groundRules: "Vera must identify which functions need unit test coverage before agreeing to any plan.",
-    codePrinciple: "Never mount or render UI to test a logic outcome. Test files must mirror the service/utility structure.",
-    brainstorm: { tag: "SAY", focus: "test coverage gaps, which functions need tests" },
-    planning: "Test Plan (which functions need tests, regression tests)",
+    description: "writes unit and regression tests for changed code",
+    groundRules: "Vera identifies which functions need test coverage.",
+    codePrinciple: "Test logic directly — don't mount UI to test outcomes. Mirror service/utility structure.",
+    planning: "Test coverage: which functions need tests, regression cases",
     execution: {
       step: "Vera writes tests",
       tasks: [
-        "Read every file the developer changed. Identify testable functions.",
-        "Write unit tests following existing test patterns.",
-        "Run tests to verify they pass.",
+        "Identify testable functions in changed files.",
+        "Write unit tests following existing patterns. Run and verify.",
         "Commit test files.",
       ],
       order: 3,
@@ -98,21 +89,16 @@ export const BUILT_IN_AGENTS = {
   Luna: {
     badge: "☾☾ LUNA ☾☾",
     role: "UX/UI Designer",
-    description: "designs pixel-perfect interfaces, champions user experience, applies psychology of user behavior, ensures visual consistency, accessibility, and intuitive interaction patterns",
-    groundRules: "Luna must review any UI changes for visual consistency, spacing, color harmony, accessibility (contrast, focus states), and intuitive interaction flow. She references specific components, screenshots, or design patterns.",
-    codePrinciple: "Reviews all UI changes for visual hierarchy, whitespace balance, color consistency, typography, responsive behavior, and accessibility (WCAG). Pushes back on cluttered layouts, inconsistent spacing, poor contrast, or confusing interaction flows. Proposes specific CSS/styling improvements with exact values.",
-    brainstorm: { tag: "THINK", focus: "UX/UI impact, visual consistency, interaction patterns, accessibility" },
-    planning: "UX Review (visual impact, layout concerns, accessibility checklist, interaction improvements). For UI tasks: define which pages/views need screenshots and whether desktop, mobile, or both are relevant.",
+    description: "reviews UI changes for visual consistency, accessibility, and UX",
+    groundRules: "Luna references specific components and proposes exact CSS fixes.",
+    codePrinciple: "Reviews visual hierarchy, spacing, color, typography, responsive behavior, accessibility (WCAG).",
+    planning: "UX review: visual impact, accessibility. For UI tasks: define screenshot plan (pages, viewports).",
     execution: {
-      step: "Luna reviews UI changes (if applicable)",
+      step: "Luna reviews UI (if applicable)",
       tasks: [
-        "Read any changed component, page, or style files.",
-        "Check visual hierarchy, spacing consistency, color harmony, typography.",
-        "Verify accessibility: contrast ratios, focus states, keyboard navigation, screen reader labels.",
-        "Check responsive behavior and interaction flow.",
-        "If issues found, propose specific fixes (exact CSS values, spacing, colors). The developer implements them before proceeding.",
-        "Define the screenshot plan: which pages/routes to capture and which viewports (desktop, mobile, or both). Hand this plan to Bart.",
-        "Skip this step if the task has no UI impact.",
+        "Read changed UI files. Check visual consistency and accessibility.",
+        "Propose specific fixes if needed. Developer implements.",
+        "Hand screenshot plan to Bart. Skip if no UI impact.",
       ],
       order: 2.1,
     },
@@ -120,19 +106,16 @@ export const BUILT_IN_AGENTS = {
   Mark: {
     badge: "✦✦ MARK ✦✦",
     role: "Content Writer",
-    description: "crafts precise, engaging copy for UI text, error messages, tooltips, onboarding flows, and documentation. Simplifies technical language into friendly, clear wording. Ensures consistent tone and voice across the product",
-    groundRules: "Mark must review all user-facing text — labels, buttons, headings, error messages, tooltips, empty states, confirmation dialogs. He ensures the tone is friendly and consistent, wording is concise, and technical jargon is avoided unless the audience is technical.",
-    codePrinciple: "Reviews all user-facing strings in changed files. Rewrites vague, wordy, or technical copy into clear, concise, human-friendly language. Ensures consistent voice — no mixing formal and casual tone. Checks empty states, error messages, and confirmation dialogs for helpfulness.",
-    brainstorm: { tag: "THINK", focus: "copy clarity, tone, user-facing text quality" },
-    planning: "Content Review (user-facing text audit, tone, clarity, empty states, error messages)",
+    description: "reviews user-facing text for clarity, tone, and consistency",
+    groundRules: "Mark reviews all labels, buttons, error messages, tooltips, and empty states.",
+    codePrinciple: "Rewrites vague or jargon-heavy copy into clear, concise language. Ensures consistent tone.",
+    planning: "Content review: user-facing text audit, tone consistency",
     execution: {
       step: "Mark reviews content (if applicable)",
       tasks: [
-        "Read all changed files that contain user-facing text (components, templates, error handlers).",
-        "Check every label, button, heading, tooltip, error message, empty state, and confirmation dialog.",
-        "Rewrite anything vague, wordy, jargon-heavy, or inconsistent in tone.",
-        "Propose exact replacement strings. The developer implements them.",
-        "Skip this step if the task has no user-facing text changes.",
+        "Read changed files with user-facing text.",
+        "Propose exact replacement strings if needed. Developer implements.",
+        "Skip if no user-facing text changes.",
       ],
       order: 2.2,
     },
@@ -172,7 +155,6 @@ export function resolveTeam(config) {
             role: custom.role || "Team Member",
             description: custom.role || "Custom team member",
             groundRules: custom.when ? `${custom.name} is invoked: ${custom.when}. How to use: ${custom.how || "as needed"}.` : "",
-            brainstorm: { tag: "SAY", focus: custom.role || "general input" },
             planning: `${custom.role || custom.name} Review`,
             execution: custom.when ? {
               step: `${custom.name} reviews`,
@@ -201,7 +183,6 @@ export function resolveTeam(config) {
           role: entry.role || "Team Member",
           description: entry.description || entry.role || "Custom team member",
           groundRules: entry.groundRules || "",
-          brainstorm: entry.brainstorm || { tag: "SAY", focus: entry.role || "general input" },
           planning: entry.planning || `${entry.role || entry.name} Review`,
           execution: entry.execution || null,
         });
@@ -242,9 +223,9 @@ export function generateTeamPrompt(team) {
 
   // Ground rules
   const rules = [];
-  rules.push(`1. Each agent speaks in turn, prefixed with their badge (e.g., "${team[0].badge} Starting.").`);
-  rules.push(`2. ALL text output MUST be prefixed with the acting agent's badge. Never output unprefixed text.`);
-  rules.push(`3. Agents should DISAGREE when they see problems — don't rubber-stamp each other.`);
+  rules.push(`1. Each agent speaks prefixed with their badge (e.g., "${team[0].badge} ...").`);
+  rules.push(`2. ALL text output MUST be prefixed with the acting agent's badge.`);
+  rules.push(`3. Raise concerns when you see problems — don't rubber-stamp.`);
   let ruleNum = 4;
   for (const a of team) {
     if (a.groundRules) {
@@ -252,7 +233,6 @@ export function generateTeamPrompt(team) {
       ruleNum++;
     }
   }
-  rules.push(`${ruleNum}. Every statement should add value — no filler, no repeating what someone else already said.`);
   sections.groundRules = rules.join("\n");
 
   // Code principles
@@ -261,11 +241,6 @@ export function generateTeamPrompt(team) {
     .map(a => `- ${a.name}: ${a.codePrinciple}`);
   sections.codePrinciples = principles.length > 0 ? principles.join("\n") : "";
 
-  // Brainstorm order
-  sections.brainstormOrder = team.map((a, i) =>
-    `${i + 1}. ${a.badge}  [${a.brainstorm.tag}]  ${a.brainstorm.focus}`
-  ).join("\n");
-
   // Planning presentations
   sections.planningOrder = team.map(a =>
     `${a.badge}  ${a.planning}`

package/cli/daemon.mjs

@@ -313,7 +313,7 @@ export async function runDaemon() {
 
   // 4. Session handling
 
-  async function handleStartSession({ sessionId, projectId, taskId: remoteTaskId, prompt, mode }) {
+  async function handleStartSession({ sessionId, projectId, taskId: remoteTaskId, prompt }) {
     // Validate project against local allowlist
     const project = projects.find(p => p.id === projectId);
     if (!project) {
@@ -379,7 +379,6 @@ export async function runDaemon() {
         project: detected, team, teamSections,
         inboxUrl, sessionUrl,
         cwd: project.path,
-        mode: mode || "full",
         apiKey,
         serverUrl: agentdeskServer,
         onEvent(event) {

package/cli/init.mjs

@@ -7,6 +7,7 @@ import { detectProject } from "./detect.mjs";
 import { loadConfig } from "./config.mjs";
 import { getStoredApiKey } from "./login.mjs";
 import { registerLocalProject } from "./projects.mjs";
+import { checkTrackerPermissions, resolveCredentialsFromEnv } from "./tracker-check.mjs";
 
 const SERVER = process.env.AGENTDESK_SERVER || "https://agentdesk.live";
 
@@ -62,6 +63,12 @@ export async function runInit(cwd) {
   if (project.lintCommand) console.log(`  Lint:         ${project.lintCommand}`);
   if (project.testCommand || project.buildCommand || project.lintCommand) console.log("");
 
+  // --- Project key ---
+  const defaultKey = existingConfig.projectKey || projectId;
+  const keyAnswer = await ask(rl, `  Project key (${defaultKey}): `);
+  const finalProjectKey = keyAnswer.trim() || defaultKey;
+  console.log("");
+
   // --- Tracker selection ---
   const trackerOptions = [
     { label: "Linear", value: "linear" },
@@ -75,22 +82,28 @@ export async function runInit(cwd) {
   console.log("");
 
   // Build config
-  const config = {};
+  const config = { projectKey: finalProjectKey };
   if (tracker) config.tracker = tracker;
 
   if (tracker === "linear") {
-    const current = existingConfig.linear?.workspace || "";
-    const answer = await ask(rl, `  Linear workspace slug${current ? ` (${current})` : ""}: `);
-    const ws = answer.trim() || current;
-    if (ws) config.linear = { workspace: ws };
+    const currentWs = existingConfig.linear?.workspace || "";
+    const wsAnswer = await ask(rl, `  Linear workspace slug${currentWs ? ` (${currentWs})` : ""}: `);
+    const ws = wsAnswer.trim() || currentWs;
+    const currentKey = existingConfig.linear?.teamKey || "";
+    const keyAnswer = await ask(rl, `  Linear team key${currentKey ? ` (${currentKey})` : ""} (e.g. KEN): `);
+    const teamKey = keyAnswer.trim() || currentKey;
+    if (ws || teamKey) config.linear = { ...(ws && { workspace: ws }), ...(teamKey && { teamKey }) };
     console.log("");
   }
 
   if (tracker === "jira") {
-    const current = existingConfig.jira?.baseUrl || "";
-    const answer = await ask(rl, `  Jira base URL${current ? ` (${current})` : ""}: `);
-    const url = answer.trim() || current;
-    if (url) config.jira = { baseUrl: url };
+    const currentUrl = existingConfig.jira?.baseUrl || "";
+    const urlAnswer = await ask(rl, `  Jira base URL${currentUrl ? ` (${currentUrl})` : ""}: `);
+    const url = urlAnswer.trim() || currentUrl;
+    const currentProj = existingConfig.jira?.project || "";
+    const projAnswer = await ask(rl, `  Jira project key${currentProj ? ` (${currentProj})` : ""} (e.g. PROJ): `);
+    const proj = projAnswer.trim() || currentProj;
+    if (url || proj) config.jira = { ...(url && { baseUrl: url }), ...(proj && { project: proj }) };
     console.log("");
   }
 
@@ -102,12 +115,64 @@ export async function runInit(cwd) {
     console.log("");
   }
 
+  // --- Verify tracker permissions ---
+  if (tracker) {
+    console.log("  Checking tracker permissions...");
+    const envPath = join(cwd, ".env");
+    let dotEnv = {};
+    if (existsSync(envPath)) {
+      for (const line of readFileSync(envPath, "utf-8").split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) continue;
+        const eq = trimmed.indexOf("=");
+        if (eq !== -1) dotEnv[trimmed.slice(0, eq)] = trimmed.slice(eq + 1);
+      }
+    }
+
+    // Also try fetching credentials from server
+    const apiKey = loadApiKey(cwd);
+    let serverCreds = {};
+    if (apiKey) {
+      try {
+        const res = await fetch(`${SERVER}/api/projects/${finalProjectKey}/settings/credentials`, {
+          headers: { "x-api-key": apiKey },
+          signal: AbortSignal.timeout(5000),
+        });
+        if (res.ok) serverCreds = await res.json();
+      } catch {}
+    }
+
+    const credentials = resolveCredentialsFromEnv({ ...dotEnv, ...serverCreds });
+    const check = await checkTrackerPermissions({ tracker, config, credentials });
+
+    if (!check.ok) {
+      console.log("");
+      console.log("  ⚠  Tracker permission issues:");
+      for (const err of check.errors) {
+        console.log(`     • ${err}`);
+      }
+      console.log("");
+      const proceed = await ask(rl, "  Continue anyway? (y/N): ");
+      if (proceed.trim().toLowerCase() !== "y") {
+        console.log("  Setup cancelled. Fix the issues above and run 'agentdesk init' again.");
+        rl.close();
+        return;
+      }
+      console.log("");
+    } else {
+      console.log("  ✓ Tracker permissions verified (read, create, update)");
+      console.log("");
+    }
+  }
+
   // --- Save .agentdesk.json ---
   let merged = {};
   if (hasConfig) {
     try { merged = JSON.parse(readFileSync(configPath, "utf-8")); } catch {}
   }
 
+  merged.projectKey = finalProjectKey;
+
   if (tracker) {
     merged.tracker = tracker;
     if (config.linear) merged.linear = config.linear;
@@ -124,7 +189,7 @@ export async function runInit(cwd) {
   console.log(`  Saved .agentdesk.json`);
 
   // Register in local project index (for daemon discovery)
-  registerLocalProject(projectId, project.name || projectId, project.dir);
+  registerLocalProject(finalProjectKey, project.name || finalProjectKey, project.dir);
 
   // --- Register with server ---
   try {
@@ -135,8 +200,8 @@ export async function runInit(cwd) {
         ...(loadApiKey(cwd) ? { "x-api-key": loadApiKey(cwd) } : {}),
       },
       body: JSON.stringify({
-        id: projectId,
-        name: project.name || projectId,
+        id: finalProjectKey,
+        name: project.name || finalProjectKey,
         path: project.dir,
         type: project.type,
         tracker,
@@ -148,7 +213,7 @@ export async function runInit(cwd) {
     // Push settings to server
     const key = loadApiKey(cwd);
     if (key) {
-      await fetch(`${SERVER}/api/projects/${projectId}/settings`, {
+      await fetch(`${SERVER}/api/projects/${finalProjectKey}/settings`, {
         method: "PUT",
         headers: { "Content-Type": "application/json", "x-api-key": key },
         body: JSON.stringify(merged),