openxiangda-devkit-core 2.0.0-alpha.114 → 2.0.0-alpha.117

package/dist/documentation.js

@@ -0,0 +1,111 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs';
+import { isAbsolute, relative, resolve } from 'node:path';
+/** 使用指南的唯一主题目录；正文从同版本根包读取。 */
+export const DOCUMENTATION_TOPICS = [
+    { id: 'getting-started', title: '安装与开始开发', file: 'getting-started.md' },
+    { id: 'development', title: '需求与开发流程', file: 'development.md' },
+    { id: 'application-foundation', title: '业务模型与标准 CRUD', file: 'application-foundation.md' },
+    { id: 'appspec', title: '需求、设计与交付记录', file: 'appspec.md' },
+    { id: 'concepts', title: '架构与能力所有者', file: 'concepts.md' },
+    { id: 'frontend', title: '页面与标准组件扩展', file: 'frontend.md' },
+    { id: 'field-components', title: '字段、表单与移动控件', file: 'field-components.md' },
+    { id: 'data-authz', title: '数据查询与权限', file: 'data-authz.md' },
+    { id: 'public-access', title: '无账号的匿名公开访问', file: 'public-access.md' },
+    { id: 'workflow-events', title: '审批、事件与通知', file: 'workflow-events.md' },
+    { id: 'backend', title: '按需后端与业务动作', file: 'backend.md' },
+    { id: 'administration', title: '应用管理与有效配置', file: 'administration.md' },
+    { id: 'testing', title: '检查与真实业务验收', file: 'testing.md' },
+    { id: 'delivery', title: '部署、生产晋级与恢复', file: 'delivery.md' },
+    { id: 'upgrading', title: '版本升级与资料刷新', file: 'upgrading.md' },
+    { id: 'cli', title: 'CLI 命令参考', file: 'reference/cli.md' },
+    { id: 'mcp', title: 'MCP 配置与工具参考', file: 'reference/mcp.md' },
+];
+/** Skill 参考文件名保留稳定入口，正文仍由中文主题生成。 */
+export function documentationReferenceFile(id) {
+    const aliases = { development: 'discovery', concepts: 'architecture', cli: 'commands' };
+    return `${aliases[id] || id}.md`;
+}
+const MAX_TOPIC_BYTES = 128 * 1024;
+export function documentationRoot() {
+    return resolve(process.env.OPENXIANGDA_DOCUMENTATION_ROOT || resolve(import.meta.dirname, '../../../docs'));
+}
+function topicSource(id, root) {
+    const topic = DOCUMENTATION_TOPICS.find(item => item.id === id);
+    if (!topic)
+        throw new Error(`DOCUMENTATION_TOPIC_NOT_FOUND: 未知主题 ${id}，运行 pnpm openxiangda docs 查看目录`);
+    const path = resolve(root, topic.file);
+    if (!existsSync(path))
+        throw new Error(`DOCUMENTATION_NOT_INSTALLED: 当前安装缺少 ${id}，请通过同版本 openxiangda 根包启动`);
+    const resolved = realpathSync(path);
+    const local = relative(realpathSync(root), resolved);
+    if (local.startsWith('..') || isAbsolute(local))
+        throw new Error('DOCUMENTATION_PATH_FORBIDDEN: 文档不能越过资料目录');
+    if (!statSync(resolved).isFile() || statSync(resolved).size > MAX_TOPIC_BYTES) {
+        throw new Error('DOCUMENTATION_SIZE_EXCEEDED: 单个主题必须是大小不超过 128 KiB 的文本文档');
+    }
+    const text = readFileSync(resolved, 'utf8');
+    const sha256 = createHash('sha256').update(text).digest('hex');
+    const manifestPath = resolve(root, 'manifest.json');
+    const manifest = existsSync(manifestPath)
+        ? JSON.parse(readFileSync(manifestPath, 'utf8'))
+        : undefined;
+    if (manifest && manifest.topics.find(item => item.id === id)?.sha256 !== sha256) {
+        throw new Error(`DOCUMENTATION_DIGEST_MISMATCH: ${id} 与当前根包资料摘要不一致，请重新安装该精确版本`);
+    }
+    return { ...topic, text, sha256, version: manifest?.version || 'development' };
+}
+function sections(text) {
+    const lines = text.split('\n');
+    const found = [];
+    let fenced = false;
+    const used = new Map();
+    lines.forEach((line, index) => {
+        if (/^\s*(```|~~~)/.test(line)) {
+            fenced = !fenced;
+            return;
+        }
+        const match = !fenced && line.match(/^##\s+(.+?)(?:\s+\{#([\w-]+)\})?\s*$/);
+        if (!match)
+            return;
+        const title = match[1];
+        const base = match[2] || title.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, '-').replace(/^-|-$/g, '');
+        const count = used.get(base) || 0;
+        used.set(base, count + 1);
+        if (found.length)
+            found[found.length - 1].end = index;
+        found.push({ id: count ? `${base}-${count + 1}` : base, title, start: index, end: lines.length });
+    });
+    return { lines, found };
+}
+export function documentationIndex(root = documentationRoot()) {
+    const topics = DOCUMENTATION_TOPICS.map(({ id }) => {
+        const source = topicSource(id, root);
+        return {
+            id, title: source.title, uri: `openxiangda://docs/${id}`,
+            version: source.version, sha256: source.sha256,
+            bytes: Buffer.byteLength(source.text),
+            sections: sections(source.text).found.map(({ id, title }) => ({ id, title })),
+        };
+    });
+    return { schemaVersion: 'openxiangda.documentation/v1', topics };
+}
+export function readDocumentation(id, section, root = documentationRoot()) {
+    const source = topicSource(id, root);
+    const parsed = sections(source.text);
+    const selected = section ? parsed.found.find(item => item.id === section) : undefined;
+    if (section && !selected)
+        throw new Error(`DOCUMENTATION_SECTION_NOT_FOUND: ${id} 没有章节 ${section}，先读取该主题的章节目录`);
+    return {
+        schemaVersion: 'openxiangda.documentation/v1', topic: id, title: source.title,
+        version: source.version, sha256: source.sha256, uri: `openxiangda://docs/${id}`,
+        sections: parsed.found.map(({ id, title }) => ({ id, title })),
+        content: selected ? parsed.lines.slice(selected.start, selected.end).join('\n') : source.text,
+    };
+}
+export function workspaceGuidanceTemplatePath() {
+    return process.env.OPENXIANGDA_DOCUMENTATION_ROOT
+        ? resolve(documentationRoot(), 'AGENTS.md')
+        : resolve(import.meta.dirname, '../../../templates/application/AGENTS.md');
+}
+//# sourceMappingURL=documentation.js.map

package/dist/documentation.js.map

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

package/dist/index.d.ts

@@ -18,4 +18,10 @@ export * from './version.js';
 export * from './toolchain-capsule.js';
 export * from './application-ui-contract.js';
 export * from './optional-backend.js';
+export * from './developer-operations.js';
+export * from './operation-progress.js';
+export * from './deployment-observer.js';
+export * from './documentation.js';
+export { developerError } from './developer-errors.js';
+export { withWorkspaceOperation } from './workspace-operation.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -18,4 +18,10 @@ export * from './version.js';
 export * from './toolchain-capsule.js';
 export * from './application-ui-contract.js';
 export * from './optional-backend.js';
+export * from './developer-operations.js';
+export * from './operation-progress.js';
+export * from './deployment-observer.js';
+export * from './documentation.js';
+export { developerError } from './developer-errors.js';
+export { withWorkspaceOperation } from './workspace-operation.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/operation-progress.d.ts

@@ -0,0 +1,26 @@
+export interface OperationStage {
+    stage: string;
+    label: string;
+    state: 'running' | 'passed' | 'failed' | 'skipped';
+    startedAt: string;
+    durationMs: number;
+    details?: Record<string, unknown>;
+}
+export interface OperationProgress extends OperationStage {
+    schemaVersion: 'openxiangda.operation-progress/v1';
+    operationId: string;
+    operation: string;
+    sequence: number;
+    elapsedMs: number;
+    heartbeat: boolean;
+}
+export type OperationProgressListener = (event: OperationProgress) => void | Promise<void>;
+/** 每次调用独立；并发 MCP 请求不会共享当前阶段或监听器。 */
+export declare function withOperationProgress<T extends {
+    data?: unknown;
+}>(operation: string, listener: OperationProgressListener | undefined, execute: () => Promise<T>, heartbeatMs?: number): Promise<T>;
+export declare function operationStage<T>(stage: string, label: string, execute: () => Promise<T>): Promise<T>;
+export declare function skippedOperationStage(stage: string, label: string): void;
+/** 平台仍是运行状态权威；此处只刷新本次观察的标题和运行指针。 */
+export declare function updateOperationStage(stage: string, label: string, details: Record<string, unknown>): void;
+//# sourceMappingURL=operation-progress.d.ts.map

package/dist/operation-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-progress.d.ts","sourceRoot":"","sources":["../src/operation-progress.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AACD,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,aAAa,EAAE,mCAAmC,CAAC;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AACD,MAAM,MAAM,yBAAyB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAY3F,oCAAoC;AACpC,wBAAsB,qBAAqB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EACtE,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,yBAAyB,GAAG,SAAS,EAC/C,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,WAAW,SAAS,GACnB,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAYD,wBAAsB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAwB3G;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAKjE;AAED,oCAAoC;AACpC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAQlG"}

package/dist/operation-progress.js

@@ -0,0 +1,92 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomUUID } from 'node:crypto';
+const storage = new AsyncLocalStorage();
+/** 每次调用独立；并发 MCP 请求不会共享当前阶段或监听器。 */
+export async function withOperationProgress(operation, listener, execute, heartbeatMs = 10_000) {
+    const context = {
+        operationId: randomUUID(), operation, started: Date.now(), sequence: 0,
+        stages: [], heartbeatMs, ...(listener ? { listener } : {}),
+    };
+    return storage.run(context, async () => {
+        const execution = () => ({
+            operationId: context.operationId,
+            elapsedMs: Date.now() - context.started,
+            stages: context.stages.map(stage => ({ ...stage })),
+        });
+        try {
+            const result = await execute();
+            const data = result.data && typeof result.data === 'object' ? result.data : {};
+            return { ...result, data: { ...data, execution: execution() } };
+        }
+        catch (error) {
+            if (error && typeof error === 'object') {
+                const value = error;
+                try {
+                    value.data = { ...value.data, execution: execution() };
+                }
+                catch { /* 保留不可扩展的原始异常。 */ }
+            }
+            throw error;
+        }
+    });
+}
+function emit(context, stage, heartbeat = false) {
+    const event = {
+        ...stage, schemaVersion: 'openxiangda.operation-progress/v1',
+        operationId: context.operationId, operation: context.operation,
+        sequence: ++context.sequence, elapsedMs: Date.now() - context.started, heartbeat,
+    };
+    // 可观测性传输失败不能改变已提交操作的结果；最终结果仍带阶段摘要。
+    try {
+        void Promise.resolve(context.listener?.(event)).catch(() => undefined);
+    }
+    catch { /* 观察者不能改变执行。 */ }
+}
+export async function operationStage(stage, label, execute) {
+    const context = storage.getStore();
+    if (!context)
+        return execute();
+    const started = Date.now();
+    const record = { stage, label, state: 'running', startedAt: new Date(started).toISOString(), durationMs: 0 };
+    context.stages.push(record);
+    emit(context, record);
+    const heartbeat = setInterval(() => {
+        record.durationMs = Date.now() - started;
+        emit(context, record, true);
+    }, context.heartbeatMs);
+    heartbeat.unref();
+    try {
+        const result = await execute();
+        record.state = result && typeof result === 'object' && 'ok' in result && result.ok === false ? 'failed' : 'passed';
+        return result;
+    }
+    catch (error) {
+        record.state = 'failed';
+        throw error;
+    }
+    finally {
+        clearInterval(heartbeat);
+        record.durationMs = Date.now() - started;
+        emit(context, record);
+    }
+}
+export function skippedOperationStage(stage, label) {
+    const context = storage.getStore();
+    if (!context)
+        return;
+    const record = { stage, label, state: 'skipped', startedAt: new Date().toISOString(), durationMs: 0 };
+    context.stages.push(record);
+    emit(context, record);
+}
+/** 平台仍是运行状态权威；此处只刷新本次观察的标题和运行指针。 */
+export function updateOperationStage(stage, label, details) {
+    const context = storage.getStore();
+    const record = context?.stages.slice().reverse().find(item => item.stage === stage && item.state === 'running');
+    if (!context || !record)
+        return;
+    record.label = label;
+    record.details = details;
+    record.durationMs = Date.now() - Date.parse(record.startedAt);
+    emit(context, record);
+}
+//# sourceMappingURL=operation-progress.js.map

package/dist/operation-progress.js.map

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

package/dist/workspace-operation.d.ts

@@ -0,0 +1,3 @@
+/** 本机工作区互斥；部署状态仍由平台持有。异常退出的锁由操作者确认进程退出后处理。 */
+export declare function withWorkspaceOperation<T>(root: string | undefined, operation: string, execute: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=workspace-operation.d.ts.map

package/dist/workspace-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-operation.d.ts","sourceRoot":"","sources":["../src/workspace-operation.ts"],"names":[],"mappings":"AAIA,8CAA8C;AAC9C,wBAAsB,sBAAsB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBlI"}

package/dist/workspace-operation.js

@@ -0,0 +1,45 @@
+import { randomUUID } from 'node:crypto';
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+/** 本机工作区互斥；部署状态仍由平台持有。异常退出的锁由操作者确认进程退出后处理。 */
+export async function withWorkspaceOperation(root, operation, execute) {
+    const directory = resolve(root || process.cwd(), '.openxiangda');
+    mkdirSync(directory, { recursive: true });
+    const path = resolve(directory, 'operation.lock');
+    const token = randomUUID();
+    let descriptor;
+    try {
+        descriptor = openSync(path, 'wx', 0o600);
+    }
+    catch (error) {
+        if (error.code === 'EEXIST') {
+            throw new Error(`WORKSPACE_OPERATION_BUSY: 工作区已有检查或部署持有 ${path}；等待其完成。异常退出时先确认锁中进程已退出，再移除锁文件`);
+        }
+        throw error;
+    }
+    try {
+        writeFileSync(descriptor, JSON.stringify({ pid: process.pid, token, operation, startedAt: new Date().toISOString() }));
+    }
+    catch (error) {
+        unlinkSync(path);
+        throw error;
+    }
+    finally {
+        closeSync(descriptor);
+    }
+    try {
+        return await execute();
+    }
+    finally {
+        if (existsSync(path)) {
+            let owner;
+            try {
+                owner = JSON.parse(readFileSync(path, 'utf8'));
+            }
+            catch { /* 无法识别的锁不自动删除。 */ }
+            if (owner?.token === token)
+                unlinkSync(path);
+        }
+    }
+}
+//# sourceMappingURL=workspace-operation.js.map

package/dist/workspace-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-operation.js","sourceRoot":"","sources":["../src/workspace-operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAI,IAAwB,EAAE,SAAiB,EAAE,OAAyB;IACpH,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IACjE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAAC,CAAC;IACjD,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,+BAA+B,CAAC,CAAC;QACjG,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IAC/H,OAAO,KAAK,EAAE,CAAC;QAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;YACxC,CAAC;QAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAAC,CAAC;IAClC,IAAI,CAAC;QAAC,OAAO,MAAM,OAAO,EAAE,CAAC;IAAC,CAAC;YACvB,CAAC;QACP,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,KAAqC,CAAC;YAC1C,IAAI,CAAC;gBAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YACpF,IAAI,KAAK,EAAE,KAAK,KAAK,KAAK;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "openxiangda-devkit-core",
-  "version": "2.0.0-alpha.114",
-  "description": "Framework-neutral OpenXiangda 2.0 workspace and control-plane use cases.",
+  "version": "2.0.0-alpha.117",
+  "description": "OpenXiangda 2.0 的编译、开发、检查、部署与中文资料服务。",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -32,7 +32,7 @@
   "dependencies": {
     "ajv": "8.20.0",
     "cron-parser": "5.4.0",
-    "openxiangda-contracts": "2.0.0-alpha.89",
+    "openxiangda-contracts": "2.0.0-alpha.91",
     "esbuild": "0.28.2",
     "typescript": "5.9.3",
     "undici": "6.28.0"