opencode-telos 1.0.0

package/src/sdd/workflows/multi-tenancy.ts

@@ -0,0 +1,84 @@
+import type { KnowledgeGraph, ChangeNode, TenantNode } from '../domain/types.js'
+
+export interface MultiTenancyWorkflow {
+  id: string
+  tenant_name: string
+  tenant_type: 'shared_database' | 'dedicated_database' | 'shared_schema'
+  isolation_level: 'row' | 'schema' | 'database'
+}
+
+export function createTenantChange(
+  _graph: KnowledgeGraph,
+  workflow: MultiTenancyWorkflow
+): { change: ChangeNode; tenant: TenantNode } {
+  const changeId = `change-tenant-${Date.now()}`
+  const tenantId = `tenant-${Date.now()}`
+
+  const tenant: TenantNode = {
+    id: tenantId,
+    type: 'tenant',
+    name: `Tenant: ${workflow.tenant_name}`,
+    description: `Multi-tenancy setup for ${workflow.tenant_name}`,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      tenant_name: workflow.tenant_name,
+      tenant_type: workflow.tenant_type,
+      isolation_level: workflow.isolation_level,
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  const change: ChangeNode = {
+    id: changeId,
+    type: 'change',
+    name: `Multi-tenancy: ${workflow.tenant_name}`,
+    description: `Add multi-tenancy for ${workflow.tenant_name}`,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      title: `Multi-tenancy: ${workflow.tenant_name}`,
+      reason: `Add multi-tenancy for ${workflow.tenant_name}`,
+      approval_level: 'APPROVAL',
+      affected_nodes: [tenantId],
+      affected_relationships: [],
+      new_nodes: [tenantId],
+      removed_nodes: [],
+      modified_nodes: [],
+      affected_files: [],
+      affected_tests: [],
+      implementation_tasks: [],
+      origin: 'multi_tenancy_workflow',
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  return { change, tenant }
+}
+
+export function getTenantInstructions(tenant: TenantNode): string {
+  const lines = [
+    '## Multi-tenancy Workflow',
+    '',
+    `**Tenant:** ${tenant.metadata.tenant_name}`,
+    `**Type:** ${tenant.metadata.tenant_type}`,
+    `**Isolation:** ${tenant.metadata.isolation_level}`,
+    '',
+    '### Implementation Steps',
+    '1. Add tenant_id to all entities',
+    '2. Create tenant middleware',
+    '3. Modify queries to filter by tenant',
+    '4. Set up tenant context',
+    '5. Test isolation between tenants',
+    '',
+    '### Security Considerations',
+    '- Ensure data isolation',
+    '- Validate tenant access',
+    '- Prevent cross-tenant data leaks',
+    '- Audit tenant operations',
+  ]
+
+  return lines.join('\n')
+}

package/src/sdd/workflows/onboarding.ts

@@ -0,0 +1,82 @@
+import type { KnowledgeGraph } from '../domain/types.js'
+
+export interface OnboardingWorkflow {
+  id: string
+  developer_name?: string
+}
+
+export function generateOnboardingGuide(
+  graph: KnowledgeGraph,
+  workflow: OnboardingWorkflow
+): string {
+  const lines = [
+    '## Guia de Onboarding',
+    '',
+  ]
+
+  if (workflow.developer_name) {
+    lines.push(`**Bem-vindo, ${workflow.developer_name}!**`, '')
+  }
+
+  lines.push(
+    '### Visão Geral do Projeto',
+    `**Total de Nós:** ${graph.nodes.length}`,
+    `**Total de Relações:** ${graph.relationships.length}`,
+    '',
+    '### Arquivos-Chave para Entender',
+  )
+
+  const nodesByType: Record<string, number> = {}
+  for (const node of graph.nodes) {
+    nodesByType[node.type] = (nodesByType[node.type] || 0) + 1
+  }
+
+  for (const [type, count] of Object.entries(nodesByType)) {
+    lines.push(`- **${type}**: ${count} nós`)
+  }
+
+  const features = graph.nodes.filter(n => n.type === 'feature')
+  if (features.length > 0) {
+    lines.push('', '### Features Principais')
+    for (const feature of features.slice(0, 5)) {
+      lines.push(`- ${feature.name}: ${feature.description || 'Sem descrição'}`)
+    }
+  }
+
+  const endpoints = graph.nodes.filter(n => n.type === 'endpoint')
+  if (endpoints.length > 0) {
+    lines.push('', '### Endpoints da API')
+    for (const endpoint of endpoints.slice(0, 5)) {
+      const meta = endpoint.metadata as any
+      lines.push(`- ${meta.method} ${meta.path}`)
+    }
+  }
+
+  const decisions = graph.nodes.filter(n => n.type === 'decision')
+  if (decisions.length > 0) {
+    lines.push('', '### Decisões Arquiteturais Importantes')
+    for (const decision of decisions.slice(0, 3)) {
+      const meta = decision.metadata as any
+      lines.push(`- **${meta.title}**: ${meta.decision}`)
+    }
+  }
+
+  lines.push(
+    '',
+    '### Primeiros Passos',
+    '1. Leia os nodes de feature para entender o que está sendo construído',
+    '2. Explore os endpoints da API',
+    '3. Entenda as decisões arquiteturais',
+    '4. Verifique se há change requests pendentes',
+    '',
+    '### Comandos Úteis',
+    '- `sdd.inspect` - Ver estado atual do projeto',
+    '- `sdd.query_graph` - Consultar o Knowledge Graph',
+    '- `sdd.validate` - Validar a especificação',
+    '',
+    '### Precisa de Ajuda?',
+    'Use `sdd.discover` para ver perguntas frequentes sobre o projeto.',
+  )
+
+  return lines.join('\n')
+}

package/src/sdd/workflows/refactoring.ts

@@ -0,0 +1,90 @@
+import type { KnowledgeGraph, ChangeNode, RefactoringNode } from '../domain/types.js'
+
+export interface RefactoringWorkflow {
+  id: string
+  target_module: string
+  description: string
+  refactoring_type: 'extract' | 'rename' | 'move' | 'simplify' | 'restructure'
+  files: string[]
+}
+
+export function createRefactoringChange(
+  _graph: KnowledgeGraph,
+  workflow: RefactoringWorkflow
+): { change: ChangeNode; refactoring: RefactoringNode } {
+  const changeId = `change-refactor-${Date.now()}`
+  const refactoringId = `refactor-${Date.now()}`
+
+  const refactoring: RefactoringNode = {
+    id: refactoringId,
+    type: 'refactoring',
+    name: `Refactoring: ${workflow.description}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      target_module: workflow.target_module,
+      refactoring_type: workflow.refactoring_type,
+      dependencies_affected: [],
+      tests_required: true,
+      backward_compatible: true,
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  const change: ChangeNode = {
+    id: changeId,
+    type: 'change',
+    name: `Refactoring: ${workflow.description}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      title: `Refactoring: ${workflow.description}`,
+      reason: workflow.description,
+      approval_level: 'REVIEW',
+      affected_nodes: [refactoringId],
+      affected_relationships: [],
+      new_nodes: [refactoringId],
+      removed_nodes: [],
+      modified_nodes: [],
+      affected_files: workflow.files,
+      affected_tests: [],
+      implementation_tasks: [],
+      origin: 'refactoring_workflow',
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  return { change, refactoring }
+}
+
+export function getRefactoringInstructions(refactoring: RefactoringNode): string {
+  const lines = [
+    '## Refactoring Workflow',
+    '',
+    `**Target:** ${refactoring.metadata.target_module}`,
+    `**Type:** ${refactoring.metadata.refactoring_type}`,
+    `**Tests Required:** ${refactoring.metadata.tests_required ? 'Yes' : 'No'}`,
+    `**Backward Compatible:** ${refactoring.metadata.backward_compatible ? 'Yes' : 'No'}`,
+    '',
+    '### Pre-Refactoring Checklist',
+    '1. Verify tests exist for the target module',
+    '2. Run existing tests to establish baseline',
+    '3. Analyze dependencies',
+    '',
+    '### During Refactoring',
+    '1. Make incremental changes',
+    '2. Run tests after each change',
+    '3. Commit frequently',
+    '',
+    '### Post-Refactoring',
+    '1. Run full test suite',
+    '2. Verify no regressions',
+    '3. Update documentation if needed',
+  ]
+
+  return lines.join('\n')
+}

package/src/server/events.ts

@@ -0,0 +1,184 @@
+/**
+ * Progress Event Emitter for SDD Dashboard
+ * Emits real-time events during graph build and other operations
+ */
+
+export interface ProgressEvent {
+  type: "progress" | "step" | "error" | "complete" | "info"
+  timestamp: string
+  step: string
+  message: string
+  progress?: number // 0-100
+  details?: Record<string, unknown>
+}
+
+type EventHandler = (event: ProgressEvent) => void
+
+class ProgressEventEmitter {
+  private handlers: Set<EventHandler> = new Set()
+  private currentBuild: {
+    id: string
+    startTime: number
+    steps: string[]
+    currentStep: number
+  } | null = null
+
+  /**
+   * Subscribe to progress events
+   */
+  on(handler: EventHandler): () => void {
+    this.handlers.add(handler)
+    return () => {
+      this.handlers.delete(handler)
+    }
+  }
+
+  /**
+   * Emit a progress event to all subscribers
+   */
+  emit(event: Omit<ProgressEvent, "timestamp">): void {
+    const fullEvent: ProgressEvent = {
+      ...event,
+      timestamp: new Date().toISOString(),
+    }
+
+    for (const handler of this.handlers) {
+      try {
+        handler(fullEvent)
+      } catch {
+        // Handler error should not break the emitter
+      }
+    }
+  }
+
+  /**
+   * Start tracking a new build operation
+   */
+  startBuild(buildId: string, steps: string[]): void {
+    this.currentBuild = {
+      id: buildId,
+      startTime: Date.now(),
+      steps,
+      currentStep: 0,
+    }
+
+    this.emit({
+      type: "info",
+      step: "build_start",
+      message: `Build started: ${buildId}`,
+      progress: 0,
+      details: { buildId, totalSteps: steps.length },
+    })
+  }
+
+  /**
+   * Report progress on the current build step
+   */
+  stepProgress(stepName: string, message: string, progress?: number): void {
+    this.emit({
+      type: "progress",
+      step: stepName,
+      message,
+      progress,
+    })
+  }
+
+  /**
+   * Move to the next step in the build
+   */
+  nextStep(stepName: string, message: string): void {
+    if (this.currentBuild) {
+      this.currentBuild.currentStep++
+      const progress = Math.round(
+        (this.currentBuild.currentStep / this.currentBuild.steps.length) * 100,
+      )
+
+      this.emit({
+        type: "step",
+        step: stepName,
+        message,
+        progress,
+        details: {
+          buildId: this.currentBuild.id,
+          stepIndex: this.currentBuild.currentStep,
+          totalSteps: this.currentBuild.steps.length,
+        },
+      })
+    } else {
+      this.emit({
+        type: "step",
+        step: stepName,
+        message,
+      })
+    }
+  }
+
+  /**
+   * Report an error during build
+   */
+  error(stepName: string, message: string, details?: Record<string, unknown>): void {
+    this.emit({
+      type: "error",
+      step: stepName,
+      message,
+      details,
+    })
+  }
+
+  /**
+   * Complete the current build
+   */
+  complete(summary: string, details?: Record<string, unknown>): void {
+    const duration = this.currentBuild
+      ? Date.now() - this.currentBuild.startTime
+      : 0
+
+    this.emit({
+      type: "complete",
+      step: "build_complete",
+      message: summary,
+      progress: 100,
+      details: {
+        ...details,
+        durationMs: duration,
+        buildId: this.currentBuild?.id,
+      },
+    })
+
+    this.currentBuild = null
+  }
+
+  /**
+   * Get the number of active subscribers
+   */
+  getSubscriberCount(): number {
+    return this.handlers.size
+  }
+
+  /**
+   * Check if a build is currently in progress
+   */
+  isBuilding(): boolean {
+    return this.currentBuild !== null
+  }
+
+  /**
+   * Get current build info
+   */
+  getCurrentBuild(): { id: string; progress: number; currentStep: string } | null {
+    if (!this.currentBuild) return null
+
+    const progress = Math.round(
+      (this.currentBuild.currentStep / this.currentBuild.steps.length) * 100,
+    )
+
+    return {
+      id: this.currentBuild.id,
+      progress,
+      currentStep: this.currentBuild.steps[this.currentBuild.currentStep] || "unknown",
+    }
+  }
+}
+
+// Singleton instance
+export const progressEmitter = new ProgressEventEmitter()