T-09DA-retire-workflow-designer-and-vault-backup
State: closed/done · Impact: medium · Complexity: small
experiences/flows and experiences/backup are the platform ports of the two standalone Nuxt
dashboards, so the dashboards are dead code carrying their own mermaid and marked. Both
directories also hold a cli.ts that platform-core still runs as a node sidecar. This task
deletes the dashboard halves now and leaves the CLIs for the sidecar retirement that
solutions/determined/docs/planning/rust-backends/ARCHITECTURE.md already schedules.
| Location | Role today |
|---|---|
solutions/determined/apps/workflow-designer/ | Nuxt dashboard (app/, server/, nuxt.config.ts) plus cli.ts and lib/; mermaid dependency; root workspace via the solutions/determined/apps/* glob; no moon project |
solutions/determined/apps/workflow-designer/app/components/MermaidPreview.vue | Standalone mermaid render |
solutions/determined/apps/vault-backup/ | Nuxt dashboard (app/, server/, nuxt.config.ts) plus cli.ts and lib/; marked dependency |
solutions/determined/apps/vault-backup/app/components/FilePreview.vue | marked render of previewed files |
solutions/determined/apps/vault-backup/moon.yml | Tasks dev, build, preview, cli, test; explicit source in .moon/workspace.yml |
.moon/workspace.yml | vault-backup: 'solutions/determined/apps/vault-backup' |
solutions/determined/crates/platform-core/src/sidecar.rs | AppSpec entries run apps/vault-backup/cli.ts and apps/workflow-designer/cli.ts |
solutions/determined/crates/platform-core/src/backends/node/backup.rs | Node arm of BackupPort over the vault-backup CLI; header schedules its deletion with the Rust-arm flip |
solutions/determined/experiences/flows/ | Platform port of the workflow designer |
solutions/determined/experiences/backup/ | Platform port of the backup dashboard; BackupFilePreview.vue renders text as an escaped <pre> |
solutions/determined/apps/README.md | Lists vault-backup/ |
solutions/determined/docs/planning/notes-obsidian/LIBRARY-REPORT.md | Lists vault-backup’s FilePreview.vue as a marked consolidation candidate |
Proposed
Section titled “Proposed”Both apps keep cli.ts, lib/, package.json, README.md and tsconfig.json. Their app/,
server/ and nuxt.config.ts are deleted, along with the dev, build and preview scripts,
the nuxt, vue, mermaid and marked dependencies, and the matching moon tasks. The
.moon/workspace.yml entry stays because the vault-backup CLI is still a project. The README
and LIBRARY-REPORT rows describe the CLI-only shape. Full directory deletion happens with the
sidecar retirement PRs named in backends/node/backup.rs.
Approach
Section titled “Approach”- Confirm coverage: every page and component under
apps/workflow-designer/app/has a counterpart underexperiences/flows/app/, and every one underapps/vault-backup/app/has a counterpart underexperiences/backup/app/; record the mapping in the PR. - Confirm the CLIs are live:
sidecar.rsnames bothcli.tsentries. Keep them. - Delete
app/,server/,nuxt.config.tsin both apps; strip dashboard scripts and dependencies from bothpackage.jsonfiles; trimvault-backup/moon.ymltocliandtest. - Rewrite the READMEs of both apps to describe the CLI only; update
solutions/determined/apps/README.mdand the LIBRARY-REPORT row. - Root
bun install;bun install --frozen-lockfile;bun testinapps/vault-backup(backup.test.ts,summarize.test.ts);cargo test -p platform-core;moon run vault-backup:test;moon run :check :test --affected. - Flip the mermaid preview and vault-backup render-site rows of the duplicates ledger in
docs/LIBRARIES.md.
Files to touch
Section titled “Files to touch”| Location | Kind | Change |
|---|---|---|
solutions/determined/apps/workflow-designer/app/ | delete | Dashboard pages and components, including MermaidPreview.vue |
solutions/determined/apps/workflow-designer/server/ | delete | Dashboard server routes |
solutions/determined/apps/workflow-designer/nuxt.config.ts | delete | Dashboard config |
solutions/determined/apps/workflow-designer/package.json | modify | Drop dev, build, nuxt, vue, mermaid |
solutions/determined/apps/workflow-designer/README.md | modify | CLI-only description |
solutions/determined/apps/vault-backup/app/ | delete | Dashboard pages and components, including FilePreview.vue |
solutions/determined/apps/vault-backup/server/ | delete | Dashboard server routes |
solutions/determined/apps/vault-backup/nuxt.config.ts | delete | Dashboard config |
solutions/determined/apps/vault-backup/package.json | modify | Drop dev, build, nuxt, vue, marked |
solutions/determined/apps/vault-backup/moon.yml | modify | Remove dev, build, preview tasks |
solutions/determined/apps/vault-backup/README.md | modify | CLI-only description |
solutions/determined/apps/README.md | modify | Row describes the CLI |
solutions/determined/docs/planning/notes-obsidian/LIBRARY-REPORT.md | modify | FilePreview.vue row marked retired |
docs/LIBRARIES.md | modify | Ledger rows flip to resolved |
bun.lock | modify | Root lockfile regen |
Acceptance criteria
Section titled “Acceptance criteria”- AC-1: Neither
solutions/determined/apps/workflow-designer/app/norsolutions/determined/apps/vault-backup/app/exists; neither app has anuxt.config.tsor aserver/directory. - AC-2:
grep -n "mermaid\|nuxt" solutions/determined/apps/workflow-designer/package.jsonandgrep -n "marked\|nuxt" solutions/determined/apps/vault-backup/package.jsonreturn nothing. - AC-3:
solutions/determined/apps/vault-backup/cli.tsandsolutions/determined/apps/workflow-designer/cli.tsstill exist andcargo test -p platform-corepasses. - AC-4:
bun testinsolutions/determined/apps/vault-backupandmoon run vault-backup:testpass;bun install --frozen-lockfilepasses at the root. - AC-5: The PR body carries the page-to-page coverage mapping from Approach step 1.
- AC-6:
grep -rn "FilePreview.vue\|MermaidPreview.vue" solutions/determined/docs solutions/determined/apps/README.mdreturns only rows marked retired.
Out of scope
Section titled “Out of scope”- Deleting the CLIs,
sidecar.rsentries orbackends/node/backup.rs; those go with the Rust-arm capability flips perrust-backends/ARCHITECTURE.md. - Rendering markdown in
BackupFilePreview.vue; it is an escaped<pre>by design. - Historical planning documents under
solutions/determined/docs/planning/that narrate the apps; only the live rows named above change.
Dependencies
Section titled “Dependencies”- None on other tasks. The user decision recorded in the program plan asked for whole-directory
deletion; the live sidecar entries in
platform-corenarrow this to the dashboard halves, which is whyneed_human_reviewis set. D-7VMX-markdown-ecosystem-strategyd.10: twomarked/mermaidrender sites are deleted.
Discovery context
Section titled “Discovery context”Member of milestone M-931L; waves 3b and 3c of D-K3EM-markdown-editor-chrome-and-plugin-environment.