You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: align wireframe with neutral scaffold surface
Update the CLI wireframe to describe the repo that actually ships today instead of the removed starter-family model.
Document the single neutral-shell scaffold path, the retained /jobs contract, the generated solverforge.app.toml and ui-model outputs, and the fact that default_template remains only as a legacy rc parser field rather than a public scaffold selector.
Verification:
- audited WIREFRAME.md against src/commands/new.rs, src/rc.rs, and current scaffold tests
Copy file name to clipboardExpand all lines: WIREFRAME.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,13 +2,14 @@
2
2
3
3
## Scaffolding Surface
4
4
5
-
The standalone CLI ships two built-in scaffold families only:
5
+
The standalone CLI currently ships one built-in scaffold path only:
6
6
7
-
-`solverforge new <name> --standard`
8
-
-`solverforge new <name> --list`
7
+
-`solverforge new <name>`
9
8
10
9
Domain-specific examples such as employee scheduling and vehicle routing are intentionally out of scope for the built-in scaffold catalog. They belong in quickstarts.
11
10
11
+
That built-in scaffold is a neutral shell. Users shape it afterward through facts, entities, variables, constraints, generated data, and `solverforge.app.toml` instead of selecting a starter family up front.
12
+
12
13
## Frontend Rule
13
14
14
15
For any generated frontend feature, ask first: does `solverforge-ui` already provide it?
@@ -25,12 +26,14 @@ The scaffold may still own thin composition code for domain-specific projections
25
26
26
27
## Generated Project Shape
27
28
28
-
Both built-in scaffold families should generate:
29
+
The built-in neutral scaffold should generate:
29
30
30
31
-`Cargo.toml` with published `solverforge` and `solverforge-ui` dependencies
31
-
-`src/api/` exposing the REST/SSE contract expected by `solverforge-ui`
32
+
-`solverforge.app.toml` as the scaffolded app/domain contract
33
+
-`src/api/` exposing the retained `/jobs` REST/SSE contract expected by `solverforge-ui`
32
34
-`static/index.html` loading `/sf/sf.css` and `/sf/sf.js`
33
35
-`static/app.js` containing only app composition and view-specific rendering
36
+
-`static/generated/ui-model.json` as the compiler-owned view/model projection
34
37
-`static/sf-config.json` as the preserved customization seam
35
38
36
39
## `sf-config.json`
@@ -44,7 +47,6 @@ The CLI may extend the config only for scaffold-owned rendering concerns. It sho
44
47
45
48
## RC Defaults
46
49
47
-
`default_template`values should align with the problem-type surface:
50
+
`.solverforgerc` still carries a legacy `default_template`field in the parser for compatibility with older configs and tests, but it is not part of the current public scaffold surface and does not define multiple starter families today.
48
51
49
-
-`"standard"`
50
-
-`"list"`
52
+
Do not extend docs or new features around `default_template` unless the public scaffold model changes again.
0 commit comments