@orderful/droid 0.4.1 → 0.5.1

package/dist/skills/project/references/creating.md

@@ -0,0 +1,58 @@
+# Creating a Project
+
+**Trigger:** `/project create {name?}` or user asks to start a new project
+
+## Procedure
+
+1. **Get project name**
+   - Use provided name, or ask if not provided
+   - Convert to kebab-case for folder name
+   - Convert to Title Case for display name
+
+2. **Create project folder**
+   - Path: `{projects_dir}/{kebab-case-name}/`
+   - Verify folder doesn't already exist
+
+3. **Create files from templates** (see `templates.md`)
+   - `PROJECT.md` - Main context file
+   - `CHANGELOG.md` - Version history
+   - Format varies by `preset` config (markdown vs obsidian)
+
+4. **Confirm creation**
+   - Show created folder path
+   - Offer to help fill in sections (Overview, Goals, Technical Details)
+
+## Naming Convention
+
+| Input | Folder Name | Display Name |
+|-------|-------------|--------------|
+| "billing refactor" | `billing-refactor` | "Billing Refactor" |
+| "API v2" | `api-v2` | "API V2" |
+| "my-feature" | `my-feature` | "My Feature" |
+
+## Example
+
+```
+User: /project create billing refactor
+
+Claude: Creating new project...
+
+Created: ~/.claude/projects/billing-refactor/
+├── PROJECT.md
+└── CHANGELOG.md
+
+Project "Billing Refactor" initialized at v0.1.0.
+
+Would you like help filling in the Overview, Goals, or Technical Details sections?
+```
+
+## Initial Structure
+
+New projects start minimal and grow organically. Common sections added over time:
+
+- **Current Work** - Active tasks and focus areas
+- **Decisions Log** - Key decisions with rationale
+- **Related** - Links to other docs, tickets, repos
+- **Roadmap** - Future phases
+
+See `templates.md` for the full initial template.

package/dist/skills/project/references/loading.md

@@ -0,0 +1,40 @@
+# Loading a Project
+
+**Trigger:** `/project {keywords}` or user asks to load/open a project
+
+## Procedure
+
+1. **List projects** in configured `projects_dir`
+   - Each subfolder with a `PROJECT.md` is a project
+
+2. **If no name provided:**
+   - Use AskUserQuestion to present available projects
+   - Let user select which to load
+
+3. **If name/keywords provided:**
+   - Parse as space-separated keywords (e.g., "transaction templates" → `["transaction", "templates"]`)
+   - Find folders where name contains ALL keywords (case-insensitive, hyphens as word separators)
+
+4. **Based on matches:**
+   - **No matches**: List available projects, ask user to select
+   - **One match**: Read `{folder}/PROJECT.md`
+   - **Multiple matches**: Use AskUserQuestion to select from matches
+
+5. **After loading:**
+   - Confirm which project was loaded
+   - Summarize key context (2-3 sentences)
+   - Use project contents for all subsequent work in the session
+
+## Example
+
+```
+User: /project transaction templates
+
+Claude: Found project "transaction-templates". Loading...
+
+Loaded #project-transaction-templates (v1.16.1)
+
+This project covers Handlebars templates for EDI transaction generation.
+Key focus areas: template rendering service, permission controls, and
+the upcoming UI for template management.
+```

package/dist/skills/project/references/templates.md

@@ -0,0 +1,124 @@
+# Project Templates
+
+Templates vary by `preset` setting.
+
+## Markdown Preset (default)
+
+### PROJECT.md
+
+```markdown
+---
+status: active
+---
+
+# Project: {Name}
+
+{Brief description}
+
+| | |
+|---|---|
+| **Version** | 0.1.0 |
+| **Started** | {today} |
+| **Status** | Active |
+
+## Overview
+
+{**What** this project does, **why** it exists}
+
+## Goals
+
+- {Goal 1}
+
+## Technical Details
+
+{Architecture, key files, patterns}
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for full history.
+
+### 0.1.0 - {today}
+- Initial project setup
+```
+
+### CHANGELOG.md
+
+```markdown
+# Changelog
+
+All notable changes to the {Name} project.
+
+## 0.1.0 - {today}
+- Initial project setup
+```
+
+---
+
+## Obsidian Preset
+
+### PROJECT.md
+
+```markdown
+---
+type: project
+status: active
+created: {today}
+updated: {today}
+---
+
+# Project: {Name}
+
+{Brief description}
+
+| | |
+|---|---|
+| **Version** | 0.1.0 |
+| **Started** | {today} |
+| **Status** | Active |
+
+## Overview
+
+{**What** this project does, **why** it exists}
+
+## Goals
+
+- {Goal 1}
+
+## Technical Details
+
+{Architecture, key files, patterns}
+
+## Related
+
+- {Links to related notes}
+
+## Changelog
+
+See [[CHANGELOG|full history]].
+
+### 0.1.0 - {today}
+- Initial project setup
+```
+
+### CHANGELOG.md
+
+Same as markdown preset.
+
+---
+
+## Template Variables
+
+| Variable | Expands To |
+|----------|------------|
+| `{today}` | YYYY-MM-DD |
+| `{Name}` | Project name (Title Case) |
+| `{name}` | Project name (lowercase) |
+| `{kebab-name}` | Folder name (kebab-case) |
+
+## Preset Differences Summary
+
+| Feature | Markdown | Obsidian |
+|---------|----------|----------|
+| Links | `[text](path)` | `[[path\|text]]` |
+| YAML properties | Minimal (`status`) | Rich (`type`, `created`, `updated`) |
+| Related section | Optional | Included |

package/dist/skills/project/references/updating.md

@@ -0,0 +1,64 @@
+# Updating a Project
+
+**Trigger:** `/project update` or user asks to capture/save learnings
+
+## Procedure
+
+1. **Identify the project:**
+   - If name provided: Find matching project (same logic as loading)
+   - If no name: Check conversation for prior project load
+   - If still unclear: List projects and ask which to update
+
+2. **Analyze the conversation for:**
+   - New implementation details or patterns
+   - Key decisions and rationale
+   - Technical constraints discovered
+   - Progress on features
+   - Important file paths or code locations
+   - Bug fixes or gotchas encountered
+
+3. **If significant new information found:**
+   - Propose specific sections/content to add or update
+   - Show what will be changed
+   - Ask for confirmation before proceeding
+
+4. **If no obvious updates:**
+   - Ask what the user would like to update
+   - Suggest sections: metadata, implementation details, technical decisions, notes
+
+5. **After approval:**
+   - Read current project file
+   - Make approved updates, preserving existing structure
+   - Determine version bump (see `versioning.md`)
+   - Add changelog entry (see `changelog.md`)
+   - Confirm what was updated
+
+## What to Capture
+
+Good project updates include:
+
+| Type | Examples |
+|------|----------|
+| **Decisions** | "Chose cursor-based pagination over offset" |
+| **Patterns** | "Using repository pattern for data access" |
+| **Constraints** | "Must support backwards compatibility with v1 API" |
+| **Gotchas** | "Watch out for timezone handling in date fields" |
+| **Progress** | "Completed validation layer, starting on UI" |
+| **File locations** | "Key files: `src/services/template.service.ts`" |
+
+## Example
+
+```
+User: /project update
+
+Claude: I'll update #project-transaction-templates with learnings from this session.
+
+Proposed changes:
+- Add "Permission Controls" section documenting the new RBAC approach
+- Update Technical Details with the Handlebars helper patterns we established
+- Note the decision to use soft deletes
+
+This looks like a minor version bump (0.16.0 → 0.17.0).
+
+Proceed with these updates?
+```

package/dist/skills/project/references/versioning.md

@@ -0,0 +1,36 @@
+# Version Bumping Rules
+
+Use semantic versioning for project docs.
+
+## When to Bump
+
+| Type | When | Examples |
+|------|------|----------|
+| **Major** | Breaking changes, complete rewrites, fundamental architecture changes | New approach that invalidates previous docs |
+| **Minor** | New features, new sections, significant additions | New helper added, new endpoint, new workflow |
+| **Patch** | Clarifications, small updates, typo fixes, status changes | Wording tweaks, deferred features, bug notes |
+
+## Auto-Determination
+
+Analyze the changes being made:
+
+1. Default to **minor** for most content additions
+2. Use **patch** for small clarifications or status updates
+3. Use **major** only for fundamental changes (rare)
+4. Only ask user if genuinely ambiguous
+
+## Examples
+
+**Patch (0.1.0 -> 0.1.1):**
+- Fixed typo in technical details
+- Updated status from active to reference
+- Added note about known limitation
+
+**Minor (0.1.1 -> 0.2.0):**
+- Added new "Authentication" section
+- Documented new API endpoint
+- Added architecture diagram
+
+**Major (0.2.0 -> 1.0.0):**
+- Complete rewrite of implementation approach
+- Switched from REST to GraphQL (invalidates prior docs)

package/package.json

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

package/src/commands/tui.tsx

@@ -11,6 +11,8 @@ import {
   getInstalledSkill,
   installSkill,
   uninstallSkill,
+  updateSkill,
+  getSkillUpdateStatus,
   isCommandInstalled,
   installCommand,
   uninstallCommand,
@@ -62,7 +64,23 @@ function getCommandsFromSkills(): Command[] {
       const content = readFileSync(join(commandsDir, file), 'utf-8');
       const lines = content.split('\n');
 
-      const headerMatch = lines[0]?.match(/^#\s+\/(\S+)\s*-?\s*(.*)/);
+      // Skip YAML frontmatter if present
+      let startLine = 0;
+      if (lines[0]?.trim() === '---') {
+        for (let i = 1; i < lines.length; i++) {
+          if (lines[i]?.trim() === '---') {
+            startLine = i + 1;
+            break;
+          }
+        }
+      }
+
+      // Find first H1 header
+      let headerMatch: RegExpMatchArray | null = null;
+      for (let i = startLine; i < lines.length; i++) {
+        headerMatch = lines[i]?.match(/^#\s+\/(\S+)\s*-?\s*(.*)/);
+        if (headerMatch) break;
+      }
       if (!headerMatch) continue;
 
       const usage: string[] = [];
@@ -393,6 +411,7 @@ function SkillItem({
 }) {
   const installed = isSkillInstalled(skill.name);
   const installedInfo = getInstalledSkill(skill.name);
+  const updateStatus = getSkillUpdateStatus(skill.name);
 
   return (
     <Box paddingX={1} backgroundColor={isActive ? colors.bgSelected : undefined}>
@@ -401,6 +420,7 @@ function SkillItem({
         <Text color={isSelected || isActive ? colors.text : colors.textMuted}>{skill.name}</Text>
         {installed && installedInfo && <Text color={colors.textDim}> v{installedInfo.version}</Text>}
         {installed && <Text color={colors.success}> *</Text>}
+        {updateStatus.hasUpdate && <Text color={colors.primary}> ↑</Text>}
       </Text>
     </Box>
   );
@@ -444,12 +464,16 @@ function SkillDetails({
   }
 
   const installed = isSkillInstalled(skill.name);
+  const updateStatus = getSkillUpdateStatus(skill.name);
   const skillCommands = getCommandsFromSkills().filter((c) => c.skillName === skill.name);
 
   const actions = installed
     ? [
         { id: 'view', label: 'View', variant: 'default' },
-        { id: 'configure', label: 'Configure', variant: 'primary' },
+        ...(updateStatus.hasUpdate
+          ? [{ id: 'update', label: `Update (${updateStatus.bundledVersion})`, variant: 'primary' }]
+          : []),
+        { id: 'configure', label: 'Configure', variant: 'default' },
         { id: 'uninstall', label: 'Uninstall', variant: 'danger' },
       ]
     : [
@@ -466,6 +490,9 @@ function SkillDetails({
           {skill.version}
           {skill.status && ` · ${skill.status}`}
           {installed && <Text color={colors.success}> · installed</Text>}
+          {updateStatus.hasUpdate && (
+            <Text color={colors.primary}> · update available ({updateStatus.installedVersion} → {updateStatus.bundledVersion})</Text>
+          )}
         </Text>
       </Box>
 
@@ -933,6 +960,8 @@ function SkillConfigScreen({ skill, onComplete, onCancel }: SkillConfigScreenPro
   const [selectedIndex, setSelectedIndex] = useState(0);
   const [editingField, setEditingField] = useState<string | null>(null);
   const [editValue, setEditValue] = useState('');
+  const [editingSelect, setEditingSelect] = useState<string | null>(null);
+  const [selectOptionIndex, setSelectOptionIndex] = useState(0);
 
   const handleSave = () => {
     saveSkillOverrides(skill.name, values);
@@ -955,6 +984,28 @@ function SkillConfigScreen({ skill, onComplete, onCancel }: SkillConfigScreenPro
     }
   }, { isActive: editingField !== null });
 
+  // Handle select field editing
+  useInput((input, key) => {
+    if (!editingSelect) return;
+    const option = configSchema[editingSelect];
+    if (!option?.options) return;
+
+    if (key.escape) {
+      setEditingSelect(null);
+      return;
+    }
+    if (key.leftArrow || key.upArrow) {
+      setSelectOptionIndex((prev) => Math.max(0, prev - 1));
+    }
+    if (key.rightArrow || key.downArrow) {
+      setSelectOptionIndex((prev) => Math.min(option.options!.length - 1, prev + 1));
+    }
+    if (key.return) {
+      setValues((prev) => ({ ...prev, [editingSelect]: option.options![selectOptionIndex] }));
+      setEditingSelect(null);
+    }
+  }, { isActive: editingSelect !== null });
+
   // Handle navigation and actions when not editing
   useInput((input, key) => {
     if (key.escape) {
@@ -983,13 +1034,19 @@ function SkillConfigScreen({ skill, onComplete, onCancel }: SkillConfigScreenPro
       if (option.type === ConfigOptionType.Boolean) {
         // Toggle boolean
         setValues((prev) => ({ ...prev, [key]: !prev[key] }));
+      } else if (option.type === ConfigOptionType.Select && option.options) {
+        // Enter select edit mode
+        const currentValue = String(values[key] || option.options[0]);
+        const currentIndex = option.options.indexOf(currentValue);
+        setSelectOptionIndex(currentIndex >= 0 ? currentIndex : 0);
+        setEditingSelect(key);
       } else if (option.type === ConfigOptionType.String) {
         // Enter edit mode for string
         setEditingField(key);
         setEditValue(String(values[key] || ''));
       }
     }
-  }, { isActive: editingField === null });
+  }, { isActive: editingField === null && editingSelect === null });
 
   if (configKeys.length === 0) {
     return (
@@ -1044,6 +1101,25 @@ function SkillConfigScreen({ skill, onComplete, onCancel }: SkillConfigScreenPro
                   <Text color={colors.text}>
                     [{values[key] ? 'x' : ' '}] {values[key] ? 'enabled' : 'disabled'}
                   </Text>
+                ) : option.type === ConfigOptionType.Select && option.options ? (
+                  <Text color={colors.text}>
+                    {option.options.map((opt, i) => {
+                      const isCurrentValue = String(values[key]) === opt;
+                      const isEditingThis = editingSelect === key;
+                      const isHighlighted = isEditingThis && selectOptionIndex === i;
+                      return (
+                        <Text key={opt}>
+                          {i > 0 && <Text color={colors.textDim}> · </Text>}
+                          <Text
+                            color={isHighlighted ? '#ffffff' : isCurrentValue ? colors.primary : colors.textMuted}
+                            backgroundColor={isHighlighted ? colors.primary : undefined}
+                          >
+                            {isCurrentValue && !isEditingThis ? `[${opt}]` : isHighlighted ? ` ${opt} ` : opt}
+                          </Text>
+                        </Text>
+                      );
+                    })}
+                  </Text>
                 ) : isEditing ? (
                   <Box>
                     <Text color={colors.textDim}>{'> '}</Text>
@@ -1078,7 +1154,11 @@ function SkillConfigScreen({ skill, onComplete, onCancel }: SkillConfigScreenPro
 
       <Box marginTop={1}>
         <Text color={colors.textDim}>
-          {editingField ? 'enter save · esc cancel' : '↑↓ select · enter toggle/edit · esc back'}
+          {editingField
+            ? 'enter save · esc cancel'
+            : editingSelect
+              ? '←→ choose · enter select · esc cancel'
+              : '↑↓ select · enter toggle/edit · esc back'}
         </Text>
       </Box>
     </Box>
@@ -1184,7 +1264,9 @@ function App() {
         if (activeTab === 'skills') {
           const skill = skills[selectedIndex];
           const installed = skill ? isSkillInstalled(skill.name) : false;
-          maxActions = installed ? 2 : 1; // View, Configure, Uninstall or View, Install
+          const hasUpdate = skill ? getSkillUpdateStatus(skill.name).hasUpdate : false;
+          // View, [Update], Configure, Uninstall or View, Install
+          maxActions = installed ? (hasUpdate ? 3 : 2) : 1;
         } else if (activeTab === 'agents') {
           maxActions = 1; // View, Install/Uninstall
         } else if (activeTab === 'commands') {
@@ -1199,20 +1281,38 @@ function App() {
         const skill = skills[selectedIndex];
         if (skill) {
           const installed = isSkillInstalled(skill.name);
-          // Actions: installed = [View, Configure, Uninstall], not installed = [View, Install]
-          if (selectedAction === 0) {
-            // View
+          const skillUpdateStatus = getSkillUpdateStatus(skill.name);
+          // Build actions array to match SkillDetails
+          const skillActions = installed
+            ? [
+                { id: 'view' },
+                ...(skillUpdateStatus.hasUpdate ? [{ id: 'update' }] : []),
+                { id: 'configure' },
+                { id: 'uninstall' },
+              ]
+            : [{ id: 'view' }, { id: 'install' }];
+
+          const actionId = skillActions[selectedAction]?.id;
+
+          if (actionId === 'view') {
             const skillMdPath = join(getBundledSkillsDir(), skill.name, 'SKILL.md');
             if (existsSync(skillMdPath)) {
               const content = readFileSync(skillMdPath, 'utf-8');
               setReadmeContent({ title: `${skill.name}/SKILL.md`, content });
               setView('readme');
             }
-          } else if (installed && selectedAction === 1) {
-            // Configure
+          } else if (actionId === 'update') {
+            const result = updateSkill(skill.name);
+            setMessage({
+              text: result.success ? `✓ ${result.message}` : `✗ ${result.message}`,
+              type: result.success ? 'success' : 'error',
+            });
+            if (result.success) {
+              setSelectedAction(0);
+            }
+          } else if (actionId === 'configure') {
             setView('configure');
-          } else if (installed && selectedAction === 2) {
-            // Uninstall
+          } else if (actionId === 'uninstall') {
             const result = uninstallSkill(skill.name);
             setMessage({
               text: result.success ? `✓ Uninstalled ${skill.name}` : `✗ ${result.message}`,
@@ -1222,8 +1322,7 @@ function App() {
               setView('menu');
               setSelectedAction(0);
             }
-          } else if (!installed && selectedAction === 1) {
-            // Install
+          } else if (actionId === 'install') {
             const result = installSkill(skill.name);
             setMessage({
               text: result.success ? `✓ Installed ${skill.name}` : `✗ ${result.message}`,
@@ -1486,6 +1585,13 @@ function App() {
           )}
         </Box>
 
+        {/* Message */}
+        {message && (
+          <Box paddingX={1} marginTop={1}>
+            <Text color={message.type === 'success' ? colors.success : colors.error}>{message.text}</Text>
+          </Box>
+        )}
+
         {/* Footer */}
         <Box paddingX={1} marginTop={1}>
           <Text color={colors.textDim}>
@@ -1510,13 +1616,6 @@ function App() {
       {activeTab === 'agents' && (
         <AgentDetails agent={selectedAgent} isFocused={view === 'detail'} selectedAction={selectedAction} />
       )}
-
-      {/* Message */}
-      {message && (
-        <Box position="absolute" marginTop={12}>
-          <Text color={message.type === 'success' ? colors.success : colors.error}>{message.text}</Text>
-        </Box>
-      )}
     </Box>
   );
 }