Skip to content

@codesoul-co/hypha-adapters-local / local-workspace-adapter

模块用法

用于声明并实施 Workspace 作用域边界。Local workspace adapter 模块公开 1 类、2 接口。

从包入口导入

ts
import {
  LocalWorkspaceAdapter,
} from '@codesoul-co/hypha-adapters-local';

import type {
  LocalWorkspaceAdapterOptions,
  LocalWorkspaceCaptureOptions,
} from '@codesoul-co/hypha-adapters-local';

使用要点

  • 2 个类型/接口用于应用代码、Adapter 或测试中的静态契约;请使用 import type,运行时不应依赖它们。
  • 1 个类提供可实例化的运行时实现;构造参数与公开方法在各自条目中完整列出。

公共导出

Symbol种类签名说明
LocalWorkspaceAdapternew LocalWorkspaceAdapter(options: LocalWorkspaceAdapterOptions): LocalWorkspaceAdapterAdapts a governed Workspace root to Local Process mutation evidence.
LocalWorkspaceAdapterOptions接口interface LocalWorkspaceAdapterOptionsLocal Workspace Adapter Options 接口,共包含 4 个公开字段或方法。
LocalWorkspaceCaptureOptions接口interface LocalWorkspaceCaptureOptionsLocal Workspace Capture Options 接口,共包含 1 个公开字段或方法。

LocalWorkspaceAdapter

Adapts a governed Workspace root to Local Process mutation evidence.

  • 种类: 类
  • 导入: import { LocalWorkspaceAdapter } from '@codesoul-co/hypha-adapters-local';
  • 源码模块: local-workspace-adapter

声明

text
export declare class LocalWorkspaceAdapter {
    readonly workspaceRoot: string;
    constructor(options: LocalWorkspaceAdapterOptions);
    assertAvailable(): Promise<void>;
    capture(options?: LocalWorkspaceCaptureOptions): Promise<LocalWorkspaceSnapshot>;
    diff(before: LocalWorkspaceSnapshot, after: LocalWorkspaceSnapshot, detectedAt: string): FileMutation[];
}

公开成员

成员种类签名说明
assertAvailable方法assertAvailable(): Promise<void>公开方法;参数与返回类型以签名列为准。
capture方法capture(options?: LocalWorkspaceCaptureOptions): Promise<LocalWorkspaceSnapshot>公开方法;参数与返回类型以签名列为准。
constructor构造函数(options: LocalWorkspaceAdapterOptions): LocalWorkspaceAdapter创建该类的实例。
diff方法diff(before: LocalWorkspaceSnapshot, after: LocalWorkspaceSnapshot, detectedAt: string): FileMutation[]公开方法;参数与返回类型以签名列为准。
workspaceRoot属性readonly workspaceRoot: string公开属性;类型、只读和可选状态以签名列为准。

LocalWorkspaceAdapterOptions

Local Workspace Adapter Options 接口,共包含 4 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { LocalWorkspaceAdapterOptions } from '@codesoul-co/hypha-adapters-local';
  • 源码模块: local-workspace-adapter

声明

text
export interface LocalWorkspaceAdapterOptions {
    workspaceRoot: string;
    maxTrackedFiles?: number;
    maxTrackedBytes?: number;
    maxCaptureDurationMs?: number;
}

契约成员

成员种类签名说明
maxCaptureDurationMs属性maxCaptureDurationMs?: number公开属性;类型、只读和可选状态以签名列为准。
maxTrackedBytes属性maxTrackedBytes?: number公开属性;类型、只读和可选状态以签名列为准。
maxTrackedFiles属性maxTrackedFiles?: number公开属性;类型、只读和可选状态以签名列为准。
workspaceRoot属性workspaceRoot: string公开属性;类型、只读和可选状态以签名列为准。

LocalWorkspaceCaptureOptions

Local Workspace Capture Options 接口,共包含 1 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { LocalWorkspaceCaptureOptions } from '@codesoul-co/hypha-adapters-local';
  • 源码模块: local-workspace-adapter

声明

text
export interface LocalWorkspaceCaptureOptions {
    abortSignal?: AbortSignal;
}

契约成员

成员种类签名说明
abortSignal属性abortSignal?: AbortSignal公开属性;类型、只读和可选状态以签名列为准。