@codedrifters/configulator 0.0.184 → 0.0.186

package/lib/index.mjs

@@ -802,10 +802,23 @@ var githubWorkflowBundle = {
         "   - `fix:` \u2192 Bug",
         "   - `chore:`, `docs:`, `refactor:`, `release:`, `hotfix:` \u2192 Task",
         "4. **Identify prerequisite issues** \u2014 if the user mentions dependencies or blockers, include a **Dependencies** section in the body with `Depends on: #<issue-number>`",
-        "5. **Create the issue** using `gh issue create`:",
+        "5. **Determine labels** \u2014 every issue must be created with the following labels:",
+        "   - **`type:*`** \u2014 derived from the issue title prefix:",
+        "     - `epic:` \u2192 `type:feat`",
+        "     - `feat:` \u2192 `type:feat`",
+        "     - `fix:` \u2192 `type:fix`",
+        "     - `chore:` \u2192 `type:chore`",
+        "     - `docs:` \u2192 `type:docs`",
+        "     - `refactor:` \u2192 `type:refactor`",
+        "     - `release:` \u2192 `type:release`",
+        "     - `hotfix:` \u2192 `type:hotfix`",
+        '   - **`priority:*`** \u2014 infer from the user\'s description when possible (e.g., "urgent"/"critical" \u2192 `priority:critical`, "important" \u2192 `priority:high`, "minor"/"low priority" \u2192 `priority:low`). If the priority is unclear, ask the user before creating the issue. Valid values: `priority:critical`, `priority:high`, `priority:medium`, `priority:low`, `priority:trivial`',
+        "   - **`status:ready`** \u2014 always add unless the issue has dependencies or blockers, in which case use `status:blocked`",
+        "6. **Create the issue** using `gh issue create`:",
         "   - `--title '<type>: <description>'`",
         "   - `--body '<issue body>'`",
         "   - `--type '<GitHub issue type>'` (Epic, Feature, Bug, or Task)",
+        "   - `--label '<type-label>' --label '<priority-label>' --label '<status-label>'`",
         "",
         "### Issue Body Template",
         "",
@@ -827,7 +840,9 @@ var githubWorkflowBundle = {
         "",
         "- Always use the conventional prefix in the issue title",
         "- Always assign the correct GitHub issue type",
+        "- Always include `type:*`, `priority:*`, and `status:*` labels",
         "- If the user does not specify a type, ask before creating the issue",
+        "- If the priority cannot be inferred from the description, ask the user before creating the issue",
         "- Keep titles concise and descriptive"
       ].join("\n"),
       tags: ["workflow"]
@@ -1758,6 +1773,152 @@ var orchestratorSubAgent = {
     "5. **Priority order:** critical > high > medium > low > trivial, then FIFO by issue number."
   ].join("\n")
 };
+var issueWorkerSubAgent = {
+  name: "issue-worker",
+  description: "Selects the next ready issue from the queue, claims it, and implements the change end-to-end following repository conventions",
+  model: AGENT_MODEL.POWERFUL,
+  maxTurns: 50,
+  canDelegateToAgents: [],
+  platforms: { cursor: { exclude: true } },
+  prompt: [
+    "# Issue Worker",
+    "",
+    "You are the issue worker for **{{repository.owner}}/{{repository.name}}**.",
+    "Your job is to pick the next issue from the queue, claim it, and implement",
+    "the change end-to-end \u2014 from branch creation through to opening a PR.",
+    "",
+    "---",
+    "",
+    "## Phase 1: Select an Issue",
+    "",
+    "If an issue number was provided in your instructions, use that issue.",
+    "Otherwise, find the next issue to work on:",
+    "",
+    "```bash",
+    ".claude/procedures/check-blocked.sh eligible",
+    "```",
+    "",
+    "This returns issues sorted by priority (critical > high > medium > low > trivial),",
+    "then by issue number (FIFO). Take the **first** `PICK` line.",
+    "",
+    "If the output is `NO_READY_ISSUES`, report that the queue is empty and stop.",
+    "",
+    "If any `SKIP` lines appear, ignore them \u2014 those issues have unresolved dependencies.",
+    "",
+    "## Phase 2: Claim the Issue",
+    "",
+    "```bash",
+    'gh issue edit <number> --remove-label "status:ready" --add-label "status:in-progress"',
+    "```",
+    "",
+    "Read the full issue details:",
+    "```bash",
+    "gh issue view <number>",
+    "```",
+    "",
+    "## Phase 3: Set Up",
+    "",
+    "```bash",
+    "git checkout {{repository.defaultBranch}} && git pull origin {{repository.defaultBranch}}",
+    "```",
+    "",
+    "Determine the branch type from the issue's `type:*` label or title prefix:",
+    "",
+    "| Label / prefix | Branch type |",
+    "|---------------|-------------|",
+    "| `type:feat` / `feat:` | `feat/` |",
+    "| `type:fix` / `fix:` | `fix/` |",
+    "| `type:chore` / `chore:` | `chore/` |",
+    "| `type:refactor` / `refactor:` | `refactor/` |",
+    "| `type:docs` / `docs:` | `docs/` |",
+    "| `type:release` / `release:` | `release/` |",
+    "| `type:hotfix` / `hotfix:` | `hotfix/` |",
+    "| No type label | `feat/` (default) |",
+    "",
+    "Create a branch following the naming convention:",
+    "```bash",
+    "git checkout -b <type>/<issue-number>-<slug>",
+    "```",
+    "",
+    "The slug should be a short (3-5 word) kebab-case summary derived from the issue title.",
+    "",
+    "Link the branch to the issue:",
+    "```bash",
+    "gh issue comment <number> --body 'Branch: `<branch-name>`'",
+    "```",
+    "",
+    "## Phase 4: Implement",
+    "",
+    "Read the issue body carefully. Understand the acceptance criteria.",
+    "",
+    "Implement the change following these guidelines based on issue type:",
+    "",
+    "- **feat**: Implement the new feature. Add tests. Export public APIs from `index.ts`.",
+    "- **fix**: Reproduce the bug first. Write a failing test. Fix the bug. Verify the test passes.",
+    "- **chore**: Make the maintenance change. Verify no regressions.",
+    "- **refactor**: Restructure code without changing behavior. Existing tests must pass unchanged.",
+    "- **docs**: Update documentation only. Do not change source code.",
+    "",
+    "Follow all conventions from CLAUDE.md and the project's agent rules.",
+    "",
+    "## Phase 5: Verify",
+    "",
+    "Run the appropriate verification commands depending on what changed:",
+    "",
+    "1. If Projen config was changed: `npx projen && pnpm install`",
+    "2. Compile the affected package: `pnpm --filter @codedrifters/<package> compile`",
+    "3. Test the affected package: `pnpm --filter @codedrifters/<package> test`",
+    "4. If changes span multiple packages: `pnpm build:all`",
+    "",
+    "Fix any compilation errors, test failures, or lint errors before proceeding.",
+    "",
+    "## Phase 6: Commit and Push",
+    "",
+    "Use conventional commit messages:",
+    "```bash",
+    "git add <files>",
+    'git commit -m "<type>: <description>"',
+    "git push -u origin <branch-name>",
+    "```",
+    "",
+    "## Phase 7: Open a PR",
+    "",
+    "```bash",
+    'gh pr create --title "<type>(<scope>): <description>" --body "## Summary',
+    "",
+    "<bullet points>",
+    "",
+    'Closes #<issue-number>"',
+    "```",
+    "",
+    "Enable auto-merge:",
+    "```bash",
+    "gh pr merge --auto --squash",
+    "```",
+    "",
+    "## Phase 8: Update Status",
+    "",
+    "After the PR is created:",
+    "```bash",
+    'gh issue edit <number> --add-label "status:done"',
+    "```",
+    "",
+    "---",
+    "",
+    "## Rules",
+    "",
+    "1. **One issue per session.** Process exactly ONE issue, then stop.",
+    "2. **Use check-blocked.sh.** Always use the procedure script for issue selection.",
+    "3. **Follow CLAUDE.md conventions** for branch naming, commits, and PRs.",
+    "4. **Do not assign PRs to a project board** \u2014 this repo has no GitHub project.",
+    "5. **Do not add AI co-author** attribution to commits.",
+    "6. **On failure:** If you cannot complete the issue, update labels and leave a comment:",
+    "   ```bash",
+    '   gh issue edit <number> --remove-label "status:in-progress" --add-label "status:needs-attention"',
+    '   gh issue comment <number> --body "Worker could not complete: <reason>"',
+    "   ```"
+  ].join("\n")
+};
 var orchestratorBundle = {
   name: "orchestrator",
   description: "Pipeline orchestrator agent for issue triage, PR review, and queue management",
@@ -1787,7 +1948,7 @@ var orchestratorBundle = {
       tags: ["workflow"]
     }
   ],
-  subAgents: [orchestratorSubAgent],
+  subAgents: [orchestratorSubAgent, issueWorkerSubAgent],
   procedures: [checkBlockedProcedure],
   claudePermissions: {
     allow: [
@@ -3245,6 +3406,12 @@ var ClaudeRenderer = class _ClaudeRenderer {
       if (agent.platforms?.claude?.memory) {
         lines.push(`memory: ${agent.platforms.claude.memory}`);
       }
+      if (agent.canDelegateToAgents && agent.canDelegateToAgents.length > 0) {
+        lines.push(`canDelegateToAgents:`);
+        for (const delegateName of agent.canDelegateToAgents) {
+          lines.push(`  - "${delegateName}"`);
+        }
+      }
       lines.push("---");
       lines.push("");
       lines.push(...agent.prompt.split("\n"));