@codedrifters/configulator 0.0.212 → 0.0.213

package/docs/label-taxonomy.md

@@ -20,9 +20,10 @@ regardless of which specific agent bundles a project enables.
 
 Families in this tier:
 
-- **`status:*`** — workflow state (`ready`, `in-progress`, `blocked`,
-  `done`, `deferred`, `needs-attention`). Required by every agent that
-  transitions issues through the workflow.
+- **`status:*`** — workflow state (`ready`, `in-progress`,
+  `ready-for-review`, `blocked`, `done`, `deferred`,
+  `needs-attention`). Required by every agent that transitions issues
+  through the workflow.
 - **`priority:*`** — scheduling priority (`critical`, `high`, `medium`,
   `low`, `trivial`). Required by the orchestrator to sequence work.
 - **`type:*`** — conventional-commit work type (`feat`, `fix`, `docs`,

package/lib/index.js

@@ -792,9 +792,10 @@ var baseBundle = {
         "|-------|----------|",
         "| `status:ready` | The issue is fully specified, has no open blockers, and is available for a worker to pick up. |",
         "| `status:blocked` | The issue cannot be started yet \u2014 either it declares `Depends on: #N` on an open issue, or it is an epic with one or more open children. |",
-        "| `status:in-progress` | A worker has claimed the issue and a branch exists. Set when the worker starts; cleared only on completion or failure. |",
+        "| `status:in-progress` | A worker has claimed the issue and a branch exists. Set when the worker starts; cleared only when the worker opens a PR or the issue fails. |",
+        "| `status:ready-for-review` | A PR has been opened for this issue and is awaiting review and merge. Replaces `status:in-progress` at the moment the PR opens. |",
         "| `status:needs-attention` | Automated triage has flagged the issue for human review (stale, failed worker, or ambiguous state). Humans reset this label manually. |",
-        "| `status:done` | The change has shipped. Usually set when the PR merges and the issue closes. |",
+        "| `status:done` | The change has shipped. Set when the PR merges and the issue closes. |",
         "",
         "### Blocking Rules",
         "",
@@ -816,9 +817,9 @@ var baseBundle = {
         "  either blocking rule applies.",
         "- **Worker claims the issue** \u2192 remove `status:ready`, add",
         "  `status:in-progress`. A branch must exist before this transition.",
-        "- **Worker opens a PR** \u2192 leave `status:in-progress` in place until the",
-        "  PR merges. Do not pre-flip to `status:done`.",
-        "- **PR merges / issue closes** \u2192 remove `status:in-progress`, add",
+        "- **Worker opens a PR** \u2192 remove `status:in-progress`, add",
+        "  `status:ready-for-review`. The PR URL should be posted on the issue.",
+        "- **PR merges / issue closes** \u2192 remove `status:ready-for-review`, add",
         "  `status:done`.",
         "- **Dependency resolves** \u2192 if the issue was `status:blocked` solely because",
         "  of the dependency-blocking rule, remove `status:blocked` and add",
@@ -835,8 +836,9 @@ var baseBundle = {
         "  by CI. Those are expected self-healing behaviors, not failures.",
         "",
         "An issue must always carry exactly one of `status:ready`, `status:blocked`,",
-        "`status:in-progress`, or `status:done`. The `status:needs-attention` label",
-        "is additive \u2014 it coexists with whichever of those four applies."
+        "`status:in-progress`, `status:ready-for-review`, or `status:done`. The",
+        "`status:needs-attention` label is additive \u2014 it coexists with whichever of",
+        "those five applies."
       ].join("\n"),
       tags: ["workflow"]
     },
@@ -4358,11 +4360,14 @@ var issueWorkerSubAgent = {
     "",
     "## Phase 8: Update Status",
     "",
-    "After the PR is created:",
+    "After the PR is created, transition the issue to the review phase:",
     "```bash",
-    'gh issue edit <number> --remove-label "status:in-progress" --add-label "status:done"',
+    'gh issue edit <number> --remove-label "status:in-progress" --add-label "status:ready-for-review"',
     "```",
     "",
+    "Do **not** set `status:done` here \u2014 the `pr-reviewer` sub-agent is",
+    "responsible for that transition once the PR successfully merges.",
+    "",
     "## Phase 9: Branch Cleanup",
     "",
     "The PR will not auto-merge until the `pr-reviewer` enables it. Poll the PR",
@@ -5251,6 +5256,14 @@ var prReviewerSubAgent = {
     "  git fetch --prune origin",
     "  git branch -d <branch-name> 2>/dev/null || git branch -D <branch-name> 2>/dev/null || true",
     "  ```",
+    "  Transition the linked issue to `status:done` (replaces whichever of",
+    "  `status:ready-for-review` or `status:in-progress` it was carrying):",
+    "  ```bash",
+    "  gh issue edit <issue-number> \\",
+    '    --remove-label "status:ready-for-review" \\',
+    '    --remove-label "status:in-progress" \\',
+    '    --add-label "status:done"',
+    "  ```",
     "  Then check the linked issue state:",
     "  ```bash",
     "  gh issue view <issue-number> --json state --jq '.state'",
@@ -9889,6 +9902,11 @@ var DEFAULT_STATUS_LABELS = [
     color: "FBCA04",
     description: "Actively being worked on"
   },
+  {
+    name: "status:ready-for-review",
+    color: "1D76DB",
+    description: "PR opened and awaiting review"
+  },
   {
     name: "status:blocked",
     color: "D93F0B",