@actiondock/core 2.0.11 → 2.0.12

package/src/registry/types.ts

@@ -1,127 +0,0 @@
-/**
- * 本地软链接（Link）注册的 Package 实体记录。
- */
-export interface LinkedPackageEntry {
-  /** Package 唯一 ID */
-  id: string;
-  /** 展示名称 */
-  name: string;
-  /** 版本号 */
-  version: string;
-  /** 源码物理目录绝对路径 */
-  path: string;
-  /** 建立软链接的时间戳（ISO 8601） */
-  linkedAt: string;
-  /** 所属 Workspace 根目录（如果是通过 Workspace 自动关联的） */
-  workspaceRoot?: string;
-}
-
-/**
- * 本地软链接（Link）注册的 Workspace 工作区目录记录。
- */
-export interface LinkedWorkspaceEntry {
-  /** 工作区物理目录绝对路径 */
-  path: string;
-  /** 建立软链接的时间戳（ISO 8601） */
-  linkedAt: string;
-}
-
-/**
- * 全局 Registry 数据结构（~/.actiondock/registry.json）。
- */
-export interface GlobalRegistryData {
-  version: "2.0.0";
-  packages: Record<string, LinkedPackageEntry>;
-  workspaces?: Record<string, LinkedWorkspaceEntry>;
-}
-
-/**
- * Link 操作返回结果。
- */
-export interface LinkResult {
-  id: string;
-  name: string;
-  version: string;
-  path: string;
-  linkedAt: string;
-  isWorkspace?: boolean;
-  entries: LinkedPackageEntry[];
-  workspace?: LinkedWorkspaceEntry;
-}
-
-/**
- * Unlink 操作返回结果。
- */
-export interface UnlinkResult {
-  type: "package" | "workspace";
-  id: string;
-  path: string;
-  packagesCount?: number;
-  removedPackage?: LinkedPackageEntry;
-  removedWorkspace?: LinkedWorkspaceEntry;
-}
-
-/**
- * 注册表树形层级节点。
- */
-export interface RegistryTreeItem {
-  type: "workspace" | "package";
-  id: string;
-  name?: string;
-  version?: string;
-  path: string;
-  status: "active" | "stale";
-  packagesCount?: number;
-  children?: Array<{
-    id: string;
-    name: string;
-    version: string;
-    path: string;
-    status: "active" | "stale";
-  }>;
-}
-
-/**
- * 注册表健康状态与列表报告。
- */
-export interface RegistryStatusReport {
-  workspaces: RegistryTreeItem[];
-  packages: RegistryTreeItem[];
-  staleCount: number;
-  totalPackagesCount: number;
-}
-
-/**
- * 失效清理结果。
- */
-export interface PruneResult {
-  prunedPackages: LinkedPackageEntry[];
-  prunedWorkspaces: LinkedWorkspaceEntry[];
-}
-
-/**
- * Action 归属项目解析结果。
- */
-export interface ResolvedActionProject {
-  /** 所在项目的根目录绝对路径 */
-  projectRoot: string;
-  /** 所属 Package ID */
-  packageId: string;
-  /** 匹配到的 Action ID */
-  actionId: string;
-}
-
-/**
- * Playbook 归属项目解析结果。
- */
-export interface ResolvedPlaybookProject {
-  /** 所在项目的根目录绝对路径 */
-  projectRoot: string;
-  /** 所属 Package ID */
-  packageId: string;
-  /** 匹配到的 Playbook ID */
-  playbookId: string;
-  /** Playbook 实体数据 */
-  playbook: import("../project/types").PlaybookDefinition;
-}
-

package/src/runtime/clock.ts

@@ -1,41 +0,0 @@
-/**
- * 统一时间与时钟接口。
- */
-export interface Clock {
-  /** 获取当前系统墙上时间 */
-  now(): Date;
-  /** 获取单调递增时间戳（单位：毫秒） */
-  monotonic(): number;
-  /** 异步休眠指定毫秒 */
-  sleep(ms: number): Promise<void>;
-}
-
-/**
- * 生产环境系统时钟实现。
- */
-export class SystemClock implements Clock {
-  now(): Date {
-    return new Date();
-  }
-
-  monotonic(): number {
-    if (typeof performance !== "undefined" && typeof performance.now === "function") {
-      return performance.now();
-    }
-    return Date.now();
-  }
-
-  sleep(ms: number): Promise<void> {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-  }
-}
-
-let defaultClock: Clock = new SystemClock();
-
-export function getSystemClock(): Clock {
-  return defaultClock;
-}
-
-export function setSystemClock(clock: Clock): void {
-  defaultClock = clock;
-}

package/src/runtime/context.ts

@@ -1,259 +0,0 @@
-import { randomUUID } from "node:crypto";
-import type {
-  ActionContext,
-  ActionDefinition,
-  ActionInvoker,
-  ActionRef,
-  Config,
-  Logger,
-  ProcessAPI,
-  ProgressReporter,
-  StateStore,
-} from "@actiondock/sdk";
-import type { ProjectConfig } from "../project/types";
-import { createGlobalStorage } from "../storage";
-import type { RuntimeStorage } from "../storage/types";
-import { resolveEnvValue } from "./env";
-import { getProcessExecutor } from "./process";
-
-/**
- * 生产级配置解析器实现。
- * 严格践行 5 层配置解析优先级链：
- * 1. CLI 临时参数覆写 (Overrides)
- * 2. 本地项目持久化存储 (Local SQLite: .actiondock/runtime.db)
- * 3. 全局共享持久化存储 (Global SQLite: ~/.actiondock/global.db)
- * 4. 操作系统环境变量 (process.env: 显式绑定 / 包名前缀 / SNAKE_CASE / 类型转换)
- * 5. 项目默认配置 (actiondock.json 中的 default 字段)
- * 6. 代码级默认回退值 (fallback)
- */
-export class RuntimeConfig implements Config {
-  private overrides: Map<string, unknown>;
-  private storage: RuntimeStorage;
-  private projectConfig?: ProjectConfig;
-  private globalStorage?: RuntimeStorage;
-
-  constructor(
-    storage: RuntimeStorage,
-    overrides: Record<string, unknown> = {},
-    projectConfig?: ProjectConfig,
-    globalStorage?: RuntimeStorage
-  ) {
-    this.storage = storage;
-    this.overrides = new Map(Object.entries(overrides));
-    this.projectConfig = projectConfig;
-    this.globalStorage = globalStorage !== undefined ? globalStorage : createGlobalStorage();
-  }
-
-  get<T = unknown>(key: string): T | undefined;
-  get<T = unknown>(key: string, defaultValue: T): T;
-  get<T = unknown>(key: string, defaultValue?: T): T | undefined {
-    // 1. CLI 临时参数覆盖
-    if (this.overrides.has(key)) {
-      return this.overrides.get(key) as T;
-    }
-
-    // 2. 本地项目 SQLite 存储
-    const stored = this.storage.getConfig<T>(key);
-    if (stored !== undefined) {
-      return stored;
-    }
-
-    // 3. 全局 SQLite 存储 (~/.actiondock/global.db)
-    if (this.globalStorage) {
-      try {
-        const globalStored = this.globalStorage.getConfig<T>(key);
-        if (globalStored !== undefined) {
-          return globalStored;
-        }
-      } catch {
-        // 忽略全局存储读取异常
-      }
-    }
-
-    // 4. 环境变量（支持包名前缀、SNAKE_CASE 转换与类型自动推断）
-    const itemDef = this.projectConfig?.config?.[key];
-    const envResolved = resolveEnvValue(key, itemDef, this.projectConfig?.id);
-    if (envResolved !== undefined) {
-      return envResolved.value as T;
-    }
-
-    // 5. 项目声明的默认值 (actiondock.json)
-    if (itemDef?.default !== undefined) {
-      return itemDef.default as T;
-    }
-
-    // 6. 调用方传入的代码级回退默认值
-    return defaultValue;
-  }
-
-  has(key: string): boolean {
-    if (this.overrides.has(key)) return true;
-    if (this.storage.getConfig(key) !== undefined) return true;
-    if (this.globalStorage?.getConfig(key) !== undefined) return true;
-    const itemDef = this.projectConfig?.config?.[key];
-    if (resolveEnvValue(key, itemDef, this.projectConfig?.id) !== undefined) return true;
-    if (itemDef?.default !== undefined) return true;
-    return false;
-  }
-}
-
-/**
- * 生产级状态存储实现，将状态持久化到 SQLite 中，完整支持命名空间分段隔离与 TTL。
- */
-export class RuntimeStateStore implements StateStore {
-  private storage: RuntimeStorage;
-  private namespace: string;
-
-  constructor(storage: RuntimeStorage, namespace = "") {
-    this.storage = storage;
-    this.namespace = namespace;
-  }
-
-  async get<T = unknown>(key: string): Promise<T | undefined> {
-    return this.storage.getState<T>(this.namespace, key);
-  }
-
-  async set<T = unknown>(
-    key: string,
-    value: T,
-    ttl?: number
-  ): Promise<void> {
-    return this.storage.setState<T>(this.namespace, key, value, ttl);
-  }
-
-  async delete(key: string): Promise<boolean> {
-    return this.storage.deleteState(this.namespace, key);
-  }
-
-  async clear(prefix = ""): Promise<number> {
-    return this.storage.clearState({
-      namespace: this.namespace,
-      prefix: prefix || undefined,
-    });
-  }
-
-  async keys(prefix = ""): Promise<string[]> {
-    return this.storage.listStateKeys(this.namespace, prefix);
-  }
-
-  scope(namespace: string): StateStore {
-    const nextNs = this.namespace
-      ? `${this.namespace}:${namespace}`
-      : namespace;
-    return new RuntimeStateStore(this.storage, nextNs);
-  }
-}
-
-/**
- * 标准 Stderr 日志记录器实现。
- * 遵循 Unix 哲学：所有诊断与追踪日志输出至 stderr，确保 stdout 纯净保留 JSON 信封。
- */
-export class StderrLogger implements Logger {
-  private prefix: string;
-
-  constructor(prefix = "") {
-    this.prefix = prefix ? `[${prefix}] ` : "";
-  }
-
-  private format(level: string, message: string, data?: unknown): string {
-    const time = new Date().toISOString().slice(11, 19);
-    const base = `[${time}] [${level.toUpperCase()}] ${this.prefix}${message}`;
-    if (data !== undefined) {
-      return `${base} ${typeof data === "object" ? JSON.stringify(data) : data}`;
-    }
-    return base;
-  }
-
-  debug(message: string, data?: unknown): void {
-    process.stderr.write(this.format("debug", message, data) + "\n");
-  }
-
-  info(message: string, data?: unknown): void {
-    process.stderr.write(this.format("info", message, data) + "\n");
-  }
-
-  warn(message: string, data?: unknown): void {
-    process.stderr.write(this.format("warn", message, data) + "\n");
-  }
-
-  error(message: string, data?: unknown): void {
-    process.stderr.write(this.format("error", message, data) + "\n");
-  }
-}
-
-/**
- * 创建 ActionContext 上下文所需的选项集合。
- */
-export interface ContextOptions {
-  storage: RuntimeStorage;
-  overrides?: Record<string, unknown>;
-  projectConfig?: ProjectConfig;
-  parentRunId?: string;
-  runId?: string;
-  rootRunId?: string;
-  callStack?: string[];
-  signal?: AbortSignal;
-  process?: ProcessAPI;
-  progress?: ProgressReporter;
-  logger?: Logger;
-  onActionInvoke?: (
-    action: ActionDefinition | ActionRef | string,
-    input: unknown,
-    parentRunId?: string
-  ) => Promise<unknown>;
-}
-
-/**
- * 构建并装配传递给 Action 的完整 ActionContext 运行时上下文。
- * 
- * @param options 上下文构建参数
- * @returns 组装完毕的 ActionContext 实例
- */
-export function createActionContext(options: ContextOptions): ActionContext {
-  const config = new RuntimeConfig(
-    options.storage,
-    options.overrides,
-    options.projectConfig
-  );
-  const state = new RuntimeStateStore(options.storage);
-  const log = options.logger || new StderrLogger();
-  const signal = options.signal ?? new AbortController().signal;
-  const currentRunId = options.runId || randomUUID();
-  const currentRootRunId = options.rootRunId || options.parentRunId || currentRunId;
-
-  const invoker: ActionInvoker = {
-    async invoke<I, O>(
-      action: ActionDefinition<I, O> | ActionRef | string,
-      input?: I
-    ): Promise<O> {
-      if (options.onActionInvoke) {
-        return (await options.onActionInvoke(
-          action as any,
-          input,
-          currentRunId
-        )) as O;
-      }
-      throw new Error("ActionInvoker not configured with an invocation delegate");
-    },
-  };
-
-  const processApi = options.process || getProcessExecutor();
-  const progressApi: ProgressReporter = options.progress || {
-    report() {},
-  };
-
-  return {
-    config,
-    state,
-    actions: invoker,
-    process: processApi,
-    log,
-    progress: progressApi,
-    signal,
-    run: {
-      id: currentRunId,
-      rootId: currentRootRunId,
-      parentId: options.parentRunId,
-    },
-  };
-}

package/src/runtime/env.ts

@@ -1,172 +0,0 @@
-import type { ConfigItemDefinition, ConfigValueType } from "../project/types";
-
-/**
- * 从环境变量成功解析后的结构体。
- */
-export interface ResolvedEnv {
-  /** 转换类型后的配置值 */
-  value: unknown;
-  /** 命中的具体环境变量键名 */
-  envKey: string;
-  /** 数据来源标识 */
-  source: "env";
-}
-
-/**
- * 将任意命名格式的字符串转换为标准的大写蛇形命名（UPPER_SNAKE_CASE）。
- * 兼容处理 camelCase、kebab-case、点号分隔以及斜杠等符号。
- * 
- * @param str 输入字符串，如 "apiKey"、"team4u.github-tools"
- * @returns 转换后的字符串，如 "API_KEY"、"TEAM4U_GITHUB_TOOLS"
- */
-export function toSnakeUpperCase(str: string): string {
-  return str
-    .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
-    .replace(/[-.\s/]+/g, "_")
-    .toUpperCase();
-}
-
-/**
- * 当未显式声明类型时，根据默认值的值类型智能推断目标配置类型。
- * 
- * @param defaultVal 默认值
- * @returns 推断出的 ConfigValueType 或 undefined
- */
-export function inferTypeFromDefault(defaultVal: unknown): ConfigValueType | undefined {
-  if (defaultVal === undefined || defaultVal === null) return undefined;
-  if (typeof defaultVal === "boolean") return "boolean";
-  if (typeof defaultVal === "number") return "number";
-  if (Array.isArray(defaultVal)) return "array";
-  if (typeof defaultVal === "object") return "object";
-  if (typeof defaultVal === "string") return "string";
-  return undefined;
-}
-
-/**
- * 将从 process.env 获取的原始字符串安全转换为目标类型。
- * 
- * 支持类型：
- * - boolean: "true"/"1"/"yes"/"on" -> true; "false"/"0"/"no"/"off" -> false
- * - number: 自动转换为数字，非数字时回退为原始字符串
- * - object / array: 自动尝试 JSON.parse 反序列化
- * - 自动探测: 当 targetType 未指定时，自动识别布尔值及 JSON 对象/数组
- * 
- * @param rawValue process.env 中的原始字符串
- * @param targetType 期望转换的目标类型
- */
-export function coerceEnvValue(
-  rawValue: string,
-  targetType?: ConfigValueType
-): unknown {
-  if (targetType === "boolean") {
-    const lower = rawValue.trim().toLowerCase();
-    if (["true", "1", "yes", "on"].includes(lower)) return true;
-    if (["false", "0", "no", "off"].includes(lower)) return false;
-    return Boolean(rawValue);
-  }
-
-  if (targetType === "number") {
-    const trimmed = rawValue.trim();
-    const num = Number(trimmed);
-    return isNaN(num) ? rawValue : num;
-  }
-
-  if (targetType === "object" || targetType === "array") {
-    try {
-      return JSON.parse(rawValue);
-    } catch {
-      return rawValue;
-    }
-  }
-
-  if (targetType === "string") {
-    return rawValue;
-  }
-
-  // 智能自动探测
-  const trimmed = rawValue.trim();
-  const lower = trimmed.toLowerCase();
-  if (lower === "true") return true;
-  if (lower === "false") return false;
-  if (
-    (trimmed.startsWith("{") && trimmed.endsWith("}")) ||
-    (trimmed.startsWith("[") && trimmed.endsWith("]"))
-  ) {
-    try {
-      return JSON.parse(trimmed);
-    } catch {
-      // 保持为字符串
-    }
-  }
-
-  return rawValue;
-}
-
-/**
- * 从操作系统环境变量 (process.env) 中解析配置值。
- * 严格遵循多层回退候选链：
- * 1. actiondock.json 中声明的显式环境变量绑定 (itemDef.env)
- * 2. 带包名前缀的变量: `ACTIONDOCK_<PACKAGE>_<KEY>` 以及 `<PACKAGE>_<KEY>`
- * 3. 标准大写蛇形变量: `<KEY>` (SNAKE_CASE)
- * 4. 原始键名原样匹配
- * 
- * @param key 配置键名
- * @param itemDef 配置项元数据定义
- * @param packageId 所属包 ID
- * @returns 命中的 ResolvedEnv 对象或 undefined
- */
-export function resolveEnvValue(
-  key: string,
-  itemDef?: ConfigItemDefinition,
-  packageId?: string
-): ResolvedEnv | undefined {
-  if (typeof process === "undefined" || !process.env) {
-    return undefined;
-  }
-
-  const candidateKeys = new Set<string>();
-
-  // 1. actiondock.json 中显式声明的 env 变量名
-  if (itemDef?.env) {
-    if (Array.isArray(itemDef.env)) {
-      for (const e of itemDef.env) {
-        if (typeof e === "string" && e.trim()) {
-          candidateKeys.add(e.trim());
-        }
-      }
-    } else if (typeof itemDef.env === "string" && itemDef.env.trim()) {
-      candidateKeys.add(itemDef.env.trim());
-    }
-  }
-
-  // 2. 包名前缀的环境变量 (例如 ACTIONDOCK_GITHUB_TOOLS_API_KEY)
-  const snakeKey = toSnakeUpperCase(key);
-  if (packageId) {
-    const cleanPkg = toSnakeUpperCase(packageId);
-    candidateKeys.add(`ACTIONDOCK_${cleanPkg}_${snakeKey}`);
-    candidateKeys.add(`${cleanPkg}_${snakeKey}`);
-  }
-
-  // 3. 标准大写蛇形变量名 (例如 API_KEY)
-  candidateKeys.add(snakeKey);
-
-  // 4. 原始键名 (例如 apiKey)
-  candidateKeys.add(key);
-
-  // 按优先级顺序依次检索环境变量
-  const effectiveType = itemDef?.type || inferTypeFromDefault(itemDef?.default);
-
-  for (const envKey of candidateKeys) {
-    const rawVal = process.env[envKey];
-    if (rawVal !== undefined) {
-      const coerced = coerceEnvValue(rawVal, effectiveType);
-      return {
-        value: coerced,
-        envKey,
-        source: "env",
-      };
-    }
-  }
-
-  return undefined;
-}