@locusai/cli 0.13.0 → 0.13.2

package/bin/locus.js

@@ -6393,7 +6393,8 @@ var init_config = __esm(() => {
     documentsDir: "documents",
     sessionsDir: "sessions",
     reviewsDir: "reviews",
-    plansDir: "plans"
+    plansDir: "plans",
+    discussionsDir: "discussions"
   };
   LOCUS_GITIGNORE_PATTERNS = [
     "# Locus AI - Session data (user-specific, can grow large)",
@@ -6408,6 +6409,9 @@ var init_config = __esm(() => {
     "# Locus AI - Plans (generated per task)",
     ".locus/plans/",
     "",
+    "# Locus AI - Discussions (AI discussion sessions)",
+    ".locus/discussions/",
+    "",
     "# Locus AI - Settings (contains API key, telegram config, etc.)",
     ".locus/settings.json",
     "",
@@ -38244,7 +38248,8 @@ var init_session = __esm(() => {
     model: exports_external.string().optional(),
     createdAt: exports_external.number(),
     updatedAt: exports_external.number(),
-    title: exports_external.string().optional()
+    title: exports_external.string().optional(),
+    prompt: exports_external.string().optional()
   });
   SessionSummarySchema = exports_external.object({
     sessionId: exports_external.string(),
@@ -38611,6 +38616,39 @@ var init_workspaces = __esm(() => {
   };
 });
 
+// ../sdk/src/discussion/discussion-types.ts
+var DiscussionMessageSchema, DiscussionInsightSchema, DiscussionSchema;
+var init_discussion_types = __esm(() => {
+  init_zod();
+  DiscussionMessageSchema = exports_external.object({
+    role: exports_external.enum(["user", "assistant"]),
+    content: exports_external.string(),
+    timestamp: exports_external.number()
+  });
+  DiscussionInsightSchema = exports_external.object({
+    id: exports_external.string(),
+    type: exports_external.enum(["decision", "requirement", "idea", "concern", "learning"]),
+    title: exports_external.string(),
+    content: exports_external.string(),
+    tags: exports_external.array(exports_external.string()).default([]),
+    createdAt: exports_external.string()
+  });
+  DiscussionSchema = exports_external.object({
+    id: exports_external.string(),
+    title: exports_external.string(),
+    topic: exports_external.string(),
+    status: exports_external.enum(["active", "completed", "archived"]).default("active"),
+    messages: exports_external.array(DiscussionMessageSchema).default([]),
+    insights: exports_external.array(DiscussionInsightSchema).default([]),
+    createdAt: exports_external.string(),
+    updatedAt: exports_external.string(),
+    metadata: exports_external.object({
+      model: exports_external.string(),
+      provider: exports_external.string()
+    })
+  });
+});
+
 // ../sdk/src/index.ts
 class LocusClient {
   api;
@@ -38712,6 +38750,7 @@ var init_src2 = __esm(() => {
   init_sprints();
   init_tasks();
   init_workspaces();
+  init_discussion_types();
   init_events();
   init_auth();
   init_ci();
@@ -38936,10 +38975,198 @@ var init_reviewer_worker = __esm(() => {
   }
 });
 
-// ../sdk/src/core/prompt-builder.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
+// ../sdk/src/discussion/discussion-manager.ts
+import {
+  existsSync as existsSync5,
+  mkdirSync as mkdirSync3,
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync5,
+  unlinkSync as unlinkSync2,
+  writeFileSync as writeFileSync3
+} from "node:fs";
 import { join as join6 } from "node:path";
 
+class DiscussionManager {
+  discussionsDir;
+  constructor(projectPath) {
+    this.discussionsDir = getLocusPath(projectPath, "discussionsDir");
+  }
+  create(topic, model, provider) {
+    this.ensureDir();
+    const now = new Date().toISOString();
+    const id = `disc-${Date.now()}`;
+    const discussion = {
+      id,
+      title: topic,
+      topic,
+      status: "active",
+      messages: [],
+      insights: [],
+      createdAt: now,
+      updatedAt: now,
+      metadata: { model, provider }
+    };
+    this.save(discussion);
+    return discussion;
+  }
+  save(discussion) {
+    this.ensureDir();
+    const jsonPath = join6(this.discussionsDir, `${discussion.id}.json`);
+    const mdPath = join6(this.discussionsDir, `summary-${discussion.id}.md`);
+    writeFileSync3(jsonPath, JSON.stringify(discussion, null, 2), "utf-8");
+    writeFileSync3(mdPath, this.toMarkdown(discussion), "utf-8");
+  }
+  load(id) {
+    this.ensureDir();
+    const filePath = join6(this.discussionsDir, `${id}.json`);
+    if (!existsSync5(filePath)) {
+      return null;
+    }
+    try {
+      return JSON.parse(readFileSync5(filePath, "utf-8"));
+    } catch {
+      return null;
+    }
+  }
+  list(status) {
+    this.ensureDir();
+    const files = readdirSync2(this.discussionsDir).filter((f) => f.endsWith(".json"));
+    const discussions = [];
+    for (const file2 of files) {
+      try {
+        const discussion = JSON.parse(readFileSync5(join6(this.discussionsDir, file2), "utf-8"));
+        if (!status || discussion.status === status) {
+          discussions.push(discussion);
+        }
+      } catch {}
+    }
+    discussions.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    return discussions;
+  }
+  complete(id) {
+    const discussion = this.load(id);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${id}`);
+    }
+    discussion.status = "completed";
+    discussion.updatedAt = new Date().toISOString();
+    this.save(discussion);
+    return discussion;
+  }
+  archive(id) {
+    const discussion = this.load(id);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${id}`);
+    }
+    discussion.status = "archived";
+    discussion.updatedAt = new Date().toISOString();
+    this.save(discussion);
+  }
+  delete(id) {
+    this.ensureDir();
+    const jsonPath = join6(this.discussionsDir, `${id}.json`);
+    const mdPath = join6(this.discussionsDir, `summary-${id}.md`);
+    if (existsSync5(jsonPath)) {
+      unlinkSync2(jsonPath);
+    }
+    if (existsSync5(mdPath)) {
+      unlinkSync2(mdPath);
+    }
+  }
+  addMessage(id, role, content) {
+    const discussion = this.load(id);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${id}`);
+    }
+    discussion.messages.push({
+      role,
+      content,
+      timestamp: Date.now()
+    });
+    discussion.updatedAt = new Date().toISOString();
+    this.save(discussion);
+    return discussion;
+  }
+  addInsight(id, insight) {
+    const discussion = this.load(id);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${id}`);
+    }
+    discussion.insights.push(insight);
+    discussion.updatedAt = new Date().toISOString();
+    this.save(discussion);
+    return discussion;
+  }
+  getAllInsights() {
+    const discussions = this.list("completed");
+    const insights = [];
+    for (const discussion of discussions) {
+      insights.push(...discussion.insights);
+    }
+    insights.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    return insights;
+  }
+  getMarkdown(id) {
+    const discussion = this.load(id);
+    if (!discussion)
+      return null;
+    return this.toMarkdown(discussion);
+  }
+  toMarkdown(discussion) {
+    const lines = [];
+    lines.push(`# Discussion: ${discussion.title}`);
+    lines.push("");
+    lines.push(`**Status:** ${discussion.status.toUpperCase()}`);
+    lines.push(`**Topic:** ${discussion.topic}`);
+    lines.push(`**Created:** ${discussion.createdAt}`);
+    lines.push(`**Updated:** ${discussion.updatedAt}`);
+    lines.push(`**Model:** ${discussion.metadata.model} (${discussion.metadata.provider})`);
+    lines.push("");
+    if (discussion.messages.length > 0) {
+      lines.push(`## Messages (${discussion.messages.length})`);
+      lines.push("");
+      for (const msg of discussion.messages) {
+        const time3 = new Date(msg.timestamp).toISOString();
+        const roleLabel = msg.role === "user" ? "User" : "Assistant";
+        lines.push(`### ${roleLabel} — ${time3}`);
+        lines.push("");
+        lines.push(msg.content);
+        lines.push("");
+      }
+    }
+    if (discussion.insights.length > 0) {
+      lines.push(`## Insights (${discussion.insights.length})`);
+      lines.push("");
+      for (const insight of discussion.insights) {
+        lines.push(`### [${insight.type.toUpperCase()}] ${insight.title}`);
+        lines.push("");
+        lines.push(insight.content);
+        if (insight.tags.length > 0) {
+          lines.push("");
+          lines.push(`**Tags:** ${insight.tags.join(", ")}`);
+        }
+        lines.push("");
+      }
+    }
+    lines.push("---");
+    lines.push(`*Discussion ID: ${discussion.id}*`);
+    return lines.join(`
+`);
+  }
+  ensureDir() {
+    if (!existsSync5(this.discussionsDir)) {
+      mkdirSync3(this.discussionsDir, { recursive: true });
+    }
+  }
+}
+var init_discussion_manager = __esm(() => {
+  init_config();
+});
+
+// ../sdk/src/core/prompt-builder.ts
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "node:fs";
+import { join as join7 } from "node:path";
+
 class PromptBuilder {
   projectPath;
   constructor(projectPath) {
@@ -38977,6 +39204,15 @@ ${knowledgeBase}
 These are accumulated lessons from past tasks. Follow them to avoid repeating mistakes:
 ${learnings}
 </learnings>
+`;
+    }
+    const discussionInsights = this.getDiscussionInsightsContent();
+    if (discussionInsights) {
+      sections += `
+<discussion_insights>
+These are key decisions and insights from product discussions. Follow them to maintain product coherence:
+${discussionInsights}
+</discussion_insights>
 `;
     }
     if (task2.docs && task2.docs.length > 0) {
@@ -39065,6 +39301,15 @@ ${knowledgeBase}
 These are accumulated lessons from past tasks. Follow them to avoid repeating mistakes:
 ${learnings}
 </learnings>
+`;
+    }
+    const discussionInsights = this.getDiscussionInsightsContent();
+    if (discussionInsights) {
+      sections += `
+<discussion_insights>
+These are key decisions and insights from product discussions. Follow them to maintain product coherence:
+${discussionInsights}
+</discussion_insights>
 `;
     }
     return `<direct_execution>
@@ -39079,9 +39324,9 @@ ${sections}
   }
   getProjectContext() {
     const contextPath = getLocusPath(this.projectPath, "contextFile");
-    if (existsSync5(contextPath)) {
+    if (existsSync6(contextPath)) {
       try {
-        const context2 = readFileSync5(contextPath, "utf-8");
+        const context2 = readFileSync6(contextPath, "utf-8");
         if (context2.trim().length > 20) {
           return context2;
         }
@@ -39092,10 +39337,10 @@ ${sections}
     return this.getFallbackContext() || null;
   }
   getFallbackContext() {
-    const readmePath = join6(this.projectPath, "README.md");
-    if (existsSync5(readmePath)) {
+    const readmePath = join7(this.projectPath, "README.md");
+    if (existsSync6(readmePath)) {
       try {
-        const content = readFileSync5(readmePath, "utf-8");
+        const content = readFileSync6(readmePath, "utf-8");
         const limit = 1000;
         return content.slice(0, limit) + (content.length > limit ? `
 ...(truncated)...` : "");
@@ -39109,15 +39354,16 @@ ${sections}
     return `You have access to the following documentation directories for context:
 - Artifacts: \`.locus/artifacts\` (local-only, not synced to cloud)
 - Documents: \`.locus/documents\` (synced from cloud)
+- Discussions: \`.locus/discussions\` (product discussion insights and decisions)
 If you need more information about the project strategies, plans, or architecture, read files in these directories.`;
   }
   getLearningsContent() {
     const learningsPath = getLocusPath(this.projectPath, "learningsFile");
-    if (!existsSync5(learningsPath)) {
+    if (!existsSync6(learningsPath)) {
       return null;
     }
     try {
-      const content = readFileSync5(learningsPath, "utf-8");
+      const content = readFileSync6(learningsPath, "utf-8");
       const lines = content.split(`
 `).filter((l) => l.startsWith("- "));
       if (lines.length === 0) {
@@ -39129,6 +39375,53 @@ If you need more information about the project strategies, plans, or architectur
       return null;
     }
   }
+  getDiscussionInsightsContent() {
+    try {
+      const manager = new DiscussionManager(this.projectPath);
+      const insights = manager.getAllInsights();
+      if (insights.length === 0) {
+        return null;
+      }
+      const groups = {};
+      for (const insight of insights) {
+        const key = insight.type;
+        if (!groups[key]) {
+          groups[key] = [];
+        }
+        groups[key].push(insight);
+      }
+      const typeLabels = {
+        decision: "Decisions",
+        requirement: "Requirements",
+        idea: "Ideas",
+        concern: "Concerns",
+        learning: "Learnings"
+      };
+      let output = "";
+      for (const [type, label] of Object.entries(typeLabels)) {
+        const items = groups[type];
+        if (!items || items.length === 0)
+          continue;
+        output += `## ${label}
+`;
+        for (const item of items) {
+          output += `- [${item.title}]: ${item.content}
+`;
+        }
+        output += `
+`;
+      }
+      if (output.length === 0) {
+        return null;
+      }
+      if (output.length > 2000) {
+        output = `${output.slice(0, 1997)}...`;
+      }
+      return output.trimEnd();
+    } catch {
+      return null;
+    }
+  }
   roleToText(role) {
     if (!role) {
       return null;
@@ -39151,6 +39444,7 @@ If you need more information about the project strategies, plans, or architectur
 }
 var init_prompt_builder = __esm(() => {
   init_src();
+  init_discussion_manager();
   init_config();
 });
 
@@ -39467,7 +39761,6 @@ Branch: \`${result.branch}\`` : "";
       this.log("All tasks done. Creating pull request...", "info");
       const prResult = this.gitWorkflow.createPullRequest(this.completedTaskList, this.taskSummaries);
       if (prResult.url) {
-        this.log(`PR created: ${prResult.url}`, "success");
         for (const task2 of this.completedTaskList) {
           try {
             await this.client.tasks.update(task2.id, this.config.workspaceId, {
@@ -39535,6 +39828,349 @@ var init_core3 = __esm(() => {
   init_prompt_builder();
 });
 
+// ../sdk/src/discussion/agents/facilitator-prompt.ts
+function buildFacilitatorPrompt(input) {
+  const {
+    topic,
+    projectContext,
+    learnings,
+    knowledgeBase,
+    previousMessages,
+    insights,
+    isFirstMessage
+  } = input;
+  let sections = "";
+  if (projectContext) {
+    sections += `
+<project_context>
+${projectContext}
+</project_context>
+`;
+  }
+  sections += `
+<knowledge_base>
+${knowledgeBase}
+</knowledge_base>
+`;
+  if (learnings) {
+    sections += `
+<learnings>
+These are accumulated lessons from past work on this project. Use them to ask more informed questions:
+${learnings}
+</learnings>
+`;
+  }
+  if (previousMessages.length > 0) {
+    let history = "";
+    for (const msg of previousMessages) {
+      const role = msg.role === "user" ? "User" : "Facilitator";
+      history += `[${role}]: ${msg.content}
+
+`;
+    }
+    sections += `
+<conversation_history>
+${history.trimEnd()}
+</conversation_history>
+`;
+  }
+  if (insights.length > 0) {
+    let insightsText = "";
+    for (const insight of insights) {
+      insightsText += `- [${insight.type.toUpperCase()}] ${insight.title}: ${insight.content}
+`;
+    }
+    sections += `
+<extracted_insights>
+Insights identified so far in this discussion:
+${insightsText.trimEnd()}
+</extracted_insights>
+`;
+  }
+  const firstMessageInstruction = isFirstMessage ? `This is the START of the discussion. Introduce yourself briefly, then ask your first probing question about the topic. Do NOT extract any insights yet — there is no user input to extract from.` : `Continue the discussion by responding to the user's latest message. Build on their answers to go deeper. After responding, extract any insights from their message.`;
+  return `<discussion_facilitator>
+You are a product strategy facilitator leading a structured discussion.
+
+<topic>
+${topic}
+</topic>
+${sections}
+<role>
+You are an expert product strategy facilitator. Your job is to:
+1. Ask probing, specific questions about the topic — never generic or surface-level
+2. Build on previous answers to progressively deepen the conversation
+3. Identify and extract key decisions, requirements, ideas, concerns, and learnings
+4. Reference existing project context and learnings to ask informed questions
+5. When the topic feels fully explored, suggest wrapping up with a summary
+</role>
+
+<rules>
+- ${firstMessageInstruction}
+- Ask ONE focused question at a time. Do not overwhelm with multiple questions.
+- Be conversational but purposeful — every question should drive toward actionable insights.
+- When you identify an insight from the user's response, include it as a structured XML block in your response.
+- Insight blocks use this format within your response text:
+
+<insight>
+{"type": "decision|requirement|idea|concern|learning", "title": "short title", "content": "detailed description", "tags": ["relevant", "tags"]}
+</insight>
+
+- You may include multiple <insight> blocks if the user's response contains several distinct insights.
+- The insight blocks will be parsed and removed from the displayed response, so write your conversational text as if they are not there.
+- Types explained:
+  - **decision**: A choice or direction that has been made or agreed upon
+  - **requirement**: A specific need, constraint, or must-have
+  - **idea**: A suggestion, proposal, or possibility to explore
+  - **concern**: A risk, worry, or potential problem identified
+  - **learning**: A realization, lesson, or important context discovered
+- Keep responses concise. Aim for 2-4 sentences of conversation plus any insight blocks.
+- If the user's responses indicate the topic is well-explored, suggest summarizing and wrapping up.
+</rules>
+</discussion_facilitator>`;
+}
+function buildSummaryPrompt(topic, messages, insights) {
+  let history = "";
+  for (const msg of messages) {
+    const role = msg.role === "user" ? "User" : "Facilitator";
+    history += `[${role}]: ${msg.content}
+
+`;
+  }
+  let insightsText = "";
+  if (insights.length > 0) {
+    for (const insight of insights) {
+      insightsText += `- [${insight.type.toUpperCase()}] **${insight.title}**: ${insight.content}`;
+      if (insight.tags.length > 0) {
+        insightsText += ` (tags: ${insight.tags.join(", ")})`;
+      }
+      insightsText += `
+`;
+    }
+  }
+  return `<discussion_summary>
+Create a final summary of this product discussion.
+
+<topic>
+${topic}
+</topic>
+
+<conversation>
+${history.trimEnd()}
+</conversation>
+
+${insightsText ? `<insights>
+${insightsText.trimEnd()}
+</insights>
+` : ""}
+<rules>
+- Write a clear, structured summary of the entire discussion.
+- Organize by: Key Decisions, Requirements, Ideas to Explore, Concerns & Risks, and Learnings.
+- Only include sections that have relevant content — skip empty categories.
+- For each item, provide a brief but actionable description.
+- End with a "Next Steps" section listing concrete action items that emerged.
+- Be concise — this summary should be scannable and useful as a reference.
+- Do NOT include any <insight> XML blocks in the summary.
+</rules>
+</discussion_summary>`;
+}
+
+// ../sdk/src/discussion/discussion-facilitator.ts
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "node:fs";
+
+class DiscussionFacilitator {
+  projectPath;
+  aiRunner;
+  discussionManager;
+  log;
+  provider;
+  model;
+  constructor(config2) {
+    this.projectPath = config2.projectPath;
+    this.aiRunner = config2.aiRunner;
+    this.discussionManager = config2.discussionManager;
+    this.log = config2.log ?? ((_msg) => {
+      return;
+    });
+    this.provider = config2.provider;
+    this.model = config2.model;
+  }
+  async startDiscussion(topic) {
+    this.log("Starting new discussion...", "info");
+    const discussion = this.discussionManager.create(topic, this.model, this.provider);
+    const { projectContext, learnings, knowledgeBase } = this.buildContext();
+    const prompt = buildFacilitatorPrompt({
+      topic,
+      projectContext,
+      learnings,
+      knowledgeBase,
+      previousMessages: [],
+      insights: [],
+      isFirstMessage: true
+    });
+    const response = await this.aiRunner.run(prompt);
+    const { cleanResponse } = this.parseInsights(response);
+    this.discussionManager.addMessage(discussion.id, "assistant", cleanResponse);
+    this.log("Discussion started", "success");
+    const saved = this.discussionManager.load(discussion.id);
+    if (!saved) {
+      throw new Error(`Failed to load discussion after creation: ${discussion.id}`);
+    }
+    return {
+      discussion: saved,
+      message: cleanResponse
+    };
+  }
+  async continueDiscussion(discussionId, userMessage) {
+    const discussion = this.discussionManager.load(discussionId);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${discussionId}`);
+    }
+    const updated = this.discussionManager.addMessage(discussionId, "user", userMessage);
+    const { projectContext, learnings, knowledgeBase } = this.buildContext();
+    const prompt = buildFacilitatorPrompt({
+      topic: updated.topic,
+      projectContext,
+      learnings,
+      knowledgeBase,
+      previousMessages: updated.messages,
+      insights: updated.insights,
+      isFirstMessage: false
+    });
+    const response = await this.aiRunner.run(prompt);
+    const { cleanResponse, insights } = this.parseInsights(response);
+    for (const insight of insights) {
+      this.discussionManager.addInsight(discussionId, insight);
+    }
+    this.discussionManager.addMessage(discussionId, "assistant", cleanResponse);
+    return { response: cleanResponse, insights };
+  }
+  async* continueDiscussionStream(discussionId, userMessage) {
+    const discussion = this.discussionManager.load(discussionId);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${discussionId}`);
+    }
+    const updated = this.discussionManager.addMessage(discussionId, "user", userMessage);
+    const { projectContext, learnings, knowledgeBase } = this.buildContext();
+    const prompt = buildFacilitatorPrompt({
+      topic: updated.topic,
+      projectContext,
+      learnings,
+      knowledgeBase,
+      previousMessages: updated.messages,
+      insights: updated.insights,
+      isFirstMessage: false
+    });
+    let fullResponse = "";
+    const stream4 = this.aiRunner.runStream(prompt);
+    for await (const chunk of stream4) {
+      yield chunk;
+      if (chunk.type === "text_delta") {
+        fullResponse += chunk.content;
+      } else if (chunk.type === "result") {
+        fullResponse = chunk.content;
+      }
+    }
+    const { cleanResponse, insights } = this.parseInsights(fullResponse);
+    for (const insight of insights) {
+      this.discussionManager.addInsight(discussionId, insight);
+    }
+    this.discussionManager.addMessage(discussionId, "assistant", cleanResponse);
+    return { response: cleanResponse, insights };
+  }
+  async summarizeDiscussion(discussionId) {
+    const discussion = this.discussionManager.load(discussionId);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${discussionId}`);
+    }
+    this.log("Generating discussion summary...", "info");
+    const prompt = buildSummaryPrompt(discussion.topic, discussion.messages, discussion.insights);
+    const summary = await this.aiRunner.run(prompt);
+    this.discussionManager.addMessage(discussionId, "assistant", summary);
+    this.discussionManager.complete(discussionId);
+    this.log("Discussion summarized and completed", "success");
+    return summary;
+  }
+  parseInsights(response) {
+    const insights = [];
+    const insightRegex = /<insight>\s*([\s\S]*?)\s*<\/insight>/g;
+    let match = insightRegex.exec(response);
+    while (match !== null) {
+      try {
+        const parsed = JSON.parse(match[1]);
+        const id = `ins-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`;
+        insights.push({
+          id,
+          type: parsed.type,
+          title: parsed.title,
+          content: parsed.content,
+          tags: parsed.tags ?? [],
+          createdAt: new Date().toISOString()
+        });
+      } catch {}
+      match = insightRegex.exec(response);
+    }
+    const cleanResponse = response.replace(/<insight>\s*[\s\S]*?\s*<\/insight>/g, "").replace(/\n{3,}/g, `
+
+`).trim();
+    return { cleanResponse, insights };
+  }
+  buildContext() {
+    return {
+      projectContext: this.getProjectContext(),
+      learnings: this.getLearningsContent(),
+      knowledgeBase: this.getKnowledgeBaseSection()
+    };
+  }
+  getProjectContext() {
+    const contextPath = getLocusPath(this.projectPath, "contextFile");
+    if (existsSync7(contextPath)) {
+      try {
+        const context2 = readFileSync7(contextPath, "utf-8");
+        if (context2.trim().length > 20) {
+          return context2;
+        }
+      } catch {
+        return null;
+      }
+    }
+    return null;
+  }
+  getLearningsContent() {
+    const learningsPath = getLocusPath(this.projectPath, "learningsFile");
+    if (!existsSync7(learningsPath)) {
+      return null;
+    }
+    try {
+      const content = readFileSync7(learningsPath, "utf-8");
+      const lines = content.split(`
+`).filter((l) => l.startsWith("- "));
+      if (lines.length === 0) {
+        return null;
+      }
+      return lines.join(`
+`);
+    } catch {
+      return null;
+    }
+  }
+  getKnowledgeBaseSection() {
+    return `You have access to the following documentation directories for context:
+- Artifacts: \`.locus/artifacts\` (local-only, not synced to cloud)
+- Documents: \`.locus/documents\` (synced from cloud)
+If you need more information about the project strategies, plans, or architecture, read files in these directories.`;
+  }
+}
+var init_discussion_facilitator = __esm(() => {
+  init_config();
+});
+
+// ../sdk/src/discussion/index.ts
+var init_discussion = __esm(() => {
+  init_discussion_facilitator();
+  init_discussion_manager();
+  init_discussion_types();
+});
+
 // ../sdk/src/exec/context-tracker.ts
 function generateArtifactId() {
   const timestamp = Date.now().toString(36);
@@ -39942,14 +40578,14 @@ var init_event_emitter = __esm(() => {
 
 // ../sdk/src/exec/history-manager.ts
 import {
-  existsSync as existsSync6,
-  mkdirSync as mkdirSync3,
-  readdirSync as readdirSync2,
-  readFileSync as readFileSync6,
+  existsSync as existsSync8,
+  mkdirSync as mkdirSync4,
+  readdirSync as readdirSync3,
+  readFileSync as readFileSync8,
   rmSync,
-  writeFileSync as writeFileSync3
+  writeFileSync as writeFileSync4
 } from "node:fs";
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 function generateSessionId2() {
   const timestamp = Date.now().toString(36);
   const random = Math.random().toString(36).substring(2, 9);
@@ -39960,30 +40596,30 @@ class HistoryManager {
   historyDir;
   maxSessions;
   constructor(projectPath, options) {
-    this.historyDir = options?.historyDir ?? join7(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.sessionsDir);
+    this.historyDir = options?.historyDir ?? join8(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.sessionsDir);
     this.maxSessions = options?.maxSessions ?? DEFAULT_MAX_SESSIONS;
     this.ensureHistoryDir();
   }
   ensureHistoryDir() {
-    if (!existsSync6(this.historyDir)) {
-      mkdirSync3(this.historyDir, { recursive: true });
+    if (!existsSync8(this.historyDir)) {
+      mkdirSync4(this.historyDir, { recursive: true });
     }
   }
   getSessionPath(sessionId) {
-    return join7(this.historyDir, `${sessionId}.json`);
+    return join8(this.historyDir, `${sessionId}.json`);
   }
   saveSession(session2) {
     const filePath = this.getSessionPath(session2.id);
     session2.updatedAt = Date.now();
-    writeFileSync3(filePath, JSON.stringify(session2, null, 2), "utf-8");
+    writeFileSync4(filePath, JSON.stringify(session2, null, 2), "utf-8");
   }
   loadSession(sessionId) {
     const filePath = this.getSessionPath(sessionId);
-    if (!existsSync6(filePath)) {
+    if (!existsSync8(filePath)) {
       return null;
     }
     try {
-      const content = readFileSync6(filePath, "utf-8");
+      const content = readFileSync8(filePath, "utf-8");
       return JSON.parse(content);
     } catch {
       return null;
@@ -39991,7 +40627,7 @@ class HistoryManager {
   }
   deleteSession(sessionId) {
     const filePath = this.getSessionPath(sessionId);
-    if (!existsSync6(filePath)) {
+    if (!existsSync8(filePath)) {
       return false;
     }
     try {
@@ -40002,7 +40638,7 @@ class HistoryManager {
     }
   }
   listSessions(options) {
-    const files = readdirSync2(this.historyDir);
+    const files = readdirSync3(this.historyDir);
     let sessions = [];
     for (const file2 of files) {
       if (file2.endsWith(".json")) {
@@ -40075,11 +40711,11 @@ class HistoryManager {
     return deleted;
   }
   getSessionCount() {
-    const files = readdirSync2(this.historyDir);
+    const files = readdirSync3(this.historyDir);
     return files.filter((f) => f.endsWith(".json")).length;
   }
   sessionExists(sessionId) {
-    return existsSync6(this.getSessionPath(sessionId));
+    return existsSync8(this.getSessionPath(sessionId));
   }
   findSessionByPartialId(partialId) {
     const sessions = this.listSessions();
@@ -40093,12 +40729,12 @@ class HistoryManager {
     return this.historyDir;
   }
   clearAllSessions() {
-    const files = readdirSync2(this.historyDir);
+    const files = readdirSync3(this.historyDir);
     let deleted = 0;
     for (const file2 of files) {
       if (file2.endsWith(".json")) {
         try {
-          rmSync(join7(this.historyDir, file2));
+          rmSync(join8(this.historyDir, file2));
           deleted++;
         } catch {}
       }
@@ -40387,8 +41023,8 @@ var init_git = __esm(() => {
 
 // ../sdk/src/orchestrator/index.ts
 import { spawn as spawn3 } from "node:child_process";
-import { existsSync as existsSync7 } from "node:fs";
-import { dirname as dirname2, join as join8 } from "node:path";
+import { existsSync as existsSync9 } from "node:fs";
+import { dirname as dirname2, join as join9 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { EventEmitter as EventEmitter4 } from "events";
 function killProcessTree(proc) {
@@ -40677,12 +41313,12 @@ ${agentId} finished (exit code: ${code})`);
       const currentModulePath = fileURLToPath2(import.meta.url);
       const currentModuleDir = dirname2(currentModulePath);
       const potentialPaths = [
-        join8(currentModuleDir, "..", "agent", "worker.js"),
-        join8(currentModuleDir, "agent", "worker.js"),
-        join8(currentModuleDir, "worker.js"),
-        join8(currentModuleDir, "..", "agent", "worker.ts")
+        join9(currentModuleDir, "..", "agent", "worker.js"),
+        join9(currentModuleDir, "agent", "worker.js"),
+        join9(currentModuleDir, "worker.js"),
+        join9(currentModuleDir, "..", "agent", "worker.ts")
       ];
-      return potentialPaths.find((p) => existsSync7(p));
+      return potentialPaths.find((p) => existsSync9(p));
     }
   };
 });
@@ -40794,14 +41430,14 @@ var init_sprint_plan = __esm(() => {
 
 // ../sdk/src/planning/plan-manager.ts
 import {
-  existsSync as existsSync8,
-  mkdirSync as mkdirSync4,
-  readdirSync as readdirSync3,
-  readFileSync as readFileSync7,
-  unlinkSync as unlinkSync2,
-  writeFileSync as writeFileSync4
+  existsSync as existsSync10,
+  mkdirSync as mkdirSync5,
+  readdirSync as readdirSync4,
+  readFileSync as readFileSync9,
+  unlinkSync as unlinkSync3,
+  writeFileSync as writeFileSync5
 } from "node:fs";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 
 class PlanManager {
   plansDir;
@@ -40811,19 +41447,19 @@ class PlanManager {
   save(plan) {
     this.ensurePlansDir();
     const slug = this.slugify(plan.name);
-    const jsonPath = join9(this.plansDir, `${slug}.json`);
-    const mdPath = join9(this.plansDir, `sprint-${slug}.md`);
-    writeFileSync4(jsonPath, JSON.stringify(plan, null, 2), "utf-8");
-    writeFileSync4(mdPath, sprintPlanToMarkdown(plan), "utf-8");
+    const jsonPath = join10(this.plansDir, `${slug}.json`);
+    const mdPath = join10(this.plansDir, `sprint-${slug}.md`);
+    writeFileSync5(jsonPath, JSON.stringify(plan, null, 2), "utf-8");
+    writeFileSync5(mdPath, sprintPlanToMarkdown(plan), "utf-8");
     return plan.id;
   }
   load(idOrSlug) {
     this.ensurePlansDir();
-    const files = readdirSync3(this.plansDir).filter((f) => f.endsWith(".json"));
+    const files = readdirSync4(this.plansDir).filter((f) => f.endsWith(".json"));
     for (const file2 of files) {
-      const filePath = join9(this.plansDir, file2);
+      const filePath = join10(this.plansDir, file2);
       try {
-        const plan = JSON.parse(readFileSync7(filePath, "utf-8"));
+        const plan = JSON.parse(readFileSync9(filePath, "utf-8"));
         if (plan.id === idOrSlug || this.slugify(plan.name) === idOrSlug) {
           return plan;
         }
@@ -40833,11 +41469,11 @@ class PlanManager {
   }
   list(status) {
     this.ensurePlansDir();
-    const files = readdirSync3(this.plansDir).filter((f) => f.endsWith(".json"));
+    const files = readdirSync4(this.plansDir).filter((f) => f.endsWith(".json"));
     const plans = [];
     for (const file2 of files) {
       try {
-        const plan = JSON.parse(readFileSync7(join9(this.plansDir, file2), "utf-8"));
+        const plan = JSON.parse(readFileSync9(join10(this.plansDir, file2), "utf-8"));
         if (!status || plan.status === status) {
           plans.push(plan);
         }
@@ -40894,18 +41530,18 @@ class PlanManager {
   }
   delete(idOrSlug) {
     this.ensurePlansDir();
-    const files = readdirSync3(this.plansDir);
+    const files = readdirSync4(this.plansDir);
     for (const file2 of files) {
-      const filePath = join9(this.plansDir, file2);
+      const filePath = join10(this.plansDir, file2);
       if (!file2.endsWith(".json"))
         continue;
       try {
-        const plan = JSON.parse(readFileSync7(filePath, "utf-8"));
+        const plan = JSON.parse(readFileSync9(filePath, "utf-8"));
         if (plan.id === idOrSlug || this.slugify(plan.name) === idOrSlug) {
-          unlinkSync2(filePath);
-          const mdPath = join9(this.plansDir, `sprint-${this.slugify(plan.name)}.md`);
-          if (existsSync8(mdPath)) {
-            unlinkSync2(mdPath);
+          unlinkSync3(filePath);
+          const mdPath = join10(this.plansDir, `sprint-${this.slugify(plan.name)}.md`);
+          if (existsSync10(mdPath)) {
+            unlinkSync3(mdPath);
           }
           return;
         }
@@ -40919,8 +41555,8 @@ class PlanManager {
     return sprintPlanToMarkdown(plan);
   }
   ensurePlansDir() {
-    if (!existsSync8(this.plansDir)) {
-      mkdirSync4(this.plansDir, { recursive: true });
+    if (!existsSync10(this.plansDir)) {
+      mkdirSync5(this.plansDir, { recursive: true });
     }
   }
   slugify(name) {
@@ -41002,8 +41638,8 @@ IMPORTANT:
 }
 
 // ../sdk/src/planning/planning-meeting.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync5, readFileSync as readFileSync8 } from "node:fs";
-import { join as join10 } from "node:path";
+import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync10 } from "node:fs";
+import { join as join11 } from "node:path";
 
 class PlanningMeeting {
   projectPath;
@@ -41019,8 +41655,8 @@ class PlanningMeeting {
   async run(directive, feedback) {
     this.log("Planning sprint...", "info");
     const plansDir = getLocusPath(this.projectPath, "plansDir");
-    if (!existsSync9(plansDir)) {
-      mkdirSync5(plansDir, { recursive: true });
+    if (!existsSync11(plansDir)) {
+      mkdirSync6(plansDir, { recursive: true });
     }
     const ts = Date.now();
     const planId = `plan-${ts}`;
@@ -41034,11 +41670,11 @@ class PlanningMeeting {
     });
     const response = await this.aiRunner.run(prompt);
     this.log("Planning meeting complete.", "success");
-    const expectedPath = join10(plansDir, `${fileName}.json`);
+    const expectedPath = join11(plansDir, `${fileName}.json`);
     let plan = null;
-    if (existsSync9(expectedPath)) {
+    if (existsSync11(expectedPath)) {
       try {
-        plan = JSON.parse(readFileSync8(expectedPath, "utf-8"));
+        plan = JSON.parse(readFileSync10(expectedPath, "utf-8"));
       } catch {}
     }
     if (!plan) {
@@ -41073,112 +41709,13 @@ var init_index_node = __esm(() => {
   init_agent2();
   init_ai();
   init_core3();
+  init_discussion();
   init_exec();
   init_git();
   init_src2();
   init_planning();
 });
 
-// src/display/execution-stats.ts
-class ExecutionStatsTracker {
-  startTime;
-  endTime = null;
-  toolTimings = new Map;
-  toolOrder = [];
-  tokensUsed = null;
-  error = null;
-  constructor() {
-    this.startTime = Date.now();
-  }
-  toolStarted(toolName, toolId) {
-    const key = toolId ?? `${toolName}-${Date.now()}`;
-    this.toolTimings.set(key, {
-      name: toolName,
-      id: toolId,
-      startTime: Date.now()
-    });
-    this.toolOrder.push(key);
-  }
-  toolCompleted(toolName, toolId) {
-    const key = this.findToolKey(toolName, toolId);
-    if (key) {
-      const timing = this.toolTimings.get(key);
-      if (timing) {
-        timing.endTime = Date.now();
-        timing.duration = timing.endTime - timing.startTime;
-        timing.success = true;
-      }
-    }
-  }
-  toolFailed(toolName, error48, toolId) {
-    const key = this.findToolKey(toolName, toolId);
-    if (key) {
-      const timing = this.toolTimings.get(key);
-      if (timing) {
-        timing.endTime = Date.now();
-        timing.duration = timing.endTime - timing.startTime;
-        timing.success = false;
-        timing.error = error48;
-      }
-    }
-  }
-  setTokensUsed(tokens) {
-    this.tokensUsed = tokens;
-  }
-  setError(error48) {
-    this.error = error48;
-  }
-  finalize() {
-    this.endTime = Date.now();
-    const toolsUsed = [];
-    const seenTools = new Set;
-    for (const key of this.toolOrder) {
-      const timing = this.toolTimings.get(key);
-      if (timing && !seenTools.has(timing.name)) {
-        seenTools.add(timing.name);
-        toolsUsed.push(timing.name);
-      }
-    }
-    const toolTimings = this.toolOrder.map((key) => this.toolTimings.get(key)).filter((t) => t !== undefined);
-    const stats = {
-      duration: this.endTime - this.startTime,
-      toolsUsed,
-      toolTimings,
-      success: this.error === null
-    };
-    if (this.tokensUsed !== null) {
-      stats.tokensUsed = this.tokensUsed;
-    }
-    if (this.error !== null) {
-      stats.error = this.error;
-    }
-    return stats;
-  }
-  getCurrentDuration() {
-    return Date.now() - this.startTime;
-  }
-  findToolKey(toolName, toolId) {
-    if (toolId && this.toolTimings.has(toolId)) {
-      return toolId;
-    }
-    for (let i = this.toolOrder.length - 1;i >= 0; i--) {
-      const key = this.toolOrder[i];
-      const timing = this.toolTimings.get(key);
-      if (timing && timing.name === toolName && timing.endTime === undefined) {
-        return key;
-      }
-    }
-    for (let i = this.toolOrder.length - 1;i >= 0; i--) {
-      const key = this.toolOrder[i];
-      const timing = this.toolTimings.get(key);
-      if (timing && timing.name === toolName) {
-        return key;
-      }
-    }
-    return null;
-  }
-}
-
 // src/display/tool-display.ts
 import * as path2 from "node:path";
 
@@ -41769,6 +42306,106 @@ var init_progress_renderer = __esm(() => {
   SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 });
 
+// src/display/execution-stats.ts
+class ExecutionStatsTracker {
+  startTime;
+  endTime = null;
+  toolTimings = new Map;
+  toolOrder = [];
+  tokensUsed = null;
+  error = null;
+  constructor() {
+    this.startTime = Date.now();
+  }
+  toolStarted(toolName, toolId) {
+    const key = toolId ?? `${toolName}-${Date.now()}`;
+    this.toolTimings.set(key, {
+      name: toolName,
+      id: toolId,
+      startTime: Date.now()
+    });
+    this.toolOrder.push(key);
+  }
+  toolCompleted(toolName, toolId) {
+    const key = this.findToolKey(toolName, toolId);
+    if (key) {
+      const timing = this.toolTimings.get(key);
+      if (timing) {
+        timing.endTime = Date.now();
+        timing.duration = timing.endTime - timing.startTime;
+        timing.success = true;
+      }
+    }
+  }
+  toolFailed(toolName, error48, toolId) {
+    const key = this.findToolKey(toolName, toolId);
+    if (key) {
+      const timing = this.toolTimings.get(key);
+      if (timing) {
+        timing.endTime = Date.now();
+        timing.duration = timing.endTime - timing.startTime;
+        timing.success = false;
+        timing.error = error48;
+      }
+    }
+  }
+  setTokensUsed(tokens) {
+    this.tokensUsed = tokens;
+  }
+  setError(error48) {
+    this.error = error48;
+  }
+  finalize() {
+    this.endTime = Date.now();
+    const toolsUsed = [];
+    const seenTools = new Set;
+    for (const key of this.toolOrder) {
+      const timing = this.toolTimings.get(key);
+      if (timing && !seenTools.has(timing.name)) {
+        seenTools.add(timing.name);
+        toolsUsed.push(timing.name);
+      }
+    }
+    const toolTimings = this.toolOrder.map((key) => this.toolTimings.get(key)).filter((t) => t !== undefined);
+    const stats = {
+      duration: this.endTime - this.startTime,
+      toolsUsed,
+      toolTimings,
+      success: this.error === null
+    };
+    if (this.tokensUsed !== null) {
+      stats.tokensUsed = this.tokensUsed;
+    }
+    if (this.error !== null) {
+      stats.error = this.error;
+    }
+    return stats;
+  }
+  getCurrentDuration() {
+    return Date.now() - this.startTime;
+  }
+  findToolKey(toolName, toolId) {
+    if (toolId && this.toolTimings.has(toolId)) {
+      return toolId;
+    }
+    for (let i = this.toolOrder.length - 1;i >= 0; i--) {
+      const key = this.toolOrder[i];
+      const timing = this.toolTimings.get(key);
+      if (timing && timing.name === toolName && timing.endTime === undefined) {
+        return key;
+      }
+    }
+    for (let i = this.toolOrder.length - 1;i >= 0; i--) {
+      const key = this.toolOrder[i];
+      const timing = this.toolTimings.get(key);
+      if (timing && timing.name === toolName) {
+        return key;
+      }
+    }
+    return null;
+  }
+}
+
 // src/repl/commands.ts
 function parseCommand(input) {
   const lowerInput = input.toLowerCase();
@@ -41878,7 +42515,7 @@ var exports_interactive_session = {};
 __export(exports_interactive_session, {
   InteractiveSession: () => InteractiveSession
 });
-import * as readline from "node:readline";
+import * as readline2 from "node:readline";
 
 class InteractiveSession {
   readline = null;
@@ -41924,7 +42561,7 @@ class InteractiveSession {
   }
   async start() {
     this.printWelcome();
-    this.readline = readline.createInterface({
+    this.readline = readline2.createInterface({
       input: process.stdin,
       output: process.stdout,
       terminal: true
@@ -42121,10 +42758,10 @@ import { createInterface } from "node:readline";
 
 // src/settings-manager.ts
 init_index_node();
-import { existsSync as existsSync10, readFileSync as readFileSync9, unlinkSync as unlinkSync3, writeFileSync as writeFileSync5 } from "node:fs";
-import { join as join11 } from "node:path";
+import { existsSync as existsSync12, readFileSync as readFileSync11, unlinkSync as unlinkSync4, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join12 } from "node:path";
 function getSettingsPath(projectPath) {
-  return join11(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.settingsFile);
+  return join12(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.settingsFile);
 }
 
 class SettingsManager {
@@ -42134,16 +42771,16 @@ class SettingsManager {
   }
   load() {
     const settingsPath = getSettingsPath(this.projectPath);
-    if (!existsSync10(settingsPath)) {
+    if (!existsSync12(settingsPath)) {
       return {};
     }
-    return JSON.parse(readFileSync9(settingsPath, "utf-8"));
+    return JSON.parse(readFileSync11(settingsPath, "utf-8"));
   }
   save(settings) {
     const { $schema: _2, ...rest } = settings;
     const ordered = { $schema: LOCUS_SCHEMAS.settings, ...rest };
     const settingsPath = getSettingsPath(this.projectPath);
-    writeFileSync5(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
+    writeFileSync6(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
   }
   get(key) {
     return this.load()[key];
@@ -42155,12 +42792,12 @@ class SettingsManager {
   }
   remove() {
     const settingsPath = getSettingsPath(this.projectPath);
-    if (existsSync10(settingsPath)) {
-      unlinkSync3(settingsPath);
+    if (existsSync12(settingsPath)) {
+      unlinkSync4(settingsPath);
     }
   }
   exists() {
-    return existsSync10(getSettingsPath(this.projectPath));
+    return existsSync12(getSettingsPath(this.projectPath));
   }
 }
 
@@ -42419,15 +43056,444 @@ async function configCommand(args) {
       showConfigHelp();
   }
 }
-// src/commands/docs.ts
+// src/commands/discuss.ts
 init_index_node();
+init_progress_renderer();
+import * as readline from "node:readline";
 import { parseArgs } from "node:util";
 
+// src/utils/banner.ts
+init_index_node();
+
+// src/utils/version.ts
+import { existsSync as existsSync13, readFileSync as readFileSync12 } from "node:fs";
+import { dirname as dirname3, join as join13 } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+function getVersion() {
+  try {
+    const __filename2 = fileURLToPath3(import.meta.url);
+    const __dirname2 = dirname3(__filename2);
+    const bundledPath = join13(__dirname2, "..", "package.json");
+    const sourcePath = join13(__dirname2, "..", "..", "package.json");
+    if (existsSync13(bundledPath)) {
+      const pkg = JSON.parse(readFileSync12(bundledPath, "utf-8"));
+      if (pkg.name === "@locusai/cli") {
+        return pkg.version || "0.0.0";
+      }
+    }
+    if (existsSync13(sourcePath)) {
+      const pkg = JSON.parse(readFileSync12(sourcePath, "utf-8"));
+      if (pkg.name === "@locusai/cli") {
+        return pkg.version || "0.0.0";
+      }
+    }
+  } catch {}
+  return "0.0.0";
+}
+var VERSION2 = getVersion();
+
+// src/utils/banner.ts
+function printBanner() {
+  console.log(c.primary(`
+ _      ____   ____ _   _  ____
+| |    / __ \\ / ___| | | |/ ___|
+| |   | |  | | |   | | | |\\___ \\
+| |___| |__| | |___| |_| |___) |
+|_____|\\____/ \\____|\\___/|____/  ${c.dim(`v${VERSION2}`)}
+    `));
+}
+// src/utils/helpers.ts
+init_index_node();
+import { existsSync as existsSync14 } from "node:fs";
+import { join as join14 } from "node:path";
+function isProjectInitialized(projectPath) {
+  const locusDir = join14(projectPath, LOCUS_CONFIG.dir);
+  const configPath = join14(locusDir, LOCUS_CONFIG.configFile);
+  return existsSync14(locusDir) && existsSync14(configPath);
+}
+function requireInitialization(projectPath, command) {
+  if (!isProjectInitialized(projectPath)) {
+    console.error(`
+  ${c.error("✖ Error")} ${c.red(`Locus is not initialized in this directory.`)}
+
+  The '${c.bold(command)}' command requires a Locus project to be initialized.
+
+  To initialize Locus in this directory, run:
+    ${c.primary("locus init")}
+
+  This will create a ${c.dim(".locus")} directory with the necessary configuration.
+`);
+    process.exit(1);
+  }
+}
+function resolveProvider3(input) {
+  if (!input)
+    return PROVIDER.CLAUDE;
+  if (input === PROVIDER.CLAUDE || input === PROVIDER.CODEX)
+    return input;
+  console.error(c.error(`Error: invalid provider '${input}'. Use 'claude' or 'codex'.`));
+  process.exit(1);
+}
+// src/commands/discuss.ts
+async function discussCommand(args) {
+  const { values, positionals } = parseArgs({
+    args,
+    options: {
+      list: { type: "boolean" },
+      show: { type: "string" },
+      archive: { type: "string" },
+      delete: { type: "string" },
+      model: { type: "string" },
+      provider: { type: "string" },
+      "reasoning-effort": { type: "string" },
+      dir: { type: "string" }
+    },
+    strict: false,
+    allowPositionals: true
+  });
+  const projectPath = values.dir || process.cwd();
+  requireInitialization(projectPath, "discuss");
+  const discussionManager = new DiscussionManager(projectPath);
+  if (values.list) {
+    return listDiscussions(discussionManager);
+  }
+  if (values.show) {
+    return showDiscussion(discussionManager, values.show);
+  }
+  if (values.archive) {
+    return archiveDiscussion(discussionManager, values.archive);
+  }
+  if (values.delete) {
+    return deleteDiscussion(discussionManager, values.delete);
+  }
+  const topic = positionals.join(" ").trim();
+  if (!topic) {
+    showDiscussHelp();
+    return;
+  }
+  const settings = new SettingsManager(projectPath).load();
+  const provider = resolveProvider3(values.provider || settings.provider);
+  const model = values.model || settings.model || DEFAULT_MODEL[provider];
+  const reasoningEffort = values["reasoning-effort"];
+  const aiRunner = createAiRunner(provider, {
+    projectPath,
+    model,
+    reasoningEffort
+  });
+  const log = (message, level) => {
+    const icon = level === "success" ? c.success("✔") : level === "error" ? c.error("✖") : level === "warn" ? c.warning("!") : c.info("●");
+    console.log(`  ${icon} ${message}`);
+  };
+  const facilitator = new DiscussionFacilitator({
+    projectPath,
+    aiRunner,
+    discussionManager,
+    log,
+    provider,
+    model
+  });
+  console.log(`
+  ${c.header(" DISCUSSION ")} ${c.bold("Starting interactive discussion...")}
+`);
+  console.log(`  ${c.dim("Topic:")} ${c.bold(topic)}`);
+  console.log(`  ${c.dim("Model:")} ${c.dim(`${model} (${provider})`)}
+`);
+  const renderer = new ProgressRenderer({ animated: true });
+  let discussionId;
+  try {
+    renderer.showThinkingStarted();
+    const result = await facilitator.startDiscussion(topic);
+    renderer.showThinkingStopped();
+    discussionId = result.discussion.id;
+    process.stdout.write(`
+`);
+    process.stdout.write(result.message);
+    process.stdout.write(`
+
+`);
+    renderer.finalize();
+  } catch (error48) {
+    renderer.finalize();
+    console.error(`
+  ${c.error("✖")} ${c.red("Failed to start discussion:")} ${error48 instanceof Error ? error48.message : String(error48)}
+`);
+    process.exit(1);
+  }
+  console.log(`  ${c.dim("Type your response, or 'help' for commands. Use 'exit' or Ctrl+C to quit.")}
+`);
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: true
+  });
+  rl.setPrompt(c.cyan("> "));
+  rl.prompt();
+  let isProcessing = false;
+  const shutdown = () => {
+    if (isProcessing) {
+      aiRunner.abort();
+    }
+    console.log(`
+  ${c.dim("Discussion saved.")} ${c.dim("ID:")} ${c.cyan(discussionId)}`);
+    console.log(c.dim(`
+  Goodbye!
+`));
+    rl.close();
+    process.exit(0);
+  };
+  process.on("SIGINT", () => {
+    if (isProcessing) {
+      aiRunner.abort();
+      isProcessing = false;
+      console.log(c.dim(`
+[Interrupted]`));
+      rl.prompt();
+    } else {
+      shutdown();
+    }
+  });
+  rl.on("close", () => {
+    shutdown();
+  });
+  rl.on("line", async (input) => {
+    const trimmed = input.trim();
+    if (trimmed === "" || isProcessing) {
+      rl.prompt();
+      return;
+    }
+    const lowerInput = trimmed.toLowerCase();
+    if (lowerInput === "help") {
+      showReplHelp();
+      rl.prompt();
+      return;
+    }
+    if (lowerInput === "exit" || lowerInput === "quit") {
+      shutdown();
+      return;
+    }
+    if (lowerInput === "insights") {
+      showCurrentInsights(discussionManager, discussionId);
+      rl.prompt();
+      return;
+    }
+    if (lowerInput === "summary") {
+      isProcessing = true;
+      const summaryRenderer = new ProgressRenderer({ animated: true });
+      try {
+        summaryRenderer.showThinkingStarted();
+        const summary = await facilitator.summarizeDiscussion(discussionId);
+        summaryRenderer.showThinkingStopped();
+        process.stdout.write(`
+`);
+        process.stdout.write(summary);
+        process.stdout.write(`
+`);
+        summaryRenderer.finalize();
+        const discussion2 = discussionManager.load(discussionId);
+        if (discussion2) {
+          console.log(`
+  ${c.success("✔")} ${c.success("Discussion completed!")}
+`);
+          console.log(`  ${c.dim("Messages:")} ${discussion2.messages.length}  ${c.dim("Insights:")} ${discussion2.insights.length}
+`);
+        }
+        console.log(`  ${c.dim("To review:")} ${c.cyan(`locus discuss --show ${discussionId}`)}`);
+        console.log(`  ${c.dim("To list all:")} ${c.cyan("locus discuss --list")}
+`);
+      } catch (error48) {
+        summaryRenderer.finalize();
+        console.error(`
+  ${c.error("✖")} ${c.red("Failed to summarize:")} ${error48 instanceof Error ? error48.message : String(error48)}
+`);
+      }
+      rl.close();
+      process.exit(0);
+      return;
+    }
+    isProcessing = true;
+    const chunkRenderer = new ProgressRenderer({ animated: true });
+    try {
+      chunkRenderer.showThinkingStarted();
+      const stream4 = facilitator.continueDiscussionStream(discussionId, trimmed);
+      let result = {
+        response: "",
+        insights: []
+      };
+      let iterResult = await stream4.next();
+      while (!iterResult.done) {
+        chunkRenderer.renderChunk(iterResult.value);
+        iterResult = await stream4.next();
+      }
+      result = iterResult.value;
+      chunkRenderer.finalize();
+      if (result.insights.length > 0) {
+        console.log("");
+        for (const insight of result.insights) {
+          const tag = formatInsightTag(insight.type);
+          console.log(`  ${tag} ${c.bold(insight.title)}`);
+          console.log(`  ${c.dim(insight.content)}
+`);
+        }
+      }
+    } catch (error48) {
+      chunkRenderer.finalize();
+      console.error(`
+  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+`);
+    }
+    isProcessing = false;
+    rl.prompt();
+  });
+}
+function listDiscussions(discussionManager) {
+  const discussions = discussionManager.list();
+  if (discussions.length === 0) {
+    console.log(`
+  ${c.dim("No discussions found.")}
+`);
+    console.log(`  ${c.dim("Start one with:")} ${c.cyan('locus discuss "your topic"')}
+`);
+    return;
+  }
+  console.log(`
+  ${c.header(" DISCUSSIONS ")} ${c.dim(`(${discussions.length})`)}
+`);
+  for (const disc of discussions) {
+    const statusIcon = disc.status === "active" ? c.warning("◯") : disc.status === "completed" ? c.success("✔") : c.dim("⊘");
+    console.log(`  ${statusIcon} ${c.bold(disc.title)} ${c.dim(`[${disc.status}]`)} ${c.dim(`— ${disc.messages.length} messages, ${disc.insights.length} insights`)}`);
+    console.log(`    ${c.dim("ID:")} ${disc.id}`);
+    console.log(`    ${c.dim("Created:")} ${disc.createdAt}`);
+    console.log("");
+  }
+}
+function showDiscussion(discussionManager, id) {
+  const md = discussionManager.getMarkdown(id);
+  if (!md) {
+    console.error(`
+  ${c.error("✖")} ${c.red(`Discussion not found: ${id}`)}
+`);
+    process.exit(1);
+  }
+  console.log(`
+${md}
+`);
+}
+function archiveDiscussion(discussionManager, id) {
+  try {
+    discussionManager.archive(id);
+    console.log(`
+  ${c.success("✔")} ${c.dim("Discussion archived.")}
+`);
+  } catch (error48) {
+    console.error(`
+  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+`);
+    process.exit(1);
+  }
+}
+function deleteDiscussion(discussionManager, id) {
+  try {
+    discussionManager.delete(id);
+    console.log(`
+  ${c.success("✔")} ${c.dim("Discussion deleted.")}
+`);
+  } catch (error48) {
+    console.error(`
+  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+`);
+    process.exit(1);
+  }
+}
+function showCurrentInsights(discussionManager, discussionId) {
+  const discussion2 = discussionManager.load(discussionId);
+  if (!discussion2 || discussion2.insights.length === 0) {
+    console.log(`
+  ${c.dim("No insights extracted yet.")}
+`);
+    return;
+  }
+  console.log(`
+  ${c.header(" INSIGHTS ")} ${c.dim(`(${discussion2.insights.length})`)}
+`);
+  for (const insight of discussion2.insights) {
+    const tag = formatInsightTag(insight.type);
+    console.log(`  ${tag} ${c.bold(insight.title)}`);
+    console.log(`  ${c.dim(insight.content)}`);
+    if (insight.tags.length > 0) {
+      console.log(`  ${c.dim(`Tags: ${insight.tags.join(", ")}`)}`);
+    }
+    console.log("");
+  }
+}
+function formatInsightTag(type) {
+  switch (type) {
+    case "decision":
+      return c.green("[DECISION]");
+    case "requirement":
+      return c.blue("[REQUIREMENT]");
+    case "idea":
+      return c.yellow("[IDEA]");
+    case "concern":
+      return c.red("[CONCERN]");
+    case "learning":
+      return c.cyan("[LEARNING]");
+  }
+}
+function showReplHelp() {
+  console.log(`
+  ${c.header(" DISCUSSION COMMANDS ")}
+
+    ${c.cyan("summary")}     Generate a final summary and end the discussion
+    ${c.cyan("insights")}    Show all insights extracted so far
+    ${c.cyan("exit")}        Save and exit without generating a summary
+    ${c.cyan("help")}        Show this help message
+
+  ${c.dim("Type anything else to continue the discussion.")}
+`);
+}
+function showDiscussHelp() {
+  console.log(`
+  ${c.header(" LOCUS DISCUSS ")} ${c.dim("— Interactive AI Discussion")}
+
+  ${c.bold("Usage:")}
+    ${c.cyan('locus discuss "topic"')}              Start a discussion on a topic
+    ${c.cyan("locus discuss --list")}                List all discussions
+    ${c.cyan("locus discuss --show <id>")}           Show discussion details
+    ${c.cyan("locus discuss --archive <id>")}        Archive a discussion
+    ${c.cyan("locus discuss --delete <id>")}         Delete a discussion
+
+  ${c.bold("Options:")}
+    ${c.dim("--model <model>")}    AI model to use
+    ${c.dim("--provider <p>")}     AI provider (claude, codex)
+    ${c.dim("--reasoning-effort <level>")}  Reasoning effort (low, medium, high)
+    ${c.dim("--dir <path>")}       Project directory
+
+  ${c.bold("REPL Commands:")}
+    ${c.dim("summary")}     Generate final summary and end the discussion
+    ${c.dim("insights")}    Show all insights extracted so far
+    ${c.dim("exit")}        Save and exit without generating a summary
+    ${c.dim("help")}        Show available commands
+
+  ${c.bold("Examples:")}
+    ${c.dim("# Start a discussion about architecture")}
+    ${c.cyan('locus discuss "how should we structure the auth system?"')}
+
+    ${c.dim("# Review a past discussion")}
+    ${c.cyan("locus discuss --show disc-1234567890")}
+
+    ${c.dim("# List all discussions")}
+    ${c.cyan("locus discuss --list")}
+`);
+}
+// src/commands/docs.ts
+init_index_node();
+import { parseArgs as parseArgs2 } from "node:util";
+
 // src/config-manager.ts
 init_index_node();
 import { execSync as execSync2 } from "node:child_process";
-import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync10, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join12 } from "node:path";
+import { existsSync as existsSync15, mkdirSync as mkdirSync7, readFileSync as readFileSync13, writeFileSync as writeFileSync7 } from "node:fs";
+import { join as join15 } from "node:path";
 var LOCUS_GITIGNORE_MARKER = "# Locus AI";
 var LOCUS_MD_TEMPLATE = `## Planning First
 
@@ -42519,12 +43585,12 @@ It is read by AI agents before every task to avoid repeating mistakes and to fol
 <!-- Add learnings below this line. Format: - **[Category]**: Description -->
 `;
 function updateGitignore(projectPath) {
-  const gitignorePath = join12(projectPath, ".gitignore");
+  const gitignorePath = join15(projectPath, ".gitignore");
   let content = "";
   const locusBlock = LOCUS_GITIGNORE_PATTERNS.join(`
 `);
-  if (existsSync11(gitignorePath)) {
-    content = readFileSync10(gitignorePath, "utf-8");
+  if (existsSync15(gitignorePath)) {
+    content = readFileSync13(gitignorePath, "utf-8");
     if (content.includes(LOCUS_GITIGNORE_MARKER)) {
       const lines = content.split(`
 `);
@@ -42541,7 +43607,7 @@ function updateGitignore(projectPath) {
       const after = lines.slice(endIdx + 1);
       content = [...before, locusBlock, ...after].join(`
 `);
-      writeFileSync6(gitignorePath, content);
+      writeFileSync7(gitignorePath, content);
       return;
     }
     if (content.length > 0 && !content.endsWith(`
@@ -42556,7 +43622,7 @@ function updateGitignore(projectPath) {
   }
   content += `${locusBlock}
 `;
-  writeFileSync6(gitignorePath, content);
+  writeFileSync7(gitignorePath, content);
 }
 function ensureGitIdentity(projectPath) {
   const hasName = (() => {
@@ -42603,48 +43669,49 @@ class ConfigManager {
     this.projectPath = projectPath;
   }
   async init(version2) {
-    const locusConfigDir = join12(this.projectPath, LOCUS_CONFIG.dir);
+    const locusConfigDir = join15(this.projectPath, LOCUS_CONFIG.dir);
     const locusConfigPath = getLocusPath(this.projectPath, "configFile");
-    if (!existsSync11(locusConfigDir)) {
-      mkdirSync6(locusConfigDir, { recursive: true });
+    if (!existsSync15(locusConfigDir)) {
+      mkdirSync7(locusConfigDir, { recursive: true });
     }
     const locusSubdirs = [
       LOCUS_CONFIG.artifactsDir,
       LOCUS_CONFIG.documentsDir,
       LOCUS_CONFIG.sessionsDir,
       LOCUS_CONFIG.reviewsDir,
-      LOCUS_CONFIG.plansDir
+      LOCUS_CONFIG.plansDir,
+      LOCUS_CONFIG.discussionsDir
     ];
     for (const subdir of locusSubdirs) {
-      const subdirPath = join12(locusConfigDir, subdir);
-      if (!existsSync11(subdirPath)) {
-        mkdirSync6(subdirPath, { recursive: true });
+      const subdirPath = join15(locusConfigDir, subdir);
+      if (!existsSync15(subdirPath)) {
+        mkdirSync7(subdirPath, { recursive: true });
       }
     }
     const locusMdPath = getLocusPath(this.projectPath, "contextFile");
-    if (!existsSync11(locusMdPath)) {
-      writeFileSync6(locusMdPath, LOCUS_MD_TEMPLATE);
+    if (!existsSync15(locusMdPath)) {
+      writeFileSync7(locusMdPath, LOCUS_MD_TEMPLATE);
     }
     const learningsMdPath = getLocusPath(this.projectPath, "learningsFile");
-    if (!existsSync11(learningsMdPath)) {
-      writeFileSync6(learningsMdPath, DEFAULT_LEARNINGS_MD);
+    if (!existsSync15(learningsMdPath)) {
+      writeFileSync7(learningsMdPath, DEFAULT_LEARNINGS_MD);
     }
-    if (!existsSync11(locusConfigPath)) {
+    if (!existsSync15(locusConfigPath)) {
       const config2 = {
         $schema: LOCUS_SCHEMAS.config,
         version: version2,
         createdAt: new Date().toISOString(),
         projectPath: "."
       };
-      writeFileSync6(locusConfigPath, JSON.stringify(config2, null, 2));
+      writeFileSync7(locusConfigPath, JSON.stringify(config2, null, 2));
     }
     updateGitignore(this.projectPath);
     ensureGitIdentity(this.projectPath);
   }
   loadConfig() {
-    const path2 = getLocusPath(this.projectPath, "configFile");
-    if (existsSync11(path2)) {
-      return JSON.parse(readFileSync10(path2, "utf-8"));
+    const path3 = getLocusPath(this.projectPath, "configFile");
+    if (existsSync15(path3)) {
+      return JSON.parse(readFileSync13(path3, "utf-8"));
     }
     return null;
   }
@@ -42674,19 +43741,19 @@ class ConfigManager {
         this.saveConfig(config2);
       }
     }
-    const settingsPath = join12(this.projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.settingsFile);
-    if (existsSync11(settingsPath)) {
-      const raw = readFileSync10(settingsPath, "utf-8");
+    const settingsPath = join15(this.projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.settingsFile);
+    if (existsSync15(settingsPath)) {
+      const raw = readFileSync13(settingsPath, "utf-8");
       const settings = JSON.parse(raw);
       if (settings.$schema !== LOCUS_SCHEMAS.settings) {
         const { $schema: _2, ...rest } = settings;
         const ordered = { $schema: LOCUS_SCHEMAS.settings, ...rest };
-        writeFileSync6(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
+        writeFileSync7(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
       }
     }
     const locusMdPath = getLocusPath(this.projectPath, "contextFile");
-    const locusMdExisted = existsSync11(locusMdPath);
-    writeFileSync6(locusMdPath, LOCUS_MD_TEMPLATE);
+    const locusMdExisted = existsSync15(locusMdPath);
+    writeFileSync7(locusMdPath, LOCUS_MD_TEMPLATE);
     if (!locusMdExisted) {
       result.directoriesCreated.push(".locus/LOCUS.md");
     }
@@ -42695,25 +43762,26 @@ class ConfigManager {
       LOCUS_CONFIG.documentsDir,
       LOCUS_CONFIG.sessionsDir,
       LOCUS_CONFIG.reviewsDir,
-      LOCUS_CONFIG.plansDir
+      LOCUS_CONFIG.plansDir,
+      LOCUS_CONFIG.discussionsDir
     ];
-    const locusConfigDir = join12(this.projectPath, LOCUS_CONFIG.dir);
+    const locusConfigDir = join15(this.projectPath, LOCUS_CONFIG.dir);
     for (const subdir of locusSubdirs) {
-      const subdirPath = join12(locusConfigDir, subdir);
-      if (!existsSync11(subdirPath)) {
-        mkdirSync6(subdirPath, { recursive: true });
+      const subdirPath = join15(locusConfigDir, subdir);
+      if (!existsSync15(subdirPath)) {
+        mkdirSync7(subdirPath, { recursive: true });
         result.directoriesCreated.push(`.locus/${subdir}`);
       }
     }
     const learningsMdPath = getLocusPath(this.projectPath, "learningsFile");
-    if (!existsSync11(learningsMdPath)) {
-      writeFileSync6(learningsMdPath, DEFAULT_LEARNINGS_MD);
+    if (!existsSync15(learningsMdPath)) {
+      writeFileSync7(learningsMdPath, DEFAULT_LEARNINGS_MD);
       result.directoriesCreated.push(".locus/LEARNINGS.md");
     }
-    const gitignorePath = join12(this.projectPath, ".gitignore");
-    const gitignoreBefore = existsSync11(gitignorePath) ? readFileSync10(gitignorePath, "utf-8") : "";
+    const gitignorePath = join15(this.projectPath, ".gitignore");
+    const gitignoreBefore = existsSync15(gitignorePath) ? readFileSync13(gitignorePath, "utf-8") : "";
     updateGitignore(this.projectPath);
-    const gitignoreAfter = readFileSync10(gitignorePath, "utf-8");
+    const gitignoreAfter = readFileSync13(gitignorePath, "utf-8");
     if (gitignoreBefore !== gitignoreAfter) {
       result.gitignoreUpdated = true;
     }
@@ -42723,83 +43791,11 @@ class ConfigManager {
   saveConfig(config2) {
     const { $schema: _2, ...rest } = config2;
     const ordered = { $schema: LOCUS_SCHEMAS.config, ...rest };
-    const path2 = getLocusPath(this.projectPath, "configFile");
-    writeFileSync6(path2, JSON.stringify(ordered, null, 2));
+    const path3 = getLocusPath(this.projectPath, "configFile");
+    writeFileSync7(path3, JSON.stringify(ordered, null, 2));
   }
 }
 
-// src/utils/banner.ts
-init_index_node();
-
-// src/utils/version.ts
-import { existsSync as existsSync12, readFileSync as readFileSync11 } from "node:fs";
-import { dirname as dirname3, join as join13 } from "node:path";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
-function getVersion() {
-  try {
-    const __filename2 = fileURLToPath3(import.meta.url);
-    const __dirname2 = dirname3(__filename2);
-    const bundledPath = join13(__dirname2, "..", "package.json");
-    const sourcePath = join13(__dirname2, "..", "..", "package.json");
-    if (existsSync12(bundledPath)) {
-      const pkg = JSON.parse(readFileSync11(bundledPath, "utf-8"));
-      if (pkg.name === "@locusai/cli") {
-        return pkg.version || "0.0.0";
-      }
-    }
-    if (existsSync12(sourcePath)) {
-      const pkg = JSON.parse(readFileSync11(sourcePath, "utf-8"));
-      if (pkg.name === "@locusai/cli") {
-        return pkg.version || "0.0.0";
-      }
-    }
-  } catch {}
-  return "0.0.0";
-}
-var VERSION2 = getVersion();
-
-// src/utils/banner.ts
-function printBanner() {
-  console.log(c.primary(`
- _      ____   ____ _   _  ____
-| |    / __ \\ / ___| | | |/ ___|
-| |   | |  | | |   | | | |\\___ \\
-| |___| |__| | |___| |_| |___) |
-|_____|\\____/ \\____|\\___/|____/  ${c.dim(`v${VERSION2}`)}
-    `));
-}
-// src/utils/helpers.ts
-init_index_node();
-import { existsSync as existsSync13 } from "node:fs";
-import { join as join14 } from "node:path";
-function isProjectInitialized(projectPath) {
-  const locusDir = join14(projectPath, LOCUS_CONFIG.dir);
-  const configPath = join14(locusDir, LOCUS_CONFIG.configFile);
-  return existsSync13(locusDir) && existsSync13(configPath);
-}
-function requireInitialization(projectPath, command) {
-  if (!isProjectInitialized(projectPath)) {
-    console.error(`
-  ${c.error("✖ Error")} ${c.red(`Locus is not initialized in this directory.`)}
-
-  The '${c.bold(command)}' command requires a Locus project to be initialized.
-
-  To initialize Locus in this directory, run:
-    ${c.primary("locus init")}
-
-  This will create a ${c.dim(".locus")} directory with the necessary configuration.
-`);
-    process.exit(1);
-  }
-}
-function resolveProvider3(input) {
-  if (!input)
-    return PROVIDER.CLAUDE;
-  if (input === PROVIDER.CLAUDE || input === PROVIDER.CODEX)
-    return input;
-  console.error(c.error(`Error: invalid provider '${input}'. Use 'claude' or 'codex'.`));
-  process.exit(1);
-}
 // src/workspace-resolver.ts
 init_index_node();
 
@@ -42844,7 +43840,7 @@ async function docsCommand(args) {
   }
 }
 async function docsSyncCommand(args) {
-  const { values } = parseArgs({
+  const { values } = parseArgs2({
     args,
     options: {
       "api-key": { type: "string" },
@@ -42961,7 +43957,7 @@ function showDocsSyncHelp() {
 // src/commands/exec.ts
 init_index_node();
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { parseArgs as parseArgs2 } from "node:util";
+import { parseArgs as parseArgs3 } from "node:util";
 
 // src/display/json-stream-renderer.ts
 init_src();
@@ -43254,7 +44250,7 @@ function showSessionsHelp() {
 
 // src/commands/exec.ts
 async function execCommand(args) {
-  const { values, positionals } = parseArgs2({
+  const { values, positionals } = parseArgs3({
     args,
     options: {
       model: { type: "string" },
@@ -43265,6 +44261,7 @@ async function execCommand(args) {
       "no-status": { type: "boolean" },
       interactive: { type: "boolean", short: "i" },
       session: { type: "string", short: "s" },
+      "session-id": { type: "string" },
       "json-stream": { type: "boolean" }
     },
     strict: false
@@ -43393,7 +44390,7 @@ async function execCommand(args) {
   }
 }
 async function execJsonStream(values, positionals, projectPath) {
-  const sessionId = values.session ?? randomUUID2();
+  const sessionId = values["session-id"] ?? values.session ?? randomUUID2();
   const execSettings = new SettingsManager(projectPath).load();
   const provider = resolveProvider3(values.provider || execSettings.provider);
   const model = values.model || execSettings.model || DEFAULT_MODEL[provider];
@@ -43462,6 +44459,11 @@ function showHelp2() {
               ${c.dim("remove        Remove all settings")}
     ${c.success("index")}     Index the codebase for AI context
     ${c.success("run")}       Start agent to work on tasks sequentially
+    ${c.success("discuss")}   Start an interactive AI discussion on a topic
+              ${c.dim("--list         List all discussions")}
+              ${c.dim("--show <id>    Show discussion details")}
+              ${c.dim("--archive <id> Archive a discussion")}
+              ${c.dim("--delete <id>  Delete a discussion")}
     ${c.success("plan")}      Run async planning meeting to create sprint plans
     ${c.success("docs")}      Manage workspace docs
               ${c.dim("sync          Sync docs from API to .locus/documents")}
@@ -43499,6 +44501,7 @@ function showHelp2() {
     ${c.dim("$")} ${c.primary("locus review")}
     ${c.dim("$")} ${c.primary("locus review local")}
     ${c.dim("$")} ${c.primary("locus telegram setup")}
+    ${c.dim("$")} ${c.primary('locus discuss "how should we design the auth system?"')}
     ${c.dim("$")} ${c.primary("locus exec sessions list")}
 
   For more information, visit: ${c.underline("https://docs.locusai.dev")}
@@ -43506,7 +44509,7 @@ function showHelp2() {
 }
 // src/commands/index-codebase.ts
 init_index_node();
-import { parseArgs as parseArgs3 } from "node:util";
+import { parseArgs as parseArgs4 } from "node:util";
 
 // src/tree-summarizer.ts
 init_index_node();
@@ -43534,7 +44537,7 @@ ${tree}`;
 
 // src/commands/index-codebase.ts
 async function indexCommand(args) {
-  const { values } = parseArgs3({
+  const { values } = parseArgs4({
     args,
     options: {
       dir: { type: "string" },
@@ -43632,9 +44635,9 @@ async function initCommand() {
 }
 // src/commands/plan.ts
 init_index_node();
-import { existsSync as existsSync14, unlinkSync as unlinkSync4 } from "node:fs";
-import { join as join15 } from "node:path";
-import { parseArgs as parseArgs4 } from "node:util";
+import { existsSync as existsSync16, unlinkSync as unlinkSync5 } from "node:fs";
+import { join as join16 } from "node:path";
+import { parseArgs as parseArgs5 } from "node:util";
 function normalizePlanIdArgs(args) {
   const planIdFlags = new Set(["--approve", "--reject", "--cancel", "--show"]);
   const result = [];
@@ -43653,7 +44656,7 @@ function normalizePlanIdArgs(args) {
 }
 async function planCommand(args) {
   const normalizedArgs = normalizePlanIdArgs(args);
-  const { values, positionals } = parseArgs4({
+  const { values, positionals } = parseArgs5({
     args: normalizedArgs,
     options: {
       approve: { type: "string" },
@@ -43740,9 +44743,9 @@ async function planCommand(args) {
   try {
     const result = await meeting.run(directive, feedback);
     planManager.save(result.plan);
-    const tempFile = join15(getLocusPath(projectPath, "plansDir"), `${result.plan.id}.json`);
-    if (existsSync14(tempFile)) {
-      unlinkSync4(tempFile);
+    const tempFile = join16(getLocusPath(projectPath, "plansDir"), `${result.plan.id}.json`);
+    if (existsSync16(tempFile)) {
+      unlinkSync5(tempFile);
     }
     console.log(`
   ${c.success("✔")} ${c.success("Planning meeting complete!")}
@@ -43938,9 +44941,9 @@ function showPlanHelp() {
 }
 // src/commands/review.ts
 init_index_node();
-import { existsSync as existsSync15, mkdirSync as mkdirSync7, writeFileSync as writeFileSync7 } from "node:fs";
-import { join as join16 } from "node:path";
-import { parseArgs as parseArgs5 } from "node:util";
+import { existsSync as existsSync17, mkdirSync as mkdirSync8, writeFileSync as writeFileSync8 } from "node:fs";
+import { join as join17 } from "node:path";
+import { parseArgs as parseArgs6 } from "node:util";
 async function reviewCommand(args) {
   const subcommand = args[0];
   if (subcommand === "local") {
@@ -43949,7 +44952,7 @@ async function reviewCommand(args) {
   return reviewPrsCommand(args);
 }
 async function reviewPrsCommand(args) {
-  const { values } = parseArgs5({
+  const { values } = parseArgs6({
     args,
     options: {
       "api-key": { type: "string" },
@@ -44035,7 +45038,7 @@ ${c.info("Received shutdown signal. Stopping reviewer...")}`);
   await reviewer.run();
 }
 async function reviewLocalCommand(args) {
-  const { values } = parseArgs5({
+  const { values } = parseArgs6({
     args,
     options: {
       model: { type: "string" },
@@ -44078,13 +45081,13 @@ async function reviewLocalCommand(args) {
 `);
     return;
   }
-  const reviewsDir = join16(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.reviewsDir);
-  if (!existsSync15(reviewsDir)) {
-    mkdirSync7(reviewsDir, { recursive: true });
+  const reviewsDir = join17(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.reviewsDir);
+  if (!existsSync17(reviewsDir)) {
+    mkdirSync8(reviewsDir, { recursive: true });
   }
   const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-  const reportPath = join16(reviewsDir, `review-${timestamp}.md`);
-  writeFileSync7(reportPath, report, "utf-8");
+  const reportPath = join17(reviewsDir, `review-${timestamp}.md`);
+  writeFileSync8(reportPath, report, "utf-8");
   console.log(`
   ${c.success("✔")} ${c.success("Review complete!")}`);
   console.log(`  ${c.dim("Report saved to:")} ${c.primary(reportPath)}
@@ -44092,9 +45095,9 @@ async function reviewLocalCommand(args) {
 }
 // src/commands/run.ts
 init_index_node();
-import { parseArgs as parseArgs6 } from "node:util";
+import { parseArgs as parseArgs7 } from "node:util";
 async function runCommand(args) {
-  const { values } = parseArgs6({
+  const { values } = parseArgs7({
     args,
     options: {
       "api-key": { type: "string" },
@@ -44176,11 +45179,11 @@ ${c.info(`Received ${signal}. Stopping agent and cleaning up...`)}`);
 // src/commands/telegram.ts
 init_index_node();
 import { spawn as spawn4 } from "node:child_process";
-import { existsSync as existsSync16 } from "node:fs";
-import { join as join17 } from "node:path";
-import { createInterface as createInterface3 } from "node:readline";
+import { existsSync as existsSync18 } from "node:fs";
+import { join as join18 } from "node:path";
+import { createInterface as createInterface4 } from "node:readline";
 function ask2(question) {
-  const rl = createInterface3({
+  const rl = createInterface4({
     input: process.stdin,
     output: process.stdout
   });
@@ -44411,8 +45414,8 @@ function runBotCommand(projectPath) {
 `);
     process.exit(1);
   }
-  const monorepoTelegramEntry = join17(projectPath, "packages/telegram/src/index.ts");
-  const isMonorepo = existsSync16(monorepoTelegramEntry);
+  const monorepoTelegramEntry = join18(projectPath, "packages/telegram/src/index.ts");
+  const isMonorepo = existsSync18(monorepoTelegramEntry);
   let cmd;
   let args;
   if (isMonorepo) {
@@ -44571,6 +45574,10 @@ var isJsonStream = process.argv.includes("--json-stream");
 async function main() {
   const command = process.argv[2];
   const args = process.argv.slice(3);
+  if (command === "--json-stream") {
+    await execCommand([command, ...args]);
+    return;
+  }
   if (command !== "exec" && !isJsonStream) {
     printBanner();
   }
@@ -44587,6 +45594,9 @@ async function main() {
     case "exec":
       await execCommand(args);
       break;
+    case "discuss":
+      await discussCommand(args);
+      break;
     case "plan":
       await planCommand(args);
       break;