@downcity/city 1.1.4 → 1.1.5

package/src/cli/CliReporter.ts

@@ -1,362 +0,0 @@
-/**
- * CLI Reporter：统一渲染 city 命令行输出。
- *
- * 关键点（中文）
- * - 为 lifecycle 类命令提供稳定、统一、层级清晰的文本版式。
- * - 将颜色、符号、对齐规则集中在这里，避免命令文件继续散落 `console.log` 模板串。
- * - 保持纯函数输出，方便测试并保证非 TTY 场景仍可读。
- */
-
-import chalk, { Chalk as ChalkConstructor } from "chalk";
-import type {
-  CliRenderOptions,
-  CliReportBlock,
-  CliReportFact,
-  CliReportList,
-  CliReportListItem,
-  CliReportTone,
-} from "@/types/cli/CliReporter.js";
-
-const FACT_LABEL_MIN_WIDTH = 8;
-/**
- * 解析终端可用宽度。
- *
- * 关键点（中文）
- * - 读取 process.stdout.columns，窄终端（<80）用更紧凑的排版。
- * - 最小 40 列，最大 120 列。
- */
-function resolveCliWidth(): number {
-  const columns = process.stdout.columns || 80;
-  if (columns < 80) return 40;
-  if (columns < 100) return 60;
-  return Math.min(columns - 20, 100);
-}
-/** 当前命令已输出的 section 计数（管理 section 间空行）。 */
-let cliSectionPrinted = false;
-/** 上一个 section 是否紧凑（无 facts/note）。 */
-let cliPreviousSectionCompact = false;
-
-/**
- * 全局 verbosity 级别。
- * - "quiet"：仅输出 error 级别 block。
- * - "normal"：输出全部内容（默认）。
- * - "verbose"：输出更多细节（暂同 normal）。
- */
-let cliVerbosity: "quiet" | "normal" | "verbose" = "normal";
-
-/**
- * 设置全局 verbosity 级别。
- *
- * 关键点（中文）
- * - 由 CLI 入口在 parse 前调用。
- * - quiet 模式下 suppress 所有非 error 的 emitCliBlock/emitCliList。
- */
-export function setCliVerbosity(level: "quiet" | "normal" | "verbose"): void {
-  cliVerbosity = level;
-}
-
-/**
- * CLI 语气对应的视觉调色板。
- */
-type CliTonePalette = {
-  /** 当前语气的标题颜色。 */
-  title: (text: string) => string;
-  /** 当前语气的状态颜色。 */
-  status: (text: string) => string;
-};
-
-/**
- * 解析当前渲染应使用的 chalk 实例。
- */
-function resolveChalk(options?: CliRenderOptions): typeof chalk {
-  if (options?.color === true) {
-    return new ChalkConstructor({ level: 1 });
-  }
-  if (options?.color === false) {
-    return new ChalkConstructor({ level: 0 });
-  }
-  return chalk;
-}
-
-/**
- * 解析语气对应的完整视觉调色板。
- */
-function resolveTonePalette(
-  tone: CliReportTone,
-  palette: typeof chalk,
-): CliTonePalette {
-  switch (tone) {
-    case "success":
-      return {
-        title: palette.bold,
-        status: palette.green,
-      };
-    case "warning":
-      return {
-        title: palette.bold,
-        status: palette.yellow,
-      };
-    case "error":
-      return {
-        title: palette.bold,
-        status: palette.red,
-      };
-    case "accent":
-      return {
-        title: palette.bold,
-        status: palette.cyan,
-      };
-    case "info":
-    default:
-      return {
-        title: palette.bold,
-        status: palette.blue,
-      };
-  }
-}
-
-/**
- * 计算详情标签列宽。
- */
-function resolveFactLabelWidth(facts: CliReportFact[]): number {
-  return facts.reduce((maxWidth, item) => {
-    return Math.max(
-      maxWidth,
-      normalizeFactLabel(String(item.label || "").trim()).length,
-    );
-  }, FACT_LABEL_MIN_WIDTH);
-}
-
-/**
- * 规范化详情标签。
- */
-function normalizeFactLabel(label: string): string {
-  return String(label || "").trim().toLowerCase();
-}
-
-/**
- * 渲染详情键值对行。
- */
-function formatFactLines(
-  facts: CliReportFact[],
-  indent: string,
-  options?: CliRenderOptions,
-): string[] {
-  const palette = resolveChalk(options);
-  const labelWidth = resolveFactLabelWidth(facts);
-  return facts.map((item) => {
-    const label = normalizeFactLabel(String(item.label || "")).padEnd(labelWidth, " ");
-    const value = formatFactValue(item.value, options);
-    return `${indent}${palette.dim(label)}  ${value}`;
-  });
-}
-
-/**
- * 渲染标题行。
- */
-function formatHeadingLine(params: {
-  tone: CliReportTone;
-  title: string;
-  summary?: string;
-  options?: CliRenderOptions;
-}): string {
-  const palette = resolveChalk(params.options);
-  const tonePalette = resolveTonePalette(params.tone, palette);
-  const renderedTitle = tonePalette.title(params.title);
-  if (!params.summary) {
-    return renderedTitle;
-  }
-  const plainSummary = String(params.summary || "").trim().toLowerCase();
-  const headlineWidth = resolveCliWidth();
-  const spacing = Math.max(
-    2,
-    headlineWidth - params.title.length - plainSummary.length,
-  );
-  return `${renderedTitle}${" ".repeat(spacing)}${tonePalette.status(plainSummary)}`;
-}
-
-/**
- * 根据值内容做轻量语义高亮。
- */
-function formatFactValue(
-  value: string,
-  options?: CliRenderOptions,
-): string {
-  const palette = resolveChalk(options);
-  const normalized = String(value || "");
-  if (/^https?:\/\//.test(normalized)) {
-    return palette.underline(normalized);
-  }
-  if (/^(started|stopped|ready|running)$/i.test(normalized)) {
-    return palette.green(normalized);
-  }
-  if (/^(already stopped|foreground)$/i.test(normalized)) {
-    return palette.blue(normalized);
-  }
-  if (/^(error|failed)$/i.test(normalized)) {
-    return palette.red(normalized);
-  }
-  return normalized;
-}
-
-/**
- * 渲染单个信息区块（纯文本，不输出到 stdout）。
- */
-export function formatCliBlock(
-  block: CliReportBlock,
-  options?: CliRenderOptions,
-): string {
-  const tone = block.tone || "info";
-  const palette = resolveChalk(options);
-  const lines = [
-    formatHeadingLine({
-      tone,
-      title: block.title,
-      summary: block.summary,
-      options,
-    }),
-  ];
-
-  if (Array.isArray(block.facts) && block.facts.length > 0) {
-    lines.push(...formatFactLines(block.facts, "  ", options));
-  }
-  if (block.note) {
-    const noteLabel = normalizeFactLabel("note").padEnd(
-      Math.max(FACT_LABEL_MIN_WIDTH, "note".length),
-      " ",
-    );
-    lines.push(`  ${palette.dim(noteLabel)}  ${block.note}`);
-  }
-
-  return lines.join("\n");
-}
-
-/**
- * 渲染列表项（纯文本）。
- */
-function formatCliListItem(
-  item: CliReportListItem,
-  options?: CliRenderOptions,
-): string[] {
-  const tone = item.tone || "info";
-  const lines = [
-    `  ${formatHeadingLine({
-      tone,
-      title: item.title,
-      options,
-    })}`,
-  ];
-  if (Array.isArray(item.facts) && item.facts.length > 0) {
-    lines.push(...formatFactLines(item.facts, "    ", options));
-  }
-  return lines;
-}
-
-/**
- * 渲染列表分组（纯文本）。
- */
-export function formatCliList(
-  list: CliReportList,
-  options?: CliRenderOptions,
-): string {
-  const tone = list.tone || "accent";
-  const lines = [
-    formatHeadingLine({
-      tone,
-      title: list.title,
-      summary: list.summary,
-      options,
-    }),
-  ];
-
-  for (const item of list.items) {
-    lines.push(...formatCliListItem(item, options));
-  }
-
-  return lines.join("\n");
-}
-
-/**
- * 渲染命令顶部 banner（纯文本）。
- */
-export function formatCliHeader(
-  version: string,
-  options?: CliRenderOptions,
-): string {
-  const palette = resolveChalk(options);
-  return `${palette.bold("downcity")} ${palette.dim(`v${version}`)}`;
-}
-
-/**
- * 重置当前命令的输出分组节奏。
- *
- * 关键点（中文）
- * - 每次新的 CLI 命令开始输出前都应先重置。
- * - 这样不同命令之间不会串联复用上一条命令的留白状态。
- */
-export function resetCliSectionFlow(): void {
-  cliSectionPrinted = false;
-  cliPreviousSectionCompact = false;
-}
-
-/**
- * 以统一节奏输出一个 section。
- *
- * 关键点（中文）
- * - 第二个 section 起会自动插入一个空行，拉开模块层级。
- * - 只负责打印节奏，不参与格式拼装。
- */
-function emitCliSection(text: string, compact: boolean): void {
-  if (cliSectionPrinted && !(cliPreviousSectionCompact && compact)) {
-    console.log("");
-  }
-  console.log(text);
-  cliSectionPrinted = true;
-  cliPreviousSectionCompact = compact;
-}
-
-/**
- * 判断 block 是否属于紧凑步骤行。
- */
-function isCompactCliBlock(block: CliReportBlock): boolean {
-  return (!block.facts || block.facts.length === 0) && !block.note;
-}
-
-/**
- * 判断 list 是否属于紧凑列表。
- */
-function isCompactCliList(list: CliReportList): boolean {
-  return list.items.every((item) => !item.facts || item.facts.length === 0);
-}
-
-/**
- * 输出 header section。
- */
-export function emitCliHeader(
-  version: string,
-  options?: CliRenderOptions,
-): void {
-  emitCliSection(formatCliHeader(version, options), false);
-}
-
-/**
- * 输出 block section。
- */
-export function emitCliBlock(
-  block: CliReportBlock,
-  options?: CliRenderOptions,
-): void {
-  if (cliVerbosity === "quiet" && block.tone !== "error") return;
-  emitCliSection(formatCliBlock(block, options), isCompactCliBlock(block));
-}
-
-/**
- * 输出 list section。
- */
-export function emitCliList(
-  list: CliReportList,
-  options?: CliRenderOptions,
-): void {
-  if (cliVerbosity === "quiet") return;
-  emitCliSection(formatCliList(list, options), isCompactCliList(list));
-}

package/src/cli/Config.ts

@@ -1,301 +0,0 @@
-/**
- * `city config` 命令组。
- *
- * 目标（中文）
- * - 提供 downcity.json 的通用读写能力（get/set/unset）。
- * - 提供 alias 写入能力。
- * - 所有输出统一支持 JSON（默认）与可读文本两种模式。
- */
-
-import path from "node:path";
-import fs from "fs-extra";
-import type { Command } from "commander";
-import { getDowncityJsonPath } from "@/config/Paths.js";
-import { printResult } from "@/utils/cli/CliOutput.js";
-import { aliasCommand } from "./Alias.js";
-import { parseBoolean } from "./IndexSupport.js";
-import { resolveProjectRoot } from "./ServiceCommandSupport.js";
-import type { DowncityConfig } from "@downcity/agent/shared/types/DowncityConfig.js";
-
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function parseConfigPath(pathInput: string): string[] {
-  const trimmed = String(pathInput || "").trim();
-  if (!trimmed) {
-    throw new Error("Config path cannot be empty");
-  }
-  const parts = trimmed.split(".");
-  if (parts.some((x) => x.trim().length === 0)) {
-    throw new Error(`Invalid config path: ${pathInput}`);
-  }
-  return parts.map((x) => x.trim());
-}
-
-function parseConfigValue(rawValue: string): unknown {
-  const trimmed = String(rawValue).trim();
-  if (!trimmed) return "";
-  try {
-    return JSON.parse(trimmed) as unknown;
-  } catch {
-    return rawValue;
-  }
-}
-
-function readDowncityConfigByPath(
-  downcityJsonPath: string,
-  scope: "project" | "console",
-): { downcityJsonPath: string; config: DowncityConfig } {
-  if (!fs.existsSync(downcityJsonPath)) {
-    const hint =
-      scope === "console"
-        ? 'Run "city init" first.'
-        : 'Run "city agent create" first.';
-    throw new Error(`downcity.json not found at ${downcityJsonPath}. ${hint}`);
-  }
-  const raw = fs.readJsonSync(downcityJsonPath) as unknown;
-  if (!isPlainObject(raw)) {
-    throw new Error("Invalid downcity.json: expected object");
-  }
-  const candidate = raw as Partial<DowncityConfig>;
-  if (typeof candidate.name !== "string" || typeof candidate.version !== "string") {
-    throw new Error("Invalid downcity.json: missing required fields name/version");
-  }
-  return { downcityJsonPath, config: candidate as DowncityConfig };
-}
-
-function readDowncityConfig(projectRoot: string): { downcityJsonPath: string; config: DowncityConfig } {
-  return readDowncityConfigByPath(getDowncityJsonPath(projectRoot), "project");
-}
-
-function writeDowncityConfig(downcityJsonPath: string, config: DowncityConfig): void {
-  fs.writeJsonSync(downcityJsonPath, config, { spaces: 2 });
-}
-
-function getByPath(
-  root: Record<string, unknown>,
-  pathTokens: string[],
-): { found: boolean; value?: unknown } {
-  let cursor: unknown = root;
-  for (const token of pathTokens) {
-    if (!isPlainObject(cursor) || !(token in cursor)) {
-      return { found: false };
-    }
-    cursor = cursor[token];
-  }
-  return { found: true, value: cursor };
-}
-
-function setByPath(
-  root: Record<string, unknown>,
-  pathTokens: string[],
-  nextValue: unknown,
-): { existed: boolean; previous: unknown } {
-  let cursor: Record<string, unknown> = root;
-  for (let i = 0; i < pathTokens.length - 1; i += 1) {
-    const key = pathTokens[i];
-    const current = cursor[key];
-    if (current === undefined) {
-      cursor[key] = {};
-      cursor = cursor[key] as Record<string, unknown>;
-      continue;
-    }
-    if (!isPlainObject(current)) {
-      throw new Error(
-        `Cannot set path "${pathTokens.join(".")}": "${pathTokens
-          .slice(0, i + 1)
-          .join(".")}" is not an object`,
-      );
-    }
-    cursor = current;
-  }
-  const leaf = pathTokens[pathTokens.length - 1];
-  const existed = Object.prototype.hasOwnProperty.call(cursor, leaf);
-  const previous = cursor[leaf];
-  cursor[leaf] = nextValue;
-  return { existed, previous };
-}
-
-function unsetByPath(
-  root: Record<string, unknown>,
-  pathTokens: string[],
-): { removed: boolean; previous: unknown } {
-  let cursor: Record<string, unknown> = root;
-  for (let i = 0; i < pathTokens.length - 1; i += 1) {
-    const key = pathTokens[i];
-    const current = cursor[key];
-    if (!isPlainObject(current)) {
-      return { removed: false, previous: undefined };
-    }
-    cursor = current;
-  }
-  const leaf = pathTokens[pathTokens.length - 1];
-  if (!Object.prototype.hasOwnProperty.call(cursor, leaf)) {
-    return { removed: false, previous: undefined };
-  }
-  const previous = cursor[leaf];
-  delete cursor[leaf];
-  return { removed: true, previous };
-}
-
-function runConfigCommand(
-  options: { path?: string; json?: boolean },
-  handler: (input: {
-    projectRoot: string;
-    downcityJsonPath: string;
-    config: DowncityConfig;
-  }) => {
-    title: string;
-    payload: Record<string, unknown>;
-    save?: boolean;
-  },
-): void {
-  const asJson = options.json !== false;
-  try {
-    const projectRoot = resolveProjectRoot(options.path);
-    const { downcityJsonPath, config } = readDowncityConfig(projectRoot);
-    const result = handler({ projectRoot, downcityJsonPath, config });
-    if (result.save) {
-      writeDowncityConfig(downcityJsonPath, config);
-    }
-    printResult({
-      asJson,
-      success: true,
-      title: result.title,
-      payload: {
-        projectRoot,
-        downcityJsonPath,
-        ...result.payload,
-      },
-    });
-  } catch (error) {
-    printResult({
-      asJson,
-      success: false,
-      title: "config command failed",
-      payload: {
-        error: error instanceof Error ? error.message : String(error),
-      },
-    });
-    process.exitCode = 1;
-  }
-}
-
-function applyCommonOptions(command: Command): Command {
-  return command
-    .option("--path <path>", "项目根目录（默认当前目录）", ".")
-    .option("--json [enabled]", "以 JSON 输出", parseBoolean, true);
-}
-
-/**
- * 注册 `city config` 命令组。
- */
-export function registerConfigCommand(program: Command): void {
-  const config = program
-    .command("config")
-    .description("管理 downcity.json 配置与 alias")
-    .helpOption("--help", "display help for command");
-
-  applyCommonOptions(
-    config
-      .command("get [keyPath]")
-      .description("读取 downcity.json（可选读取单个路径）")
-      .helpOption("--help", "display help for command"),
-  ).action((keyPath: string | undefined, options: { path?: string; json?: boolean }) => {
-    runConfigCommand(options, ({ config: downcityConfig }) => {
-      if (!keyPath) {
-        return {
-          title: "config loaded",
-          payload: { config: downcityConfig },
-        };
-      }
-      const pathTokens = parseConfigPath(keyPath);
-      const got = getByPath(downcityConfig as unknown as Record<string, unknown>, pathTokens);
-      if (!got.found) {
-        throw new Error(`Config path not found: ${keyPath}`);
-      }
-      return {
-        title: "config value loaded",
-        payload: {
-          keyPath,
-          value: got.value,
-        },
-      };
-    });
-  });
-
-  applyCommonOptions(
-    config
-      .command("set <keyPath> <value>")
-      .description("设置 downcity.json 指定路径的值（value 支持 JSON 字面量）")
-      .helpOption("--help", "display help for command"),
-  ).action(
-    (
-      keyPath: string,
-      value: string,
-      options: { path?: string; json?: boolean },
-    ) => {
-      const pathTokens = parseConfigPath(keyPath);
-      runConfigCommand(options, ({ config: downcityConfig }) => {
-        const parsed = parseConfigValue(value);
-        const changed = setByPath(
-          downcityConfig as unknown as Record<string, unknown>,
-          pathTokens,
-          parsed,
-        );
-        return {
-          title: "config value updated",
-          save: true,
-          payload: {
-            keyPath,
-            value: parsed,
-            existed: changed.existed,
-            previous: changed.previous,
-          },
-        };
-      });
-    },
-  );
-
-  applyCommonOptions(
-    config
-      .command("unset <keyPath>")
-      .description("删除 downcity.json 指定路径")
-      .helpOption("--help", "display help for command"),
-  ).action((keyPath: string, options: { path?: string; json?: boolean }) => {
-    const pathTokens = parseConfigPath(keyPath);
-    runConfigCommand(options, ({ config: downcityConfig }) => {
-      const removed = unsetByPath(
-        downcityConfig as unknown as Record<string, unknown>,
-        pathTokens,
-      );
-      if (!removed.removed) {
-        throw new Error(`Config path not found: ${keyPath}`);
-      }
-      return {
-        title: "config value removed",
-        save: true,
-        payload: {
-          keyPath,
-          previous: removed.previous,
-        },
-      };
-    });
-  });
-
-  config
-    .command("alias")
-    .description("在 .zshrc / .bashrc 中写入 `alias city=\"downcity\"`")
-    .option("--shell <shell>", "指定写入的 shell: zsh | bash | both", "both")
-    .option("--dry-run", "只打印将要修改的文件，不实际写入", false)
-    .option("--print", "仅打印 alias 内容（用于 eval）", false)
-    .helpOption("--help", "display help for command")
-    .action(async (options: { shell?: string; dryRun?: boolean; print?: boolean }) => {
-      await aliasCommand({
-        shell: options.shell,
-        dryRun: Boolean(options.dryRun),
-        print: Boolean(options.print),
-      });
-    });
-}