@quenty/studio-bridge 0.7.1 → 0.9.0

package/dist/src/commands/framework/arg-builder.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the arg builder DSL and schema converters.
+ */
+export {};
+//# sourceMappingURL=arg-builder.test.d.ts.map

package/dist/src/commands/framework/arg-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-builder.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/framework/arg-builder.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/commands/framework/arg-builder.test.js

@@ -0,0 +1,246 @@
+/**
+ * Unit tests for the arg builder DSL and schema converters.
+ */
+import { describe, it, expect } from 'vitest';
+import { arg, toYargsOptions, toJsonSchema } from './arg-builder.js';
+describe('arg.positional', () => {
+    it('creates a positional arg definition', () => {
+        const def = arg.positional({ description: 'Source code' });
+        expect(def.kind).toBe('positional');
+        expect(def.description).toBe('Source code');
+    });
+    it('defaults to string type', () => {
+        const def = arg.positional({ description: 'test' });
+        expect(def.type).toBe('string');
+    });
+    it('respects explicit number type', () => {
+        const def = arg.positional({ description: 'test', type: 'number' });
+        expect(def.type).toBe('number');
+    });
+    it('defaults to required', () => {
+        const def = arg.positional({ description: 'test' });
+        expect(def.required).toBe(true);
+    });
+    it('allows optional positionals', () => {
+        const def = arg.positional({ description: 'test', required: false });
+        expect(def.required).toBe(false);
+    });
+    it('supports choices', () => {
+        const def = arg.positional({
+            description: 'Direction',
+            choices: ['head', 'tail'],
+        });
+        expect(def.choices).toEqual(['head', 'tail']);
+    });
+});
+describe('arg.option', () => {
+    it('creates an option arg definition', () => {
+        const def = arg.option({ description: 'Max count' });
+        expect(def.kind).toBe('option');
+        expect(def.description).toBe('Max count');
+    });
+    it('defaults to string type', () => {
+        const def = arg.option({ description: 'test' });
+        expect(def.type).toBe('string');
+    });
+    it('supports number type', () => {
+        const def = arg.option({ description: 'test', type: 'number' });
+        expect(def.type).toBe('number');
+    });
+    it('supports alias', () => {
+        const def = arg.option({ description: 'test', alias: 'n' });
+        expect(def.alias).toBe('n');
+    });
+    it('supports default value', () => {
+        const def = arg.option({
+            description: 'test',
+            type: 'number',
+            default: 50,
+        });
+        expect(def.default).toBe(50);
+    });
+    it('supports required flag', () => {
+        const def = arg.option({ description: 'test', required: true });
+        expect(def.required).toBe(true);
+    });
+    it('supports choices', () => {
+        const def = arg.option({
+            description: 'Mode',
+            choices: ['text', 'json'],
+        });
+        expect(def.choices).toEqual(['text', 'json']);
+    });
+    it('supports array flag', () => {
+        const def = arg.option({ description: 'Levels', array: true });
+        expect(def.array).toBe(true);
+    });
+});
+describe('arg.flag', () => {
+    it('creates a flag arg definition', () => {
+        const def = arg.flag({ description: 'Include children' });
+        expect(def.kind).toBe('flag');
+        expect(def.type).toBe('boolean');
+    });
+    it('defaults to false', () => {
+        const def = arg.flag({ description: 'test' });
+        expect(def.default).toBe(false);
+    });
+    it('allows default true', () => {
+        const def = arg.flag({ description: 'test', default: true });
+        expect(def.default).toBe(true);
+    });
+    it('supports alias', () => {
+        const def = arg.flag({ description: 'test', alias: 'c' });
+        expect(def.alias).toBe('c');
+    });
+});
+describe('toYargsOptions', () => {
+    it('separates positionals from options', () => {
+        const result = toYargsOptions({
+            code: arg.positional({ description: 'Source' }),
+            count: arg.option({ description: 'Max', type: 'number' }),
+            verbose: arg.flag({ description: 'Verbose' }),
+        });
+        expect(result.positionals).toHaveLength(1);
+        expect(result.positionals[0].name).toBe('code');
+        expect(Object.keys(result.options)).toEqual(['count', 'verbose']);
+    });
+    it('converts positional fields', () => {
+        const result = toYargsOptions({
+            path: arg.positional({
+                description: 'DataModel path',
+                choices: ['Workspace', 'ServerStorage'],
+            }),
+        });
+        const pos = result.positionals[0];
+        expect(pos.options.describe).toBe('DataModel path');
+        expect(pos.options.type).toBe('string');
+        expect(pos.options.demandOption).toBe(true);
+        expect(pos.options.choices).toEqual(['Workspace', 'ServerStorage']);
+    });
+    it('converts option fields', () => {
+        const result = toYargsOptions({
+            count: arg.option({
+                description: 'Number of entries',
+                type: 'number',
+                alias: 'n',
+                default: 50,
+            }),
+        });
+        const opt = result.options.count;
+        expect(opt.describe).toBe('Number of entries');
+        expect(opt.type).toBe('number');
+        expect(opt.alias).toBe('n');
+        expect(opt.default).toBe(50);
+    });
+    it('converts flag fields', () => {
+        const result = toYargsOptions({
+            json: arg.flag({ description: 'Output JSON', alias: 'j' }),
+        });
+        const opt = result.options.json;
+        expect(opt.describe).toBe('Output JSON');
+        expect(opt.type).toBe('boolean');
+        expect(opt.alias).toBe('j');
+        expect(opt.default).toBe(false);
+    });
+    it('omits undefined optional fields from options', () => {
+        const result = toYargsOptions({
+            name: arg.option({ description: 'Name' }),
+        });
+        const opt = result.options.name;
+        expect(opt).not.toHaveProperty('alias');
+        expect(opt).not.toHaveProperty('default');
+        expect(opt).not.toHaveProperty('choices');
+        expect(opt).not.toHaveProperty('array');
+    });
+    it('returns empty arrays for no args', () => {
+        const result = toYargsOptions({});
+        expect(result.positionals).toEqual([]);
+        expect(result.options).toEqual({});
+    });
+});
+describe('toJsonSchema', () => {
+    it('generates a valid object schema', () => {
+        const schema = toJsonSchema({
+            code: arg.positional({ description: 'Source code' }),
+        });
+        expect(schema.type).toBe('object');
+        expect(schema.additionalProperties).toBe(false);
+        expect(schema.properties.code).toBeDefined();
+    });
+    it('includes required positionals in required array', () => {
+        const schema = toJsonSchema({
+            code: arg.positional({ description: 'Source code' }),
+        });
+        expect(schema.required).toEqual(['code']);
+    });
+    it('includes required options in required array', () => {
+        const schema = toJsonSchema({
+            target: arg.option({ description: 'Target', required: true }),
+        });
+        expect(schema.required).toEqual(['target']);
+    });
+    it('omits required array when no args are required', () => {
+        const schema = toJsonSchema({
+            count: arg.option({ description: 'Count', type: 'number' }),
+            verbose: arg.flag({ description: 'Verbose' }),
+        });
+        expect(schema).not.toHaveProperty('required');
+    });
+    it('maps string type', () => {
+        const schema = toJsonSchema({
+            name: arg.option({ description: 'Name' }),
+        });
+        expect(schema.properties.name.type).toBe('string');
+    });
+    it('maps number type', () => {
+        const schema = toJsonSchema({
+            count: arg.option({ description: 'Count', type: 'number' }),
+        });
+        expect(schema.properties.count.type).toBe('number');
+    });
+    it('maps boolean type for flags', () => {
+        const schema = toJsonSchema({
+            verbose: arg.flag({ description: 'Verbose' }),
+        });
+        expect(schema.properties.verbose.type).toBe('boolean');
+    });
+    it('maps array options', () => {
+        const schema = toJsonSchema({
+            levels: arg.option({ description: 'Log levels', array: true }),
+        });
+        expect(schema.properties.levels.type).toBe('array');
+        expect(schema.properties.levels.items).toEqual({ type: 'string' });
+    });
+    it('maps choices to enum', () => {
+        const schema = toJsonSchema({
+            direction: arg.option({
+                description: 'Direction',
+                choices: ['head', 'tail'],
+            }),
+        });
+        expect(schema.properties.direction.enum).toEqual(['head', 'tail']);
+    });
+    it('includes default values', () => {
+        const schema = toJsonSchema({
+            count: arg.option({ description: 'Count', type: 'number', default: 50 }),
+        });
+        expect(schema.properties.count.default).toBe(50);
+    });
+    it('includes description on all properties', () => {
+        const schema = toJsonSchema({
+            code: arg.positional({ description: 'Source code' }),
+            count: arg.option({ description: 'Max entries', type: 'number' }),
+            json: arg.flag({ description: 'JSON output' }),
+        });
+        expect(schema.properties.code.description).toBe('Source code');
+        expect(schema.properties.count.description).toBe('Max entries');
+        expect(schema.properties.json.description).toBe('JSON output');
+    });
+    it('returns empty properties for no args', () => {
+        const schema = toJsonSchema({});
+        expect(schema.properties).toEqual({});
+        expect(schema).not.toHaveProperty('required');
+    });
+});
+//# sourceMappingURL=arg-builder.test.js.map

package/dist/src/commands/framework/arg-builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-builder.test.js","sourceRoot":"","sources":["../../../../src/commands/framework/arg-builder.test.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/framework/command-registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Command registry — collects `CommandDefinition` objects and provides
+ * lookup by group, name, category, and scope.
+ */
+import type { CommandDefinition, CommandCategory } from './define-command.js';
+export declare class CommandRegistry {
+    private _commands;
+    /** Register a command definition. */
+    register(def: CommandDefinition): void;
+    /** Return all registered commands in insertion order. */
+    getAll(): readonly CommandDefinition[];
+    /** Return commands belonging to a specific group. */
+    getByGroup(group: string): readonly CommandDefinition[];
+    /** Return unique group names (excluding top-level commands). */
+    getGroups(): string[];
+    /** Return top-level commands (group is `null`). */
+    getTopLevel(): readonly CommandDefinition[];
+    /** Return commands in a given category. */
+    getByCategory(category: CommandCategory): readonly CommandDefinition[];
+    /** Find a specific command by group and name. */
+    get(group: string | null, name: string): CommandDefinition | undefined;
+}
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/src/commands/framework/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../../../src/commands/framework/command-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE9E,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA2B;IAE5C,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAItC,yDAAyD;IACzD,MAAM,IAAI,SAAS,iBAAiB,EAAE;IAItC,qDAAqD;IACrD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,iBAAiB,EAAE;IAIvD,gEAAgE;IAChE,SAAS,IAAI,MAAM,EAAE;IAUrB,mDAAmD;IACnD,WAAW,IAAI,SAAS,iBAAiB,EAAE;IAI3C,2CAA2C;IAC3C,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,iBAAiB,EAAE;IAItE,iDAAiD;IACjD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;CAGvE"}

package/dist/src/commands/framework/command-registry.js

@@ -0,0 +1,42 @@
+/**
+ * Command registry — collects `CommandDefinition` objects and provides
+ * lookup by group, name, category, and scope.
+ */
+export class CommandRegistry {
+    _commands = [];
+    /** Register a command definition. */
+    register(def) {
+        this._commands.push(def);
+    }
+    /** Return all registered commands in insertion order. */
+    getAll() {
+        return this._commands;
+    }
+    /** Return commands belonging to a specific group. */
+    getByGroup(group) {
+        return this._commands.filter((d) => d.group === group);
+    }
+    /** Return unique group names (excluding top-level commands). */
+    getGroups() {
+        const groups = new Set();
+        for (const cmd of this._commands) {
+            if (cmd.group !== null) {
+                groups.add(cmd.group);
+            }
+        }
+        return [...groups];
+    }
+    /** Return top-level commands (group is `null`). */
+    getTopLevel() {
+        return this._commands.filter((d) => d.group === null);
+    }
+    /** Return commands in a given category. */
+    getByCategory(category) {
+        return this._commands.filter((d) => d.category === category);
+    }
+    /** Find a specific command by group and name. */
+    get(group, name) {
+        return this._commands.find((d) => d.group === group && d.name === name);
+    }
+}
+//# sourceMappingURL=command-registry.js.map

package/dist/src/commands/framework/command-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../../../src/commands/framework/command-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,OAAO,eAAe;IAClB,SAAS,GAAwB,EAAE,CAAC;IAE5C,qCAAqC;IACrC,QAAQ,CAAC,GAAsB;QAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,yDAAyD;IACzD,MAAM;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,qDAAqD;IACrD,UAAU,CAAC,KAAa;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,gEAAgE;IAChE,SAAS;QACP,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,mDAAmD;IACnD,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,2CAA2C;IAC3C,aAAa,CAAC,QAAyB;QACrC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED,iDAAiD;IACjD,GAAG,CAAC,KAAoB,EAAE,IAAY;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/src/commands/framework/command-registry.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the CommandRegistry.
+ */
+export {};
+//# sourceMappingURL=command-registry.test.d.ts.map

package/dist/src/commands/framework/command-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/framework/command-registry.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/commands/framework/command-registry.test.js

@@ -0,0 +1,158 @@
+/**
+ * Unit tests for the CommandRegistry.
+ */
+import { describe, it, expect } from 'vitest';
+import { CommandRegistry } from './command-registry.js';
+import { defineCommand } from './define-command.js';
+function makeCommand(overrides = {}) {
+    const scope = overrides.scope ?? 'session';
+    const base = {
+        group: overrides.group === undefined
+            ? 'console'
+            : overrides.group,
+        name: overrides.name ?? 'exec',
+        description: 'Test command',
+        category: overrides.category ?? 'execution',
+        safety: overrides.safety ?? 'mutate',
+        args: {},
+    };
+    if (scope === 'session') {
+        return defineCommand({
+            ...base,
+            scope: 'session',
+            handler: async () => ({}),
+        });
+    }
+    else if (scope === 'connection') {
+        return defineCommand({
+            ...base,
+            scope: 'connection',
+            handler: async () => ({}),
+        });
+    }
+    else {
+        return defineCommand({
+            ...base,
+            scope: 'standalone',
+            handler: async () => ({}),
+        });
+    }
+}
+describe('CommandRegistry', () => {
+    describe('register / getAll', () => {
+        it('registers and retrieves commands', () => {
+            const registry = new CommandRegistry();
+            const cmd = makeCommand();
+            registry.register(cmd);
+            expect(registry.getAll()).toHaveLength(1);
+            expect(registry.getAll()[0]).toBe(cmd);
+        });
+        it('maintains insertion order', () => {
+            const registry = new CommandRegistry();
+            const a = makeCommand({ name: 'alpha' });
+            const b = makeCommand({ name: 'beta' });
+            const c = makeCommand({ name: 'charlie' });
+            registry.register(a);
+            registry.register(b);
+            registry.register(c);
+            const names = registry.getAll().map((d) => d.name);
+            expect(names).toEqual(['alpha', 'beta', 'charlie']);
+        });
+        it('returns empty array when no commands registered', () => {
+            const registry = new CommandRegistry();
+            expect(registry.getAll()).toEqual([]);
+        });
+    });
+    describe('getByGroup', () => {
+        it('filters by group name', () => {
+            const registry = new CommandRegistry();
+            registry.register(makeCommand({ group: 'console', name: 'exec' }));
+            registry.register(makeCommand({ group: 'console', name: 'logs' }));
+            registry.register(makeCommand({ group: 'process', name: 'list' }));
+            const consoleCommands = registry.getByGroup('console');
+            expect(consoleCommands).toHaveLength(2);
+            expect(consoleCommands.map((c) => c.name)).toEqual(['exec', 'logs']);
+        });
+        it('returns empty array for unknown group', () => {
+            const registry = new CommandRegistry();
+            registry.register(makeCommand({ group: 'console', name: 'exec' }));
+            expect(registry.getByGroup('nonexistent')).toEqual([]);
+        });
+    });
+    describe('getGroups', () => {
+        it('returns unique group names', () => {
+            const registry = new CommandRegistry();
+            registry.register(makeCommand({ group: 'console', name: 'exec' }));
+            registry.register(makeCommand({ group: 'console', name: 'logs' }));
+            registry.register(makeCommand({ group: 'process', name: 'list' }));
+            const groups = registry.getGroups();
+            expect(groups).toEqual(['console', 'process']);
+        });
+        it('excludes null group (top-level commands)', () => {
+            const registry = new CommandRegistry();
+            registry.register(makeCommand({ group: null, name: 'serve', scope: 'standalone' }));
+            registry.register(makeCommand({ group: 'console', name: 'exec' }));
+            const groups = registry.getGroups();
+            expect(groups).toEqual(['console']);
+        });
+        it('returns empty array when no groups', () => {
+            const registry = new CommandRegistry();
+            expect(registry.getGroups()).toEqual([]);
+        });
+    });
+    describe('getTopLevel', () => {
+        it('returns commands with null group', () => {
+            const registry = new CommandRegistry();
+            registry.register(makeCommand({ group: null, name: 'serve', scope: 'standalone' }));
+            registry.register(makeCommand({ group: null, name: 'mcp', scope: 'standalone' }));
+            registry.register(makeCommand({ group: 'console', name: 'exec' }));
+            const topLevel = registry.getTopLevel();
+            expect(topLevel).toHaveLength(2);
+            expect(topLevel.map((c) => c.name)).toEqual(['serve', 'mcp']);
+        });
+        it('returns empty array when no top-level commands', () => {
+            const registry = new CommandRegistry();
+            registry.register(makeCommand({ group: 'console', name: 'exec' }));
+            expect(registry.getTopLevel()).toEqual([]);
+        });
+    });
+    describe('getByCategory', () => {
+        it('filters by category', () => {
+            const registry = new CommandRegistry();
+            registry.register(makeCommand({ name: 'exec', category: 'execution' }));
+            registry.register(makeCommand({ name: 'list', category: 'infrastructure' }));
+            registry.register(makeCommand({ name: 'logs', category: 'execution' }));
+            const execution = registry.getByCategory('execution');
+            expect(execution).toHaveLength(2);
+            expect(execution.map((c) => c.name)).toEqual(['exec', 'logs']);
+        });
+    });
+    describe('get', () => {
+        it('finds by group and name', () => {
+            const registry = new CommandRegistry();
+            const cmd = makeCommand({ group: 'console', name: 'exec' });
+            registry.register(cmd);
+            expect(registry.get('console', 'exec')).toBe(cmd);
+        });
+        it('finds top-level commands with null group', () => {
+            const registry = new CommandRegistry();
+            const cmd = makeCommand({
+                group: null,
+                name: 'serve',
+                scope: 'standalone',
+            });
+            registry.register(cmd);
+            expect(registry.get(null, 'serve')).toBe(cmd);
+        });
+        it('returns undefined for missing command', () => {
+            const registry = new CommandRegistry();
+            expect(registry.get('console', 'nonexistent')).toBeUndefined();
+        });
+        it('returns undefined when group matches but name does not', () => {
+            const registry = new CommandRegistry();
+            registry.register(makeCommand({ group: 'console', name: 'exec' }));
+            expect(registry.get('console', 'logs')).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=command-registry.test.js.map

package/dist/src/commands/framework/command-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.test.js","sourceRoot":"","sources":["../../../../src/commands/framework/command-registry.test.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/framework/define-command.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Core types and `defineCommand()` factory for the declarative command system.
+ *
+ * A single `CommandDefinition` drives CLI registration. The `scope`
+ * discriminant determines the handler signature:
+ *
+ *   - `session`    — `(session: BridgeSession, args) => Promise<TResult>`
+ *   - `connection` — `(connection: BridgeConnection, args) => Promise<TResult>`
+ *   - `standalone` — `(args) => Promise<TResult>`
+ */
+import type { BridgeSession, BridgeConnection } from '../../bridge/index.js';
+import type { ArgDefinition } from './arg-builder.js';
+/**
+ * Brand symbol used by the registry to identify command definitions when
+ * scanning module exports via dynamic `import()`.
+ */
+export declare const COMMAND_BRAND: unique symbol;
+/** Safety classification — drives targeting behavior in adapters. */
+export type CommandSafety = 'read' | 'mutate' | 'none';
+export type CommandScope = 'session' | 'connection' | 'standalone';
+export type CommandCategory = 'execution' | 'infrastructure';
+export interface CliConfig<TResult> {
+    /**
+     * Render the result for human (terminal) output. Used as the default and
+     * for `--format=text`. Falls back to `result.summary` then JSON if not set.
+     */
+    format?: (result: TResult) => string;
+    /**
+     * Override the default JSON output (which is `formatJson(result)`). Use
+     * this when the result has fields that don't belong in machine output —
+     * e.g. dropping a base64 binary field.
+     */
+    json?: (result: TResult) => string;
+    /** Field name containing base64 binary data for raw file writes via --output. */
+    binaryField?: string;
+}
+interface BaseFields<TArgs, TResult> {
+    /** `null` for top-level commands. */
+    group: string | null;
+    name: string;
+    description: string;
+    category: CommandCategory;
+    safety: CommandSafety;
+    args: Record<string, ArgDefinition>;
+    cli?: CliConfig<TResult>;
+}
+export interface SessionCommandInput<TArgs, TResult> extends BaseFields<TArgs, TResult> {
+    scope: 'session';
+    handler: (session: BridgeSession, args: TArgs) => Promise<TResult>;
+}
+export interface ConnectionCommandInput<TArgs, TResult> extends BaseFields<TArgs, TResult> {
+    scope: 'connection';
+    handler: (connection: BridgeConnection, args: TArgs) => Promise<TResult>;
+}
+export interface StandaloneCommandInput<TArgs, TResult> extends BaseFields<TArgs, TResult> {
+    scope: 'standalone';
+    handler: (args: TArgs) => Promise<TResult>;
+}
+export type CommandInput<TArgs = any, TResult = any> = SessionCommandInput<TArgs, TResult> | ConnectionCommandInput<TArgs, TResult> | StandaloneCommandInput<TArgs, TResult>;
+export type CommandDefinition<TArgs = any, TResult = any> = CommandInput<TArgs, TResult> & {
+    readonly [COMMAND_BRAND]: true;
+};
+/**
+ * Define a new command. Stamps the brand symbol so the registry can
+ * identify it when scanning module exports.
+ */
+export declare function defineCommand<TArgs, TResult>(input: SessionCommandInput<TArgs, TResult>): CommandDefinition<TArgs, TResult>;
+export declare function defineCommand<TArgs, TResult>(input: ConnectionCommandInput<TArgs, TResult>): CommandDefinition<TArgs, TResult>;
+export declare function defineCommand<TArgs, TResult>(input: StandaloneCommandInput<TArgs, TResult>): CommandDefinition<TArgs, TResult>;
+/**
+ * Check whether a value is a branded `CommandDefinition`. Used by the
+ * registry when scanning module exports via dynamic `import()`.
+ */
+export declare function isCommandDefinition(value: unknown): value is CommandDefinition;
+export {};
+//# sourceMappingURL=define-command.d.ts.map

package/dist/src/commands/framework/define-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-command.d.ts","sourceRoot":"","sources":["../../../../src/commands/framework/define-command.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/framework/define-command.js

@@ -0,0 +1,28 @@
+/**
+ * Core types and `defineCommand()` factory for the declarative command system.
+ *
+ * A single `CommandDefinition` drives CLI registration. The `scope`
+ * discriminant determines the handler signature:
+ *
+ *   - `session`    — `(session: BridgeSession, args) => Promise<TResult>`
+ *   - `connection` — `(connection: BridgeConnection, args) => Promise<TResult>`
+ *   - `standalone` — `(args) => Promise<TResult>`
+ */
+/**
+ * Brand symbol used by the registry to identify command definitions when
+ * scanning module exports via dynamic `import()`.
+ */
+export const COMMAND_BRAND = Symbol.for('studio-bridge:command');
+export function defineCommand(input) {
+    return { ...input, [COMMAND_BRAND]: true };
+}
+/**
+ * Check whether a value is a branded `CommandDefinition`. Used by the
+ * registry when scanning module exports via dynamic `import()`.
+ */
+export function isCommandDefinition(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value[COMMAND_BRAND] === true);
+}
+//# sourceMappingURL=define-command.js.map