add support to local team-ai-directive

Author: kanfil

scripts/bash/common.sh

@@ -1,6 +1,9 @@
 #!/usr/bin/env bash
 # Common functions and variables for all scripts
 
+# Shared constants
+TEAM_DIRECTIVES_DIRNAME="team-ai-directives"
+
 # Load gateway configuration and export helper environment variables
 load_gateway_config() {
     local repo_root="$1"
@@ -30,6 +33,30 @@ load_gateway_config() {
     fi
 }
 
+load_team_directives_config() {
+    local repo_root="$1"
+    if [[ -n "${SPECIFY_TEAM_DIRECTIVES:-}" ]]; then
+        return
+    fi
+
+    local config_file="$repo_root/.specify/config/team_directives.path"
+    if [[ -f "$config_file" ]]; then
+        local path
+        path=$(cat "$config_file" 2>/dev/null)
+        if [[ -n "$path" && -d "$path" ]]; then
+            export SPECIFY_TEAM_DIRECTIVES="$path"
+            return
+        else
+            echo "[specify] Warning: team directives path '$path' from $config_file is unavailable." >&2
+        fi
+    fi
+
+    local default_dir="$repo_root/.specify/memory/$TEAM_DIRECTIVES_DIRNAME"
+    if [[ -d "$default_dir" ]]; then
+        export SPECIFY_TEAM_DIRECTIVES="$default_dir"
+    fi
+}
+
 # Get repository root, with fallback for non-git repositories
 get_repo_root() {
     if git rev-parse --show-toplevel >/dev/null 2>&1; then
@@ -115,6 +142,7 @@ get_feature_dir() { echo "$1/specs/$2"; }
 get_feature_paths() {
     local repo_root=$(get_repo_root)
     load_gateway_config "$repo_root"
+    load_team_directives_config "$repo_root"
     local current_branch=$(get_current_branch)
     local has_git_repo="false"
 
@@ -137,6 +165,7 @@ DATA_MODEL='$feature_dir/data-model.md'
 QUICKSTART='$feature_dir/quickstart.md'
 CONTEXT='$feature_dir/context.md'
 CONTRACTS_DIR='$feature_dir/contracts'
+TEAM_DIRECTIVES='${SPECIFY_TEAM_DIRECTIVES:-}'
 EOF
 }
 

scripts/bash/create-new-feature.sh

@@ -62,7 +62,19 @@ else
     CONSTITUTION_FILE=""
 fi
 
-TEAM_DIRECTIVES_DIR="$REPO_ROOT/.specify/memory/$TEAM_DIRECTIVES_DIRNAME"
+if [ -z "$SPECIFY_TEAM_DIRECTIVES" ]; then
+    CONFIG_TEAM_FILE="$REPO_ROOT/.specify/config/team_directives.path"
+    if [ -f "$CONFIG_TEAM_FILE" ]; then
+        CONFIG_TEAM_PATH=$(cat "$CONFIG_TEAM_FILE")
+        if [ -d "$CONFIG_TEAM_PATH" ]; then
+            export SPECIFY_TEAM_DIRECTIVES="$CONFIG_TEAM_PATH"
+        else
+            >&2 echo "[specify] Warning: team directives path '$CONFIG_TEAM_PATH' from $CONFIG_TEAM_FILE is missing."
+        fi
+    fi
+fi
+
+TEAM_DIRECTIVES_DIR="${SPECIFY_TEAM_DIRECTIVES:-$REPO_ROOT/.specify/memory/$TEAM_DIRECTIVES_DIRNAME}"
 if [ -d "$TEAM_DIRECTIVES_DIR" ]; then
     export SPECIFY_TEAM_DIRECTIVES="$TEAM_DIRECTIVES_DIR"
 else

scripts/bash/setup-plan.sh

@@ -33,6 +33,12 @@ eval $(get_feature_paths)
 # Check if we're on a proper feature branch (only for git repos)
 check_feature_branch "$CURRENT_BRANCH" "$HAS_GIT" || exit 1
 
+# Resolve team directives path if provided
+if [[ -n "$TEAM_DIRECTIVES" && ! -d "$TEAM_DIRECTIVES" ]]; then
+    echo "ERROR: TEAM_DIRECTIVES path $TEAM_DIRECTIVES is not accessible." >&2
+    exit 1
+fi
+
 # Ensure the feature directory exists
 mkdir -p "$FEATURE_DIR"
 
@@ -71,7 +77,10 @@ else
     CONSTITUTION_FILE=""
 fi
 
-TEAM_DIRECTIVES_DIR="${SPECIFY_TEAM_DIRECTIVES:-}"
+TEAM_DIRECTIVES_DIR="${TEAM_DIRECTIVES:-}"
+if [[ -z "$TEAM_DIRECTIVES_DIR" ]]; then
+    TEAM_DIRECTIVES_DIR="${SPECIFY_TEAM_DIRECTIVES:-}"
+fi
 if [[ -z "$TEAM_DIRECTIVES_DIR" ]]; then
     TEAM_DIRECTIVES_DIR="$REPO_ROOT/.specify/memory/team-ai-directives"
 fi

src/specify_cli/__init__.py

@@ -399,15 +399,21 @@ def _run_git_command(args: list[str], cwd: Path | None = None, *, env: dict[str,
     return subprocess.run(cmd, check=True, capture_output=True, text=True, env=env)
 
 
-def sync_team_ai_directives(repo_url: str, project_root: Path, *, skip_tls: bool = False) -> str:
-    """Clone or update the team-ai-directives repository under .specify/memory.
+def sync_team_ai_directives(repo_url: str, project_root: Path, *, skip_tls: bool = False) -> tuple[str, Path]:
+    """Clone or update the team-ai-directives repository.
 
-    Returns a short status string describing the action performed.
+    If repo_url is a local path, return it directly and skip cloning.
+    Returns a tuple of (status, path_to_use).
     """
     repo_url = (repo_url or "").strip()
     if not repo_url:
         raise ValueError("Team AI directives repository URL cannot be empty")
 
+    # Detect local path
+    potential_path = Path(repo_url).expanduser()
+    if potential_path.exists() and potential_path.is_dir():
+        return ("local", potential_path.resolve())
+
     memory_root = project_root / ".specify" / "memory"
     memory_root.mkdir(parents=True, exist_ok=True)
     destination = memory_root / TEAM_DIRECTIVES_DIRNAME
@@ -432,14 +438,14 @@ def sync_team_ai_directives(repo_url: str, project_root: Path, *, skip_tls: bool
                 _run_git_command(["remote", "set-url", "origin", repo_url], cwd=destination, env=git_env)
 
             _run_git_command(["pull", "--ff-only"], cwd=destination, env=git_env)
-            return "updated"
+            return ("updated", destination)
 
         if destination.exists() and not any(destination.iterdir()):
             shutil.rmtree(destination)
 
         memory_root.mkdir(parents=True, exist_ok=True)
         _run_git_command(["clone", repo_url, str(destination)], env=git_env)
-        return "cloned"
+        return ("cloned", destination)
     except subprocess.CalledProcessError as exc:
         message = exc.stderr.strip() if exc.stderr else str(exc)
         raise RuntimeError(f"Git operation failed: {message}") from exc
@@ -1116,11 +1122,13 @@ def init(
                 suppress_warning=gateway_suppress_warning,
             )
 
+            resolved_team_directives: Path | None = None
             if team_ai_directives and team_ai_directives.strip():
                 tracker.start("directives", "syncing")
                 try:
-                    directives_status = sync_team_ai_directives(team_ai_directives, project_path, skip_tls=skip_tls)
-                    tracker.complete("directives", directives_status)
+                    status, resolved_path = sync_team_ai_directives(team_ai_directives, project_path, skip_tls=skip_tls)
+                    resolved_team_directives = resolved_path
+                    tracker.complete("directives", status)
                 except Exception as e:
                     tracker.error("directives", str(e))
                     raise
@@ -1165,6 +1173,18 @@ def init(
     # Final static tree (ensures finished state visible after Live context ends)
     console.print(tracker.render())
     console.print("\n[bold green]Project ready.[/bold green]")
+
+    # Persist team directives path if available
+    if resolved_team_directives is None:
+        default_dir = project_path / ".specify" / "memory" / TEAM_DIRECTIVES_DIRNAME
+        if default_dir.exists():
+            resolved_team_directives = default_dir
+
+    if resolved_team_directives is not None:
+        os.environ["SPECIFY_TEAM_DIRECTIVES"] = str(resolved_team_directives)
+        config_dir = project_path / ".specify" / "config"
+        config_dir.mkdir(parents=True, exist_ok=True)
+        (config_dir / "team_directives.path").write_text(str(resolved_team_directives))
 
     # Agent folder security notice
     agent_folder_map = {

tests/test_team_directives.py

@@ -18,9 +18,10 @@ def fake_run(cmd, check, capture_output, text, env=None):
 
     monkeypatch.setattr(subprocess, "run", fake_run)
 
-    status = sync_team_ai_directives("https://example.com/repo.git", tmp_path, skip_tls=True)
+    status, path = sync_team_ai_directives("https://example.com/repo.git", tmp_path, skip_tls=True)
 
     assert status == "cloned"
+    assert path == tmp_path / ".specify" / "memory" / TEAM_DIRECTIVES_DIRNAME
     memory_root = tmp_path / ".specify" / "memory"
     assert memory_root.exists()
     assert calls[0][0][:2] == ["git", "clone"]
@@ -42,9 +43,10 @@ def fake_run(cmd, check, capture_output, text, env=None):
 
     monkeypatch.setattr(subprocess, "run", fake_run)
 
-    status = sync_team_ai_directives("https://example.com/repo.git", tmp_path)
+    status, path = sync_team_ai_directives("https://example.com/repo.git", tmp_path)
 
     assert status == "updated"
+    assert path == destination
     assert any(item[3] == "pull" for item in commands if len(item) > 3)
     assert commands[0][:4] == ["git", "-C", str(destination), "rev-parse"]
 
@@ -81,3 +83,13 @@ def fake_run(cmd, check, capture_output, text, env=None):
         sync_team_ai_directives("https://example.com/repo.git", tmp_path)
 
     assert "fatal: error" in str(exc.value)
+
+
+def test_sync_returns_local_path_when_given_directory(tmp_path):
+    local_repo = tmp_path / "team-ai-directives"
+    local_repo.mkdir()
+
+    status, path = sync_team_ai_directives(str(local_repo), tmp_path)
+
+    assert status == "local"
+    assert path == local_repo