npm - @hiroleague/taskmanager - Versions diffs - 0.0.2 → 0.0.4 - Mend

@hiroleague/taskmanager 0.0.2 → 0.0.4

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 (179) hide show

package/dist/index.html CHANGED Viewed

@@ -25,24 +25,28 @@
         } catch (e) {}
       })();
     </script>
-    <script type="module" crossorigin src="/assets/index-CZZuue3D.js"></script>
+    <script type="module" crossorigin src="/assets/index-DmNErTAP.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="stylesheet" crossorigin href="/assets/index-hMFTu7sr.css">
+    <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-BpzHnKdP.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
   "name": "@hiroleague/taskmanager",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
-  "description": "Local-only task board app (Bun + Hono + React)",
+  "description": "Task Manager for Solo Builders and AI Agents, working as a team",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -22,7 +22,6 @@
     "skills",
     "LICENSE",
     "README.md",
-    "scripts/postinstall-message.mjs",
     "scripts/stubs/node-domexception"
   ],
   "overrides": {
@@ -33,7 +32,6 @@
     "hirotm": "./src/cli/bin/hirotm.ts"
   },
   "scripts": {
-    "postinstall": "node scripts/postinstall-message.mjs",
     "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\"",

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

@@ -39,7 +39,9 @@ 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.
+The `hirotm` binary ships with the **`@hiroleague/taskmanager`** npm package ([npm](https://www.npmjs.com/package/@hiroleague/taskmanager), [source](https://github.com/hiro-league/hirotaskmanager)).
+If the command is not found, ask the user to [install](https://docs.hiroleague.com/task-manager/get-started/quickstart) it and configure it.
 # Discovery
@@ -70,12 +72,12 @@ If you are not allowed to access an entity or perform an operation due to CLI Ac
 ## References
-- [Installation Guide](https://docs.hiroleague.com/task-manager/get-started/quick-start)
+- [Installation Guide](https://docs.hiroleague.com/task-manager/get-started/quickstart)
 - 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.
+- [Releases Commands](reference/releases.md) - List, show, add, update, delete, and set-default 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`.
@@ -94,4 +96,4 @@ If you are not allowed to access an entity or perform an operation due to CLI Ac
 **References**
-- [Online Documentation](https://docs.hiroleague.com/task-manager/get-started/quick-start)
+- [Online Documentation](https://docs.hiroleague.com/task-manager/get-started/quickstart)

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

@@ -54,6 +54,7 @@ Use this page to map `hirotm` commands to the board CLI policy checks enforced b
 - `releases add`: `readBoard` + `manageStructure`
 - `releases update`: `readBoard` + `manageStructure`
 - `releases delete`: `readBoard` + `manageStructure`
+- `releases set-default`: `readBoard` + `manageStructure`
 ### Search and trash

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

@@ -85,3 +85,17 @@ 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.
+### `releases set-default`
+Format:
+```bash
+hirotm releases set-default --board <id-or-slug> <release-id>
+hirotm releases set-default --board <id-or-slug> --clear
+```
+Set or clear the board’s default release (the release used for new tasks when the board’s auto-assign rules apply). This PATCHes the board (`defaultReleaseId`); requires `manageStructure` on the board for CLI clients.
+- Provide `<release-id>` to set the default, or `--clear` to remove it.
+- Do not pass `<release-id>` together with `--clear`.

package/src/cli/bootstrap/launcher.ts CHANGED Viewed

@@ -29,6 +29,8 @@ import {
   formatTextPrompt,
   isAuthInitialized,
   paintValue,
+  printSetupContinuePrompt,
+  printSetupNextSteps,
   printPassphraseHint,
   printRecoveryKey,
   printRecoveryKeyExitHint,
@@ -319,7 +321,7 @@ async function waitForRecoveryKeyFile(authDir: string): Promise<string> {
   return key;
 }
-async function waitForEnterToExitLauncher(): Promise<void> {
+async function waitForEnterKey(): Promise<void> {
   const rl = createInterface({
     input: process.stdin,
     output: process.stdout,
@@ -383,9 +385,21 @@ export function createHirotaskmanagerProgram(): Command {
               },
             };
-        // Safety net: copy bundled skills to ~/.taskmanager/skills/ if
-        // postinstall was skipped (--ignore-scripts, CI, bunx) or stale.
-        ensureBundledSkills();
+        // Registry installs can skip lifecycle hooks, so setup itself must
+        // print the exact `npx skills` commands users should run next.
+        const skillsInstalled = ensureBundledSkills();
+        if (shouldRunSetup) {
+          printSetupNextSteps({
+            profileName: selectedProfile,
+            skillsInstalled,
+          });
+          if (setupResult.setupMeta.justFinishedInteractiveSetup) {
+            // Keep setup blocked here so users see the required skills step
+            // before the server starts and the browser steals focus.
+            printSetupContinuePrompt();
+            await waitForEnterKey();
+          }
+        }
         const launcherConfig = setupResult.config;
@@ -471,7 +485,7 @@ export function createHirotaskmanagerProgram(): Command {
             const recoveryKey = await waitForRecoveryKeyFile(authDir);
             printRecoveryKey(recoveryKey);
             printRecoveryKeyExitHint(runningUrl);
-            await waitForEnterToExitLauncher();
+            await waitForEnterKey();
           }
         } finally {
           if (previousSilentStartup === undefined) {

package/src/cli/bootstrap/program.test.ts ADDED Viewed

@@ -0,0 +1,46 @@
+import { describe, expect, test } from "bun:test";
+import {
+  getHirotmLauncherSetupCommand,
+  shouldRequireLauncherSetupForHirotm,
+} from "./program";
+describe("shouldRequireLauncherSetupForHirotm", () => {
+  test("requires launcher setup for installed mode without a saved profile", () => {
+    expect(
+      shouldRequireLauncherSetupForHirotm({
+        runtimeKind: "installed",
+        hasInstalledProfileConfig: false,
+      }),
+    ).toBe(true);
+  });
+  test("allows installed mode once the profile config exists", () => {
+    expect(
+      shouldRequireLauncherSetupForHirotm({
+        runtimeKind: "installed",
+        hasInstalledProfileConfig: true,
+      }),
+    ).toBe(false);
+  });
+  test("never blocks dev mode on launcher setup", () => {
+    expect(
+      shouldRequireLauncherSetupForHirotm({
+        runtimeKind: "dev",
+        hasInstalledProfileConfig: false,
+      }),
+    ).toBe(false);
+  });
+});
+describe("getHirotmLauncherSetupCommand", () => {
+  test("uses the plain launcher command for the default profile", () => {
+    expect(getHirotmLauncherSetupCommand("default")).toBe("hirotaskmanager");
+  });
+  test("includes the selected profile for named profiles", () => {
+    expect(getHirotmLauncherSetupCommand("work")).toBe(
+      "hirotaskmanager --profile work",
+    );
+  });
+});

package/src/cli/bootstrap/program.ts CHANGED Viewed

@@ -8,8 +8,56 @@ import { registerStatusCommands } from "../commands/statuses";
 import { registerTaskCommands } from "../commands/tasks";
 import { registerTrashCommands } from "../commands/trash";
 import { createDefaultCliContext } from "../handlers/context";
+import { hasCliConfigFile, resolveProfileName, resolveRuntimeKind } from "../lib/config";
 import { syncCliOutputFormatFromGlobals } from "../lib/cliFormat";
-import { exitWithError, resetCliOutputFormat } from "../lib/output";
+import { CliError, exitWithError, resetCliOutputFormat } from "../lib/output";
+import { CLI_ERR } from "../types/errors";
+export function shouldRequireLauncherSetupForHirotm(options: {
+  runtimeKind: "installed" | "dev";
+  hasInstalledProfileConfig: boolean;
+}): boolean {
+  return (
+    options.runtimeKind === "installed" &&
+    options.hasInstalledProfileConfig === false
+  );
+}
+export function getHirotmLauncherSetupCommand(profileName: string): string {
+  return profileName === "default"
+    ? "hirotaskmanager"
+    : `hirotaskmanager --profile ${profileName}`;
+}
+function ensureInstalledProfileIsReadyForHirotm(): void {
+  const runtimeKind = resolveRuntimeKind();
+  const profileName = resolveProfileName({ kind: "installed" });
+  const hasInstalledProfileConfig = hasCliConfigFile({
+    profile: profileName,
+    kind: "installed",
+  });
+  if (
+    !shouldRequireLauncherSetupForHirotm({
+      runtimeKind,
+      hasInstalledProfileConfig,
+    })
+  ) {
+    return;
+  }
+  const setupCommand = getHirotmLauncherSetupCommand(profileName);
+  // Package managers can skip lifecycle scripts, so actionable `hirotm`
+  // commands must direct users back to the launcher for first-run setup.
+  throw new CliError(
+    `No installed TaskManager profile found for "${profileName}". Run \`${setupCommand}\` first to create and configure this profile.`,
+    2,
+    {
+      code: CLI_ERR.missingRequired,
+      profile: profileName,
+      hint: `Run \`${setupCommand}\` first.`,
+    },
+  );
+}
 /**
  * Build the hirotm Commander program.
@@ -45,6 +93,7 @@ export function createHirotmProgram(): Command {
       quiet?: boolean;
     };
     syncCliOutputFormatFromGlobals(opts);
+    ensureInstalledProfileIsReadyForHirotm();
   });
   const ctx = createDefaultCliContext();

package/src/cli/commands/query.ts CHANGED Viewed

@@ -1,56 +1,56 @@
-import { Command } from "commander";
-import type { CliContext } from "../types/context";
-import { handleSearch } from "../handlers/search";
-import {
-  addClientNameOption,
-  CLI_FIELDS_OPTION_DESC,
-  cliAction,
-} from "../lib/command-helpers";
-import { CLI_DEFAULTS } from "../lib/constants";
-export function registerQueryCommands(
-  program: Command,
-  ctx: CliContext,
-): void {
-  const query = program
-    .command("query")
-    .description("Read-only queries across boards (search, etc.)");
-  addClientNameOption(
-    query
-      .command("search")
-      .description(
-        "Search tasks (title, body, list name, group & status labels) via FTS5",
-      )
-      .argument("<query...>", "Search query (quote phrases with spaces)")
-      .option("--board <id-or-slug>", "Limit results to one board")
-      .option(
-        "--limit <n>",
-        `Page size (default ${CLI_DEFAULTS.DEFAULT_SEARCH_LIMIT}, max ${CLI_DEFAULTS.MAX_PAGE_LIMIT})`,
-      )
-      .option("--offset <n>", "Skip this many hits (default 0)")
-      .option(
-        "--page-all",
-        "Fetch every page at the current --limit and merge into one result set",
-      )
-      .option(
-        "--no-prefix",
-        "Do not add * to the last token (exact token only). Default matches prefixes (drag finds dragging); this flag does not",
-      )
-      .option("--fields <keys>", CLI_FIELDS_OPTION_DESC),
-  ).action(
-    cliAction(
-      (
-        queryParts: string[],
-        options: {
-          board?: string;
-          limit?: string;
-          offset?: string;
-          pageAll?: boolean;
-          noPrefix?: boolean;
-          fields?: string;
-        },
-      ) => handleSearch(ctx, queryParts, options),
-    ),
-  );
-}
+import { Command } from "commander";
+import type { CliContext } from "../types/context";
+import { handleSearch } from "../handlers/search";
+import {
+  addClientNameOption,
+  CLI_FIELDS_OPTION_DESC,
+  cliAction,
+} from "../lib/command-helpers";
+import { CLI_DEFAULTS } from "../lib/constants";
+export function registerQueryCommands(
+  program: Command,
+  ctx: CliContext,
+): void {
+  const query = program
+    .command("query")
+    .description("Read-only queries across boards (search, etc.)");
+  addClientNameOption(
+    query
+      .command("search")
+      .description(
+        "Search tasks (title, body, list name, group & status labels) via FTS5",
+      )
+      .argument("<query...>", "Search query (quote phrases with spaces)")
+      .option("--board <id-or-slug>", "Limit results to one board")
+      .option(
+        "--limit <n>",
+        `Page size (default ${CLI_DEFAULTS.DEFAULT_SEARCH_LIMIT}, max ${CLI_DEFAULTS.MAX_PAGE_LIMIT})`,
+      )
+      .option("--offset <n>", "Skip this many hits (default 0)")
+      .option(
+        "--page-all",
+        "Fetch every page at the current --limit and merge into one result set",
+      )
+      .option(
+        "--no-prefix",
+        "Do not add * to the last token (exact token only). Default matches prefixes (drag finds dragging); this flag does not",
+      )
+      .option("--fields <keys>", CLI_FIELDS_OPTION_DESC),
+  ).action(
+    cliAction(
+      (
+        queryParts: string[],
+        options: {
+          board?: string;
+          limit?: string;
+          offset?: string;
+          pageAll?: boolean;
+          noPrefix?: boolean;
+          fields?: string;
+        },
+      ) => handleSearch(ctx, queryParts, options),
+    ),
+  );
+}

package/src/cli/commands/releases.ts CHANGED Viewed

@@ -4,6 +4,7 @@ import {
   handleReleasesAdd,
   handleReleasesDelete,
   handleReleasesList,
+  handleReleasesSetDefault,
   handleReleasesShow,
   handleReleasesUpdate,
 } from "../handlers/releases";
@@ -84,6 +85,27 @@ export function registerReleaseCommands(
     }) => handleReleasesAdd(ctx, options)),
   );
+  addClientNameOption(
+    releasesCommand
+      .command("set-default")
+      .description(
+        "Set or clear the board default release (PATCH board; requires manageStructure)",
+      )
+      .requiredOption("--board <id-or-slug>", "Board id or slug")
+      .option("--clear", "Clear the board default release")
+      .argument(
+        "[release-id]",
+        "Numeric release id to use as default (omit when using --clear)",
+      ),
+  ).action(
+    cliAction(
+      (
+        releaseId: string | undefined,
+        options: { board: string; clear?: boolean },
+      ) => handleReleasesSetDefault(ctx, releaseId, options),
+    ),
+  );
   addClientNameOption(
     releasesCommand
       .command("update")