~/.claude/skills/gstack/bin/gstack-review-read

+====================================================================+
|                    REVIEW READINESS DASHBOARD                       |
+====================================================================+
Review
Runs
Last Run
Status
Required
Eng Review
1
2026-03-16 15:00
CLEAR
YES
CEO Review
0
—
—
no
Design Review
0
—
—
no
Adversarial
0
—
—
no
Outside Voice
0
—
—
no
+--------------------------------------------------------------------+
| VERDICT: CLEARED — Eng Review passed                                |
+====================================================================+

1. Check if the diff adds a new cmd/ directory, main.go, or bin/ entry point:

git diff origin/<base> --name-only | grep -E '(cmd/./main\.go|bin/|Cargo\.toml|setup\.py|package\.json)' | head -5

2. If new artifact detected, check for a release workflow:

ls .github/workflows/ 2>/dev/null | grep -iE 'release|publish|dist'
   grep -qE 'release|publish|deploy' .gitlab-ci.yml 2>/dev/null && echo "GITLAB_CI_RELEASE"

3. If no release pipeline exists and a new artifact was added: Use AskUserQuestion:
- "This PR adds a new binary/tool but there's no CI/CD pipeline to build and publish it. Users won't be able to download the artifact after merge." - A) Add a release workflow now (CI/CD release pipeline — GitHub Actions or GitLab CI depending on platform) - B) Defer — add to TODOS.md - C) Not needed — this is internal/web-only, existing deployment covers it
4. If release pipeline exists: Continue silently.
5. If no new artifact detected: Skip silently.

Step 3: Merge the base branch (BEFORE tests)

Fetch and merge the base branch into the feature branch so tests run against the merged state:

git fetch origin <base> && git merge origin/<base> --no-edit

Step 4: Test Framework Bootstrap

Test Framework Bootstrap

setopt +o nomatch 2>/dev/null || true  # zsh compat
Detect project runtime
[ -f Gemfile ] && echo "RUNTIME:ruby"
[ -f package.json ] && echo "RUNTIME:node"
[ -f requirements.txt ] || [ -f pyproject.toml ] && echo "RUNTIME:python"
[ -f go.mod ] && echo "RUNTIME:go"
[ -f Cargo.toml ] && echo "RUNTIME:rust"
[ -f composer.json ] && echo "RUNTIME:php"
[ -f mix.exs ] && echo "RUNTIME:elixir"
Detect sub-frameworks
[ -f Gemfile ] && grep -q "rails" Gemfile 2>/dev/null && echo "FRAMEWORK:rails"
[ -f package.json ] && grep -q '"next"' package.json 2>/dev/null && echo "FRAMEWORK:nextjs"
Check for existing test infrastructure
ls jest.config. vitest.config. playwright.config. .rspec pytest.ini pyproject.toml phpunit.xml 2>/dev/null
ls -d test/ tests/ spec/ __tests__/ cypress/ e2e/ 2>/dev/null
Check opt-out marker
[ -f .gstack/no-test-bootstrap ] && echo "BOOTSTRAP_DECLINED"

# Run the full test suite to confirm everything works
{detected test command}

# Check CI provider
ls -d .github/ 2>/dev/null && echo "CI:github"
ls .gitlab-ci.yml .circleci/ bitrise.yml 2>/dev/null

git status --porcelain

bin/test-lane 2>&1 | tee /tmp/ship_tests.txt &
npm run test 2>&1 | tee /tmp/ship_vitest.txt &
wait

• Find who likely broke it. Check BOTH the test file AND the production code it tests:

# Who last touched the failing test?
  git log --format="%an (%ae)" -1 -- <failing-test-file>
  # Who last touched the production code the test covers? (often the actual breaker)
  git log --format="%an (%ae)" -1 -- <source-file-under-test>

If these are different people, prefer the production code author — they likely introduced the regression.
• Create an issue assigned to that person (use the platform detected in Step 0):
- If GitHub:

gh issue create \
      --title "Pre-existing test failure: <test-name>" \
      --body "Found failing on branch <current-branch>. Failure is pre-existing.\n\nError:\n

\n\n``\n\nLast modified by: \nNoticed by: gstack /ship on " \ --assignee "" CODEBLOCK_32_ENDbash glab issue create \ -t "Pre-existing test failure: " \ -d "Found failing on branch . Failure is pre-existing.\n\nError:\n`\n\n`\n\nLast modified by: \nNoticed by: gstack /ship on " \ -a "" CODEBLOCK_33_ENDbash git diff origin/ --name-only CODEBLOCK_34_ENDbash grep -l "changed_file_basename" test/evals/_eval_runner.rb CODEBLOCK_35_ENDbash EVAL_JUDGE_TIER=full EVAL_VERBOSE=1 bin/test-lane --eval test/evals/_eval_test.rb 2>&1 | tee /tmp/ship_evals.txt CODEBLOCK_36_ENDbash setopt +o nomatch 2>/dev/null || true # zsh compat

Detect project runtime

[ -f Gemfile ] && echo "RUNTIME:ruby" [ -f package.json ] && echo "RUNTIME:node" [ -f requirements.txt ] || [ -f pyproject.toml ] && echo "RUNTIME:python" [ -f go.mod ] && echo "RUNTIME:go" [ -f Cargo.toml ] && echo "RUNTIME:rust"

Check for existing test infrastructure

ls jest.config. vitest.config. playwright.config. cypress.config. .rspec pytest.ini phpunit.xml 2>/dev/null ls -d test/ tests/ spec/ __tests__/ cypress/ e2e/ 2>/dev/null CODEBLOCK_37_ENDbash

Count test files before any generation

find . -name '.test.' -o -name '.spec.' -o -name '_test.' -o -name '_spec.' | grep -v node_modules | wc -l CODEBLOCK_38_END CODE PATHS USER FLOWS [+] src/services/billing.ts [+] Payment checkout ├── processPayment() ├── [★★★ TESTED] Complete purchase — checkout.e2e.ts:15 │ ├── [★★★ TESTED] happy + declined + timeout ├── [GAP] [→E2E] Double-click submit │ ├── [GAP] Network timeout └── [GAP] Navigate away mid-payment │ └── [GAP] Invalid currency └── refundPayment() [+] Error states ├── [★★ TESTED] Full refund — :89 ├── [★★ TESTED] Card declined message └── [★ TESTED] Partial (non-throw only) — :101 └── [GAP] Network timeout UX

LLM integration: [GAP] [→EVAL] Prompt template change — needs eval test

COVERAGE: 5/13 paths tested (38%) | Code paths: 3/5 (60%) | User flows: 2/8 (25%) QUALITY: ★★★:2 ★★:2 ★:1 | GAPS: 8 (2 E2E, 1 eval) CODEBLOCK_39_ENDbash

Count test files after generation

find . -name '.test.' -o -name '.spec.' -o -name '_test.' -o -name '_spec.' | grep -v node_modules | wc -l CODEBLOCK_40_ENDbash eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" && mkdir -p ~/.gstack/projects/$SLUG USER=$(whoami) DATETIME=$(date +%Y%m%d-%H%M%S) CODEBLOCK_41_ENDmarkdown

Test Plan

Generated by /ship on {date} Branch: {branch} Repo: {owner/repo}

Affected Pages/Routes

• {URL path} — {what to test and why}

Key Interactions to Verify

• {interaction description} on {page}

Edge Cases

• {edge case} on {page}

Critical Paths

• {end-to-end flow that must work}
CODEBLOCK_42_ENDbash setopt +o nomatch 2>/dev/null || true # zsh compat BRANCH=$(git branch --show-current 2>/dev/null | tr '/' '-') REPO=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)")

Compute project slug for ~/.gstack/projects/ lookup

_PLAN_SLUG=$(git remote get-url origin 2>/dev/null | sed 's|.[:/]\([^/]/[^/]\)\.git$|\1|;s|.[:/]\([^/]/[^/]\)$|\1|' | tr '/' '-' | tr -cd 'a-zA-Z0-9._-') || true _PLAN_SLUG="${_PLAN_SLUG:-$(basename "$PWD" | tr -cd 'a-zA-Z0-9._-')}"

Search common plan file locations (project designs first, then personal/local)

for PLAN_DIR in "$HOME/.gstack/projects/$_PLAN_SLUG" "$HOME/.claude/plans" "$HOME/.codex/plans" ".gstack/plans"; do [ -d "$PLAN_DIR" ] || continue PLAN=$(ls -t "$PLAN_DIR"/.md 2>/dev/null | xargs grep -l "$BRANCH" 2>/dev/null | head -1) [ -z "$PLAN" ] && PLAN=$(ls -t "$PLAN_DIR"/.md 2>/dev/null | xargs grep -l "$REPO" 2>/dev/null | head -1) [ -z "$PLAN" ] && PLAN=$(find "$PLAN_DIR" -name '.md' -mmin -1440 -maxdepth 1 2>/dev/null | xargs ls -t 2>/dev/null | head -1) [ -n "$PLAN" ] && break done [ -n "$PLAN" ] && echo "PLAN_FILE: $PLAN" || echo "NO_PLAN_FILE" CODEBLOCK_43_END PLAN COMPLETION AUDIT ═══════════════════════════════ Plan: {plan file path}

Implementation Items

[DONE] Create UserService — src/services/user_service.rb (+142 lines) [PARTIAL] Add validation — model validates but missing controller checks [NOT DONE] Add caching layer — no cache-related changes in diff [CHANGED] "Redis queue" → implemented with Sidekiq instead

Test Items

[DONE] Unit tests for UserService — test/services/user_service_test.rb [NOT DONE] E2E test for signup flow

Migration Items

[DONE] Create users table — db/migrate/20240315_create_users.rb

───────────────────────────────── COMPLETION: 4/7 DONE, 1 PARTIAL, 1 NOT DONE, 1 CHANGED ───────────────────────────────── CODEBLOCK_44_ENDbash curl -s -o /dev/null -w '%{http_code}' http://localhost:3000 2>/dev/null || \ curl -s -o /dev/null -w '%{http_code}' http://localhost:8080 2>/dev/null || \ curl -s -o /dev/null -w '%{http_code}' http://localhost:5173 2>/dev/null || \ curl -s -o /dev/null -w '%{http_code}' http://localhost:4000 2>/dev/null || echo "NO_SERVER" CODEBLOCK_45_ENDbash cat ${CLAUDE_SKILL_DIR}/../qa-only/SKILL.md CODEBLOCK_46_ENDbash _CROSS_PROJ=$(~/.claude/skills/gstack/bin/gstack-config get cross_project_learnings 2>/dev/null || echo "unset") echo "CROSS_PROJECT: $_CROSS_PROJ" if [ "$_CROSS_PROJ" = "true" ]; then ~/.claude/skills/gstack/bin/gstack-learnings-search --limit 10 --cross-project 2>/dev/null || true else ~/.claude/skills/gstack/bin/gstack-learnings-search --limit 10 2>/dev/null || true fi CODEBLOCK_47_ENDbash source <(~/.claude/skills/gstack/bin/gstack-diff-scope 2>/dev/null) CODEBLOCK_48_ENDbash ~/.claude/skills/gstack/bin/gstack-review-log '{"skill":"design-review-lite","timestamp":"TIMESTAMP","status":"STATUS","findings":N,"auto_fixed":M,"commit":"COMMIT"}' CODEBLOCK_49_ENDbash which codex 2>/dev/null && echo "CODEX_AVAILABLE" || echo "CODEX_NOT_AVAILABLE" CODEBLOCK_50_ENDbash TMPERR_DRL=$(mktemp /tmp/codex-drl-XXXXXXXX) _REPO_ROOT=$(git rev-parse --show-toplevel) || { echo "ERROR: not in a git repo" >&2; exit 1; } codex exec "Review the git diff on this branch. Run 7 litmus checks (YES/NO each): 1. Brand/product unmistakable in first screen? 2. One strong visual anchor present? 3. Page understandable by scanning headlines only? 4. Each section has one job? 5. Are cards actually necessary? 6. Does motion improve hierarchy or atmosphere? 7. Would design feel premium with all decorative shadows removed? Flag any hard rejections: 1. Generic SaaS card grid as first impression 2. Beautiful image with weak brand 3. Strong headline with no clear action 4. Busy imagery behind text 5. Sections repeating same mood statement 6. Carousel with no narrative purpose 7. App UI made of stacked cards instead of layout 5 most important design findings only. Reference file:line." -C "$_REPO_ROOT" -s read-only -c 'model_reasoning_effort="high"' --enable web_search_cached < /dev/null 2>"$TMPERR_DRL" CODEBLOCK_51_ENDbash cat "$TMPERR_DRL" && rm -f "$TMPERR_DRL" CODEBLOCK_52_ENDbash source <(~/.claude/skills/gstack/bin/gstack-diff-scope 2>/dev/null) || true

Detect stack for specialist context

STACK="" [ -f Gemfile ] && STACK="${STACK}ruby " [ -f package.json ] && STACK="${STACK}node " [ -f requirements.txt ] || [ -f pyproject.toml ] && STACK="${STACK}python " [ -f go.mod ] && STACK="${STACK}go " [ -f Cargo.toml ] && STACK="${STACK}rust " echo "STACK: ${STACK:-unknown}" DIFF_INS=$(git diff origin/ --stat | tail -1 | grep -oE '[0-9]+ insertion' | grep -oE '[0-9]+' || echo "0") DIFF_DEL=$(git diff origin/ --stat | tail -1 | grep -oE '[0-9]+ deletion' | grep -oE '[0-9]+' || echo "0") DIFF_LINES=$((DIFF_INS + DIFF_DEL)) echo "DIFF_LINES: $DIFF_LINES"

Detect test framework for specialist test stub generation

TEST_FW="" { [ -f jest.config.ts ] || [ -f jest.config.js ]; } && TEST_FW="jest" [ -f vitest.config.ts ] && TEST_FW="vitest" { [ -f spec/spec_helper.rb ] || [ -f .rspec ]; } && TEST_FW="rspec" { [ -f pytest.ini ] || [ -f conftest.py ]; } && TEST_FW="pytest" [ -f go.mod ] && TEST_FW="go-test" echo "TEST_FW: ${TEST_FW:-unknown}" CODEBLOCK_53_ENDbash ~/.claude/skills/gstack/bin/gstack-specialist-stats 2>/dev/null || true CODEBLOCK_54_ENDbash ~/.claude/skills/gstack/bin/gstack-learnings-search --type pitfall --query "{specialist domain}" --limit 5 2>/dev/null || true CODEBLOCK_55_END SPECIALIST REVIEW: N findings (X critical, Y informational) from Z specialists

[For each finding, in order: CRITICAL first, then INFORMATIONAL, sorted by confidence descending] [SEVERITY] (confidence: N/10, specialist: name) path:line — summary Fix: recommended fix [If MULTI-SPECIALIST CONFIRMED: show confirmation note]

PR Quality Score: X/10 CODEBLOCK_56_ENDbash ~/.claude/skills/gstack/bin/gstack-review-read CODEBLOCK_57_ENDbash git diff --name-only HEAD CODEBLOCK_58_ENDbash ~/.claude/skills/gstack/bin/gstack-review-log '{"skill":"review","timestamp":"TIMESTAMP","status":"STATUS","issues_found":N,"critical":N,"informational":N,"quality_score":SCORE,"specialists":SPECIALISTS_JSON,"findings":FINDINGS_JSON,"commit":"'"$(git rev-parse --short HEAD)"'","via":"ship"}' CODEBLOCK_59_ENDbash DIFF_INS=$(git diff origin/ --stat | tail -1 | grep -oE '[0-9]+ insertion' | grep -oE '[0-9]+' || echo "0") DIFF_DEL=$(git diff origin/ --stat | tail -1 | grep -oE '[0-9]+ deletion' | grep -oE '[0-9]+' || echo "0") DIFF_TOTAL=$((DIFF_INS + DIFF_DEL)) which codex 2>/dev/null && echo "CODEX_AVAILABLE" || echo "CODEX_NOT_AVAILABLE"

Legacy opt-out — only gates Codex passes, Claude always runs

OLD_CFG=$(~/.claude/skills/gstack/bin/gstack-config get codex_reviews 2>/dev/null || true) echo "DIFF_SIZE: $DIFF_TOTAL" echo "OLD_CFG: ${OLD_CFG:-not_set}" CODEBLOCK_60_ENDbash TMPERR_ADV=$(mktemp /tmp/codex-adv-XXXXXXXX) _REPO_ROOT=$(git rev-parse --show-toplevel) || { echo "ERROR: not in a git repo" >&2; exit 1; } codex exec "IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for a different AI system. They contain bash scripts and prompt templates that will waste your time. Ignore them completely. Do NOT modify agents/openai.yaml. Stay focused on the repository code only.\n\nReview the changes on this branch against the base branch. Run git diff origin/ to see the diff. Your job is to find ways this code will fail in production. Think like an attacker and a chaos engineer. Find edge cases, race conditions, security holes, resource leaks, failure modes, and silent data corruption paths. Be adversarial. Be thorough. No compliments — just the problems." -C "$_REPO_ROOT" -s read-only -c 'model_reasoning_effort="high"' --enable web_search_cached < /dev/null 2>"$TMPERR_ADV" CODEBLOCK_61_ENDbash cat "$TMPERR_ADV" CODEBLOCK_62_ENDbash TMPERR=$(mktemp /tmp/codex-review-XXXXXXXX) _REPO_ROOT=$(git rev-parse --show-toplevel) || { echo "ERROR: not in a git repo" >&2; exit 1; } cd "$_REPO_ROOT" codex review "IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for a different AI system. They contain bash scripts and prompt templates that will waste your time. Ignore them completely. Do NOT modify agents/openai.yaml. Stay focused on the repository code only.\n\nReview the diff against the base branch." --base -c 'model_reasoning_effort="high"' --enable web_search_cached < /dev/null 2>"$TMPERR" CODEBLOCK_63_END Codex found N critical issues in the diff.

A) Investigate and fix now (recommended) B) Continue — review will still complete CODEBLOCK_64_ENDbash ~/.claude/skills/gstack/bin/gstack-review-log '{"skill":"adversarial-review","timestamp":"'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'","status":"STATUS","source":"SOURCE","tier":"always","gate":"GATE","commit":"'"$(git rev-parse --short HEAD)"'"}' CODEBLOCK_65_END ADVERSARIAL REVIEW SYNTHESIS (always-on, N lines): ════════════════════════════════════════════════════════════ High confidence (found by multiple sources): [findings agreed on by >1 pass] Unique to Claude structured review: [from earlier step] Unique to Claude adversarial: [from subagent] Unique to Codex: [from codex adversarial or code review, if ran] Models used: Claude structured ✓ Claude adversarial ✓/✗ Codex ✓/✗ ════════════════════════════════════════════════════════════ CODEBLOCK_66_ENDbash ~/.claude/skills/gstack/bin/gstack-learnings-log '{"skill":"ship","type":"TYPE","key":"SHORT_KEY","insight":"DESCRIPTION","confidence":N,"source":"SOURCE","files":["path/to/relevant/file"]}' CODEBLOCK_67_ENDbash BASE_VERSION=$(git show origin/:VERSION 2>/dev/null | tr -d '\r\n[:space:]' || echo "0.0.0.0") CURRENT_VERSION=$(cat VERSION 2>/dev/null | tr -d '\r\n[:space:]' || echo "0.0.0.0") [ -z "$BASE_VERSION" ] && BASE_VERSION="0.0.0.0" [ -z "$CURRENT_VERSION" ] && CURRENT_VERSION="0.0.0.0" PKG_VERSION="" PKG_EXISTS=0 if [ -f package.json ]; then PKG_EXISTS=1 if command -v node >/dev/null 2>&1; then PKG_VERSION=$(node -e 'const p=require("./package.json");process.stdout.write(p.version||"")' 2>/dev/null) PARSE_EXIT=$? elif command -v bun >/dev/null 2>&1; then PKG_VERSION=$(bun -e 'const p=require("./package.json");process.stdout.write(p.version||"")' 2>/dev/null) PARSE_EXIT=$? else echo "ERROR: package.json exists but neither node nor bun is available. Install one and re-run." exit 1 fi if [ "$PARSE_EXIT" != "0" ]; then echo "ERROR: package.json is not valid JSON. Fix the file before re-running /ship." exit 1 fi fi echo "BASE: $BASE_VERSION VERSION: $CURRENT_VERSION package.json: ${PKG_VERSION:-}"

if [ "$CURRENT_VERSION" = "$BASE_VERSION" ]; then if [ "$PKG_EXISTS" = "1" ] && [ -n "$PKG_VERSION" ] && [ "$PKG_VERSION" != "$CURRENT_VERSION" ]; then echo "STATE: DRIFT_UNEXPECTED" echo "package.json version ($PKG_VERSION) disagrees with VERSION ($CURRENT_VERSION) while VERSION matches base." echo "This looks like a manual edit to package.json bypassing /ship. Reconcile manually, then re-run." exit 1 fi echo "STATE: FRESH" else if [ "$PKG_EXISTS" = "1" ] && [ -n "$PKG_VERSION" ] && [ "$PKG_VERSION" != "$CURRENT_VERSION" ]; then echo "STATE: DRIFT_STALE_PKG" else echo "STATE: ALREADY_BUMPED" fi fi CODEBLOCK_68_ENDbash QUEUE_JSON=$(bun run bin/gstack-next-version \ --base \ --bump "$BUMP_LEVEL" \ --current-version "$BASE_VERSION" 2>/dev/null || echo '{"offline":true}') NEW_VERSION=$(echo "$QUEUE_JSON" | jq -r '.version // empty') CLAIMED_COUNT=$(echo "$QUEUE_JSON" | jq -r '.claimed | length') ACTIVE_SIBLING_COUNT=$(echo "$QUEUE_JSON" | jq -r '.active_siblings | length') OFFLINE=$(echo "$QUEUE_JSON" | jq -r '.offline // false') REASON=$(echo "$QUEUE_JSON" | jq -r '.reason // ""') CODEBLOCK_69_END Queue on (vBASE_VERSION): # → v [⚠ collision with #] Active sibling workspaces (WIP, not yet PR'd): → v (committed Nh ago) Your branch will claim: vNEW_VERSION () CODEBLOCK_70_ENDbash if ! printf '%s' "$NEW_VERSION" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$'; then echo "ERROR: NEW_VERSION ($NEW_VERSION) does not match MAJOR.MINOR.PATCH.MICRO pattern. Aborting." exit 1 fi echo "$NEW_VERSION" > VERSION if [ -f package.json ]; then if command -v node >/dev/null 2>&1; then node -e 'const fs=require("fs"),p=require("./package.json");p.version=process.argv[1];fs.writeFileSync("package.json",JSON.stringify(p,null,2)+"\n")' "$NEW_VERSION" || { echo "ERROR: failed to update package.json. VERSION was written but package.json is now stale. Fix and re-run — the new idempotency check will detect the drift." exit 1 } elif command -v bun >/dev/null 2>&1; then bun -e 'const fs=require("fs"),p=require("./package.json");p.version=process.argv[1];fs.writeFileSync("package.json",JSON.stringify(p,null,2)+"\n")' "$NEW_VERSION" || { echo "ERROR: failed to update package.json. VERSION was written but package.json is now stale." exit 1 } else echo "ERROR: package.json exists but neither node nor bun is available." exit 1 fi fi CODEBLOCK_71_ENDbash REPAIR_VERSION=$(cat VERSION | tr -d '\r\n[:space:]') if ! printf '%s' "$REPAIR_VERSION" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$'; then echo "ERROR: VERSION file contents ($REPAIR_VERSION) do not match MAJOR.MINOR.PATCH.MICRO pattern. Refusing to propagate invalid semver into package.json. Fix VERSION manually, then re-run /ship." exit 1 fi if command -v node >/dev/null 2>&1; then node -e 'const fs=require("fs"),p=require("./package.json");p.version=process.argv[1];fs.writeFileSync("package.json",JSON.stringify(p,null,2)+"\n")' "$REPAIR_VERSION" || { echo "ERROR: drift repair failed — could not update package.json." exit 1 } else bun -e 'const fs=require("fs"),p=require("./package.json");p.version=process.argv[1];fs.writeFileSync("package.json",JSON.stringify(p,null,2)+"\n")' "$REPAIR_VERSION" || { echo "ERROR: drift repair failed." exit 1 } fi echo "Drift repaired: package.json synced to $REPAIR_VERSION. No version bump performed." CODEBLOCK_72_ENDbash git log ..HEAD --oneline CODEBLOCK_73_ENDbash git diff ...HEAD CODEBLOCK_74_ENDbash WIP_COUNT=$(git log ..HEAD --oneline --grep="^WIP:" 2>/dev/null | wc -l | tr -d ' ') echo "WIP_COMMITS: $WIP_COUNT" CODEBLOCK_75_ENDbash

Export [gstack-context] blocks from all WIP commits on this branch.

This file becomes input to the CHANGELOG entry and may inform PR body context.

mkdir -p "$(git rev-parse --show-toplevel)/.gstack" git log ..HEAD --grep="^WIP:" --format="%H%n%B%n---END---" > \ "$(git rev-parse --show-toplevel)/.gstack/wip-context-before-squash.md" 2>/dev/null || true CODEBLOCK_76_ENDbash

Interactive rebase with automated WIP squashing.

Mark every WIP commit as 'fixup' (drop its message, fold changes into prior commit).

git rebase -i $(git merge-base HEAD origin/) \ --exec 'true' \ -X ours 2>/dev/null || { echo "Rebase conflict. Aborting: git rebase --abort" git rebase --abort echo "STATUS: BLOCKED — manual WIP squash required" exit 1 } CODEBLOCK_77_ENDbash

Branch contains only WIP commits. Reset-soft is safe here because there's

nothing non-WIP to preserve. Verify first.

NON_WIP=$(git log ..HEAD --oneline --invert-grep --grep="^WIP:" 2>/dev/null | wc -l | tr -d ' ') if [ "$NON_WIP" -eq 0 ]; then git reset --soft $(git merge-base HEAD origin/) echo "WIP-only branch, reset-soft to merge base. Step 15.1 will create clean commits." fi CODEBLOCK_78_ENDbash git commit -m "$(cat <<'EOF' chore: bump version and changelog (vX.Y.Z.W)

Co-Authored-By: Claude Opus 4.7 EOF )" CODEBLOCK_79_ENDbash git fetch origin 2>/dev/null LOCAL=$(git rev-parse HEAD) REMOTE=$(git rev-parse origin/ 2>/dev/null || echo "none") echo "LOCAL: $LOCAL REMOTE: $REMOTE" [ "$LOCAL" = "$REMOTE" ] && echo "ALREADY_PUSHED" || echo "PUSH_NEEDED" CODEBLOCK_80_ENDbash git push -u origin CODEBLOCK_81_ENDbash gh pr view --json url,number,state -q 'if .state == "OPEN" then "PR #\(.number): \(.url)" else "NO_PR" end' 2>/dev/null || echo "NO_PR" CODEBLOCK_82_ENDbash glab mr view -F json 2>/dev/null | jq -r 'if .state == "opened" then "MR_EXISTS" else "NO_MR" end' 2>/dev/null || echo "NO_MR" CODEBLOCK_83_END

Summary

git log ..HEAD --oneline to enumerate every commit. Exclude the VERSION/CHANGELOG metadata commit (that's this PR's bookkeeping, not a substantive change). Group the remaining commits into logical sections (e.g., "Performance", "Dead Code Removal", "Infrastructure"). Every substantive commit must appear in at least one section. If a commit's work isn't reflected in the summary, you missed it.>

Test Coverage

Pre-Landing Review

Design Review

Eval Results

Greptile Review

Scope Drift

Plan Completion

Verification Results

TODOS

Documentation

documentation_section string returned by Step 18's subagent here, verbatim.> documentation_section: null (no docs updated), omit this section entirely.>

Test plan

• [x] All Rails tests pass (N runs, 0 failures)
• [x] All Vitest tests pass (N tests)
🤖 Generated with Claude Code CODEBLOCK_84_ENDbash gh pr create --base --title "v$NEW_VERSION :
" --body "$(cat <<'EOF' EOF )" CODEBLOCK_85_ENDbash glab mr create -b -t "v$NEW_VERSION :
" -d "$(cat <<'EOF' EOF )" CODEBLOCK_86_ENDbash eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" && mkdir -p ~/.gstack/projects/$SLUG CODEBLOCK_87_ENDbash echo '{"skill":"ship","timestamp":"'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'","coverage_pct":COVERAGE_PCT,"plan_items_total":PLAN_TOTAL,"plan_items_done":PLAN_DONE,"verification_result":"VERIFY_RESULT","version":"VERSION","branch":"BRANCH"}' >> ~/.gstack/projects/$SLUG/$BRANCH-reviews.jsonl `
Substitute from earlier steps:
• COVERAGE_PCT: coverage percentage from Step 7 diagram (integer, or -1 if undetermined)
• PLAN_TOTAL: total plan items extracted in Step 8 (0 if no plan file)
• PLAN_DONE: count of DONE + CHANGED items from Step 8 (0 if no plan file)
• VERIFY_RESULT: "pass", "fail", or "skipped" from Step 8.1
• VERSION: from the VERSION file
• BRANCH: current branch name
This step is automatic — never skip it, never ask for confirmation.
---
Important Rules
• Never skip tests. If tests fail, stop.
• Never skip the pre-landing review. If checklist.md is unreadable, stop.
• Never force push. Use regular git push only.
• Never ask for trivial confirmations (e.g., "ready to push?", "create PR?"). DO stop for: version bumps (MINOR/MAJOR), pre-landing review findings (ASK items), and Codex structured review [P1] findings (large diffs only).
• Always use the 4-digit version format from the VERSION file.
• Date format in CHANGELOG: YYYY-MM-DD
• Split commits for bisectability — each commit = one logical change.
• TODOS.md completion detection must be conservative. Only mark items as completed when the diff clearly shows the work is done.
• Use Greptile reply templates from greptile-triage.md. Every reply includes evidence (inline diff, code references, re-rank suggestion). Never post vague replies.
• Never push without fresh verification evidence. If code changed after Step 5 tests, re-run before pushing.
• Step 7 generates coverage tests. They must pass before committing. Never commit failing tests.
• The goal is: user says /ship`, next thing they see is the review + PR URL + auto-synced docs.