@orderful/droid 0.5.2 → 0.7.0

package/dist/skills/brain-obsidian/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: brain-obsidian
+description: >-
+  Obsidian extension for brain skill. Adds YAML frontmatter, wikilinks, and folder
+  organization. Requires brain skill. Install this to use brain docs with your
+  Obsidian vault.
+globs:
+  - "**/brain/**/*.md"
+alwaysApply: false
+---
+
+# Brain Obsidian Extension
+
+Extends the brain skill with Obsidian-specific features. **This skill overrides brain's default templates and workflows.**
+
+## Requirements
+
+- `brain` skill must be installed
+- Set `brain_dir` to your Obsidian vault path in brain skill overrides
+
+## Configuration
+
+**Required:** Set vault path in `~/.droid/skills/brain/overrides.yaml`:
+
+```yaml
+brain_dir: ~/path/to/your/vault
+```
+
+**Optional:** Configure folders in `~/.droid/skills/brain-obsidian/overrides.yaml`:
+
+| Setting            | Default       | Description                     |
+|--------------------|---------------|---------------------------------|
+| `inbox_folder`     | `0-Inbox`     | Where new docs are created      |
+| `archive_folder`   | `4-Archives`  | Where stale/done docs go        |
+| `para_structure`   | `false`       | Enable full PARA organization   |
+| `projects_folder`  | `1-Projects`  | Active project docs (PARA only) |
+| `areas_folder`     | `1-Areas`     | Area docs (PARA only)           |
+| `resources_folder` | `3-Resources` | Reference material (PARA only)  |
+
+## What This Adds
+
+| Feature             | Description                                |
+|---------------------|--------------------------------------------|
+| YAML frontmatter    | Type, status, dates, project links, tags   |
+| Wikilinks           | `[[note-name]]` syntax for linking         |
+| Folder organization | Inbox + Archive always; full PARA optional |
+| Project linking     | Associate brain docs with project files    |
+
+## Folder Organization
+
+**Always available:**
+- `inbox_folder` - New docs land here
+- `archive_folder` - Stale/completed docs
+
+**With `para_structure: true`:**
+```
+vault/
+├── {inbox_folder}/      # New docs (default: 0-Inbox)
+├── {projects_folder}/   # Active project docs (default: 1-Projects)
+├── {areas_folder}/      # Area docs (default: 2-Areas)
+├── {resources_folder}/  # Reference material (default: 3-Resources)
+└── {archive_folder}/    # Completed/stale (default: 4-Archives)
+```
+
+## Overridden Behavior
+
+When this skill is installed, **ALL brain operations use Obsidian format**:
+
+### Templates
+
+All docs get YAML frontmatter:
+
+```yaml
+---
+type: plan | research | review | note
+status: exploring | drafting | decided | done
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+project: "[[project-name]]"  # Optional
+tags: []                      # Optional
+---
+```
+
+See `references/templates.md` for full templates.
+
+### File Location
+
+Docs are created in your vault's inbox folder:
+- `{brain_dir}/{inbox_folder}/{filename}.md`
+
+### Finalizing
+
+When running `/brain done`:
+1. Updates status to `done` in frontmatter
+2. Suggests moving to archive (or projects/resources if PARA enabled)
+3. Confirms before moving
+
+## Commands
+
+Same commands as brain skill, but with Obsidian output:
+
+| Command                   | Obsidian Behavior                          |
+|---------------------------|--------------------------------------------|
+| `/brain plan {topic}`     | Creates in inbox with frontmatter          |
+| `/brain research {topic}` | Creates in inbox with frontmatter          |
+| `/brain review {topic}`   | Creates in inbox with frontmatter          |
+| `/brain note {text}`      | Quick capture to inbox                     |
+| `/brain done`             | Updates status, suggests archive/PARA move |

package/dist/skills/brain-obsidian/SKILL.yaml

@@ -0,0 +1,45 @@
+name: brain-obsidian
+description: >-
+  Obsidian extension for brain skill. Adds YAML frontmatter, wikilinks, and folder
+  organization. Requires brain skill. Install this to use brain docs with your
+  Obsidian vault.
+version: 0.1.0
+status: beta
+dependencies:
+  - brain
+  # Optional: project skill enables linking features
+provides_output: false
+config_schema:
+  inbox_folder:
+    type: string
+    description: Folder for new brain docs
+    default: "0-Inbox"
+  archive_folder:
+    type: string
+    description: Folder for archived/stale docs
+    default: "4-Archives"
+  para_structure:
+    type: boolean
+    description: Enable full PARA folder organization
+    default: false
+  projects_folder:
+    type: string
+    description: Folder for active project docs (when para_structure is true)
+    default: "1-Projects"
+  areas_folder:
+    type: string
+    description: Folder for area docs (when para_structure is true)
+    default: "1-Areas"
+  resources_folder:
+    type: string
+    description: Folder for reference material (when para_structure is true)
+    default: "3-Resources"
+examples:
+  - title: "Create planning doc in vault"
+    code: |
+      /brain plan auth refactor
+      # Creates in vault's 0-Inbox/ with YAML frontmatter
+  - title: "Link to project"
+    code: |
+      /brain plan feature-x
+      # Frontmatter includes project: "[[feature-x]]"

package/dist/skills/brain-obsidian/references/templates.md

@@ -0,0 +1,144 @@
+# Obsidian Brain Templates
+
+Templates with YAML frontmatter and wikilink support.
+
+## Plan Template
+
+```markdown
+---
+type: plan
+status: exploring
+created: {date}
+updated: {date}
+project: "[[{project}]]"
+tags: []
+---
+
+# {Topic}
+
+Planning {brief description}.
+
+## Context
+
+What we're solving and why.
+
+## Exploration
+
+Options and approaches considered.
+
+## Decision
+
+What we chose and why.
+
+## Next Steps
+
+- [ ] Action items
+```
+
+## Research Template
+
+```markdown
+---
+type: research
+status: exploring
+created: {date}
+updated: {date}
+project: "[[{project}]]"
+tags: []
+---
+
+# {Topic}
+
+Researching {brief description}.
+
+## Questions
+
+What we're trying to understand.
+
+## Findings
+
+What we've learned.
+
+## Summary
+
+Key takeaways.
+
+## Related
+
+- [[related-note-1]]
+- [[related-note-2]]
+```
+
+## Review Template
+
+```markdown
+---
+type: review
+status: exploring
+created: {date}
+updated: {date}
+project: "[[{project}]]"
+tags: []
+---
+
+# {Topic}
+
+Reviewing {brief description}.
+
+## Overview
+
+What's being reviewed and scope.
+
+## Observations
+
+Key findings and notes.
+
+## Recommendations
+
+Suggested changes or actions.
+
+## Verdict
+
+Overall assessment.
+```
+
+## Note Template
+
+```markdown
+---
+type: note
+created: {date}
+tags: []
+---
+
+# {Brief Title}
+
+{content}
+```
+
+## Template Variables
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `{Topic}` | Doc title from user input | "Auth Refactor" |
+| `{date}` | Current date (YYYY-MM-DD) | "2025-01-15" |
+| `{brief description}` | Context from conversation | "refactoring the authentication system" |
+| `{project}` | Active project name (if any) | "transaction-templates" |
+| `{content}` | User-provided text | (for notes) |
+
+## Frontmatter Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` | string | Doc type: `plan`, `research`, `review`, `note` |
+| `status` | string | Lifecycle: `exploring`, `drafting`, `decided`, `done`, `stale` |
+| `created` | date | Creation date (YYYY-MM-DD) |
+| `updated` | date | Last modification date |
+| `project` | wikilink | Link to related project: `"[[project-name]]"` |
+| `tags` | list | Tags for filtering: `[tag1, tag2]` |
+
+## Wikilink Conventions
+
+- Project links: `[[project-name]]` or `[[1-Projects/project-name/PROJECT]]`
+- Related notes: `[[note-name]]`
+- Use Obsidian's autocomplete to find existing notes

package/dist/skills/brain-obsidian/references/workflows.md

@@ -0,0 +1,192 @@
+# Obsidian Brain Workflows
+
+Obsidian-specific procedures that override brain defaults.
+
+## Creating Docs
+
+**Overrides:** brain's Creating workflow
+
+**Steps:**
+
+1. **Resolve paths from config:**
+   - `brain_dir` from brain skill (your vault path)
+   - `inbox_folder` from brain-obsidian (default: `0-Inbox`)
+
+2. **Target folder:** `{brain_dir}/{inbox_folder}/`
+
+3. **Generate filename** using brain's naming conventions:
+   - Format: `{type}-{topic-slug}.md`
+
+4. **Check for active project:**
+   - If `/project` was loaded this session, use its name for `project` field
+   - Otherwise, leave `project` field empty or ask user
+
+5. **Apply Obsidian template** from `references/templates.md`:
+   - Include YAML frontmatter with all fields
+   - Set `created` and `updated` to today
+   - Set `status: exploring`
+
+6. **Create the file** in vault
+
+7. **Set as active doc** (same as brain)
+
+## Opening Docs
+
+**Overrides:** brain's Opening workflow
+
+**Steps:**
+
+1. **Search in brain_dir** (your vault):
+   ```
+   Glob: {brain_dir}/**/*{topic}*.md
+   ```
+
+2. **Rest of workflow same as brain** (fuzzy match, select, read, set active)
+
+## Updating Frontmatter
+
+When modifying any brain doc:
+
+1. **Update the `updated` field** to current date
+2. **Update `status`** if work has progressed
+3. **Add `project` link** if doc becomes associated with a project
+
+## Finalizing
+
+**Overrides:** brain's Finalizing workflow
+
+**Steps:**
+
+1. **Read active doc** and current location
+
+2. **Update frontmatter:**
+   - Set `status: done`
+   - Update `updated` date
+
+3. **Suggest destination based on content and config:**
+
+   **Without PARA (`para_structure: false`):**
+   | Condition | Suggested Destination |
+   |-----------|----------------------|
+   | Done/stale | `{archive_folder}/` |
+   | Still useful in inbox | Keep in place |
+
+   **With PARA (`para_structure: true`):**
+   | Condition | Suggested Destination |
+   |-----------|----------------------|
+   | Has active project link | `{projects_folder}/` |
+   | Ongoing area of responsibility | `{areas_folder}/` |
+   | Reference/learning value | `{resources_folder}/` |
+   | Stale or obsolete | `{archive_folder}/` |
+
+4. **Confirm move with user** before relocating
+
+5. **Move the file** if confirmed:
+   ```bash
+   mv "{brain_dir}/{inbox_folder}/{file}" "{brain_dir}/{destination}/{file}"
+   ```
+
+6. **Clear active doc** from session
+
+## Quick Notes
+
+**Overrides:** brain's Notes workflow
+
+**Steps:**
+
+1. **Create in inbox:** `{brain_dir}/{inbox_folder}/note-{date}-{slug}.md`
+
+2. **Use note template** with minimal frontmatter:
+   ```yaml
+   ---
+   type: note
+   created: {date}
+   tags: []
+   ---
+   ```
+
+3. **Fire-and-forget** (does not become active)
+
+## Project Integration (Optional)
+
+**Requires:** `project` skill. If not installed, suggest:
+> "Linking to projects requires the project skill. Install it with `droid` → Skills → project"
+
+When a project is loaded via `/project {name}`:
+
+1. **Remember project name** for session
+2. **New brain docs** automatically get `project: "[[{name}]]"` in frontmatter
+3. **Suggest linking** existing brain docs to the project
+
+## Adding Brain Doc to Existing Project
+
+**Trigger:** User says "add this to the project", "link this to project", or "capture in project"
+
+**Requires:** `project` skill. If not installed, suggest:
+> "Linking to projects requires the project skill. Install it with `droid` → Skills → project"
+
+For linking a brain doc (research, notes, design) to an existing project.
+
+**Steps:**
+
+1. **Check for active project:**
+   - If project loaded via `/project`, use that
+   - Otherwise, ask which project to link to
+
+2. **Update brain doc frontmatter:**
+   - Add `project: "[[{project-name}]]"`
+   - Update status if appropriate
+
+3. **Update project:**
+   - Add wikilink in Related section: `[[{brain-doc}]]`
+   - Or add to appropriate section (Key Decisions, Implementation, etc.)
+
+4. **Suggest moving brain doc:**
+   - With PARA: move to `{projects_folder}/` alongside project
+   - Without PARA: keep in place with project link
+
+## Promoting Brain Doc to New Project
+
+**Trigger:** User says "promote to project", "make this a project", or "convert to project"
+
+**Requires:** `project` skill. If not installed, suggest:
+> "Promoting to project requires the project skill. Install it with `droid` → Skills → project"
+
+For graduating a full tech design or plan into its own project.
+
+**Steps:**
+
+1. **Confirm promotion:**
+   - "This will create a new project from this brain doc. Continue?"
+
+2. **Extract project info from brain doc:**
+   - Title → project name
+   - Context → project overview
+   - Decision/Next Steps → initial tasks
+   - Status → project status
+
+3. **Create new project** via project skill:
+   - Generate PROJECT.md from brain doc content
+   - Create CHANGELOG.md with initial entry
+   - Place in projects directory
+
+4. **Update original brain doc:**
+   - Add `project: "[[{new-project}]]"` to frontmatter
+   - Update status to `done`
+   - Add note: "Promoted to project: [[{new-project}]]"
+
+5. **Handle the brain doc:**
+   - Option A: Keep as historical reference in `{resources_folder}/`
+   - Option B: Archive to `{archive_folder}/`
+   - Option C: Delete (content now lives in project)
+
+## Listing Docs
+
+**Overrides:** brain's Listing workflow
+
+Search in vault:
+```
+Glob: {brain_dir}/**/*.md
+```
+
+Filter to brain doc types by checking frontmatter for `type: plan|research|review|note`.

package/dist/skills/comments/SKILL.yaml

@@ -3,7 +3,7 @@ description: >-
   Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI,
   AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup
   to remove resolved threads. Ideal for code review notes and async collaboration.
-version: 0.2.0
+version: 0.2.1
 status: beta
 dependencies: []
 provides_output: false

package/package.json

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

package/src/commands/tui.tsx

@@ -21,7 +21,7 @@ import { getBundledAgents, getBundledAgentsDir, isAgentInstalled, installAgent,
 import { configExists, loadConfig, saveConfig, loadSkillOverrides, saveSkillOverrides } from '../lib/config.js';
 import { configureAIToolPermissions } from './setup.js';
 import { AITool, BuiltInOutput, ConfigOptionType, type DroidConfig, type OutputPreference, type SkillManifest, type ConfigOption, type SkillOverrides } from '../lib/types.js';
-import { getVersion } from '../lib/version.js';
+import { getVersion, getUpdateInfo, runUpdate, type UpdateInfo } from '../lib/version.js';
 
 type Tab = 'skills' | 'commands' | 'agents' | 'settings';
 type View = 'welcome' | 'setup' | 'menu' | 'detail' | 'configure' | 'readme';
@@ -133,20 +133,49 @@ function getOutputOptions(): Array<{ label: string; value: OutputPreference }> {
   return options;
 }
 
-function WelcomeScreen({ onContinue }: { onContinue: () => void }) {
+interface WelcomeScreenProps {
+  onContinue: () => void;
+  onUpdate: () => void;
+  updateInfo: UpdateInfo;
+  isUpdating: boolean;
+}
+
+function WelcomeScreen({ onContinue, onUpdate, updateInfo, isUpdating }: WelcomeScreenProps) {
+  const [selectedButton, setSelectedButton] = useState(0);
+
   useInput((input, key) => {
-    if (key.return || input === 'q') {
-      onContinue();
+    if (isUpdating) return;
+
+    if (updateInfo.hasUpdate) {
+      if (key.leftArrow || key.rightArrow) {
+        setSelectedButton((prev) => (prev === 0 ? 1 : 0));
+      }
+      if (key.return) {
+        if (selectedButton === 0) {
+          onUpdate();
+        } else {
+          onContinue();
+        }
+      }
+      if (input === 'q') {
+        onContinue();
+      }
+    } else {
+      if (key.return || input === 'q') {
+        onContinue();
+      }
     }
   });
 
+  const hasUpdate = updateInfo.hasUpdate && updateInfo.latestVersion;
+
   return (
-    <Box flexDirection="column" alignItems="center" justifyContent="center" height={16}>
+    <Box flexDirection="column" alignItems="center" justifyContent="center" height={18}>
       <Box
         flexDirection="column"
         alignItems="center"
         borderStyle="single"
-        borderColor={colors.border}
+        borderColor={hasUpdate ? '#eab308' : colors.border}
         paddingX={4}
         paddingY={1}
       >
@@ -154,13 +183,13 @@ function WelcomeScreen({ onContinue }: { onContinue: () => void }) {
           <Text>
             <Text color={colors.textDim}>╔═════╗    </Text>
             <Text color={colors.text}>droid</Text>
-            <Text color={colors.textDim}> v{getVersion()}</Text>
+            <Text color={colors.textDim}> v{updateInfo.currentVersion}</Text>
           </Text>
           <Text>
             <Text color={colors.textDim}>║ </Text>
-            <Text color={colors.primary}>●</Text>
+            <Text color={hasUpdate ? '#eab308' : colors.primary}>●</Text>
             <Text color={colors.textDim}> </Text>
-            <Text color={colors.primary}>●</Text>
+            <Text color={hasUpdate ? '#eab308' : colors.primary}>●</Text>
             <Text color={colors.textDim}> ║    </Text>
             <Text color={colors.textMuted}>Teaching your droid new tricks</Text>
           </Text>
@@ -170,13 +199,60 @@ function WelcomeScreen({ onContinue }: { onContinue: () => void }) {
           </Text>
         </Box>
 
-        <Box marginTop={2} marginBottom={1}>
-          <Text backgroundColor={colors.primary} color="#ffffff" bold>
-            {' '}I'm probably the droid you are looking for.{' '}
-          </Text>
-        </Box>
+        {hasUpdate ? (
+          <>
+            <Box marginTop={2} marginBottom={1} flexDirection="column" alignItems="center">
+              <Text color="#eab308" italic>
+                "The odds of functioning optimally without this
+              </Text>
+              <Text color="#eab308" italic>
+                update are approximately 3,720 to 1."
+              </Text>
+            </Box>
+
+            <Box marginBottom={1}>
+              <Text color={colors.textMuted}>
+                v{updateInfo.currentVersion} → v{updateInfo.latestVersion}
+              </Text>
+            </Box>
 
-        <Text color={colors.textDim}>press enter</Text>
+            {isUpdating ? (
+              <Text color="#eab308">Updating...</Text>
+            ) : (
+              <Box flexDirection="row">
+                <Text
+                  backgroundColor={selectedButton === 0 ? '#eab308' : colors.bgSelected}
+                  color={selectedButton === 0 ? '#000000' : colors.textMuted}
+                  bold={selectedButton === 0}
+                >
+                  {' '}Update{' '}
+                </Text>
+                <Text> </Text>
+                <Text
+                  backgroundColor={selectedButton === 1 ? colors.bgSelected : undefined}
+                  color={selectedButton === 1 ? colors.text : colors.textMuted}
+                  bold={selectedButton === 1}
+                >
+                  {' '}Skip for now{' '}
+                </Text>
+              </Box>
+            )}
+
+            <Box marginTop={1}>
+              <Text color={colors.textDim}>←→ select · enter</Text>
+            </Box>
+          </>
+        ) : (
+          <>
+            <Box marginTop={2} marginBottom={1}>
+              <Text backgroundColor={colors.primary} color="#ffffff" bold>
+                {' '}I'm probably the droid you are looking for.{' '}
+              </Text>
+            </Box>
+
+            <Text color={colors.textDim}>press enter</Text>
+          </>
+        )}
       </Box>
     </Box>
   );
@@ -1183,6 +1259,31 @@ function App() {
   const [message, setMessage] = useState<{ text: string; type: 'success' | 'error' } | null>(null);
   const [isEditingSettings, setIsEditingSettings] = useState(false);
   const [readmeContent, setReadmeContent] = useState<{ title: string; content: string } | null>(null);
+  const [isUpdating, setIsUpdating] = useState(false);
+
+  // Check for updates once on mount
+  const updateInfo = useMemo(() => getUpdateInfo(), []);
+
+  const handleUpdate = () => {
+    setIsUpdating(true);
+    // Run update in next tick to allow UI to show "Updating..."
+    setTimeout(() => {
+      const result = runUpdate();
+      if (result.success) {
+        // Exit and let user restart with new version
+        exit();
+      } else {
+        setIsUpdating(false);
+        setMessage({ text: result.message, type: 'error' });
+        // Continue to menu on failure
+        if (!configExists()) {
+          setView('setup');
+        } else {
+          setView('menu');
+        }
+      }
+    }, 100);
+  };
 
   const MAX_VISIBLE_ITEMS = 6;
 
@@ -1424,6 +1525,9 @@ function App() {
   if (view === 'welcome') {
     return (
       <WelcomeScreen
+        updateInfo={updateInfo}
+        isUpdating={isUpdating}
+        onUpdate={handleUpdate}
         onContinue={() => {
           // If no config exists, show setup first
           if (!configExists()) {
@@ -1498,6 +1602,7 @@ function App() {
             <Text color={colors.primary}>●</Text>
             <Text color={colors.textDim}>] </Text>
             <Text color={colors.textMuted}>droid</Text>
+            <Text color={colors.textDim}> v{getVersion()}</Text>
           </Text>
         </Box>