orbital-command 0.3.0 → 1.0.0

package/dist/server/shared/api-types.js

@@ -2,4 +2,83 @@
 //
 // Types shared between server and client. Single source of truth for
 // enums/unions that were previously duplicated across layers.
-export {};
+export const DEFAULT_DISPATCH_FLAGS = {
+    permissionMode: 'bypass',
+    verbose: true,
+    allowedTools: [],
+    disallowedTools: [],
+    appendSystemPrompt: '',
+    outputFormat: '',
+    noMarkdown: false,
+    printMode: false,
+};
+export const DEFAULT_DISPATCH_CONFIG = {
+    staleTimeoutMinutes: 10,
+    maxBatchSize: 20,
+    maxConcurrent: 0,
+    envVars: {},
+};
+// ─── Validation ─────────────────────────────────────────────
+export const VALID_PERMISSION_MODES = ['bypass', 'default', 'plan', 'acceptEdits'];
+export const VALID_OUTPUT_FORMATS = ['', 'text', 'json', 'stream-json'];
+export const VALID_TERMINAL_ADAPTERS = ['auto', 'iterm2', 'subprocess', 'none'];
+const SAFE_TOOL_NAME = /^[a-zA-Z0-9_:.-]+$/;
+const SAFE_ENV_KEY = /^[A-Za-z_][A-Za-z0-9_]*$/;
+export function validateToolName(name) {
+    return SAFE_TOOL_NAME.test(name);
+}
+export function validateEnvKey(key) {
+    return SAFE_ENV_KEY.test(key);
+}
+export function validateDispatchFlags(flags) {
+    if (flags.permissionMode !== undefined && !VALID_PERMISSION_MODES.includes(flags.permissionMode)) {
+        return `Invalid permissionMode: ${flags.permissionMode}`;
+    }
+    if (flags.outputFormat !== undefined && !VALID_OUTPUT_FORMATS.includes(flags.outputFormat)) {
+        return `Invalid outputFormat: ${flags.outputFormat}`;
+    }
+    if (flags.allowedTools !== undefined) {
+        if (!Array.isArray(flags.allowedTools))
+            return 'allowedTools must be an array';
+        for (const t of flags.allowedTools) {
+            if (typeof t !== 'string' || !validateToolName(t))
+                return `Invalid tool name: ${t}`;
+        }
+    }
+    if (flags.disallowedTools !== undefined) {
+        if (!Array.isArray(flags.disallowedTools))
+            return 'disallowedTools must be an array';
+        for (const t of flags.disallowedTools) {
+            if (typeof t !== 'string' || !validateToolName(t))
+                return `Invalid tool name: ${t}`;
+        }
+    }
+    if (flags.appendSystemPrompt !== undefined && typeof flags.appendSystemPrompt !== 'string') {
+        return 'appendSystemPrompt must be a string';
+    }
+    return null;
+}
+export function validateDispatchConfig(config) {
+    if (config.terminalAdapter !== undefined && !VALID_TERMINAL_ADAPTERS.includes(config.terminalAdapter)) {
+        return `Invalid terminalAdapter: ${config.terminalAdapter}`;
+    }
+    if (config.staleTimeoutMinutes !== undefined && (typeof config.staleTimeoutMinutes !== 'number' || config.staleTimeoutMinutes < 1)) {
+        return 'staleTimeoutMinutes must be a positive number';
+    }
+    if (config.maxBatchSize !== undefined && (typeof config.maxBatchSize !== 'number' || config.maxBatchSize < 1)) {
+        return 'maxBatchSize must be a positive number';
+    }
+    if (config.maxConcurrent !== undefined && (typeof config.maxConcurrent !== 'number' || config.maxConcurrent < 0)) {
+        return 'maxConcurrent must be a non-negative number';
+    }
+    if (config.envVars !== undefined) {
+        if (typeof config.envVars !== 'object' || config.envVars === null || Array.isArray(config.envVars)) {
+            return 'envVars must be an object';
+        }
+        for (const key of Object.keys(config.envVars)) {
+            if (!validateEnvKey(key))
+                return `Invalid env var key: ${key}`;
+        }
+    }
+    return null;
+}

package/dist/server/shared/workflow-engine.js

@@ -313,7 +313,7 @@ export class WorkflowEngine {
                 continue;
             // Generate aliases for deployment-group targets (dev, staging, production)
             const group = targetList.group;
-            if (group === 'deployment') {
+            if (group?.startsWith('deploy')) {
                 const sessionKey = targetList.sessionKey ?? '';
                 lines.push(`  "to-${edge.to}:${edge.from}:${edge.to}:${sessionKey}"`);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orbital-command",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "description": "Orbital Command — mission control dashboard for Claude Code projects",
   "type": "module",
   "license": "MIT",
@@ -47,8 +47,10 @@
     "build": "./node_modules/.bin/vite build",
     "build:server": "./node_modules/.bin/tsc -p tsconfig.server.json",
     "typecheck": "./node_modules/.bin/tsc --noEmit && ./node_modules/.bin/tsc --noEmit -p tsconfig.server.json",
+    "validate": "npm run typecheck && npm run test && npm run build && npm run build:server",
+    "release": "./scripts/release.sh",
     "postinstall": "node scripts/postinstall.js",
-    "prepublishOnly": "npm run typecheck && npm run build && npm run build:server",
+    "prepublishOnly": "npm run validate",
     "preview": "vite preview",
     "test": "vitest run",
     "test:unit": "vitest run --project unit",
@@ -58,31 +60,38 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
+    "better-sqlite3": "^12.0.0",
+    "chokidar": "^4.0.3",
+    "express": "^4.21.2",
+    "gray-matter": "^4.0.3",
+    "picocolors": "^1.1.1",
+    "socket.io": "^4.8.1"
+  },
+  "devDependencies": {
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@radix-ui/react-dialog": "^1.1.4",
-    "@radix-ui/react-dropdown-menu": "^2.1.4",
     "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-scroll-area": "^1.2.2",
-    "@radix-ui/react-select": "^2.1.4",
     "@radix-ui/react-separator": "^1.1.1",
     "@radix-ui/react-slot": "^1.1.1",
     "@radix-ui/react-tabs": "^1.1.2",
     "@radix-ui/react-tooltip": "^1.1.6",
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/express": "^5.0.0",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@types/supertest": "^7.2.0",
     "@vitejs/plugin-react": "^4.7.0",
     "@xyflow/react": "^12.10.1",
     "autoprefixer": "^10.4.27",
-    "better-sqlite3": "^12.0.0",
-    "chokidar": "^4.0.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "concurrently": "^9.2.1",
     "date-fns": "^4.1.0",
-    "express": "^4.21.2",
     "framer-motion": "^11.15.0",
-    "gray-matter": "^4.0.3",
     "lucide-react": "^0.577.0",
-    "picocolors": "^1.1.1",
     "postcss": "^8.5.8",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
@@ -90,23 +99,14 @@
     "react-router-dom": "^6.30.2",
     "recharts": "^2.15.0",
     "remark-gfm": "^4.0.1",
-    "socket.io": "^4.8.1",
     "socket.io-client": "^4.8.1",
+    "supertest": "^7.2.2",
     "tailwind-merge": "^2.6.0",
     "tailwindcss": "^3.4.19",
     "tailwindcss-animate": "^1.0.7",
     "tsx": "^4.19.2",
-    "vite": "^6.0.7"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.12",
-    "@types/express": "^5.0.0",
-    "@types/react": "^18.3.18",
-    "@types/react-dom": "^18.3.5",
-    "@types/supertest": "^7.2.0",
-    "concurrently": "^9.2.1",
-    "supertest": "^7.2.2",
     "typescript": "^5.7.3",
+    "vite": "^6.0.7",
     "vitest": "^4.1.3"
   },
   "engines": {

package/schemas/orbital.config.schema.json

@@ -35,10 +35,7 @@
         "typeCheck": { "type": ["string", "null"], "default": null },
         "lint": { "type": ["string", "null"], "default": null },
         "build": { "type": ["string", "null"], "default": null },
-        "test": { "type": ["string", "null"], "default": null },
-        "validateTemplates": { "type": ["string", "null"], "default": null },
-        "validateDocs": { "type": ["string", "null"], "default": null },
-        "checkRules": { "type": ["string", "null"], "default": null }
+        "test": { "type": ["string", "null"], "default": null }
       },
       "additionalProperties": false
     },
@@ -77,21 +74,6 @@
         "production": { "type": "string", "format": "uri" }
       },
       "additionalProperties": { "type": "string", "format": "uri" }
-    },
-    "telemetry": {
-      "type": "object",
-      "description": "Session telemetry — uploads Claude session JSONL files to a remote endpoint. Can also be disabled via ORBITAL_TELEMETRY=false env var.",
-      "properties": {
-        "enabled": { "type": "boolean", "default": true, "description": "Enable session telemetry upload" },
-        "url": { "type": "string", "description": "Base URL of the telemetry receiver (Cloudflare Worker)" },
-        "headers": {
-          "type": "object",
-          "additionalProperties": { "type": "string" },
-          "default": {},
-          "description": "Custom headers sent with upload requests (e.g. Authorization)"
-        }
-      },
-      "additionalProperties": false
     }
   },
   "additionalProperties": false

package/scripts/postinstall.js

@@ -9,14 +9,13 @@
  * 3. Otherwise, prints a banner with next steps.
  */
 
-import { existsSync, readFileSync } from 'fs';
+import { existsSync } from 'fs';
 import { execFileSync } from 'child_process';
 import path from 'path';
 import { fileURLToPath } from 'url';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.resolve(__dirname, '..');
-const orbitalHome = path.join(process.env.HOME || process.env.USERPROFILE || '~', '.orbital');
 
 // ─── 1. Esbuild safety net ─────────────────────────────────────
 
@@ -29,44 +28,9 @@ if (existsSync(esbuildInstall)) {
   }
 }
 
-// ─── 2. Setup wizard or banner ──────────────────────────────────
+// ─── 2. Post-install banner ─────────────────────────────────────
 
-const isInteractive = process.stdout.isTTY && !process.env.CI;
-const alreadySetUp = existsSync(path.join(orbitalHome, 'config.json'));
-
-if (isInteractive && !alreadySetUp) {
-  // Launch the Phase 1 setup wizard
-  try {
-    const pkg = JSON.parse(readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
-    const version = pkg.version || '0.0.0';
-
-    let wizard;
-    try {
-      wizard = await import('../dist/server/server/wizard/index.js');
-    } catch {
-      try {
-        wizard = await import('../server/wizard/index.js');
-      } catch {
-        // Wizard module not available — fall through to banner
-        wizard = null;
-      }
-    }
-
-    if (wizard) {
-      await wizard.runSetupWizard(version);
-    } else {
-      printBanner();
-    }
-  } catch {
-    printBanner();
-  }
-} else if (!alreadySetUp) {
-  printBanner();
-}
-
-function printBanner() {
-  console.log('');
-  console.log('  Orbital Command installed.');
-  console.log('  Run `orbital` in your project directory to get started.');
-  console.log('');
-}
+console.log('');
+console.log('  Orbital Command installed.');
+console.log('  Run \x1b[36morbital\x1b[0m in your project directory to get started.');
+console.log('');

package/scripts/release.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Release Orbital Command
+# Usage: ./scripts/release.sh [patch|minor|major]
+#
+# Runs the full validation pipeline, bumps version, tags, and pushes.
+# The tag push triggers publish.yml which publishes to npm.
+
+set -e
+
+BUMP="${1:-patch}"
+
+if [[ "$BUMP" != "patch" && "$BUMP" != "minor" && "$BUMP" != "major" ]]; then
+  echo "Usage: ./scripts/release.sh [patch|minor|major]"
+  echo "  Default: patch"
+  exit 1
+fi
+
+# Ensure clean working tree
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo "Error: working tree is dirty. Commit or stash changes first."
+  exit 1
+fi
+
+# Ensure we're on main
+BRANCH="$(git branch --show-current)"
+if [[ "$BRANCH" != "main" ]]; then
+  echo "Error: releases must be cut from main (currently on $BRANCH)"
+  exit 1
+fi
+
+# Pull latest
+echo "Pulling latest from origin/main..."
+git pull --ff-only origin main
+
+# Validate
+echo ""
+echo "Running full validation pipeline..."
+echo ""
+npm run validate
+
+# Bump version and create tag
+echo ""
+echo "Bumping $BUMP version..."
+npm version "$BUMP"
+
+# Push commit and tag
+echo ""
+echo "Pushing to origin..."
+git push origin main --follow-tags
+
+VERSION="$(node -p "require('./package.json').version")"
+echo ""
+echo "Released v$VERSION — publish.yml will handle npm publish."

package/server/__tests__/data-routes.test.ts

@@ -9,6 +9,7 @@ import { WorkflowEngine } from '../../shared/workflow-engine.js';
 import { createTestDb } from './helpers/db.js';
 import { createMockEmitter } from './helpers/mock-emitter.js';
 import { DEFAULT_CONFIG } from '../../shared/__fixtures__/workflow-configs.js';
+import { loadConfig } from '../config.js';
 import type Database from 'better-sqlite3';
 
 describe('data-routes', () => {
@@ -42,6 +43,7 @@ describe('data-routes', () => {
       engine,
       projectRoot: '/tmp/test-project',
       inferScopeStatus: vi.fn(),
+      config: loadConfig('/tmp/test-project'),
     });
 
     app = express();

package/server/__tests__/scope-routes.test.ts

@@ -69,6 +69,7 @@ describe('scope-routes', () => {
       projectRoot: '/tmp/test-project',
       projectName: 'Test',
       engine,
+      config: { claude: { dispatchFlags: { permissionMode: 'bypass', verbose: false, noMarkdown: false, printMode: false, outputFormat: null, allowedTools: [], disallowedTools: [], appendSystemPrompt: '' } }, dispatch: { envVars: {}, maxConcurrent: 5, maxBatchSize: 20, staleTimeoutMinutes: 10 } } as any,
     });
 
     app = express();

package/server/config-migrator.ts

@@ -62,9 +62,6 @@ const NESTED_DEFAULTS: Record<string, Record<string, unknown>> = {
     lint: null,
     build: null,
     test: null,
-    validateTemplates: null,
-    validateDocs: null,
-    checkRules: null,
   },
 };
 

package/server/config.ts

@@ -14,6 +14,7 @@ export interface TerminalConfig {
 export interface ClaudeConfig {
   executable: string;
   flags: string[];
+  dispatchFlags: DispatchFlags;
 }
 
 export interface CommandsConfig {
@@ -21,13 +22,12 @@ export interface CommandsConfig {
   lint: string | null;
   build: string | null;
   test: string | null;
-  validateTemplates: string | null;
-  validateDocs: string | null;
-  checkRules: string | null;
 }
 
-export type { AgentConfig } from '../shared/api-types.js';
-import type { AgentConfig } from '../shared/api-types.js';
+export type { AgentConfig, DispatchFlags, DispatchConfig } from '../shared/api-types.js';
+import type { AgentConfig, DispatchFlags, DispatchConfig } from '../shared/api-types.js';
+import { DEFAULT_DISPATCH_FLAGS, DEFAULT_DISPATCH_CONFIG } from '../shared/api-types.js';
+import { loadGlobalConfig as loadGlobal } from './global-config.js';
 
 export interface TelemetryConfig {
   enabled: boolean;
@@ -55,6 +55,9 @@ export interface OrbitalConfig {
   // Claude Code CLI
   claude: ClaudeConfig;
 
+  // Dispatch operational settings
+  dispatch: DispatchConfig;
+
   // Build/test commands
   commands: CommandsConfig;
 
@@ -86,19 +89,18 @@ const DEFAULT_CONFIG: Omit<OrbitalConfig, 'projectRoot'> = {
   claude: {
     executable: 'claude',
     flags: ['--dangerously-skip-permissions'],
+    dispatchFlags: DEFAULT_DISPATCH_FLAGS,
   },
+  dispatch: DEFAULT_DISPATCH_CONFIG,
   commands: {
     typeCheck: null,
     lint: null,
     build: null,
     test: null,
-    validateTemplates: null,
-    validateDocs: null,
-    checkRules: null,
   },
   logLevel: 'info' as const,
   telemetry: {
-    enabled: true,
+    enabled: false,
     url: '',
     headers: {},
   },
@@ -106,7 +108,6 @@ const DEFAULT_CONFIG: Omit<OrbitalConfig, 'projectRoot'> = {
   agents: [
     { id: 'attacker', label: 'Attacker', emoji: '\u{1F5E1}\u{FE0F}', color: '#ff1744' },
     { id: 'chaos', label: 'Chaos', emoji: '\u{1F4A5}', color: '#F97316' },
-    { id: 'solana-expert', label: 'Solana Expert', emoji: '\u{26D3}\u{FE0F}', color: '#8B5CF6' },
     { id: 'frontend-designer', label: 'Frontend Designer', emoji: '\u{1F3A8}', color: '#EC4899' },
     { id: 'architect', label: 'Architect', emoji: '\u{1F3D7}\u{FE0F}', color: '#536dfe' },
     { id: 'rules-enforcer', label: 'Rules Enforcer', emoji: '\u{1F4CB}', color: '#6B7280' },
@@ -168,6 +169,15 @@ export function getClaudeSessionsDir(projectRoot: string): string {
 export function loadConfig(projectRoot?: string): OrbitalConfig {
   const root = projectRoot ?? resolveProjectRoot();
 
+  // Try loading edition overrides (e.g. edition.json at repo root)
+  const editionPath = path.join(root, 'edition.json');
+  let editionConfig: Record<string, unknown> = {};
+  if (fs.existsSync(editionPath)) {
+    try {
+      editionConfig = JSON.parse(fs.readFileSync(editionPath, 'utf-8'));
+    } catch { /* malformed edition.json — ignore */ }
+  }
+
   // Try loading user config
   const configPath = path.join(root, '.claude', 'orbital.config.json');
   let userConfig: Record<string, unknown> = {};
@@ -201,11 +211,26 @@ export function loadConfig(projectRoot?: string): OrbitalConfig {
     ...(userConfig.terminal as Partial<TerminalConfig> ?? {}),
   };
 
+  // Global settings — seed from ~/.orbital/config.json
+  let globalDispatchFlags = DEFAULT_DISPATCH_FLAGS;
+  let globalDispatch = DEFAULT_DISPATCH_CONFIG;
+  let globalTelemetry: Partial<TelemetryConfig> = {};
+  try {
+    const global = loadGlobal();
+    if (global.dispatchFlags) globalDispatchFlags = { ...DEFAULT_DISPATCH_FLAGS, ...global.dispatchFlags };
+    if (global.dispatch) globalDispatch = { ...DEFAULT_DISPATCH_CONFIG, ...global.dispatch };
+    if (global.telemetry) globalTelemetry = global.telemetry;
+  } catch { /* global config may not exist yet */ }
+
+  const userClaude = (userConfig.claude as Partial<ClaudeConfig>) ?? {};
   const claude: ClaudeConfig = {
     ...DEFAULT_CONFIG.claude,
-    ...(userConfig.claude as Partial<ClaudeConfig> ?? {}),
+    ...userClaude,
+    dispatchFlags: globalDispatchFlags,
   };
 
+  const dispatch: DispatchConfig = globalDispatch;
+
   const commands: CommandsConfig = {
     ...DEFAULT_CONFIG.commands,
     ...(userConfig.commands as Partial<CommandsConfig> ?? {}),
@@ -217,6 +242,8 @@ export function loadConfig(projectRoot?: string): OrbitalConfig {
 
   const telemetry: TelemetryConfig = {
     ...DEFAULT_CONFIG.telemetry,
+    ...globalTelemetry,
+    ...(editionConfig.telemetry as Partial<TelemetryConfig> ?? {}),
     ...(userConfig.telemetry as Partial<TelemetryConfig> ?? {}),
   };
   if (process.env.ORBITAL_TELEMETRY === 'false') telemetry.enabled = false;
@@ -232,6 +259,7 @@ export function loadConfig(projectRoot?: string): OrbitalConfig {
     clientPort,
     terminal,
     claude,
+    dispatch,
     commands,
     logLevel,
     categories,

package/server/database.ts

@@ -2,7 +2,6 @@ import Database from 'better-sqlite3';
 import path from 'path';
 import fs from 'fs';
 import { SCHEMA_DDL } from './schema.js';
-import { getConfig } from './config.js';
 import { createLogger } from './utils/logger.js';
 
 const log = createLogger('database');
@@ -14,7 +13,6 @@ const log = createLogger('database');
  * Creates the directory if needed, applies schema DDL and migrations.
  *
  * Each call returns a NEW connection — callers manage their own lifecycle.
- * This is the multi-project replacement for the getDatabase() singleton.
  */
 export function openProjectDatabase(dbDir: string): Database.Database {
   fs.mkdirSync(dbDir, { recursive: true });
@@ -33,22 +31,6 @@ export function openProjectDatabase(dbDir: string): Database.Database {
   return database;
 }
 
-// ─── Singleton (backward compat, used by index.ts) ──────────
-
-function getDbPaths(): { dir: string; file: string } {
-  const config = getConfig();
-  return { dir: config.dbDir, file: path.join(config.dbDir, 'orbital.db') };
-}
-
-let db: Database.Database | null = null;
-
-/** @deprecated Use openProjectDatabase() for multi-project support. */
-export function getDatabase(): Database.Database {
-  if (db) return db;
-  db = openProjectDatabase(getDbPaths().dir);
-  return db;
-}
-
 /** Check if a table exists in the database */
 function tableExists(database: Database.Database, tableName: string): boolean {
   const row = database.prepare(
@@ -114,11 +96,3 @@ function runMigrations(database: Database.Database): void {
     `);
   }
 }
-
-export function closeDatabase(): void {
-  if (db) {
-    db.close();
-    db = null;
-    log.debug('Database closed');
-  }
-}

package/server/global-config.ts

@@ -27,6 +27,10 @@ export interface OrbitalGlobalConfig {
   version: 1;
   projects: ProjectRegistration[];
   privateMode?: boolean;
+  dispatchFlags?: import('../shared/api-types.js').DispatchFlags;
+  dispatch?: import('../shared/api-types.js').DispatchConfig;
+  telemetry?: import('./config.js').TelemetryConfig;
+  terminalAdapter?: string;
 }
 
 // ─── Constants ──────────────────────────────────────────────