agestra 4.7.0 → 4.8.0

package/hooks/user-prompt-submit.js

@@ -1,7 +1,11 @@
 #!/usr/bin/env node
 
 // Agestra UserPromptSubmit hook
-// Detects user intent and injects Agestra tool suggestions as additionalContext.
+// Detects user intent and routes to debate mode with configured providers.
+// If no providers.config.json exists, suggests /agestra setup first.
+
+const { existsSync } = require("fs");
+const { join } = require("path");
 
 let input = "";
 process.stdin.on("data", (chunk) => { input += chunk; });
@@ -33,37 +37,98 @@ process.stdin.on("end", () => {
     if (ideaKeywords.some((k) => prompt.includes(k))) matched.push("idea");
     if (designKeywords.some((k) => prompt.includes(k))) matched.push("design");
 
-    if (matched.length > 0) {
+    if (matched.length === 0) return;
+
+    // Check if providers.config.json exists
+    const cwd = data.cwd || process.cwd();
+    const configPath = join(cwd, "providers.config.json");
+    const hasConfig = existsSync(configPath);
+
+    if (!hasConfig) {
+      // No config — suggest setup first
       const lines = [
-        "[Agestra] 외부 AI(Ollama, Gemini, Codex)와 팀을 구성하여 작업할 수 있습니다.",
-        "사용자에게 팀 모드 사용 여부를 제안하세요.",
+        "[Agestra] 외부 AI와 끝장토론을 하려면 먼저 초기 설정이 필요합니다.",
+        "`/agestra setup`을 실행하여 사용할 AI를 선택하세요.",
         "",
+        "설정 후 자동으로 끝장토론 모드로 진행됩니다.",
       ];
+      console.log(JSON.stringify({ additionalContext: lines.join("\n") }));
+      return;
+    }
 
-      if (matched.includes("review")) {
-        lines.push("• 코드 리뷰 → `environment_check` 실행 후 모드 선택 제공:");
-        lines.push("  - Claude only: agestra-reviewer 단독 실행");
-        lines.push("  - 각자 독립: 팀(moderator + reviewer + 외부 AI) 각자 리뷰 → 취합 문서");
-        lines.push("  - 끝장토론: 각자 독립 + 합의까지 반복 리뷰");
-      }
-      if (matched.includes("idea")) {
-        lines.push("• 아이디어 탐색 → `environment_check` 실행 후 모드 선택 제공:");
-        lines.push("  - Claude only: agestra-ideator 단독 탐색");
-        lines.push("  - 각자 독립: 팀(moderator + ideator + 외부 AI) 각자 탐색 → 취합 문서");
-        lines.push("  - 끝장토론: 각자 독립 + 합의까지 반복 토론");
-      }
-      if (matched.includes("design")) {
-        lines.push("• 설계 탐색 → `environment_check` 실행 후 모드 선택 제공:");
-        lines.push("  - Claude only: agestra-designer 단독 설계");
-        lines.push("  - 각자 독립: 팀(moderator + designer + 외부 AI) 각자 설계 → 취합 문서");
-        lines.push("  - 끝장토론: 각자 독립 + 합의까지 반복 토론");
-      }
-
-      lines.push("");
-      lines.push("반드시 `environment_check`를 먼저 호출하여 사용 가능한 프로바이더를 확인한 후, 모드 선택지를 사용자에게 보여주세요.");
+    // Config exists — check selectionPolicy
+    let config;
+    try {
+      config = JSON.parse(require("fs").readFileSync(configPath, "utf-8"));
+    } catch {
+      // Corrupted config — suggest re-setup
+      console.log(JSON.stringify({
+        additionalContext: "[Agestra] providers.config.json이 손상되었습니다. `/agestra setup`으로 재설정하세요.",
+      }));
+      return;
+    }
+
+    // ask-each-session: always ask user before proceeding
+    if (config.selectionPolicy === "ask-each-session") {
+      const enabledProviders = (config.providers || [])
+        .filter((p) => p.enabled)
+        .map((p) => p.id);
+
+      const lines = [
+        `[Agestra] Session policy: ask-each-session.`,
+        `Currently enabled AI: ${enabledProviders.join(", ") || "none"}.`,
+        "",
+        "MANDATORY: You MUST use AskUserQuestion to ask the user:",
+        "Present in the user's language.",
+        "Question 1: 'Run multi-AI debate with current providers?'",
+        "Options: 'Yes' / 'No' / 'Change AI selection (run /agestra setup)'",
+        "",
+        "If YES: call `environment_check` then proceed with debate.",
+        "If NO: handle directly without Agestra.",
+        "If CHANGE: run the setup skill to reconfigure providers.",
+      ];
 
       console.log(JSON.stringify({ additionalContext: lines.join("\n") }));
+      return;
+    }
+
+    // Fixed or ask-each-session mode
+    const enabledProviders = (config.providers || [])
+      .filter((p) => p.enabled)
+      .map((p) => p.id);
+
+    if (enabledProviders.length === 0) {
+      console.log(JSON.stringify({
+        additionalContext: "[Agestra] No AI providers are enabled. Run `/agestra setup` to select AIs.",
+      }));
+      return;
     }
+
+    const intentMap = [];
+    if (matched.includes("review")) intentMap.push("code review");
+    if (matched.includes("idea")) intentMap.push("idea exploration");
+    if (matched.includes("design")) intentMap.push("design exploration");
+    const intentStr = intentMap.join(", ");
+
+    const lines = [
+      `[Agestra] Detected intent: ${intentStr}.`,
+      `Available AI providers: ${enabledProviders.join(", ")}.`,
+      "",
+      "MANDATORY: You MUST use AskUserQuestion to ask the user whether to proceed with Agestra multi-AI debate.",
+      "Present this question in the user's language.",
+      "Question: 'Should we run a multi-AI debate (끝장토론) with the enabled providers?'",
+      "Options: 'Yes, run debate' / 'No, I will handle it alone'",
+      "",
+      "If user selects YES:",
+      "  1. Call `environment_check` to verify provider availability",
+      "  2. Proceed with 끝장토론 using the enabled providers",
+      "  3. Follow the workflow in the relevant skill (agestra-review / agestra-idea / agestra-design)",
+      "",
+      "If user selects NO:",
+      "  Proceed without Agestra. Handle the task directly.",
+    ];
+
+    console.log(JSON.stringify({ additionalContext: lines.join("\n") }));
   } catch (e) {
     // silent — do not block user prompt on error
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agestra",
-  "version": "4.7.0",
+  "version": "4.8.0",
   "description": "Multi-host AI orchestration toolkit for Claude Code, Codex CLI, and Gemini CLI",
   "type": "module",
   "packageManager": "npm@11.11.0",

package/skills/design.md

@@ -67,68 +67,45 @@ Brownfield: modifying or extending existing code.
 
 Call `environment_check` to determine available providers.
 
-Present mode selection (in the user's language):
+- If **no providers are available**: proceed to Phase 3 (Explore → Propose → Refine → Document) directly using `agestra-designer` agent (Claude only).
+- If **1+ providers are available**: proceed to 끝장토론 execution below.
 
-| Option | Condition | Description |
-|--------|-----------|-------------|
-| **Claude only** | Always | 플러그인 전문 에이전트가 소크라테스식 질문으로 아키텍처 탐색 |
-| **각자 독립** | 1+ provider available | 에이전트 팀(moderator + designer + 외부 AI)이 각자 독립 설계 후 취합 문서 작성 |
-| **끝장토론** | 1+ provider available | 각자 독립 설계 후 취합 문서를 돌아가며 분석/피드백, 모두 동의할 때까지 |
+### Phase 3: Execute 끝장토론
 
-Only show options whose conditions are met. If no providers are available, run Claude only.
+**팀 구성:** `agestra-moderator` (리더) + `agestra-designer` (Claude) + 사용 가능한 외부 AI (gemini, codex 등)
 
-### Phase 3: Execute
+1. Independent work + initial aggregation:
 
-#### If "Claude only":
-Proceed to Phase 4 (Explore → Propose → Refine → Document) directly using `agestra-designer` agent.
+   a. In parallel:
+      - Spawn the `agestra-designer` agent for Claude's independent architecture exploration.
+        After the agent completes, save Claude's result as a document via `workspace_create_document`:
+        - **title:** `Architecture Design — claude/designer`
+        - **metadata:** `{ "Provider": "claude/designer", "Task": "{subject}", "Mode": "Independent" }`
+        - **content:** The designer agent's full output.
+      - For each available provider, call `ai_chat` with `save_as_document`:
+        - **save_as_document.title:** `Architecture Design — {provider}`
+        - **save_as_document.metadata:** `{ "Task": "{subject}", "Mode": "Independent" }`
+        - **prompt:** Create a complete design document for [subject]. Include: 1) Problem definition — what exactly we're solving and why. 2) Constraints and requirements — technical limits, compatibility needs, performance targets. 3) 2-3 architecture approaches — each with detailed pros/cons, component diagrams, data flow, and effort estimates. 4) Recommended approach — pick one and justify the choice. 5) Implementation plan — step-by-step build sequence with dependencies. 6) Risks and mitigations. Be thorough and detailed — this document will be debated and refined.
 
-#### If "각자 독립":
+   b. Collect all document IDs.
 
-**팀 구성:** `agestra-moderator` (리더) + `agestra-designer` (Claude) + 사용 가능한 외부 AI (gemini, codex, ollama 등)
+   c. Spawn the `agestra-moderator` agent in **Independent Aggregation** mode:
+      - Pass the document ID list.
+      - Moderator reads each document, classifies consensus/unique/disputed approaches.
+      - Moderator creates an aggregated document. This becomes the starting document.
 
-1. In parallel:
-   - Spawn the `agestra-designer` agent for Claude's independent architecture exploration.
-     After the agent completes, save Claude's result as a document via `workspace_create_document`:
-     - **title:** `Architecture Design — claude/designer`
-     - **metadata:** `{ "Provider": "claude/designer", "Task": "{subject}", "Mode": "Independent" }`
-     - **content:** The designer agent's full output.
-   - For each available provider, call `ai_chat` with `save_as_document`:
-     - **save_as_document.title:** `Architecture Design — {provider}`
-     - **save_as_document.metadata:** `{ "Task": "{subject}", "Mode": "Independent" }`
-     - **prompt:** Propose an architecture approach for [subject]. Consider existing patterns in the codebase, trade-offs (complexity, performance, maintainability), and implementation steps. Present 2-3 distinct approaches with pros/cons for each.
+2. Start a turn-based debate session with `agent_debate_create`.
 
-2. Collect all document IDs.
+3. Document review rounds (no max — until all agree):
+   a. Moderator sends the current document to each AI for review.
+   b. Moderator collects all feedback and updates the working document.
+   c. If all providers agree on all sections → consensus reached.
+   d. If not → next round with the revised document.
+   e. **Every 10 rounds:** Ask the user whether to continue or stop with current state.
 
-3. Spawn the `agestra-moderator` agent in **Independent Aggregation** mode:
-   - Pass the document ID list.
-   - Moderator reads each document, classifies consensus/unique/disputed approaches.
-   - Moderator creates an aggregated document via `workspace_create_document`.
+4. When consensus is reached, record the final synthesis with `agent_debate_conclude`.
 
-4. Present summary report to the user:
-   - Key consensus approaches (1-3 lines).
-   - Notable unique design ideas (if any).
-   - Trade-off disagreements (if any).
-   - Individual + aggregated document IDs.
-
-#### If "끝장토론":
-
-**팀 구성:** `agestra-moderator` (리더) + `agestra-designer` (Claude) + 사용 가능한 외부 AI (gemini, codex, ollama 등)
-
-1. Execute "각자 독립" steps 1-3 above (independent work + initial aggregation).
-   - The moderator's integrated document becomes the starting document.
-
-2. Document review rounds (no max — until all agree):
-   a. Moderator sends the current document to each AI for review:
-      - Claude: spawn `agestra-designer` → analyze document → section-by-section feedback
-      - Other providers: `agent_debate_turn` with the document as prompt, requesting agree/disagree per section
-   b. Moderator collects all feedback.
-   c. Classify: agree/disagree per section per provider.
-   d. Revise document incorporating disagreement feedback.
-   e. If all providers agree on all sections → consensus reached.
-   f. If not → next round with revised document.
-   g. **Every 10 rounds:** Ask the user whether to continue or stop with current state.
-
-3. Present the final document:
+5. Present the final document:
    - Consensus sections: marked as agreed
    - Disputed sections: show split positions with each provider's rationale