baton-issue-tracker 1.9.0 → 1.11.0

package/package.json

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

package/source/cli.js

@@ -29,6 +29,8 @@ 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';
 
@@ -40,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
@@ -48,6 +51,7 @@ Commands:
   list     Lists issues filtered by status and priority
   create   Creates an issue with specified fields
   approve  Move an issue from in-review to closed
+  submit   Submit finished work for human review
   priority Set an issue's priority level
   update   Updates an issue's specified fields
   delete   Deletes an issue
@@ -61,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)
@@ -79,6 +84,7 @@ Options:
   create --token-limit <n>        Optional token budget for this issue
   create --json                   Output as JSON (for AI agents)
   approve <id> [--json]
+  submit <id> [--json]
   reject <id> --reason <text>     Reject an issue with a given reason
   priority <id> <level> [--json]  low | medium | high
   update --title <text>           New title
@@ -96,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
@@ -107,6 +114,7 @@ Examples:
   baton create --title "Fix login bug" --priority high
   baton create --title "Refactor auth" --description "Clean up JWT logic" --token-limit 4000
   baton approve 5
+  baton submit 14
   baton priority 5 high
   baton priority 3 low
   baton update 3 --title "Revised title"
@@ -133,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),
@@ -146,6 +155,7 @@ async function main() {
     update: () => runUpdate(args),
     delete: () => runDelete(args),
     log: () => runLog(args),
+    submit: () => runSubmit(args),
   };
 
   const handler = handlers[command];

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/commands/submit.js

@@ -0,0 +1,76 @@
+// submit.js
+// AI was consulted to generate the contents of the file. It was then reviewed and edited by a human.
+// Allows an agent to submit "finished" work for human review.
+// The issue must be in the in-progress status to be submitted for review.
+// Usage: baton submit <id> [--json]
+//
+// Options:
+//   --json                 Output as JSON (for AI agents)
+//
+// Examples:
+//   baton submit 14
+
+import { getIssue, submitForReview } from '../services/issuesService.js';
+import { Status } from '../models/issue.js';
+import {
+  hasFlag,
+  renderOutput,
+  renderError,
+  serializeIssue,
+} from '../util.js';
+
+/**
+ * Submits an in-progress issue for human review.
+ * @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');
+
+  const idArgs = args.filter((arg) => arg !== '--json');
+  if (idArgs.length === 0) {
+    renderError(isJson, 'Missing issue ID.\nUsage: baton submit <id>', 'MISSING_ID');
+    return 1;
+  }
+
+  const id = Number(idArgs[0]);
+  if (!Number.isInteger(id)) {
+    renderError(isJson, `Invalid ID "${idArgs[0]}". ID must be an integer.`, 'INVALID_ID');
+    return 1;
+  }
+
+  let issue;
+  try {
+    issue = getIssue(id);
+  } catch (error) {
+    if (error.message.includes('not found')) {
+      renderError(isJson, error.message, 'NOT_FOUND');
+    } else {
+      renderError(isJson, error.message);
+    }
+    return 1;
+  }
+
+  if (issue.status !== Status.IN_PROGRESS) {
+    renderError(
+      isJson,
+      `Issue #${id} is currently "${issue.status}". Only issues in "${Status.IN_PROGRESS}" can be submitted for review.`,
+      'INVALID_STATE',
+    );
+    return 1;
+  }
+
+  try {
+    const updatedIssue = submitForReview(id);
+    const envelope = { status: 'success', issue: serializeIssue(updatedIssue) };
+
+    renderOutput(isJson, envelope, () => {
+      console.log(`Success: Issue #${id} submitted for review.`);
+    });
+
+    return 0;
+  } catch (error) {
+    renderError(isJson, 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));
 }

package/source/services/issuesService.js

@@ -33,6 +33,14 @@ function logActivity(db, issueId, action, details = null) {
     .run();
 }
 
+/**
+ * Returns the active actor ID set during authentication.
+ * @returns {number|null}
+ */
+export function getActiveActor() {
+  return currentActorId;
+}
+
 /**
  * Convert a raw database row to an Issue instance.
  * @private
@@ -280,16 +288,37 @@ export function rejectIssue(id, reason) {
 }
 
 /**
- * Change the status of an issue to in-review.
- * Logs a state_change_event.
- * @param {number} id
+ * Change the status of an issue from in-progress to in-review.
+ * Logs a state_change event attributed to the current actor.
+ * @param {number} issueId
  * @returns {Issue}
+ * @throws {Error} If issueId is invalid, issue is not found, or status is not in-progress
  */
-export function submitForReview(id) {
+export function submitForReview(issueId) {
+  if (!Number.isInteger(issueId)) {
+    throw new Error('issueId must be an integer');
+  }
+
   const db = getDB();
-  db.update(issuesTable).set({ status: Status.IN_REVIEW }).where(eq(issuesTable.id, id)).run();
-  logActivity(db, id, Action.STATE_CHANGE, `Issue #${id} was submitted for review.`);
-  return getIssue(id);
+  const existing = findById(db, issueId);
+
+  if (existing.status !== Status.IN_PROGRESS) {
+    throw new Error(
+      `Issue #${issueId} is currently "${existing.status}". Only issues in "${Status.IN_PROGRESS}" can be submitted for review.`,
+    );
+  }
+
+  db.update(issuesTable)
+    .set({ status: Status.IN_REVIEW })
+    .where(eq(issuesTable.id, issueId))
+    .run();
+  logActivity(
+    db,
+    issueId,
+    Action.STATE_CHANGE,
+    `Issue #${issueId} was submitted for review.`,
+  );
+  return getIssue(issueId);
 }
 
 /**