nolo-cli 0.1.32 → 0.1.33

package/spaceAttachCommands.ts

@@ -1,134 +0,0 @@
-import { ContentType } from "./app/types";
-import { getReadableCliDb, type AgentCommandDeps } from "./agentCommandSupport";
-import { resolveAgentRecordFromHybridStore } from "./agentRecordHelpers";
-import {
-  parseUserIdFromAuthToken,
-  readOption,
-  resolveAuthToken,
-  resolveServerCandidates,
-  resolveServerUrl,
-} from "./cliEnvHelpers";
-import {
-  parseSpaceIdFromInput,
-  readSpaceRecordWithFallback,
-  writeSpaceRecord,
-} from "./spaceMutationHelpers";
-
-function usage() {
-  return [
-    "Usage:",
-    "  nolo space attach-agent --space <spaceId|spaceKey|spaceUrl> --agent <agentKey|alias|agentUrl>",
-    "",
-  ].join("\n");
-}
-
-export async function runSpaceAttachAgentCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-
-  if (args.includes("--help") || args.includes("-h")) {
-    output.write(`${usage()}\n`);
-    return 0;
-  }
-
-  const rawSpace = readOption(args, "--space");
-  const rawAgent = readOption(args, "--agent");
-  if (!rawSpace || !rawAgent) {
-    output.write(`${usage()}\n`);
-    return 1;
-  }
-
-  const authToken = resolveAuthToken(args, env);
-  const userId = parseUserIdFromAuthToken(authToken);
-  if (!authToken || !userId) {
-    output.write("[nolo] space attach-agent requires an auth token with userId. Run `nolo login`.\n");
-    return 1;
-  }
-
-  const db = deps.db ?? await getReadableCliDb(output);
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  const fallbackFetchImpl = deps.fallbackFetchImpl;
-  const defaultServerUrl = resolveServerUrl(args, env);
-  const serverCandidates = resolveServerCandidates(args, env, defaultServerUrl);
-
-  try {
-    const spaceId = parseSpaceIdFromInput(rawSpace);
-    const spaceRecord = await readSpaceRecordWithFallback({
-      authToken,
-      db,
-      fallbackFetchImpl,
-      fetchImpl,
-      serverCandidates,
-      spaceId,
-    });
-    const resolvedAgent = await resolveAgentRecordFromHybridStore({
-      agentInput: rawAgent,
-      cliArgs: args,
-      env,
-      db,
-      fetchImpl,
-      fallbackFetchImpl,
-    });
-    if (!resolvedAgent?.record || typeof resolvedAgent.record !== "object") {
-      throw new Error(`agent not found: ${rawAgent}`);
-    }
-    const agentKey = resolvedAgent.agentKey;
-
-    const title =
-      typeof resolvedAgent.record.name === "string" && resolvedAgent.record.name.trim()
-        ? resolvedAgent.record.name.trim()
-        : agentKey;
-    const now = Date.now();
-    const nextSpaceRecord = {
-      ...spaceRecord,
-      updatedAt: now,
-      contents: {
-        ...(spaceRecord?.contents ?? {}),
-        [agentKey]: {
-          ...(spaceRecord?.contents?.[agentKey] ?? {}),
-          title,
-          type: ContentType.AGENT,
-          contentKey: agentKey,
-          updatedAt: now,
-          createdAt: spaceRecord?.contents?.[agentKey]?.createdAt ?? now,
-        },
-      },
-    };
-
-    await writeSpaceRecord({
-      authToken,
-      db,
-      fallbackFetchImpl,
-      fetchImpl,
-      record: nextSpaceRecord,
-      serverUrl: defaultServerUrl,
-      spaceId,
-      userId,
-    });
-
-    output.write(
-      `${JSON.stringify(
-        {
-          ok: true,
-          baseUrl: defaultServerUrl,
-          spaceId,
-          agentKey,
-          title,
-        },
-        null,
-        2
-      )}\n`
-    );
-    return 0;
-  } catch (error) {
-    output.write(
-      `[nolo] space attach-agent failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-}

package/spaceCategoryCommands.ts

@@ -1,263 +0,0 @@
-import { ulid } from "ulid";
-import { getReadableCliDb, type AgentCommandDeps } from "./agentCommandSupport";
-import {
-  parseUserIdFromAuthToken,
-  readOption,
-  resolveAuthToken,
-  resolveServerCandidates,
-  resolveServerUrl,
-} from "./cliEnvHelpers";
-import {
-  parseContentKeys,
-  parseSpaceIdFromInput,
-  readSpaceRecordWithFallback,
-  writeSpaceRecord,
-} from "./spaceMutationHelpers";
-
-function categoryUsage() {
-  return [
-    "Usage:",
-    "  nolo space category --space <spaceId|spaceKey|spaceUrl> --name <name> [--category-id <id>] [--order <n>]",
-    "",
-  ].join("\n");
-}
-
-function contentCategoryUsage() {
-  return [
-    "Usage:",
-    "  nolo space content-category --space <spaceId|spaceKey|spaceUrl> --category-id <id> (--content-key <dbKey> | --content-keys '[\"dbKey1\"]')",
-    "",
-  ].join("\n");
-}
-
-export async function runSpaceCategoryCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-
-  if (args.includes("--help") || args.includes("-h")) {
-    output.write(`${categoryUsage()}\n`);
-    return 0;
-  }
-
-  const rawSpace = readOption(args, "--space");
-  const rawName = readOption(args, "--name")?.trim();
-  if (!rawSpace || !rawName) {
-    output.write(`${categoryUsage()}\n`);
-    return 1;
-  }
-
-  const authToken = resolveAuthToken(args, env);
-  const userId = parseUserIdFromAuthToken(authToken);
-  if (!authToken || !userId) {
-    output.write("[nolo] space category requires an auth token with userId. Run `nolo login`.\n");
-    return 1;
-  }
-
-  const rawOrder = readOption(args, "--order");
-  const parsedOrder = rawOrder == null ? undefined : Number.parseInt(rawOrder, 10);
-  if (rawOrder != null && !Number.isFinite(parsedOrder)) {
-    output.write("[nolo] --order must be an integer.\n");
-    return 1;
-  }
-
-  const db = deps.db ?? await getReadableCliDb(output);
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  const fallbackFetchImpl = deps.fallbackFetchImpl;
-  const defaultServerUrl = resolveServerUrl(args, env);
-  const serverCandidates = resolveServerCandidates(args, env, defaultServerUrl);
-
-  try {
-    const spaceId = parseSpaceIdFromInput(rawSpace);
-    const categoryId = (readOption(args, "--category-id") ?? ulid()).trim();
-    if (!categoryId) {
-      throw new Error("categoryId cannot be empty.");
-    }
-
-    const spaceRecord = await readSpaceRecordWithFallback({
-      authToken,
-      db,
-      fallbackFetchImpl,
-      fetchImpl,
-      serverCandidates,
-      spaceId,
-    });
-    const existingCategory = spaceRecord?.categories?.[categoryId];
-    const existingCategories = Object.values(spaceRecord?.categories ?? {}).filter(
-      (value) => value && typeof value === "object"
-    );
-    const nowIso = new Date().toISOString();
-    const nextCategory = {
-      ...(existingCategory && typeof existingCategory === "object" ? existingCategory : {}),
-      name: rawName,
-      order:
-        parsedOrder ??
-        (typeof existingCategory?.order === "number"
-          ? existingCategory.order
-          : existingCategories.length),
-      updatedAt: nowIso,
-    };
-    const nextSpaceRecord = {
-      ...spaceRecord,
-      updatedAt: nowIso,
-      categories: {
-        ...(spaceRecord?.categories ?? {}),
-        [categoryId]: nextCategory,
-      },
-    };
-
-    await writeSpaceRecord({
-      authToken,
-      db,
-      fallbackFetchImpl,
-      fetchImpl,
-      record: nextSpaceRecord,
-      serverUrl: defaultServerUrl,
-      spaceId,
-      userId,
-    });
-
-    output.write(
-      `${JSON.stringify(
-        {
-          ok: true,
-          action: existingCategory ? "updated" : "created",
-          baseUrl: defaultServerUrl,
-          spaceId,
-          categoryId,
-          category: nextCategory,
-        },
-        null,
-        2
-      )}\n`
-    );
-    return 0;
-  } catch (error) {
-    output.write(
-      `[nolo] space category failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-}
-
-export async function runSpaceContentCategoryCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-
-  if (args.includes("--help") || args.includes("-h")) {
-    output.write(`${contentCategoryUsage()}\n`);
-    return 0;
-  }
-
-  const rawSpace = readOption(args, "--space");
-  const categoryId = readOption(args, "--category-id")?.trim();
-  if (!rawSpace || !categoryId) {
-    output.write(`${contentCategoryUsage()}\n`);
-    return 1;
-  }
-
-  const authToken = resolveAuthToken(args, env);
-  const userId = parseUserIdFromAuthToken(authToken);
-  if (!authToken || !userId) {
-    output.write("[nolo] space content-category requires an auth token with userId. Run `nolo login`.\n");
-    return 1;
-  }
-
-  let contentKeys: string[];
-  try {
-    contentKeys = parseContentKeys(args);
-  } catch (error) {
-    output.write(
-      `[nolo] space content-category failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-  if (contentKeys.length === 0) {
-    output.write("[nolo] space content-category requires at least one content key.\n");
-    return 1;
-  }
-
-  const db = deps.db ?? await getReadableCliDb(output);
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  const fallbackFetchImpl = deps.fallbackFetchImpl;
-  const defaultServerUrl = resolveServerUrl(args, env);
-  const serverCandidates = resolveServerCandidates(args, env, defaultServerUrl);
-
-  try {
-    const spaceId = parseSpaceIdFromInput(rawSpace);
-    const spaceRecord = await readSpaceRecordWithFallback({
-      authToken,
-      db,
-      fallbackFetchImpl,
-      fetchImpl,
-      serverCandidates,
-      spaceId,
-    });
-
-    if (!spaceRecord?.categories?.[categoryId]) {
-      throw new Error(`target category not found: ${categoryId}`);
-    }
-
-    const contents = { ...(spaceRecord?.contents ?? {}) } as Record<string, any>;
-    const now = Date.now();
-    for (const contentKey of contentKeys) {
-      const currentContent = contents[contentKey];
-      if (!currentContent || typeof currentContent !== "object") {
-        throw new Error(`content not found in space: ${contentKey}`);
-      }
-      contents[contentKey] = {
-        ...currentContent,
-        categoryId,
-        updatedAt: now,
-      };
-    }
-
-    const nextSpaceRecord = {
-      ...spaceRecord,
-      contents,
-      updatedAt: now,
-    };
-
-    await writeSpaceRecord({
-      authToken,
-      db,
-      fallbackFetchImpl,
-      fetchImpl,
-      record: nextSpaceRecord,
-      serverUrl: defaultServerUrl,
-      spaceId,
-      userId,
-    });
-
-    output.write(
-      `${JSON.stringify(
-        {
-          ok: true,
-          baseUrl: defaultServerUrl,
-          spaceId,
-          categoryId,
-          contentKeys,
-        },
-        null,
-        2
-      )}\n`
-    );
-    return 0;
-  } catch (error) {
-    output.write(
-      `[nolo] space content-category failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-}

package/spaceCommands.ts

@@ -1,295 +0,0 @@
-import { createSpaceKey, normalizeSpaceId } from "./create/space/spaceKeys";
-import type { CliKvDb } from "./client/hybridRecordStore";
-import { getReadableCliDb, type AgentCommandDeps } from "./agentCommandSupport";
-import {
-  parseUserIdFromAuthToken,
-  readOption,
-  resolveAuthToken,
-  resolveServerCandidates,
-  resolveServerUrl,
-} from "./cliEnvHelpers";
-import { readDbRecord } from "./agentRecordHelpers";
-import { readFromServerCandidates, readThroughList } from "./hybridReadHelpers";
-
-type SpaceMembership = Record<string, any> & {
-  spaceId?: string;
-  name?: string;
-  spaceName?: string;
-  title?: string;
-  role?: string;
-};
-
-type ListedSpace = {
-  spaceId: string;
-  spaceKey: string;
-  name: string;
-  role: string | null;
-  ownerId: string | null;
-  visibility: string | null;
-  contentCount: number;
-  updatedAt: string | number | null;
-  membershipKey: string;
-};
-
-function displayName(value: Record<string, any>) {
-  return String(value.spaceName ?? value.name ?? value.title ?? value.spaceTitle ?? "").trim();
-}
-
-function parseSpaceListArgs(args: string[]) {
-  return {
-    wantJson: args.includes("--json"),
-    idsOnly: args.includes("--ids-only"),
-    exactName: readOption(args, "--name"),
-    nameContains: readOption(args, "--name-contains"),
-  };
-}
-
-function sortListedSpaces(spaces: ListedSpace[]) {
-  return spaces.sort((a, b) => {
-    const ta = a.updatedAt == null ? 0 : new Date(a.updatedAt).getTime();
-    const tb = b.updatedAt == null ? 0 : new Date(b.updatedAt).getTime();
-    if (tb !== ta) return tb - ta;
-    return a.name.localeCompare(b.name, "zh-Hans");
-  });
-}
-
-function applyFilters(
-  spaces: ListedSpace[],
-  filters: ReturnType<typeof parseSpaceListArgs>
-) {
-  return spaces.filter((space) => {
-    if (filters.exactName && space.name !== filters.exactName) return false;
-    if (filters.nameContains && !space.name.includes(filters.nameContains)) return false;
-    return true;
-  });
-}
-
-async function listLocalMemberships(args: {
-  db: CliKvDb;
-  userId: string;
-}) {
-  const range = createSpaceKey.memberRange(args.userId);
-  const memberships: SpaceMembership[] = [];
-  for await (const [key, value] of args.db.iterator({ gte: range.start, lte: range.end })) {
-    if (!value || typeof value !== "object") continue;
-    memberships.push({
-      ...(value as SpaceMembership),
-      dbKey: typeof (value as any).dbKey === "string" ? (value as any).dbKey : String(key),
-    });
-  }
-  return memberships;
-}
-
-async function readLocalSpaceRecord(args: {
-  db: CliKvDb;
-  spaceId: string;
-}) {
-  return await args.db.get(createSpaceKey.space(args.spaceId));
-}
-
-async function fetchRemoteMemberships(args: {
-  authToken: string;
-  fetchImpl: typeof fetch;
-  serverCandidates: string[];
-  userId: string;
-}) {
-  return await readFromServerCandidates({
-    serverCandidates: args.serverCandidates,
-    readRemote: async (serverUrl) => {
-      const response = await args.fetchImpl(`${serverUrl}/rpc/getUserSpaceMemberships`, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${args.authToken}`,
-          "Content-Type": "application/json",
-        },
-        body: JSON.stringify({ userId: args.userId }),
-      });
-      const data = await response.json().catch(() => ({}));
-      if (!response.ok || !Array.isArray(data)) {
-        throw new Error(
-          `Failed to list memberships (${response.status}): ${JSON.stringify(data)}`
-        );
-      }
-      return {
-        memberships: data as SpaceMembership[],
-        serverUrl,
-      };
-    },
-  }).then((result) => result.value);
-}
-
-async function readRemoteSpaceRecord(args: {
-  authToken: string;
-  fallbackFetchImpl?: typeof fetch;
-  fetchImpl: typeof fetch;
-  serverUrl: string;
-  spaceId: string;
-}) {
-  return await readDbRecord({
-    authToken: args.authToken,
-    dbKey: createSpaceKey.space(args.spaceId),
-    fallbackFetchImpl: args.fallbackFetchImpl,
-    fetchImpl: args.fetchImpl,
-    serverUrl: args.serverUrl,
-  });
-}
-
-async function buildListedSpace(
-  membership: SpaceMembership,
-  readSpaceRecord: (spaceId: string) => Promise<Record<string, any>>
-): Promise<ListedSpace | null> {
-  const spaceId = normalizeSpaceId(String(membership.spaceId ?? ""));
-  if (!spaceId) return null;
-
-  let spaceRecord: Record<string, any> = {};
-  try {
-    const value = await readSpaceRecord(spaceId);
-    if (value && typeof value === "object") {
-      spaceRecord = value;
-    }
-  } catch {
-    spaceRecord = {};
-  }
-
-  const contents = spaceRecord.contents;
-  return {
-    spaceId,
-    spaceKey: createSpaceKey.space(spaceId),
-    name: displayName(spaceRecord) || displayName(membership) || spaceId,
-    role: typeof membership.role === "string" ? membership.role : null,
-    ownerId: typeof spaceRecord.ownerId === "string" ? spaceRecord.ownerId : null,
-    visibility: typeof spaceRecord.visibility === "string" ? spaceRecord.visibility : null,
-    contentCount: contents && typeof contents === "object" ? Object.keys(contents).length : 0,
-    updatedAt:
-      typeof spaceRecord.updatedAt === "string" || typeof spaceRecord.updatedAt === "number"
-        ? spaceRecord.updatedAt
-        : typeof membership.updatedAt === "string" || typeof membership.updatedAt === "number"
-          ? membership.updatedAt
-          : null,
-    membershipKey:
-      typeof membership.dbKey === "string"
-        ? membership.dbKey
-        : createSpaceKey.member(String(membership.userId ?? ""), spaceId),
-  };
-}
-
-export async function runSpaceListCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-  const filters = parseSpaceListArgs(args);
-
-  const authToken = resolveAuthToken(args, env);
-  if (!authToken) {
-    output.write("[nolo] space list requires an auth token. Run `nolo login` or set AUTH_TOKEN.\n");
-    return 1;
-  }
-
-  const userId = parseUserIdFromAuthToken(authToken);
-  if (!userId) {
-    output.write("[nolo] space list could not read userId from AUTH_TOKEN.\n");
-    return 1;
-  }
-
-  const db = deps.db ?? await getReadableCliDb(output);
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  const fallbackFetchImpl = deps.fallbackFetchImpl;
-  const defaultServerUrl = resolveServerUrl(args, env);
-  const serverCandidates = resolveServerCandidates(args, env, defaultServerUrl);
-
-  try {
-    let spaces: ListedSpace[];
-    let source: "local-cache" | "remote-cache";
-    let resolvedBaseUrl = defaultServerUrl;
-    const loadRemoteSpaces = async () => {
-      const remote = await fetchRemoteMemberships({
-        authToken,
-        fetchImpl,
-        serverCandidates,
-        userId,
-      });
-      resolvedBaseUrl = remote.serverUrl;
-      const memberships = remote.memberships;
-      return (
-        await Promise.all(
-          memberships.map((membership) =>
-            buildListedSpace(membership, async (spaceId) => {
-              const value = await readRemoteSpaceRecord({
-                authToken,
-                fallbackFetchImpl,
-                fetchImpl,
-                serverUrl: resolvedBaseUrl,
-                spaceId,
-              });
-              return value && typeof value === "object" ? (value as Record<string, any>) : {};
-            })
-          )
-        )
-      ).filter((space): space is ListedSpace => space != null);
-    };
-
-    const result = await readThroughList({
-      readLocal: async () => {
-        const memberships = await listLocalMemberships({ db, userId });
-        return (
-          await Promise.all(
-            memberships.map((membership) =>
-              buildListedSpace(membership, async (spaceId) => {
-                const value = await readLocalSpaceRecord({ db, spaceId });
-                return value && typeof value === "object" ? (value as Record<string, any>) : {};
-              })
-            )
-          )
-        ).filter((space): space is ListedSpace => space != null);
-      },
-      readRemote: loadRemoteSpaces,
-    });
-    spaces = result.items;
-    source = result.source;
-
-    spaces = applyFilters(sortListedSpaces(spaces), filters);
-
-    if (filters.idsOnly) {
-      output.write(`${spaces.map((space) => space.spaceId).join("\n")}\n`);
-      return 0;
-    }
-
-    if (filters.wantJson) {
-      output.write(
-        JSON.stringify(
-          {
-            baseUrl: resolvedBaseUrl,
-            userId,
-            total: spaces.length,
-            source,
-            spaces,
-          },
-          null,
-          2
-        )
-      );
-      output.write("\n");
-      return 0;
-    }
-
-    output.write(`Base: ${resolvedBaseUrl}\n`);
-    output.write(`User: ${userId}\n`);
-    output.write(`Spaces: ${spaces.length}\n`);
-    output.write(`Source: ${source}\n`);
-    for (const space of spaces) {
-      output.write(
-        `- ${space.name} (${space.spaceId}) role=${space.role ?? "-"} contents=${space.contentCount}\n`
-      );
-    }
-    return 0;
-  } catch (error) {
-    output.write(
-      `[nolo] space list failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-}