@baseworks/organization 0.2.0

package/dist/chunk-5UCSEIJS.js

@@ -0,0 +1,64 @@
+// src/schema/sqlite/organizations.ts
+import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+var organizations = sqliteTable("organizations", {
+  id: text("id").primaryKey(),
+  shortId: text("short_id").notNull().unique(),
+  slug: text("slug").notNull().unique(),
+  name: text("name").notNull(),
+  metadata: text("metadata"),
+  // JSON: { logo_url, website, ... }
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull()
+});
+
+// src/schema/sqlite/workspaces.ts
+import { integer as integer2, sqliteTable as sqliteTable2, text as text2, uniqueIndex } from "drizzle-orm/sqlite-core";
+var workspaces = sqliteTable2("workspaces", {
+  id: text2("id").primaryKey(),
+  organizationId: text2("organization_id").notNull().references(() => organizations.id, { onDelete: "cascade" }),
+  shortId: text2("short_id").notNull().unique(),
+  slug: text2("slug").notNull(),
+  name: text2("name").notNull(),
+  isDefault: integer2("is_default", { mode: "boolean" }).notNull().default(false),
+  createdAt: integer2("created_at").notNull(),
+  updatedAt: integer2("updated_at").notNull()
+}, (t) => ({
+  orgSlugUniq: uniqueIndex("workspaces_org_slug_uniq").on(t.organizationId, t.slug)
+}));
+
+// src/schema/sqlite/projects.ts
+import { integer as integer3, sqliteTable as sqliteTable3, text as text3, uniqueIndex as uniqueIndex2 } from "drizzle-orm/sqlite-core";
+var projects = sqliteTable3("projects", {
+  id: text3("id").primaryKey(),
+  workspaceId: text3("workspace_id").notNull().references(() => workspaces.id, { onDelete: "cascade" }),
+  shortId: text3("short_id").notNull().unique(),
+  slug: text3("slug").notNull(),
+  name: text3("name").notNull(),
+  isDefault: integer3("is_default", { mode: "boolean" }).notNull().default(false),
+  metadata: text3("metadata"),
+  createdAt: integer3("created_at").notNull(),
+  updatedAt: integer3("updated_at").notNull()
+}, (t) => ({
+  workspaceSlugUniq: uniqueIndex2("projects_workspace_slug_uniq").on(t.workspaceId, t.slug)
+}));
+
+// src/schema/sqlite/environments.ts
+import { integer as integer4, sqliteTable as sqliteTable4, text as text4, uniqueIndex as uniqueIndex3 } from "drizzle-orm/sqlite-core";
+var environments = sqliteTable4("environments", {
+  id: text4("id").primaryKey(),
+  projectId: text4("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  shortId: text4("short_id").notNull().unique(),
+  slug: text4("slug").notNull(),
+  name: text4("name").notNull(),
+  createdAt: integer4("created_at").notNull(),
+  updatedAt: integer4("updated_at").notNull()
+}, (t) => ({
+  projectSlugUniq: uniqueIndex3("environments_project_slug_uniq").on(t.projectId, t.slug)
+}));
+
+export {
+  organizations,
+  workspaces,
+  projects,
+  environments
+};

package/dist/cli.d.ts

@@ -0,0 +1,18 @@
+import { Command } from 'commander';
+import { ApiClient } from '@baseworks/cli/client';
+import { ContextManager } from '@baseworks/cli/context';
+
+interface OrgCliDeps {
+    http: ApiClient;
+    ctx: ContextManager<Record<string, string | undefined>>;
+    appBase: string;
+    cliName?: string;
+}
+declare function buildOrgCommand(deps: OrgCliDeps): Command;
+declare function buildWsCommand(deps: OrgCliDeps): Command;
+declare function buildProjCommand(deps: OrgCliDeps): Command;
+declare function buildEnvCommand(deps: OrgCliDeps): Command;
+declare function addGlobalCommands(program: Command, deps: OrgCliDeps): void;
+declare function orgCommand(deps: OrgCliDeps): Command;
+
+export { type OrgCliDeps, addGlobalCommands, buildEnvCommand, buildOrgCommand, buildProjCommand, buildWsCommand, orgCommand };

package/dist/cli.js

@@ -0,0 +1,534 @@
+// src/cli.ts
+import { Command } from "commander";
+import { clr, kv, table, summary, success, warn, fatal, printOutput, outputOption, prompt } from "@baseworks/cli/display";
+import { fmtDate } from "@baseworks/cli/fmt";
+import { tree } from "@baseworks/cli/tree";
+function activeOrgSlug(ctx, cliName, flagOrg) {
+  return flagOrg ?? ctx.getContext()?.["org"] ?? ctx.loadConfig()["activeOrg"] ?? fatal(`No active org. Run: ${cliName} use <org>`);
+}
+function activeWsSlug(ctx, cliName, flagWs) {
+  return flagWs ?? ctx.getContext()?.["workspace"] ?? fatal(`No active workspace. Run: ${cliName} use <org>/<ws>`);
+}
+function activeProjSlug(ctx, cliName, flagProj) {
+  return flagProj ?? ctx.getContext()?.["project"] ?? fatal(`No active project. Run: ${cliName} use <org>/<ws>/<proj>`);
+}
+function buildOrgCommand(deps) {
+  const { http } = deps;
+  const cli = deps.cliName ?? "cli";
+  const cmd = new Command("org").description("Organization management").option(...outputOption()).action(async (opts) => {
+    const res = await http.get("/v1/orgs").catch((e) => {
+      console.error(e.message);
+      process.exit(1);
+    });
+    printOutput(res.orgs, opts.output, (wide) => {
+      table(res.orgs, [
+        { key: "shortId", label: "ID" },
+        { key: "slug", label: "SLUG" },
+        { key: "name", label: "NAME" },
+        { key: "createdAt", label: "CREATED", wide: true, fmt: (v) => fmtDate(v) },
+        { key: "id", label: "FULL ID", wide: true }
+      ], { wide, emptyHint: `No orgs yet.  Run: ${cli} org create --name <n>` });
+      summary(`${res.orgs.length} org${res.orgs.length !== 1 ? "s" : ""}`);
+    }, "slug");
+  });
+  cmd.addCommand(
+    new Command("create").description("Create a new organization").requiredOption("--name <name>", "Display name").option("--slug <slug>", "URL slug (auto-generated if omitted)").action(async (opts) => {
+      const res = await http.post("/v1/orgs", { name: opts.name, slug: opts.slug }).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Org created: ${res.org.slug}`);
+      kv([["id", res.org.shortId], ["slug", res.org.slug]]);
+    })
+  );
+  cmd.addCommand(
+    new Command("get").argument("<slug>").description("Get org details").option(...outputOption()).action(async (slug, opts) => {
+      const res = await http.get(`/v1/orgs/${slug}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      const meta2 = res.org.metadata ?? {};
+      printOutput(res.org, opts.output, () => {
+        kv([["id", res.org.shortId], ["slug", res.org.slug], ["name", res.org.name], ["full_id", res.org.id]]);
+        if (Object.keys(meta2).length) {
+          console.log(`  ${clr.dim}\u2500\u2500 metadata \u2500\u2500${clr.reset}`);
+          kv(Object.entries(meta2).map(([k, v]) => [k, JSON.stringify(v)]));
+        }
+      }, "slug");
+    })
+  );
+  cmd.addCommand(
+    new Command("update").argument("<slug>").description("Update org name or slug").option("--name <name>", "New display name").option("--slug <new-slug>", "New URL slug").action(async (slug, opts) => {
+      if (!opts.name && !opts.slug) {
+        warn("Provide at least --name or --slug");
+        return;
+      }
+      const body = {};
+      if (opts.name) body["name"] = opts.name;
+      if (opts.slug) body["slug"] = opts.slug;
+      const res = await http.patch(`/v1/orgs/${slug}`, body).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success("Org updated.");
+      kv([["id", res.org.shortId], ["slug", res.org.slug], ["name", res.org.name]]);
+    })
+  );
+  cmd.addCommand(
+    new Command("delete").argument("<slug>").description("Delete an organization").action(async (slug) => {
+      await http.del(`/v1/orgs/${slug}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Org deleted: ${slug}`);
+    })
+  );
+  const meta = new Command("meta").description("Manage org metadata");
+  meta.addCommand(
+    new Command("get").argument("<slug>").argument("[key]").description("Show metadata (all or one key)").action(async (slug, key) => {
+      const res = await http.get(`/v1/orgs/${slug}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      const m = res.org.metadata ?? {};
+      if (key) {
+        const val = m[key];
+        if (val === void 0) warn(`Key '${key}' not found.`);
+        else console.log(`  ${clr.dim}${key}${clr.reset}  ${JSON.stringify(val)}`);
+      } else if (!Object.keys(m).length) {
+        console.log(`  ${clr.dim}(no metadata)${clr.reset}`);
+      } else {
+        kv(Object.entries(m).map(([k, v]) => [k, JSON.stringify(v)]));
+      }
+    })
+  );
+  meta.addCommand(
+    new Command("set").argument("<slug>").argument("<key>").argument("<value>").description("Set a metadata key (JSON or string)").action(async (slug, key, value) => {
+      let parsed;
+      try {
+        parsed = JSON.parse(value);
+      } catch {
+        parsed = value;
+      }
+      await http.patch(`/v1/orgs/${slug}/metadata`, { [key]: parsed }).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Metadata key '${key}' set.`);
+    })
+  );
+  meta.addCommand(
+    new Command("delete-key").argument("<slug>").argument("<key>").description("Remove a metadata key").action(async (slug, key) => {
+      await http.del(`/v1/orgs/${slug}/metadata/${key}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Metadata key '${key}' deleted.`);
+    })
+  );
+  cmd.addCommand(meta);
+  return cmd;
+}
+function buildWsCommand(deps) {
+  const { http, ctx } = deps;
+  const cli = deps.cliName ?? "cli";
+  const cmd = new Command("ws").alias("workspace").description("Workspace management").enablePositionalOptions().option("--org <slug>", "Override active org").option(...outputOption()).action(async (opts) => {
+    const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+    const res = await http.get(`/v1/orgs/${orgSlug}/workspaces`).catch((e) => {
+      console.error(e.message);
+      process.exit(1);
+    });
+    printOutput(res.workspaces, opts.output, (wide) => {
+      table(res.workspaces, [
+        { key: "shortId", label: "ID" },
+        { key: "slug", label: "SLUG" },
+        { key: "name", label: "NAME" },
+        { key: "isDefault", label: "DEFAULT", fmt: (v) => v ? "\u2713" : "" },
+        { key: "id", label: "FULL ID", wide: true }
+      ], { wide, emptyHint: `No workspaces yet.  Run: ${cli} ws create --name <n>` });
+      summary(`${res.workspaces.length} workspace${res.workspaces.length !== 1 ? "s" : ""}`);
+    }, "slug");
+  });
+  cmd.addCommand(
+    new Command("create").description("Create a workspace").requiredOption("--name <name>", "Display name").option("--slug <slug>", "URL slug (auto-generated if omitted)").option("--org <slug>", "Override active org").action(async (opts) => {
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const res = await http.post(`/v1/orgs/${orgSlug}/workspaces`, { name: opts.name, slug: opts.slug }).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Workspace created: ${res.workspace.slug}`);
+      kv([["id", res.workspace.shortId], ["slug", res.workspace.slug]]);
+    })
+  );
+  cmd.addCommand(
+    new Command("get").argument("<ref>").description("Get workspace details").option("--org <slug>", "Override active org").option(...outputOption()).action(async (ref, opts) => {
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const res = await http.get(`/v1/orgs/${orgSlug}/workspaces/${ref}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      printOutput(res.workspace, opts.output, () => {
+        kv([["id", res.workspace.shortId], ["slug", res.workspace.slug], ["name", res.workspace.name], ["full_id", res.workspace.id]]);
+      }, "slug");
+    })
+  );
+  cmd.addCommand(
+    new Command("update").argument("<ref>").description("Update a workspace").option("--name <name>", "New display name").option("--slug <new-slug>", "New URL slug").option("--org <slug>", "Override active org").action(async (ref, opts) => {
+      if (!opts.name && !opts.slug) {
+        warn("Provide at least --name or --slug");
+        return;
+      }
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const body = {};
+      if (opts.name) body["name"] = opts.name;
+      if (opts.slug) body["slug"] = opts.slug;
+      const res = await http.patch(`/v1/orgs/${orgSlug}/workspaces/${ref}`, body).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success("Workspace updated.");
+      kv([["id", res.workspace.shortId], ["slug", res.workspace.slug], ["name", res.workspace.name]]);
+    })
+  );
+  cmd.addCommand(
+    new Command("delete").argument("<ref>").description("Delete a workspace").option("--org <slug>", "Override active org").action(async (ref, opts) => {
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      await http.del(`/v1/orgs/${orgSlug}/workspaces/${ref}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Workspace deleted: ${ref}`);
+    })
+  );
+  return cmd;
+}
+function buildProjCommand(deps) {
+  const { http, ctx } = deps;
+  const cli = deps.cliName ?? "cli";
+  const cmd = new Command("proj").alias("project").description("Project management").enablePositionalOptions().option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").option(...outputOption()).action(async (opts) => {
+    const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+    const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+    const res = await http.get(`/v1/orgs/${orgSlug}/workspaces/${wsSlug}/projects`).catch((e) => {
+      console.error(e.message);
+      process.exit(1);
+    });
+    printOutput(res.projects, opts.output, (wide) => {
+      table(res.projects, [
+        { key: "shortId", label: "ID" },
+        { key: "slug", label: "SLUG" },
+        { key: "name", label: "NAME" },
+        { key: "isDefault", label: "DEFAULT", fmt: (v) => v ? "\u2713" : "" },
+        { key: "id", label: "FULL ID", wide: true }
+      ], { wide, emptyHint: `No projects yet.  Run: ${cli} proj create --name <n>` });
+      summary(`${res.projects.length} project${res.projects.length !== 1 ? "s" : ""}`);
+    }, "slug");
+  });
+  cmd.addCommand(
+    new Command("create").description("Create a project").requiredOption("--name <name>", "Display name").option("--slug <slug>", "URL slug (auto-generated if omitted)").option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").action(async (opts) => {
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+      const res = await http.post(`/v1/orgs/${orgSlug}/workspaces/${wsSlug}/projects`, { name: opts.name, slug: opts.slug }).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Project created: ${res.project.slug}`);
+      kv([["id", res.project.shortId], ["slug", res.project.slug]]);
+    })
+  );
+  cmd.addCommand(
+    new Command("get").argument("<ref>").description("Get project details").option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").option(...outputOption()).action(async (ref, opts) => {
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+      const res = await http.get(`/v1/orgs/${orgSlug}/workspaces/${wsSlug}/projects/${ref}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      printOutput(res.project, opts.output, () => {
+        kv([["id", res.project.shortId], ["slug", res.project.slug], ["name", res.project.name], ["full_id", res.project.id]]);
+      }, "slug");
+    })
+  );
+  cmd.addCommand(
+    new Command("update").argument("<ref>").description("Update a project").option("--name <name>", "New display name").option("--slug <new-slug>", "New URL slug").option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").action(async (ref, opts) => {
+      if (!opts.name && !opts.slug) {
+        warn("Provide at least --name or --slug");
+        return;
+      }
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+      const body = {};
+      if (opts.name) body["name"] = opts.name;
+      if (opts.slug) body["slug"] = opts.slug;
+      const res = await http.patch(`/v1/orgs/${orgSlug}/workspaces/${wsSlug}/projects/${ref}`, body).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success("Project updated.");
+      kv([["id", res.project.shortId], ["slug", res.project.slug], ["name", res.project.name]]);
+    })
+  );
+  cmd.addCommand(
+    new Command("delete").argument("<ref>").description("Delete a project").option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").action(async (ref, opts) => {
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+      await http.del(`/v1/orgs/${orgSlug}/workspaces/${wsSlug}/projects/${ref}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Project deleted: ${ref}`);
+    })
+  );
+  return cmd;
+}
+function buildEnvCommand(deps) {
+  const { http, ctx } = deps;
+  const cli = deps.cliName ?? "cli";
+  function basePath(orgSlug, wsSlug, projSlug) {
+    return `/v1/orgs/${orgSlug}/workspaces/${wsSlug}/projects/${projSlug}/envs`;
+  }
+  const cmd = new Command("env").description("Environment management").enablePositionalOptions().option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").option("--proj <slug>", "Override active project").option(...outputOption()).action(async (opts) => {
+    const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+    const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+    const projSlug = activeProjSlug(ctx, cli, opts.proj);
+    const res = await http.get(basePath(orgSlug, wsSlug, projSlug)).catch((e) => {
+      console.error(e.message);
+      process.exit(1);
+    });
+    printOutput(res.envs, opts.output, (wide) => {
+      table(res.envs, [
+        { key: "shortId", label: "ID" },
+        { key: "slug", label: "SLUG" },
+        { key: "name", label: "NAME" },
+        { key: "isDefault", label: "DEFAULT", fmt: (v) => v ? "\u2713" : "" },
+        { key: "id", label: "FULL ID", wide: true }
+      ], { wide, emptyHint: `No envs yet.  Run: ${cli} env create --name <n>` });
+      summary(`${res.envs.length} env${res.envs.length !== 1 ? "s" : ""}`);
+    }, "slug");
+  });
+  cmd.addCommand(
+    new Command("create").description("Create an environment").requiredOption("--name <name>", "Display name").option("--slug <slug>", "URL slug (auto-generated if omitted)").option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").option("--proj <slug>", "Override active project").action(async (opts) => {
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+      const projSlug = activeProjSlug(ctx, cli, opts.proj);
+      const res = await http.post(basePath(orgSlug, wsSlug, projSlug), { name: opts.name, slug: opts.slug }).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Env created: ${res.env.slug}`);
+      kv([["id", res.env.shortId], ["slug", res.env.slug]]);
+    })
+  );
+  cmd.addCommand(
+    new Command("get").argument("<ref>").description("Get environment details").option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").option("--proj <slug>", "Override active project").option(...outputOption()).action(async (ref, opts) => {
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+      const projSlug = activeProjSlug(ctx, cli, opts.proj);
+      const res = await http.get(`${basePath(orgSlug, wsSlug, projSlug)}/${ref}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      printOutput(res.env, opts.output, () => {
+        kv([["id", res.env.shortId], ["slug", res.env.slug], ["name", res.env.name], ["full_id", res.env.id]]);
+      }, "slug");
+    })
+  );
+  cmd.addCommand(
+    new Command("update").argument("<ref>").description("Update an environment").option("--name <name>", "New display name").option("--slug <new-slug>", "New URL slug").option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").option("--proj <slug>", "Override active project").action(async (ref, opts) => {
+      if (!opts.name && !opts.slug) {
+        warn("Provide at least --name or --slug");
+        return;
+      }
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+      const projSlug = activeProjSlug(ctx, cli, opts.proj);
+      const body = {};
+      if (opts.name) body["name"] = opts.name;
+      if (opts.slug) body["slug"] = opts.slug;
+      const res = await http.patch(`${basePath(orgSlug, wsSlug, projSlug)}/${ref}`, body).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success("Env updated.");
+      kv([["id", res.env.shortId], ["slug", res.env.slug], ["name", res.env.name]]);
+    })
+  );
+  cmd.addCommand(
+    new Command("delete").argument("<ref>").description("Delete an environment").option("--org <slug>", "Override active org").option("--ws <slug>", "Override active workspace").option("--proj <slug>", "Override active project").action(async (ref, opts) => {
+      const orgSlug = activeOrgSlug(ctx, cli, opts.org);
+      const wsSlug = activeWsSlug(ctx, cli, opts.ws);
+      const projSlug = activeProjSlug(ctx, cli, opts.proj);
+      await http.del(`${basePath(orgSlug, wsSlug, projSlug)}/${ref}`).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      success(`Env deleted: ${ref}`);
+    })
+  );
+  return cmd;
+}
+function addGlobalCommands(program, deps) {
+  const { http, ctx } = deps;
+  const cli = deps.cliName ?? "cli";
+  program.addCommand(
+    new Command("use").alias("context").description("Set active org / workspace / project (interactive if no arg)").argument("[path]", "org  or  org/ws  or  org/ws/proj").action(async (path) => {
+      await runUseCommand(http, ctx, path);
+    })
+  );
+  program.addCommand(
+    new Command("ls").description("Tree view of all orgs, workspaces, and projects").action(async () => {
+      const ctxData = ctx.getContext();
+      const activeOrg = ctxData?.["org"];
+      const activeWs = ctxData?.["workspace"];
+      const activeProj = ctxData?.["project"];
+      const { orgs } = await http.get("/v1/orgs").catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+      });
+      let totalWs = 0;
+      let totalProj = 0;
+      const nodes = await Promise.all(
+        orgs.map(async (org) => {
+          const { workspaces } = await http.get(`/v1/orgs/${org.slug}/workspaces`);
+          totalWs += workspaces.length;
+          const wsNodes = await Promise.all(
+            workspaces.map(async (ws) => {
+              const { projects } = await http.get(`/v1/orgs/${org.slug}/workspaces/${ws.slug}/projects`);
+              totalProj += projects.length;
+              const isActiveWs = org.slug === activeOrg && ws.slug === activeWs;
+              return {
+                label: isActiveWs ? clr.bold + ws.slug + clr.reset : ws.slug,
+                badge: isActiveWs ? clr.cyan + "\u25CF" + clr.reset : void 0,
+                children: projects.map((p) => {
+                  const isActiveProj = isActiveWs && p.slug === activeProj;
+                  return {
+                    label: isActiveProj ? clr.bold + p.slug + clr.reset : p.slug,
+                    badge: isActiveProj ? clr.green + "\u25CF" + clr.reset : void 0
+                  };
+                })
+              };
+            })
+          );
+          const isActiveOrg = org.slug === activeOrg;
+          return {
+            label: isActiveOrg ? clr.bold + org.slug + clr.reset : org.slug,
+            badge: isActiveOrg ? clr.cyan + "\u2605" + clr.reset : void 0,
+            meta: org.name && org.name !== org.slug ? org.name : void 0,
+            children: wsNodes
+          };
+        })
+      );
+      console.log();
+      tree(nodes);
+      console.log();
+      console.log(
+        `  ${clr.dim}${orgs.length} org${orgs.length !== 1 ? "s" : ""}  \xB7  ${totalWs} workspace${totalWs !== 1 ? "s" : ""}  \xB7  ${totalProj} project${totalProj !== 1 ? "s" : ""}` + (activeOrg ? `  \xB7  active: ${clr.bold}${activeOrg}/${activeWs}/${activeProj}${clr.reset}${clr.dim}` : "") + clr.reset
+      );
+      console.log();
+    })
+  );
+  program.addCommand(
+    new Command("ps").description("Show active session (context, token, api endpoint)").action(() => {
+      const ctxData = ctx.getContext();
+      const cfg = ctx.loadConfig();
+      const token = cfg["token"] ?? Object.values(cfg["orgs"] ?? {}).find((e) => e?.token)?.token;
+      const apiBase = cfg["apiBase"] ?? deps.appBase;
+      console.log();
+      if (ctxData?.["org"]) {
+        console.log(
+          `  ${clr.dim}context${clr.reset}   ${clr.bold}${ctxData["org"]}${clr.reset} ${clr.dim}/${clr.reset} ${ctxData["workspace"] ?? "\u2014"} ${clr.dim}/${clr.reset} ${ctxData["project"] ?? "\u2014"}  ${clr.green}\u25CF active${clr.reset}`
+        );
+      } else {
+        console.log(`  ${clr.dim}context${clr.reset}   ${clr.yellow}not set${clr.reset}  ${clr.dim}(run: ${cli} use)${clr.reset}`);
+      }
+      if (token) {
+        console.log(`  ${clr.dim}token  ${clr.reset}   ${clr.cyan}${token.slice(0, 14)}\u2026${clr.reset}`);
+      } else {
+        console.log(`  ${clr.dim}token  ${clr.reset}   ${clr.yellow}none${clr.reset}  ${clr.dim}(run: ${cli} login)${clr.reset}`);
+      }
+      console.log(`  ${clr.dim}api    ${clr.reset}   ${clr.dim}${apiBase}${clr.reset}`);
+      console.log(`  ${clr.dim}config ${clr.reset}   ${clr.dim}${ctx.configPath}${clr.reset}`);
+      console.log();
+    })
+  );
+}
+function orgCommand(deps) {
+  const root = new Command("org").description("Org, workspace, and project management");
+  addGlobalCommands(root, deps);
+  root.addCommand(buildOrgCommand(deps));
+  root.addCommand(buildWsCommand(deps));
+  root.addCommand(buildProjCommand(deps));
+  return root;
+}
+async function runUseCommand(http, ctx, path) {
+  async function pick(label, items) {
+    if (!items.length) fatal(`No ${label}s found.`);
+    if (items.length === 1) return items[0];
+    console.log(`
+Select ${label}:`);
+    items.forEach((it, i) => console.log(`  ${clr.cyan}${i + 1}${clr.reset}  ${it.slug}${it.name ? `  ${clr.dim}${it.name}${clr.reset}` : ""}`));
+    const ans = await prompt(`${label} [1-${items.length}]: `);
+    const n = parseInt(ans, 10);
+    if (!n || n < 1 || n > items.length) fatal("Invalid selection.");
+    return items[n - 1];
+  }
+  const parts = (path ?? "").split("/").map((s) => s.trim()).filter(Boolean);
+  const orgHint = parts[0];
+  const wsHint = parts[1];
+  const projHint = parts[2];
+  let orgSlug;
+  if (orgHint) {
+    orgSlug = orgHint;
+  } else {
+    const { orgs } = await http.get("/v1/orgs").catch((e) => {
+      console.error(e.message);
+      process.exit(1);
+    });
+    const org = await pick("org", orgs);
+    orgSlug = org.slug;
+  }
+  const orgRes = await http.get(`/v1/orgs/${orgSlug}`).catch(() => fatal(`Org not found: ${orgSlug}`));
+  if (parts.length <= 1 && orgHint) {
+    const cfg = ctx.loadConfig();
+    ctx.saveConfig({ ...cfg, activeOrg: orgRes.org.slug, context: { org: orgRes.org.slug, orgId: orgRes.org.id } });
+    success("Active org set.");
+    kv([["org", orgRes.org.slug]]);
+    return;
+  }
+  const { workspaces } = await http.get(`/v1/orgs/${orgSlug}/workspaces`).catch((e) => {
+    console.error(e.message);
+    process.exit(1);
+  });
+  const ws = wsHint ? workspaces.find((w) => w.slug === wsHint) ?? fatal(`Workspace not found: ${wsHint}`) : workspaces.length === 1 ? workspaces[0] : await pick("workspace", workspaces);
+  if (parts.length === 2) {
+    const cfg = ctx.loadConfig();
+    ctx.saveConfig({ ...cfg, activeOrg: orgRes.org.slug });
+    ctx.setContext({ org: orgRes.org.slug, orgId: orgRes.org.id, workspace: ws.slug, workspaceId: ws.id });
+    success("Active context set.");
+    kv([["org", orgRes.org.slug], ["workspace", ws.slug]]);
+    return;
+  }
+  const projRes = await http.get(`/v1/orgs/${orgSlug}/workspaces/${ws.slug}/projects`).catch((e) => {
+    console.error(e.message);
+    process.exit(1);
+  });
+  const { projects } = projRes;
+  const proj = projHint ? projects.find((p) => p.slug === projHint) ?? fatal(`Project not found: ${projHint}`) : projects.length === 1 ? projects[0] : await pick("project", projects);
+  ctx.setContext({
+    org: orgRes.org.slug,
+    orgId: orgRes.org.id,
+    workspace: ws.slug,
+    workspaceId: ws.id,
+    project: proj.slug,
+    projectId: proj.id
+  });
+  success("Active context set.");
+  kv([["org", orgRes.org.slug], ["workspace", ws.slug], ["project", proj.slug]]);
+}
+export {
+  addGlobalCommands,
+  buildEnvCommand,
+  buildOrgCommand,
+  buildProjCommand,
+  buildWsCommand,
+  orgCommand
+};