drydock-cli 2.1.0__tar.gz → 2.1.2__tar.gz

{drydock_cli-2.1.0 → drydock_cli-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drydock-cli
-Version: 2.1.0
+Version: 2.1.2
 Summary: Drydock — nautical CLI coding agent
 Project-URL: Homepage, https://github.com/fbobe321/drydock
 Project-URL: Repository, https://github.com/fbobe321/drydock

{drydock_cli-2.1.0 → drydock_cli-2.1.2}/drydock/core/agent_loop.py

@@ -296,6 +296,11 @@ class AgentLoop:
     async def act(self, msg: str) -> AsyncGenerator[BaseEvent]:
         self._clean_message_history()
 
+        # Auto-create AGENTS.md if no project instructions exist.
+        # devstral needs per-project AGENTS.md to anchor its behavior —
+        # without it the model loops on ls/bash instead of using subagents.
+        self._ensure_agents_md()
+
         # Load project state for cross-session context
         try:
             from drydock.core.session.state_file import load_state
@@ -1768,6 +1773,46 @@ class AgentLoop:
         if parts:
             self._inject_system_note("\n\n".join(parts))
 
+    def _ensure_agents_md(self) -> None:
+        """Auto-create AGENTS.md if no project instructions file exists.
+
+        devstral requires a per-project AGENTS.md to use subagents properly.
+        Without it, the model loops on bash/ls instead of delegating.
+        """
+        from drydock.core.paths import AGENTS_MD_FILENAMES
+
+        cwd = Path.cwd()
+        # Check if any project instructions file already exists
+        for name in AGENTS_MD_FILENAMES:
+            if (cwd / name).exists():
+                return  # Already has instructions
+
+        # Also check for CLAUDE.md (user might be using Claude Code convention)
+        if (cwd / "CLAUDE.md").exists():
+            return
+
+        # Create default AGENTS.md
+        agents_md = cwd / "AGENTS.md"
+        try:
+            agents_md.write_text(
+                "# Project Instructions\n\n"
+                "## Workflow\n"
+                "When building a project:\n"
+                "1. Use `task(agent=\"planner\")` to create an implementation plan first\n"
+                "2. Use `task(agent=\"explore\")` to understand existing code\n"
+                "3. Create files using `write_file` with absolute imports\n"
+                "4. Always create `__main__.py` so `python3 -m package_name` works\n"
+                "5. Test with `bash` after creating files\n\n"
+                "## Rules\n"
+                "- Use absolute imports: `from package.module import X`, NOT `from .module import X`\n"
+                "- Always create `__init__.py` and `__main__.py` for packages\n"
+                "- Create sample test data before testing\n"
+                "- Use `python3 -m package_name` to run, NOT `python3 package/file.py`\n"
+            )
+            logger.info("Auto-created AGENTS.md in %s", cwd)
+        except (OSError, PermissionError):
+            pass  # Non-critical — read-only filesystem or no permissions
+
     def _is_build_task(self, user_msg: str) -> bool:
         """Detect if a user message is an explicit build task that needs orchestration.
 

{drydock_cli-2.1.0 → drydock_cli-2.1.2}/drydock/core/prompts/cli.md

@@ -222,18 +222,21 @@ Error Handling:
 - After ANY error, your next action must be DIFFERENT from what just failed.
 - Never run the same failing command twice — the result won't change.
 
+Building Projects (multi-file):
+When asked to build a project from a PRD or requirements:
+1. Use `task(agent="planner")` to create an implementation plan FIRST
+2. Use `task(agent="explore")` to understand existing code (if any)
+3. Create files one at a time using `write_file`
+4. Test with `bash` after creating all files
+5. Fix errors with `search_replace`, then test again
+
 Python Package Rules (MANDATORY):
 When creating Python packages (directories with __init__.py):
-- ALWAYS create __main__.py so `python3 -m mypackage` works. Contents:
-  ```
-  from mypackage.cli import main
-  if __name__ == "__main__":
-      main()
-  ```
+- ALWAYS create `__init__.py` AND `__main__.py`
+- `__main__.py` contents: `from package.cli import main; main()` (if __name__ == "__main__")
 - Use ABSOLUTE imports: `from mypackage.module import X`, NOT `from .module import X`
-- NEVER run `python3 mypackage/file.py` — ALWAYS use `python3 -m mypackage`
-- Create sample/test data BEFORE running tests (e.g., create test.log before analyzing it)
-- After 1-2 successful test runs, STOP testing and summarize what you built
+- Run with `python3 -m mypackage`, NOT `python3 mypackage/file.py`
+- Create sample/test data BEFORE running tests
 
 Debugging Best Practices:
 When fixing bugs, follow this cycle: RUN → READ → FIX → VERIFY.

{drydock_cli-2.1.0 → drydock_cli-2.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "drydock-cli"
-version = "2.1.0"
+version = "2.1.2"
 description = "Drydock — nautical CLI coding agent"
 readme = "README.md"
 requires-python = ">=3.12"