baton-issue-tracker 1.10.0 → 1.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baton-issue-tracker",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "A CLI issue tracker for AI agents",
   "type": "module",
   "bin": {

package/source/cli.js

@@ -29,6 +29,7 @@ import { run as runDelete } from './commands/delete.js';
 import { run as runPriority } from './commands/priority.js';
 import { run as runLog } from './commands/log.js';
 import { run as runRegister } from './commands/register.js';
+import { run as runAgents } from './commands/agents.js';
 import { run as runSubmit } from './commands/submit.js';
 
 import { authenticateContext } from './services/authService.js';
@@ -41,6 +42,7 @@ Usage:
 Commands:
   init     Initialize storage and seed issues from product specs
   register Register a new AI agent or human user
+  agents   List all registered agents and humans
   next     Work on the highest-priority open issue
   loop     Run the agent autonomously for multiple steps
   status   Show issue counts and overall progress
@@ -63,6 +65,7 @@ Options:
   Default specs: docs/specs/project-requirements.md
   register --name <name>          Name of the agent or user
   register --type <type>          agent | human (default: agent)
+  agents [--json]
   loop --steps <n>                Number of autonomous steps (alias: -n)
   loop -n <n>
   loop --json                     Output as JSON (for AI agents)
@@ -99,6 +102,7 @@ Examples:
   baton init ./my-specs.md
   baton init --force
   baton register --name claude-dev --type agent
+  baton agents
   baton next
   baton loop --steps 5
   baton status
@@ -137,6 +141,7 @@ async function main() {
   const handlers = {
     init: () => runInit(args),
     register: () => runRegister(args),
+    agents: () => runAgents(args),
     next: () => runNext(args),
     loop: () => runLoop(args),
     status: () => runStatus(args),

package/source/commands/agents.js

@@ -0,0 +1,78 @@
+// agents.js
+// Lists all registered agents and humans in the tracker.
+// Usage: baton agents [--json]
+//
+// Options:
+//   --json                 Output as JSON (for AI agents)
+//   -h, --help             Show this help
+//
+// Examples:
+//   baton agents
+
+import { listAgents } from '../services/agentsService.js';
+import { hasFlag, renderOutput } from '../util.js';
+
+const VALID_FLAGS = ['--json'];
+
+const COL = { id: 4, name: 14, type: 5 };
+
+/**
+ * @param {Agent} agent
+ * @returns {{ id: number, name: string, type: string }}
+ */
+function serializeAgent(agent) {
+  return {
+    id: agent.id,
+    name: agent.name,
+    type: agent.type,
+  };
+}
+
+/**
+ * @param {Agent[]} agents
+ */
+function printAgentsTable(agents) {
+  console.log(
+    `${'ID'.padEnd(COL.id)} | ${'Name'.padEnd(COL.name)} | Type`,
+  );
+  for (const agent of agents) {
+    console.log(
+      `${String(agent.id).padEnd(COL.id)} | ${agent.name.padEnd(COL.name)} | ${agent.type}`,
+    );
+  }
+}
+
+/**
+ * Lists all registered agents and humans.
+ * @param {string[]} args - The command line arguments
+ * @returns {Promise<number>} The exit code: 0 is success, 1 is error
+ */
+export async function run(args = []) {
+  const isJson = hasFlag(args, '--json');
+
+  for (const arg of args) {
+    if (arg.startsWith('--') && !VALID_FLAGS.includes(arg)) {
+      throw new Error(`Unknown flag provided: ${arg}.\nFlags: --json`);
+    }
+  }
+
+  try {
+    const agents = listAgents();
+    const records = agents.map(serializeAgent);
+    const envelope = { status: 'success', count: records.length, agents: records };
+
+    renderOutput(isJson, envelope, (data) => {
+      if (data.count === 0) {
+        console.log('No registered agents or humans found.');
+        return;
+      }
+      printAgentsTable(agents);
+    });
+
+    return 0;
+  } catch (error) {
+    console.error('Error: Failed to list agents.');
+    console.error(error.message);
+    return 1;
+  }
+}

package/source/services/agentsService.js

@@ -39,4 +39,14 @@ export function getAgentByName(name) {
   } else {
     return null;
   }
+}
+
+/**
+ * Lists all registered agents and humans, ordered by id.
+ * @returns {Agent[]}
+ */
+export function listAgents() {
+  const db = getDB();
+  const rows = db.select().from(agentsTable).orderBy(agentsTable.id).all();
+  return rows.map((row) => new Agent(row));
 }