@astrale-os/cli 0.8.1-alpha.4 → 0.8.1-alpha.6

package/src/program/__tests__/program.test.ts

@@ -138,7 +138,6 @@ describe('program composition', () => {
       'auth token',
       'browser',
       'call',
-      'describe',
       'domain',
       'domain install',
       'domain list',
@@ -170,6 +169,7 @@ describe('program composition', () => {
       'instance list',
       'instance status',
       'instance use',
+      'introspect',
       'logs',
       'mutate',
       'query',
@@ -186,7 +186,7 @@ describe('program composition', () => {
       'whoami',
     ])
     expect(createHash('sha256').update(JSON.stringify(surface)).digest('hex')).toBe(
-      '4b053fe80827aeb40aecc13cd17c293b8701e59cb04f5ccb8185e9e255376dd1',
+      '0f4739269db4c1dc8e1ba8cdf7840d7fbbe9c809234d2e21eef143a9de856382',
     )
   })
 
@@ -279,6 +279,7 @@ describe('help contract — connect-only command surface', () => {
       'server',
       'env',
       'ls',
+      'describe',
     ]) {
       expect(names).not.toContain(removed)
     }
@@ -334,6 +335,7 @@ describe('help contract — payload sources', () => {
 
     expect(callHelp).toContain('--data <json>')
     expect(callHelp).not.toContain('--file <path>')
+    expect(callHelp).not.toContain('--describe')
     expect(mutateHelp).toContain('--data <json>')
     expect(mutateHelp).toContain('--file <path>')
   })

package/src/program/build.ts

@@ -23,13 +23,6 @@ export async function buildProgram(): Promise<Command> {
     .showSuggestionAfterError(true)
     .addOption(new Option('--ci', 'Machine mode: no prompts, structured errors on stderr'))
     .addOption(new Option('--no-prompt', 'Disable interactive prompts'))
-    .addOption(
-      new Option('--offline-ok', 'Tolerate offline state for commands that can operate locally'),
-    )
-    .addOption(
-      new Option('--log-level <level>', 'Log level').choices(['debug', 'info', 'warn', 'error']),
-    )
-    .addOption(new Option('--log-format <format>', 'Log output format').choices(['text', 'json']))
     .action(async () => {
       // Bare `astrale` in an interactive terminal with nothing connected yet →
       // launch the guided setup. Otherwise (configured, piped, or CI) show help.
@@ -61,8 +54,8 @@ export async function buildProgram(): Promise<Command> {
   registerCommand(program, withKernelOptions((await import('../commands/token')).default))
   registerCommand(program, withKernelOptions((await import('../commands/get')).default))
   registerCommand(program, withKernelOptions((await import('../commands/mutate')).default))
-  registerCommand(program, withKernelOptions((await import('../commands/describe')).default))
   registerCommand(program, withKernelOptions((await import('../commands/query')).default))
+  registerCommand(program, withKernelOptions((await import('../commands/introspect')).default))
   registerCommand(program, withKernelOptions((await import('../commands/logs')).default))
   registerCommand(program, withKernelOptions((await import('../commands/view')).default))
   registerCommand(program, (await import('../commands/status')).default)
@@ -158,7 +151,7 @@ export async function buildProgram(): Promise<Command> {
     `
 Command groups:
   Getting started  setup     (sign in, pick an instance, equip your workspace)
-  Kernel        get, mutate, call, query, describe, token
+  Kernel        get, mutate, call, query, introspect, logs, view, token
   Management    admin, instance, domain, identity, auth, idp, update
   Agent         browser   (drive the GUI via agent-browser)
   Studio        studio    (launch the local Domain Studio GUI for a workspace)
@@ -180,6 +173,7 @@ Examples:
   $ astrale instance status staging
   $ astrale token --audience shell.astrale.ai --ttl 3600
   $ astrale query /:notes.example.dev:class.Note --limit 50
+  $ astrale introspect /:host.astrale.ai:class.Manager:createInstance
   $ astrale query --file query.v6.json --cursor "$CURSOR"
 `,
   )

package/src/program/options.ts

@@ -16,7 +16,8 @@ const KERNEL_PASSTHROUGH_OPTIONS: readonly CommandOption[] = Object.freeze([
   { flags: '--creds <token>', description: 'Use a pre-signed credential (e.g. delegation token)' },
   {
     flags: '--anonymous',
-    description: 'Send no credential (cannot be combined with --as or --creds)',
+    description:
+      'Send no credential (cannot be combined with --as or --creds; --as and --creds are mutually exclusive)',
   },
   { flags: '--debug', description: 'Print full error diagnostics on failure' },
 ])

package/src/state/__tests__/identities.test.ts

@@ -46,7 +46,7 @@ describe('identity state', () => {
       path,
       now: () => new Date('2025-01-01T00:00:00.000Z'),
     })
-    expect(missing.identities.manager.createdAt).toBe('2025-01-01T00:00:00.000Z')
+    expect(missing).toEqual({ default: '', identities: {} })
     await expect(readFile(path, 'utf-8')).rejects.toThrow()
 
     await writeFile(path, legacy)
@@ -56,7 +56,7 @@ describe('identity state', () => {
 
     const current = `${JSON.stringify({ version: IDENTITY_STORE_VERSION, ...missing })}\n`
     await writeFile(path, current)
-    expect((await readIdentityStore({ path })).identities.manager.subject).toBe('manager')
+    expect((await readIdentityStore({ path })).identities).toEqual({})
     expect(await readFile(path, 'utf-8')).toBe(current)
   })
 

package/src/state/identities.ts

@@ -183,17 +183,10 @@ function hasVersion(input: unknown): input is { readonly version: unknown } {
   return typeof input === 'object' && input !== null && Object.hasOwn(input, 'version')
 }
 
-function seed(now: Date): IdentityStore {
+function seed(_now: Date): IdentityStore {
   return {
-    default: 'manager',
-    identities: {
-      manager: {
-        subject: 'manager',
-        createdAt: now.toISOString(),
-        source: 'key',
-        mode: 'local',
-      },
-    },
+    default: '',
+    identities: {},
   }
 }
 

package/src/commands/describe.ts

@@ -1,86 +0,0 @@
-import type { Node } from '@astrale-os/sdk/graph/node'
-
-import { ClassPath } from '@astrale-os/sdk/graph/class'
-import { Path } from '@astrale-os/sdk/graph/path'
-import chalk from 'chalk'
-
-import type { KernelCommandOpts } from '../connection'
-import type { CommandDefinition } from '../program/index'
-
-import { expandSelfInPath, runKernelCommand, withSelfHint } from '../connection'
-import { unqualifyProperty } from '../graph/index'
-import { log } from '../lib/log'
-import { output } from '../lib/output'
-
-type DescribeOpts = KernelCommandOpts & { schema?: boolean }
-type DescribedNode = Omit<Node, 'props'> & { readonly props: Readonly<Record<string, unknown>> }
-
-/** Describe only facts present on the canonical Node; no hierarchy is inferred from its Path. */
-export async function describeCommand(target: string, opts: DescribeOpts): Promise<void> {
-  let path: string
-  let meta
-  try {
-    ;({ path, meta } = await expandSelfInPath(target, opts))
-  } catch (error) {
-    log.error(error instanceof Error ? error.message : 'Invalid target')
-    process.exit(1)
-  }
-
-  await runKernelCommand({
-    opts,
-    label: `Describe ${path}`,
-    fn: ({ graph }) => withSelfHint(() => graph.getOrThrow(Path.parse(path)), meta),
-    format: (node, format, machine) => {
-      const shown = opts.schema === false ? withoutSchema(node) : node
-      if (machine || format.format !== undefined) output(shown, format)
-      else printDescription(path, shown)
-    },
-  })
-}
-
-function withoutSchema(node: Node): DescribedNode {
-  return {
-    ...node,
-    props: Object.fromEntries(
-      Object.entries(node.props).filter(([key]) => unqualifyProperty(key) !== 'schema'),
-    ),
-  }
-}
-
-function printDescription(target: string, node: DescribedNode): void {
-  console.log(`  ${chalk.bold.cyan(target)}`)
-  console.log(`  ${chalk.dim('id')}     ${node.id}`)
-  console.log(
-    `  ${chalk.dim('class')}  ${ClassPath.name(node.class)} ${chalk.dim(`(${node.class})`)}`,
-  )
-
-  const properties = Object.entries(node.props)
-  if (properties.length === 0) return
-  console.log(`\n  ${chalk.bold('Properties:')}`)
-  for (const [key, value] of properties) {
-    const rendered = typeof value === 'string' ? value : JSON.stringify(value)
-    console.log(`    ${chalk.cyan(unqualifyProperty(key))}: ${chalk.dim(rendered)}`)
-  }
-}
-
-export default {
-  name: 'describe',
-  description: 'Describe the canonical facts of one node',
-  afterHelpText: `
-Behavior:
-  Reads one canonical Node and presents its ID, Class, and properties.
-  It does not infer operations or children from path layout. --no-schema
-  omits schema-valued properties from Domain-sized results.
-
-Examples:
-  $ astrale describe /:kernel.astrale.ai:class.Domain
-  $ astrale describe @self --no-schema
-`,
-  arguments: [{ name: 'target', description: 'Canonical Node Path or @id' }],
-  options: [
-    { flags: '--no-schema', description: 'Omit properties whose qualified leaf is schema' },
-  ],
-  action: async (target, opts) => {
-    await describeCommand(target as string, opts as DescribeOpts)
-  },
-} satisfies CommandDefinition