@vibedx/vibekit 0.4.0 → 0.6.0

package/README.md

@@ -41,6 +41,16 @@ vibe new "Add user authentication"
 vibe start TKT-001
 ```
 
+### 🤖 Use with AI Agents (skills.sh)
+
+Install the vibekit skill so AI coding agents (Claude Code, Cursor, Codex, etc.) know how to use it:
+
+```bash
+npx skills add vibedx/vibekit
+```
+
+The skill teaches agents the ticket-driven workflow — they'll create focused tickets before writing code, track work through git branches, and keep tickets as living documentation.
+
 ## 🤔 Why VibeKit?
 
 - **🎯 Vibe code with manageable smaller tasks** - Break down complex features into focused tickets
@@ -84,11 +94,13 @@ vibe get-started
 ```bash
 # Create a new ticket
 vibe new "Fix login bug"
-vibe new "Add dark mode" --priority high --status open
+vibe new "Add dark mode" --priority high --assignee opusaku
+vibe new "Quick task" --assignee mani-yadv -n   # -n skips AI prompt
 
 # List all tickets (with optional filtering)
 vibe list
 vibe list --status=open
+vibe list --assignee=opusaku
 
 # Close/complete a ticket
 vibe close TKT-001
@@ -98,6 +110,22 @@ vibe start TKT-001
 vibe start TKT-001 --base main --update-status
 ```
 
+### 👥 Team Management
+```bash
+# List team members
+vibe team
+
+# Add a member (stored in .vibe/team.yml)
+vibe team add mani-yadv --name "Mani" --github mani-yadv --slack U0ABC123 --x vernon1943 --role Founder
+vibe team add opusaku --name "Opus" --github opusaku --slack U0DEF456 --role "Senior Engineer"
+
+# Show a member's details
+vibe team show mani-yadv
+
+# Remove a member
+vibe team remove old-member
+```
+
 ### 🤖 AI Integration
 ```bash
 # Connect Claude Code for ticket enhancement
@@ -281,6 +309,7 @@ VibeKit creates a `.vibe` directory in your project root:
 ```
 📁 .vibe/
   ├── 📋 config.yml           # Main configuration
+  ├── 👥 team.yml             # Team members (GitHub, Slack, X handles)
   ├── 📁 .templates/          # Ticket templates
   │   └── 📄 default.md       # Default ticket template
   ├── 📁 tickets/             # Your ticket files
@@ -316,10 +345,13 @@ tickets:
     - high
     - critical
 
+# Team (stored in separate file for large teams)
+team:
+  path: .vibe/team.yml
+
 # AI integration
 ai:
   enabled: true
-  provider: claude-code
 
 # Git integration
 git:

package/assets/config.yml

@@ -21,9 +21,11 @@ tickets:
     - high
     - critical
 
+team:
+  path: .vibe/team.yml
+
 ai:
   enabled: false
-  provider: "none"
 
 hooks:
   pre_commit: false

package/assets/team.yml

@@ -0,0 +1,22 @@
+# VibeKit Team Configuration
+# Add team members here. Use their ID as the assignee value in tickets.
+#
+# Usage:
+#   vibe team                              - List all members
+#   vibe team add <id> --name "Name" ...   - Add a member
+#   vibe team remove <id>                  - Remove a member
+#   vibe new "task" --assignee <id>        - Assign ticket to member
+
+members: {}
+  # Example:
+  # mani-yadv:
+  #   name: Mani
+  #   github: mani-yadv
+  #   slack: U0XXXXXXXX
+  #   x: vernon1943
+  #   role: Founder
+  # opusaku:
+  #   name: Opus
+  #   github: opusaku
+  #   slack: U0XXXXXXXX
+  #   role: Senior Engineer

package/index.js

@@ -22,8 +22,8 @@ const __dirname = dirname(__filename);
 
 // Available commands in VibeKit
 const AVAILABLE_COMMANDS = [
-  'init', 'new', 'close', 'list', 'get-started', 
-  'start', 'link', 'unlink', 'refine', 'lint', 'review'
+  'init', 'new', 'close', 'list', 'get-started',
+  'start', 'link', 'unlink', 'refine', 'lint', 'review', 'team'
 ];
 
 /**

package/package.json

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

package/src/commands/init/index.js

@@ -23,7 +23,8 @@ function initCommand(args) {
   // Use real files instead of hardcoded template strings
   const templateSrc = path.join(__dirname, "../../../assets", "default.md");
   const configSrc = path.join(__dirname, "../../../assets", "config.yml");
-  
+  const teamSrc = path.join(__dirname, "../../../assets", "team.yml");
+
   fs.mkdirSync(targetFolder, { recursive: true });
   fs.mkdirSync(path.join(targetFolder, "tickets"), { recursive: true });
   fs.mkdirSync(path.join(targetFolder, ".templates"), { recursive: true });
@@ -31,6 +32,7 @@ function initCommand(args) {
   // Copy files from assets directory instead of using hardcoded templates
   fs.copyFileSync(configSrc, path.join(targetFolder, "config.yml"));
   fs.copyFileSync(templateSrc, path.join(targetFolder, ".templates", "default.md"));
+  fs.copyFileSync(teamSrc, path.join(targetFolder, "team.yml"));
 
   console.log(`✅ '${targetFolder}' initialized with config, tickets/, and .templates/default.md`);
   

package/src/commands/link/index.js

@@ -162,7 +162,6 @@ async function linkCommand() {
   config.ai = {
     ...config.ai,
     enabled: true,
-    provider: 'claude-code',
   };
 
   if (!saveConfig(config)) {

package/src/commands/lint/index.js

@@ -87,7 +87,12 @@ function getRequiredFrontmatter(config) {
     }
     
     const frontmatter = yaml.load(parts[1]);
-    return Object.keys(frontmatter || {});
+    // Only require fields that have non-empty default values in the template
+    // Fields like assignee: "" and author: "" are optional
+    return Object.keys(frontmatter || {}).filter(key => {
+      const val = frontmatter[key];
+      return val !== '' && val !== null && val !== undefined;
+    });
   } catch (error) {
     // Fallback to default required fields
     return ['id', 'title', 'slug', 'status', 'priority', 'created_at', 'updated_at'];

package/src/commands/new/index.js

@@ -16,7 +16,7 @@ const GIT_STATUS_CHECK_TIMEOUT = 5000;
  * @returns {boolean} True if AI is enabled
  */
 function checkAiEnabled(config) {
-  return config && config.ai && config.ai.enabled && config.ai.provider !== 'none';
+  return config && config.ai && config.ai.enabled;
 }
 
 /**

package/src/commands/refine/index.js

@@ -39,7 +39,7 @@ function loadConfig() {
 function checkAiConfiguration() {
   const config = loadConfig();
 
-  if (!config.ai?.enabled || config.ai?.provider === 'none') {
+  if (!config.ai?.enabled) {
     return {
       configured: false,
       reason: 'AI is not enabled. Run "vibe link" first.'

package/src/commands/team/index.js

@@ -0,0 +1,196 @@
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+import { getConfig } from '../../utils/index.js';
+
+/**
+ * Get path to team.yml (from config or default)
+ */
+function getTeamPath() {
+  const config = getConfig();
+  const teamPath = config.team?.path || '.vibe/team.yml';
+  return path.resolve(process.cwd(), teamPath);
+}
+
+/**
+ * Load team data from team.yml
+ */
+function loadTeam() {
+  const teamPath = getTeamPath();
+  try {
+    if (fs.existsSync(teamPath)) {
+      const content = fs.readFileSync(teamPath, 'utf-8');
+      const data = yaml.load(content) || {};
+      return data.members || {};
+    }
+  } catch (error) {
+    console.error(`❌ Error reading team file: ${error.message}`);
+  }
+  return {};
+}
+
+/**
+ * Save team data to team.yml
+ */
+function saveTeam(members) {
+  const teamPath = getTeamPath();
+  const dir = path.dirname(teamPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  const content = yaml.dump({ members }, { lineWidth: -1 });
+  fs.writeFileSync(teamPath, content, 'utf-8');
+}
+
+/**
+ * Manage team members
+ * Usage:
+ *   vibe team                           - List all team members
+ *   vibe team add <id> --name "Name" --github <gh> --slack <slack>
+ *   vibe team remove <id>
+ *   vibe team show <id>
+ */
+async function teamCommand(args) {
+  const subcommand = args[0];
+
+  if (!subcommand || subcommand === 'list') {
+    return listTeam();
+  }
+  if (subcommand === 'add') {
+    return addMember(args.slice(1));
+  }
+  if (subcommand === 'remove') {
+    return removeMember(args[1]);
+  }
+  if (subcommand === 'show') {
+    return showMember(args[1]);
+  }
+  return showMember(subcommand);
+}
+
+function listTeam() {
+  const team = loadTeam();
+  const members = Object.entries(team);
+
+  if (members.length === 0) {
+    console.log('\nNo team members configured.\n');
+    console.log('Add members with: vibe team add <id> --name "Name" --github <gh> --slack <slack-id>\n');
+    return;
+  }
+
+  console.log('\n✨ Team Members ✨\n');
+
+  const idWidth = 16;
+  const nameWidth = 16;
+  const githubWidth = 16;
+  const slackWidth = 14;
+
+  console.log(
+    `${'ID'.padEnd(idWidth)}| ${'NAME'.padEnd(nameWidth)}| ${'GITHUB'.padEnd(githubWidth)}| SLACK`
+  );
+  console.log(`${'-'.repeat(idWidth)}+${'-'.repeat(nameWidth + 1)}+${'-'.repeat(githubWidth + 1)}+${'-'.repeat(slackWidth)}`);
+
+  for (const [id, member] of members) {
+    if (typeof member !== 'object') continue;
+    console.log(
+      `${id.padEnd(idWidth)}| ${(member.name || '').padEnd(nameWidth)}| ${(member.github || '').padEnd(githubWidth)}| ${member.slack || ''}`
+    );
+  }
+
+  console.log(`\nFound ${members.length} member(s).\n`);
+}
+
+function addMember(args) {
+  if (!args[0]) {
+    console.error('❌ Please provide a member ID. Usage: vibe team add <id> --name "Name" --github <gh> --slack <slack>');
+    process.exit(1);
+  }
+
+  const id = args[0];
+  const member = {};
+
+  for (let i = 1; i < args.length; i++) {
+    if (args[i] === '--name' && args[i + 1]) {
+      member.name = args[++i];
+    } else if (args[i] === '--github' && args[i + 1]) {
+      member.github = args[++i];
+    } else if (args[i] === '--slack' && args[i + 1]) {
+      member.slack = args[++i];
+    } else if (args[i] === '--x' && args[i + 1]) {
+      member.x = args[++i];
+    } else if (args[i] === '--role' && args[i + 1]) {
+      member.role = args[++i];
+    }
+  }
+
+  const team = loadTeam();
+  team[id] = { ...team[id], ...member };
+  saveTeam(team);
+
+  console.log(`✅ Added team member: ${id}`);
+  if (member.name) console.log(`   Name: ${member.name}`);
+  if (member.github) console.log(`   GitHub: ${member.github}`);
+  if (member.slack) console.log(`   Slack: ${member.slack}`);
+  if (member.x) console.log(`   X: ${member.x}`);
+  if (member.role) console.log(`   Role: ${member.role}`);
+}
+
+function removeMember(id) {
+  if (!id) {
+    console.error('❌ Please provide a member ID. Usage: vibe team remove <id>');
+    process.exit(1);
+  }
+
+  const team = loadTeam();
+  if (!team[id]) {
+    console.error(`❌ Member '${id}' not found.`);
+    process.exit(1);
+  }
+
+  delete team[id];
+  saveTeam(team);
+  console.log(`✅ Removed team member: ${id}`);
+}
+
+function showMember(id) {
+  if (!id) return listTeam();
+
+  const team = loadTeam();
+  const member = team[id];
+
+  if (!member) {
+    console.error(`❌ Member '${id}' not found.`);
+    process.exit(1);
+  }
+
+  console.log(`\n📋 ${id}`);
+  if (member.name) console.log(`   Name: ${member.name}`);
+  if (member.github) console.log(`   GitHub: @${member.github}`);
+  if (member.slack) console.log(`   Slack: <@${member.slack}>`);
+  if (member.x) console.log(`   X: @${member.x}`);
+  if (member.role) console.log(`   Role: ${member.role}`);
+  console.log();
+}
+
+/**
+ * Resolve an assignee ID to their team info.
+ * Exported for use by other commands and external tools.
+ */
+export function resolveAssignee(assigneeId) {
+  const team = loadTeam();
+  return team[assigneeId] || null;
+}
+
+/**
+ * Get Slack mention string for an assignee.
+ * Returns <@SLACK_ID> if found, or the raw assignee string.
+ */
+export function getSlackMention(assigneeId) {
+  const member = resolveAssignee(assigneeId);
+  if (member?.slack) {
+    return `<@${member.slack}>`;
+  }
+  return assigneeId;
+}
+
+export default teamCommand;

package/src/commands/unlink/index.js

@@ -83,8 +83,6 @@ async function unlinkCommand() {
     
     // Show current configuration
     console.log('📝 Current AI configuration:');
-    console.log(`   Provider: ${config.ai.provider === 'claude-code' ? 'Claude Code (Anthropic API)' : config.ai.provider}`);
-    console.log(`   Model: ${config.ai.model || 'Not specified'}`);
     console.log(`   Status: ${config.ai.enabled ? 'Enabled' : 'Disabled'}`);
     console.log();
     
@@ -101,7 +99,6 @@ async function unlinkCommand() {
     config.ai = {
       ...config.ai,
       enabled: false,
-      provider: 'none'
     };
     
     if (saveConfig(config)) {

package/src/utils/test-helpers.js

@@ -111,7 +111,6 @@ export function createMockVibeProject(baseDir, options = {}) {
       },
       ai: {
         enabled: false,
-        provider: 'none'
       }
     };
     
@@ -141,7 +140,6 @@ git:
 
 ai:
   enabled: false
-  provider: none
 `;
     
     fs.writeFileSync(configPath, configContent, 'utf-8');
@@ -460,7 +458,6 @@ git:
 
 ai:
   enabled: false
-  provider: none
 `;
   
   // Create mock default.md template