ui/server/src/workflowsViewer

Backend for epic .

Cockpit server, next. Source: ui/server/src/workflowsViewer.mjs.

Functions#

editWorkflowFile()#

editWorkflowFile(root, feature, file, req, __namedParameters): { after: string; before: any; contentHash: string; ok: boolean; } | { after?: undefined; before?: undefined; contentHash: string; error: string; feature: any; file: any; machines: any[]; ok: boolean; path: string; savedPath: string; violations: any[]; }

Defined in: ui/server/src/workflowsViewer.mjs:93

-- one visual edit, applied as an exact source-range edit (src/engine/workflowEditor.mjs). commit:false returns the patched source for the client's diff preview without touching disk; commit:true re-applies the SAME request server-side (the client never sends file content), checks the contentHash still matches (no clobbering a concurrent edit), runs the same architecture/SoC enforcement gate the pages editor uses, and only then writes. Nothing besides the source file is stored.

Parameters#

root

any

feature

any

file

any

req

any

__namedParameters

commit

any

contentHash

any

Returns#

{ after: string; before: any; contentHash: string; ok: boolean; } | { after?: undefined; before?: undefined; contentHash: string; error: string; feature: any; file: any; machines: any[]; ok: boolean; path: string; savedPath: string; violations: any[]; }

---

listWorkflowFeatures()#

listWorkflowFeatures(root): string[]

Defined in: ui/server/src/workflowsViewer.mjs:23

Features that actually have a workflows/ folder.

Parameters#

root

any

Returns#

string[]

---

listWorkflowFiles()#

listWorkflowFiles(root, feature): string[]

Defined in: ui/server/src/workflowsViewer.mjs:29

Every source file under features//workflows/**, relative to it.

Parameters#

root

any

feature

any

Returns#

string[]

---

readWorkflowMachines()#

readWorkflowMachines(root, feature, file): object

Defined in: ui/server/src/workflowsViewer.mjs:69

Machines defined in one workflow file, extracted from the live source.

Parameters#

root

any

feature

any

file

any

Returns#

object

contentHash

contentHash: string

error

error: string

feature

feature: any

file

file: any

machines

machines: any[]

path

path: string = relPath

---

readWorkflowNarrative()#

readWorkflowNarrative(root, feature, file): object

Defined in: ui/server/src/workflowsViewer.mjs:79

Epic -- the machines of one workflow file explained in plain English (narrative, scenarios, health findings), derived fresh from the source on every request (src/engine/workflowExplain.mjs). Same scope guard as readWorkflowMachines; read-only, nothing stored.

Parameters#

root

any

feature

any

file

any

Returns#

object

contentHash

contentHash: string

error

error: string

feature

feature: any

file

file: any

machines

machines: any[]

path

path: string = relPath

---

resolveWorkflowFile()#

resolveWorkflowFile(root, feature, file): object

Defined in: ui/server/src/workflowsViewer.mjs:47

Resolve + validate a (feature, file) pair to an absolute path strictly inside that feature's workflows/ folder (or throw PagesEditorError).

Parameters#

root

any

feature

any

file

any

Returns#

object

absPath

absPath: any = real

relPath

relPath: string