@quire-io/quire-cli 0.1.0

package/dist/util/recurrence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurrence.js","sourceRoot":"","sources":["../../src/util/recurrence.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAS/C,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,MAAM,OAAO,GACX,KAAK,CAAC,cAAc,KAAK,SAAS;QAClC,KAAK,CAAC,kBAAkB,KAAK,SAAS;QACtC,KAAK,CAAC,mBAAmB,KAAK,SAAS;QACvC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC;IACtC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC;IACjD,IAAI,CAAC,IAAI,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,eAAe,CACvB,+FAA+F,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,cAAc,IAAI,EAAE,GAAG,CAC9J,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,IAAI,eAAe,CAAC,8EAA8E,CAAC,CAAC;IAC5G,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,eAAe,CAAC,0DAA0D,KAAK,CAAC,kBAAkB,GAAG,CAAC,CAAC;IACnH,CAAC;IAED,MAAM,UAAU,GAAoB;QAClC,IAAI,EAAE,IAA+B;QACrC,QAAQ;KACT,CAAC;IAEF,IAAI,KAAK,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,mBAAmB;aACnC,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,eAAe,CAAC,sEAAsE,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAChI,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,eAAe,CAAC,qEAAqE,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC;YAC/H,CAAC;QACH,CAAC;QACD,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,CAAC;IAED,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC,eAAe,CAAC;IAC3C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/util/retry-after.js

@@ -0,0 +1,56 @@
+/**
+ * Retry-once-on-429 helper. Wraps any async function: on a Quire 429
+ * "rate limited" error, parses the retry-after value from the error
+ * message (set by `@quire-io/api-client`'s `formatQuireError`), waits,
+ * and retries one time. Above the cap (default 60s) or when the wait
+ * value is unparseable, throws a `CliError` with exit code 2.
+ *
+ * 429 means the server did no work, so retrying is always idempotent —
+ * the wrapped function can be a single GET, a single write, or a
+ * multi-step action; either way replaying it is safe.
+ *
+ * Implementation note: the api-client throws a plain `Error` for 4xx
+ * responses, encoding the retry-after value into the message text. We
+ * detect 429s by message-prefix and parse the wait value out. If the
+ * api-client ever exposes a typed `QuireRateLimitedError` we'd switch
+ * to that — but for now message-matching is the only API surface.
+ */
+import { CliError, ExitCode } from "../errors.js";
+const DEFAULT_CAP_SEC = 60;
+const RATE_LIMITED_PREFIX = "Quire API error 429";
+// Matches "retry after 30s" / "retry after 1m 30s" / "retry after 2m"
+const RETRY_AFTER_PATTERN = /retry after (?:(\d+)m\s*)?(\d+)?s?/i;
+function parseRetryAfterSec(message) {
+    const m = RETRY_AFTER_PATTERN.exec(message);
+    if (!m)
+        return null;
+    const minutes = m[1] ? Number.parseInt(m[1], 10) : 0;
+    const seconds = m[2] ? Number.parseInt(m[2], 10) : 0;
+    const total = minutes * 60 + seconds;
+    return total > 0 ? total : null;
+}
+function isRateLimited(err) {
+    return err instanceof Error && err.message.startsWith(RATE_LIMITED_PREFIX);
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export async function withRetryOn429(fn, opts = {}) {
+    const cap = opts.capSec ?? DEFAULT_CAP_SEC;
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (!isRateLimited(err))
+            throw err;
+        const waitSec = parseRetryAfterSec(err.message);
+        if (waitSec === null) {
+            throw new CliError("Quire API rate limited; retry in 60s+ (precise wait time unavailable)", ExitCode.ApiError);
+        }
+        if (waitSec > cap) {
+            throw new CliError(`Quire API rate limited; retry in ${waitSec}s`, ExitCode.ApiError);
+        }
+        opts.onRetry?.(waitSec);
+        await sleep(waitSec * 1000);
+        return await fn();
+    }
+}
+//# sourceMappingURL=retry-after.js.map

package/dist/util/retry-after.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-after.js","sourceRoot":"","sources":["../../src/util/retry-after.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAClD,sEAAsE;AACtE,MAAM,mBAAmB,GAAG,qCAAqC,CAAC;AAElE,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,GAAG,EAAE,GAAG,OAAO,CAAC;IACrC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,SAAS,aAAa,CAAC,GAAY;IACjC,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAoB,EACpB,OAAiE,EAAE;IAEnE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;QACnC,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,QAAQ,CAChB,uEAAuE,EACvE,QAAQ,CAAC,QAAQ,CAClB,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;YAClB,MAAM,IAAI,QAAQ,CAChB,oCAAoC,OAAO,GAAG,EAC9C,QAAQ,CAAC,QAAQ,CAClB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;QACxB,MAAM,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAC5B,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/util/task-id.js

@@ -0,0 +1,34 @@
+import { looksLikeOid, parseQuireUrl } from "@quire-io/api-client";
+import { ValidationError } from "../errors.js";
+/**
+ * Resolve a user-supplied task identifier into a Quire task OID. Accepted
+ * forms:
+ *   - bare OID (passes `looksLikeOid`)
+ *   - `project-slug/#408` or `project-slug/408`
+ *   - full Quire task URL (parsed via `parseQuireUrl`)
+ *
+ * Bare numeric IDs like `#408` aren't accepted because they're ambiguous
+ * — they need a project context to disambiguate. Surfaced as a clean
+ * `ValidationError` so the caller exits 3 with a helpful message.
+ */
+export async function resolveTaskOid(client, input) {
+    if (looksLikeOid(input))
+        return input;
+    if (/^https?:\/\//i.test(input)) {
+        const parsed = parseQuireUrl(input);
+        if (parsed?.kind === "task") {
+            const task = await client.getTaskByProjectAndId(parsed.projectId, parsed.taskId);
+            return task.oid;
+        }
+        throw new ValidationError(`URL is not a Quire task: "${input}"`);
+    }
+    const slugMatch = input.match(/^([^/]+)\/#?(\d+)$/);
+    if (slugMatch) {
+        const projectId = slugMatch[1];
+        const taskId = slugMatch[2];
+        const task = await client.getTaskByProjectAndId(projectId, taskId);
+        return task.oid;
+    }
+    throw new ValidationError(`Cannot resolve task: "${input}". Expected a task OID, "project-slug/#408", or a full Quire task URL.`);
+}
+//# sourceMappingURL=task-id.js.map

package/dist/util/task-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id.js","sourceRoot":"","sources":["../../src/util/task-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAmB,EAAE,KAAa;IACrE,IAAI,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,MAAM,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YACjF,OAAO,IAAI,CAAC,GAAG,CAAC;QAClB,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,6BAA6B,KAAK,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAW,CAAC;QACzC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAW,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,eAAe,CACvB,yBAAyB,KAAK,wEAAwE,CACvG,CAAC;AACJ,CAAC"}

package/dist/util/text-input.js

@@ -0,0 +1,26 @@
+import { readFileSync } from "node:fs";
+/**
+ * Resolve a `--text`-style flag value into actual text. Three forms:
+ *
+ *   - `-`            → read all of stdin until EOF
+ *   - `@/path/file`  → read the file at that path
+ *   - anything else  → use as a literal string
+ *
+ * Mirrors how `gh` and `kubectl` handle text-input flags so users can
+ * `cat long.md | quire comment add … --text -` or
+ * `quire comment add … --text @notes.md` for long descriptions.
+ */
+export async function resolveTextInput(value) {
+    if (value === "-") {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        return Buffer.concat(chunks).toString("utf8");
+    }
+    if (value.startsWith("@")) {
+        return readFileSync(value.slice(1), "utf8");
+    }
+    return value;
+}
+//# sourceMappingURL=text-input.js.map

package/dist/util/text-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input.js","sourceRoot":"","sources":["../../src/util/text-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa;IAClD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/version.js

@@ -0,0 +1,19 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+// In a Node SEA / esbuild bundle, `process.env.QUIRE_CLI_VERSION` is
+// substituted as a string literal at build time (see scripts/build-sea.mjs).
+// In dev runs via `tsx` or `node dist/cli.js`, the env var is undefined, so
+// we fall back to reading package.json next to the running file.
+const BUILD_TIME_VERSION = process.env.QUIRE_CLI_VERSION;
+export function readVersion() {
+    if (BUILD_TIME_VERSION !== undefined && BUILD_TIME_VERSION !== "") {
+        return BUILD_TIME_VERSION;
+    }
+    // package.json sits one level up from dist/cli.js (built) or src/cli.ts (dev via tsx).
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(here, "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return pkg.version;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,qEAAqE;AACrE,6EAA6E;AAC7E,4EAA4E;AAC5E,iEAAiE;AACjE,MAAM,kBAAkB,GAAuB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAE7E,MAAM,UAAU,WAAW;IACzB,IAAI,kBAAkB,KAAK,SAAS,IAAI,kBAAkB,KAAK,EAAE,EAAE,CAAC;QAClE,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,uFAAuF;IACvF,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAwB,CAAC;IAC7E,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@quire-io/quire-cli",
+  "version": "0.1.0",
+  "description": "Command-line interface for the Quire API.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "quire": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGES.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:live": "vitest run --config vitest.live.config.ts",
+    "package": "node scripts/build-sea.mjs",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "keywords": [
+    "quire",
+    "cli",
+    "task-management",
+    "productivity",
+    "api"
+  ],
+  "license": "ISC",
+  "author": "Potix Corporation",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quire-io/quire-cli.git"
+  },
+  "homepage": "https://github.com/quire-io/quire-cli#readme",
+  "bugs": {
+    "url": "https://github.com/quire-io/quire-cli/issues"
+  },
+  "dependencies": {
+    "@quire-io/api-client": "^0.1.3",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "esbuild": "^0.28.0",
+    "postject": "^1.0.0-alpha.6",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.5"
+  }
+}