agentready 2.45.0__tar.gz → 2.46.0__tar.gz

{agentready-2.45.0/src/agentready.egg-info → agentready-2.46.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentready
-Version: 2.45.0
+Version: 2.46.0
 Summary: Assess and bootstrap git repositories for AI-assisted development with automated remediation
 Author-email: Jeremy Eder <jeder@redhat.com>
 License: MIT

{agentready-2.45.0 → agentready-2.46.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentready"
-version = "2.45.0"
+version = "2.46.0"
 description = "Assess and bootstrap git repositories for AI-assisted development with automated remediation"
 authors = [{name = "Jeremy Eder", email = "jeder@redhat.com"}]
 readme = "README.md"

{agentready-2.45.0 → agentready-2.46.0}/src/agentready/assessors/patterns.py

@@ -290,6 +290,13 @@ class DesignIntentAssessor(BaseAssessor):
                     evidence.append(f"Design intent language found in {filename}")
                     break
 
+        enforcement_pts, enforcement_evidence = self._check_design_enforcement(
+            repository
+        )
+        if enforcement_pts > 0:
+            score += enforcement_pts
+            evidence.extend(enforcement_evidence)
+
         score = min(score, 100.0)
 
         if score >= 50:
@@ -315,6 +322,99 @@ class DesignIntentAssessor(BaseAssessor):
                 error_message=None,
             )
 
+    def _check_design_enforcement(
+        self, repository: Repository
+    ) -> tuple[float, list[str]]:
+        """Check for enforcement of design doc updates alongside code changes.
+
+        Advisory enforcement (10 pts): AGENTS.md/CLAUDE.md rules requiring
+        design doc updates with architectural changes.
+        Deterministic enforcement (15 pts): Hooks or skills that check for
+        design doc updates. Awards the higher of the two, not both.
+        """
+        import json
+
+        doc_ref_pattern = re.compile(
+            r"design\s+doc|docs/design|architecture\s+doc|\.adr|design\s+document",
+            re.IGNORECASE,
+        )
+        enforcement_verb_pattern = re.compile(
+            r"update|review|create|maintain|must|required|ensure|check",
+            re.IGNORECASE,
+        )
+
+        deterministic_score = 0.0
+        deterministic_evidence = []
+
+        settings_path = repository.path / ".claude" / "settings.json"
+        if settings_path.exists():
+            try:
+                settings = json.loads(settings_path.read_text(encoding="utf-8"))
+                hooks = settings.get("hooks", {})
+                hooks_str = json.dumps(hooks).lower()
+                if (
+                    hooks
+                    and doc_ref_pattern.search(hooks_str)
+                    and enforcement_verb_pattern.search(hooks_str)
+                ):
+                    deterministic_score = 15.0
+                    deterministic_evidence.append(
+                        ".claude/settings.json hooks reference design docs (deterministic enforcement)"
+                    )
+            except (json.JSONDecodeError, OSError):
+                pass
+
+        if deterministic_score == 0:
+            skills_dir = repository.path / ".claude" / "skills"
+            if skills_dir.exists() and skills_dir.is_dir():
+                try:
+                    for skill_dir in skills_dir.iterdir():
+                        if not skill_dir.is_dir():
+                            continue
+                        skill_md = skill_dir / "SKILL.md"
+                        if not skill_md.exists():
+                            continue
+                        try:
+                            content = skill_md.read_text(encoding="utf-8")
+                            if doc_ref_pattern.search(
+                                content
+                            ) and enforcement_verb_pattern.search(content):
+                                deterministic_score = 15.0
+                                deterministic_evidence.append(
+                                    f".claude/skills/{skill_dir.name}/ references design doc enforcement (deterministic)"
+                                )
+                                break
+                        except (OSError, UnicodeDecodeError):
+                            continue
+                except OSError:
+                    pass
+
+        if deterministic_score > 0:
+            return deterministic_score, deterministic_evidence
+
+        advisory_score = 0.0
+        advisory_evidence = []
+        context_files = ["AGENTS.md", "CLAUDE.md", ".claude/CLAUDE.md"]
+        for filename in context_files:
+            filepath = repository.path / filename
+            if not filepath.exists():
+                continue
+            try:
+                content = filepath.read_text(encoding="utf-8")
+            except (OSError, UnicodeDecodeError):
+                continue
+
+            if doc_ref_pattern.search(content) and enforcement_verb_pattern.search(
+                content
+            ):
+                advisory_score = 10.0
+                advisory_evidence.append(
+                    f"{filename} contains design doc update rules (advisory enforcement)"
+                )
+                break
+
+        return advisory_score, advisory_evidence
+
     def _create_remediation(self) -> Remediation:
         return Remediation(
             summary="Document design intent: preconditions, invariants, and rationale",
@@ -323,11 +423,14 @@ class DesignIntentAssessor(BaseAssessor):
                 "For each critical module, document preconditions, invariants, and rationale",
                 "Use an AI agent to reverse-engineer initial design docs from code, then enrich with intent",
                 "Reference design docs from CLAUDE.md/AGENTS.md",
+                "Add a rule to AGENTS.md requiring design doc updates with architectural changes",
+                "For stronger enforcement, add a hook or skill that checks for design doc updates",
             ],
             tools=[],
             commands=["mkdir -p docs/design"],
             examples=[
                 "# docs/design/event-system.md\n## Invariants\n- Event log is append-only; never mutate or delete entries\n- Events are processed exactly-once via idempotency keys\n\n## Preconditions\n- Auth middleware must validate token before event handlers run\n\n## Rationale\n- Polling instead of webhooks: upstream API has 5s delivery SLA, too slow for our use case",
+                "# AGENTS.md - Advisory enforcement\n## Design Documentation\nWhen modifying component boundaries, data flows, or API contracts,\nreview and update the corresponding design doc in docs/design/.",
             ],
             citations=[
                 Citation(
@@ -336,6 +439,12 @@ class DesignIntentAssessor(BaseAssessor):
                     url="",
                     relevance="Agents cannot infer design intent from code alone",
                 ),
+                Citation(
+                    source="Red Hat",
+                    title="Repository Scaffolding for AI Coding Agents, Section 2.3 Practice C",
+                    url="",
+                    relevance="Enforce design doc updates as part of architectural changes",
+                ),
             ],
         )
 

{agentready-2.45.0 → agentready-2.46.0}/src/agentready/assessors/testing.py

@@ -791,18 +791,22 @@ class DeterministicEnforcementAssessor(BaseAssessor):
         score = 0.0
 
         if precommit_config.exists():
-            score += 60.0
-            evidence.append(".pre-commit-config.yaml found (pre-commit hooks)")
+            score += 40.0
+            evidence.append(".pre-commit-config.yaml found (git hooks, bypassable)")
 
         if claude_settings.exists():
             try:
                 import json
 
                 content = json.loads(claude_settings.read_text())
-                if "hooks" in content:
-                    score += 30.0
+                hooks = content.get("hooks")
+                has_configured_hooks = isinstance(hooks, dict) and any(
+                    isinstance(entries, list) and entries for entries in hooks.values()
+                )
+                if has_configured_hooks:
+                    score += 60.0
                     evidence.append(
-                        ".claude/settings.json has hooks configured (agent hooks)"
+                        ".claude/settings.json has hooks configured (deterministic agent hooks)"
                     )
                 else:
                     score += 10.0
@@ -840,16 +844,18 @@ class DeterministicEnforcementAssessor(BaseAssessor):
                 hook_scripts = []
                 evidence.append(".husky directory exists but could not be read")
             if hook_scripts:
-                score += 60.0
+                score += 40.0
                 hooks_list = ", ".join(sorted(hook_scripts))
-                evidence.append(f".husky directory found with hooks: {hooks_list}")
+                evidence.append(
+                    f".husky directory found with hooks: {hooks_list} (git hooks, bypassable)"
+                )
             else:
                 score += 10.0
                 evidence.append(".husky directory found but no hook scripts")
 
         score = min(score, 100.0)
 
-        if score >= 60:
+        if score >= 40:
             return Finding(
                 attribute=self.attribute,
                 status="pass",
@@ -888,9 +894,9 @@ class DeterministicEnforcementAssessor(BaseAssessor):
         return Remediation(
             summary="Set up deterministic enforcement with hooks and lint rules",
             steps=[
+                "Configure .claude/settings.json with agent hooks (deterministic, cannot be bypassed)",
                 "Start with 2 hooks: auto-format on edit + block destructive operations",
-                "Install pre-commit (Python) or Husky (Node.js) for git hooks",
-                "Configure .claude/settings.json with agent hooks for team-wide sharing",
+                "Optionally add pre-commit (Python) or Husky (Node.js) for git hooks",
                 "Add lint rules for import restrictions and architectural boundaries",
             ],
             tools=["pre-commit", "husky"],
@@ -906,7 +912,12 @@ class DeterministicEnforcementAssessor(BaseAssessor):
     "PostToolUse": [
       {
         "matcher": "Edit|Write",
-        "command": "npx prettier --write $CLAUDE_FILE_PATH 2>/dev/null || true"
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx prettier --write $CLAUDE_FILE_PATH 2>/dev/null || true"
+          }
+        ]
       }
     ]
   }

{agentready-2.45.0 → agentready-2.46.0/src/agentready.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentready
-Version: 2.45.0
+Version: 2.46.0
 Summary: Assess and bootstrap git repositories for AI-assisted development with automated remediation
 Author-email: Jeremy Eder <jeder@redhat.com>
 License: MIT