@astrale-os/cli 1.0.0-beta.3 → 1.0.0-beta.31

package/studio/shared/contracts/surface.test.ts

@@ -6,10 +6,9 @@ import ts from 'typescript'
 const SHARED_ROOT = resolve(import.meta.dir, '..')
 const STUDIO_ROOT = resolve(SHARED_ROOT, '..')
 
-// Frozen from HEAD's former monolithic shared/types.ts before it was split.
-// Keeping this manifest in the test makes the compatibility proof independent
-// of Git and catches any historical symbol silently dropped by a future move.
-const HISTORICAL_BARREL_EXPORTS = [
+// Closed Studio V1 shared surface. Keeping this manifest independent of Git
+// catches accidental aliases and shadow contracts.
+const TARGET_BARREL_EXPORTS = [
   'AGENT_ACCESS_LEVELS',
   'AGENT_EFFORT_LEVELS',
   'AgentAccess',
@@ -34,9 +33,9 @@ const HISTORICAL_BARREL_EXPORTS = [
   'ContextStore',
   'ConversationInfo',
   'CopyPayload',
-  'CrossDomainImport',
   'DeployRecord',
   'DeployResult',
+  'DOCUMENTS_DIR',
   'DocMeta',
   'DomainAnatomy',
   'DomainCatalogEntry',
@@ -61,15 +60,15 @@ const HISTORICAL_BARREL_EXPORTS = [
   'InstancesState',
   'Integration',
   'IntegrationsState',
+  'IrCallable',
   'IrCallableAuth',
   'IrCallableOutput',
   'IrClass',
-  'IrDefinitionKey',
-  'IrDefinitionRef',
+  'IrClassKey',
+  'IrClassRef',
   'IrEndpoint',
   'IrFunction',
   'IrImportDescriptor',
-  'IrInterface',
   'IrMethod',
   'IrSchemaKey',
   'IrSchemaRef',
@@ -83,7 +82,6 @@ const HISTORICAL_BARREL_EXPORTS = [
   'MethodInheritance',
   'NodePosition',
   'RememberedViewTarget',
-  'SchemaAnnotation',
   'SchemaChange',
   'SchemaChangeKind',
   'SchemaIR',
@@ -108,24 +106,24 @@ const HISTORICAL_BARREL_EXPORTS = [
   'VisibilityState',
 ] as const
 
-// Deliberate canonical identity/revision helpers added alongside the split.
-const INTENTIONAL_BARREL_ADDITIONS = [
+const TARGET_BARREL_HELPERS = [
   'IR_SCHEMA_REF_KINDS',
   'IrSchemaRefKind',
   'STUDIO_SCHEMA_PROJECTION_VERSION',
   'SchemaRevision',
-  'definitionRefKey',
-  'isIrDefinitionRef',
-  'isIrInterfaceRef',
+  'classRefKey',
+  'isIrClassRef',
   'isIrSchemaRef',
+  'isNodePathSchema',
   'isSchemaRevision',
-  'parseDefinitionRefKey',
+  'parseClassRefKey',
   'parseSchemaRefKey',
   'schemaRefKey',
 ] as const
 
 function productionFiles(dir: string): string[] {
   return readdirSync(dir).flatMap((entry) => {
+    if (entry === 'node_modules') return []
     const path = join(dir, entry)
     if (statSync(path).isDirectory()) return productionFiles(path)
     return /\.(?:ts|tsx)$/.test(path) && !/\.test\.(?:ts|tsx)$/.test(path) ? [path] : []
@@ -277,10 +275,10 @@ test('types.ts remains a re-export-only compatibility facade', () => {
   expect(source.statements.every(ts.isExportDeclaration)).toBe(true)
 })
 
-test('types.ts exhaustively preserves its historical named export surface', () => {
+test('types.ts exposes exactly the Studio V1 shared surface', () => {
   const exports = namedExports(join(SHARED_ROOT, 'types.ts'))
   const duplicates = exports.filter((name, index) => exports.indexOf(name) !== index)
-  const expected = [...HISTORICAL_BARREL_EXPORTS, ...INTENTIONAL_BARREL_ADDITIONS].sort()
+  const expected = [...TARGET_BARREL_EXPORTS, ...TARGET_BARREL_HELPERS].sort()
 
   expect(duplicates).toEqual([])
   expect(exports.sort()).toEqual(expected)

package/studio/shared/contracts/workspace.ts

@@ -113,18 +113,12 @@ export interface MergeResult {
 
 export type SchemaChangeKind =
   | 'schema-metadata-changed'
-  | 'type-added'
-  | 'type-removed'
-  | 'type-changed'
   | 'import-added'
   | 'import-removed'
   | 'import-changed'
   | 'class-added'
   | 'class-removed'
   | 'class-contract-changed'
-  | 'interface-added'
-  | 'interface-removed'
-  | 'interface-contract-changed'
   | 'edge-added'
   | 'edge-removed'
   | 'edge-contract-changed'
@@ -208,6 +202,9 @@ export interface DocMeta {
   stored: string
 }
 
+/** Where context documents live inside a domain — shown in the UI, read by the agent. */
+export const DOCUMENTS_DIR = '.domain-studio/context/docs'
+
 export interface Integration {
   id: string
   name: string
@@ -264,11 +261,8 @@ export interface LayoutState {
 
 /** Persisted per-domain canvas visibility. This is the sole authority for its JSON shape. */
 export interface VisibilityState {
-  /** refs hidden on the canvas: `class.X` | `edge.X` | `domain.<origin>` (interfaces use
-   *  `materializedInterfaces`, not this set — see below) */
+  /** Refs hidden on the canvas: `class.X` | `edge.X` | `domain.<origin>`. */
   hidden: Record<string, true>
+  /** Whether local Class inheritance edges are rendered. */
   showInheritedEdges: boolean
-  /** Local interfaces MATERIALIZED as canvas NODES (default = badge). Keyed by BARE interface
-   *  name (e.g. `Fulfillable`) — a set distinct from `hidden`, so no ref namespace collision. */
-  materializedInterfaces: Record<string, true>
 }

package/studio/shared/schema/identity.test.ts

@@ -1,58 +1,34 @@
 import { describe, expect, test } from 'bun:test'
 
 import {
-  IR_SCHEMA_REF_KINDS,
-  definitionRefKey,
-  isIrDefinitionRef,
-  isIrInterfaceRef,
+  classRefKey,
+  isIrClassRef,
   isIrSchemaRef,
-  parseDefinitionRefKey,
+  parseClassRefKey,
   parseSchemaRefKey,
   schemaRefKey,
-  type IrSchemaRef,
 } from './identity'
 
-describe('canonical schema identity', () => {
-  test('round-trips every structural reference kind without short-name aliases', () => {
-    for (const kind of IR_SCHEMA_REF_KINDS) {
-      const ref = {
-        origin: 'directory.example.dev',
-        kind,
-        name: '$Named_member',
-      } satisfies IrSchemaRef
-      expect(parseSchemaRefKey(schemaRefKey(ref))).toEqual(ref)
-    }
+describe('schema identity', () => {
+  test('round-trips exact Class identity', () => {
+    const ref = { origin: 'docs.example.dev', kind: 'class' as const, name: 'Document' }
+    expect(classRefKey(ref)).toBe('docs.example.dev:class.Document')
+    expect(parseClassRefKey(classRefKey(ref))).toEqual(ref)
+    expect(isIrClassRef(ref)).toBe(true)
   })
 
-  test('keeps class and interface identities distinct', () => {
-    const classRef = { origin: 'contracts.example.dev', kind: 'class', name: 'Shared' } as const
-    const interfaceRef = {
-      origin: 'contracts.example.dev',
-      kind: 'interface',
-      name: 'Shared',
-    } as const
-
-    expect(definitionRefKey(classRef)).toBe('contracts.example.dev:class.Shared')
-    expect(definitionRefKey(interfaceRef)).toBe('contracts.example.dev:interface.Shared')
-    expect(parseDefinitionRefKey(definitionRefKey(classRef))).toEqual(classRef)
-    expect(parseDefinitionRefKey(definitionRefKey(interfaceRef))).toEqual(interfaceRef)
-  })
-
-  test('guards structural refs without claiming SDK admission', () => {
-    expect(isIrSchemaRef({ origin: 'a.dev', kind: 'policy', name: 'may_read' })).toBe(true)
-    expect(isIrDefinitionRef({ origin: 'a.dev', kind: 'class', name: 'Thing' })).toBe(true)
-    expect(isIrDefinitionRef({ origin: 'a.dev', kind: 'policy', name: 'may_read' })).toBe(false)
-    expect(isIrInterfaceRef({ origin: 'a.dev', kind: 'interface', name: 'Named' })).toBe(true)
-    expect(isIrInterfaceRef({ origin: 'a.dev', kind: 'class', name: 'Named' })).toBe(false)
-    expect(isIrSchemaRef({ origin: 'a.dev', kind: 'unknown', name: 'Thing' })).toBe(false)
-    expect(isIrSchemaRef({ origin: 'a.dev', kind: 'class' })).toBe(false)
+  test('preserves all supported schema reference kinds', () => {
+    const ref = { origin: 'docs.example.dev', kind: 'function' as const, name: 'search' }
+    expect(schemaRefKey(ref)).toBe('docs.example.dev:function.search')
+    expect(parseSchemaRefKey(schemaRefKey(ref))).toEqual(ref)
+    expect(isIrSchemaRef(ref)).toBe(true)
   })
 
-  test('rejects malformed and non-definition keys', () => {
-    expect(parseSchemaRefKey('a.dev:unknown.Thing')).toBeUndefined()
-    expect(parseSchemaRefKey('a.dev:class.')).toBeUndefined()
-    expect(parseSchemaRefKey(':class.Thing')).toBeUndefined()
-    expect(parseSchemaRefKey(null)).toBeUndefined()
-    expect(parseDefinitionRefKey('a.dev:type.Payload')).toBeUndefined()
+  test('rejects removed Interface coordinates and malformed keys', () => {
+    expect(isIrSchemaRef({ origin: 'docs.example.dev', kind: 'interface', name: 'Named' })).toBe(
+      false,
+    )
+    expect(parseSchemaRefKey('docs.example.dev:interface.Named')).toBeUndefined()
+    expect(parseClassRefKey('docs.example.dev:function.search')).toBeUndefined()
   })
 })

package/studio/shared/schema/identity.ts

@@ -4,16 +4,7 @@
  * These helpers validate and encode only the structural wire coordinate. SDK
  * admission remains the authority for whether a reference is semantically valid.
  */
-
-export const IR_SCHEMA_REF_KINDS = [
-  'type',
-  'interface',
-  'class',
-  'function',
-  'policy',
-  'view',
-  'core',
-] as const
+export const IR_SCHEMA_REF_KINDS = ['class', 'function', 'policy', 'view', 'core'] as const
 
 export type IrSchemaRefKind = (typeof IR_SCHEMA_REF_KINDS)[number]
 
@@ -27,14 +18,12 @@ export interface IrSchemaRef {
 /** Canonical DSL key for a schema member: `origin:kind.name`. */
 export type IrSchemaKey = `${string}:${IrSchemaRefKind}.${string}`
 
-export type IrDefinitionRef = Omit<IrSchemaRef, 'kind'> & {
-  kind: 'class' | 'interface'
-}
+export type IrClassRef = Omit<IrSchemaRef, 'kind'> & { kind: 'class' }
 
-export type IrDefinitionKey = `${string}:${IrDefinitionRef['kind']}.${string}`
+export type IrClassKey = `${string}:class.${string}`
 
 const schemaKinds = new Set<string>(IR_SCHEMA_REF_KINDS)
-const schemaKeyPattern = /^(.+):(type|interface|class|function|policy|view|core)\.(.+)$/
+const schemaKeyPattern = /^(.+):(class|function|policy|view|core)\.(.+)$/
 
 /** Structural guard only; it deliberately does not perform SDK admission. */
 export function isIrSchemaRef(value: unknown): value is IrSchemaRef {
@@ -48,19 +37,15 @@ export function isIrSchemaRef(value: unknown): value is IrSchemaRef {
   )
 }
 
-export function isIrDefinitionRef(value: unknown): value is IrDefinitionRef {
-  return isIrSchemaRef(value) && (value.kind === 'class' || value.kind === 'interface')
-}
-
-export function isIrInterfaceRef(value: unknown): value is IrDefinitionRef & { kind: 'interface' } {
-  return isIrSchemaRef(value) && value.kind === 'interface'
+export function isIrClassRef(value: unknown): value is IrClassRef {
+  return isIrSchemaRef(value) && value.kind === 'class'
 }
 
 export function schemaRefKey(ref: IrSchemaRef): IrSchemaKey {
   return `${ref.origin}:${ref.kind}.${ref.name}`
 }
 
-export function definitionRefKey(ref: IrDefinitionRef): IrDefinitionKey {
+export function classRefKey(ref: IrClassRef): IrClassKey {
   return `${ref.origin}:${ref.kind}.${ref.name}`
 }
 
@@ -76,7 +61,7 @@ export function parseSchemaRefKey(value: unknown): IrSchemaRef | undefined {
   }
 }
 
-export function parseDefinitionRefKey(value: unknown): IrDefinitionRef | undefined {
+export function parseClassRefKey(value: unknown): IrClassRef | undefined {
   const ref = parseSchemaRefKey(value)
-  return ref && isIrDefinitionRef(ref) ? ref : undefined
+  return ref && isIrClassRef(ref) ? ref : undefined
 }

package/studio/tsconfig.json

@@ -19,5 +19,6 @@
       "@shared/*": ["./shared/*"]
     }
   },
-  "include": ["server", "shared", "client/src", "e2e", "playwright.config.ts", "vite.config.ts"]
+  "include": ["server", "shared", "client/src", "e2e", "playwright.config.ts", "vite.config.ts"],
+  "exclude": ["e2e/fixture"]
 }

package/tsconfig.json

@@ -7,7 +7,7 @@
     "strict": true,
     "skipLibCheck": true,
     "noEmit": true,
-    "types": ["@types/bun", "@types/node"]
+    "types": ["bun-types", "@types/node"]
   },
   "include": ["bin", "src"],
   "exclude": ["templates", "**/__tests__/**", "src/lib/view/open-intent.ts"]

package/viewer/dist/index.html

@@ -32,6 +32,8 @@
         display: flex;
         gap: 12px;
         align-items: center;
+        min-width: 0;
+        overflow: hidden;
         padding: 6px 10px;
         border-bottom: 1px solid #26262e;
         flex: none;
@@ -56,6 +58,23 @@
         font-weight: 600;
         color: #e8e8f0;
       }
+      #view-label,
+      #target-label,
+      #identity-label {
+        min-width: 0;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        white-space: nowrap;
+      }
+      #view-label {
+        flex-shrink: 1;
+      }
+      #target-label {
+        flex-shrink: 2;
+      }
+      #identity-label {
+        flex-shrink: 3;
+      }
       .dim {
         color: #7a7a86;
       }
@@ -68,6 +87,8 @@
       }
       #frame {
         flex: 1;
+        min-width: 0;
+        min-height: 0;
         position: relative;
       }
       #frame iframe {