agentic-devtools 0.2.177__tar.gz → 0.2.178__tar.gz

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-devtools
-Version: 0.2.177
+Version: 0.2.178
 Summary: Agentic devtools integrate Jira, DevOps & more
 Author: ayaiayorg
 License-Expression: MIT
@@ -27,6 +27,8 @@ Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest-recording>=0.13.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
+Requires-Dist: types-requests>=2.28.0; extra == 'dev'
 Requires-Dist: vcrpy>=6.0.0; extra == 'dev'
 Provides-Extra: langchain
 Requires-Dist: langchain-core<1.0,>=0.3; extra == 'langchain'

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.177'
-__version_tuple__ = version_tuple = (0, 2, 177)
+__version__ = version = '0.2.178'
+__version_tuple__ = version_tuple = (0, 2, 178)
 
 __commit_id__ = commit_id = None

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/analysis/context_resolver.py

@@ -121,6 +121,7 @@ def resolve_analysis_context(
             msg = "Not in a git repository. Cannot resolve analysis context."
             raise ValueError(msg)
 
+    assert git_root is not None  # Resolved above in all branches
     caller_state_dir = get_state_dir()
 
     return AnalysisContext(

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/azure_devops/batch_review_helpers.py

@@ -10,6 +10,8 @@ intended to be reused by a future refactor of ``agdt-submit-reviews``.
 
 from __future__ import annotations
 
+from typing import Any
+
 # Valid outcomes for batch reviews (compared case-insensitively)
 _VALID_OUTCOMES = frozenset({"approve", "request-changes", "request-changes-with-suggestion"})
 
@@ -32,7 +34,7 @@ def _is_empty_or_whitespace(value: object) -> bool:
     return False
 
 
-def resolve_batch_reviews(payload: dict) -> list[object]:
+def resolve_batch_reviews(payload: dict) -> list[Any]:
     """Resolve defaults into individual review items from a batch payload.
 
     Takes a payload dict with optional ``default_outcome``,
@@ -57,13 +59,13 @@ def resolve_batch_reviews(payload: dict) -> list[object]:
     # Normalize items to a list so non-list / None values surface as
     # validation errors instead of crashing with TypeError.
     if raw_items is None:
-        items: list[object] = []
+        items: list[Any] = []
     elif isinstance(raw_items, list):
         items = raw_items
     else:
         items = [raw_items]
 
-    resolved: list[object] = []
+    resolved: list[Any] = []
     for item in items:
         # Non-dict items are passed through so validate_batch_reviews()
         # can surface a user-friendly error instead of an opaque TypeError.

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/azure_devops/marker.py

@@ -16,6 +16,7 @@ from __future__ import annotations
 
 import re
 import urllib.parse
+from collections.abc import Sequence
 from typing import Any
 
 # ---------------------------------------------------------------------------
@@ -240,7 +241,7 @@ def filter_agdt_threads(threads: list[dict[str, Any] | None]) -> list[dict[str,
     return [t for t in threads if t and has_agdt_marker(_get_first_comment_content(t))]
 
 
-def classify_agdt_threads(threads: list[dict[str, Any] | None]) -> dict[str, list[dict[str, Any]]]:
+def classify_agdt_threads(threads: Sequence[dict[str, Any] | None]) -> dict[str, list[dict[str, Any]]]:
     """Group agdt-marked threads by their marker ``type`` value.
 
     Only threads with a valid marker are included.  Threads without markers

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/git/agdt_branch.py

@@ -485,7 +485,7 @@ def read_branch_tree(
     if result.returncode != 0:
         raise GitPlumbingError("git ls-tree failed: " + result.stderr.strip())
 
-    tree = {}  # type: Dict[str, str]
+    tree = {}  # type: dict[str, str]
     for line in result.stdout.splitlines():
         # Format: "<mode> <type> <sha>\t<path>"
         meta, path = line.split("\t", 1)
@@ -659,7 +659,7 @@ def _discover_workflow_files(repo_root: Path, identity: str, worktree_key: str)
     base = repo_root / ".agdt" / "workflows" / identity / worktree_key
     if not base.is_dir():
         return {}
-    files = {}  # type: Dict[str, str]
+    files = {}  # type: dict[str, str]
     for file_path in sorted(base.rglob("*")):
         if not file_path.is_file():
             continue
@@ -763,7 +763,7 @@ def _read_tree_for_commit(commit_sha: str) -> dict[str, str]:
     if result.returncode != 0:
         raise GitPlumbingError("git ls-tree failed: " + result.stderr.strip())
 
-    tree = {}  # type: Dict[str, str]
+    tree = {}  # type: dict[str, str]
     for line in result.stdout.splitlines():
         # Format: "<mode> <type> <sha>\t<path>"
         meta, path = line.split("\t", 1)
@@ -869,7 +869,7 @@ def persist_workflow_state(
         #    When creating a brand-new -agdt branch, resolve the source branch
         #    HEAD upfront so we can (a) use its tree as the base and (b) set it
         #    as the parent commit.
-        src_sha = None  # type: Optional[str]
+        src_sha = None  # type: str | None
         if branch_is_new:
             src_result = _run_plumbing("rev-parse", source_branch)
             if src_result.returncode != 0:
@@ -889,7 +889,8 @@ def persist_workflow_state(
         #    in the newly discovered updates, so deleted files do not persist
         #    indefinitely in the -agdt branch.
         if branch_is_new:
-            existing_tree = _read_tree_for_commit(src_sha)  # type: Dict[str, str]
+            assert src_sha is not None  # Set to non-None when branch_is_new is True
+            existing_tree = _read_tree_for_commit(src_sha)  # type: dict[str, str]
         else:
             existing_tree = read_branch_tree(target_branch)
         workflow_prefix = f".agdt/workflows/{identity}/{worktree_key}/"
@@ -897,7 +898,7 @@ def persist_workflow_state(
             path: sha
             for path, sha in existing_tree.items()
             if not (path.startswith(workflow_prefix) and path not in updates)
-        }  # type: Dict[str, str]
+        }  # type: dict[str, str]
         merged = dict(filtered_existing, **updates)
         tree_sha = build_tree(merged)
 
@@ -993,7 +994,7 @@ def persist_workflow_state(
                 path: sha
                 for path, sha in remote_tree.items()
                 if not (path.startswith(workflow_prefix) and path not in updates)
-            }  # type: Dict[str, str]
+            }  # type: dict[str, str]
             merged = dict(filtered_remote, **updates)
             tree_sha = build_tree(merged)
 

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/github/pr_approve.py

@@ -217,7 +217,7 @@ def _verify_approval(
                 # Sort by submitted_at descending. Coerce non-string /
                 # null values to "" so the sort key is always comparable.
                 matching.sort(
-                    key=lambda r: r.get("submitted_at") if isinstance(r.get("submitted_at"), str) else "",
+                    key=lambda r: r.get("submitted_at") if isinstance(r.get("submitted_at"), str) else "",  # type: ignore[arg-type, return-value]
                     reverse=True,
                 )
                 latest = matching[0]

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/github/review_reply.py

@@ -257,16 +257,16 @@ def _verify_replies(
     if expected_reply_map:
         # Build precise lookup: (id, in_reply_to_id) pairs
         comment_pairs = {(c.get("id"), c.get("in_reply_to_id")) for c in comments}
-        result: dict[int, bool] = {}
+        verification: dict[int, bool] = {}
         for cid in expected_comment_ids:
             reply_id = expected_reply_map.get(cid)
             if reply_id is not None:
                 # Verify the specific reply we posted exists
-                result[cid] = (reply_id, cid) in comment_pairs
+                verification[cid] = (reply_id, cid) in comment_pairs
             else:
                 # No known reply ID; fall back to presence check
-                result[cid] = cid in reply_to_ids
-        return result
+                verification[cid] = cid in reply_to_ids
+        return verification
 
     return {cid: (cid in reply_to_ids) for cid in expected_comment_ids}
 

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/jira/create_commands.py

@@ -116,6 +116,12 @@ def create_epic() -> None:
         print("  agdt-create-epic", file=sys.stderr)
         sys.exit(1)
 
+    # At this point all required values are non-None (validated above)
+    assert summary is not None
+    assert role is not None
+    assert desired_outcome is not None
+    assert benefit is not None
+
     acceptance_criteria = _parse_multiline_string(get_jira_value("acceptance_criteria"))
     additional_information = _parse_multiline_string(get_jira_value("additional_information"))
     custom_labels = _parse_comma_separated(get_jira_value("labels"))
@@ -191,6 +197,12 @@ def create_issue() -> None:
         print(f"Error: Missing required fields: {', '.join(missing)}", file=sys.stderr)
         sys.exit(1)
 
+    # At this point all required values are non-None (validated above)
+    assert summary is not None
+    assert role is not None
+    assert desired_outcome is not None
+    assert benefit is not None
+
     acceptance_criteria = _parse_multiline_string(get_jira_value("acceptance_criteria"))
     additional_information = _parse_multiline_string(get_jira_value("additional_information"))
     custom_labels = _parse_comma_separated(get_jira_value("labels"))
@@ -259,6 +271,12 @@ def create_subtask() -> None:
         print(f"Error: Missing required fields: {', '.join(missing)}", file=sys.stderr)
         sys.exit(1)
 
+    # At this point all required values are non-None (validated above)
+    assert summary is not None
+    assert role is not None
+    assert desired_outcome is not None
+    assert benefit is not None
+
     if parent_key:
         project_key = parent_key.split("-")[0]
     else:  # pragma: no cover — parent_key is always required above

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/jira/role_commands.py

@@ -163,9 +163,9 @@ def check_users_exist() -> None:
     if existing_users:  # pragma: no cover
         print(f"\nUsers that CAN be added to roles ({len(existing_users)}):")
         usernames = [u["username"] for u in existing_users]
-        print(f"  {','.join(usernames)}")
+        print(f"  {','.join(str(u) for u in usernames)}")
         print("\nTo add these users to a role, run:")
-        print(f'  agdt-set jira.users "{",".join(usernames)}"')
+        print(f'  agdt-set jira.users "{",".join(str(u) for u in usernames)}"')
         print("  agdt-add-users-to-project-role")
 
 
@@ -465,7 +465,7 @@ def add_users_to_project_role_batch() -> None:
     failed = []
 
     for user_info in existing_users:
-        user = user_info["username"]
+        user = str(user_info["username"])
         payload = {"user": [user]}
         response = requests.post(url, headers=headers, json=payload, verify=ssl_verify, timeout=30)
 

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/tasks/commands.py

@@ -168,7 +168,7 @@ def list_tasks() -> None:
     print(f"\nTotal: {len(tasks)} task(s)")
 
     # Count by status
-    status_counts = {}
+    status_counts: dict[TaskStatus, int] = {}
     for task in tasks:
         status_counts[task.status] = status_counts.get(task.status, 0) + 1
 

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/workflows/advancement.py

@@ -161,7 +161,7 @@ def try_advance_workflow_after_pr_creation(
     Returns:
         True if a workflow transition was triggered, False otherwise
     """
-    context_updates = {}
+    context_updates: dict[str, int | str] = {}
     if pull_request_id:
         context_updates["pull_request_id"] = pull_request_id
     if pull_request_url:

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/cli/workflows/checklist.py

@@ -307,7 +307,7 @@ def parse_completed_items_arg(arg: str) -> list[int]:
     Returns:
         List of item IDs
     """
-    ids = []
+    ids: list[int] = []
     # Split by comma or space
     parts = arg.replace(",", " ").split()
 

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/file_locking.py

@@ -73,8 +73,8 @@ def _lock_file_windows(file_handle: IO, exclusive: bool = True, timeout: float =
         try:
             # On Windows, we lock the first byte of the file
             # LK_NBLCK for exclusive, LK_NBRLCK for shared (read-only)
-            lock_mode = msvcrt.LK_NBLCK if exclusive else msvcrt.LK_NBRLCK
-            msvcrt.locking(file_handle.fileno(), lock_mode, 1)
+            lock_mode = msvcrt.LK_NBLCK if exclusive else msvcrt.LK_NBRLCK  # type: ignore[attr-defined]
+            msvcrt.locking(file_handle.fileno(), lock_mode, 1)  # type: ignore[attr-defined]
             return
         except OSError as e:
             if time.time() - start_time > timeout:
@@ -87,7 +87,7 @@ def _unlock_file_windows(file_handle: IO) -> None:
     import msvcrt
 
     try:
-        msvcrt.locking(file_handle.fileno(), msvcrt.LK_UNLCK, 1)
+        msvcrt.locking(file_handle.fileno(), msvcrt.LK_UNLCK, 1)  # type: ignore[attr-defined]
     except OSError:
         # Ignore unlock errors - file may already be unlocked
         pass

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/orchestration/review/graph_builder.py

@@ -35,11 +35,11 @@ def build_pr_review_graph(checkpointer=None) -> CompiledStateGraph:
     """
     graph = StateGraph(PRReviewState)
 
-    graph.add_node("fetch_pr_details", fetch_pr_details_node)
-    graph.add_node("scaffold", scaffold_node)
-    graph.add_node("review_files", review_file_node)
-    graph.add_node("summarize", summarize_node)
-    graph.add_node("complete", complete_node)
+    graph.add_node("fetch_pr_details", fetch_pr_details_node)  # type: ignore[type-var]
+    graph.add_node("scaffold", scaffold_node)  # type: ignore[type-var]
+    graph.add_node("review_files", review_file_node)  # type: ignore[type-var]
+    graph.add_node("summarize", summarize_node)  # type: ignore[type-var]
+    graph.add_node("complete", complete_node)  # type: ignore[type-var]
 
     graph.set_entry_point("fetch_pr_details")
 

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/state.py

@@ -29,7 +29,7 @@ import tempfile
 from collections.abc import Iterator
 from datetime import datetime, timezone
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING, Any, Literal, overload
 
 from .file_locking import FileLockError, locked_state_file
 
@@ -1481,6 +1481,15 @@ def get_all_keys() -> list[str]:
 # Convenience functions for common parameters
 
 
+if TYPE_CHECKING:
+
+    @overload
+    def get_pull_request_id(required: Literal[True]) -> int: ...
+
+    @overload
+    def get_pull_request_id(required: bool = ...) -> int | None: ...
+
+
 def get_pull_request_id(required: bool = False) -> int | None:
     """Get the pull request ID from state."""
     value = get_value("pull_request_id", required=required)
@@ -1492,6 +1501,15 @@ def set_pull_request_id(pull_request_id: int) -> None:
     set_value("pull_request_id", pull_request_id)
 
 
+if TYPE_CHECKING:
+
+    @overload
+    def get_thread_id(required: Literal[True]) -> int: ...
+
+    @overload
+    def get_thread_id(required: bool = ...) -> int | None: ...
+
+
 def get_thread_id(required: bool = False) -> int | None:
     """Get the thread ID from state."""
     value = get_value("thread_id", required=required)

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/agentic_devtools/submission_processor.py

@@ -74,7 +74,7 @@ def _get_attribution_params(
     review_state: Any,
     config: AzureDevOpsConfig,
     file_path: str | None = None,
-) -> dict[str, str | None]:
+) -> dict[str, Any]:
     """Extract attribution parameters from ReviewState for comment rendering.
 
     Replicates the logic from ``file_review_commands._get_attribution_params()``
@@ -276,7 +276,7 @@ def process_submission(
 
             # Record verdict when a model ID is available
             if review_state.sessions:
-                model_id = review_state.sessions[-1].modelId
+                model_id: str | None = review_state.sessions[-1].modelId
             else:
                 model_id = getattr(review_state, "modelId", None)
             if model_id:

{agentic_devtools-0.2.177 → agentic_devtools-0.2.178}/pyproject.toml

@@ -39,6 +39,8 @@ dev = [
     "pytest-asyncio>=0.23.0",
     "pytest-cov>=4.0.0",
     "ruff>=0.4.0",
+    "types-PyYAML>=6.0.0",
+    "types-requests>=2.28.0",
     "vcrpy>=6.0.0",
     "pytest-recording>=0.13.0",
 ]
@@ -261,3 +263,24 @@ exclude_also = [
 
 [tool.coverage.html]
 directory = "htmlcov"
+
+[tool.mypy]
+python_version = "3.10"
+warn_unused_configs = true
+disallow_untyped_defs = false
+
+[[tool.mypy.overrides]]
+module = ["langgraph.*", "mcp.*", "azure.*"]
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = [
+    "agentic_devtools.cli.azure_devops.vpn_toggle",
+    "agentic_devtools.cli.azure_devops.mark_reviewed",
+    "agentic_devtools.cli.azure_devops.helpers",
+    "agentic_devtools.cli.azure_devops.file_review_commands",
+    "agentic_devtools.cli.azure_devops.pull_request_details_commands",
+    "agentic_devtools.cli.azure_devops.run_details_commands",
+    "agentic_devtools.cli.azure_context.commands",
+]
+ignore_errors = true

agentic_devtools-0.2.178/specs/1741-create-jira-issue-workflow/spec.md

@@ -0,0 +1,135 @@
+# Feature Specification: create-jira-issue workflow: no Copilot session started after placeholder creation and worktree setup
+
+**Source Issue**: #1741 (<https://github.com/ayaiayorg/agentic-devtools/issues/1741>)
+
+## Problem Statement
+
+When `agdt-initiate-create-jira-issue-workflow` is run without `--issue-key`,
+the command successfully creates a placeholder Jira issue and opens the new
+worktree in VS Code, but the workflow does not continue automatically.
+
+The terminal reports that "A Copilot session will start automatically in the VS
+Code integrated terminal.", yet no Copilot session starts and no
+`runOn: folderOpen` task displays the next workflow guidance. Users are left in
+a blank editor window and must manually find and run a continuation command.
+This breaks the expected end-to-end handoff and creates inconsistent behavior
+compared to issue-key flows that do continue automatically.
+
+## Steps to Reproduce
+
+1. From the main repo (not in a worktree), run:
+
+   ```text
+   agdt-initiate-create-jira-issue-workflow --project-key DFLY --issue-type Story --user-request "I need a story to cover..."
+   ```
+
+2. The command creates a placeholder issue (e.g., DFLY-3006) and sets up a worktree at `C:\repos\DFLY-3006`
+3. VS Code opens with the worktree workspace
+4. Observe: **no Copilot session is started** — the user is left at a blank VS Code window with no workflow guidance
+
+## Expected Behavior
+
+After the worktree is created and VS Code is opened, a Copilot session should start automatically (or a VS Code `runOn: folderOpen` task should fire) that hands off to `@agdt.get-next-workflow-prompt`
+to display the create-jira-issue workflow instructions. This is what the success message promises: "A Copilot session will start automatically in the VS Code integrated terminal."
+
+The continuation should behave identically to running this manually inside the worktree:
+
+```text
+agdt-initiate-update-jira-issue-workflow --issue-key DFLY-3006 --user-request "<original user request>"
+```
+
+Or equivalently:
+
+```text
+agdt-initiate-create-jira-issue-workflow --issue-key DFLY-3006 --user-request "<original user request>"
+```
+
+## Actual Behavior
+
+- The placeholder Jira issue is created successfully.
+- The worktree is created successfully.
+- VS Code opens on the new worktree.
+- **No Copilot session starts and no `folderOpen` continuation task runs.**
+- The success message claims automatic continuation, but the user must manually copy and run the continuation command from prior terminal output.
+
+## User Scenarios & Testing
+
+### User Story 1 - Primary Workflow (Priority: P1)
+
+As a developer creating a new Jira issue from the main repo (no `--issue-key`),
+I want the workflow to continue automatically after VS Code opens the new
+worktree so I can immediately see and execute the next guided step without
+manual command copy/paste.
+
+**Acceptance Scenarios**:
+
+1. **Given** `agdt-initiate-create-jira-issue-workflow` is run without
+   `--issue-key`, **When** placeholder creation and worktree setup complete,
+   **Then** opening the worktree triggers automatic continuation in that
+   window (Copilot session and/or `runOn: folderOpen` task).
+2. **Given** the new worktree window is opened, **When** continuation runs,
+   **Then** the user is shown guidance sourced from
+   `@agdt.get-next-workflow-prompt` without requiring manual terminal input.
+
+### User Story 2 - Error Recovery (Priority: P1)
+
+As a developer who sees the workflow success message, I want the message to match actual behavior so I can trust that continuation has started in the newly opened worktree.
+
+**Acceptance Scenarios**:
+
+1. **Given** the workflow reports successful setup, **When** the worktree
+   opens, **Then** either the Copilot session starts or an equivalent
+   folder-open continuation is visibly executed in that window.
+2. **Given** automatic continuation cannot be started, **When** the workflow
+   completes, **Then** the user receives an explicit failure/next-step message
+   instead of a misleading "Copilot session will start automatically" success
+   statement.
+
+### User Story 3 - Graceful Degradation (Priority: P2)
+
+As a developer using either the existing-issue path (`--issue-key`) or
+placeholder-creation path (no `--issue-key`), I want both paths to provide the
+same automatic continuation experience after worktree open.
+
+**Acceptance Scenarios**:
+
+1. **Given** I run with `--issue-key`, **When** the worktree opens, **Then**
+   continuation guidance appears automatically in the new window.
+2. **Given** I run without `--issue-key` and a placeholder is created,
+   **When** the worktree opens, **Then** continuation guidance appears
+   automatically in the same way as the `--issue-key` path.
+
+## Requirements
+
+### Functional Requirements
+
+- **FR-001**: When `agdt-initiate-create-jira-issue-workflow` is run without
+  `--issue-key`, the workflow MUST invoke the same auto-setup continuation
+  mechanism used by the issue-key path after placeholder issue creation and
+  worktree setup.
+
+- **FR-002**: After VS Code opens the new worktree, the workflow MUST
+  automatically start continuation in that window by starting a Copilot session
+  and/or triggering an equivalent `runOn: folderOpen` task.
+
+- **FR-003**: Automatic continuation MUST display the next workflow guidance by invoking `@agdt.get-next-workflow-prompt` in the newly opened worktree context, without requiring manual command entry.
+
+- **FR-004**: Success output MUST be truthful: it MUST only claim automatic Copilot/session continuation when that continuation has actually been initiated.
+
+- **FR-005**: If automatic continuation cannot be initiated, the workflow MUST emit an explicit actionable failure/degraded message describing the exact manual continuation command to run in the new worktree.
+
+### Non-Functional Requirements
+
+- **NFR-001**: The implementation must complete all operations within 120 seconds under normal conditions.
+
+- **NFR-002**: The implementation must maintain backward compatibility with existing interfaces and contracts.
+
+## Success Criteria
+
+- **SC-001**: In placeholder-creation runs (no `--issue-key`), 100% of
+  successful setups open the worktree and automatically display next-step
+  workflow guidance in that new VS Code window without manual copy/paste.
+
+- **SC-002**: The user-visible success message for create-jira-issue setup has zero observed mismatches between "automatic continuation started" claims and actual continuation behavior.
+
+- **SC-003**: Placeholder-creation and issue-key paths produce equivalent continuation UX: both paths automatically surface `@agdt.get-next-workflow-prompt` guidance after the worktree window opens.