agent-sdlc 0.2.0__tar.gz → 0.3.0__tar.gz

{agent_sdlc-0.2.0/agent_sdlc.egg-info → agent_sdlc-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-sdlc
-Version: 0.2.0
+Version: 0.3.0
 Summary: Diff-scoped mutation gate for pre-commit and agent Stop hooks
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/PavelGuzenfeld/agent-sdlc
@@ -81,6 +81,21 @@ cd agent-sdlc
 - `ast-grep-cli` adds an `sg` shim that can shadow the system `sg`; call
   `ast-grep`.
 
+## Use it
+
+In Claude Code (Codex: `$name` instead of `/name`):
+
+1. `./install.sh --target claude --deps`
+2. In your repo: `touch .mutation-gate.toml && mutation-gate rules sync`
+3. `claude`, then `/grill <idea>` or `gh issue create …`
+4. Approve the ticket: `gh issue edit 42 --add-label model:sonnet`
+5. `/kata 42`: a worker writes the failing test, implements, gates, opens the PR
+6. Review, then type `LGTM`: it squash-merges and cleans up
+7. `/done` to close out the session
+
+Full walkthrough, and what differs in Codex:
+<https://pavelguzenfeld.com/agent-sdlc/usage/>
+
 ## What's inside
 
 | Path | What |

{agent_sdlc-0.2.0 → agent_sdlc-0.3.0}/README.md

@@ -66,6 +66,21 @@ cd agent-sdlc
 - `ast-grep-cli` adds an `sg` shim that can shadow the system `sg`; call
   `ast-grep`.
 
+## Use it
+
+In Claude Code (Codex: `$name` instead of `/name`):
+
+1. `./install.sh --target claude --deps`
+2. In your repo: `touch .mutation-gate.toml && mutation-gate rules sync`
+3. `claude`, then `/grill <idea>` or `gh issue create …`
+4. Approve the ticket: `gh issue edit 42 --add-label model:sonnet`
+5. `/kata 42`: a worker writes the failing test, implements, gates, opens the PR
+6. Review, then type `LGTM`: it squash-merges and cleans up
+7. `/done` to close out the session
+
+Full walkthrough, and what differs in Codex:
+<https://pavelguzenfeld.com/agent-sdlc/usage/>
+
 ## What's inside
 
 | Path | What |

{agent_sdlc-0.2.0 → agent_sdlc-0.3.0/agent_sdlc.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-sdlc
-Version: 0.2.0
+Version: 0.3.0
 Summary: Diff-scoped mutation gate for pre-commit and agent Stop hooks
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/PavelGuzenfeld/agent-sdlc
@@ -81,6 +81,21 @@ cd agent-sdlc
 - `ast-grep-cli` adds an `sg` shim that can shadow the system `sg`; call
   `ast-grep`.
 
+## Use it
+
+In Claude Code (Codex: `$name` instead of `/name`):
+
+1. `./install.sh --target claude --deps`
+2. In your repo: `touch .mutation-gate.toml && mutation-gate rules sync`
+3. `claude`, then `/grill <idea>` or `gh issue create …`
+4. Approve the ticket: `gh issue edit 42 --add-label model:sonnet`
+5. `/kata 42`: a worker writes the failing test, implements, gates, opens the PR
+6. Review, then type `LGTM`: it squash-merges and cleans up
+7. `/done` to close out the session
+
+Full walkthrough, and what differs in Codex:
+<https://pavelguzenfeld.com/agent-sdlc/usage/>
+
 ## What's inside
 
 | Path | What |

{agent_sdlc-0.2.0 → agent_sdlc-0.3.0}/mutation_gate/__init__.py

@@ -1,3 +1,3 @@
 """Diff-scoped mutation gate. Spec: PavelGuzenfeld/dotfiles#9."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{agent_sdlc-0.2.0 → agent_sdlc-0.3.0}/mutation_gate/cli.py

@@ -121,7 +121,7 @@ def _gate_file(
     all_tests = [str(p.relative_to(repo.root)) for p in cands]
 
     baseline = runner.baseline_green(repo, all_tests, lang_cfg.test_command)
-    configured = repo.config.mutant_timeout
+    configured = repo.config.mutant_timeout_for(rel)
     timeout = configured if configured else max(30.0, baseline * TIMEOUT_FACTOR)
     source = "configured" if configured else "from baseline"
     _emit(f"  {rel}: baseline {baseline:.1f}s, per-mutant timeout {timeout:.0f}s ({source})")

{agent_sdlc-0.2.0 → agent_sdlc-0.3.0}/mutation_gate/mutants.py

@@ -405,6 +405,17 @@ def _literal_mutants(
     return out
 
 
+MAIN_MODULE_LITERALS = frozenset({'"__main__"', "'__main__'"})
+
+
+def _is_main_guard(hit: dict) -> bool:
+    """Flipped, the guard runs the script at import with the test runner's argv
+    (#315); a subprocess test covers the entry point instead."""
+    operands = hit.get("metaVariables", {}).get("single", {})
+    texts = {operands.get(name, {}).get("text") for name in ("A", "B")}
+    return "__name__" in texts and bool(texts & MAIN_MODULE_LITERALS)
+
+
 def _gdscript_config(root: Path) -> Path | None:
     from . import vocabulary_check
     return vocabulary_check._gdscript_ready(root)
@@ -437,6 +448,8 @@ def generate(root: Path, files: dict[str, set[int]], language: str) -> list[Muta
                 # BEFORE `seen`, or the identity shadows the real `not in => in` mutant.
                 if hit["replacement"] == hit["text"]:
                     continue
+                if _is_main_guard(hit):
+                    continue
                 if lineno not in lines or span in seen:
                     continue
                 seen.add(span)

{agent_sdlc-0.2.0 → agent_sdlc-0.3.0}/mutation_gate/repo.py

@@ -159,6 +159,12 @@ class Golden:
     artifact: str
 
 
+@dataclass(frozen=True)
+class PathTimeout:
+    path: str
+    mutant_timeout: float
+
+
 @dataclass
 class Config:
     enabled: bool = True
@@ -197,6 +203,7 @@ class Config:
     # baseline, which is right only where a mutant costs what the baseline cost;
     # where a build sits between the edit and the tests it does not (#78).
     mutant_timeout: float | None = None
+    timeout: list[PathTimeout] = field(default_factory=list)
     # Import hops from a test to the mutated file. 1 = direct import; raising it
     # selects nearly the whole suite once a common module sits in the path.
     closure_depth: int = 1
@@ -237,9 +244,10 @@ class Config:
         model_exclude = _load_model_exclude(raw.pop("model_exclude", []))
         golden = _load_golden(raw.pop("golden", []))
         doc_allow = _load_doc_allow(raw.pop("doc_allow", []))
+        timeout = _load_timeout(raw.pop("timeout", []))
         # Named, not silently dropped: a key that does nothing is how a repo
         # believes it is scoping the gate while the gate ignores it.
-        nested = {"languages", "model_exclude", "golden", "doc_allow"}
+        nested = {"languages", "model_exclude", "golden", "doc_allow", "timeout"}
         unknown = sorted(set(raw) - {f.name for f in fields(cls) if f.name not in nested})
         if unknown:
             raise GateError(
@@ -247,7 +255,7 @@ class Config:
                 "nothing reads them. Scope the gate with exclude_paths."
             )
         cfg = cls(**raw, languages=languages, model_exclude=model_exclude, golden=golden,
-                  doc_allow=doc_allow)
+                  doc_allow=doc_allow, timeout=timeout)
         if cfg.model_paths and not cfg.model_spec.startswith("issue:"):
             raise GateError(
                 f'{CONFIG_NAME}: model_spec must be "issue:N" naming a pinned issue once '
@@ -255,6 +263,12 @@ class Config:
             )
         return cfg
 
+    def mutant_timeout_for(self, rel: str) -> float | None:
+        matching = [t for t in self.timeout if rel.startswith(t.path)]
+        if not matching:
+            return self.mutant_timeout
+        return max(matching, key=lambda t: len(t.path)).mutant_timeout
+
     def test_prefixes(self) -> set[str]:
         paths = set(self.test_paths)
         for lang_cfg in self.languages.values():
@@ -308,6 +322,20 @@ def _load_golden(raw: list) -> list[Golden]:
     return out
 
 
+def _load_timeout(raw: list) -> list[PathTimeout]:
+    out: list[PathTimeout] = []
+    for entry in raw:
+        cap = entry.get("mutant_timeout")
+        if (set(entry) != {"path", "mutant_timeout"} or isinstance(cap, bool)
+                or not isinstance(cap, (int, float)) or cap <= 0):
+            raise GateError(
+                f"{CONFIG_NAME}: every [[timeout]] needs exactly `path` and a positive "
+                "`mutant_timeout` in seconds"
+            )
+        out.append(PathTimeout(path=entry["path"], mutant_timeout=float(cap)))
+    return out
+
+
 def _load_languages(raw: dict) -> dict[str, LanguageConfig]:
     known = {f.name for f in fields(LanguageConfig)}
     languages: dict[str, LanguageConfig] = {}

{agent_sdlc-0.2.0 → agent_sdlc-0.3.0}/rules/tickets.md

@@ -25,6 +25,11 @@ repo defaults to squash-only merges with delete-branch-on-merge.
 The one carve-out: a batch of confirmed `size:tiny` follow-ups may share one
 worker, one branch and one PR, with a `Closes #N` line per ticket.
 
+Every ticket and its PR name one responsible person as assignee. Triage
+sets it alongside the `model:*` label — the label approves, the assignee
+names who works it. An agent works only tickets assigned to the `gh` user
+it runs as, `@me`, and its PR carries that same assignee.
+
 ## Follow-ups
 
 A follow-up starts from `/done`, a kata worker, any agent mid-task, or the
@@ -39,8 +44,9 @@ form's label.
 The filer proposes `size:tiny` when the ticket is tiny: its evidence names
 one location, it leaves no design choice open, and it needs no new file,
 dependency or config key. The maintainer confirms the proposal by adding its
-model label. A follow-up is never born with a `model:<name>` label, and a
-label-creation step must never add one to an untriaged follow-up.
+model label. A follow-up is never born with a `model:<name>` label or an
+assignee — triage sets both — and a label-creation step must never add the
+label to an untriaged follow-up.
 
 Labels are created if missing; if creation is refused, file without them
 rather than drop the item.