claude-dev-env 1.93.0 → 1.94.0

package/skills/logifix/CLAUDE.md

@@ -1,36 +0,0 @@
-# logifix skill
-
-Restores the Logitech Gaming Software (LCore) tray icon when it disappears on Windows. Runs a PowerShell script that reproduces the verified recovery procedure.
-
-**Trigger:** `/logifix`, "logitech tray icon missing", "LCore tray gone", "logitech is not loaded".
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `SKILL.md` | Full procedure description, invocation options, fallback steps |
-| `scripts/logifix.ps1` | PowerShell script that runs the recovery procedure |
-
-## Subdirectories
-
-| Directory | Role |
-|---|---|
-| `scripts/` | The PowerShell recovery script |
-
-## What the script does
-
-1. Takes a state snapshot (Explorer instances, Logitech services, LCore process).
-2. Stops LCore in user context.
-3. Runs one elevated UAC step: starts `LogiRegistryService`, stops `explorer.exe`, and lets Windows shell auto-respawn rebuild it (does **not** call `Start-Process explorer` from the elevated block).
-4. Waits for shell auto-respawn (default 5 seconds).
-5. Confirms exactly one Explorer in the user's session.
-6. Runs `LCoreRelaunchAttemptCount` full stop-then-launch cycles of `LCore.exe /minimized` (default 2). Always runs the full count.
-7. Takes a final state snapshot.
-
-## Invocation
-
-```
-/logifix
-```
-
-Optional parameters: `-ExplorerAutoRespawnWaitSeconds`, `-LCoreInitializationWaitSeconds`, `-LCoreRelaunchAttemptCount`.

package/skills/logifix/SKILL.md

@@ -1,69 +0,0 @@
----
-name: logifix
-description: Restore the Logitech Gaming Software (LCore) tray icon when it disappears on Windows. Calls a PowerShell script that reproduces the verified Session 2 recovery procedure from 2026-04-25. Triggers on "logifix", "/logifix", "logitech tray icon missing", "LCore tray gone", "logitech is not loaded".
----
-
-# logifix
-
-## Overview
-
-Restore the Logitech Gaming Software (LCore) tray icon by reproducing the verified recovery procedure documented in `sessions/System Support/2. Logitech Tray Icon Fix Recurrence.md`.
-
-**Announce at start:** "Running /logifix to restore the LCore tray icon."
-
-## What the script does
-
-`scripts/logifix.ps1` runs this sequence (verified during Session 2 on 2026-04-25):
-
-1. **State snapshot.** Explorer instances per session, Logitech services state, LCore process state.
-2. **Stop LCore in user context.** `Stop-Process -Name LCore -Force`.
-3. **Single elevated UAC step:**
-   - `Start-Service -Name LogiRegistryService` (handles the recurrence case where the service is Stopped).
-   - `Stop-Process -Name explorer -Force`.
-   - **Does NOT** call `Start-Process explorer` from inside the elevated block. Windows shell auto-respawn handles the user-session explorer cleanly. Skipping this line is the operative fix discovered in Session 2 — including it created a duplicate admin-context `explorer.exe` (no resolvable owner, parent = the admin pwsh) that blocked LCore tray registration.
-4. **Wait for Windows shell auto-respawn** (default 5 seconds).
-5. **Verify exactly one explorer in the user's session.**
-6. **Perform `LCoreRelaunchAttemptCount` full stop-then-launch cycles of `LCore.exe /minimized`** (default 2). The full count always runs — a responsive LCore on the first attempt does NOT imply the tray icon registered. Per Session 2 gotcha #2, the first relaunch can leave LCore responsive with no tray icon; only a second stop+launch reliably triggers `Shell_NotifyIcon` registration.
-7. **Final state snapshot.**
-
-## Invocation
-
-From Claude Code:
-
-```
-/logifix
-```
-
-Direct PowerShell:
-
-```
-pwsh -File "$HOME\.claude\skills\logifix\scripts\logifix.ps1"
-```
-
-Optional parameters (all have safe defaults):
-
-- `-ExplorerAutoRespawnWaitSeconds <int>` — wait after the elevated kill (default 5).
-- `-LCoreInitializationWaitSeconds <int>` — wait after each LCore relaunch before checking responsiveness (default 5).
-- `-LCoreRelaunchAttemptCount <int>` — number of LCore stop+launch cycles to perform (default 2). Always runs the full count.
-
-## When to use
-
-- LCore tray icon missing (also confirmed absent from the overflow `^` chevron).
-- LCore process is running but the tray icon never appears.
-- After resume from sleep, system restart, or a Logitech service crash that leaves LCore in a half-loaded state.
-
-## Fallback (if the script does not restore the icon)
-
-If `/logifix` reports that UAC was canceled, or LCore is still not responding after both relaunch cycles:
-
-1. **Ctrl+Shift+Esc** → Task Manager.
-2. Find **Windows Explorer** → right-click → **Restart**.
-3. Re-run `/logifix`.
-
-The Task Manager restart path is guaranteed to hit the correct interactive session and elevation context regardless of how the calling shell was launched. In Session 2, elevated calls from Claude Code's PowerShell tool could not be confirmed to reach the user's interactive Session 1 — Task Manager bypasses that ambiguity.
-
-## Source
-
-Procedure verified during Session 2 (Logitech Tray Icon Fix Recurrence), 2026-04-25. The session log lists the verified command set, the gotcha catalog, and the final process/service state.
-
-The "always run the full relaunch count" behavior was added on 2026-04-26 after `/logifix` reported success on the first responsive attempt but the tray icon never appeared — the original early-break optimization conflicted with documented Session 2 gotcha #2 (responsive LCore, no tray icon).

package/skills/logifix/scripts/CLAUDE.md

@@ -1,16 +0,0 @@
-# logifix/scripts
-
-PowerShell recovery script for the `logifix` skill.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `logifix.ps1` | Restores the LCore tray icon: stops LCore, runs one elevated UAC step (starts `LogiRegistryService`, stops explorer, lets Windows auto-respawn), then re-launches LCore a configurable number of times |
-
-## Conventions
-
-- The script accepts three optional parameters: `-ExplorerAutoRespawnWaitSeconds` (default 5), `-LCoreInitializationWaitSeconds` (default 5), `-LCoreRelaunchAttemptCount` (default 2).
-- The full relaunch count always runs — an early-exit on a responsive LCore is intentional behavior per the recovery procedure.
-- The elevated block does **not** call `Start-Process explorer`; Windows shell auto-respawn handles that to avoid a duplicate admin-context Explorer.
-- Run directly as: `pwsh -File "$HOME\.claude\skills\logifix\scripts\logifix.ps1"`.

package/skills/logifix/scripts/logifix.ps1

@@ -1,205 +0,0 @@
-<#
-.SYNOPSIS
-Restores the Logitech Gaming Software (LCore) tray icon when it is missing on Windows.
-
-.DESCRIPTION
-Reproduces the verified recovery procedure from
-sessions/System Support/2. Logitech Tray Icon Fix Recurrence.md (2026-04-25):
-  1. Stops LCore in user context.
-  2. Single elevated UAC step:
-       - Starts LogiRegistryService (handles the case where it is Stopped).
-       - Stops explorer.exe and lets Windows shell auto-respawn rebuild it.
-     Deliberately omits Start-Process explorer from the elevated block to
-     avoid the duplicate admin-context explorer that blocked tray registration
-     during Session 2.
-  3. Waits for shell auto-respawn.
-  4. Verifies a single user-session explorer.
-  5. Performs LCoreRelaunchAttemptCount full stop-then-launch cycles of
-     LCore /minimized. Always runs the full count: a responsive LCore on the
-     first attempt does NOT imply Shell_NotifyIcon registered, per Session 2
-     gotcha #2 (responsive process, no tray icon).
-
-.PARAMETER ExplorerAutoRespawnWaitSeconds
-Seconds to wait after the elevated explorer kill before verifying respawn.
-
-.PARAMETER LCoreInitializationWaitSeconds
-Seconds to wait after each LCore relaunch before checking responsiveness.
-
-.PARAMETER LCoreRelaunchAttemptCount
-Total number of LCore relaunch cycles to perform (default 2). The full count
-always runs, because the documented failure mode is a responsive LCore that
-never registered a tray icon -- only a second stop+launch reliably triggers
-Shell_NotifyIcon registration.
-#>
-
-[CmdletBinding()]
-param(
-    [int] $ExplorerAutoRespawnWaitSeconds = 5,
-    [int] $LCoreInitializationWaitSeconds = 5,
-    [int] $LCoreRelaunchAttemptCount = 2
-)
-
-Set-StrictMode -Version Latest
-$ErrorActionPreference = 'Stop'
-
-$script:LCoreExecutablePath = 'C:\Program Files\Logitech Gaming Software\LCore.exe'
-$script:LCoreProcessName = 'LCore'
-
-function Get-CurrentInteractiveSessionId {
-    [OutputType([int])]
-    param()
-    return (Get-CimInstance Win32_Process -Filter "ProcessId=$PID").SessionId
-}
-
-function Get-ExplorerProcessesInSession {
-    [OutputType([object[]])]
-    param([Parameter(Mandatory)] [int] $TargetSessionId)
-    $allExplorers = Get-CimInstance Win32_Process -Filter "Name='explorer.exe'"
-    $matchingExplorers = @()
-    foreach ($eachExplorer in $allExplorers) {
-        if ($eachExplorer.SessionId -ne $TargetSessionId) { continue }
-        $ownerInfo = Invoke-CimMethod -InputObject $eachExplorer -MethodName GetOwner -ErrorAction SilentlyContinue
-        $matchingExplorers += [PSCustomObject]@{
-            ProcessId    = $eachExplorer.ProcessId
-            SessionId    = $eachExplorer.SessionId
-            OwnerUser    = if ($ownerInfo) { $ownerInfo.User } else { $null }
-            CreationDate = $eachExplorer.CreationDate
-        }
-    }
-    return ,$matchingExplorers
-}
-
-function Stop-LCoreIfRunning {
-    [OutputType([void])]
-    param()
-    $stopSettleMilliseconds = 500
-    Stop-Process -Name $script:LCoreProcessName -Force -ErrorAction SilentlyContinue
-    Start-Sleep -Milliseconds $stopSettleMilliseconds
-}
-
-function Invoke-ElevatedExplorerRebuild {
-    [OutputType([bool])]
-    param()
-    $elevatedScriptBlockText = @'
-Start-Service -Name LogiRegistryService -ErrorAction SilentlyContinue
-Stop-Process -Name explorer -Force -ErrorAction SilentlyContinue
-'@
-    $encodedElevatedCommand = [Convert]::ToBase64String([Text.Encoding]::Unicode.GetBytes($elevatedScriptBlockText))
-    try {
-        Start-Process -FilePath 'pwsh' `
-            -ArgumentList '-NoProfile', '-EncodedCommand', $encodedElevatedCommand `
-            -Verb RunAs `
-            -Wait `
-            -ErrorAction Stop
-        return $true
-    } catch {
-        Write-Warning "Elevated step did not run: $($_.Exception.Message)"
-        return $false
-    }
-}
-
-function Start-LCoreMinimized {
-    [OutputType([void])]
-    param()
-    $launchArguments = '/minimized'
-    Start-Process -FilePath $script:LCoreExecutablePath -ArgumentList $launchArguments
-}
-
-function Test-LCoreIsResponding {
-    [OutputType([bool])]
-    param([Parameter(Mandatory)] [int] $WaitSeconds)
-    Start-Sleep -Seconds $WaitSeconds
-    $lcoreProcesses = Get-Process -Name $script:LCoreProcessName -ErrorAction SilentlyContinue
-    if (-not $lcoreProcesses) { return $false }
-    foreach ($eachLCore in @($lcoreProcesses)) {
-        if (-not $eachLCore.Responding) { return $false }
-    }
-    return $true
-}
-
-function Write-StateSnapshot {
-    [OutputType([void])]
-    param([Parameter(Mandatory)] [string] $Label)
-    $logitechServiceNamesToVerify = @('LogiRegistryService', 'logi_lamparray_service')
-    Write-Host ""
-    Write-Host "=== $Label ==="
-    $sessionId = Get-CurrentInteractiveSessionId
-    $explorersInSession = Get-ExplorerProcessesInSession -TargetSessionId $sessionId
-    Write-Host "Explorer instances in session ${sessionId}: $($explorersInSession.Count)"
-    if ($explorersInSession.Count -gt 0) {
-        $explorersInSession | Format-Table ProcessId, OwnerUser, CreationDate -AutoSize | Out-String | Write-Host
-    }
-    $servicesObserved = Get-Service -Name $logitechServiceNamesToVerify -ErrorAction SilentlyContinue
-    if ($servicesObserved) {
-        $servicesObserved | Format-Table Name, Status -AutoSize | Out-String | Write-Host
-    }
-    $lcoreProcessesObserved = Get-Process -Name $script:LCoreProcessName -ErrorAction SilentlyContinue
-    if ($lcoreProcessesObserved) {
-        $lcoreProcessesObserved | Select-Object Id, Responding | Format-Table -AutoSize | Out-String | Write-Host
-    } else {
-        Write-Host "LCore not running."
-    }
-}
-
-function Invoke-LogifixRecovery {
-    [OutputType([void])]
-    param()
-
-    Write-StateSnapshot -Label 'Before'
-
-    if (-not (Test-Path -Path $script:LCoreExecutablePath)) {
-        Write-Error "LCore.exe not found at expected path: $script:LCoreExecutablePath"
-        return
-    }
-
-    Stop-LCoreIfRunning
-
-    $elevatedSucceeded = Invoke-ElevatedExplorerRebuild
-    if (-not $elevatedSucceeded) {
-        Write-Warning "UAC was canceled or the elevated step failed."
-        Write-Warning "Fallback: open Task Manager (Ctrl+Shift+Esc), find 'Windows Explorer', right-click, Restart. Then re-run /logifix."
-        return
-    }
-
-    Start-Sleep -Seconds $ExplorerAutoRespawnWaitSeconds
-
-    $sessionId = Get-CurrentInteractiveSessionId
-    $explorersAfterRespawn = Get-ExplorerProcessesInSession -TargetSessionId $sessionId
-    $explorerCountAfterRespawn = @($explorersAfterRespawn).Count
-    if ($explorerCountAfterRespawn -ne 1) {
-        if ($explorerCountAfterRespawn -eq 0) {
-            Write-Warning "No explorer.exe found in session $sessionId after $ExplorerAutoRespawnWaitSeconds-second wait."
-        } else {
-            Write-Warning "Expected exactly 1 explorer.exe in session $sessionId after shell auto-respawn, but found $explorerCountAfterRespawn."
-            Write-Warning "Multiple explorer.exe processes in the same session reproduce the Session 2 duplicate-explorer failure mode that blocks tray icon registration."
-            $explorersAfterRespawn | Format-Table ProcessId, OwnerUser, CreationDate -AutoSize | Out-String | Write-Host
-        }
-        Write-Warning "Restart Explorer manually via Task Manager (Ctrl+Shift+Esc, Windows Explorer, Restart), then re-run /logifix."
-        return
-    }
-
-    $lastAttemptResponded = $false
-    for ($attemptIndex = 1; $attemptIndex -le $LCoreRelaunchAttemptCount; $attemptIndex++) {
-        Stop-LCoreIfRunning
-        Start-LCoreMinimized
-        $lastAttemptResponded = Test-LCoreIsResponding -WaitSeconds $LCoreInitializationWaitSeconds
-        if ($lastAttemptResponded) {
-            Write-Host "LCore relaunch attempt ${attemptIndex}: process is responding."
-        } else {
-            Write-Warning "LCore relaunch attempt ${attemptIndex}: process not responding."
-        }
-    }
-
-    Write-StateSnapshot -Label 'After'
-
-    if (-not $lastAttemptResponded) {
-        Write-Warning "LCore did not respond after $LCoreRelaunchAttemptCount attempts."
-        Write-Warning "Use Task Manager to Restart Windows Explorer, then re-run /logifix."
-        return
-    }
-
-    Write-Host ""
-    Write-Host "Recovery complete ($LCoreRelaunchAttemptCount stop+launch cycles performed). If the tray icon is still not visible, use Task Manager to Restart Windows Explorer (guaranteed correct session/elevation), then re-run /logifix."
-}
-
-Invoke-LogifixRecovery

package/skills/monitor-open-prs/CLAUDE.md

@@ -1,34 +0,0 @@
-# monitor-open-prs skill
-
-Discovers every open pull request across the `jl-cmd/*` and `JonEcho/*` owner scopes, dispatches `/bugteam` on each with the `--bugbot-retrigger` flag, and polls for new Cursor bugbot replies after each bugteam run.
-
-**Trigger:** `/monitor-open-prs`, "sweep the open PRs", "audit the open PR backlog".
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `SKILL.md` | Full workflow: refusal cases, discovery, dispatch, post-convergence polling, final report |
-| `test_skill_contract.py` | Contract tests for the skill |
-| `packages/claude-dev-env/skills/monitor-open-prs/scripts/discover_open_prs.py` | Shells out to `gh search prs` per owner scope and flattens results to a uniform dict shape |
-| `packages/claude-dev-env/skills/monitor-open-prs/scripts/test_discover_open_prs.py` | Tests for the discovery helper |
-
-## Subdirectories
-
-| Directory | Role |
-|---|---|
-| `scripts/` | Discovery helper and its tests |
-
-## Workflow summary
-
-1. Call `discover_open_prs.discover_open_prs(all_owners=["jl-cmd", "JonEcho"])` to get the full open-PR list.
-2. For each PR, invoke `/bugteam <pr_number>`; include `--bugbot-retrigger` only when bugbot is enabled (`reviews_disabled.py --reviewer bugbot` exits 1).
-3. After each bugteam run, poll for new bugbot comments on a 60s → 120s → 240s → 480s → 960s backoff. Re-invoke bugteam if new findings appear.
-4. Emit a sweep summary when all PRs exit polling.
-
-## Refusals (checked first)
-
-- `CLAUDE_REVIEWS_DISABLED` has `bugteam` → stop with a message.
-- GitHub API not accessible → stop.
-- Uncommitted changes in the caller's repo → stop.
-- Required subagent types missing (`code-quality-agent`, `clean-coder`) → stop.

package/skills/monitor-open-prs/SKILL.md

@@ -1,88 +0,0 @@
----
-name: monitor-open-prs
-description: >-
-  Discover every open pull request across the jl-cmd/* and JonEcho/*
-  owner scopes, spawn /bugteam on each in parallel with the bugbot
-  re-trigger flag (--bugbot-retrigger), and poll Cursor's bugbot replies
-  after convergence so any post-bugteam findings loop back through
-  /bugteam. Triggers: '/monitor-open-prs', 'sweep the open PRs',
-  'audit the open PR backlog'.
----
-
-# Monitor Open PRs
-
-**Core principle:** One sweep covers every open PR across both owner scopes. Claude discovers PRs live via `scripts/discover_open_prs.py` which shells out to `gh search prs --owner <owner> --state open --json ...`, dispatches `/bugteam --bugbot-retrigger` per PR, then polls Cursor's bugbot replies until each PR is quiet for a full backoff cycle.
-
-## Contents
-
-- Transport check — gh presence and auth route the sweep local or through the cloud transport
-- When this skill applies — refusal cases and trigger conditions
-- Discovery — `scripts/discover_open_prs.py` queries via `gh search prs` across both owner scopes
-- Dispatch — `/bugteam --bugbot-retrigger <pr_numbers...>`
-- Post-convergence polling — bugbot replies and re-invocation
-- `scripts/discover_open_prs.py` — the discovery helper
-
-## Transport check (before any GitHub step)
-
-Run `command -v gh`; when it succeeds, run `gh auth status`; for each PR the sweep dispatches, `gh api repos/<owner>/<repo> --jq .permissions.push` must print `true`. When any check fails, run the `pr-loop-cloud-transport` skill first and route every `gh` operation in this skill through its substitution matrix, including the discovery query (`mcp__github__search_pull_requests` with `perPage` in place of `gh search prs`).
-
-## When this skill applies
-
-`/monitor-open-prs` authorizes one full sweep over all open PRs in both owner scopes.
-
-Refusals — first match wins; respond with the quoted line exactly and stop:
-
-- **Disabled via environment.** When `CLAUDE_REVIEWS_DISABLED` (comma-separated, case-insensitive, whitespace-tolerant) has the token `bugteam`: `/monitor-open-prs is a /bugteam dispatcher and /bugteam is disabled via CLAUDE_REVIEWS_DISABLED.` Gate semantics live in the `reviewer-gates` skill ([../reviewer-gates/SKILL.md](../reviewer-gates/SKILL.md)).
-- **GitHub API not accessible.** `get_me failed. /monitor-open-prs needs active GitHub MCP credentials.`
-- **Dirty tree on the caller's repo.** `Uncommitted changes detected. Stash, commit, or revert before /monitor-open-prs.`
-- **Required subagents missing.** Confirm `code-quality-agent` and `clean-coder` exist. Else: `Required subagent type <name> not installed.`
-
-## Discovery
-
-Call `scripts/discover_open_prs.discover_open_prs(all_owners=["jl-cmd", "JonEcho"])` to merge the live open-PR list across both scopes. The helper shells out to `gh search prs --owner <owner> --state open --json number,repository,url,headRefName,baseRefName` for each owner scope and flattens the result to a uniform dict shape with keys `number`, `owner`, `repo`, `head_ref`, `base_ref`, `url`. Empty scopes contribute empty lists; an entirely empty sweep returns `[]` and exits cleanly.
-
-## Dispatch
-
-For each discovered PR:
-
-1. Resolve the PR's repo checkout (existing worktree or fresh `git clone`).
-2. From that checkout, invoke `/bugteam <pr_number>`. Include `--bugbot-retrigger` only when bugbot is enabled for the run — when `python "$HOME/.claude/_shared/pr-loop/scripts/reviews_disabled.py" --reviewer bugbot` exits 1. On exit 0 (bugbot disabled — the default) omit `--bugbot-retrigger` so the bugbot leg sits out the run.
-3. The `--bugbot-retrigger` flag tells bugteam to post `bugbot run` as an issue comment after every successful FIX push so Cursor's bugbot re-evaluates the new commit.
-4. Bugteam runs its own 20-loop audit/fix cycle per PR; this skill waits for each bugteam invocation to return before dispatching the next (or fanning out — see below).
-
-**Fan-out (optional):** when the discovered list has more than one PR, the skill may spawn `/bugteam` dispatches in parallel by issuing multiple `Agent` calls in a single assistant message. Each dispatch operates in its own per-PR worktree (bugteam Step 1.1). Serialize when the caller sets an explicit `--serial` flag.
-
-## Post-Convergence Polling
-
-After a `/bugteam` invocation returns (converged, cap reached, stuck, or error), the PR may accumulate new Cursor bugbot comments within minutes. Poll for them:
-
-1. Baseline: capture `since_timestamp` as the PR's last commit timestamp.
-2. Every 60 seconds, call `pull_request_read(method="get", pullNumber=<pr_number>, owner=<owner>, repo=<repo>)` and filter the response's `comments` array for entries whose `.author.login` matches `"bugbot"` or `"cursor"` and `.createdAt` is after `<since_timestamp>`.
-3. Back off: 60s → 120s → 240s → 480s → 960s. If five successive polls return empty, exit polling for this PR.
-4. If bugbot posts a new finding in any poll, re-invoke `/bugteam <pr_number>` with the bugbot finding text seeded into the invocation's `bugs_to_fix` preamble. Reset the backoff.
-
-### Polling Cost and Cadence
-
-The five-step backoff sums to `60 + 120 + 240 + 480 + 960 = 1860` seconds (~31 minutes) of idle polling per PR before the skill declares bugbot quiet. A sweep over ten open PRs therefore retains up to ~5 wall-clock hours of bugbot-watch time beyond the active `/bugteam` work. Callers who need faster turnaround should pass `--serial` to disable fan-out (so polling starts only after the previous PR finishes) or accept the tradeoff: the backoff exists specifically to catch late bugbot analyses that can take several minutes to appear after a push.
-
-## Final Report
-
-After every PR has exited polling, emit:
-
-```
-/monitor-open-prs sweep summary
-PRs discovered: <N>
-  jl-cmd/*: <count>
-  JonEcho/*: <count>
-PRs converged clean: <count>
-PRs hit 20-loop cap: <count>
-PRs stuck: <count>
-PRs errored: <count>
-Bugbot re-triggers fired: <count>
-```
-
-## Non-Negotiable Guardrails
-
-- Never pass `--no-verify` or `--no-gpg-sign` to git in any dispatched bugteam run.
-- Never open a PR from this skill; only comment on existing ones.
-- Never merge or close PRs; the skill is read + audit + patch only.

package/skills/monitor-open-prs/scripts/CLAUDE.md

@@ -1,17 +0,0 @@
-# monitor-open-prs/scripts
-
-Discovery helper for the `monitor-open-prs` skill.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `discover_open_prs.py` | Queries `gh search prs` for each owner scope and flattens results to a uniform list of dicts |
-| `test_discover_open_prs.py` | Tests for the discovery helper |
-
-## Conventions
-
-- `discover_open_prs(all_owners: list[str]) -> list[dict]` is the single entry point. It shells out to `gh search prs --owner <owner> --state open --json number,repository,url,headRefName,baseRefName` once per owner and merges the results.
-- Each returned dict has keys: `number`, `owner`, `repo`, `head_ref`, `base_ref`, `url`.
-- An empty scope or an empty sweep returns an empty list and exits cleanly with no errors.
-- The module is stateless and has no filesystem side effects.

package/skills/monitor-open-prs/scripts/discover_open_prs.py

@@ -1,69 +0,0 @@
-"""Discover every open pull request across a list of owner scopes.
-
-Shells out to ``gh search prs --owner <owner> --state open --json ...`` once per
-owner, parses the JSON output, and flattens each entry to a uniform dict shape.
-The module is stateless, takes no filesystem side effects, and exposes a single
-``discover_open_prs`` entry point consumed by the monitor-open-prs skill.
-"""
-
-from __future__ import annotations
-
-import json
-import subprocess
-
-
-def build_gh_search_argv(owner: str) -> list[str]:
-    gh_command_name = "gh"
-    search_subcommand = ("search", "prs")
-    owner_flag = "--owner"
-    state_flag = "--state"
-    state_open_value = "open"
-    json_fields_flag = "--json"
-    json_fields_value = "number,repository,url,headRefName,baseRefName"
-    return [
-        gh_command_name,
-        *search_subcommand,
-        owner_flag,
-        owner,
-        state_flag,
-        state_open_value,
-        json_fields_flag,
-        json_fields_value,
-    ]
-
-
-def split_repository_name(name_with_owner: str) -> tuple[str, str]:
-    repo_separator = "/"
-    if repo_separator not in name_with_owner:
-        return "", name_with_owner
-    owner_segment, repository_segment = name_with_owner.split(repo_separator, 1)
-    return owner_segment, repository_segment
-
-
-def flatten_pr_entry(raw_pr_entry: dict) -> dict:
-    name_with_owner = raw_pr_entry.get("repository", {}).get("nameWithOwner", "")
-    owner_segment, repository_segment = split_repository_name(name_with_owner)
-    return {
-        "number": raw_pr_entry.get("number"),
-        "owner": owner_segment,
-        "repo": repository_segment,
-        "head_ref": raw_pr_entry.get("headRefName", ""),
-        "base_ref": raw_pr_entry.get("baseRefName", ""),
-        "url": raw_pr_entry.get("url", ""),
-    }
-
-
-def fetch_open_prs_for_owner(owner: str) -> list[dict]:
-    search_argv = build_gh_search_argv(owner)
-    completed_process = subprocess.run(
-        search_argv, check=True, capture_output=True, text=True
-    )
-    raw_pr_entries = json.loads(completed_process.stdout)
-    return [flatten_pr_entry(each_entry) for each_entry in raw_pr_entries]
-
-
-def discover_open_prs(all_owners: list[str]) -> list[dict]:
-    all_discovered: list[dict] = []
-    for each_owner in all_owners:
-        all_discovered.extend(fetch_open_prs_for_owner(each_owner))
-    return all_discovered