@hiroleague/taskmanager 0.0.1 → 0.0.3

package/skills/hiro-task-manager-cli/reference/lists.md

@@ -0,0 +1,106 @@
+# Lists Commands
+
+Use `hirotm lists` to inspect and manage board columns. Lists belong to a board, so most commands require `--board <id-or-slug>`.
+
+## Shared arguments
+
+- `--board <id-or-slug>`: target board id or slug.
+- `<list-id>`: numeric list id.
+- `--yes`: use for non-interactive delete, restore, and purge commands.
+
+### Position flags
+
+Used by `lists move`. Pass exactly one.
+
+- `--before <list-id>`: place before another list.
+- `--after <list-id>`: place after another list.
+- `--first`: move to the first position.
+- `--last`: move to the last position.
+
+## Commands
+
+### `lists list`
+
+Format:
+
+```bash
+hirotm lists list --board <id-or-slug> [--limit <n>] [--offset <n>] [--page-all] [--fields <keys>]
+```
+
+Use this to discover lists on a board before mutation.
+
+- `--limit <n>`: page size.
+- `--offset <n>`: skip rows.
+- `--page-all`: merge all pages.
+- `--fields <keys>`: project only selected fields.
+- Supports global `--quiet` with `--format ndjson`.
+
+### `lists add`
+
+Format:
+
+```bash
+hirotm lists add --board <id-or-slug> [name] [--emoji <text>]
+```
+
+Create a new list on a board.
+
+- `[name]`: list name. Optional.
+- `--emoji <text>`: emoji prefix for the list.
+
+### `lists update`
+
+Format:
+
+```bash
+hirotm lists update --board <id-or-slug> <list-id> [--name <text>] [--color <css> | --clear-color] [--emoji <text> | --clear-emoji]
+```
+
+Update list fields. Pass at least one change.
+
+- `--name <text>`: rename the list.
+- `--color <css>`: set a CSS color value.
+- `--clear-color`: remove the list color.
+- `--emoji <text>` or `--clear-emoji`: set or clear emoji.
+
+### `lists move`
+
+Format:
+
+```bash
+hirotm lists move --board <id-or-slug> <list-id> [--before <list-id> | --after <list-id> | --first | --last]
+```
+
+Reorder a list within a board.
+
+- Position flags are listed once in `Position flags`.
+
+### `lists delete`
+
+Format:
+
+```bash
+hirotm lists delete --board <id-or-slug> <list-id> --yes
+```
+
+Move a list to Trash.
+
+### `lists restore`
+
+Format:
+
+```bash
+hirotm lists restore <list-id> --yes
+```
+
+Restore a trashed list.
+
+### `lists purge`
+
+Format:
+
+```bash
+hirotm lists purge <list-id> --yes
+```
+
+Permanently delete a trashed list. This is irreversible.

package/skills/hiro-task-manager-cli/reference/releases.md

@@ -0,0 +1,87 @@
+# Releases Commands
+
+Use `hirotm releases` to inspect and manage board releases. Releases are board-level labels used to group tasks.
+
+## Shared arguments
+
+- `--board <id-or-slug>`: target board id or slug.
+- `<release-id>`: numeric release id.
+- `--yes`: use for non-interactive delete commands.
+
+### Shared list/read flags
+
+Used by `releases list` and partially by `releases show`.
+
+- `--limit <n>`: page size.
+- `--offset <n>`: skip rows.
+- `--page-all`: merge all pages.
+- `--fields <keys>`: project only selected fields.
+- `releases list` supports global `--quiet` with `--format ndjson`.
+
+### Shared update fields
+
+Used by `releases add` and `releases update`.
+
+- `--name <text>`: release name.
+- `--color <css>` or `--clear-color`: set or clear release color.
+- `--release-date <text>` or `--clear-release-date`: set or clear the release date.
+
+## Commands
+
+### `releases list`
+
+Format:
+
+```bash
+hirotm releases list --board <id-or-slug> [--limit <n>] [--offset <n>] [--page-all] [--fields <keys>]
+```
+
+Use this to discover releases on a board before setting `--release` or `--release-id` on tasks.
+
+### `releases show`
+
+Format:
+
+```bash
+hirotm releases show --board <id-or-slug> <release-id> [--fields <keys>]
+```
+
+Inspect one release by id.
+
+### `releases add`
+
+Format:
+
+```bash
+hirotm releases add --board <id-or-slug> --name <text> [--color <css> | --clear-color] [--release-date <text> | --clear-release-date]
+```
+
+Create a release on a board.
+
+- Shared update fields are listed once in `Shared update fields`.
+- Release names must be unique per board.
+
+### `releases update`
+
+Format:
+
+```bash
+hirotm releases update --board <id-or-slug> <release-id> [--name <text>] [--color <css> | --clear-color] [--release-date <text> | --clear-release-date]
+```
+
+Update release fields. Pass at least one change.
+
+- Shared update fields are listed once in `Shared update fields`.
+
+### `releases delete`
+
+Format:
+
+```bash
+hirotm releases delete --board <id-or-slug> <release-id> [--move-tasks-to <id>] --yes
+```
+
+Delete a release from a board.
+
+- `--move-tasks-to <id>`: move tagged tasks to another release before deletion.
+- If omitted, tasks on that release become untagged.

package/skills/hiro-task-manager-cli/reference/search.md

@@ -0,0 +1,38 @@
+# Search Commands
+
+Use `hirotm query search` for full-text task search across indexed task fields such as title, body, list name, group label, and status label.
+
+## Command
+
+### `query search <query...>`
+
+Format:
+
+```bash
+hirotm query search <query...> [--board <id-or-slug>] [--limit <n>] [--offset <n>] [--page-all] [--no-prefix] [--fields <keys>]
+```
+
+Search tasks by text.
+
+- `<query...>`: search text. Quote phrases when needed.
+- `--board <id-or-slug>`: limit hits to one board.
+- `--limit <n>`: page size. Defaults to `20` when omitted.
+- `--offset <n>`: skip rows.
+- `--page-all`: merge all pages.
+- `--no-prefix`: disable automatic prefix matching on the last token.
+- `--fields <keys>`: project only selected fields.
+- Supports global `--quiet` with `--format ndjson`.
+
+## Search behavior
+
+- By default, the last token is prefix-matched unless `--no-prefix` is used.
+- Results are ordered by relevance score, best matches first.
+- Invalid search syntax returns an error.
+
+## Result fields
+
+- `taskId`: global task id.
+- `boardSlug` / `boardName`: where the task lives.
+- `listName`: list name for the hit.
+- `snippet`: short excerpt with match context.
+- `score`: relevance score; lower is better.

package/skills/hiro-task-manager-cli/reference/statuses.md

@@ -0,0 +1,25 @@
+# Statuses Commands
+
+Use `hirotm statuses` to inspect the global workflow status table. These status ids are the values used by task commands for `--status`.
+
+## Commands
+
+### `statuses list`
+
+Format:
+
+```bash
+hirotm statuses list [--fields <keys>]
+```
+
+List all workflow statuses in display order.
+
+- `--fields <keys>`: project only selected fields.
+- Supports global `--quiet` with `--format ndjson`.
+
+## Field meaning
+
+- `statusId`: value accepted by task commands for `--status`.
+- `label`: human-readable status name.
+- `sortOrder`: workflow display order.
+- `isClosed`: whether the status counts as closed.

package/skills/hiro-task-manager-cli/reference/tasks.md

@@ -0,0 +1,144 @@
+# Tasks Commands
+
+Use `hirotm tasks` to inspect, create, update, move, and remove tasks on a board.
+
+## Shared arguments
+
+- `--board <id-or-slug>`: target board id or slug.
+- `<task-id>`: numeric task id.
+- `--yes`: use for non-interactive delete, restore, and purge commands.
+
+### Body input variants
+
+Used by `tasks add` and `tasks update` when setting the task body.
+
+- `--body <text>`: inline Markdown text.
+- `--body-file <path>`: read body from file.
+- `--body-stdin`: read body from stdin.
+
+### Release selectors
+
+Used by `tasks add` and `tasks update`. Use only one release selector at a time.
+
+- `--release <name>`: select a release by exact name.
+- `--release none`: explicitly leave the task untagged.
+- `--release-id <id>`: select a release by numeric id.
+- Omit both release flags to allow server defaults or auto-assignment when configured.
+
+### Move position flags
+
+Used by `tasks move`. Pass exactly one when you need placement control.
+
+- `--before-task <id>`: place before another task.
+- `--after-task <id>`: place after another task.
+- `--first`: move to the first position.
+- `--last`: move to the last position.
+
+## Commands
+
+### `tasks list`
+
+Format:
+
+```bash
+hirotm tasks list --board <id-or-slug> [--list <id>] [--group <id>...] [--priority <id>...] [--status <id>...] [--release-id <id>...] [--untagged] [--date-mode opened|closed|any] [--from <yyyy-mm-dd>] [--to <yyyy-mm-dd>] [--limit <n>] [--offset <n>] [--page-all] [--fields <keys>]
+```
+
+Use this to inspect tasks on a board and narrow the result set before mutation.
+
+- `--list <id>`: filter to one list.
+- `--group <id>...`: filter by group id; repeat or use comma-separated values.
+- `--priority <id>...`: filter by priority id; repeat or use comma-separated values.
+- `--status <id>...`: filter by workflow status id; repeat or use comma-separated values.
+- `--release-id <id>...`: filter by release id; repeat or use comma-separated values.
+- `--untagged`: include tasks without a release; combine with `--release-id` as OR.
+- `--date-mode`: use `opened`, `closed`, or `any`.
+- `--from <yyyy-mm-dd>` / `--to <yyyy-mm-dd>`: inclusive date range.
+- `--limit <n>`: page size.
+- `--offset <n>`: skip rows.
+- `--page-all`: merge all pages.
+- `--fields <keys>`: project only selected fields.
+- Supports global `--quiet` with `--format ndjson`.
+
+### `tasks add`
+
+Format:
+
+```bash
+hirotm tasks add --board <id-or-slug> --list <id> --group <id> [--title <text>] [--status <id>] [--priority <id>] [release selector] [--emoji <text>] [body input]
+```
+
+Create a task on a board.
+
+- `--list <id>`: destination list id.
+- `--group <id>`: required task group id.
+- `--title <text>`: task title. Optional.
+- `--status <id>`: workflow status id. Optional.
+- `--priority <id>`: priority id. Optional.
+- `--emoji <text>`: emoji prefix for the task.
+- Release selectors are listed once in `Release selectors`.
+- Body input variants are listed once in `Body input variants`.
+
+### `tasks update`
+
+Format:
+
+```bash
+hirotm tasks update --board <id-or-slug> <task-id> [--title <text>] [--status <id>] [--list <id>] [--group <id>] [--priority <id>] [release selector] [--color <css> | --clear-color] [--emoji <text> | --clear-emoji] [body input]
+```
+
+Update task fields. Pass at least one change.
+
+- `--title <text>`: rename the task.
+- `--status <id>`: change workflow status.
+- `--list <id>`: move to another list.
+- `--group <id>`: change task group.
+- `--priority <id>`: change priority.
+- `--color <css>` or `--clear-color`: set or clear card color.
+- `--emoji <text>` or `--clear-emoji`: set or clear emoji.
+- Release selectors are listed once in `Release selectors`.
+- Body input variants are listed once in `Body input variants`.
+
+### `tasks move`
+
+Format:
+
+```bash
+hirotm tasks move --board <id-or-slug> --to-list <id> <task-id> [--to-status <id>] [--before-task <id> | --after-task <id> | --first | --last]
+```
+
+Move a task to another list and optionally change its status in the destination.
+
+- `--to-list <id>`: destination list id.
+- `--to-status <id>`: destination workflow status. Optional.
+- Move position flags are listed once in `Move position flags`.
+
+### `tasks delete`
+
+Format:
+
+```bash
+hirotm tasks delete --board <id-or-slug> <task-id> --yes
+```
+
+Move a task to Trash.
+
+### `tasks restore`
+
+Format:
+
+```bash
+hirotm tasks restore <task-id> --yes
+```
+
+Restore a trashed task.
+
+### `tasks purge`
+
+Format:
+
+```bash
+hirotm tasks purge <task-id> --yes
+```
+
+Permanently delete a trashed task. This is irreversible.

package/skills/hiro-task-manager-cli/reference/trash.md

@@ -0,0 +1,50 @@
+# Trash Commands
+
+Use `hirotm trash` to inspect what is currently in Trash. These commands are read-only; restore and purge are done through `boards`, `lists`, or `tasks`.
+
+## Shared arguments
+
+- `--limit <n>`: page size.
+- `--offset <n>`: skip rows.
+- `--page-all`: merge all pages.
+- `--fields <keys>`: project only selected fields.
+- Supports global `--quiet` with `--format ndjson`.
+
+## Row meaning
+
+- `trash list boards`: trashed boards.
+- `trash list lists`: trashed lists with parent board context.
+- `trash list tasks`: trashed tasks with parent board and list context.
+- `canRestore`: whether restore is currently possible.
+
+## Commands
+
+### `trash list boards`
+
+Format:
+
+```bash
+hirotm trash list boards [--limit <n>] [--offset <n>] [--page-all] [--fields <keys>]
+```
+
+List boards currently in Trash.
+
+### `trash list lists`
+
+Format:
+
+```bash
+hirotm trash list lists [--limit <n>] [--offset <n>] [--page-all] [--fields <keys>]
+```
+
+List trashed lists with their board context.
+
+### `trash list tasks`
+
+Format:
+
+```bash
+hirotm trash list tasks [--limit <n>] [--offset <n>] [--page-all] [--fields <keys>]
+```
+
+List trashed tasks with their board and list context.

package/src/cli/bootstrap/launcher.test.ts

@@ -0,0 +1,66 @@
+import { describe, expect, test } from "bun:test";
+import { resolveLauncherStartPlan } from "./launcher";
+
+describe("resolveLauncherStartPlan", () => {
+  test("uses background mode by default outside setup", () => {
+    expect(
+      resolveLauncherStartPlan({
+        shouldRunSetup: false,
+        needsRecoveryKeyExitFlow: false,
+        alreadyRunning: false,
+        shouldOpenBrowser: true,
+      }),
+    ).toEqual({
+      startMode: "background",
+      readyLabel: "Started",
+      shouldOpenBrowserOnReady: true,
+    });
+  });
+
+  test("allows explicit foreground outside setup", () => {
+    expect(
+      resolveLauncherStartPlan({
+        shouldRunSetup: false,
+        needsRecoveryKeyExitFlow: false,
+        alreadyRunning: false,
+        shouldOpenBrowser: false,
+        preferForegroundWhenNotSetup: true,
+      }).startMode,
+    ).toBe("foreground");
+  });
+
+  test("does not reopen browser when already running", () => {
+    expect(
+      resolveLauncherStartPlan({
+        shouldRunSetup: false,
+        needsRecoveryKeyExitFlow: false,
+        alreadyRunning: true,
+        shouldOpenBrowser: true,
+      }),
+    ).toEqual({
+      startMode: "background",
+      readyLabel: "Already started",
+      shouldOpenBrowserOnReady: false,
+    });
+  });
+
+  test("keeps setup launches attached unless recovery flow needs background-attached", () => {
+    expect(
+      resolveLauncherStartPlan({
+        shouldRunSetup: true,
+        needsRecoveryKeyExitFlow: false,
+        alreadyRunning: false,
+        shouldOpenBrowser: true,
+      }).startMode,
+    ).toBe("foreground");
+
+    expect(
+      resolveLauncherStartPlan({
+        shouldRunSetup: true,
+        needsRecoveryKeyExitFlow: true,
+        alreadyRunning: false,
+        shouldOpenBrowser: true,
+      }).startMode,
+    ).toBe("background-attached");
+  });
+});