@lotics/cli 0.34.0 → 0.36.0

package/README.md

@@ -39,42 +39,57 @@ lotics auth signup a@b.com --name "Agent"            # non-interactive
 lotics auth web
 ```
 
-**`lotics auth api-key`** — Saves an existing API key directly (e.g. one created in the Lotics web app).
+**`lotics auth api-key`** — Saves an API key (e.g. one created in the Lotics web app). The key belongs to one org, so this **registers that org as a profile** — run it once per org. Registering a second key adds a profile; it does not overwrite the first.
 
 ```bash
 lotics auth api-key                  # interactive prompt
-lotics auth api-key ltk_...          # non-interactive
+lotics auth api-key ltk_...          # registers the key's org as a profile (now active)
 ```
 
-API key is saved to the config file. Run `lotics auth logout` to remove saved credentials.
+Run `lotics auth logout [<name|id>]` to remove a profile (default: the active org), or `lotics auth logout --all` to wipe the store.
 
-Auth priority: `--api-key` flag > `LOTICS_API_KEY` env > config file.
+## Organizations
 
-### Config file location
+Each saved API key belongs to one org. Register a key per org once, then switch freely — no re-pasting:
 
-The CLI resolves `.lotics/config.json` by walking up from the current working directory — the first ancestor that has one wins, otherwise the global `~/.lotics/config.json`. A per-directory config lets a project or worktree pin its own account and workspace; commands run from a subdirectory still resolve to it.
+```bash
+lotics org                          # list saved orgs (marks the active one)
+lotics org use acme                 # switch active org by name (or org id)
+lotics org use "Acme Corp"          # names are case-insensitive
+```
+
+### Working in parallel (worktrees)
 
-Create one by passing `--local` to `lotics auth`:
+Pin a directory to its own org/workspace so a global `org use` elsewhere never disturbs it. The pin is a pointer — the key still comes from the global store, so there's nothing to paste:
 
 ```bash
 cd my-worktree
-lotics auth api-key ltk_... --local      # writes ./.lotics/config.json
-lotics workspace select wks_...          # auto-resolves to the local config
+lotics org use acme --local         # writes ./.lotics/config.json { active_org }
+lotics workspace select wks_...     # records the workspace in the local pin
 ```
 
-`.lotics/` should be gitignored. Note: an exported `LOTICS_API_KEY` overrides the config file's key.
+Each worktree resolves independently; switching the global default in another shell leaves pinned worktrees untouched. Use `lotics auth whoami` to see the active org, workspace, and which source resolved them. `.lotics/` should be gitignored.
+
+### Resolution precedence
+
+```
+--api-key flag  >  LOTICS_API_KEY env  >  LOTICS_ORG env (name|id)
+  >  local .lotics/config.json  >  global active profile
+```
+
+`LOTICS_WORKSPACE` (or `--workspace <id>` / `-w`) overrides the workspace at any level. For ephemeral or CI use, set `LOTICS_API_KEY` instead of saving anything.
 
 ## Workspaces
 
-If your organization has multiple workspaces, select one before running tools:
+Workspaces live inside the active org. If the org has more than one, select before running tools:
 
 ```bash
-lotics workspace                    # list workspaces (marks current)
-lotics workspace select wks_...     # switch to a workspace
+lotics workspace                    # list workspaces in the active org (marks current)
+lotics workspace select wks_...     # set the workspace for the active scope (pin or profile)
 lotics workspace create "Sales"     # create a new workspace (admin only)
 ```
 
-Single-workspace organizations auto-select on first use.
+Single-workspace organizations auto-select on first use. The selection is remembered per org, so switching back lands where you left off.
 
 ## CLI
 
@@ -97,8 +112,11 @@ lotics upload ./report.pdf ./data.csv ./documents/
 lotics run generate_excel_from_template '{"..."}'
 lotics download <file_id> -o ./reports/
 
-# CI / non-interactive
+# CI / non-interactive (key inline)
 LOTICS_API_KEY=ltk_... lotics run query_tables '{}'
+
+# One-off against a saved org/workspace, no switching
+LOTICS_ORG=acme LOTICS_WORKSPACE=wks_... lotics run query_tables '{}'
 ```
 
 ## Local .xlsx and .docx authoring

package/dist/app_commands.d.ts

@@ -86,6 +86,15 @@ export declare function appCreate(client: LoticsClient, args: {
 export declare function appSetSubdomain(client: LoticsClient, args: {
     subdomain: string;
 }): Promise<void>;
+/**
+ * `lotics app rename <name>` — change the current app's display name (the
+ * launcher/title shown in the workspace). The app_id comes from the local
+ * `package.json` manifest. Wraps the `update_app` tool — the public address
+ * (`lotics app subdomain`) and the code (`lotics app deploy`) are unchanged.
+ */
+export declare function appRename(client: LoticsClient, args: {
+    name: string;
+}): Promise<void>;
 export declare function appPull(client: LoticsClient, args: {
     app_id: string;
     targetPath?: string;

package/dist/app_commands.js

@@ -238,6 +238,19 @@ export async function appSetSubdomain(client, args) {
     const result = await client.setAppSubdomain(meta.app_id, args.subdomain);
     console.error(`Public address set: https://${result.public_subdomain}.lotics.app`);
 }
+/**
+ * `lotics app rename <name>` — change the current app's display name (the
+ * launcher/title shown in the workspace). The app_id comes from the local
+ * `package.json` manifest. Wraps the `update_app` tool — the public address
+ * (`lotics app subdomain`) and the code (`lotics app deploy`) are unchanged.
+ */
+export async function appRename(client, args) {
+    const meta = readAppMeta(process.cwd());
+    const res = await client.execute("update_app", { app_id: meta.app_id, name: args.name });
+    if (res.error)
+        throw new Error(res.error);
+    console.error(`App renamed: "${args.name}" (${meta.app_id})`);
+}
 export async function appPull(client, args) {
     const app = await client.getApp(args.app_id);
     if (!app.current_version_id) {

package/dist/args.d.ts

@@ -21,11 +21,13 @@ export declare function parseArgs(argv: string[]): {
         output?: string;
         as?: string;
         apiKey?: string;
+        workspace?: string;
         name?: string;
         timezone?: string;
         message?: string;
         forceWorkflowSync: boolean;
         local: boolean;
+        all: boolean;
         version: boolean;
         help: boolean;
     };

package/dist/args.js

@@ -17,11 +17,13 @@ export function parseArgs(argv) {
         output: undefined,
         as: undefined,
         apiKey: undefined,
+        workspace: undefined,
         name: undefined,
         timezone: undefined,
         message: undefined,
         forceWorkflowSync: false,
         local: false,
+        all: false,
         version: false,
         help: false,
     };
@@ -49,6 +51,10 @@ export function parseArgs(argv) {
             case "--api-key":
                 flags.apiKey = argv[++i];
                 break;
+            case "--workspace":
+            case "-w":
+                flags.workspace = argv[++i];
+                break;
             case "--name":
                 flags.name = argv[++i];
                 break;
@@ -65,6 +71,9 @@ export function parseArgs(argv) {
             case "--local":
                 flags.local = true;
                 break;
+            case "--all":
+                flags.all = true;
+                break;
             case "--version":
             case "-v":
                 flags.version = true;

package/dist/args.test.js

@@ -34,4 +34,32 @@ describe("parseArgs", () => {
         expect(r.flags.forceWorkflowSync).toBe(false);
         expect(r.flags.message).toBeUndefined();
     });
+    it("parses --workspace as a value flag", () => {
+        const r = parseArgs(["run", "query_tables", "{}", "--workspace", "wsp_123"]);
+        expect(r.flags.workspace).toBe("wsp_123");
+        expect(r.command).toBe("run");
+        expect(r.subcommand).toBe("query_tables");
+        expect(r.toolArgs).toBe("{}");
+    });
+    it("parses -w as the workspace alias", () => {
+        const r = parseArgs(["run", "query_tables", "-w", "wsp_123"]);
+        expect(r.flags.workspace).toBe("wsp_123");
+    });
+    it("parses --all as a boolean flag", () => {
+        const r = parseArgs(["auth", "logout", "--all"]);
+        expect(r.flags.all).toBe(true);
+        expect(r.command).toBe("auth");
+        expect(r.subcommand).toBe("logout");
+    });
+    it("defaults workspace to undefined and all to false", () => {
+        const r = parseArgs(["org"]);
+        expect(r.flags.workspace).toBeUndefined();
+        expect(r.flags.all).toBe(false);
+    });
+    it("treats `org use <name>` as command / subcommand / positional", () => {
+        const r = parseArgs(["org", "use", "Acme Corp"]);
+        expect(r.command).toBe("org");
+        expect(r.subcommand).toBe("use");
+        expect(r.toolArgs).toBe("Acme Corp");
+    });
 });