@vibe-forge/core 0.7.4 → 0.8.0

package/src/hooks/index.ts

@@ -1,39 +0,0 @@
-import type { Writable } from 'node:stream'
-
-import type { HookInputs, HookOutputs } from './type'
-
-export interface HookContext {
-  logger: {
-    stream: Writable
-    info: (...args: unknown[]) => void
-    warn: (...args: unknown[]) => void
-    debug: (...args: unknown[]) => void
-    error: (...args: unknown[]) => void
-  }
-}
-
-export type Plugin =
-  & {
-    name?: string
-  }
-  & {
-    [P in keyof HookInputs]: (
-      ctx: HookContext,
-      input: HookInputs[P],
-      next: () => Promise<HookOutputs[P]>
-    ) => Promise<HookOutputs[P]>
-  }
-
-export const definePlugin = (plugin: Partial<Plugin>) => plugin
-
-export interface PluginMap {}
-
-export type PluginConfig =
-  | (Partial<Plugin> | (() => Partial<Plugin>))[]
-  | Record<string, Record<string, unknown>>
-  | Partial<PluginMap>
-
-export * from './call'
-export * from './loader'
-export * from './runtime'
-export * from './type'

package/src/hooks/loader.ts

@@ -1,75 +0,0 @@
-import type { Plugin, PluginConfig } from './index'
-
-/**
- * 解析单个插件配置
- */
-const loadPlugin = async (
-  name: string,
-  config: Record<string, unknown>
-): Promise<Partial<Plugin> | null> => {
-  try {
-    // eslint-disable-next-line ts/no-require-imports
-    const module = require(`${name}/hooks`)
-
-    // 兼容 ESM default export 和 CJS module.exports
-    const factory: (
-      // 直接导出插件对象
-      | Partial<Plugin>
-      // 导出工厂函数，接受配置并返回插件对象
-      | ((config: Record<string, unknown>) => Partial<Plugin>)
-    ) = module.default ?? module
-
-    if (typeof factory === 'function') {
-      // TODO: 这里可以注入更多上下文，如全局配置、版本信息等
-      return factory(config)
-    } else if (typeof factory === 'object' && factory !== null) {
-      return factory
-    }
-
-    console.warn(`Plugin ${name} does not export a valid plugin factory or object.`)
-    return null
-  } catch (e) {
-    console.error(`Failed to load plugin ${name}:`, e)
-    return null
-  }
-}
-
-export const resolvePlugins = async (config: PluginConfig): Promise<Partial<Plugin>[]> => {
-  // 1. 处理数组形式配置 (直接实例化或函数调用)
-  if (Array.isArray(config)) {
-    return config.map((p) => (typeof p === 'function' ? p() : p))
-  }
-
-  // 2. 处理对象形式配置 (动态加载)
-  const entries = Object.entries(config)
-  if (entries.length === 0) return []
-
-  // 并行加载所有插件
-  const modules = await Promise.allSettled(
-    entries.map(([pkgName, pkgConfig]) => {
-      // 如果不是以 @ 或 @vibe-forge/plugin- 开头，则默认加上 @vibe-forge/plugin- 前缀
-      const resolvedName = pkgName.startsWith('@') ? pkgName : `@vibe-forge/plugin-${pkgName}`
-      // dprint-ignore
-      return (
-        loadPlugin(resolvedName, pkgConfig as Record<string, unknown>) ??
-        loadPlugin(pkgName, pkgConfig as Record<string, unknown>)
-      )
-    })
-  )
-
-  // 收集成功加载的插件
-  const plugins: Partial<Plugin>[] = []
-
-  modules.forEach((result, index) => {
-    const pkgName = entries[index][0]
-    if (result.status === 'fulfilled') {
-      if (result.value) {
-        plugins.push(result.value)
-      }
-    } else {
-      console.error(`Error loading plugin ${pkgName}:`, result.reason)
-    }
-  })
-
-  return plugins
-}

package/src/hooks/runtime.ts

@@ -1,139 +0,0 @@
-import { Buffer } from 'node:buffer'
-import process from 'node:process'
-
-import { loadConfig, resetConfigCache } from '#~/config/load.js'
-import { resolveServerLogLevel } from '#~/env.js'
-import { createLogger } from '#~/utils/create-logger.js'
-import { transformCamelKey } from '#~/utils/string-transform.js'
-
-import type { HookInput, HookInputs, HookOutputCore, HookOutputs } from './type'
-import type { HookContext, Plugin } from './index'
-import { resolvePlugins } from './loader'
-
-export const callPluginHook = async <K extends keyof HookInputs>(
-  eventName: K,
-  context: HookContext,
-  input: HookInputs[K],
-  plugins: Partial<Plugin>[] = []
-): Promise<HookOutputs[K]> => {
-  const { logger } = context
-  const filteredPlugins = plugins.filter(
-    (
-      item
-    ): item is
-      & {
-        name?: string
-      }
-      & {
-        [P in K]: NonNullable<Plugin[P]>
-      } => !!item && !!item[eventName]
-  )
-
-  let index = 0
-
-  const next = async (): Promise<HookOutputs[K]> => {
-    if (index >= filteredPlugins.length) {
-      return { continue: true }
-    }
-
-    const currentPlugin = filteredPlugins[index]
-    const { name = '<anonymous>', [eventName]: hook } = currentPlugin
-    index++
-
-    const withNameLogger = {
-      ...logger,
-      info: logger.info.bind(logger, `[plugin.${name}]`),
-      warn: logger.warn.bind(logger, `[plugin.${name}]`),
-      debug: logger.debug.bind(logger, `[plugin.${name}]`),
-      error: logger.error.bind(logger, `[plugin.${name}]`)
-    }
-
-    try {
-      return await hook(
-        {
-          ...context,
-          logger: withNameLogger
-        },
-        input,
-        next
-      )
-    } catch (error) {
-      if (error instanceof Error && !error.name.includes('[plugin.')) {
-        error.name = `${error.name}[plugin.${name}]`
-      }
-      throw error
-    }
-  }
-
-  return next()
-}
-
-export const executeHookInput = async (
-  input: HookInput,
-  env: Record<string, string | null | undefined> = process.env
-) => {
-  const workspaceFolder = env.__VF_PROJECT_WORKSPACE_FOLDER__ ?? input.cwd ?? process.env.HOME ?? '/'
-  const ctxId = env.__VF_PROJECT_AI_CTX_ID__ ?? input.sessionId ?? 'default'
-  const logPrefix = env.__VF_PROJECT_AI_LOG_PREFIX__ ?? ''
-  const loggerBase = createLogger(
-    workspaceFolder,
-    ctxId,
-    input.sessionId,
-    logPrefix,
-    resolveServerLogLevel(env)
-  )
-
-  const logger: typeof loggerBase = {
-    ...loggerBase,
-    info: (...args) => loggerBase.info(`[${input.hookEventName}]`, ...args),
-    warn: (...args) => loggerBase.warn(`[${input.hookEventName}]`, ...args),
-    debug: (...args) => loggerBase.debug(`[${input.hookEventName}]`, ...args),
-    error: (...args) => loggerBase.error(`[${input.hookEventName}]`, ...args)
-  }
-
-  resetConfigCache()
-  const jsonVariables = {
-    ...env,
-    WORKSPACE_FOLDER: workspaceFolder,
-    __VF_PROJECT_WORKSPACE_FOLDER__: workspaceFolder
-  }
-  const [config, userConfig] = await loadConfig({ jsonVariables })
-  const plugins = [
-    ...await resolvePlugins(config?.plugins ?? []),
-    ...await resolvePlugins(userConfig?.plugins ?? [])
-  ]
-
-  return callPluginHook(
-    input.hookEventName,
-    { logger },
-    input as HookInputs[typeof input.hookEventName],
-    plugins
-  )
-}
-
-export const readHookInput = async () => {
-  const stdoutBuffer = await new Promise<Buffer>((resolve) => {
-    const chunks: Buffer[] = []
-    process.stdin.on('data', chunk => chunks.push(chunk))
-    process.stdin.once('end', () => resolve(Buffer.concat(chunks)))
-  })
-
-  return transformCamelKey<HookInput>(
-    JSON.parse(stdoutBuffer.toString() || '{}')
-  )
-}
-
-export const runHookCli = async () => {
-  try {
-    const input = await readHookInput()
-    const result = await executeHookInput(input)
-    console.log(JSON.stringify(result))
-  } catch (error) {
-    console.log(
-      JSON.stringify({
-        continue: false,
-        stopReason: `run hook error: ${String(error)}`
-      } satisfies HookOutputCore)
-    )
-  }
-}

package/src/hooks/type.ts

@@ -1,120 +0,0 @@
-import type { ToolInput, ToolOutput } from '../tools'
-
-/**
- * https://docs.anthropic.com/en/docs/claude-code/hooks#hook-input
- */
-export interface HookInputCore {
-  cwd: string
-  sessionId: string
-  hookEventName: keyof HookInputs
-}
-
-export interface HookInputs {
-  /**
-   * https://docs.anthropic.com/en/docs/claude-code/hooks#pretooluse-input
-   */
-  PreToolUse: HookInputCore & ToolInput
-  /**
-   * https://docs.anthropic.com/en/docs/claude-code/hooks#posttooluse-input
-   */
-  PostToolUse: HookInputCore & ToolOutput
-  Notification: HookInputCore
-  UserPromptSubmit: HookInputCore & { prompt: string }
-  Stop: HookInputCore
-  SubagentStop: HookInputCore
-  PreCompact: HookInputCore
-  SessionStart: HookInputCore
-  SessionEnd: HookInputCore & {
-    reason: string
-  }
-
-  StartTasks: HookInputCore & {
-    tasks: Array<{
-      description: string
-      type: 'default' | 'spec' | 'entity'
-      name?: string
-      adapter?: string
-      background?: boolean
-    }>
-  }
-  GenerateSystemPrompt: HookInputCore & {
-    type?: 'spec' | 'entity'
-    name?: string
-    data?: unknown
-  }
-  TaskStart: HookInputCore & {
-    adapter?: string
-    options: unknown
-    adapterOptions: unknown
-  }
-  TaskStop: HookInputCore & {
-    exitCode?: number
-    stderr?: string
-    adapter?: string
-
-    options: unknown
-    adapterOptions: unknown
-  }
-}
-
-export type HookInput = HookInputs[keyof HookInputs]
-
-/**
- * https://docs.anthropic.com/en/docs/claude-code/hooks#common-json-fields
- */
-export interface HookOutputCore {
-  /**
-   * Whether Claude should continue after hook execution
-   * @default true
-   */
-  continue?: boolean
-  /**
-   * Message shown when continue is false
-   */
-  stopReason?: string
-  /**
-   * Hide stdout from transcript mode
-   * @default false
-   */
-  suppressOutput?: boolean
-  /**
-   * Optional warning message shown to the user
-   */
-  systemMessage?: string
-}
-
-export interface HookOutputs {
-  /**
-   * https://docs.anthropic.com/en/docs/claude-code/hooks#pretooluse-decision-control
-   */
-  PreToolUse: HookOutputCore & {
-    hookSpecificOutput?: {
-      hookEventName: 'PreToolUse'
-      permissionDecision: 'allow' | 'deny' | 'ask'
-      permissionDecisionReason: string
-    }
-  }
-  /**
-   * https://docs.anthropic.com/en/docs/claude-code/hooks#posttooluse-decision-control
-   */
-  PostToolUse: HookOutputCore & {
-    hookSpecificOutput?: {
-      hookEventName: 'PostToolUse'
-      additionalContext: string
-    }
-  }
-  Notification: HookOutputCore
-  UserPromptSubmit: HookOutputCore
-  Stop: HookOutputCore
-  SessionStart: HookOutputCore
-  SessionEnd: HookOutputCore
-  SubagentStop: HookOutputCore
-  PreCompact: HookOutputCore
-
-  StartTasks: HookOutputCore
-  GenerateSystemPrompt: HookOutputCore
-  TaskStart: HookOutputCore
-  TaskStop: HookOutputCore
-}
-
-export type HookOutput = HookOutputs[keyof HookOutputs]

package/src/utils/cache.ts

@@ -1,58 +0,0 @@
-import * as fs from 'node:fs/promises'
-import { dirname, resolve } from 'node:path'
-
-import type { Cache } from '@vibe-forge/core'
-
-declare module '@vibe-forge/core' {
-  interface Cache {
-  }
-}
-
-export const getCachePath = (
-  cwd: string,
-  taskId: string,
-  sessionId: string | undefined,
-  key: keyof Cache
-) => {
-  const taskDir = resolve(cwd, '.ai/caches', taskId)
-  const cacheDir = sessionId ? resolve(taskDir, sessionId) : taskDir
-  return resolve(cacheDir, `${key}.json`)
-}
-
-export const setCache = async <K extends keyof Cache>(
-  cwd: string,
-  taskId: string,
-  sessionId: string | undefined,
-  key: K,
-  value: Cache[K]
-) => {
-  const cachePath = getCachePath(cwd, taskId, sessionId, key)
-  const cacheDir = dirname(cachePath)
-  try {
-    await fs.access(cacheDir)
-  } catch {
-    await fs.mkdir(cacheDir, { recursive: true })
-  }
-  await fs.writeFile(cachePath, JSON.stringify(value, null, 2), {
-    flag: 'w'
-  })
-  return { cachePath }
-}
-
-export const getCache = async <K extends keyof Cache>(
-  cwd: string,
-  taskId: string,
-  sessionId: string | undefined,
-  key: K
-): Promise<Cache[K] | undefined> => {
-  const cachePath = getCachePath(cwd, taskId, sessionId, key)
-  try {
-    await fs.access(cachePath)
-  } catch (error) {
-    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
-      return undefined
-    }
-    throw error
-  }
-  return JSON.parse(await fs.readFile(cachePath, 'utf-8'))
-}

package/src/utils/create-logger.ts

@@ -1,89 +0,0 @@
-import { createWriteStream, existsSync, mkdirSync } from 'node:fs'
-import { dirname, resolve } from 'node:path'
-
-import type { LogLevel } from '#~/env.js'
-
-export interface Logger {
-  stream: NodeJS.WritableStream
-  info: (...args: unknown[]) => void
-  warn: (...args: unknown[]) => void
-  debug: (...args: unknown[]) => void
-  error: (...args: unknown[]) => void
-}
-
-const LOG_LEVEL_PRIORITY: Record<LogLevel, number> = {
-  debug: 10,
-  info: 20,
-  warn: 30,
-  error: 40
-}
-
-export const createLogger = (
-  cwd: string,
-  taskId: string,
-  sessionId: string,
-  logPrefix = '',
-  level: LogLevel = 'info'
-) => {
-  const normalizedSessionId = sessionId ?? 'default'
-  const taskDir = resolve(
-    cwd,
-    `.ai${logPrefix}/logs/${taskId}`
-  )
-
-  const loggerFilePath = resolve(
-    taskDir,
-    `${normalizedSessionId}.log.md`
-  )
-  // 默认日志文件不存在时，创建一个默认的日志文件
-  if (!existsSync(loggerFilePath)) {
-    mkdirSync(dirname(loggerFilePath), { recursive: true })
-  }
-  const loggerStream = createWriteStream(loggerFilePath, {
-    flags: 'a'
-  })
-  const createLog = (tag: string, currentLevel: LogLevel) => (...args: unknown[]) => {
-    if (LOG_LEVEL_PRIORITY[currentLevel] < LOG_LEVEL_PRIORITY[level]) {
-      return
-    }
-    const msg = args
-      .map((arg) => {
-        if (typeof arg === 'string') {
-          return arg
-        }
-        if (arg instanceof Error) {
-          return (
-            '\n```text\n' +
-            `${arg.stack}\n` +
-            '```'
-          )
-        }
-        return (
-          '\n```json\n' +
-          `${JSON.stringify(arg, null, 2)}\n` +
-          '```'
-        )
-      })
-      .join(' ')
-    const now = new Date().toLocaleString()
-    if (loggerStream.writableEnded) {
-      const tempLoggerStream = createWriteStream(loggerFilePath, {
-        flags: 'a'
-      })
-      tempLoggerStream.write(
-        `# [${now}] __E__ UNEXPECTED LOGGER STREAM ENDED\n`
-      )
-      tempLoggerStream.write(`# [${now}] __${tag}__ ${msg}\n`)
-      tempLoggerStream.end()
-      return
-    }
-    loggerStream.write(`# [${now}] __${tag}__ ${msg}\n`)
-  }
-  return {
-    stream: loggerStream,
-    info: createLog('I', 'info'),
-    warn: createLog('W', 'warn'),
-    debug: createLog('D', 'debug'),
-    error: createLog('E', 'error')
-  }
-}