cscec-super-code 0.0.53

package/dist/plugin-handlers/plugin-components-loader.d.ts

@@ -0,0 +1,22 @@
+import type { CscecSuperCodeConfig } from "../config";
+export type PluginComponents = {
+    commands: Record<string, unknown>;
+    skills: Record<string, unknown>;
+    agents: Record<string, unknown>;
+    mcpServers: Record<string, unknown>;
+    hooksConfigs: Array<{
+        hooks?: Record<string, unknown>;
+    }>;
+    plugins: Array<{
+        name: string;
+        version: string;
+    }>;
+    errors: Array<{
+        pluginKey: string;
+        installPath: string;
+        error: string;
+    }>;
+};
+export declare function loadPluginComponents(params: {
+    pluginConfig: CscecSuperCodeConfig;
+}): Promise<PluginComponents>;

package/dist/plugin-handlers/provider-config-handler.d.ts

@@ -0,0 +1,5 @@
+import type { ModelCacheState } from "../plugin-state";
+export declare function applyProviderConfig(params: {
+    config: Record<string, unknown>;
+    modelCacheState: ModelCacheState;
+}): void;

package/dist/plugin-handlers/suirenshi-agent-config-builder.d.ts

@@ -0,0 +1,23 @@
+import type { CategoryConfig } from "../config/schema";
+type SuirenshiOverride = Record<string, unknown> & {
+    category?: string;
+    model?: string;
+    variant?: string;
+    reasoningEffort?: string;
+    textVerbosity?: string;
+    thinking?: {
+        type: string;
+        budgetTokens?: number;
+    };
+    temperature?: number;
+    top_p?: number;
+    maxTokens?: number;
+    prompt_append?: string;
+};
+export declare function buildSuirenshiAgentConfig(params: {
+    configAgentPlan: Record<string, unknown> | undefined;
+    pluginSuirenshiOverride: SuirenshiOverride | undefined;
+    userCategories: Record<string, CategoryConfig> | undefined;
+    currentModel: string | undefined;
+}): Promise<Record<string, unknown>>;
+export {};

package/dist/plugin-handlers/tool-config-handler.d.ts

@@ -0,0 +1,6 @@
+import type { CscecSuperCodeConfig } from "../config";
+export declare function applyToolConfig(params: {
+    config: Record<string, unknown>;
+    pluginConfig: CscecSuperCodeConfig;
+    agentResult: Record<string, unknown>;
+}): void;

package/dist/plugin-interface.d.ts

@@ -0,0 +1,21 @@
+import type { PluginContext, PluginInterface, ToolsRecord } from "./plugin/types";
+import type { CscecSuperCodeConfig } from "./config";
+import type { CreatedHooks } from "./create-hooks";
+import type { Managers } from "./create-managers";
+export declare function createPluginInterface(args: {
+    ctx: PluginContext;
+    pluginConfig: CscecSuperCodeConfig;
+    firstMessageVariantGate: {
+        shouldOverride: (sessionID: string) => boolean;
+        markApplied: (sessionID: string) => void;
+        markSessionCreated: (sessionInfo: {
+            id?: string;
+            title?: string;
+            parentID?: string;
+        } | undefined) => void;
+        clear: (sessionID: string) => void;
+    };
+    managers: Managers;
+    hooks: CreatedHooks;
+    tools: ToolsRecord;
+}): PluginInterface;

package/dist/plugin-state.d.ts

@@ -0,0 +1,5 @@
+export interface ModelCacheState {
+    modelContextLimitsCache: Map<string, number>;
+    anthropicContext1MEnabled: boolean;
+}
+export declare function createModelCacheState(): ModelCacheState;

package/dist/shared/agent-display-names.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Agent config keys to display names mapping.
+ * Config keys are lowercase (e.g., "yugong", "buzhoushan").
+ * Display names include suffixes for UI/logs (e.g., "Yugong (Ultraworker)").
+ */
+export declare const AGENT_DISPLAY_NAMES: Record<string, string>;
+/**
+ * Get display name for an agent config key.
+ * Uses case-insensitive lookup for backward compatibility.
+ * Returns original key if not found.
+ */
+export declare function getAgentDisplayName(configKey: string): string;
+/**
+ * Resolve an agent name (display name or config key) to its lowercase config key.
+ * "Buzhoushan (Plan Executor)" → "buzhoushan", "buzhoushan" → "buzhoushan", "unknown" → "unknown"
+ */
+export declare function getAgentConfigKey(agentName: string): string;

package/dist/shared/agent-tool-restrictions.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Agent tool restrictions for session.prompt calls.
+ * OpenCode SDK's session.prompt `tools` parameter expects boolean values.
+ * true = tool allowed, false = tool denied.
+ */
+export declare function getAgentToolRestrictions(agentName: string): Record<string, boolean>;
+export declare function hasAgentToolRestrictions(agentName: string): boolean;

package/dist/shared/agent-variant.d.ts

@@ -0,0 +1,9 @@
+import type { CscecSuperCodeConfig } from "../config";
+export declare function resolveAgentVariant(config: CscecSuperCodeConfig, agentName?: string): string | undefined;
+export declare function resolveVariantForModel(config: CscecSuperCodeConfig, agentName: string, currentModel: {
+    providerID: string;
+    modelID: string;
+}): string | undefined;
+export declare function applyAgentVariant(config: CscecSuperCodeConfig, agentName: string | undefined, message: {
+    variant?: string;
+}): void;

package/dist/shared/binary-downloader.d.ts

@@ -0,0 +1,10 @@
+export declare function getCachedBinaryPath(cacheDir: string, binaryName: string): string | null;
+export declare function ensureCacheDir(cacheDir: string): void;
+export declare function downloadArchive(downloadUrl: string, archivePath: string): Promise<void>;
+export declare function extractTarGz(archivePath: string, destDir: string, options?: {
+    args?: string[];
+    cwd?: string;
+}): Promise<void>;
+export declare function extractZipArchive(archivePath: string, destDir: string): Promise<void>;
+export declare function cleanupArchive(archivePath: string): void;
+export declare function ensureExecutable(binaryPath: string): void;

package/dist/shared/claude-config-dir.d.ts

@@ -0,0 +1 @@
+export declare function getClaudeConfigDir(): string;

package/dist/shared/command-executor/embedded-commands.d.ts

@@ -0,0 +1,7 @@
+export interface CommandMatch {
+    fullMatch: string;
+    command: string;
+    start: number;
+    end: number;
+}
+export declare function findEmbeddedCommands(text: string): CommandMatch[];

package/dist/shared/command-executor/execute-command.d.ts

@@ -0,0 +1 @@
+export declare function executeCommand(command: string): Promise<string>;

package/dist/shared/command-executor/execute-hook-command.d.ts

@@ -0,0 +1,12 @@
+export interface CommandResult {
+    exitCode: number;
+    stdout?: string;
+    stderr?: string;
+}
+export interface ExecuteHookOptions {
+    forceZsh?: boolean;
+    zshPath?: string;
+    /** Timeout in milliseconds. Process is killed after this. Default: 30000 */
+    timeoutMs?: number;
+}
+export declare function executeHookCommand(command: string, stdin: string, cwd: string, options?: ExecuteHookOptions): Promise<CommandResult>;

package/dist/shared/command-executor/home-directory.d.ts

@@ -0,0 +1 @@
+export declare function getHomeDirectory(): string;

package/dist/shared/command-executor/resolve-commands-in-text.d.ts

@@ -0,0 +1 @@
+export declare function resolveCommandsInText(text: string, depth?: number, maxDepth?: number): Promise<string>;

package/dist/shared/command-executor/shell-path.d.ts

@@ -0,0 +1,2 @@
+export declare function findZshPath(customZshPath?: string): string | null;
+export declare function findBashPath(): string | null;

package/dist/shared/command-executor.d.ts

@@ -0,0 +1,4 @@
+export { executeHookCommand } from "./command-executor/execute-hook-command";
+export type { CommandResult, ExecuteHookOptions } from "./command-executor/execute-hook-command";
+export { executeCommand } from "./command-executor/execute-command";
+export { resolveCommandsInText } from "./command-executor/resolve-commands-in-text";

package/dist/shared/config-errors.d.ts

@@ -0,0 +1,7 @@
+export type ConfigLoadError = {
+    path: string;
+    error: string;
+};
+export declare function getConfigLoadErrors(): ConfigLoadError[];
+export declare function clearConfigLoadErrors(): void;
+export declare function addConfigLoadError(error: ConfigLoadError): void;

package/dist/shared/connected-providers-cache.d.ts

@@ -0,0 +1,55 @@
+interface ModelMetadata {
+    id: string;
+    provider?: string;
+    context?: number;
+    output?: number;
+    name?: string;
+}
+interface ProviderModelsCache {
+    models: Record<string, string[] | ModelMetadata[]>;
+    connected: string[];
+    updatedAt: string;
+}
+/**
+ * Read the connected providers cache.
+ * Returns the list of connected provider IDs, or null if cache doesn't exist.
+ */
+export declare function readConnectedProvidersCache(): string[] | null;
+/**
+ * Check if connected providers cache exists.
+ */
+export declare function hasConnectedProvidersCache(): boolean;
+/**
+ * Read the provider-models cache.
+ * Returns the cache data, or null if cache doesn't exist.
+ */
+export declare function readProviderModelsCache(): ProviderModelsCache | null;
+/**
+ * Check if provider-models cache exists.
+ */
+export declare function hasProviderModelsCache(): boolean;
+/**
+ * Write the provider-models cache.
+ */
+export declare function writeProviderModelsCache(data: {
+    models: Record<string, string[]>;
+    connected: string[];
+}): void;
+/**
+ * Update the connected providers cache by fetching from the client.
+ * Also updates the provider-models cache with model lists per provider.
+ */
+export declare function updateConnectedProvidersCache(client: {
+    provider?: {
+        list?: () => Promise<{
+            data?: {
+                connected?: string[];
+                all?: Array<{
+                    id: string;
+                    models?: Record<string, unknown>;
+                }>;
+            };
+        }>;
+    };
+}): Promise<void>;
+export {};

package/dist/shared/data-path.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 数据路径解析模块
+ *
+ * 提供插件数据存储路径解析功能。
+ * 遵循 XDG 基础目录规范，与 OpenCode 的路径行为保持一致。
+ *
+ * @module shared/data-path
+ */
+/**
+ * 获取用户级数据目录
+ *
+ * 遵循 XDG 规范，与 OpenCode 通过 xdg-basedir 的行为一致：
+ * - 所有平台：XDG_DATA_HOME 或 ~/.local/share
+ *
+ * 注意：OpenCode 在所有平台（包括 Windows）都使用 ~/.local/share，
+ * 我们保持相同的行为以确保兼容性。
+ *
+ * @returns 用户数据目录路径
+ */
+export declare function getDataDir(): string;
+/**
+ * 获取 OpenCode 存储目录路径
+ *
+ * @returns OpenCode 存储目录路径（~/.local/share/opencode/storage）
+ */
+export declare function getOpenCodeStorageDir(): string;
+/**
+ * 获取用户级缓存目录
+ *
+ * 遵循 XDG 规范：
+ * - 所有平台：XDG_CACHE_HOME 或 ~/.cache
+ *
+ * @returns 用户缓存目录路径
+ */
+export declare function getCacheDir(): string;
+/**
+ * 获取 cscec-super-code 缓存目录
+ *
+ * @returns 插件缓存目录路径（~/.cache/cscec-super-code）
+ */
+export declare function getOmoOpenCodeCacheDir(): string;
+/**
+ * 获取 OpenCode 缓存目录（用于读取 OpenCode 缓存）
+ *
+ * @returns OpenCode 缓存目录路径（~/.cache/opencode）
+ */
+export declare function getOpenCodeCacheDir(): string;

package/dist/shared/deep-merge.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 深度合并工具模块
+ *
+ * 提供对象深度合并功能，支持递归合并嵌套对象。
+ * 用于配置合并、状态更新等场景。
+ *
+ * @module shared/deep-merge
+ */
+/**
+ * 检查值是否为普通对象
+ *
+ * @param value - 要检查的值
+ * @returns 如果是普通对象则返回 true
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * 深度合并两个对象
+ *
+ * - 对象递归合并
+ * - 数组被替换（而非连接）
+ * - override 中的 undefined 值不会覆盖 base 中的值
+ * - 防止原型污染攻击
+ *
+ * @typeParam T - 对象类型
+ * @param base - 基础对象
+ * @param override - 覆盖对象，其值优先
+ * @param depth - 当前递归深度（内部使用）
+ * @returns 合并后的对象
+ *
+ * @example
+ * deepMerge({ a: 1, b: { c: 2, d: 3 } }, { b: { c: 10 }, e: 5 })
+ * // => { a: 1, b: { c: 10, d: 3 }, e: 5 }
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(base: T, override: Partial<T>, depth?: number): T;
+export declare function deepMerge<T extends Record<string, unknown>>(base: T | undefined, override: T | undefined, depth?: number): T | undefined;

package/dist/shared/disabled-tools.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+export declare function filterDisabledTools(tools: Record<string, ToolDefinition>, disabledTools: readonly string[] | undefined): Record<string, ToolDefinition>;

package/dist/shared/dynamic-truncator.d.ts

@@ -0,0 +1,31 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+type ModelCacheStateLike = {
+    anthropicContext1MEnabled: boolean;
+};
+export interface TruncationResult {
+    result: string;
+    truncated: boolean;
+    removedCount?: number;
+}
+export interface TruncationOptions {
+    targetMaxTokens?: number;
+    preserveHeaderLines?: number;
+    contextWindowLimit?: number;
+}
+export declare function truncateToTokenLimit(output: string, maxTokens: number, preserveHeaderLines?: number): TruncationResult;
+export declare function getContextWindowUsage(ctx: PluginInput, sessionID: string, modelCacheState?: ModelCacheStateLike): Promise<{
+    usedTokens: number;
+    remainingTokens: number;
+    usagePercentage: number;
+} | null>;
+export declare function dynamicTruncate(ctx: PluginInput, sessionID: string, output: string, options?: TruncationOptions, modelCacheState?: ModelCacheStateLike): Promise<TruncationResult>;
+export declare function createDynamicTruncator(ctx: PluginInput, modelCacheState?: ModelCacheStateLike): {
+    truncate: (sessionID: string, output: string, options?: TruncationOptions) => Promise<TruncationResult>;
+    getUsage: (sessionID: string) => Promise<{
+        usedTokens: number;
+        remainingTokens: number;
+        usagePercentage: number;
+    } | null>;
+    truncateSync: (output: string, maxTokens: number, preserveHeaderLines?: number) => TruncationResult;
+};
+export {};

package/dist/shared/external-plugin-detector.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Detects external plugins that may conflict with cscec-super-code features.
+ * Used to prevent crashes from concurrent notification plugins.
+ */
+export interface ExternalNotifierResult {
+    detected: boolean;
+    pluginName: string | null;
+    allPlugins: string[];
+}
+/**
+ * Detect if any external notification plugin is configured.
+ * Returns information about detected plugins for logging/warning.
+ */
+export declare function detectExternalNotificationPlugin(directory: string): ExternalNotifierResult;
+/**
+ * Generate a warning message for users with conflicting notification plugins.
+ */
+export declare function getNotificationConflictWarning(pluginName: string): string;

package/dist/shared/fallback-model-availability.d.ts

@@ -0,0 +1,12 @@
+type FallbackEntry = {
+    providers: string[];
+    model: string;
+};
+type ResolvedFallbackModel = {
+    provider: string;
+    model: string;
+};
+export declare function resolveFirstAvailableFallback(fallbackChain: FallbackEntry[], availableModels: Set<string>): ResolvedFallbackModel | null;
+export declare function isAnyFallbackModelAvailable(fallbackChain: FallbackEntry[], availableModels: Set<string>): boolean;
+export declare function isAnyProviderConnected(providers: string[], availableModels: Set<string>): boolean;
+export {};

package/dist/shared/file-reference-resolver.d.ts

@@ -0,0 +1 @@
+export declare function resolveFileReferencesInText(text: string, cwd?: string, depth?: number, maxDepth?: number): Promise<string>;

package/dist/shared/file-utils.d.ts

@@ -0,0 +1,7 @@
+export declare function isMarkdownFile(entry: {
+    name: string;
+    isFile: () => boolean;
+}): boolean;
+export declare function isSymbolicLink(filePath: string): boolean;
+export declare function resolveSymlink(filePath: string): string;
+export declare function resolveSymlinkAsync(filePath: string): Promise<string>;

package/dist/shared/first-message-variant.d.ts

@@ -0,0 +1,11 @@
+type SessionInfo = {
+    id?: string;
+    parentID?: string;
+};
+export declare function createFirstMessageVariantGate(): {
+    markSessionCreated(info?: SessionInfo): void;
+    shouldOverride(sessionID?: string): boolean;
+    markApplied(sessionID?: string): void;
+    clear(sessionID?: string): void;
+};
+export {};

package/dist/shared/frontmatter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * YAML Frontmatter 解析模块
+ *
+ * 提供从文本内容中解析 YAML frontmatter 的功能。
+ * 使用 JSON_SCHEMA 安全模式，防止通过 YAML 标签执行代码。
+ *
+ * @module shared/frontmatter
+ */
+/**
+ * Frontmatter 解析结果
+ *
+ * @typeParam T - frontmatter 数据类型
+ */
+export interface FrontmatterResult<T = Record<string, unknown>> {
+    /** 解析后的 frontmatter 数据 */
+    data: T;
+    /** 移除 frontmatter 后的内容主体 */
+    body: string;
+    /** 是否存在 frontmatter */
+    hadFrontmatter: boolean;
+    /** 是否解析错误 */
+    parseError: boolean;
+}
+/**
+ * 解析 YAML frontmatter
+ *
+ * 从内容中提取 YAML frontmatter 块（由 --- 分隔）。
+ * 使用 JSON_SCHEMA 安全模式解析 YAML，防止代码执行攻击。
+ *
+ * @typeParam T - 期望的 frontmatter 数据类型
+ * @param content - 要解析的内容字符串
+ * @returns 解析结果
+ *
+ * @example
+ * const result = parseFrontmatter<{ title: string }>(`
+ * ---
+ * title: Hello
+ * ---
+ * Content here
+ * `)
+ * // result.data = { title: "Hello" }
+ * // result.body = "Content here"
+ */
+export declare function parseFrontmatter<T = Record<string, unknown>>(content: string): FrontmatterResult<T>;

package/dist/shared/git-worktree/collect-git-diff-stats.d.ts

@@ -0,0 +1,2 @@
+import type { GitFileStat } from "./types";
+export declare function collectGitDiffStats(directory: string): GitFileStat[];

package/dist/shared/git-worktree/format-file-changes.d.ts

@@ -0,0 +1,2 @@
+import type { GitFileStat } from "./types";
+export declare function formatFileChanges(stats: GitFileStat[], notepadPath?: string): string;

package/dist/shared/git-worktree/index.d.ts

@@ -0,0 +1,7 @@
+export type { GitFileStatus, GitFileStat } from "./types";
+export type { ParsedGitStatusPorcelainLine } from "./parse-status-porcelain-line";
+export { parseGitStatusPorcelainLine } from "./parse-status-porcelain-line";
+export { parseGitStatusPorcelain } from "./parse-status-porcelain";
+export { parseGitDiffNumstat } from "./parse-diff-numstat";
+export { collectGitDiffStats } from "./collect-git-diff-stats";
+export { formatFileChanges } from "./format-file-changes";

package/dist/shared/git-worktree/parse-diff-numstat.d.ts

@@ -0,0 +1,2 @@
+import type { GitFileStat, GitFileStatus } from "./types";
+export declare function parseGitDiffNumstat(output: string, statusMap: Map<string, GitFileStatus>): GitFileStat[];

package/dist/shared/git-worktree/parse-status-porcelain-line.d.ts

@@ -0,0 +1,6 @@
+import type { GitFileStatus } from "./types";
+export interface ParsedGitStatusPorcelainLine {
+    filePath: string;
+    status: GitFileStatus;
+}
+export declare function parseGitStatusPorcelainLine(line: string): ParsedGitStatusPorcelainLine | null;

package/dist/shared/git-worktree/parse-status-porcelain.d.ts

@@ -0,0 +1,2 @@
+import type { GitFileStatus } from "./types";
+export declare function parseGitStatusPorcelain(output: string): Map<string, GitFileStatus>;

package/dist/shared/git-worktree/types.d.ts

@@ -0,0 +1,7 @@
+export type GitFileStatus = "modified" | "added" | "deleted";
+export interface GitFileStat {
+    path: string;
+    added: number;
+    removed: number;
+    status: GitFileStatus;
+}

package/dist/shared/hook-disabled.d.ts

@@ -0,0 +1,2 @@
+import type { ClaudeHookEvent, PluginConfig } from "../hooks/claude-code-hooks/types";
+export declare function isHookDisabled(config: PluginConfig, hookType: ClaudeHookEvent): boolean;

package/dist/shared/index.d.ts

@@ -0,0 +1,56 @@
+export * from "./frontmatter";
+export * from "./command-executor";
+export * from "./file-reference-resolver";
+export * from "./model-sanitizer";
+export * from "./logger";
+export * from "./snake-case";
+export * from "./tool-name";
+export * from "./pattern-matcher";
+export * from "./hook-disabled";
+export * from "./deep-merge";
+export * from "./file-utils";
+export * from "./dynamic-truncator";
+export * from "./data-path";
+export * from "./config-errors";
+export * from "./claude-config-dir";
+export * from "./jsonc-parser";
+export * from "./migration";
+export * from "./opencode-config-dir";
+export type { OpenCodeBinaryType, OpenCodeConfigDirOptions, OpenCodeConfigPaths, } from "./opencode-config-dir-types";
+export * from "./opencode-version";
+export * from "./opencode-storage-detection";
+export * from "./permission-compat";
+export * from "./external-plugin-detector";
+export * from "./zip-extractor";
+export * from "./binary-downloader";
+export * from "./agent-variant";
+export * from "./session-cursor";
+export * from "./shell-env";
+export * from "./system-directive";
+export * from "./agent-tool-restrictions";
+export * from "./model-requirements";
+export * from "./model-resolver";
+export { normalizeModel, normalizeModelID } from "./model-normalization";
+export { normalizeFallbackModels } from "./model-resolver";
+export { resolveModelPipeline } from "./model-resolution-pipeline";
+export type { ModelResolutionRequest, ModelResolutionProvenance, ModelResolutionResult, } from "./model-resolution-types";
+export * from "./model-availability";
+export * from "./fallback-model-availability";
+export * from "./connected-providers-cache";
+export * from "./session-utils";
+export * from "./tmux";
+export * from "./model-suggestion-retry";
+export * from "./opencode-server-auth";
+export * from "./opencode-http-api";
+export * from "./port-utils";
+export * from "./git-worktree";
+export * from "./safe-create-hook";
+export * from "./truncate-description";
+export * from "./opencode-storage-paths";
+export * from "./opencode-message-dir";
+export * from "./normalize-sdk-response";
+export * from "./session-directory-resolver";
+export * from "./prompt-tools";
+export * from "./internal-initiator-marker";
+export * from "./plugin-command-discovery";
+export { SessionCategoryRegistry } from "./session-category-registry";

package/dist/shared/internal-initiator-marker.d.ts

@@ -0,0 +1,5 @@
+export declare const OMO_INTERNAL_INITIATOR_MARKER = "<!-- OMO_INTERNAL_INITIATOR -->";
+export declare function createInternalAgentTextPart(text: string): {
+    type: "text";
+    text: string;
+};

package/dist/shared/jsonc-parser.d.ts

@@ -0,0 +1,15 @@
+export interface JsoncParseResult<T> {
+    data: T | null;
+    errors: Array<{
+        message: string;
+        offset: number;
+        length: number;
+    }>;
+}
+export declare function parseJsonc<T = unknown>(content: string): T;
+export declare function parseJsoncSafe<T = unknown>(content: string): JsoncParseResult<T>;
+export declare function readJsoncFile<T = unknown>(filePath: string): T | null;
+export declare function detectConfigFile(basePath: string): {
+    format: "json" | "jsonc" | "none";
+    path: string;
+};

package/dist/shared/logger.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 日志工具模块
+ *
+ * 提供插件共享的日志功能，日志写入 /tmp/cscec-super-code.log。
+ * 使用上海时区 (Asia/Shanghai) 格式化时间戳。
+ *
+ * @module shared/logger
+ */
+/**
+ * 写入日志条目
+ *
+ * 将带时间戳的消息写入日志文件。时间戳使用上海时区格式。
+ *
+ * @param message - 日志消息
+ * @param data - 可选的数据对象，将序列化为 JSON
+ *
+ * @example
+ * log("[Plugin] 初始化完成", { version: "1.0.0" })
+ * // 日志文件: [2024-01-15 10:30:00] [Plugin] 初始化完成 {"version":"1.0.0"}
+ */
+export declare function log(message: string, data?: unknown): void;
+/**
+ * 获取日志文件路径
+ *
+ * @returns 日志文件的完整路径
+ */
+export declare function getLogFilePath(): string;

package/dist/shared/merge-categories.d.ts

@@ -0,0 +1,6 @@
+import type { CategoriesConfig, CategoryConfig } from "../config/schema";
+/**
+ * Merge default and user categories, filtering out disabled ones.
+ * Single source of truth for category merging across the codebase.
+ */
+export declare function mergeCategories(userCategories?: CategoriesConfig): Record<string, CategoryConfig>;