ai-dev-workflow 0.2.0__tar.gz → 0.3.0__tar.gz

{ai_dev_workflow-0.2.0 → ai_dev_workflow-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-dev-workflow
-Version: 0.2.0
+Version: 0.3.0
 Summary: Provider-neutral AI-assisted development workflow and CLI
 Author: vuthethienlong
 Project-URL: Homepage, https://github.com/vuthethienlong/ai-dev-workflow
@@ -16,7 +16,7 @@ Requires-Dist: PyYAML>=6.0
 
 Reusable, provider-neutral workflow for AI-assisted software development.
 
-This repository starts from the workflow proven in the Dragon's Dogma 2 project and keeps Superpowers-style artifacts as first-class inputs: brainstorming, spec, ADR, implementation plan, tests, PR evidence and runtime verification.
+This repository provides a reusable, provider-neutral AI development workflow with first-class brainstorming, spec, ADR, implementation plan, tests, PR evidence and runtime verification artifacts.
 
 ## Default lifecycle
 
@@ -30,7 +30,7 @@ Brainstorm
   -> RED
   -> ImplementerAgent implements
   -> GREEN + regression
-  -> ReviewerAgent (optional/manual by default)
+  -> ReviewerAgent (automatic independent review by default)
   -> Integration
   -> Runtime verification batch when required
   -> Promotion / Done
@@ -41,7 +41,7 @@ Brainstorm
 - `ArchitectAgent`: brainstorm, spec, ADR and acceptance criteria.
 - `TesterAgent`: derives tests from the frozen contract and proves RED before implementation.
 - `ImplementerAgent`: implements without changing the frozen test contract; must reach GREEN and run applicable regression checks.
-- `ReviewerAgent`: optional semantic/architecture reviewer. Disabled/manual by default in v1.
+- `ReviewerAgent`: automatic semantic/architecture reviewer by default; must use a different worker_id from the Implementer. Separate credential/identity is optional.
 - `RuntimeVerifierAgent`: optional, project-specific runtime verification role.
 
 A role is not a model. GPT, Codex, Claude, local models or future providers are replaceable adapters under these contracts.
@@ -52,7 +52,7 @@ A role is not a model. GPT, Codex, Claude, local models or future providers are
 - `Ready` is the commitment/freeze boundary.
 - Test design happens before implementation.
 - Implementer may report a bad test/spec as blocked, but must not rewrite expectations merely to make tests pass.
-- Deterministic CI gates run before optional semantic AI review.
+- Deterministic CI gates run before automatic independent semantic review.
 - Runtime verification is separate from offline/CI verification.
 - Projects consume versioned reusable workflows such as `@v1`; they do not copy the engine.
 
@@ -70,6 +70,8 @@ project tests/runtime rules
 
 Its caller workflow will reference this repository's reusable workflow.
 
+The framework does **not** install its own CI/check workflow into consumer repositories, does not configure required status checks, and does not modify branch protection. Existing consumer-repository build, test, lint, security, approval, and merge policies remain authoritative. The generated `.github/workflows/ai-workflow.yml` is orchestration only.
+
 See:
 - `AGENTS.md`
 - `docs/lifecycle.md`
@@ -278,7 +280,7 @@ Local stdio MCP remains available with `--ado-mcp-mode local`. Supported MCP aut
 
 ## Worker registration
 
-Setup can register local, Codespaces, or cloud workers separately from AI provider configuration.
+Setup can register local, Codespaces, or cloud workers separately from AI provider configuration. Worker IDs are independent from credential identities, so multiple workers may share one credential reference.
 
 Example local hybrid worker:
 
@@ -326,14 +328,28 @@ Use `./bin/ai-workflow update --check` to inspect the configured framework ref,
 
 ## Install from PyPI
 
-Once a release is published to PyPI, consumers do not need to clone this repository:
+Consumers do not need to clone this repository:
 
 ```bash
 python -m pip install --upgrade ai-dev-workflow
-ai-workflow --help
+```
+
+After installation, start with the built-in guide:
+
+```bash
+ai-workflow guide
+```
+
+Typical first-run flow:
+
+```bash
+cd /path/to/project
 ai-workflow setup
+ai-workflow doctor
 ```
 
+The setup wizard detects the containing Git repository by default, shows the generated plan/configuration, and prints the next required steps after apply. Use `ai-workflow setup --help` for setup options and `ai-workflow guide` at any time for the end-to-end usage flow.
+
 The GitHub repository may remain private because normal consumers install the built distribution from PyPI rather than cloning the source repository.
 
 On another machine, install Python 3.10+ and run the same `pip install ai-dev-workflow` command. Project-specific configuration remains in each consumer repository.
@@ -346,3 +362,26 @@ ai-workflow update
 ```
 
 The first command upgrades the installed CLI package. The second migrates/updates the workflow installation in the current project.
+
+
+## Active work and claims
+
+A selected task is not considered started until its worker/provider acknowledges it:
+
+```text
+ready/queued
+-> reserved
+-> offered
+-> accepted by worker/provider
+-> claim committed
+-> active status
+```
+
+Local agents acknowledge with the registered worker identity (for example through `ai-workflow claim`). Phase completion can be recorded with `ai-workflow complete-phase`, which releases the current claim and reserves an eligible worker for the next role. Automatic review always excludes the implementation worker_id; identity separation is enforced only when the optional strict-review policy is enabled.
+
+
+## Worker credentials and identity
+
+Worker IDs and credentials are separate concepts. Several workers may intentionally use the same credential reference and therefore operate as the same GitHub/ADO actor. This is valid for normal planning, testing, implementation, and runtime work.
+
+The workflow verifies effective actor identity where possible. A distinct credential is not required merely because workers are different. By default, ReviewerAgent only needs a different worker_id from the Implementer. Projects that require stronger separation may enable `reviewer.require_distinct_identity: true`.

{ai_dev_workflow-0.2.0 → ai_dev_workflow-0.3.0}/README.md

@@ -2,7 +2,7 @@
 
 Reusable, provider-neutral workflow for AI-assisted software development.
 
-This repository starts from the workflow proven in the Dragon's Dogma 2 project and keeps Superpowers-style artifacts as first-class inputs: brainstorming, spec, ADR, implementation plan, tests, PR evidence and runtime verification.
+This repository provides a reusable, provider-neutral AI development workflow with first-class brainstorming, spec, ADR, implementation plan, tests, PR evidence and runtime verification artifacts.
 
 ## Default lifecycle
 
@@ -16,7 +16,7 @@ Brainstorm
   -> RED
   -> ImplementerAgent implements
   -> GREEN + regression
-  -> ReviewerAgent (optional/manual by default)
+  -> ReviewerAgent (automatic independent review by default)
   -> Integration
   -> Runtime verification batch when required
   -> Promotion / Done
@@ -27,7 +27,7 @@ Brainstorm
 - `ArchitectAgent`: brainstorm, spec, ADR and acceptance criteria.
 - `TesterAgent`: derives tests from the frozen contract and proves RED before implementation.
 - `ImplementerAgent`: implements without changing the frozen test contract; must reach GREEN and run applicable regression checks.
-- `ReviewerAgent`: optional semantic/architecture reviewer. Disabled/manual by default in v1.
+- `ReviewerAgent`: automatic semantic/architecture reviewer by default; must use a different worker_id from the Implementer. Separate credential/identity is optional.
 - `RuntimeVerifierAgent`: optional, project-specific runtime verification role.
 
 A role is not a model. GPT, Codex, Claude, local models or future providers are replaceable adapters under these contracts.
@@ -38,7 +38,7 @@ A role is not a model. GPT, Codex, Claude, local models or future providers are
 - `Ready` is the commitment/freeze boundary.
 - Test design happens before implementation.
 - Implementer may report a bad test/spec as blocked, but must not rewrite expectations merely to make tests pass.
-- Deterministic CI gates run before optional semantic AI review.
+- Deterministic CI gates run before automatic independent semantic review.
 - Runtime verification is separate from offline/CI verification.
 - Projects consume versioned reusable workflows such as `@v1`; they do not copy the engine.
 
@@ -56,6 +56,8 @@ project tests/runtime rules
 
 Its caller workflow will reference this repository's reusable workflow.
 
+The framework does **not** install its own CI/check workflow into consumer repositories, does not configure required status checks, and does not modify branch protection. Existing consumer-repository build, test, lint, security, approval, and merge policies remain authoritative. The generated `.github/workflows/ai-workflow.yml` is orchestration only.
+
 See:
 - `AGENTS.md`
 - `docs/lifecycle.md`
@@ -264,7 +266,7 @@ Local stdio MCP remains available with `--ado-mcp-mode local`. Supported MCP aut
 
 ## Worker registration
 
-Setup can register local, Codespaces, or cloud workers separately from AI provider configuration.
+Setup can register local, Codespaces, or cloud workers separately from AI provider configuration. Worker IDs are independent from credential identities, so multiple workers may share one credential reference.
 
 Example local hybrid worker:
 
@@ -312,14 +314,28 @@ Use `./bin/ai-workflow update --check` to inspect the configured framework ref,
 
 ## Install from PyPI
 
-Once a release is published to PyPI, consumers do not need to clone this repository:
+Consumers do not need to clone this repository:
 
 ```bash
 python -m pip install --upgrade ai-dev-workflow
-ai-workflow --help
+```
+
+After installation, start with the built-in guide:
+
+```bash
+ai-workflow guide
+```
+
+Typical first-run flow:
+
+```bash
+cd /path/to/project
 ai-workflow setup
+ai-workflow doctor
 ```
 
+The setup wizard detects the containing Git repository by default, shows the generated plan/configuration, and prints the next required steps after apply. Use `ai-workflow setup --help` for setup options and `ai-workflow guide` at any time for the end-to-end usage flow.
+
 The GitHub repository may remain private because normal consumers install the built distribution from PyPI rather than cloning the source repository.
 
 On another machine, install Python 3.10+ and run the same `pip install ai-dev-workflow` command. Project-specific configuration remains in each consumer repository.
@@ -332,3 +348,26 @@ ai-workflow update
 ```
 
 The first command upgrades the installed CLI package. The second migrates/updates the workflow installation in the current project.
+
+
+## Active work and claims
+
+A selected task is not considered started until its worker/provider acknowledges it:
+
+```text
+ready/queued
+-> reserved
+-> offered
+-> accepted by worker/provider
+-> claim committed
+-> active status
+```
+
+Local agents acknowledge with the registered worker identity (for example through `ai-workflow claim`). Phase completion can be recorded with `ai-workflow complete-phase`, which releases the current claim and reserves an eligible worker for the next role. Automatic review always excludes the implementation worker_id; identity separation is enforced only when the optional strict-review policy is enabled.
+
+
+## Worker credentials and identity
+
+Worker IDs and credentials are separate concepts. Several workers may intentionally use the same credential reference and therefore operate as the same GitHub/ADO actor. This is valid for normal planning, testing, implementation, and runtime work.
+
+The workflow verifies effective actor identity where possible. A distinct credential is not required merely because workers are different. By default, ReviewerAgent only needs a different worker_id from the Implementer. Projects that require stronger separation may enable `reviewer.require_distinct_identity: true`.

{ai_dev_workflow-0.2.0 → ai_dev_workflow-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-dev-workflow"
-version = "0.2.0"
+version = "0.3.0"
 description = "Provider-neutral AI-assisted development workflow and CLI"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -31,6 +31,10 @@ ai-workflow = "ai_workflow_cli:main"
 package-dir = {"" = "tools"}
 py-modules = [
   "ado_mcp",
+  "workflow_handoff",
+  "workflow_runtime",
+  "work_claim",
+  "active_work_context",
   "ado_provider",
   "ai_provider",
   "ai_workflow_cli",
@@ -43,7 +47,10 @@ py-modules = [
   "setup_context",
   "setup_wizard",
   "source_connection",
+  "skill_registry",
+  "work_breakdown",
   "work_item_provider",
   "work_item_registry",
+  "worker_identity",
   "worker_registry",
 ]

ai_dev_workflow-0.3.0/tests/test_active_work_context.py

@@ -0,0 +1,48 @@
+import sys, unittest
+from pathlib import Path
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tools"))
+
+from active_work_context import (
+    build_active_work_context, validate_context, role_for_phase,
+    queued_status_for_phase, active_status_for_phase,
+)
+
+
+class Tests(unittest.TestCase):
+    def test_context_binds_worker_issue_phase_and_role(self):
+        worker={
+            "worker_id":"local-1","provider":"chatgpt","environment":"local",
+            "roles":["TesterAgent","ImplementerAgent"],
+            "identity":{"github":{"actor":"devuser"}},
+        }
+        ctx=build_active_work_context(
+            worker=worker,
+            phase="test-design",
+            github_issue={"repository":"o/r","number":85,"url":"https://example/85"},
+            ado_work_item={"id":1234},
+            epic={"id":1200},
+            session_id="session-1",
+            claim={"state":"reserved","dispatch_id":"d1"},
+        )
+        self.assertEqual(ctx["required_role"],"TesterAgent")
+        self.assertEqual(ctx["queued_status"],"ready")
+        self.assertEqual(ctx["active_status"],"in-progress")
+        self.assertEqual(ctx["ado_work_item"]["id"],1234)
+        self.assertEqual(validate_context(ctx),[])
+
+    def test_worker_must_support_phase_role(self):
+        with self.assertRaisesRegex(ValueError,"does not support"):
+            build_active_work_context(
+                worker={"worker_id":"w","roles":["ImplementerAgent"]},
+                phase="code-review",
+                github_issue={"repository":"o/r","number":1},
+            )
+
+    def test_phase_maps(self):
+        self.assertEqual(role_for_phase("implementing"),"ImplementerAgent")
+        self.assertEqual(queued_status_for_phase("code-review"),"in-review")
+        self.assertEqual(active_status_for_phase("runtime-verify"),"runtime-pending")
+        self.assertIsNone(role_for_phase("done"))
+
+
+if __name__=="__main__": unittest.main()

{ai_dev_workflow-0.2.0 → ai_dev_workflow-0.3.0}/tests/test_ai_workflow_cli.py

@@ -1,7 +1,9 @@
-import sys, unittest
+import io, sys, unittest
 from pathlib import Path
+from contextlib import redirect_stdout
+from unittest.mock import patch
 sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tools"))
-from ai_workflow_cli import build_ado_config, doctor, parse_role_provider, parse_ado_field_mapping, PACKAGE_VERSION
+from ai_workflow_cli import build_ado_config, doctor, parse_role_provider, parse_ado_field_mapping, onboarding_guide, setup_next_steps, main, PACKAGE_VERSION
 
 DISCOVERY={
   "organization":"org","project":"proj","project_id":"p","process_id":"proc",
@@ -16,7 +18,32 @@ DISCOVERY={
 
 class Tests(unittest.TestCase):
     def test_package_version(self):
-        self.assertEqual(PACKAGE_VERSION, "0.2.0")
+        self.assertEqual(PACKAGE_VERSION, "0.3.0")
+
+    def test_guide_command_is_exposed_by_cli(self):
+        output=io.StringIO()
+        with patch.object(sys,"argv",["ai-workflow","guide"]), redirect_stdout(output):
+            self.assertEqual(main(),0)
+        text=output.getvalue()
+        self.assertIn("AI Dev Workflow - Getting Started",text)
+        self.assertIn("ai-workflow setup",text)
+
+    def test_onboarding_guide_covers_install_setup_claim_handoff_and_update(self):
+        text=onboarding_guide()
+        self.assertIn("ai-workflow setup",text)
+        self.assertIn("ai-workflow doctor",text)
+        self.assertIn("ai-workflow claim",text)
+        self.assertIn("ai-workflow complete-phase",text)
+        self.assertIn("ai-workflow update --check",text)
+        self.assertIn("Local worker credentials stay on the local machine",text)
+
+    def test_setup_next_steps_distinguishes_plan_only_and_applied_setup(self):
+        planned=setup_next_steps(plan_only=True)
+        applied=setup_next_steps()
+        self.assertIn("Re-run ai-workflow setup without --plan-only",planned)
+        self.assertIn("Setup completed.",applied)
+        self.assertIn("ai-workflow doctor",applied)
+        self.assertIn("ai-workflow guide",applied)
 
     def test_init_generates_explicit_mapping_and_agents(self):
         cfg=build_ado_config(DISCOVERY)

ai_dev_workflow-0.3.0/tests/test_codex_cloud_executor.py

@@ -0,0 +1,206 @@
+"""Tests for the Codex Cloud GitHub executor."""
+import sys
+import unittest
+from pathlib import Path
+
+sys.path.insert(
+    0,
+    str(
+        Path(__file__).resolve().parents[1]
+        / '.github'
+        / 'actions'
+        / 'codex-cloud-executor'
+    ),
+)
+from codex_cloud_executor import (
+    MARKER,
+    DeliveryError,
+    GitHubAPIError,
+    deliver,
+    prompt,
+)
+
+
+def payload():
+    return {
+        'issue_number': 42,
+        'dispatch_id': 'dispatch-42',
+        'suggested_branch': 'issue-42-example',
+        'base_branch': 'integration',
+        'execution_type': 'implementation',
+        'workflow_phase': 'implementing',
+        'required_role': 'ImplementerAgent',
+    }
+
+
+class FakeGitHub:
+    def __init__(self):
+        self.prs = {}
+        self.notes = {}
+        self.created_refs = 0
+        self.deleted_refs = 0
+        self.created_prs = 0
+        self.branch_exists = False
+        self.permissions = {'push': True}
+        self.fail_create_pr = None
+        self.fail_comment = None
+        self.create_ref_conflict = False
+
+    def repository_info(self):
+        return {'permissions': dict(self.permissions)}
+
+    def find_pr(self, branch):
+        return self.prs.get(branch)
+
+    def get_ref(self, branch):
+        if branch == 'integration':
+            return {'object': {'sha': 'base-sha'}}
+        if branch == 'issue-42-example' and self.branch_exists:
+            return {'object': {'sha': 'bootstrap-sha'}}
+        raise GitHubAPIError(404, 'GET', f'/git/ref/heads/{branch}', 'Not Found')
+
+    def create_commit_from(self, base_sha, message):
+        return {'sha': 'bootstrap-sha'}
+
+    def create_ref(self, branch, sha):
+        if self.create_ref_conflict:
+            self.branch_exists = True
+            raise GitHubAPIError(
+                422, 'POST', '/git/refs', 'Reference already exists'
+            )
+        self.created_refs += 1
+        self.branch_exists = True
+        return {'ref': f'refs/heads/{branch}'}
+
+    def delete_ref(self, branch):
+        self.deleted_refs += 1
+        self.branch_exists = False
+        return {}
+
+    def create_pr(self, title, body, head, base):
+        if self.fail_create_pr:
+            status = self.fail_create_pr
+            raise GitHubAPIError(
+                status,
+                'POST',
+                '/pulls',
+                'Resource not accessible by integration',
+            )
+        self.created_prs += 1
+        pr = {'number': 7, 'head': {'ref': head}, 'base': {'ref': base}}
+        self.prs[head] = pr
+        return pr
+
+    def comments(self, number):
+        return list(self.notes.get(number, []))
+
+    def comment(self, number, body):
+        if self.fail_comment:
+            status = self.fail_comment
+            raise GitHubAPIError(
+                status,
+                'POST',
+                f'/issues/{number}/comments',
+                'Resource not accessible by integration',
+            )
+        self.notes.setdefault(number, []).append({'body': body})
+        return {'body': body}
+
+
+class CodexCloudExecutorTests(unittest.TestCase):
+    def test_prompt_contains_codex_trigger_and_frozen_contract_rules(self):
+        text = prompt(payload())
+        self.assertIn('@codex Implement Issue #42', text)
+        self.assertIn('AGENTS.md', text)
+        self.assertIn('TDD', text)
+        self.assertIn('Do not merge', text)
+        self.assertIn('dispatch-42', text)
+        self.assertIn(MARKER, text)
+
+    def test_tester_prompt_stays_in_test_design_role(self):
+        p = payload()
+        p["workflow_phase"] = "test-design"
+        p["required_role"] = "TesterAgent"
+        text = prompt(p)
+        self.assertIn("@codex Design tests for Issue #42", text)
+        self.assertIn("Act as TesterAgent", text)
+        self.assertIn("prove the expected RED", text)
+        self.assertIn("Do not implement production behavior", text)
+
+    def test_delivery_is_idempotent_for_same_dispatch(self):
+        api = FakeGitHub()
+        first = deliver(api, payload())
+        second = deliver(api, payload())
+        self.assertEqual(first['number'], second['number'])
+        self.assertEqual(api.created_refs, 1)
+        self.assertEqual(api.created_prs, 1)
+        self.assertEqual(len(api.notes[7]), 1)
+
+    def test_existing_pr_gets_only_missing_codex_comment(self):
+        api = FakeGitHub()
+        api.prs['issue-42-example'] = {'number': 9}
+        deliver(api, payload())
+        self.assertEqual(api.created_refs, 0)
+        self.assertEqual(api.created_prs, 0)
+        self.assertEqual(len(api.notes[9]), 1)
+
+    def test_preflight_denies_missing_contents_write_before_artifacts(self):
+        api = FakeGitHub()
+        api.permissions['push'] = False
+        with self.assertRaises(DeliveryError) as caught:
+            deliver(api, payload())
+        self.assertEqual(caught.exception.code, 'github-contents-write-required')
+        self.assertEqual(api.created_refs, 0)
+        self.assertEqual(api.created_prs, 0)
+
+    def test_pr_create_403_deletes_branch_created_by_this_attempt(self):
+        api = FakeGitHub()
+        api.fail_create_pr = 403
+        with self.assertRaises(DeliveryError) as caught:
+            deliver(api, payload())
+        error = caught.exception
+        self.assertEqual(error.code, 'github-pr-create-denied')
+        self.assertEqual(error.status, 403)
+        self.assertIn('pull-request write permission', str(error))
+        self.assertEqual(error.recovery, 'new-bootstrap-branch-deleted')
+        self.assertEqual(api.created_refs, 1)
+        self.assertEqual(api.deleted_refs, 1)
+        self.assertFalse(api.branch_exists)
+        self.assertEqual(api.created_prs, 0)
+
+    def test_existing_orphan_branch_is_reused_after_previous_partial_attempt(self):
+        api = FakeGitHub()
+        api.create_ref_conflict = True
+        api.branch_exists = True
+        pr = deliver(api, payload())
+        self.assertEqual(pr['number'], 7)
+        self.assertEqual(api.created_refs, 0)
+        self.assertEqual(api.deleted_refs, 0)
+        self.assertEqual(api.created_prs, 1)
+        self.assertEqual(len(api.notes[7]), 1)
+
+    def test_comment_403_preserves_pr_and_retry_adds_one_trigger(self):
+        api = FakeGitHub()
+        api.fail_comment = 403
+        with self.assertRaises(DeliveryError) as caught:
+            deliver(api, payload())
+        error = caught.exception
+        self.assertEqual(error.code, 'github-codex-trigger-comment-denied')
+        self.assertEqual(
+            error.recovery, 'keep-existing-pr-and-retry-comment'
+        )
+        self.assertEqual(api.created_refs, 1)
+        self.assertEqual(api.created_prs, 1)
+        self.assertEqual(api.deleted_refs, 0)
+        self.assertIn('issue-42-example', api.prs)
+
+        api.fail_comment = None
+        retry = deliver(api, payload())
+        self.assertEqual(retry['number'], 7)
+        self.assertEqual(api.created_refs, 1)
+        self.assertEqual(api.created_prs, 1)
+        self.assertEqual(len(api.notes[7]), 1)
+
+
+if __name__ == '__main__':
+    unittest.main()

{ai_dev_workflow-0.2.0 → ai_dev_workflow-0.3.0}/tests/test_composite_work_item.py

@@ -2,7 +2,7 @@ import sys, unittest
 from pathlib import Path
 sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tools"))
 
-from composite_work_item import build_composite_config, sync_projection
+from composite_work_item import build_composite_config, sync_projection, sync_active_work_context
 from ado_provider import validate_field_mapping, defaults_for_wit, execution_field_updates
 
 DISCOVERY={
@@ -64,6 +64,34 @@ class Tests(unittest.TestCase):
         self.assertEqual(projected["fields"]["Custom.AIPhase"],"code-review")
         self.assertEqual(projected["fields"]["Custom.GitHubIssue"],"o/r#7")
 
+    def test_active_work_context_projects_worker_role_and_issue(self):
+        mapping={
+            "Custom.UserStory":{
+                "workflow_phase":{"field":"Custom.AIPhase"},
+                "github_issue":{"field":"Custom.GitHubIssue"},
+                "worker":{"field":"Custom.Worker"},
+                "agent_role":{"field":"Custom.AgentRole"},
+            }
+        }
+        cfg=build_composite_config(
+            ado={},github={},field_mapping=mapping
+        )
+        ctx={
+            "phase":"implementing",
+            "required_role":"ImplementerAgent",
+            "worker":{"worker_id":"local-1"},
+            "github_issue":{"repository":"o/r","number":85},
+        }
+        projected=sync_active_work_context(
+            cfg,wit_ref="Custom.UserStory",context=ctx,
+            values={"pull_request":"o/r#91"},
+        )
+        self.assertEqual(projected["state"],"Active")
+        self.assertEqual(projected["fields"]["Custom.AIPhase"],"implementing")
+        self.assertEqual(projected["fields"]["Custom.GitHubIssue"],"o/r#85")
+        self.assertEqual(projected["fields"]["Custom.Worker"],"local-1")
+        self.assertEqual(projected["fields"]["Custom.AgentRole"],"ImplementerAgent")
+
     def test_done_projects_to_done(self):
         cfg=build_composite_config(
             ado={},github={},field_mapping=MAPPING

{ai_dev_workflow-0.2.0 → ai_dev_workflow-0.3.0}/tests/test_connection_and_mcp.py

@@ -3,7 +3,7 @@ from pathlib import Path
 from unittest.mock import patch, Mock
 sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tools"))
 
-from source_connection import resolve_github_token
+from source_connection import resolve_github_token, parse_github_repository, detect_repository_context
 from work_item_registry import validate_work_item_provider
 from ado_mcp import build_ado_mcp, ado_mcp_credentials
 from setup_wizard import build_setup_plan
@@ -19,13 +19,33 @@ class Tests(unittest.TestCase):
             if old is None: os.environ.pop("GH_TOKEN",None)
             else: os.environ["GH_TOKEN"]=old
 
-    @patch("source_connection.subprocess.run")
+    @patch("source_connection._run", return_value="oauth-token")
     def test_github_cli_oauth_session(self, run):
-        run.return_value=Mock(stdout="oauth-token\n")
         token, meta=resolve_github_token("gh-cli")
         self.assertEqual(token,"oauth-token")
         self.assertEqual(meta["type"],"gh-cli-oauth")
-        run.assert_called_once()
+        run.assert_called_once_with(["gh","auth","token"])
+
+    def test_parse_github_repository_remote_formats(self):
+        self.assertEqual(parse_github_repository("git@github.com:owner/repo.git"), "owner/repo")
+        self.assertEqual(parse_github_repository("https://github.com/owner/repo.git"), "owner/repo")
+        self.assertIsNone(parse_github_repository("https://gitlab.com/owner/repo.git"))
+
+    @patch("source_connection._run")
+    def test_detect_repository_context_uses_git_root_and_origin(self, run):
+        run.side_effect = ["/work/repo", "git@github.com:owner/repo.git"]
+        out = detect_repository_context("/work/repo/subdir")
+        self.assertEqual(out["root"], "/work/repo")
+        self.assertEqual(out["github_repository"], "owner/repo")
+
+    @patch("source_connection._run", return_value="oauth-token")
+    @patch("source_connection.subprocess.run")
+    def test_github_browser_auth_returns_non_persisted_cli_session(self, subprocess_run, run):
+        token, meta = resolve_github_token("gh-browser")
+        self.assertEqual(token, "oauth-token")
+        self.assertEqual(meta["type"], "gh-cli-oauth")
+        self.assertEqual(meta["login"], "browser")
+        subprocess_run.assert_called_once_with(["gh", "auth", "login", "--web"], check=True)
 
     def test_work_item_provider_registry(self):
         self.assertEqual(validate_work_item_provider("github-issues"),[])

{ai_dev_workflow-0.2.0 → ai_dev_workflow-0.3.0}/tests/test_general_init.py

@@ -48,6 +48,11 @@ class Tests(unittest.TestCase):
                 self.assertTrue(Path("CURRENT.md").exists())
                 self.assertTrue(Path(".devcontainer/devcontainer.json").exists())
                 self.assertTrue(Path(".github/workflows/ai-workflow.yml").exists())
+                self.assertFalse(Path(".github/workflows/queue-dispatcher-checks.yml").exists())
+                self.assertFalse(Path(".github/workflows/framework-checks.yml").exists())
+                generated_workflow=Path(".github/workflows/ai-workflow.yml").read_text(encoding="utf-8")
+                self.assertNotIn("Framework Queue Dispatcher Checks",generated_workflow)
+                self.assertNotIn("required-check",generated_workflow)
                 Path("AGENTS.md").write_text("custom",encoding="utf-8")
                 perform_init(args)
                 self.assertEqual(Path("AGENTS.md").read_text(encoding="utf-8"),"custom")