@astrale-os/cli 1.0.0-beta.32 → 1.0.0-beta.43

package/src/admin/contract.ts

@@ -1,47 +0,0 @@
-import type { Input } from '@astrale-os/sdk/client'
-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'
-import { Path } from '@astrale-os/sdk/graph/path'
-import { K, PropertyKey } from '@astrale-os/sdk/schema'
-
-const origin = 'admin.astrale.ai'
-
-function classRef(name: string): ClassRef {
-  return Object.freeze({ origin, kind: 'class', name }) as ClassRef
-}
-
-const Domain = classRef('Domain')
-
-export const AdminContract = Object.freeze({
-  origin,
-  fleet: Path.parse('/:admin.astrale.ai:core.fleet'),
-  classes: Object.freeze({
-    Domain,
-  }),
-  edges: Object.freeze({
-    fleetInstallsDomainByDefault: classRef('fleet_installs_domain_by_default'),
-  }),
-  properties: Object.freeze({
-    domain: Object.freeze({
-      origin: PropertyKey.of(Domain, 'origin'),
-      name: K.classes.Named.properties.name.key,
-      discoveryUrl: PropertyKey.of(Domain, 'discoveryUrl'),
-      description: K.classes.Descriptable.properties.description.key,
-      createdAt: K.classes.Timestamped.properties.createdAt.key,
-      updatedAt: K.classes.Timestamped.properties.updatedAt.key,
-    }),
-  }),
-})
-
-/** Invoke one stable Admin instance Method without schema discovery or reflection. */
-export function callAdminMethod(
-  session: ClientSession,
-  receiver: Path,
-  method: string,
-  input: Input,
-  options?: SessionRequestOptions,
-): Promise<unknown> {
-  return session.call(call(Path.instanceMethod(receiver, method), input), options)
-}

package/src/admin/graph/.spec/api.d.ts

@@ -1,22 +0,0 @@
-import type { GraphApi } from '@astrale-os/sdk/client'
-import type { Node } from '@astrale-os/sdk/graph/node'
-import type { QueryAST } from '@astrale-os/sdk/query'
-
-/** Smallest Kernel graph capability needed by bounded Admin graph reads. */
-export type AdminGraphQueryApi = Pick<GraphApi, 'query'>
-
-/** Caller-scoped graph reads shared by the Admin catalog and Instance journeys. */
-export type AdminGraphApi = Pick<GraphApi, 'query' | 'neighbors'>
-
-export interface ReadAllNodesOptions {
-  readonly label: string
-  readonly maximum: number
-  readonly maximumPages: number
-}
-
-/** Collect one bounded Node selection and reject projection, cursor, or identity anomalies. */
-export function readAllNodes(
-  graph: AdminGraphQueryApi,
-  ast: QueryAST,
-  options: ReadAllNodesOptions,
-): Promise<readonly Node[]>

package/src/admin/graph/.spec/architecture.md

@@ -1,5 +0,0 @@
-# Admin Graph inventory helper
-
-This internal helper consumes only public `GraphApi.query` pages. It requires a Node selection,
-enforces explicit Node and page bounds, rejects repeated cursors and Node identities, and returns a
-frozen inventory. It owns no Admin schema meaning and performs no mutation or invocation.

package/src/admin/graph/.spec/icon.svg

@@ -1,3 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#0891b2" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round">
-  <circle cx="5" cy="12" r="2"/><circle cx="12" cy="6" r="2"/><circle cx="19" cy="12" r="2"/><circle cx="12" cy="18" r="2"/><path d="m7 11 3.5-3.5M13.5 7.5 17 11M17 13l-3.5 3.5M10.5 16.5 7 13"/>
-</svg>

package/src/admin/graph/.spec/layout.ts

@@ -1,3 +0,0 @@
-import { defineLayout } from '@astrale-os/spec/authoring'
-
-export default defineLayout({ entries: ['index.ts', 'nodes.ts'], exact: true })

package/src/admin/graph/index.ts

@@ -1,6 +0,0 @@
-export {
-  readAllNodes,
-  type AdminGraphApi,
-  type AdminGraphQueryApi,
-  type ReadAllNodesOptions,
-} from './nodes'

package/src/admin/graph/nodes.ts

@@ -1,56 +0,0 @@
-import type { GraphApi } from '@astrale-os/sdk/client'
-import type { Node } from '@astrale-os/sdk/graph/node'
-import type { QueryAST } from '@astrale-os/sdk/query'
-
-export type AdminGraphQueryApi = Pick<GraphApi, 'query'>
-export type AdminGraphApi = Pick<GraphApi, 'query' | 'neighbors'>
-
-export interface ReadAllNodesOptions {
-  readonly label: string
-  readonly maximum: number
-  readonly maximumPages: number
-}
-
-/** Collect one explicitly bounded Node-value projection without hiding cursors. */
-export async function readAllNodes(
-  graph: AdminGraphQueryApi,
-  ast: QueryAST,
-  options: ReadAllNodesOptions,
-): Promise<readonly Node[]> {
-  const nodes: Node[] = []
-  const ids = new Set<string>()
-  const cursors = new Set<string>()
-  let cursor: string | undefined
-  let pages = 0
-  const pageSize = Math.min(options.maximum, 256)
-  do {
-    pages += 1
-    if (pages > options.maximumPages) {
-      throw new TypeError(`${options.label} exceeded its page bound.`)
-    }
-    const response = await graph.query(ast, {
-      page: { size: pageSize, ...(cursor === undefined ? {} : { after: cursor }) },
-    })
-    const result = response.result
-    if (result.kind !== 'nodes')
-      throw new TypeError(`${options.label} returned the wrong projection.`)
-    for (const projection of result.nodes) {
-      if (projection.kind !== 'value') {
-        throw new TypeError(`${options.label} omitted requested Node values.`)
-      }
-      const node = projection.value
-      if (ids.has(String(node.id))) throw new TypeError(`${options.label} repeated a Node.`)
-      ids.add(String(node.id))
-      nodes.push(node)
-    }
-    if (nodes.length > options.maximum) {
-      throw new TypeError(`${options.label} exceeded its Node bound.`)
-    }
-    cursor = response.page.next
-    if (cursor !== undefined && cursors.has(cursor)) {
-      throw new TypeError(`${options.label} repeated a cursor.`)
-    }
-    if (cursor !== undefined) cursors.add(cursor)
-  } while (cursor !== undefined)
-  return Object.freeze(nodes)
-}

package/src/admin/index.ts

@@ -1,2 +0,0 @@
-export * as catalog from './catalog'
-export * as instance from './instance'

package/src/admin/instance/.spec/api.d.ts

@@ -1,62 +0,0 @@
-import type { ClientSession } from '@astrale-os/sdk/client/session'
-
-export type InstanceState = 'provisioning' | 'ready' | 'deleting' | 'failed' | 'deleted'
-
-export interface InstanceInfo {
-  readonly id: string
-  readonly slug: string
-  readonly url: string
-  readonly hostId?: string
-  readonly region?: string
-  readonly state: InstanceState
-  readonly phase?: string
-  readonly error?: string | null
-  readonly createdAt?: string
-  readonly updatedAt?: string
-  readonly organizationId?: string
-}
-
-export interface OwnedInstanceInfo extends InstanceInfo {
-  readonly state: InstanceState
-}
-
-export interface DomainInstallReceipt {
-  readonly domain: string
-  readonly instance: string
-  readonly origin: string
-  readonly ok: boolean
-  readonly installedRevision?: string
-  readonly error?: string
-}
-
-export interface AdminInstanceContext {
-  readonly session: ClientSession
-}
-
-export interface AdminInstanceApi {
-  list(): Promise<OwnedInstanceInfo[]>
-  create(slug: string): Promise<InstanceInfo>
-  status(identifier: string): Promise<InstanceInfo>
-  delete(identifier: string): Promise<InstanceInfo>
-  installDomain(identifier: string, domain: string): Promise<DomainInstallReceipt>
-}
-
-export class AdminInstanceNotFoundError extends Error {
-  constructor(identifier: string)
-  readonly name: 'NotFoundError'
-  readonly identifier: string
-}
-
-export interface AdminInstanceDependencies {
-  readonly operationId?: (kind: 'create' | 'status' | 'delete' | 'install-domain') => string
-}
-
-export function connectAdminInstances(
-  context: AdminInstanceContext,
-  dependencies?: AdminInstanceDependencies,
-): Promise<AdminInstanceApi>
-export function findOwnedInstance(
-  instances: readonly OwnedInstanceInfo[],
-  identifier: string,
-): OwnedInstanceInfo | undefined
-export function formatInstanceState(info: InstanceInfo): string

package/src/admin/instance/.spec/architecture.md

@@ -1,10 +0,0 @@
-# CLI Admin Instance adapter
-
-The adapter calls the stable singleton Fleet receiver directly. Listing and automatic creation are
-one Admin Method call each; connection performs no schema discovery, introspection, or graph read.
-Every returned summary is decoded locally before it reaches a command.
-
-Automatic creation invokes `Fleet.createInstance`. Status, deletion, and Domain installation first
-resolve a caller-visible Instance through Fleet and then invoke that exact Instance receiver. The
-adapter creates internal operation IDs but preserves the existing CLI projection and
-selection-required experience.

package/src/admin/instance/.spec/icon.svg

@@ -1,3 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#2563eb" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round">
-  <rect x="4" y="4" width="16" height="16" rx="3"/><path d="M8 9h8M8 13h8M8 17h5"/><circle cx="17" cy="17" r="1" fill="#2563eb"/>
-</svg>

package/src/admin/instance/.spec/layout.ts

@@ -1,6 +0,0 @@
-import { defineLayout } from '@astrale-os/spec/authoring'
-
-export default defineLayout({
-  entries: ['__tests__/', 'client.ts', 'index.ts', 'model.ts', 'tsconfig.json'],
-  exact: true,
-})

package/src/admin/instance/__tests__/client.test.ts

@@ -1,273 +0,0 @@
-import { describe, expect, test } from 'bun:test'
-
-import { adminSession } from '../../__tests__/fixture'
-import { connectAdminInstances } from '../client'
-
-function fixture(input: { invoke?: (target: string, input: unknown) => unknown }) {
-  const calls: Array<{
-    target: string
-    value: unknown
-  }> = []
-  const remote = adminSession((target, value) => {
-    calls.push({ target, value })
-    return input.invoke?.(target, value)
-  })
-  return {
-    call: remote.call,
-    reflection: remote.reflection,
-    calls,
-    connect: () =>
-      connectAdminInstances(
-        { session: remote.session },
-        {
-          operationId: (kind) => `cli.instance.${kind}:test`,
-        },
-      ),
-  }
-}
-
-describe('V2 Admin Instance adapter', () => {
-  test('lists caller-visible Instances through the Admin-owned Fleet operation', async () => {
-    const contract = fixture({
-      invoke: (target) =>
-        target.endsWith('::listInstances')
-          ? [
-              {
-                id: '@instance-node',
-                slug: 'demo',
-                url: 'https://demo.eu.astrale.ai',
-                hostId: '@host-node',
-                region: 'fr-par',
-                state: 'ready',
-                createdAt: '2026-08-12T00:00:00.000Z',
-                updatedAt: '2026-08-12T00:00:00.000Z',
-              },
-            ]
-          : undefined,
-    })
-
-    await expect((await contract.connect()).list()).resolves.toEqual([
-      {
-        id: '@instance-node',
-        slug: 'demo',
-        url: 'https://demo.eu.astrale.ai',
-        hostId: '@host-node',
-        region: 'fr-par',
-        state: 'ready',
-        createdAt: '2026-08-12T00:00:00.000Z',
-        updatedAt: '2026-08-12T00:00:00.000Z',
-      },
-    ])
-    expect(contract.calls).toEqual([
-      {
-        target: '/:admin.astrale.ai:core.fleet::listInstances',
-        value: {},
-      },
-    ])
-    expect(contract.reflection).not.toHaveBeenCalled()
-  })
-
-  test('delegates default placement to Fleet without reading Host inventory', async () => {
-    const created = {
-      id: '@instance-node',
-      slug: 'demo',
-      url: 'https://demo.eu.astrale.ai',
-      state: 'ready',
-      createdAt: '2026-08-12T00:00:00.000Z',
-      updatedAt: '2026-08-12T00:00:00.000Z',
-    }
-    const contract = fixture({ invoke: () => created })
-
-    await expect((await contract.connect()).create('demo')).resolves.toMatchObject({
-      id: created.id,
-      slug: created.slug,
-      url: created.url,
-      state: created.state,
-      createdAt: created.createdAt,
-    })
-    expect(contract.calls).toEqual([
-      {
-        target: '/:admin.astrale.ai:core.fleet::createInstance',
-        value: { operationId: 'cli.instance.create:test', slug: 'demo' },
-      },
-    ])
-  })
-
-  test('refreshes and deletes through the resolved Instance receiver', async () => {
-    const contract = fixture({
-      invoke: (target) =>
-        target.endsWith('::listInstances')
-          ? [
-              {
-                id: '@instance-node',
-                slug: 'demo',
-                url: 'https://demo.eu.astrale.ai',
-                state: 'ready',
-                createdAt: '2026-08-12T00:00:00.000Z',
-                updatedAt: '2026-08-12T00:00:00.000Z',
-              },
-            ]
-          : {
-              id: '@instance-node',
-              slug: 'demo',
-              url: 'https://demo.eu.astrale.ai',
-              state: target.endsWith('::delete') ? 'deleted' : 'ready',
-              createdAt: '2026-08-12T00:00:00.000Z',
-              updatedAt: '2026-08-12T00:00:00.000Z',
-            },
-    })
-    const api = await contract.connect()
-
-    await expect(api.status('demo')).resolves.toMatchObject({ state: 'ready' })
-    await expect(api.delete('@instance-node')).resolves.toMatchObject({ state: 'deleted' })
-    expect(contract.calls).toEqual([
-      { target: '/:admin.astrale.ai:core.fleet::listInstances', value: {} },
-      {
-        target: '@instance-node::status',
-        value: { operationId: 'cli.instance.status:test' },
-      },
-      { target: '/:admin.astrale.ai:core.fleet::listInstances', value: {} },
-      {
-        target: '@instance-node::delete',
-        value: { operationId: 'cli.instance.delete:test' },
-      },
-    ])
-    expect(contract.reflection).not.toHaveBeenCalled()
-  })
-
-  test('installs a resolved catalog Domain through Instance.installDomain', async () => {
-    const contract = fixture({
-      invoke: (target) =>
-        target.endsWith('::listInstances')
-          ? [
-              {
-                id: '@instance-node',
-                slug: 'demo',
-                url: 'https://demo.eu.astrale.ai',
-                state: 'ready',
-                createdAt: '2026-08-12T00:00:00.000Z',
-                updatedAt: '2026-08-12T00:00:00.000Z',
-              },
-            ]
-          : {
-              domain: '@crm-domain',
-              instance: '@instance-node',
-              origin: 'crm.acme.dev',
-              ok: true,
-              installedRevision: `sha256:${'a'.repeat(64)}`,
-            },
-    })
-    const api = await contract.connect()
-
-    await expect(api.installDomain('demo', '@crm-domain')).resolves.toMatchObject({
-      domain: '@crm-domain',
-      instance: '@instance-node',
-      origin: 'crm.acme.dev',
-      ok: true,
-    })
-    expect(contract.calls.at(-1)).toEqual({
-      target: '@instance-node::installDomain',
-      value: { operationId: 'cli.instance.install-domain:test', domain: '@crm-domain' },
-    })
-    expect(contract.reflection).not.toHaveBeenCalled()
-  })
-
-  test('connects without network I/O and list performs exactly one call', async () => {
-    const contract = fixture({ invoke: () => [] })
-
-    const api = await contract.connect()
-    expect(contract.call).not.toHaveBeenCalled()
-    expect(contract.reflection).not.toHaveBeenCalled()
-
-    await expect(api.list()).resolves.toEqual([])
-    expect(contract.call).toHaveBeenCalledTimes(1)
-    expect(contract.reflection).not.toHaveBeenCalled()
-  })
-
-  test('rejects malformed inventory, lifecycle, Method, and install outputs', async () => {
-    await expect((await fixture({ invoke: () => ({}) }).connect()).list()).rejects.toThrow(
-      'Admin Instance inventory is invalid.',
-    )
-    await expect(
-      (
-        await fixture({
-          invoke: () => [{ id: '@instance-node', slug: 'demo', state: 'mystery' }],
-        }).connect()
-      ).list(),
-    ).rejects.toThrow('Admin Instance state is invalid.')
-    await expect(
-      (
-        await fixture({
-          invoke: () => [{ id: 'not-a-path', slug: 'demo', state: 'ready' }],
-        }).connect()
-      ).list(),
-    ).rejects.toThrow('Admin Instance id is invalid.')
-    await expect(
-      (
-        await fixture({
-          invoke: () => [
-            { id: '@instance-node', slug: 'demo', hostId: 'not-a-path', state: 'ready' },
-          ],
-        }).connect()
-      ).list(),
-    ).rejects.toThrow('Admin Host id is invalid.')
-
-    const malformedStatus = fixture({
-      invoke: (target) =>
-        target.endsWith('::listInstances')
-          ? [
-              {
-                id: '@instance-node',
-                slug: 'demo',
-                state: 'ready',
-                createdAt: '2026-08-12T00:00:00.000Z',
-                updatedAt: '2026-08-12T00:00:00.000Z',
-              },
-            ]
-          : {
-              id: '@instance-node',
-              slug: 'demo',
-              state: 'ready',
-              failure: {},
-              createdAt: '2026-08-12T00:00:00.000Z',
-              updatedAt: '2026-08-12T00:00:00.000Z',
-            },
-    })
-    await expect((await malformedStatus.connect()).status('demo')).rejects.toThrow(
-      'Admin failure message is invalid.',
-    )
-
-    const malformedInstall = fixture({
-      invoke: (target) =>
-        target.endsWith('::listInstances')
-          ? [
-              {
-                id: '@instance-node',
-                slug: 'demo',
-                state: 'ready',
-                createdAt: '2026-08-12T00:00:00.000Z',
-                updatedAt: '2026-08-12T00:00:00.000Z',
-              },
-            ]
-          : {
-              domain: '@crm-domain',
-              instance: '@instance-node',
-              origin: 'crm.acme.dev',
-              ok: 'yes',
-            },
-    })
-    await expect(
-      (await malformedInstall.connect()).installDomain('demo', '@crm-domain'),
-    ).rejects.toThrow('Admin Domain install outcome is invalid.')
-
-    const malformedInstallPath = fixture({
-      invoke: (target) =>
-        target.endsWith('::listInstances')
-          ? [{ id: '@instance-node', slug: 'demo', state: 'ready' }]
-          : { domain: 'not-a-path', instance: '@instance-node', origin: 'crm.acme.dev', ok: true },
-    })
-    await expect(
-      (await malformedInstallPath.connect()).installDomain('demo', '@crm-domain'),
-    ).rejects.toThrow('Admin Domain reference is invalid.')
-  })
-})