@inf-monkeys-tech/monkeys-cli 0.10.6 → 0.11.1

package/dist/data/cursor.js

@@ -3,20 +3,23 @@ import { CliError, EXIT_CODES } from '../errors/cli-error.js';
 export function dataQueryFingerprint(input) {
     return createHash('sha256').update(JSON.stringify(input)).digest('hex');
 }
-export function encodeDataCursor(token, fingerprint) {
+export function encodeDataCursor(token, fingerprint, perspective) {
     if (!token)
         return undefined;
-    return Buffer.from(JSON.stringify({ fingerprint, token, v: 1 })).toString('base64url');
+    return Buffer.from(JSON.stringify({ fingerprint, ...(perspective ? { perspective } : {}), token, v: 2 })).toString('base64url');
 }
-export function decodeDataCursor(cursor, fingerprint) {
+export function decodeDataCursorState(cursor, fingerprint) {
     if (!cursor)
-        return undefined;
+        return {};
     try {
         const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
-        if (parsed.v !== 1 || !parsed.token || parsed.fingerprint !== fingerprint) {
+        if ((parsed.v !== 1 && parsed.v !== 2) || !parsed.token || parsed.fingerprint !== fingerprint) {
             throw new Error('cursor mismatch');
         }
-        return parsed.token;
+        if (parsed.perspective !== undefined && parsed.perspective !== 'kernel' && parsed.perspective !== 'studio') {
+            throw new Error('cursor perspective mismatch');
+        }
+        return { ...(parsed.perspective ? { perspective: parsed.perspective } : {}), token: parsed.token };
     }
     catch (cause) {
         throw new CliError('Data Cursor does not match the current Context or query criteria.', {
@@ -26,4 +29,7 @@ export function decodeDataCursor(cursor, fingerprint) {
         });
     }
 }
+export function decodeDataCursor(cursor, fingerprint) {
+    return decodeDataCursorState(cursor, fingerprint).token;
+}
 //# sourceMappingURL=cursor.js.map

package/dist/data/cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/data/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAQ9D,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAyB,EAAE,WAAmB;IAC7E,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAA0B,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA0B,EAAE,WAAmB;IAC9E,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAkB,CAAC;QAC9F,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,mEAAmE,EAAE;YACtF,KAAK;YACL,IAAI,EAAE,sBAAsB;YAC5B,QAAQ,EAAE,UAAU,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/data/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAS9D,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAyB,EAAE,WAAmB,EAAE,WAAiC;IAChH,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAA0B,CAAC,CAC9G,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAA0B,EAC1B,WAAmB;IAEnB,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAkB,CAAC;QAC9F,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YAC9F,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC3G,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACrG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,mEAAmE,EAAE;YACtF,KAAK;YACL,IAAI,EAAE,sBAAsB;YAC5B,QAAQ,EAAE,UAAU,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA0B,EAAE,WAAmB;IAC9E,OAAO,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC"}

package/dist/data/kernel-bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernel-bindings.d.ts","sourceRoot":"","sources":["../../src/data/kernel-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AA+CD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAG/H"}
+{"version":3,"file":"kernel-bindings.d.ts","sourceRoot":"","sources":["../../src/data/kernel-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAgDD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAG/H"}

package/dist/data/kernel-bindings.js

@@ -5,6 +5,7 @@ const KERNEL_ONTOLOGY_V1_BINDINGS = {
     'data.asset.list': { method: 'GET', pathTemplate: '/api/kernel/data-v2' },
     'data.asset.listNextPage': { method: 'GET', pathTemplate: '/api/kernel/data-v2/nextpage' },
     'data.asset.next': { method: 'GET', pathTemplate: '/api/kernel/data-v2/nextpage' },
+    'data.asset.search': { method: 'POST', pathTemplate: '/api/kernel/data-v2/search/advanced' },
     'data.asset.update': { method: 'PUT', pathTemplate: '/api/kernel/data-v2/{assetId}' },
     'data.container.copy': { method: 'POST', pathTemplate: '/api/kernel/data-v2/views/{viewId}/assets/{assetId}/copy' },
     'data.container.move': { method: 'PUT', pathTemplate: '/api/kernel/data-v2/views/{viewId}/assets/{assetId}' },

package/dist/data/kernel-bindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"kernel-bindings.js","sourceRoot":"","sources":["../../src/data/kernel-bindings.ts"],"names":[],"mappings":"AAOA,MAAM,2BAA2B,GAAgD;IAC/E,mBAAmB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,qBAAqB,EAAE;IAC5E,mBAAmB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,+BAA+B,EAAE;IACxF,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,+BAA+B,EAAE;IAClF,iBAAiB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE;IACzE,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,8BAA8B,EAAE;IAC1F,iBAAiB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,8BAA8B,EAAE;IAClF,mBAAmB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,+BAA+B,EAAE;IACrF,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,0DAA0D,EAAE;IACnH,qBAAqB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,qDAAqD,EAAE;IAC7G,uBAAuB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,qDAAqD,EAAE;IAClH,2BAA2B,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,iCAAiC,EAAE;IAC/F,gCAAgC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,0CAA0C,EAAE;IAC7G,8BAA8B,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,kDAAkD,EAAE;IACpH,mBAAmB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,qCAAqC,EAAE;IAC5F,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,+CAA+C,EAAE;IAClG,iBAAiB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,qCAAqC,EAAE;IACzF,mBAAmB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,+CAA+C,EAAE;IACrG,sBAAsB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,gCAAgC,EAAE;IAC1F,mBAAmB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,6CAA6C,EAAE;IACnG,oBAAoB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,gCAAgC,EAAE;IACvF,sBAAsB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,6CAA6C,EAAE;IACtG,wBAAwB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,6CAA6C,EAAE;IACzG,uBAAuB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,gCAAgC,EAAE;IAC3F,uBAAuB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,0CAA0C,EAAE;IACvG,oBAAoB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,0CAA0C,EAAE;IACjG,qBAAqB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,gCAAgC,EAAE;IACxF,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,+CAA+C,EAAE;IAC3G,uBAAuB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,0CAA0C,EAAE;IACpG,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,0BAA0B,EAAE;IAC/E,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,kCAAkC,EAAE;IACzF,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,gCAAgC,EAAE;IAClF,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,0BAA0B,EAAE;IAC5E,iBAAiB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,kCAAkC,EAAE;IACtF,sBAAsB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,iDAAiD,EAAE;IAC3G,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,iDAAiD,EAAE;IAC1G,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,0CAA0C,EAAE;IAC9F,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,wDAAwD,EAAE;IAC3G,gCAAgC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,yDAAyD,EAAE;IAC7H,kBAAkB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,2BAA2B,EAAE;IACjF,kBAAkB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,oCAAoC,EAAE;IAC5F,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,gCAAgC,EAAE;IACnF,kBAAkB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,oCAAoC,EAAE;CAC1F,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,SAAiB,EAAE,OAAoC;IAC9F,IAAI,OAAO,KAAK,aAAa;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,2BAA2B,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"kernel-bindings.js","sourceRoot":"","sources":["../../src/data/kernel-bindings.ts"],"names":[],"mappings":"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"}

package/dist/data/ontology-command.d.ts

@@ -18,8 +18,16 @@ export declare function listOntologies(options: BaseOptions & {
     effectiveTeamId?: string;
     resourceLocator?: import("./resource-locator-types.js").DataResourceLocator;
     effectivePerspective?: "kernel" | "studio";
-    perspectiveSource: "fixed-route" | "legacy-unverified" | "session-scope";
-    requestedPerspective: string;
+    perspectiveResolution?: {
+        attempts: Array<{
+            outcome: 'empty' | 'not_found' | 'success';
+            perspective: 'kernel' | 'studio';
+        }>;
+        fallbackReason?: 'studio_empty' | 'studio_not_found';
+        policy: 'explicit' | 'fixed-route' | 'studio-first';
+    };
+    perspectiveSource: "explicit" | "fixed-route" | "studio-first";
+    requestedPerspective: import("./perspective.js").DataPerspectiveRequest;
     schemaFresh: boolean;
     schemaSource: string;
     teamMode: import("./command.js").DataTeamMode;
@@ -47,8 +55,16 @@ export declare function listOntologies(options: BaseOptions & {
     effectiveTeamId?: string;
     resourceLocator?: import("./resource-locator-types.js").DataResourceLocator;
     effectivePerspective?: "kernel" | "studio";
-    perspectiveSource: "fixed-route" | "legacy-unverified" | "session-scope";
-    requestedPerspective: string;
+    perspectiveResolution?: {
+        attempts: Array<{
+            outcome: 'empty' | 'not_found' | 'success';
+            perspective: 'kernel' | 'studio';
+        }>;
+        fallbackReason?: 'studio_empty' | 'studio_not_found';
+        policy: 'explicit' | 'fixed-route' | 'studio-first';
+    };
+    perspectiveSource: "explicit" | "fixed-route" | "studio-first";
+    requestedPerspective: import("./perspective.js").DataPerspectiveRequest;
     schemaFresh: boolean;
     schemaSource: string;
     teamMode: import("./command.js").DataTeamMode;
@@ -69,8 +85,16 @@ export declare function getOntology(options: BaseOptions & {
     effectiveTeamId?: string;
     resourceLocator?: import("./resource-locator-types.js").DataResourceLocator;
     effectivePerspective?: "kernel" | "studio";
-    perspectiveSource: "fixed-route" | "legacy-unverified" | "session-scope";
-    requestedPerspective: string;
+    perspectiveResolution?: {
+        attempts: Array<{
+            outcome: 'empty' | 'not_found' | 'success';
+            perspective: 'kernel' | 'studio';
+        }>;
+        fallbackReason?: 'studio_empty' | 'studio_not_found';
+        policy: 'explicit' | 'fixed-route' | 'studio-first';
+    };
+    perspectiveSource: "explicit" | "fixed-route" | "studio-first";
+    requestedPerspective: import("./perspective.js").DataPerspectiveRequest;
     schemaFresh: boolean;
     schemaSource: string;
     teamMode: import("./command.js").DataTeamMode;
@@ -97,8 +121,16 @@ export declare function getOntology(options: BaseOptions & {
     effectiveTeamId?: string;
     resourceLocator?: import("./resource-locator-types.js").DataResourceLocator;
     effectivePerspective?: "kernel" | "studio";
-    perspectiveSource: "fixed-route" | "legacy-unverified" | "session-scope";
-    requestedPerspective: string;
+    perspectiveResolution?: {
+        attempts: Array<{
+            outcome: 'empty' | 'not_found' | 'success';
+            perspective: 'kernel' | 'studio';
+        }>;
+        fallbackReason?: 'studio_empty' | 'studio_not_found';
+        policy: 'explicit' | 'fixed-route' | 'studio-first';
+    };
+    perspectiveSource: "explicit" | "fixed-route" | "studio-first";
+    requestedPerspective: import("./perspective.js").DataPerspectiveRequest;
     schemaFresh: boolean;
     schemaSource: string;
     teamMode: import("./command.js").DataTeamMode;
@@ -118,8 +150,16 @@ export declare function createOntology(options: BaseOptions & {
     effectiveTeamId?: string;
     resourceLocator?: import("./resource-locator-types.js").DataResourceLocator;
     effectivePerspective?: "kernel" | "studio";
-    perspectiveSource: "fixed-route" | "legacy-unverified" | "session-scope";
-    requestedPerspective: string;
+    perspectiveResolution?: {
+        attempts: Array<{
+            outcome: 'empty' | 'not_found' | 'success';
+            perspective: 'kernel' | 'studio';
+        }>;
+        fallbackReason?: 'studio_empty' | 'studio_not_found';
+        policy: 'explicit' | 'fixed-route' | 'studio-first';
+    };
+    perspectiveSource: "explicit" | "fixed-route" | "studio-first";
+    requestedPerspective: import("./perspective.js").DataPerspectiveRequest;
     schemaFresh: boolean;
     schemaSource: string;
     teamMode: import("./command.js").DataTeamMode;
@@ -147,8 +187,16 @@ export declare function createOntology(options: BaseOptions & {
     effectiveTeamId?: string;
     resourceLocator?: import("./resource-locator-types.js").DataResourceLocator;
     effectivePerspective?: "kernel" | "studio";
-    perspectiveSource: "fixed-route" | "legacy-unverified" | "session-scope";
-    requestedPerspective: string;
+    perspectiveResolution?: {
+        attempts: Array<{
+            outcome: 'empty' | 'not_found' | 'success';
+            perspective: 'kernel' | 'studio';
+        }>;
+        fallbackReason?: 'studio_empty' | 'studio_not_found';
+        policy: 'explicit' | 'fixed-route' | 'studio-first';
+    };
+    perspectiveSource: "explicit" | "fixed-route" | "studio-first";
+    requestedPerspective: import("./perspective.js").DataPerspectiveRequest;
     schemaFresh: boolean;
     schemaSource: string;
     teamMode: import("./command.js").DataTeamMode;
@@ -170,8 +218,16 @@ export declare function updateOntology(options: BaseOptions & {
     effectiveTeamId?: string;
     resourceLocator?: import("./resource-locator-types.js").DataResourceLocator;
     effectivePerspective?: "kernel" | "studio";
-    perspectiveSource: "fixed-route" | "legacy-unverified" | "session-scope";
-    requestedPerspective: string;
+    perspectiveResolution?: {
+        attempts: Array<{
+            outcome: 'empty' | 'not_found' | 'success';
+            perspective: 'kernel' | 'studio';
+        }>;
+        fallbackReason?: 'studio_empty' | 'studio_not_found';
+        policy: 'explicit' | 'fixed-route' | 'studio-first';
+    };
+    perspectiveSource: "explicit" | "fixed-route" | "studio-first";
+    requestedPerspective: import("./perspective.js").DataPerspectiveRequest;
     schemaFresh: boolean;
     schemaSource: string;
     teamMode: import("./command.js").DataTeamMode;
@@ -200,8 +256,16 @@ export declare function updateOntology(options: BaseOptions & {
     effectiveTeamId?: string;
     resourceLocator?: import("./resource-locator-types.js").DataResourceLocator;
     effectivePerspective?: "kernel" | "studio";
-    perspectiveSource: "fixed-route" | "legacy-unverified" | "session-scope";
-    requestedPerspective: string;
+    perspectiveResolution?: {
+        attempts: Array<{
+            outcome: 'empty' | 'not_found' | 'success';
+            perspective: 'kernel' | 'studio';
+        }>;
+        fallbackReason?: 'studio_empty' | 'studio_not_found';
+        policy: 'explicit' | 'fixed-route' | 'studio-first';
+    };
+    perspectiveSource: "explicit" | "fixed-route" | "studio-first";
+    requestedPerspective: import("./perspective.js").DataPerspectiveRequest;
     schemaFresh: boolean;
     schemaSource: string;
     teamMode: import("./command.js").DataTeamMode;

package/dist/data/ontology-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ontology-command.d.ts","sourceRoot":"","sources":["../../src/data/ontology-command.ts"],"names":[],"mappings":"AAKA,UAAU,WAAW;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAMD,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;QAH9E,OAAO;QAAiB,WAAW;QAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;GAoBvG;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;QAtBhC,OAAO;QAAiB,WAAW;QAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCvG;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;;;;;;;;;;;;;;;;;QAvCvD,OAAO;QAAiB,WAAW;QAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDvG;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;;;;;;;;;;;;;;;;;QAvDnE,OAAO;QAAiB,WAAW;QAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EvG"}
+{"version":3,"file":"ontology-command.d.ts","sourceRoot":"","sources":["../../src/data/ontology-command.ts"],"names":[],"mappings":"AAKA,UAAU,WAAW;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAMD,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAH9E,OAAO;QAAiB,WAAW;QAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoBvG;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;QAtBhC,OAAO;QAAiB,WAAW;QAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCvG;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;QAvCvD,OAAO;QAAiB,WAAW;QAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDvG;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;QAvDnE,OAAO;QAAiB,WAAW;QAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EvG"}

package/dist/data/perspective.d.ts

@@ -1,15 +1,20 @@
 import type { HttpClient } from '../transport/http-client.js';
 export type DataPerspective = 'kernel' | 'studio';
+export type DataPerspectiveRequest = DataPerspective | 'auto';
 export type DataPerspectiveRoute = 'kernel' | 'session' | 'studio';
-export type DataPerspectiveSource = 'fixed-route' | 'legacy-unverified' | 'session-scope';
+export type DataPerspectiveSource = 'explicit' | 'fixed-route' | 'studio-first';
+export interface DataSessionSurfaces {
+    kernel: boolean;
+    studio: boolean;
+}
 export declare const dataPerspectiveFlags: {
     perspective: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
 };
 export declare function parseDataPerspective(value?: string): DataPerspective | undefined;
-export declare function dataPerspectiveFingerprint(baseFingerprint: string, perspective?: DataPerspective): string;
-export declare function resolveSessionDataPerspective(client: HttpClient, requested?: DataPerspective): Promise<DataPerspective | undefined>;
-export declare function resolveOperationDataPerspective(requested: DataPerspective | undefined, sessionPerspective: DataPerspective | undefined, operation: string, availablePerspectives: DataPerspective[], route?: DataPerspectiveRoute): {
-    effectivePerspective?: DataPerspective;
+export declare function dataPerspectiveFingerprint(baseFingerprint: string, perspective: DataPerspectiveRequest): string;
+export declare function resolveSessionDataSurfaces(client: HttpClient, requested: DataPerspectiveRequest): Promise<DataSessionSurfaces>;
+export declare function resolveOperationDataPerspective(requested: DataPerspectiveRequest, sessionSurfaces: DataSessionSurfaces, operation: string, availablePerspectives: DataPerspective[], route?: DataPerspectiveRoute): {
+    effectivePerspective: DataPerspective;
     perspectiveSource: DataPerspectiveSource;
 };
 //# sourceMappingURL=perspective.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"perspective.d.ts","sourceRoot":"","sources":["../../src/data/perspective.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AACnE,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAkB1F,eAAO,MAAM,oBAAoB;IAC/B,WAAW;CAIZ,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAQhF;AAED,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,GAAG,MAAM,CAGzG;AAED,wBAAsB,6BAA6B,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAuBzI;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,eAAe,GAAG,SAAS,EACtC,kBAAkB,EAAE,eAAe,GAAG,SAAS,EAC/C,SAAS,EAAE,MAAM,EACjB,qBAAqB,EAAE,eAAe,EAAE,EACxC,KAAK,GAAE,oBAAgC,GACtC;IAAE,oBAAoB,CAAC,EAAE,eAAe,CAAC;IAAC,iBAAiB,EAAE,qBAAqB,CAAA;CAAE,CAwDtF"}
+{"version":3,"file":"perspective.d.ts","sourceRoot":"","sources":["../../src/data/perspective.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,MAAM,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AACnE,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,aAAa,GAAG,cAAc,CAAC;AAChF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAmBD,eAAO,MAAM,oBAAoB;IAC/B,WAAW;CAIZ,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAQhF;AAED,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,GAAG,MAAM,CAE/G;AAMD,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6BpI;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,sBAAsB,EACjC,eAAe,EAAE,mBAAmB,EACpC,SAAS,EAAE,MAAM,EACjB,qBAAqB,EAAE,eAAe,EAAE,EACxC,KAAK,GAAE,oBAAgC,GACtC;IAAE,oBAAoB,EAAE,eAAe,CAAC;IAAC,iBAAiB,EAAE,qBAAqB,CAAA;CAAE,CAuCrF"}

package/dist/data/perspective.js

@@ -13,6 +13,7 @@ const sessionSurfaceSchema = z
     surfaces: z
         .object({
         kernel: z.boolean(),
+        studio: z.boolean(),
     })
         .passthrough(),
 })
@@ -20,7 +21,7 @@ const sessionSurfaceSchema = z
 export const dataPerspectiveFlags = {
     perspective: Flags.string({
         options: ['kernel', 'studio'],
-        summary: 'Asserts the Data perspective; does not change Session permissions or server-side routing',
+        summary: 'Use only this Data perspective; when omitted, read queries use Studio first and may fall back to Kernel',
     }),
 };
 export function parseDataPerspective(value) {
@@ -35,85 +36,77 @@ export function parseDataPerspective(value) {
     });
 }
 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;
+function hasSurface(surfaces, perspective) {
+    return surfaces[perspective];
+}
+export async function resolveSessionDataSurfaces(client, requested) {
     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('Unable to confirm Data perspective from current Session.', {
+        throw new CliError('Unable to confirm Data perspectives from current Session.', {
             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('The current account does not have Kernel management rights and cannot use the Kernel Data perspective.', {
-            code: 'DATA_KERNEL_PERMISSION_REQUIRED',
+    const surfaces = session.data.surfaces;
+    if (!surfaces.studio && !surfaces.kernel) {
+        throw new CliError('The current account has neither Studio nor Kernel Data access.', {
+            code: 'DATA_PERSPECTIVE_PERMISSION_REQUIRED',
             exitCode: EXIT_CODES.authorization,
-            safeDetails: { requestState: 'not_sent', requestedPerspective: requested, sessionPerspective },
+            safeDetails: { requestState: 'not_sent', requestedPerspective: requested, sessionSurfaces: surfaces },
         });
     }
-    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} does not support the ${requested} Data perspective.`, {
-            code: 'DATA_PERSPECTIVE_UNAVAILABLE',
+    if (requested !== 'auto' && !hasSurface(surfaces, requested)) {
+        throw new CliError(`The current account does not have ${requested === 'kernel' ? 'Kernel management rights' : 'Studio access'}.`, {
+            code: requested === 'kernel' ? 'DATA_KERNEL_PERMISSION_REQUIRED' : 'DATA_STUDIO_PERMISSION_REQUIRED',
             exitCode: EXIT_CODES.authorization,
-            safeDetails: { availablePerspectives, operation, requestState: 'not_sent', requestedPerspective: requested },
+            safeDetails: { requestState: 'not_sent', requestedPerspective: requested, sessionSurfaces: surfaces },
         });
     }
-    if (!sessionPerspective) {
-        throw new CliError('The explicit Data perspective lacks confirmed Session capabilities.', {
-            code: 'DATA_PERSPECTIVE_SESSION_INCOMPATIBLE',
-            exitCode: EXIT_CODES.compatibility,
-            safeDetails: { operation, requestState: 'not_sent', requestedPerspective: requested },
-        });
-    }
-    if (requested === 'kernel' && sessionPerspective !== 'kernel') {
-        throw new CliError('The current account does not have Kernel management rights and cannot use the Kernel Data perspective.', {
-            code: 'DATA_KERNEL_PERMISSION_REQUIRED',
-            exitCode: EXIT_CODES.authorization,
-            safeDetails: {
-                availablePerspectives,
-                operation,
-                requestState: 'not_sent',
-                requestedPerspective: requested,
-                sessionPerspective,
-            },
-        });
+    return surfaces;
+}
+export function resolveOperationDataPerspective(requested, sessionSurfaces, operation, availablePerspectives, route = 'session') {
+    if (requested !== 'auto') {
+        if (!availablePerspectives.includes(requested)) {
+            throw new CliError(`${operation} does not support the ${requested} Data perspective.`, {
+                code: 'DATA_PERSPECTIVE_UNAVAILABLE',
+                exitCode: EXIT_CODES.authorization,
+                safeDetails: { availablePerspectives, operation, requestState: 'not_sent', requestedPerspective: requested },
+            });
+        }
+        if (!hasSurface(sessionSurfaces, requested)) {
+            throw new CliError(`The current account does not have ${requested === 'kernel' ? 'Kernel management rights' : 'Studio access'}.`, {
+                code: requested === 'kernel' ? 'DATA_KERNEL_PERMISSION_REQUIRED' : 'DATA_STUDIO_PERMISSION_REQUIRED',
+                exitCode: EXIT_CODES.authorization,
+                safeDetails: { availablePerspectives, operation, requestState: 'not_sent', requestedPerspective: requested, sessionSurfaces },
+            });
+        }
+        return { effectivePerspective: requested, perspectiveSource: 'explicit' };
     }
-    if (route === 'session') {
-        if (requested === 'studio' && sessionPerspective === 'kernel') {
-            throw new CliError('The current Server routes this Kernel Session to the management perspective, so it cannot be forced to Studio.', {
-                code: 'DATA_STUDIO_SESSION_REQUIRED',
+    if (route !== 'session') {
+        if (!availablePerspectives.includes(route) || !hasSurface(sessionSurfaces, route)) {
+            throw new CliError(`The current account cannot use the ${route} perspective required by ${operation}.`, {
+                code: route === 'kernel' ? 'DATA_KERNEL_PERMISSION_REQUIRED' : 'DATA_STUDIO_PERMISSION_REQUIRED',
                 exitCode: EXIT_CODES.authorization,
-                recovery: ['Use an account or Profile without Kernel administrative rights, or use a Studio-only entry point.'],
-                safeDetails: {
-                    availablePerspectives,
-                    operation,
-                    requestState: 'not_sent',
-                    requestedPerspective: requested,
-                    sessionPerspective,
-                },
+                safeDetails: { availablePerspectives, operation, requestState: 'not_sent', requestedPerspective: requested, sessionSurfaces },
             });
         }
-        return { effectivePerspective: sessionPerspective, perspectiveSource: 'session-scope' };
+        return { effectivePerspective: route, perspectiveSource: 'fixed-route' };
+    }
+    const effectivePerspective = sessionSurfaces.studio ? 'studio' : 'kernel';
+    if (!availablePerspectives.includes(effectivePerspective)) {
+        throw new CliError(`${operation} does not support an available Data perspective.`, {
+            code: 'DATA_PERSPECTIVE_UNAVAILABLE',
+            exitCode: EXIT_CODES.authorization,
+            safeDetails: { availablePerspectives, operation, requestState: 'not_sent', requestedPerspective: requested, sessionSurfaces },
+        });
     }
-    return { effectivePerspective: route, perspectiveSource: 'fixed-route' };
+    return { effectivePerspective, perspectiveSource: 'studio-first' };
 }
 //# sourceMappingURL=perspective.js.map

package/dist/data/perspective.js.map

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

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

@@ -1 +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,CAuEhI"}
+{"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,CAyEhI"}

package/dist/data/resource-locator.js

@@ -17,28 +17,30 @@ function notSent(code, message, safeDetails, recovery) {
 }
 export function prepareOntologyReadRuntime(runtime, scope, resourceTeam) {
     const normalizedResourceTeam = resourceTeam === undefined ? undefined : requireExactId(resourceTeam, 'Resource Team');
+    const requestedPerspective = runtime.requestedPerspective;
+    const explicitTeam = runtime.runtimeInput.explicitTeam;
     if (normalizedResourceTeam && scope.kind !== 'ontology') {
         throw notSent('DATA_RESOURCE_TEAM_NOT_APPLICABLE', '--resource-team only supports precise Ontology scope, old Bucket compatible commands continue to use --team.', { dataScopeKind: scope.kind }, ['Use --ontology instead, <Ontology ID>, or --team in the old Bucket command.']);
     }
-    if (normalizedResourceTeam && runtime.dataPerspective !== 'kernel') {
-        throw notSent('DATA_RESOURCE_TEAM_NOT_APPLICABLE', '--resource-team is only used for explicit Kernel Ontology reads; Studio uses the --team context.', { requestedPerspective: runtime.dataPerspective ?? 'legacy' }, [
+    if (normalizedResourceTeam && requestedPerspective === 'studio') {
+        throw notSent('DATA_RESOURCE_TEAM_NOT_APPLICABLE', '--resource-team is only used for explicit Kernel Ontology reads; Studio uses the --team context.', { requestedPerspective }, [
             'For Kernel reading, please explicitly pass --perspective kernel; for Studio reading, please remove --resource-team and use --team.',
         ]);
     }
-    if (normalizedResourceTeam && runtime.context.team) {
-        throw notSent('DATA_TEAM_ROLE_CONFLICT', '--team and --resource-team represent different roles and cannot be used at the same time in the current request.', { requestedPerspective: runtime.dataPerspective }, [
+    if (normalizedResourceTeam && explicitTeam) {
+        throw notSent('DATA_TEAM_ROLE_CONFLICT', '--team and --resource-team represent different roles and cannot be used at the same time in the current request.', { requestedPerspective }, [
             'Kernel global resource reading retains --resource-team and removes --team; explicit Team filtering retains --team and removes --resource-team.',
         ]);
     }
-    if (runtime.dataPerspective !== 'kernel' || runtime.teamMode !== 'none')
-        return runtime;
     if (scope.kind !== 'ontology')
         return runtime;
-    if (!normalizedResourceTeam) {
+    if (requestedPerspective === 'kernel' && runtime.teamMode === 'none' && !normalizedResourceTeam) {
         throw notSent('DATA_RESOURCE_TEAM_REQUIRED', 'Current Kernel Ontology reads require an explicit data resource Team.', { ontologyId: scope.id }, [
             'Pass in --resource-team <Team ID> after confirming the data resource Team of the target Ontology; do not use the Ontology owner Team to guess.',
         ]);
     }
+    if (!normalizedResourceTeam)
+        return runtime;
     if (runtime.resourceLocator) {
         if (runtime.resourceLocator.ontologyId === scope.id && runtime.resourceLocator.teamId === normalizedResourceTeam)
             return runtime;

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

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

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

@@ -1,5 +1,5 @@
 import { type DataCallResult } from './client.js';
-import type { DataRuntime } from './command.js';
+import { type DataRuntime } from './command.js';
 import type { DataScope } from './scope.js';
 type ViewRowColumnKind = 'base' | 'feature' | 'property' | 'tag-group';
 export interface ViewRowColumn {

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

@@ -1 +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"}
+{"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,EAAiC,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAG/E,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;AA8WD,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,CAoB7B"}

package/dist/data/view-rows.js

@@ -1,6 +1,7 @@
 import { CliError, EXIT_CODES } from '../errors/cli-error.js';
 import { attachmentSummary } from './attachments.js';
 import { DataClient } from './client.js';
+import { resolveDataRuntimePerspective } from './command.js';
 import { batchGetFeatureValues, listViewFeatureColumns, MAX_VIEW_COLUMNS } from './feature-values.js';
 import { requireExactId } from './policy.js';
 import { normalizeTreeNodes } from './tree.js';
@@ -209,12 +210,12 @@ async function listMetadata(client, scope, path, id) {
         safeDetails: { maxItems: 2000, operation: id },
     });
 }
-export async function readViewRows(runtime, scope, input) {
+async function readViewRowsOnce(runtime, scope, input) {
     const viewId = requireExactId(input.viewId, 'View');
     if (!Number.isInteger(input.limit) || input.limit < 1 || input.limit > 200) {
         throw new CliError('--limit must be between 1 and 200.', { code: 'DATA_BATCH_LIMIT', exitCode: EXIT_CODES.validation });
     }
-    const client = new DataClient(runtime, scope);
+    const client = new DataClient(runtime, scope, false);
     const viewResult = await client.call('data.view.tree', 'GET', '/api/v2/data/views/tree', 'read', {
         query: { ontologyId: scope.id },
     });
@@ -234,7 +235,7 @@ export async function readViewRows(runtime, scope, input) {
     const planned = planColumns(table, fieldList.columns, tagGroups?.items ?? []);
     const advancedFilter = configuredAdvancedFilter(viewRecord);
     const assetResult = advancedFilter
-        ? await client.page('data.asset.search', 'POST', '/api/kernel/data-v2/search/advanced', {
+        ? await client.page('data.asset.search', 'POST', '/api/v2/data/assets/search/advanced', {
             body: {
                 ...advancedFilter,
                 ontologyId: scope.id,
@@ -338,4 +339,26 @@ export async function readViewRows(runtime, scope, input) {
         },
     };
 }
+export async function readViewRows(runtime, scope, input) {
+    const canFallback = runtime.requestedPerspective === 'auto' && runtime.dataPerspective === 'studio' && runtime.sessionSurfaces.kernel;
+    const studio = await readViewRowsOnce(runtime, scope, input);
+    if (!canFallback || studio.rows.length > 0)
+        return studio;
+    const kernelRuntime = await resolveDataRuntimePerspective(runtime, 'kernel');
+    const kernel = await readViewRowsOnce(kernelRuntime, scope, input);
+    return {
+        ...kernel,
+        binding: {
+            ...kernel.binding,
+            perspectiveResolution: {
+                attempts: [
+                    { outcome: 'empty', perspective: 'studio' },
+                    { outcome: kernel.rows.length > 0 ? 'success' : 'empty', perspective: 'kernel' },
+                ],
+                fallbackReason: 'studio_empty',
+                policy: 'studio-first',
+            },
+        },
+    };
+}
 //# sourceMappingURL=view-rows.js.map