@astrale-os/cli 1.0.0-beta.22 → 1.0.0-beta.24

package/dist/public/connect-core.js

@@ -8242,14 +8242,14 @@ function isPidAlive(pid) {
 function sleep(milliseconds) {
   return new Promise((resolve) => setTimeout(resolve, milliseconds));
 }
-// node_modules/.pnpm/@astrale-os+kernel-dsl@0.2.0-beta.12/node_modules/@astrale-os/kernel-dsl/dist/value/limits.js
+// node_modules/.pnpm/@astrale-os+kernel-dsl@0.2.0-beta.13/node_modules/@astrale-os/kernel-dsl/dist/value/limits.js
 var defaultLimits = Object.freeze({
   maxBytes: 16 * 1024 * 1024,
   maxDepth: 64,
   maxMembers: 1e5,
   maxStringBytes: 1024 * 1024
 });
-// node_modules/.pnpm/@astrale-os+kernel-dsl@0.2.0-beta.12/node_modules/@astrale-os/kernel-dsl/dist/value/canonical.js
+// node_modules/.pnpm/@astrale-os+kernel-dsl@0.2.0-beta.13/node_modules/@astrale-os/kernel-dsl/dist/value/canonical.js
 var encoder2 = new TextEncoder;
 // node_modules/.pnpm/jsonc-parser@3.3.1/node_modules/jsonc-parser/lib/esm/impl/scanner.js
 var CharacterCodes;
@@ -8429,7 +8429,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// node_modules/.pnpm/@astrale-os+kernel-dsl@0.2.0-beta.12/node_modules/@astrale-os/kernel-dsl/dist/value/decode.js
+// node_modules/.pnpm/@astrale-os+kernel-dsl@0.2.0-beta.13/node_modules/@astrale-os/kernel-dsl/dist/value/decode.js
 var decoder2 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
 // node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/external.js
 var exports_external = {};
@@ -23659,7 +23659,7 @@ var log = {
   dim: (msg) => console.log(source_default.dim(msg))
 };
 var IS_CI = !!(process.env.CI || process.env.CONTINUOUS_INTEGRATION || process.env.NO_SPINNER);
-// node_modules/.pnpm/@astrale-os+kernel-core@0.9.0-beta.15/node_modules/@astrale-os/kernel-core/dist/dns-label.js
+// node_modules/.pnpm/@astrale-os+kernel-core@0.9.0-beta.16/node_modules/@astrale-os/kernel-core/dist/dns-label.js
 var DNS_LABEL_RE = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
 function isDnsLabel(value) {
   return DNS_LABEL_RE.test(value);

package/dist/types/admin/contract.d.ts

@@ -1,5 +1,5 @@
 import type { Input } from '@astrale-os/sdk/client';
-import type { ClientSession } from '@astrale-os/sdk/client/session';
+import type { ClientSession, SessionRequestOptions } from '@astrale-os/sdk/client/session';
 import type { ClassRef } from '@astrale-os/sdk/schema';
 import { Path } from '@astrale-os/sdk/graph/path';
 export declare const AdminContract: Readonly<{
@@ -23,4 +23,4 @@ export declare const AdminContract: Readonly<{
     }>;
 }>;
 /** Invoke one stable Admin instance Method without schema discovery or reflection. */
-export declare function callAdminMethod(session: ClientSession, receiver: Path, method: string, input: Input): Promise<unknown>;
+export declare function callAdminMethod(session: ClientSession, receiver: Path, method: string, input: Input, options?: SessionRequestOptions): Promise<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/cli",
-  "version": "1.0.0-beta.22",
+  "version": "1.0.0-beta.24",
   "description": "Astrale CLI — connect to existing Astrale kernels",
   "keywords": [
     "astrale",
@@ -57,13 +57,14 @@
     "jose": "^6.1.3",
     "ora": "^9.0.0",
     "ts-morph": "^25.0.1",
+    "tsconfig-paths": "4.2.0",
     "yaml": "^2.8.2",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@astrale-os/ox": ">=0.1.3 <1.0.0",
-    "@astrale-os/sdk": "0.5.0-beta.50",
-    "@astrale-os/shell": "0.4.2-beta.5",
+    "@astrale-os/sdk": "0.5.0-beta.51",
+    "@astrale-os/shell": "0.4.2-beta.6",
     "@astrale/commitlint-config": "npm:@jsr/astrale__commitlint-config@~2.0.1",
     "@commitlint/cli": "21.2.2",
     "@commitlint/config-conventional": "21.2.2",
@@ -98,7 +99,7 @@
   "scripts": {
     "build": "bun scripts/build.ts",
     "package:check": "pnpm run typecheck && pnpm run test && pnpm run build && node scripts/verify-public-exports.mjs && node scripts/verify-public-dependency-boundary.mjs",
-    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.tests.json && tsc --noEmit -p viewer && pnpm --dir studio run typecheck",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.tests.json && tsc --noEmit -p tsconfig.scripts.json && tsc --noEmit -p viewer && pnpm --dir studio run typecheck",
     "lint": "oxlint .",
     "lint:fix": "oxlint --fix .",
     "format": "pnpm exec oxfmt --write .",

package/src/admin/contract.ts

@@ -1,5 +1,5 @@
 import type { Input } from '@astrale-os/sdk/client'
-import type { ClientSession } from '@astrale-os/sdk/client/session'
+import type { ClientSession, SessionRequestOptions } from '@astrale-os/sdk/client/session'
 import type { ClassRef } from '@astrale-os/sdk/schema'
 
 import { call } from '@astrale-os/sdk/client'
@@ -41,6 +41,7 @@ export function callAdminMethod(
   receiver: Path,
   method: string,
   input: Input,
+  options?: SessionRequestOptions,
 ): Promise<unknown> {
-  return session.call(call(Path.instanceMethod(receiver, method), input))
+  return session.call(call(Path.instanceMethod(receiver, method), input), options)
 }

package/src/commands/__tests__/read-commands.test.ts

@@ -6,6 +6,12 @@ type GraphContext = {
     getOrThrow: typeof getOrThrowMock
     mutate: typeof mutateMock
   }
+  session: {
+    schema: {
+      inspect: typeof inspectMock
+      bundle: typeof bundleMock
+    }
+  }
 }
 
 type RunOpts = {
@@ -36,6 +42,8 @@ let mutations: unknown[] = []
 let queryResult: unknown
 let getResult: unknown
 let mutationResult: unknown
+let inspectResult: unknown
+let bundleResult: unknown
 let selfFailure: unknown
 let selfContexts: unknown[] = []
 
@@ -51,6 +59,8 @@ const mutateMock = mock(async (mutation: unknown) => {
   mutations.push(mutation)
   return mutationResult
 })
+const inspectMock = mock(async (_origin: string) => inspectResult)
+const bundleMock = mock(async (_origin: string) => bundleResult)
 const expandSelfInPathMock = mock(async (path: string, context: unknown) => {
   selfContexts.push(context)
   if (selfFailure !== undefined) throw selfFailure
@@ -65,6 +75,7 @@ const expandSelfInPathMock = mock(async (path: string, context: unknown) => {
 const withSelfHintMock = mock(async (action: () => Promise<unknown>) => action())
 const commandContext = {
   graph: { query: queryMock, getOrThrow: getOrThrowMock, mutate: mutateMock },
+  session: { schema: { inspect: inspectMock, bundle: bundleMock } },
 }
 const runKernelCommandMock = mock(async (run: RunOpts) => {
   const result = await run.fn(commandContext)
@@ -93,11 +104,22 @@ beforeEach(() => {
   }
   getResult = undefined
   mutationResult = { createdNodes: {} }
+  inspectResult = {
+    origin: 'notes.example.dev',
+    revision: 'notes-v1',
+    generation: 'sha256:generation',
+  }
+  bundleResult = {
+    domain: inspectResult,
+    bundle: { origin: 'notes.example.dev', revision: 'notes-v1' },
+  }
   selfFailure = undefined
   selfContexts = []
   queryMock.mockClear()
   getOrThrowMock.mockClear()
   mutateMock.mockClear()
+  inspectMock.mockClear()
+  bundleMock.mockClear()
   expandSelfInPathMock.mockClear()
   withSelfHintMock.mockClear()
   runKernelCommandMock.mockClear()
@@ -280,6 +302,40 @@ describe('get command', () => {
   })
 })
 
+describe('introspect command', () => {
+  test('uses the split SDK Schema API without recreating the retired introspection request', async () => {
+    const { introspectCommand } = await import('../introspect')
+
+    await introspectCommand(
+      'notes.example.dev',
+      { json: true },
+      {
+        runKernelCommand: runKernelCommandMock as never,
+      },
+    )
+
+    expect(inspectMock).toHaveBeenCalledWith('notes.example.dev')
+    expect(bundleMock).not.toHaveBeenCalled()
+    expect(JSON.parse(stdout)).toEqual(inspectResult)
+  })
+
+  test('requests the immutable bundle only when explicitly selected', async () => {
+    const { introspectCommand } = await import('../introspect')
+
+    await introspectCommand(
+      'notes.example.dev',
+      { json: true, bundle: true },
+      {
+        runKernelCommand: runKernelCommandMock as never,
+      },
+    )
+
+    expect(bundleMock).toHaveBeenCalledWith('notes.example.dev')
+    expect(inspectMock).not.toHaveBeenCalled()
+    expect(JSON.parse(stdout)).toEqual(bundleResult)
+  })
+})
+
 describe('mutate command', () => {
   /** @evidence TEST-CLI-MUTATE-DISPATCHES-CANONICAL-V3 */
   test('admits authoring input and dispatches one canonical Mutation V3 document', async () => {

package/src/commands/__tests__/view.test.ts

@@ -52,7 +52,6 @@ const resolved = [
         kind: 'definition' as const,
         definitions: [{ origin: 'ai-gateway.astrale.ai', kind: 'class' as const, name: 'Model' }],
       },
-      auth: 'required' as const,
     },
   }),
   route({
@@ -62,7 +61,7 @@ const resolved = [
     issuer: 'https://ai-gateway.astrale.ai',
     etag: `sha256:${'c'.repeat(64)}`,
     revision: `sha256:${'d'.repeat(64)}`,
-    declaration: { target: { kind: 'domain' as const }, auth: 'public' as const },
+    declaration: { target: { kind: 'domain' as const } },
   }),
 ]
 

package/src/commands/introspect.ts

@@ -38,14 +38,13 @@ export async function introspectCommand(
     opts,
     label: `Introspect ${origin}`,
     fn: async ({ session }) => {
-      const includeBundle = wantsCallable || opts.bundle === true
-      const result = await readInstalledDomain(session.schema, origin, includeBundle)
       if (wantsCallable) {
-        const described = describeCallableFromBundle(path, (result as DomainBundle).bundle)
+        const result = await readInstalledDomain(session.schema, origin, true)
+        const described = describeCallableFromBundle(path, result.bundle)
         if (described === undefined) throw missingCallableDescription(path.raw)
         return described
       }
-      return result
+      return readInstalledDomain(session.schema, origin, opts.bundle === true)
     },
     format: (value, format) => output(value, format),
   })
@@ -110,11 +109,11 @@ export default {
   description: 'Read installed Domain schema from the Kernel Schema syscall',
   afterHelpText: `
 Behavior:
-  Calls the public Kernel introspect syscall for one installed Domain.
-  A bare origin (kernel.astrale.ai or /:kernel.astrale.ai) prints installation
-  state, target, source, readiness, and capabilities. --bundle includes the
-  schema bundle. A method or Function Path projects that callable's
-  input/output from the installed bundle.
+  Calls the public SDK Schema API for one installed Domain. A bare origin
+  (kernel.astrale.ai or /:kernel.astrale.ai) prints its exact revision,
+  generation, publication, readiness, capabilities, and bindings. --bundle
+  includes the schema bundle. A method or Function Path projects that
+  callable's input/output from the installed bundle.
 
 Examples:
   $ astrale introspect kernel.astrale.ai

package/src/ui/.spec/architecture.md

@@ -4,10 +4,11 @@ This private CLI owner manages an existing local React project. It does not conn
 does not add React, Base UI, Tailwind, shadcn, or the UI runtime to the installed CLI dependency
 graph.
 
-One registry operation resolves one immutable UI commit. Package compatibility and registry reads
-use that commit. Patterns and blocks invoke the release-qualified shadcn CLI on demand through the
-detected package manager. Released themes copy the exact admitted embedded CSS directly, while a
-local playground export is admitted and copied without registry or shadcn. Both theme paths install
-consumer-owned source and activate it through one project-relative CSS
-import, and complete application writes before the lock advances. Dry-run, list, and doctor do not
-claim a file mutation.
+One registry operation resolves one immutable UI commit. During the V1 prerelease, operations
+without an explicit version resolve the npm `beta` dist-tag; the legacy `latest` channel is not a V1
+source. Package compatibility and registry reads use that commit. Patterns and blocks invoke the
+release-qualified shadcn CLI on demand through the detected package manager. Released themes copy
+the exact admitted embedded CSS directly, while a local playground export is admitted and copied
+without registry or shadcn. Both theme paths install consumer-owned source and activate it through
+one project-relative CSS import, and complete application writes before the lock advances. Dry-run,
+list, and doctor do not claim a file mutation.

package/src/ui/.spec/laws.ts

@@ -1,5 +1,12 @@
 import { defineLaw } from '@astrale-os/spec/authoring'
 
+export const CLI_UI_BETA_DEFAULT = defineLaw({
+  id: 'CLI-UI-BETA-DEFAULT',
+  statement:
+    'Until the UI V1 channel is promoted, an operation without an explicit version resolves the npm beta dist-tag and never the legacy latest dist-tag.',
+  tests: [{ file: '../__tests__/ui.test.ts', id: 'TEST-CLI-UI-BETA-DEFAULT' }],
+})
+
 export const CLI_UI_ONE_SNAPSHOT = defineLaw({
   id: 'CLI-UI-ONE-SNAPSHOT',
   statement: