trackerctl 0.1.0 → 0.3.0

package/README.md

@@ -28,16 +28,19 @@ bun run build          # bundle to dist/tracker.js (what the npm package ships)
 
 ## Configuration
 
-Copy `tracker.config.example.json` to `tracker.config.json` and fill in your instance:
+In the project root, scaffold a config:
 
 ```sh
-cp tracker.config.example.json tracker.config.json
+tracker init --base-url https://gitlab.example.com --project group/project
+# or `tracker init` alone, then edit the placeholders
 ```
 
-`tracker.config.json` is **gitignored** (it carries instance/project identifiers); the
-committed example holds the shape. The token is also never committed (env var or gitignored
-`.env`). Config discovery walks up from the current directory, so any subdirectory of the
-project works.
+`init` writes `tracker.config.json` and — inside a git repository — git-ignores the
+local-only files (`tracker.config.json`, `.tracker/`, `.env`) so instance and project
+identifiers can never be committed. The committed `tracker.config.example.json` holds the
+same shape if you prefer copying it by hand. The token is also never committed (env var or
+gitignored `.env`). Config discovery walks up from the current directory, so any
+subdirectory of the project works.
 
 ```json
 {
@@ -86,6 +89,8 @@ Read commands serve from a local sqlite cache that auto-syncs when older than
 | `tracker release <id>` | Clear assignee + label, tombstone claim tokens |
 | `tracker close <id> [--reason <text>]` | Close (clears assignee + in-progress label) |
 | `tracker comment <id> <text>` | Post a comment on an item |
+| `tracker spend <id> <duration>` | Add time spent (`1h30m`, `2d`; `-30m` subtracts) |
+| `tracker estimate <id> <duration>` | Set the time estimate (`0` clears it) |
 | `tracker dep <id> --blocked-by <o> \| --blocks <o>` | Add a dependency edge |
 | `tracker parent <child> <parent>` | Re-parent an item |
 | `tracker remember <key> <text>` | Store a project memory |
@@ -101,6 +106,8 @@ tracker search --state closed                 # state alone is a valid filter
 tracker search "payment timeout" --label backend --state open
 tracker comment 42 "blocked on design review"
 tracker comments 42 --json
+tracker spend 42 1h30m                        # durations: w/d/h/m/s, 1d=8h, 1w=5d
+tracker estimate 42 2d
 tracker search checkout --remote --json       # fresher, server-side
 tracker create -t "Ship login" -d "OAuth" --parent 12 --blocked-by 7,9 -l auth,backend
 tracker claim 42 && do-the-work || echo "someone else got it"
@@ -144,6 +151,8 @@ domain refusal (e.g. lost a claim race) — pick different work, don't retry.
 - Inspect:          `tracker show <id> --json`, `tracker children <id> --json`,
                     `tracker epic-status <id> --json`, `tracker comments <id> --json`
 - Discuss:          `tracker comment <id> "<note for humans or other agents>"`
+- Track time:       `tracker spend <id> 1h30m` after finishing work (estimate vs spent
+                    feeds later evaluations; durations use 1d=8h, -30m subtracts)
 - Project memory:   `tracker remember <key> "<fact>"`, `tracker memories --json`,
                     `tracker forget <key>`
 
@@ -168,7 +177,9 @@ Never edit the `📌 Project Memory` issue or `🔒/🔓` notes by hand.
   "blockedBy": ["7", "9"],     // ids of open OR closed blockers; `ready` checks openness
   "url": "https://gitlab…/issues/42",
   "description": "…",
-  "updatedAt": "2026-06-10T17:21:33.000Z"
+  "updatedAt": "2026-06-10T17:21:33.000Z",
+  "timeSpentSeconds": 3600,        // 0 = none recorded
+  "timeEstimateSeconds": 57600     // 0 = no estimate
 }
 ```
 

package/dist/tracker.js

@@ -2,8 +2,8 @@
 // @bun
 
 // src/cli/index.ts
-import { existsSync as existsSync3 } from "fs";
-import { resolve as resolve3 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import { resolve as resolve4 } from "path";
 
 // src/errors.ts
 class DomainError extends Error {
@@ -156,6 +156,8 @@ function mapIssue(issue, info) {
     url: issue.web_url,
     description,
     updatedAt: issue.updated_at,
+    timeSpentSeconds: issue.time_stats?.total_time_spent ?? 0,
+    timeEstimateSeconds: issue.time_stats?.time_estimate ?? 0,
     raw: issue
   };
 }
@@ -225,7 +227,12 @@ class GitLabAdapter {
     this.nativeBlocking = opts.nativeBlocking;
   }
   capabilities() {
-    return { nativeBlocking: this.nativeBlocking, nativeHierarchy: true, serverSearch: true };
+    return {
+      nativeBlocking: this.nativeBlocking,
+      nativeHierarchy: true,
+      serverSearch: true,
+      timeTracking: true
+    };
   }
   async getFullPath() {
     if (this.fullPath)
@@ -414,6 +421,47 @@ class GitLabAdapter {
       throw new DomainError(`workItemUpdate: ${data.workItemUpdate.errors.join("; ")}`);
     }
   }
+  static glDuration(seconds) {
+    const sign = seconds < 0 ? "-" : "";
+    let rest = Math.abs(seconds);
+    const parts = [];
+    const h = Math.floor(rest / 3600);
+    rest %= 3600;
+    const m = Math.floor(rest / 60);
+    const s = rest % 60;
+    if (h)
+      parts.push(`${h}h`);
+    if (m)
+      parts.push(`${m}m`);
+    if (s)
+      parts.push(`${s}s`);
+    return sign + (parts.join("") || "0m");
+  }
+  async addTimeSpent(id, seconds) {
+    try {
+      await this.client.rest(`projects/${this.projectRef}/issues/${id}/add_spent_time`, {
+        method: "POST",
+        body: { duration: GitLabAdapter.glDuration(seconds) }
+      });
+    } catch (e) {
+      if (e instanceof GitLabHttpError && e.status === 400) {
+        throw new DomainError(`cannot record ${GitLabAdapter.glDuration(seconds)} on #${id}: ${e.message}`);
+      }
+      throw e;
+    }
+  }
+  async setTimeEstimate(id, seconds) {
+    if (seconds === 0) {
+      await this.client.rest(`projects/${this.projectRef}/issues/${id}/reset_time_estimate`, {
+        method: "POST"
+      });
+      return;
+    }
+    await this.client.rest(`projects/${this.projectRef}/issues/${id}/time_estimate`, {
+      method: "POST",
+      body: { duration: GitLabAdapter.glDuration(seconds) }
+    });
+  }
   async comment(id, body) {
     await this.client.rest(`projects/${this.projectRef}/issues/${id}/notes`, {
       method: "POST",
@@ -478,6 +526,8 @@ CREATE TABLE IF NOT EXISTS items (
   url         TEXT NOT NULL,
   description TEXT NOT NULL,
   updated_at  TEXT NOT NULL,
+  time_spent    INTEGER NOT NULL DEFAULT 0,
+  time_estimate INTEGER NOT NULL DEFAULT 0,
   raw         TEXT
 );
 CREATE INDEX IF NOT EXISTS idx_items_parent ON items(parent);
@@ -501,16 +551,24 @@ class Cache {
       mkdirSync(dirname(path), { recursive: true });
     this.db = new Database(path);
     this.db.exec(SCHEMA);
+    for (const col of [
+      "time_spent INTEGER NOT NULL DEFAULT 0",
+      "time_estimate INTEGER NOT NULL DEFAULT 0"
+    ]) {
+      try {
+        this.db.exec(`ALTER TABLE items ADD COLUMN ${col}`);
+      } catch {}
+    }
   }
   replaceAll(items, provider) {
-    const insertItem = this.db.prepare(`INSERT INTO items (id, provider, kind, title, state, labels, assignees, author, parent, url, description, updated_at, raw)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+    const insertItem = this.db.prepare(`INSERT INTO items (id, provider, kind, title, state, labels, assignees, author, parent, url, description, updated_at, time_spent, time_estimate, raw)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
     const insertLink = this.db.prepare("INSERT OR IGNORE INTO links (blocker, blocked) VALUES (?, ?)");
     const insertFts = this.db.prepare("INSERT INTO items_fts (id, title, description) VALUES (?, ?, ?)");
     const tx = this.db.transaction(() => {
       this.db.exec("DELETE FROM items; DELETE FROM links; DELETE FROM items_fts;");
       for (const item of items) {
-        insertItem.run(item.id, provider, item.kind, item.title, item.state, JSON.stringify(item.labels), JSON.stringify(item.assignees), item.author ? JSON.stringify(item.author) : null, item.parent, item.url, item.description, item.updatedAt, item.raw === undefined ? null : JSON.stringify(item.raw));
+        insertItem.run(item.id, provider, item.kind, item.title, item.state, JSON.stringify(item.labels), JSON.stringify(item.assignees), item.author ? JSON.stringify(item.author) : null, item.parent, item.url, item.description, item.updatedAt, item.timeSpentSeconds, item.timeEstimateSeconds, item.raw === undefined ? null : JSON.stringify(item.raw));
         for (const blocker of item.blockedBy)
           insertLink.run(blocker, item.id);
         insertFts.run(item.id, item.title, item.description);
@@ -531,7 +589,9 @@ class Cache {
       blockedBy: this.blockersOf(row.id),
       url: row.url,
       description: row.description,
-      updatedAt: row.updated_at
+      updatedAt: row.updated_at,
+      timeSpentSeconds: row.time_spent,
+      timeEstimateSeconds: row.time_estimate
     };
   }
   blockersOf(id) {
@@ -698,7 +758,7 @@ function parseConfig(json, rootDir) {
 function loadConfig(startDir = process.cwd()) {
   const file = findConfigFile(startDir);
   if (!file) {
-    throw new UsageError(`no ${CONFIG_FILENAME} found in ${startDir} or any parent directory \u2014 create one (see README) or cd into the project.`);
+    throw new UsageError(`no ${CONFIG_FILENAME} found in ${startDir} or any parent directory \u2014 run \`tracker init\` to create one, or cd into the project.`);
   }
   return parseConfig(readFileSync2(file, "utf8"), dirname3(file));
 }
@@ -854,6 +914,47 @@ async function releaseItem(adapter, id, policy) {
   return { id, cleared };
 }
 
+// src/core/duration.ts
+var UNIT_SECONDS = {
+  w: 5 * 8 * 3600,
+  d: 8 * 3600,
+  h: 3600,
+  m: 60,
+  s: 1
+};
+function parseDuration(input) {
+  const trimmed = input.trim();
+  const negative = trimmed.startsWith("-");
+  const body = negative ? trimmed.slice(1) : trimmed;
+  if (body === "0")
+    return 0;
+  const parts = [...body.matchAll(/(\d+)([wdhms])/g)];
+  const matched = parts.map((p) => p[0]).join("");
+  if (parts.length === 0 || matched !== body) {
+    throw new UsageError(`invalid duration "${input}" \u2014 use units w/d/h/m/s, e.g. 1h30m, 45m, 2d (1d=8h, 1w=5d), -30m to subtract`);
+  }
+  const seconds = parts.reduce((sum, p) => sum + Number(p[1]) * UNIT_SECONDS[p[2]], 0);
+  return negative ? -seconds : seconds;
+}
+function formatDuration(totalSeconds) {
+  const sign = totalSeconds < 0 ? "-" : "";
+  let rest = Math.abs(Math.round(totalSeconds));
+  const parts = [];
+  const h = Math.floor(rest / 3600);
+  rest %= 3600;
+  const m = Math.floor(rest / 60);
+  const s = rest % 60;
+  if (h)
+    parts.push(`${h}h`);
+  if (m)
+    parts.push(`${m}m`);
+  if (s)
+    parts.push(`${s}s`);
+  if (parts.length === 0)
+    return "0m";
+  return sign + parts.join(" ");
+}
+
 // src/core/ids.ts
 function normalizeId(input) {
   const id = (input ?? "").trim().replace(/^#/, "");
@@ -1004,11 +1105,83 @@ async function ensureFresh(adapter, cache, staleMs, nowMs = Date.now(), onSync)
   return true;
 }
 
+// src/init.ts
+import { appendFileSync as appendFileSync2, existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync } from "fs";
+import { dirname as dirname4, join as join3, resolve as resolve3 } from "path";
+var PLACEHOLDER_URL = "https://gitlab.example.com";
+var PLACEHOLDER_PROJECT = "group/project";
+function configTemplate(baseUrl, project) {
+  const config = {
+    provider: "gitlab",
+    gitlab: {
+      base_url: baseUrl.replace(/\/+$/, ""),
+      project,
+      token_env: ["TRACKER_GITLAB_TOKEN", "GITLAB_PERSONAL_ACCESS_TOKEN"],
+      native_blocking: true
+    },
+    labels: { in_progress: "status::in-progress" },
+    memory: { enabled: true, title: "\uD83D\uDCCC Project Memory", label: "meta::memory" },
+    cache: { path: ".tracker/cache.sqlite", stale_minutes: 15 }
+  };
+  return `${JSON.stringify(config, null, 2)}
+`;
+}
+function ensureIgnored(dir, warnings) {
+  const gitRoot = findGitRoot(dir);
+  if (!gitRoot)
+    return [];
+  const entries = [
+    [CONFIG_FILENAME, join3(dir, CONFIG_FILENAME)],
+    [".tracker/", join3(dir, ".tracker", "cache.sqlite")],
+    [".env", join3(dir, ".env")]
+  ];
+  const added = [];
+  for (const [pattern, path] of entries) {
+    const ignored = isGitIgnored(gitRoot, path);
+    if (ignored === null) {
+      warnings.push(`git not available \u2014 verify ${pattern} is git-ignored yourself`);
+      return added;
+    }
+    if (ignored)
+      continue;
+    const gitignorePath = join3(dir, ".gitignore");
+    const existing = existsSync3(gitignorePath) ? readFileSync3(gitignorePath, "utf8") : "";
+    const prefix = existing && !existing.endsWith(`
+`) ? `
+` : "";
+    appendFileSync2(gitignorePath, `${prefix}${pattern}
+`);
+    added.push(pattern);
+  }
+  return added;
+}
+function initProject(targetDir, opts) {
+  const dir = resolve3(targetDir);
+  const configPath = join3(dir, CONFIG_FILENAME);
+  if (existsSync3(configPath)) {
+    throw new UsageError(`${configPath} already exists \u2014 edit it instead of re-running init`);
+  }
+  const warnings = [];
+  const parentConfig = findConfigFile(dirname4(dir));
+  if (parentConfig) {
+    warnings.push(`a ${CONFIG_FILENAME} already exists in ${dirname4(parentConfig)} \u2014 the one created here will shadow it for everything under ${dir}`);
+  }
+  const placeholders = !opts.baseUrl || !opts.project;
+  writeFileSync(configPath, configTemplate(opts.baseUrl ?? PLACEHOLDER_URL, opts.project ?? PLACEHOLDER_PROJECT));
+  const ignoreAdded = ensureIgnored(dir, warnings);
+  return { configPath, placeholders, ignoreAdded, warnings };
+}
+
 // src/cli/help.ts
 var HELP = `tracker \u2014 multi-backend issue tracking for humans and AI agents
 
 usage: tracker <command> [args]
 
+setup:
+  init [--base-url <url>] [--project <group/project>]
+                             scaffold tracker.config.json + .gitignore entries
+  doctor                     verify config, token, connectivity, capabilities
+
 read commands (local cache, auto-sync when stale; all accept --json):
   sync                       refresh the local cache from the provider
   ready [--parent <id>]      open + unblocked + unassigned + not in-progress
@@ -1020,7 +1193,6 @@ read commands (local cache, auto-sync when stale; all accept --json):
   users <query>              resolve usernames/names to user ids
   whoami                     the authenticated user
   memories [filter]          list project memories
-  doctor                     verify config, token, connectivity, capabilities
 
 write commands:
   create -t <title> [-d <desc>] [--parent <id>] [--epic <id>] [-l a,b]
@@ -1029,6 +1201,8 @@ write commands:
   release <id>               clear assignee/label, tombstone live claim tokens
   close <id> [--reason <text>]
   comment <id> <text>        post a comment on an item
+  spend <id> <duration>      add time spent (1h30m, 45m, 2d; -30m subtracts)
+  estimate <id> <duration>   set the time estimate (0 clears it)
   dep <id> --blocked-by <other> | --blocks <other>
   parent <child-id> <parent-id>
   remember <key> <text>      store a project memory (key has no whitespace)
@@ -1098,6 +1272,21 @@ Lists the item's comments oldest-first (system notes are filtered out). Claim
 notes (\uD83D\uDD12/\uD83D\uDD13) and memory entries (\uD83D\uDCCC) appear here too \u2014 useful for debugging.
 
 example: tracker comments 42 --json`,
+  spend: `usage: tracker spend <id> <duration>
+
+Adds to the item's time spent. Durations use GitLab conventions:
+units w/d/h/m/s with 1d = 8h and 1w = 5d. A leading "-" subtracts.
+
+examples:
+  tracker spend 42 1h30m
+  tracker spend 42 -30m     # logged too much, take 30m back`,
+  estimate: `usage: tracker estimate <id> <duration>
+
+Sets the item's time estimate (same duration format as spend). 0 clears it.
+
+examples:
+  tracker estimate 42 2d
+  tracker estimate 42 0`,
   dep: `usage: tracker dep <id> --blocked-by <other> | --blocks <other>
 
 examples:
@@ -1133,7 +1322,17 @@ example: tracker users mehmet`,
   whoami: "usage: tracker whoami [--json]",
   doctor: `usage: tracker doctor [--json]
 
-Verifies config, token, REST/GraphQL connectivity, capabilities, cache.`
+Verifies config, token, REST/GraphQL connectivity, capabilities, cache.`,
+  init: `usage: tracker init [--base-url <url>] [--project <group/project>]
+
+Scaffolds tracker.config.json in the current directory (placeholders when the
+flags are omitted) and, inside a git repository, git-ignores the local-only
+files (tracker.config.json, .tracker/, .env) so instance and project
+identifiers can never be committed. Refuses to overwrite an existing config.
+
+examples:
+  tracker init --base-url https://gitlab.example.com --project group/project
+  tracker init    # then edit the placeholders in tracker.config.json`
 };
 function commandHelp(cmd) {
   return PER_COMMAND[cmd] ?? HELP;
@@ -1168,6 +1367,11 @@ function printItemDetail(item, blocks) {
   console.log(`parent:     ${item.parent ? `#${item.parent}` : "-"}`);
   console.log(`blocked by: ${item.blockedBy.map((b) => `#${b}`).join(", ") || "-"}`);
   console.log(`blocks:     ${blocks.map((b) => `#${b}`).join(", ") || "-"}`);
+  if (item.timeSpentSeconds || item.timeEstimateSeconds) {
+    const spent = formatDuration(item.timeSpentSeconds);
+    const estimate = item.timeEstimateSeconds ? ` / estimate ${formatDuration(item.timeEstimateSeconds)}` : "";
+    console.log(`time:       spent ${spent}${estimate}`);
+  }
   console.log(`updated:    ${item.updatedAt}`);
   if (item.description) {
     console.log("---");
@@ -1185,7 +1389,7 @@ function parseArgs(args, spec, aliases = {}) {
   const positionals = [];
   for (let i = 0;i < args.length; i++) {
     const arg = args[i];
-    if (!arg.startsWith("-") || arg === "-") {
+    if (!arg.startsWith("-") || arg === "-" || /^-\d/.test(arg)) {
       positionals.push(arg);
       continue;
     }
@@ -1217,8 +1421,8 @@ function buildCtx() {
     token,
     nativeBlocking: config.gitlab.native_blocking
   });
-  const cachePath = resolve3(config.rootDir, config.cache.path);
-  if (!existsSync3(cachePath)) {
+  const cachePath = resolve4(config.rootDir, config.cache.path);
+  if (!existsSync4(cachePath)) {
     const guard = guardCacheIgnored(config.rootDir, cachePath);
     if (guard.action === "added" || guard.action === "warn")
       console.error(`(${guard.detail})`);
@@ -1244,7 +1448,7 @@ async function cmdSync(ctx) {
   const t0 = performance.now();
   const { count } = await syncCache(ctx.adapter, ctx.cache);
   const ms = Math.round(performance.now() - t0);
-  console.log(`synced ${count} items in ${ms}ms \u2192 ${resolve3(ctx.config.rootDir, ctx.config.cache.path)}`);
+  console.log(`synced ${count} items in ${ms}ms \u2192 ${resolve4(ctx.config.rootDir, ctx.config.cache.path)}`);
 }
 async function cmdReady(ctx, args) {
   await freshen(ctx);
@@ -1381,6 +1585,38 @@ async function cmdMemories(ctx, args) {
   for (const m of memories)
     console.log(`${m.key}	${m.ts}	${m.text}`);
 }
+function requireTimeTracking(ctx) {
+  if (!ctx.adapter.capabilities().timeTracking) {
+    throw new UsageError(`the ${ctx.adapter.provider} adapter does not support time tracking`);
+  }
+}
+async function cmdSpend(ctx, args) {
+  requireTimeTracking(ctx);
+  const [idArg, durationArg] = args.positionals;
+  const id = normalizeId(idArg);
+  if (!durationArg)
+    throw new UsageError(commandHelp("spend"));
+  const seconds = parseDuration(durationArg);
+  if (seconds === 0)
+    throw new UsageError("spend needs a non-zero duration (e.g. 1h30m or -30m)");
+  await ctx.adapter.addTimeSpent(id, seconds);
+  invalidate(ctx);
+  const item = await ctx.adapter.get(id);
+  console.log(`#${id} ${seconds > 0 ? "spent" : "subtracted"} ${formatDuration(Math.abs(seconds))} \u2192 total ${formatDuration(item.timeSpentSeconds)}`);
+}
+async function cmdEstimate(ctx, args) {
+  requireTimeTracking(ctx);
+  const [idArg, durationArg] = args.positionals;
+  const id = normalizeId(idArg);
+  if (durationArg === undefined)
+    throw new UsageError(commandHelp("estimate"));
+  const seconds = parseDuration(durationArg);
+  if (seconds < 0)
+    throw new UsageError("an estimate cannot be negative (use 0 to clear it)");
+  await ctx.adapter.setTimeEstimate(id, seconds);
+  invalidate(ctx);
+  console.log(seconds === 0 ? `#${id} estimate cleared` : `#${id} estimate ${formatDuration(seconds)}`);
+}
 async function cmdComment(ctx, args) {
   const [idArg, ...textParts] = args.positionals;
   const id = normalizeId(idArg);
@@ -1462,7 +1698,7 @@ async function cmdDoctor(args) {
       name: "config",
       status: "fail",
       detail: e.message,
-      fix: "create tracker.config.json (see README) in the project root"
+      fix: "run `tracker init` in the project root to create tracker.config.json"
     });
   }
   let ctx = null;
@@ -1529,7 +1765,7 @@ async function cmdDoctor(args) {
       status: "ok",
       detail: last ? `${ctx.cache.count()} items, synced ${Math.round((Date.now() - last) / 60000)}m ago` : "empty (run: tracker sync)"
     });
-    const cachePath = resolve3(config.rootDir, config.cache.path);
+    const cachePath = resolve4(config.rootDir, config.cache.path);
     const gitRoot = findGitRoot(config.rootDir);
     if (gitRoot) {
       const ignored = isGitIgnored(gitRoot, cachePath);
@@ -1557,6 +1793,21 @@ all good.`);
   }
   return failed ? 1 : 0;
 }
+function cmdInit(args) {
+  const result = initProject(process.cwd(), {
+    baseUrl: str(args, "--base-url"),
+    project: str(args, "--project")
+  });
+  console.log(`created ${result.configPath}`);
+  for (const pattern of result.ignoreAdded)
+    console.log(`added "${pattern}" to .gitignore`);
+  for (const warning of result.warnings)
+    console.error(`warning: ${warning}`);
+  if (result.placeholders) {
+    console.log("next: edit gitlab.base_url and gitlab.project in the config");
+  }
+  console.log("then: export TRACKER_GITLAB_TOKEN (or add it to .env) and run: tracker doctor");
+}
 var VALUE_FLAGS = {
   ready: { "--parent": "value", "--json": "bool" },
   show: { "--json": "bool" },
@@ -1586,9 +1837,12 @@ var VALUE_FLAGS = {
   users: { "--json": "bool" },
   whoami: { "--json": "bool" },
   doctor: { "--json": "bool" },
+  init: { "--base-url": "value", "--project": "value" },
   memories: { "--json": "bool" },
   comment: {},
   comments: { "--json": "bool" },
+  spend: {},
+  estimate: {},
   sync: {},
   claim: {},
   release: {},
@@ -1624,6 +1878,10 @@ ${HELP}`);
     return 0;
   }
   const args = parseArgs(rest, spec, ALIASES[cmd] ?? {});
+  if (cmd === "init") {
+    cmdInit(args);
+    return 0;
+  }
   if (cmd === "doctor")
     return cmdDoctor(args);
   const ctx = buildCtx();
@@ -1644,6 +1902,8 @@ ${HELP}`);
     memories: cmdMemories,
     comment: cmdComment,
     comments: cmdComments,
+    spend: cmdSpend,
+    estimate: cmdEstimate,
     search: cmdSearch,
     users: cmdUsers,
     whoami: cmdWhoami

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackerctl",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Multi-backend issue-tracking CLI for humans and AI agents — claim races, dependencies, hierarchy, local FTS search, project memory. GitLab adapter first.",
   "license": "MIT",
   "author": "refo",