specfuse-loop 0.3.19__tar.gz → 0.3.21__tar.gz

{specfuse_loop-0.3.19/specfuse_loop.egg-info → specfuse_loop-0.3.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfuse-loop
-Version: 0.3.19
+Version: 0.3.21
 Summary: Local-first executor for the Specfuse Plan + Work Unit gate-cycle methodology.
 Author: Specfuse contributors
 License: Apache-2.0

{specfuse_loop-0.3.19 → specfuse_loop-0.3.21}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specfuse-loop"
-version = "0.3.19"
+version = "0.3.21"
 description = "Local-first executor for the Specfuse Plan + Work Unit gate-cycle methodology."
 readme = "README.md"
 requires-python = ">=3.10"

specfuse_loop-0.3.21/specfuse/loop/data/VERSION

@@ -0,0 +1 @@
+0.3.21

{specfuse_loop-0.3.19 → specfuse_loop-0.3.21}/specfuse/loop/data/docs/methodology.md

@@ -139,7 +139,13 @@ auto-close only eliminates the reflective overhead, not the forward-design step.
 full close ceremony regardless of predicate outcome. Alternatively, set
 `auto_close_disabled: true` in a feature's `PLAN.md` frontmatter to disable
 auto-close permanently for that feature (e.g., for features that are inherently
-exploratory and expect off-plan behavior).
+exploratory and expect off-plan behavior). For a single **substantive close**
+— a `close` (or `close-intermediate`) WU whose acceptance criteria assert on the
+source tree, reconcile prior gates, or observe runtime behaviour rather than
+just writing the retrospective stub — set `auto_close_disabled: true` in **that
+WU's** frontmatter. The predicate keys on the implementation WUs' cost and
+plan-conformance and cannot see what a close verifies, so a substantive close
+must be marked must-run or its verification is silently skipped (#189).
 
 **Predicate-version transparency** — every `auto_close_decision` event in
 `events.jsonl` carries a `predicate_version` field (e.g., `predicate_version:

{specfuse_loop-0.3.19 → specfuse_loop-0.3.21}/specfuse/loop/lint_plan.py

@@ -248,12 +248,23 @@ def _find_task_graph_block(body: str) -> dict | None:
     return None
 
 
+# Ceremony WU types systematically under-estimated in the field: close and
+# plan-next WUs ran 2.8-5.2x over on $2-3 estimates across FEAT-2026-0049
+# (clabonte/generator), poisoning every calibration built on the plans (#201).
+# The floor is a WARN threshold, not a cap — estimates below it are almost
+# certainly wishful, not cheap.
+CEREMONY_COST_FLOOR_USD = 5.0
+_CEREMONY_TYPES = frozenset({"close", "close-intermediate", "plan-next"})
+
+
 def check_planned_cost(feature_dir: Path, plan_fm: dict, gates: list) -> None:
     """Emit WARN for missing planned_cost_usd on WUs and PLAN.md.
 
     Sealed WUs (wu status=done AND plan status=done) are skipped silently —
     backfilling cost estimates on history is pointless.  Active or draft WUs
-    get the WARN.  PLAN.md is compared against the sum of WU planned costs;
+    get the WARN.  Ceremony-type WUs (close/close-intermediate/plan-next)
+    with a planned cost below CEREMONY_COST_FLOOR_USD get a floor WARN
+    (#201).  PLAN.md is compared against the sum of WU planned costs;
     delta > 10% emits a separate WARN naming the delta.  Never raises or
     appends to an errors list — all findings are WARN-only (exit code 0).
     """
@@ -283,6 +294,21 @@ def check_planned_cost(feature_dir: Path, plan_fm: dict, gates: list) -> None:
                 )
             if planned is not None:
                 wu_sum += float(planned)
+                # Floor applies to POSITIVE estimates only: the observed
+                # failure is a real-but-wishful $2-3 estimate anchoring
+                # calibration, not an explicit 0.00 (the scaffold's
+                # "unestimated" placeholder, already visible as such).
+                if (not is_sealed
+                        and wfm.get("type") in _CEREMONY_TYPES
+                        and 0 < float(planned) < CEREMONY_COST_FLOOR_USD):
+                    print(
+                        f"WARN: {wfile}: planned_cost_usd "
+                        f"${float(planned):.2f} is below the "
+                        f"${CEREMONY_COST_FLOOR_USD:.2f} floor for "
+                        f"'{wfm.get('type')}' WUs. Ceremony WUs ran 2.8-5.2x "
+                        f"over on $2-3 estimates (FEAT-2026-0049); raise the "
+                        f"estimate rather than anchoring calibration on it."
+                    )
 
     wu_sum = round(wu_sum, 2)