claude-dev-env 4.2.0 → 7.0.0

package/_shared/pr-loop/preflight-proposal.md

@@ -1,56 +0,0 @@
-# Preflight proposal contract
-
-Audit skills use this contract when the caller selects `preflight-proposal`. The mode prepares a local candidate and returns evidence for downstream selection.
-
-Each skill hub defines its command name and finding classification. Commands use this shape:
-
-```text
-<audit-skill> preflight-proposal <pr_number> --base-sha <base_sha> --head-sha <head_sha> --worktree <isolated_worktree>
-```
-
-## Required inputs
-
-| Input | Contract |
-|---|---|
-| `pr_number` | Resolved open pull-request number |
-| `--base-sha` | Full immutable base commit SHA |
-| `--head-sha` | Full immutable head commit SHA |
-| `--worktree` | Caller-supplied isolated worktree path |
-
-## Contract
-
-1. Validate every required input before the first audit command.
-2. Run `git rev-parse HEAD` in the supplied worktree and require exact equality with the head SHA.
-3. Gather changed paths and audit scope from the exact `base_sha...head_sha` range. Use the resolved PR number for PR metadata.
-4. Run the complete audit and findings against the immutable range and worktree.
-5. Keep every audit edit and test inside the caller-supplied isolated worktree.
-6. Create an immutable proposal identity. Use the existing commit SHA for committed proposals. For working-tree edits, use a deterministic diff hash over the baseline `HEAD` SHA, base SHA, head SHA, sorted normalized changed paths, status records, and file bytes.
-7. Record every changed path, including tracked, untracked, renamed, and deleted paths.
-8. Record exact tests and outcomes: each test command, exit code, and outcome.
-9. Return selected-candidate-ready proposal evidence with the proposal ID, isolated worktree path, changed paths, findings, tests, and outcomes.
-10. Keep commit, push, pull-request body, pull-request comment, pull-request review, pull-request update, merge, rebase, and Ready-state mutations disabled.
-11. Return the proposal for downstream disposition. The downstream owner adds the proposal ID to its selected or dispositioned proposal collection. Reapplication uses exactly the selected records and their changed paths. Give each later finding a new proposal ID and evidence record.
-
-## Evidence record
-
-Use this record shape:
-
-```yaml
-mode: preflight-proposal
-pr_number: <resolved PR number>
-base_sha: <immutable base SHA>
-head_sha: <immutable head SHA>
-proposal_id:
-  kind: commit-sha | diff-sha256
-  value: <immutable identity>
-isolated_worktree: <caller-supplied path>
-changed_paths:
-  - <normalized path>
-findings:
-  - <audit-classified finding>
-tests:
-  - command: <exact command>
-    exit_code: <integer>
-    outcome: <exact outcome>
-downstream_selection: required
-```