bug-context

bug-context

Entry point of the php-src bug-fix flow. Pulls the GitHub issue, synthesises it, and writes the Context phase of SPEC.md.

Inputs

1. Issue identifier (required) — a GitHub issue number (12345), GH-12345, or full URL (https://github.com/php/php-src/issues/12345).
2. PHP_SRC_DIR (required) — resolved per _shared/php-src-detection.md (auto-detect cwd inside checkout, or honour the env var override). Refuse if neither path resolves.
3. gh CLI (required) — must be authenticated (gh auth status). If unauthenticated, stop and tell the user.

What it produces

SPEC.md in the task directory (resolved per _shared/task-dir.md; default $PHP_SRC_DIR/.claude/php-core-dev/gh-<N>/SPEC.md) with:

• Frontmatter: type: bug, linked: set to the GH issue URL, php_src_ref: set to the current git rev-parse HEAD of $PHP_SRC_DIR, target_branch: resolved per _shared/branch-detection.md (see step 6 below), created: today's date, status: in-progress.
• ## Context section with a synthesised problem statement.
• Phase skeletons (Reproduction, Analysis & Plan, Implementation, Verification) — all status: todo, with their guardrails pre-declared.
• Empty ## Open Questions.
• A first Progress Log entry.

Workflow

1. Resolve PHP_SRC_DIR and validate environment

Resolve PHP_SRC_DIR using the algorithm in _shared/php-src-detection.md (env-var override or walk-up from $PWD). If neither path resolves, refuse with the detection doc's error message — do not guess.

gh auth status >/dev/null 2>&1 || { echo "gh CLI not authenticated. Run: gh auth login"; exit 1; }

2. Resolve issue identifier

Accept any of:

• 12345
• GH-12345
• https://github.com/php/php-src/issues/12345
• https://github.com/<owner>/<repo>/issues/12345 (rare — non-php/php-src forks)

Default repo is php/php-src when only a number is given.

3. Fetch issue data

gh issue view <N> --repo php/php-src --json number,title,body,labels,state,url,comments,createdAt,author