specfuse-loop 0.3.1__tar.gz → 0.3.2__tar.gz

{specfuse_loop-0.3.1/specfuse_loop.egg-info → specfuse_loop-0.3.2}/PKG-INFO

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

{specfuse_loop-0.3.1 → specfuse_loop-0.3.2}/pyproject.toml

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

specfuse_loop-0.3.2/specfuse/loop/data/VERSION

@@ -0,0 +1 @@
+0.3.2

{specfuse_loop-0.3.1 → specfuse_loop-0.3.2}/specfuse/loop/data/templates/GATE.template.md

@@ -14,12 +14,6 @@ status: open        # open | awaiting_review | passed
 # set it in the successor gate to exercise the brake for the first time.
 ---
 
-<!--
-Copyright 2026 Specfuse Contributors
-Licensed under the Apache License, Version 2.0. See LICENSE.
--->
-
-
 # Gate 1 — <name of the milestone this gate proves>
 
 ## Definition of done

{specfuse_loop-0.3.1 → specfuse_loop-0.3.2}/specfuse/loop/data/templates/PLAN.template.md

@@ -11,12 +11,6 @@ status: active                  # active | done | abandoned
 # planned_cost_usd: 0.00        # OPTIONAL — sum of WU planned costs; lint warns when missing or when delta from WU sum > 10%
 ---
 
-<!--
-Copyright 2026 Specfuse Contributors
-Licensed under the Apache License, Version 2.0. See LICENSE.
--->
-
-
 # Plan: <short feature title>
 
 <One or two paragraphs of human-facing intent. The work units carry the executable

{specfuse_loop-0.3.1 → specfuse_loop-0.3.2}/specfuse/loop/data/templates/WU.template.md

@@ -10,12 +10,6 @@ generated_surfaces: []     # OPTIONAL — paths to generated files this unit's a
 # oracle_env: macos_local  # OPTIONAL — environment where this WU's verifying oracle runs; see frontmatter notes
 ---
 
-<!--
-Copyright 2026 Specfuse Contributors
-Licensed under the Apache License, Version 2.0. See LICENSE.
--->
-
-
 <!--
 Frontmatter notes (single-repo):
 
@@ -48,6 +42,9 @@ DRIVER-OWNED FIELDS — the driver writes these at outcome time; authors leave t
 <!-- driver-owned: attempts, cost_usd, input_tokens, output_tokens, duration_seconds,
      cumulative_cost_usd, cumulative_duration_seconds, cumulative_input_tokens,
      cumulative_output_tokens, re_arm_count, re_arm_history -->
+<!-- driver-stamped at dispatch (resolved execution metadata, visible in this .md):
+     model, effort (override or type default), gate_set (the verification.yml set
+     that is this WU's exit oracle), driver_version, started_at (UTC ISO). -->
 <!-- Full field semantics in docs/methodology.md §2 and events.jsonl outcome payloads. -->
 
 Dependencies live in PLAN.md's `gates[].work_units[].depends_on` graph, not

{specfuse_loop-0.3.1 → specfuse_loop-0.3.2}/specfuse/loop/loop.py

@@ -62,7 +62,7 @@ SPECFUSE_DIR = Path(".specfuse")
 REPO_ROOT = SPECFUSE_DIR.parent
 FEATURES_DIR = SPECFUSE_DIR / "features"
 VERIFICATION_PATH = SPECFUSE_DIR / "verification.yml"
-DRIVER_VERSION = "0.3.1"
+DRIVER_VERSION = "0.3.2"
 # Oldest scaffold layout this driver can drive. init.sh stamps the scaffold's own
 # version into `.specfuse/VERSION`; check_scaffold_version() fails loud at startup if
 # the consumer's scaffold is older than this, pointing at `specfuse upgrade`. Bump
@@ -3156,6 +3156,20 @@ def run(
                 if _is_rearm:
                     fold_cumulative_on_rearm(wu, backend)
                 backend.set_wu(wu, "status", "in_progress")
+                # Stamp the resolved execution metadata into the WU frontmatter so
+                # it is visible when you read the .md (not only on the console /
+                # in events.jsonl): the model + effort it runs with (override or
+                # type default), which verification gate set is its exit oracle,
+                # the driver version that executed it, and when it was dispatched.
+                # Written after head_before so they ride the WU's squash commit;
+                # idempotent on retries/re-arms (same values overwrite cleanly,
+                # started_at refreshes to the latest dispatch).
+                backend.set_wu(wu, "model", wu.model)
+                backend.set_wu(wu, "effort", wu.effort)
+                backend.set_wu(wu, "gate_set", GATES_FOR_TYPE.get(wu.type, "code"))
+                backend.set_wu(wu, "driver_version", DRIVER_VERSION)
+                backend.set_wu(wu, "started_at",
+                               dt.datetime.now(dt.timezone.utc).isoformat())
                 # Events and per-attempt notes are buffered in memory during the
                 # WU's lifecycle and flushed at outcome time. This prevents the
                 # `git reset --hard` between failed attempts from silently

{specfuse_loop-0.3.1 → specfuse_loop-0.3.2/specfuse_loop.egg-info}/PKG-INFO

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

{specfuse_loop-0.3.1 → specfuse_loop-0.3.2}/specfuse_loop.egg-info/SOURCES.txt

@@ -124,4 +124,5 @@ tests/test_validate_event.py
 tests/test_verdict_coupling.py
 tests/test_verify_empty_gate_set.py
 tests/test_version_consistency.py
-tests/test_version_skew.py
+tests/test_version_skew.py
+tests/test_wu_execution_metadata.py

specfuse_loop-0.3.2/tests/test_wu_execution_metadata.py

@@ -0,0 +1,115 @@
+#
+# Copyright 2026 Specfuse contributors
+# Licensed under the Apache License, Version 2.0. See LICENSE.
+#
+"""The driver stamps resolved execution metadata into a WU's frontmatter.
+
+So the planned/effective model, effort, exit-oracle gate set, driver version,
+and dispatch time are visible when you read the WU `.md` — not only on the
+console or in events.jsonl. Written at dispatch (after status -> in_progress),
+so they ride the WU's squash commit.
+"""
+
+from __future__ import annotations
+
+import os
+import subprocess
+import unittest
+from pathlib import Path
+
+from tests._loop_loader import load_loop
+from tests.test_driver_integration import (
+    integration_workspace,
+    write_minimal_feature,
+    _read_frontmatter,
+)
+
+loop = load_loop()
+
+
+def _write_verification_yml(root: Path) -> None:
+    (root / ".specfuse/verification.yml").write_text(
+        "code:\n  - name: noop\n    command: \"true\"\n"
+        "doc:\n  - name: noop\n    command: \"true\"\n"
+        "plannext:\n  - name: noop\n    command: \"true\"\n"
+    )
+    subprocess.run(["git", "-C", str(root), "add", ".specfuse/verification.yml"],
+                   check=True)
+    subprocess.run(["git", "-C", str(root), "commit", "-q", "-m", "verif"], check=True)
+
+
+class TestWUExecutionMetadata(unittest.TestCase):
+
+    def setUp(self):
+        self._cwd = os.getcwd()
+        self._patches: list[tuple[str, object]] = []
+
+    def tearDown(self):
+        os.chdir(self._cwd)
+        for name, original in self._patches:
+            setattr(loop, name, original)
+
+    def _patch(self, name: str, replacement) -> None:
+        self._patches.append((name, getattr(loop, name)))
+        setattr(loop, name, replacement)
+
+    def test_dispatch_stamps_model_effort_gateset_driver_started(self):
+        with integration_workspace() as root:
+            os.chdir(root)
+            _write_verification_yml(root)
+            write_minimal_feature(
+                root, "FEAT-2026-9301", "exec-meta", "feat/exec-meta",
+                [("FEAT-2026-9301/T01", "implementation", "pending")],
+            )
+            self._patch("dispatch", lambda wu, fn, cost_tracking=True: ("(stub)\n", None))
+            self._patch("verify", lambda wu, fd, cfg=None: (True, "(stub)"))
+
+            rc = loop.run(None, dry_run=False)
+            self.assertEqual(rc, 0)
+
+            fdir = root / ".specfuse/features/FEAT-2026-9301-exec-meta"
+            fm = _read_frontmatter(fdir / "WU-T01.md")
+
+            # model = the WU's resolved model (the integration helper authors a
+            # concrete haiku id); effort defaults to EFFORT_BY_TYPE[implementation]
+            # = medium (helper sets no effort); gate_set = GATES_FOR_TYPE = code.
+            self.assertEqual(fm.get("model"), "claude-haiku-4-5-20251001")
+            self.assertEqual(fm.get("effort"), "medium")
+            self.assertEqual(fm.get("gate_set"), "code")
+            self.assertEqual(fm.get("driver_version"), loop.DRIVER_VERSION)
+            # started_at is a UTC ISO timestamp.
+            self.assertIn("started_at", fm)
+            self.assertRegex(fm["started_at"], r"^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}")
+
+    def test_author_model_effort_override_is_preserved(self):
+        """An explicit model/effort override survives the stamp (same value)."""
+        with integration_workspace() as root:
+            os.chdir(root)
+            _write_verification_yml(root)
+            write_minimal_feature(
+                root, "FEAT-2026-9302", "exec-ovr", "feat/exec-ovr",
+                [("FEAT-2026-9302/T01", "implementation", "pending")],
+            )
+            # Override the helper's default model with an alias + set effort.
+            wu_path = root / ".specfuse/features/FEAT-2026-9302-exec-ovr/WU-T01.md"
+            text = wu_path.read_text()
+            text = text.replace("model: claude-haiku-4-5-20251001\n",
+                                "model: opus\neffort: high\n", 1)
+            wu_path.write_text(text)
+            subprocess.run(["git", "-C", str(root), "add", "."], check=True)
+            subprocess.run(["git", "-C", str(root), "commit", "-q", "-m", "override"],
+                           check=True)
+
+            self._patch("dispatch", lambda wu, fn, cost_tracking=True: ("(stub)\n", None))
+            self._patch("verify", lambda wu, fd, cfg=None: (True, "(stub)"))
+            rc = loop.run(None, dry_run=False)
+            self.assertEqual(rc, 0)
+
+            fm = _read_frontmatter(
+                root / ".specfuse/features/FEAT-2026-9302-exec-ovr/WU-T01.md")
+            self.assertEqual(fm.get("model"), "opus")
+            self.assertEqual(fm.get("effort"), "high")
+
+
+if __name__ == "__main__":
+    unittest.main()

specfuse_loop-0.3.1/specfuse/loop/data/VERSION

@@ -1 +0,0 @@
-0.3.1