devhive 0.1.25__tar.gz → 0.1.27__tar.gz

{devhive-0.1.25 → devhive-0.1.27}/MANIFEST.in

@@ -1,4 +1,5 @@
 recursive-include skills *
 recursive-include community_skills *
 recursive-include templates *
+recursive-include agents *
 

{devhive-0.1.25/devhive.egg-info → devhive-0.1.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devhive
-Version: 0.1.25
+Version: 0.1.27
 Summary: CLI to manage DevHive skills and autonomous AI agents for OpenCode.
 Home-page: https://github.com/ramBlanco/devhive
 Author: ramBlanco

devhive-0.1.27/agents/devhive.md

@@ -0,0 +1,25 @@
+---
+name: devhive
+description: Autonomous Software Development Agent using Skill-Driven Development (SDD).
+---
+
+# DevHive Agent
+
+You are DevHive, an elite autonomous software engineer and system orchestrator. 
+You manage the entire software development lifecycle using Skill-Driven Development (SDD), a pipeline that generates and follows local Markdown specifications in the `.devhive/specs/` directory.
+
+## Core Directive: Immediate Delegation
+You are NOT a general conversational assistant. Your primary function is to execute the SDD pipeline.
+Whenever invoked, your FIRST action MUST be to use the `skill` tool to load the `devhive-orchestrator` skill.
+
+## Operating Protocol
+
+1. **Initialization**: Upon receiving a user request, immediately load `devhive-orchestrator`.
+2. **Context Gathering**: 
+   - Check if the user explicitly requested "continuous mode" in their prompt.
+   - Proactively use your tools (like `bash` or `read`) to check if the flag file `.devhive/continuous` exists in the workspace.
+   - If continuous mode is enabled via either method, ensure the orchestrator knows to run the pipeline autonomously without pausing for user approval between phases.
+3. **Execution**: Follow the exact step-by-step instructions injected by the `devhive-orchestrator` skill. Rely on the local file system (`.devhive/specs/`) as your source of truth and state management.
+4. **Tone & Behavior**: Be extremely concise. Avoid conversational filler (e.g., "Sure, I can help with that!"). Output minimal text to the user, focusing entirely on executing tool calls and advancing the pipeline.
+
+Remember: Your success depends entirely on loading `devhive-orchestrator` and strictly following its phase-by-phase guidelines.

{devhive-0.1.25 → devhive-0.1.27/devhive.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devhive
-Version: 0.1.25
+Version: 0.1.27
 Summary: CLI to manage DevHive skills and autonomous AI agents for OpenCode.
 Home-page: https://github.com/ramBlanco/devhive
 Author: ramBlanco

{devhive-0.1.25 → devhive-0.1.27}/devhive.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ LICENSE
 MANIFEST.in
 README.md
 setup.py
+agents/devhive.md
 community_skills/architecture-patterns/SKILL.md
 community_skills/architecture-patterns/resources/implementation-playbook.md
 community_skills/backend-arthitect/SKILL.md
@@ -47,4 +48,5 @@ skills/devhive_releaser/SKILL.md
 skills/devhive_sast/SKILL.md
 skills/devhive_taskplanner/SKILL.md
 skills/devhive_techwriter/SKILL.md
+templates/AGENTS.backend.md
 templates/AGENTS.frontend.md

{devhive-0.1.25 → devhive-0.1.27}/devhive_cli/main.py

@@ -11,7 +11,9 @@ ROOT_DIR = CLI_DIR.parent
 LOCAL_SKILLS_DIR = ROOT_DIR / "skills"
 COMMUNITY_SKILLS_DIR = ROOT_DIR / "community_skills"
 TEMPLATES_DIR = ROOT_DIR / "templates"
+LOCAL_AGENTS_DIR = ROOT_DIR / "agents"
 TARGET_DIR = Path.home() / ".config" / "opencode" / "skills"
+TARGET_AGENTS_DIR = Path.home() / ".config" / "opencode" / "agents"
 
 @click.group()
 def cli():
@@ -47,11 +49,24 @@ def sync_local_skills(clean=False):
                     shutil.copytree(skill_path, target_skill_path)
                     click.secho(f"Updated: {skill_path.name}", fg="blue")
 
+def sync_local_agents():
+    if not TARGET_AGENTS_DIR.exists():
+        TARGET_AGENTS_DIR.mkdir(parents=True, exist_ok=True)
+    
+    if not LOCAL_AGENTS_DIR.exists():
+        click.secho(f"Warning: Source directory {LOCAL_AGENTS_DIR} not found.", fg="yellow")
+        return
+        
+    click.secho(f"\nSyncing agents from {LOCAL_AGENTS_DIR.name}...", fg="cyan", bold=True)
+    for agent_file in LOCAL_AGENTS_DIR.glob("*.md"):
+        target_file = TARGET_AGENTS_DIR / agent_file.name
+        shutil.copy2(agent_file, target_file)
+        click.secho(f"Installed agent: {agent_file.name}", fg="green")
+
 def install_remote_skills():
     click.secho("\nInstalling official remote skills via npx...", fg="cyan", bold=True)
     commands = [
         ["npx", "--yes", "skills", "add", "https://github.com/shadcn/ui", "--skill", "shadcn", "-y", "--global"],
-        ["npx", "--yes", "skills", "add", "https://github.com/supercent-io/skills-template", "--skill", "responsive-design", "-y", "--global"]
     ]
     
     for cmd in commands:
@@ -66,6 +81,7 @@ def install():
     """Install all devhive and community skills."""
     click.secho("Starting DevHive Skills Installation...", fg="green", bold=True)
     sync_local_skills(clean=False)
+    sync_local_agents()
     install_remote_skills()
     click.secho("\nInstallation Complete! 🎉", fg="green", bold=True)
 
@@ -74,6 +90,7 @@ def update_skill():
     """Update all skills (cleans existing ones and reinstalls)."""
     click.secho("Updating DevHive Skills...", fg="blue", bold=True)
     sync_local_skills(clean=True)
+    sync_local_agents()
     install_remote_skills()
     click.secho("\nUpdate Complete! 🚀", fg="green", bold=True)
 
@@ -115,7 +132,12 @@ def init_backend():
     
     iac = click.prompt("Which IaC tool are you using?", type=click.Choice(['cdk', 'terraform', 'serverless']))
     
-    md_content = generate_backend_agents_md(language, framework, iac, use_di)
+    template_path = TEMPLATES_DIR / "AGENTS.backend.md"
+    if not template_path.exists():
+        click.secho("Error: Backend template not found in the devhive package.", fg="red")
+        return
+
+    md_content = generate_backend_agents_md(template_path, language, framework, iac, use_di)
     
     with open(dest_path, "w", encoding="utf-8") as f:
         f.write(md_content)

{devhive-0.1.25 → devhive-0.1.27}/devhive_cli/templates_backend.py

@@ -1,4 +1,7 @@
-def generate_backend_agents_md(language: str, framework: str, iac: str, use_di: bool) -> str:
+import os
+from pathlib import Path
+
+def generate_backend_agents_md(template_path: Path, language: str, framework: str, iac: str, use_di: bool) -> str:
     stack_list = []
     if language == 'python':
         stack_list.append("- **Language**: Python 3.10+ (Strict Type Hinting)")
@@ -29,73 +32,21 @@ def generate_backend_agents_md(language: str, framework: str, iac: str, use_di:
         stack_list.append("- **Infrastructure as Code**: Serverless Framework")
 
     stack_section = "\n".join(stack_list)
+    iac_tool_upper = iac.upper()
 
-    # Base structure
-    md = f"""# Backend Architecture & AI Agent Guidelines
-
-This `AGENTS.md` (or `GUIDELINES.md`) file serves as the strict instruction manual for OpenCode and DevHive agents. It defines the technical stack, architectural patterns, and coding conventions for this backend project.
-
-## 🛠️ 1. Tech Stack
-{stack_section}
-
-## 🧠 2. OpenCode Skills to Load
-Agents **MUST** load the following specialized skills before executing tasks:
-- `architecture-patterns`: For maintaining clean separation of concerns and Hexagonal Architecture.
-- `backend-architect`: For scalable API design and domain modeling.
-- `backend-security-coder`: For secure coding practices, input validation, and auth.
-- `devhive-devops`: For {iac.upper()} infrastructure setup.
-
-## 📂 3. Project Structure (Hexagonal Architecture)
-For maximum scalability, testability, and maintainability, the project MUST strictly follow Hexagonal Architecture (Ports & Adapters).
-
-```text
-src/
-├── domain/             # ENTERPRISE BUSINESS RULES (No external dependencies)
-│   ├── entities/       # Pure domain models
-│   └── exceptions/     # Domain-specific errors
-├── application/        # APPLICATION BUSINESS RULES (Use Cases & Ports)
-│   ├── use_cases/      # Orchestrates domain logic
-│   └── ports/          # Interfaces for outbound communication (Repositories, External APIs)
-├── infrastructure/     # ADAPTERS (Database, External Services, Third-party libs)
-│   ├── database/       # Concrete implementation of repository ports
-│   └── di/             # Dependency Injection container/setup
-└── presentation/       # ENTRY POINTS (Controllers, REST APIs, GraphQL, Lambdas)
-    └── controllers/    # Parses HTTP requests and calls use cases
-
-infrastructure/         # IaC DEFINITIONS (Outside src/)
-└── # {iac.upper()} configurations
-```
-
-## 📐 4. Architectural Rules & Clean Code (CRITICAL)
-
-1. **The Dependency Rule**: Source code dependencies MUST only point inward, toward the `domain/`. 
-   - `domain/` knows nothing about anything else.
-   - `application/` depends only on `domain/`.
-   - `infrastructure/` and `presentation/` depend on `application/` and `domain/`.
-   - **Never import an infrastructure detail (like a DB model) into a use case.**
-
-2. **Ports and Adapters**:
-   - Outbound communication (like DB queries) MUST be defined as an interface (Port) in the `application/` layer.
-   - The actual database logic MUST be implemented as an Adapter in the `infrastructure/` layer.
-
-3. **Dependency Injection**:
-   - Use Cases must receive their dependencies (Ports) via constructor injection.
-   - The Presentation layer resolves these dependencies and passes them to the Use Cases.
-"""
-
+    di_rules = ""
     if language == 'node' and use_di:
-        md += """
+        di_rules = """
 4. **InversifyJS Usage**:
    - Decorate concrete adapters in `infrastructure/` with `@injectable()`.
    - Bind interfaces to symbols in an `inversify.config.ts` container file.
    - Use the container in the `presentation/` layer to resolve use cases.
 """
 
-    md += "\n## 💻 5. Code Examples\n\n"
-
+    code_examples = ""
     if language == 'python':
         if framework == 'fastapi':
-            md += """### Example: FastAPI + Hexagonal Architecture
+            code_examples = """### Example: FastAPI + Hexagonal Architecture
 
 **1. Port (Application Layer)**
 *File: `src/application/ports/user_repository.py`*
@@ -165,7 +116,7 @@ def get_user(user_id: str, use_case: GetUserUseCase = Depends(get_user_use_case)
 ```
 """
         elif framework == 'django':
-            md += """### Example: Django + Hexagonal Architecture
+            code_examples = """### Example: Django + Hexagonal Architecture
 
 **Note on Django**: Do NOT put business logic in Django Views or Models. Use Django ONLY as the `infrastructure/` and `presentation/` layers.
 
@@ -217,7 +168,7 @@ def get_user_view(request, user_id: str):
 ```
 """
         else:
-            md += """### Example: Pure Python + Hexagonal Architecture
+            code_examples = """### Example: Pure Python + Hexagonal Architecture
 
 **1. Port (Application Layer)**
 *File: `src/application/ports/user_repository.py`*
@@ -262,7 +213,7 @@ def lambda_handler(event, context):
 """
     else: # Node.js
         if use_di:
-            md += """### Example: Node.js + TypeScript + InversifyJS
+            code_examples = """### Example: Node.js + TypeScript + InversifyJS
 
 **1. Port (Application Layer)**
 *File: `src/application/ports/IUserRepository.ts`*
@@ -356,7 +307,7 @@ export class UserController {
 ```
 """
         else:
-            md += """### Example: Node.js + TypeScript (Manual DI)
+            code_examples = """### Example: Node.js + TypeScript (Manual DI)
 
 **1. Port (Application Layer)**
 *File: `src/application/ports/IUserRepository.ts`*
@@ -421,4 +372,12 @@ export class UserController {
 ```
 """
 
+    with open(template_path, 'r', encoding='utf-8') as f:
+        md = f.read()
+
+    md = md.replace("{{TECH_STACK}}", stack_section)
+    md = md.replace("{{IAC_TOOL}}", iac_tool_upper)
+    md = md.replace("{{DI_RULES}}", di_rules)
+    md = md.replace("{{CODE_EXAMPLES}}", code_examples)
+
     return md

{devhive-0.1.25 → devhive-0.1.27}/setup.py

@@ -8,7 +8,7 @@ with open(os.path.join(this_directory, 'README.md'), encoding='utf-8') as f:
 
 setup(
     name="devhive",
-    version="0.1.25",
+    version="0.1.27",
     packages=find_packages(),
     include_package_data=True,
     install_requires=[

devhive-0.1.27/templates/AGENTS.backend.md

@@ -0,0 +1,54 @@
+# Backend Architecture & AI Agent Guidelines
+
+This `AGENTS.md` (or `GUIDELINES.md`) file serves as the strict instruction manual for OpenCode and DevHive agents. It defines the technical stack, architectural patterns, and coding conventions for this backend project.
+
+## 🛠️ 1. Tech Stack
+{{TECH_STACK}}
+
+## 🧠 2. OpenCode Skills to Load
+Agents **MUST** load the following specialized skills before executing tasks:
+- `architecture-patterns`: For maintaining clean separation of concerns and Hexagonal Architecture.
+- `backend-architect`: For scalable API design and domain modeling.
+- `backend-security-coder`: For secure coding practices, input validation, and auth.
+- `devhive-devops`: For {{IAC_TOOL}} infrastructure setup.
+
+## 📂 3. Project Structure (Hexagonal Architecture)
+For maximum scalability, testability, and maintainability, the project MUST strictly follow Hexagonal Architecture (Ports & Adapters).
+
+```text
+src/
+├── domain/             # ENTERPRISE BUSINESS RULES (No external dependencies)
+│   ├── entities/       # Pure domain models
+│   └── exceptions/     # Domain-specific errors
+├── application/        # APPLICATION BUSINESS RULES (Use Cases & Ports)
+│   ├── use_cases/      # Orchestrates domain logic
+│   └── ports/          # Interfaces for outbound communication (Repositories, External APIs)
+├── infrastructure/     # ADAPTERS (Database, External Services, Third-party libs)
+│   ├── database/       # Concrete implementation of repository ports
+│   └── di/             # Dependency Injection container/setup
+└── presentation/       # ENTRY POINTS (Controllers, REST APIs, GraphQL, Lambdas)
+    └── controllers/    # Parses HTTP requests and calls use cases
+
+infrastructure/         # IaC DEFINITIONS (Outside src/)
+└── # {{IAC_TOOL}} configurations
+```
+
+## 📐 4. Architectural Rules & Clean Code (CRITICAL)
+
+1. **The Dependency Rule**: Source code dependencies MUST only point inward, toward the `domain/`. 
+   - `domain/` knows nothing about anything else.
+   - `application/` depends only on `domain/`.
+   - `infrastructure/` and `presentation/` depend on `application/` and `domain/`.
+   - **Never import an infrastructure detail (like a DB model) into a use case.**
+
+2. **Ports and Adapters**:
+   - Outbound communication (like DB queries) MUST be defined as an interface (Port) in the `application/` layer.
+   - The actual database logic MUST be implemented as an Adapter in the `infrastructure/` layer.
+
+3. **Dependency Injection**:
+   - Use Cases must receive their dependencies (Ports) via constructor injection.
+   - The Presentation layer resolves these dependencies and passes them to the Use Cases.
+{{DI_RULES}}
+## 💻 5. Code Examples
+
+{{CODE_EXAMPLES}}