devhive 0.1.34__tar.gz → 0.1.36__tar.gz

{devhive-0.1.34/devhive.egg-info → devhive-0.1.36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devhive
-Version: 0.1.34
+Version: 0.1.36
 Summary: CLI to manage DevHive skills and autonomous AI agents for OpenCode.
 Home-page: https://github.com/ramBlanco/devhive
 Author: ramBlanco
@@ -47,6 +47,7 @@ DevHive is composed of specialized Agent Skills that work sequentially:
 13. **`devhive-sast`**: Performs a Static Application Security Testing (SAST) scan and writes `05-sast-report.md`
 14. **`devhive-qa`**: Writes test cases and test plans in `06-qa-plan.md`
 15. **`devhive-auditor`**: Performs a final check and writes `07-audit.md`
+16. **`devhive-reflection`**: Extracts persistent memory (semantic, episodic, anti-patterns) to `.devhive/memory/` and writes `08-reflection.md`
 
 All of this is managed by the **`devhive-orchestrator`** skill.
 

{devhive-0.1.34 → devhive-0.1.36}/README.md

@@ -24,6 +24,7 @@ DevHive is composed of specialized Agent Skills that work sequentially:
 13. **`devhive-sast`**: Performs a Static Application Security Testing (SAST) scan and writes `05-sast-report.md`
 14. **`devhive-qa`**: Writes test cases and test plans in `06-qa-plan.md`
 15. **`devhive-auditor`**: Performs a final check and writes `07-audit.md`
+16. **`devhive-reflection`**: Extracts persistent memory (semantic, episodic, anti-patterns) to `.devhive/memory/` and writes `08-reflection.md`
 
 All of this is managed by the **`devhive-orchestrator`** skill.
 

{devhive-0.1.34 → devhive-0.1.36/devhive.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devhive
-Version: 0.1.34
+Version: 0.1.36
 Summary: CLI to manage DevHive skills and autonomous AI agents for OpenCode.
 Home-page: https://github.com/ramBlanco/devhive
 Author: ramBlanco
@@ -47,6 +47,7 @@ DevHive is composed of specialized Agent Skills that work sequentially:
 13. **`devhive-sast`**: Performs a Static Application Security Testing (SAST) scan and writes `05-sast-report.md`
 14. **`devhive-qa`**: Writes test cases and test plans in `06-qa-plan.md`
 15. **`devhive-auditor`**: Performs a final check and writes `07-audit.md`
+16. **`devhive-reflection`**: Extracts persistent memory (semantic, episodic, anti-patterns) to `.devhive/memory/` and writes `08-reflection.md`
 
 All of this is managed by the **`devhive-orchestrator`** skill.
 

{devhive-0.1.34 → devhive-0.1.36}/devhive.egg-info/SOURCES.txt

@@ -45,6 +45,7 @@ devhive_cli/skills/devhive_perf/SKILL.md
 devhive_cli/skills/devhive_prd/SKILL.md
 devhive_cli/skills/devhive_proposal/SKILL.md
 devhive_cli/skills/devhive_qa/SKILL.md
+devhive_cli/skills/devhive_reflection/SKILL.md
 devhive_cli/skills/devhive_releaser/SKILL.md
 devhive_cli/skills/devhive_sast/SKILL.md
 devhive_cli/skills/devhive_taskplanner/SKILL.md

{devhive-0.1.34 → devhive-0.1.36}/devhive_cli/main.py

@@ -1,5 +1,57 @@
 import os
 import shutil
+
+ZERO_TOUCH_POLICY = """# 🛑 SYSTEM DIRECTIVE: ZERO-TOUCH POLICY (DevHive Enforcement)
+**CRITICAL INSTRUCTION FOR ALL AI AGENTS:**
+This project strictly uses **DevHive (Skill-Driven Development)**. As a general AI agent, you are FORBIDDEN from directly modifying source code, creating files, or writing implementation logic for feature requests.
+
+When asked to build a feature, fix a bug, or apply changes, you MUST NOT do it yourself. Instead, your ONLY job is to delegate the task by invoking the DevHive orchestrator.
+
+**How to apply changes:**
+If you have access to tool calling, immediately invoke the `devhive` agent or load the `devhive-orchestrator` skill, passing the user's exact request to it. Do not attempt to bypass this pipeline.
+
+---
+"""
+
+
+def handle_existing_agents_md(dest_path: Path) -> bool:
+    """
+    Handles the case where AGENTS.md already exists.
+    Returns True if the caller should proceed to overwrite the file, False otherwise.
+    """
+    with open(dest_path, "r") as f:
+        content = f.read()
+        
+    if "ZERO-TOUCH POLICY" in content:
+        click.secho("AGENTS.md already exists and is up to date with DevHive policies.", fg="yellow")
+        return False
+        
+    click.secho("⚠️ AGENTS.md already exists, but it is missing the critical DevHive Zero-Touch Policy.", fg="yellow")
+    action = click.prompt(
+        "Do you want to:
+"
+        "  [i]nject the policy at the top (preserves your file)
+"
+        "  [o]verwrite the entire file with a new template
+"
+        "  [a]bort
+"
+        "Action",
+        type=click.Choice(['i', 'o', 'a'], case_sensitive=False)
+    )
+    
+    if action == 'i':
+        with open(dest_path, "w") as f:
+            f.write(ZERO_TOUCH_POLICY + "
+" + content)
+        click.secho("✅ Zero-Touch Policy injected successfully! Your existing content was preserved.", fg="green", bold=True)
+        return False
+    elif action == 'o':
+        return True
+    else:
+        click.secho("Aborted.", fg="yellow")
+        return False
+
 import subprocess
 from pathlib import Path
 import click
@@ -105,8 +157,8 @@ def init_frontend():
         return
         
     if dest_path.exists():
-        click.secho("AGENTS.md already exists in this directory. Aborting to prevent overwrite.", fg="yellow")
-        return
+        if not handle_existing_agents_md(dest_path):
+            return
         
     shutil.copy2(template_path, dest_path)
     click.secho("✅ Successfully created AGENTS.md with modern Next.js/React frontend guidelines!", fg="green", bold=True)
@@ -117,8 +169,8 @@ def init_backend():
     dest_path = Path.cwd() / "AGENTS.md"
     
     if dest_path.exists():
-        click.secho("AGENTS.md already exists in this directory. Aborting to prevent overwrite.", fg="yellow")
-        return
+        if not handle_existing_agents_md(dest_path):
+            return
 
     language = click.prompt("Which backend language?", type=click.Choice(['python', 'node']))
     

{devhive-0.1.34 → devhive-0.1.36}/devhive_cli/skills/devhive_architect/SKILL.md

@@ -9,7 +9,7 @@ description: Designs the technical architecture, components, data models, and in
 When the orchestrator assigns you the architecture phase after the proposal is complete.
 
 ## Input Context
-Read `.devhive/specs/01-exploration.md` and `.devhive/specs/02-proposal.md`.
+Read `.devhive/specs/01-exploration.md` and `.devhive/specs/02-proposal.md`. You MUST also check for and read `.devhive/memory/semantic.md` and `.devhive/memory/anti_patterns.md` to ensure your design does not violate historical architectural decisions or repeat past mistakes.
 
 ## Playbook (What to Do)
 0. **Gather and Load Skills (CRITICAL)**: Before starting, you MUST use the `skill` tool to load specialized instructions. Check `GUIDELINES.md` for global skills, check `04-tasks.md` for task-specific skills, and ALWAYS load your hardcoded skills: `architecture-patterns`, `backend-architect`. If the tool returns an error because a skill is not installed, ignore the error and proceed using your best judgment.

{devhive-0.1.34 → devhive-0.1.36}/devhive_cli/skills/devhive_auditor/SKILL.md

@@ -9,7 +9,7 @@ description: Verifies project consistency, architecture adherence, and security.
 When the orchestrator assigns you the audit phase as the final check.
 
 ## Input Context
-Read all specs from `.devhive/specs/` and review the final codebase state.
+Read all specs from `.devhive/specs/` and review the final codebase state. You MUST also read `.devhive/memory/semantic.md` and `.devhive/memory/anti_patterns.md` (if they exist) to ensure the code does not violate persistent project rules or use known anti-patterns.
 
 ## Playbook (What to Do)
 0. **Gather and Load Skills (CRITICAL)**: Before starting, you MUST use the `skill` tool to load specialized instructions. Check `GUIDELINES.md` for global skills, check `04-tasks.md` for task-specific skills. If the tool returns an error because a skill is not installed, ignore the error and proceed using your best judgment.

{devhive-0.1.34 → devhive-0.1.36}/devhive_cli/skills/devhive_backender/SKILL.md

@@ -9,7 +9,7 @@ description: Implements the backend logic (APIs, databases, server setup) based
 When the orchestrator assigns you the backend development phase.
 
 ## Input Context
-Read `.devhive/specs/04-tasks.md`, `.devhive/specs/03-architecture.md`, and the project's `GUIDELINES.md` if it exists.
+Read `.devhive/specs/04-tasks.md`, `.devhive/specs/03-architecture.md`, and the project's `GUIDELINES.md` if it exists. You MUST also read `.devhive/memory/episodic.md` (if it exists) to avoid repeating past backend errors.
 
 ## Playbook (What to Do)
 0. **Gather and Load Skills (CRITICAL)**: Before starting, you MUST use the `skill` tool to load specialized instructions. Check `GUIDELINES.md` for global skills, check `04-tasks.md` for task-specific skills, and ALWAYS load your hardcoded skills: `backend-security-coder`, `architecture-patterns`. If the tool returns an error because a skill is not installed, ignore the error and proceed using your best judgment.

{devhive-0.1.34 → devhive-0.1.36}/devhive_cli/skills/devhive_explorer/SKILL.md

@@ -9,7 +9,7 @@ description: Analyzes requirements, constraints, and dependencies for a new feat
 When the orchestrator assigns you the exploration phase for a feature request.
 
 ## Input Context
-You will read `.devhive/specs/00-prd.md` and `docs/PRODUCT_REQUIREMENTS.md` (if they exist) to understand the product requirements. You may also receive the user's initial request.
+You will read `.devhive/specs/00-prd.md` and `docs/PRODUCT_REQUIREMENTS.md` (if they exist) to understand the product requirements. You MUST also check for and read `.devhive/memory/semantic.md` and `.devhive/memory/anti_patterns.md` to ensure your exploration respects historical persistent memory constraints. You may also receive the user's initial request.
 
 ## Playbook (What to Do)
 0. **Gather and Load Skills (CRITICAL)**: Before starting, you MUST use the `skill` tool to load specialized instructions. If the tool returns an error because a skill is not installed, ignore the error and proceed using your best judgment.

{devhive-0.1.34 → devhive-0.1.36}/devhive_cli/skills/devhive_frontender/SKILL.md

@@ -9,7 +9,7 @@ description: Implements the user interface, client-side state, and UI/UX logic.
 When the orchestrator assigns you the frontend development phase after backend is complete.
 
 ## Input Context
-Read `.devhive/specs/04-tasks.md`, `.devhive/specs/03-architecture.md`, and the project's `GUIDELINES.md` if it exists.
+Read `.devhive/specs/04-tasks.md`, `.devhive/specs/03-architecture.md`, and the project's `GUIDELINES.md` if it exists. You MUST also read `.devhive/memory/episodic.md` (if it exists) to avoid repeating past front-end errors.
 
 ## Playbook (What to Do)
 0. **Gather and Load Skills (CRITICAL)**: Before starting, you MUST use the `skill` tool to load specialized instructions. Check `GUIDELINES.md` for global skills, check `04-tasks.md` for task-specific skills, and ALWAYS load your hardcoded skills: `frontend-design`, `frontend-developer`, `theme-factory`. If the project uses shadcn/ui, you MUST load the `shadcn` skill. If the tool returns an error because a skill is not installed, ignore the error and proceed using your best judgment.

{devhive-0.1.34 → devhive-0.1.36}/devhive_cli/skills/devhive_orchestrator/SKILL.md

@@ -26,6 +26,7 @@ The typical SDD pipeline consists of the following phases and their correspondin
 13. `devhive-sast` -> performs security scan and writes `05-sast-report.md`
 14. `devhive-qa` -> writes tests and `06-qa-plan.md`
 15. `devhive-auditor` -> `07-audit.md`
+16. `devhive-reflection` -> generates persistent memory in `.devhive/memory/` and writes `08-reflection.md`
 
 ## Playbook (Execution Loop)
 
@@ -50,13 +51,14 @@ The typical SDD pipeline consists of the following phases and their correspondin
      - If ALL sections are fully `[x]`, proceed to `devhive-sast`.
    - If `05-sast-report.md` exists but `06-qa-plan.md` does not -> Invoke `devhive-qa`.
    - If `06-qa-plan.md` exists but `07-audit.md` does not -> Invoke `devhive-auditor`.
+   - If `07-audit.md` exists but `08-reflection.md` does not -> Invoke `devhive-reflection`.
 3. **Launch Task**: Use the `Task` tool (with `subagent_type="general"`) to launch the sub-agent.
-   - **Prompt**: Instruct the sub-agent to strictly follow its corresponding DevHive skill (e.g., "Use the `devhive-proposal` skill rules to complete your work based on the current context"). Pass the user's initial request or context if needed.
+   - **Prompt**: Instruct the sub-agent to strictly follow its corresponding DevHive skill. Instruct the sub-agent to read `.devhive/memory/` files (if they exist) for contextual constraints. If invoking `devhive-reflection`, you MUST pass a summary of the current chat history (human corrections and feedback) as input. Pass the user's initial request or context if needed.
 4. **Evaluate the Result**:
    - Verify that the sub-agent successfully created the required `.devhive/specs/XX-name.md` file (or checked off tasks in `04-tasks.md`).
    - **Pause (Default Behavior)**: Stop and ask the user for approval. Show them the path of the newly created spec and ask if they want to proceed.
    - **Continuous Mode**: If the user explicitly requested "continuous mode", "no pauses", or if the project has a `.devhive/continuous` flag file, DO NOT STOP. Automatically proceed to step 1 to launch the next phase.
-5. **Completion & Executive Summary**: The pipeline is complete when the Auditor finishes and writes `07-audit.md`. Instead of just saying "done", you MUST output an **Executive Summary** to the user.
+5. **Completion & Executive Summary**: The pipeline is complete when the Reflection agent finishes and writes `08-reflection.md`. Instead of just saying "done", you MUST output an **Executive Summary** to the user.
    - You MUST use the `Read` tool to extract data from `.devhive/specs/05-sast-report.md` and `.devhive/specs/07-audit.md`.
    - **A. Security Summary**: Output a highly visible Markdown table summarizing the SAST findings. Columns: `Severity` | `Vulnerability Type` | `Affected File` | `Status/Recommendation`.
    - **B. Audit Summary**: Output a brief summary of the auditor's findings. Include the overall "Pass/Fail" status, architecture adherence, and any critical technical debt.

devhive-0.1.36/devhive_cli/skills/devhive_reflection/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: devhive-reflection
+description: Analyzes execution results and human corrections to generate persistent learning memories.
+---
+
+# Skill: devhive-reflection
+
+## Overview
+You are the Reflection Agent and Memory Manager for DevHive. Your job is to extract reusable knowledge (Semantic, Episodic, and Anti-pattern memories) from the current execution cycle and persist it, ensuring DevHive learns from mistakes and human feedback.
+
+## Inputs
+You will receive a summary of the chat history (human corrections) from the orchestrator. You MUST also use the `Read` tool to examine:
+- `.devhive/specs/04-tasks.md`
+- `.devhive/specs/05-sast-report.md`
+- `.devhive/specs/07-audit.md`
+
+## Playbook (What to Do)
+1. **Analyze Execution & Feedback**:
+   - Identify repeated mistakes, successful fixes, bad practices, architectural decisions, and human corrections from the chat history and audit reports.
+
+2. **Memory Scoring**:
+   - Evaluate each potential memory using this logic: `score = recurrence * 0.4 + severity * 0.3 + humanCorrection * 0.3` (Scale 0.0 to 1.0)
+   - ONLY keep memories with a score >= 0.6.
+
+3. **Categorize Memories**:
+   - **Semantic (`semantic.md`)**: Architecture rules, conventions, stack rules.
+   - **Episodic (`episodic.md`)**: Specific bugs and fixes (Issue + Fix).
+   - **Anti-pattern (`anti_patterns.md`)**: What NOT to do, failed strategies, destructive errors.
+
+4. **Deduplication & Writing (CRITICAL)**:
+   - You are the ONLY agent authorized to write to `.devhive/memory/`.
+   - Create the directory `.devhive/memory/` if it doesn't exist using the `Bash` tool.
+   - Read existing memory files in `.devhive/memory/` before writing to deduplicate new learnings against existing ones.
+   - Use the `Write` or `Edit` tools to append or update these files. Use concise Markdown bullet points to save tokens.
+
+5. **Acknowledge Completion**:
+   - Write a brief summary of the extracted lessons to `.devhive/specs/08-reflection.md`. This signals to the Orchestrator that memory persistence is complete.

{devhive-0.1.34 → devhive-0.1.36}/devhive_cli/skills/devhive_taskplanner/SKILL.md

@@ -9,7 +9,7 @@ description: Breaks down the architecture into actionable infrastructure, backen
 When the orchestrator assigns you the task planning phase after the architecture is designed.
 
 ## Input Context
-Read `.devhive/specs/03-architecture.md` and `.devhive/specs/02-proposal.md`.
+Read `.devhive/specs/03-architecture.md` and `.devhive/specs/02-proposal.md`. You MUST also check for and read `.devhive/memory/semantic.md` to integrate any historical rules into your task definitions.
 
 ## Playbook (What to Do)
 0. **Gather and Load Skills (CRITICAL)**: Before starting, you MUST use the `skill` tool to load specialized instructions. Check `GUIDELINES.md` for global skills, check `04-tasks.md` for task-specific skills. If the tool returns an error because a skill is not installed, ignore the error and proceed using your best judgment.

{devhive-0.1.34 → devhive-0.1.36}/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.34",
+    version="0.1.36",
     packages=find_packages(),
     include_package_data=True,
     install_requires=[