@vibedx/vibekit 0.8.3 → 0.8.6

package/README.md

@@ -20,7 +20,7 @@
 
 **A CLI tool to help you vibe your code better** ✨  
 *Vibe your development workflow*  
-_vibekit uses vibekit to develop vibekit - we vibin!_ 🔄
+_vibekit uses vibekit to develop vibekit._ 🔄
 
 </div>
 

package/index.js

@@ -24,7 +24,7 @@ const __dirname = dirname(__filename);
 const AVAILABLE_COMMANDS = [
   'init', 'new', 'close', 'list', 'get-started',
   'start', 'link', 'unlink', 'refine', 'lint', 'review', 'team', 'skills',
-  'status', 'pr'
+  'status', 'stats', 'pr'
 ];
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibedx/vibekit",
-  "version": "0.8.3",
+  "version": "0.8.6",
   "description": "A powerful CLI tool for managing development tickets and project workflows",
   "main": "index.js",
   "type": "module",

package/skills/vibekit/SKILL.md

@@ -86,8 +86,12 @@ vibe new "Add dark mode" --assignee bob --author alice -n
 - `--status open|in_progress|review|done` (default: open)
 - `--assignee <username>` — who works on it
 - `--author <username>` — who created it
+- `-d` / `--description "text"` — pre-fill the Description section
+- `--acceptance-criteria "- [ ] criterion 1\n- [ ] criterion 2"` — pre-fill Acceptance Criteria
 - `-n` / `--no-interactive` — skip AI enhancement prompt
 
+**AI agents should always provide `--description` and `--acceptance-criteria` when creating tickets.** This ensures tickets are actionable immediately without needing `vibe refine`. Fill in as much detail as possible based on the task context.
+
 ## Ticket Structure
 
 Tickets live in `.vibe/tickets/` as markdown files with YAML frontmatter:

package/src/commands/new/index.js

@@ -34,6 +34,8 @@ function parseArguments(args) {
   let status = DEFAULT_STATUS;
   let assignee = '';
   let author = '';
+  let description = '';
+  let acceptanceCriteria = '';
   let noInteractive = false;
 
   for (let i = 0; i < args.length; i++) {
@@ -51,6 +53,12 @@ function parseArguments(args) {
     } else if (arg === '--author' && i + 1 < args.length) {
       author = args[i + 1];
       i++;
+    } else if ((arg === '--description' || arg === '-d') && i + 1 < args.length) {
+      description = args[i + 1];
+      i++;
+    } else if (arg === '--acceptance-criteria' && i + 1 < args.length) {
+      acceptanceCriteria = args[i + 1];
+      i++;
     } else if (arg === '--no-interactive' || arg === '-n') {
       noInteractive = true;
     } else if (!arg.startsWith('--')) {
@@ -64,7 +72,7 @@ function parseArguments(args) {
     throw new Error('Please provide a title for the new ticket.');
   }
 
-  return { title, priority, status, assignee, author, noInteractive };
+  return { title, priority, status, assignee, author, description, acceptanceCriteria, noInteractive };
 }
 
 /**
@@ -103,11 +111,11 @@ function createTicketContent(template, ticketData) {
   if (typeof template !== 'string') {
     throw new Error('Template must be a string');
   }
-  
-  const { ticketId, title, slug, priority, status, assignee, author, timestamp } = ticketData;
+
+  const { ticketId, title, slug, priority, status, assignee, author, description, acceptanceCriteria, timestamp } = ticketData;
   const paddedId = ticketId.replace('TKT-', '');
 
-  return template
+  let content = template
     .replace(/{id}/g, paddedId)
     .replace(/{title}/g, title)
     .replace(/{slug}/g, slug)
@@ -116,6 +124,22 @@ function createTicketContent(template, ticketData) {
     .replace(/^status: .*$/m, `status: ${status}`)
     .replace(/^assignee: .*$/m, `assignee: "${assignee || ''}"`)
     .replace(/^author: .*$/m, `author: "${author || ''}"`);
+
+  if (description) {
+    content = content.replace(
+      /## Description\n\n<!-- .+? -->/s,
+      `## Description\n\n${description}`
+    );
+  }
+
+  if (acceptanceCriteria) {
+    content = content.replace(
+      /## Acceptance Criteria\n\n<!-- .+? -->/s,
+      `## Acceptance Criteria\n\n${acceptanceCriteria}`
+    );
+  }
+
+  return content;
 }
 
 /**
@@ -206,7 +230,7 @@ async function handleFileRename(originalPath, ticketDir) {
 async function newCommand(args) {
   try {
     // Parse and validate arguments
-    const { title, priority, status, assignee, author, noInteractive } = parseArguments(args);
+    const { title, priority, status, assignee, author, description, acceptanceCriteria, noInteractive } = parseArguments(args);
     
     // Check required files and paths
     const configPath = path.join(process.cwd(), '.vibe', 'config.yml');
@@ -251,6 +275,8 @@ async function newCommand(args) {
       status: validatedOptions.status,
       assignee,
       author,
+      description,
+      acceptanceCriteria,
       timestamp
     };
     

package/src/commands/start/index.js

@@ -116,10 +116,14 @@ function updateTicketStatus(ticket, worktreePath) {
   const now = new Date().toISOString();
   let updatedContent = ticket.content;
 
-  if (updatedContent.match(/^worktree_path: .+$/m)) {
-    updatedContent = updatedContent.replace(/^worktree_path: .+$/m, `worktree_path: "${worktreePath}"`);
+  if (worktreePath) {
+    if (updatedContent.match(/^worktree_path: .+$/m)) {
+      updatedContent = updatedContent.replace(/^worktree_path: .+$/m, `worktree_path: "${worktreePath}"`);
+    } else {
+      updatedContent = updatedContent.replace(/^(updated_at: .+)$/m, `$1\nworktree_path: "${worktreePath}"`);
+    }
   } else {
-    updatedContent = updatedContent.replace(/^(updated_at: .+)$/m, `$1\nworktree_path: "${worktreePath}"`);
+    updatedContent = updatedContent.replace(/^worktree_path: .+\n?/m, '');
   }
 
   updatedContent = updatedContent

package/src/commands/stats/index.js

@@ -0,0 +1,117 @@
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+import { getTicketsDir } from '../../utils/index.js';
+
+function parseTickets(ticketsDir) {
+  if (!fs.existsSync(ticketsDir)) {
+    return [];
+  }
+
+  const files = fs.readdirSync(ticketsDir).filter(f => f.endsWith('.md'));
+  const tickets = [];
+
+  for (const file of files) {
+    try {
+      const content = fs.readFileSync(path.join(ticketsDir, file), 'utf-8');
+      const match = content.match(/^---\n([\s\S]*?)\n---/);
+      if (match) {
+        const fm = yaml.load(match[1]);
+        tickets.push({
+          id: fm.id || 'Unknown',
+          title: fm.title || 'Untitled',
+          status: fm.status || 'open',
+          priority: fm.priority || 'medium',
+          assignee: fm.assignee || fm.owner || '',
+          created_at: fm.created_at || null,
+        });
+      }
+    } catch {
+      // skip unparseable tickets
+    }
+  }
+
+  return tickets;
+}
+
+function bar(count, max, width = 20) {
+  if (max === 0) return '';
+  const filled = Math.round((count / max) * width);
+  return '█'.repeat(filled) + '░'.repeat(width - filled);
+}
+
+function statsCommand(args) {
+  const ticketsDir = getTicketsDir();
+  const tickets = parseTickets(ticketsDir);
+
+  if (tickets.length === 0) {
+    console.log('📭 No tickets found. Create one with: vibe new "title"');
+    return;
+  }
+
+  const byStatus = {};
+  const byPriority = {};
+  const byAssignee = {};
+
+  for (const t of tickets) {
+    byStatus[t.status] = (byStatus[t.status] || 0) + 1;
+    byPriority[t.priority] = (byPriority[t.priority] || 0) + 1;
+    if (t.assignee) {
+      byAssignee[t.assignee] = (byAssignee[t.assignee] || 0) + 1;
+    }
+  }
+
+  const total = tickets.length;
+  const done = byStatus['done'] || 0;
+  const inProgress = byStatus['in_progress'] || 0;
+  const open = byStatus['open'] || 0;
+
+  console.log('\n📊 VibeKit Stats\n');
+  console.log(`  Total tickets: ${total}`);
+  console.log(`  Completion:    ${done}/${total} (${total > 0 ? Math.round((done / total) * 100) : 0}%)\n`);
+
+  // Status breakdown
+  console.log('  Status');
+  const statusOrder = ['open', 'in_progress', 'review', 'done'];
+  const statusLabels = { open: '🔵 open', in_progress: '🟡 in_progress', review: '🔵 review', done: '🟢 done' };
+  const allStatuses = [...new Set([...statusOrder, ...Object.keys(byStatus)])];
+  const maxStatusCount = Math.max(...Object.values(byStatus));
+
+  for (const s of allStatuses) {
+    const count = byStatus[s] || 0;
+    if (count === 0) continue;
+    const label = statusLabels[s] || `⚪ ${s}`;
+    console.log(`    ${label.padEnd(18)} ${bar(count, maxStatusCount, 15)} ${count}`);
+  }
+
+  // Priority breakdown
+  if (Object.keys(byPriority).length > 0) {
+    console.log('\n  Priority');
+    const priorityOrder = ['critical', 'high', 'medium', 'low'];
+    const priorityLabels = { critical: '🔴 critical', high: '🟠 high', medium: '🟡 medium', low: '🟢 low' };
+    const allPriorities = [...new Set([...priorityOrder, ...Object.keys(byPriority)])];
+    const maxPriorityCount = Math.max(...Object.values(byPriority));
+
+    for (const p of allPriorities) {
+      const count = byPriority[p] || 0;
+      if (count === 0) continue;
+      const label = priorityLabels[p] || `⚪ ${p}`;
+      console.log(`    ${label.padEnd(18)} ${bar(count, maxPriorityCount, 15)} ${count}`);
+    }
+  }
+
+  // Assignee breakdown
+  if (Object.keys(byAssignee).length > 0) {
+    console.log('\n  Assignees');
+    const maxAssigneeCount = Math.max(...Object.values(byAssignee));
+    const sorted = Object.entries(byAssignee).sort((a, b) => b[1] - a[1]);
+
+    for (const [name, count] of sorted) {
+      console.log(`    ${name.padEnd(18)} ${bar(count, maxAssigneeCount, 15)} ${count}`);
+    }
+  }
+
+  console.log('');
+}
+
+export default statsCommand;

package/src/commands/stats/index.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
+import {
+  createTempDir,
+  cleanupTempDir,
+  mockConsole,
+  mockProcessCwd,
+  createMockVibeProject
+} from '../../utils/test-helpers.js';
+import statsCommand from './index.js';
+
+describe('stats command', () => {
+  let tempDir;
+  let consoleMock;
+  let restoreCwd;
+
+  beforeEach(() => {
+    tempDir = createTempDir('stats-test');
+    consoleMock = mockConsole();
+    restoreCwd = mockProcessCwd(tempDir);
+  });
+
+  afterEach(() => {
+    consoleMock.restore();
+    restoreCwd();
+    cleanupTempDir(tempDir);
+  });
+
+  it('should show empty message when no tickets exist', () => {
+    createMockVibeProject(tempDir);
+
+    statsCommand([]);
+
+    expect(consoleMock.logs.log.some(l => l.includes('No tickets found'))).toBe(true);
+  });
+
+  it('should show total count and completion percentage', () => {
+    createMockVibeProject(tempDir, {
+      withTickets: [
+        { id: 'TKT-001', title: 'Open task', status: 'open', priority: 'high', slug: 'open-task' },
+        { id: 'TKT-002', title: 'Done task', status: 'done', priority: 'medium', slug: 'done-task' },
+        { id: 'TKT-003', title: 'WIP task', status: 'in_progress', priority: 'low', slug: 'wip-task' },
+      ]
+    });
+
+    statsCommand([]);
+
+    const output = consoleMock.logs.log.join('\n');
+    expect(output).toContain('Total tickets: 3');
+    expect(output).toContain('1/3');
+    expect(output).toContain('33%');
+  });
+
+  it('should show status breakdown', () => {
+    createMockVibeProject(tempDir, {
+      withTickets: [
+        { id: 'TKT-001', title: 'A', status: 'open', priority: 'medium', slug: 'a' },
+        { id: 'TKT-002', title: 'B', status: 'open', priority: 'medium', slug: 'b' },
+        { id: 'TKT-003', title: 'C', status: 'done', priority: 'high', slug: 'c' },
+      ]
+    });
+
+    statsCommand([]);
+
+    const output = consoleMock.logs.log.join('\n');
+    expect(output).toContain('Status');
+    expect(output).toContain('open');
+    expect(output).toContain('done');
+  });
+
+  it('should show priority breakdown', () => {
+    createMockVibeProject(tempDir, {
+      withTickets: [
+        { id: 'TKT-001', title: 'A', status: 'open', priority: 'critical', slug: 'a' },
+        { id: 'TKT-002', title: 'B', status: 'open', priority: 'low', slug: 'b' },
+      ]
+    });
+
+    statsCommand([]);
+
+    const output = consoleMock.logs.log.join('\n');
+    expect(output).toContain('Priority');
+    expect(output).toContain('critical');
+    expect(output).toContain('low');
+  });
+
+  it('should show assignee breakdown when tickets have assignees', () => {
+    createMockVibeProject(tempDir, {
+      withTickets: [
+        { id: 'TKT-001', title: 'A', status: 'open', priority: 'medium', slug: 'a', assignee: 'alice' },
+        { id: 'TKT-002', title: 'B', status: 'open', priority: 'medium', slug: 'b', assignee: 'alice' },
+        { id: 'TKT-003', title: 'C', status: 'done', priority: 'medium', slug: 'c', assignee: 'bob' },
+      ]
+    });
+
+    statsCommand([]);
+
+    const output = consoleMock.logs.log.join('\n');
+    expect(output).toContain('Assignees');
+    expect(output).toContain('alice');
+    expect(output).toContain('bob');
+  });
+
+  it('should handle tickets with no assignees gracefully', () => {
+    createMockVibeProject(tempDir, {
+      withTickets: [
+        { id: 'TKT-001', title: 'A', status: 'open', priority: 'medium', slug: 'a' },
+      ]
+    });
+
+    statsCommand([]);
+
+    const output = consoleMock.logs.log.join('\n');
+    expect(output).not.toContain('Assignees');
+  });
+});

package/src/utils/test-helpers.js

@@ -219,6 +219,7 @@ Always use \`vibe start\` to start working on this ticket and \`vibe close\` to
     if (ticket.slug !== undefined) frontmatterLines.push(`slug: ${ticket.slug}`);
     if (ticket.status !== undefined) frontmatterLines.push(`status: ${ticket.status}`);
     if (ticket.priority !== undefined) frontmatterLines.push(`priority: ${ticket.priority}`);
+    if (ticket.assignee !== undefined) frontmatterLines.push(`assignee: ${ticket.assignee}`);
     if (ticket.created_at !== undefined) frontmatterLines.push(`created_at: ${ticket.created_at}`);
     if (ticket.updated_at !== undefined) frontmatterLines.push(`updated_at: ${ticket.updated_at}`);