issue-reconcile

/issue-close-stage + /issue-close-finalize is the sanctioned close path inside Claude Code, but the enforce-issue-close.js hook only covers Claude Code's Bash tool. Issues closed elsewhere have no <!-- issue-close-sentinel: appended --> comment and never trigger doc-append. This skill walks closed issues, detects missing sentinels, and backfills entries.

Usage: /issue-reconcile

Pre-flight

• AGENTS_CONFIG_DIR must be set.
• Read rules/github-issues.md — on-demand-only, never auto-injected.

Step 1: pre-resolve

Resolve in main: OWNER_REPO=$(gh repo view --json owner,name --jq '.owner.login + "/" + .name'), HISTORY_MD_PATH (absolute path to docs/history.md), HISTORY_DIR_PATH (absolute path to docs/history/ directory).

Step 2: scan via worker

Dispatch the issue-reconcile worker per skills/_shared/worker-dispatch.md. Payload: owner_repo, history_md_path, history_dir_path, artifact_dir (the PLANS_DIR from WD-1), limit (omit for the 1000-issue default).

On status: failed: stop and report. A scan truncated at <N> summary means the closed-issue scan hit limit — re-dispatch with a higher limit rather than acting on the partial result. On status: complete: read the JSONL artifact — issues with classification: needs-reconcile feed Step 3.

Step 3: prompt and append

For each non-clean issue, show the user:

• Issue number, title, closedAt
• Classification (sentinel-only / unappended)
• The Background/Changes (or Cause/Fix) the entry would carry

Ask whether to append, skip, or stop.

On "append":

# Fetch current docs/history.md into a staging file, append via --target,
# validate, then PUT to GitHub via the Contents API. The ISSUE_CLOSE_SKILL=1
# env-var bypass was removed in #672.
STAGING_DIR="$(bash "$AGENTS_CONFIG_DIR/bin/workflow-plans-dir")"
STAGE="$STAGING_DIR/reconcile-${NUM}-history.md"
OWNER_REPO=$(gh repo view --json owner,name --jq '.owner.login + "/" + .name')
DEF=$(gh api "repos/$OWNER_REPO" --jq '.default_branch')
gh api "repos/$OWNER_REPO/contents/docs/history.md?ref=$DEF" \
    | jq -r '.content' | tr -d '\r\n' | base64 -d > "$STAGE"
bash "$AGENTS_CONFIG_DIR/bin/github-issues/issue-to-history.sh" "$NUM" --target "$STAGE" --allow-backdate
bash "$AGENTS_CONFIG_DIR/bin/lib/github-contents-write.sh" \
    --owner "${OWNER_REPO%%/*}" --repo "${OWNER_REPO#*/}" \
    --path docs/history.md --file "$STAGE" \
    --message "docs(history): record issue #$NUM" --branch "$DEF"
rm -f "$STAGE"