nolo-cli 0.1.32 → 0.1.33

package/machineCommandPrompts.ts

@@ -1,79 +0,0 @@
-import {
-  buildMachinePermissionPromptBlock,
-  resolveMachineRunPermissionPolicy,
-  type MachineRunPermissionPolicy,
-} from "./ai/agent/machineRunPermissions";
-import { buildNoloReadOnlyBridgePrompt } from "./noloReadBridgePrompt";
-
-export function inferTaskRunRole(agentKey: string, agentConfig: any) {
-  const haystack = [agentKey, agentConfig?.name, agentConfig?.prompt]
-    .filter(Boolean)
-    .join("\n")
-    .toLowerCase();
-  if (haystack.includes("frontend") || haystack.includes("前端")) return "frontend";
-  if (haystack.includes("fullstack") || haystack.includes("全栈")) return "fullstack";
-  if (haystack.includes("review") || haystack.includes("审查")) return "reviewer";
-  if (haystack.includes("project-manager") || haystack.includes("项目经理")) return "pm";
-  return "codex";
-}
-
-export function buildTaskRunBridgePrompt(args: {
-  agentKey: string;
-  agentConfig: any;
-  runtimeContext: any;
-}) {
-  const taskRun = args.runtimeContext?.taskRun;
-  const rowDbKey = typeof taskRun?.rowDbKey === "string" ? taskRun.rowDbKey.trim() : "";
-  if (!rowDbKey) return "";
-  const workItemId = typeof taskRun?.workItemId === "string" ? taskRun.workItemId.trim() : "";
-  const role = inferTaskRunRole(args.agentKey, args.agentConfig);
-  return [
-    "--- Nolo task-run tool bridge ---",
-    "This CLI runtime does not receive server-side function tools directly.",
-    "Use the local task-run bridge command for durable task state writes. Do not edit meta.taskRun with table or database commands.",
-    "Run commands from the repository root. The runner already provides server URL and auth in the environment.",
-    "Release boundary: after review passes, AI/reviewer/Codex may advance alpha for verification. Do not merge, push, or release main/release unless the human owner explicitly authorizes it in the current task context.",
-    "Cost boundary: read taskRun.control from context. Prefer low-cost/free-window models for routine work, and reserve Codex for supervision, quality gates, complex unblocking, and main/release decisions.",
-    "Handoff context: start from read-context, then inspect existing refs such as workItems.dialogIds, workItems.outcome, review.dialogId, activityRefs, agentRuns.dialogId/resultSummary, and artifactRefs. Use dialog read/search for exact evidence; do not infer completion from handoff text alone.",
-    `Read context: bun packages/cli/index.ts task-run read-context --row-dbkey ${JSON.stringify(rowDbKey)}`,
-    ...(workItemId
-      ? [
-          `Claim work item: bun packages/cli/index.ts task-run claim-work-item --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --agent-key ${JSON.stringify(args.agentKey)} --role ${role}`,
-          `Set blocker: bun packages/cli/index.ts task-run set-blocker --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --layer tool --code <CODE> --message <MESSAGE>`,
-          `Clear resolved blocker: bun packages/cli/index.ts task-run clear-blocker --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --blocker-id <BLOCKER_ID>`,
-          `Submit outcome: bun packages/cli/index.ts task-run submit-outcome --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --summary <SUMMARY>`,
-          `Request review: bun packages/cli/index.ts task-run request-review --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --reviewer-agent-key <AGENT_KEY> --message <MESSAGE>`,
-          `Record review: bun packages/cli/index.ts task-run record-review --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --review-status <passed|needs_changes|blocked> --reviewer-agent-key ${JSON.stringify(args.agentKey)} --findings <FINDINGS>`,
-          `Close work item: bun packages/cli/index.ts task-run close-work-item --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --summary <SUMMARY>`,
-        ]
-      : []),
-    "If a bridge command fails, report the exact command and error.",
-  ].join("\n");
-}
-
-export function buildConnectorCliPrompt(
-  agentConfig: any,
-  userInput: string,
-  bridgeArgs?: {
-    agentKey: string;
-    runtimeContext: any;
-  },
-  permissionPolicy?: MachineRunPermissionPolicy,
-) {
-  const policy = permissionPolicy ?? resolveMachineRunPermissionPolicy(agentConfig);
-  return [
-    typeof agentConfig?.prompt === "string" ? agentConfig.prompt.trim() : "",
-    buildNoloReadOnlyBridgePrompt(),
-    bridgeArgs
-      ? buildTaskRunBridgePrompt({
-          agentKey: bridgeArgs.agentKey,
-          agentConfig,
-          runtimeContext: bridgeArgs.runtimeContext,
-        })
-      : "",
-    buildMachinePermissionPromptBlock(policy),
-    `--- User task ---\n${userInput}`,
-  ]
-    .filter(Boolean)
-    .join("\n\n");
-}

package/machineCommandResolution.ts

@@ -1,43 +0,0 @@
-import {
-  hasFlag,
-  readCliOptionValue,
-  resolveAuthToken as resolveCliAuthToken,
-  resolveAuthTokenFromArgs,
-  resolveServerUrlFromArgs,
-  resolveServerUrlFromEnv,
-  type EnvLike,
-} from "./cliEnvHelpers";
-import type { OutputLike } from "./cliIoTypes";
-export type { OutputLike } from "./cliIoTypes";
-export { hasFlag };
-
-export function resolveServerUrl(env: EnvLike) {
-  return resolveServerUrlFromEnv(env);
-}
-
-export function resolveAuthToken(env: EnvLike) {
-  return resolveCliAuthToken(env);
-}
-
-export function writeAuthMissing(output: OutputLike) {
-  output.write(
-    "[nolo] Machine commands require an auth token. Run `nolo login` or set AUTH_TOKEN.\n"
-  );
-}
-
-export function readOption(args: string[], flag: string) {
-  return readCliOptionValue(args, flag);
-}
-
-export function resolveConnectServerUrl(args: string[], env: EnvLike) {
-  return resolveServerUrlFromArgs(args, env);
-}
-
-export function resolveConnectAuthToken(args: string[], env: EnvLike) {
-  return resolveAuthTokenFromArgs(args, env);
-}
-
-export function resolveConnectorReconnectDelayMs(env: EnvLike) {
-  const raw = Number(env.NOLO_CONNECT_RECONNECT_MS ?? "");
-  return Number.isFinite(raw) && raw >= 0 ? raw : 5_000;
-}

package/noloReadBridgePrompt.ts

@@ -1,16 +0,0 @@
-const REPO_CLI_PREFIX = "bun packages/cli/index.ts";
-
-export function buildNoloReadOnlyBridgePrompt() {
-  return [
-    "--- Nolo read-only CLI bridge ---",
-    "This CLI runtime does not receive server-side function tools directly.",
-    "Use these repo-local read commands to fetch authoritative Nolo docs and records on demand instead of trusting prompt snapshots or summaries alone.",
-    "Run commands from the repository root. The runner already provides server URL and auth in the environment.",
-    `Read doc/page truth: ${REPO_CLI_PREFIX} doc read "<pageKey>"`,
-    `Read skill doc truth: ${REPO_CLI_PREFIX} skill-doc read "<pageKey>"`,
-    `Read dialog truth: ${REPO_CLI_PREFIX} dialog read "<dialogId|dialogUrl>"`,
-    `Read shared space truth: ${REPO_CLI_PREFIX} space read "<spaceId|spaceKey|spaceUrl>"`,
-    `Read agent truth: ${REPO_CLI_PREFIX} agent read "<agentKey|agentAlias|agentUrl>"`,
-    "If a read command fails, report the exact command and error.",
-  ].join("\n");
-}

package/pageCreateCommands.ts

@@ -1,219 +0,0 @@
-import type { SkillDocConfig } from "./ai/skills/skillDocProtocol";
-import { getReadableCliDb, type AgentCommandDeps } from "./agentCommandSupport";
-import { readDbRecord } from "./agentRecordHelpers";
-import { parseUserIdFromAuthToken, resolveAuthToken, resolveServerUrl } from "./cliEnvHelpers";
-import {
-  buildDocSpaceRecord,
-  buildPageKey,
-  buildPageRecord,
-  buildSkillDocId,
-  buildSkillPageRecord,
-  buildSkillSummaryFromRecord,
-  createPageId,
-  parseJsonOption,
-  readBodyOption,
-  readOption,
-  writeRemoteRecordsThenCache,
-} from "./pageWriteHelpers";
-import { findPotentialSecrets, formatSecretFindings } from "./secretScanHelpers";
-
-function usage(command: "doc" | "skill-doc") {
-  return [
-    "Usage:",
-    `  nolo ${command} create --title <title> [options]`,
-    "",
-  ].join("\n");
-}
-
-async function readSpaceRecord(args: {
-  authToken: string;
-  db: Awaited<ReturnType<typeof getReadableCliDb>>;
-  fetchImpl: typeof fetch;
-  fallbackFetchImpl?: typeof fetch;
-  serverUrl: string;
-  spaceKey: string;
-}) {
-  try {
-    return await args.db.get(args.spaceKey);
-  } catch {
-    return readDbRecord({
-      authToken: args.authToken,
-      dbKey: args.spaceKey,
-      fallbackFetchImpl: args.fallbackFetchImpl,
-      fetchImpl: args.fetchImpl,
-      serverUrl: args.serverUrl,
-    });
-  }
-}
-
-async function runBasePageCreateCommand(
-  args: string[],
-  deps: AgentCommandDeps,
-  mode: "doc" | "skill-doc"
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-  if (args.includes("--help") || args.includes("-h")) {
-    output.write(`${usage(mode)}\n`);
-    return 0;
-  }
-
-  const title = readOption(args, "--title")?.trim();
-  const description = readOption(args, "--description")?.trim();
-  const spaceId = readOption(args, "--space")?.trim() ?? null;
-  if (!title || !spaceId || (mode === "skill-doc" && !description)) {
-    output.write(`${usage(mode)}\n`);
-    return 1;
-  }
-
-  const authToken = resolveAuthToken(args, env);
-  const userId = parseUserIdFromAuthToken(authToken);
-  if (!authToken || !userId) {
-    output.write(`[nolo] ${mode} create requires an auth token with userId. Run \`nolo login\`.\n`);
-    return 1;
-  }
-
-  const body = readBodyOption(args, "");
-  const secretFindings = findPotentialSecrets(body);
-  if (secretFindings.length > 0 && !args.includes("--allow-secrets")) {
-    output.write(
-      `[nolo] refusing to create ${mode} because the body looks like it contains secrets.\n${formatSecretFindings(secretFindings)}\n`
-    );
-    return 1;
-  }
-
-  const serverUrl = resolveServerUrl(args, env);
-  const db = deps.db ?? await getReadableCliDb(output);
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  const fallbackFetchImpl = deps.fallbackFetchImpl;
-  const explicitId = readOption(args, "--id")?.trim();
-  const pageId = explicitId || (mode === "skill-doc" ? buildSkillDocId(title) : createPageId());
-  const dbKey = buildPageKey(userId, pageId);
-  const spaceKey = `space-${spaceId}`;
-  const shouldDryRun = args.includes("--dry-run");
-  const shouldOutputJson = args.includes("--json");
-
-  const pageRecord =
-    mode === "skill-doc"
-      ? buildSkillPageRecord({
-          body,
-          dbKey,
-          existing: null,
-          skillConfig: {
-            version: "0.1",
-            kind: "skill",
-            id: pageId,
-            name: title,
-            description: description!,
-            ...(readOption(args, "--tools") !== undefined
-              ? { toolNames: parseJsonOption<string[]>(readOption(args, "--tools"), []) }
-              : {}),
-            ...(readOption(args, "--required-skills") !== undefined
-              ? { requiredSkills: parseJsonOption<string[]>(readOption(args, "--required-skills"), []) }
-              : {}),
-            ...(readOption(args, "--recommended-skills") !== undefined
-              ? { recommendedSkills: parseJsonOption<string[]>(readOption(args, "--recommended-skills"), []) }
-              : {}),
-            ...(readOption(args, "--preferred-agents") !== undefined
-              ? { preferredAgents: parseJsonOption<string[]>(readOption(args, "--preferred-agents"), []) }
-              : {}),
-            ...(readOption(args, "--trigger-mode") !== undefined
-              ? { triggerMode: readOption(args, "--trigger-mode") as SkillDocConfig["triggerMode"] }
-              : {}),
-            ...(readOption(args, "--budget-tier") !== undefined
-              ? { budgetTier: readOption(args, "--budget-tier") as SkillDocConfig["budgetTier"] }
-              : {}),
-            ...(readOption(args, "--prompt-patch") !== undefined
-              ? { promptPatch: readOption(args, "--prompt-patch") || undefined }
-              : {}),
-          },
-          skillId: pageId,
-          spaceId,
-          title,
-        })
-      : buildPageRecord({
-          content: body,
-          dbKey,
-          meta: description ? { description } : undefined,
-          pageId,
-          spaceId,
-          title,
-        });
-
-  const summary = {
-    dryRun: shouldDryRun,
-    kind: mode === "skill-doc" ? "skill" : "page",
-    title,
-    dbKey,
-    id: pageId,
-    spaceId,
-    baseUrl: serverUrl,
-    secretFindingCount: secretFindings.length,
-    secretFindings,
-  };
-
-  if (shouldDryRun) {
-    output.write(`${JSON.stringify(summary, null, 2)}\n`);
-    return 0;
-  }
-
-  try {
-    const existingSpaceRecord = await readSpaceRecord({
-      authToken,
-      db,
-      fallbackFetchImpl,
-      fetchImpl,
-      serverUrl,
-      spaceKey,
-    });
-    const spaceRecord = buildDocSpaceRecord({
-      contentKey: dbKey,
-      existingSpaceRecord,
-      skillSummary: mode === "skill-doc" ? buildSkillSummaryFromRecord(pageRecord) : undefined,
-      spaceId,
-      title,
-    });
-
-    await writeRemoteRecordsThenCache({
-      authToken,
-      db,
-      fallbackFetchImpl,
-      fetchImpl,
-      records: [
-        { dbKey, record: pageRecord, serverUrl },
-        { dbKey: spaceKey, record: spaceRecord, serverUrl },
-      ],
-      userId,
-    });
-
-    output.write(
-      `${JSON.stringify(
-        shouldOutputJson ? summary : { ...summary, ok: true },
-        null,
-        2
-      )}\n`
-    );
-    return 0;
-  } catch (error) {
-    output.write(
-      `[nolo] ${mode} create failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-}
-
-export async function runDocCreateCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  return runBasePageCreateCommand(args, deps, "doc");
-}
-
-export async function runSkillDocCreateCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  return runBasePageCreateCommand(args, deps, "skill-doc");
-}

package/pageDeleteCommands.ts

@@ -1,167 +0,0 @@
-import { parseSkillDocProtocol, resolvePageSkillMetadata } from "./ai/skills/skillDocProtocol";
-import { getReadableCliDb, type AgentCommandDeps } from "./agentCommandSupport";
-import { deleteDbRecord, readDbRecord, writeDbRecord } from "./agentRecordHelpers";
-import {
-  parseUserIdFromAuthToken,
-  resolveAuthToken,
-  resolveServerCandidates,
-  resolveServerUrl,
-} from "./cliEnvHelpers";
-import { readRecordWithCandidates } from "./hybridReadHelpers";
-import { buildDetachedDocSpaceRecord, readOption } from "./pageWriteHelpers";
-
-function usage(command: "doc" | "skill-doc") {
-  return [
-    "Usage:",
-    `  nolo ${command} delete --key <pageKey>`,
-    "",
-  ].join("\n");
-}
-
-async function readRecord(args: {
-  authToken: string;
-  db: Awaited<ReturnType<typeof getReadableCliDb>>;
-  dbKey: string;
-  fetchImpl: typeof fetch;
-  fallbackFetchImpl?: typeof fetch;
-  serverCandidates: string[];
-}) {
-  return readRecordWithCandidates<Record<string, any>>({
-    db: args.db,
-    dbKey: args.dbKey,
-    serverCandidates: args.serverCandidates,
-    readRemote: async (serverUrl, dbKey) =>
-      readDbRecord({
-        authToken: args.authToken,
-        dbKey,
-        fallbackFetchImpl: args.fallbackFetchImpl,
-        fetchImpl: args.fetchImpl,
-        serverUrl,
-      }),
-  });
-}
-
-export async function runBasePageDeleteCommand(
-  args: string[],
-  deps: AgentCommandDeps,
-  mode: "doc" | "skill-doc"
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-  const dbKey = readOption(args, "--key");
-  if (!dbKey || dbKey === "-h" || dbKey === "--help") {
-    output.write(`${usage(mode)}\n`);
-    return dbKey ? 0 : 1;
-  }
-
-  const authToken = resolveAuthToken(args, env);
-  const userId = parseUserIdFromAuthToken(authToken);
-  if (!authToken || !userId) {
-    output.write(`[nolo] ${mode} delete 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 existing = await readRecord({
-      authToken,
-      db,
-      dbKey,
-      fetchImpl,
-      fallbackFetchImpl,
-      serverCandidates,
-    });
-
-    if (mode === "doc" && existing?.meta?.kind === "skill") {
-      throw new Error(`target page is a skill doc; use \`nolo skill-doc delete --key ${dbKey}\``);
-    }
-    if (mode === "skill-doc") {
-      const parsed = parseSkillDocProtocol(
-        typeof existing?.content === "string" ? existing.content : "",
-        existing?.meta,
-        existing?.tools
-      );
-      const metadata = resolvePageSkillMetadata({
-        ...existing,
-        content: parsed.content,
-      });
-      if (!metadata?.skillConfig) {
-        throw new Error(`target page is not a skill doc: ${dbKey}`);
-      }
-    }
-
-    const spaceId =
-      typeof existing?.spaceId === "string" && existing.spaceId.trim()
-        ? existing.spaceId
-        : null;
-    const spaceKey = spaceId ? `space-${spaceId}` : null;
-    let pendingSpaceRecord: Record<string, any> | null = null;
-
-    if (spaceId && spaceKey) {
-      const existingSpaceRecord = await readRecord({
-        authToken,
-        db,
-        dbKey: spaceKey,
-        fetchImpl,
-        fallbackFetchImpl,
-        serverCandidates,
-      });
-      const spaceRecord = buildDetachedDocSpaceRecord({
-        contentKey: dbKey,
-        existingSpaceRecord,
-        spaceId,
-      });
-      pendingSpaceRecord = spaceRecord;
-      await writeDbRecord({
-        authToken,
-        dbKey: spaceKey,
-        fallbackFetchImpl,
-        fetchImpl,
-        record: spaceRecord,
-        serverUrl: defaultServerUrl,
-        userId,
-      });
-    }
-
-    const deleteStatus = await deleteDbRecord({
-      authToken,
-      dbKey,
-      fallbackFetchImpl,
-      fetchImpl,
-      serverUrl: defaultServerUrl,
-      userId,
-    });
-    if (spaceKey && pendingSpaceRecord) {
-      await db.put(spaceKey, pendingSpaceRecord);
-    }
-    await db.batch([{ type: "del", key: dbKey }]);
-    output.write(`${JSON.stringify({ ok: true, dbKey, status: deleteStatus, spaceKey }, null, 2)}\n`);
-    return 0;
-  } catch (error) {
-    output.write(
-      `[nolo] ${mode} delete failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-}
-
-export async function runDocDeleteCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  return runBasePageDeleteCommand(args, deps, "doc");
-}
-
-export async function runSkillDocDeleteCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  return runBasePageDeleteCommand(args, deps, "skill-doc");
-}

package/pageReadCommands.ts

@@ -1,151 +0,0 @@
-import { parseSkillDocProtocol, resolvePageSkillMetadata } from "./ai/skills/skillDocProtocol";
-import { getReadableCliDb, type AgentCommandDeps } from "./agentCommandSupport";
-import { readDbRecord } from "./agentRecordHelpers";
-import {
-  resolveAuthToken,
-  resolveServerCandidates,
-  resolveServerUrl,
-} from "./cliEnvHelpers";
-import { readRecordWithCandidates } from "./hybridReadHelpers";
-
-type PageReadResult = {
-  baseUrl: string;
-  dbKey: string;
-  title: string | null;
-  spaceId: string | null;
-  type: string | null;
-  content: string | null;
-  meta: Record<string, any> | null;
-  record: Record<string, any>;
-};
-
-function usage(command: "doc" | "skill-doc") {
-  return [
-    "Usage:",
-    `  nolo ${command} read <pageKey>`,
-    "",
-  ].join("\n");
-}
-
-async function readPageRecord(args: {
-  db: Awaited<ReturnType<typeof getReadableCliDb>>;
-  authToken: string;
-  dbKey: string;
-  fetchImpl: typeof fetch;
-  fallbackFetchImpl?: typeof fetch;
-  serverCandidates: string[];
-}) {
-  return await readRecordWithCandidates<Record<string, any>>({
-    db: args.db,
-    dbKey: args.dbKey,
-    serverCandidates: args.serverCandidates,
-    readRemote: async (serverUrl, dbKey) =>
-      readDbRecord({
-        authToken: args.authToken,
-        dbKey,
-        fallbackFetchImpl: args.fallbackFetchImpl,
-        fetchImpl: args.fetchImpl,
-        serverUrl,
-      }),
-  });
-}
-
-function buildPageReadResult(baseUrl: string, dbKey: string, record: Record<string, any>): PageReadResult {
-  return {
-    baseUrl,
-    dbKey,
-    title: record?.title ?? null,
-    spaceId: record?.spaceId ?? null,
-    type: record?.type ?? null,
-    content: typeof record?.content === "string" ? record.content : null,
-    meta: record?.meta && typeof record.meta === "object" ? record.meta : null,
-    record,
-  };
-}
-
-async function runBasePageReadCommand(
-  args: string[],
-  deps: AgentCommandDeps,
-  mode: "doc" | "skill-doc"
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-  const raw = args[0]?.trim();
-  if (!raw || raw === "-h" || raw === "--help") {
-    output.write(`${usage(mode)}\n`);
-    return raw ? 0 : 1;
-  }
-
-  const authToken = resolveAuthToken(args, env);
-  if (!authToken) {
-    output.write(`[nolo] ${mode} read requires an auth token. Run \`nolo login\` or set 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 {
-    const record = await readPageRecord({
-      db,
-      authToken,
-      dbKey: raw,
-      fetchImpl,
-      fallbackFetchImpl,
-      serverCandidates,
-    });
-    const result = buildPageReadResult(defaultServerUrl, raw, record);
-
-    if (mode === "doc") {
-      output.write(`${JSON.stringify(result, null, 2)}\n`);
-      return 0;
-    }
-
-    const parsed = parseSkillDocProtocol(
-      typeof record?.content === "string" ? record.content : "",
-      record?.meta,
-      record?.tools
-    );
-    const meta = resolvePageSkillMetadata(record);
-    const skillConfig = meta?.skillConfig ?? null;
-
-    output.write(
-      `${JSON.stringify(
-        {
-          ...result,
-          isSkill: Boolean(meta?.kind === "skill" || skillConfig),
-          body: typeof parsed.content === "string" ? parsed.content : "",
-          meta: meta ?? result.meta,
-          skillConfig,
-        },
-        null,
-        2
-      )}\n`
-    );
-    return 0;
-  } catch (error) {
-    output.write(
-      `[nolo] ${mode} read failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-}
-
-export async function runDocReadCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  return runBasePageReadCommand(args, deps, "doc");
-}
-
-export async function runSkillDocReadCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  return runBasePageReadCommand(args, deps, "skill-doc");
-}