@astrale-os/cli 1.0.0-beta.8 → 1.0.0-npm-deprecated.0

package/src/admin/catalog/model.ts

@@ -1,41 +0,0 @@
-/** CLI-stable projection of one Admin Domain catalog record. */
-export interface DomainInfo {
-  readonly id: string
-  readonly origin: string
-  readonly name: string
-  readonly url?: string
-  readonly description?: string
-  readonly installByDefault?: boolean
-  readonly createdAt: string
-  readonly updatedAt: string
-}
-
-export interface PublishDomainInput {
-  readonly origin: string
-  readonly name: string
-  readonly url: string
-  readonly description?: string
-  readonly installByDefault?: boolean
-}
-
-export interface PublishDomainResult {
-  readonly entry: DomainInfo
-  readonly changed: boolean
-  readonly isNew: boolean
-}
-
-export interface InstallDomainResult {
-  readonly name: string
-  readonly origin: string
-  readonly instanceId: string
-  readonly url: string
-  readonly ok: boolean
-  readonly error?: string | null
-}
-
-export class AdminDomainNotFoundError extends AstraleError {
-  constructor(readonly identifier: string) {
-    super('DOMAIN_NOT_FOUND', `No visible Admin Domain matches ${JSON.stringify(identifier)}.`)
-  }
-}
-import { AstraleError } from '../../errors'

package/src/admin/catalog/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../../tsconfig.json",
-  "compilerOptions": {
-    "types": ["@types/node"]
-  },
-  "include": ["*.ts"],
-  "exclude": ["__tests__"]
-}

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,66 +0,0 @@
-import type { ClientSession } from '@astrale-os/sdk/client/session'
-import type { DomainBinding } from '@astrale-os/shell'
-
-import type { AdminGraphApi } from '../../graph/.spec/api.js'
-
-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 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
-  readonly graph: AdminGraphApi
-}
-
-export interface AdminInstanceApi {
-  list(): Promise<OwnedInstanceInfo[]>
-  create(slug: string, hostId?: 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 bind?: (session: ClientSession) => Promise<DomainBinding>
-  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 formatInstanceLocation(info: InstanceInfo): string

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

@@ -1,10 +0,0 @@
-# CLI Admin Instance adapter
-
-The adapter discovers and binds the configured Admin Domain, proves its origin, and resolves the
-singleton Fleet receiver. Policy-visible `Instance` and `Host` Nodes come from bounded Graph queries;
-Host location is joined through `instance_runs_on_host`.
-
-Automatic creation invokes `Fleet.createInstance`; explicit `--host-id` resolves one visible,
-non-reserved Host and invokes `Host.createInstance`. Status, deletion, and Domain installation
-invoke the 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,266 +0,0 @@
-import type { Node } from '@astrale-os/sdk/graph/node'
-import type { QueryAST } from '@astrale-os/sdk/query'
-
-import { NodeId } from '@astrale-os/sdk/graph/node'
-import { Path } from '@astrale-os/sdk/graph/path'
-import { describe, expect, mock, test } from 'bun:test'
-
-import type { AdminGraphApi } from '../../graph'
-
-import { AdminTestDomain, adminBinding, adminSession } from '../../__tests__/fixture'
-import { connectAdminInstances } from '../client'
-
-function hostNode(id: string, props: { readonly id: string; readonly state: string }): Node {
-  return {
-    id: NodeId(id),
-    class: AdminTestDomain.classes.Host.key,
-    props: AdminTestDomain.classes.Host.properties.from(props),
-  }
-}
-
-function instanceNode(id: string): Node {
-  return {
-    id: NodeId(id),
-    class: AdminTestDomain.classes.Instance.key,
-    props: AdminTestDomain.classes.Instance.properties.from({}),
-  }
-}
-
-function graphResult(nodes: readonly Node[], cursor?: string) {
-  return {
-    result: {
-      kind: 'nodes' as const,
-      nodes: nodes.map((value) => ({ kind: 'value' as const, value })),
-    },
-    page: cursor === undefined ? {} : { next: cursor },
-  }
-}
-
-function sourceName(ast: QueryAST): string | undefined {
-  const term = ast.source.terms[0]
-  return term?.kind === 'class' ? term.class.name : undefined
-}
-
-function fixture(input: {
-  instances?: readonly Node[]
-  hosts?: readonly Node[]
-  reserved?: Node | null
-  invoke?: (method: { owner: string; name: string }, receiver: unknown, input: unknown) => unknown
-}) {
-  const calls: Array<{
-    method: { owner: string; name: string }
-    receiver: string
-    value: unknown
-  }> = []
-  const remote = adminSession((method, receiver, value) => {
-    calls.push({ method, receiver: String(receiver), value })
-    return input.invoke?.(method, receiver, value)
-  })
-  const binding = adminBinding()
-  const query = mock(async (ast: QueryAST) => {
-    const name = sourceName(ast)
-    if (name === 'Instance') return graphResult(input.instances ?? [])
-    if (name === 'Host') return graphResult(input.hosts ?? [])
-    throw new Error(`Unexpected graph query ${String(name)}`)
-  })
-  const neighbors = mock(async (source: unknown, edge: { name?: string }) => {
-    if (String(source) === '/:admin.astrale.ai:core.fleet') return page(input.reserved ?? null)
-    if (edge.name === 'instance_runs_on_host') return page(input.hosts?.[0] ?? null)
-    throw new Error(`Unexpected neighbor query ${String(source)} ${String(edge)}`)
-  })
-  const graph = { query, neighbors } as unknown as AdminGraphApi
-  return {
-    binding,
-    graph,
-    invoke: remote.invoke,
-    calls,
-    connect: () =>
-      connectAdminInstances(
-        { session: remote.session, graph },
-        {
-          bind: async () => binding,
-          operationId: (kind) => `cli.instance.${kind}:test`,
-        },
-      ),
-  }
-}
-
-function page(item: Node | null) {
-  return {
-    nodes: item === null ? [] : [item],
-    first: item,
-    graph: { nodes: item === null ? [] : [item], edges: [] },
-    cursor: null,
-  }
-}
-
-describe('V2 Admin Instance adapter', () => {
-  test('lists caller-visible Instances through the Admin-owned Fleet operation', async () => {
-    const contract = fixture({
-      invoke: (method) =>
-        method.name === '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',
-                hostId: '@host-node',
-                region: 'fr-par',
-              },
-            ]
-          : undefined,
-    })
-
-    await expect((await contract.connect()).list()).resolves.toEqual([
-      {
-        id: '@instance-node',
-        slug: 'demo',
-        url: 'https://demo.eu.astrale.ai',
-        state: 'ready',
-        createdAt: '2026-08-12T00:00:00.000Z',
-        hostId: '@host-node',
-        region: 'fr-par',
-      },
-    ])
-    expect(contract.calls).toEqual([
-      {
-        method: { owner: 'Fleet', name: 'listInstances' },
-        receiver: '/:admin.astrale.ai:core.fleet::listInstances',
-        value: {},
-      },
-    ])
-  })
-
-  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({
-      hosts: [hostNode('host-node', { id: 'host-paris', state: 'ready' })],
-      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([
-      {
-        method: { owner: 'Fleet', name: 'createInstance' },
-        receiver: '/:admin.astrale.ai:core.fleet::createInstance',
-        value: { operationId: 'cli.instance.create:test', slug: 'demo' },
-      },
-    ])
-    expect(contract.graph.query).not.toHaveBeenCalled()
-    expect(contract.graph.neighbors).not.toHaveBeenCalled()
-  })
-
-  test('resolves --host-id to an exact Host receiver and rejects the reserved Admin Host', async () => {
-    const reserved = hostNode('admin-host', { id: 'admin', state: 'ready' })
-    const consumer = hostNode('consumer-host', { id: 'consumer-paris', state: 'ready' })
-    const contract = fixture({
-      hosts: [reserved, consumer],
-      reserved,
-      invoke: () => ({
-        id: '@instance-node',
-        slug: 'demo',
-        url: 'https://demo.eu.astrale.ai',
-        state: 'ready',
-      }),
-    })
-    const api = await contract.connect()
-
-    await expect(api.create('demo', 'admin')).rejects.toMatchObject({ code: 'HOST_NOT_FOUND' })
-    await expect(api.create('demo', 'consumer-paris')).resolves.toMatchObject({ slug: 'demo' })
-    expect(contract.calls.at(-1)).toEqual({
-      method: { owner: 'Host', name: 'createInstance' },
-      receiver: '@consumer-host::createInstance',
-      value: { operationId: 'cli.instance.create:test', slug: 'demo' },
-    })
-  })
-
-  test('refreshes and deletes through the resolved Instance receiver', async () => {
-    const instance = instanceNode('instance-node')
-    const contract = fixture({
-      instances: [instance],
-      invoke: (method) =>
-        method.name === '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: method.name === 'delete' ? 'deleted' : 'ready',
-            },
-    })
-    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.map(({ method }) => method)).toEqual([
-      { owner: 'Fleet', name: 'listInstances' },
-      { owner: 'Instance', name: 'status' },
-      { owner: 'Fleet', name: 'listInstances' },
-      { owner: 'Instance', name: 'delete' },
-    ])
-  })
-
-  test('installs a resolved catalog Domain through Instance.installDomain', async () => {
-    const instance = instanceNode('instance-node')
-    const contract = fixture({
-      instances: [instance],
-      invoke: (method) =>
-        method.name === '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({
-      method: { owner: 'Instance', name: 'installDomain' },
-      receiver: '@instance-node::installDomain',
-      value: { operationId: 'cli.instance.install-domain:test', domain: '@crm-domain' },
-    })
-  })
-})