@orderful/droid 0.42.1 → 0.44.0

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

@@ -0,0 +1,166 @@
+# 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** — compare branches to find PRs included in this release:
+   ```bash
+   # Get commits in release_branch that aren't in production_branch
+   gh api repos/{owner}/{repo}/compare/{production_branch}...{release_branch} --jq '.commits[].commit.message'
+   ```
+   Extract PR numbers from commit messages (e.g. `(#1234)`) and format as a bulleted list for the PR body.
+
+   **Do NOT use** `gh pr list --base {release_branch} --state merged` — that returns ALL historically merged PRs, not just the ones since the last release.
+
+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 merge [repo]`
+
+Merge the release PR if all checks are green, then notify Slack.
+
+### Steps
+
+1. **Detect repo** — match cwd or ask user
+
+2. **Find the open release PR:**
+   ```bash
+   gh pr list --search "[RELEASE]" --state open --base {production_branch} --head {release_branch} --json number,title,url,statusCheckRollup --repo {owner}/{repo}
+   ```
+   If no open release PR found, error: "No open release PR found. Run `/release start` first."
+
+3. **Check all status checks:**
+   Parse `statusCheckRollup` from the PR data. Every check must have `conclusion: "SUCCESS"` or `state: "SUCCESS"`.
+
+   If any checks are pending: "CI checks are still running on PR #{number}. Wait for them to finish."
+   If any checks are failing: "CI checks are failing on PR #{number}. Fix them before merging." Show the failing checks.
+
+4. **Confirm with user** — use AskUserQuestion:
+   "All checks are green on PR #{number}. Merge `{release_branch}` → `{production_branch}`?"
+
+5. **Merge the PR:**
+   ```bash
+   gh pr merge {pr_number} --merge --repo {owner}/{repo}
+   ```
+
+6. **Post to Slack** — release merged notification (see `templates.md`).
+
+7. **Confirm to user** — show merge confirmation 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.42.1",
+  "version": "0.44.0",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {

package/src/commands/repos.ts

@@ -40,6 +40,10 @@ export async function reposListCommand(options?: ReposListOptions): Promise<void
     if (repo.description) {
       console.log(chalk.gray(`  ${repo.description}`));
     }
+    if (repo.release_branch) {
+      const prod = repo.production_branch || 'master';
+      console.log(chalk.gray(`  Release: ${repo.release_branch} → ${prod}`));
+    }
     console.log();
   }
 }
@@ -93,6 +97,29 @@ export async function reposAddCommand(
     repoDescription = answers.description || undefined;
   }
 
+  // Optional release fields
+  const releaseAnswers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'release_branch',
+      message: 'Release branch (optional, e.g. "dev"):',
+    },
+  ]);
+  const releaseBranch = releaseAnswers.release_branch || undefined;
+
+  let productionBranch: string | undefined;
+  if (releaseBranch) {
+    const prodAnswers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'production_branch',
+        message: 'Production branch:',
+        default: 'master',
+      },
+    ]);
+    productionBranch = prodAnswers.production_branch || 'master';
+  }
+
   // At this point, repoName and repoPath should be defined
   if (!repoName || !repoPath) {
     console.error(chalk.red('Name and path are required'));
@@ -103,6 +130,8 @@ export async function reposAddCommand(
     name: repoName,
     path: repoPath,
     description: repoDescription,
+    ...(releaseBranch && { release_branch: releaseBranch }),
+    ...(productionBranch && { production_branch: productionBranch }),
   };
 
   addRepo(repo);

package/src/commands/tui/views/ReposManagementScreen.tsx

@@ -10,7 +10,15 @@ export interface ReposManagementScreenProps {
   onCancel: () => void;
 }
 
-type Screen = 'list' | 'add-name' | 'add-path' | 'add-desc' | 'confirm-delete';
+type Screen =
+  | 'list'
+  | 'add-name'
+  | 'add-path'
+  | 'add-desc'
+  | 'repo-actions'
+  | 'edit-release-branch'
+  | 'edit-production-branch'
+  | 'confirm-delete';
 
 export function ReposManagementScreen({ onComplete: _onComplete, onCancel }: ReposManagementScreenProps) {
   const [repos, setRepos] = useState<RepoConfig[]>(() => getRepos());
@@ -23,8 +31,11 @@ export function ReposManagementScreen({ onComplete: _onComplete, onCancel }: Rep
   const [newRepoPath, setNewRepoPath] = useState('');
   const [newRepoDesc, setNewRepoDesc] = useState('');
 
-  // Delete repo state
-  const [repoToDelete, setRepoToDelete] = useState<string | null>(null);
+  // Edit/delete repo state
+  const [activeRepo, setActiveRepo] = useState<RepoConfig | null>(null);
+  const [actionIndex, setActionIndex] = useState(0);
+  const [editReleaseBranch, setEditReleaseBranch] = useState('');
+  const [editProductionBranch, setEditProductionBranch] = useState('');
 
   const handleAddRepo = () => {
     if (!newRepoName || !newRepoPath) {
@@ -53,7 +64,7 @@ export function ReposManagementScreen({ onComplete: _onComplete, onCancel }: Rep
     removeRepo(repoName);
     setRepos(getRepos());
     setMessage({ text: `Removed ${repoName}`, type: 'success' });
-    setRepoToDelete(null);
+    setActiveRepo(null);
     setScreen('list');
 
     // Adjust selected index if needed
@@ -62,6 +73,25 @@ export function ReposManagementScreen({ onComplete: _onComplete, onCancel }: Rep
     }
   };
 
+  const handleSaveReleaseBranches = () => {
+    if (!activeRepo) return;
+
+    const updated: RepoConfig = {
+      ...activeRepo,
+      release_branch: editReleaseBranch || undefined,
+      production_branch: editReleaseBranch ? (editProductionBranch || 'master') : undefined,
+    };
+
+    addRepo(updated);
+    setRepos(getRepos());
+    const label = editReleaseBranch
+      ? `Set release: ${editReleaseBranch} → ${editProductionBranch || 'master'}`
+      : 'Cleared release branches';
+    setMessage({ text: `${activeRepo.name}: ${label}`, type: 'success' });
+    setActiveRepo(null);
+    setScreen('list');
+  };
+
   // List screen navigation
   useInput((input, key) => {
     if (message) setMessage(null);
@@ -86,13 +116,42 @@ export function ReposManagementScreen({ onComplete: _onComplete, onCancel }: Rep
         // "Add New Repo" selected
         setScreen('add-name');
       } else if (selectedIndex < repos.length) {
-        // Repo selected - prompt to delete
-        setRepoToDelete(repos[selectedIndex].name);
-        setScreen('confirm-delete');
+        // Repo selected - show action menu
+        setActiveRepo(repos[selectedIndex]);
+        setActionIndex(0);
+        setScreen('repo-actions');
       }
     }
   }, { isActive: screen === 'list' });
 
+  // Repo action menu
+  useInput((input, key) => {
+    if (key.escape) {
+      setActiveRepo(null);
+      setScreen('list');
+      return;
+    }
+
+    if (key.upArrow) {
+      setActionIndex((prev) => Math.max(0, prev - 1));
+    }
+    if (key.downArrow) {
+      setActionIndex((prev) => Math.min(1, prev + 1));
+    }
+
+    if (key.return && activeRepo) {
+      if (actionIndex === 0) {
+        // Edit release branches
+        setEditReleaseBranch(activeRepo.release_branch || '');
+        setEditProductionBranch(activeRepo.production_branch || '');
+        setScreen('edit-release-branch');
+      } else {
+        // Delete
+        setScreen('confirm-delete');
+      }
+    }
+  }, { isActive: screen === 'repo-actions' });
+
   // Add name input
   useInput((input, key) => {
     if (key.escape) {
@@ -117,14 +176,27 @@ export function ReposManagementScreen({ onComplete: _onComplete, onCancel }: Rep
     }
   }, { isActive: screen === 'add-desc' });
 
+  // Edit release branch input
+  useInput((input, key) => {
+    if (key.escape) {
+      setScreen('repo-actions');
+    }
+  }, { isActive: screen === 'edit-release-branch' });
+
+  // Edit production branch input
+  useInput((input, key) => {
+    if (key.escape) {
+      setScreen('edit-release-branch');
+    }
+  }, { isActive: screen === 'edit-production-branch' });
+
   // Confirm delete
   useInput((input, key) => {
     if (key.escape || input === 'n') {
-      setRepoToDelete(null);
-      setScreen('list');
+      setScreen('repo-actions');
     }
-    if (input === 'y' && repoToDelete) {
-      handleDeleteRepo(repoToDelete);
+    if (input === 'y' && activeRepo) {
+      handleDeleteRepo(activeRepo.name);
     }
   }, { isActive: screen === 'confirm-delete' });
 
@@ -206,14 +278,98 @@ export function ReposManagementScreen({ onComplete: _onComplete, onCancel }: Rep
     );
   }
 
-  if (screen === 'confirm-delete' && repoToDelete) {
-    const repo = repos.find((r) => r.name === repoToDelete);
+  if (screen === 'repo-actions' && activeRepo) {
+    const actions = ['Edit release branches', 'Remove repository'];
+    return (
+      <Box flexDirection="column" padding={2}>
+        <Text color={colors.text} bold>{activeRepo.name}</Text>
+        <Box marginTop={0}>
+          <Text color={colors.textDim}>{activeRepo.path}</Text>
+        </Box>
+        {activeRepo.release_branch && (
+          <Box marginTop={0}>
+            <Text color={colors.textDim}>Release: {activeRepo.release_branch} → {activeRepo.production_branch || 'master'}</Text>
+          </Box>
+        )}
+
+        <Box flexDirection="column" marginTop={1}>
+          {actions.map((action, index) => (
+            <Box key={action}>
+              <Text
+                color={actionIndex === index ? colors.primary : (index === 1 ? colors.error : colors.text)}
+                bold={actionIndex === index}
+              >
+                {actionIndex === index ? '> ' : '  '}
+                {action}
+              </Text>
+            </Box>
+          ))}
+        </Box>
+
+        <Box marginTop={2}>
+          <Text color={colors.textDim}>↑↓ navigate · enter select · esc back</Text>
+        </Box>
+      </Box>
+    );
+  }
+
+  if (screen === 'edit-release-branch' && activeRepo) {
+    return (
+      <Box flexDirection="column" padding={2}>
+        <Text color={colors.text} bold>Edit Release Branches — {activeRepo.name}</Text>
+        <Box marginTop={1}>
+          <Text color={colors.textDim}>Release branch (e.g. &quot;dev&quot;, blank to clear): </Text>
+          <TextInput
+            value={editReleaseBranch}
+            onChange={setEditReleaseBranch}
+            onSubmit={() => {
+              if (editReleaseBranch) {
+                setScreen('edit-production-branch');
+              } else {
+                handleSaveReleaseBranches();
+              }
+            }}
+            placeholder={activeRepo.release_branch || 'dev'}
+          />
+        </Box>
+        <Box marginTop={1}>
+          <Text color={colors.textDim}>enter {editReleaseBranch ? 'next' : 'clear & save'} · esc back</Text>
+        </Box>
+      </Box>
+    );
+  }
+
+  if (screen === 'edit-production-branch' && activeRepo) {
+    return (
+      <Box flexDirection="column" padding={2}>
+        <Text color={colors.text} bold>Edit Release Branches — {activeRepo.name}</Text>
+        <Box marginTop={1}>
+          <Text color={colors.textDim}>Release branch: </Text>
+          <Text color={colors.text}>{editReleaseBranch}</Text>
+        </Box>
+        <Box marginTop={1}>
+          <Text color={colors.textDim}>Production branch: </Text>
+          <TextInput
+            value={editProductionBranch}
+            onChange={setEditProductionBranch}
+            onSubmit={handleSaveReleaseBranches}
+            placeholder="master"
+          />
+        </Box>
+        <Box marginTop={1}>
+          <Text color={colors.textDim}>enter save · esc back</Text>
+        </Box>
+      </Box>
+    );
+  }
+
+  if (screen === 'confirm-delete' && activeRepo) {
     return (
       <Box flexDirection="column" padding={2}>
         <Text color={colors.text} bold>Remove Repository</Text>
         <Box marginTop={1} flexDirection="column">
-          <Text color={colors.text}>{repo?.name}</Text>
-          <Text color={colors.textDim}>{repo?.path}</Text>
+          <Text color={colors.text}>{activeRepo.name}</Text>
+          <Text color={colors.textDim}>{activeRepo.path}</Text>
         </Box>
         <Box marginTop={2}>
           <Text color={colors.error}>Remove this repository from the registry?</Text>
@@ -263,6 +419,11 @@ export function ReposManagementScreen({ onComplete: _onComplete, onCancel }: Rep
                   <Text color={colors.textDim}>{repo.description}</Text>
                 </Box>
               )}
+              {repo.release_branch && (
+                <Box paddingLeft={2}>
+                  <Text color={colors.textDim}>Release: {repo.release_branch} → {repo.production_branch || 'master'}</Text>
+                </Box>
+              )}
             </Box>
           ))
         )}
@@ -282,7 +443,7 @@ export function ReposManagementScreen({ onComplete: _onComplete, onCancel }: Rep
       <Box marginTop={2}>
         <Text color={colors.textDim}>
           {repos.length > 0 && selectedIndex < repos.length
-            ? 'enter remove · esc back'
+            ? 'enter edit · esc back'
             : '↑↓ navigate · enter select · esc back'}
         </Text>
       </Box>

package/src/commands/tui/views/ReposViewerScreen.tsx

@@ -36,6 +36,11 @@ export function ReposViewerScreen({ onClose }: ReposViewerScreenProps) {
                   <Text color={colors.textDim}>{repo.description}</Text>
                 </Box>
               )}
+              {repo.release_branch && (
+                <Box marginTop={0}>
+                  <Text color={colors.textDim}>Release: {repo.release_branch} → {repo.production_branch || 'master'}</Text>
+                </Box>
+              )}
             </Box>
           ))}
         </Box>

package/src/lib/types.ts

@@ -53,6 +53,8 @@ export interface RepoConfig {
   name: string;
   path: string;
   description?: string;
+  release_branch?: string;      // e.g., "dev" — source branch for releases
+  production_branch?: string;   // e.g., "master" — target branch for releases
 }
 
 // ToolConfig is flexible - each tool defines its own keys

package/src/tools/release/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "droid-release",
+  "version": "0.1.0",
+  "description": "Release ceremony automation — create release PRs, check status, notify Slack.",
+  "author": {
+    "name": "Orderful",
+    "url": "https://github.com/orderful"
+  },
+  "repository": "https://github.com/orderful/droid",
+  "license": "MIT",
+  "keywords": [
+    "droid",
+    "ai",
+    "release"
+  ],
+  "skills": [
+    "./skills/release/SKILL.md"
+  ],
+  "commands": [
+    "./commands/release.md"
+  ]
+}

package/src/tools/release/TOOL.yaml

@@ -0,0 +1,21 @@
+name: release
+description: "Release ceremony automation — create release PRs, check status, notify Slack."
+version: 0.1.0
+status: alpha
+
+includes:
+  skills:
+    - name: release
+      required: true
+  commands:
+    - name: release
+      is_alias: false
+  agents: []
+
+dependencies: []
+
+config_schema:
+  slack_channel:
+    type: string
+    description: "Slack channel for release notifications"
+    default: "#release-management"

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,74 @@
+---
+name: release
+description: "Release ceremony automation for dev-to-master releases. Use when starting a release, merging a release, checking release status, or completing a release. User prompts like 'start a release', 'merge the release', 'release status', 'release complete'."
+argument-hint: "[start [repo] | merge [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 merge [repo]` | Merge release PR (only if checks pass) + 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 |