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

package/README.md

@@ -110,7 +110,7 @@ Main command groups:
 
 | Group | What it covers |
 |-------|----------------|
-| Kernel | `get`, `call`, `query`, `describe`, `token` |
+| Kernel | `get`, `call`, `query`, `token` |
 | Context | `status`, `whoami`, `use` |
 | Management | `admin`, `instance`, `identity`, `auth`, `idp`, `update` |
 | Agent | `browser` |

package/dist/astrale.js

@@ -2576,7 +2576,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@astrale-os/cli",
-    version: "0.8.1-alpha.4",
+    version: "0.8.1-alpha.5",
     description: "Astrale CLI — connect to existing Astrale kernels",
     keywords: [
       "astrale",
@@ -90847,91 +90847,6 @@ Examples:
   };
 });
 
-// node_modules/.pnpm/@astrale-os+sdk@file+vendor+astrale-os-sdk-0.5.0-beta.1.tgz_@astrale-os+ox@0.1.2_oxfmt@_72b33f8043e5d121b8114f4a315f9796/node_modules/@astrale-os/sdk/dist/graph/class/index.js
-var init_class3 = __esm(() => {
-  init_class();
-});
-
-// src/commands/describe.ts
-var exports_describe = {};
-__export(exports_describe, {
-  describeCommand: () => describeCommand,
-  default: () => describe_default
-});
-async function describeCommand(target2, opts) {
-  let path5;
-  let meta3;
-  try {
-    ({ path: path5, meta: meta3 } = await expandSelfInPath(target2, opts));
-  } catch (error52) {
-    log.error(error52 instanceof Error ? error52.message : "Invalid target");
-    process.exit(1);
-  }
-  await runKernelCommand({
-    opts,
-    label: `Describe ${path5}`,
-    fn: ({ graph }) => withSelfHint(() => graph.getOrThrow(Path.parse(path5)), meta3),
-    format: (node4, format3, machine) => {
-      const shown = opts.schema === false ? withoutSchema(node4) : node4;
-      if (machine || format3.format !== undefined)
-        output(shown, format3);
-      else
-        printDescription(path5, shown);
-    }
-  });
-}
-function withoutSchema(node4) {
-  return {
-    ...node4,
-    props: Object.fromEntries(Object.entries(node4.props).filter(([key]) => unqualifyProperty(key) !== "schema"))
-  };
-}
-function printDescription(target2, node4) {
-  console.log(`  ${source_default.bold.cyan(target2)}`);
-  console.log(`  ${source_default.dim("id")}     ${node4.id}`);
-  console.log(`  ${source_default.dim("class")}  ${ClassPath.name(node4.class)} ${source_default.dim(`(${node4.class})`)}`);
-  const properties = Object.entries(node4.props);
-  if (properties.length === 0)
-    return;
-  console.log(`
-  ${source_default.bold("Properties:")}`);
-  for (const [key, value2] of properties) {
-    const rendered = typeof value2 === "string" ? value2 : JSON.stringify(value2);
-    console.log(`    ${source_default.cyan(unqualifyProperty(key))}: ${source_default.dim(rendered)}`);
-  }
-}
-var describe_default;
-var init_describe = __esm(() => {
-  init_class3();
-  init_path5();
-  init_source();
-  init_connection2();
-  init_graph6();
-  init_log();
-  init_output();
-  describe_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 (target2, opts) => {
-      await describeCommand(target2, opts);
-    }
-  };
-});
-
 // src/commands/query.ts
 var exports_query = {};
 __export(exports_query, {
@@ -94065,6 +93980,11 @@ var init_create3 = __esm(() => {
   };
 });
 
+// node_modules/.pnpm/@astrale-os+sdk@file+vendor+astrale-os-sdk-0.5.0-beta.1.tgz_@astrale-os+ox@0.1.2_oxfmt@_72b33f8043e5d121b8114f4a315f9796/node_modules/@astrale-os/sdk/dist/graph/class/index.js
+var init_class3 = __esm(() => {
+  init_class();
+});
+
 // node_modules/.pnpm/@astrale-os+sdk@file+vendor+astrale-os-sdk-0.5.0-beta.1.tgz_@astrale-os+ox@0.1.2_oxfmt@_72b33f8043e5d121b8114f4a315f9796/node_modules/@astrale-os/sdk/dist/graph/model/index.js
 var init_model8 = __esm(() => {
   init_graph2();
@@ -95796,7 +95716,8 @@ function renderCommanderError(program2, error, argv = process.argv.slice(2)) {
 `);
 }
 var RETIRED_COMMANDS = {
-  ls: "astrale query <source> --edge <class>"
+  ls: "astrale query <source> --edge <class>",
+  describe: "astrale get <target>"
 };
 function renderUnknownCommand(tokens, catalog) {
   const command = tokens.join(" ");
@@ -96009,7 +95930,6 @@ async function buildProgram() {
   registerCommand(program3, withKernelOptions((await Promise.resolve().then(() => (init_token(), exports_token))).default));
   registerCommand(program3, withKernelOptions((await Promise.resolve().then(() => (init_get(), exports_get))).default));
   registerCommand(program3, withKernelOptions((await Promise.resolve().then(() => (init_mutate4(), exports_mutate))).default));
-  registerCommand(program3, withKernelOptions((await Promise.resolve().then(() => (init_describe(), exports_describe))).default));
   registerCommand(program3, withKernelOptions((await Promise.resolve().then(() => (init_query7(), exports_query))).default));
   registerCommand(program3, withKernelOptions((await Promise.resolve().then(() => (init_logs(), exports_logs))).default));
   registerCommand(program3, withKernelOptions((await Promise.resolve().then(() => (init_view6(), exports_view2))).default));
@@ -96096,7 +96016,7 @@ async function buildProgram() {
   program3.addHelpText("after", `
 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, 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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/cli",
-  "version": "0.8.1-alpha.4",
+  "version": "0.8.1-alpha.5",
   "description": "Astrale CLI — connect to existing Astrale kernels",
   "keywords": [
     "astrale",

package/src/lib/__tests__/command-dx.test.ts

@@ -23,8 +23,10 @@ describe('command DX suggestions', () => {
     expect(usages).toContain('use <name>')
     expect(usages).toContain('update')
     expect(usages).toContain('query [sources...]')
+    expect(usages).toContain('get <target>')
     expect(usages).toContain('status')
     expect(usages).not.toContain('ls <source>')
+    expect(usages).not.toContain('describe <target>')
   })
 
   test('explains shared verbs as namespaced commands, not arity errors', async () => {
@@ -43,6 +45,21 @@ describe('command DX suggestions', () => {
     expect(rendered).not.toContain('too many arguments')
   })
 
+  test('points retired describe at get', async () => {
+    const program = await buildProgram()
+    const error = new CommanderError(
+      1,
+      'commander.unknownCommand',
+      "error: unknown command 'describe'",
+    )
+    const rendered = stripAnsi(renderCommanderError(program, error, ['describe', '@note']))
+
+    expect(rendered).toContain('Unknown command: astrale describe @note')
+    expect(rendered).toContain('astrale describe` was removed')
+    expect(rendered).toContain('astrale get <target>')
+    expect(rendered).not.toContain('Did you mean:')
+  })
+
   test('points retired ls at query', async () => {
     const program = await buildProgram()
     const error = new CommanderError(1, 'commander.unknownCommand', "error: unknown command 'ls'")

package/src/lib/command-dx.ts

@@ -74,6 +74,7 @@ export function renderCommanderError(
 
 const RETIRED_COMMANDS: Record<string, string> = {
   ls: 'astrale query <source> --edge <class>',
+  describe: 'astrale get <target>',
 }
 
 function renderUnknownCommand(tokens: string[], catalog: CommandCatalogEntry[]): string {

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

@@ -138,7 +138,6 @@ describe('program composition', () => {
       'auth token',
       'browser',
       'call',
-      'describe',
       'domain',
       'domain install',
       'domain list',
@@ -186,7 +185,7 @@ describe('program composition', () => {
       'whoami',
     ])
     expect(createHash('sha256').update(JSON.stringify(surface)).digest('hex')).toBe(
-      '4b053fe80827aeb40aecc13cd17c293b8701e59cb04f5ccb8185e9e255376dd1',
+      '369e7d1d51871f0ca1c6007d2a5c45023d093e70b85db07c1f58b06b7a0b17d4',
     )
   })
 
@@ -279,6 +278,7 @@ describe('help contract — connect-only command surface', () => {
       'server',
       'env',
       'ls',
+      'describe',
     ]) {
       expect(names).not.toContain(removed)
     }

package/src/program/build.ts

@@ -61,7 +61,6 @@ 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/logs')).default))
   registerCommand(program, withKernelOptions((await import('../commands/view')).default))
@@ -158,7 +157,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, 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)

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