npm - @hiroleague/taskmanager - Versions diffs - 0.0.1 → 0.0.3 - Mend

@hiroleague/taskmanager 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (196) hide show

package/dist/index.html CHANGED Viewed

@@ -25,23 +25,27 @@
         } catch (e) {}
       })();
     </script>
-    <script type="module" crossorigin src="/assets/index-lyyIVcc_.js"></script>
+    <script type="module" crossorigin src="/assets/index-oKG1C41_.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/chunk-CFjPhJqf.js">
     <link rel="modulepreload" crossorigin href="/assets/src-C47h8eAM.js">
-    <link rel="modulepreload" crossorigin href="/assets/chunk-ICPOFSXX-BNR1V8rT.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-ICPOFSXX-DkUVjrLw.js">
     <link rel="modulepreload" crossorigin href="/assets/dist-BXMOO6xX.js">
-    <link rel="modulepreload" crossorigin href="/assets/identity-D4WOnl_h.js">
-    <link rel="modulepreload" crossorigin href="/assets/chunk-5PVQY5BW-BrmXs2Gs.js">
-    <link rel="modulepreload" crossorigin href="/assets/chunk-U2HBQHQK-DTJPeU7W.js">
-    <link rel="modulepreload" crossorigin href="/assets/chunk-X2U36JSP-CrTnmMqG.js">
-    <link rel="modulepreload" crossorigin href="/assets/chunk-ZZ45TVLE-D3I1kLlo.js">
-    <link rel="modulepreload" crossorigin href="/assets/rough.esm-DtEqI08j.js">
-    <link rel="modulepreload" crossorigin href="/assets/chunk-5FUZZQ4R-XEga0hMC.js">
-    <link rel="modulepreload" crossorigin href="/assets/chunk-BSJP7CBP-D8kBlJsf.js">
+    <link rel="modulepreload" crossorigin href="/assets/identity-Me9aart9.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-5PVQY5BW-cGfZCZGU.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-U2HBQHQK-DogcerR6.js">
+    <link rel="modulepreload" crossorigin href="/assets/isEmpty-Cu0k-j1j.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-X2U36JSP-CwVWdmZV.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-ZZ45TVLE-Bk1S1YtS.js">
+    <link rel="modulepreload" crossorigin href="/assets/rough.esm-DEh6Frf9.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-5FUZZQ4R-B_HuuUjf.js">
     <link rel="modulepreload" crossorigin href="/assets/path-CIRGLb_6.js">
     <link rel="modulepreload" crossorigin href="/assets/array-BCJ35G43.js">
-    <link rel="modulepreload" crossorigin href="/assets/line-DNzQATGr.js">
-    <link rel="modulepreload" crossorigin href="/assets/chunk-ENJZ2VHE-BgZKYo1l.js">
+    <link rel="modulepreload" crossorigin href="/assets/line-otOkzGl8.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-BSJP7CBP-B0LrXV9y.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-ENJZ2VHE-DrWzOrpd.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-336JU56O-BGQvSwLk.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-426QAEUC-Cl9nQN9c.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-XPW4576I-DQpNCogT.js">
     <link rel="stylesheet" crossorigin href="/assets/index-hMFTu7sr.css">
   </head>
   <body>

package/package.json CHANGED Viewed

@@ -1,92 +1,99 @@
-{
-  "name": "@hiroleague/taskmanager",
-  "version": "0.0.1",
-  "type": "module",
-  "description": "Local-only task board app (Bun + Hono + React)",
-  "license": "UNLICENSED",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hiro-league/hirotaskmanager.git"
-  },
-  "homepage": "https://github.com/hiro-league/hirotaskmanager#readme",
-  "bugs": {
-    "url": "https://github.com/hiro-league/hirotaskmanager/issues"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "dist",
-    "src",
-    "README.md"
-  ],
-  "bin": {
-    "hirotaskmanager": "./src/cli/bin/hirotaskmanager.ts",
-    "hirotm": "./src/cli/bin/hirotm.ts"
-  },
-  "scripts": {
-    "app": "bun run src/cli/bin/hirotaskmanager.ts",
-    "cli": "bun run src/cli/bin/hirotm.ts",
-    "dev": "concurrently -k -n api,web -c blue,green \"npm run dev:server\" \"npm run dev:client\"",
-    "dev:server": "npx --yes bun --watch src/server/bootstrapDev.ts",
-    "dev:client": "npx --yes wait-on tcp:127.0.0.1:3002 && vite",
-    "build": "vite build",
-    "prepack": "npm run build",
-    "release:check": "npm run typecheck && bun test && npm run build && npm pack --dry-run",
-    "release:publish": "npm publish --access public",
-    "start": "npx --yes bun src/server/bootstrapInstalled.ts",
-    "typecheck": "tsc --noEmit",
-    "test": "bun test",
-    "test:cli:real-stack": "bun run scripts/run-cli-real-stack-test.ts",
-    "profile:summarize": "node --max-old-space-size=8192 docs/profiling/summarize-profiler-export.mjs",
-    "profile:chrome": "node docs/chrome-profiling/summarize-chrome-trace.mjs",
-    "seed:perf": "bun run scripts/seed-perf-board.ts"
-  },
-  "dependencies": {
-    "@dnd-kit/abstract": "^0.3.2",
-    "@dnd-kit/helpers": "^0.3.2",
-    "@dnd-kit/react": "^0.3.2",
-    "@fontsource-variable/plus-jakarta-sans": "^5.2.8",
-    "@fontsource/lora": "^5.2.8",
-    "@number-flow/react": "^0.6.0",
-    "@radix-ui/react-dropdown-menu": "^2.1.16",
-    "@tailwindcss/vite": "^4.2.2",
-    "@tanstack/react-query": "^5.95.2",
-    "@tanstack/react-virtual": "^3.13.23",
-    "@uiw/react-md-editor": "^4.0.11",
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "cmdk": "^1.1.1",
-    "commander": "^14.0.3",
-    "emoji-picker-react": "^4.18.0",
-    "hono": "^4.12.9",
-    "lucide-react": "^1.7.0",
-    "mermaid": "^11.14.0",
-    "motion": "^12.38.0",
-    "partycles": "^1.2.6",
-    "radix-ui": "^1.4.3",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "react-markdown": "^10.1.0",
-    "react-router-dom": "^7.13.2",
-    "rehype-rewrite": "^4.0.4",
-    "shadcn": "^4.1.1",
-    "tailwind-merge": "^3.5.0",
-    "tailwindcss": "^4.2.2",
-    "tw-animate-css": "^1.4.0",
-    "zustand": "^5.0.12"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.3.11",
-    "@types/node": "^25.5.0",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^6.0.1",
-    "concurrently": "^9.2.1",
-    "typescript": "^6.0.2",
-    "vite": "^8.0.2",
-    "wait-on": "^8.0.5"
-  },
-  "packageManager": "bun@1.3.11"
-}
+{
+  "name": "@hiroleague/taskmanager",
+  "version": "0.0.3",
+  "type": "module",
+  "description": "Task Manager for Solo Builders and AI Agents, working as a team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hiro-league/hirotaskmanager.git"
+  },
+  "homepage": "https://github.com/hiro-league/hirotaskmanager#readme",
+  "bugs": {
+    "url": "https://github.com/hiro-league/hirotaskmanager/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "src",
+    "skills",
+    "LICENSE",
+    "README.md",
+    "scripts/stubs/node-domexception"
+  ],
+  "overrides": {
+    "node-domexception": "file:./scripts/stubs/node-domexception"
+  },
+  "bin": {
+    "hirotaskmanager": "./src/cli/bin/hirotaskmanager.ts",
+    "hirotm": "./src/cli/bin/hirotm.ts"
+  },
+  "scripts": {
+    "app": "bun run src/cli/bin/hirotaskmanager.ts",
+    "cli": "bun run src/cli/bin/hirotm.ts",
+    "dev": "concurrently -k -n api,web -c blue,green \"npm run dev:server\" \"npm run dev:client\"",
+    "dev:server": "npx --yes bun --watch src/server/bootstrapDev.ts --dev --profile dev",
+    "dev:client": "npx --yes wait-on tcp:127.0.0.1:3002 && vite",
+    "build": "vite build",
+    "pack:install": "node ./pack-and-install.mjs",
+    "prepack": "npm run build",
+    "release:check": "npm run typecheck && bun test && npm run build && npm pack --dry-run",
+    "release:publish": "npm publish --access public",
+    "start": "npx --yes bun src/server/bootstrapInstalled.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "test:cli:real-stack": "bun run scripts/run-cli-real-stack-test.ts",
+    "profile:summarize": "node --max-old-space-size=8192 docs/profiling/summarize-profiler-export.mjs",
+    "profile:chrome": "node docs/chrome-profiling/summarize-chrome-trace.mjs",
+    "seed:perf": "bun run scripts/seed-perf-board.ts"
+  },
+  "dependencies": {
+    "@dnd-kit/abstract": "^0.3.2",
+    "@dnd-kit/helpers": "^0.3.2",
+    "@dnd-kit/react": "^0.3.2",
+    "@fontsource-variable/plus-jakarta-sans": "^5.2.8",
+    "@fontsource/lora": "^5.2.8",
+    "@number-flow/react": "^0.6.0",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@tailwindcss/vite": "^4.2.2",
+    "@tanstack/react-query": "^5.95.2",
+    "@tanstack/react-virtual": "^3.13.23",
+    "@uiw/react-md-editor": "^4.0.11",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "commander": "^14.0.3",
+    "emoji-picker-react": "^4.18.0",
+    "hono": "^4.12.9",
+    "lucide-react": "^1.7.0",
+    "mermaid": "^11.14.0",
+    "motion": "^12.38.0",
+    "partycles": "^1.2.6",
+    "radix-ui": "^1.4.3",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-markdown": "^10.1.0",
+    "react-router-dom": "^7.13.2",
+    "rehype-rewrite": "^4.0.4",
+    "shadcn": "^4.1.1",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss": "^4.2.2",
+    "tw-animate-css": "^1.4.0",
+    "zustand": "^5.0.12"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.11",
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "concurrently": "^9.2.1",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.2",
+    "wait-on": "^8.0.5"
+  },
+  "packageManager": "bun@1.3.11"
+}

package/scripts/stubs/node-domexception/index.cjs ADDED Viewed

@@ -0,0 +1,18 @@
+/*!
+ * Same implementation as registry `node-domexception@1.0.0` (MIT), vendored so
+ * npm does not warn about the deprecated package. Transitive deps (fetch-blob)
+ * still need this export shape.
+ */
+if (!globalThis.DOMException) {
+  try {
+    const { MessageChannel } = require("worker_threads"),
+      port = new MessageChannel().port1,
+      ab = new ArrayBuffer();
+    port.postMessage(ab, [ab, ab]);
+  } catch (err) {
+    err.constructor.name === "DOMException" &&
+      (globalThis.DOMException = err.constructor);
+  }
+}
+module.exports = globalThis.DOMException;

package/scripts/stubs/node-domexception/package.json ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "name": "node-domexception",
+  "version": "1.0.0",
+  "main": "index.cjs",
+  "license": "MIT",
+  "description": "Vendored shim matching registry node-domexception@1.0.0 (not deprecated on npm)."
+}

package/skills/hiro-task-manager-cli/SKILL.md ADDED Viewed

@@ -0,0 +1,97 @@
+---
+name: hiro-task-manager-cli
+description: Use this skill when working with Hiro Task Manager through the `hirotm` CLI to manage tasks, task lists and task boards.
+---
+# Hiro Task Manager CLI
+Use this skill when the user wants to work with Hiro Task Manager through the `hirotm` CLI to manage tasks, task lists and task boards.
+## Use this skill for
+- Creating, updating and deleting tasks.
+- Creating, updating and deleting task lists.
+- Managing boards.
+- listing, searching and filtering tasks, lists and boards.
+- Managing Hiro Task Manager server, to be able to operate on tasks, lists and boards.
+- Delete, purge or restore tasks, lists and boards.
+## Default operating workflow
+1. Navigate to intended workspace root.
+2. Initially make sure Hiro Task Manager server is running.
+3. Discover the boards, lists or tasks you need to work with.
+4. Narrow down to the entity you need to work with, using search or list/filter.
+5. Use (Identification) to identify yourself in all commands.
+6. Perform the smallest safe mutation using all the available data,
+7. Show the resulting state after the change.
+## Core rules
+- Use `hirotm` cli command for all operations.
+- use `--help` to get help on any command or sub command `boards --help`, `boards describe --help`.
+- Run commands from the intended workspace root.
+- Inspect current state before making mutations.
+- Use `--client-name` on mutating commands so changes are attributable.
+- Treat delete, purge, and structural changes as sensitive.
+# Identification
+Identify yourself in all commands with `--client-name <your-name>`. Your name should reflect the Agent Name, ex: Cursor Agent, Github Copilot Agent, Claude Code Agent, Open Code Agent.
+If you are not sure, use a generic name "AI Agent"
+## Installation
+If command is not found, ask the user to [install](https://docs.hiroleague.com/task-manager/get-started/quick-start) it and configure it.
+# Discovery
+- use `boards list` to list all boards.
+- use `boards describe <id-or-slug>` to describe all or some board details.
+- use `tasks list --board <board-id-or-slug>` to list and filter tasks in a board.
+# Finding/Adding/Updating Tasks
+- When a user refers to an existing task, use `tasks list` with filers, or `search query` to find it.
+- If convenient, use limit, offset, fields, or quiet options to manage and the output shape.
+- When adding a task
+  - use any available information such as priority, task group, release, etc...
+  - Add proper title (80 characters max) and Emoji if relevant only.
+  - use Organized Markdown description if the task body is detailed.
+  - use mermaid diagrams if the task includes design diagrams or if the user requests it.
+  - If linking to a larger documents in the workspace, make sure to use a proper link from the workspace root.
+# Access
+If you are not allowed to access an entity or perform an operation due to CLI Access Control, explain the situation and suggest the user to give you the necessary permissions. Never attempt to bypass the CLI Access Control.
+# Server Operations
+- Check Server Status with `server status`
+- Start Server with `server start --background`
+- Stop Server with `server stop`
+## References
+- [Installation Guide](https://docs.hiroleague.com/task-manager/get-started/quick-start)
+- Server Commands - Start, stop, and check the server status.
+- [Boards Commands](reference/boards.md) - Create, update, delete, list, describe, and configure boards.
+- [Lists Commands](reference/lists.md) - List, add, update, move, delete, restore, and purge board lists.
+- [Tasks Commands](reference/tasks.md) - List, add, update, move, delete, restore, and purge tasks.
+- [Releases Commands](reference/releases.md) - List, show, add, update, and delete releases.
+- [Trash Commands](reference/trash.md) - Inspect trashed boards, lists, and tasks.
+- [Status Commands](reference/statuses.md) - List workflow statuses and their meanings.
+- [Search Commands](reference/search.md) - Full-text task search with `query search`.
+- [CLI Access Policy](reference/cli-access-policy.md) - Map commands to `cliPolicy` requirements and read/write permissions.
+- [Errors and Exit Codes](reference/errors.md) - Exit codes, stderr fields, and common machine-readable codes.
+**Safety notes**
+- Prefer inspect-first workflows.
+- Search before create when overlap is likely.
+- Do not purge unless intent is clearly explicit.
+- Do not bypass the CLI by any other means than the `hirotm` CLI.
+- Respect permission and policy failures instead of working around them unsafely.
+**References**
+- [Online Documentation](https://docs.hiroleague.com/task-manager/get-started/quick-start)

package/skills/hiro-task-manager-cli/reference/boards.md ADDED Viewed

@@ -0,0 +1,143 @@
+# Boards Commands
+Use `hirotm boards` to discover boards, inspect board structure, and manage board-level settings. Use `hirotm tasks list --board <id-or-slug>` for task rows; `boards describe` does not return tasks.
+## Shared arguments
+- `<id-or-slug>`: board numeric id or board slug.
+- `--yes`: use for non-interactive destructive or structural commands.
+### Text input variants
+Used by board create or update when setting descriptions.
+- `--description <text>`: inline text.
+- `--description-file <path>`: read text from file.
+- `--description-stdin`: read text from stdin.
+### JSON input variants
+Used by `boards configure groups` and `boards configure priorities`. Pass exactly one.
+- `--json <text>`: inline JSON.
+- `--file <path>`: read JSON from file.
+- `--stdin`: read JSON from stdin.
+## Commands
+### `boards list`
+Format:
+```bash
+hirotm boards list [--limit <n>] [--offset <n>] [--page-all] [--fields <keys>]
+```
+Use this to discover accessible boards 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`.
+### `boards describe <id-or-slug>`
+Format:
+```bash
+hirotm boards describe <id-or-slug> [--entities <csv>]
+```
+Use this to inspect one board without loading tasks.
+- Best source for `listId`, `groupId`, `priority`, `releaseId`, and status ids.
+- `--entities <csv>` accepts `list`, `group`, `priority`, `release`, `status`, `meta`.
+- Omitting `--entities` returns the standard entity sections without `meta`.
+- There is no `boards show`; pair `boards describe` with `tasks list --board` when task rows are needed.
+### `boards add [name]`
+Format:
+```bash
+hirotm boards add [name] [--emoji <text>] [description flags]
+```
+Create a new board.
+- `[name]`: board name. Optional.
+- `--emoji <text>`: emoji prefix for the board.
+- Description flags are listed once in `Text input variants`.
+### `boards update <id-or-slug>`
+Format:
+```bash
+hirotm boards update <id-or-slug> [--name <text>] [--emoji <text> | --clear-emoji] [description flags | --clear-description] [--board-color <preset> | --clear-board-color]
+```
+Update board identity or appearance. Pass at least one change.
+- `--name <text>`: rename the board.
+- `--emoji <text>` or `--clear-emoji`: set or clear emoji.
+- Description flags are listed once in `Text input variants`.
+- `--clear-description`: remove the description.
+- `--board-color <preset>`: one of `stone`, `cyan`, `azure`, `indigo`, `violet`, `rose`, `amber`, `emerald`, `coral`, `sage`.
+- `--clear-board-color`: remove the color preset.
+### `boards delete <id-or-slug>`
+Format:
+```bash
+hirotm boards delete <id-or-slug> --yes
+```
+Move a board to Trash.
+### `boards restore <id-or-slug>`
+Format:
+```bash
+hirotm boards restore <id-or-slug> --yes
+```
+Restore a trashed board.
+### `boards purge <id-or-slug>`
+Format:
+```bash
+hirotm boards purge <id-or-slug> --yes
+```
+Permanently delete a trashed board. This is irreversible.
+### `boards configure groups <id-or-slug>`
+Format:
+```bash
+hirotm boards configure groups <id-or-slug> [--json <text> | --file <path> | --stdin] --yes
+```
+Replace board task groups from JSON input.
+- JSON input variants are listed once in `JSON input variants`.
+### `boards configure priorities <id-or-slug>`
+Format:
+```bash
+hirotm boards configure priorities <id-or-slug> [--json <text> | --file <path> | --stdin] --yes
+```
+Replace board priorities from JSON input.
+- JSON input variants are listed once in `JSON input variants`.

package/skills/hiro-task-manager-cli/reference/cli-access-policy.md ADDED Viewed

@@ -0,0 +1,72 @@
+# CLI Access Policy
+Use this page to map `hirotm` commands to the board CLI policy checks enforced by Task Manager.
+## Core rule
+- `readBoard` is the baseline requirement for board-scoped commands.
+- Trash listings only return rows for boards the CLI can read.
+- If `readBoard` is off, board-scoped reads and writes fail for that board.
+## Policy flags
+- `readBoard`: read board-scoped data.
+- `createLists`: create new lists on a board.
+- `createTasks`: create new tasks on a board.
+- `manageCliCreatedLists`: manage lists created by the CLI.
+- `manageAnyLists`: manage lists regardless of creator.
+- `manageCliCreatedTasks`: manage tasks created by the CLI.
+- `manageAnyTasks`: manage tasks regardless of creator.
+- `manageStructure`: manage releases and board structure.
+- `deleteBoard`: delete, restore, and purge boards.
+## Command mapping
+### Board reads
+- `boards list`: `readBoard`
+- `boards describe`: `readBoard`
+### Board lifecycle
+- `boards delete`: `readBoard` + `deleteBoard`
+- `boards restore`: `readBoard` + `deleteBoard`
+- `boards purge`: `readBoard` + `deleteBoard`
+### List commands
+- `lists add`: `readBoard` + `createLists`
+- `lists delete`: `readBoard` + either `manageCliCreatedLists` for CLI-created lists or `manageAnyLists` for other lists
+- `lists restore`: `readBoard` + either `manageCliCreatedLists` for CLI-created lists or `manageAnyLists` for other lists
+- `lists purge`: `readBoard` + either `manageCliCreatedLists` for CLI-created lists or `manageAnyLists` for other lists
+### Task commands
+- `tasks add`: `readBoard` + `createTasks`
+- `tasks delete`: `readBoard` + either `manageCliCreatedTasks` for CLI-created tasks or `manageAnyTasks` for other tasks
+- `tasks restore`: `readBoard` + either `manageCliCreatedTasks` for CLI-created tasks or `manageAnyTasks` for other tasks
+- `tasks purge`: `readBoard` + either `manageCliCreatedTasks` for CLI-created tasks or `manageAnyTasks` for other tasks
+### Release commands
+- `releases list`: `readBoard`
+- `releases show`: `readBoard`
+- `releases add`: `readBoard` + `manageStructure`
+- `releases update`: `readBoard` + `manageStructure`
+- `releases delete`: `readBoard` + `manageStructure`
+### Search and trash
+- `query search` without `--board`: returns hits only from boards the CLI can read
+- `query search --board <id-or-slug>`: `readBoard` for that board
+- `trash list boards`: `readBoard` for each returned board
+- `trash list lists`: `readBoard` for each row's board
+- `trash list tasks`: `readBoard` for each row's board
+### Global commands
+- `statuses list`: not board-scoped
+## Practical note
+Use `hirotm boards describe <id-or-slug>` to inspect the current `cliPolicy` values before attempting a write.

package/skills/hiro-task-manager-cli/reference/errors.md ADDED Viewed

@@ -0,0 +1,85 @@
+# Errors and Exit Codes
+Use this page for how `hirotm` reports failures through exit codes and stderr payloads.
+## Failure output
+- With `--format ndjson`, failures are JSON on stderr.
+- With `--format human`, failures are plain text on stderr.
+- Prefer the machine-readable `code` field over parsing `error` text.
+## Common stderr fields
+- `error`: human-readable summary.
+- `code`: stable machine-readable identifier.
+- `retryable`: whether retry may succeed later.
+- `hint`: recovery hint, such as how to start the server.
+- `status`: HTTP status when the error came from the API.
+- `url`: request URL when relevant.
+- `serverCode`: original API code when the CLI normalized `code`.
+## Exit codes
+| Exit | Meaning | Typical action |
+| --- | --- | --- |
+| `0` | Success | Parse stdout and continue. |
+| `1` | Generic failure or unmapped server/API error | Read `error` and `code`; retry only if appropriate. |
+| `2` | Invalid CLI arguments | Fix flags or values; do not retry unchanged. |
+| `3` | Not found | Refresh ids, slugs, or file paths. |
+| `4` | Forbidden | Respect CLI policy; do not retry unchanged. |
+| `5` | Conflict | Skip create, rename differently, or resolve state conflict. |
+| `6` | Server unreachable | Start the server using the provided `hint`, then retry. |
+| `7` | Timeout | Retry after a delay. |
+| `8` | Version mismatch | Update the CLI or app. |
+| `9` | Bad request or validation failure | Fix the request shape or values. |
+| `10` | Unauthenticated | Configure auth when that flow exists. |
+## Common `code` values
+### API and permission codes
+- `bad_request`
+- `unauthenticated`
+- `forbidden`
+- `not_found`
+- `conflict`
+- `request_timeout`
+- `version_mismatch`
+- `rate_limited`
+- `internal_error`
+- `http_error`
+### Local validation codes
+- `missing_required`
+- `invalid_value`
+- `mutually_exclusive_options`
+- `conflicting_input_sources`
+- `conflicting_clear_with_input`
+- `invalid_json`
+- `invalid_input_shape`
+- `no_update_fields`
+- `release_not_found_by_name`
+- `emoji_validation_failed`
+### Connection and process codes
+- `server_unreachable`
+- `request_timeout`
+- `server_start_timeout`
+- `server_exited`
+- `no_managed_server`
+- `stale_pid`
+- `signal_failed`
+### Other useful codes
+- `file_not_found`
+- `response_inconsistent`
+- `internal_error`
+- `confirmation_required`
+- `confirmation_declined`
+## Recovery rule
+If the CLI exits with `6`, run the exact `hint` command from stderr, then retry.