@orderful/droid 0.42.0 → 0.43.0

package/dist/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/dist/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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.42.0",
+  "version": "0.43.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/meeting/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-meeting",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Work with meeting notes, summaries, and transcripts. List recent meetings, search content, generate context-aware summaries, export to codex. Backed by Granola MCP.",
   "author": {
     "name": "Orderful",

package/src/tools/meeting/TOOL.yaml

@@ -1,6 +1,6 @@
 name: meeting
 description: "Work with meeting notes, summaries, and transcripts. List recent meetings, search content, generate context-aware summaries, export to codex. Backed by Granola MCP."
-version: 0.1.0
+version: 0.1.1
 status: beta
 
 includes:

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

@@ -1,7 +1,7 @@
 ---
 name: meeting
 description: "Work with meeting notes, summaries, and transcripts. Use when user asks about meetings, wants to review notes, search decisions, or export to codex. User prompts like 'what did we discuss today', 'summarise the tech design review', 'export my meeting with Thea to codex'."
-argument-hint: "[search {query} | summary {title} | summarize {title} | export {title} | decisions | last week]"
+argument-hint: "[search {query} [--all] | summary {title} | summarize {title} | export {title} | decisions | last week]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash(droid:*)]
 ---
 
@@ -41,7 +41,7 @@ If connected, proceed.
 |---------|--------|
 | `/meeting` | List recent meetings (this week) |
 | `/meeting last week` | List meetings from last week |
-| `/meeting search {query}` | Natural language search across all meetings |
+| `/meeting search {query}` | Search meetings (latest match by default; use `--all` for all matches) |
 | `/meeting summary {title}` | Quick summary from Granola (fast, no context cost) |
 | `/meeting summarize {title}` | Context-aware summary using transcript + loaded project/codex context |
 | `/meeting export {title}` | Export meeting to codex |
@@ -61,12 +61,20 @@ Natural language is the primary interface. Users should not need these commands.
 2. Call with `time_range`: `"this_week"` (default) or `"last_week"`
 3. Present results as a table: title, date, participants
 
-### Search (`/meeting search {query}`)
+### Search (`/meeting search {query}` / `/meeting search {query} --all`)
 
-1. Use `ToolSearch` to load `mcp__granola__query_granola_meetings`
-2. Call with user's query
-3. Preserve citation links in the response
-4. Present the response to the user
+**Default behaviour: latest match.** Recurring meetings (dailies, weeklies) return multiple hits. Searching all of them is rarely what the user wants — they usually mean the most recent one.
+
+1. Use `ToolSearch` to load `mcp__granola__list_meetings` and `mcp__granola__query_granola_meetings`
+2. Call `list_meetings` with `time_range: "this_week"` (or `"last_week"` / `"last_30_days"` if no matches)
+3. Fuzzy-match the query against meeting titles in the list
+4. **If multiple meetings match the query title:**
+   - **Without `--all`:** Scope the Granola query to only the **most recent** matching meeting ID (pass `document_ids`). Mention: "Showing results from {date}'s {title}. Use `--all` to search across all {N} matches."
+   - **With `--all`:** Query across all matching meeting IDs (pass all IDs in `document_ids`). Mention: "Searching across {N} {title} meetings."
+5. **If only one meeting matches:** Query that single meeting (pass `document_ids`)
+6. **If no title matches but query looks like a topic:** Fall back to a broad Granola query without `document_ids` (original behaviour)
+7. Preserve citation links in the response
+8. Present the response to the user
 
 ### Quick summary (`/meeting summary {title}`)
 

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"