fishladder 0.1.0 → 0.2.0

package/bin/fish.js

@@ -12,7 +12,7 @@ import { registerHiringCommand } from '../src/commands/hiring.js';
 program
   .name('fish')
   .description('Fishladder CLI — manage projects, tasks, feedback, and hiring')
-  .version('0.1.0');
+  .version('0.2.0');
 
 registerLoginCommand(program);
 registerLogoutCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fishladder",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Fishladder CLI — manage projects, tasks, feedback, and hiring from your terminal",
   "type": "module",
   "bin": {

package/src/commands/feedback.js

@@ -61,6 +61,85 @@ export function registerFeedbackCommand(program) {
 
       console.log(`Feedback created: ${entry.title} (${entry.id.slice(0, 8)})`);
     });
+
+  feedback
+    .command('analyze')
+    .description('Run AI analysis on feedback (supports stdin)')
+    .option('--ids <ids>', 'Comma-separated feedback IDs to analyze')
+    .option('--format <format>', 'Output format: table or json', 'table')
+    .action(async (opts) => {
+      const body = {};
+
+      if (opts.ids) {
+        body.feedbackIds = opts.ids.split(',').map(id => id.trim());
+      }
+
+      // Read from stdin if piped
+      if (!process.stdin.isTTY) {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+          chunks.push(chunk);
+        }
+        const input = Buffer.concat(chunks).toString('utf-8').trim();
+        if (input) {
+          // Try to parse as JSON array of IDs, otherwise treat as raw text
+          try {
+            const parsed = JSON.parse(input);
+            if (Array.isArray(parsed)) {
+              body.feedbackIds = parsed.map(item =>
+                typeof item === 'string' ? item : item.id
+              );
+            } else {
+              body.text = input;
+            }
+          } catch {
+            body.text = input;
+          }
+        }
+      }
+
+      if (!body.feedbackIds && !body.text) {
+        console.error('Provide feedback IDs with --ids or pipe data via stdin.');
+        console.error('Examples:');
+        console.error('  fish feedback analyze --ids abc123,def456');
+        console.error('  fish feedback list --format json | fish feedback analyze');
+        console.error('  echo "Users want dark mode" | fish feedback analyze');
+        process.exit(1);
+      }
+
+      const result = await request('/feedback/analyze', {
+        method: 'POST',
+        body: JSON.stringify(body),
+      });
+
+      if (opts.format === 'json') {
+        formatJson(result);
+        return;
+      }
+
+      if (result.summary) {
+        console.log('\nSummary');
+        console.log('-------');
+        console.log(result.summary);
+      }
+
+      if (result.themes?.length > 0) {
+        console.log('\nThemes');
+        console.log('------');
+        formatTable(
+          ['Theme', 'Count', 'Impact'],
+          result.themes.map(t => [t.name, t.count ?? '-', t.impact ?? '-'])
+        );
+      }
+
+      if (result.recommendations?.length > 0) {
+        console.log('\nRecommendations');
+        console.log('---------------');
+        result.recommendations.forEach((r, i) => {
+          console.log(`${i + 1}. ${r}`);
+        });
+      }
+    });
 }
 
 function truncate(str, len) {

package/src/commands/hiring.js

@@ -98,6 +98,65 @@ export function registerHiringCommand(program) {
         ])
       );
     });
+
+  hiring
+    .command('move <applicationId>')
+    .description('Move an application to a different stage')
+    .requiredOption('--stage <stageId>', 'Target stage ID')
+    .option('--format <format>', 'Output format: table or json', 'table')
+    .action(async (applicationId, opts) => {
+      const result = await request(`/applications/${applicationId}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ stageId: opts.stage }),
+      });
+
+      if (opts.format === 'json') {
+        formatJson(result);
+        return;
+      }
+
+      console.log(`Application ${result.id.slice(0, 8)} moved to stage ${result.stageId?.slice(0, 8) ?? opts.stage}.`);
+    });
+
+  hiring
+    .command('hire <applicationId>')
+    .description('Mark an application as hired')
+    .option('--format <format>', 'Output format: table or json', 'table')
+    .action(async (applicationId, opts) => {
+      const result = await request(`/applications/${applicationId}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ status: 'hired' }),
+      });
+
+      if (opts.format === 'json') {
+        formatJson(result);
+        return;
+      }
+
+      console.log(`Application ${result.id.slice(0, 8)} marked as hired.`);
+    });
+
+  hiring
+    .command('reject <applicationId>')
+    .description('Reject an application')
+    .option('--reason <text>', 'Rejection reason')
+    .option('--format <format>', 'Output format: table or json', 'table')
+    .action(async (applicationId, opts) => {
+      const body = { status: 'rejected' };
+      if (opts.reason) body.rejectionReason = opts.reason;
+
+      const result = await request(`/applications/${applicationId}`, {
+        method: 'PATCH',
+        body: JSON.stringify(body),
+      });
+
+      if (opts.format === 'json') {
+        formatJson(result);
+        return;
+      }
+
+      console.log(`Application ${result.id.slice(0, 8)} rejected.`);
+    });
 }
 
 function truncate(str, len) {

package/src/commands/tasks.js

@@ -1,5 +1,6 @@
 import { request } from '../api.js';
 import { formatTable, formatJson } from '../format.js';
+import { parseSmartSyntax } from '../smart-syntax.js';
 
 export function registerTasksCommand(program) {
   const tasks = program
@@ -42,21 +43,34 @@ export function registerTasksCommand(program) {
 
   tasks
     .command('create <title>')
-    .description('Create a new task')
+    .description('Create a new task (supports smart syntax: @user !priority #tag due:date)')
     .requiredOption('--project <id>', 'Project ID (required)')
     .option('--assign <userId>', 'Assignee user ID')
     .option('--priority <level>', 'Priority: none, low, medium, high, urgent', 'none')
     .option('--due <date>', 'Due date (YYYY-MM-DD)')
     .option('--format <format>', 'Output format: table or json', 'table')
-    .action(async (title, opts) => {
+    .allowUnknownOption(false)
+    .action(async (title, opts, cmd) => {
+      // Parse smart syntax from extra args on the raw command line
+      const extra = cmd.args.filter(a => a !== title);
+      const smart = parseSmartSyntax(extra);
+
       const body = {
         title,
         projectId: opts.project,
       };
 
+      // Smart syntax values are overridden by explicit flags
       if (opts.assign) body.assigneeId = opts.assign;
-      if (opts.priority) body.priority = opts.priority;
+      else if (smart.assignee) body.assigneeId = smart.assignee;
+
+      if (opts.priority && opts.priority !== 'none') body.priority = opts.priority;
+      else if (smart.priority) body.priority = smart.priority;
+
       if (opts.due) body.dueDate = opts.due;
+      else if (smart.due) body.dueDate = smart.due;
+
+      if (smart.tags.length > 0) body.tags = smart.tags;
 
       const task = await request('/tasks', {
         method: 'POST',
@@ -70,6 +84,60 @@ export function registerTasksCommand(program) {
 
       console.log(`Task created: ${task.title} (${task.id.slice(0, 8)})`);
     });
+
+  tasks
+    .command('update <id>')
+    .description('Update an existing task')
+    .option('--title <title>', 'New title')
+    .option('--assign <userId>', 'Reassign to user ID')
+    .option('--priority <level>', 'Priority: none, low, medium, high, urgent')
+    .option('--due <date>', 'Due date (YYYY-MM-DD)')
+    .option('--status <status>', 'Status (e.g. todo, in_progress, done)')
+    .option('--format <format>', 'Output format: table or json', 'table')
+    .action(async (id, opts) => {
+      const body = {};
+
+      if (opts.title) body.title = opts.title;
+      if (opts.assign) body.assigneeId = opts.assign;
+      if (opts.priority) body.priority = opts.priority;
+      if (opts.due) body.dueDate = opts.due;
+      if (opts.status) body.status = opts.status;
+
+      if (Object.keys(body).length === 0) {
+        console.error('No fields to update. Use --title, --assign, --priority, --due, or --status.');
+        process.exit(1);
+      }
+
+      const task = await request(`/tasks/${id}`, {
+        method: 'PATCH',
+        body: JSON.stringify(body),
+      });
+
+      if (opts.format === 'json') {
+        formatJson(task);
+        return;
+      }
+
+      console.log(`Task updated: ${task.title} (${task.id.slice(0, 8)})`);
+    });
+
+  tasks
+    .command('complete <id>')
+    .description('Mark a task as complete')
+    .option('--format <format>', 'Output format: table or json', 'table')
+    .action(async (id, opts) => {
+      const task = await request(`/tasks/${id}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ status: 'done' }),
+      });
+
+      if (opts.format === 'json') {
+        formatJson(task);
+        return;
+      }
+
+      console.log(`Task completed: ${task.title} (${task.id.slice(0, 8)})`);
+    });
 }
 
 function truncate(str, len) {

package/src/smart-syntax.js

@@ -0,0 +1,55 @@
+// Parses smart syntax tokens from variadic args
+// e.g. "Fix bug" @sarah !high #backend due:friday
+// Returns { assignee, priority, tags, due }
+
+const DAY_NAMES = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
+
+function resolveDate(value) {
+  const lower = value.toLowerCase();
+
+  if (/^\d{4}-\d{2}-\d{2}$/.test(lower)) return lower;
+
+  const today = new Date();
+
+  if (lower === 'today') {
+    return fmt(today);
+  }
+
+  if (lower === 'tomorrow') {
+    today.setDate(today.getDate() + 1);
+    return fmt(today);
+  }
+
+  const dayIndex = DAY_NAMES.indexOf(lower);
+  if (dayIndex !== -1) {
+    const current = today.getDay();
+    let diff = dayIndex - current;
+    if (diff <= 0) diff += 7;
+    today.setDate(today.getDate() + diff);
+    return fmt(today);
+  }
+
+  return value; // pass through as-is if not recognized
+}
+
+function fmt(date) {
+  return date.toISOString().split('T')[0];
+}
+
+export function parseSmartSyntax(tokens) {
+  const result = { tags: [] };
+
+  for (const token of tokens) {
+    if (token.startsWith('@')) {
+      result.assignee = token.slice(1);
+    } else if (token.startsWith('!')) {
+      result.priority = token.slice(1).toLowerCase();
+    } else if (token.startsWith('#')) {
+      result.tags.push(token.slice(1));
+    } else if (token.startsWith('due:')) {
+      result.due = resolveDate(token.slice(4));
+    }
+  }
+
+  return result;
+}

package/CLAUDE.md

@@ -1,113 +0,0 @@
-# Fishladder CLI — Project Context for Claude
-
-## What This Is
-
-A CLI tool for the Fishladder app (https://app.ladder.fish). npm package name: `fishladder`, binary: `fish`. Installed via `npm install -g fishladder`.
-
-**Spec document**: The full spec lives in the main Fishladder app repo at `docs/phase-5-cli-tool.md`. This CLI implements Track B of that spec. Track A (the `/cli-auth` backend endpoint) lives in the main app.
-
-**Main app repo**: `github.com/prone/fishladder` — the CLI talks to its `/api/v1/` endpoints.
-
-## Architecture
-
-```
-fishladder-cli/
-  bin/fish.js          — entry point (#!/usr/bin/env node), registers all commands
-  src/
-    auth.js            — login (browser OAuth → local HTTP server → keytar), logout, getToken()
-    api.js             — fetch wrapper with Bearer auth, 401/429 error handling
-    format.js          — table output (cli-table3) + --format json
-    commands/
-      login.js         — fish login (browser OAuth flow)
-      logout.js        — fish logout (remove keychain token)
-      whoami.js        — fish whoami (GET /members)
-      projects.js      — fish projects list (GET /projects)
-      tasks.js         — fish tasks list|create (GET|POST /tasks)
-      feedback.js      — fish feedback list|create (GET|POST /feedback)
-      hiring.js        — fish hiring jobs|candidates|pipeline (GET /jobs, /candidates, /applications)
-```
-
-## Tech Stack
-
-- **Runtime**: Node.js >=18, ESM (`"type": "module"`)
-- **CLI framework**: Commander.js
-- **Secure token storage**: keytar (system keychain — never write tokens to disk)
-- **Output**: chalk (colors), cli-table3 (tables), `--format json` on all list commands
-- **Browser launch**: open (for OAuth login flow)
-- **Tests**: vitest (not yet written)
-
-## Auth Flow
-
-### Browser OAuth (`fish login`)
-1. CLI generates random `state`, finds available port (9876–9885)
-2. Starts local HTTP server on that port
-3. Opens browser to `https://app.ladder.fish/cli-auth?state=<state>&port=<port>`
-4. User authenticates in browser (or is already logged in)
-5. App generates `fl_` prefixed API key, redirects to `http://localhost:<port>/callback?token=<token>&state=<state>`
-6. CLI validates state match, stores token in system keychain via keytar
-
-### Environment variable fallback
-Set `FISHLADDER_API_KEY=fl_<key>` to bypass browser login. Useful for development and CI. The `getToken()` function checks the env var first, then keytar.
-
-### Environment variables
-| Variable | Default | Purpose |
-|----------|---------|---------|
-| `FISHLADDER_API_KEY` | (none) | API key fallback — skips keytar |
-| `FISHLADDER_API_URL` | `https://app.ladder.fish/api/v1` | API base URL |
-| `FISHLADDER_AUTH_URL` | `https://app.ladder.fish` | Auth page base URL |
-
-## API
-
-Base URL: `https://app.ladder.fish/api/v1`
-Auth: `Authorization: Bearer fl_<key>`
-Rate limit: 120 req/hour
-Errors: `{ "error": "message" }`
-
-| CLI Command | HTTP | Endpoint |
-|-------------|------|----------|
-| `fish whoami` | GET | `/members` |
-| `fish projects list` | GET | `/projects` |
-| `fish tasks list` | GET | `/tasks?projectId=<id>` |
-| `fish tasks create` | POST | `/tasks` (requires `projectId`, `title`) |
-| `fish feedback list` | GET | `/feedback` |
-| `fish feedback create` | POST | `/feedback` (requires `title`) |
-| `fish hiring jobs` | GET | `/jobs` |
-| `fish hiring candidates` | GET | `/candidates` |
-| `fish hiring pipeline` | GET | `/applications?jobId=<id>` |
-
-## Running / Developing
-
-```bash
-npm install           # install dependencies
-npm link              # link globally so `fish` binary works
-fish --help           # verify it works
-npm test              # run tests (vitest)
-```
-
-To test against a local dev server:
-```bash
-FISHLADDER_API_URL=http://localhost:3000/api/v1 FISHLADDER_API_KEY=fl_<key> fish projects list
-```
-
-## Conventions
-
-- All files are plain `.js` (ESM, no TypeScript, no build step)
-- Every list command supports `--format json` for piping to `jq`
-- Error handling: 401 → "Run: fish login", 429 → show retry-after, other errors → show error message. Never show stack traces to users.
-- Token security: **never** write tokens to plaintext files. Keytar (system keychain) or env var only.
-- Each command file exports a `registerXCommand(program)` function that adds itself to the Commander program
-
-## v2 Commands (not yet built)
-
-The spec (`docs/phase-5-cli-tool.md` in main repo) defines v2 commands to add after v1 is dogfooded:
-- `fish tasks update/complete`
-- `fish feedback analyze` (AI analysis, stdin support)
-- `fish hiring move/hire/reject`
-- Smart syntax: `fish tasks create "Fix bug" @sarah !high #backend due:friday`
-
-## Status
-
-- **v1 commands**: All built and tested end-to-end against live API
-- **Tests**: vitest configured but no test files written yet
-- **npm publish**: Not yet — dogfood internally first (per spec)
-- **Track A (backend)**: Complete — `/cli-auth` page and `/api/cli-auth` endpoint exist in main app