opencode-telos 1.0.0

package/src/sdd/workflow/exporter.ts

@@ -0,0 +1,169 @@
+import type { KnowledgeGraph, ChangeNode, DecisionNode } from "../domain/types.js"
+import { getNodesByType } from "../graph/engine.js"
+import { getPendingChanges } from "../changes/manager.js"
+
+export interface WorkflowExport {
+  project_id: string
+  exported_at: string
+  summary: {
+    total_nodes: number
+    total_relationships: number
+    nodes_by_type: Record<string, number>
+    status_distribution: Record<string, number>
+  }
+  changes: ChangeExport[]
+  decisions: DecisionExport[]
+  blockers: BlockerExport[]
+  recommendations: string[]
+}
+
+export interface ChangeExport {
+  id: string
+  status: string
+  title: string
+  created_at: string
+}
+
+export interface DecisionExport {
+  id: string
+  decision: string
+  rationale?: string
+  created_at: string
+}
+
+export interface BlockerExport {
+  node_id: string
+  node_type: string
+  name: string
+  reason: string
+}
+
+export function exportWorkflow(graph: KnowledgeGraph): WorkflowExport {
+  const nodesByType: Record<string, number> = {}
+  for (const node of graph.nodes) {
+    nodesByType[node.type] = (nodesByType[node.type] || 0) + 1
+  }
+
+  const statusDistribution: Record<string, number> = {}
+  for (const node of graph.nodes) {
+    statusDistribution[node.status] = (statusDistribution[node.status] || 0) + 1
+  }
+
+  const changes = getNodesByType<ChangeNode>(graph, "change").map((c) => ({
+    id: c.id,
+    status: c.status,
+    title: c.metadata.title,
+    created_at: c.created_at,
+  }))
+
+  const decisions = getNodesByType<DecisionNode>(graph, "decision").map((d) => ({
+    id: d.id,
+    decision: d.metadata.decision,
+    rationale: d.metadata.context,
+    created_at: d.created_at,
+  }))
+
+  const blockers = graph.nodes
+    .filter((n) => n.status === "BLOCKED")
+    .map((n) => ({
+      node_id: n.id,
+      node_type: n.type,
+      name: n.name,
+      reason: (n.metadata as any).reason || "Unknown",
+    }))
+
+  const recommendations = generateRecommendations(graph)
+
+  return {
+    project_id: graph.project_id,
+    exported_at: new Date().toISOString(),
+    summary: {
+      total_nodes: graph.nodes.length,
+      total_relationships: graph.relationships.length,
+      nodes_by_type: nodesByType,
+      status_distribution: statusDistribution,
+    },
+    changes,
+    decisions,
+    blockers,
+    recommendations,
+  }
+}
+
+function generateRecommendations(graph: KnowledgeGraph): string[] {
+  const recs: string[] = []
+
+  const pendingChanges = getPendingChanges(graph)
+  if (pendingChanges.length > 3) {
+    recs.push(`${pendingChanges.length} changes pending approval - consider batch review`)
+  }
+
+  const features = getNodesByType(graph, "feature")
+  const completedFeatures = features.filter((f) => f.status === "COMPLETED")
+  if (features.length > 0 && completedFeatures.length / features.length < 0.5) {
+    recs.push("Less than 50% of features completed - focus on finishing existing work")
+  }
+
+  const requirements = getNodesByType(graph, "requirement")
+  const tests = getNodesByType(graph, "test")
+  if (requirements.length > 0 && tests.length < requirements.length * 0.5) {
+    recs.push("Low test coverage - add tests for requirements")
+  }
+
+  const blocked = graph.nodes.filter((n) => n.status === "BLOCKED")
+  if (blocked.length > 0) {
+    recs.push(`${blocked.length} blocked items need resolution`)
+  }
+
+  if (recs.length === 0) {
+    recs.push("Project looks healthy - keep up the good work!")
+  }
+
+  return recs
+}
+
+export function formatWorkflowExport(exp: WorkflowExport): string {
+  const lines = [
+    `## SDD Workflow Export`,
+    `**Project:** ${exp.project_id}`,
+    `**Exported:** ${exp.exported_at}`,
+    "",
+    "### Summary",
+    `- Nodes: ${exp.summary.total_nodes}`,
+    `- Relationships: ${exp.summary.total_relationships}`,
+    "",
+    "#### Nodes by Type",
+  ]
+
+  for (const [type, count] of Object.entries(exp.summary.nodes_by_type)) {
+    lines.push(`- ${type}: ${count}`)
+  }
+
+  lines.push("\n#### Status Distribution")
+  for (const [status, count] of Object.entries(exp.summary.status_distribution)) {
+    lines.push(`- ${status}: ${count}`)
+  }
+
+  if (exp.changes.length > 0) {
+    lines.push("\n### Changes")
+    for (const c of exp.changes) {
+      lines.push(`- **${c.id}** (${c.status}): ${c.title}`)
+    }
+  }
+
+  if (exp.blockers.length > 0) {
+    lines.push("\n### Blockers")
+    for (const b of exp.blockers) {
+      lines.push(`- **${b.name}** (${b.node_type}): ${b.reason}`)
+    }
+  }
+
+  if (exp.recommendations.length > 0) {
+    lines.push("\n### Recommendations")
+    for (const r of exp.recommendations) {
+      lines.push(`- ${r}`)
+    }
+  }
+
+  return lines.join("\n")
+}

package/src/sdd/workflows/ab-testing.ts

@@ -0,0 +1,90 @@
+import type { KnowledgeGraph, ChangeNode, ExperimentNode } from '../domain/types.js'
+
+export interface ABTestingWorkflow {
+  id: string
+  hypothesis: string
+  variants: Array<{
+    name: string
+    description: string
+    traffic_percentage: number
+  }>
+  primary_metric: string
+  duration_days: number
+}
+
+export function createExperimentChange(
+  _graph: KnowledgeGraph,
+  workflow: ABTestingWorkflow
+): { change: ChangeNode; experiment: ExperimentNode } {
+  const changeId = `change-experiment-${Date.now()}`
+  const experimentId = `experiment-${Date.now()}`
+
+  const experiment: ExperimentNode = {
+    id: experimentId,
+    type: 'experiment',
+    name: `Experiment: ${workflow.hypothesis}`,
+    description: workflow.hypothesis,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      hypothesis: workflow.hypothesis,
+      variants: workflow.variants,
+      primary_metric: workflow.primary_metric,
+      duration_days: workflow.duration_days,
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  const change: ChangeNode = {
+    id: changeId,
+    type: 'change',
+    name: `Experiment: ${workflow.hypothesis}`,
+    description: workflow.hypothesis,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      title: `Experiment: ${workflow.hypothesis}`,
+      reason: workflow.hypothesis,
+      approval_level: 'REVIEW',
+      affected_nodes: [experimentId],
+      affected_relationships: [],
+      new_nodes: [experimentId],
+      removed_nodes: [],
+      modified_nodes: [],
+      affected_files: [],
+      affected_tests: [],
+      implementation_tasks: [],
+      origin: 'ab_testing_workflow',
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  return { change, experiment }
+}
+
+export function getExperimentInstructions(experiment: ExperimentNode): string {
+  const lines = [
+    '## A/B Testing Workflow',
+    '',
+    `**Hypothesis:** ${experiment.metadata.hypothesis}`,
+    `**Primary Metric:** ${experiment.metadata.primary_metric}`,
+    `**Duration:** ${experiment.metadata.duration_days} days`,
+    '',
+    '### Variants',
+    ...experiment.metadata.variants.map(v => 
+      `- **${v.name}**: ${v.description} (${v.traffic_percentage}% traffic)`
+    ),
+    '',
+    '### Steps',
+    '1. Implement variant code',
+    '2. Set up tracking for primary metric',
+    '3. Split traffic according to percentages',
+    '4. Monitor for statistical significance',
+    '5. Analyze results after duration',
+    '6. Implement winning variant',
+  ]
+
+  return lines.join('\n')
+}

package/src/sdd/workflows/bug-fix.ts

@@ -0,0 +1,81 @@
+import type { KnowledgeGraph, ChangeNode, BugFixNode } from '../domain/types.js'
+
+export interface BugFixWorkflow {
+  id: string
+  description: string
+  files: string[]
+  severity: 'critical' | 'high' | 'medium' | 'low'
+}
+
+export function createBugFixChange(
+  _graph: KnowledgeGraph,
+  workflow: BugFixWorkflow
+): { change: ChangeNode; bugFix: BugFixNode } {
+  const changeId = `change-bugfix-${Date.now()}`
+  const bugFixId = `bugfix-${Date.now()}`
+
+  const bugFix: BugFixNode = {
+    id: bugFixId,
+    type: 'bug_fix',
+    name: `Bug Fix: ${workflow.description}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      bug_description: workflow.description,
+      affected_files: workflow.files,
+      severity: workflow.severity,
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  const change: ChangeNode = {
+    id: changeId,
+    type: 'change',
+    name: `Bug Fix: ${workflow.description}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      title: `Bug Fix: ${workflow.description}`,
+      reason: workflow.description,
+      approval_level: 'AUTO',
+      affected_nodes: [bugFixId],
+      affected_relationships: [],
+      new_nodes: [bugFixId],
+      removed_nodes: [],
+      modified_nodes: [],
+      affected_files: workflow.files,
+      affected_tests: [],
+      implementation_tasks: [],
+      origin: 'bug_fix_workflow',
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  return { change, bugFix }
+}
+
+export function getBugFixInstructions(bugFix: BugFixNode): string {
+  const lines = [
+    '## Bug Fix Workflow',
+    '',
+    `**Bug:** ${bugFix.metadata.bug_description}`,
+    `**Severity:** ${bugFix.metadata.severity}`,
+    `**Affected Files:** ${bugFix.metadata.affected_files.join(', ')}`,
+    '',
+    '### Steps',
+    '1. Reproduce the bug',
+    '2. Identify root cause',
+    '3. Create fix',
+    '4. Add tests to prevent regression',
+    '5. Verify fix works',
+    '',
+    '### Auto-Approval',
+    'Bug fixes are approved automatically (AUTO approval level).',
+  ]
+
+  return lines.join('\n')
+}

package/src/sdd/workflows/data-migration.ts

@@ -0,0 +1,86 @@
+import type { KnowledgeGraph, ChangeNode, MigrationNode } from '../domain/types.js'
+
+export interface DataMigrationWorkflow {
+  id: string
+  source_schema: string
+  target_schema: string
+  description: string
+  data_transformations?: string[]
+}
+
+export function createMigrationChange(
+  _graph: KnowledgeGraph,
+  workflow: DataMigrationWorkflow
+): { change: ChangeNode; migration: MigrationNode } {
+  const changeId = `change-migration-${Date.now()}`
+  const migrationId = `migration-${Date.now()}`
+
+  const migration: MigrationNode = {
+    id: migrationId,
+    type: 'migration',
+    name: `Migration: ${workflow.description}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      source_schema: workflow.source_schema,
+      target_schema: workflow.target_schema,
+      data_transformations: workflow.data_transformations,
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  const change: ChangeNode = {
+    id: changeId,
+    type: 'change',
+    name: `Migration: ${workflow.description}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      title: `Migration: ${workflow.description}`,
+      reason: workflow.description,
+      approval_level: 'APPROVAL',
+      affected_nodes: [migrationId],
+      affected_relationships: [],
+      new_nodes: [migrationId],
+      removed_nodes: [],
+      modified_nodes: [],
+      affected_files: [],
+      affected_tests: [],
+      implementation_tasks: [],
+      origin: 'data_migration_workflow',
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  return { change, migration }
+}
+
+export function getMigrationInstructions(migration: MigrationNode): string {
+  const lines = [
+    '## Data Migration Workflow',
+    '',
+    `**Source Schema:** ${migration.metadata.source_schema}`,
+    `**Target Schema:** ${migration.metadata.target_schema}`,
+    '',
+    '### Steps',
+    '1. Backup current data',
+    '2. Analyze schema differences',
+    '3. Generate migration script',
+    '4. Test migration on staging',
+    '5. Run migration on production',
+    '6. Verify data integrity',
+    '',
+    '### Rollback',
+    'Migration includes rollback script for emergency recovery.',
+  ]
+
+  if (migration.metadata.data_transformations) {
+    lines.push('', '### Data Transformations', ...migration.metadata.data_transformations.map(t => `- ${t}`))
+  }
+
+  return lines.join('\n')
+}

package/src/sdd/workflows/deprecation.ts

@@ -0,0 +1,87 @@
+import type { KnowledgeGraph, ChangeNode, DeprecationNode } from '../domain/types.js'
+
+export interface DeprecationWorkflow {
+  id: string
+  target_feature: string
+  description: string
+  removal_date: string
+  migration_guide?: string
+  affected_endpoints: string[]
+}
+
+export function createDeprecationChange(
+  _graph: KnowledgeGraph,
+  workflow: DeprecationWorkflow
+): { change: ChangeNode; deprecation: DeprecationNode } {
+  const changeId = `change-deprecate-${Date.now()}`
+  const deprecationId = `deprecate-${Date.now()}`
+
+  const deprecation: DeprecationNode = {
+    id: deprecationId,
+    type: 'deprecation',
+    name: `Deprecation: ${workflow.target_feature}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      target_feature: workflow.target_feature,
+      removal_date: workflow.removal_date,
+      migration_guide: workflow.migration_guide,
+      affected_endpoints: workflow.affected_endpoints,
+      notification_sent: false,
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  const change: ChangeNode = {
+    id: changeId,
+    type: 'change',
+    name: `Deprecation: ${workflow.target_feature}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      title: `Deprecation: ${workflow.target_feature}`,
+      reason: workflow.description,
+      approval_level: 'APPROVAL',
+      affected_nodes: [deprecationId],
+      affected_relationships: [],
+      new_nodes: [deprecationId],
+      removed_nodes: [],
+      modified_nodes: [],
+      affected_files: [],
+      affected_tests: [],
+      implementation_tasks: [],
+      origin: 'deprecation_workflow',
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  return { change, deprecation }
+}
+
+export function getDeprecationInstructions(deprecation: DeprecationNode): string {
+  const lines = [
+    '## Deprecation Workflow',
+    '',
+    `**Target:** ${deprecation.metadata.target_feature}`,
+    `**Removal Date:** ${deprecation.metadata.removal_date}`,
+    `**Affected Endpoints:** ${deprecation.metadata.affected_endpoints.join(', ')}`,
+    '',
+    '### Steps',
+    '1. Find all usages of the feature',
+    '2. Create migration guide',
+    '3. Send notifications to affected users',
+    '4. Add deprecation warnings',
+    '5. Monitor usage',
+    '6. Remove feature on removal date',
+  ]
+
+  if (deprecation.metadata.migration_guide) {
+    lines.push('', '### Migration Guide', deprecation.metadata.migration_guide)
+  }
+
+  return lines.join('\n')
+}

package/src/sdd/workflows/feature-flags.ts

@@ -0,0 +1,91 @@
+import type { KnowledgeGraph, ChangeNode, FeatureFlagNode } from '../domain/types.js'
+
+export interface FeatureFlagWorkflow {
+  id: string
+  flag_name: string
+  description: string
+  rollout_percentage: number
+  target_audience?: string
+}
+
+export function createFeatureFlagChange(
+  _graph: KnowledgeGraph,
+  workflow: FeatureFlagWorkflow
+): { change: ChangeNode; featureFlag: FeatureFlagNode } {
+  const changeId = `change-flag-${Date.now()}`
+  const flagId = `flag-${Date.now()}`
+
+  const featureFlag: FeatureFlagNode = {
+    id: flagId,
+    type: 'feature_flag',
+    name: `Feature Flag: ${workflow.flag_name}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      flag_name: workflow.flag_name,
+      description: workflow.description,
+      enabled: false,
+      rollout_percentage: workflow.rollout_percentage,
+      target_audience: workflow.target_audience,
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  const change: ChangeNode = {
+    id: changeId,
+    type: 'change',
+    name: `Feature Flag: ${workflow.flag_name}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      title: `Feature Flag: ${workflow.flag_name}`,
+      reason: workflow.description,
+      approval_level: 'AUTO',
+      affected_nodes: [flagId],
+      affected_relationships: [],
+      new_nodes: [flagId],
+      removed_nodes: [],
+      modified_nodes: [],
+      affected_files: [],
+      affected_tests: [],
+      implementation_tasks: [],
+      origin: 'feature_flag_workflow',
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  return { change, featureFlag }
+}
+
+export function getFeatureFlagInstructions(featureFlag: FeatureFlagNode): string {
+  const lines = [
+    '## Feature Flag Workflow',
+    '',
+    `**Flag:** ${featureFlag.metadata.flag_name}`,
+    `**Description:** ${featureFlag.metadata.description}`,
+    `**Rollout:** ${featureFlag.metadata.rollout_percentage}%`,
+    '',
+    '### Implementation',
+    '1. Create flag check in code',
+    '2. Wrap feature with flag condition',
+    '3. Set up flag management',
+    '4. Monitor usage',
+    '',
+    '### Rollout Strategy',
+    '1. Start with 0% rollout',
+    '2. Gradually increase percentage',
+    '3. Monitor metrics',
+    '4. Full rollout when confident',
+    '5. Remove flag after cleanup period',
+  ]
+
+  if (featureFlag.metadata.target_audience) {
+    lines.push('', `**Target Audience:** ${featureFlag.metadata.target_audience}`)
+  }
+
+  return lines.join('\n')
+}

package/src/sdd/workflows/hotfix.ts

@@ -0,0 +1,83 @@
+import type { KnowledgeGraph, ChangeNode, HotfixNode } from '../domain/types.js'
+
+export interface HotfixWorkflow {
+  id: string
+  description: string
+  files: string[]
+  urgency: 'critical' | 'high' | 'medium'
+}
+
+export function createHotfixChange(
+  _graph: KnowledgeGraph,
+  workflow: HotfixWorkflow
+): { change: ChangeNode; hotfix: HotfixNode } {
+  const changeId = `change-hotfix-${Date.now()}`
+  const hotfixId = `hotfix-${Date.now()}`
+
+  const hotfix: HotfixNode = {
+    id: hotfixId,
+    type: 'hotfix',
+    name: `Hotfix: ${workflow.description}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      incident_description: workflow.description,
+      urgency: workflow.urgency,
+      fix_applied: false,
+      post_hoc_documented: false,
+      rollback_available: false,
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  const change: ChangeNode = {
+    id: changeId,
+    type: 'change',
+    name: `Hotfix: ${workflow.description}`,
+    description: workflow.description,
+    status: 'PROPOSED',
+    version: 1,
+    metadata: {
+      title: `Hotfix: ${workflow.description}`,
+      reason: workflow.description,
+      approval_level: 'POST_HOC',
+      affected_nodes: [hotfixId],
+      affected_relationships: [],
+      new_nodes: [hotfixId],
+      removed_nodes: [],
+      modified_nodes: [],
+      affected_files: workflow.files,
+      affected_tests: [],
+      implementation_tasks: [],
+      origin: 'hotfix_workflow',
+    },
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+  }
+
+  return { change, hotfix }
+}
+
+export function getHotfixInstructions(hotfix: HotfixNode): string {
+  const lines = [
+    '## Hotfix Workflow',
+    '',
+    `**Incident:** ${hotfix.metadata.incident_description}`,
+    `**Urgency:** ${hotfix.metadata.urgency}`,
+    '',
+    '### Emergency Mode',
+    '1. Enforcement is temporarily disabled',
+    '2. Apply the fix directly',
+    '3. After fix is applied, document retroactively',
+    '',
+    '### Post-Hoc Documentation',
+    'After the incident is resolved:',
+    '1. Use `sdd.hotfix` to document the change',
+    '2. Create proper Change node with status COMPLETED',
+    '3. Re-enable enforcement',
+  ]
+
+  return lines.join('\n')
+}