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

package/README.md

@@ -110,7 +110,7 @@ Main command groups:
 
 | Group | What it covers |
 |-------|----------------|
-| Kernel | `ls`, `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.3",
+    version: "0.8.1-alpha.5",
     description: "Astrale CLI — connect to existing Astrale kernels",
     keywords: [
       "astrale",
@@ -90847,200 +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/ls.ts
-var exports_ls = {};
-__export(exports_ls, {
-  lsCommand: () => lsCommand,
-  listProjection: () => listProjection,
-  displayName: () => displayName,
-  default: () => ls_default
-});
-async function lsCommand(source2, opts) {
-  if (opts.edge === undefined) {
-    log.error("ls requires --edge <class>; Kernel V2 has no universal child relation");
-    process.exit(1);
-  }
-  let path5;
-  let meta3;
-  let prepared;
-  try {
-    ({ path: path5, meta: meta3 } = await expandSelfInPath(source2, opts));
-    prepared = prepareQuery({
-      sources: [path5],
-      edge: opts.edge,
-      direction: opts.direction,
-      limit: opts.limit,
-      cursor: opts.cursor
-    });
-  } catch (error52) {
-    log.error(error52 instanceof Error ? error52.message : "Invalid edge neighborhood");
-    process.exit(1);
-  }
-  await runKernelCommand({
-    opts,
-    label: `Neighbors of ${path5}`,
-    fn: ({ graph }) => withSelfHint(() => graph.query(prepared.ast, { page: prepared.page }), meta3),
-    format: (response2, format3) => {
-      const graph = completeGraph(response2.result);
-      presentList([...graph.nodes], { ...format3, long: opts.long, quiet: opts.quiet, count: opts.count }, listProjection);
-      if (response2.page.next && !isMachine(format3) && !opts.quiet && !opts.count) {
-        process.stderr.write(`  cursor: ${response2.page.next}
-`);
-      }
-    }
-  });
-}
-function completeGraph(result) {
-  if (result.kind !== "graph")
-    throw new TypeError("ls expected one complete graph Query result");
-  return result.graph;
-}
-function listProjection(nodes) {
-  return {
-    columns: [
-      { key: "name", header: "NAME", color: source_default.cyan },
-      { key: "class", header: "CLASS", color: source_default.dim },
-      { key: "id", header: "ID", color: source_default.dim }
-    ],
-    rows: nodes.map((node4) => ({
-      name: displayName(node4),
-      class: ClassPath.name(node4.class),
-      id: node4.id
-    })),
-    paths: nodes.map((node4) => `@${node4.id}`)
-  };
-}
-function displayName(node4) {
-  const value2 = nodeProperty(node4, "name") ?? nodeProperty(node4, "title") ?? nodeProperty(node4, "slug");
-  return typeof value2 === "string" && value2.length > 0 ? value2 : `@${node4.id}`;
-}
-var ls_default;
-var init_ls = __esm(() => {
-  init_class3();
-  init_source();
-  init_connection2();
-  init_graph6();
-  init_log();
-  init_output();
-  ls_default = {
-    name: "ls",
-    description: "List one finite exact edge neighborhood",
-    afterHelpText: `
-Behavior:
-  Lists Nodes reached from one source through one exact Edge Class. Kernel V2
-  has no universal parent/child relation, so --edge is required and recursive
-  tree walking is intentionally absent. Direction defaults to outgoing and the
-  finite default limit is 100. -q emits one @id per line.
-
-Examples:
-  $ astrale ls @note --edge /:notes.example.dev:class.references
-  $ astrale ls @note --edge /:notes.example.dev:class.references --direction incoming --limit 25
-`,
-    arguments: [{ name: "source", description: "Canonical source Path or @id" }],
-    options: [
-      { flags: "--edge <class>", description: "Exact Edge Class to traverse" },
-      {
-        flags: "--direction <direction>",
-        description: "Traversal direction (default: outgoing)",
-        choices: ["outgoing", "incoming", "incident"]
-      },
-      { flags: "--limit <n>", description: "Finite selected Node limit (default: 100)" },
-      { flags: "--cursor <token>", description: "Resume one live query scope" },
-      { flags: "-l, --long", description: "Print complete canonical Nodes" },
-      { flags: "-q, --quiet", description: "Print one @id per line" },
-      { flags: "--count", description: "Print only the number of returned Nodes" }
-    ],
-    action: async (source2, opts) => {
-      await lsCommand(source2, opts);
-    }
-  };
-});
-
-// 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, {
@@ -93569,7 +93375,7 @@ Behavior:
   Reads the admin catalog — every domain that has been \`publish\`ed
   (origin → published worker URL). Listing only shows what is INSTALLABLE;
   what is actually mounted where lives on each instance's own graph
-  (\`astrale ls /\` against that instance).
+  (\`astrale query\` against that instance).
 
   Default output is a NAME/ORIGIN/URL/DEFAULT table on a TTY, JSON when piped
   or with --json/--raw (agent-friendly — full DomainInfo objects). -q prints
@@ -94174,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();
@@ -95904,9 +95715,22 @@ function renderCommanderError(program2, error, argv = process.argv.slice(2)) {
   ].join(`
 `);
 }
+var RETIRED_COMMANDS = {
+  ls: "astrale query <source> --edge <class>",
+  describe: "astrale get <target>"
+};
 function renderUnknownCommand(tokens, catalog) {
   const command = tokens.join(" ");
   const first = tokens[0];
+  const retired = first === undefined ? undefined : RETIRED_COMMANDS[first];
+  if (retired !== undefined) {
+    return [
+      `Unknown command: ${source_default.bold(`astrale ${command}`)}`,
+      "",
+      `\`astrale ${first}\` was removed. Use ${source_default.bold(retired)} instead.`
+    ].join(`
+`);
+  }
   const namespaceMatches = catalog.filter((entry) => entry.path.at(-1) === first);
   if (namespaceMatches.length > 0) {
     return [
@@ -96106,8 +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_ls(), exports_ls))).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));
@@ -96194,7 +96016,7 @@ async function buildProgram() {
   program3.addHelpText("after", `
 Command groups:
   Getting started  setup     (sign in, pick an instance, equip your workspace)
-  Kernel        ls, 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)
@@ -96208,7 +96030,6 @@ Path syntax:
   @nodeId::method                Instance method on a node by UID
 
 Examples:
-  $ astrale ls @note --edge /:notes.example.dev:class.references
   $ astrale studio
   $ astrale admin status
   $ astrale update --check

package/package.json

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

package/src/commands/__tests__/read-commands.test.ts

@@ -218,18 +218,6 @@ describe('get command', () => {
   })
 })
 
-describe('ls command', () => {
-  /** @evidence TEST-CLI-LS-REQUIRES-EXACT-EDGE-BEFORE-CONNECTION */
-  test('rejects a generic child listing before opening the command connection', async () => {
-    const { lsCommand } = await import('../ls')
-
-    await expect(lsCommand('@node', { json: true })).rejects.toEqual(new ExitError(1))
-
-    expect(runKernelCommandMock).not.toHaveBeenCalled()
-    expect(errors.join('\n')).toContain('Kernel V2 has no universal child relation')
-  })
-})
-
 describe('mutate command', () => {
   /** @evidence TEST-CLI-MUTATE-DISPATCHES-CANONICAL-V3 */
   test('admits authoring input and dispatches one canonical Mutation V3 document', async () => {

package/src/commands/domain/list.ts

@@ -66,7 +66,7 @@ Behavior:
   Reads the admin catalog — every domain that has been \`publish\`ed
   (origin → published worker URL). Listing only shows what is INSTALLABLE;
   what is actually mounted where lives on each instance's own graph
-  (\`astrale ls /\` against that instance).
+  (\`astrale query\` against that instance).
 
   Default output is a NAME/ORIGIN/URL/DEFAULT table on a TTY, JSON when piped
   or with --json/--raw (agent-friendly — full DomainInfo objects). -q prints

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

@@ -22,8 +22,11 @@ describe('command DX suggestions', () => {
     expect(usages).toContain('admin use [bookmark]')
     expect(usages).toContain('use <name>')
     expect(usages).toContain('update')
-    expect(usages).toContain('ls <source>')
+    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 () => {
@@ -42,6 +45,32 @@ 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'")
+    const rendered = stripAnsi(renderCommanderError(program, error, ['ls', '@note']))
+
+    expect(rendered).toContain('Unknown command: astrale ls @note')
+    expect(rendered).toContain('astrale ls` was removed')
+    expect(rendered).toContain('astrale query <source> --edge <class>')
+    expect(rendered).not.toContain('Did you mean:')
+  })
+
   test('suggests nearest command for typo paths', async () => {
     const program = await buildProgram()
     const error = new CommanderError(

package/src/lib/command-dx.ts

@@ -72,9 +72,22 @@ export function renderCommanderError(
   ].join('\n')
 }
 
+const RETIRED_COMMANDS: Record<string, string> = {
+  ls: 'astrale query <source> --edge <class>',
+  describe: 'astrale get <target>',
+}
+
 function renderUnknownCommand(tokens: string[], catalog: CommandCatalogEntry[]): string {
   const command = tokens.join(' ')
   const first = tokens[0]
+  const retired = first === undefined ? undefined : RETIRED_COMMANDS[first]
+  if (retired !== undefined) {
+    return [
+      `Unknown command: ${chalk.bold(`astrale ${command}`)}`,
+      '',
+      `\`astrale ${first}\` was removed. Use ${chalk.bold(retired)} instead.`,
+    ].join('\n')
+  }
   const namespaceMatches = catalog.filter((entry) => entry.path.at(-1) === first)
   if (namespaceMatches.length > 0) {
     return [

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

@@ -138,7 +138,6 @@ describe('program composition', () => {
       'auth token',
       'browser',
       'call',
-      'describe',
       'domain',
       'domain install',
       'domain list',
@@ -171,7 +170,6 @@ describe('program composition', () => {
       'instance status',
       'instance use',
       'logs',
-      'ls',
       'mutate',
       'query',
       'session',
@@ -187,7 +185,7 @@ describe('program composition', () => {
       'whoami',
     ])
     expect(createHash('sha256').update(JSON.stringify(surface)).digest('hex')).toBe(
-      '4a57bfc347f9abebcea239427214eb25fbaf9ca704170c8b4a933d0c9ba4d14e',
+      '369e7d1d51871f0ca1c6007d2a5c45023d093e70b85db07c1f58b06b7a0b17d4',
     )
   })
 
@@ -267,7 +265,7 @@ describe('help contract — connect-only command surface', () => {
     const program = await buildProgram()
     const names = allCommands(program).map((command) => command.name())
 
-    // `logs` and `domain` have managed/admin meanings, so only retired local-runtime verbs are absent.
+    // `logs` and `domain` have managed/admin meanings, so only retired verbs are absent.
     for (const removed of [
       'init',
       'start',
@@ -279,6 +277,8 @@ describe('help contract — connect-only command surface', () => {
       'graph',
       'server',
       'env',
+      'ls',
+      'describe',
     ]) {
       expect(names).not.toContain(removed)
     }

package/src/program/build.ts

@@ -61,8 +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/ls')).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))
@@ -159,7 +157,7 @@ export async function buildProgram(): Promise<Command> {
     `
 Command groups:
   Getting started  setup     (sign in, pick an instance, equip your workspace)
-  Kernel        ls, 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)
@@ -173,7 +171,6 @@ Path syntax:
   @nodeId::method                Instance method on a node by UID
 
 Examples:
-  $ astrale ls @note --edge /:notes.example.dev:class.references
   $ astrale studio
   $ astrale admin status
   $ astrale update --check

package/src/telemetry/__tests__/gate.test.ts

@@ -49,7 +49,7 @@ describe('extractSignals / hasSignals', () => {
   })
 
   test('quiet session has no signals until a transcript is attached', () => {
-    const s = extractSignals([ev(['status'], 0), ev(['ls', '/'], 0)])
+    const s = extractSignals([ev(['status'], 0), ev(['query', '/'], 0)])
     expect(hasSignals(s)).toBe(false)
     s.harnessSessions = [
       {

package/src/commands/__tests__/ls.test.ts

@@ -1,29 +0,0 @@
-import type { Node } from '@astrale-os/sdk/graph/node'
-
-import { ClassPath } from '@astrale-os/sdk/graph/class'
-import { NodeId } from '@astrale-os/sdk/graph/node'
-import { normalizeProperties } from '@astrale-os/sdk/graph/properties'
-import { describe, expect, test } from 'bun:test'
-
-import { displayName, listProjection } from '../ls'
-
-describe('ls display projection', () => {
-  const node = {
-    id: NodeId('note-1'),
-    class: ClassPath.parse('/:notes.example.dev:class.Note'),
-    props: normalizeProperties({ 'notes.example.dev:class.Note.property.title': 'Hello' }),
-  } satisfies Node
-
-  /** @evidence TEST-CLI-LS-PROJECTS-CANONICAL-NODES */
-  test('uses canonical properties for display and @id for pipeable output', () => {
-    expect(displayName(node)).toBe('Hello')
-    expect(listProjection([node])).toMatchObject({
-      rows: [{ name: 'Hello', class: 'Note', id: 'note-1' }],
-      paths: ['@note-1'],
-    })
-  })
-
-  test('falls back to the canonical Node ID when no display property exists', () => {
-    expect(displayName({ ...node, props: normalizeProperties({}) })).toBe('@note-1')
-  })
-})

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

package/src/commands/ls.ts

@@ -1,125 +0,0 @@
-import type { Node } from '@astrale-os/sdk/graph/node'
-import type { QueryDirection, QueryResult } from '@astrale-os/sdk/query'
-
-import { ClassPath } from '@astrale-os/sdk/graph/class'
-import chalk from 'chalk'
-
-import type { KernelCommandOpts } from '../connection'
-import type { ListProjection } from '../lib/output'
-import type { CommandDefinition } from '../program/index'
-
-import { expandSelfInPath, runKernelCommand, withSelfHint } from '../connection'
-import { nodeProperty, prepareQuery } from '../graph/index'
-import { log } from '../lib/log'
-import { isMachine, presentList } from '../lib/output'
-
-type LsOpts = KernelCommandOpts & {
-  edge?: string
-  direction?: QueryDirection
-  limit?: string
-  cursor?: string
-  long?: boolean
-  quiet?: boolean
-  count?: boolean
-}
-
-export async function lsCommand(source: string, opts: LsOpts): Promise<void> {
-  if (opts.edge === undefined) {
-    log.error('ls requires --edge <class>; Kernel V2 has no universal child relation')
-    process.exit(1)
-  }
-
-  let path: string
-  let meta
-  let prepared
-  try {
-    ;({ path, meta } = await expandSelfInPath(source, opts))
-    prepared = prepareQuery({
-      sources: [path],
-      edge: opts.edge,
-      direction: opts.direction,
-      limit: opts.limit,
-      cursor: opts.cursor,
-    })
-  } catch (error) {
-    log.error(error instanceof Error ? error.message : 'Invalid edge neighborhood')
-    process.exit(1)
-  }
-
-  await runKernelCommand({
-    opts,
-    label: `Neighbors of ${path}`,
-    fn: ({ graph }) => withSelfHint(() => graph.query(prepared.ast, { page: prepared.page }), meta),
-    format: (response, format) => {
-      const graph = completeGraph(response.result)
-      presentList(
-        [...graph.nodes],
-        { ...format, long: opts.long, quiet: opts.quiet, count: opts.count },
-        listProjection,
-      )
-      if (response.page.next && !isMachine(format) && !opts.quiet && !opts.count) {
-        process.stderr.write(`  cursor: ${response.page.next}\n`)
-      }
-    },
-  })
-}
-
-function completeGraph(result: QueryResult) {
-  if (result.kind !== 'graph') throw new TypeError('ls expected one complete graph Query result')
-  return result.graph
-}
-
-export function listProjection(nodes: Node[]): ListProjection {
-  return {
-    columns: [
-      { key: 'name', header: 'NAME', color: chalk.cyan },
-      { key: 'class', header: 'CLASS', color: chalk.dim },
-      { key: 'id', header: 'ID', color: chalk.dim },
-    ],
-    rows: nodes.map((node) => ({
-      name: displayName(node),
-      class: ClassPath.name(node.class),
-      id: node.id,
-    })),
-    paths: nodes.map((node) => `@${node.id}`),
-  }
-}
-
-export function displayName(node: Node): string {
-  const value =
-    nodeProperty(node, 'name') ?? nodeProperty(node, 'title') ?? nodeProperty(node, 'slug')
-  return typeof value === 'string' && value.length > 0 ? value : `@${node.id}`
-}
-
-export default {
-  name: 'ls',
-  description: 'List one finite exact edge neighborhood',
-  afterHelpText: `
-Behavior:
-  Lists Nodes reached from one source through one exact Edge Class. Kernel V2
-  has no universal parent/child relation, so --edge is required and recursive
-  tree walking is intentionally absent. Direction defaults to outgoing and the
-  finite default limit is 100. -q emits one @id per line.
-
-Examples:
-  $ astrale ls @note --edge /:notes.example.dev:class.references
-  $ astrale ls @note --edge /:notes.example.dev:class.references --direction incoming --limit 25
-`,
-  arguments: [{ name: 'source', description: 'Canonical source Path or @id' }],
-  options: [
-    { flags: '--edge <class>', description: 'Exact Edge Class to traverse' },
-    {
-      flags: '--direction <direction>',
-      description: 'Traversal direction (default: outgoing)',
-      choices: ['outgoing', 'incoming', 'incident'],
-    },
-    { flags: '--limit <n>', description: 'Finite selected Node limit (default: 100)' },
-    { flags: '--cursor <token>', description: 'Resume one live query scope' },
-    { flags: '-l, --long', description: 'Print complete canonical Nodes' },
-    { flags: '-q, --quiet', description: 'Print one @id per line' },
-    { flags: '--count', description: 'Print only the number of returned Nodes' },
-  ],
-  action: async (source, opts) => {
-    await lsCommand(source as string, opts as LsOpts)
-  },
-} satisfies CommandDefinition