@inf-monkeys-tech/monkeys-cli 0.10.0

package/dist/data/perspective.js

@@ -0,0 +1,119 @@
+import { createHash } from 'node:crypto';
+import { Flags } from '@oclif/core';
+import { z } from 'zod';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+const sessionEnvelopeSchema = z
+    .object({
+    data: z.unknown().optional(),
+})
+    .passthrough();
+const sessionSurfaceSchema = z
+    .object({
+    authenticated: z.literal(true),
+    surfaces: z
+        .object({
+        kernel: z.boolean(),
+    })
+        .passthrough(),
+})
+    .passthrough();
+export const dataPerspectiveFlags = {
+    perspective: Flags.string({
+        options: ['kernel', 'studio'],
+        summary: '断言 Data 视角；不改变 Session 权限或服务端路由',
+    }),
+};
+export function parseDataPerspective(value) {
+    if (value === undefined || value === '')
+        return undefined;
+    if (value === 'kernel' || value === 'studio')
+        return value;
+    throw new CliError('--perspective 只接受 kernel 或 studio。', {
+        code: 'DATA_PERSPECTIVE_INVALID',
+        exitCode: EXIT_CODES.validation,
+        safeDetails: { requestState: 'not_sent' },
+    });
+}
+export function dataPerspectiveFingerprint(baseFingerprint, perspective) {
+    if (!perspective)
+        return baseFingerprint;
+    return createHash('sha256').update(`${baseFingerprint}\0data-perspective:${perspective}`, 'utf8').digest('hex');
+}
+export async function resolveSessionDataPerspective(client, requested) {
+    if (!requested)
+        return undefined;
+    const response = await client.request({ method: 'GET', path: '/api/auth/session' });
+    const envelope = sessionEnvelopeSchema.safeParse(response.data);
+    const value = envelope.success && envelope.data.data !== undefined ? envelope.data.data : response.data;
+    const session = sessionSurfaceSchema.safeParse(value);
+    if (!session.success) {
+        throw new CliError('无法从当前 Session 确认 Data 视角。', {
+            cause: session.error,
+            code: 'DATA_PERSPECTIVE_SESSION_INCOMPATIBLE',
+            exitCode: EXIT_CODES.compatibility,
+            safeDetails: { requestState: 'read_failed', requestedPerspective: requested },
+        });
+    }
+    const sessionPerspective = session.data.surfaces.kernel ? 'kernel' : 'studio';
+    if (requested === 'kernel' && sessionPerspective !== 'kernel') {
+        throw new CliError('当前账户没有 Kernel 管理权限，不能使用 Kernel Data 视角。', {
+            code: 'DATA_KERNEL_PERMISSION_REQUIRED',
+            exitCode: EXIT_CODES.authorization,
+            safeDetails: { requestState: 'not_sent', requestedPerspective: requested, sessionPerspective },
+        });
+    }
+    return sessionPerspective;
+}
+export function resolveOperationDataPerspective(requested, sessionPerspective, operation, availablePerspectives, route = 'session') {
+    if (!requested) {
+        return route === 'session'
+            ? { perspectiveSource: 'legacy-unverified' }
+            : { effectivePerspective: route, perspectiveSource: 'fixed-route' };
+    }
+    if (!availablePerspectives.includes(requested)) {
+        throw new CliError(`${operation} 不支持 ${requested} Data 视角。`, {
+            code: 'DATA_PERSPECTIVE_UNAVAILABLE',
+            exitCode: EXIT_CODES.authorization,
+            safeDetails: { availablePerspectives, operation, requestState: 'not_sent', requestedPerspective: requested },
+        });
+    }
+    if (!sessionPerspective) {
+        throw new CliError('显式 Data 视角缺少已确认的 Session 能力。', {
+            code: 'DATA_PERSPECTIVE_SESSION_INCOMPATIBLE',
+            exitCode: EXIT_CODES.compatibility,
+            safeDetails: { operation, requestState: 'not_sent', requestedPerspective: requested },
+        });
+    }
+    if (requested === 'kernel' && sessionPerspective !== 'kernel') {
+        throw new CliError('当前账户没有 Kernel 管理权限，不能使用 Kernel Data 视角。', {
+            code: 'DATA_KERNEL_PERMISSION_REQUIRED',
+            exitCode: EXIT_CODES.authorization,
+            safeDetails: {
+                availablePerspectives,
+                operation,
+                requestState: 'not_sent',
+                requestedPerspective: requested,
+                sessionPerspective,
+            },
+        });
+    }
+    if (route === 'session') {
+        if (requested === 'studio' && sessionPerspective === 'kernel') {
+            throw new CliError('当前 Kernel Session 会被现有 Server 路由到管理视角，不能强制声明为 Studio。', {
+                code: 'DATA_STUDIO_SESSION_REQUIRED',
+                exitCode: EXIT_CODES.authorization,
+                recovery: ['改用不含 Kernel 管理权限的账户/Profile，或使用固定 Studio 入口。'],
+                safeDetails: {
+                    availablePerspectives,
+                    operation,
+                    requestState: 'not_sent',
+                    requestedPerspective: requested,
+                    sessionPerspective,
+                },
+            });
+        }
+        return { effectivePerspective: sessionPerspective, perspectiveSource: 'session-scope' };
+    }
+    return { effectivePerspective: route, perspectiveSource: 'fixed-route' };
+}
+//# sourceMappingURL=perspective.js.map

package/dist/data/perspective.js.map

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

package/dist/data/policy.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedContext } from '../context/resolver.js';
+export declare function requireExactId(value: string, label: string): string;
+export declare function requireKernelContext(context: ResolvedContext): {
+    team: string;
+};
+export declare function requireBatchLimit<T>(items: T[], max: number): T[];
+export declare function throwIfPartialResult(value: unknown): void;
+//# sourceMappingURL=policy.d.ts.map

package/dist/data/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/data/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAW/E;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,CASjE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAgBzD"}

package/dist/data/policy.js

@@ -0,0 +1,48 @@
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+export function requireExactId(value, label) {
+    const normalized = value.trim();
+    if (!normalized || /[\s/\\]/.test(normalized)) {
+        throw new CliError(`${label} 必须是精确资源 ID。`, { code: 'DATA_RESOURCE_ID_INVALID', exitCode: EXIT_CODES.validation });
+    }
+    return normalized;
+}
+export function requireKernelContext(context) {
+    if (!context.expectedSurfaces.includes('kernel')) {
+        throw new CliError('该命令只允许显式声明 Kernel Surface 的 Profile。', {
+            code: 'KERNEL_PROFILE_REQUIRED',
+            exitCode: EXIT_CODES.authorization,
+        });
+    }
+    if (!context.team) {
+        throw new CliError('Kernel Data 治理必须显式指定 Team。', { code: 'KERNEL_TEAM_REQUIRED', exitCode: EXIT_CODES.validation });
+    }
+    return { team: context.team };
+}
+export function requireBatchLimit(items, max) {
+    if (!items.length || items.length > max) {
+        throw new CliError(`批量项目数必须在 1-${max} 之间。`, {
+            code: 'DATA_BATCH_LIMIT',
+            exitCode: EXIT_CODES.validation,
+            safeDetails: { count: items.length, max },
+        });
+    }
+    return items;
+}
+export function throwIfPartialResult(value) {
+    if (!value || typeof value !== 'object')
+        return;
+    const record = value;
+    const failures = record.failures ?? record.errors ?? record.failed;
+    const hasFailures = (Array.isArray(failures) && failures.length > 0) ||
+        (typeof failures === 'number' && failures > 0) ||
+        (Array.isArray(record.items) &&
+            record.items.some((item) => item && typeof item === 'object' && item.ok === false));
+    if (hasFailures) {
+        throw new CliError('Data 批量操作部分失败。', {
+            code: 'DATA_BATCH_PARTIAL',
+            exitCode: EXIT_CODES.partial,
+            safeDetails: { result: value },
+        });
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/data/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/data/policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAa;IACzD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,QAAQ,CAAC,GAAG,KAAK,cAAc,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;IACpH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAwB;IAC3D,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,QAAQ,CAAC,sCAAsC,EAAE;YACzD,IAAI,EAAE,yBAAyB;YAC/B,QAAQ,EAAE,UAAU,CAAC,aAAa;SACnC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,QAAQ,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;IACtH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAI,KAAU,EAAE,GAAW;IAC1D,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACxC,MAAM,IAAI,QAAQ,CAAC,cAAc,GAAG,MAAM,EAAE;YAC1C,IAAI,EAAE,kBAAkB;YACxB,QAAQ,EAAE,UAAU,CAAC,UAAU;YAC/B,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO;IAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;IACnE,MAAM,WAAW,GACf,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAChD,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,GAAG,CAAC,CAAC;QAC9C,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAK,IAAgC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC;IACrH,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE;YACnC,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,UAAU,CAAC,OAAO;YAC5B,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/data/resource-locator-types.d.ts

@@ -0,0 +1,10 @@
+export interface DataResourceLocator {
+    kind: 'ontology-resource-team';
+    ontologyId: string;
+    source: 'explicit-flag';
+    teamId: string;
+}
+export type DataResourceLocatorLocation = 'body' | 'query';
+export declare function dataResourceLocatorLocation(operation: string): DataResourceLocatorLocation | undefined;
+export declare function dataResourceLocatorFingerprint(baseFingerprint: string, locator: DataResourceLocator): string;
+//# sourceMappingURL=resource-locator-types.d.ts.map

package/dist/data/resource-locator-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-locator-types.d.ts","sourceRoot":"","sources":["../../src/data/resource-locator-types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,OAAO,CAAC;AAY3D,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS,CAEtG;AAED,wBAAgB,8BAA8B,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAI5G"}

package/dist/data/resource-locator-types.js

@@ -0,0 +1,19 @@
+import { createHash } from 'node:crypto';
+const READ_BINDINGS = new Map([
+    ['data.field.get', 'query'],
+    ['data.field.list', 'query'],
+    ['data.asset.search', 'body'],
+    ['data.asset.list', 'query'],
+    ['data.asset.next', 'query'],
+    ['data.value.get', 'body'],
+    ['data.view.tree', 'query'],
+]);
+export function dataResourceLocatorLocation(operation) {
+    return READ_BINDINGS.get(operation);
+}
+export function dataResourceLocatorFingerprint(baseFingerprint, locator) {
+    return createHash('sha256')
+        .update(`${baseFingerprint}\0data-resource-locator:${locator.kind}:${locator.source}:${locator.ontologyId}:${locator.teamId}`, 'utf8')
+        .digest('hex');
+}
+//# sourceMappingURL=resource-locator-types.js.map

package/dist/data/resource-locator-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-locator-types.js","sourceRoot":"","sources":["../../src/data/resource-locator-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAsC;IACjE,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAC3B,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAC5B,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAC7B,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAC5B,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAC5B,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC1B,CAAC,gBAAgB,EAAE,OAAO,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,UAAU,2BAA2B,CAAC,SAAiB;IAC3D,OAAO,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,eAAuB,EAAE,OAA4B;IAClG,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,eAAe,2BAA2B,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC;SACrI,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/data/resource-locator.d.ts

@@ -0,0 +1,7 @@
+import type { DataRuntime } from './command.js';
+import type { DataScope } from './scope.js';
+export declare const dataResourceTeamFlags: {
+    'resource-team': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare function prepareOntologyReadRuntime(runtime: DataRuntime, scope: DataScope, resourceTeam: string | undefined): DataRuntime;
+//# sourceMappingURL=resource-locator.d.ts.map

package/dist/data/resource-locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-locator.d.ts","sourceRoot":"","sources":["../../src/data/resource-locator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,qBAAqB;IAChC,eAAe;CAGhB,CAAC;AAWF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CA8DhI"}

package/dist/data/resource-locator.js

@@ -0,0 +1,61 @@
+import { Flags } from '@oclif/core';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { requireExactId } from './policy.js';
+import { dataResourceLocatorFingerprint } from './resource-locator-types.js';
+export const dataResourceTeamFlags = {
+    'resource-team': Flags.string({
+        summary: 'Kernel Ontology 数据资源定位 Team；不表示 Team 筛选，不能与 --team 同时使用',
+    }),
+};
+function notSent(code, message, safeDetails, recovery) {
+    return new CliError(message, {
+        code,
+        exitCode: EXIT_CODES.validation,
+        recovery,
+        safeDetails: { ...safeDetails, requestState: 'not_sent' },
+    });
+}
+export function prepareOntologyReadRuntime(runtime, scope, resourceTeam) {
+    const normalizedResourceTeam = resourceTeam === undefined ? undefined : requireExactId(resourceTeam, 'Resource Team');
+    if (normalizedResourceTeam && scope.kind !== 'ontology') {
+        throw notSent('DATA_RESOURCE_TEAM_NOT_APPLICABLE', '--resource-team 只支持精确 Ontology 作用域，旧 Bucket 兼容命令继续使用 --team。', { dataScopeKind: scope.kind }, ['改用 --ontology <Ontology ID>，或在旧 Bucket 命令中使用 --team。']);
+    }
+    if (normalizedResourceTeam && runtime.dataPerspective !== 'kernel') {
+        throw notSent('DATA_RESOURCE_TEAM_NOT_APPLICABLE', '--resource-team 只用于显式 Kernel Ontology 读取；Studio 使用 --team 上下文。', { requestedPerspective: runtime.dataPerspective ?? 'legacy' }, ['Kernel 读取请显式传 --perspective kernel；Studio 读取请移除 --resource-team 并使用 --team。']);
+    }
+    if (normalizedResourceTeam && runtime.context.team) {
+        throw notSent('DATA_TEAM_ROLE_CONFLICT', '--team 与 --resource-team 表示不同角色，当前请求不能同时使用。', { requestedPerspective: runtime.dataPerspective }, ['Kernel 全局资源读取保留 --resource-team 并移除 --team；显式 Team 筛选则保留 --team 并移除 --resource-team。']);
+    }
+    if (runtime.dataPerspective !== 'kernel' || runtime.teamMode !== 'none')
+        return runtime;
+    if (scope.kind !== 'ontology')
+        return runtime;
+    if (!normalizedResourceTeam) {
+        throw notSent('DATA_RESOURCE_TEAM_REQUIRED', '当前 Kernel Ontology 读取需要显式的数据资源 Team。', { ontologyId: scope.id }, [
+            '确认目标 Ontology 的 data resource Team 后传入 --resource-team <Team ID>；不要使用 Ontology owner Team 猜测。',
+        ]);
+    }
+    if (runtime.resourceLocator) {
+        if (runtime.resourceLocator.ontologyId === scope.id && runtime.resourceLocator.teamId === normalizedResourceTeam)
+            return runtime;
+        throw notSent('DATA_RESOURCE_TEAM_SCOPE_MISMATCH', '当前 Data Runtime 已绑定到不同的 Ontology 或 Resource Team。', {
+            actualOntologyId: runtime.resourceLocator.ontologyId,
+            expectedOntologyId: scope.id,
+        }, ['为每个 Ontology 和 Resource Team 使用独立命令调用。']);
+    }
+    const locator = {
+        kind: 'ontology-resource-team',
+        ontologyId: scope.id,
+        source: 'explicit-flag',
+        teamId: normalizedResourceTeam,
+    };
+    return {
+        ...runtime,
+        context: {
+            ...runtime.context,
+            fingerprint: dataResourceLocatorFingerprint(runtime.context.fingerprint, locator),
+        },
+        resourceLocator: locator,
+    };
+}
+//# sourceMappingURL=resource-locator.js.map

package/dist/data/resource-locator.js.map

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

package/dist/data/scope.d.ts

@@ -0,0 +1,38 @@
+import type { DataContractVariant } from './contract-variant.js';
+export declare const dataScopeFlags: {
+    perspective: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    bucket: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    ontology: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export interface DataScopeInput {
+    bucket?: string;
+    ontology?: string;
+}
+export declare function dataScopeInput(ontology: string | undefined, bucket: string | undefined): DataScopeInput;
+export interface DataScope {
+    id: string;
+    kind: 'legacy-bucket' | 'ontology';
+    variant: DataContractVariant;
+}
+export declare function requireDataScopeInput(input: DataScopeInput): {
+    deprecatedBucketFlag: boolean;
+    id: string;
+};
+export declare function createDataScope(input: DataScopeInput, variant: DataContractVariant): DataScope & {
+    deprecatedBucketFlag: boolean;
+};
+export declare function dataScopeKey(scope: DataScope): 'bucketId' | 'ontologyId';
+export declare function dataScopeMeta(scope: DataScope & {
+    deprecatedBucketFlag?: boolean;
+}): {
+    dataScope: {
+        id: string;
+        kind: "legacy-bucket" | "ontology";
+    };
+    deprecation?: {
+        flag: string;
+        replacement: string;
+        schemaMajor: number;
+    };
+};
+//# sourceMappingURL=scope.d.ts.map

package/dist/data/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/data/scope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIjE,eAAO,MAAM,cAAc;;;;CAI1B,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAKvG;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,GAAG,UAAU,CAAC;IACnC,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG;IAAE,oBAAoB,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAe1G;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,mBAAmB,GAAG,SAAS,GAAG;IAAE,oBAAoB,EAAE,OAAO,CAAA;CAAE,CAOlI;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,CAExE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE;;QAElE,EAAE;QAAY,IAAI;;;QACmB,IAAI;QAAc,WAAW;QAAgB,WAAW;;EAE7G"}

package/dist/data/scope.js

@@ -0,0 +1,49 @@
+import { Flags } from '@oclif/core';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { requireExactId } from './policy.js';
+import { dataPerspectiveFlags } from './perspective.js';
+export const dataScopeFlags = {
+    ...dataPerspectiveFlags,
+    bucket: Flags.string({ summary: '旧 Bucket ID（已弃用；新任务使用 --ontology）' }),
+    ontology: Flags.string({ summary: 'Ontology ID' }),
+};
+export function dataScopeInput(ontology, bucket) {
+    return {
+        ...(bucket ? { bucket } : {}),
+        ...(ontology ? { ontology } : {}),
+    };
+}
+export function requireDataScopeInput(input) {
+    if (input.bucket && input.ontology) {
+        throw new CliError('--ontology 与已弃用的 --bucket 不能同时使用。', {
+            code: 'DATA_SCOPE_CONFLICT',
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+    const value = input.ontology ?? input.bucket;
+    if (!value) {
+        throw new CliError('Data 操作必须显式指定 --ontology。旧部署可暂时使用 --bucket。', {
+            code: 'DATA_SCOPE_REQUIRED',
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+    return { deprecatedBucketFlag: input.ontology === undefined, id: requireExactId(value, input.ontology ? 'Ontology' : 'Bucket') };
+}
+export function createDataScope(input, variant) {
+    const resolved = requireDataScopeInput(input);
+    return {
+        ...resolved,
+        kind: variant === 'ontology-v1' ? 'ontology' : 'legacy-bucket',
+        variant,
+    };
+}
+export function dataScopeKey(scope) {
+    return scope.variant === 'ontology-v1' ? 'ontologyId' : 'bucketId';
+}
+export function dataScopeMeta(scope) {
+    return {
+        dataScope: { id: scope.id, kind: scope.kind },
+        ...(scope.deprecatedBucketFlag ? { deprecation: { flag: '--bucket', replacement: '--ontology', schemaMajor: 1 } } : {}),
+    };
+}
+//# sourceMappingURL=scope.js.map

package/dist/data/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/data/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,oBAAoB;IACvB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;IACtE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;CACnD,CAAC;AAOF,MAAM,UAAU,cAAc,CAAC,QAA4B,EAAE,MAA0B;IACrF,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACzD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,QAAQ,CAAC,mCAAmC,EAAE;YACtD,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,UAAU,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAAC,6CAA6C,EAAE;YAChE,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,UAAU,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,oBAAoB,EAAE,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,EAAE,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;AACnI,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAqB,EAAE,OAA4B;IACjF,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe;QAC9D,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,OAAO,KAAK,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAqD;IACjF,OAAO;QACL,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;QAC7C,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxH,CAAC;AACJ,CAAC"}

package/dist/data/tree.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeTreeNodes(value: unknown, label?: string): unknown[];
+//# sourceMappingURL=tree.d.ts.map

package/dist/data/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/data/tree.ts"],"names":[],"mappings":"AAUA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAc,GAAG,OAAO,EAAE,CAmBjF"}

package/dist/data/tree.js

@@ -0,0 +1,34 @@
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+function objectValue(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function emptyEnvelope(record) {
+    return Object.keys(record).length === 0;
+}
+export function normalizeTreeNodes(value, label = 'View Tree') {
+    let current = value;
+    const visited = new Set();
+    for (let depth = 0; depth < 16; depth += 1) {
+        if (Array.isArray(current))
+            return current;
+        if (current === undefined || current === null)
+            return [];
+        const record = objectValue(current);
+        if (!record)
+            break;
+        if (visited.has(record))
+            break;
+        visited.add(record);
+        if (emptyEnvelope(record))
+            return [];
+        const key = ['tree', 'items', 'data'].find((candidate) => Object.hasOwn(record, candidate));
+        if (!key)
+            break;
+        current = record[key];
+    }
+    throw new CliError(`${label} 响应结构无法识别，拒绝把非空响应当作空树。`, {
+        code: 'DATA_TREE_RESPONSE_INCOMPATIBLE',
+        exitCode: EXIT_CODES.compatibility,
+    });
+}
+//# sourceMappingURL=tree.js.map

package/dist/data/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../src/data/tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE9D,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtH,CAAC;AAED,SAAS,aAAa,CAAC,MAA+B;IACpD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,KAAK,GAAG,WAAW;IACpE,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QAC3C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,MAAM;QACnB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,MAAM;QAC/B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,IAAI,aAAa,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;QAC5F,IAAI,CAAC,GAAG;YAAE,MAAM;QAChB,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,GAAG,KAAK,wBAAwB,EAAE;QACnD,IAAI,EAAE,iCAAiC;QACvC,QAAQ,EAAE,UAAU,CAAC,aAAa;KACnC,CAAC,CAAC;AACL,CAAC"}

package/dist/data/view-rows.d.ts

@@ -0,0 +1,38 @@
+import { type DataCallResult } from './client.js';
+import type { DataRuntime } from './command.js';
+import type { DataScope } from './scope.js';
+type ViewRowColumnKind = 'base' | 'feature' | 'property' | 'tag-group';
+export interface ViewRowColumn {
+    downloadable?: boolean;
+    key: string;
+    kind: ViewRowColumnKind;
+    label: string;
+    sourceId: string;
+    valueType: string;
+}
+export interface ViewRow {
+    assetId: string;
+    cells: Record<string, unknown>;
+}
+export interface ReadViewRowsResult {
+    binding: DataCallResult['binding'];
+    columnSource: 'field-list-fallback' | 'view-config';
+    columns: ViewRowColumn[];
+    nextToken?: string;
+    requestIds: string[];
+    rows: ViewRow[];
+    total?: number;
+    view: {
+        id: string;
+        name: string;
+        path?: string;
+        viewType?: string;
+    };
+}
+export declare function readViewRows(runtime: DataRuntime, scope: DataScope, input: {
+    limit: number;
+    pageToken?: string;
+    viewId: string;
+}): Promise<ReadViewRowsResult>;
+export {};
+//# sourceMappingURL=view-rows.d.ts.map

package/dist/data/view-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-rows.d.ts","sourceRoot":"","sources":["../../src/data/view-rows.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,KAAK,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,YAAY,EAAE,qBAAqB,GAAG,aAAa,CAAC;IACpD,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAgOD,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,kBAAkB,CAAC,CAwI7B"}