claude-dev-env 2.28.1 → 2.29.0

package/.agents/skills-archived/pr-converge/reference/AGENTS.md

@@ -1,28 +1 @@
-# pr-converge/reference
 
-Reference documents for the `pr-converge` skill. These files define the per-tick step sequence, convergence gates, fix protocol, stop conditions, state schema, multi-PR orchestration, and examples.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `progress-checklist.md` | The per-tick eleven-step checklist (Step 0 open → Step 11 report), each step pointing to its spoke file |
-| `per-tick.md` | Step-by-step procedure for one tick (resolve HEAD, run the internal CODE_REVIEW and BUGTEAM phases, then the terminal BUGBOT and COPILOT_WAIT gates, schedule next wakeup) |
-| `convergence-gates.md` | Six gates that must all pass before the PR is marked ready for review |
-| `fix-protocol.md` | pr-converge deltas on the `pr-fix-protocol` skill: multi-PR teammate obligations and the same-tick bugbot re-trigger rule |
-| `ground-rules.md` | Non-negotiable constraints for the convergence loop |
-| `stop-conditions.md` | Conditions that end the loop without convergence (cap reached, stuck, user stop) |
-| `state-schema.md` | Fields in `pr-converge-state.json` and their meanings |
-| `multi-pr-orchestration.md` | How to run the loop across multiple PRs in parallel |
-| `examples.md` | Worked examples of tick sequences |
-
-## Subdirectories
-
-| Directory | Role |
-|---|---|
-| `obstacles/` | Per-obstacle runbooks for known failure modes in the convergence loop |
-
-## Conventions
-
-- `per-tick.md` is the primary reference loaded during each tick. The pacing workflow lives in `../workflows/schedule-wakeup-loop.md`.
-- Every gate in `convergence-gates.md` must produce evidence before the next gate runs.

package/.agents/skills-archived/pr-converge/reference/obstacles/AGENTS.md

@@ -1,23 +1 @@
-# pr-converge/reference/obstacles
 
-Per-obstacle runbooks for known failure modes in the `pr-converge` convergence loop. Each file covers one specific obstacle: what causes it, how to detect it, and how to recover.
-
-## Files
-
-| File | Obstacle |
-|---|---|
-| `fix-post-replies.md` | Posting inline review replies fails or posts to the wrong thread |
-| `fix-publish-summary.md` | Publishing the bugteam summary comment fails |
-| `fix-push.md` | `git push` fails during a fix commit |
-| `fix-read-filelines.md` | Reading file line ranges for a fix fails |
-| `fix-reset-state.md` | State JSON becomes corrupt or inconsistent between ticks |
-| `fix-resolve-threads.md` | Resolving inline comment threads via GraphQL fails |
-| `fix-spawn-clean-coder.md` | Spawning the `clean-coder` subagent fails or produces no output |
-| `fix-stage-commit.md` | Staging or committing a fix fails |
-| `fix-trigger-bugbot.md` | Triggering Cursor Bugbot via an issue comment fails |
-| `fix-write-test.md` | Writing a failing test before a fix fails |
-
-## Conventions
-
-- Each runbook is loaded on demand when the convergence loop hits that specific obstacle.
-- Runbooks do not overlap with `per-tick.md`; they cover edge cases and recovery paths that fall outside the normal tick flow.

package/.agents/skills-archived/pr-converge/scripts/AGENTS.md

@@ -1,46 +1 @@
-# pr-converge/scripts
 
-Python helper scripts for the `pr-converge` skill, plus their tests and a PowerShell/AutoHotkey toolset for advancing Cursor agents.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `check_bugbot_ci.py` | Checks bugbot CI check-run status on a given SHA |
-| `check_convergence.py` | Evaluates whether all convergence gates pass on the current HEAD |
-| `check_convergence_availability.py` | Resolves reviewer waivers from flag, disk-authoritative settings (env fallback), and the availability/quota probe, with waived / enforced / probe_error_reason states |
-| `check_convergence_gates.py` | GitHub REST leaf checks (review and Bugbot) the convergence gates call |
-| `check_convergence_thread_gates.py` | GitHub GraphQL and REST leaf checks (review threads and pending reviewers) the convergence gates call |
-| `check_pending_reviews.py` | Fetches pending review requests and reviewer states |
-| `fetch_copilot_reviews.py` | Fetches Copilot reviewer reviews filtered to the current HEAD |
-| `post_fix_reply.py` | Posts an inline reply to a review comment thread |
-| `reflow_skill_md.py` | Reformats `SKILL.md` to enforce a line width limit |
-| `README.md` | MCP tool reference for PR operations used by the scripts |
-| `_pr_converge_path_setup.py` | Adds the scripts directory to `sys.path` for direct script imports |
-| `conftest.py` | Puts the scripts directory on `sys.path` so pytest collects the suite |
-| `test_check_bugbot_ci.py` | Tests for `check_bugbot_ci.py` |
-| `test_check_convergence.py` | Tests for `check_convergence.py` |
-| `test_check_convergence_availability.py` | Tests for `check_convergence_availability.py` |
-| `test_check_convergence_contract.py` | Contract pins for `check_convergence.py` gate wiring |
-| `test_check_convergence_gates.py` | Tests for `check_convergence_gates.py` |
-| `test_check_convergence_thread_gates.py` | Tests for `check_convergence_thread_gates.py` |
-| `test__pr_converge_path_setup.py` | Tests for `_pr_converge_path_setup.py` |
-| `test_cursor_agents_continue.py` | Tests for the cursor-agents-continue toolset |
-| `test_reflow_skill_md.py` | Tests for `reflow_skill_md.py` |
-| `caller-window-pid.ps1` | Gets the PID of the calling terminal window |
-| `cursor-agents-continue.ahk` | AutoHotkey script to advance Cursor agent prompts |
-| `cursor-agents-continue.cmd` | CMD wrapper for the AHK script |
-| `cursor-agents-continue-stop-others.ps1` | Stops other Cursor agents before advancing one |
-| `cursor-agents-continue-caller.cmd` | Caller-side CMD wrapper |
-
-## Subdirectories
-
-| Directory | Role |
-|---|---|
-| `pr_converge_scripts_constants/` | Script-specific constants (re-exports skill constants plus adds reflow/CLI constants) |
-
-## Conventions
-
-- Scripts import constants from `pr_converge_scripts_constants.pr_converge_constants`, which re-exports everything from `pr_converge_skill_constants.constants`.
-- Run scripts as `python ~/.claude/skills/pr-converge/scripts/<script>.py --owner <O> --repo <R> --pr-number <N>`.
-- The `reflow_skill_md.py` script targets `SKILL.md` in the parent skill directory (resolved via `TARGET_SKILL_PATH` in `pr_converge_scripts_constants/reflow_skill_md_constants.py`).

package/.agents/skills-archived/pr-converge/scripts/pr_converge_scripts_constants/AGENTS.md

@@ -1,18 +1 @@
-# pr_converge_scripts_constants
 
-Constants module for the `pr-converge` skill's Python scripts. Re-exports all runtime/API constants from the skill-level module and adds script-specific constants for CLI arguments, markdown patterns, and reflow settings.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `__init__.py` | Package marker |
-| `pr_converge_constants.py` | Re-exports all constants from `pr_converge_skill_constants.constants` plus adds script-specific values |
-| `reflow_skill_md_constants.py` | Constants for `reflow_skill_md.py`: line width limit, list item patterns, `TARGET_SKILL_PATH` |
-| `convergence_gate_constants.py` | Constants for `check_convergence_gates.py`: short-SHA length, join separators, and the review-threads GraphQL query |
-
-## Conventions
-
-- `pr_converge_constants.py` uses `from pr_converge_skill_constants.constants import ...` (with `# noqa: F401`) to re-export everything so script files can import from one location.
-- `reflow_skill_md_constants.py` resolves `TARGET_SKILL_PATH` from its own `__file__` path, pointing to `SKILL.md` three directories up.
-- Script-specific regex patterns (ordered list items, bullet list items, unfinished markdown link targets, markdown reference definitions) live in `reflow_skill_md_constants.py`.

package/.agents/skills-archived/pr-converge/workflows/AGENTS.md

@@ -1,16 +1 @@
-# pr-converge/workflows
 
-Pacing workflow specification for the `pr-converge` loop.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `schedule-wakeup-loop.md` | Specifies `ScheduleWakeup` call parameters, delays, and stop/convergence conditions for each tick |
-
-## Conventions
-
-- `per-tick.md` (in `../reference/`) references this file for Step 4 (schedule next wakeup). Read it before running Step 4.
-- Default delay: `delaySeconds: 360`. Exception: BUGBOT inline-lag branch uses `delaySeconds: 90`.
-- On convergence or a hard stop condition, omit the `ScheduleWakeup` call entirely.
-- The `reason` field in each `ScheduleWakeup` call names what is being awaited, including the current `phase` and `bugbot_clean_at` SHA when set.

package/.agents/skills-archived/recall/AGENTS.md

@@ -1,30 +1 @@
-# recall
 
-Retrieves prior session context and decisions from the Obsidian vault for the current project.
-
-**Trigger:** `/recall [search query or project name]`.
-
-## Purpose
-
-Surfaces relevant session reports, decision notes, and research from the Obsidian vault before starting work. Prevents repeating decisions already made or missing known gotchas.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `SKILL.md` | The complete skill — six steps (resolve query, frontmatter search, content search, read top matches, present with attribution, handle no results). No companion files. |
-
-## How the skill runs
-
-1. Uses `$ARGUMENTS` as the search query, or infers the project name from conversation context.
-2. Searches by frontmatter first (`mcp__obsidian__search_notes` with `searchFrontmatter: true`) to catch session reports and decision notes tagged with the project.
-3. Falls back to content keyword search when frontmatter search returns few results.
-4. Reads the top 3 most relevant notes via `mcp__obsidian__read_note`, preferring recent notes and decision summaries over raw research.
-5. Reports each note with its path, date, relevant excerpts, and whether any decisions are marked `status: Superseded`.
-6. States clearly when no vault history exists — never infers or invents history.
-
-## Conventions
-
-- `disable-model-invocation: true` is not set; this skill does invoke the model to synthesize results.
-- The skill is read-only: it never writes to the vault.
-- Companion to `/remember` (which writes decisions) and `/session-log` (which writes session reports).

package/.agents/skills-archived/remember/AGENTS.md

@@ -1,31 +1 @@
-# remember
 
-Saves a decision, gotcha, or architectural choice to the Obsidian vault as a structured note.
-
-**Trigger:** User-initiated only. `/remember [what to remember]`.
-
-## Purpose
-
-Writes a decision, fact, procedure, or gotcha to `decisions/[Project] - [Short Title].md` in the Obsidian vault. Each note carries structured frontmatter and a body shaped by its type, making it searchable and readable via `/recall`.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `SKILL.md` | The complete skill — six steps (parse input, classify type, infer project, generate title, write to vault, confirm). No companion files. |
-
-## Four note types
-
-| Type | Body format |
-|---|---|
-| `decision` | Decision + Reasoning + Alternatives + Consequences |
-| `gotcha` | Gotcha + Symptom + Fix |
-| `procedural` | 1–3 clear sentences describing the how-to |
-| `fact` | 1–3 clear sentences stating the fact |
-
-## Conventions
-
-- `disable-model-invocation: true` is set — runs without a secondary LLM call.
-- Writes via `mcp__obsidian__write_note` only; never edits existing notes.
-- Path pattern: `decisions/[Project] - [Short Title].md`.
-- Companion to `/recall` (reads vault) and `/session-log` (triggers decision extraction at session end).

package/AGENTS.md

@@ -1,113 +1 @@
-less words. small words. few words. always. forever.
 
-Avoid all redundant text for all output. IE: instead of "the review found 2 real issues", simply state "the review found 2 issues".
-
-## User-facing language hierarchy
-
-ELI5 owns beginner framing and beginner-friendly presentation, large visuals, minimal text, one stable self-contained HTML artifact, update-in-place continuity, and sharing when a response needs that presentation.
-
-`rules/asd-ste100-language.md` owns sentence-level word choice, grammar, tone, punctuation, exact labels, and prose form in every user-facing response and every ELI5 page.
-
-Named capability rules own evidence, questions, current-state documentation, completion, code documentation, durable artifacts, and runtime enforcement. They apply ASD sentence rules and use ELI5 presentation when their user-facing output needs that envelope.
-
-Raw tool output, machine payloads, code, and native repository artifacts keep their required formats. Their user-visible explanations follow the ASD rule.
-
-A responsible human verifies technical accuracy, terminology, safety, confidentiality, and intended meaning.
-
-Ask when ambiguity materially changes scope or implementation. Collect credentials through secure UI only; never request secrets in chat.
-
-## Documentation
-
-Describe the current system state. Keep documentation self-contained. Apply `rules/asd-ste100-language.md` for sentence-level prose.
-
-Code and tests
-
-Tests must exercise real behavior, real data, and production paths. Test theater is forbidden.
-
-For multi-step code tasks:
-
-Coders consult a warm session-advisor when blocked (Sol xHigh).
-Repair reported findings when that review mode is selected.
-
-Use `~/.claude/agents/session-advisor.md` for advisor selection and consultation protocol.
-
-Research and delegation
-Delegate fact extraction when multiple files or search patterns are required. Request precise file-and-line answers.
-
-Use warm & reusable parallel luna (you decide effort level per task) fast subagents for unrelated questions; threaded & named appropriately.
-
-Read or search directly only in files you will modify via es.exe.
-
-For code navigation, prefer es.exe, then content search or globbing.
-
-Scope every es.exe search.
-
-Never scan an entire drive or network share.
-
-Use `~/.claude/skills/everything-search/SKILL.md` for scoped filesystem searches that require Everything.
-
-Task tracking
-Track every task using `update_plan`.
-
-## Definitions
-Warm agent: Any agent who has acted within the past 30 minutes.
-
-# Response and working style
-
-ELI5 presentation sets beginner framing, useful visuals, concise detail, stable HTML continuity, and sharing when that capability applies.
-
-Sentence-level language follows `rules/asd-ste100-language.md`.
-
-Progress and final structure follow the named completion contract.
-
-# Word budget
-
-Keep ELI5 pages concise and useful. Use the ASD rule's 20-word procedure target and 25-word descriptive target when the technical content allows.
-
-# No contrast framing
-
-Use direct claims and direct actions. The canonical rule owns sentence form; capability contracts own exceptions needed to explain a concrete failure.
-
-# Naming
-
-Use full capability names for files, modules, functions, variables, branches, and tests. Name reusable components for the capability they provide. Keep workflow words on driver surfaces.
-
-  # Change size
-
-
-
-  When planning work or opening a pull request, size the change first: one self-contained change, around 100 lines, with its tests. Read the small-changelists guide for the numbers, the allowed exceptions, and how to split.
-
-Use `~/.claude/skills/pr-small-cl/SKILL.md` for change-size guidance and review-sized boundaries.
-
-## Execution and delegation
-
-Delegate all task work to Tier 3 agents.
-
-Draft a separate assignment for each agent. Each assignment must be clear, concise, tightly scoped, independently executable, and explicit about ownership, constraints, deliverables, and verification.
-
-Run independent assignments in parallel. Keep overlapping work sequential. The primary agent coordinates agents, resolves dependencies, verifies results, and reports outcomes.
-
-## Definitions
-
-Tier 3 agent: A strong execution specialist that independently completes a bounded assignment, follows repository contracts, repairs routine failures, tests production behavior, and escalates decisions that materially affect architecture or scope.
-
-Warm agent: An agent that has acted within the past 30 minutes. Reuse warm agents for related follow-up work.
-
-  # Corrections
-
-  Only correct an earlier statement when the ecode, conclusions, or decisions. Statecorrections plainly and briefly, then continue the task. For slips that change nothing for the user, make the fix and move on without noting it.
-
-  # Tool calls and output hygiene
-
-  When you use a tool, you may say a brief sentence first. If no tool can express what the user asked for, say so. Do not include internal or system XML tags in your response.
-
-Use the named review workflow for code-review response reporting.
-
-  # Code review
-
-  When reviewing code, report everything you find. Filtering belongs in a separate pass.
-
-<tone_preference>
-ELI5 sets beginner-friendly presentation when it applies. ASD sets sentence-level wording and tone.
-</tone_preference>

package/_shared/AGENTS.md

@@ -1,17 +1 @@
-# _shared
 
-Cross-cutting runtime assets shared by multiple skills. The PR-loop skills (`bugteam`, `pr-converge`, `findbugs`, `fixbugs`) are one such cluster; other clusters live here too. Files here are installed into `~/.claude/_shared/` by `bin/install.mjs` alongside the skill directories that import them.
-
-Shared assets use `~/.claude/rules/asd-ste100-language.md` for user-facing word choice, sentence style, tone, punctuation, and prose form. Each asset keeps its workflow-specific structure.
-
-## Contents
-
-| Entry | Description |
-|---|---|
-| `pr-loop/` | Docs, scripts, and constants for the PR-loop workflow suite |
-| `advisor/` | Warm-advisor spawn-and-consult protocol for `team-advisor` and `orchestrator` |
-| `process-tree/` | One process-tree kill helper for every script that captures a spawned CLI's output |
-
-## Install path
-
-`bin/install.mjs` copies this entire directory tree verbatim to `~/.claude/_shared/`. Skills reference files here by relative path from their own skill root (e.g. `../../_shared/pr-loop/audit-contract.md`).

package/_shared/advisor/AGENTS.md

@@ -1,22 +1 @@
-# _shared/advisor
 
-Warm-advisor bind-and-consult protocol shared by `team-advisor`, `orchestrator`, `orchestrator-refresh`, and every executor subagent `orchestrator` routes work to. Changes here affect all of these simultaneously — treat this as a breaking-change surface.
-
-Host profile is resolved from session identity first (Claude, Codex, or neither). Claude walks Fable then Sol in-session (CLI chain as the Fable fallback). Codex walks Sol in-session. A third-party host binds Fable through the CLI Claude-chain (fail closed when Fable and Sol cannot serve) with a separate executor paste block.
-
-## Key documents
-
-| File | Purpose |
-|---|---|
-| `advisor-protocol.md` | Router with a moment-keyed read map: session identity and host profiles first, model floor, warm-up and consult standing rules, lifecycle ownership, Advisor-block assembly rule, and the shared CLI Claude-chain — each with a stub pointing at its `reference/` detail file |
-
-## Subdirectory
-
-| Entry | Description |
-|---|---|
-| `scripts/` | `model_tier_run_validator.py` (spawn-walk log checks, including Codex Sol-first and optional Sol), `codex_sol_advisor.py` (read-only Sol bind and resume at shared `ADVISOR_EFFORT`), `tier_model_ids.py` (Claude aliases, Codex model ids, session identity, and host detection), and `advisor_scripts_constants` under `scripts/config/` (ladder, bind tokens, aliases, host profiles, identity tokens, shared effort, and SendMessage wait bound) |
-| `reference/` | Progressive-disclosure detail behind protocol stub sections: `identity.md`, `warm-up.md`, `third-party-bind.md`, `sol-rung.md`, `consult-format.md`, `advisor-block.md`, `lifecycle.md`, `cli-chain.md`, and `spawn-walk-log.md` |
-
-## Breaking-change rule
-
-A change to session identity, host detection, the model-floor rule, the charter template, any host's Advisor block, or lifecycle ownership in `advisor-protocol.md` requires updating every consuming skill (`team-advisor`, `orchestrator`, `orchestrator-refresh`) in the same commit.

package/_shared/advisor/advisor-protocol.md

@@ -1,6 +1,9 @@
 # Advisor Protocol
 
-Shared spawn-once, consult-by-message protocol for a warm advisor. Two skills depend on this: `team-advisor` (binds the advisor for its own consulting session) and `orchestrator` (binds the same advisor and lets its own routed executor subagents consult it too). Executor spawn prompts are a third consumer, via the assembled Advisor block.
+Shared spawn-once, consult-by-message protocol for a warm advisor.
+`team-advisor` binds the advisor for its own consulting session.
+Executor spawn prompts that skill issues consume the assembled Advisor
+block.
 
 **First step of every bind:** name the session identity and resolve the host profile (next section).
 Walk the model-floor ladder, spawn the in-session advisor, or open the CLI fallback only after the host is known.

package/_shared/advisor/reference/consult-format.md

@@ -16,7 +16,7 @@ The first consult is complete and self-contained. It carries:
 - Unresolved risks
 - Load-bearing paths or excerpts
 
-On a shared advisor with multiple consumers, open with who is asking and the assignment. A single-consumer team-advisor session may omit the identity opener while keeping the assignment.
+If more than one party consults the same advisor, open with who is asking and the assignment. A `/team-advisor` session talks to its advisor alone, so it may omit that identity opener while keeping the assignment.
 
 Later consults carry only the delta: changed actions, new output, changed decisions, new validation, and newly discovered risks.
 
@@ -36,6 +36,8 @@ After a CORRECTION or PLAN, your next consult on that topic opens with what happ
 ## Handling the reply
 
 Address a CORRECTION before treating the plan or the work as done, whether it names a wrong step or a risk worth closing.
-Report a STOP, or a consult that finds the advisor unreachable, upward: team-advisor's sole consumer is the session itself, so it reports to the user; orchestrator's executors report to the orchestrating session, which decides.
+
+`/team-advisor` is the skill that binds one warm advisor for the session that ran it. That lead session sends every consult. The bound advisor (`team-advisor-agent` on Claude) replies only to the lead session. If the lead session later spawns worker subagents, those workers do not consult the bound advisor, and the bound advisor does not reply to them. When the reply is STOP, or the bound advisor cannot be reached, the lead session tells the human. The lead session has no parent session to report to.
+
 When the advisor becomes unreachable, report that to the session that owns its lifecycle ([`lifecycle.md`](lifecycle.md)); that session alone decides whether to respawn (Claude Agent, Codex native Sol, or third-party CLI re-bind).
 A third-party host that cannot re-bind follows the fail-closed rule in [`third-party-bind.md`](third-party-bind.md).

package/_shared/pr-loop/AGENTS.md

@@ -1,28 +1 @@
-# _shared/pr-loop
 
-Runtime documents and scripts shared by every PR-loop skill. Changes here affect `bugteam`, `pr-converge`, `clean-room audit`, and `pr-fix-protocol` simultaneously — treat this as a breaking-change surface.
-
-## Key documents
-
-| File | Purpose |
-|---|---|
-| `audit-contract.md` | Canonical finding schema (Shape A / Shape B) and loop contract; defines the JSON shapes every audit skill must emit |
-| `audit-reply-template.md` | Canonical reply skeleton Claude posts to each unresolved review thread; single source of truth for reply structure |
-| `post-audit-thread-contract.md` | Single source of truth for the `post_audit_thread.py` invocation string, exit-code table, and per-caller policy (bugteam exit 2 = hard blocker; autoconverge clean-audit failed post = recorded bypass) |
-| `fix-protocol.md` | Ordered sequence a fix lens follows: read, capture SHA, TDD, apply, validate, self-audit, commit, push, reply + resolve |
-| `gh-payloads.md` | How to build GitHub review and reply payloads via MCP tools; describes the one-review-per-loop pattern |
-| `preflight-proposal.md` | Shared immutable proposal evidence and mutation-boundary contract for audit preflight worktrees |
-| `state-schema.md` | Fields each PR-loop workflow tracks across iterations; documents common fields and per-skill extensions |
-| `code-rules-gate.md` | Reference for the CODE_RULES pre-commit gate check; describes what the gate blocks and when it runs |
-| `precatch-rubric.md` | Shared pre-catch lane checklist — deterministic sweep, doc-vs-code parity, test-assertion completeness, PR-description parity, adversarial audit — that autoconverge's lenses and pr-converge's CODE_REVIEW step read on demand |
-| `worker-spawn.md` | Worker-spawn tier protocol and Claude-only slash-step host routing: three tiers, CLI/API inputs, JSON result shape, host detection, code-review modes via `detect_host_profile` + `invoke_code_review`, leader-socket rule, cloud setup; documents `scripts/resolve_worker_spawn.py` |
-
-## Subdirectory
-
-| Entry | Description |
-|---|---|
-| `scripts/` | Python scripts and constants consumed at runtime by the PR-loop skills |
-
-## Breaking-change rule
-
-Any shape change in a canonical contract listed under **Key documents** requires updating every consuming skill in the same commit.

package/_shared/pr-loop/scripts/AGENTS.md

@@ -1,50 +1 @@
-# _shared/pr-loop/scripts
 
-Python scripts invoked at runtime by the PR-loop skills. Each script is a standalone CLI entry point; `pr_loop_shared_constants/` holds the named constants they import.
-
-## Key scripts
-
-| File | Purpose |
-|---|---|
-| `preflight.py` | Pre-flight check run before each audit loop tick: verifies hooks path, finds test files, runs pytest, checks for `BUGTEAM_PREFLIGHT_SKIP` opt-out |
-| `preflight_self_heal.py` | Clears stale `core.hooksPath` overrides that Git seeds into fresh worktree local config; called from `preflight.py` |
-| `post_audit_thread.py` | Posts an audit review (APPROVE / REQUEST_CHANGES) to a draft PR via the GitHub reviews API; reads the body skeleton from `audit-reply-template.md` at runtime |
-| `grant_project_claude_permissions.py` | Writes idempotent allow-rules and `additionalDirectories` entries into `~/.claude/settings.json` so subagents can edit the project's `.claude/` tree without prompting |
-| `revoke_project_claude_permissions.py` | Removes the allow-rules and entries that `grant_project_claude_permissions.py` wrote; safe to run when no prior grant exists |
-| `stale_worktree_rule_sweep.py` | Drops allow/deny rules pointing at deleted `~/.claude/worktrees/<repo>/<worktree>` directories and deduplicates the rule arrays; run by the grant and revoke flows before they write |
-| `code_rules_gate.py` | Pre-commit gate that runs `code_rules_enforcer` checks on staged Python files before a fix commit lands, and the terminology sweep over the staged diff |
-| `terminology_sweep.py` | Flags a prose term that near-misses an identifier introduced on added code lines of a unified diff (shared leading word, divergent tail) |
-| `reviews_disabled.py` | Shared helper for the reviewer opt-out and opt-in gates; parses `CLAUDE_REVIEWS_DISABLED` tokens `bugteam`, `bugbot`, `copilot`, and `codex`, plus `CLAUDE_REVIEWS_ENABLED` for opt-in. `bugbot`, `bugteam`, and `codex` are off by default and each runs only when `CLAUDE_REVIEWS_ENABLED` lists it; `copilot` runs by default and stops only when `CLAUDE_REVIEWS_DISABLED` lists it |
-| `copilot_quota.py` | Copilot premium-request quota pre-check: resolves a configured GitHub account, reads its remaining `premium_interactions` quota via `gh api copilot_internal/user`, and exits 0 (run Copilot) or non-zero (skip: out of quota, API down, or no account configured) |
-| `reviewer_availability.py` | Unified reviewer-availability entry point for Copilot and Bugbot: reuses `copilot_quota.py` and `reviews_disabled.py` and exits 0 when the named `--reviewer` may be spawned, non-zero when it is opted out or (for Copilot) out of quota |
-| `fix_hookspath.py` | Repairs a malformed `core.hooksPath` global git config entry |
-| `_claude_permissions_common.py` | Internal helpers shared by the grant/revoke scripts: atomic settings.json writes, list mutation, path helpers |
-| `check_convergence.py` | Single convergence gate check for autoconverge finalize and mark-ready hooks |
-| `check_bugbot_ci.py` | Bugbot CI check-run status on a given SHA |
-| `check_convergence_availability.py` | Reviewer waiver resolution for convergence gates |
-| `check_convergence_gates.py` | GitHub REST leaf checks for convergence gates |
-| `check_convergence_thread_gates.py` | GitHub GraphQL and REST thread gate checks |
-| `check_pending_reviews.py` | Pending review requests and reviewer states |
-| `fetch_copilot_reviews.py` | Copilot reviews filtered to the current HEAD |
-| `post_fix_reply.py` | Inline reply poster for review comment threads |
-| `run_codex_review.py` | Codex review capture wrapper for the autoconverge Codex gate |
-| `codex_usage_probe.py` | Weekly Codex usage probe for gate threshold decisions |
-| `codex_down_classifier.py` | Maps Codex run outcomes to completed or codex_down |
-| `parse_codex_findings.py` | Parses Codex reviewer output into findings |
-
-## Subdirectories
-
-| Entry | Description |
-|---|---|
-| `code_rules_gate_parts/` | The decomposed modules `code_rules_gate.py` wires together: enforcer loading, git file sets, blob readers, added-line maps, violation scoping, wrapper plumb-through, gate running, staged-test running, and argument parsing |
-| `pr_loop_shared_constants/` | Named constants used by the scripts above |
-| `pr_converge_skill_constants/` | Bot logins, review states, and API templates for convergence scripts |
-| `pr_converge_scripts_constants/` | CLI and reflow constants for convergence scripts |
-| `codex_review_scripts_constants/` | Constants for Codex review capture and classification |
-| `tests/` | pytest suite for all scripts in this directory |
-
-## Running tests
-
-```bash
-python -m pytest packages/claude-dev-env/_shared/pr-loop/scripts/tests/
-```

package/_shared/pr-loop/scripts/code_rules_gate_parts/AGENTS.md

@@ -1,42 +1 @@
-# code_rules_gate_parts
 
-The modules `code_rules_gate.py` wires together to run the code-rules gate. Each
-module owns one concern; the entry script imports them and re-exports their
-surface for the test suite.
-
-## Modules
-
-| File | Purpose |
-|---|---|
-| `enforcer_loading.py` | Locates and loads `code_rules_enforcer.validate_content` from disk with the hooks directory on `sys.path` |
-| `git_file_sets.py` | Resolves the diff, staged, and untracked file sets from git, plus prefix filtering and staged line-span helpers |
-| `git_blob_readers.py` | Reads the committed and staged content of one file, and probes staged-index presence |
-| `added_line_maps.py` | Maps each changed file to the line numbers the current diff added, resolving renames and new files |
-| `violation_scoping.py` | Recovers a violation's line span from the enforcer message and partitions violations into blocking versus advisory |
-| `wrapper_plumb_check.py` | Flags a public wrapper that drops a same-file delegate's optional keyword arguments; holds the code-path and test-path classifiers |
-| `gate_running.py` | Validates the eligible file set, reports the inspected-file count, and prints the partitioned violation report |
-| `staged_test_running.py` | Runs one staged-test group, grouped by its owning pytest config and by top-level directory when no config owns it, in command-line-length-safe pytest batches, optionally writing a JUnit XML report per batch |
-| `staged_test_regression.py` | Discovers the staged test files, runs every group, and blocks only on a failure the staged change introduces — a group that fails is re-run against the HEAD baseline (a throwaway detached checkout made with `git worktree add --detach` under the OS temp root, deleted with `git worktree remove --force`) and only a failure absent there blocks |
-| `baseline_import_isolation.py` | Points the baseline run's imports at the baseline worktree — rebases every repository import root onto the front of its `PYTHONPATH` — and installs the pytest plugin that reports which modules the run loaded out of the user's own tree, so a route that survives the rebase is measured and the baseline discarded |
-| `gate_arguments.py` | Parses the gate's command-line arguments |
-| `__init__.py` | Package marker |
-
-## Staged-test grouping boundaries
-
-The top-level fallback in `staged_test_running.py` fires only in a repository
-whose root holds no pytest config, and it splits top-level neighbors alone:
-
-- Config-less packages that sit deeper under one shared top-level directory, such as `pkgs/alpha` and `pkgs/beta`, share that directory's single pytest session, so a module name they both expose still shadows.
-- A `conftest.py` at the repository root stays unloaded for those groups, because each session works from the top-level directory and the root file falls outside the tree pytest treats as its root.
-
-## Subdirectory
-
-| Entry | Description |
-|---|---|
-| `tests/` | pytest suite with one test module per module above, plus `_repo_test_helpers.py` (shared real-git-repository builders) |
-
-## Running tests
-
-```bash
-python -m pytest packages/claude-dev-env/_shared/pr-loop/scripts/code_rules_gate_parts/tests/
-```

package/_shared/pr-loop/scripts/codex_review_scripts_constants/AGENTS.md

@@ -1,18 +1 @@
-# codex_review_scripts_constants
 
-Python package of named constants imported by Codex review scripts under `_shared/pr-loop/scripts/`. Importing from this package keeps magic values out of script bodies.
-
-## Modules
-
-| File | Constants for |
-|---|---|
-| `__init__.py` | Package marker and package docstring. |
-| `run_constants.py` | Binary name, flag strings, custom-instructions prompt, version-probe pattern, timeout default, decode/timeout exit sentinels, flag_token_pattern suffix (whole-token shape match), JSONL keys, and capture outcome class labels for `run_codex_review.py`. |
-| `findings_constants.py` | Finding field keys, fenced-JSON and freeform patterns for `parse_codex_findings.py`. |
-| `classifier_constants.py` | Failure class names and stream markers for `codex_down_classifier.py`. |
-| `run_constants.py` | Binary name, flag strings, custom-instructions prompt, version-probe pattern, timeout default, decode/timeout exit sentinels, flag_token_pattern suffix (whole-token shape match), JSONL keys, JSONL capture filename and newline mode, and capture outcome class labels for `run_codex_review.py`. |
-| `codex_usage_probe_constants.py` | The weekly-usage probe CLI: gate threshold, report JSON keys, app-server JSON-RPC surface, rate-limit field keys, weekly-window sizing, text-status parse patterns, source labels, and exit codes. |
-
-## Convention
-
-Scripts import from this package at module scope. No constant is defined inline in a script body — the hook enforces this at write time.

package/_shared/pr-loop/scripts/pr_converge_scripts_constants/AGENTS.md

@@ -1,18 +1 @@
-# pr_converge_scripts_constants
 
-Constants module for shared PR-loop convergence scripts. Re-exports all runtime/API constants from `pr_converge_skill_constants` and adds script-specific constants for CLI arguments, markdown patterns, and reflow settings.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `__init__.py` | Package marker |
-| `pr_converge_constants.py` | Re-exports all constants from `pr_converge_skill_constants.constants` plus adds script-specific values |
-| `reflow_skill_md_constants.py` | Constants for `reflow_skill_md.py`: line width limit, list item patterns, `TARGET_SKILL_PATH` |
-| `convergence_gate_constants.py` | Constants for `check_convergence_gates.py`: short-SHA length, join separators, and the review-threads GraphQL query |
-
-## Conventions
-
-- `pr_converge_constants.py` uses `from pr_converge_skill_constants.constants import ...` (with `# noqa: F401`) to re-export everything so script files can import from one location.
-- `reflow_skill_md_constants.py` resolves `TARGET_SKILL_PATH` from its own `__file__` path, pointing to `SKILL.md` three directories up.
-- Script-specific regex patterns (ordered list items, bullet list items, unfinished markdown link targets, markdown reference definitions) live in `reflow_skill_md_constants.py`.

package/_shared/pr-loop/scripts/pr_converge_skill_constants/AGENTS.md

@@ -1,26 +1 @@
-# pr_converge_skill_constants
 
-Importable Python constants module for shared PR-loop convergence scripts. Script-specific constants (CLI args, markdown patterns, reflow settings) live in `pr_converge_scripts_constants/` beside this package and import from here.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `__init__.py` | Package marker |
-| `constants.py` | All runtime and API constants: bot logins, review states, GH API path templates, bugbot/bugteam detection patterns, exit codes |
-
-## Exported constants (selected)
-
-| Constant | Purpose |
-|---|---|
-| `CURSOR_BOT_LOGIN` | Login string for the Cursor bugbot reviewer |
-| `COPILOT_REVIEWER_LOGIN` | Login string for the Copilot reviewer bot |
-| `ALL_COPILOT_CLEAN_REVIEW_STATES` | Tuple of review states that count as clean for Copilot |
-| `BUGBOT_DIRTY_BODY_REGEX` | Regex that matches a bugbot review body reporting findings |
-| `GH_REVIEWS_PATH_TEMPLATE` | `gh api` path template for PR reviews |
-| `GH_INLINE_COMMENTS_PATH_TEMPLATE` | `gh api` path template for PR inline comments |
-
-## Conventions
-
-- All path templates use `str.format(**kwargs)` with keys `owner`, `repo`, `number`.
-- `packages/claude-dev-env/_shared/pr-loop/scripts/pr_converge_scripts_constants/pr_converge_constants.py` re-exports everything here via `from pr_converge_skill_constants.constants import ...` so scripts can import from either location.

package/_shared/pr-loop/scripts/pr_loop_shared_constants/AGENTS.md

@@ -1,26 +1 @@
-# pr_loop_shared_constants
 
-Named constants for every script in `_shared/pr-loop/scripts/`. Each module owns the constants for one script; the module name mirrors the script name with a `_constants` suffix.
-
-## Modules
-
-| File | Constants for |
-|---|---|
-| `claude_permissions_constants.py` | `grant_project_claude_permissions.py` and `revoke_project_claude_permissions.py` — permission rule strings and settings.json keys |
-| `claude_settings_keys_constants.py` | Top-level `~/.claude/settings.json` key names used across the permission helpers |
-| `stale_worktree_rule_sweep_constants.py` | `stale_worktree_rule_sweep.py` — the worktrees subdirectory name, the worktree path segment count, the rule-string delimiters, the `.claude` home path marker, and `get_claude_worktrees_root` |
-| `code_rules_gate_constants.py` | `code_rules_gate.py` — file extensions, git diff subcommands, test filename patterns |
-| `inline_duplicate_body_span_constants.py` | `code_rules_gate.py` — regex and capture-group indices for the same-file inline-duplicate message, which carries both the helper and the enclosing span the gate reconstructs the union from |
-| `fix_hookspath_constants.py` | `fix_hookspath.py` — verification suffix and related strings |
-| `post_audit_thread_constants.py` | `post_audit_thread.py` — HTTP status codes, retry counts, GitHub API paths |
-| `preflight_constants.py` | `preflight.py` — env-var names, git subcommands, pytest exit codes, test discovery patterns |
-| `preflight_self_heal_constants.py` | `preflight_self_heal.py` — git config keys and local-scope detection strings |
-| `reviews_disabled_constants.py` | `reviews_disabled.py` — `CLAUDE_REVIEWS_DISABLED` and `CLAUDE_REVIEWS_ENABLED` env-var names and token taxonomy |
-| `copilot_quota_constants.py` | `copilot_quota.py` — `COPILOT_QUOTA_ACCOUNT` env-var name, `copilot_internal/user` API path, the `premium_interactions` gating field names, the four skip/run exit codes, and the default `.env` path |
-| `terminology_sweep_constants.py` | `terminology_sweep.py` — identifier and prose-token regexes, diff-parsing prefixes, code-file extensions, test-file detection patterns, and the finding-message template |
-| `reviewer_availability_constants.py` | `reviewer_availability.py` — the available/down exit codes for the unified reviewer-availability pre-check |
-| `__init__.py` | Empty package marker |
-
-## Convention
-
-Every constant is `UPPER_SNAKE_CASE` with an explicit type annotation. No magic literals appear in the consuming scripts — all values live here. Test coverage for each module lives in `tests/test_<module_name>.py`.