@quire-io/quire-cli 0.1.6 → 1.0.0

package/dist/program.js

@@ -0,0 +1,228 @@
+/**
+ * Builds the whole `quire` command tree.
+ *
+ * Kept separate from cli.ts — which is the executable entry point and runs
+ * on import — so that tooling can construct the tree without invoking the
+ * CLI. scripts/gen-coverage.ts walks the object this returns, which is what
+ * keeps COVERAGE.md honest: the doc is generated from the same tree the CLI
+ * actually registers, not a second hand-written list of it.
+ */
+import { Command } from "commander";
+import { registerChatCommand } from "./commands/chat.js";
+import { registerColorsCommand } from "./commands/colors.js";
+import { registerCommentCommand } from "./commands/comment.js";
+import { registerDashboardCommand } from "./commands/dashboard.js";
+import { registerDocCommand } from "./commands/doc.js";
+import { registerInsightCommand } from "./commands/insight.js";
+import { registerLoginCommand } from "./commands/login.js";
+import { registerLogoutCommand } from "./commands/logout.js";
+import { registerMineCommand } from "./commands/mine.js";
+import { registerNotifyCommand } from "./commands/notify.js";
+import { registerOrgCommand } from "./commands/org.js";
+import { registerPartnerCommand } from "./commands/partner.js";
+import { registerProjectCommand } from "./commands/project.js";
+import { registerReminderCommand } from "./commands/reminder.js";
+import { registerResolveCommand } from "./commands/resolve.js";
+import { registerStatusCommand } from "./commands/status.js";
+import { registerSublistCommand } from "./commands/sublist.js";
+import { registerTagCommand } from "./commands/tag.js";
+import { registerTaskCommand } from "./commands/task.js";
+import { registerUndoCommand } from "./commands/undo.js";
+import { registerUserCommand } from "./commands/user.js";
+import { registerWhoamiCommand } from "./commands/whoami.js";
+import { readVersion } from "./version.js";
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name("quire")
+        .description("Command-line interface for the Quire API.")
+        .version(readVersion(), "-v, --version", "Print the CLI version")
+        .option("--verbose", "Enable verbose (debug) logging on stderr")
+        .option("--json", "Emit raw API JSON (no human formatting)")
+        .option("-q, --quiet", "Print only IDs (one per line) — designed for xargs pipelines")
+        .option("--color-mode <mode>", "Color output mode: always|never|auto", "auto")
+        .option("--profile <name>", "Use a named credential profile (default: $QUIRE_PROFILE or 'default')")
+        .option("--yes", "Auto-confirm destructive prompts (required for non-interactive mutating commands)")
+        .option("--no-truncate", "Disable per-cell truncation in human-readable tables");
+    registerLoginCommand(program);
+    registerLogoutCommand(program);
+    registerWhoamiCommand(program);
+    registerUserCommand(program);
+    registerOrgCommand(program);
+    registerProjectCommand(program);
+    registerPartnerCommand(program);
+    registerTaskCommand(program);
+    registerMineCommand(program);
+    registerTagCommand(program);
+    registerSublistCommand(program);
+    registerStatusCommand(program);
+    registerCommentCommand(program);
+    registerChatCommand(program);
+    registerDocCommand(program);
+    registerInsightCommand(program);
+    registerDashboardCommand(program);
+    registerReminderCommand(program);
+    registerResolveCommand(program);
+    registerColorsCommand(program);
+    registerNotifyCommand(program);
+    registerUndoCommand(program);
+    program.addHelpText("after", `
+Auth:
+  quire login                  Sign in via OAuth (loopback + PKCE)
+  quire logout                 Remove local credentials (server-side token stays valid; revoke at quire.io/apps)
+  quire whoami                 Show the signed-in user
+  quire user get <oid>         Show one user by OID
+
+Orgs / projects:
+  quire org list               List your organizations
+  quire org get <id>           Show one organization
+  quire org update <id>        Update name / description / followers (--follower / --add-follower / --remove-follower)
+  quire org limit <id>         Show API rate-limit usage for an organization
+  quire project list           List projects you can see (or --org <id> to scope)
+  quire project get <id>       Show one project
+  quire project update <id>    Update name / description / dates / archive / public / followers (--follower / --add-follower / --remove-follower)
+  quire project members <id>   List a project's members
+  quire project export <id>    Export the project as CSV (default) or JSON (--format json [--output file])
+
+Tasks (read):
+  quire task list <project>    List tasks in a project
+  quire task get <id>          Show task details (id = OID, slug/#N, or URL)
+  quire task tree <id>         Render the recursive subtree (default depth 3)
+  quire task search <query>    Search tasks; scope with --project / --org / --folder; filter with --assignee / --follower / --tag
+  quire task subtasks <id>     List a task's direct subtasks
+  quire task comments <id>     List a task's comments
+  quire mine                   List tasks assigned to me; scope with --project / --inbox / --org / --all-orgs
+
+Tasks (write):
+  quire task create <project> --name "..."   Create a new task (--parent / --sibling+--position to nest; --assignee / --follower)
+  quire task subtask <parent> --name "..."   Shorthand for "task create --parent"
+  quire task update <id>                     Update fields: --name / --status / --priority / --add-tag / etc.
+                                             Followers: --follower (full replace) / --add-follower / --remove-follower
+                                             Follower values: OID, ID, email, 'me', 'app', or 'inherit' (the parent task's followers)
+  quire task complete <id> / uncomplete <id> Toggle status to 100 / 0
+  quire task move <id> --to <id|root>        Re-parent within the same project
+  quire task transfer <id> --to <project>    Cross-project transfer (--keep-tags / --keep-status / --invite)
+  quire task dates <id> --start ... --due ... Set / clear dates (pass 'null' to clear)
+  quire task peekaboo <id> [--reshow-at ISO | --show] Hide or un-hide a task
+  quire task delete <id>                     Delete a task (prompts unless --yes)
+  quire task undo-remove <oid>               Restore a deleted task
+  quire task attach <id> <file>              Attach a file to a task ('-' = stdin; --filename / --content-type optional)
+
+Tasks (bulk):
+  quire task bulk-create <project>     --from-file tasks.json   Create up to 300 tasks atomically
+  quire task bulk-subtasks <parent>    --from-file tasks.json   Create up to 300 subtasks under one parent
+  quire task bulk-update <project>     --from-file updates.json Update many tasks atomically (each item needs an oid)
+  quire task bulk-delete <project>     --from-file ids.txt      Delete many (prompts unless --yes); refs one per line or JSON array
+  quire task bulk-move <project>       --to <id|root> --from-file ids.txt
+  quire task bulk-transfer <project>   --to <project> --from-file ids.txt
+  quire task bulk-approve <project>    --state request|approve|reject|change --from-file ids.txt
+
+Tasks (approval / timelogs / recurrence):
+  quire task approve <id> --state ...           Set a task's approval state
+                                                Add --comment <text|-|@file> [--comment-pinned / --comment-as-user] to post a companion comment
+  quire task revoke-approval <id>               Revoke any approval state
+  quire task timelog add <id>     --start --end [--user / --billable / --note]
+  quire task timelog update <id>  --start --end [--new-start / --new-end / --note / ...]
+  quire task timelog remove <id>  --start --end                                (prompts unless --yes)
+  --recurrence-freq / --recurrence-interval / --recurrence-byweekday / --recurrence-until
+                                                Add / clear recurrence on "task create" / "task subtask" / "task update"
+
+Project metadata (approval categories):
+  quire project approval-category add <project>          --id ... --name ... [--claimer / --approver]
+  quire project approval-category update <project> <id>  [--name / --claimer / --approver / --claimers-anyone / --claimers-admins-only / ...]
+  quire project approval-category remove <project> <id>  (prompts unless --yes)
+
+Project metadata (custom-field definitions):
+  quire project field add <project>          --name --type [--hidden / --private / --percent / --multiple / --clear-on-dup / --extra k=v]
+  quire project field update <project> <name>  [--type / --hidden / --private / --percent / --multiple / --extra k=v]
+  quire project field rename <project> <name> --new-name ...
+  quire project field move <project> <name>   [--before <name>] [--to-end]
+  quire project field remove <project> <name> (prompts unless --yes)
+  quire insight field add <insight-oid>       --name --type [...]   (formula / lookup only)
+  quire insight field {update / rename / move / remove}              (same flag shape as project field)
+
+Project metadata (read):
+  quire tag list <project>      List tags defined on a project (also: 'tag get <oid>')
+  quire sublist list <project>  List sublists on a project (also: 'sublist get <oid>')
+  quire status list <project>   List custom statuses on a project (also: 'status get <project> <value>')
+  quire partner list <project>  List partner orgs (external teams) on a project
+  quire partner get <oid>       Show one partner organization
+
+Project metadata (write):
+  quire tag create <project>      Create a tag (--name / --color)
+  quire tag update <oid>          Update tag --name / --color
+  quire tag delete <oid>          Delete a tag (prompts unless --yes)
+  quire sublist create <project>      Create a sublist (--name / --description / --member / --members-admins-only)
+  quire sublist update <oid>          Update sublist (--name / --description / --start / --due / --archive / --unarchive)
+  quire sublist add-task <oid> <task> Add a task to a sublist
+  quire sublist remove-task <oid> <task>  Remove a task from a sublist
+  quire sublist delete <oid>          Delete a sublist (prompts unless --yes)
+  quire sublist undo-remove <oid>     Restore a deleted sublist
+  quire status create <project>   Create a status (--name / --value / --color)
+  quire status update <project> <value>  Update a status (--name / --color / --new-value)
+  quire status delete <project> <value>  Delete a status (prompts unless --yes)
+
+Comments / chats / docs / insights / dashboards (read):
+  quire comment list <task>    List comments on a task (alias for "quire task comments"; also: 'comment get <oid>')
+  quire chat list <project>    List chats / chat get <id> / chat comments <id>
+  quire doc list <project>     List documents / doc get <id>
+  quire insight list <project> List insights / insight get <id>
+  quire dashboard list <owner> List dashboards / dashboard get <id> ([--owner-type project|organization|folder|smart-folder])
+
+Comments (write):
+  quire comment add <task> --text "..."   Add a comment ('-' = stdin, '@file' = read file)
+  quire comment update <oid>              Update --text and/or --pin / --unpin
+  quire comment attach <oid> <file>       Attach a file to a comment ('-' = stdin; --filename / --content-type optional)
+  quire comment delete <oid>              Delete a comment (prompts unless --yes)
+
+Chats / docs / insights / dashboards (write):
+  quire chat create <project>             --name [--description / --partner / --follower / --member / --members-admins-only]
+  quire chat update <oid>                 [--name / --description / --archive / --unarchive / --follower / --add-follower / --remove-follower]
+  quire chat delete <oid>                 (prompts unless --yes)
+  quire chat undo-remove <oid>
+  quire chat comment add <chat-id>        --text [--pin]
+  quire doc create <project>              --name [--description / --follower / --member / --members-admins-only]
+  quire doc update <oid>                  [--name / --description / --archive / --unarchive / --follower / --add-follower / --remove-follower]
+  quire doc delete <oid>                  (prompts unless --yes)
+  quire doc undo-remove <oid>
+  quire insight create <project>          --name [--id / --description / --icon-color / --image / --member / --members-admins-only]
+  quire insight update <oid>              [--name / --description / --icon-color / --image / --archive / --unarchive]
+  quire insight delete <oid>              (prompts unless --yes)
+  quire insight undo-remove <oid>
+  quire insight run <oid>                 Run an insight and print the aggregated rows ([--group-by member|section] [--status active|completed|all])
+  quire dashboard create <owner>          --name [--owner-type / --id / --description / --icon-color / --image / --partner / --start / --due / --member]
+  quire dashboard update <oid>            [--id / --name / --description / --icon-color / --image / --start / --due / --archive / --unarchive] ('null' clears a date)
+  quire dashboard delete <oid>            (prompts unless --yes)
+  quire dashboard undo-remove <oid>
+
+Reminders:
+  quire reminder list <owner>    List reminders ([--owner-type project|organization|folder|smart-folder|task]; '-' = your Inbox)
+                                 A project's list includes its tasks' reminders; ordered by OID, not fire time
+  quire reminder get <oid>       Show one reminder
+  quire reminder create <owner>  [--owner-type / --when / --lead / --name / --partner / --member / --recurrence-*]
+                                 --when is required unless the task already has a start or due date (that supplies the fire time)
+                                 --lead '<n>m' | '<n>d' | '<n>d@HH:mm', repeatable (max 30); omit for one notification at the fire time
+  quire reminder update <oid>    [--when / --lead / --name / --clear-recurrence / --recurrence-*] ('null' clears --when / --name)
+                                 Members and partner are create-only — recreate the reminder to change who can see it
+  quire reminder delete <oid>    Delete permanently — no trash, no undo (prompts unless --yes)
+
+Record visibility (create-only):
+  --member <user>                Restrict a sublist / doc / chat / insight / dashboard / reminder to these users; repeat for multiple
+  --members-admins-only          Restrict it to the owner's admins
+                                 Omit both for every member of the owner. Cannot be changed after creation.
+
+Generic undo:
+  quire undo <kind> <oid>                 kind = task | chat | comment | dashboard | document | insight | sublist
+
+URL resolver:
+  quire resolve <url>          Paste any Quire URL, get the typed resource back
+
+Notifications:
+  quire notify --message ...   Send an in-app notification to yourself ('-' / '@file' for stdin / file)
+
+Reference:
+  quire colors                 List Quire's 48-slot palette (code, hex, name)
+`);
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"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"}

package/dist/util/member-flags.js

@@ -0,0 +1,40 @@
+import { ValidationError } from "../errors.js";
+const append = (val, prev) => [...(prev ?? []), val];
+/** Adds the two shared member options to a `create` command. */
+export function addMemberOptions(cmd) {
+    return cmd
+        .option("--member <user>", "Restrict visibility to this user (OID, ID, email, or 'me'); repeat for multiple. Omit for every member of the owner. Cannot be changed after creation.", append, [])
+        .option("--members-admins-only", "Restrict visibility to the owner's admins (empty member list). Cannot be changed after creation.");
+}
+/**
+ * Resolve the flags to the wire value, or `undefined` when the field should be
+ * left off the request entirely. Unlike `project approval-category add` — where
+ * `--claimers-admins-only` silently overrides `--claimer` — combining the two
+ * is an error here, because the result is immutable once created.
+ */
+export function resolveMembers(flags) {
+    const hasList = (flags.member?.length ?? 0) > 0;
+    if (flags.membersAdminsOnly === true) {
+        if (hasList) {
+            throw new ValidationError("Cannot combine --member with --members-admins-only.");
+        }
+        return [];
+    }
+    return hasList ? flags.member : undefined;
+}
+/**
+ * Render a record's `members` for `… get` output. The server returns all three
+ * states explicitly, so `null` (everyone) and `[]` (admins only) are told
+ * apart the same way `project approval-category` renders claimers / approvers.
+ *
+ * As of the Sep 21 2026 server release these are user objects; older servers
+ * sent bare OID strings, so both shapes are accepted.
+ */
+export function formatMembers(members) {
+    if (members === null || members === undefined)
+        return "(everyone)";
+    if (members.length === 0)
+        return "(admins only)";
+    return members.map((m) => (typeof m === "string" ? m : (m.name ?? m.oid))).join(", ");
+}
+//# sourceMappingURL=member-flags.js.map

package/dist/util/member-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-flags.js","sourceRoot":"","sources":["../../src/util/member-flags.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,IAA0B,EAAY,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;AAO7F,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,GAAG;SACP,MAAM,CACL,iBAAiB,EACjB,wJAAwJ,EACxJ,MAAM,EACN,EAAc,CACf;SACA,MAAM,CAAC,uBAAuB,EAAE,kGAAkG,CAAC,CAAC;AACzI,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,eAAe,CAAC,qDAAqD,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,OAAuE;IACnG,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC;IACjD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxF,CAAC"}

package/dist/util/reminder-lead.js

@@ -0,0 +1,60 @@
+import { ValidationError } from "../errors.js";
+/** Quire caps a lead at 10,000 days out, and a reminder at 30 leads. */
+const MAX_DAYS = 10_000;
+const MAX_MINUTES = MAX_DAYS * 24 * 60;
+const MAX_LEADS = 30;
+const LEAD_RE = /^(\d+)(m|d)?(?:@(\d{1,2}):(\d{2}))?$/;
+function parseLead(spec) {
+    const m = LEAD_RE.exec(spec.trim());
+    if (!m) {
+        throw new ValidationError(`Invalid --lead "${spec}". Expected <n>m (minutes), <n>d (days), or <n>d@HH:mm — e.g. '30m', '2d', '1d@09:00'.`);
+    }
+    const value = Number.parseInt(m[1], 10);
+    const unit = m[2] ?? "m";
+    const hh = m[3];
+    const mm = m[4];
+    if (hh !== undefined && unit !== "d") {
+        throw new ValidationError(`Invalid --lead "${spec}". The @HH:mm suffix is only valid on a day lead — e.g. '1d@09:00'.`);
+    }
+    if (unit === "d") {
+        if (value > MAX_DAYS) {
+            throw new ValidationError(`--lead "${spec}" exceeds Quire's maximum of ${MAX_DAYS} days.`);
+        }
+        const lead = { days: value };
+        if (hh !== undefined && mm !== undefined) {
+            const hours = Number.parseInt(hh, 10);
+            const mins = Number.parseInt(mm, 10);
+            if (hours > 23 || mins > 59) {
+                throw new ValidationError(`Invalid --lead "${spec}". The time must be 24-hour HH:mm, 00:00-23:59.`);
+            }
+            lead.at = `${String(hours).padStart(2, "0")}:${mm}`;
+        }
+        return lead;
+    }
+    if (value > MAX_MINUTES) {
+        throw new ValidationError(`--lead "${spec}" exceeds Quire's maximum of ${MAX_DAYS} days.`);
+    }
+    return { minutes: value };
+}
+/**
+ * Parse every `--lead` value. Returns `undefined` when the flag was not
+ * passed, so the caller can omit the field and let Quire apply its default of
+ * one notification at the fire time.
+ */
+export function parseLeads(specs) {
+    if (specs === undefined || specs.length === 0)
+        return undefined;
+    if (specs.length > MAX_LEADS) {
+        throw new ValidationError(`A reminder carries at most ${MAX_LEADS} leads; got ${specs.length}.`);
+    }
+    return specs.map(parseLead);
+}
+/** Render a reminder's leads back in the `--lead` grammar, for `… get` output. */
+export function formatLeads(leads) {
+    if (leads === undefined || leads.length === 0)
+        return undefined;
+    return leads
+        .map((l) => (l.days !== undefined ? `${l.days}d${l.at !== undefined ? `@${l.at}` : ""}` : `${l.minutes ?? 0}m`))
+        .join(", ");
+}
+//# sourceMappingURL=reminder-lead.js.map

package/dist/util/reminder-lead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-lead.js","sourceRoot":"","sources":["../../src/util/reminder-lead.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quire-io/quire-cli",
-  "version": "0.1.6",
+  "version": "1.0.0",
   "description": "Command-line interface for the Quire API.",
   "type": "module",
   "publishConfig": {
@@ -24,6 +24,8 @@
     "build": "tsc",
     "start": "node dist/cli.js",
     "typecheck": "tsc --noEmit",
+    "gen-coverage": "tsx scripts/gen-coverage.ts",
+    "check-coverage": "tsx scripts/gen-coverage.ts && git diff --exit-code COVERAGE.md",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:live": "vitest run --config vitest.live.config.ts",
@@ -48,7 +50,7 @@
     "url": "https://github.com/quire-io/quire-cli/issues"
   },
   "dependencies": {
-    "@quire-io/api-client": "^0.1.11",
+    "@quire-io/api-client": "^1.0.0",
     "commander": "^12.1.0"
   },
   "devDependencies": {