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

package/src/admin/__tests__/fixture.ts

@@ -1,101 +0,0 @@
-import type { ClientSession } from '@astrale-os/sdk/client/session'
-import type { CallableReference } from '@astrale-os/sdk/client/session'
-
-import {
-  callableAddress,
-  core,
-  defineSchema,
-  edgeClass,
-  method,
-  nodeClass,
-  property,
-  schema,
-} from '@astrale-os/sdk/schema'
-import { mock } from 'bun:test'
-
-import type { AdminBinding } from '../binding'
-
-const operation = () =>
-  method({
-    auth: 'authenticated',
-    input: { type: 'object', additionalProperties: true },
-    output: { type: 'object', additionalProperties: true },
-  })
-
-const Domain = nodeClass({
-  properties: {
-    origin: property({ type: 'string' }, { required: true }),
-    name: property({ type: 'string' }, { required: true }),
-    discoveryUrl: property({ type: 'string' }, { required: true }),
-    description: property({ type: 'string' }),
-    createdAt: property({ type: 'string' }, { required: true }),
-    updatedAt: property({ type: 'string' }, { required: true }),
-  },
-  methods: { configureDefault: operation() },
-})
-const Fleet = nodeClass({
-  methods: {
-    publishDomain: operation(),
-    listInstances: operation(),
-    createInstance: operation(),
-  },
-})
-const Host = nodeClass({
-  properties: {
-    id: property({ type: 'string' }, { required: true }),
-    state: property({ type: 'string' }, { required: true }),
-  },
-  methods: { createInstance: operation() },
-})
-const Instance = nodeClass({
-  methods: {
-    status: operation(),
-    delete: operation(),
-    installDomain: operation(),
-  },
-})
-const fleet_installs_domain_by_default = edgeClass.directed({
-  source: { as: 'fleet', accepts: [Fleet], outgoing: '0..*' },
-  target: { as: 'domain', accepts: [Domain], incoming: '0..*' },
-})
-const fleet_reserves_admin_host = edgeClass.directed({
-  source: { as: 'fleet', accepts: [Fleet], outgoing: '0..1' },
-  target: { as: 'host', accepts: [Host], incoming: '0..1' },
-})
-
-export const AdminTestSchema = defineSchema('admin.astrale.ai', {
-  classes: {
-    Domain,
-    Fleet,
-    Host,
-    Instance,
-    fleet_installs_domain_by_default,
-    fleet_reserves_admin_host,
-  },
-  core: { nodes: { fleet: core.node(() => Fleet, {}) }, edges: [] },
-})
-
-export const AdminTestDomain = schema.resolve(AdminTestSchema)
-
-export function adminBinding(): AdminBinding {
-  return { domain: AdminTestDomain, graph: {} } as unknown as AdminBinding
-}
-
-export function adminSession(
-  implementation?: (
-    method: { readonly owner: string; readonly name: string },
-    receiver: unknown,
-    input: unknown,
-  ) => unknown,
-) {
-  const invoke = mock(async (reference: CallableReference, input: unknown) => {
-    const address = callableAddress(reference.callable)
-    if (address.kind !== 'method') throw new Error('Expected an Admin Method.')
-    return implementation?.(
-      { owner: address.owner.name, name: address.name },
-      reference.target,
-      input,
-    )
-  })
-  return { invoke, session: { invoke } as unknown as ClientSession }
-}

package/src/admin/binding.ts

@@ -1,98 +0,0 @@
-import type { Input } from '@astrale-os/sdk/client'
-import type { ClientSession } from '@astrale-os/sdk/client/session'
-import type {
-  ResolvedClass,
-  ResolvedCoreDefinition,
-  ResolvedMethod,
-  ResolvedProperty,
-} from '@astrale-os/sdk/schema'
-import type { DomainBinding } from '@astrale-os/shell'
-
-import { reference } from '@astrale-os/sdk/client/session'
-import { Path } from '@astrale-os/sdk/graph/path'
-import { bindDomain } from '@astrale-os/shell'
-
-const ADMIN_ORIGIN = 'admin.astrale.ai'
-
-export type AdminBinding = DomainBinding
-
-/** Bind the exact Admin revision installed on this source Kernel. */
-export async function bindAdmin(session: ClientSession): Promise<AdminBinding> {
-  const installed = await session.installation(ADMIN_ORIGIN)
-  return requireAdminBinding(await bindDomain(session, installed.bundle.root))
-}
-
-/** Admit an injected dynamic binding as the Admin Domain. */
-export function requireAdminBinding(binding: AdminBinding): AdminBinding {
-  if (binding.domain.origin !== ADMIN_ORIGIN) {
-    throw new TypeError('Configured Admin target does not serve the Admin Domain.')
-  }
-  return binding
-}
-
-/** Resolve one required Admin Class without rebuilding its schema contract. */
-export function requireAdminClass(
-  binding: AdminBinding,
-  name: string,
-  kind: 'node',
-): ResolvedClass<'node'>
-export function requireAdminClass(
-  binding: AdminBinding,
-  name: string,
-  kind: 'edge',
-): ResolvedClass<'edge'>
-export function requireAdminClass(
-  binding: AdminBinding,
-  name: string,
-  kind: 'node' | 'edge',
-): ResolvedClass<'node'> | ResolvedClass<'edge'> {
-  const selected = binding.domain.classes[name]
-  if (selected?.kind !== kind) throw new TypeError(`Admin ${name} is not a ${kind} Class.`)
-  return selected
-}
-
-/** Resolve one required Admin Core Node as its canonical projection Path. */
-export function requireAdminCore(binding: AdminBinding, name: string): Path {
-  const selected = binding.domain.core.nodes[name] as ResolvedCoreDefinition | undefined
-  if (selected === undefined) throw new TypeError(`Admin has no Core Node ${name}.`)
-  return Path.project(selected.ref)
-}
-
-/** Resolve one effective Property by unambiguous member name. */
-export function requireAdminProperty(
-  owner: ResolvedClass,
-  name: string,
-): ResolvedProperty<unknown> {
-  const selected = [...owner.properties].find((property) => property.name === name)
-  if (selected === undefined) {
-    throw new TypeError(`Admin ${owner.ref.name}.${name} Property is absent.`)
-  }
-  return selected
-}
-
-/** Invoke one resolved executable instance Method through Kernel Client. */
-export async function invokeAdminMethod(
-  session: ClientSession,
-  binding: AdminBinding,
-  owner: ResolvedClass<'node'>,
-  name: string,
-  receiver: Path,
-  input: Input,
-): Promise<unknown> {
-  const method = [...owner.methods].find((candidate) => candidate.name === name)
-  if (method === undefined || !isExecutableInstanceMethod(method)) {
-    throw new TypeError(`Admin ${owner.ref.name}.${name} is not an executable instance Method.`)
-  }
-  return session.invoke(reference(binding.domain, method)(receiver), input)
-}
-
-type ExecutableInstanceMethod = ResolvedMethod<
-  unknown,
-  unknown,
-  false,
-  Exclude<ResolvedMethod['inheritance'], 'abstract'>
->
-
-function isExecutableInstanceMethod(method: ResolvedMethod): method is ExecutableInstanceMethod {
-  return method.static === false && method.inheritance !== 'abstract'
-}

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

@@ -1,65 +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 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 interface AdminCatalogContext {
-  readonly session: ClientSession
-  readonly graph: AdminGraphApi
-}
-
-export interface AdminCatalogApi {
-  list(): Promise<DomainInfo[]>
-  require(identifier: string): Promise<DomainInfo>
-  publish(input: PublishDomainInput): Promise<PublishDomainResult>
-}
-
-export class AdminDomainNotFoundError extends Error {
-  constructor(identifier: string)
-  readonly name: 'NotFoundError'
-  readonly identifier: string
-}
-
-export interface AdminCatalogDependencies {
-  readonly bind?: (session: ClientSession) => Promise<DomainBinding>
-  readonly operationId?: (kind: 'publish' | 'configure-default') => string
-}
-
-export function connectAdminCatalog(
-  context: AdminCatalogContext,
-  dependencies?: AdminCatalogDependencies,
-): Promise<AdminCatalogApi>

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

@@ -1,6 +0,0 @@
-# CLI Admin catalog adapter
-
-The adapter reads policy-visible `Domain` Nodes through bounded Graph pages and derives default
-membership from the Fleet relation. Publication invokes `Fleet.publishDomain`; a requested default
-change is a separate explicit `Domain.configureDefault` call. Unchanged publication input is a
-no-op, and an omitted description preserves the current value.

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

@@ -1,3 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#059669" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round">
-  <path d="M5 4h14v16H5zM8 8h8M8 12h8M8 16h5"/><circle cx="17" cy="16" r="2"/>
-</svg>

package/src/admin/catalog/.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/catalog/__tests__/client.test.ts

@@ -1,142 +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 { describe, expect, mock, test } from 'bun:test'
-
-import type { AdminGraphApi } from '../../graph'
-
-import { AdminTestDomain, adminBinding, adminSession } from '../../__tests__/fixture'
-import { connectAdminCatalog } from '../client'
-
-function domainNode(id: string, origin: string): Node {
-  return {
-    id: NodeId(id),
-    class: AdminTestDomain.classes.Domain.key,
-    props: AdminTestDomain.classes.Domain.properties.from({
-      origin,
-      name: origin.split('.')[0]!,
-      discoveryUrl: `https://${origin}`,
-      createdAt: '2026-08-12T00:00:00.000Z',
-      updatedAt: '2026-08-12T00:00:00.000Z',
-    }),
-  }
-}
-
-function fixture(input: {
-  domains?: readonly Node[]
-  defaults?: readonly Node[]
-  invoke?: (method: { owner: string; name: string }, receiver: unknown, value: 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) => ({
-    result: {
-      kind: 'nodes' as const,
-      nodes: (input.domains ?? []).map((value) => ({ kind: 'value' as const, value })),
-    },
-    page: {},
-  }))
-  const defaultNodes = input.defaults ?? []
-  const neighbors = mock(async () => ({
-    nodes: defaultNodes,
-    first: defaultNodes[0] ?? null,
-    graph: { nodes: defaultNodes, edges: [] },
-    cursor: null,
-    collect: async () => ({ nodes: defaultNodes, cursor: null }),
-  }))
-  const graph = { query, neighbors } as unknown as AdminGraphApi
-  return {
-    invoke: remote.invoke,
-    calls,
-    connect: () =>
-      connectAdminCatalog(
-        { session: remote.session, graph },
-        {
-          bind: async () => binding,
-          operationId: (kind) => `cli.domain.${kind}:test`,
-        },
-      ),
-  }
-}
-
-function summary(origin: string) {
-  return {
-    id: '@crm-domain',
-    origin,
-    name: 'crm',
-    discoveryUrl: `https://${origin}`,
-    createdAt: '2026-08-12T00:00:00.000Z',
-    updatedAt: '2026-08-12T00:00:00.000Z',
-  }
-}
-
-describe('V2 Admin Domain catalog adapter', () => {
-  test('lists Domain nodes through GraphApi and joins the Fleet default relation', async () => {
-    const crm = domainNode('crm-domain', 'crm.acme.dev')
-    const notes = domainNode('notes-domain', 'notes.acme.dev')
-    const api = await fixture({ domains: [crm, notes], defaults: [crm] }).connect()
-
-    await expect(api.list()).resolves.toEqual([
-      expect.objectContaining({
-        id: '@crm-domain',
-        origin: 'crm.acme.dev',
-        installByDefault: true,
-      }),
-      expect.objectContaining({ id: '@notes-domain', origin: 'notes.acme.dev' }),
-    ])
-  })
-
-  test('publishes through Fleet then configures the Domain default explicitly', async () => {
-    const contract = fixture({ invoke: () => summary('crm.acme.dev') })
-    const api = await contract.connect()
-
-    await expect(
-      api.publish({
-        origin: 'crm.acme.dev',
-        name: 'crm',
-        url: 'https://crm.acme.dev',
-        installByDefault: true,
-      }),
-    ).resolves.toMatchObject({ changed: true, isNew: true, entry: { installByDefault: true } })
-    expect(contract.calls).toEqual([
-      {
-        method: { owner: 'Fleet', name: 'publishDomain' },
-        receiver: '/:admin.astrale.ai:core.fleet::publishDomain',
-        value: {
-          operationId: 'cli.domain.publish:test',
-          origin: 'crm.acme.dev',
-          name: 'crm',
-          discoveryUrl: 'https://crm.acme.dev',
-        },
-      },
-      {
-        method: { owner: 'Domain', name: 'configureDefault' },
-        receiver: '@crm-domain::configureDefault',
-        value: {
-          operationId: 'cli.domain.configure-default:test',
-          enabled: true,
-        },
-      },
-    ])
-  })
-
-  test('does not invoke a receiver when the catalog record is already current', async () => {
-    const crm = domainNode('crm-domain', 'crm.acme.dev')
-    const contract = fixture({ domains: [crm] })
-    const api = await contract.connect()
-
-    await expect(
-      api.publish({ origin: 'crm.acme.dev', name: 'crm', url: 'https://crm.acme.dev' }),
-    ).resolves.toMatchObject({ changed: false, isNew: false })
-    expect(contract.invoke).not.toHaveBeenCalled()
-  })
-})

package/src/admin/catalog/client.ts

@@ -1,218 +0,0 @@
-import type { ClientSession } from '@astrale-os/sdk/client/session'
-import type { Node } from '@astrale-os/sdk/graph/node'
-import type { ResolvedClass } from '@astrale-os/sdk/schema'
-
-import { Path } from '@astrale-os/sdk/graph/path'
-import { Query } from '@astrale-os/sdk/query'
-
-import {
-  bindAdmin,
-  invokeAdminMethod,
-  requireAdminBinding,
-  requireAdminClass,
-  requireAdminCore,
-  requireAdminProperty,
-  type AdminBinding,
-} from '../binding'
-import { readAllNodes, type AdminGraphApi } from '../graph'
-import {
-  AdminDomainNotFoundError,
-  type DomainInfo,
-  type PublishDomainInput,
-  type PublishDomainResult,
-} from './model'
-
-const PAGE_SIZE = 256
-const MAXIMUM_DOMAINS = 10_000
-const MAXIMUM_PAGES = Math.ceil(MAXIMUM_DOMAINS / PAGE_SIZE) + 1
-
-export interface AdminCatalogContext {
-  readonly session: ClientSession
-  readonly graph: AdminGraphApi
-}
-
-export interface AdminCatalogApi {
-  list(): Promise<DomainInfo[]>
-  require(identifier: string): Promise<DomainInfo>
-  publish(input: PublishDomainInput): Promise<PublishDomainResult>
-}
-
-export interface AdminCatalogDependencies {
-  readonly bind?: (session: ClientSession) => Promise<AdminBinding>
-  readonly operationId?: (kind: 'publish' | 'configure-default') => string
-}
-
-/** Bind the discovered Admin revision and expose its Domain catalog journey. */
-export async function connectAdminCatalog(
-  context: AdminCatalogContext,
-  dependencies: AdminCatalogDependencies = {},
-): Promise<AdminCatalogApi> {
-  const binding = requireAdminBinding(await (dependencies.bind ?? bindAdmin)(context.session))
-  const Domain = requireAdminClass(binding, 'Domain', 'node')
-  const Fleet = requireAdminClass(binding, 'Fleet', 'node')
-  const fleetInstallsByDefault = requireAdminClass(
-    binding,
-    'fleet_installs_domain_by_default',
-    'edge',
-  )
-  const fleet = requireAdminCore(binding, 'fleet')
-  const operationId = dependencies.operationId ?? defaultOperationId
-
-  const list = async (): Promise<DomainInfo[]> => {
-    const [nodes, defaultsPage] = await Promise.all([
-      readAllNodes(
-        context.graph,
-        Query.from({ nodes: [Domain] }).select({
-          kind: 'nodes',
-          projection: { kind: 'value' },
-        }),
-        {
-          label: 'Admin Domain catalog',
-          maximum: MAXIMUM_DOMAINS,
-          maximumPages: MAXIMUM_PAGES,
-        },
-      ),
-      context.graph.neighbors(fleet, fleetInstallsByDefault, {
-        direction: 'outgoing',
-        page: { size: PAGE_SIZE },
-      }),
-    ])
-    const defaults = await defaultsPage.collect({ maximumPages: MAXIMUM_PAGES })
-    if (defaults.cursor !== null)
-      throw new TypeError('Admin default Domain catalog exceeded its bound.')
-    const defaultIds = new Set(defaults.nodes.map((node) => String(node.id)))
-    return nodes.map((node) => domainFromNode(Domain, node, defaultIds.has(String(node.id))))
-  }
-
-  const requireDomain = async (identifier: string): Promise<DomainInfo> => {
-    const found = (await list()).find(
-      (domain) =>
-        domain.origin === identifier ||
-        domain.url === identifier ||
-        domain.id === identifier ||
-        (domain.id.startsWith('@') && domain.id.slice(1) === identifier),
-    )
-    if (found === undefined) throw new AdminDomainNotFoundError(identifier)
-    return found
-  }
-
-  return Object.freeze({
-    list,
-    require: requireDomain,
-    async publish(input: PublishDomainInput): Promise<PublishDomainResult> {
-      const existing = (await list()).find((domain) => domain.origin === input.origin)
-      const description = input.description ?? existing?.description
-      const registryChanged =
-        existing === undefined ||
-        existing.name !== input.name ||
-        existing.url !== input.url ||
-        existing.description !== description
-      let entry = existing
-      if (registryChanged) {
-        entry = domainFromSummary(
-          await invokeAdminMethod(context.session, binding, Fleet, 'publishDomain', fleet, {
-            operationId: operationId('publish'),
-            origin: input.origin,
-            name: input.name,
-            discoveryUrl: input.url,
-            ...(description === undefined ? {} : { description }),
-          }),
-          existing?.installByDefault === true,
-        )
-      }
-      if (entry === undefined) throw new TypeError('Admin Domain publication returned no entry.')
-
-      const defaultChanged =
-        input.installByDefault !== undefined &&
-        (entry.installByDefault ?? false) !== input.installByDefault
-      if (defaultChanged) {
-        entry = domainFromSummary(
-          await invokeAdminMethod(
-            context.session,
-            binding,
-            Domain,
-            'configureDefault',
-            Path.parse(entry.id),
-            {
-              operationId: operationId('configure-default'),
-              enabled: input.installByDefault,
-            },
-          ),
-          input.installByDefault === true,
-        )
-      }
-      return Object.freeze({
-        entry,
-        changed: registryChanged || defaultChanged,
-        isNew: existing === undefined,
-      })
-    },
-  })
-}
-
-type DynamicDefinition = ResolvedClass<'node'>
-
-function domainFromNode(
-  definition: DynamicDefinition,
-  node: Node,
-  installByDefault: boolean,
-): DomainInfo {
-  return Object.freeze({
-    id: Path.id(node.id).raw,
-    origin: requiredProperty(definition, node, 'origin'),
-    name: requiredProperty(definition, node, 'name'),
-    url: requiredProperty(definition, node, 'discoveryUrl'),
-    ...optionalProperty(definition, node, 'description'),
-    ...(installByDefault ? { installByDefault: true } : {}),
-    createdAt: requiredProperty(definition, node, 'createdAt'),
-    updatedAt: requiredProperty(definition, node, 'updatedAt'),
-  })
-}
-
-function domainFromSummary(input: unknown, installByDefault: boolean): DomainInfo {
-  const value = record(input, 'Admin Domain summary')
-  return Object.freeze({
-    id: requiredString(value.id, 'Admin Domain id'),
-    origin: requiredString(value.origin, 'Admin Domain origin'),
-    name: requiredString(value.name, 'Admin Domain name'),
-    url: requiredString(value.discoveryUrl, 'Admin Domain discovery URL'),
-    ...(value.description === undefined
-      ? {}
-      : { description: requiredString(value.description, 'Admin Domain description') }),
-    ...(installByDefault ? { installByDefault: true } : {}),
-    createdAt: requiredString(value.createdAt, 'Admin Domain creation time'),
-    updatedAt: requiredString(value.updatedAt, 'Admin Domain update time'),
-  })
-}
-
-function requiredProperty(definition: DynamicDefinition, node: Node, name: string): string {
-  return requiredString(
-    node.props[requireAdminProperty(definition, name).key],
-    `Admin Domain.${name}`,
-  )
-}
-
-function optionalProperty(
-  definition: DynamicDefinition,
-  node: Node,
-  name: string,
-): Readonly<Record<string, string>> {
-  const value = node.props[requireAdminProperty(definition, name).key]
-  return value === undefined ? {} : { [name]: requiredString(value, `Admin Domain.${name}`) }
-}
-
-function requiredString(input: unknown, label: string): string {
-  if (typeof input !== 'string' || input.length === 0) throw new TypeError(`${label} is invalid.`)
-  return input
-}
-
-function record(input: unknown, label: string): Readonly<Record<string, unknown>> {
-  if (typeof input !== 'object' || input === null || Array.isArray(input)) {
-    throw new TypeError(`${label} is invalid.`)
-  }
-  return input as Readonly<Record<string, unknown>>
-}
-
-function defaultOperationId(kind: 'publish' | 'configure-default'): string {
-  return `cli.domain.${kind}:${globalThis.crypto.randomUUID()}`
-}

package/src/admin/catalog/index.ts

@@ -1,13 +0,0 @@
-export {
-  connectAdminCatalog,
-  type AdminCatalogApi,
-  type AdminCatalogContext,
-  type AdminCatalogDependencies,
-} from './client'
-export {
-  AdminDomainNotFoundError,
-  type DomainInfo,
-  type InstallDomainResult,
-  type PublishDomainInput,
-  type PublishDomainResult,
-} from './model'