@luizsantiago/spec-guardrails 4.5.0 → 4.5.1

package/README.md

@@ -144,7 +144,7 @@ Automatic checks at step boundaries — each one blocks a specific kind of short
 | `quality-checks` | Configured project commands (`npm test`, …) fail during `/verify` |
 | `lessons` | A failed verify tries to skip the lesson step |
 
-→ [Gates](docs/guide/gates.md) · [Garantees matrix](docs/guide/Guarantees-matrix.md)
+→ [Gates](docs/guide/gates.md) · [Guarantees matrix](docs/guide/Guarantees-matrix.md)
 
 ### Requirements analysis
 
@@ -235,6 +235,7 @@ Spec Guardrails adapts patterns from open-source work. These are the projects wh
 | [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) | MIT | Design-discussion patterns and definition-of-done framing |
 | [graph-engineering](https://github.com/codejunkie99/graph-engineering) | MIT | Task-graph rules behind safe parallel waves |
 | [loop-engineering](https://github.com/cobusgreyling/loop-engineering) | MIT | Wave-based execution model |
+| [loopgate_harness](https://github.com/rxdt/loopgate_harness) | MIT | Suppression-bypass blocking, project-configured quality commands as verify evidence, honest-limits and theme-aware diagram presentation |
 
 Everything else — the CLI, the Python checks, the platform adapters, and the requirements-analysis phase — is original work in this repository. Full lineage, including references we cite but do not bundle: [Credits and lineage](docs/guide/credits.md).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luizsantiago/spec-guardrails",
-  "version": "4.5.0",
+  "version": "4.5.1",
   "description": "Governed spec-driven development for AI coding agents. Your agent writes the spec, gets your approval, builds in small waves, and proves the result — plans and project memory stored as files in your repo.",
   "type": "module",
   "bin": {

package/scripts/check_commit.py

@@ -59,11 +59,14 @@ def read_staged_diff(cwd: Path) -> str:
         cwd=cwd,
         capture_output=True,
         text=True,
+        # Paths can carry bytes the platform locale cannot decode.
+        encoding="utf-8",
+        errors="replace",
         check=False,
     )
     if result.returncode not in (0, 1):
-        raise RuntimeError(result.stderr.strip() or "git diff --cached --numstat failed")
-    return result.stdout
+        raise RuntimeError((result.stderr or "").strip() or "git diff --cached --numstat failed")
+    return result.stdout or ""
 
 
 def count_staged_lines(numstat_text: str) -> int:

package/scripts/check_suppressions.py

@@ -33,11 +33,14 @@ def read_staged_diff(cwd: Path) -> str:
         cwd=cwd,
         capture_output=True,
         text=True,
+        # Diffs can carry bytes the platform locale cannot decode (SVG, em dashes).
+        encoding="utf-8",
+        errors="replace",
         check=False,
     )
     if result.returncode not in (0, 1):
-        raise RuntimeError(result.stderr.strip() or "git diff --cached failed")
-    return result.stdout
+        raise RuntimeError((result.stderr or "").strip() or "git diff --cached failed")
+    return result.stdout or ""
 
 
 def added_lines(diff_text: str) -> list[tuple[str, str]]:

package/scripts/run_quality_checks.py

@@ -38,6 +38,9 @@ def run_command(command: str, cwd: Path) -> dict:
         shell=True,
         capture_output=True,
         text=True,
+        # Test runners emit symbols the platform locale cannot always decode.
+        encoding="utf-8",
+        errors="replace",
         check=False,
     )
     output = (completed.stdout or "") + (completed.stderr or "")

package/skills/agent-architecture.md

@@ -60,6 +60,8 @@ Structural gates run **before** owner review, so they cannot drift when the mode
 | Rebuild / embed memory index | `npx @luizsantiago/spec-guardrails memory-index rebuild` · `memory-index embed` |
 | On gate retry (Execute playbook) | `npx @luizsantiago/spec-guardrails execution-policy record-retry Tn` |
 | On each commit | `python3 .specs/guardrails/scripts/check_commit.py --message "<message>"` |
+| Before each commit (staged diff) | `python3 .specs/guardrails/scripts/check_suppressions.py` |
+| During Verify, when `quality.checks` is configured | `python3 .specs/guardrails/scripts/run_quality_checks.py` |
 | Before declaring a feature done | `python3 .specs/guardrails/scripts/validate_state.py [feature]` |
 | Traceability (Medium+ features) | `python3 .specs/guardrails/scripts/validate_traceability.py [feature]` |
 | Quick mode evidence | `python3 .specs/guardrails/scripts/validate_quick.py [feature]` |
@@ -82,15 +84,15 @@ EXPLORE (optional) → ELICIT (optional) → SPECIFY → DISCUSS (conditional)
 | Phase | Required | Reference | Sister skill | Gate |
 | --- | --- | --- | --- | --- |
 | **Explore** | Optional | `references/explore.md` | — | — |
-| **Elicit** | Optional | `references/elicitation.md` | `validate-req-analysis` | — (before `/specify`; suggest-only entry) |
+| **Elicit** | Optional | `references/elicitation.md` | — | `validate_req_analysis.py` (before `/specify`; suggest-only entry) |
 | **Constitution** | Once per project | `references/constitution.md` | — | — |
 | **Specify** | Yes | `references/specify.md` | — | `validate_spec.py` |
 | **Discuss** | Conditional | `references/discuss.md` | — | — |
 | **Design** | No | `references/design.md` | — | — |
 | **Tasks** | No | `references/tasks.md` | `task-graph-engineering.md` | `validate_tasks.py` |
 | **Analyze** | Before task approval | `references/analyze.md` | — | `analyze_artifacts.py` |
-| **Execute** | Yes | `references/implement.md` | `engineering-standards.md` | `check_commit.py` |
-| **Verify** | Yes | `references/validate.md` | `security-review.md` | `validate_state.py` |
+| **Execute** | Yes | `references/implement.md` | `engineering-standards.md` | `check_commit.py`, `check_suppressions.py` |
+| **Verify** | Yes | `references/validate.md` | `security-review.md` | `validate_state.py`, `run_quality_checks.py` |
 | **Archive** | After Verify PASS | `references/archive.md` | `git-handoff.md` | `archive-feature` |
 | **Converge** | On drift | `references/converge.md` | — | `analyze_artifacts.py` |
 | **Handoff** | Yes | `references/memory.md` | `git-handoff.md` | — |