@workjournal/cli 0.8.0 → 0.16.0

package/dist/help/_dispatch.js

@@ -0,0 +1,132 @@
+import { HELP_DOCS, listCommands } from './_registry.js';
+import { FEEDBACK_FOOTER, renderHelp } from './_renderer.js';
+/**
+ * Returns true if any element of argv is the literal `--help` or `-h`.
+ *
+ * The CLI accepts `--help` / `-h` in any position — not just as the subcommand
+ * — because users (and especially agents) habitually probe `<cmd> --help` to
+ * discover flags. This walker treats every position equally so
+ * `journals list --help` works the same as `journals --help list`.
+ */
+export function hasHelpFlag(argv) {
+    return argv.some((a) => a === '--help' || a === '-h');
+}
+/**
+ * If argv is asking for help, print the appropriate help block (per-command if
+ * we can resolve a HelpDoc, else group summary) and return true. Caller should
+ * `return` immediately on true.
+ *
+ * `command` is the space-separated form as it would appear in the registry —
+ * e.g. `entries update`, `auth login`, or just `entries` for the group level.
+ */
+export function tryHandleHelp(command, argv, jsonOutput) {
+    if (!hasHelpFlag(argv))
+        return false;
+    const doc = HELP_DOCS[command];
+    if (doc) {
+        printDoc(doc, jsonOutput);
+        return true;
+    }
+    // No exact match — fall back to a group summary if `command` is a prefix.
+    const matches = listCommands().filter((c) => c.startsWith(`${command} `));
+    if (matches.length > 0) {
+        printGroupSummary(command, matches, jsonOutput);
+        return true;
+    }
+    // No match anywhere — print the top-level help so the user has something.
+    printTopLevelHelp(jsonOutput);
+    return true;
+}
+/**
+ * Print a single command's help. Text or JSON depending on `--json`.
+ */
+export function printDoc(doc, jsonOutput) {
+    if (jsonOutput) {
+        process.stdout.write(`${JSON.stringify(doc, null, 2)}\n`);
+        return;
+    }
+    process.stdout.write(renderHelp(doc));
+}
+/**
+ * Print a one-liner summary for every command under a group prefix
+ * (e.g. `entries` → list, write, last, get, update, delete, search).
+ */
+function printGroupSummary(group, commands, jsonOutput) {
+    if (jsonOutput) {
+        const docs = commands.map((c) => HELP_DOCS[c]);
+        process.stdout.write(`${JSON.stringify(docs, null, 2)}\n`);
+        return;
+    }
+    const lines = [];
+    lines.push(`workjournal ${group} <subcommand> [...]`);
+    lines.push('');
+    lines.push(`Subcommands:`);
+    const labels = commands.map((c) => c.slice(group.length + 1));
+    const width = Math.max(...labels.map((l) => l.length));
+    for (let i = 0; i < commands.length; i++) {
+        const doc = HELP_DOCS[commands[i]];
+        const label = labels[i].padEnd(width);
+        lines.push(`  ${label}  ${firstSentence(doc.description)}`);
+    }
+    lines.push('');
+    lines.push(`Run \`workjournal ${group} <subcommand> --help\` for full details.`);
+    lines.push('');
+    lines.push(FEEDBACK_FOOTER);
+    process.stdout.write(`${lines.join('\n')}\n`);
+}
+/**
+ * Print the top-level help — every command in the registry, grouped by the
+ * first word. This replaces the legacy hand-written `printHelp()` template.
+ */
+export function printTopLevelHelp(jsonOutput) {
+    if (jsonOutput) {
+        const docs = listCommands().map((c) => HELP_DOCS[c]);
+        process.stdout.write(`${JSON.stringify(docs, null, 2)}\n`);
+        return;
+    }
+    const lines = [];
+    lines.push('workjournal — CLI for Workjournal (https://workjournal.pro)');
+    lines.push('');
+    lines.push('Usage:');
+    lines.push('  workjournal                                List entries in the selected journal');
+    lines.push('  workjournal <command> [<subcommand>] [...] Run a specific command');
+    lines.push('  workjournal <command> --help               Detailed help for one command');
+    lines.push('  workjournal --version                      Print version');
+    lines.push('');
+    // Group keys by their first word so the output mirrors how users think
+    // about the surface (workspaces, journals, entries, …).
+    const grouped = new Map();
+    for (const cmd of listCommands()) {
+        const group = cmd.includes(' ') ? cmd.slice(0, cmd.indexOf(' ')) : cmd;
+        const list = grouped.get(group) ?? [];
+        list.push(cmd);
+        grouped.set(group, list);
+    }
+    for (const [group, cmds] of grouped) {
+        lines.push(`${capitalize(group)}:`);
+        const labels = cmds.map((c) => `workjournal ${c}`);
+        const width = Math.max(...labels.map((l) => l.length));
+        for (let i = 0; i < cmds.length; i++) {
+            const doc = HELP_DOCS[cmds[i]];
+            const label = labels[i].padEnd(width);
+            lines.push(`  ${label}  ${firstSentence(doc.description)}`);
+        }
+        lines.push('');
+    }
+    lines.push('Global flags:');
+    lines.push('  --json     Machine-readable output (where applicable)');
+    lines.push('  --verbose  Extra detail on `journals get` / `journal`');
+    lines.push('');
+    lines.push(FEEDBACK_FOOTER);
+    process.stdout.write(`${lines.join('\n')}\n`);
+}
+function firstSentence(s) {
+    const idx = s.indexOf('.');
+    if (idx === -1)
+        return s;
+    return s.slice(0, idx + 1);
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=_dispatch.js.map

package/dist/help/_dispatch.js.map

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

package/dist/help/_registry.d.ts

@@ -0,0 +1,18 @@
+import type { HelpDoc } from './_types.js';
+/**
+ * Every command's help doc, keyed by the space-separated command form as the
+ * user types it (`entries update`, `auth login`, `journal`, …). Lookups in
+ * `index.ts` use this map to render `--help` output on demand.
+ *
+ * Adding a new command is two steps: drop a `<group>-<sub>.json` here, and
+ * register it below.
+ */
+export declare const HELP_DOCS: Readonly<Record<string, HelpDoc>>;
+/**
+ * Look up a HelpDoc by command form (`entries update`, etc.) — returns
+ * `undefined` for unknown keys.
+ */
+export declare function getHelpDoc(command: string): HelpDoc | undefined;
+/** Stable list of command keys for iteration (alphabetical). */
+export declare function listCommands(): string[];
+//# sourceMappingURL=_registry.d.ts.map

package/dist/help/_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_registry.d.ts","sourceRoot":"","sources":["../../src/help/_registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAmC3C;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCtD,CAAC;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE/D;AAED,gEAAgE;AAChE,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC"}

package/dist/help/_registry.js

@@ -0,0 +1,88 @@
+import authLogin from './auth-login.json' with { type: 'json' };
+import authLogout from './auth-logout.json' with { type: 'json' };
+import authStatus from './auth-status.json' with { type: 'json' };
+import authWhoami from './auth-whoami.json' with { type: 'json' };
+import configShow from './config-show.json' with { type: 'json' };
+import entriesDelete from './entries-delete.json' with { type: 'json' };
+import entriesGet from './entries-get.json' with { type: 'json' };
+import entriesLast from './entries-last.json' with { type: 'json' };
+import entriesList from './entries-list.json' with { type: 'json' };
+import entriesSearch from './entries-search.json' with { type: 'json' };
+import entriesUpdate from './entries-update.json' with { type: 'json' };
+import entriesWrite from './entries-write.json' with { type: 'json' };
+import exportCmd from './export.json' with { type: 'json' };
+import invitesDelete from './invites-delete.json' with { type: 'json' };
+import invitesList from './invites-list.json' with { type: 'json' };
+import invitesNew from './invites-new.json' with { type: 'json' };
+import journal from './journal.json' with { type: 'json' };
+import journalsAssignPrompt from './journals-assign-prompt.json' with { type: 'json' };
+import journalsDelete from './journals-delete.json' with { type: 'json' };
+import journalsGet from './journals-get.json' with { type: 'json' };
+import journalsList from './journals-list.json' with { type: 'json' };
+import journalsNew from './journals-new.json' with { type: 'json' };
+import journalsRename from './journals-rename.json' with { type: 'json' };
+import journalsSelect from './journals-select.json' with { type: 'json' };
+import journalsSetSlug from './journals-set-slug.json' with { type: 'json' };
+import journalsUnassignPrompt from './journals-unassign-prompt.json' with { type: 'json' };
+import promptsDelete from './prompts-delete.json' with { type: 'json' };
+import promptsGet from './prompts-get.json' with { type: 'json' };
+import promptsList from './prompts-list.json' with { type: 'json' };
+import promptsNew from './prompts-new.json' with { type: 'json' };
+import promptsUpdate from './prompts-update.json' with { type: 'json' };
+import sharesDelete from './shares-delete.json' with { type: 'json' };
+import sharesList from './shares-list.json' with { type: 'json' };
+/**
+ * Every command's help doc, keyed by the space-separated command form as the
+ * user types it (`entries update`, `auth login`, `journal`, …). Lookups in
+ * `index.ts` use this map to render `--help` output on demand.
+ *
+ * Adding a new command is two steps: drop a `<group>-<sub>.json` here, and
+ * register it below.
+ */
+export const HELP_DOCS = Object.freeze({
+    'auth login': authLogin,
+    'auth logout': authLogout,
+    'auth status': authStatus,
+    'auth whoami': authWhoami,
+    'config show': configShow,
+    'entries delete': entriesDelete,
+    'entries get': entriesGet,
+    'entries last': entriesLast,
+    'entries list': entriesList,
+    'entries search': entriesSearch,
+    'entries update': entriesUpdate,
+    'entries write': entriesWrite,
+    'invites delete': invitesDelete,
+    'invites list': invitesList,
+    'invites new': invitesNew,
+    'journals assign-prompt': journalsAssignPrompt,
+    'journals delete': journalsDelete,
+    'journals get': journalsGet,
+    'journals list': journalsList,
+    'journals new': journalsNew,
+    'journals rename': journalsRename,
+    'journals select': journalsSelect,
+    'journals set-slug': journalsSetSlug,
+    'journals unassign-prompt': journalsUnassignPrompt,
+    'prompts delete': promptsDelete,
+    'prompts get': promptsGet,
+    'prompts list': promptsList,
+    'prompts new': promptsNew,
+    'prompts update': promptsUpdate,
+    'shares delete': sharesDelete,
+    'shares list': sharesList,
+    export: exportCmd,
+    journal: journal,
+});
+/**
+ * Look up a HelpDoc by command form (`entries update`, etc.) — returns
+ * `undefined` for unknown keys.
+ */
+export function getHelpDoc(command) {
+    return HELP_DOCS[command];
+}
+/** Stable list of command keys for iteration (alphabetical). */
+export function listCommands() {
+    return Object.keys(HELP_DOCS).sort();
+}
+//# sourceMappingURL=_registry.js.map

package/dist/help/_registry.js.map

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

package/dist/help/_renderer.d.ts

@@ -0,0 +1,31 @@
+import type { HelpDoc } from './_types.js';
+/** Public so route handlers can append the same footer to ad-hoc usage lines. */
+export declare const FEEDBACK_FOOTER = "Report issues / feedback: https://github.com/workjournal-pro/feedback/issues";
+/**
+ * Render a `HelpDoc` to a terminal-friendly string. The output is one block:
+ *
+ *     workjournal entries update <workspaceSlug> <journalSlug> <index> [-t <title>] [-s <summary>] [-b <file>|-]
+ *
+ *     <description>
+ *
+ *     Arguments:
+ *       <workspaceSlug>  ...
+ *
+ *     Flags:
+ *       -t, --title <title>  ...
+ *
+ *     At least one of -t/-s/-b is required.
+ *
+ *     Examples:
+ *       workjournal entries update acme engineering 5 -t "Verified"
+ *
+ *     When to use:
+ *       Annotate, verify, or fix typos ...
+ *
+ *     Report issues / feedback: <url>
+ *
+ * Rendering is intentionally naive — no terminal-width detection, no colour. We
+ * favour deterministic output (so tests can assert verbatim) over polish.
+ */
+export declare function renderHelp(doc: HelpDoc): string;
+//# sourceMappingURL=_renderer.d.ts.map

package/dist/help/_renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_renderer.d.ts","sourceRoot":"","sources":["../../src/help/_renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,iFAAiF;AACjF,eAAO,MAAM,eAAe,iFAA8C,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAkD/C"}

package/dist/help/_renderer.js

@@ -0,0 +1,99 @@
+const FEEDBACK_URL = 'https://github.com/workjournal-pro/feedback/issues';
+/** Public so route handlers can append the same footer to ad-hoc usage lines. */
+export const FEEDBACK_FOOTER = `Report issues / feedback: ${FEEDBACK_URL}`;
+/**
+ * Render a `HelpDoc` to a terminal-friendly string. The output is one block:
+ *
+ *     workjournal entries update <workspaceSlug> <journalSlug> <index> [-t <title>] [-s <summary>] [-b <file>|-]
+ *
+ *     <description>
+ *
+ *     Arguments:
+ *       <workspaceSlug>  ...
+ *
+ *     Flags:
+ *       -t, --title <title>  ...
+ *
+ *     At least one of -t/-s/-b is required.
+ *
+ *     Examples:
+ *       workjournal entries update acme engineering 5 -t "Verified"
+ *
+ *     When to use:
+ *       Annotate, verify, or fix typos ...
+ *
+ *     Report issues / feedback: <url>
+ *
+ * Rendering is intentionally naive — no terminal-width detection, no colour. We
+ * favour deterministic output (so tests can assert verbatim) over polish.
+ */
+export function renderHelp(doc) {
+    const lines = [];
+    lines.push(usageLine(doc));
+    lines.push('');
+    lines.push(doc.description);
+    if (doc.args && doc.args.length > 0) {
+        lines.push('');
+        lines.push('Arguments:');
+        const width = Math.max(...doc.args.map((a) => formatArgName(a).length));
+        for (const arg of doc.args) {
+            const name = formatArgName(arg).padEnd(width);
+            lines.push(`  ${name}  ${arg.description}`);
+        }
+    }
+    if (doc.flags && doc.flags.length > 0) {
+        lines.push('');
+        lines.push('Flags:');
+        const formatted = doc.flags.map(formatFlag);
+        const width = Math.max(...formatted.map((f) => f.label.length));
+        for (const f of formatted) {
+            lines.push(`  ${f.label.padEnd(width)}  ${f.description}`);
+        }
+    }
+    if (doc.constraints && doc.constraints.length > 0) {
+        lines.push('');
+        for (const c of doc.constraints) {
+            lines.push(c);
+        }
+    }
+    if (doc.examples.length > 0) {
+        lines.push('');
+        lines.push('Examples:');
+        for (const ex of doc.examples) {
+            lines.push(`  ${ex}`);
+        }
+    }
+    lines.push('');
+    lines.push('When to use:');
+    lines.push(`  ${doc.when_to_use}`);
+    lines.push('');
+    lines.push(FEEDBACK_FOOTER);
+    return `${lines.join('\n')}\n`;
+}
+function usageLine(doc) {
+    const parts = ['workjournal', doc.command];
+    if (doc.args) {
+        for (const arg of doc.args) {
+            parts.push(arg.required ? `<${arg.name}>` : `[${arg.name}]`);
+        }
+    }
+    if (doc.flags) {
+        for (const flag of doc.flags) {
+            parts.push(`[${formatFlagInline(flag)}]`);
+        }
+    }
+    return parts.join(' ');
+}
+function formatArgName(arg) {
+    return arg.required ? `<${arg.name}>` : `[${arg.name}]`;
+}
+function formatFlagInline(flag) {
+    const aliases = [flag.short, flag.long].filter(Boolean).join('/');
+    return flag.value ? `${aliases} ${flag.value}` : aliases;
+}
+function formatFlag(flag) {
+    const aliases = [flag.short, flag.long].filter(Boolean).join(', ');
+    const label = flag.value ? `${aliases} ${flag.value}` : aliases;
+    return { label, description: flag.description };
+}
+//# sourceMappingURL=_renderer.js.map

package/dist/help/_renderer.js.map

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

package/dist/help/_types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Schema for the per-command help JSON files in this directory.
+ *
+ * Every `<group>-<sub>.json` (or `<sub>.json` for top-level commands like
+ * `export`) conforms to this interface. The renderer at `_renderer.ts` walks
+ * a `HelpDoc` to produce terminal output; `--help --json` emits the raw JSON
+ * untouched. The registry at `_registry.ts` is the single import surface for
+ * the routes in `index.ts`.
+ *
+ * The shape is CLI-flavoured (positional `args[]` ordered, aliased `flags[]`,
+ * free-form `constraints[]`) rather than a JSON-Schema clone — see the plan
+ * doc for the rationale.
+ */
+export interface HelpArg {
+    /** Camel-cased name as it appears in usage strings (e.g. `workspaceSlug`). */
+    name: string;
+    required: boolean;
+    description: string;
+}
+export interface HelpFlag {
+    /** Single-dash short form (e.g. `-t`). Optional for long-only flags. */
+    short?: string;
+    /** Double-dash long form (e.g. `--title`). Required. */
+    long: string;
+    /**
+     * Placeholder shown after the flag in usage (e.g. `<title>` or `<file>|-`).
+     * Omit for boolean toggles that take no value.
+     */
+    value?: string;
+    description: string;
+}
+export interface HelpAnnotations {
+    /** Mutates server state in a way that can't be reversed (delete, set-slug). */
+    destructive: boolean;
+    /** Repeated identical calls converge on identical server state. */
+    idempotent: boolean;
+}
+export interface HelpDoc {
+    /** Space-separated form as the user types it (e.g. `entries update`). */
+    command: string;
+    /** 1–2 sentence summary used in both the human and the JSON output. */
+    description: string;
+    args?: HelpArg[];
+    flags?: HelpFlag[];
+    /** Free-form constraint strings rendered verbatim under flags. */
+    constraints?: string[];
+    annotations: HelpAnnotations;
+    /** 1–2 realistic invocations a user (or agent) would actually run. */
+    examples: string[];
+    /** Why an agent or user would reach for this command over alternatives. */
+    when_to_use: string;
+}
+//# sourceMappingURL=_types.d.ts.map

package/dist/help/_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_types.d.ts","sourceRoot":"","sources":["../../src/help/_types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,OAAO;IACvB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACxB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,+EAA+E;IAC/E,WAAW,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACvB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;CACpB"}

package/dist/help/_types.js

@@ -0,0 +1,15 @@
+/**
+ * Schema for the per-command help JSON files in this directory.
+ *
+ * Every `<group>-<sub>.json` (or `<sub>.json` for top-level commands like
+ * `export`) conforms to this interface. The renderer at `_renderer.ts` walks
+ * a `HelpDoc` to produce terminal output; `--help --json` emits the raw JSON
+ * untouched. The registry at `_registry.ts` is the single import surface for
+ * the routes in `index.ts`.
+ *
+ * The shape is CLI-flavoured (positional `args[]` ordered, aliased `flags[]`,
+ * free-form `constraints[]`) rather than a JSON-Schema clone — see the plan
+ * doc for the rationale.
+ */
+export {};
+//# sourceMappingURL=_types.js.map

package/dist/help/_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_types.js","sourceRoot":"","sources":["../../src/help/_types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/help/auth-login.json

@@ -0,0 +1,12 @@
+{
+    "command": "auth login",
+    "description": "Authenticate with Workjournal via browser-based OAuth (PKCE). Two-phase flow for headless environments: `auth login start` prints the authorize URL, `auth login finish <CODE>` exchanges the 8-character code for credentials.",
+    "flags": [],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal auth login",
+        "workjournal auth login start",
+        "workjournal auth login finish ABC23DEF"
+    ],
+    "when_to_use": "First-time setup, after a logout, or when an existing token has been revoked. The two-phase form works in SSH sessions, dev containers, and CI where no browser is available locally."
+}

package/dist/help/auth-logout.json

@@ -0,0 +1,7 @@
+{
+    "command": "auth logout",
+    "description": "Sign out the current device. Best-effort revokes the per-device session server-side and clears local credentials at `~/.config/workjournal/credentials.json`.",
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal auth logout"],
+    "when_to_use": "When stepping away from a shared machine, rotating credentials, or before re-running `auth login` to force a fresh token."
+}

package/dist/help/auth-status.json

@@ -0,0 +1,7 @@
+{
+    "command": "auth status",
+    "description": "Print whether the CLI is authenticated and when the current access token expires (ISO timestamp, with `(expired, will auto-refresh)` when in the past).",
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal auth status"],
+    "when_to_use": "Diagnosing token-expiry issues or scripting an auth-precheck before a batch of CLI calls. The CLI auto-refreshes on 401, so an expired timestamp here is rarely a real problem."
+}

package/dist/help/auth-whoami.json

@@ -0,0 +1,7 @@
+{
+    "command": "auth whoami",
+    "description": "Print whether the CLI is authenticated and where credentials are stored on disk.",
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal auth whoami"],
+    "when_to_use": "Quick yes/no check that credentials are present. For token-expiry detail use `auth status` instead."
+}

package/dist/help/config-show.json

@@ -0,0 +1,7 @@
+{
+    "command": "config show",
+    "description": "Print the resolved CLI configuration — both project-config (the `.workjournal` file in the current directory or any parent) and global-config (in the user config dir).",
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal config show"],
+    "when_to_use": "Diagnosing which workspace and journal the shortcut forms (`workjournal`, `workjournal journal`) will resolve to. Project values take precedence over global."
+}

package/dist/help/entries-delete.json

@@ -0,0 +1,12 @@
+{
+    "command": "entries delete",
+    "description": "Delete a single entry by its per-journal index. Irreversible. The index is not reused; subsequent entries keep their existing indices.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        { "name": "index", "required": true, "description": "Per-journal positive integer (≥ 1)." }
+    ],
+    "annotations": { "destructive": true, "idempotent": true },
+    "examples": ["workjournal entries delete acme engineering 5"],
+    "when_to_use": "Removing an entry that was created by mistake or contains content that shouldn't have been recorded. Prefer `entries update` for any fix that doesn't require removal."
+}

package/dist/help/entries-get.json

@@ -0,0 +1,12 @@
+{
+    "command": "entries get",
+    "description": "Fetch a single entry by its per-journal index. The index is the integer shown as `#N` in `entries list` output and is monotonic, never reused.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        { "name": "index", "required": true, "description": "Per-journal positive integer (≥ 1)." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal entries get acme engineering 5"],
+    "when_to_use": "Reading one specific entry by its index — useful when correlating across `entries search` results or following a reference like `entry #5`."
+}

package/dist/help/entries-last.json

@@ -0,0 +1,19 @@
+{
+    "command": "entries last",
+    "description": "Print the N most recent entries with their full body content. Defaults to 1.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        {
+            "name": "count",
+            "required": false,
+            "description": "How many entries to fetch (positive integer; default 1)."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal entries last acme engineering",
+        "workjournal entries last acme engineering 5"
+    ],
+    "when_to_use": "Reading recent work back to recover context — the most common opening move for an agent starting a new session in an existing journal."
+}

package/dist/help/entries-list.json

@@ -0,0 +1,14 @@
+{
+    "command": "entries list",
+    "description": "List entries in a journal (newest first), slim form — no body. Use `entries last` or `entries get` to read full content.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal entries list acme engineering",
+        "workjournal entries list acme engineering --json"
+    ],
+    "when_to_use": "Browsing what's in a journal. For a view that includes the body, use `entries last <ws> <j> N`."
+}

package/dist/help/entries-search.json

@@ -0,0 +1,15 @@
+{
+    "command": "entries search",
+    "description": "Search a journal's entries by keyword. Returns slim entries (id, index, summary, created_at) — follow up with `entries get` for the full body.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        { "name": "query", "required": true, "description": "Search string. Quote multi-word queries." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal entries search acme engineering auth",
+        "workjournal entries search acme engineering \"refresh token\" --json"
+    ],
+    "when_to_use": "Finding past entries on a topic — file paths, feature names, error strings, decision keywords. Run several searches with different terms to find related entries."
+}