agentrepocoach 0.3.1__tar.gz → 0.4.0__tar.gz

{agentrepocoach-0.3.1 → agentrepocoach-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentrepocoach
-Version: 0.3.1
+Version: 0.4.0
 Summary: Score your codebase on how ready it is for AI agents — and coach you through the fixes.
 Author: WouterDeBot
 License: Apache-2.0
@@ -43,13 +43,14 @@ Dynamic: license-file
 
 AgentRepoCoach computes the **Codebase Agent Health (CAH)** score: a single 0-100
 composite measuring how friendly a repository is for autonomous AI agents.
-It blends five statically-measurable components:
+It blends six statically-measurable components:
 
-- **Navigability** (25%) — `AGENTS.md`, codebase map, CLI manifest, root cleanliness
-- **Error quality** (25%) — fix-hint coverage, exception typing, generic-exception dominance
-- **Decision queryability** (20%) — ADR catalog, inline reference resolution
-- **Test quality** (15%) — naming convention, helper presence, fixture duplication
-- **Module hygiene** (15%) — internal visibility, god files, doc coverage, architecture doc freshness
+- **Navigability** (22%) — `AGENTS.md`, codebase map, CLI manifest, root cleanliness
+- **Error quality** (22%) — fix-hint coverage, exception typing, generic-exception dominance
+- **Decision queryability** (18%) — ADR catalog, inline reference resolution
+- **Test quality** (13%) — naming convention, helper presence, fixture duplication
+- **Module hygiene** (13%) — internal visibility, god files, doc coverage, architecture doc freshness
+- **Bootstrap signals** (12%) — CI-Signal (runnable test workflow on PR triggers) + README-quality (install + test commands in first 100 lines)
 
 AgentRepoCoach ships with zero runtime dependencies — it uses the Python 3.11+
 standard library only, including `tomllib` for config parsing.
@@ -111,9 +112,21 @@ jobs:
 
 ## Usage as a CLI
 
+Install and run:
+
 ```bash
 pip install agentrepocoach
+```
+
+Run tests after contributing:
+
+```bash
+pytest tests/ -q
+```
+
+Score your repository:
 
+```bash
 # Score the current directory (prints a summary table)
 python -m agentrepocoach.cli --repo .
 
@@ -139,16 +152,19 @@ AgentRepoCoach looks for `.agentrepocoach.toml` at the repo root. Every field is
 optional — the tool ships with sensible defaults and will score zero-config
 repos without complaint.
 
-Minimal example:
+Minimal example (schema v2, required since v0.4.0):
 
 ```toml
 # .agentrepocoach.toml
+schema_version = 2
+
 [weights]
-navigability = 0.25
-error_quality = 0.25
-decision_queryability = 0.20
-test_quality = 0.15
-module_hygiene = 0.15
+navigability = 0.22
+error_quality = 0.22
+decision_queryability = 0.18
+test_quality = 0.13
+module_hygiene = 0.13
+bootstrap_signals = 0.12
 
 [paths]
 adr_dir = "docs/adr/"
@@ -159,8 +175,17 @@ domain_exception_types = ["DomainError", "ValidationError"]
 
 [decision_queryability]
 inline_ref_patterns = ["ADR-\\d+"]
+
+# Optional: tune bootstrap_signals detection globs / patterns
+[bootstrap_signals]
+ci_workflow_globs = [".github/workflows/*.yml", ".gitlab-ci.yml"]
 ```
 
+**Migrating from v1?** Add `schema_version = 2` at the top and add
+`bootstrap_signals = 0.12` to `[weights]`, then rebalance the other five
+weights so they still sum to 1.0. See [`docs/configuration.md`](docs/configuration.md)
+for the one-line migration recipe.
+
 See [`docs/METHODOLOGY.md`](docs/METHODOLOGY.md) for the full config schema
 and scoring formula.
 
@@ -192,10 +217,19 @@ appear in:
 ## How it works
 
 AgentRepoCoach detects the primary language of the repo, loads a language
-adapter, and runs five component scorers against the adapter's view of
+adapter, and runs six component scorers against the adapter's view of
 the codebase. Each component returns a 0-100 sub-score with a transparent
 breakdown. The weighted sum is the composite CAH score.
 
+The six components are:
+
+- **Navigability** — checks for `AGENTS.md`, codebase map, CLI manifest, and root cleanliness.
+- **Error quality** — scores fix-hint coverage, exception typing, and generic-exception usage.
+- **Decision queryability** — audits ADR catalog completeness and inline ADR cross-references.
+- **Test quality** — checks test naming conventions, helper presence, and fixture duplication.
+- **Module hygiene** — inspects internal visibility ratios, god files, doc coverage, and architecture doc freshness.
+- **Bootstrap signals** — language-agnostic CI-Signal scorer (does the repo have a CI workflow triggered on pull requests?) and README-quality scorer (do the first 100 README lines contain both an install and a test command in fenced code blocks?). Both are configurable via `[bootstrap_signals]` in `.agentrepocoach.toml`.
+
 Every output field is a count, percentage, type name, or file path —
 AgentRepoCoach never emits code snippets or raw message bodies, so reports
 are safe to publish as CI artifacts.

{agentrepocoach-0.3.1 → agentrepocoach-0.4.0}/README.md

@@ -9,13 +9,14 @@
 
 AgentRepoCoach computes the **Codebase Agent Health (CAH)** score: a single 0-100
 composite measuring how friendly a repository is for autonomous AI agents.
-It blends five statically-measurable components:
+It blends six statically-measurable components:
 
-- **Navigability** (25%) — `AGENTS.md`, codebase map, CLI manifest, root cleanliness
-- **Error quality** (25%) — fix-hint coverage, exception typing, generic-exception dominance
-- **Decision queryability** (20%) — ADR catalog, inline reference resolution
-- **Test quality** (15%) — naming convention, helper presence, fixture duplication
-- **Module hygiene** (15%) — internal visibility, god files, doc coverage, architecture doc freshness
+- **Navigability** (22%) — `AGENTS.md`, codebase map, CLI manifest, root cleanliness
+- **Error quality** (22%) — fix-hint coverage, exception typing, generic-exception dominance
+- **Decision queryability** (18%) — ADR catalog, inline reference resolution
+- **Test quality** (13%) — naming convention, helper presence, fixture duplication
+- **Module hygiene** (13%) — internal visibility, god files, doc coverage, architecture doc freshness
+- **Bootstrap signals** (12%) — CI-Signal (runnable test workflow on PR triggers) + README-quality (install + test commands in first 100 lines)
 
 AgentRepoCoach ships with zero runtime dependencies — it uses the Python 3.11+
 standard library only, including `tomllib` for config parsing.
@@ -77,9 +78,21 @@ jobs:
 
 ## Usage as a CLI
 
+Install and run:
+
 ```bash
 pip install agentrepocoach
+```
+
+Run tests after contributing:
+
+```bash
+pytest tests/ -q
+```
+
+Score your repository:
 
+```bash
 # Score the current directory (prints a summary table)
 python -m agentrepocoach.cli --repo .
 
@@ -105,16 +118,19 @@ AgentRepoCoach looks for `.agentrepocoach.toml` at the repo root. Every field is
 optional — the tool ships with sensible defaults and will score zero-config
 repos without complaint.
 
-Minimal example:
+Minimal example (schema v2, required since v0.4.0):
 
 ```toml
 # .agentrepocoach.toml
+schema_version = 2
+
 [weights]
-navigability = 0.25
-error_quality = 0.25
-decision_queryability = 0.20
-test_quality = 0.15
-module_hygiene = 0.15
+navigability = 0.22
+error_quality = 0.22
+decision_queryability = 0.18
+test_quality = 0.13
+module_hygiene = 0.13
+bootstrap_signals = 0.12
 
 [paths]
 adr_dir = "docs/adr/"
@@ -125,8 +141,17 @@ domain_exception_types = ["DomainError", "ValidationError"]
 
 [decision_queryability]
 inline_ref_patterns = ["ADR-\\d+"]
+
+# Optional: tune bootstrap_signals detection globs / patterns
+[bootstrap_signals]
+ci_workflow_globs = [".github/workflows/*.yml", ".gitlab-ci.yml"]
 ```
 
+**Migrating from v1?** Add `schema_version = 2` at the top and add
+`bootstrap_signals = 0.12` to `[weights]`, then rebalance the other five
+weights so they still sum to 1.0. See [`docs/configuration.md`](docs/configuration.md)
+for the one-line migration recipe.
+
 See [`docs/METHODOLOGY.md`](docs/METHODOLOGY.md) for the full config schema
 and scoring formula.
 
@@ -158,10 +183,19 @@ appear in:
 ## How it works
 
 AgentRepoCoach detects the primary language of the repo, loads a language
-adapter, and runs five component scorers against the adapter's view of
+adapter, and runs six component scorers against the adapter's view of
 the codebase. Each component returns a 0-100 sub-score with a transparent
 breakdown. The weighted sum is the composite CAH score.
 
+The six components are:
+
+- **Navigability** — checks for `AGENTS.md`, codebase map, CLI manifest, and root cleanliness.
+- **Error quality** — scores fix-hint coverage, exception typing, and generic-exception usage.
+- **Decision queryability** — audits ADR catalog completeness and inline ADR cross-references.
+- **Test quality** — checks test naming conventions, helper presence, and fixture duplication.
+- **Module hygiene** — inspects internal visibility ratios, god files, doc coverage, and architecture doc freshness.
+- **Bootstrap signals** — language-agnostic CI-Signal scorer (does the repo have a CI workflow triggered on pull requests?) and README-quality scorer (do the first 100 README lines contain both an install and a test command in fenced code blocks?). Both are configurable via `[bootstrap_signals]` in `.agentrepocoach.toml`.
+
 Every output field is a count, percentage, type name, or file path —
 AgentRepoCoach never emits code snippets or raw message bodies, so reports
 are safe to publish as CI artifacts.

{agentrepocoach-0.3.1 → agentrepocoach-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentrepocoach"
-version = "0.3.1"
+version = "0.4.0"
 description = "Score your codebase on how ready it is for AI agents — and coach you through the fixes."
 readme = "README.md"
 license = { text = "Apache-2.0" }

{agentrepocoach-0.3.1 → agentrepocoach-0.4.0}/src/agentrepocoach/__init__.py

@@ -9,6 +9,6 @@ from __future__ import annotations
 
 from .compute import compute_cah
 
-VERSION = "0.3.1"
+VERSION = "0.4.0"
 
 __all__ = ["compute_cah", "VERSION"]

{agentrepocoach-0.3.1 → agentrepocoach-0.4.0}/src/agentrepocoach/components/__init__.py

@@ -11,7 +11,9 @@ File-to-component mapping:
 - ``decision_queryability.py`` -> ``decision_queryability``
 - ``test_quality.py``        -> ``test_quality``
 - ``module_hygiene.py``      -> ``module_hygiene``
+- ``bootstrap_signals.py``   -> ``bootstrap_signals`` (CI workflow + README quality)
 """
+from .bootstrap_signals import compute_bootstrap_signals
 from .decision_queryability import compute_decision_queryability
 from .documentation import compute_navigability
 from .error_quality import compute_error_quality
@@ -19,6 +21,7 @@ from .module_hygiene import compute_module_hygiene
 from .test_quality import compute_test_quality
 
 __all__ = [
+    "compute_bootstrap_signals",
     "compute_decision_queryability",
     "compute_error_quality",
     "compute_module_hygiene",

agentrepocoach-0.4.0/src/agentrepocoach/components/bootstrap_signals.py

@@ -0,0 +1,204 @@
+"""Bootstrap-signals component — scores the two artifacts an agent needs
+to validate its own work against the repo: a runnable CI workflow on PRs
+(50 pts), and a README that surfaces install + test commands in the
+first 100 lines (50 pts).
+
+Security invariants (AC-06):
+- No shell-out calls (see test_bootstrap_signals_security.py for the grep guard).
+- README reads are capped at _README_BYTE_CAP bytes before line scan.
+- CI workflow scans are limited to _CI_FILES_MAX_SCAN files.
+"""
+from __future__ import annotations
+
+import re
+from pathlib import Path
+from typing import Any
+
+from ..adapters import LanguageAdapter
+from ..config import BootstrapSignalsConfig, Config
+
+_CI_SIGNAL_WEIGHT = 50
+_README_QUALITY_WEIGHT = 50
+
+_README_HEAD_LINES = 100        # line cap for README scoring
+_README_BYTE_CAP = 200_000      # hard byte cap before line scan (DoS guard)
+_CI_FILES_MAX_SCAN = 50         # short-circuit for pathological repos
+
+# Regex patterns for detecting "on: pull_request" in YAML files.
+# Covers three common forms:
+#   on: pull_request
+#   on: [pull_request, push]
+#   on:\n  pull_request:
+_PR_SCALAR_RE = re.compile(r"^on:\s+\[?[^#\n]*pull_request", re.MULTILINE)
+_PR_MAP_BLOCK_RE = re.compile(r"^\s*on:\s*$", re.MULTILINE)
+_PR_MAP_VALUE_RE = re.compile(r"^\s+pull_request\b", re.MULTILINE)
+
+
+def compute_bootstrap_signals(
+    repo_root: Path, config: Config, adapter: LanguageAdapter,
+) -> dict[str, Any]:
+    """Score the bootstrap-signals component.
+
+    Returns a dict with ``{"score": float, "total": 100, "breakdown": {...}}``.
+    The ``adapter`` parameter is accepted for interface consistency and future
+    per-language override hooks; it is currently unused.
+    """
+    ci = _score_ci_signal(repo_root, config)
+    readme = _score_readme_quality(repo_root, config)
+    total = ci["score"] + readme["score"]
+    return {
+        "score": round(total, 2),
+        "total": 100,
+        "breakdown": {"ci_signal": ci, "readme_quality": readme},
+    }
+
+
+def _score_ci_signal(repo_root: Path, config: Config) -> dict[str, Any]:
+    """Score CI-signal sub-component (0–50 pts).
+
+    30 pts: any CI workflow file containing a recognisable test command exists.
+    20 pts: at least one such workflow triggers on pull_request.
+    """
+    bsc = config.bootstrap_signals
+    workflow_files: list[Path] = []
+    for glob_pattern in bsc.ci_workflow_globs:
+        matches = sorted(repo_root.glob(glob_pattern))
+        workflow_files.extend(matches)
+        if len(workflow_files) >= _CI_FILES_MAX_SCAN:
+            workflow_files = workflow_files[:_CI_FILES_MAX_SCAN]
+            break
+
+    if not workflow_files:
+        return {
+            "score": 0,
+            "total": _CI_SIGNAL_WEIGHT,
+            "workflows_found": 0,
+            "pr_trigger": False,
+            "note": "No CI workflow files found.",
+        }
+
+    # 30 pts for having any workflow; 20 pts for a pull_request trigger.
+    has_pr_trigger = any(_file_has_pr_trigger(f, config) for f in workflow_files)
+    score = 30 + (20 if has_pr_trigger else 0)
+
+    return {
+        "score": score,
+        "total": _CI_SIGNAL_WEIGHT,
+        "workflows_found": len(workflow_files),
+        "pr_trigger": has_pr_trigger,
+    }
+
+
+def _file_has_pr_trigger(path: Path, config: Config) -> bool:
+    """Return True if the file triggers on pull_request."""
+    try:
+        byte_size = path.stat().st_size
+        if byte_size > config.thresholds.max_file_bytes:
+            return False
+        text = path.read_text(encoding="utf-8", errors="ignore")
+    except OSError:
+        return False
+
+    # scalar form: on: pull_request  OR  on: [pull_request, push]
+    if _PR_SCALAR_RE.search(text):
+        return True
+
+    # block map form: on:\n  pull_request:
+    for match in _PR_MAP_BLOCK_RE.finditer(text):
+        tail = text[match.end():]
+        first_line = tail.lstrip("\n").split("\n")[0] if tail else ""
+        if _PR_MAP_VALUE_RE.match("\n" + first_line):
+            return True
+
+    return False
+
+
+def _score_readme_quality(repo_root: Path, config: Config) -> dict[str, Any]:
+    """Score README-quality sub-component (0–50 pts).
+
+    25 pts: a fenced code block in the first 100 lines contains an install command.
+    25 pts: a fenced code block in the first 100 lines contains a test command.
+    """
+    bsc = config.bootstrap_signals
+
+    # Try common README filenames in priority order.
+    readme_path: Path | None = None
+    for candidate in ("README.md", "README.rst", "README.txt", "README"):
+        p = repo_root / candidate
+        if p.is_file():
+            readme_path = p
+            break
+
+    if readme_path is None:
+        return {
+            "score": 0,
+            "total": _README_QUALITY_WEIGHT,
+            "install_found": False,
+            "test_found": False,
+            "note": "No README file found.",
+        }
+
+    try:
+        byte_size = readme_path.stat().st_size
+        if byte_size > _README_BYTE_CAP:
+            return {
+                "score": 0,
+                "total": _README_QUALITY_WEIGHT,
+                "install_found": False,
+                "test_found": False,
+                "note": f"README exceeds {_README_BYTE_CAP} byte cap; skipped for DoS safety.",
+            }
+        text = readme_path.read_text(encoding="utf-8", errors="ignore")
+    except OSError:
+        return {
+            "score": 0,
+            "total": _README_QUALITY_WEIGHT,
+            "install_found": False,
+            "test_found": False,
+            "note": "README could not be read.",
+        }
+
+    head_lines = text.splitlines()[: bsc.readme_head_lines]
+    code_blocks = _extract_fenced_code_blocks(head_lines)
+
+    install_found = _any_matches(code_blocks, bsc.install_command_patterns)
+    test_found = _any_matches(code_blocks, bsc.test_command_patterns)
+
+    score = (25 if install_found else 0) + (25 if test_found else 0)
+    return {
+        "score": score,
+        "total": _README_QUALITY_WEIGHT,
+        "install_found": install_found,
+        "test_found": test_found,
+    }
+
+
+def _extract_fenced_code_blocks(lines: list[str]) -> list[str]:
+    """Return a flat list of all lines that appear inside fenced code blocks."""
+    inside = False
+    fence_marker = ""
+    collected: list[str] = []
+
+    for line in lines:
+        stripped = line.strip()
+        if not inside:
+            if stripped.startswith("```") or stripped.startswith("~~~"):
+                inside = True
+                fence_marker = stripped[:3]
+        else:
+            if stripped.startswith(fence_marker) and len(stripped) >= len(fence_marker):
+                inside = False
+                fence_marker = ""
+            else:
+                collected.append(line)
+
+    return collected
+
+
+def _any_matches(lines: list[str], patterns: tuple[str, ...]) -> bool:
+    """Return True if any line contains any of the pattern substrings."""
+    for line in lines:
+        for pattern in patterns:
+            if pattern in line:
+                return True
+    return False

{agentrepocoach-0.3.1 → agentrepocoach-0.4.0}/src/agentrepocoach/compute.py

@@ -6,6 +6,7 @@ from typing import Any
 
 from .adapters import LanguageAdapter, detect_all, detect_primary, get_adapter_by_name
 from .components import (
+    compute_bootstrap_signals,
     compute_decision_queryability,
     compute_error_quality,
     compute_module_hygiene,
@@ -44,6 +45,7 @@ def compute_cah(repo_root: Path, config: Config | None = None, adapter: Language
         "decision_queryability": compute_decision_queryability(repo_root, config, adapter),
         "test_quality": compute_test_quality(repo_root, config, adapter),
         "module_hygiene": compute_module_hygiene(repo_root, config, adapter),
+        "bootstrap_signals": compute_bootstrap_signals(repo_root, config, adapter),
     }
 
     total = 0.0

{agentrepocoach-0.3.1 → agentrepocoach-0.4.0}/src/agentrepocoach/config.py

@@ -9,23 +9,34 @@ or unreadable, defaults are used.
 """
 from __future__ import annotations
 
+import sys
 import tomllib
 from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any
 
+# Module-level guard: emit the soft-upgrade warning at most once per process
+# per schema version encountered.
+_warned_schemas: set[int] = set()
+
 # Schema version — bump on breaking config changes.
-CURRENT_SCHEMA_VERSION = 1
+# v1 → v2: Added 6th component ``bootstrap_signals`` (ARC-005). Existing
+# configs that pin all five weights must add ``bootstrap_signals`` to the
+# [weights] table and set ``schema_version = 2``.
+CURRENT_SCHEMA_VERSION = 2
 
 # Default component weights. Derived from methodology research: navigability
 # and error quality dominate because agents fail fastest on missing entry
-# points and unactionable errors.
+# points and unactionable errors. Rebalanced in v2 to accommodate the new
+# bootstrap_signals component (navigability 0.25→0.22, error_quality 0.25→0.22,
+# decision_queryability 0.20→0.18, test_quality 0.15→0.13, module_hygiene 0.15→0.13).
 DEFAULT_WEIGHTS: dict[str, float] = {
-    "navigability": 0.25,
-    "error_quality": 0.25,
-    "decision_queryability": 0.20,
-    "test_quality": 0.15,
-    "module_hygiene": 0.15,
+    "navigability": 0.22,
+    "error_quality": 0.22,
+    "decision_queryability": 0.18,
+    "test_quality": 0.13,
+    "module_hygiene": 0.13,
+    "bootstrap_signals": 0.12,
 }
 
 DEFAULT_EXCLUDES: tuple[str, ...] = (
@@ -113,6 +124,42 @@ class ModuleHygieneConfig:
     internal_visibility_full_ratio: float = 0.10
 
 
+@dataclass(frozen=True)
+class BootstrapSignalsConfig:
+    """Settings for the bootstrap_signals component."""
+    install_command_patterns: tuple[str, ...] = (
+        "pip install",
+        "uv pip",
+        "npm install",
+        "npm ci",
+        "yarn install",
+        "cargo install",
+        "cargo build",
+        "go install",
+        "go get",
+        "dotnet add",
+        "dotnet restore",
+    )
+    test_command_patterns: tuple[str, ...] = (
+        "pytest",
+        "npm test",
+        "npm run test",
+        "go test",
+        "cargo test",
+        "dotnet test",
+        "make test",
+        "mvn test",
+        "gradle test",
+    )
+    ci_workflow_globs: tuple[str, ...] = (
+        ".github/workflows/*.yml",
+        ".github/workflows/*.yaml",
+        ".gitlab-ci.yml",
+        ".circleci/config.yml",
+    )
+    readme_head_lines: int = 100
+
+
 @dataclass(frozen=True)
 class PathConfig:
     """File and directory paths used by scoring components."""
@@ -139,6 +186,7 @@ class Config:
     error_quality: ErrorQualityConfig = field(default_factory=ErrorQualityConfig)
     test_quality: TestQualityConfig = field(default_factory=TestQualityConfig)
     module_hygiene: ModuleHygieneConfig = field(default_factory=ModuleHygieneConfig)
+    bootstrap_signals: BootstrapSignalsConfig = field(default_factory=BootstrapSignalsConfig)
 
 
 class ConfigError(ValueError):
@@ -168,12 +216,29 @@ def load_config(repo_root: Path, config_path: Path | None = None) -> Config:
 def _build_config_from_dict(raw: dict[str, Any]) -> Config:
     """Merge a parsed TOML dict into a Config with defaults applied."""
     schema_version = int(raw.get("schema_version", CURRENT_SCHEMA_VERSION))
-    if schema_version != CURRENT_SCHEMA_VERSION:
+    if schema_version > CURRENT_SCHEMA_VERSION:
         msg = f"Unsupported schema_version {schema_version}. This tool supports schema_version {CURRENT_SCHEMA_VERSION}."
         raise ConfigError(f"{msg} Try updating agentrepocoach or check the config file format at docs/configuration.md.")
 
+    if schema_version < CURRENT_SCHEMA_VERSION:
+        if schema_version not in _warned_schemas:
+            _warned_schemas.add(schema_version)
+            print(
+                f"agentrepocoach: WARNING: .agentrepocoach.toml uses schema_version {schema_version}; "
+                f"this tool ships schema_version {CURRENT_SCHEMA_VERSION}. Auto-upgrading in-memory; "
+                f"please bump your config and rebalance [weights]. See docs/configuration.md.",
+                file=sys.stderr,
+            )
+
     weights = dict(DEFAULT_WEIGHTS)
     weights.update(raw.get("weights", {}))
+
+    if schema_version < CURRENT_SCHEMA_VERSION:
+        current_sum = sum(weights.values())
+        if abs(current_sum - 1.0) > 0.01:
+            for k in weights:
+                weights[k] = weights[k] / current_sum
+
     _validate_weights(weights)
 
     return Config(
@@ -190,6 +255,7 @@ def _build_config_from_dict(raw: dict[str, Any]) -> Config:
         error_quality=_build_error_quality_config(raw.get("error_quality", {})),
         test_quality=_build_test_quality_config(raw.get("test_quality", {})),
         module_hygiene=_build_module_hygiene_config(raw.get("module_hygiene", {})),
+        bootstrap_signals=_build_bootstrap_signals_config(raw.get("bootstrap_signals", {})),
     )
 
 
@@ -198,11 +264,11 @@ def _validate_weights(weights: dict[str, float]) -> None:
     missing = set(DEFAULT_WEIGHTS) - set(weights)
     if missing:
         msg = f"Missing component weights: {sorted(missing)}."
-        raise ConfigError(f"{msg} Check that [weights] in .agentrepocoach.toml includes all five components. See docs/configuration.md.")
+        raise ConfigError(f"{msg} Check that [weights] in .agentrepocoach.toml includes all six components. See docs/configuration.md.")
     total = sum(weights[name] for name in DEFAULT_WEIGHTS)
     if abs(total - 1.0) > 0.01:
         msg = f"Component weights must sum to 1.0 (got {total:.3f})."
-        raise ConfigError(f"{msg} Check the [weights] section in .agentrepocoach.toml and ensure the five values add up to exactly 1.0.")
+        raise ConfigError(f"{msg} Check the [weights] section in .agentrepocoach.toml and ensure the six values add up to exactly 1.0.")
 
 
 def _build_path_config(raw: dict[str, Any]) -> PathConfig:
@@ -261,3 +327,16 @@ def _build_module_hygiene_config(raw: dict[str, Any]) -> ModuleHygieneConfig:
         architecture_doc_fresh_days=int(raw.get("architecture_doc_fresh_days", 60)),
         internal_visibility_full_ratio=float(raw.get("internal_visibility_full_ratio", 0.10)),
     )
+
+
+def _build_bootstrap_signals_config(raw: dict[str, Any]) -> BootstrapSignalsConfig:
+    install_patterns = raw.get("install_command_patterns")
+    test_patterns = raw.get("test_command_patterns")
+    ci_globs = raw.get("ci_workflow_globs")
+    defaults = BootstrapSignalsConfig()
+    return BootstrapSignalsConfig(
+        install_command_patterns=tuple(install_patterns) if install_patterns is not None else defaults.install_command_patterns,
+        test_command_patterns=tuple(test_patterns) if test_patterns is not None else defaults.test_command_patterns,
+        ci_workflow_globs=tuple(ci_globs) if ci_globs is not None else defaults.ci_workflow_globs,
+        readme_head_lines=int(raw.get("readme_head_lines", defaults.readme_head_lines)),
+    )