zero-workspace 0.0.2

package/dist/types/context.d.ts

@@ -0,0 +1,174 @@
+import type { NodeStatus, AcceptanceCriteria } from "./node.js";
+import type { DispatchConfig, DocRef } from "./workspace.js";
+export type { DocRef };
+/**
+ * 带类型的日志条目（Phase 2）
+ */
+export interface TypedLogEntry {
+    timestamp: string;
+    operator: "AI" | "Human";
+    event: string;
+}
+/**
+ * 上下文链项
+ */
+export interface ContextChainItem {
+    nodeId: string;
+    title: string;
+    requirement: string;
+    docs: DocRef[];
+    note: string;
+    conclusion?: string;
+    problem?: string;
+    logEntries?: TypedLogEntry[];
+    acceptanceCriteria?: AcceptanceCriteria[];
+}
+/**
+ * 子节点结论项
+ */
+export interface ChildConclusionItem {
+    nodeId: string;
+    title: string;
+    status: NodeStatus;
+    conclusion: string;
+}
+/**
+ * Memo 引用项
+ */
+export interface MemoReferenceItem {
+    memoId: string;
+    title: string;
+    summary: string;
+    content: string;
+    tags: string[];
+}
+/**
+ * context_get 结果
+ */
+export interface ContextGetResult {
+    workspace: {
+        goal: string;
+        rules: string[];
+        rulesHash: string;
+        docs: DocRef[];
+        dispatch?: DispatchConfig;
+    };
+    chain: ContextChainItem[];
+    references: ContextChainItem[];
+    memoReferences: MemoReferenceItem[];
+    childConclusions: ChildConclusionItem[];
+    conclusionsHash: string;
+    hint?: string;
+    guidance?: string;
+}
+/**
+ * context_get 输入
+ */
+export interface ContextGetParams {
+    workspaceId: string;
+    nodeId: string;
+    includeLog?: boolean;
+    maxLogEntries?: number;
+    reverseLog?: boolean;
+    includeProblem?: boolean;
+}
+/**
+ * context_focus 输入
+ */
+export interface ContextFocusParams {
+    workspaceId: string;
+    nodeId: string;
+}
+/**
+ * context_focus 输出
+ */
+export interface ContextFocusResult {
+    success: boolean;
+    previousFocus: string | null;
+    currentFocus: string;
+    error?: "CONCLUSION_STALE";
+    staleNodeId?: string;
+    hint?: string;
+}
+/**
+ * node_isolate 输入
+ */
+export interface NodeIsolateParams {
+    workspaceId: string;
+    nodeId: string;
+    isolate: boolean;
+}
+/**
+ * node_isolate 输出
+ */
+export interface NodeIsolateResult {
+    success: boolean;
+}
+/**
+ * node_reference 操作类型
+ */
+export type ReferenceAction = "add" | "remove";
+/**
+ * node_reference 输入
+ */
+export interface NodeReferenceParams {
+    workspaceId: string;
+    nodeId: string;
+    targetIdOrPath: string;
+    action: ReferenceAction;
+    description?: string;
+}
+/**
+ * node_reference 输出
+ */
+export interface NodeReferenceResult {
+    success: boolean;
+    references: DocRef[];
+}
+/**
+ * log_append 输入
+ */
+export interface LogAppendParams {
+    workspaceId: string;
+    nodeId?: string;
+    operator: "AI" | "Human";
+    event: string;
+}
+/**
+ * log_append 输出
+ */
+export interface LogAppendResult {
+    success: boolean;
+    timestamp: string;
+    hint?: string;
+}
+/**
+ * problem_update 输入
+ */
+export interface ProblemUpdateParams {
+    workspaceId: string;
+    nodeId?: string;
+    problem: string;
+    nextStep?: string;
+}
+/**
+ * problem_update 输出
+ */
+export interface ProblemUpdateResult {
+    success: boolean;
+    hint?: string;
+}
+/**
+ * problem_clear 输入
+ */
+export interface ProblemClearParams {
+    workspaceId: string;
+    nodeId?: string;
+}
+/**
+ * problem_clear 输出
+ */
+export interface ProblemClearResult {
+    success: boolean;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"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"}

package/dist/types/context.js

@@ -0,0 +1,3 @@
+// src/types/context.ts
+export {};
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA,uBAAuB"}

package/dist/types/errors.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 错误码定义
+ */
+export declare const ErrorCodes: {
+    readonly WORKSPACE_EXISTS: "WORKSPACE_EXISTS";
+    readonly WORKSPACE_NOT_FOUND: "WORKSPACE_NOT_FOUND";
+    readonly WORKSPACE_ACTIVE: "WORKSPACE_ACTIVE";
+    readonly WORKSPACE_ARCHIVED: "WORKSPACE_ARCHIVED";
+    readonly WORKSPACE_ERROR: "WORKSPACE_ERROR";
+    readonly INVALID_NAME: "INVALID_NAME";
+    readonly INVALID_PATH: "INVALID_PATH";
+    readonly INIT_FAILED: "INIT_FAILED";
+    readonly NODE_NOT_FOUND: "NODE_NOT_FOUND";
+    readonly PARENT_NOT_FOUND: "PARENT_NOT_FOUND";
+    readonly INVALID_TITLE: "INVALID_TITLE";
+    readonly INVALID_CONTENT: "INVALID_CONTENT";
+    readonly CANNOT_DELETE_ROOT: "CANNOT_DELETE_ROOT";
+    readonly INVALID_TRANSITION: "INVALID_TRANSITION";
+    readonly CONCLUSION_REQUIRED: "CONCLUSION_REQUIRED";
+    readonly CONCLUSION_TOO_LONG: "CONCLUSION_TOO_LONG";
+    readonly CONCLUSION_STALE: "CONCLUSION_STALE";
+    readonly CONCLUSIONS_HASH_REQUIRED: "CONCLUSIONS_HASH_REQUIRED";
+    readonly CONCLUSIONS_HASH_MISMATCH: "CONCLUSIONS_HASH_MISMATCH";
+    readonly INFO_COLLECTION_REQUIRED: "INFO_COLLECTION_REQUIRED";
+    readonly INVALID_CONFIRMATION_TOKEN: "INVALID_CONFIRMATION_TOKEN";
+    readonly CONFIRMATION_MISMATCH: "CONFIRMATION_MISMATCH";
+    readonly REFERENCE_NOT_FOUND: "REFERENCE_NOT_FOUND";
+    readonly REFERENCE_EXISTS: "REFERENCE_EXISTS";
+    readonly MEMO_NOT_FOUND: "MEMO_NOT_FOUND";
+    readonly LOG_APPEND_FAILED: "LOG_APPEND_FAILED";
+    readonly INVALID_NODE_TYPE: "INVALID_NODE_TYPE";
+    readonly INVALID_NODE_ROLE: "INVALID_NODE_ROLE";
+    readonly EXECUTION_CANNOT_HAVE_CHILDREN: "EXECUTION_CANNOT_HAVE_CHILDREN";
+    readonly INVALID_PARENT_STATUS: "INVALID_PARENT_STATUS";
+    readonly INCOMPLETE_CHILDREN: "INCOMPLETE_CHILDREN";
+    readonly CONCURRENT_EXECUTION: "CONCURRENT_EXECUTION";
+    readonly RULES_HASH_MISMATCH: "RULES_HASH_MISMATCH";
+    readonly INVALID_PARAMS: "INVALID_PARAMS";
+    readonly UNKNOWN_PARAMS: "UNKNOWN_PARAMS";
+    readonly CONTENT_CHANGED: "CONTENT_CHANGED";
+    readonly NO_MATCH: "NO_MATCH";
+    readonly MULTI_MATCH: "MULTI_MATCH";
+    readonly GRAPH_CORRUPTED: "GRAPH_CORRUPTED";
+    readonly NODE_DIR_MISSING: "NODE_DIR_MISSING";
+    readonly NODE_INFO_MISSING: "NODE_INFO_MISSING";
+    readonly GIT_NOT_FOUND: "GIT_NOT_FOUND";
+    readonly DISPATCH_CONFLICT: "DISPATCH_CONFLICT";
+    readonly DISPATCH_NOT_ENABLED: "DISPATCH_NOT_ENABLED";
+    readonly DISPATCH_REQUIRED: "DISPATCH_REQUIRED";
+    readonly DISPATCH_IN_PROGRESS: "DISPATCH_IN_PROGRESS";
+    readonly INVALID_NODE_STATUS: "INVALID_NODE_STATUS";
+    readonly INVALID_TEST_NODE: "INVALID_TEST_NODE";
+    readonly EXEC_NODE_NOT_FOUND: "EXEC_NODE_NOT_FOUND";
+    readonly DISPATCH_ALREADY_ENABLED: "DISPATCH_ALREADY_ENABLED";
+    readonly DISPATCH_MODE_CONFLICT: "DISPATCH_MODE_CONFLICT";
+    readonly GIT_ENVIRONMENT_LOST: "GIT_ENVIRONMENT_LOST";
+    readonly NODE_NOT_READY: "NODE_NOT_READY";
+    readonly DISPATCH_SKIP: "DISPATCH_SKIP";
+    readonly INVALID_DISPATCH_PARENT: "INVALID_DISPATCH_PARENT";
+    readonly INVALID_DISPATCH_STATUS: "INVALID_DISPATCH_STATUS";
+    readonly DISPATCH_CHILDREN_EXIST: "DISPATCH_CHILDREN_EXIST";
+    readonly INVALID_CONFIG: "INVALID_CONFIG";
+    readonly VERSION_TOO_HIGH: "VERSION_TOO_HIGH";
+    readonly VERSION_READONLY: "VERSION_READONLY";
+};
+/**
+ * 错误码类型
+ */
+export type ErrorCode = keyof typeof ErrorCodes;
+/**
+ * 自定义错误类
+ */
+export declare class ZeroError extends Error {
+    code: ErrorCode;
+    constructor(code: ErrorCode, message: string);
+}
+/**
+ * 错误消息映射
+ */
+export declare const ErrorMessages: Record<ErrorCode, string>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFb,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,UAAU,CAAC;AAEhD;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAEzB,IAAI,EAAE,SAAS;gBAAf,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM;CAKlB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CA6DnD,CAAC"}

package/dist/types/errors.js

@@ -0,0 +1,154 @@
+// src/types/errors.ts
+/**
+ * 错误码定义
+ */
+export const ErrorCodes = {
+    // 工作区错误
+    WORKSPACE_EXISTS: "WORKSPACE_EXISTS",
+    WORKSPACE_NOT_FOUND: "WORKSPACE_NOT_FOUND",
+    WORKSPACE_ACTIVE: "WORKSPACE_ACTIVE",
+    WORKSPACE_ARCHIVED: "WORKSPACE_ARCHIVED",
+    WORKSPACE_ERROR: "WORKSPACE_ERROR",
+    INVALID_NAME: "INVALID_NAME",
+    INVALID_PATH: "INVALID_PATH",
+    INIT_FAILED: "INIT_FAILED",
+    // 节点错误
+    NODE_NOT_FOUND: "NODE_NOT_FOUND",
+    PARENT_NOT_FOUND: "PARENT_NOT_FOUND",
+    INVALID_TITLE: "INVALID_TITLE",
+    INVALID_CONTENT: "INVALID_CONTENT",
+    CANNOT_DELETE_ROOT: "CANNOT_DELETE_ROOT",
+    // 状态转换错误
+    INVALID_TRANSITION: "INVALID_TRANSITION",
+    CONCLUSION_REQUIRED: "CONCLUSION_REQUIRED",
+    CONCLUSION_TOO_LONG: "CONCLUSION_TOO_LONG",
+    CONCLUSION_STALE: "CONCLUSION_STALE",
+    CONCLUSIONS_HASH_REQUIRED: "CONCLUSIONS_HASH_REQUIRED",
+    CONCLUSIONS_HASH_MISMATCH: "CONCLUSIONS_HASH_MISMATCH",
+    INFO_COLLECTION_REQUIRED: "INFO_COLLECTION_REQUIRED",
+    INVALID_CONFIRMATION_TOKEN: "INVALID_CONFIRMATION_TOKEN",
+    CONFIRMATION_MISMATCH: "CONFIRMATION_MISMATCH",
+    // 引用错误
+    REFERENCE_NOT_FOUND: "REFERENCE_NOT_FOUND",
+    REFERENCE_EXISTS: "REFERENCE_EXISTS",
+    // 备忘错误
+    MEMO_NOT_FOUND: "MEMO_NOT_FOUND",
+    // 日志错误
+    LOG_APPEND_FAILED: "LOG_APPEND_FAILED",
+    // 节点类型错误
+    INVALID_NODE_TYPE: "INVALID_NODE_TYPE",
+    INVALID_NODE_ROLE: "INVALID_NODE_ROLE",
+    EXECUTION_CANNOT_HAVE_CHILDREN: "EXECUTION_CANNOT_HAVE_CHILDREN",
+    INVALID_PARENT_STATUS: "INVALID_PARENT_STATUS",
+    INCOMPLETE_CHILDREN: "INCOMPLETE_CHILDREN",
+    CONCURRENT_EXECUTION: "CONCURRENT_EXECUTION",
+    RULES_HASH_MISMATCH: "RULES_HASH_MISMATCH",
+    INVALID_PARAMS: "INVALID_PARAMS",
+    UNKNOWN_PARAMS: "UNKNOWN_PARAMS",
+    CONTENT_CHANGED: "CONTENT_CHANGED",
+    NO_MATCH: "NO_MATCH",
+    MULTI_MATCH: "MULTI_MATCH",
+    // 校验错误
+    GRAPH_CORRUPTED: "GRAPH_CORRUPTED",
+    NODE_DIR_MISSING: "NODE_DIR_MISSING",
+    NODE_INFO_MISSING: "NODE_INFO_MISSING",
+    // 派发错误
+    GIT_NOT_FOUND: "GIT_NOT_FOUND",
+    DISPATCH_CONFLICT: "DISPATCH_CONFLICT",
+    DISPATCH_NOT_ENABLED: "DISPATCH_NOT_ENABLED",
+    DISPATCH_REQUIRED: "DISPATCH_REQUIRED",
+    DISPATCH_IN_PROGRESS: "DISPATCH_IN_PROGRESS",
+    INVALID_NODE_STATUS: "INVALID_NODE_STATUS",
+    INVALID_TEST_NODE: "INVALID_TEST_NODE",
+    EXEC_NODE_NOT_FOUND: "EXEC_NODE_NOT_FOUND",
+    DISPATCH_ALREADY_ENABLED: "DISPATCH_ALREADY_ENABLED",
+    DISPATCH_MODE_CONFLICT: "DISPATCH_MODE_CONFLICT",
+    GIT_ENVIRONMENT_LOST: "GIT_ENVIRONMENT_LOST",
+    NODE_NOT_READY: "NODE_NOT_READY",
+    DISPATCH_SKIP: "DISPATCH_SKIP",
+    INVALID_DISPATCH_PARENT: "INVALID_DISPATCH_PARENT",
+    INVALID_DISPATCH_STATUS: "INVALID_DISPATCH_STATUS",
+    DISPATCH_CHILDREN_EXIST: "DISPATCH_CHILDREN_EXIST",
+    // 配置错误
+    INVALID_CONFIG: "INVALID_CONFIG",
+    // 版本错误
+    VERSION_TOO_HIGH: "VERSION_TOO_HIGH",
+    VERSION_READONLY: "VERSION_READONLY",
+};
+/**
+ * 自定义错误类
+ */
+export class ZeroError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ZeroError";
+    }
+}
+/**
+ * 错误消息映射
+ */
+export const ErrorMessages = {
+    WORKSPACE_EXISTS: "工作区已存在",
+    WORKSPACE_NOT_FOUND: "工作区不存在",
+    WORKSPACE_ACTIVE: "工作区处于活动状态，无法删除（使用 force 强制删除）",
+    WORKSPACE_ARCHIVED: "工作区状态不符合操作要求",
+    WORKSPACE_ERROR: "工作区处于错误状态，需要修复",
+    INVALID_NAME: "名称不合法，不能包含特殊字符: / \\ : * ? \" < > |",
+    INVALID_PATH: "路径不合法或不存在",
+    INIT_FAILED: "工作区初始化失败",
+    NODE_NOT_FOUND: "节点不存在",
+    PARENT_NOT_FOUND: "父节点不存在",
+    INVALID_TITLE: "标题不合法，不能包含特殊字符: / \\ : * ? \" < > |",
+    INVALID_CONTENT: "内容格式不合法，包含会破坏解析的字符",
+    CANNOT_DELETE_ROOT: "无法删除根节点",
+    INVALID_TRANSITION: "非法状态转换",
+    CONCLUSION_REQUIRED: "complete/fail 动作必须提供 conclusion",
+    CONCLUSION_TOO_LONG: "结论过长，请创建 memo 记录详情后提交精简结论",
+    CONCLUSION_STALE: "结论已过期，请先更新结论后再切换焦点",
+    CONCLUSIONS_HASH_REQUIRED: "规划节点 complete 需要提供 conclusionsHash，请先调用 context_get",
+    CONCLUSIONS_HASH_MISMATCH: "conclusionsHash 不匹配，子节点结论可能已变化，请重新 context_get",
+    INFO_COLLECTION_REQUIRED: "根节点 start 前必须完成信息收集节点",
+    INVALID_CONFIRMATION_TOKEN: "confirmation token 无效或已过期",
+    CONFIRMATION_MISMATCH: "confirmation token 对应的节点不匹配",
+    REFERENCE_NOT_FOUND: "引用不存在",
+    REFERENCE_EXISTS: "引用已存在",
+    MEMO_NOT_FOUND: "备忘不存在",
+    LOG_APPEND_FAILED: "日志追加失败",
+    INVALID_NODE_TYPE: "节点类型无效，必须是 planning 或 execution",
+    INVALID_NODE_ROLE: "节点角色无效，派发子节点不能再升级为派发母节点",
+    EXECUTION_CANNOT_HAVE_CHILDREN: "执行节点不能创建子节点",
+    INVALID_PARENT_STATUS: "父节点状态不允许创建子节点",
+    INCOMPLETE_CHILDREN: "存在未完成的子节点",
+    CONCURRENT_EXECUTION: "同级节点正在执行中，请遵循一次一个节点原则",
+    RULES_HASH_MISMATCH: "规则哈希不匹配，请先获取最新规则",
+    INVALID_PARAMS: "参数无效",
+    UNKNOWN_PARAMS: "存在未知参数",
+    CONTENT_CHANGED: "内容已变更，请重新获取",
+    NO_MATCH: "未找到匹配内容",
+    MULTI_MATCH: "找到多处匹配，请提供更多上下文",
+    GRAPH_CORRUPTED: "节点图数据损坏",
+    NODE_DIR_MISSING: "节点目录不存在",
+    NODE_INFO_MISSING: "节点 Info.md 不存在",
+    GIT_NOT_FOUND: "当前项目不是 git 仓库",
+    DISPATCH_CONFLICT: "已有其他工作区正在派发中",
+    DISPATCH_NOT_ENABLED: "派发模式未启用",
+    DISPATCH_REQUIRED: "派发模式已启用，执行节点必须通过 dispatch_node 派发执行",
+    DISPATCH_IN_PROGRESS: "节点正在派发执行中，请等待 subagent 完成",
+    INVALID_NODE_STATUS: "节点状态不符合操作要求",
+    INVALID_TEST_NODE: "无效的测试节点",
+    EXEC_NODE_NOT_FOUND: "关联的执行节点不存在",
+    DISPATCH_ALREADY_ENABLED: "派发模式已启用，如需切换模式请先禁用",
+    DISPATCH_MODE_CONFLICT: "同一项目只能使用一种派发模式",
+    GIT_ENVIRONMENT_LOST: "Git 环境已丢失",
+    NODE_NOT_READY: "节点未准备好派发，缺少必要信息",
+    DISPATCH_SKIP: "节点无需派发，可直接执行",
+    INVALID_DISPATCH_PARENT: "节点不是派发母节点，需先调用 dispatch_node 升级",
+    INVALID_DISPATCH_STATUS: "派发状态不正确，需先调用 node_transition(action=start) 开始执行",
+    DISPATCH_CHILDREN_EXIST: "派发子节点已存在，无法重复创建",
+    INVALID_CONFIG: "配置文件无效",
+    VERSION_TOO_HIGH: "数据版本过高，请升级 zero-workspace",
+    VERSION_READONLY: "数据版本高于当前代码版本，禁止写入",
+};
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"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"}

package/dist/types/guidance.d.ts

@@ -0,0 +1,162 @@
+/**
+ * 引导级别
+ * - L0: 简短提示（1-2 句话，嵌入在工具返回值的 hint 中）
+ * - L1: 工作流片段（关键步骤列表，3-5 个要点）
+ * - L2: 完整指南（详细说明，包含示例和错误处理）
+ */
+export type GuidanceLevel = 0 | 1 | 2;
+/**
+ * 触发场景类型
+ * 定义何时需要显示引导内容
+ */
+export type GuidanceScenario = "workspace_init" | "workspace_first_planning" | "workspace_archived" | "workspace_restored" | "scenario_feature" | "scenario_summary" | "scenario_optimize" | "scenario_debug" | "scenario_misc" | "node_create_planning" | "node_create_execution" | "node_create_info_collection" | "execution_start" | "execution_complete" | "execution_fail" | "planning_start" | "planning_complete" | "planning_monitoring" | "node_reopen_with_children" | "actionRequired_triggered" | "confirmation_required" | "info_collection_missing" | "docs_派发_missing" | "error_invalid_transition" | "error_execution_has_children" | "error_workspace_not_found" | "unknown";
+/**
+ * 引导内容
+ * 包含不同级别的引导信息
+ */
+export interface Guidance {
+    /** 引导级别 */
+    level: GuidanceLevel;
+    /** 触发场景 */
+    scenario: GuidanceScenario;
+    /** 引导内容 */
+    content: string;
+    /** 是否可展开到更详细级别 */
+    expandable: boolean;
+    /** 展开到更详细级别时的场景（如果 expandable 为 true） */
+    expandTo?: GuidanceScenario;
+    /** 相关主题（用于关联到 zero_help 主题） */
+    relatedHelpTopics?: string[];
+    /** 元数据（可选） */
+    metadata?: {
+        /** 优先级（数字越大优先级越高） */
+        priority?: number;
+        /** 触发频率限制（避免重复提示） */
+        frequencyLimit?: "once" | "session" | "always";
+        /** 是否为关键协议（违反将导致任务失败） */
+        critical?: boolean;
+    };
+}
+/**
+ * 引导配置
+ * 定义不同场景下的引导内容（所有级别）
+ */
+export interface GuidanceConfig {
+    /** 场景标识 */
+    scenario: GuidanceScenario;
+    /** L0 级别：简短提示（1-2 句话） */
+    l0: string;
+    /** L1 级别：工作流片段（关键步骤，3-5 个要点） */
+    l1: string;
+    /** L2 级别：完整指南（详细说明，包含示例） */
+    l2: string;
+    /** 相关 zero_help 主题 */
+    relatedHelpTopics?: string[];
+    /** 配置元数据 */
+    metadata?: {
+        priority?: number;
+        frequencyLimit?: "once" | "session" | "always";
+        critical?: boolean;
+    };
+}
+/**
+ * 引导内容生成器接口
+ * 用于根据场景和上下文动态生成引导内容
+ */
+export interface GuidanceGenerator {
+    /**
+     * 检测当前场景
+     * @param context 当前操作上下文
+     * @returns 检测到的场景类型
+     */
+    detectScenario(context: GuidanceContext): GuidanceScenario;
+    /**
+     * 生成引导内容
+     * @param scenario 场景类型
+     * @param level 引导级别
+     * @param context 上下文数据（用于动态填充）
+     * @returns 引导内容
+     */
+    generate(scenario: GuidanceScenario, level: GuidanceLevel, context?: GuidanceContext): Guidance;
+    /**
+     * 获取场景的完整配置
+     * @param scenario 场景类型
+     * @returns 引导配置
+     */
+    getConfig(scenario: GuidanceScenario): GuidanceConfig | null;
+}
+/**
+ * 引导上下文
+ * 用于场景检测和内容生成的上下文数据
+ */
+export interface GuidanceContext {
+    /** 工具名称（如 workspace_init, node_create 等） */
+    toolName?: string;
+    /** 工具输入参数 */
+    toolInput?: Record<string, unknown>;
+    /** 工具输出结果 */
+    toolOutput?: Record<string, unknown>;
+    /** 节点类型 */
+    nodeType?: "planning" | "execution";
+    /** 节点状态 */
+    nodeStatus?: string;
+    /** 节点角色 */
+    nodeRole?: string;
+    /** 是否有子节点 */
+    hasChildren?: boolean;
+    /** 是否有文档引用 */
+    hasDocs?: boolean;
+    /** 错误信息（如果有） */
+    error?: {
+        code: string;
+        message: string;
+    };
+    /** 其他上下文数据 */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 引导内容注入策略
+ * 定义如何将引导内容注入到工具返回值中
+ */
+export interface GuidanceInjectionStrategy {
+    /** 注入目标字段 */
+    targetField: "hint" | "actionRequired.message" | "error.message" | "custom";
+    /** 自定义字段名（当 targetField 为 "custom" 时使用） */
+    customField?: string;
+    /** 是否追加到现有内容（false 则替换） */
+    append?: boolean;
+    /** 内容格式化函数 */
+    format?: (guidance: Guidance, existingContent?: string) => string;
+}
+/**
+ * 引导内容存储接口
+ * 用于持久化引导配置和使用记录
+ */
+export interface GuidanceStorage {
+    /**
+     * 加载所有引导配置
+     * @returns 引导配置映射
+     */
+    loadConfigs(): Promise<Map<GuidanceScenario, GuidanceConfig>>;
+    /**
+     * 保存引导配置
+     * @param configs 引导配置映射
+     */
+    saveConfigs(configs: Map<GuidanceScenario, GuidanceConfig>): Promise<void>;
+    /**
+     * 记录引导内容使用
+     * @param scenario 场景类型
+     * @param level 引导级别
+     * @param sessionId 会话 ID
+     */
+    recordUsage(scenario: GuidanceScenario, level: GuidanceLevel, sessionId?: string): Promise<void>;
+    /**
+     * 检查引导内容是否应该显示（基于频率限制）
+     * @param scenario 场景类型
+     * @param frequencyLimit 频率限制
+     * @param sessionId 会话 ID
+     * @returns 是否应该显示
+     */
+    shouldShow(scenario: GuidanceScenario, frequencyLimit: "once" | "session" | "always", sessionId?: string): Promise<boolean>;
+}
+//# sourceMappingURL=guidance.d.ts.map

package/dist/types/guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../../src/types/guidance.ts"],"names":[],"mappings":"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"}

package/dist/types/guidance.js

@@ -0,0 +1,4 @@
+// src/types/guidance.ts
+// 层级式引导内容结构定义
+export {};
+//# sourceMappingURL=guidance.js.map

package/dist/types/guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance.js","sourceRoot":"","sources":["../../src/types/guidance.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,cAAc"}

package/dist/types/health.d.ts

@@ -0,0 +1,61 @@
+export type HealthIssueType = "version_mismatch" | "index_corrupt" | "node_corrupt" | "dir_missing" | "graph_corrupt" | "config_corrupt";
+export type IssueSeverity = "error" | "warning";
+export interface HealthIssue {
+    type: HealthIssueType;
+    severity: IssueSeverity;
+    target?: string;
+    message: string;
+    suggestion: string;
+}
+export interface WorkspaceHealthResult {
+    workspaceId: string;
+    workspaceName: string;
+    status: "healthy" | "warning" | "error";
+    issues: HealthIssue[];
+}
+export interface HealthReport {
+    status: "healthy" | "warning" | "error";
+    checkedAt: string;
+    codeVersion: string;
+    issues: HealthIssue[];
+    summary: {
+        totalWorkspaces: number;
+        healthyWorkspaces: number;
+        warningWorkspaces: number;
+        errorWorkspaces: number;
+    };
+}
+export interface BackupMeta {
+    name: string;
+    workspaceId: string;
+    workspaceName: string;
+    createdAt: string;
+    trigger: "manual" | "auto" | "pre_operation";
+    codeVersion: string;
+    size: number;
+    verified: boolean;
+}
+export interface BackupListItem extends BackupMeta {
+    path: string;
+}
+export type GlobalBackupTrigger = "beta_update" | "manual" | "pre_restore";
+export interface GlobalBackupManifest {
+    format: "twbak";
+    version: "1.0";
+    createdAt: string;
+    codeVersion: string;
+    trigger: GlobalBackupTrigger;
+    checksum: string;
+    contents: {
+        workspaceCount: number;
+    };
+}
+export interface GlobalBackupItem {
+    name: string;
+    path: string;
+    createdAt: string;
+    codeVersion: string;
+    trigger: GlobalBackupTrigger;
+    size: number;
+}
+//# sourceMappingURL=health.d.ts.map