orbitmap 0.3.0 → 0.4.1

package/dist/id-resolve.js

@@ -0,0 +1,87 @@
+import { OrbitMapAPIError } from './errors.js';
+/**
+ * Prefixed display IDs (`TS-uw9yh5`, `IS-4k2p9q`, …) are what the CLI prints and therefore
+ * what users paste back in. This module is the single place that understands them.
+ *
+ * The Agent API is asymmetric about them: `/issues/{id}`, `/ideas/{id}`, `/intents/{id}` and
+ * `/missions/{id}` resolve a prefixed ID inline, server-side, but **tasks do not** — a task
+ * reference that is not a uuid has to go through `/tasks/by-number/{number}` first, with the
+ * `TS-` prefix stripped. Before this module the CLI patched that around in four copies of the
+ * same two helpers and simply omitted it in eight commands, so the same identifier worked in
+ * `orbitmap task` and 404'd in `orbitmap status`.
+ *
+ * Resolution lives in the adapter layer (see `resolveTaskRef` below and its callers in
+ * `adapters/cloud.ts`), not in the commands: per CLAUDE.md commands never talk to the network
+ * and never reimplement rules, and putting it there means a new task command gets prefixed-ID
+ * support for free instead of having to remember. `LocalAdapter` already resolves every task
+ * reference through `requireTaskFile`, so this brings cloud mode up to the same contract.
+ */
+/** Two-letter prefix → object type, as the Agent API assigns them. */
+export const OBJECT_PREFIXES = {
+    TS: 'task',
+    IS: 'issue',
+    ID: 'idea',
+    VB: 'vibe',
+    IN: 'intent',
+    MS: 'mission',
+};
+/**
+ * A prefixed display ID or a bare object code — i.e. anything that is NOT a uuid and has to
+ * be resolved by number. Six base-36 characters, optionally behind a two-letter prefix.
+ *
+ * This is the one shared predicate for the number-vs-uuid decision; a uuid is 36 characters
+ * with dashes and can never match, and a value that matches can never be a uuid, so the two
+ * paths are mutually exclusive by construction. Kept byte-identical to the four helper copies
+ * it replaces so no existing input changes meaning.
+ */
+export function isObjectNumber(id) {
+    return /^([A-Z]{2}-)?[a-z0-9]{6}$/.test(id.trim());
+}
+/** Canonical uuid check, for callers that need the positive form rather than {@link isObjectNumber}. */
+export function isUuid(id) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id.trim());
+}
+/**
+ * Drop the two-letter prefix from a display ID, leaving the bare object code. A value with no
+ * prefix (a bare code, or a uuid) is returned unchanged, so this is safe to call on anything.
+ */
+export function stripPrefix(id) {
+    return id.trim().replace(/^[A-Z]{2}-/, '');
+}
+/** The prefix of a display ID, or `undefined` when there is none. Never mangles the input. */
+export function objectPrefix(id) {
+    const match = id.trim().match(/^([A-Z]{2})-/);
+    const prefix = match?.[1];
+    return prefix && prefix in OBJECT_PREFIXES ? prefix : undefined;
+}
+/** Dig the task uuid out of a `/tasks/by-number/{n}` (or `/tasks/{id}`) response envelope. */
+function taskIdFromEnvelope(response) {
+    const data = response?.data;
+    const task = data?.task ?? data;
+    const id = task?.id;
+    return typeof id === 'string' && id.length > 0 ? id : undefined;
+}
+/**
+ * Turn any task reference — uuid, `TS-uw9yh5` or the bare code `uw9yh5` — into the uuid the
+ * task endpoints expect.
+ *
+ * A uuid costs **no extra request**: it is returned as-is, synchronously in effect, so the
+ * commands that already passed uuids keep their single round trip. Only a by-number reference
+ * pays for the `/tasks/by-number/{n}` lookup, which is the price of the API asymmetry this
+ * works around (see the module comment) and disappears if `/tasks/{id}` ever resolves
+ * prefixed IDs inline the way `/intents/{id}` already does.
+ */
+export async function resolveTaskRef(ref, lookup) {
+    const trimmed = ref.trim();
+    if (!isObjectNumber(trimmed))
+        return trimmed;
+    const response = await lookup.getTaskByNumber(stripPrefix(trimmed));
+    const id = taskIdFromEnvelope(response);
+    if (!id) {
+        // The lookup answered but without an id — a contract drift we must not paper over by
+        // sending the unresolved reference on and letting it 404 somewhere less obvious.
+        throw new OrbitMapAPIError(`Could not resolve task \`${trimmed}\` to an id — the API returned no task id for it.`, 'NOT_FOUND', 404);
+    }
+    return id;
+}
+//# sourceMappingURL=id-resolve.js.map

package/dist/id-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-resolve.js","sourceRoot":"","sources":["../src/id-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,SAAS;CACL,CAAC;AAIX;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,2BAA2B,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,MAAM,CAAC,EAAU;IAC/B,OAAO,iEAAiE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO,MAAM,IAAI,MAAM,IAAI,eAAe,CAAC,CAAC,CAAE,MAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC;AAOD,8FAA8F;AAC9F,SAAS,kBAAkB,CAAC,QAAiB;IAC3C,MAAM,IAAI,GAAI,QAA+B,EAAE,IAAI,CAAC;IACpD,MAAM,IAAI,GAAI,IAA2B,EAAE,IAAI,IAAI,IAAI,CAAC;IACxD,MAAM,EAAE,GAAI,IAAyB,EAAE,EAAE,CAAC;IAC1C,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,MAAwB;IAExB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE7C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,MAAM,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,qFAAqF;QACrF,iFAAiF;QACjF,MAAM,IAAI,gBAAgB,CACxB,4BAA4B,OAAO,mDAAmD,EACtF,WAAW,EACX,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}