Files
resolutionflow/frontend/src/lib/treeMarkdownSync.ts
chihlasm eac6e184ec feat: add dual-mode tree editor with Code Mode, variables, and markdown sync
Implements the full dual-mode tree editor (Plan Phases 1-5):

Backend:
- JSONB↔Markdown bidirectional serializer/parser with mistune
- Markdown validator with line/column error reporting
- 3 API endpoints: export-markdown, import-markdown, validate-markdown
- Variable extraction/resolution service ([USER_INPUT], [VAR], [SAVE_AS])
- Session variables JSONB column (migration 028)
- 39 tree markdown tests + variable service tests (403 total passing)

Frontend:
- Monaco-based Code Mode with custom Monarch tokenizer and dark theme
- Autocomplete for @node_id refs, type values, variable names
- Debounced validation (800ms) with inline Monaco error markers
- Syntax help panel (absolute overlay, toggleable)
- Starter template for new trees with valid cross-references
- Bidirectional metadata sync (name/description/category/tags frontmatter)
- Synchronous tree→markdown serializer (fixes async race condition)
- Pre-save validation blocks save on broken refs or missing tree name
- Mode-aware undo/redo: Monaco native in Code Mode, throttled zundo in Flow Mode
- Variable prompt modal and frontend resolver for session navigation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-10 09:45:26 -05:00

91 lines
2.6 KiB
TypeScript

import type { TreeStructure } from '@/types'
export interface TreeMetadata {
name?: string
description?: string
category?: string
tags?: string[]
}
/**
* Lightweight frontend serializer for instant preview when switching Form→Code.
* The backend remains authoritative for actual saves.
*/
export function treeStructureToMarkdownPreview(
structure: TreeStructure,
metadata?: TreeMetadata,
): string {
const blocks: string[] = []
if (metadata) {
const fm = ['---']
if (metadata.name) fm.push(`name: ${metadata.name}`)
if (metadata.description) fm.push(`description: ${metadata.description}`)
if (metadata.category) fm.push(`category: ${metadata.category}`)
if (metadata.tags?.length) fm.push(`tags: [${metadata.tags.join(', ')}]`)
fm.push('---')
blocks.push(fm.join('\n'))
}
serializeNode(structure, null, blocks)
return blocks.join('\n\n') + '\n'
}
function serializeNode(
node: TreeStructure,
parentId: string | null,
blocks: string[],
): void {
const fm = ['---', `id: ${node.id}`, `type: ${node.type}`]
if (parentId !== null) fm.push(`parent: ${parentId}`)
fm.push('---')
const body: string[] = []
if (node.type === 'decision') {
if (node.question) {
body.push(`# ${node.question}`, '')
}
if (node.help_text) {
for (const line of node.help_text.split('\n')) {
body.push(`> ${line}`)
}
body.push('')
}
if (node.options) {
node.options.forEach((opt, i) => {
const letter = String.fromCharCode(65 + i)
if (opt.next_node_id) {
body.push(`- [${letter}] ${opt.label} → @${opt.next_node_id}`)
} else {
body.push(`- [${letter}] ${opt.label}`)
}
})
}
} else if (node.type === 'action') {
if (node.title) body.push(`## ${node.title}`, '')
if (node.description) body.push(node.description, '')
if (node.commands?.length) {
body.push('```commands')
node.commands.forEach(cmd => body.push(cmd))
body.push('```', '')
}
if (node.expected_outcome) body.push(`**Expected:** ${node.expected_outcome}`, '')
if (node.next_node_id) body.push(`→ @${node.next_node_id}`)
} else if (node.type === 'solution') {
if (node.title) body.push(`## ${node.title}`, '')
if (node.description) body.push(node.description, '')
if (node.resolution_steps?.length) {
node.resolution_steps.forEach((step, i) => body.push(`${i + 1}. ${step}`))
}
}
blocks.push(fm.join('\n') + '\n' + body.join('\n'))
if (node.children) {
for (const child of node.children) {
serializeNode(child, node.id, blocks)
}
}
}