devcouncil 0.1.0 → 0.2.0

package/src/devcouncil/integrations/gitnexus.py

@@ -1,27 +1,62 @@
-from pathlib import Path
-from rich.console import Console
-from devcouncil.indexing.graph_index import GraphIndex
-
-console = Console()
-
-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"}')
-        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
+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 +1,34 @@
-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
+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