orbital-command 0.1.0

package/src/types/index.ts

@@ -0,0 +1,497 @@
+import type {
+  SprintStatus, SprintScopeStatus, GroupType,
+  GateStatus, DeployStatus, DeployEnvironment, AgentConfig,
+} from '../../shared/api-types.js';
+
+// Re-export shared types so existing imports from '@/types' keep working
+export type { SprintStatus, SprintScopeStatus, GroupType, GateStatus, DeployStatus, DeployEnvironment, AgentConfig };
+
+// ─── Scope Types ───────────────────────────────────────────
+
+// ScopeStatus is a dynamic string — runtime validation via engine.isValidStatus()
+export type ScopeStatus = string;
+
+export type ScopePriority = 'critical' | 'high' | 'medium' | 'low';
+
+export interface Scope {
+  id: number;
+  title: string;
+  status: ScopeStatus;
+  is_ghost?: boolean;
+  priority: ScopePriority | null;
+  effort_estimate: string | null;
+  category: string | null;
+  tags: string[];
+  blocked_by: number[];
+  blocks: number[];
+  file_path: string;
+  created_at: string | null;
+  updated_at: string | null;
+  raw_content: string | null;
+  sessions: Record<string, string[]>;
+}
+
+// ─── Card Display Types ────────────────────────────────────
+
+export interface CardDisplayConfig {
+  effort: boolean;
+  category: boolean;
+  priority: boolean;
+  tags: boolean;
+}
+
+// ─── Filter Types ──────────────────────────────────────────
+
+export type FilterField = 'priority' | 'category' | 'tags' | 'effort' | 'dependencies';
+
+export type ViewMode = 'kanban' | 'swimlane';
+export type SwimGroupField = 'priority' | 'category' | 'tags' | 'effort' | 'dependencies';
+
+export type ScopeFilterState = Record<FilterField, Set<string>>;
+
+export const PRIORITY_OPTIONS = ['critical', 'high', 'medium', 'low'] as const;
+
+// Default categories — overridden at runtime by /api/orbital/config
+export const CATEGORY_OPTIONS = [
+  'feature', 'bugfix', 'refactor', 'infrastructure', 'docs',
+] as const;
+
+export const EFFORT_BUCKETS = ['<1H', '1-4H', '4H+', 'TBD'] as const;
+
+export const DEPENDENCY_OPTIONS = ['has-blockers', 'blocks-others', 'no-deps'] as const;
+
+// ─── Event Types ───────────────────────────────────────────
+
+export type EventType =
+  | 'SESSION_START'
+  | 'SESSION_END'
+  | 'CHECKPOINT_SAVED'
+  | 'HANDOFF_CREATED'
+  | 'SKILL_INVOKED'
+  | 'SKILL_COMPLETED'
+  | 'AGENT_STARTED'
+  | 'AGENT_FINDING'
+  | 'AGENT_COMPLETED'
+  | 'AGENT_CONSENSUS'
+  | 'GATE_STARTED'
+  | 'GATE_PASSED'
+  | 'GATE_FAILED'
+  | 'ALL_GATES_PASSED'
+  | 'FILE_MODIFIED'
+  | 'BUILD_COMPLETED'
+  | 'TESTS_COMPLETED'
+  | 'BRANCH_CREATED'
+  | 'COMMIT_CREATED'
+  | 'PR_CREATED'
+  | 'PR_MERGED'
+  | 'DEPLOY_STARTED'
+  | 'DEPLOY_HEALTHY'
+  | 'DEPLOY_FAILED'
+  | 'ROLLBACK_INITIATED'
+  | 'SCOPE_CREATED'
+  | 'SCOPE_STATUS_CHANGED'
+  | 'SCOPE_COMPLETED'
+  | 'VIOLATION'
+  | 'OVERRIDE'
+  | 'PATTERN_DETECTED'
+  | 'RULE_PROPOSED'
+  | 'SCOPE_TRANSITION'
+  | 'COMMIT'
+  | 'DISPATCH';
+
+export interface OrbitalEvent {
+  id: string;
+  type: EventType;
+  scope_id: number | null;
+  session_id: string | null;
+  agent: string | null;
+  data: Record<string, unknown>;
+  timestamp: string;
+}
+
+// ─── Quality Gate Types ────────────────────────────────────
+
+export interface QualityGate {
+  id: number;
+  scope_id: number | null;
+  gate_name: string;
+  status: GateStatus;
+  details: string | null;
+  duration_ms: number | null;
+  run_at: string;
+  commit_sha: string | null;
+}
+
+// ─── Transition Readiness Types ───────────────────────────
+
+export type HookReadiness = 'pass' | 'fail' | 'unknown';
+
+export interface HookStatus {
+  id: string;
+  label: string;
+  category: import('../../shared/workflow-config').HookCategory;
+  enforcement: import('../../shared/workflow-config').HookEnforcement;
+  status: HookReadiness;
+  reason: string | null;
+}
+
+export interface TransitionReadiness {
+  from: string;
+  to: string;
+  edge: import('../../shared/workflow-config').WorkflowEdge;
+  hooks: HookStatus[];
+  gates: Array<{
+    gate_name: string;
+    status: GateStatus;
+    details: string | null;
+    duration_ms: number | null;
+    run_at: string;
+  }>;
+  ready: boolean;
+  blockers: string[];
+}
+
+export interface ScopeReadiness {
+  scope_id: number;
+  current_status: string;
+  transitions: TransitionReadiness[];
+}
+
+// ─── Enforcement Rules Types ─────────────────────────────
+
+export interface EnforcementRuleStats {
+  violations: number;
+  overrides: number;
+  last_triggered: string | null;
+}
+
+export interface EnforcementRule {
+  hook: import('../../shared/workflow-config').WorkflowHook;
+  enforcement: import('../../shared/workflow-config').HookEnforcement;
+  edges: Array<{ from: string; to: string; label: string }>;
+  stats: EnforcementRuleStats;
+}
+
+export interface EnforcementRulesData {
+  summary: { guards: number; gates: number; lifecycle: number; observers: number };
+  rules: EnforcementRule[];
+  totalEdges: number;
+}
+
+export interface ViolationTrendPoint {
+  day: string;
+  rule: string;
+  count: number;
+}
+
+// ─── Deployment Types ──────────────────────────────────────
+
+export interface Deployment {
+  id: number;
+  environment: DeployEnvironment;
+  status: DeployStatus;
+  commit_sha: string | null;
+  branch: string | null;
+  pr_number: number | null;
+  health_check_url: string | null;
+  started_at: string | null;
+  completed_at: string | null;
+  details: Record<string, unknown> | null;
+}
+
+// ─── Pipeline Drift Types ─────────────────────────────────
+
+export interface DriftCommit {
+  sha: string;
+  message: string;
+  author: string;
+  date: string; // ISO 8601
+}
+
+export interface BranchHead {
+  sha: string;
+  date: string;
+  message: string;
+}
+
+export interface PipelineDrift {
+  devToStaging: { count: number; commits: DriftCommit[]; oldestDate: string | null };
+  stagingToMain: { count: number; commits: DriftCommit[]; oldestDate: string | null };
+  heads: { dev: BranchHead; staging: BranchHead; main: BranchHead };
+}
+
+export interface DeployFrequencyWeek {
+  week: string;
+  staging: number;
+  production: number;
+}
+
+// ─── Session Types ─────────────────────────────────────────
+
+export interface Session {
+  id: string;
+  scope_id: number | null;
+  claude_session_id: string | null;
+  action: string | null;
+  started_at: string | null;
+  ended_at: string | null;
+  handoff_file: string | null;
+  summary: string | null;
+  discoveries: string[];
+  next_steps: string[];
+  progress_pct: number | null;
+}
+
+// ─── Agent Types ───────────────────────────────────────────
+
+// AgentName is now a dynamic string — validated at runtime against config
+export type AgentName = string;
+
+// Default agents — overridden at runtime by /api/orbital/config
+const DEFAULT_AGENTS: AgentConfig[] = [
+  { 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' },
+];
+
+/** Build emoji map from agent config array */
+export function buildAgentEmoji(agents?: AgentConfig[]): Record<string, string> {
+  const list = agents ?? DEFAULT_AGENTS;
+  return Object.fromEntries(list.map(a => [a.id, a.emoji]));
+}
+
+/** Build color map from agent config array */
+export function buildAgentColor(agents?: AgentConfig[]): Record<string, string> {
+  const list = agents ?? DEFAULT_AGENTS;
+  return Object.fromEntries(list.map(a => [a.id, a.color]));
+}
+
+// Legacy compatibility — static defaults for initial render before config loads
+export const AGENT_EMOJI: Record<string, string> = buildAgentEmoji();
+export const AGENT_COLOR: Record<string, string> = buildAgentColor();
+
+// ─── Board Column Config ───────────────────────────────────
+
+export interface BoardColumn {
+  id: string;
+  label: string;
+  color: string;
+}
+
+// ─── Sprint / Batch Types ─────────────────────────────────
+
+
+export interface BatchDispatchResult {
+  commit_sha?: string;
+  pr_url?: string;
+  pr_number?: number;
+  dispatched_at?: string;
+}
+
+export interface Sprint {
+  id: number;
+  name: string;
+  status: SprintStatus;
+  concurrency_cap: number;
+  group_type: GroupType;
+  target_column: string;
+  dispatch_result: BatchDispatchResult | null;
+  scope_ids: number[];
+  scopes: SprintScope[];
+  layers: number[][] | null;
+  progress: { pending: number; in_progress: number; completed: number; failed: number; skipped: number };
+  created_at: string;
+  updated_at: string;
+  dispatched_at: string | null;
+  completed_at: string | null;
+}
+
+export interface SprintScope {
+  scope_id: number;
+  title: string;
+  scope_status: string;
+  effort_estimate: string | null;
+  layer: number | null;
+  dispatch_status: SprintScopeStatus;
+}
+
+// ─── Socket Events ─────────────────────────────────────────
+
+export interface DispatchResolvedPayload {
+  event_id: string;
+  scope_id: number | null;
+  scope_ids?: number[] | null;
+  outcome: 'completed' | 'failed' | 'abandoned';
+}
+
+export interface ServerToClientEvents {
+  'scope:updated': (scope: Scope) => void;
+  'scope:created': (scope: Scope) => void;
+  'scope:deleted': (scopeId: number) => void;
+  'event:new': (event: OrbitalEvent) => void;
+  'dispatch:resolved': (payload: DispatchResolvedPayload) => void;
+  'gate:updated': (gate: QualityGate) => void;
+  'deploy:updated': (deployment: Deployment) => void;
+  'session:updated': (session: Session) => void;
+  'sprint:created': (sprint: Sprint) => void;
+  'sprint:updated': (sprint: Sprint) => void;
+  'sprint:deleted': (payload: { id: number }) => void;
+  'sprint:completed': (sprint: Sprint) => void;
+  'workflow:changed': () => void;
+  'git:status:changed': () => void;
+  'config:agents:changed': (payload: { action: string; path: string }) => void;
+  'config:skills:changed': (payload: { action: string; path: string }) => void;
+  'config:hooks:changed': (payload: { action: string; path: string }) => void;
+  'version:updating': (payload: { stage: 'pulling' | 'installing' }) => void;
+  'version:updated': (payload: { success: true } | { success: false; error: string }) => void;
+}
+
+export interface ClientToServerEvents {
+  'subscribe': (channel: string) => void;
+  'unsubscribe': (channel: string) => void;
+}
+
+// ─── Config Primitives Types ──────────────────────────────
+
+export type ConfigPrimitiveType = 'agents' | 'skills' | 'hooks';
+
+export interface ConfigFileNode {
+  name: string;
+  path: string;
+  type: 'file' | 'folder';
+  children?: ConfigFileNode[];
+  frontmatter?: Record<string, unknown>;
+}
+
+// ─── Source Control Types ─────────────────────────────────
+
+export interface GitOverview {
+  branchingMode: 'trunk' | 'worktree';
+  currentBranch: string;
+  dirty: boolean;
+  detached: boolean;
+  mainHead: { sha: string; message: string; date: string } | null;
+  aheadBehind: { ahead: number; behind: number } | null;
+  worktreeCount: number;
+  featureBranchCount: number;
+}
+
+export interface CommitEntry {
+  sha: string;
+  shortSha: string;
+  message: string;
+  author: string;
+  date: string;
+  branch: string;
+  scopeId: number | null;
+  refs: string[];
+}
+
+export interface BranchInfoData {
+  name: string;
+  isRemote: boolean;
+  isCurrent: boolean;
+  headSha: string;
+  headMessage: string;
+  headDate: string;
+  aheadBehind: { ahead: number; behind: number } | null;
+  scopeId: number | null;
+  isStale: boolean;
+}
+
+export interface WorktreeDetail {
+  path: string;
+  branch: string;
+  head: string;
+  scopeId: number | null;
+  scopeTitle: string | null;
+  scopeStatus: string | null;
+  dirty: boolean;
+  aheadBehind: { ahead: number; behind: number } | null;
+}
+
+export interface GitHubStatus {
+  connected: boolean;
+  authUser: string | null;
+  repo: {
+    owner: string;
+    name: string;
+    fullName: string;
+    defaultBranch: string;
+    visibility: string;
+    url: string;
+  } | null;
+  openPRs: number;
+  error: string | null;
+}
+
+export interface PullRequestInfo {
+  number: number;
+  title: string;
+  author: string;
+  branch: string;
+  baseBranch: string;
+  state: string;
+  url: string;
+  createdAt: string;
+  scopeIds: number[];
+}
+
+export interface DriftPair {
+  from: string;
+  to: string;
+  count: number;
+  commits: Array<{ sha: string; message: string; author: string; date: string }>;
+}
+
+// ─── Pipeline Display Types ──────────────────────────────
+
+export interface ResolvedHook {
+  id: string;
+  label: string;
+  category: import('../../shared/workflow-config').HookCategory;
+  enforcement: import('../../shared/workflow-config').HookEnforcement;
+  filePath: string | null;
+  timing: 'before' | 'after';
+  blocking: boolean;
+  description?: string;
+}
+
+export interface ResolvedAgent {
+  id: string;
+  label: string;
+  emoji: string;
+  color: string;
+  team?: string;
+  filePath: string | null;
+}
+
+export interface ReviewTeam {
+  skillCommand: string;
+  skillPath: string | null;
+  agents: ResolvedAgent[];
+}
+
+export interface EdgeData {
+  edge: import('../../shared/workflow-config').WorkflowEdge;
+  skillPath: string | null;
+  edgeHooks: ResolvedHook[];
+}
+
+export interface StageData {
+  list: import('../../shared/workflow-config').WorkflowList;
+  stageHooks: ResolvedHook[];
+  alwaysOnAgents: ResolvedAgent[];
+  reviewTeams: ReviewTeam[];
+  forwardEdges: EdgeData[];
+  backwardEdges: import('../../shared/workflow-config').WorkflowEdge[];
+}
+
+export interface PipelineData {
+  globalHooks: ResolvedHook[];
+  stages: StageData[];
+  skillPathMap: Map<string, string>;
+  hookPathMap: Map<string, string>;
+  agentPathMap: Map<string, string>;
+  orchestratesMap: Map<string, string[]>;
+}