craft:propose

Preamble (always runs — non-overridable)

1. Manifest read (lint if standalone). Probe: remote? none → propose AND integrate no-op with a note (work stays on the local branch); the run ends after documentation.
2. Cross-phase invariant check: the validation phase's run has landed or recorded a no-op, survivors are triaged, gates.phase is green. Not yet → wait; never create the PR early.

Procedure (default body — a manifest override: replaces everything below)

1. Pre-PR gate (pr.pre-pr-gate if declared): contract = check + documented remediation + documented exceptions (both live in the manifest body or a phase context file — never memory). Run it; apply the remediation in its own conventional commit; re-gate.
2. Consult push action (see docs/contributing/specs/policy.md for surface semantics). Obey the returned surface, then push -u origin <branch>.

3. Consult propose action (see docs/contributing/specs/policy.md). Obey the returned surface:

   • ask (default, ADR-127) — hand the drafted body to the user and stop (pr.creator: user behaviour); on approval proceed with the PR creation, on decline record POLICY(ask:propose→declined) and block.
   • never — refuse; record POLICY(never:propose); phase no-ops.
   • always — create the PR without stopping; record POLICY(always:propose); supersedes the pr.creator: user stop (ADR-128 — Supersede).

   Prose-lint the drafted body (advisory). Before invoking the port, write the drafted body to a temp file and scan it under the same posture the ci.sh cadence uses: resolve the gate via node "${CRAFT_ROOT:-${CLAUDE_PLUGIN_ROOT}}/engine/bin/hygiene-gate.js" <manifest-path> (default advisory), then run node "${CRAFT_ROOT:-${CLAUDE_PLUGIN_ROOT}}/engine/bin/prose-lint.js" --gate <gate> --waiver-source <body-file> -- <body-file>. Fold any SLOP-FOUND(<file>): … lines into the run record and a hygiene note in the PR body; the hygiene.gate knob and the SLOP-WAIVE(<file>) waiver are honored (the body is its own waiver source, so a deliberate ban-list word can be waived in-body). The in-body waiver is its own line, SLOP-WAIVE(<body-file>): <reason>, starting at column 0 and outside any code fence; the token mid-sentence or inside a fence waives nothing. PR body only — never the ci.sh touched-docs cadence.

   Invoke the VCS port propose(title, body) (see docs/contributing/specs/vcs.md); the adapter owns the host CLI. Body: drafted in the documentation phase per templates/pr-body.md — a Background · Intuition · Code narrative, then a Provenance & verification trailer (decisions + ADRs, design path, divergences, pinned behaviours, test plan, run record).