@creator-notes/cnotes 0.16.11

package/dist/commands/theme.js

@@ -0,0 +1,184 @@
+import { ApiClient } from "../lib/api-client.js";
+import { resolveBaseConfig } from "../lib/config.js";
+import { AuthError, ValidationError, handleError } from "../lib/errors.js";
+import { outputJson, outputTable } from "../lib/output.js";
+import { PRESETS, PRESET_IDS, EDITABLE_TOKEN_NAMES, EDITABLE_TOKEN_NAME_SET, hslTripleToHex, parseColorInput, } from "../lib/themes.js";
+function requireAuthedConfig(program) {
+    const cfg = resolveBaseConfig(program.opts());
+    if (!cfg.token)
+        throw new AuthError();
+    return cfg;
+}
+export function registerThemeCommands(program) {
+    const theme = program
+        .command("theme")
+        .description("Manage your theme preset and per-token custom colors");
+    theme
+        .command("list")
+        .description("List available theme presets")
+        .action(async () => {
+        const cfg = requireAuthedConfig(program);
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            const current = await api.get("/api/theme");
+            if (cfg.json) {
+                outputJson({
+                    current: current.themeId,
+                    customBaseId: current.customBaseId,
+                    presets: PRESETS.map((p) => ({
+                        id: p.id,
+                        name: p.name,
+                        isDark: p.isDark,
+                        description: p.description,
+                    })),
+                });
+                return;
+            }
+            const rows = PRESETS.map((p) => [
+                current.themeId === p.id ? "*" : "",
+                p.id,
+                p.name,
+                p.isDark ? "dark" : "light",
+                p.description,
+            ]);
+            outputTable(["", "ID", "NAME", "MODE", "DESCRIPTION"], rows);
+            if (current.themeId === "custom") {
+                console.log(`\nActive: custom (based on ${current.customBaseId}, ${Object.keys(current.customColors).length} overrides)`);
+            }
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+    theme
+        .command("get")
+        .description("Show the active theme and any custom color overrides")
+        .action(async () => {
+        const cfg = requireAuthedConfig(program);
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            const data = await api.get("/api/theme");
+            if (cfg.json) {
+                outputJson(data);
+                return;
+            }
+            console.log(`themeId:       ${data.themeId}`);
+            console.log(`mode:          ${data.isDark ? "dark" : "light"}`);
+            if (data.themeId === "custom") {
+                console.log(`customBaseId:  ${data.customBaseId}`);
+            }
+            const overrides = Object.entries(data.customColors);
+            if (overrides.length === 0) {
+                console.log("custom colors: (none)");
+            }
+            else {
+                console.log("custom colors:");
+                const rows = overrides.map(([token, hsl]) => [
+                    token,
+                    hsl,
+                    // Hex is a lossy preview, so omit it for alpha-bearing triples
+                    // (including "transparent") where it would mislead.
+                    hsl.includes("/") ? "—" : hslTripleToHex(hsl),
+                ]);
+                outputTable(["TOKEN", "HSL", "HEX"], rows);
+            }
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+    theme
+        .command("set")
+        .description("Switch to a built-in theme preset")
+        .argument("<id>", "Preset ID (run `cnotes theme list` to see all)")
+        .action(async (id) => {
+        const cfg = requireAuthedConfig(program);
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        if (id === "custom") {
+            throw new ValidationError("`cnotes theme set custom` is not supported. Use `cnotes theme set-color <token> <color>` to enter custom mode (it seeds the base palette atomically).");
+        }
+        if (!PRESET_IDS.has(id)) {
+            throw new ValidationError(`Unknown theme id: ${id}. Run \`cnotes theme list\` to see available presets.`);
+        }
+        try {
+            const data = await api.put("/api/theme", { themeId: id });
+            if (cfg.json) {
+                outputJson(data);
+            }
+            else {
+                console.log(`Theme set to ${data.themeId} (${data.isDark ? "dark" : "light"}).`);
+                console.log("Reload an open browser tab to see the change.");
+            }
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+    theme
+        .command("set-color")
+        .description("Override a single token color (switches theme to 'custom')")
+        .argument("<token>", "Editable token name (e.g. primary, background)")
+        .argument("<color>", 'HSL ("310 85% 67%"), HSL with alpha ("310 85% 67% / 0.5"), hex ("#ff00aa"), or "transparent"')
+        .action(async (token, color) => {
+        const cfg = requireAuthedConfig(program);
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        if (!EDITABLE_TOKEN_NAME_SET.has(token)) {
+            throw new ValidationError(`Token "${token}" is not editable. Editable tokens: ${EDITABLE_TOKEN_NAMES.join(", ")}`);
+        }
+        const normalized = parseColorInput(color);
+        if (normalized === null) {
+            throw new ValidationError(`Invalid color: ${color}. Use HSL ("310 85% 67%"), hex ("#ff00aa"), or "transparent".`);
+        }
+        try {
+            // Use PATCH so the server merges this single token into the
+            // existing HSL palette without round-tripping unmodified tokens.
+            // We still need the current themeId to seed customBaseId on the
+            // first transition into custom — once we're already custom, the
+            // server preserves the existing base.
+            const current = await api.get("/api/theme");
+            const customBaseId = current.themeId === "custom" ? undefined : current.themeId;
+            const data = await api.patch("/api/theme/colors", {
+                customColors: { [token]: normalized },
+                ...(customBaseId ? { customBaseId } : {}),
+            });
+            if (cfg.json) {
+                outputJson(data);
+            }
+            else {
+                const storedHsl = data.customColors[token];
+                const display = storedHsl ?? normalized;
+                // Skip the hex hint when alpha is in play — hex can't represent it.
+                const hexHint = storedHsl && !storedHsl.includes("/") ? hslTripleToHex(storedHsl) : "";
+                console.log(`Set ${token} = ${display}${hexHint && hexHint !== display ? ` (${hexHint})` : ""}.`);
+                console.log(`Theme is now custom (based on ${data.customBaseId}).`);
+                console.log("Reload an open browser tab to see the change.");
+            }
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+    theme
+        .command("reset")
+        .description("Drop all custom color overrides and return to the base preset")
+        .action(async () => {
+        const cfg = requireAuthedConfig(program);
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            const current = await api.get("/api/theme");
+            const targetId = current.themeId === "custom" ? current.customBaseId : current.themeId;
+            const data = await api.put("/api/theme", { themeId: targetId });
+            if (cfg.json) {
+                outputJson(data);
+            }
+            else {
+                console.log(`Theme reset to ${data.themeId}.`);
+                console.log("Reload an open browser tab to see the change.");
+            }
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+}
+//# sourceMappingURL=theme.js.map

package/dist/commands/theme.js.map

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

package/dist/commands/timeline.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerTimelineCommands(program: Command): void;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/commands/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/commands/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoEpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsE/D"}

package/dist/commands/timeline.js

@@ -0,0 +1,97 @@
+import { ApiClient } from "../lib/api-client.js";
+import { resolveConfig } from "../lib/config.js";
+import { handleError, ValidationError } from "../lib/errors.js";
+import { outputJson, outputTable, timeAgo, truncate } from "../lib/output.js";
+const DURATION_UNITS = {
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000,
+    w: 604_800_000,
+};
+function parseDateInput(input) {
+    // Relative shorthand: 7d, 3h, 30m, 2w
+    const rel = input.match(/^(\d+)([mhdw])$/);
+    if (rel) {
+        const amount = parseInt(rel[1], 10);
+        const unit = rel[2];
+        return Date.now() - amount * DURATION_UNITS[unit];
+    }
+    // Unix ms timestamp
+    if (/^\d{10,13}$/.test(input)) {
+        const n = parseInt(input, 10);
+        return input.length <= 10 ? n * 1000 : n;
+    }
+    // Reject short ambiguous strings (e.g. "7" parses as Jan 7 2001)
+    if (input.length < 6) {
+        throw new ValidationError(`Invalid date: "${input}". Use relative (7d, 2w), ISO date (2026-03-21), or unix ms.`);
+    }
+    // ISO / calendar date
+    const ms = new Date(input).getTime();
+    if (isNaN(ms)) {
+        throw new ValidationError(`Invalid date: "${input}". Use relative (7d, 2w), ISO date (2026-03-21), or unix ms.`);
+    }
+    return ms;
+}
+export function registerTimelineCommands(program) {
+    program
+        .command("timeline")
+        .alias("tl")
+        .description("Show recent changes across notes")
+        .option("--since <when>", "Start of range (e.g. 7d, 2w, 2026-03-21)", "7d")
+        .option("--until <when>", "End of range (default: now)")
+        .option("--type <noteType>", "Filter by note type (comma-separated, e.g. Meeting,Decision)")
+        .option("--note <filter>", "Filter by note ID or title substring")
+        .option("--limit <n>", "Max results (1-100)", "50")
+        .addHelpText("after", `
+Examples:
+  $ cnotes timeline --since 7d
+  $ cnotes timeline --since 2026-03-01 --type Decision,Meeting --json
+`)
+        .action(async (opts) => {
+        const cfg = resolveConfig(program.opts());
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            const sinceMs = parseDateInput(opts.since);
+            const untilMs = opts.until ? parseDateInput(opts.until) : undefined;
+            const limit = Math.max(1, Math.min(100, parseInt(opts.limit, 10) || 50));
+            const params = {
+                workspaceId: cfg.workspaceId,
+                afterTimestamp: String(sinceMs),
+                beforeTimestamp: untilMs ? String(untilMs) : undefined,
+                limit: String(limit),
+                noteTypes: opts.type,
+                noteFilter: opts.note,
+            };
+            const data = await api.get("/api/timeline", params);
+            if (cfg.json) {
+                outputJson(data);
+                return;
+            }
+            if (cfg.quiet) {
+                for (const item of data.items) {
+                    console.log(item.versionId);
+                }
+                return;
+            }
+            if (data.items.length === 0) {
+                console.log("No changes found in the specified time range.");
+                return;
+            }
+            const rows = data.items.map((item) => [
+                item.note.displayId,
+                `v${item.versionNumber}`,
+                truncate(item.changeDescription || "(no description)", 50),
+                timeAgo(item.createdAtRaw),
+            ]);
+            outputTable(["NOTE", "V#", "CHANGE", "WHEN"], rows);
+            const typeSummary = Object.entries(data.summary.byType)
+                .map(([type, count]) => `${type}: ${count}`)
+                .join(", ");
+            console.log(`\n${data.summary.totalChanges} changes across ${data.summary.uniqueNotes} notes (${typeSummary})`);
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+}
+//# sourceMappingURL=timeline.js.map

package/dist/commands/timeline.js.map

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

package/dist/commands/types.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerTypesCommands(program: Command): void;
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0I5D"}

package/dist/commands/types.js

@@ -0,0 +1,139 @@
+import { ApiClient } from "../lib/api-client.js";
+import { resolveConfig } from "../lib/config.js";
+import { handleError, ValidationError } from "../lib/errors.js";
+import { outputJson, outputTable, outputQuiet } from "../lib/output.js";
+export function registerTypesCommands(program) {
+    const types = program
+        .command("types")
+        .alias("t")
+        .description("Manage note types (supertags)");
+    types
+        .command("list")
+        .description("List note types in the current workspace")
+        .addHelpText("after", `
+Examples:
+  $ cnotes types list --json
+`)
+        .action(async () => {
+        const cfg = resolveConfig(program.opts());
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            const data = await api.get("/api/supertags", {
+                workspaceId: cfg.workspaceId,
+            });
+            const list = Array.isArray(data) ? data : [];
+            if (cfg.json) {
+                outputJson(list, cfg.fields);
+                return;
+            }
+            if (list.length === 0) {
+                console.log("No types found.");
+                return;
+            }
+            const rows = list.map((s) => [
+                String(s.name || ""),
+                String(s.prefix || ""),
+                s.displayName !== s.name ? String(s.displayName || "") : "",
+                s.color ? String(s.color) : "",
+                s.isBuiltIn ? "yes" : "",
+                s.validationEnabled ? "on" : (s.validationPrompt ? "off" : ""),
+            ]);
+            outputTable(["NAME", "PREFIX", "DISPLAY NAME", "COLOR", "BUILT-IN", "RUBRIC"], rows);
+            console.log("\nTip: run with --json to read each type's full rubric (validationPrompt) before authoring.");
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+    types
+        .command("create")
+        .description("Create a new note type")
+        .argument("<name>", "Type name (no spaces, e.g., PainPoint, UserStory)")
+        .option("--display-name <name>", "Display name (can have spaces)")
+        .option("--description <desc>", "Description")
+        .option("--color <color>", "Color hex code (e.g., #FF5733)")
+        .addHelpText("after", `
+Examples:
+  $ cnotes types create Insight --display-name "Insight" --color "#4F46E5"
+`)
+        .action(async (name, opts) => {
+        const cfg = resolveConfig(program.opts());
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        // Validate no spaces in name
+        if (/\s/.test(name)) {
+            throw new ValidationError(`Type name cannot contain spaces. Use PascalCase (e.g., "PainPoint" instead of "Pain Point").`);
+        }
+        try {
+            const data = await api.post("/api/supertags", {
+                workspaceId: cfg.workspaceId,
+                name,
+                displayName: opts.displayName,
+                description: opts.description,
+                color: opts.color,
+            });
+            if (cfg.quiet) {
+                outputQuiet(String(data.id || ""));
+                return;
+            }
+            if (cfg.json) {
+                outputJson(data);
+            }
+            else {
+                const displayName = opts.displayName ? ` (${opts.displayName})` : "";
+                console.log(`Created type: ${name}${displayName}`);
+            }
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+    types
+        .command("update")
+        .description("Update a note type")
+        .argument("<name>", "Type name to update")
+        .option("--display-name <name>", "New display name (prefix is auto-derived from this)")
+        .option("--description <desc>", "New description")
+        .option("--color <color>", "Color hex code (e.g., #FF5733)")
+        .option("--validation-prompt <text>", "Set the type's quality rubric (the save-time check and the authoring spec agents read)")
+        .option("--enable-validation", "Turn this type's quality rubric on")
+        .option("--disable-validation", "Turn this type's quality rubric off")
+        .action(async (name, opts) => {
+        const cfg = resolveConfig(program.opts());
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            const body = {
+                workspaceId: cfg.workspaceId,
+                name,
+            };
+            if (opts.displayName)
+                body.displayName = opts.displayName;
+            if (opts.description)
+                body.description = opts.description;
+            if (opts.color)
+                body.color = opts.color;
+            if (opts.validationPrompt)
+                body.validationPrompt = opts.validationPrompt;
+            if (opts.enableValidation && opts.disableValidation) {
+                throw new ValidationError("Pass only one of --enable-validation or --disable-validation.");
+            }
+            if (opts.enableValidation)
+                body.validationEnabled = true;
+            if (opts.disableValidation)
+                body.validationEnabled = false;
+            if (Object.keys(body).length === 2) {
+                throw new ValidationError("No update flags provided. Use --display-name, --description, --color, --validation-prompt, --enable-validation, or --disable-validation.");
+            }
+            const data = await api.patch("/api/supertags", body);
+            if (cfg.json) {
+                outputJson(data);
+            }
+            else {
+                console.log(`Updated type: ${name}`);
+            }
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+}
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

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

package/dist/commands/versions.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerVersionsCommands(program: Command): void;
+//# sourceMappingURL=versions.d.ts.map

package/dist/commands/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/commands/versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAS5C,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgI/D"}

package/dist/commands/versions.js

@@ -0,0 +1,120 @@
+import { Option } from "commander";
+import { ApiClient } from "../lib/api-client.js";
+import { resolveConfig } from "../lib/config.js";
+import { handleError, ValidationError } from "../lib/errors.js";
+import { readFileSafe } from "../lib/fs-utils.js";
+import { outputJson, outputTable, timeAgo } from "../lib/output.js";
+import { resolveNoteId } from "../lib/resolve-note.js";
+import { readStdin } from "../lib/stdin.js";
+export function registerVersionsCommands(program) {
+    const versions = program
+        .command("versions")
+        .alias("v")
+        .description("Manage note versions");
+    versions
+        .command("list")
+        .description("List versions of a note")
+        .argument("<noteId>", "Note display ID or Convex ID")
+        .addHelpText("after", `
+Examples:
+  $ cnotes versions list MEETING-12
+`)
+        .action(async (noteId) => {
+        const cfg = resolveConfig(program.opts());
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            // Resolve note ID and fetch versions from dedicated endpoint
+            const resolvedId = await resolveNoteId(api, cfg.workspaceId, noteId);
+            const data = await api.get(`/api/notes/${resolvedId}/versions`, {
+                workspaceId: cfg.workspaceId,
+            });
+            const versionsList = (data.versions || []);
+            if (cfg.json) {
+                outputJson(versionsList);
+                return;
+            }
+            if (versionsList.length === 0) {
+                console.log("No versions found.");
+                return;
+            }
+            const rows = versionsList.map((v) => [
+                String(v.versionNumber || ""),
+                v.isLatest ? "*" : "",
+                String(v.description || v.changeDescription || ""),
+                v.createdAt ? timeAgo(v.createdAt) : "",
+            ]);
+            outputTable(["VERSION", "LATEST", "DESCRIPTION", "CREATED"], rows);
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+    versions
+        .command("create")
+        .description("Create a new version of a note.\n" +
+        "  Relationship link syntax (use inside markdown):\n" +
+        "    [NOTE-12: Title](relationship:references)   → reference an existing note.\n" +
+        "  Always include the `: Title` part — the title-less form `[NOTE-12](relationship:references)`\n" +
+        "  produces a chip with `title: null`, which renders as \"Untitled\" in the UI.\n" +
+        "  The relationship name is free-form (e.g. references, supports, triggers); use\n" +
+        "  `references` if unsure.")
+        .argument("<noteId>", "Note display ID or Convex ID")
+        .option("--markdown <md>", "Content as markdown")
+        .option("--markdown-file <path>", "Read markdown content from file")
+        .option("--markdown-stdin", "Read markdown content from stdin")
+        .option("--description <text>", "Change description (required unless --minor is set)")
+        .option("--minor", "Mark as a minor change — skips the description requirement")
+        // Removed flags — kept as hidden options so we can emit a clear
+        // migration error instead of commander's generic "unknown option".
+        .addOption(new Option("--content-file <path>", "[removed]").hideHelp())
+        .addOption(new Option("--content-stdin", "[removed]").hideHelp())
+        .addHelpText("after", `
+Examples:
+  $ cnotes versions create MEETING-12 --markdown-file ./meeting.md --description "Add action items"
+  $ echo "# Quick fix" | cnotes versions create MEETING-12 --markdown-stdin --minor
+`)
+        .action(async (noteId, opts) => {
+        const cfg = resolveConfig(program.opts());
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            if (opts.contentFile || opts.contentStdin) {
+                throw new ValidationError("TipTap JSON input is no longer supported. Use --markdown, --markdown-file, or --markdown-stdin instead — the server now accepts markdown directly.");
+            }
+            let content;
+            if (opts.markdownFile) {
+                content = readFileSafe(opts.markdownFile);
+            }
+            else if (opts.markdownStdin) {
+                content = await readStdin();
+            }
+            else if (opts.markdown) {
+                content = opts.markdown;
+            }
+            if (!content) {
+                throw new ValidationError("Content is required. Use --markdown, --markdown-file, or --markdown-stdin");
+            }
+            // Enforce the same rule as the web UI: every version must have a description
+            // unless the caller explicitly marks it as a minor change.
+            if (!opts.minor && !opts.description) {
+                throw new ValidationError("--description is required unless --minor is set (minor changes may skip the description)");
+            }
+            // Resolve note ID if it's a display ID
+            const resolvedId = await resolveNoteId(api, cfg.workspaceId, noteId);
+            const data = await api.post(`/api/notes/${resolvedId}/versions`, {
+                content,
+                description: opts.description,
+                isMinor: opts.minor ? true : undefined,
+            });
+            if (cfg.json) {
+                outputJson(data);
+            }
+            else {
+                console.log(`Created version ${data.versionNumber || "new"} for ${noteId}`);
+            }
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+}
+//# sourceMappingURL=versions.js.map

package/dist/commands/versions.js.map

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

package/dist/commands/workspace.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "commander";
+export interface WorkspaceChoice {
+    id: string;
+    name: string;
+}
+/**
+ * Select a workspace from a pre-fetched list, or fetch from the API if not provided.
+ * Auto-selects if only one workspace exists.
+ * Returns null if no workspaces are available.
+ */
+export declare function fetchAndSelectWorkspace(serverUrl: string, token: string, currentWorkspaceId?: string, prefetchedWorkspaces?: Array<Record<string, unknown>>): Promise<WorkspaceChoice | null>;
+export declare function registerWorkspaceCommands(program: Command): void;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/commands/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/commands/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,kBAAkB,CAAC,EAAE,MAAM,EAC3B,oBAAoB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpD,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAoCjC;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiIhE"}