baton-issue-tracker 1.5.0 → 1.7.0

package/drizzle/0002_breezy_wiccan.sql

@@ -0,0 +1,10 @@
+CREATE TABLE `agents` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`name` text NOT NULL,
+	`type` text NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `agents_name_unique` ON `agents` (`name`);--> statement-breakpoint
+ALTER TABLE `activity` ADD `actor_id` integer REFERENCES agents(id);--> statement-breakpoint
+ALTER TABLE `issues` ADD `assignee_id` integer REFERENCES agents(id);--> statement-breakpoint
+ALTER TABLE `issues` DROP COLUMN `assignees`;

package/drizzle/meta/0002_snapshot.json

@@ -0,0 +1,229 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "d89cefa6-9c90-4882-8fab-f6322fd1f45e",
+  "prevId": "af5467aa-0757-4c91-8afb-c6f0202dd90c",
+  "tables": {
+    "activity": {
+      "name": "activity",
+      "columns": {
+        "log_id": {
+          "name": "log_id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "issue_id": {
+          "name": "issue_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "actor_id": {
+          "name": "actor_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "CURRENT_TIMESTAMP"
+        },
+        "action": {
+          "name": "action",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "details": {
+          "name": "details",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "activity_actor_id_agents_id_fk": {
+          "name": "activity_actor_id_agents_id_fk",
+          "tableFrom": "activity",
+          "tableTo": "agents",
+          "columnsFrom": [
+            "actor_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {
+        "activity_action_check": {
+          "name": "activity_action_check",
+          "value": "\"activity\".\"action\" IN ('state_change', 'priority_change', 'edit', 'read', 'creation', 'deletion', 'rejection')"
+        }
+      }
+    },
+    "agents": {
+      "name": "agents",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "type": {
+          "name": "type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "agents_name_unique": {
+          "name": "agents_name_unique",
+          "columns": [
+            "name"
+          ],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "issues": {
+      "name": "issues",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "CURRENT_TIMESTAMP"
+        },
+        "last_updated": {
+          "name": "last_updated",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "CURRENT_TIMESTAMP"
+        },
+        "attempt_num": {
+          "name": "attempt_num",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'PENDING'"
+        },
+        "status": {
+          "name": "status",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'Open'"
+        },
+        "priority": {
+          "name": "priority",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'Low'"
+        },
+        "token_limit": {
+          "name": "token_limit",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "assignee_id": {
+          "name": "assignee_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "issues_assignee_id_agents_id_fk": {
+          "name": "issues_assignee_id_agents_id_fk",
+          "tableFrom": "issues",
+          "tableTo": "agents",
+          "columnsFrom": [
+            "assignee_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/drizzle/meta/_journal.json

@@ -15,6 +15,13 @@
       "when": 1780114722528,
       "tag": "0001_salty_luke_cage",
       "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "6",
+      "when": 1780293597234,
+      "tag": "0002_breezy_wiccan",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baton-issue-tracker",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "A CLI issue tracker for AI agents",
   "type": "module",
   "bin": {
@@ -37,6 +37,7 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
+    "@inquirer/prompts": "^8.5.1",
     "better-sqlite3": "^12.10.0",
     "drizzle-orm": "^0.45.2"
   }

package/source/cli.js

@@ -23,7 +23,12 @@ import { run as runView} from './commands/view.js';
 import { run as runSearch } from './commands/search.js';
 import { run as runList } from './commands/list.js';
 import { run as runCreate } from './commands/create.js'
-import { run as runUpdate } from './commands/update.js'
+import { run as runUpdate } from './commands/update.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 { authenticateContext } from './services/authService.js';
 
 const HELP = `baton — AI agent issue tracker CLI
 
@@ -32,6 +37,7 @@ Usage:
 
 Commands:
   init     Initialize storage and seed issues from product specs
+  register Register a new AI agent or human user
   next     Work on the highest-priority open issue
   loop     Run the agent autonomously for multiple steps
   status   Show issue counts and overall progress
@@ -40,7 +46,9 @@ 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
-  update   Updates an issue's specified fields 
+  priority Set an issue's priority level
+  update   Updates an issue's specified fields
+  log      Show activity history for an issue
 
 Options:
   init --force                    Re-initialize an existing tracker database
@@ -48,6 +56,8 @@ Options:
   init --json                     Output as JSON (for AI agents)
   init <path>                     Same as --specs <path> (positional)
   Default specs: docs/specs/project-requirements.md
+  register --name <name>          Name of the agent or user
+  register --type <type>          agent | human (default: agent)
   loop --steps <n>                Number of autonomous steps (alias: -n)
   loop -n <n>
   loop --json                     Output as JSON (for AI agents)
@@ -66,19 +76,21 @@ Options:
   create --token-limit <n>        Optional token budget for this issue
   create --json                   Output as JSON (for AI agents)
   approve <id> [--json]
+  priority <id> <level> [--json]  low | medium | high
   update --title <text>           New title
   update --description <text>     New description
   update --token-limit <n>        New token budget
   update --status <s>             open | in-progress | closed
   update --priority <level>       low | medium | high
   update --json                   Output as JSON (for AI agents)
- 
+  log <id> [--json]
 
 Examples:
   baton init
   baton init --specs ./my-specs.md
   baton init ./my-specs.md
   baton init --force
+  baton register --name claude-dev --type agent
   baton next
   baton loop --steps 5
   baton status
@@ -90,8 +102,11 @@ 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 priority 5 high
+  baton priority 3 low
   baton update 3 --title "Revised title"
   baton update 7 --status closed --priority medium
+  baton log 5
 `;
 
 /**
@@ -107,8 +122,12 @@ async function main() {
     return;
   }
 
+  // Authenticate the user and context before executing any command.
+  authenticateContext(command);
+
   const handlers = {
     init: () => runInit(args),
+    register: () => runRegister(args),
     next: () => runNext(args),
     loop: () => runLoop(args),
     status: () => runStatus(args),
@@ -116,12 +135,19 @@ async function main() {
     search: () => runSearch(args),
     list: () => runList(args),
     approve: () => runApprove(args),
+    priority: () => runPriority(args),
     create: () => runCreate(args),
-    update: () => runUpdate(args)
+    update: () => runUpdate(args),
+    log: () => runLog(args),
   };
-  
+
   const handler = handlers[command];
   if (!handler) {
+    if (wantsHelp(args)) {
+      console.log(HELP);
+      process.exit(0);
+      return;
+    }
     console.error(`Error: Unknown command "${command}".`);
     console.error('Run `baton --help` for usage.');
     process.exit(1);

package/source/commands/create.js

@@ -1,52 +1,237 @@
 // create.js
 // AI was consulted for some portions of this file.
-// create command allows the user to create an issue 
+// create command allows the user to create an issue
 // Usage: baton create --title <text> --description <text> --priority <level> --token-limit <n>
-// 
+//        baton create                  (launches interactive prompt mode)
+//
 // Examples:
-// baton create --title "Fix login bug" --priority high
-//  baton create --title "Refactor auth" --description "Clean up JWT logic" --token-limit 4000
+//   baton create --title "Fix login bug" --priority high
+//   baton create --title "Refactor auth" --description "Clean up JWT logic" --token-limit 4000
+//   baton create                         # interactive mode
+//
 // Options:
-//  --title <text>         Issue title (defaults to "Issue #<id>" if omitted)
-//  --description <text>   Issue description
-//  --priority <level>     low | medium | high  (default: low)
-//  --token-limit <n>      Optional token budget for this issue
-//  -h, --help             Show this help
+//   --title <text>         Issue title (defaults to "Issue #<id>" if omitted)
+//   --description <text>   Issue description
+//   --priority <level>     low | medium | high  (default: low)
+//   --token-limit <n>      Optional token budget for this issue
+//   -h, --help             Show this help
 
 import { createIssue } from "../services/issuesService.js";
-import { getFlagValue, getNumericFlag } from "../util.js";
-import { hasFlag, parseArgs, renderOutput, serializeIssue } from '../util.js';
+import { hasFlag, parseArgs, renderOutput, serializeIssue } from "../util.js";
+import { issueSchema } from "../models/schema.js";
+import { input, select, confirm, editor } from "@inquirer/prompts";
+import { spawnSync } from "child_process";
+import { writeFileSync, readFileSync, unlinkSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+
+const ALLOWED_CREATE_FIELDS = ['title', 'priority', 'tokenLimit', 'description'];
+
+const VALID_FLAGS = new Set([
+  ...ALLOWED_CREATE_FIELDS.map(key => issueSchema[key].flag),
+  "--json",
+]);
+
+// Build select choices from issueSchema.priority.values so the list stays in
+// sync with the Priority enum without any duplication.
+const PRIORITY_HINTS = {
+  Low: "routine work, no urgency",
+  Medium: "should be resolved this week",
+  High: "blocking or time-sensitive",
+};
+const PRIORITY_CHOICES = issueSchema.priority.values.map((v) => ({
+  name: `${v.padEnd(6)} -- ${PRIORITY_HINTS[v] ?? v}`,
+  value: v,
+}));
+const DEFAULT_PRIORITY = issueSchema.priority.values[0];
+
+const DESCRIPTION_PLACEHOLDER = [
+  "## What is the issue?",
+  "",
+  "## Steps to reproduce (if applicable)",
+  "",
+  "## Expected vs actual behaviour",
+  "",
+  "## Additional context",
+  "",
+].join("\n");
+
+/**
+ * Opens the user's $EDITOR with an optional seed template and returns the
+ * saved contents, or null if the user left it unchanged / empty.
+ *
+ * Falls back gracefully: if no $EDITOR is set the inquirer `editor` prompt is
+ * used instead (which has its own built-in text area).
+ *
+ * @param {string} template   Initial file content shown to the user.
+ * @returns {Promise<string|null>}
+ */
+async function openEditorForDescription(template = DESCRIPTION_PLACEHOLDER) {
+  const editorBin = process.env.EDITOR || process.env.VISUAL;
+
+  if (!editorBin) {
+    // If no $EDITOR set, then fall back to @inquirer/prompts built-in editor widget
+    const result = await editor({
+      message:
+        "Description (opens in-terminal editor -- save & quit when done):",
+      default: template,
+      waitForUseInput: false,
+    });
+    const cleaned = result.trim();
+    return cleaned && cleaned !== template.trim() ? cleaned : null;
+  }
+
+  // Write template to a temp file, open $EDITOR, read back the result
+  const tmpPath = join(tmpdir(), `baton-issue-${Date.now()}.md`);
+  writeFileSync(tmpPath, template, "utf8");
+
+  const result = spawnSync(editorBin, [tmpPath], { stdio: "inherit" });
+
+  if (result.error) {
+    unlinkSync(tmpPath);
+    throw new Error(
+      `Could not open $EDITOR (${editorBin}): ${result.error.message}`,
+    );
+  }
+
+  const saved = readFileSync(tmpPath, "utf8");
+  unlinkSync(tmpPath);
+
+  const cleaned = saved.trim();
+  // Return null if the user saved without changing anything
+  return cleaned && cleaned !== template.trim() ? cleaned : null;
+}
+
+/**
+ * Guides the user through issue creation with interactive prompts.
+ * @returns {Promise<object>} Options object ready to pass to createIssue()
+ */
+async function runInteractiveMode() {
+  console.log("\n  Baton -- interactive issue creation\n");
+
+  // Title
+  const title = await input({
+    message: "Title:",
+    required: true,
+    validate: (val) => val.trim().length > 0 || "Title cannot be empty.",
+  });
+
+  // Priority
+  const priority = await select({
+    message: "Priority:",
+    choices: PRIORITY_CHOICES,
+    default: DEFAULT_PRIORITY,
+  });
+
+  // Token limit
+  const wantsTokenLimit = await confirm({
+    message: "Set a token limit for this issue?",
+    default: false,
+  });
+
+  let tokenLimit = null;
+  if (wantsTokenLimit) {
+    const raw = await input({
+      message: "Token limit (positive integer):",
+      validate: (val) => {
+        const n = Number(val);
+        return (Number.isInteger(n) && n > 0) || "Must be a positive integer.";
+      },
+    });
+    tokenLimit = Number(raw);
+  }
+
+  // Description
+  const wantsDescription = await confirm({
+    message: "Add a description?",
+    default: true,
+  });
+
+  let description = null;
+  if (wantsDescription) {
+    const editorBin = process.env.EDITOR || process.env.VISUAL;
+    const hint = editorBin ? `opens ${editorBin}` : "in-terminal editor";
+    console.log(
+      `  ->  ${hint} -- fill in what's relevant, save and quit when done.\n`,
+    );
+    description = await openEditorForDescription();
+  }
+
+  // Preview & confirm
+  console.log("\n" + "-".repeat(48));
+  console.log(`  Title      : ${title}`);
+  console.log(`  Priority   : ${priority}`);
+  console.log(`  Token limit: ${tokenLimit ?? "(none)"}`);
+  if (description) {
+    const preview = description.split("\n").slice(0, 3).join(" ").slice(0, 72);
+    console.log(
+      `  Description: ${preview}${description.length > 72 ? "..." : ""}`,
+    );
+  } else {
+    console.log(`  Description: (none)`);
+  }
+  console.log("-".repeat(48) + "\n");
+
+  const confirmed = await confirm({
+    message: "Create this issue?",
+    default: true,
+  });
+  if (!confirmed) {
+    console.log("Aborted -- no issue created.");
+    process.exit(0);
+  }
+
+  return { title, priority, tokenLimit, description };
+}
 
 /**
  * Initializes a new issue in the database with the specified fields
+ * Drops into interactive mode when no flags are provided
+ *
  * @param {string[]} args - The command line arguments
- * @returns {Promise<number>} The exit code: 0 is success, 1 is error.
+ * @returns {Promise<number>} The exit code: 0 is success, 1 is error
  */
 export async function run(args) {
-    const isJson = hasFlag(args, '--json');
-    const validFlags = ['--title', '--description', '--priority', '--token-limit', '--json'];
-    // Check if user misspelled a flag
-    for (const arg of args) {
-        if (arg.startsWith('--')) {
-            if (!validFlags.includes(arg)) {
-                throw new Error(`Unknown flag provided: ${arg}. \nFlags: --title <text>, --description <text>, --priority <level>, --token-limit <n>`);
-            }
-        }
+  const isJson = hasFlag(args, "--json");
+
+  // Flag validation -- VALID_FLAGS is derived from issueSchema, so this stays
+  // current automatically when fields are added or renamed there
+  const providedFlags = args.filter((a) => a.startsWith("--"));
+  for (const flag of providedFlags) {
+    if (!VALID_FLAGS.has(flag)) {
+      const knownFlags = [...VALID_FLAGS].join(", ");
+      throw new Error(
+        `Unknown flag: ${flag}\nValid flags: ${knownFlags}\n` +
+          `Tip: run \`baton create\` with no flags to use interactive mode.`,
+      );
     }
+  }
+
+  try {
+    // Interactive mode: no flags provided (human at a keyboard)
+    // Flag mode:        at least one flag present (scripts, CI, power users)
+    const nonJsonFlags = providedFlags.filter((f) => f !== "--json");
+    const isInteractive = nonJsonFlags.length === 0;
 
-    try {
-        const options = parseArgs(args);
+    const options = isInteractive
+      ? await runInteractiveMode()
+      : parseArgs(args);
 
-        const issue = await createIssue(options);
-        const envelope = { status: 'success', issue: serializeIssue(issue) };
+    const issue = await createIssue(options);
+    const envelope = { status: "success", issue: serializeIssue(issue) };
 
-        renderOutput(isJson, envelope, () => {
-            console.log(`Successfully created issue #${issue.id}: "${issue.title}"`);
-        });
+    renderOutput(isJson, envelope, () => {
+      console.log(`\nCreated issue #${issue.id}: "${issue.title}"`);
+    });
 
-        return 0;
-    } catch (error) {
-        console.error(`Failed to create issue: ${error.message}`);
-        return 1;
+    return 0;
+  } catch (error) {
+    // when user hits Ctrl+C
+    if (error.name === "ExitPromptError") {
+      console.log("\nAborted.");
+      return 0;
     }
+    console.error(`Failed to create issue: ${error.message}`);
+    return 1;
+  }
 }