baton-issue-tracker 1.3.1

package/README.md

@@ -0,0 +1,13 @@
+# Fantastic Four
+
+## Developer Guide
+[Contributing guide](CONTRIBUTING.md)
+
+## Project Details: 
+TBD
+
+# Team Page
+[Click Here](/admin/team.md)
+
+# Agile: Team Status Video
+[https://youtu.be/xToi68JAcwk](https://youtu.be/xToi68JAcwk)

package/drizzle/0000_tidy_enchantress.sql

@@ -0,0 +1,18 @@
+CREATE TABLE `activity` (
+	`log_id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`issue_id` integer,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	`action` text NOT NULL,
+	`details` text
+);
+--> statement-breakpoint
+CREATE TABLE `issues` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	`attempt_num` integer DEFAULT 0 NOT NULL,
+	`title` text DEFAULT 'PENDING' NOT NULL,
+	`status` text DEFAULT 'Open' NOT NULL,
+	`priority` text DEFAULT 'Low',
+	`token_limit` integer,
+	`description` text
+);

package/drizzle/0001_salty_luke_cage.sql

@@ -0,0 +1,16 @@
+ALTER TABLE `issues` ADD `last_updated` text DEFAULT CURRENT_TIMESTAMP NOT NULL;--> statement-breakpoint
+ALTER TABLE `issues` ADD `assignees` text DEFAULT '[]';--> statement-breakpoint
+PRAGMA foreign_keys=OFF;--> statement-breakpoint
+CREATE TABLE `__new_activity` (
+	`log_id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`issue_id` integer,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	`action` text NOT NULL,
+	`details` text,
+	CONSTRAINT "activity_action_check" CHECK("__new_activity"."action" IN ('state_change', 'priority_change', 'edit', 'read', 'creation', 'deletion', 'rejection'))
+);
+--> statement-breakpoint
+INSERT INTO `__new_activity`("log_id", "issue_id", "created_at", "action", "details") SELECT "log_id", "issue_id", "created_at", "action", "details" FROM `activity`;--> statement-breakpoint
+DROP TABLE `activity`;--> statement-breakpoint
+ALTER TABLE `__new_activity` RENAME TO `activity`;--> statement-breakpoint
+PRAGMA foreign_keys=ON;

package/drizzle/meta/0000_snapshot.json

@@ -0,0 +1,135 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "3a9e6e25-7620-4cef-9154-95ab093513fc",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "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
+        },
+        "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": {},
+      "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"
+        },
+        "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
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/drizzle/meta/0001_snapshot.json

@@ -0,0 +1,156 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "af5467aa-0757-4c91-8afb-c6f0202dd90c",
+  "prevId": "3a9e6e25-7620-4cef-9154-95ab093513fc",
+  "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
+        },
+        "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": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {
+        "activity_action_check": {
+          "name": "activity_action_check",
+          "value": "\"activity\".\"action\" IN ('state_change', 'priority_change', 'edit', 'read', 'creation', 'deletion', 'rejection')"
+        }
+      }
+    },
+    "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
+        },
+        "assignees": {
+          "name": "assignees",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'[]'"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/drizzle/meta/_journal.json

@@ -0,0 +1,20 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "6",
+      "when": 1779934723405,
+      "tag": "0000_tidy_enchantress",
+      "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "6",
+      "when": 1780114722528,
+      "tag": "0001_salty_luke_cage",
+      "breakpoints": true
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "baton-issue-tracker",
+  "version": "1.3.1",
+  "description": "A CLI issue tracker for AI agents",
+  "type": "module",
+  "bin": {
+    "baton": "source/cli.js"
+  },
+  "files": [
+    "source/",
+    "drizzle/"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "lint": "eslint source/",
+    "lint:fix": "eslint source/ --fix",
+    "prepare": "husky",
+    "commitlint": "commitlint --edit",
+    "semantic-release": "semantic-release",
+    "build-docs": "jsdoc --pedantic -r source -d docs/jsdoc"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^21.0.1",
+    "@commitlint/config-conventional": "^21.0.1",
+    "@eslint/js": "^9.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^13.1.5",
+    "drizzle-kit": "^0.31.10",
+    "eslint": "^9.0.0",
+    "globals": "^17.6.0",
+    "husky": "^9.1.7",
+    "jsdoc": "^4.0.5",
+    "semantic-release": "^25.0.3"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.10.0",
+    "drizzle-orm": "^0.45.2"
+  }
+}

package/source/cli.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+// cli.js
+// AI was consulted for large portions of this file.
+// CLI for the issue tracker which allows the user to interact with the tracker.
+// usage: baton [command] [options]
+// commands:
+//   init: initialize the tracker
+//   next: work on the next issue
+//   loop: run the agent autonomously for multiple steps
+//   status: show issue counts and overall progress
+//
+// see each command's file for more detailed flags specifications.
+/**
+ * Imports the run functions from each command.
+ */
+import { run as runInit } from './commands/init.js';
+import { run as runNext } from './commands/next.js';
+import { run as runLoop } from './commands/loop.js';
+import { run as runStatus } from './commands/status.js';
+import { run as runApprove } from './commands/approve.js';
+import { wantsHelp } from './util.js';
+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'
+
+const HELP = `baton — AI agent issue tracker CLI
+
+Usage:
+  baton <command> [options]
+
+Commands:
+  init     Initialize storage and seed issues from product specs
+  next     Work on the highest-priority open issue
+  loop     Run the agent autonomously for multiple steps
+  status   Show issue counts and overall progress
+  view     View all issue fields for a given issue ID
+  search   Search issues by title and description (case insensitive)
+  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 
+
+Options:
+  init --force                    Re-initialize an existing tracker database
+  init --specs <path>             Path to product specs file (overrides default)
+  init <path>                     Same as --specs <path> (positional)
+  Default specs: docs/specs/project-requirements.md
+  loop --steps <n>                Number of autonomous steps (alias: -n)
+  loop -n <n>
+  view <id>  
+  search <query>
+  list --status <s>               Filter by status: open | in-progress | closed
+  list --priority <p>             Filter by priority: low | medium | high
+  list --limit <n>                Max results (default: 50)
+  list --offset <n>               Skip first n results (default: 0)
+  create --title <text>           Issue title (defaults to "Issue #<id>" if omitted)
+  create --description <text>     Issue description
+  create --priority <level>       low | medium | high  (default: low)
+  create --token-limit <n>        Optional token budget for this issue
+  approve <id>
+  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  
+ 
+
+Examples:
+  baton init
+  baton init --specs ./my-specs.md
+  baton init ./my-specs.md
+  baton init --force
+  baton next
+  baton loop --steps 5
+  baton status
+  baton view 29
+  baton search system
+  baton list
+  baton list --status open --priority high
+  baton list --limit 10 --offset 20
+  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 update 3 --title "Revised title"
+  baton update 7 --status closed --priority medium
+`;
+
+/**
+ * Main function that runs the CLI.
+ * @returns {Promise<void>} The exit code: 0 is success, 1 is error, 2 is invalid input.
+ */
+async function main() {
+  const [, , command, ...args] = process.argv;
+
+  if (!command || command === 'help' || wantsHelp(args) || command === '--help') {
+    console.log(HELP);
+    process.exit(command ? 0 : 1);
+    return;
+  }
+
+  const handlers = {
+    init: () => runInit(args),
+    next: () => runNext(args),
+    loop: () => runLoop(args),
+    status: () => runStatus(args),
+    view: () => runView(args),
+    search: () => runSearch(args),
+    list: () => runList(args),
+    approve: () => runApprove(args),
+    create: () => runCreate(args),
+    update: () => runUpdate(args)
+  };
+  
+  const handler = handlers[command];
+  if (!handler) {
+    console.error(`Error: Unknown command "${command}".`);
+    console.error('Run `baton --help` for usage.');
+    process.exit(1);
+    return;
+  }
+
+  try {
+    const exitCode = await handler();
+    process.exit(exitCode ?? 0);
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(2);
+  }
+}
+
+main();

package/source/commands/approve.js

@@ -0,0 +1,43 @@
+// approve.js
+// AI was (regrettably) consulted for some portions of this file.
+// approve command which allows a user to approve an issue currently under review.
+// Usage: baton approve <id>
+
+import { approveIssue } from '../services/issuesService.js';
+
+/**
+ * Approves an issue and moves it to the closed state.
+ * @param {string[]} args - the command line arguments.
+ * @returns {Promise<number>} the exit code: 0 is success, 1 is error
+ */
+export async function run(args) {
+    //check if id argument is empty
+    if (args.length == 0) {
+        throw new Error(
+            'Invalid input: Missing issue ID.\nUsage: baton approve <id>'
+        );
+    }
+
+    const id = args.join(' ');
+
+    //check if ID argument isn't a number
+    if (isNaN(id)) {
+        throw new Error(
+            'Invalid input: ID must be a number.\nUsage: baton approve <id>'
+        );
+    }
+
+  //try to approve the issue
+    try {
+        const issue = await approveIssue(id);
+        console.log(
+            `Issue #${issue.id} approved and moved to ${issue.status}.`
+        );
+
+        return 0;
+    } catch (error) {
+        console.error('Error: Failed to approve issue.');
+        console.error(error.message);
+        return 1;
+    }
+}

package/source/commands/create.js

@@ -0,0 +1,48 @@
+// create.js
+// AI was consulted for some portions of this file.
+// create command allows the user to create an issue 
+// Usage: baton create --title <text> --description <text> --priority <level> --token-limit <n>
+// 
+// Examples:
+// baton create --title "Fix login bug" --priority high
+//  baton create --title "Refactor auth" --description "Clean up JWT logic" --token-limit 4000
+// 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
+
+import { createIssue } from "../services/issuesService.js";
+import { getFlagValue, getNumericFlag } from "../util.js";
+import { parseArgs } from '../util.js';
+
+/**
+ * Initializes a new issue in the database with the specified fields
+ * @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 validFlags = ['--title', '--description', '--priority', '--token-limit'];
+    // 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>`);
+            }
+        }
+    }
+
+    try {
+        const options = parseArgs(args);
+
+        const issue = await createIssue(options);
+
+        // program reaches this line if issue was successfully created
+        console.log(`Successfully created issue #${issue.id}: "${issue.title}"`);
+        return 0;
+    } catch (error) {
+        console.error(`Failed to create issue: ${error.message}`);
+        return 1;
+    }
+}