@astrosheep/keiyaku 4.5.9 → 4.5.10

package/build/integrations/marketplace/plugins/keiyaku/skills/keiyaku-workflow/SKILL.md

@@ -266,25 +266,29 @@ Deliver when the worktree content is the candidate you intend to land:
 keiyaku deliver <contract> --include-dirty
 ```
 
-Use `--include-dirty` only when the complete current workspace is the intended
-candidate; otherwise commit the intended bytes first. Read the receipt for the
-candidate, gate/placement stop, and any physical-effect lag. A not-complete
-delivery is still a recorded `tendered` candidate.
-
-`deliver` freshly tenders the candidate and requests placement. A current audit
-attestation is reused only when its integration snapshot and Verification
-segment still match; changes to the worktree, target, policy, document,
-Verification, or snapshot-producing options make it stale.
+Deliver when the work is ready to be judged, not when Git looks tidy. `git
+commit` only shapes the candidate; skipping it is fine — `deliver
+--include-dirty` captures the complete non-ignored worktree. Deliver and review
+answer different questions: deliver records the candidate and places and claims
+by itself only when every placement obligation is current; a review gate is
+satisfied only by review testimony over the current candidate, and a satisfied
+review may itself be the invocation that places and claims. Reviewing before any
+delivery is legal but records testimony only — it creates no candidate and
+authorizes nothing. A Contract without a review gate needs no review.
+
+A current audit attestation is reused only when its integration snapshot and
+Verification segment still match; changes to the worktree, target, policy,
+document, Verification, or snapshot-producing options make it stale.
 
 ## Review Gates
 
 The Reviewer owns the answer. A gate review compares the full current candidate
 against every journaled Criterion — the floor that cannot be reduced — and
 testifies satisfied or unsatisfied over the current document identity and
-worktree; satisfied requests placement. A current defect, missing, failed, or
-stale required evidence, or terms too ambiguous or contradictory to judge all
-yield unsatisfied, with the summary naming what blocks. Advice beyond the terms
-belongs in the summary and never changes the verdict by itself.
+worktree. A current defect, missing, failed, or stale required evidence, or
+terms too ambiguous or contradictory to judge all yield unsatisfied, with the
+summary naming what blocks. Advice beyond the terms belongs in the summary and
+never changes the verdict by itself.
 
 ```bash
 keiyaku review <contract> --satisfied --summary "<conclusion>"

package/build/src/cli/commands/contract.d.ts

@@ -134,7 +134,7 @@ export declare const CONTRACT_COMMAND_SPECS: {
             readonly json: "boolean";
         };
         readonly usage: "deliver [<contract>|@<contract>] [--message <text>] [--include-dirty] [--materialize-conflict] [--json]";
-        readonly purpose: "Deliver one Contract candidate from the appointed worktree.";
+        readonly purpose: "Deliver your work as this Contract's candidate.";
         readonly details: string;
     };
     readonly review: {

package/build/src/cli/commands/contract.js

@@ -52,11 +52,18 @@ export const CONTRACT_COMMAND_SPECS = {
             json: "boolean",
         },
         usage: "deliver [<contract>|@<contract>] [--message <text>] [--include-dirty] [--materialize-conflict] [--json]",
-        purpose: "Deliver one Contract candidate from the appointed worktree.",
+        purpose: "Deliver your work as this Contract's candidate.",
         details: [
-            "  --include-dirty         Capture the complete non-ignored worktree tree as the",
-            "                          candidate; stages nothing, commits nothing, including",
-            "                          an unmerged shared index.",
+            "A clean worktree delivers its HEAD; --include-dirty captures every non-ignored",
+            "byte as an immutable commit object without changing the appointed worktree's HEAD",
+            "or real index. Runs or reuses Verification and requests placement: when every",
+            "prerequisite and declared gate is current, the same invocation places and claims.",
+            "Otherwise the candidate is recorded and the Contract is tendered. A prior git",
+            "commit is optional preparation — it never delivers, and delivering never",
+            "satisfies a review gate.",
+            "",
+            "  --include-dirty         Include all non-ignored worktree bytes, including an",
+            "                          unmerged shared index, in the candidate commit.",
             "  --materialize-conflict  After a conflict result, project the judged targetHead",
             "                          into the worktree as an uncommitted merge. Not a",
             "                          delivery: resolve, then deliver with --include-dirty.",

package/build/src/contract-guidance.js

@@ -19,6 +19,9 @@ export const CONTRACT_DELIVERER_SKILL = [
     "",
     "## Deliver",
     "",
+    "`deliver` creates the immutable candidate commit. When the finished worktree itself is the candidate, use `deliver --include-dirty`;",
+    "Keiyaku captures its complete non-ignored state without moving this worktree's HEAD or real index.",
+    "",
     "```bash",
     "keiyaku deliver <contract> --include-dirty",
     "keiyaku deliver <contract> --materialize-conflict",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/keiyaku",
-  "version": "4.5.9",
+  "version": "4.5.10",
   "files": [
     "build"
   ],