@actiondock/core 2.0.11 → 2.0.12

package/dist/profile/client.d.ts

@@ -0,0 +1,116 @@
+import type { ExecutionResult, RunRecord } from "@actiondock/sdk";
+import type { RemoteHealthResult } from "./types";
+/**
+ * 调用远端 ActionDock 服务端执行 Action 时的选项参数。
+ */
+export interface RemoteExecuteOptions {
+    /** 动态配置覆盖 */
+    configOverrides?: Record<string, unknown>;
+    /** 鉴权 Bearer Token */
+    token?: string;
+    /** 超时毫秒数 */
+    timeoutMs?: number;
+    /** 中断信号 */
+    signal?: AbortSignal;
+    /** 是否异步触发（202 Accepted 立即返回 runId） */
+    async?: boolean;
+}
+/**
+ * 远端 Action 执行结果信封对象。
+ */
+export type RemoteExecutionResult<T = unknown> = ExecutionResult<T> & {
+    status?: string;
+};
+/**
+ * 探测指定远端 ActionDock 服务的健康状态与网络延迟。
+ *
+ * @param serverUrl 目标服务端地址
+ * @param token 鉴权 Token（可选）
+ * @param timeoutMs 探测超时时间（默认 5000ms）
+ */
+export declare function checkRemoteHealth(serverUrl: string, token?: string, timeoutMs?: number): Promise<RemoteHealthResult>;
+export declare function executeRemoteAction<T = unknown>(serverUrl: string, actionId: string, input?: unknown, configOverridesOrOptions?: Record<string, unknown> | RemoteExecuteOptions, tokenArg?: string): Promise<RemoteExecutionResult<T>>;
+export declare function fetchRemoteRun(serverUrl: string, runId: string, token?: string): Promise<RunRecord>;
+export declare function cancelRemoteRun(serverUrl: string, runId: string, token?: string, reason?: string): Promise<{
+    ok: boolean;
+    runId: string;
+    status: string;
+}>;
+export declare function fetchRemoteActions(serverUrl: string, token?: string, intent?: string): Promise<Array<{
+    id: string;
+    description: string;
+    packageId?: string;
+}>>;
+export declare function fetchRemoteActionShow(serverUrl: string, actionId: string, token?: string): Promise<any>;
+export declare function fetchRemoteInfo(serverUrl: string, token?: string, options?: {
+    intent?: string;
+    package?: string;
+    tree?: boolean;
+}): Promise<any>;
+export declare function fetchRemoteDoctor(serverUrl: string, token?: string, targetPackage?: string): Promise<any>;
+export declare function fetchRemotePlaybooks(serverUrl: string, token?: string, options?: {
+    intent?: string;
+    package?: string;
+}): Promise<Array<{
+    id: string;
+    description: string;
+    actions: string[];
+    packageId: string;
+    filePath: string;
+}>>;
+export declare function fetchRemotePlaybookShow(serverUrl: string, playbookId: string, token?: string): Promise<any>;
+export declare function fetchRemoteRuns(serverUrl: string, token?: string, options?: {
+    status?: string;
+    actionId?: string;
+    packageId?: string;
+    intent?: string;
+    limit?: number;
+}): Promise<{
+    ok: boolean;
+    total: number;
+    items: RunRecord[];
+}>;
+export declare function clearRemoteRuns(serverUrl: string, token?: string, options?: {
+    packageId?: string;
+    actionId?: string;
+    status?: string;
+}): Promise<{
+    ok: boolean;
+    clearedCount: number;
+}>;
+export declare function fetchRemoteStateList(serverUrl: string, token?: string, options?: {
+    package?: string;
+    namespace?: string;
+    prefix?: string;
+}): Promise<{
+    ok: boolean;
+    packageId: string;
+    keys: string[];
+}>;
+export declare function getRemoteStateKey(serverUrl: string, key: string, token?: string, options?: {
+    package?: string;
+    namespace?: string;
+}): Promise<any>;
+export declare function setRemoteStateKey(serverUrl: string, key: string, value: unknown, token?: string, options?: {
+    package?: string;
+    namespace?: string;
+    ttl?: number;
+}): Promise<any>;
+export declare function deleteRemoteStateKey(serverUrl: string, key: string, token?: string, options?: {
+    package?: string;
+    namespace?: string;
+}): Promise<any>;
+export declare function clearRemoteState(serverUrl: string, token?: string, options?: {
+    package?: string;
+    namespace?: string;
+    prefix?: string;
+    all?: boolean;
+}): Promise<{
+    ok: boolean;
+    packageId: string;
+    clearedCount: number;
+}>;
+export declare function fetchRemoteConfig(serverUrl: string, token?: string, packageId?: string): Promise<any>;
+export declare function setRemoteConfig(serverUrl: string, key: string, value: unknown, token?: string, packageId?: string): Promise<any>;
+export declare function deleteRemoteConfig(serverUrl: string, key: string, token?: string, packageId?: string): Promise<any>;
+export declare function fetchRemoteConfigEnv(serverUrl: string, token?: string, packageId?: string): Promise<any>;

package/dist/profile/manager.d.ts

@@ -0,0 +1,47 @@
+import type { ProfileEntry, ProfilesConfig, ResolvedTarget, TokenResolutionSource } from "./types";
+/**
+ * 默认初始 Profiles 配置（预设 local 本地环境）。
+ */
+export declare const DEFAULT_PROFILES_CONFIG: ProfilesConfig;
+/**
+ * 格式化并规范化 Server URL 地址（自动补齐 http:// 协议头并移除末尾斜杠）。
+ */
+export declare function normalizeServerUrl(url: string): string;
+/**
+ * 获取 profiles.json 配置文件的物理绝对路径（~/.actiondock/profiles.json）。
+ */
+export declare function getProfilesFilePath(customHome?: string): string;
+/**
+ * 加载并读取 profiles.json 配置文件。
+ */
+export declare function loadProfiles(customHome?: string): ProfilesConfig;
+/**
+ * 保存并写入 profiles.json 配置文件，并严格限制文件权限为 0600。
+ */
+export declare function saveProfiles(data: ProfilesConfig, customHome?: string): void;
+export declare function addProfile(name: string, entry: ProfileEntry, customHome?: string): void;
+export declare function removeProfile(name: string, customHome?: string): boolean;
+export declare function useProfile(name: string, customHome?: string): void;
+export declare function getProfile(name: string, customHome?: string): ProfileEntry | undefined;
+export declare function listProfiles(customHome?: string): Array<{
+    name: string;
+    isCurrent: boolean;
+    entry: ProfileEntry;
+}>;
+/**
+ * Resolves token following multi-tier precedence:
+ * 1. CLI explicit --token
+ * 2. profile.tokenEnv specified environment variable
+ * 3. Derived profile environment variable: ACTIONDOCK_<PROFILE>_TOKEN or <PROFILE>_TOKEN
+ * 4. Stored token in profiles.json (deprecated)
+ * 5. Global ACTIONDOCK_TOKEN
+ */
+export declare function resolveProfileToken(profileName?: string, entry?: ProfileEntry, explicitToken?: string): {
+    token?: string;
+    source: TokenResolutionSource;
+};
+export declare function resolveTarget(options?: {
+    profile?: string;
+    server?: string;
+    token?: string;
+}, customHome?: string): ResolvedTarget;

package/dist/profile/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 单个远端配置环境（Profile）实体定义。
+ */
+export interface ProfileEntry {
+    /** 远端 ActionDock 服务端地址（如 "http://192.168.1.100:5177" 或 "local"） */
+    serverUrl: string;
+    /**
+     * 存储在配置文件中的明文鉴权 Token。
+     * @deprecated 强烈建议使用 tokenEnv 或标准环境变量（如 ACTIONDOCK_<PROFILE>_TOKEN），避免明文持久化
+     */
+    token?: string;
+    /** 指定从哪一个操作系统环境变量名动态读取 Token */
+    tokenEnv?: string;
+    /** 该机器/环境的描述信息 */
+    description?: string;
+}
+/**
+ * 全局 profiles.json 配置文件结构契约。
+ */
+export interface ProfilesConfig {
+    /** 当前激活的默认 Profile 名称（默认为 "local"） */
+    currentProfile?: string;
+    /** 已配置的 Profile 字典映射表 */
+    profiles: Record<string, ProfileEntry>;
+}
+/**
+ * Token 解析命中来源枚举。
+ */
+export type TokenResolutionSource = "cli" | "tokenEnv" | "profileEnv" | "profile" | "globalEnv" | "none";
+/**
+ * 经过解析后确定的最终执行目标环境。
+ */
+export interface ResolvedTarget {
+    /** 执行环境类型：local (本地 Bun 进程) 或 remote (远端 HTTP Server) */
+    type: "local" | "remote";
+    /** 命中的 Profile 名称 */
+    profileName?: string;
+    /** 远端 Server URL */
+    serverUrl?: string;
+    /** 解析出的有效鉴权 Token */
+    token?: string;
+    /** Token 数据来源 */
+    tokenSource?: TokenResolutionSource;
+}
+/**
+ * 远端服务器健康探测与时延检测结果。
+ */
+export interface RemoteHealthResult {
+    /** 服务端是否连通且鉴权成功 */
+    ok: boolean;
+    /** 服务端状态标识（如 "ok"） */
+    status?: string;
+    /** 远端 ActionDock 版本号 */
+    version?: string;
+    /** 远端服务运行时间（秒） */
+    uptime?: number;
+    /** 网络往返延迟（毫秒） */
+    latencyMs: number;
+    /** 探测失败时的错误信息 */
+    error?: string;
+}

package/dist/project/closure.d.ts

@@ -0,0 +1,25 @@
+export interface EnsureDependencyClosureOptions {
+    /**
+     * 自定义依赖安装回调函数（便于单测 Mock 与自定义扩展）
+     */
+    ensure?: (root: string) => boolean | Promise<boolean>;
+    /**
+     * 自定义 ActionDock 家目录
+     */
+    customHome?: string;
+}
+export interface DependencyClosureResult {
+    /** 成功执行依赖安装或更新的项目根路径列表 */
+    installed: string[];
+    /** 无法在注册表中解析包引用的警告列表 */
+    warnings: string[];
+}
+/**
+ * 广度优先遍历 (BFS) uses 声明的跨包依赖闭包，对涉及的每个项目包逐一执行依赖预装（ensureProjectDependencies）。
+ * 内部已尊重 ACTIONDOCK_AUTO_INSTALL=false 环境变量。
+ *
+ * @param roots 根项目目录列表
+ * @param opts 选项参数
+ * @returns 安装成功的路径列表及警告信息
+ */
+export declare function ensureDependencyClosure(roots: string[], opts?: EnsureDependencyClosureOptions): Promise<DependencyClosureResult>;

package/{src/project/index.ts → dist/project/index.d.ts}

@@ -1,3 +1,4 @@
+export * from "./closure";
 export * from "./init";
 export * from "./loader";
 export * from "./manifest";

package/dist/project/init.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 项目初始化脚手架选项。
+ */
+export interface InitOptions {
+    /** 自定义项目 ID（默认使用目录名） */
+    id?: string;
+    /** 自定义项目展示名称（默认由目录名美化生成） */
+    name?: string;
+    /** 自定义项目描述 */
+    description?: string;
+}
+/**
+ * 在目标目录初始化一个完整的 ActionDock 2.0 Action Package 脚手架。
+ * 生成内容包括：
+ * - actiondock.json（项目元数据与配置声明）
+ * - actiondock.manifest.json（声明式元数据清单事实源）
+ * - package.json（Node.js 标准脚本与依赖声明）
+ * - tsconfig.json（现代 NodeNext 模块规范）
+ * - .gitignore（排除持久化 db、node_modules、dist）
+ * - actions/greet.ts（标准示例 Action，演示 config、state、log 使用）
+ * - playbooks/greet-user.md（标准 SOP Playbook 演示）
+ * - tests/greet.test.ts（基于 node:test 与 @actiondock/testing 的测试用例）
+ *
+ * @param targetDir 目标项目目录
+ * @param options 初始化选项
+ */
+export declare function initProject(targetDir: string, options?: InitOptions): void;

package/dist/project/loader.d.ts

@@ -0,0 +1,105 @@
+import type { ActionDefinition } from "@actiondock/sdk";
+import type { PlaybookDefinition, ProjectConfig } from "./types";
+/**
+ * 从指定目录开始向上逐级递归查找包含 `actiondock.json` 的项目根目录。
+ *
+ * @param cwd 起始搜索目录（默认为 process.cwd()）
+ * @returns 项目根目录绝对路径，若未找到则返回 null
+ */
+export declare function findProjectRoot(cwd?: string): string | null;
+export declare const ACTION_ID_REGEX: RegExp;
+export declare const PLAYBOOK_ID_REGEX: RegExp;
+/**
+ * 加载并校验指定目录下的 `actiondock.json` 配置文件。
+ *
+ * @param projectRoot 项目根目录绝对路径
+ * @returns 解析后的 ProjectConfig 对象
+ * @throws {Error} 若文件不存在或 JSON 格式错误、缺失必要字段
+ */
+export declare function loadProjectConfig(projectRoot: string): ProjectConfig;
+export declare const ALLOWED_INSTALLERS: Set<string>;
+/**
+ * 探测宿主系统中可用的包管理工具。
+ * 优先级：
+ * - 环境变量 ACTIONDOCK_INSTALLER 显式指定（严格白名单校验：npm, bun）；
+ * - 依据项目根目录下现存的锁文件进行精确匹配（bun.lock/bun.lockb -> bun, package-lock.json/npm-shrinkwrap.json -> npm）；
+ * - 候选回退优先级探测（npm > bun）。
+ */
+export declare function getInstallCommand(projectRoot?: string): string[];
+/**
+ * 读取项目当前缓存的依赖指纹哈希。
+ */
+export declare function readStoredDependencyFingerprint(projectRoot: string): string | null;
+/**
+ * 将最新的依赖指纹哈希写入缓存文件。
+ */
+export declare function saveDependencyFingerprint(projectRoot: string, fingerprint: string): void;
+/**
+ * 计算项目依赖的指纹哈希（基于 package.json 依赖声明及可能存在的锁文件内容）。
+ *
+ * @param projectRoot 项目根目录
+ * @returns 64位十六进制哈希字符串，若 package.json 不存在或解析失败则返回 null
+ */
+export declare function computeDependencyFingerprint(projectRoot: string): string | null;
+/**
+ * 确保项目依赖（node_modules）已正确安装。
+ * 若尚未安装、依赖版本变更（指纹不匹配）或加载失败时，自动触发包管理器执行依赖安装。
+ *
+ * @param projectRoot 项目根目录
+ * @param force 是否强制重新安装
+ * @returns 是否成功执行了安装或更新
+ */
+export declare function ensureProjectDependencies(projectRoot: string, force?: boolean): boolean;
+/**
+ * 发现并检索项目 actions 目录下的所有 Action 源码文件（.ts）。
+ *
+ * @param projectRoot 项目根目录
+ * @param actionsDir actions 子目录名称（默认 "actions"）
+ */
+export declare function discoverActionFiles(projectRoot: string, actionsDir?: string): string[];
+/**
+ * 动态导入并加载项目下的所有 Action 定义对象。
+ *
+ * @param projectRoot 项目根目录
+ * @param actionsDir actions 子目录（默认 "actions"）
+ * @param options 控制是否允许自动安装依赖等选项
+ * @returns Map<ActionId, ActionDefinition> 映射
+ */
+export declare function loadActions(projectRoot: string, actionsDir?: string, options?: {
+    autoInstall?: boolean;
+}): Promise<Map<string, ActionDefinition>>;
+/**
+ * Action 文件映射条目，包含 Action ID、源文件绝对路径与 Action 定义对象。
+ */
+export interface ActionFileEntry {
+    id: string;
+    filePath: string;
+    action: ActionDefinition;
+}
+/**
+ * 加载并建立 Action ID 与其物理源码文件路径之间的映射关系（供构建打包器及清单同步使用）。
+ */
+export declare function loadActionFileMap(projectRoot: string, actionsDir?: string, options?: {
+    autoInstall?: boolean;
+    strict?: boolean;
+}): Promise<Map<string, ActionFileEntry>>;
+/**
+ * 发现项目 playbooks 目录下的所有 Playbook Markdown 文档（.md）。
+ */
+export declare function discoverPlaybookFiles(projectRoot: string, playbooksDir?: string): string[];
+/**
+ * 解析单个 Playbook Markdown 文件的内容与 YAML Frontmatter 头部元数据。
+ *
+ * @param content 文件文本内容
+ * @param filePath 物理文件路径
+ * @returns PlaybookDefinition 对象
+ */
+export declare function parsePlaybookContent(content: string, filePath: string): PlaybookDefinition;
+/**
+ * 加载项目 playbooks 目录下的所有 Playbook SOP 文档。
+ *
+ * @param projectRoot 项目根目录
+ * @param playbooksDir playbooks 子目录（默认 "playbooks"）
+ * @returns Map<PlaybookId, PlaybookDefinition> 映射
+ */
+export declare function loadPlaybooks(projectRoot: string, playbooksDir?: string): Map<string, PlaybookDefinition>;

package/dist/project/manifest.d.ts

@@ -0,0 +1,44 @@
+import type { ActionDockManifest, ActionManifestEntry, ManifestSyncResult, SyncManifestOptions } from "./types";
+export declare const MANIFEST_FILE_NAME = "actiondock.manifest.json";
+/**
+ * 读取并解析项目的声明式清单文件。
+ * 若文件不存在则返回 null。
+ */
+export declare function loadManifest(projectRoot: string): ActionDockManifest | null;
+/**
+ * 保存声明式清单文件至项目根目录。
+ */
+export declare function saveManifest(projectRoot: string, manifest: ActionDockManifest): void;
+/**
+ * 校验清单数据结构的合法性与安全性。
+ */
+export declare function validateManifest(manifest: unknown, options?: {
+    projectRoot?: string;
+}): {
+    valid: boolean;
+    errors?: string[];
+};
+/**
+ * 为单个 Action 构建清单项。
+ */
+export declare function createManifestEntry(options: {
+    entry: string;
+    description?: string;
+    inputSchema?: Record<string, unknown> | boolean;
+    outputSchema?: Record<string, unknown> | boolean;
+    uses?: string[];
+    tags?: string[];
+    annotations?: Record<string, unknown>;
+}): ActionManifestEntry;
+/**
+ * 依据动作源码目录中的 Action 定义，增量同步或校验 actiondock.manifest.json 文件。
+ *
+ * @param projectRoot 项目根目录绝对路径
+ * @param options 同步选项（包括 actionsDir、check、prune、autoInstall）
+ * @returns 同步变更结果报告
+ */
+export declare function syncManifest(projectRoot: string, options?: SyncManifestOptions): Promise<ManifestSyncResult>;
+/**
+ * 校验当前 actiondock.manifest.json 是否与动作源码定义保持一致（只读检查）。
+ */
+export declare function checkManifestSync(projectRoot: string, options?: Omit<SyncManifestOptions, "check">): Promise<ManifestSyncResult>;

package/dist/project/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * 配置项的值类型枚举。用于自动类型推断与环境变量自动转换。
+ */
+export type ConfigValueType = "string" | "number" | "boolean" | "object" | "array";
+/**
+ * 在 actiondock.json 中声明的单项配置定义。
+ */
+export interface ConfigItemDefinition {
+    /** 配置项的功能描述，展示在 CLI 配置提示与帮助文档中 */
+    description?: string;
+    /** 默认回退值。若未配置任何自定义值或环境变量，将使用此默认值 */
+    default?: unknown;
+    /** 是否为敏感信息（如 API Key, Password）。若为 true，在日志与 CLI 输出中默认脱敏 */
+    secret?: boolean;
+    /** 期望的目标数据类型，从 process.env 读取字符串时将自动尝试强转为此类型 */
+    type?: ConfigValueType;
+    /** 显式绑定的外部环境变量名（支持单个或优先级数组） */
+    env?: string | string[];
+}
+/**
+ * ActionDock 项目根配置文件契约（对应 actiondock.json）。
+ */
+export interface ProjectConfig {
+    /** 项目全局唯一 ID（例如 "team4u.github-tools"） */
+    id: string;
+    /** 项目展示名称（例如 "GitHub Tools"） */
+    name: string;
+    /** 项目版本号（遵循语义化版本 Semantic Versioning，如 "1.0.0"） */
+    version: string;
+    /** 项目描述信息 */
+    description?: string;
+    /** Action 脚本文件存放目录（相对于项目根目录，默认为 "actions"） */
+    actionsDir?: string;
+    /** Playbook SOP 文档存放目录（相对于项目根目录，默认为 "playbooks"） */
+    playbooksDir?: string;
+    /** 声明的项目依赖配置项清单 */
+    config?: Record<string, ConfigItemDefinition>;
+}
+/**
+ * Playbook Markdown 文档头部 YAML Frontmatter 元数据。
+ */
+export interface PlaybookFrontmatter {
+    /** Playbook 唯一标识符（例如 "review-pr"） */
+    id: string;
+    /** Playbook 任务描述 */
+    description?: string;
+    /** 该 Playbook SOP 所依赖/调用的 Action ID 列表（用于最小化构建与 Tree-shaking 导出） */
+    actions?: string[];
+}
+/**
+ * 解析后的完整 Playbook 定义对象。
+ */
+export interface PlaybookDefinition extends PlaybookFrontmatter {
+    /** Markdown 正文内容（去除了头部 YAML Frontmatter 后的 SOP 指南内容） */
+    content: string;
+    /** Playbook 源文件的绝对物理路径 */
+    filePath: string;
+}
+/**
+ * 单个 Action 在清单中的声明项。
+ */
+export interface ActionManifestEntry {
+    /** Action 入口文件相对路径（如 "actions/greet.ts"） */
+    entry: string;
+    /** Action 功能描述 */
+    description?: string;
+    /** 输入参数模式规范 */
+    inputSchema?: Record<string, unknown> | boolean;
+    /** 输出结果模式规范 */
+    outputSchema?: Record<string, unknown> | boolean;
+    /** 静态依赖的 Action 列表 */
+    uses?: string[];
+    /** 标签列表 */
+    tags?: string[];
+    /** 协议注解元数据 */
+    annotations?: Record<string, unknown>;
+}
+/**
+ * ActionDock 声明式清单（actiondock.manifest.json）规范。
+ * 作为元数据的单一事实源，实现无副作用的模块发现与构建规划。
+ */
+export interface ActionDockManifest {
+    schemaVersion: number;
+    actions: Record<string, ActionManifestEntry>;
+    assets?: string[];
+}
+/**
+ * 清单同步操作选项。
+ */
+export interface SyncManifestOptions {
+    /** 自定义 actions 源码目录（默认为工程配置中的 actionsDir 或 "actions"） */
+    actionsDir?: string;
+    /** 是否仅检查同步状态而不保存写入文件（默认 false） */
+    check?: boolean;
+    /** 是否自动移除源码中已不存在的 Action（默认 true） */
+    prune?: boolean;
+    /** 缺失依赖时是否自动执行安装（默认 true） */
+    autoInstall?: boolean;
+}
+/**
+ * 单个 Action 的清单同步变更项。
+ */
+export interface ManifestSyncChange {
+    /** Action 标识符 */
+    actionId: string;
+    /** 变更类型：新增、更新、删除或未变 */
+    type: "added" | "updated" | "removed" | "unchanged";
+    /** 源码入口文件相对路径 */
+    entry?: string;
+    /** 发生变更的字段列表（例如 ["description", "inputSchema"]） */
+    changedFields?: string[];
+}
+/**
+ * 清单同步执行结果。
+ */
+export interface ManifestSyncResult {
+    /** 清单当前是否已与源码完全一致 */
+    inSync: boolean;
+    /** 清单文件的物理绝对路径 */
+    manifestPath: string;
+    /** 所有 Action 的变更详情列表 */
+    changes: ManifestSyncChange[];
+    /** 新增的 Action 标识列表 */
+    added: string[];
+    /** 更新的 Action 标识列表 */
+    updated: string[];
+    /** 移除的 Action 标识列表 */
+    removed: string[];
+    /** 未改变的 Action 标识列表 */
+    unchanged: string[];
+}

package/dist/registry/registry.d.ts

@@ -0,0 +1,24 @@
+import type { GlobalRegistryData, LinkedPackageEntry, LinkedWorkspaceEntry, LinkResult, PruneResult, RegistryStatusReport, ResolvedActionProject, ResolvedPlaybookProject, UnlinkResult } from "./types";
+/**
+ * 跨平台注册表写锁控制函数（防止多进程并发读写导致 registry.json 损坏）。
+ */
+export declare function withRegistryLock<T>(filePath: string, fn: () => T): T;
+/**
+ * 递归扫描包含 actiondock.json 的子项目根目录
+ */
+export declare function discoverProjects(dir: string, maxDepth?: number): string[];
+export declare function getRegistryFilePath(customHome?: string): string;
+export declare function loadRegistry(customHome?: string): GlobalRegistryData;
+export declare function saveRegistry(data: GlobalRegistryData, customHome?: string): void;
+export declare function linkPackage(targetPath?: string, customHome?: string, options?: {
+    recursive?: boolean;
+}): LinkResult;
+export declare function unlinkPackage(identifier?: string, customHome?: string): UnlinkResult | null;
+export declare function listLinkedPackages(customHome?: string): LinkedPackageEntry[];
+export declare function listLinkedWorkspaces(customHome?: string): LinkedWorkspaceEntry[];
+export declare function resolveActionProjectSync(actionIdentifier: string, cwd?: string, customHome?: string): ResolvedActionProject;
+export declare function resolveActionProject(actionIdentifier: string, cwd?: string, customHome?: string): Promise<ResolvedActionProject>;
+export declare function resolvePackageRoot(packageIdOrPath?: string, cwd?: string, customHome?: string): string | null;
+export declare function resolvePlaybookProject(playbookIdentifier: string, cwd?: string, customHome?: string): ResolvedPlaybookProject;
+export declare function getRegistryStatus(customHome?: string): RegistryStatusReport;
+export declare function pruneRegistry(customHome?: string): PruneResult;