synap 0.3.0 → 0.4.0

package/.claude/skills/synap-assistant/SKILL.md

@@ -51,7 +51,7 @@ Detect user intent and respond appropriately:
 | **Capture** | "Add this...", "Remind me...", "I had an idea..." | Fast capture, minimal questions, default to idea type |
 | **Review** | "What's on my plate?", "Daily review", "Show me..." | Stats + prioritized summary, grouped by type |
 | **Triage** | "Process my synap", "Process my brain dump", "What needs attention?" | Surface raw entries, help classify and prioritize |
-| **Focus** | "What should I work on?", "Priority items" | P1 todos + active projects, clear next actions |
+| **Focus** | "What should I work on?", "Priority items" | WIP items + P1 todos + active projects, clear next actions |
 | **Cleanup** | "Archive completed", "Clean up old stuff" | Bulk operations with preview and confirmation |
 
 ### Volume Modes (Quick vs Deep)
@@ -74,6 +74,8 @@ Detect user intent and respond appropriately:
 | Search | `synap search "keyword"` |
 | Show details | `synap show <id>` |
 | Mark done | `synap done <id>` |
+| Start working | `synap start <id>` |
+| Stop working | `synap stop <id>` |
 | Get stats | `synap stats` |
 | Setup wizard | `synap setup` |
 | Edit preferences | `synap preferences --edit` |
@@ -110,7 +112,7 @@ synap add --type project --title "Website Redesign" "Complete overhaul of the ma
 - `--priority <1|2|3>`: 1=high, 2=medium, 3=low
 - `--tags <tags>`: Comma-separated tags
 - `--parent <id>`: Parent entry ID
-- `--due <date>`: Due date (YYYY-MM-DD, 3d/1w, or keywords: today, tomorrow, next monday)
+- `--due <date>`: Due date (YYYY-MM-DD, 3d/1w, weekday names: monday/friday, or keywords: today, tomorrow, next monday)
 - `--json`: JSON output
 
 #### `synap todo <content>`
@@ -133,6 +135,18 @@ synap question "Should we migrate to TypeScript?"
 
 Options: `--priority`, `--tags`, `--parent`, `--due`, `--json`
 
+#### `synap log <id> <message>`
+Add a timestamped log entry under a parent entry.
+
+```bash
+synap log a1b2c3d4 "Started implementation"
+synap log a1b2c3d4 "Completed first draft" --inherit-tags
+```
+
+**Options**:
+- `--inherit-tags`: Copy tags from parent entry
+- `--json`: JSON output
+
 ### Query Commands
 
 #### `synap list`
@@ -154,7 +168,7 @@ synap list --json                       # JSON output for parsing
 
 **Options**:
 - `--type <type>`: Filter by entry type
-- `--status <status>`: raw, active, someday, done, archived (default: raw,active)
+- `--status <status>`: raw, active, wip, someday, done, archived (default: raw,active)
 - `--tags <tags>`: Comma-separated, AND logic
 - `--priority <1|2|3>`: Filter by priority
 - `--parent <id>`: Children of specific entry
@@ -239,6 +253,36 @@ synap done --type todo --tags "sprint-1"     # By filter
 synap done --dry-run --type todo             # Preview first
 ```
 
+#### `synap start <ids...>`
+Start working on entries (mark as WIP).
+
+```bash
+synap start a1b2c3d4                         # Single entry
+synap start a1b2c3d4 b2c3d4e5                # Multiple
+synap start --type todo --tags urgent        # By filter
+synap start --dry-run --type todo            # Preview first
+```
+
+**Options**:
+- `-t, --type <type>`: Filter by type
+- `--tags <tags>`: Filter by tags
+- `--dry-run`: Show what would be started
+- `--json`: JSON output
+
+#### `synap stop <ids...>`
+Stop working on entries (remove WIP status).
+
+```bash
+synap stop a1b2c3d4                          # Single entry
+synap stop --all                             # Stop all WIP entries
+synap stop --dry-run                         # Preview first
+```
+
+**Options**:
+- `--all`: Stop all WIP entries
+- `--dry-run`: Show what would be stopped
+- `--json`: JSON output
+
 #### `synap archive <ids...>`
 Archive entries (hides from default view).
 
@@ -447,12 +491,13 @@ Critical for preventing accidental mass changes:
   "content": "The full text of the entry",
   "title": "Short title (optional)",
   "type": "idea|project|feature|todo|question|reference|note",
-  "status": "raw|active|someday|done|archived",
+  "status": "raw|active|wip|someday|done|archived",
   "priority": 1|2|3|null,
   "tags": ["tag1", "tag2"],
   "parent": "parent-id|null",
   "related": ["id1", "id2"],
   "due": "2026-01-10T23:59:59.000Z",
+  "startedAt": "2026-01-10T08:30:00.000Z",
   "createdAt": "2026-01-05T08:30:00.000Z",
   "updatedAt": "2026-01-05T08:30:00.000Z",
   "source": "cli|agent|import"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synap",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "A CLI for externalizing your working memory",
   "main": "src/cli.js",
   "bin": {

package/src/cli.js

@@ -81,6 +81,17 @@ async function main() {
     return date.toLocaleDateString();
   };
 
+  const formatDuration = (ms) => {
+    const minutes = Math.floor(ms / (1000 * 60));
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+
+    if (days > 0) return `(${days}d ${hours % 24}h)`;
+    if (hours > 0) return `(${hours}h ${minutes % 60}m)`;
+    if (minutes > 0) return `(${minutes}m)`;
+    return '(<1m)';
+  };
+
   // ============================================
   // CAPTURE COMMANDS
   // ============================================
@@ -297,6 +308,67 @@ async function main() {
     .option('--json', 'Output as JSON')
     .action(createTypeShorthand('reference', 'reference'));
 
+  program
+    .command('log <id> <message...>')
+    .description('Add a timestamped log entry under a parent')
+    .option('--inherit-tags', 'Copy tags from parent entry')
+    .option('--json', 'Output as JSON')
+    .action(async (id, messageParts, options) => {
+      const message = messageParts.join(' ');
+
+      const parent = await storage.getEntry(id);
+      if (!parent) {
+        if (options.json) {
+          console.log(JSON.stringify({ success: false, error: `Parent entry not found: ${id}`, code: 'ENTRY_NOT_FOUND' }));
+        } else {
+          console.error(chalk.red(`Parent entry not found: ${id}`));
+        }
+        process.exit(1);
+      }
+
+      const now = new Date();
+      const timestamp = now.toISOString().slice(0, 16).replace('T', ' ');
+      const content = `[${timestamp}] ${message}`;
+      const title = message.length <= 40 ? message : message.slice(0, 37) + '...';
+
+      let tags = [];
+      if (options.inheritTags && parent.tags && parent.tags.length > 0) {
+        tags = [...parent.tags];
+      }
+
+      try {
+        const entry = await storage.addEntry({
+          content,
+          title,
+          type: 'note',
+          tags,
+          parent: parent.id,
+          source: 'cli'
+        });
+
+        if (options.json) {
+          console.log(JSON.stringify({
+            success: true,
+            entry,
+            parent: { id: parent.id, title: parent.title || parent.content.slice(0, 40) }
+          }, null, 2));
+        } else {
+          const shortId = entry.id.slice(0, 8);
+          const parentShortId = parent.id.slice(0, 8);
+          console.log(chalk.green(`Logged ${shortId} under ${parentShortId}:`));
+          console.log(`  Parent: ${chalk.cyan(parent.title || parent.content.slice(0, 30))}`);
+          console.log(`  Log: ${message.slice(0, 60)}${message.length > 60 ? '...' : ''}`);
+        }
+      } catch (err) {
+        if (options.json) {
+          console.log(JSON.stringify({ success: false, error: err.message }));
+        } else {
+          console.error(chalk.red(err.message));
+        }
+        process.exit(1);
+      }
+    });
+
   // ============================================
   // QUERY COMMANDS
   // ============================================
@@ -775,6 +847,126 @@ async function main() {
       }
     });
 
+  program
+    .command('start [ids...]')
+    .description('Start working on entries (mark as WIP)')
+    .option('-t, --type <type>', 'Filter by type')
+    .option('--tags <tags>', 'Filter by tags')
+    .option('--dry-run', 'Show what would be started')
+    .option('--json', 'Output as JSON')
+    .action(async (ids, options) => {
+      let entries;
+
+      if (ids.length > 0) {
+        entries = await storage.getEntriesByIds(ids);
+      } else if (options.type || options.tags) {
+        const result = await storage.listEntries({
+          type: options.type,
+          tags: options.tags ? options.tags.split(',').map(t => t.trim()) : undefined,
+          status: 'raw,active',
+          limit: 1000
+        });
+        entries = result.entries;
+      } else {
+        console.error(chalk.red('Please provide entry IDs or filter options (--type, --tags)'));
+        process.exit(1);
+      }
+
+      entries = entries.filter(e => e.status !== 'wip');
+
+      if (entries.length === 0) {
+        if (options.json) {
+          console.log(JSON.stringify({ success: true, count: 0, entries: [] }));
+        } else {
+          console.log(chalk.gray('No entries to start (already WIP or not found)'));
+        }
+        return;
+      }
+
+      if (options.dryRun) {
+        if (options.json) {
+          console.log(JSON.stringify({ success: true, dryRun: true, count: entries.length, entries }));
+        } else {
+          console.log(chalk.yellow(`Would start ${entries.length} entries:`));
+          for (const entry of entries) {
+            console.log(`  ${entry.id.slice(0, 8)} (${entry.type}): ${entry.title || entry.content.slice(0, 40)}...`);
+          }
+        }
+        return;
+      }
+
+      const startedAt = new Date().toISOString();
+      const updatedEntries = [];
+      for (const entry of entries) {
+        const updated = await storage.updateEntry(entry.id, { status: 'wip', startedAt });
+        updatedEntries.push(updated);
+      }
+
+      if (options.json) {
+        console.log(JSON.stringify({ success: true, count: updatedEntries.length, entries: updatedEntries }));
+      } else {
+        console.log(chalk.green(`Started ${updatedEntries.length} entries (marked as WIP)`));
+        for (const entry of updatedEntries) {
+          console.log(`  ${chalk.blue(entry.id.slice(0, 8))} ${entry.title || entry.content.slice(0, 40)}`);
+        }
+      }
+    });
+
+  program
+    .command('stop [ids...]')
+    .description('Stop working on entries (remove WIP status)')
+    .option('--all', 'Stop all WIP entries')
+    .option('--dry-run', 'Show what would be stopped')
+    .option('--json', 'Output as JSON')
+    .action(async (ids, options) => {
+      let entries;
+
+      if (ids.length > 0) {
+        entries = await storage.getEntriesByIds(ids);
+        entries = entries.filter(e => e.status === 'wip');
+      } else if (options.all) {
+        const result = await storage.listEntries({ status: 'wip', limit: 1000 });
+        entries = result.entries;
+      } else {
+        console.error(chalk.red('Please provide entry IDs or use --all to stop all WIP entries'));
+        process.exit(1);
+      }
+
+      if (entries.length === 0) {
+        if (options.json) {
+          console.log(JSON.stringify({ success: true, count: 0, entries: [] }));
+        } else {
+          console.log(chalk.gray('No WIP entries to stop'));
+        }
+        return;
+      }
+
+      if (options.dryRun) {
+        if (options.json) {
+          console.log(JSON.stringify({ success: true, dryRun: true, count: entries.length, entries }));
+        } else {
+          console.log(chalk.yellow(`Would stop ${entries.length} WIP entries:`));
+          for (const entry of entries) {
+            const duration = entry.startedAt ? formatDuration(Date.now() - new Date(entry.startedAt).getTime()) : '';
+            console.log(`  ${entry.id.slice(0, 8)}: ${entry.title || entry.content.slice(0, 40)}... ${duration}`);
+          }
+        }
+        return;
+      }
+
+      const updatedEntries = [];
+      for (const entry of entries) {
+        const updated = await storage.updateEntry(entry.id, { status: 'active', startedAt: null });
+        updatedEntries.push(updated);
+      }
+
+      if (options.json) {
+        console.log(JSON.stringify({ success: true, count: updatedEntries.length, entries: updatedEntries }));
+      } else {
+        console.log(chalk.green(`Stopped ${updatedEntries.length} entries (marked as active)`));
+      }
+    });
+
   program
     .command('archive [ids...]')
     .description('Archive entries')

package/src/storage.js

@@ -15,7 +15,7 @@ const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
 
 // Valid types, statuses, and date formats
 const VALID_TYPES = ['idea', 'project', 'feature', 'todo', 'question', 'reference', 'note'];
-const VALID_STATUSES = ['raw', 'active', 'someday', 'done', 'archived'];
+const VALID_STATUSES = ['raw', 'active', 'wip', 'someday', 'done', 'archived'];
 const VALID_DATE_FORMATS = ['relative', 'absolute', 'locale'];
 
 /**
@@ -250,6 +250,26 @@ function parseDate(input) {
     return endOfDay(new Date(now.getTime() + diff * dayMs)).toISOString();
   }
 
+  // Bare weekday names (e.g., "monday", "friday")
+  const bareWeekdayMatch = lowered.match(/^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/);
+  if (bareWeekdayMatch) {
+    const weekdays = {
+      sunday: 0,
+      monday: 1,
+      tuesday: 2,
+      wednesday: 3,
+      thursday: 4,
+      friday: 5,
+      saturday: 6
+    };
+    const target = weekdays[bareWeekdayMatch[1]];
+    const now = new Date();
+    const current = now.getDay();
+    let diff = (target - current + 7) % 7;
+    if (diff === 0) diff = 7;
+    return endOfDay(new Date(now.getTime() + diff * dayMs)).toISOString();
+  }
+
   const inMatch = lowered.match(/^in\s+(\d+)\s*(hour|hours|day|days|week|weeks|month|months)$/);
   if (inMatch) {
     const value = parseInt(inMatch[1], 10);
@@ -654,6 +674,7 @@ async function updateEntry(id, updates) {
   if (updates.priority === null) delete entry.priority;
   if (updates.parent === null) delete entry.parent;
   if (updates.due === null) delete entry.due;
+  if (updates.startedAt === null) delete entry.startedAt;
 
   saveEntries(data);