feat: add gpd:zen command

[aaball]

What

Adds a small, intentionally-light gpd:zen slash command (plus its same-stem workflow spec) that prints one short, read-only physics-research koan and takes no action — a projectless palate-cleanser between tasks.

Changes

• src/gpd/commands/zen.md, src/gpd/specs/workflows/zen.md — new command + same-stem workflow (read-only, context_mode: projectless, file_read only).
• src/gpd/registry.py — map gpd-zen to the help skill category.
• Regenerated surfaces: help workflow + detailed-command-reference markers, repo-graph contract, and tests/README.md same-stem block.
• Prompt-budget baselines for the new command/workflow, and a +1 bump to the codex command-projection advisory budget (structural, from adding one command surface).

Tests

Full suite green: 12952 passed, 14 skipped.

Summary by CodeRabbit

• New Features

  • Added gpd:zen command—a read-only starter command that prints a short physics-research zen koan to reset focus. Supports an optional mood word argument to tailor the output.

• Documentation

  • Updated command reference and help workflows to document the new zen command and its usage.

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 2e742aa9-7f6f-482f-bf3a-eccb65cc3063

📥 Commits

Reviewing files that changed from the base of the PR and between 0f41769 and 79fbde5.

📒 Files selected for processing (9)

• src/gpd/commands/zen.md
• src/gpd/registry.py
• src/gpd/specs/references/help/detailed-command-reference.md
• src/gpd/specs/workflows/help.md
• src/gpd/specs/workflows/zen.md
• tests/README.md
• tests/adapters/test_runtime_projection_diagnostics_budget.py
• tests/core/test_command_prompt_budget.py
• tests/repo_graph_contract.json

---

📝 Walkthrough

Walkthrough

This PR introduces a new read-only gpd:zen command that prints physics-research zen koans to reset focus. The change includes command and workflow definitions, registry mapping, help documentation, and corresponding test baseline and contract updates.

Changes

Zen Command Feature

Layer / File(s)	Summary
Command definition and workflow implementation src/gpd/commands/zen.md, src/gpd/specs/workflows/zen.md, src/gpd/registry.py	New gpd:zen command with metadata and execution contract points to a workflow that reads an optional mood word, prints a fixed intro sentence, selects one koan from a curated list, and closes with encouragement. No side effects, file writes, or routing. Registry maps gpd-zen skill to the help category.
Help documentation src/gpd/specs/references/help/detailed-command-reference.md, src/gpd/specs/workflows/help.md	Adds gpd:zen to the starter commands section with one-line description of its purpose and optional mood-word argument.
Test baselines and repo graph tracking tests/core/test_command_prompt_budget.py, tests/adapters/test_runtime_projection_diagnostics_budget.py, tests/repo_graph_contract.json, tests/README.md	Expands prompt budget baselines for command and workflow, increases runtime pressure budget count by 1, regenerates repo graph counts (commands 71→72, workflows 72→73), adds zen stem to same-stem inventory, and documents the new command-workflow mapping.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

A rabbit hops through zen and file,
With koans and calm in measured style,
No scripts, no side—just words to smile,
A quiet break from the research pile! 🐰✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'feat: add gpd:zen command' directly and clearly describes the main change — introducing a new slash command.
Description check	✅ Passed	The description covers what changed, why it was added, and test results, matching the template structure despite minor section label variations.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch adam-b

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[marcpickett1]

🤖 RoastBot: The agent was too stressed, so we added meditation. The singularity is going to need a lot of therapy.