devhive 0.1.19__tar.gz → 0.1.20__tar.gz

{devhive-0.1.19 → devhive-0.1.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devhive
-Version: 0.1.19
+Version: 0.1.20
 Summary: DevHive MCP Server
 Requires-Python: >=3.10
 License-File: LICENSE

{devhive-0.1.19 → devhive-0.1.20}/devhive/cli.py

@@ -5,55 +5,55 @@ import json
 import os
 from pathlib import Path
 
-# Try to find default agent file location relative to package
-# This assumes the package structure allows finding the file in the root
+# Try to find default skill file location relative to package
 PACKAGE_ROOT = Path(__file__).parent.parent
-DEFAULT_AGENT_PATH = PACKAGE_ROOT / "DEVHIVE_AGENT.md"
+DEFAULT_SKILL_PATH = PACKAGE_ROOT / "skills" / "devhive_workflow.md"
 
-def get_default_agent_content():
-    """Reads the DEVHIVE_AGENT.md content from the package source."""
-    if DEFAULT_AGENT_PATH.exists():
-        return DEFAULT_AGENT_PATH.read_text()
+def get_default_skill_content():
+    """Reads the devhive_workflow.md content from the package source."""
+    if DEFAULT_SKILL_PATH.exists():
+        return DEFAULT_SKILL_PATH.read_text()
     
-    # Fallback content if file is totally missing (should not happen in proper install)
-    return """# DevHive Agent System Prompt
+    # Fallback content if file is missing
+    return """# DevHive Workflow Orchestrator
 
-You are the DevHive Agent, an autonomous software development orchestrator.
-Your goal is to manage the full software development lifecycle using the DevHive MCP server tools.
+This skill defines the autonomous execution loop for the DevHive AI software development pipeline.
 
-## Core Workflow
+## Core Rules
+1. **Autonomous Execution**: Run the entire DevHive pipeline autonomously. Do not stop to ask the user for permission between each agent step unless an unrecoverable error occurs or the Explorer agent explicitly asks a `clarification_question`.
+2. **Subagent Delegation**: You MUST use the `Task` tool with `subagent_type="general"` to execute the prompts generated by the MCP server. Do not execute the prompts yourself in the main context.
+3. **Strict JSON**: The DevHive MCP server expects strict JSON. Instruct the subagent to output ONLY valid JSON without markdown formatting.
 
-1.  **Start/Resume Project**:
-    - Use `devhive_start_pipeline(project_name, requirements)` to initialize a project or get the next task.
-    - If the project already exists, this will resume from the last state.
+## The Execution Loop
 
-2.  **Execute Task**:
-    - The output of `devhive_start_pipeline` (or `devhive_submit_result`) provides a `next_task` object containing:
-        - `agent`: The sub-agent role (e.g., Explorer, Developer).
-        - `system_prompt`: The specific instructions for this sub-agent.
-        - `user_prompt`: The context and requirements for the task.
-    - You must execute this task. 
-      - **OpenCode**: Use the `Task` tool with the provided prompts.
-      - **Copilot**: Act as the sub-agent directly using the prompts.
+When a user asks you to build a feature or start a project using DevHive, follow this exact procedure:
 
-3.  **Submit Result**:
-    - Once the sub-agent task is complete, use `devhive_submit_result(project_name, agent_name, llm_response)` to save the work.
-    - This tool will return the *next* task in the pipeline.
-    - Repeat step 2 with the new task.
+### 1. Initialization
+Use the `devhive_start_pipeline` tool.
+- `project_name`: A short snake_case identifier derived from the request.
+- `requirements`: The user's full request.
 
-## Available Tools
+The tool will return a JSON envelope containing `status`, `agent`, `system_prompt`, `user_prompt`, `expected_keys`, and `task_description`.
 
-- `devhive_start_pipeline`: Initialize project and get first task.
-- `devhive_submit_result`: Save task result and get next task.
-- `devhive_search_memory`: Retrieve context from previous steps.
-- `devhive_get_memory_stats`: Check project memory usage.
-- `devhive_get_recent_memories`: See recent project activity.
+### 2. Main Loop
+While `status` is `"pending"`:
 
-## Important Instructions
+**A. Launch Subagent**
+Use the `Task` tool with `subagent_type="general"`.
+- `description`: The `task_description` from the envelope.
+- `prompt`: Combine the `system_prompt` and `user_prompt` from the envelope. Append this CRITICAL instruction: *"You must ONLY output valid JSON containing these exact keys: {expected_keys}. Do not include any other text, markdown formatting, or explanations."*
 
-- Always follow the strict sequential pipeline: Explorer -> Proposal -> Architect -> TaskPlanner -> Developer -> QA -> Auditor -> Archivist.
-- Do not skip steps unless the pipeline explicitly skips them.
-- Use the prompts provided by the tools exactly as given.
+**B. Submit Result**
+Once the subagent returns its JSON output, use the `devhive_submit_result` tool.
+- `project_name`: The current project name.
+- `agent_name`: The `agent` from the current envelope.
+- `llm_response`: The raw JSON output from the subagent.
+
+**C. Process Server Response**
+The tool will return a new envelope:
+- If `status` == `"success"`: Print a brief update to the user. If `next_task` is present, update your envelope and repeat the loop.
+- If `status` == `"error"`: The envelope has an error message. Launch the subagent again, provide the error and the previous output, and ask it to fix the JSON structure. Retry up to 3 times.
+- If `status` == `"complete"`: The pipeline is finished. Give the user a final summary and exit the loop.
 """
 
 def configure():
@@ -68,24 +68,24 @@ def configure():
         print("Invalid choice. Please type 'opencode', 'copilot', or 'both'.")
 
     # 2. Locate source file
-    cwd_agent = Path("DEVHIVE_AGENT.md").resolve()
-    pkg_agent = DEFAULT_AGENT_PATH.resolve()
+    cwd_skill = Path("skills/devhive_workflow.md").resolve()
+    pkg_skill = DEFAULT_SKILL_PATH.resolve()
     
     source_to_use = None
     
-    if cwd_agent.exists():
-        print(f"[+] Found agent file in current directory: {cwd_agent}")
-        source_to_use = cwd_agent
-    elif pkg_agent.exists():
-        print(f"[+] Found agent file in package: {pkg_agent}")
-        source_to_use = pkg_agent
+    if cwd_skill.exists():
+        print(f"[+] Found skill file in current directory: {cwd_skill}")
+        source_to_use = cwd_skill
+    elif pkg_skill.exists():
+        print(f"[+] Found skill file in package: {pkg_skill}")
+        source_to_use = pkg_skill
     else:
-        print("[-] DEVHIVE_AGENT.md not found.")
-        print("[*] Using embedded default agent prompt.")
-        temp_path = Path("DEVHIVE_AGENT.md").resolve()
+        print("[-] skills/devhive_workflow.md not found.")
+        print("[*] Using embedded default skill prompt.")
+        temp_path = Path("devhive_workflow.md").resolve()
         try:
             with open(temp_path, "w") as f:
-                f.write(get_default_agent_content())
+                f.write(get_default_skill_content())
             print(f"[+] Created temporary source file at: {temp_path}")
             source_to_use = temp_path
         except Exception as e:
@@ -94,16 +94,36 @@ def configure():
 
     # 3. Configure OpenCode
     if choice in ["opencode", "both"]:
-        dest_dir = Path.home() / ".config" / "opencode" / "agents"
-        dest_file = dest_dir / "DevHive0119.md"
-        _copy_agent_file(source_to_use, dest_dir, dest_file, "OpenCode Agent")
+        # Remove legacy agent
+        old_agent_dir = Path.home() / ".config" / "opencode" / "agents"
+        old_agent = old_agent_dir / "DevHive0119.md"
+        if old_agent.exists():
+            print(f"[*] Removing legacy OpenCode agent: {old_agent}")
+            try:
+                old_agent.unlink()
+            except Exception as e:
+                print(f"[-] Could not remove legacy agent: {e}")
+        
+        dest_dir = Path.home() / ".config" / "opencode" / "skills"
+        dest_file = dest_dir / "devhive_workflow.md"
+        _copy_agent_file(source_to_use, dest_dir, dest_file, "OpenCode Skill")
         _configure_devhive()
 
     # 4. Configure Copilot
     if choice in ["copilot", "both"]:
-        dest_dir = Path.home() / ".copilot" / "agents"
-        dest_file = dest_dir / "DevHive.md"
-        _copy_agent_file(source_to_use, dest_dir, dest_file, "Copilot Agent")
+        # Remove legacy agent
+        old_agent_dir = Path.home() / ".copilot" / "agents"
+        old_agent = old_agent_dir / "DevHive.md"
+        if old_agent.exists():
+            print(f"[*] Removing legacy Copilot agent: {old_agent}")
+            try:
+                old_agent.unlink()
+            except Exception as e:
+                print(f"[-] Could not remove legacy agent: {e}")
+
+        dest_dir = Path.home() / ".copilot" / "instructions"
+        dest_file = dest_dir / "devhive_workflow.md"
+        _copy_agent_file(source_to_use, dest_dir, dest_file, "Copilot Instructions")
         _configure_vscode_copilot(dest_file)
 
     print("\nConfiguration complete!")

{devhive-0.1.19 → devhive-0.1.20}/devhive/core/task_orchestrator.py

@@ -1,6 +1,6 @@
 """
 Task-based pipeline orchestrator.
-Manages agent sequence and returns Task launch instructions for OpenCode.
+Manages agent sequence and returns Task launch instructions for SDD Skill execution.
 """
 
 import json
@@ -27,7 +27,7 @@ class TaskOrchestrator:
     - Builds prompts using PromptBuilder
     - Validates responses using ResponseValidator
     - Saves artifacts using ArtifactManager
-    - Returns structured envelopes for OpenCode
+    - Returns structured envelopes for Skill execution
     """
     
     def __init__(self, project_name: str):

{devhive-0.1.19 → devhive-0.1.20}/devhive/server.py

@@ -55,7 +55,7 @@ def _parse_json_response(text: str) -> Dict[str, Any]:
         raise ValueError(f"Invalid JSON response: {e}")
 
 # ============================================================================
-# TASK-BASED WORKFLOW TOOLS (Recommended - Uses OpenCode Task Tool)
+# TASK-BASED WORKFLOW TOOLS (Recommended - Use devhive_workflow skill)
 # ============================================================================
 
 @mcp.tool()
@@ -64,7 +64,7 @@ def devhive_start_pipeline(project_name: str, requirements: str) -> str:
     Start a new DevHive pipeline with Task-based execution.
     
     This is the RECOMMENDED way to use DevHive. It returns Task launch instructions
-    that OpenCode can use to execute each agent in isolated context.
+    that OpenCode should execute using the devhive_workflow skill.
 
     Remember always read AGENTS.md if exists.
     
@@ -85,7 +85,7 @@ def devhive_start_pipeline(project_name: str, requirements: str) -> str:
     
     Example:
         result = devhive_start_pipeline("csv_export", "Add CSV export to dashboard")
-        # Use result["system_prompt"] and result["user_prompt"] with OpenCode Task tool
+        # Use result["system_prompt"] and result["user_prompt"] with Task tool (general)
         # Then call devhive_submit_result() with the Task output
     """
     try:
@@ -136,7 +136,7 @@ def devhive_submit_result(project_name: str, agent_name: str, llm_response: str)
         if result["status"] == "success":
             print(result["executive_summary"])
             next_task = result["next_task"]
-            # Use next_task with OpenCode Task tool
+            # Use next_task with Task tool (general)
     """
     try:
         from devhive.core.task_orchestrator import TaskOrchestrator

{devhive-0.1.19 → devhive-0.1.20}/devhive.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devhive
-Version: 0.1.19
+Version: 0.1.20
 Summary: DevHive MCP Server
 Requires-Python: >=3.10
 License-File: LICENSE

{devhive-0.1.19 → devhive-0.1.20}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "devhive"
-version = "0.1.19"
+version = "0.1.20"
 description = "DevHive MCP Server"
 requires-python = ">=3.10"
 

{devhive-0.1.19 → devhive-0.1.20}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="devhive",
-    version="0.1.19",
+    version="0.1.20",
     packages=find_packages(),
     package_data={
         "devhive": ["skills/*.md", "skills/*/*.md"],