agentic-devtools 0.2.148__tar.gz → 0.2.150__tar.gz

{agentic_devtools-0.2.148 → agentic_devtools-0.2.150}/.github/workflows/README.md

@@ -113,30 +113,27 @@ Reviews with this marker from trusted users (`acmarsnik`) are recognized by
 
 ### speckit-issue-trigger.yml
 
-**SpecKit Issue to Specification Automation (Phase 1 — Specify)**
+**SpecKit Issue Trigger — Thin Dispatcher (Phase 1)**
 
 - Runs on:
   - Issues labeled event (when `speckit` or configured label is added)
   - Manual workflow dispatch
-- Purpose: Generates the initial feature specification (`spec.md`) from a GitHub issue — Phase 1 of the SpecKit per-phase pipeline
-- Outputs: Creates Phase 1 branch (`speckit/<issue>/phase-1-specify`), spec file, and pull request labeled `speckit:phase-1`
-- Scripts: Uses helper scripts in `.github/scripts/speckit-trigger/`
-- **Sequence Diagram**: See
-  [Workflow Sequence Diagram](../../specs/002-github-action-speckit-trigger/workflow-sequence-diagram.md)
-  for the original workflow design
-  (note: the diagram predates the per-phase PR progression and may not reflect the current split pipeline)
+- Purpose: Dispatches Phase 1 (Specify) to the unified `speckit-phase-progression.yml` workflow via `workflow_dispatch` with `phase=1`
+- Does NOT perform generation, commit, or PR creation directly — delegates all logic to the progression workflow
+- Retains per-issue concurrency group, processing label management, and failure handling
 
 ### speckit-phase-progression.yml
 
-**SpecKit Phase Progression (Phases 2–5)**
+**SpecKit Phase Progression (Phases 1–5)**
 
 - Runs on:
   - Pull request closed (merged) events with `speckit:phase-N` labels
   - Manual `workflow_dispatch` with inputs:
     - `issue_number` (required): The GitHub issue number to progress
-    - `phase` (required): The phase to generate (2–5)
-- Purpose: Automatically progresses the SpecKit pipeline when a phase PR is merged.
-  Generates the next phase's artifacts and creates a new PR.
+    - `phase` (required): The phase to generate (1–5)
+- Purpose: Unified workflow that handles all SpecKit pipeline phases.
+  Generates phase artifacts and creates PRs using human-identity tokens
+  (`SPECKIT_PR_TOKEN` or `COPILOT_GITHUB_TOKEN`).
   The `workflow_dispatch` trigger allows operators to recover or retry phases
   when the merge trigger fails or a PR is missing the `speckit:phase-N` label.
 - Phase flow: specify → clarify → plan → tasks → analyze

{agentic_devtools-0.2.148 → agentic_devtools-0.2.150}/.github/workflows/speckit-issue-trigger.yml

@@ -5,26 +5,21 @@ on:
     types: [labeled]
   workflow_dispatch: { inputs: { issue_number: { description: 'Issue number to process (for manual testing)', required: true, type: number } } }
 
-permissions: { contents: write, issues: write, pull-requests: write }
-
-env:
-  AGDT_USE_PYTHON_ORCHESTRATOR: "1"
+permissions: { actions: write, issues: write }
 
 concurrency:
   group: speckit-trigger-${{ github.event.issue.number || inputs.issue_number }}
   cancel-in-progress: false
 
 jobs:
-  speckit-trigger:
+  dispatch-phase-1:
     runs-on: ubuntu-latest
-    timeout-minutes: 30
+    timeout-minutes: 5
     if: >-
       github.event_name == 'workflow_dispatch' ||
       github.event.label.name == vars.SPECKIT_TRIGGER_LABEL ||
       github.event.label.name == 'speckit'
     steps:
-      - uses: actions/checkout@v4
-        with: { fetch-depth: 0 }
       - name: Add Processing Label
         uses: actions/github-script@v7
         with:
@@ -36,86 +31,25 @@ jobs:
             }
             try { await github.rest.issues.addLabels({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issueNumber, labels: ['speckit:processing'] }); }
             catch (error) { core.warning(`Failed to add speckit:processing label to issue #${issueNumber}: ${error.message}`); }
-      - uses: actions/setup-python@v5
-        with: { python-version: '3.12' }
-      - run: |
-          python -m pip install --upgrade pip
-          python -m pip install github-copilot-sdk
-          python -m pip install . --no-deps
-      - id: generate
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
-          SPECKIT_TRIGGER_LABEL: ${{ vars.SPECKIT_TRIGGER_LABEL || 'speckit' }}
-        run: agdt-speckit-trigger
-      - name: Add ai-auto-merge-allowed label to Phase 1 PR
-        if: success() && vars.SPECKIT_AUTO_MERGE_ALLOWED_LABEL == 'true'
-        env:
-          ISSUE_NUMBER: ${{ github.event.issue.number || inputs.issue_number }}
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const issueNumber = Number(process.env.ISSUE_NUMBER);
-            if (!Number.isInteger(issueNumber) || issueNumber <= 0) {
-              core.warning('Could not determine issue number for speckit phase-1 PR lookup');
-              return;
-            }
 
-            try {
-              const query = `repo:${context.repo.owner}/${context.repo.repo} is:pr is:open head:speckit/${issueNumber}/phase-1-specify`;
-              const search = await github.rest.search.issuesAndPullRequests({
-                q: query,
-                per_page: 1,
-              });
-              const speckit1Pr = search.data.items?.[0];
-              if (!speckit1Pr) {
-                core.warning(`Could not find speckit phase-1 PR for issue #${issueNumber} to label`);
-                return;
-              }
-              await github.rest.issues.addLabels({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: speckit1Pr.number,
-                labels: ['ai-auto-merge-allowed'],
-              });
-              core.info(`Added ai-auto-merge-allowed to PR #${speckit1Pr.number}`);
-            } catch (e) {
-              core.warning(`Could not add ai-auto-merge-allowed label: ${e.message}`);
-            }
-
-      - name: Agent Fallback on Structural Failure
-        id: agent-fallback
-        if: failure()
-        uses: actions/github-script@v7
+      - name: Dispatch Phase Progression
         env:
-          WORKSPACE_FILE: ${{ github.workspace }}/validation-errors.json
-          ISSUE_NUMBER_ENV: ${{ github.event.issue.number || inputs.issue_number || '0' }}
-          ISSUE_TITLE_ENV: ${{ github.event.issue.title || '' }}
-          ISSUE_BODY_ENV: ${{ github.event.issue.body || '' }}
-          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
-          SPECKIT_AGENT_FALLBACK: ${{ vars.SPECKIT_AGENT_FALLBACK || '' }}
-          SPECKIT_REFERENCE_SPEC_PATH: ${{ vars.SPECKIT_REFERENCE_SPEC_PATH || '' }}
-          SPECKIT_COMMENT_ON_ISSUE: ${{ vars.SPECKIT_COMMENT_ON_ISSUE || '' }}
-        with:
-          script: |
-            const fallback = require('./.github/scripts/speckit-trigger/agent-fallback.js');
-            await fallback.run({
-              github,
-              context,
-              core,
-              phase: 1,
-              validationErrors: '',
-              workspaceFile: process.env.WORKSPACE_FILE,
-              issueNumber: Number(process.env.ISSUE_NUMBER_ENV) || 0,
-              issueTitle: process.env.ISSUE_TITLE_ENV,
-              issueBody: process.env.ISSUE_BODY_ENV,
-              token: process.env.COPILOT_GITHUB_TOKEN,
-              killSwitch: process.env.SPECKIT_AGENT_FALLBACK,
-              referenceSpecPath: process.env.SPECKIT_REFERENCE_SPEC_PATH,
-            });
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          ISSUE_NUMBER="${{ github.event.issue.number || inputs.issue_number }}"
+          if [[ -z "$ISSUE_NUMBER" || "$ISSUE_NUMBER" == "0" ]]; then
+            echo "::error::Could not determine issue number"
+            exit 1
+          fi
+          gh api \
+            --method POST \
+            "/repos/${{ github.repository }}/actions/workflows/speckit-phase-progression.yml/dispatches" \
+            -f ref=main \
+            -f "inputs[issue_number]=$ISSUE_NUMBER" \
+            -f "inputs[phase]=1"
 
       - name: Handle Failure (Comment + Label)
-        if: failure() && steps['agent-fallback'].outputs.handled != 'true'
+        if: failure()
         uses: actions/github-script@v7
         env:
           ISSUE_NUMBER_INPUT: ${{ inputs.issue_number || '' }}
@@ -127,20 +61,20 @@ jobs:
             if (!issueNumber) return;
             const triggerLabel = process.env.TRIGGER_LABEL || 'speckit';
             const retriggerLabelInstructions = triggerLabel === 'speckit'
-              ? `3. You can re-trigger by removing the \`speckit:failed\` label and re-adding the \`speckit\` label, or use the **workflow_dispatch** trigger on the [SpecKit Issue Trigger workflow](https://github.com/${context.repo.owner}/${context.repo.repo}/actions/workflows/speckit-issue-trigger.yml)`
-              : `3. You can re-trigger by removing the \`speckit:failed\` label and re-adding the \`${triggerLabel}\` label (legacy: \`speckit\`), or use the **workflow_dispatch** trigger on the [SpecKit Issue Trigger workflow](https://github.com/${context.repo.owner}/${context.repo.repo}/actions/workflows/speckit-issue-trigger.yml)`;
+              ? `3. You can re-trigger by removing the \`speckit:failed\` label and re-adding the \`speckit\` label, or use the **workflow_dispatch** trigger on the [SpecKit Phase Progression workflow](https://github.com/${context.repo.owner}/${context.repo.repo}/actions/workflows/speckit-phase-progression.yml)`
+              : `3. You can re-trigger by removing the \`speckit:failed\` label and re-adding the \`${triggerLabel}\` label (legacy: \`speckit\`), or use the **workflow_dispatch** trigger on the [SpecKit Phase Progression workflow](https://github.com/${context.repo.owner}/${context.repo.repo}/actions/workflows/speckit-phase-progression.yml)`;
 
             const body = [
               '## ❌ SpecKit: Trigger Failed',
               '',
-              'An error occurred while running the SpecKit trigger workflow.',
+              'An error occurred while dispatching the SpecKit Phase 1 workflow.',
               '',
               `**Workflow Run**: [View logs](https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId})`,
               '',
               '### Troubleshooting',
               '',
               '1. Check the workflow logs for detailed error messages',
-              '2. Verify that the COPILOT_GITHUB_TOKEN secret is configured with repo permissions',
+              '2. Verify that the workflow has `permissions: actions: write`, that Actions are enabled in repository settings, and that the target workflow file name/path is correct',
               retriggerLabelInstructions,
               '',
               '---',

{agentic_devtools-0.2.148 → agentic_devtools-0.2.150}/.github/workflows/speckit-phase-progression.yml

@@ -10,10 +10,11 @@ on:
         required: true
         type: number
       phase:
-        description: 'The phase to generate (2-5)'
+        description: 'The phase to generate (1-5)'
         required: true
         type: choice
         options:
+          - '1'
           - '2'
           - '3'
           - '4'
@@ -264,7 +265,7 @@ jobs:
               }
             }
 
-      # For phases 2-5, proceed with generating next phase artifacts
+      # For phases 1-5, proceed with generating phase artifacts
       - name: Checkout Repository (Post-Merge Main)
         if: steps.extract.outcome == 'success' && steps.extract.outputs.next_phase != '6' && steps.extract.outputs.next_phase != '0'
         uses: actions/checkout@v4
@@ -455,13 +456,20 @@ jobs:
         if: steps.extract.outcome == 'success' && steps.extract.outputs.next_phase != '6' && steps.extract.outputs.next_phase != '0' && steps.idempotency.outputs.skipped != 'true'
         env:
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+          SPECKIT_PR_TOKEN: ${{ secrets.SPECKIT_PR_TOKEN }}
         run: |
           if [[ -z "$COPILOT_GITHUB_TOKEN" ]]; then
-            echo "::error::COPILOT_GITHUB_TOKEN secret is not set. This PAT is required for Copilot SDK authentication and PR creation. Configure the COPILOT_GITHUB_TOKEN secret with a PAT that has Copilot API access and repo permissions."
+            echo "::error::COPILOT_GITHUB_TOKEN secret is not set. This PAT is required for Copilot SDK authentication. For PR creation, SPECKIT_PR_TOKEN is preferred and COPILOT_GITHUB_TOKEN is the fallback. Configure COPILOT_GITHUB_TOKEN with a PAT that has Copilot API access and repo permissions."
             exit 1
           fi
           echo "✓ COPILOT_GITHUB_TOKEN is set"
 
+          if [[ -n "$SPECKIT_PR_TOKEN" ]]; then
+            echo "✓ SPECKIT_PR_TOKEN is set (will be used for PR creation)"
+          else
+            echo "✓ SPECKIT_PR_TOKEN is not set; COPILOT_GITHUB_TOKEN will be used for PR creation"
+          fi
+
       - name: Set up Python
         if: steps.extract.outcome == 'success' && steps.extract.outputs.next_phase != '6' && steps.extract.outputs.next_phase != '0' && steps.idempotency.outputs.skipped != 'true'
         uses: actions/setup-python@v5

{agentic_devtools-0.2.148 → agentic_devtools-0.2.150}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-devtools
-Version: 0.2.148
+Version: 0.2.150
 Summary: Agentic devtools integrate Jira, DevOps & more
 Author: ayaiayorg
 License-Expression: MIT

{agentic_devtools-0.2.148 → agentic_devtools-0.2.150}/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.148'
-__version_tuple__ = version_tuple = (0, 2, 148)
+__version__ = version = '0.2.150'
+__version_tuple__ = version_tuple = (0, 2, 150)
 
 __commit_id__ = commit_id = None

agentic_devtools-0.2.150/agentic_devtools/cli/ci/commands.py

@@ -0,0 +1,127 @@
+"""CLI entry points for CI orchestration commands.
+
+Provides ``agdt-ai-pr-loop`` and ``agdt-speckit-trigger`` commands
+that read event data from environment variables and invoke the
+appropriate orchestrator functions.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import os
+import shutil
+import sys
+
+from agentic_devtools.cli.ci.exceptions import MalformedEventError
+from agentic_devtools.cli.ci.github_provider import GitHubActionsProvider
+from agentic_devtools.cli.ci.guards import check_edit_relevance
+from agentic_devtools.cli.ci.logging_config import setup_logging
+from agentic_devtools.cli.ci.orchestrator import run_ai_pr_loop
+from agentic_devtools.cli.ci.pipeline.command import run_ai_pr_loop_v2
+from agentic_devtools.cli.ci.speckit_trigger import DEPRECATION_MESSAGE
+
+
+def _python_orchestrator_enabled() -> bool:
+    """Return True when the Python CI orchestrator path is enabled."""
+    return os.environ.get("AGDT_USE_PYTHON_ORCHESTRATOR", "").lower() in ("1", "true")
+
+
+def _pipeline_v2_enabled() -> bool:
+    """Return True when the idempotent pipeline v2 is enabled."""
+    return os.environ.get("AGDT_USE_PIPELINE_V2", "").lower() in ("1", "true")
+
+
+def ai_pr_loop_command() -> None:
+    """CLI entry point for the AI PR loop orchestrator.
+
+    Reads event data from ``GITHUB_EVENT_PATH`` and ``GITHUB_EVENT_NAME``
+    environment variables, constructs a GitHub Actions provider, and
+    invokes the appropriate orchestrator or pipeline.
+
+    Routing is controlled by two feature flags, evaluated in order:
+
+    1. ``AGDT_USE_PYTHON_ORCHESTRATOR`` must be ``"1"`` or ``"true"`` to
+       activate any Python-side processing.  When absent/false the function
+       exits with code 0 so the legacy YAML path handles the run.
+
+    2. ``AGDT_USE_PIPELINE_V2`` (requires flag 1 to be set): when ``"1"``
+       or ``"true"``, routes to the idempotent action-evaluator pipeline
+       (``run_ai_pr_loop_v2``).  Otherwise routes to the event-branching
+       orchestrator (``run_ai_pr_loop``).
+
+    Exit codes:
+        0: Success or deferred to legacy path
+        1: Guard blocked
+        2: Malformed event
+        3: Merge blocked
+        4: Metadata resolution failed
+        5: Repair dispatched
+        10: Missing dependency or configuration
+    """
+    # Feature flag check
+    if not _python_orchestrator_enabled():
+        # Legacy path — let the YAML handle it
+        sys.exit(0)
+
+    setup_logging()
+
+    # Check gh CLI dependency
+    if shutil.which("gh") is None:
+        print("Error: 'gh' CLI not found on PATH. Install GitHub CLI to use agdt-ai-pr-loop.", file=sys.stderr)
+        sys.exit(10)
+
+    # Read event data
+    event_path = os.environ.get("GITHUB_EVENT_PATH", "")
+    event_name = os.environ.get("GITHUB_EVENT_NAME", "")
+
+    if not event_path or not event_name:
+        print("Error: GITHUB_EVENT_PATH and GITHUB_EVENT_NAME must be set.", file=sys.stderr)
+        sys.exit(10)
+
+    try:
+        with open(event_path, encoding="utf-8") as f:
+            raw_payload = json.load(f)
+    except (OSError, json.JSONDecodeError) as exc:
+        print(f"Error: Failed to read event payload: {exc}", file=sys.stderr)
+        sys.exit(10)
+
+    # Determine repository
+    repo = os.environ.get("GITHUB_REPOSITORY", "")
+
+    # Create provider and run orchestrator
+    provider = GitHubActionsProvider(repo=repo)
+
+    try:
+        event_payload = provider.parse_event(raw_payload, event_name)
+    except MalformedEventError as exc:
+        json.dump({"error": "malformed_event", "event_name": exc.event_name, "reason": exc.reason}, sys.stderr)
+        sys.stderr.write("\n")
+        sys.exit(2)
+
+    # Edit-relevance preflight — skip body-only edits before orchestrator calls
+    should_skip, skip_reason = check_edit_relevance(event_payload)
+    if should_skip:
+        logger = logging.getLogger(__name__)
+        logger.info("PR #%d: %s", event_payload.pr_number, skip_reason)
+        sys.exit(0)
+
+    if _pipeline_v2_enabled():
+        exit_code = run_ai_pr_loop_v2(provider, event_payload)
+    else:
+        exit_code = run_ai_pr_loop(provider, event_payload)
+    sys.exit(exit_code)
+
+
+def speckit_trigger_command() -> None:
+    """CLI entry point for the SpecKit trigger handler — DEPRECATED.
+
+    This command is deprecated. Phase 1 is now handled by the unified
+    ``speckit-phase-progression.yml`` workflow. The ``speckit-issue-trigger.yml``
+    workflow dispatches to it directly via ``workflow_dispatch``.
+
+    Exit codes:
+        1: Always exits with 1 to indicate deprecation
+    """
+    print(f"Error: {DEPRECATION_MESSAGE}", file=sys.stderr)
+    sys.exit(1)