@event4u/agent-config 1.12.0 → 1.14.0

package/.agent-src/templates/hooks/pre-commit-roadmap-progress

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# Pre-commit hook: roadmap progress dashboard sync (event4u/agent-config)
+#
+# Installed by `./agent-config hooks:install`. Aborts the commit if
+# `agents/roadmaps-progress.md` is out of date relative to staged
+# changes under `agents/roadmaps/`. Exits silently when no roadmap
+# files are staged — zero overhead on unrelated commits.
+#
+# To run manually:
+#   ./agent-config roadmap:progress-check
+#
+# To uninstall:
+#   rm .git/hooks/pre-commit
+set -e
+
+# Only act on commits that touch roadmap content.
+staged="$(git diff --cached --name-only --diff-filter=ACMR 2>/dev/null || true)"
+case "$staged" in
+  *agents/roadmaps/*.md*|*agents/roadmaps-progress.md*|*.augment/scripts/update_roadmap_progress.py*)
+    : ;;
+  *)
+    exit 0 ;;
+esac
+
+# Resolve the script — prefer the consumer-shipped path, fall back to
+# the source-of-truth copy when run from inside the package itself.
+script=""
+for cand in \
+  ".augment/scripts/update_roadmap_progress.py" \
+  ".agent-src/scripts/update_roadmap_progress.py" \
+  ".agent-src.uncompressed/scripts/update_roadmap_progress.py"; do
+  if [ -f "$cand" ]; then
+    script="$cand"
+    break
+  fi
+done
+
+if [ -z "$script" ]; then
+  echo "⚠️  pre-commit-roadmap-progress: update_roadmap_progress.py not found." >&2
+  echo "    Run \`task install\` (or \`./agent-config install\`) and retry." >&2
+  echo "    Skipping check — letting commit through." >&2
+  exit 0
+fi
+
+if ! python3 "$script" --check >/dev/null 2>&1; then
+  echo "❌  agents/roadmaps-progress.md is stale relative to your staged changes." >&2
+  echo "" >&2
+  echo "    Regenerate the dashboard with one of:" >&2
+  echo "      ./agent-config roadmap:progress" >&2
+  echo "      task roadmap-progress" >&2
+  echo "      python3 $script" >&2
+  echo "" >&2
+  echo "    Then \`git add agents/roadmaps-progress.md\` and retry the commit." >&2
+  echo "" >&2
+  echo "    To bypass once (NOT recommended):" >&2
+  echo "      git commit --no-verify" >&2
+  exit 1
+fi
+
+exit 0

package/.agent-src/templates/roadmaps.md

@@ -27,8 +27,14 @@ Templates for roadmap files stored in `agents/roadmaps/` or `app/Modules/{Module
 
 13. **No tags, releases, or version numbers.** Roadmaps describe work, not shipping.
     Never assign version suffixes to phases (`Phase 1 — v1.8.0`), never write
-    "Target release: X.Y.Z", never plan git tags. Release and tag decisions
-    belong to the user and are taken outside the roadmap.
+    "Target release: X.Y.Z", never plan git tags or deprecation dates. Release
+    and tag decisions belong to the user, taken outside the roadmap. Enforced by
+    [`scope-control`](../rules/scope-control.md#git-operations--permission-gated).
+14. **No automatic branch switches mid-roadmap.** Roadmap work runs on the
+    current branch. If a separate branch (spike, hotfix, experiment) would
+    be useful, agent may propose it **once** during creation — not during
+    execution. Default: stay on current branch. If user declines, topic is
+    closed for this roadmap. See [`scope-control`](../rules/scope-control.md#decline--silence--no-re-asking-on-the-same-task).
 
 ---
 

package/.agent-src/templates/scripts/implement_ticket/__init__.py

@@ -1,40 +1,77 @@
-"""/implement-ticket orchestrator — linear step dispatcher.
-
-Shipped to consumer projects via the installer. Consumer code imports
-``DeliveryState``, ``dispatch``, and the ``Outcome`` enum from this
-package; step implementations land in Phase 2 under
-``.agent-src.uncompressed/skills/implement-ticket/`` and plug into the
-``Step`` protocol exposed here.
-
-Architectural constraints (from
-``agents/contexts/adr-implement-ticket-runtime.md`` and
-``agents/contexts/implement-ticket-flow.md``):
-
-- Runtime is Python 3.10+.
-- The dispatcher is linear, not a DAG. Eight fixed steps, fixed order.
-- ``DeliveryState`` is the only object shared between steps — no
-  hidden state, no side channels.
-- Every step terminates in ``success | blocked | partial``. ``blocked``
-  and ``partial`` halt the flow and surface numbered questions.
-- The dispatcher never calls git, writes commits, or opens PRs.
+"""``implement_ticket`` — deprecated shim, retained for one release.
+
+The engine moved to :mod:`work_engine` in R1 Phase 3. This module
+re-exports the public surface so existing imports keep working, but
+emits :class:`DeprecationWarning` on import. The Golden-Transcript
+freeze-guard pins ``./agent-config implement-ticket`` against the
+locked baseline; the shim keeps that path byte-stable while internal
+callers migrate to ``work_engine``.
+
+Remove after the next public release of this package.
 """
 from __future__ import annotations
 
-from .delivery_state import (
+import sys as _sys
+import warnings as _warnings
+
+_warnings.warn(
+    "implement_ticket has moved to work_engine; importing implement_ticket "
+    "is deprecated and will be removed in a future release. Update imports "
+    "to `from work_engine import …`.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Register submodule aliases so `from implement_ticket.steps.plan import …`
+# and friends keep resolving to the work_engine implementation. The legacy
+# package no longer ships these submodules on disk; sys.modules entries
+# keep dotted-path imports working until the shim is removed.
+import work_engine as _we_pkg  # noqa: E402
+import work_engine.cli as _we_cli  # noqa: E402
+import work_engine.delivery_state as _we_delivery_state  # noqa: E402
+import work_engine.dispatcher as _we_dispatcher  # noqa: E402
+import work_engine.persona_policy as _we_persona_policy  # noqa: E402
+import work_engine.directives.backend as _we_steps  # noqa: E402
+from work_engine.directives.backend import (  # noqa: E402
+    analyze as _we_step_analyze,
+    implement as _we_step_implement,
+    memory as _we_step_memory,
+    plan as _we_step_plan,
+    refine as _we_step_refine,
+    report as _we_step_report,
+    test as _we_step_test,
+    verify as _we_step_verify,
+)
+
+_sys.modules.setdefault("implement_ticket.cli", _we_cli)
+_sys.modules.setdefault("implement_ticket.delivery_state", _we_delivery_state)
+_sys.modules.setdefault("implement_ticket.dispatcher", _we_dispatcher)
+_sys.modules.setdefault("implement_ticket.persona_policy", _we_persona_policy)
+_sys.modules.setdefault("implement_ticket.steps", _we_steps)
+_sys.modules.setdefault("implement_ticket.steps.analyze", _we_step_analyze)
+_sys.modules.setdefault("implement_ticket.steps.implement", _we_step_implement)
+_sys.modules.setdefault("implement_ticket.steps.memory", _we_step_memory)
+_sys.modules.setdefault("implement_ticket.steps.plan", _we_step_plan)
+_sys.modules.setdefault("implement_ticket.steps.refine", _we_step_refine)
+_sys.modules.setdefault("implement_ticket.steps.report", _we_step_report)
+_sys.modules.setdefault("implement_ticket.steps.test", _we_step_test)
+_sys.modules.setdefault("implement_ticket.steps.verify", _we_step_verify)
+
+from work_engine import (  # noqa: E402,F401  — re-export for backwards compat
     AGENT_DIRECTIVE_PREFIX,
+    DEFAULT_PERSONA,
+    DEFAULT_STATE_FILE,
     DeliveryState,
     Outcome,
+    PersonaPolicy,
+    STEP_ORDER,
     Step,
     StepResult,
     agent_directive,
+    dispatch,
     is_agent_directive,
-)
-from .cli import DEFAULT_STATE_FILE, main
-from .dispatcher import STEP_ORDER, dispatch
-from .persona_policy import (
-    DEFAULT_PERSONA,
-    PersonaPolicy,
     known_personas,
+    main,
     resolve_policy,
 )
 

package/.agent-src/templates/scripts/implement_ticket/__main__.py

@@ -1,9 +1,15 @@
-"""Module entry point — lets ``python3 -m implement_ticket`` run the CLI."""
+"""Deprecated CLI entry point — delegates to :mod:`work_engine`.
+
+``python3 -m implement_ticket`` still works because the Golden-Transcript
+freeze-guard pins that invocation. Internally it forwards to
+``work_engine.cli.main`` after emitting a ``DeprecationWarning`` from
+the package ``__init__``.
+"""
 from __future__ import annotations
 
 import sys
 
-from .cli import main
+from work_engine.cli import main
 
 if __name__ == "__main__":
     sys.exit(main())