@codedrifters/configulator 0.0.227 → 0.0.228

package/lib/index.mjs

@@ -2190,6 +2190,148 @@ var companyProfileBundle = {
 
 // src/agent/bundles/github-workflow.ts
 import { GitHub } from "projen/lib/github";
+var setIssueTypeProcedure = {
+  name: "set-issue-type.sh",
+  description: "Assign a GitHub issue type (Feature / Task / Epic / Bug / etc.) via the updateIssueIssueType GraphQL mutation in a single step",
+  content: [
+    "#!/usr/bin/env bash",
+    "# set-issue-type.sh \u2014 Assign a GitHub issue type in one step.",
+    "#",
+    "# Wraps the two-step GraphQL flow used to set an issue's type:",
+    "#   1. Look up the repo's issue type node IDs.",
+    "#   2. Call the updateIssueIssueType mutation.",
+    "#",
+    "# Usage:",
+    "#   .claude/procedures/set-issue-type.sh <issue-number> <type-name>",
+    "#",
+    "# Where <type-name> is the human-readable GitHub issue type name",
+    "# (e.g. Feature, Task, Epic, Bug). Matching is case-insensitive.",
+    "#",
+    "# Exits 0 on success. Exits non-zero with a clear diagnostic on stderr",
+    "# for any validation error or API failure.",
+    "",
+    "set -uo pipefail",
+    "",
+    "# \u2500\u2500 helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    "err() {",
+    '  printf "set-issue-type.sh: %s\\n" "$*" >&2',
+    "}",
+    "",
+    "usage() {",
+    "  cat >&2 <<'USAGE'",
+    "Usage: set-issue-type.sh <issue-number> <type-name>",
+    "",
+    "  <issue-number>  Positive integer GitHub issue number.",
+    "  <type-name>     Human-readable issue type (Feature, Task, Epic, Bug,",
+    "                  or any type defined at the org level). Case-insensitive.",
+    "",
+    "Examples:",
+    "  set-issue-type.sh 123 Feature",
+    "  set-issue-type.sh 456 bug",
+    "USAGE",
+    "}",
+    "",
+    "# \u2500\u2500 argument validation \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    "if [[ $# -ne 2 ]]; then",
+    '  err "expected 2 arguments, got $#"',
+    "  usage",
+    "  exit 2",
+    "fi",
+    "",
+    'issue_number="$1"',
+    'type_name="$2"',
+    "",
+    'if ! [[ "$issue_number" =~ ^[1-9][0-9]*$ ]]; then',
+    `  err "issue number must be a positive integer (got: '$issue_number')"`,
+    "  exit 2",
+    "fi",
+    "",
+    'if [[ -z "${type_name// /}" ]]; then',
+    '  err "type name must be non-empty"',
+    "  exit 2",
+    "fi",
+    "",
+    "# \u2500\u2500 dependency checks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    "for cmd in gh jq; do",
+    '  if ! command -v "$cmd" >/dev/null 2>&1; then',
+    '    err "required command not found on PATH: $cmd"',
+    "    exit 3",
+    "  fi",
+    "done",
+    "",
+    "# \u2500\u2500 resolve repo owner/name \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    "repo_json=$(gh repo view --json owner,name 2>/dev/null)",
+    'if [[ -z "$repo_json" ]]; then',
+    `  err "could not resolve owning repo via 'gh repo view' (not a GitHub repo or gh not authenticated?)"`,
+    "  exit 4",
+    "fi",
+    "",
+    `owner=$(echo "$repo_json" | jq -r '.owner.login // empty')`,
+    `name=$(echo "$repo_json" | jq -r '.name // empty')`,
+    "",
+    'if [[ -z "$owner" || -z "$name" ]]; then',
+    '  err "could not parse owner/name from gh repo view output"',
+    "  exit 4",
+    "fi",
+    "",
+    "# \u2500\u2500 look up issue type node ID \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    "types_json=$(gh api graphql \\",
+    "  -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){issueTypes(first:50){nodes{id name}}}}' \\",
+    '  -f owner="$owner" -f repo="$name" 2>/dev/null)',
+    "",
+    'if [[ -z "$types_json" ]]; then',
+    '  err "failed to query repo issue types via GraphQL"',
+    "  exit 5",
+    "fi",
+    "",
+    `types_nodes=$(echo "$types_json" | jq -c '.data.repository.issueTypes.nodes // []')`,
+    "",
+    'if [[ "$types_nodes" == "[]" || "$types_nodes" == "null" ]]; then',
+    '  err "repo ${owner}/${name} has no issue types defined"',
+    "  exit 5",
+    "fi",
+    "",
+    "# Case-insensitive match by name.",
+    `type_id=$(echo "$types_nodes" | jq -r --arg n "$type_name" '`,
+    "  .[] | select((.name | ascii_downcase) == ($n | ascii_downcase)) | .id",
+    "' | head -n 1)",
+    "",
+    'if [[ -z "$type_id" ]]; then',
+    `  available=$(echo "$types_nodes" | jq -r '.[].name' | paste -sd ',' - | sed 's/,/, /g')`,
+    "  err \"type '${type_name}' not found in ${owner}/${name}. Available types: ${available}\"",
+    "  exit 6",
+    "fi",
+    "",
+    "# \u2500\u2500 look up issue node ID \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    `issue_id=$(gh issue view "$issue_number" --json id -q '.id' 2>/dev/null || echo "")`,
+    "",
+    'if [[ -z "$issue_id" ]]; then',
+    '  err "issue #${issue_number} not found in ${owner}/${name}"',
+    "  exit 7",
+    "fi",
+    "",
+    "# \u2500\u2500 apply the mutation \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    "result=$(gh api graphql \\",
+    "  -f query='mutation($issueId:ID!,$typeId:ID!){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$typeId}){issue{number issueType{name}}}}' \\",
+    '  -f issueId="$issue_id" -f typeId="$type_id" 2>&1)',
+    "mutation_exit=$?",
+    "",
+    "if [[ $mutation_exit -ne 0 ]]; then",
+    '  err "updateIssueIssueType mutation failed: ${result}"',
+    "  exit 8",
+    "fi",
+    "",
+    "# Print the resulting {number, issueType: {name}} JSON line.",
+    `echo "$result" | jq -c '.data.updateIssueIssueType.issue'`
+  ].join("\n")
+};
 var githubWorkflowBundle = {
   name: "github-workflow",
   description: "GitHub issue and PR workflow automation patterns",
@@ -2252,19 +2394,20 @@ var githubWorkflowBundle = {
         "   - `--title '<type>: <description>'`",
         "   - `--body '<issue body>'`",
         "   - `--label '<type-label>' --label '<priority-label>' --label '<status-label>'`",
-        "7. **Set the GitHub issue type** via the GraphQL `updateIssueIssueType` mutation:",
-        "   - Look up the issue's node ID: `gh issue view <issue-number> --json id -q .id`",
-        "   - Look up the repo's issue type node IDs (one-time, can be cached):",
+        "7. **Set the GitHub issue type** by invoking the `set-issue-type.sh` helper (shipped with this bundle):",
+        "",
+        "   ```sh",
+        "   .claude/procedures/set-issue-type.sh <issue-number> <Feature|Task|Epic|Bug>",
+        "   ```",
         "",
-        "     ```sh",
-        "     gh api graphql -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){issueTypes(first:20){nodes{id name}}}}' -f owner=<owner> -f repo=<repo>",
-        "     ```",
+        "   The helper resolves owner/repo, looks up the issue type node ID, looks up the issue node ID, and applies the `updateIssueIssueType` mutation in one step. It exits non-zero with a clear diagnostic on any error and lists available types if the type name is not recognised.",
         "",
-        "   - Apply the chosen type to the issue:",
+        "   **Under the hood** (documented fallback if the helper is unavailable): the helper performs a two-step GraphQL flow \u2014 first a `repository(...).issueTypes` query to map the human-readable type name to a node ID, then the `updateIssueIssueType` mutation. The canonical queries are:",
         "",
-        "     ```sh",
-        "     gh api graphql -f query='mutation($issueId:ID!,$typeId:ID!){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$typeId}){issue{number issueType{name}}}}' -f issueId=<issue-node-id> -f typeId=<issue-type-node-id>",
-        "     ```",
+        "   ```sh",
+        "   gh api graphql -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){issueTypes(first:50){nodes{id name}}}}' -f owner=<owner> -f repo=<repo>",
+        "   gh api graphql -f query='mutation($issueId:ID!,$typeId:ID!){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$typeId}){issue{number issueType{name}}}}' -f issueId=<issue-node-id> -f typeId=<issue-type-node-id>",
+        "   ```",
         "",
         "### Issue Body Template",
         "",
@@ -2285,7 +2428,7 @@ var githubWorkflowBundle = {
         "### Important",
         "",
         "- Always use the conventional prefix in the issue title",
-        "- Always assign the correct GitHub issue type via the `updateIssueIssueType` GraphQL mutation (step 7) \u2014 never via `gh issue create --type`",
+        "- Always assign the correct GitHub issue type via the `set-issue-type.sh` helper (step 7) \u2014 never via `gh issue create --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",
@@ -2337,7 +2480,8 @@ var githubWorkflowBundle = {
       ].join("\n"),
       tags: ["workflow"]
     }
-  ]
+  ],
+  procedures: [setIssueTypeProcedure]
 };
 
 // src/agent/bundles/industry-discovery.ts