@platforma-sdk/pl-cli 0.2.0

package/dist/output-INk3CKvr.js

@@ -0,0 +1,174 @@
+import { PlClient as e, UnauthenticatedPlClient as t, field as n, isNullResourceId as r, plAddressToConfig as i } from "@milaboratories/pl-client";
+import { ProjectCreatedTimestamp as a, ProjectLastModifiedTimestamp as o, ProjectMetaKey as s, ProjectStructureKey as c, ProjectsField as l, SchemaVersionKey as u, duplicateProject as d } from "@milaboratories/pl-middle-layer";
+import { createHash as f } from "node:crypto";
+/** Creates an authenticated PlClient from address + credentials. */
+async function p(n) {
+	let r = i(n.address);
+	n.user !== void 0 && (r.user = n.user), n.password !== void 0 && (r.password = n.password);
+	let a = await t.build(r), o;
+	if (await a.requireAuth()) {
+		if (r.user === void 0 || r.password === void 0) throw Error("Server requires authentication but no credentials provided. Use --user/--password flags or PL_USER/PL_PASSWORD env vars.");
+		o = await a.login(r.user, r.password);
+	} else o = {};
+	return await e.init(r, { authInformation: o });
+}
+/** Creates a PlClient with admin/controller credentials. */
+async function m(n) {
+	let r = i(n.address), a = await (await t.build(r)).login(n.adminUser, n.adminPassword);
+	return await e.init(r, { authInformation: a });
+}
+/** List all projects from a project list resource. */
+async function h(e, t) {
+	return await e.withReadTx("listProjects", async (e) => {
+		let n = await e.getResourceData(t, !0), i = [];
+		for (let t of n.fields) {
+			if (r(t.value)) continue;
+			let [n, c, l] = await Promise.all([
+				e.getKValueStringIfExists(t.value, s),
+				e.getKValueStringIfExists(t.value, a),
+				e.getKValueStringIfExists(t.value, o)
+			]), u = n ? JSON.parse(n) : { label: "(unknown)" };
+			i.push({
+				id: t.name,
+				rid: String(t.value),
+				label: u.label,
+				created: c ? new Date(Number(c)) : /* @__PURE__ */ new Date(0),
+				lastModified: l ? new Date(Number(l)) : /* @__PURE__ */ new Date(0)
+			});
+		}
+		return i.sort((e, t) => t.lastModified.getTime() - e.lastModified.getTime()), i;
+	});
+}
+/** Get detailed info about a project. */
+async function g(e, t, i) {
+	return await e.withReadTx("getProjectInfo", async (e) => {
+		let l = await e.getField(n(t, i));
+		if (r(l.value)) throw Error(`Project "${i}" not found.`);
+		let d = l.value, f = await e.listKeyValuesString(d), p = f.find((e) => e.key === s), m = f.find((e) => e.key === a), h = f.find((e) => e.key === o), g = f.find((e) => e.key === u), _ = f.find((e) => e.key === c), v = p ? JSON.parse(p.value) : { label: "(unknown)" }, y = g ? JSON.parse(g.value) : void 0, b = [];
+		if (_) {
+			let e = JSON.parse(_.value);
+			for (let t of e.groups ?? []) for (let e of t.blocks ?? []) b.push(e.id);
+		}
+		return {
+			id: i,
+			rid: String(d),
+			label: v.label,
+			created: m ? new Date(Number(m.value)) : /* @__PURE__ */ new Date(0),
+			lastModified: h ? new Date(Number(h.value)) : /* @__PURE__ */ new Date(0),
+			schemaVersion: y,
+			blockCount: b.length,
+			blockIds: b
+		};
+	});
+}
+/** Resolve a project identifier (id or label) to its field ID and ResourceId. */
+async function _(e, t, n) {
+	return await e.withReadTx("resolveProject", async (e) => {
+		let i = await e.getResourceData(t, !0);
+		for (let t of i.fields) {
+			if (r(t.value)) continue;
+			if (t.name === n) return {
+				id: t.name,
+				rid: t.value
+			};
+			let i = await e.getKValueStringIfExists(t.value, s);
+			if (i && JSON.parse(i).label === n) return {
+				id: t.name,
+				rid: t.value
+			};
+		}
+		throw Error(`Project "${n}" not found (searched by id and label).`);
+	});
+}
+/** Read all project labels within an existing transaction. */
+async function v(e, t) {
+	let n = await e.getResourceData(t, !0), i = [];
+	for (let t of n.fields) {
+		if (r(t.value)) continue;
+		let n = await e.getKValueStringIfExists(t.value, s);
+		if (n) {
+			let e = JSON.parse(n);
+			i.push(e.label);
+		}
+	}
+	return i;
+}
+/**
+* Deduplicates a project name against existing labels.
+* "X" → "X (Copy)" → "X (Copy 2)" → ...
+*/
+function y(e, t) {
+	let n = `${e} (Copy)`, r = 2;
+	for (; t.includes(n);) n = `${e} (Copy ${r})`, r++;
+	return n;
+}
+/** Rename a project (update its label). */
+async function b(e, t, n) {
+	await e.withWriteTx("renameProject", async (e) => {
+		let r = await e.getKValueString(t, s), i = {
+			...JSON.parse(r),
+			label: n
+		};
+		e.setKValue(t, s, JSON.stringify(i)), e.setKValue(t, o, String(Date.now())), await e.commit();
+	});
+}
+/** Delete a project from the project list. */
+async function x(e, t, r) {
+	await e.withWriteTx("deleteProject", async (e) => {
+		e.removeField(n(t, r)), await e.commit();
+	});
+}
+/** Get the project list ResourceId for the connected user. */
+async function S(e) {
+	return await e.withReadTx("getProjectList", async (e) => {
+		let t = await e.getField({
+			resourceId: e.clientRoot,
+			fieldName: l
+		});
+		if (r(t.value)) throw Error("No project list found for this user.");
+		return t.value;
+	});
+}
+/**
+* Navigates to a specific user's project list resource ID.
+* Computes SHA256(username) to find the user's root, then reads the "projects" field.
+*/
+async function C(e, t) {
+	let n = f("sha256").update(t).digest("hex");
+	return await e.withReadTx("navigateToUserRoot", async (e) => {
+		if (!await e.checkResourceNameExists(n)) throw Error(`User "${t}" not found on this server (no root resource).`);
+		let i = await e.getResourceByName(n), a = await e.getField({
+			resourceId: i,
+			fieldName: l
+		});
+		if (r(a.value)) throw Error(`User "${t}" has no project list.`);
+		return {
+			userRoot: i,
+			projectListRid: a.value
+		};
+	});
+}
+/** Outputs a line of text to stdout. */
+function w(e) {
+	console.log(e);
+}
+/** Outputs data as formatted JSON to stdout. */
+function T(e) {
+	console.log(JSON.stringify(e, null, 2));
+}
+/** Formats a table as aligned text columns. */
+function E(e, t) {
+	let n = e.map((e, n) => Math.max(e.length, ...t.map((e) => (e[n] ?? "").length))), r = n.map((e) => "-".repeat(e)).join("  ");
+	return [
+		e.map((e, t) => e.padEnd(n[t])).join("  "),
+		r,
+		...t.map((e) => e.map((e, t) => (e ?? "").padEnd(n[t])).join("  "))
+	].join("\n");
+}
+/** Formats a Date as a short human-readable string. */
+function D(e) {
+	return e.getTime() === 0 ? "(unknown)" : e.toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z");
+}
+export { y as a, v as c, h as d, C as f, p as g, m as h, w as i, g as l, _ as m, E as n, x as o, b as p, T as r, d as s, D as t, S as u };
+
+//# sourceMappingURL=output-INk3CKvr.js.map

package/dist/output-INk3CKvr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-INk3CKvr.js","names":[],"sources":["../src/connection.ts","../src/project_ops.ts","../src/output.ts"],"sourcesContent":["import {\n  PlClient,\n  UnauthenticatedPlClient,\n  plAddressToConfig,\n  type AuthInformation,\n  type PlClientConfig,\n} from \"@milaboratories/pl-client\";\n\nexport interface PlConnectionOptions {\n  address: string;\n  user?: string;\n  password?: string;\n}\n\nexport interface AdminConnectionOptions {\n  address: string;\n  adminUser: string;\n  adminPassword: string;\n}\n\n/** Creates an authenticated PlClient from address + credentials. */\nexport async function createPlConnection(opts: PlConnectionOptions): Promise<PlClient> {\n  const config: PlClientConfig = plAddressToConfig(opts.address);\n\n  if (opts.user !== undefined) config.user = opts.user;\n  if (opts.password !== undefined) config.password = opts.password;\n\n  const unauth = await UnauthenticatedPlClient.build(config);\n  let authInformation: AuthInformation;\n\n  if (await unauth.requireAuth()) {\n    if (config.user === undefined || config.password === undefined) {\n      throw new Error(\n        \"Server requires authentication but no credentials provided. \" +\n          \"Use --user/--password flags or PL_USER/PL_PASSWORD env vars.\",\n      );\n    }\n    authInformation = await unauth.login(config.user, config.password);\n  } else {\n    authInformation = {};\n  }\n\n  return await PlClient.init(config, { authInformation });\n}\n\n/** Creates a PlClient with admin/controller credentials. */\nexport async function createAdminPlConnection(opts: AdminConnectionOptions): Promise<PlClient> {\n  const config: PlClientConfig = plAddressToConfig(opts.address);\n\n  const unauth = await UnauthenticatedPlClient.build(config);\n  const authInformation: AuthInformation = await unauth.login(opts.adminUser, opts.adminPassword);\n\n  return await PlClient.init(config, { authInformation });\n}\n","import type { PlClient, ResourceId, PlTransaction } from \"@milaboratories/pl-client\";\nimport { field, isNullResourceId } from \"@milaboratories/pl-client\";\nimport {\n  ProjectMetaKey,\n  ProjectCreatedTimestamp,\n  ProjectLastModifiedTimestamp,\n  SchemaVersionKey,\n  ProjectStructureKey,\n  ProjectsField,\n  duplicateProject,\n} from \"@milaboratories/pl-middle-layer\";\nimport type { ProjectMeta } from \"@milaboratories/pl-middle-layer\";\nimport { createHash } from \"node:crypto\";\n\nexport interface ProjectEntry {\n  id: string;\n  rid: string;\n  label: string;\n  created: Date;\n  lastModified: Date;\n}\n\nexport interface ProjectInfo extends ProjectEntry {\n  schemaVersion: string | undefined;\n  blockCount: number;\n  blockIds: string[];\n}\n\n/** List all projects from a project list resource. */\nexport async function listProjects(\n  pl: PlClient,\n  projectListRid: ResourceId,\n): Promise<ProjectEntry[]> {\n  return await pl.withReadTx(\"listProjects\", async (tx) => {\n    const data = await tx.getResourceData(projectListRid, true);\n    const entries: ProjectEntry[] = [];\n\n    for (const f of data.fields) {\n      if (isNullResourceId(f.value)) continue;\n\n      const [metaStr, createdStr, modifiedStr] = await Promise.all([\n        tx.getKValueStringIfExists(f.value, ProjectMetaKey),\n        tx.getKValueStringIfExists(f.value, ProjectCreatedTimestamp),\n        tx.getKValueStringIfExists(f.value, ProjectLastModifiedTimestamp),\n      ]);\n\n      const meta: ProjectMeta = metaStr ? JSON.parse(metaStr) : { label: \"(unknown)\" };\n\n      entries.push({\n        id: f.name,\n        rid: String(f.value),\n        label: meta.label,\n        created: createdStr ? new Date(Number(createdStr)) : new Date(0),\n        lastModified: modifiedStr ? new Date(Number(modifiedStr)) : new Date(0),\n      });\n    }\n\n    entries.sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime());\n    return entries;\n  });\n}\n\n/** Get detailed info about a project. */\nexport async function getProjectInfo(\n  pl: PlClient,\n  projectListRid: ResourceId,\n  projectId: string,\n): Promise<ProjectInfo> {\n  return await pl.withReadTx(\"getProjectInfo\", async (tx) => {\n    const fieldData = await tx.getField(field(projectListRid, projectId));\n    if (isNullResourceId(fieldData.value)) {\n      throw new Error(`Project \"${projectId}\" not found.`);\n    }\n\n    const rid = fieldData.value;\n    const kvs = await tx.listKeyValuesString(rid);\n\n    const metaKV = kvs.find((kv: { key: string }) => kv.key === ProjectMetaKey);\n    const createdKV = kvs.find((kv: { key: string }) => kv.key === ProjectCreatedTimestamp);\n    const modifiedKV = kvs.find((kv: { key: string }) => kv.key === ProjectLastModifiedTimestamp);\n    const schemaKV = kvs.find((kv: { key: string }) => kv.key === SchemaVersionKey);\n    const structureKV = kvs.find((kv: { key: string }) => kv.key === ProjectStructureKey);\n\n    const meta: ProjectMeta = metaKV ? JSON.parse(metaKV.value) : { label: \"(unknown)\" };\n    const schemaVersion = schemaKV ? JSON.parse(schemaKV.value) : undefined;\n\n    const blockIds: string[] = [];\n    if (structureKV) {\n      const structure = JSON.parse(structureKV.value);\n      for (const group of structure.groups ?? []) {\n        for (const block of group.blocks ?? []) {\n          blockIds.push(block.id);\n        }\n      }\n    }\n\n    return {\n      id: projectId,\n      rid: String(rid),\n      label: meta.label,\n      created: createdKV ? new Date(Number(createdKV.value)) : new Date(0),\n      lastModified: modifiedKV ? new Date(Number(modifiedKV.value)) : new Date(0),\n      schemaVersion,\n      blockCount: blockIds.length,\n      blockIds,\n    };\n  });\n}\n\n/** Resolve a project identifier (id or label) to its field ID and ResourceId. */\nexport async function resolveProject(\n  pl: PlClient,\n  projectListRid: ResourceId,\n  identifier: string,\n): Promise<{ id: string; rid: ResourceId }> {\n  return await pl.withReadTx(\"resolveProject\", async (tx) => {\n    const data = await tx.getResourceData(projectListRid, true);\n    for (const f of data.fields) {\n      if (isNullResourceId(f.value)) continue;\n      if (f.name === identifier) {\n        return { id: f.name, rid: f.value };\n      }\n      const metaStr = await tx.getKValueStringIfExists(f.value, ProjectMetaKey);\n      if (metaStr) {\n        const meta: ProjectMeta = JSON.parse(metaStr);\n        if (meta.label === identifier) {\n          return { id: f.name, rid: f.value };\n        }\n      }\n    }\n\n    throw new Error(`Project \"${identifier}\" not found (searched by id and label).`);\n  });\n}\n\n/** Read all project labels within an existing transaction. */\nexport async function getExistingLabelsInTx(\n  tx: PlTransaction,\n  projectListRid: ResourceId,\n): Promise<string[]> {\n  const data = await tx.getResourceData(projectListRid, true);\n  const labels: string[] = [];\n  for (const f of data.fields) {\n    if (isNullResourceId(f.value)) continue;\n    const metaStr = await tx.getKValueStringIfExists(f.value, ProjectMetaKey);\n    if (metaStr) {\n      const meta: ProjectMeta = JSON.parse(metaStr);\n      labels.push(meta.label);\n    }\n  }\n  return labels;\n}\n\n/** Get all project labels from a project list. */\nexport async function getProjectLabels(\n  pl: PlClient,\n  projectListRid: ResourceId,\n): Promise<string[]> {\n  return await pl.withReadTx(\"getProjectLabels\", async (tx) => {\n    return getExistingLabelsInTx(tx, projectListRid);\n  });\n}\n\n/**\n * Deduplicates a project name against existing labels.\n * \"X\" → \"X (Copy)\" → \"X (Copy 2)\" → ...\n */\nexport function deduplicateName(baseName: string, existingLabels: string[]): string {\n  let candidate = `${baseName} (Copy)`;\n  let i = 2;\n  while (existingLabels.includes(candidate)) {\n    candidate = `${baseName} (Copy ${i})`;\n    i++;\n  }\n  return candidate;\n}\n\n/** Rename a project (update its label). */\nexport async function renameProject(\n  pl: PlClient,\n  projectRid: ResourceId,\n  newLabel: string,\n): Promise<void> {\n  await pl.withWriteTx(\"renameProject\", async (tx) => {\n    const metaStr = await tx.getKValueString(projectRid, ProjectMetaKey);\n    const meta: ProjectMeta = JSON.parse(metaStr);\n    const updated: ProjectMeta = { ...meta, label: newLabel };\n    tx.setKValue(projectRid, ProjectMetaKey, JSON.stringify(updated));\n    tx.setKValue(projectRid, ProjectLastModifiedTimestamp, String(Date.now()));\n    await tx.commit();\n  });\n}\n\n/** Delete a project from the project list. */\nexport async function deleteProject(\n  pl: PlClient,\n  projectListRid: ResourceId,\n  projectId: string,\n): Promise<void> {\n  await pl.withWriteTx(\"deleteProject\", async (tx) => {\n    tx.removeField(field(projectListRid, projectId));\n    await tx.commit();\n  });\n}\n\n/** Get the project list ResourceId for the connected user. */\nexport async function getProjectListRid(pl: PlClient): Promise<ResourceId> {\n  return await pl.withReadTx(\"getProjectList\", async (tx) => {\n    const fieldData = await tx.getField({\n      resourceId: tx.clientRoot,\n      fieldName: ProjectsField,\n    });\n    if (isNullResourceId(fieldData.value)) {\n      throw new Error(\"No project list found for this user.\");\n    }\n    return fieldData.value;\n  });\n}\n\n/**\n * Navigates to a specific user's project list resource ID.\n * Computes SHA256(username) to find the user's root, then reads the \"projects\" field.\n */\nexport async function navigateToUserRoot(\n  pl: PlClient,\n  username: string,\n): Promise<{ userRoot: ResourceId; projectListRid: ResourceId }> {\n  const rootName = createHash(\"sha256\").update(username).digest(\"hex\");\n\n  return await pl.withReadTx(\"navigateToUserRoot\", async (tx) => {\n    if (!(await tx.checkResourceNameExists(rootName))) {\n      throw new Error(`User \"${username}\" not found on this server (no root resource).`);\n    }\n\n    const userRootRid = await tx.getResourceByName(rootName);\n\n    const projectsFieldData = await tx.getField({\n      resourceId: userRootRid,\n      fieldName: ProjectsField,\n    });\n\n    if (isNullResourceId(projectsFieldData.value)) {\n      throw new Error(`User \"${username}\" has no project list.`);\n    }\n\n    return { userRoot: userRootRid, projectListRid: projectsFieldData.value };\n  });\n}\n\n// Re-export duplicateProject from pl-middle-layer for use in commands\nexport { duplicateProject };\n","export type OutputFormat = \"text\" | \"json\";\n\n/** Outputs a line of text to stdout. */\nexport function outputText(message: string): void {\n  console.log(message);\n}\n\n/** Outputs data as formatted JSON to stdout. */\nexport function outputJson(data: unknown): void {\n  console.log(JSON.stringify(data, null, 2));\n}\n\n/** Formats a table as aligned text columns. */\nexport function formatTable(headers: string[], rows: string[][]): string {\n  const colWidths = headers.map((h, i) =>\n    Math.max(h.length, ...rows.map((r) => (r[i] ?? \"\").length)),\n  );\n\n  const sep = colWidths.map((w) => \"-\".repeat(w)).join(\"  \");\n  const headerLine = headers.map((h, i) => h.padEnd(colWidths[i])).join(\"  \");\n  const dataLines = rows.map((row) =>\n    row.map((cell, i) => (cell ?? \"\").padEnd(colWidths[i])).join(\"  \"),\n  );\n\n  return [headerLine, sep, ...dataLines].join(\"\\n\");\n}\n\n/** Formats a Date as a short human-readable string. */\nexport function formatDate(d: Date): string {\n  if (d.getTime() === 0) return \"(unknown)\";\n  return d\n    .toISOString()\n    .replace(\"T\", \" \")\n    .replace(/\\.\\d+Z$/, \"Z\");\n}\n"],"mappings":"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"}

package/dist/output.d.ts

@@ -0,0 +1,9 @@
+export type OutputFormat = "text" | "json";
+/** Outputs a line of text to stdout. */
+export declare function outputText(message: string): void;
+/** Outputs data as formatted JSON to stdout. */
+export declare function outputJson(data: unknown): void;
+/** Formats a table as aligned text columns. */
+export declare function formatTable(headers: string[], rows: string[][]): string;
+/** Formats a Date as a short human-readable string. */
+export declare function formatDate(d: Date): string;

package/dist/project_ops.d.ts

@@ -0,0 +1,47 @@
+import { PlClient, ResourceId, PlTransaction } from '@milaboratories/pl-client';
+import { duplicateProject } from '@milaboratories/pl-middle-layer';
+export interface ProjectEntry {
+    id: string;
+    rid: string;
+    label: string;
+    created: Date;
+    lastModified: Date;
+}
+export interface ProjectInfo extends ProjectEntry {
+    schemaVersion: string | undefined;
+    blockCount: number;
+    blockIds: string[];
+}
+/** List all projects from a project list resource. */
+export declare function listProjects(pl: PlClient, projectListRid: ResourceId): Promise<ProjectEntry[]>;
+/** Get detailed info about a project. */
+export declare function getProjectInfo(pl: PlClient, projectListRid: ResourceId, projectId: string): Promise<ProjectInfo>;
+/** Resolve a project identifier (id or label) to its field ID and ResourceId. */
+export declare function resolveProject(pl: PlClient, projectListRid: ResourceId, identifier: string): Promise<{
+    id: string;
+    rid: ResourceId;
+}>;
+/** Read all project labels within an existing transaction. */
+export declare function getExistingLabelsInTx(tx: PlTransaction, projectListRid: ResourceId): Promise<string[]>;
+/** Get all project labels from a project list. */
+export declare function getProjectLabels(pl: PlClient, projectListRid: ResourceId): Promise<string[]>;
+/**
+ * Deduplicates a project name against existing labels.
+ * "X" → "X (Copy)" → "X (Copy 2)" → ...
+ */
+export declare function deduplicateName(baseName: string, existingLabels: string[]): string;
+/** Rename a project (update its label). */
+export declare function renameProject(pl: PlClient, projectRid: ResourceId, newLabel: string): Promise<void>;
+/** Delete a project from the project list. */
+export declare function deleteProject(pl: PlClient, projectListRid: ResourceId, projectId: string): Promise<void>;
+/** Get the project list ResourceId for the connected user. */
+export declare function getProjectListRid(pl: PlClient): Promise<ResourceId>;
+/**
+ * Navigates to a specific user's project list resource ID.
+ * Computes SHA256(username) to find the user's root, then reads the "projects" field.
+ */
+export declare function navigateToUserRoot(pl: PlClient, username: string): Promise<{
+    userRoot: ResourceId;
+    projectListRid: ResourceId;
+}>;
+export { duplicateProject };

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@platforma-sdk/pl-cli",
+  "version": "0.2.0",
+  "description": "CLI for Platforma server state manipulation",
+  "license": "UNLICENSED",
+  "bin": {
+    "pl-cli": "./bin/run.js"
+  },
+  "files": [
+    "./bin/*",
+    "./dist/**/*",
+    "./src/**/*",
+    "./README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/lib.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/lib.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@oclif/core": "^4.0.37",
+    "@milaboratories/pl-client": "2.17.12",
+    "@milaboratories/pl-middle-layer": "1.49.0"
+  },
+  "devDependencies": {
+    "@types/node": "~24.5.2",
+    "rollup-plugin-node-externals": "^8.0.0",
+    "typescript": "~5.9.3",
+    "vite": "8.0.0-beta.15",
+    "vite-plugin-dts": "^4.5.3",
+    "vitest": "^4.0.18",
+    "@milaboratories/oclif-index": "1.1.1",
+    "@milaboratories/build-configs": "1.5.2",
+    "@milaboratories/ts-configs": "1.2.2",
+    "@milaboratories/ts-builder": "1.3.0"
+  },
+  "oclif": {
+    "bin": "pl-cli",
+    "commands": {
+      "identifier": "COMMANDS",
+      "strategy": "explicit",
+      "target": "./dist/cli.js"
+    },
+    "dirname": "pl-cli",
+    "topicSeparator": " ",
+    "topics": {
+      "admin": {
+        "description": "Admin operations (requires controller credentials)"
+      },
+      "project": {
+        "description": "Manage projects"
+      }
+    }
+  },
+  "scripts": {
+    "oclif:index": "oclif-index --commands-root=./src/cmd/ --index-file=./src/cmd/index.ts && node --run fmt",
+    "build": "vite build",
+    "test": "vitest run --passWithNoTests",
+    "do-pack": "rm -f *.tgz && pnpm pack && mv *.tgz package.tgz",
+    "check": "ts-builder check --target node",
+    "formatter:check": "ts-builder formatter --check",
+    "linter:check": "ts-builder linter --check",
+    "types:check": "ts-builder type-check --target node",
+    "fmt": "ts-builder format"
+  }
+}

package/src/base_command.ts

@@ -0,0 +1,90 @@
+import { Command } from "@oclif/core";
+import type { PlClient, ResourceId } from "@milaboratories/pl-client";
+import { createPlConnection, createAdminPlConnection } from "./connection";
+import { getProjectListRid, navigateToUserRoot } from "./project_ops";
+import { GlobalFlags, UserAuthFlags, AdminTargetFlags } from "./cmd-opts";
+
+/** Base command with dual-mode connection: user auth or admin + target-user. */
+export abstract class PlCommand extends Command {
+  static baseFlags = {
+    ...GlobalFlags,
+    ...UserAuthFlags,
+    ...AdminTargetFlags,
+  };
+
+  private _pl?: PlClient;
+
+  /**
+   * Low-level: get an authenticated PlClient without resolving a project list.
+   * Use this for commands that navigate to multiple users (e.g. admin copy-project).
+   */
+  protected async connectClient(flags: {
+    address: string;
+    user?: string;
+    password?: string;
+    "admin-user"?: string;
+    "admin-password"?: string;
+  }): Promise<PlClient> {
+    if (this._pl) throw new Error("connectClient() called twice");
+
+    if (flags["admin-user"] && flags["admin-password"]) {
+      this._pl = await createAdminPlConnection({
+        address: flags.address,
+        adminUser: flags["admin-user"],
+        adminPassword: flags["admin-password"],
+      });
+    } else {
+      this._pl = await createPlConnection({
+        address: flags.address,
+        user: flags.user,
+        password: flags.password,
+      });
+    }
+
+    return this._pl;
+  }
+
+  /**
+   * Connect and resolve the project list for a single user.
+   * In admin mode (--admin-user + --admin-password + --target-user), operates on the target user's data.
+   * In user mode, operates on the authenticated user's own data.
+   */
+  protected async connect(flags: {
+    address: string;
+    user?: string;
+    password?: string;
+    "admin-user"?: string;
+    "admin-password"?: string;
+    "target-user"?: string;
+  }): Promise<{ pl: PlClient; projectListRid: ResourceId }> {
+    const hasAdminUser = !!flags["admin-user"];
+    const hasAdminPassword = !!flags["admin-password"];
+    const hasTarget = !!flags["target-user"];
+
+    // Validate flag combinations
+    if (hasTarget && !(hasAdminUser && hasAdminPassword)) {
+      throw new Error("--target-user requires --admin-user and --admin-password");
+    }
+    if ((hasAdminUser || hasAdminPassword) && !hasTarget) {
+      throw new Error("--admin-user/--admin-password require --target-user for project commands");
+    }
+
+    const pl = await this.connectClient(flags);
+
+    let projectListRid: ResourceId;
+    if (hasTarget) {
+      const nav = await navigateToUserRoot(pl, flags["target-user"]!);
+      projectListRid = nav.projectListRid;
+    } else {
+      projectListRid = await getProjectListRid(pl);
+    }
+
+    return { pl, projectListRid };
+  }
+
+  protected async finally(_: Error | undefined): Promise<void> {
+    if (this._pl) {
+      await this._pl.close();
+    }
+  }
+}

package/src/cmd/admin/copy-project.ts

@@ -0,0 +1,101 @@
+import { Flags } from "@oclif/core";
+import { field, toGlobalResourceId } from "@milaboratories/pl-client";
+import { ProjectMetaKey } from "@milaboratories/pl-middle-layer";
+import { randomUUID } from "node:crypto";
+import { PlCommand } from "../../base_command";
+import { GlobalFlags, AdminAuthFlags } from "../../cmd-opts";
+import {
+  resolveProject,
+  deduplicateName,
+  duplicateProject,
+  getExistingLabelsInTx,
+  navigateToUserRoot,
+} from "../../project_ops";
+import { outputJson, outputText } from "../../output";
+
+export default class AdminCopyProject extends PlCommand {
+  static override description =
+    "Copy a project from one user to another. Requires admin/controller credentials.";
+
+  static override flags = {
+    ...GlobalFlags,
+    ...AdminAuthFlags,
+    "source-user": Flags.string({
+      summary: "Username of the source project owner",
+      required: true,
+    }),
+    "source-project": Flags.string({
+      summary: "Source project ID or label",
+      required: true,
+    }),
+    "target-user": Flags.string({
+      summary: "Username of the target user (defaults to source-user for same-user copy)",
+    }),
+    name: Flags.string({
+      char: "n",
+      summary: "Name for the copied project",
+      helpValue: "<name>",
+    }),
+    "auto-rename": Flags.boolean({
+      summary: "Auto-rename on collision (default: true)",
+      default: true,
+      allowNo: true,
+    }),
+  };
+
+  public async run(): Promise<void> {
+    const { flags } = await this.parse(AdminCopyProject);
+    const pl = await this.connectClient(flags);
+
+    const targetUser = flags["target-user"] ?? flags["source-user"];
+
+    const source = await navigateToUserRoot(pl, flags["source-user"]);
+    const { rid: sourceRid } = await resolveProject(
+      pl,
+      source.projectListRid,
+      flags["source-project"],
+    );
+
+    const target =
+      targetUser === flags["source-user"] ? source : await navigateToUserRoot(pl, targetUser);
+
+    const newId = randomUUID();
+
+    const result = await pl.withWriteTx("adminCopyProject", async (tx) => {
+      const sourceMetaStr = await tx.getKValueString(sourceRid, ProjectMetaKey);
+      const sourceMeta = JSON.parse(sourceMetaStr);
+      const sourceLabel: string = sourceMeta.label;
+
+      const existingLabels = await getExistingLabelsInTx(tx, target.projectListRid);
+
+      let newLabel: string = flags.name ?? sourceLabel;
+
+      if (existingLabels.includes(newLabel)) {
+        if (!flags["auto-rename"]) {
+          throw new Error(`Project name "${newLabel}" already exists for target user.`);
+        }
+        newLabel = deduplicateName(flags.name ?? sourceLabel, existingLabels);
+      }
+
+      const newPrj = await duplicateProject(tx, sourceRid, { label: newLabel });
+      tx.createField(field(target.projectListRid, newId), "Dynamic", newPrj);
+      await tx.commit();
+
+      return { rid: await toGlobalResourceId(newPrj), label: newLabel };
+    });
+
+    if (flags.format === "json") {
+      outputJson({
+        id: newId,
+        rid: String(result.rid),
+        label: result.label,
+        sourceUser: flags["source-user"],
+        targetUser,
+      });
+    } else {
+      outputText(
+        `Copied project from ${flags["source-user"]} to ${targetUser} as "${result.label}" (id: ${newId})`,
+      );
+    }
+  }
+}

package/src/cmd/index.ts

@@ -0,0 +1,17 @@
+// Command index for oclif. Run `pnpm run oclif:index` to regenerate.
+
+import ProjectList from "./project/list";
+import ProjectInfo from "./project/info";
+import ProjectDuplicate from "./project/duplicate";
+import ProjectRename from "./project/rename";
+import ProjectDelete from "./project/delete";
+import AdminCopyProject from "./admin/copy-project";
+
+export const COMMANDS = {
+  "project:list": ProjectList,
+  "project:info": ProjectInfo,
+  "project:duplicate": ProjectDuplicate,
+  "project:rename": ProjectRename,
+  "project:delete": ProjectDelete,
+  "admin:copy-project": AdminCopyProject,
+};

package/src/cmd/project/delete.ts

@@ -0,0 +1,58 @@
+import { Args, Flags } from "@oclif/core";
+import { createInterface } from "node:readline";
+import { PlCommand } from "../../base_command";
+import { resolveProject, deleteProject, getProjectInfo } from "../../project_ops";
+import { outputJson, outputText } from "../../output";
+
+export default class ProjectDelete extends PlCommand {
+  static override description = "Delete a project. This permanently destroys all project data.";
+
+  static override args = {
+    project: Args.string({
+      description: "Project ID or label",
+      required: true,
+    }),
+  };
+
+  static override flags = {
+    ...PlCommand.baseFlags,
+    force: Flags.boolean({
+      summary: "Skip confirmation",
+      default: false,
+    }),
+  };
+
+  public async run(): Promise<void> {
+    const { args, flags } = await this.parse(ProjectDelete);
+    const { pl, projectListRid } = await this.connect(flags);
+    const { id } = await resolveProject(pl, projectListRid, args.project);
+
+    const info = await getProjectInfo(pl, projectListRid, id);
+
+    if (!flags.force) {
+      const rl = createInterface({ input: process.stdin, output: process.stderr });
+      try {
+        const answer = await new Promise<string>((resolve) => {
+          rl.question(
+            `Delete project "${info.label}" (${info.blockCount} blocks)? [y/N] `,
+            resolve,
+          );
+        });
+        if (answer.toLowerCase() !== "y") {
+          outputText("Aborted.");
+          return;
+        }
+      } finally {
+        rl.close();
+      }
+    }
+
+    await deleteProject(pl, projectListRid, id);
+
+    if (flags.format === "json") {
+      outputJson({ deleted: true, id, label: info.label });
+    } else {
+      outputText(`Deleted project "${info.label}"`);
+    }
+  }
+}