feat: Phase 6 — Project Setup & Discovery (#2)

* feat: journal table with create trigger

Amp-Thread-ID: https://ampcode.com/threads/T-019cf10a-0f05-77aa-9a2f-292ddee96bba
Co-authored-by: Amp <amp@ampcode.com>

* feat: journal triggers for update and delete

Amp-Thread-ID: https://ampcode.com/threads/T-019cf10a-0f05-77aa-9a2f-292ddee96bba
Co-authored-by: Amp <amp@ampcode.com>

* feat: export journal to JSONL

Amp-Thread-ID: https://ampcode.com/threads/T-019cf10a-0f05-77aa-9a2f-292ddee96bba
Co-authored-by: Amp <amp@ampcode.com>

* feat: rebuild database from journal

Amp-Thread-ID: https://ampcode.com/threads/T-019cf10a-0f05-77aa-9a2f-292ddee96bba
Co-authored-by: Amp <amp@ampcode.com>

* refactor: extract bean SQL constants and bean_values helper

Amp-Thread-ID: https://ampcode.com/threads/T-019cf10a-0f05-77aa-9a2f-292ddee96bba
Co-authored-by: Amp <amp@ampcode.com>

* feat: beans init with project discovery and default AGENTS.md

Amp-Thread-ID: https://ampcode.com/threads/T-019cf255-639d-746e-9a46-c88c06cabe75
Co-authored-by: Amp <amp@ampcode.com>

* refactor: use class attribute for BeanId prefix

Amp-Thread-ID: https://ampcode.com/threads/T-019cf255-639d-746e-9a46-c88c06cabe75
Co-authored-by: Amp <amp@ampcode.com>

* docs: strengthen default-args guideline in AGENTS.md

Amp-Thread-ID: https://ampcode.com/threads/T-019cf255-639d-746e-9a46-c88c06cabe75
Co-authored-by: Amp <amp@ampcode.com>

---------

Co-authored-by: Amp <amp@ampcode.com>

Author: henriquebastos

AGENTS.md

@@ -51,15 +51,24 @@ class BeanStore:
 
 ### Default arguments for configurability
 
-Extract magic values as default arguments. This makes functions testable and reusable
-without adding configuration infrastructure.
+Never reference module-level constants directly inside function bodies. Instead, pass
+them as default arguments. This makes functions testable and reusable without adding
+configuration infrastructure. For classes, use class attributes instead of reaching for
+the global.
 
 ```python
-def generate_id(prefix="bean-", fn=partial(secrets.token_hex, ID_BYTES)) -> str:
-    return prefix + fn()
-
-def local_timestamp(dt, fmt="%Y-%m-%d %H:%M") -> str:
-    return dt.astimezone().strftime(fmt)
+# Yes — constant flows through the signature
+def find_beans_dir(start=None, dirname=BEANS_DIR) -> Path: ...
+
+# Yes — class owns its configuration
+class BeanId(str):
+    prefix = ID_PREFIX
+    def __new__(cls, value="", **kwargs):
+        if not value.startswith(cls.prefix): ...
+
+# No — function reaches for the global directly
+def find_beans_dir(start=None) -> Path:
+    candidate = current / BEANS_DIR  # hidden dependency
 ```
 
 ### `**kwargs` over dict for named fields

src/beans/cli.py

@@ -1,6 +1,8 @@
 # Python imports
 from datetime import UTC, datetime
+import importlib.resources
 import json
+from pathlib import Path
 from typing import Annotated
 
 # Pip imports
@@ -61,11 +63,52 @@ def error(e: Exception):
     raise typer.Exit(code=1) from e
 
 
-def get_store() -> Store:
-    db_path = state.get("db") or "beans.db"  # TODO: project discovery (Phase 6.2)
+BEANS_DIR = ".beans"
+DB_NAME = "beans.db"
+AGENTS_MD = "AGENTS.md"
+
+
+def get_store(db_name=DB_NAME) -> Store:
+    if state.get("db"):
+        db_path = state["db"]
+    else:
+        try:
+            db_path = str(find_beans_dir() / db_name)
+        except FileNotFoundError:
+            db_path = db_name
     return Store.from_path(db_path, dry_run=state.get("dry_run", False))
 
 
+def find_beans_dir(start=None, dirname=BEANS_DIR) -> Path:
+    """Walk up from start (default cwd) to find a .beans/ directory."""
+    current = Path(start) if start else Path.cwd()
+    while True:
+        candidate = current / dirname
+        if candidate.is_dir():
+            return candidate
+        parent = current.parent
+        if parent == current:
+            raise FileNotFoundError(f"No {dirname} directory found (walked up from {start or Path.cwd()})")
+        current = parent
+
+
+@app.command()
+def init(dirname=BEANS_DIR, db_name=DB_NAME, agents_md=AGENTS_MD):
+    """Initialize a beans project in the current directory."""
+    beans_dir = Path.cwd() / dirname
+    beans_dir.mkdir(exist_ok=True)
+
+    db_path = beans_dir / db_name
+    Store.from_path(str(db_path)).close()
+
+    agents_file = beans_dir / agents_md
+    if not agents_file.exists():
+        template = importlib.resources.files("beans.templates").joinpath(agents_md).read_text()
+        agents_file.write_text(template)
+
+    typer.echo(f"Initialized beans project in {beans_dir}")
+
+
 @app.command()
 def create(
     title: str,

src/beans/models.py

@@ -17,8 +17,10 @@ class BeanNotFoundError(KeyError):
 
 
 class BeanId(str):
+    prefix = ID_PREFIX
+
     def __new__(cls, value="", **kwargs):
-        if not value.startswith(ID_PREFIX):
+        if not value.startswith(cls.prefix):
             raise ValueError(f"Invalid bean id: {value}")
         return super().__new__(cls, value)
 
@@ -30,7 +32,7 @@ def __get_pydantic_core_schema__(cls, source_type, handler):
 
     @classmethod
     def __get_pydantic_json_schema__(cls, schema, handler):
-        return {"type": "string", "pattern": f"^{ID_PREFIX}[0-9a-f]{{8}}$"}
+        return {"type": "string", "pattern": f"^{cls.prefix}[0-9a-f]{{8}}$"}
 
     @classmethod
     def generate(cls, prefix=ID_PREFIX, fn=partial(secrets.token_hex, ID_BYTES)) -> BeanId:

src/beans/templates/AGENTS.md

@@ -0,0 +1,38 @@
+# Beans — Agent Integration
+
+This project uses [beans](https://github.com/henriquebastos/beans) for issue tracking.
+
+## Workflow
+
+Before starting work, check for available tasks:
+
+```bash
+beans ready
+```
+
+Claim a task before working on it:
+
+```bash
+beans claim <bean-id> --actor <your-name>
+```
+
+When done, close the task:
+
+```bash
+beans close <bean-id>
+```
+
+## Commands Reference
+
+| Command | Description |
+|---------|-------------|
+| `beans list` | List all beans |
+| `beans ready` | List unblocked beans |
+| `beans show <id>` | Show bean details |
+| `beans create <title>` | Create a new bean |
+| `beans update <id>` | Update bean fields |
+| `beans close <id>` | Close a bean |
+| `beans claim <id>` | Claim a bean |
+| `beans release <id>` | Release a bean |
+| `beans dep add <from> <to>` | Add dependency |
+| `beans dep remove <from> <to>` | Remove dependency |

src/beans/templates/__init__.py

@@ -0,0 +1 @@
+

tests/test_init.py

@@ -0,0 +1,115 @@
+# Python imports
+import json
+
+# Pip imports
+import pytest
+from typer.testing import CliRunner
+
+# Internal imports
+from beans.cli import app, find_beans_dir
+
+runner = CliRunner()
+
+
+@pytest.fixture()
+def project_dir(tmp_path, monkeypatch):
+    d = tmp_path / "myproject"
+    d.mkdir()
+    monkeypatch.chdir(d)
+    return d
+
+
+@pytest.fixture()
+def invoke(project_dir):
+    def invoke(*args):
+        result = runner.invoke(app, ["--json", *args])
+        data = json.loads(result.output) if result.output.strip() else None
+        return result.exit_code, data
+
+    return invoke
+
+
+def init_project():
+    return runner.invoke(app, ["init"])
+
+
+class TestInitCommand:
+    """'beans init' creates .beans/ directory with db and AGENTS.md."""
+
+    def test_init_creates_beans_dir(self, project_dir):
+        result = init_project()
+
+        assert result.exit_code == 0
+        assert (project_dir / ".beans").is_dir()
+
+    def test_init_creates_db(self, project_dir):
+        init_project()
+
+        assert (project_dir / ".beans" / "beans.db").exists()
+
+    def test_init_creates_agents_md(self, project_dir):
+        init_project()
+
+        agents_file = project_dir / ".beans" / "AGENTS.md"
+        assert agents_file.exists()
+        assert "beans" in agents_file.read_text().lower()
+
+    def test_init_idempotent(self, project_dir):
+        init_project()
+        result = init_project()
+
+        assert result.exit_code == 0
+
+    def test_init_does_not_overwrite_existing_agents_md(self, project_dir):
+        beans_dir = project_dir / ".beans"
+        beans_dir.mkdir()
+        agents_file = beans_dir / "AGENTS.md"
+        agents_file.write_text("custom content")
+
+        init_project()
+
+        assert agents_file.read_text() == "custom content"
+
+
+class TestFindBeansDir:
+    """find_beans_dir() walks up from cwd to find .beans/."""
+
+    def test_finds_beans_dir_in_cwd(self, project_dir):
+        (project_dir / ".beans").mkdir()
+        assert find_beans_dir(project_dir) == project_dir / ".beans"
+
+    def test_finds_beans_dir_in_parent(self, project_dir):
+        (project_dir / ".beans").mkdir()
+        subdir = project_dir / "src" / "app"
+        subdir.mkdir(parents=True)
+        assert find_beans_dir(subdir) == project_dir / ".beans"
+
+    def test_raises_when_not_found(self, tmp_path, monkeypatch):
+        empty = tmp_path / "empty"
+        empty.mkdir()
+        monkeypatch.chdir(empty)
+        with pytest.raises(FileNotFoundError, match=r"\.beans"):
+            find_beans_dir(empty)
+
+
+class TestProjectDiscovery:
+    """CLI commands use project discovery to find .beans/beans.db."""
+
+    def test_create_uses_discovered_db(self, project_dir, invoke):
+        init_project()
+
+        exit_code, _ = invoke("create", "Fix auth")
+        assert exit_code == 0
+
+        _, data = invoke("list")
+        assert len(data) == 1
+        assert data[0]["title"] == "Fix auth"
+
+    def test_db_flag_overrides_discovery(self, project_dir, invoke):
+        init_project()
+
+        db_path = str(project_dir / "custom.db")
+        runner.invoke(app, ["--db", db_path, "--json", "create", "Custom"])
+
+        _, data = invoke("list")
+        assert len(data) == 0