@actiondock/core 2.0.11 → 2.2.0

package/dist/catalog/package-catalog.d.ts

@@ -0,0 +1,7 @@
+import { LocationRegistry } from "./location-registry.js";
+import type { CatalogSnapshot } from "./types.js";
+export declare class PackageCatalog {
+    private registry;
+    constructor(registry?: LocationRegistry);
+    buildSnapshot(cwd?: string): CatalogSnapshot;
+}

package/dist/catalog/package-catalog.js

@@ -0,0 +1,76 @@
+import { existsSync, realpathSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { resolve } from "node:path";
+import { findProjectRoot, loadProjectConfig } from "../project/loader.js";
+import { discoverProjects } from "../registry/registry.js";
+import { LocationRegistry } from "./location-registry.js";
+export class PackageCatalog {
+    registry;
+    constructor(registry) {
+        this.registry = registry || new LocationRegistry();
+    }
+    buildSnapshot(cwd = process.cwd()) {
+        const packages = new Map();
+        const seenRealPaths = new Map(); // realPath -> packageId
+        const seenPackageIds = new Map(); // packageId -> realPath
+        const registerPackage = (root, isChild = false) => {
+            const abs = resolve(root);
+            if (!existsSync(abs))
+                return;
+            const real = realpathSync(abs);
+            if (seenRealPaths.has(real)) {
+                return; // 符号链接归一化去重
+            }
+            try {
+                const config = loadProjectConfig(abs);
+                if (seenPackageIds.has(config.id)) {
+                    const existingPath = seenPackageIds.get(config.id);
+                    if (existingPath !== real) {
+                        throw new Error(`PACKAGE_ID_CONFLICT: Package ID '${config.id}' is declared by multiple directories: '${existingPath}' and '${real}'`);
+                    }
+                }
+                const entry = {
+                    id: config.id,
+                    packageInstanceId: `${config.id}:${real}`,
+                    projectRoot: abs,
+                    config,
+                    isWorkspaceChild: isChild,
+                };
+                packages.set(config.id, entry);
+                seenRealPaths.set(real, config.id);
+                seenPackageIds.set(config.id, real);
+            }
+            catch (e) {
+                if (e.message?.startsWith("PACKAGE_ID_CONFLICT")) {
+                    throw e;
+                }
+                // 忽略无效项目
+            }
+        };
+        // 优先包含当前工作目录所在项目
+        const currentRoot = findProjectRoot(cwd);
+        if (currentRoot) {
+            registerPackage(currentRoot);
+        }
+        // 扫描注册表中的位置
+        const regData = this.registry.load();
+        for (const link of regData.links) {
+            if (!existsSync(link.path))
+                continue;
+            if (link.type === "package") {
+                registerPackage(link.path);
+            }
+            else if (link.type === "workspace") {
+                const subprojects = discoverProjects(link.path, link.depth ?? 3);
+                for (const sub of subprojects) {
+                    registerPackage(sub, true);
+                }
+            }
+        }
+        return {
+            generationId: randomUUID(),
+            createdAt: new Date().toISOString(),
+            packages,
+        };
+    }
+}

package/dist/catalog/types.d.ts

@@ -0,0 +1,68 @@
+import type { ActionContract } from "@actiondock/sdk";
+import type { ProjectConfig } from "../project/types.js";
+/**
+ * 注册的位置条目类型。
+ */
+export type LocationType = "package" | "workspace";
+/**
+ * 位置注册表中的单条链接记录。
+ */
+export interface LocationLink {
+    /** 位置类型：单包或工作区 */
+    type: LocationType;
+    /** 目录绝对物理路径 */
+    path: string;
+    /** 注册时间（ISO 8601） */
+    linkedAt: string;
+    /** 扫描最大深度（工作区模式有效，默认 3） */
+    depth?: number;
+}
+/**
+ * 物理位置注册表文件（~/.actiondock/registry.json）格式。
+ */
+export interface LocationRegistryData {
+    schemaVersion: 1;
+    links: LocationLink[];
+}
+/**
+ * 解析后的包实例快照。
+ */
+export interface CatalogPackageEntry {
+    /** 逻辑包标识 */
+    id: string;
+    /** 包物理实例唯一标识 */
+    packageInstanceId: string;
+    /** 项目根目录绝对路径 */
+    projectRoot: string;
+    /** 项目配置 */
+    config: ProjectConfig;
+    /** 是否来自工作区自动发现 */
+    isWorkspaceChild?: boolean;
+}
+/**
+ * 运行时目录与包快照。
+ */
+export interface CatalogSnapshot {
+    /** 快照代次唯一标识 */
+    generationId: string;
+    /** 生成快照时间 */
+    createdAt: string;
+    /** 已发现的包集合（按 packageId 索引） */
+    packages: Map<string, CatalogPackageEntry>;
+}
+/**
+ * 索引中的 Action 描述符。
+ */
+export interface IndexedAction {
+    /** 所属逻辑包 ID */
+    packageId: string;
+    /** 动作 ID */
+    actionId: string;
+    /** 契约元数据 */
+    contract: ActionContract;
+    /** 实现入口相对路径 */
+    entry: string;
+    /** 包根目录绝对路径 */
+    projectRoot: string;
+}
+export type { ModuleLoader } from "../runtime/module-loader.js";

package/dist/catalog/types.js

@@ -0,0 +1 @@
+export {};

package/dist/doctor/doctor.d.ts

@@ -0,0 +1,7 @@
+import type { DoctorReport } from "./types.js";
+export declare function runDoctorChecks(options?: {
+    cwd?: string;
+    packageIdOrPath?: string;
+    customHome?: string;
+    packageAllowlist?: string[];
+}): Promise<DoctorReport>;