@locusai/commands 0.16.2

package/dist/api-context.d.ts

@@ -0,0 +1,31 @@
+import { LocusClient } from "@locusai/sdk";
+import type { AiProvider } from "@locusai/sdk/node";
+export interface ApiContextOptions {
+    projectPath: string;
+    apiKey?: string;
+    apiUrl?: string;
+    workspaceId?: string;
+    provider?: string;
+    model?: string;
+}
+export interface ApiContext {
+    client: LocusClient;
+    workspaceId: string;
+    apiKey: string;
+    apiBase: string;
+}
+export interface AiSettings {
+    provider: AiProvider;
+    model: string;
+}
+/**
+ * Resolve API context (client + workspace) from options and settings.
+ * Merges explicit options with persisted settings. Throws on missing API key.
+ */
+export declare function resolveApiContext(options: ApiContextOptions): Promise<ApiContext>;
+/**
+ * Resolve AI provider and model from options and settings.
+ * Merges explicit options with persisted settings, applying defaults.
+ */
+export declare function resolveAiSettings(options: ApiContextOptions): AiSettings;
+//# sourceMappingURL=api-context.d.ts.map

package/dist/api-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-context.d.ts","sourceRoot":"","sources":["../src/api-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQpD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CA0BrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAOxE"}

package/dist/api-context.js

@@ -0,0 +1,39 @@
+import { LocusClient } from "@locusai/sdk";
+import { DEFAULT_MODEL } from "@locusai/sdk/node";
+import { resolveProvider } from "./config.js";
+import { SettingsManager } from "./settings.js";
+import { WorkspaceResolver } from "./workspace.js";
+const DEFAULT_API_BASE = "https://api.locusai.dev/api";
+/**
+ * Resolve API context (client + workspace) from options and settings.
+ * Merges explicit options with persisted settings. Throws on missing API key.
+ */
+export async function resolveApiContext(options) {
+    const settings = new SettingsManager(options.projectPath).load();
+    const apiKey = options.apiKey || settings.apiKey;
+    if (!apiKey) {
+        throw new Error("API key is required. Configure with: locus config setup --api-key <key>");
+    }
+    const apiBase = options.apiUrl || settings.apiUrl || DEFAULT_API_BASE;
+    const resolver = new WorkspaceResolver({
+        apiKey,
+        apiBase,
+        workspaceId: options.workspaceId,
+    });
+    const workspaceId = await resolver.resolve();
+    const client = new LocusClient({
+        baseUrl: apiBase,
+        token: apiKey,
+    });
+    return { client, workspaceId, apiKey, apiBase };
+}
+/**
+ * Resolve AI provider and model from options and settings.
+ * Merges explicit options with persisted settings, applying defaults.
+ */
+export function resolveAiSettings(options) {
+    const settings = new SettingsManager(options.projectPath).load();
+    const provider = resolveProvider(options.provider || settings.provider);
+    const model = options.model || settings.model || DEFAULT_MODEL[provider];
+    return { provider, model };
+}

package/dist/artifacts.d.ts

@@ -0,0 +1,42 @@
+export interface ArtifactInfo {
+    name: string;
+    fileName: string;
+    createdAt: Date;
+    size: number;
+}
+/**
+ * List artifacts sorted by creation time (newest first).
+ */
+export declare function listArtifacts(projectPath: string): ArtifactInfo[];
+/**
+ * Read an artifact's content by name (with or without .md extension).
+ */
+export declare function readArtifact(projectPath: string, name: string): {
+    content: string;
+    info: ArtifactInfo;
+} | null;
+/**
+ * Find an artifact by exact or partial name match.
+ *
+ * Returns:
+ * - `{ match, content, info }` if exactly one artifact matches
+ * - `{ ambiguous: ArtifactInfo[] }` if multiple artifacts match
+ * - `null` if no artifacts match
+ */
+export declare function findArtifact(projectPath: string, name: string): {
+    match: true;
+    content: string;
+    info: ArtifactInfo;
+} | {
+    match: false;
+    ambiguous: ArtifactInfo[];
+} | null;
+/**
+ * Format file size for display.
+ */
+export declare function formatSize(bytes: number): string;
+/**
+ * Format a date for display.
+ */
+export declare function formatDate(date: Date): string;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAuBjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CAqBhD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAEV;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACpD;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,YAAY,EAAE,CAAA;CAAE,GAC3C,IAAI,CAyBP;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQ7C"}

package/dist/artifacts.js

@@ -0,0 +1,100 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { getLocusPath } from "@locusai/sdk/node";
+/**
+ * List artifacts sorted by creation time (newest first).
+ */
+export function listArtifacts(projectPath) {
+    const artifactsDir = getLocusPath(projectPath, "artifactsDir");
+    if (!existsSync(artifactsDir)) {
+        return [];
+    }
+    const files = readdirSync(artifactsDir).filter((f) => f.endsWith(".md"));
+    return files
+        .map((fileName) => {
+        const filePath = join(artifactsDir, fileName);
+        const stat = statSync(filePath);
+        const name = fileName.replace(/\.md$/, "");
+        return {
+            name,
+            fileName,
+            createdAt: stat.birthtime,
+            size: stat.size,
+        };
+    })
+        .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+}
+/**
+ * Read an artifact's content by name (with or without .md extension).
+ */
+export function readArtifact(projectPath, name) {
+    const artifactsDir = getLocusPath(projectPath, "artifactsDir");
+    const fileName = name.endsWith(".md") ? name : `${name}.md`;
+    const filePath = join(artifactsDir, fileName);
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    const stat = statSync(filePath);
+    const content = readFileSync(filePath, "utf-8");
+    return {
+        content,
+        info: {
+            name: fileName.replace(/\.md$/, ""),
+            fileName,
+            createdAt: stat.birthtime,
+            size: stat.size,
+        },
+    };
+}
+/**
+ * Find an artifact by exact or partial name match.
+ *
+ * Returns:
+ * - `{ match, content, info }` if exactly one artifact matches
+ * - `{ ambiguous: ArtifactInfo[] }` if multiple artifacts match
+ * - `null` if no artifacts match
+ */
+export function findArtifact(projectPath, name) {
+    // Try exact match first
+    const exact = readArtifact(projectPath, name);
+    if (exact) {
+        return { match: true, content: exact.content, info: exact.info };
+    }
+    // Try partial match
+    const artifacts = listArtifacts(projectPath);
+    const matches = artifacts.filter((a) => a.name.toLowerCase().includes(name.toLowerCase()));
+    if (matches.length === 1) {
+        const result = readArtifact(projectPath, matches[0].name);
+        if (result) {
+            return { match: true, content: result.content, info: result.info };
+        }
+    }
+    if (matches.length > 1) {
+        return { match: false, ambiguous: matches };
+    }
+    return null;
+}
+/**
+ * Format file size for display.
+ */
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    const kb = bytes / 1024;
+    if (kb < 1024)
+        return `${kb.toFixed(1)}KB`;
+    const mb = kb / 1024;
+    return `${mb.toFixed(1)}MB`;
+}
+/**
+ * Format a date for display.
+ */
+export function formatDate(date) {
+    return date.toLocaleDateString("en-US", {
+        year: "numeric",
+        month: "short",
+        day: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+    });
+}

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+import { type AiProvider } from "@locusai/sdk/node";
+/**
+ * Check if a project has been initialized with Locus.
+ */
+export declare function isProjectInitialized(projectPath: string): boolean;
+/**
+ * Resolve and validate AI provider from input string.
+ * Returns the provider or throws an error for invalid input.
+ */
+export declare function resolveProvider(input?: string): AiProvider;
+/**
+ * Mask a secret value for display (show first 4 + last 4 chars).
+ */
+export declare function maskSecret(value: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAA0B,MAAM,mBAAmB,CAAC;AAE5E;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAI1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD"}

package/dist/config.js

@@ -0,0 +1,30 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { LOCUS_CONFIG, PROVIDER } from "@locusai/sdk/node";
+/**
+ * Check if a project has been initialized with Locus.
+ */
+export function isProjectInitialized(projectPath) {
+    const locusDir = join(projectPath, LOCUS_CONFIG.dir);
+    const configPath = join(locusDir, LOCUS_CONFIG.configFile);
+    return existsSync(locusDir) && existsSync(configPath);
+}
+/**
+ * Resolve and validate AI provider from input string.
+ * Returns the provider or throws an error for invalid input.
+ */
+export function resolveProvider(input) {
+    if (!input)
+        return PROVIDER.CLAUDE;
+    if (input === PROVIDER.CLAUDE || input === PROVIDER.CODEX)
+        return input;
+    throw new Error(`Invalid provider '${input}'. Must be 'claude' or 'codex'.`);
+}
+/**
+ * Mask a secret value for display (show first 4 + last 4 chars).
+ */
+export function maskSecret(value) {
+    if (value.length <= 8)
+        return "****";
+    return `${value.slice(0, 4)}...${value.slice(-4)}`;
+}

package/dist/discussions.d.ts

@@ -0,0 +1,26 @@
+import type { DiscussionManager } from "@locusai/sdk/node";
+export interface DiscussionSummary {
+    id: string;
+    title: string;
+    status: string;
+    messageCount: number;
+    insightCount: number;
+    createdAt: string;
+}
+/**
+ * List all discussions with summary info.
+ */
+export declare function listDiscussions(manager: DiscussionManager): DiscussionSummary[];
+/**
+ * Get discussion markdown content. Returns null if not found.
+ */
+export declare function showDiscussion(manager: DiscussionManager, id: string): string | null;
+/**
+ * Archive a discussion by ID. Throws if not found.
+ */
+export declare function archiveDiscussion(manager: DiscussionManager, id: string): void;
+/**
+ * Delete a discussion by ID. Throws if not found.
+ */
+export declare function deleteDiscussion(manager: DiscussionManager, id: string): void;
+//# sourceMappingURL=discussions.d.ts.map

package/dist/discussions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discussions.d.ts","sourceRoot":"","sources":["../src/discussions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,GACzB,iBAAiB,EAAE,CAUrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAEf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,EAAE,EAAE,MAAM,GACT,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,EAAE,EAAE,MAAM,GACT,IAAI,CAEN"}

package/dist/discussions.js

@@ -0,0 +1,32 @@
+/**
+ * List all discussions with summary info.
+ */
+export function listDiscussions(manager) {
+    const discussions = manager.list();
+    return discussions.map((d) => ({
+        id: d.id,
+        title: d.title,
+        status: d.status,
+        messageCount: d.messages.length,
+        insightCount: d.insights.length,
+        createdAt: d.createdAt,
+    }));
+}
+/**
+ * Get discussion markdown content. Returns null if not found.
+ */
+export function showDiscussion(manager, id) {
+    return manager.getMarkdown(id);
+}
+/**
+ * Archive a discussion by ID. Throws if not found.
+ */
+export function archiveDiscussion(manager, id) {
+    manager.archive(id);
+}
+/**
+ * Delete a discussion by ID. Throws if not found.
+ */
+export function deleteDiscussion(manager, id) {
+    manager.delete(id);
+}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { type ApiContext, type ApiContextOptions, type AiSettings, resolveApiContext, resolveAiSettings, } from "./api-context.js";
+export { type ArtifactInfo, findArtifact, formatDate, formatSize, listArtifacts, readArtifact, } from "./artifacts.js";
+export { isProjectInitialized, maskSecret, resolveProvider, } from "./config.js";
+export { type DiscussionSummary, listDiscussions, showDiscussion, archiveDiscussion, deleteDiscussion, } from "./discussions.js";
+export { createCliLogger, createWorkerLogger, type LogFn, noopLogger, } from "./logger.js";
+export { type PlanSummary, listPlans, showPlan, cancelPlan, rejectPlan, } from "./plans.js";
+export { type LocusSettings, SettingsManager, type TelegramSettings, } from "./settings.js";
+export { resolveWorkspaceId, WorkspaceResolver, type WorkspaceResolverOptions, } from "./workspace.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,iBAAiB,EACtB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,KAAK,KAAK,EACV,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,WAAW,EAChB,SAAS,EACT,QAAQ,EACR,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,aAAa,EAClB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,331 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  showPlan: () => showPlan,
+  showDiscussion: () => showDiscussion,
+  resolveWorkspaceId: () => resolveWorkspaceId,
+  resolveProvider: () => resolveProvider,
+  resolveApiContext: () => resolveApiContext,
+  resolveAiSettings: () => resolveAiSettings,
+  rejectPlan: () => rejectPlan,
+  readArtifact: () => readArtifact,
+  noopLogger: () => import_node4.noopLogger,
+  maskSecret: () => maskSecret,
+  listPlans: () => listPlans,
+  listDiscussions: () => listDiscussions,
+  listArtifacts: () => listArtifacts,
+  isProjectInitialized: () => isProjectInitialized,
+  formatSize: () => formatSize,
+  formatDate: () => formatDate,
+  findArtifact: () => findArtifact,
+  deleteDiscussion: () => deleteDiscussion,
+  createWorkerLogger: () => import_node4.createWorkerLogger,
+  createCliLogger: () => createCliLogger,
+  cancelPlan: () => cancelPlan,
+  archiveDiscussion: () => archiveDiscussion,
+  WorkspaceResolver: () => WorkspaceResolver,
+  SettingsManager: () => SettingsManager
+});
+module.exports = __toCommonJS(exports_src);
+
+// src/api-context.ts
+var import_sdk2 = require("@locusai/sdk");
+var import_node5 = require("@locusai/sdk/node");
+
+// src/config.ts
+var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
+var import_node = require("@locusai/sdk/node");
+function isProjectInitialized(projectPath) {
+  const locusDir = import_node_path.join(projectPath, import_node.LOCUS_CONFIG.dir);
+  const configPath = import_node_path.join(locusDir, import_node.LOCUS_CONFIG.configFile);
+  return import_node_fs.existsSync(locusDir) && import_node_fs.existsSync(configPath);
+}
+function resolveProvider(input) {
+  if (!input)
+    return import_node.PROVIDER.CLAUDE;
+  if (input === import_node.PROVIDER.CLAUDE || input === import_node.PROVIDER.CODEX)
+    return input;
+  throw new Error(`Invalid provider '${input}'. Must be 'claude' or 'codex'.`);
+}
+function maskSecret(value) {
+  if (value.length <= 8)
+    return "****";
+  return `${value.slice(0, 4)}...${value.slice(-4)}`;
+}
+
+// src/settings.ts
+var import_node_fs2 = require("node:fs");
+var import_node_path2 = require("node:path");
+var import_node2 = require("@locusai/sdk/node");
+function getSettingsPath(projectPath) {
+  return import_node_path2.join(projectPath, import_node2.LOCUS_CONFIG.dir, import_node2.LOCUS_CONFIG.settingsFile);
+}
+
+class SettingsManager {
+  projectPath;
+  constructor(projectPath) {
+    this.projectPath = projectPath;
+  }
+  load() {
+    const settingsPath = getSettingsPath(this.projectPath);
+    if (!import_node_fs2.existsSync(settingsPath)) {
+      return {};
+    }
+    return JSON.parse(import_node_fs2.readFileSync(settingsPath, "utf-8"));
+  }
+  save(settings) {
+    const { $schema: _, ...rest } = settings;
+    const ordered = { $schema: import_node2.LOCUS_SCHEMAS.settings, ...rest };
+    const settingsPath = getSettingsPath(this.projectPath);
+    import_node_fs2.writeFileSync(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
+  }
+  get(key) {
+    return this.load()[key];
+  }
+  set(key, value) {
+    const settings = this.load();
+    settings[key] = value;
+    this.save(settings);
+  }
+  remove() {
+    const settingsPath = getSettingsPath(this.projectPath);
+    if (import_node_fs2.existsSync(settingsPath)) {
+      import_node_fs2.unlinkSync(settingsPath);
+    }
+  }
+  exists() {
+    return import_node_fs2.existsSync(getSettingsPath(this.projectPath));
+  }
+}
+
+// src/workspace.ts
+var import_sdk = require("@locusai/sdk");
+
+// src/logger.ts
+var import_node3 = require("@locusai/sdk/node");
+var import_node4 = require("@locusai/sdk/node");
+function createCliLogger() {
+  return (message, level) => {
+    const icon = level === "success" ? import_node3.c.success("✔") : level === "error" ? import_node3.c.error("✖") : level === "warn" ? import_node3.c.warning("!") : import_node3.c.info("●");
+    console.log(`  ${icon} ${message}`);
+  };
+}
+
+// src/workspace.ts
+class WorkspaceResolver {
+  options;
+  constructor(options) {
+    this.options = options;
+  }
+  async resolve() {
+    if (this.options.workspaceId) {
+      return this.options.workspaceId;
+    }
+    const log = this.options.log ?? import_node4.noopLogger;
+    try {
+      log("Resolving workspace from API key...");
+      const client = new import_sdk.LocusClient({
+        baseUrl: this.options.apiBase,
+        token: this.options.apiKey
+      });
+      const info = await client.auth.getApiKeyInfo();
+      if (info.workspaceId) {
+        log(`Resolved workspace: ${info.workspaceId}`);
+        return info.workspaceId;
+      }
+      throw new Error("API key is not associated with a workspace. Please specify a workspace ID.");
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("API key is not")) {
+        throw error;
+      }
+      throw new Error(`Error resolving workspace: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+}
+async function resolveWorkspaceId(client, workspaceId) {
+  if (workspaceId) {
+    return workspaceId;
+  }
+  const info = await client.auth.getApiKeyInfo();
+  if (info.workspaceId) {
+    return info.workspaceId;
+  }
+  throw new Error("Could not resolve workspace from API key. Please set workspaceId in settings.");
+}
+
+// src/api-context.ts
+var DEFAULT_API_BASE = "https://api.locusai.dev/api";
+async function resolveApiContext(options) {
+  const settings = new SettingsManager(options.projectPath).load();
+  const apiKey = options.apiKey || settings.apiKey;
+  if (!apiKey) {
+    throw new Error("API key is required. Configure with: locus config setup --api-key <key>");
+  }
+  const apiBase = options.apiUrl || settings.apiUrl || DEFAULT_API_BASE;
+  const resolver = new WorkspaceResolver({
+    apiKey,
+    apiBase,
+    workspaceId: options.workspaceId
+  });
+  const workspaceId = await resolver.resolve();
+  const client = new import_sdk2.LocusClient({
+    baseUrl: apiBase,
+    token: apiKey
+  });
+  return { client, workspaceId, apiKey, apiBase };
+}
+function resolveAiSettings(options) {
+  const settings = new SettingsManager(options.projectPath).load();
+  const provider = resolveProvider(options.provider || settings.provider);
+  const model = options.model || settings.model || import_node5.DEFAULT_MODEL[provider];
+  return { provider, model };
+}
+// src/artifacts.ts
+var import_node_fs3 = require("node:fs");
+var import_node_path3 = require("node:path");
+var import_node6 = require("@locusai/sdk/node");
+function listArtifacts(projectPath) {
+  const artifactsDir = import_node6.getLocusPath(projectPath, "artifactsDir");
+  if (!import_node_fs3.existsSync(artifactsDir)) {
+    return [];
+  }
+  const files = import_node_fs3.readdirSync(artifactsDir).filter((f) => f.endsWith(".md"));
+  return files.map((fileName) => {
+    const filePath = import_node_path3.join(artifactsDir, fileName);
+    const stat = import_node_fs3.statSync(filePath);
+    const name = fileName.replace(/\.md$/, "");
+    return {
+      name,
+      fileName,
+      createdAt: stat.birthtime,
+      size: stat.size
+    };
+  }).sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+}
+function readArtifact(projectPath, name) {
+  const artifactsDir = import_node6.getLocusPath(projectPath, "artifactsDir");
+  const fileName = name.endsWith(".md") ? name : `${name}.md`;
+  const filePath = import_node_path3.join(artifactsDir, fileName);
+  if (!import_node_fs3.existsSync(filePath)) {
+    return null;
+  }
+  const stat = import_node_fs3.statSync(filePath);
+  const content = import_node_fs3.readFileSync(filePath, "utf-8");
+  return {
+    content,
+    info: {
+      name: fileName.replace(/\.md$/, ""),
+      fileName,
+      createdAt: stat.birthtime,
+      size: stat.size
+    }
+  };
+}
+function findArtifact(projectPath, name) {
+  const exact = readArtifact(projectPath, name);
+  if (exact) {
+    return { match: true, content: exact.content, info: exact.info };
+  }
+  const artifacts = listArtifacts(projectPath);
+  const matches = artifacts.filter((a) => a.name.toLowerCase().includes(name.toLowerCase()));
+  if (matches.length === 1) {
+    const result = readArtifact(projectPath, matches[0].name);
+    if (result) {
+      return { match: true, content: result.content, info: result.info };
+    }
+  }
+  if (matches.length > 1) {
+    return { match: false, ambiguous: matches };
+  }
+  return null;
+}
+function formatSize(bytes) {
+  if (bytes < 1024)
+    return `${bytes}B`;
+  const kb = bytes / 1024;
+  if (kb < 1024)
+    return `${kb.toFixed(1)}KB`;
+  const mb = kb / 1024;
+  return `${mb.toFixed(1)}MB`;
+}
+function formatDate(date) {
+  return date.toLocaleDateString("en-US", {
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+// src/discussions.ts
+function listDiscussions(manager) {
+  const discussions = manager.list();
+  return discussions.map((d) => ({
+    id: d.id,
+    title: d.title,
+    status: d.status,
+    messageCount: d.messages.length,
+    insightCount: d.insights.length,
+    createdAt: d.createdAt
+  }));
+}
+function showDiscussion(manager, id) {
+  return manager.getMarkdown(id);
+}
+function archiveDiscussion(manager, id) {
+  manager.archive(id);
+}
+function deleteDiscussion(manager, id) {
+  manager.delete(id);
+}
+// src/plans.ts
+function listPlans(manager, status) {
+  const plans = manager.list(status);
+  return plans.map((p) => ({
+    id: p.id,
+    name: p.name,
+    status: p.status,
+    taskCount: p.tasks.length,
+    directive: p.directive,
+    createdAt: p.createdAt,
+    feedback: p.feedback
+  }));
+}
+function showPlan(manager, idOrSlug) {
+  return manager.getMarkdown(idOrSlug);
+}
+function cancelPlan(manager, idOrSlug) {
+  manager.cancel(idOrSlug);
+}
+function rejectPlan(manager, idOrSlug, feedback) {
+  return manager.reject(idOrSlug, feedback);
+}

package/dist/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Standardized logging utilities for Locus packages.
+ *
+ * Re-exports core logger types from SDK and adds CLI-specific factories.
+ */
+export type { LogFn } from "@locusai/sdk/node";
+export { createWorkerLogger, noopLogger } from "@locusai/sdk/node";
+/**
+ * Creates a CLI-style logger with colored icons.
+ * Used by CLI commands (discuss, plan, docs, review) for consistent output.
+ *
+ * Output format: `  ● message` (with level-appropriate icon and color)
+ */
+export declare function createCliLogger(): (message: string, level?: "info" | "success" | "warn" | "error") => void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,eAAe,KACrB,SAAS,MAAM,EAAE,QAAQ,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,UAWvE"}

package/dist/logger.js

@@ -0,0 +1,26 @@
+/**
+ * Standardized logging utilities for Locus packages.
+ *
+ * Re-exports core logger types from SDK and adds CLI-specific factories.
+ */
+import { c } from "@locusai/sdk/node";
+// Re-export core logging primitives from SDK
+export { createWorkerLogger, noopLogger } from "@locusai/sdk/node";
+/**
+ * Creates a CLI-style logger with colored icons.
+ * Used by CLI commands (discuss, plan, docs, review) for consistent output.
+ *
+ * Output format: `  ● message` (with level-appropriate icon and color)
+ */
+export function createCliLogger() {
+    return (message, level) => {
+        const icon = level === "success"
+            ? c.success("✔")
+            : level === "error"
+                ? c.error("✖")
+                : level === "warn"
+                    ? c.warning("!")
+                    : c.info("●");
+        console.log(`  ${icon} ${message}`);
+    };
+}

package/dist/plans.d.ts

@@ -0,0 +1,28 @@
+import type { PlanManager, SprintPlan } from "@locusai/sdk/node";
+export interface PlanSummary {
+    id: string;
+    name: string;
+    status: string;
+    taskCount: number;
+    directive: string;
+    createdAt: string;
+    feedback?: string;
+}
+/**
+ * List all plans with summary info.
+ */
+export declare function listPlans(manager: PlanManager, status?: SprintPlan["status"]): PlanSummary[];
+/**
+ * Get plan markdown content. Returns null if not found.
+ */
+export declare function showPlan(manager: PlanManager, idOrSlug: string): string | null;
+/**
+ * Cancel a plan by ID. Throws if not found.
+ */
+export declare function cancelPlan(manager: PlanManager, idOrSlug: string): void;
+/**
+ * Reject a plan with feedback. Throws if not found or not pending.
+ * Returns the rejected plan.
+ */
+export declare function rejectPlan(manager: PlanManager, idOrSlug: string, feedback: string): SprintPlan;
+//# sourceMappingURL=plans.d.ts.map

package/dist/plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,GAC5B,WAAW,EAAE,CAWf;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAEf;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEvE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,UAAU,CAEZ"}

package/dist/plans.js

@@ -0,0 +1,34 @@
+/**
+ * List all plans with summary info.
+ */
+export function listPlans(manager, status) {
+    const plans = manager.list(status);
+    return plans.map((p) => ({
+        id: p.id,
+        name: p.name,
+        status: p.status,
+        taskCount: p.tasks.length,
+        directive: p.directive,
+        createdAt: p.createdAt,
+        feedback: p.feedback,
+    }));
+}
+/**
+ * Get plan markdown content. Returns null if not found.
+ */
+export function showPlan(manager, idOrSlug) {
+    return manager.getMarkdown(idOrSlug);
+}
+/**
+ * Cancel a plan by ID. Throws if not found.
+ */
+export function cancelPlan(manager, idOrSlug) {
+    manager.cancel(idOrSlug);
+}
+/**
+ * Reject a plan with feedback. Throws if not found or not pending.
+ * Returns the rejected plan.
+ */
+export function rejectPlan(manager, idOrSlug, feedback) {
+    return manager.reject(idOrSlug, feedback);
+}

package/dist/settings.d.ts

@@ -0,0 +1,25 @@
+export interface TelegramSettings {
+    botToken?: string;
+    chatId?: number;
+    testMode?: boolean;
+}
+export interface LocusSettings {
+    $schema?: string;
+    apiKey?: string;
+    apiUrl?: string;
+    provider?: string;
+    model?: string;
+    workspaceId?: string;
+    telegram?: TelegramSettings;
+}
+export declare class SettingsManager {
+    private projectPath;
+    constructor(projectPath: string);
+    load(): LocusSettings;
+    save(settings: LocusSettings): void;
+    get<K extends keyof LocusSettings>(key: K): LocusSettings[K];
+    set<K extends keyof LocusSettings>(key: K, value: LocusSettings[K]): void;
+    remove(): void;
+    exists(): boolean;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAMD,qBAAa,eAAe;IACd,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAEvC,IAAI,IAAI,aAAa;IAQrB,IAAI,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAOnC,GAAG,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,GAAG,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IAI5D,GAAG,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAMzE,MAAM,IAAI,IAAI;IAOd,MAAM,IAAI,OAAO;CAGlB"}

package/dist/settings.js

@@ -0,0 +1,42 @@
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { LOCUS_CONFIG, LOCUS_SCHEMAS } from "@locusai/sdk/node";
+function getSettingsPath(projectPath) {
+    return join(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.settingsFile);
+}
+export class SettingsManager {
+    projectPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    load() {
+        const settingsPath = getSettingsPath(this.projectPath);
+        if (!existsSync(settingsPath)) {
+            return {};
+        }
+        return JSON.parse(readFileSync(settingsPath, "utf-8"));
+    }
+    save(settings) {
+        const { $schema: _, ...rest } = settings;
+        const ordered = { $schema: LOCUS_SCHEMAS.settings, ...rest };
+        const settingsPath = getSettingsPath(this.projectPath);
+        writeFileSync(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
+    }
+    get(key) {
+        return this.load()[key];
+    }
+    set(key, value) {
+        const settings = this.load();
+        settings[key] = value;
+        this.save(settings);
+    }
+    remove() {
+        const settingsPath = getSettingsPath(this.projectPath);
+        if (existsSync(settingsPath)) {
+            unlinkSync(settingsPath);
+        }
+    }
+    exists() {
+        return existsSync(getSettingsPath(this.projectPath));
+    }
+}

package/dist/workspace.d.ts

@@ -0,0 +1,19 @@
+import { LocusClient } from "@locusai/sdk";
+export interface WorkspaceResolverOptions {
+    apiKey: string;
+    apiBase: string;
+    workspaceId?: string;
+    log?: (message: string) => void;
+}
+export declare class WorkspaceResolver {
+    private options;
+    constructor(options: WorkspaceResolverOptions);
+    resolve(): Promise<string>;
+}
+/**
+ * Convenience function to resolve workspace ID.
+ * If workspaceId is provided, returns it directly.
+ * Otherwise resolves from API key info.
+ */
+export declare function resolveWorkspaceId(client: LocusClient, workspaceId?: string): Promise<string>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,wBAAwB;IAE/C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAiCjC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/workspace.js

@@ -0,0 +1,48 @@
+import { LocusClient } from "@locusai/sdk";
+import { noopLogger } from "./logger.js";
+export class WorkspaceResolver {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async resolve() {
+        if (this.options.workspaceId) {
+            return this.options.workspaceId;
+        }
+        const log = this.options.log ?? noopLogger;
+        try {
+            log("Resolving workspace from API key...");
+            const client = new LocusClient({
+                baseUrl: this.options.apiBase,
+                token: this.options.apiKey,
+            });
+            const info = await client.auth.getApiKeyInfo();
+            if (info.workspaceId) {
+                log(`Resolved workspace: ${info.workspaceId}`);
+                return info.workspaceId;
+            }
+            throw new Error("API key is not associated with a workspace. Please specify a workspace ID.");
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes("API key is not")) {
+                throw error;
+            }
+            throw new Error(`Error resolving workspace: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+/**
+ * Convenience function to resolve workspace ID.
+ * If workspaceId is provided, returns it directly.
+ * Otherwise resolves from API key info.
+ */
+export async function resolveWorkspaceId(client, workspaceId) {
+    if (workspaceId) {
+        return workspaceId;
+    }
+    const info = await client.auth.getApiKeyInfo();
+    if (info.workspaceId) {
+        return info.workspaceId;
+    }
+    throw new Error("Could not resolve workspace from API key. Please set workspaceId in settings.");
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@locusai/commands",
+  "version": "0.16.2",
+  "description": "Shared command logic for Locus CLI and Telegram bot",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node --format cjs --external @locusai/sdk --external @locusai/shared --external zod && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "lint": "biome lint .",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf node_modules"
+  },
+  "dependencies": {
+    "@locusai/sdk": "^0.16.2",
+    "@locusai/shared": "^0.16.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "@types/node": "^22.10.7"
+  }
+}