Files
resolutionflow/frontend/src/lib/treeMarkdownSync.ts
2026-02-18 02:01:11 -05:00

95 lines
2.9 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}`))
}
} else if (node.type === 'answer') {
// Answer placeholder — render as a clearly marked stub
body.push(`## [ANSWER PLACEHOLDER] ${node.title || 'Untitled'}`, '')
body.push('> This is an unresolved answer stub. Convert it to a Decision, Action, or Solution before publishing.')
}
blocks.push(fm.join('\n') + '\n' + body.join('\n'))
if (node.children) {
for (const child of node.children) {
serializeNode(child, node.id, blocks)
}
}
}