devcouncil 0.2.0 → 0.2.1

package/src/devcouncil/integrations/github_intent.py

@@ -1,142 +0,0 @@
-"""Resolve a DevCouncil goal from a GitHub issue or pull-request reference.
-
-A terse goal like ``"#142"`` or a full issue URL carries far more intent than a
-one-line argument — the issue body usually *is* the spec. This module detects
-such references and expands them into a rich goal string (title + body + a few
-comments) by shelling out to the authenticated ``gh`` CLI, so private repos work
-without any token plumbing. When ``gh`` is unavailable or the lookup fails, the
-caller keeps the original goal text unchanged — expansion is strictly additive.
-"""
-
-from __future__ import annotations
-
-import json
-import re
-import shutil
-import subprocess
-from dataclasses import dataclass
-from pathlib import Path
-
-from devcouncil.utils.subprocess_env import clean_subprocess_env
-
-# Cap each pulled discussion comment so a long thread can't dominate the prompt.
-_MAX_COMMENT_CHARS = 600
-
-# "#142", "GH-142", "owner/repo#142", or a full issues/pull URL.
-_SHORT_REF = re.compile(r"^\s*(?:GH-|#)(\d+)\s*$", re.IGNORECASE)
-_OWNER_REPO_REF = re.compile(r"^\s*([\w.-]+/[\w.-]+)#(\d+)\s*$")
-_URL_REF = re.compile(
-    r"^\s*https?://github\.com/([\w.-]+/[\w.-]+)/(issues|pull)/(\d+)",
-    re.IGNORECASE,
-)
-
-
-@dataclass(frozen=True)
-class IntentRef:
-    number: int
-    kind: str  # "issue" | "pull" | "auto"
-    repo: str | None  # "owner/repo" when explicit, else None (current repo)
-
-
-def parse_intent_ref(goal: str) -> IntentRef | None:
-    """Return the GitHub reference a goal points at, or None if it's plain text."""
-    text = goal.strip()
-    m = _URL_REF.match(text)
-    if m:
-        kind = "pull" if m.group(2).lower() == "pull" else "issue"
-        return IntentRef(number=int(m.group(3)), kind=kind, repo=m.group(1))
-    m = _OWNER_REPO_REF.match(text)
-    if m:
-        return IntentRef(number=int(m.group(2)), kind="auto", repo=m.group(1))
-    m = _SHORT_REF.match(text)
-    if m:
-        return IntentRef(number=int(m.group(1)), kind="auto", repo=None)
-    return None
-
-
-def _gh_view(ref: IntentRef, sub: str, root: Path) -> dict | None:
-    """Run ``gh <issue|pr> view`` and return the parsed JSON, or None on failure."""
-    gh = shutil.which("gh")
-    if not gh:
-        return None
-    cmd = [gh, sub, "view", str(ref.number), "--json", "title,body,comments,url,state"]
-    if ref.repo:
-        cmd += ["--repo", ref.repo]
-    try:
-        result = subprocess.run(
-            cmd, cwd=root, capture_output=True, text=True,
-            encoding="utf-8", errors="replace", timeout=20, env=clean_subprocess_env(),
-        )
-    except Exception:
-        return None
-    if result.returncode != 0 or not result.stdout.strip():
-        return None
-    try:
-        data = json.loads(result.stdout)
-    except json.JSONDecodeError:
-        return None
-    return data if isinstance(data, dict) else None
-
-
-def _compose_goal(ref: IntentRef, data: dict, source: str) -> str:
-    title = str(data.get("title") or "").strip()
-    body = str(data.get("body") or "").strip()
-    url = str(data.get("url") or "").strip()
-    lines = [f"Implement {source} #{ref.number}: {title}".rstrip(": ").rstrip()]
-    if url:
-        lines.append(f"Source: {url}")
-    if body:
-        lines += ["", body]
-    # Pull in up to three discussion comments — clarifications often live there.
-    # Cap each so a long thread can't bloat the planning prompt; the issue body
-    # above is the primary spec, comments are secondary context.
-    comments = data.get("comments")
-    if isinstance(comments, list) and comments:
-        snippets = []
-        for comment in comments[:3]:
-            text = str((comment or {}).get("body") or "").strip()
-            if text:
-                if len(text) > _MAX_COMMENT_CHARS:
-                    text = text[:_MAX_COMMENT_CHARS].rstrip() + " […]"
-                snippets.append(text)
-        if snippets:
-            lines += ["", "Discussion notes:"]
-            lines += [f"- {s}" for s in snippets]
-    return "\n".join(lines).strip()
-
-
-def resolve_goal_intent(goal: str, root: Path) -> tuple[str, str | None]:
-    """Expand a GitHub issue/PR reference into a full goal.
-
-    Returns ``(goal, note)``. When ``goal`` is a reference and the lookup
-    succeeds, the first element is the composed goal and ``note`` describes the
-    expansion (for display). Otherwise the original goal is returned with a
-    ``note`` explaining why it could not be expanded (or ``None`` when the goal
-    was plain text and no expansion was attempted).
-    """
-    ref = parse_intent_ref(goal)
-    if ref is None:
-        return goal, None
-
-    if not shutil.which("gh"):
-        return goal, (
-            f"Goal looks like GitHub reference #{ref.number}, but the `gh` CLI is not on "
-            "PATH — using the literal text. Install/auth gh to pull the issue/PR body."
-        )
-
-    order = (
-        ["pull", "issue"] if ref.kind == "pull"
-        else ["issue", "pull"] if ref.kind == "issue"
-        else ["issue", "pull"]
-    )
-    for sub in order:
-        data = _gh_view(ref, "pr" if sub == "pull" else "issue", root)
-        if data is not None:
-            source = "pull request" if sub == "pull" else "issue"
-            composed = _compose_goal(ref, data, source)
-            return composed, f"Pulled intent from {source} #{ref.number} via gh."
-
-    return goal, (
-        f"Could not fetch GitHub #{ref.number} via gh (not found, no access, or not a "
-        "git/GitHub repo) — using the literal text."
-    )

package/src/devcouncil/integrations/gitnexus.py

@@ -1,62 +0,0 @@
-from pathlib import Path
-from rich.console import Console
-from devcouncil.indexing.graph_index import GraphIndex
-
-console = Console()
-AGENT_GUIDE_MARKER = "<!-- Managed by dev map: keep this file in sync with .devcouncil/repo_map.json. -->"
-
-
-def _agent_guide_text() -> str:
-    return "\n".join(
-        [
-            AGENT_GUIDE_MARKER,
-            "",
-            "# Agent Workspace Guide",
-            "",
-            "Use `.devcouncil/repo_map.json` as the primary file index for this workspace.",
-            "Repo map: `.devcouncil/repo_map.json`",
-            "",
-            "Workflow for agents:",
-            "1. Open `.devcouncil/repo_map.json` before guessing at file locations.",
-            "2. Use the `files` list to resolve module ownership and nearby siblings.",
-            "3. Run `dev map` again after large refactors to refresh the map.",
-            "",
-            "Important surfaces:",
-            "1. `src/devcouncil/cli/main.py` for CLI composition.",
-            "2. `src/devcouncil/app/orchestrator.py` and `src/devcouncil/app/state_machine.py` for lifecycle control.",
-            "3. `src/devcouncil/artifacts/graph.py` and `src/devcouncil/storage/repositories.py` for persistence and evidence.",
-            "4. `src/devcouncil/execution/` and `src/devcouncil/executors/` for task execution.",
-            "5. `src/devcouncil/verification/` and `src/devcouncil/gating/` for verification and policy gates.",
-            "",
-            "If the map and source disagree, trust the source and regenerate the map.",
-        ]
-    )
-
-class GitNexusIntegration:
-    """
-    Integration for GitNexus: Codebase knowledge graph and structural awareness.
-    """
-    def __init__(self, project_root: Path):
-        self.project_root = project_root
-
-    def initialize(self):
-        console.print("[cyan]Initializing GitNexus context...[/cyan]")
-        nexus_dir = self.project_root / ".devcouncil" / "nexus"
-        nexus_dir.mkdir(exist_ok=True)
-        # Mock initialization logic
-        (nexus_dir / "index_config.json").write_text('{"mode": "structural", "version": "1.0"}')
-        for filename in ("AGENTS.md", "CLAUDE.md"):
-            path = self.project_root / filename
-            if path.exists():
-                existing = path.read_text(encoding="utf-8")
-                if AGENT_GUIDE_MARKER not in existing:
-                    continue
-            path.write_text(_agent_guide_text() + "\n", encoding="utf-8")
-        console.print("  - GitNexus structural awareness active.")
-
-    def sync_graph(self, graph_index: GraphIndex):
-        """
-        Export DevCouncil artifact graph to GitNexus.
-        """
-        console.print("  - Syncing DevCouncil artifacts to GitNexus...")
-        pass

package/src/devcouncil/integrations/graphify.py

@@ -1,34 +0,0 @@
-from pathlib import Path
-from rich.console import Console
-
-console = Console()
-
-class GraphifyIntegration:
-    """
-    Integration for graphify: Always-on graph context and multi-agent integration.
-    """
-    def __init__(self, project_root: Path):
-        self.project_root = project_root
-
-    def initialize(self):
-        console.print("[magenta]Initializing Graphify engine...[/magenta]")
-        graphify_config = self.project_root / ".devcouncil" / "graphify.yaml"
-        # Create a default graphify config
-        content = """
-graph:
-  engine: internal
-  persist: true
-agents:
-  shared_context: true
-hooks:
-  enabled: true
-"""
-        graphify_config.write_text(content.strip())
-        console.print("  - Graphify engine configured and ready.")
-
-    def apply_rules(self):
-        """
-        Apply graph-based rules to implementation plans.
-        """
-        console.print("  - Graphify checking architectural rules...")
-        pass