@orderful/droid 0.42.0 → 0.43.0

package/src/tools/release/commands/release.md

@@ -0,0 +1,28 @@
+---
+name: release
+description: "Release ceremony automation"
+argument-hint: "[start [repo] | status | complete [repo]]"
+---
+
+# /release
+
+**User invoked:** `/release $ARGUMENTS`
+
+**Your task:** Invoke the **release skill** with these arguments.
+
+## Examples
+
+- `/release start` → Create release PR for current repo
+- `/release start orderful-workspace` → Create release PR for a specific repo
+- `/release status` → Check CI state across release repos
+- `/release complete` → Post "release complete" to Slack
+
+## Quick Reference
+
+```
+/release start [repo]       # Create release PR + notify Slack
+/release status             # CI state across repos
+/release complete [repo]    # Notify Slack, close out release
+```
+
+See the **release skill** for complete documentation.

package/src/tools/release/skills/release/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: release
+description: "Release ceremony automation for dev-to-master releases. Use when starting a release, checking release status, or completing a release. User prompts like 'start a release', 'release status', 'release complete'."
+argument-hint: "[start [repo] | status | complete [repo]]"
+allowed-tools: [Read, Write, Glob, Grep, Bash, Edit]
+---
+
+# Release Skill
+
+Automate dev → master release ceremonies: create release PRs, notify Slack, and track status.
+
+## When to Use
+
+- User wants to start a release (create PR from dev → master)
+- User asks about release status (open PRs, CI checks)
+- User says "release complete" or wants to close out a release
+- Natural language like "start a release", "what's the release status?"
+
+## When NOT to Use
+
+- Deploying to environments (this is about merging dev → master, not deployment)
+- Feature branch management (this is for release branches only)
+- Hotfixes or cherry-picks (manual process)
+
+## Prerequisites
+
+1. **`gh` CLI** — authenticated with access to target repos
+2. **Slack integration** — `droid integrations slack post` configured (optional, falls back to terminal)
+
+## Configuration
+
+Read config at the start of every command:
+
+```bash
+droid config --get tools.release
+droid config --get repos
+```
+
+- **Repos:** Filter `repos` array for entries with `release_branch` set — these are release repos
+- **Slack channel:** From `tools.release.slack_channel` (default: `#release-management`)
+- **Repo detection:** Match cwd against repo paths, or ask user if ambiguous
+
+If no repos have `release_branch` set, tell user:
+> "No release repos configured. Run `droid repos add` and set a release branch to get started."
+
+## Commands
+
+| Command | Action |
+|---------|--------|
+| `/release start [repo]` | Create release PR + notify Slack |
+| `/release status` | Check open release PRs + CI state |
+| `/release complete [repo]` | Post completion to Slack |
+
+See `references/workflows.md` for detailed step-by-step procedures and exact `gh` commands.
+
+See `references/templates.md` for Slack message and PR body templates.
+
+## Repo Detection
+
+1. Get cwd and match against configured repo paths
+2. If match found and repo has `release_branch`, use it
+3. If no match or multiple release repos, ask user to pick
+4. Use `release_branch` as source and `production_branch` (default: `master`) as target
+
+## Error Handling
+
+| Error | Action |
+|-------|--------|
+| No release repos configured | Suggest `droid repos add` with release branch |
+| `gh` CLI not authenticated | Suggest `gh auth login` |
+| Slack not configured | Print message to terminal, suggest `droid integrations setup slack` |
+| Release PR already exists | Show existing PR, ask if user wants to proceed |
+| CI checks failing | Show status, do not auto-merge |

package/src/tools/release/skills/release/references/templates.md

@@ -0,0 +1,83 @@
+# Release Templates
+
+Slack mrkdwn and PR body templates for release notifications.
+
+## Slack Messages
+
+All Slack messages are posted via `droid integrations slack post`. Format as Slack mrkdwn (not GitHub markdown).
+
+### Release Started
+
+```
+:rocket: *Release started — {repo_name}*
+
+*Risk:* {risk_emoji} {risk_level}
+*PR:* <{pr_url}|#{pr_number}>
+*Branch:* `{release_branch}` → `{production_branch}`
+
+{pr_summary}
+
+Posted with :droid:
+```
+
+Risk emojis:
+- Low Risk: `:large_green_circle:`
+- High Risk: `:warning:`
+
+### Release Complete
+
+```
+:white_check_mark: *Release complete — {repo_name}*
+
+*PR:* <{pr_url}|#{pr_number}>
+*Branch:* `{release_branch}` → `{production_branch}`
+
+Posted with :droid:
+```
+
+---
+
+## Release PR Body
+
+Used when creating the release PR via `gh pr create --body`.
+
+```markdown
+### {repo_name} Release
+
+**Risk:** [{risk_level}]
+
+**When:** Imminent
+
+**PRs included:**
+{pr_list}
+
+---
+
+Created with :robot: [droid](https://github.com/Orderful/droid)
+```
+
+Where `{pr_list}` is a bulleted list of merged PRs:
+```markdown
+- #{number} {title} (@{author})
+- #{number} {title} (@{author})
+```
+
+---
+
+## Terminal Fallback
+
+When Slack is not configured, print a plain-text version to terminal:
+
+### Release Started (terminal)
+```
+Release started — {repo_name}
+  Risk: {risk_level}
+  PR:   {pr_url}
+  Branch: {release_branch} -> {production_branch}
+```
+
+### Release Complete (terminal)
+```
+Release complete — {repo_name}
+  PR: {pr_url}
+```

package/src/tools/release/skills/release/references/workflows.md

@@ -0,0 +1,129 @@
+# Release Workflows
+
+Detailed step-by-step procedures for each `/release` subcommand. All commands use `gh` CLI directly.
+
+## Common Setup (every command)
+
+```bash
+# 1. Read config
+SLACK_CHANNEL=$(droid config --get tools.release.slack_channel)
+# Default to #release-management if not set
+SLACK_CHANNEL="${SLACK_CHANNEL:-#release-management}"
+
+# 2. Get repos and filter for release repos (those with release_branch set)
+droid config --get repos
+# Parse JSON output — release repos have release_branch defined
+```
+
+Detect repo from cwd or ask user. Extract `release_branch`, `production_branch` (default: `master`), and the GitHub `owner/repo` slug from the repo's remote.
+
+```bash
+# Get owner/repo from git remote
+git -C {repo_path} remote get-url origin
+# Parse to extract owner/repo (e.g., "Orderful/orderful-workspace")
+```
+
+---
+
+## `/release start [repo]`
+
+Create a release PR and notify Slack.
+
+### Steps
+
+1. **Detect repo** — match cwd or ask user to pick from release repos
+
+2. **Check for existing release PR:**
+   ```bash
+   gh pr list --search "[RELEASE]" --state open --base {production_branch} --head {release_branch} --json number,title,url --repo {owner}/{repo}
+   ```
+   If one exists, show it and ask: "A release PR already exists. Open it instead?"
+
+3. **Generate release notes** — list PRs merged to the release branch since last release:
+   ```bash
+   gh pr list --base {release_branch} --state merged --json number,title,author --limit 50 --repo {owner}/{repo}
+   ```
+   Format as a bulleted list for the PR body.
+
+4. **Ask risk level** — use AskUserQuestion:
+   - Low Risk (routine release, no breaking changes)
+   - High Risk (breaking changes, data migrations, or high-traffic feature)
+
+5. **Create the release PR:**
+   ```bash
+   gh pr create \
+     --base {production_branch} \
+     --head {release_branch} \
+     --title "[RELEASE] {repo_name}" \
+     --label "READY" \
+     --body "{release_pr_body}" \
+     --repo {owner}/{repo}
+   ```
+   See `templates.md` for the PR body template.
+
+6. **Post to Slack:**
+   ```bash
+   node -e 'process.stdout.write(JSON.stringify({
+     channel: "{slack_channel}",
+     text: "{slack_message}",
+     unfurl_links: false
+   }))' | droid integrations slack post
+   ```
+   See `templates.md` for the Slack message template (release started).
+
+7. **Confirm to user** — show PR URL and Slack post confirmation.
+
+---
+
+## `/release status`
+
+Check release status across all configured release repos.
+
+### Steps
+
+1. **Get all release repos** from config
+
+2. **For each release repo**, gather:
+
+   **Open release PRs:**
+   ```bash
+   gh pr list --search "[RELEASE]" --state open --json number,title,url,statusCheckRollup --repo {owner}/{repo}
+   ```
+
+3. **Format and display** as a summary:
+
+   ```
+   {repo_name}
+     Release PR: #{number} — {CI status} (green/pending/failing)
+   ```
+
+   If no open release PR: "No active release"
+   If no release repos configured: "No release repos configured"
+
+---
+
+## `/release complete [repo]`
+
+Close out a release — notify Slack.
+
+### Steps
+
+1. **Detect repo** — match cwd or ask user
+
+2. **Find the release PR:**
+   ```bash
+   # Check merged first
+   gh pr list --search "[RELEASE]" --state merged --base {production_branch} --head {release_branch} --json number,title,url,mergedAt --limit 1 --repo {owner}/{repo}
+   ```
+   If no merged PR found, check open:
+   ```bash
+   gh pr list --search "[RELEASE]" --state open --base {production_branch} --head {release_branch} --json number,title,url --repo {owner}/{repo}
+   ```
+   - If PR is still open (not merged): warn "Release PR #{number} is still open. Merge it first, or complete anyway?"
+   - If no PR found at all: warn "No release PR found. Post completion anyway?"
+
+3. **Post to Slack** — release complete notification (see `templates.md`).
+
+4. **Confirm to user:**
+   - "Release complete for `{repo_name}`"
+   - Show Slack message confirmation