methodology-framework 0.4.2__tar.gz → 0.4.3__tar.gz

{methodology_framework-0.4.2/src/methodology_framework.egg-info → methodology_framework-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: methodology-framework
-Version: 0.4.2
+Version: 0.4.3
 Summary: Portable process tooling for agent-driven delivery — scripts, playbooks, templates, and specs.
 Author: whiteout59
 License-Expression: Apache-2.0
@@ -316,7 +316,7 @@ jobs:
   build-and-register:
     uses: whiteout59/methodology-framework/.github/workflows/build-and-register.yml@v0.1.0
     with:
-      playbook_body_path: "methodology/playbooks/scrum-router.body.md"
+      playbook_body_path: "methodology/playbooks/router-base.body.md"
       bindings_path: "docs/jira-pickup-config.md"
     secrets:
       DEVIN_API_TOKEN: ${{ secrets.DEVIN_API_TOKEN }}

{methodology_framework-0.4.2 → methodology_framework-0.4.3}/README.md

@@ -292,7 +292,7 @@ jobs:
   build-and-register:
     uses: whiteout59/methodology-framework/.github/workflows/build-and-register.yml@v0.1.0
     with:
-      playbook_body_path: "methodology/playbooks/scrum-router.body.md"
+      playbook_body_path: "methodology/playbooks/router-base.body.md"
       bindings_path: "docs/jira-pickup-config.md"
     secrets:
       DEVIN_API_TOKEN: ${{ secrets.DEVIN_API_TOKEN }}

{methodology_framework-0.4.2 → methodology_framework-0.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "methodology-framework"
-version = "0.4.2"
+version = "0.4.3"
 description = "Portable process tooling for agent-driven delivery — scripts, playbooks, templates, and specs."
 readme = "README.md"
 license = "Apache-2.0"

{methodology_framework-0.4.2 → methodology_framework-0.4.3}/src/methodology_framework/build_playbook.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """Build a concrete, project-bound playbook from the parameterized body + bindings.
 
-Reads the parameterized playbook body from methodology/playbooks/scrum-router.body.md
+Reads the parameterized playbook body from methodology/playbooks/router-base.body.md
 and substitutes {{PLACEHOLDER}} tokens with the project-specific bindings defined in
 docs/jira-pickup-config.md § 5.1 (the playbook_bindings YAML block).
 
@@ -23,7 +23,7 @@ Options:
                     Does not write output.
 
 When --body and --bindings are omitted, the script falls back to the legacy
-hardcoded paths (methodology/playbooks/scrum-router.body.md and
+hardcoded paths (methodology/playbooks/router-base.body.md and
 docs/jira-pickup-config.md relative to the repo root).
 """
 
@@ -35,7 +35,7 @@ import sys
 from pathlib import Path
 
 REPO_ROOT = Path(__file__).resolve().parent.parent
-BODY_PATH = REPO_ROOT / "methodology" / "playbooks" / "scrum-router.body.md"
+BODY_PATH = REPO_ROOT / "methodology" / "playbooks" / "router-base.body.md"
 CONFIG_PATH = REPO_ROOT / "docs" / "jira-pickup-config.md"
 
 PLACEHOLDER_RE = re.compile(r"\{\{(\w+)\}\}")

{methodology_framework-0.4.2 → methodology_framework-0.4.3}/src/methodology_framework/jira_discovery.py

@@ -229,24 +229,14 @@ def discover_statuses(
     return result
 
 
-def discover_transitions(
-    session: Any,
-    base_url: str,
-    project_key: str,
-) -> dict[str, str]:
-    """Discover transition name→ID map.
-
-    Uses GET /rest/api/3/project/{key}/statuses to find a sample issue
-    type, then queries the workflow scheme. Falls back to scanning
-    transitions from each status via the workflow spec.
-
-    For transitions, the approach is: use the statuses endpoint to get
-    status names, then use GET /rest/api/3/status to get transitions.
-    But Jira Cloud doesn't expose transitions without an issue context.
-
-    Instead, we create a name→ID map from the workflow spec (which has
-    transition_id values) and verify they're consistent with what's live.
-    The verifier already checked these exist; we trust the spec IDs.
+def _spec_transition_map() -> dict[str, str]:
+    """Return canonical transition name→ID map sourced from workflow.yaml.
+
+    Used only for dry-run sync invocations where no Jira credentials are
+    available. Returns the SCRUM-accidental IDs encoded in the spec —
+    these are stable for the SCRUM project but will NOT match a freshly-
+    provisioned team-managed project. Real sync uses :func:`discover_transitions`
+    which queries Jira directly.
     """
     shape = _load_shape(_WORKFLOW_YAML)
     result: dict[str, str] = {}
@@ -256,11 +246,86 @@ def discover_transitions(
             tid = str(t["transition_id"])
             if name not in result:
                 result[name] = tid
+    return result
 
-    if not result:
-        raise _fail("transition", "(any)", project_key)
 
-    return result
+def discover_transitions(
+    session: Any,
+    base_url: str,
+    project_key: str,
+) -> dict[str, str]:
+    """Discover transition name→ID map by querying Jira directly.
+
+    Strategy: find any existing issue in the project via JQL search, then
+    call ``GET /rest/api/3/issue/{key}/transitions`` to read the live
+    transition map for the workflow. The framework's canonical workflow
+    uses global transitions (``isGlobal: true``), so any single issue
+    exposes the complete name→ID map.
+
+    Raises :class:`DiscoveryError` if:
+
+    - The project has no issues yet (operator must create at least one
+      issue before first sync — sync can't probe an empty project's
+      workflow because Jira Cloud only exposes transitions in an issue
+      context).
+    - Any canonical transition name is missing from the live workflow
+      (operator must fix the workflow per ``bootstrap-jira --verify``).
+
+    For SCRUM the discovered IDs match :func:`_spec_transition_map` by
+    historical accident. For freshly-provisioned projects they will not —
+    that's the point of querying instead of trusting the spec.
+    """
+    # Find any existing issue in the project via JQL.
+    resp = session.get(
+        f"{base_url}/rest/api/3/search/jql",
+        params={
+            "jql": f"project={project_key}",
+            "fields": "key",
+            "maxResults": 1,
+        },
+    )
+    resp.raise_for_status()
+    search_data: dict[str, Any] = resp.json()
+    issues = search_data.get("issues") or []
+
+    if not issues:
+        raise DiscoveryError(
+            f"Project {project_key} has no issues yet, so workflow transitions "
+            f"cannot be probed. Jira Cloud only exposes transition IDs in an "
+            f"issue context. Create at least one placeholder issue in "
+            f"{project_key} (any issue type, any state) and re-run sync. "
+            f"That issue is enough — discovery uses it as a probe to read the "
+            f"global transition map for the project's workflow."
+        )
+
+    probe_key: str = issues[0]["key"]
+    logger.info(
+        "Probing transitions on %s (any existing issue exposes the global "
+        "transition map for the project's workflow).",
+        probe_key,
+    )
+
+    resp = session.get(f"{base_url}/rest/api/3/issue/{probe_key}/transitions")
+    resp.raise_for_status()
+    transitions_data: dict[str, Any] = resp.json()
+
+    name_to_id: dict[str, str] = {}
+    for t in transitions_data.get("transitions", []):
+        name_to_id[t["name"]] = str(t["id"])
+
+    # Verify every canonical transition name resolved.
+    canonical = _canonical_transition_names()
+    missing = canonical - set(name_to_id.keys())
+    if missing:
+        raise DiscoveryError(
+            f"Project {project_key}'s workflow is missing required transition(s): "
+            f"{', '.join(sorted(missing))}. "
+            f"Run 'methodology-framework bootstrap-jira --verify "
+            f"--project-key={project_key}' to identify the gaps, then add the "
+            f"missing states/transitions in the Jira workflow editor."
+        )
+
+    return name_to_id
 
 
 def discover_link_types(

methodology_framework-0.4.2/src/methodology_framework/playbooks/scrum-router.body.md → methodology_framework-0.4.3/src/methodology_framework/playbooks/router-base.body.md

@@ -1,7 +1,8 @@
 ---
 playbook_id: {{PLAYBOOK_ID}}
-version: 1.5.0
+version: 1.6.0
 changelog:
+  - "1.6.0 (2026-06-07): Renamed body file from `scrum-router.body.md` to `router-base.body.md`. Canonical-template naming should be project-neutral; the SCRUM prefix was a legacy artifact from when the playbook had a single SCRUM binding. The rendered outputs continue to be named per-binding via `{{PLAYBOOK_ID}}` (scrum-router, meth-router, etc.). Code + workflow references updated to the new path. Closes #113. MINOR bump per SemVer (additive: file rename + reference updates, no body content change)."
   - "1.5.0 (2026-06-07): Parameterize all self-references via new {{PLAYBOOK_ID}} substitution token (previously hardcoded as `scrum-router` in 4 places — frontmatter, the audit-banner step, the comment template, and the webapp settings-path reference). Bindings (scrum.yaml, meth.yaml) now declare PLAYBOOK_ID. Rendered METH playbook now correctly emits `meth-router` in the audit banner instead of `scrum-router` (surfaced by the post-extraction smoke #71 / METH-5). MINOR bump per SemVer (new substitution token added; no breaking change since all bindings updated simultaneously). Closes #92."
   - "1.4.0 (2026-06-02): Added METH as a second bound project alongside SCRUM. Surface expansion only; no body changes. MINOR bump per SemVer (binding surface expands without breaking existing callers)."
   - "1.3.0 (2026-05-29): New convention — cross-repo writeback discipline (story file in repo A, implementation in repo B → two-PR pattern with writeback PR in repo A). New convention — agent populates agent_session_url field in post-execution notes block. New convention — agent_acus field added to post-exec block (default \"pending\"; populated asynchronously by post-merge automation since agents cannot self-report ACU consumption mid-session). MINOR bump per SemVer (three additive new conventions, no breaking changes for single-repo work)."

{methodology_framework-0.4.2 → methodology_framework-0.4.3}/src/methodology_framework/register_playbook_with_devin.py

@@ -103,9 +103,7 @@ def list_playbooks(token: str, org_id: str) -> list[dict[str, Any]]:
     # forward-compat across API shape changes.
     if isinstance(resp, list):
         return resp
-    items: list[dict[str, Any]] = resp.get(
-        "items", resp.get("playbooks", resp.get("data", []))
-    )
+    items: list[dict[str, Any]] = resp.get("items", resp.get("playbooks", resp.get("data", [])))
     return items
 
 

{methodology_framework-0.4.2 → methodology_framework-0.4.3}/src/methodology_framework/sync_stories_to_jira.py

@@ -1070,10 +1070,13 @@ def main(argv: list[str] | None = None) -> int:
             logger.error("Jira shape discovery failed: %s", exc)
             return 1
     else:
-        # In dry-run mode, use a placeholder shape with spec-sourced IDs
-        from methodology_framework.jira_discovery import discover_transitions as _dt
+        # In dry-run mode, use a placeholder shape with spec-sourced IDs.
+        # _spec_transition_map() reads workflow.yaml and never calls Jira —
+        # safe for dry-run where credentials may be absent. Real sync uses
+        # discover_transitions() which probes a live issue.
+        from methodology_framework.jira_discovery import _spec_transition_map
 
-        transitions = _dt(client.session, client.base_url, project_key)
+        transitions = _spec_transition_map()
         shape = JiraShape(
             project_key=project_key,
             cf_story_file="DRY_RUN_CF",

{methodology_framework-0.4.2 → methodology_framework-0.4.3/src/methodology_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: methodology-framework
-Version: 0.4.2
+Version: 0.4.3
 Summary: Portable process tooling for agent-driven delivery — scripts, playbooks, templates, and specs.
 Author: whiteout59
 License-Expression: Apache-2.0
@@ -316,7 +316,7 @@ jobs:
   build-and-register:
     uses: whiteout59/methodology-framework/.github/workflows/build-and-register.yml@v0.1.0
     with:
-      playbook_body_path: "methodology/playbooks/scrum-router.body.md"
+      playbook_body_path: "methodology/playbooks/router-base.body.md"
       bindings_path: "docs/jira-pickup-config.md"
     secrets:
       DEVIN_API_TOKEN: ${{ secrets.DEVIN_API_TOKEN }}

{methodology_framework-0.4.2 → methodology_framework-0.4.3}/src/methodology_framework.egg-info/SOURCES.txt

@@ -18,7 +18,7 @@ src/methodology_framework/jira_shapes/__init__.py
 src/methodology_framework/jira_shapes/automation_rules.yaml
 src/methodology_framework/jira_shapes/custom_fields.yaml
 src/methodology_framework/jira_shapes/workflow.yaml
-src/methodology_framework/playbooks/scrum-router.body.md
+src/methodology_framework/playbooks/router-base.body.md
 src/methodology_framework/playbooks/bindings/meth.yaml
 src/methodology_framework/playbooks/bindings/scrum.yaml
 src/methodology_framework/specs/devin-story-format.md