@whatcha/cli 0.0.0-stage → 0.1.0

package/dist/lib/append-entry.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeEntry = writeEntry;
+const errors_1 = require("../errors");
+function existingEntryIdFrom(err) {
+    if (err.status !== 409 || err.code !== "VERSION_CONFLICT")
+        return null;
+    const details = err.details;
+    return typeof details?.existingEntryId === "string" ? details.existingEntryId : null;
+}
+function headerOf(entry) {
+    return {
+        title: entry.title,
+        mood: entry.mood,
+        location: entry.location,
+        tags: entry.tags,
+        coverMediaAssetId: entry.coverMediaAssetId,
+    };
+}
+/**
+ * What the stored body should read as after appending `text`, mirroring the
+ * API's own `appendedBody` (apps/api/src/modules/diaries/entries/
+ * entries-content.ts, merged to master in #1424): existing text, trimmed,
+ * then a blank line, then the new text -- or just the new text if there was
+ * none yet.
+ */
+function expectedAppendedBody(existingBody, text) {
+    const trimmed = existingBody.trimEnd();
+    return trimmed ? `${trimmed}\n\n${text}` : text;
+}
+/**
+ * The one thing this whole command exists to get right: add `text` to
+ * `diaryId`'s entry for `occurredAt`'s day without ever touching what
+ * somebody else already wrote there.
+ *
+ * Three paths, in order:
+ *
+ * 1. No entry exists yet for that day -- `POST /entries` creates it with
+ *    exactly `text` as its body. Nothing to append to, nothing at risk.
+ * 2. An entry exists (`POST` answers 409 with `details.existingEntryId`).
+ *    Read it (`GET /entries/{id}`) to get its current header fields --
+ *    title/mood/location/tags/cover are full-replace-on-save same as the
+ *    body (entries-content.ts's `contentToItems`), so sending `content`
+ *    without them would silently wipe whatever the other person set, even
+ *    though `appendBody` protects the body itself. Then `PATCH` with
+ *    `appendBody: true` and only the *new* text as `content.body` -- the
+ *    server appends it to whatever is currently stored, in the same
+ *    transaction that checks `expectedHeadCommitId`, so this is safe even
+ *    against a write that lands between our GET and our PATCH.
+ * 3. The PATCH in (2) answers 422 VALIDATION_ERROR citing `appendBody` as
+ *    an unrecognized key (ApiError#isUnrecognizedAppendBodyFlag) -- the
+ *    server does not have the #1422 fix. Build the appended body ourselves
+ *    from the text we just read in (2) and PATCH again without the flag,
+ *    still carrying `expectedHeadCommitId` so a concurrent write is caught
+ *    as a conflict rather than silently overwritten. This is the read
+ *    that "fall back to read-then-append" refers to; note it is the *same*
+ *    read as (2), not a second one -- appendBody is tried first precisely
+ *    so the common case does not pay for a read it does not need.
+ *
+ * Either way, nothing is ever PATCHed as a plain replacement of a body this
+ * function did not just read.
+ */
+async function writeEntry(client, diaryId, occurredAt, text) {
+    try {
+        const created = await client.post("/entries", {
+            diaryId,
+            occurredAt: occurredAt.toISOString(),
+            content: { body: text },
+        });
+        return { entryId: created.id, headCommitId: created.headCommitId, mode: "created", verified: null };
+    }
+    catch (err) {
+        if (!(err instanceof errors_1.ApiError))
+            throw err;
+        const existingEntryId = existingEntryIdFrom(err);
+        if (!existingEntryId)
+            throw err;
+        return appendToExisting(client, existingEntryId, text);
+    }
+}
+async function appendToExisting(client, entryId, text) {
+    const existing = await client.get(`/entries/${entryId}`);
+    const header = headerOf(existing);
+    try {
+        const saved = await client.patch(`/entries/${entryId}`, {
+            content: { body: text, ...header },
+            appendBody: true,
+            expectedHeadCommitId: existing.headCommitId,
+        });
+        const verified = await verifyAppend(client, entryId, existing.body, text);
+        return { entryId, headCommitId: saved.headCommitId, mode: "appended", verified };
+    }
+    catch (err) {
+        if (!(err instanceof errors_1.ApiError))
+            throw err;
+        if (err.status === 409)
+            throw concurrentWriteError(err);
+        if (!err.isUnrecognizedAppendBodyFlag())
+            throw err;
+        // Fallback: this server does not know appendBody. Merge client-side
+        // from the body we already read, and send the merged body as a plain
+        // replacement -- which is safe precisely because we just read what it
+        // is replacing.
+        const mergedBody = expectedAppendedBody(existing.body, text);
+        const saved = await client
+            .patch(`/entries/${entryId}`, {
+            content: { body: mergedBody, ...header },
+            expectedHeadCommitId: existing.headCommitId,
+        })
+            .catch((fallbackErr) => {
+            if (fallbackErr instanceof errors_1.ApiError && fallbackErr.status === 409)
+                throw concurrentWriteError(fallbackErr);
+            throw fallbackErr;
+        });
+        const verified = await verifyAppend(client, entryId, existing.body, text);
+        return { entryId, headCommitId: saved.headCommitId, mode: "appended-fallback", verified };
+    }
+}
+function concurrentWriteError(err) {
+    return new errors_1.CliUsageError("Someone else saved to this entry while whatcha was writing to it. Nothing was overwritten -- " +
+        `run \`whatcha write\` again to retry. (${err.message})`);
+}
+/**
+ * Defense in depth against the exact failure #1422 was about, for the one
+ * case none of the above can rule out: a server old enough that it neither
+ * knows `appendBody` NOR rejects the unrecognized key (STRICT_REQUEST_BODIES
+ * off, which is the API's own default -- apps/api/src/config/index.ts). Such
+ * a server answers 200 having silently replaced the body instead of
+ * appending, and there is no error to catch.
+ *
+ * So: read the entry back and check the stored body actually starts with
+ * what was there before. This cannot repair a loss it finds -- the PATCH
+ * already committed -- but it turns a silent data loss into a loud one, and
+ * `whatcha write --json` surfaces `verified: false` so an agent calling
+ * this does not mistake a corrupted write for a clean one.
+ */
+async function verifyAppend(client, entryId, bodyBeforeWrite, text) {
+    const after = await client.get(`/entries/${entryId}`);
+    return after.body === expectedAppendedBody(bodyBeforeWrite, text);
+}
+//# sourceMappingURL=append-entry.js.map

package/dist/lib/append-entry.js.map

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

package/dist/lib/diary-resolve.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDiary = resolveDiary;
+exports.listAllDiaries = listAllDiaries;
+const errors_1 = require("../errors");
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * `<diary>` on the command line -- a diary id, or a name to look up against
+ * `GET /diaries` (list, not search: the API also offers `?q=` substring
+ * search, but that is for the app's search box, not for turning a name a
+ * person typed back into exactly the diary they meant, so this matches by
+ * exact name, case-insensitively, and refuses to guess when more than one
+ * diary shares a name).
+ */
+async function resolveDiary(client, nameOrId) {
+    if (UUID_RE.test(nameOrId)) {
+        try {
+            return await client.get(`/diaries/${nameOrId}`);
+        }
+        catch (err) {
+            if (err instanceof errors_1.ApiError && err.status === 404) {
+                throw new errors_1.CliUsageError(`No diary with id ${nameOrId} (or it is not visible to you).`);
+            }
+            throw err;
+        }
+    }
+    const all = await listAllDiaries(client);
+    const matches = all.filter((d) => d.name.toLowerCase() === nameOrId.toLowerCase());
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1) {
+        const ids = matches.map((d) => `  ${d.id}  ${d.name} (${d.groupName})`).join("\n");
+        throw new errors_1.CliUsageError(`"${nameOrId}" matches more than one diary -- use the id instead:\n${ids}`);
+    }
+    const known = all.map((d) => d.name).join(", ") || "(none)";
+    throw new errors_1.CliUsageError(`No diary named "${nameOrId}". Diaries you can see: ${known}`);
+}
+async function listAllDiaries(client) {
+    const all = [];
+    let cursor;
+    for (;;) {
+        const page = await client.getPage("/diaries", { limit: "50", cursor });
+        all.push(...page.items);
+        if (!page.hasNext || !page.nextCursor)
+            break;
+        cursor = page.nextCursor;
+    }
+    return all;
+}
+//# sourceMappingURL=diary-resolve.js.map

package/dist/lib/diary-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diary-resolve.js","sourceRoot":"","sources":["../../src/lib/diary-resolve.ts"],"names":[],"mappings":";;AAcA,oCAqBC;AAED,wCAUC;AA/CD,sCAAoD;AAIpD,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF;;;;;;;GAOG;AACI,KAAK,UAAU,YAAY,CAAC,MAAqB,EAAE,QAAgB;IACxE,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,GAAG,CAAQ,YAAY,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,iBAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClD,MAAM,IAAI,sBAAa,CAAC,oBAAoB,QAAQ,iCAAiC,CAAC,CAAC;YACzF,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnF,MAAM,IAAI,sBAAa,CAAC,IAAI,QAAQ,yDAAyD,GAAG,EAAE,CAAC,CAAC;IACtG,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;IAC5D,MAAM,IAAI,sBAAa,CAAC,mBAAmB,QAAQ,2BAA2B,KAAK,EAAE,CAAC,CAAC;AACzF,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,MAAqB;IACxD,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,IAAI,MAA0B,CAAC;IAC/B,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAQ,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,MAAM;QAC7C,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/entry-date.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertValidDate = assertValidDate;
+exports.assertValidTime = assertValidTime;
+exports.dateKeyInTimeZone = dateKeyInTimeZone;
+exports.timeKeyInTimeZone = timeKeyInTimeZone;
+exports.zonedTimeToUtc = zonedTimeToUtc;
+exports.resolveOccurredAt = resolveOccurredAt;
+const errors_1 = require("../errors");
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const TIME_RE = /^([01]\d|2[0-3]):([0-5]\d)$/;
+function assertValidDate(date) {
+    if (!DATE_RE.test(date))
+        throw new errors_1.CliUsageError(`--date must be YYYY-MM-DD, got "${date}".`);
+    // DATE_RE only checks the shape; Date.UTC quietly rolls "2026-02-30" into
+    // March, so check the round-trip too rather than writing to the wrong day.
+    const [y, m, d] = date.split("-").map(Number);
+    const roundTrip = new Date(Date.UTC(y, m - 1, d));
+    if (roundTrip.getUTCFullYear() !== y || roundTrip.getUTCMonth() !== m - 1 || roundTrip.getUTCDate() !== d) {
+        throw new errors_1.CliUsageError(`--date "${date}" is not a real calendar date.`);
+    }
+}
+function assertValidTime(time) {
+    if (!TIME_RE.test(time))
+        throw new errors_1.CliUsageError(`--time must be HH:MM (24h), got "${time}".`);
+}
+/** "YYYY-MM-DD" for `date`, as read in `timeZone` -- what day the diary's own §11.4 uniqueness check would see. */
+function dateKeyInTimeZone(date, timeZone) {
+    // en-CA formats as YYYY-MM-DD, which is also the wire format --
+    // avoids hand-assembling the string from getters that don't accept a tz.
+    return new Intl.DateTimeFormat("en-CA", { timeZone, year: "numeric", month: "2-digit", day: "2-digit" }).format(date);
+}
+/** "HH:MM" for `date`, as read in `timeZone`. Used to default --time to "now" without a second copy of the format string. */
+function timeKeyInTimeZone(date, timeZone) {
+    return new Intl.DateTimeFormat("en-GB", {
+        timeZone,
+        hour: "2-digit",
+        minute: "2-digit",
+        hourCycle: "h23",
+    }).format(date);
+}
+/**
+ * The inverse of the two functions above: the UTC instant that reads as
+ * `dateStr` `timeStr` when displayed in `timeZone`.
+ *
+ * There is no built-in for this (Intl only goes UTC -> zoned, never back),
+ * so this uses the standard trick: read `dateStr timeStr` as if it were
+ * already UTC, ask what that UTC instant looks like in `timeZone`, and shift
+ * by the difference. Good to the minute, which is all `--time` offers;
+ * degrades right at a DST transition (an hour that either repeats or does
+ * not exist), which is an acceptable rough edge for a diary entry's
+ * timestamp and not worth a timezone-database dependency for.
+ */
+function zonedTimeToUtc(dateStr, timeStr, timeZone) {
+    const asIfUtc = new Date(`${dateStr}T${timeStr}:00.000Z`);
+    const readInZone = new Date(asIfUtc.toLocaleString("en-US", { timeZone }));
+    const diff = asIfUtc.getTime() - readInZone.getTime();
+    return new Date(asIfUtc.getTime() + diff);
+}
+/**
+ * Resolves `--date`/`--time` into the `occurredAt` instant to send the API,
+ * defaulting both to "now" in the diary's own timezone -- not the machine's,
+ * since §11.4's one-entry-per-day check is computed in the diary's timezone
+ * (entries-create-service.ts) and a mismatch is exactly the kind of thing
+ * that would land a `--date 2026-09-25` entry on the 24th or 26th instead.
+ */
+function resolveOccurredAt(opts, timeZone, now = new Date()) {
+    if (opts.date)
+        assertValidDate(opts.date);
+    if (opts.time)
+        assertValidTime(opts.time);
+    const date = opts.date ?? dateKeyInTimeZone(now, timeZone);
+    const time = opts.time ?? timeKeyInTimeZone(now, timeZone);
+    return zonedTimeToUtc(date, time, timeZone);
+}
+//# sourceMappingURL=entry-date.js.map

package/dist/lib/entry-date.js.map

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

package/dist/lib/entry-find.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findEntryOnDate = findEntryOnDate;
+const entry_date_1 = require("./entry-date");
+const PAGE_LIMIT = 50;
+/** Ten pages is 500 entries -- generous for "find the one entry on this diary-day" without paging forever through years of history for a typo'd date. */
+const MAX_PAGES = 10;
+/**
+ * `GET /entries` has no `?date=`, only cursor pagination newest-first
+ * (entries-query-service.ts's `listEntriesPage`, `orderBy: occurred_at
+ * desc`). Since there is at most one entry per diary-day (§11.4), walking
+ * that list until an entry's day (in the diary's own timezone) matches or
+ * we pass it is exact, not a heuristic -- it just is not O(1). Returns null
+ * if the diary has no entry on that day, or if it is farther back than
+ * MAX_PAGES cover.
+ */
+async function findEntryOnDate(client, diaryId, timeZone, dateKey) {
+    let cursor;
+    for (let page = 0; page < MAX_PAGES; page++) {
+        const result = await client.getPage("/entries", {
+            diaryId,
+            limit: String(PAGE_LIMIT),
+            cursor,
+        });
+        for (const entry of result.items) {
+            const entryDateKey = (0, entry_date_1.dateKeyInTimeZone)(new Date(entry.occurredAt), timeZone);
+            if (entryDateKey === dateKey)
+                return entry;
+            // Newest-first: once we're past the target day, it is not coming back.
+            if (entryDateKey < dateKey)
+                return null;
+        }
+        if (!result.hasNext || !result.nextCursor)
+            return null;
+        cursor = result.nextCursor;
+    }
+    return null;
+}
+//# sourceMappingURL=entry-find.js.map

package/dist/lib/entry-find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-find.js","sourceRoot":"","sources":["../../src/lib/entry-find.ts"],"names":[],"mappings":";;AAiBA,0CAuBC;AAtCD,6CAAiD;AAEjD,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,yJAAyJ;AACzJ,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB;;;;;;;;GAQG;AACI,KAAK,UAAU,eAAe,CACnC,MAAqB,EACrB,OAAe,EACf,QAAgB,EAChB,OAAe;IAEf,IAAI,MAA0B,CAAC;IAC/B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAgB,UAAU,EAAE;YAC7D,OAAO;YACP,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC;YACzB,MAAM;SACP,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,YAAY,GAAG,IAAA,8BAAiB,EAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC7E,IAAI,YAAY,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;YAC3C,uEAAuE;YACvE,IAAI,YAAY,GAAG,OAAO;gBAAE,OAAO,IAAI,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QACvD,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/jwt.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeJwtPayloadUnsafe = decodeJwtPayloadUnsafe;
+/**
+ * Reads the payload of a JWT without verifying its signature -- fine here
+ * because we never trust this for authorization (the server does that on
+ * every request), only to show a human "signed in as ...". Used for the
+ * `--token`/`WHATCHA_TOKEN` escape hatch (issue #1428): `POST /auth/refresh`
+ * returns only `accessToken`/`expiresIn`/`refreshToken`, no user object, so
+ * this is the only way to get an email/id to display after that path.
+ */
+function decodeJwtPayloadUnsafe(token) {
+    const parts = token.split(".");
+    if (parts.length !== 3)
+        return null;
+    try {
+        const json = Buffer.from(parts[1].replace(/-/g, "+").replace(/_/g, "/"), "base64").toString("utf8");
+        const parsed = JSON.parse(json);
+        return typeof parsed === "object" && parsed !== null ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=jwt.js.map

package/dist/lib/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../src/lib/jwt.ts"],"names":[],"mappings":";;AAQA,wDAUC;AAlBD;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CAAC,KAAa;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpG,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAE,MAAkC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/output.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printJson = printJson;
+exports.printLine = printLine;
+exports.printErrorLine = printErrorLine;
+/**
+ * The `--json` contract (see README.md): every command prints exactly one
+ * JSON object to stdout on success, `{"ok": true, ...command-specific
+ * fields}`, and `{"ok": false, "error": {"code", "message"}}` on failure --
+ * always to stdout, even for an error, so a script doing `whatcha ... --json
+ * | jq` gets parseable JSON either way instead of having to also capture
+ * stderr. Human-mode output goes to stdout on success and stderr on
+ * failure, and is not meant to be parsed by anything.
+ *
+ * Never pass an access/refresh token or a password through this -- see
+ * README.md's "--json contract" section. Nothing in src/commands builds a
+ * JSON payload from a StoredSession or a LoginResult directly; they pick
+ * the fields by hand.
+ */
+function printJson(value) {
+    process.stdout.write(JSON.stringify(value) + "\n");
+}
+function printLine(text) {
+    process.stdout.write(text + "\n");
+}
+function printErrorLine(text) {
+    process.stderr.write(text + "\n");
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":";;AAcA,8BAEC;AAED,8BAEC;AAED,wCAEC;AAxBD;;;;;;;;;;;;;GAaG;AACH,SAAgB,SAAS,CAAC,KAA8B;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// Wire shapes this CLI actually touches, trimmed from apps/api/openapi.yaml.
+// Not the whole API -- just the fields the four commands read or send. Keep
+// these in sync with openapi.yaml by hand; there is no codegen step here.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,4EAA4E;AAC5E,0EAA0E"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@whatcha/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Official command-line client for what-are-you-do-ing (whatareyoudo.ing) -- login, list diaries, write and read entries.",
+  "license": "Apache-2.0",
+  "homepage": "https://whatareyoudo.ing/cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitea.lovekapibarasan.org/LoveKapibarasan/what-are-you-do-ing.git",
+    "directory": "apps/cli"
+  },
+  "bugs": {
+    "url": "https://gitea.lovekapibarasan.org/LoveKapibarasan/what-are-you-do-ing/issues"
+  },
+  "keywords": [
+    "whatcha",
+    "diary",
+    "journal",
+    "cli",
+    "whatareyoudo"
+  ],
+  "bin": {
+    "whatcha": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node node_modules/typescript/bin/tsc",
+    "typecheck": "node node_modules/typescript/bin/tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.5.2",
+    "vitest": "^4.1.10"
+  }
+}