specfuse-loop 0.18.0__tar.gz → 0.19.0__tar.gz

{specfuse_loop-0.18.0/specfuse_loop.egg-info → specfuse_loop-0.19.0}/PKG-INFO

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

{specfuse_loop-0.18.0 → specfuse_loop-0.19.0}/pyproject.toml

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

specfuse_loop-0.19.0/specfuse/loop/data/VERSION

@@ -0,0 +1 @@
+0.19.0

{specfuse_loop-0.18.0 → specfuse_loop-0.19.0}/specfuse/loop/data/docs/methodology.md

@@ -407,6 +407,28 @@ consumer that queries only those concludes the record is empty when it is not.
 A cross-repo audit reported three separate "missing diagnostic" findings that
 were all query errors against this contract, none of which existed (#270).
 
+**Retain-and-repair (FEAT-2026-0103).** `files_changed_mismatch`,
+`produces_not_in_diff`, `deliverable_missing`, and `no_deliverable_files` —
+the guard-refusal outcomes — record `tree_retained: true` in `extras` by
+default: the driver uncommits the squash but leaves the working tree exactly
+as the refused attempt left it, so the next attempt repairs in place instead
+of re-authoring from scratch. Controlled by `defaults.retain_on_guard_refusal`
+in `verification.yml` (default `true`; set `false` to restore the pre-0.18
+discard-and-restart behaviour) — see `specfuse/loop/data/verification.yml.example`
+for the four covered outcomes and the exact default. A `passed` outcome may
+separately carry `auto_repaired_files_changed` in `extras`: the list of
+declared-but-unchanged `files_changed` paths the driver dropped on the
+WU's behalf rather than failing the attempt over.
+
+Retention interacts with spinning detection, not around it:
+`detect_deterministic_refusal_repeat` (#1415) escalates a WU to
+`blocked_human` when two consecutive attempts emit an identical refusal
+summary over an identical touched-paths set. A retained tree that the repair
+attempt leaves untouched reproduces exactly that signature on its next
+refusal, so a session that ignores the retained-tree brief still escalates
+after two refusals rather than grinding to the attempt ceiling — retention
+does not weaken the spinning guard, it feeds it a cleaner signal.
+
 Consumers that read `attempt_outcome` events (the auto-close
 predicate, `/gate-status`, the spinning-detector hook, close-ceremony
 cost analysis) treat the `outcome` and `failure_class` values as an

{specfuse_loop-0.18.0 → specfuse_loop-0.19.0}/specfuse/loop/data/verification.yml.example

@@ -68,6 +68,60 @@
 # `narrow_command` — see `tests` below — to run a cheaper command per attempt
 # while `command` still runs whole in the broad run; that is orthogonal to
 # `tier` and most gates need only one or the other, not both.
+#
+# PER-GATE `narrow_selection` (optional, FEAT-2026-0110). Controls how a
+# dispatched unit's own `produces:` entries are turned into the
+# `{selected_test_modules}` a `narrow_command` substitutes — for repos whose
+# tests are not Python modules under `tests/`. Four keys, each independently
+# defaulted (an absent `narrow_selection` block, or an absent key within one
+# that IS declared, resolves to the value shown):
+#   test_roots: ["tests/"]     # produces: entries under one of these roots
+#                               # are what gets selected; entries elsewhere are
+#                               # ignored by this gate's narrow tier.
+#   format: python_module      # how a selected path is turned into an item:
+#                               #   python_module — dotted module name
+#                               #     (src/foo/bar.py -> src.foo.bar)
+#                               #   class_name — bare file stem
+#                               #     (FooTest.java -> FooTest)
+#                               #   path — the path itself, unchanged
+#                               # An unrecognized format is a CONFIGURATION
+#                               # ERROR, never a silent fallback.
+#   item_template: "{module}"  # each rendered item is substituted into this
+#                               # template before joining; default is verbatim.
+#   separator: " "              # how rendered items are joined before
+#                               # replacing {selected_test_modules}.
+# An empty selection (no produces: entry under any test_root) falls back to
+# the gate's full `command` — fail safe, never open.
+#
+# Example for a Maven repo (#3281), where tests are JUnit classes under
+# src/test/java rather than tests/, selected by class name, space-separated
+# for `-Dtest=`:
+#   - name: tests
+#     command: "mvn -q test"
+#     narrow_command: "mvn -q test -Dtest={selected_test_modules}"
+#     narrow_selection:
+#       test_roots: ["src/test/java/"]
+#       format: class_name
+#       separator: ","
+
+# TOP-LEVEL `defaults:` block (optional). Project-wide fallbacks a work unit's
+# own frontmatter can override.
+#   max_attempts: 3            # attempt ceiling when a WU declares none of
+#                               # its own; the constant MAX_ATTEMPTS is the
+#                               # fallback when this key is also absent.
+#   retain_on_guard_refusal: true  # whether a bookkeeping-guard refusal keeps
+#                               # the working tree instead of uncommitting it
+#                               # back to a blank slate. Covers four outcomes:
+#                               # `deliverable_missing`, `no_deliverable_files`,
+#                               # `produces_not_in_diff`, `files_changed_mismatch`
+#                               # (FEAT-2026-0103). Defaults to true: the next
+#                               # attempt repairs the retained tree in place
+#                               # instead of re-authoring from scratch. Set to
+#                               # false to restore the pre-0.18 discard behaviour.
+# defaults:
+#   max_attempts: 3
+#   retain_on_guard_refusal: true
+
 code:
   - name: tests
     # Run the suite UNDER `coverage run` so the `coverage` gate below can reuse