complete scaffolding

Author: xlc-dev

docs/book/design.html

@@ -522,10 +522,10 @@ <h3 id="scaffolding"><a class="header" href="#scaffolding">Scaffolding</a></h3>
 It customizes directory names, filenames, and file contents based on user input (like project name and database choice),
 effectively bootstrapping a new application with a chosen layout.</p>
 <p>The core logic resides in the createFromTemplate function, w
-hich is invoked by higher-level functions like CreateMinimal, CreateStructured, or CreateTODO.
+hich is invoked by higher-level functions like CreateMinimal, or CreateStructured.
 It systematically processes template items to build the new project. If any step fails, the scaffolding process is halted, and an error is returned.</p>
 <pre class="mermaid">flowchart TD
-    A_USER_CALL[&quot;User calls CreateMinimal, CreateStructured, or CreateTODO&quot;] --&gt; B_INVOKE_CFT[&quot;Invoke createFromTemplate(name, templateConfig, dbImport)&quot;]
+    A_USER_CALL[&quot;User calls CreateMinimal or CreateStructured&quot;] --&gt; B_INVOKE_CFT[&quot;Invoke createFromTemplate(name, templateConfig, dbImport)&quot;]
 
     B_INVOKE_CFT --&gt; C_START_CFT[&quot;Start createFromTemplate&quot;]
 

docs/book/scaffolding.html

@@ -158,7 +158,7 @@ <h1 class="menu-title">nova</h1>
                         <h1 id="scaffolding"><a class="header" href="#scaffolding">Scaffolding</a></h1>
 <p><strong>scaffolding</strong> in Nova automates project bootstrapping. It provides:</p>
 <ul>
-<li><strong>Multiple Layouts:</strong> Choose between Minimal, Structured, or TODO-style starter kits.</li>
+<li><strong>Multiple Layouts:</strong> Choose between Minimal or Structured template.</li>
 <li><strong>Name-Aware Paths:</strong> Template filenames and directories can include <code>{{.Name}}</code> to personalize paths.</li>
 <li><strong>Content Templating:</strong> File contents are processed as Go <code>text/template</code>, with access to project metadata.</li>
 <li><strong>Database Adapter Injection:</strong> Select between <code>sqlite</code>, <code>postgres</code>, or <code>mysql</code>; the correct Go import path is injected.</li>
@@ -181,7 +181,6 @@ <h2 id="core-concepts"><a class="header" href="#core-concepts">Core Concepts</a>
 <ul>
 <li><strong>Minimal:</strong> A bare-bones project with a single <code>main.go</code> file.</li>
 <li><strong>Structured:</strong> A more complete project with a <code>main.go</code> file, a <code>cmd</code> directory, and a <code>db</code> directory.</li>
-<li><strong>TODO:</strong> A full TODO CRUD API making use of all Nova’s powers to show off Nova’s capabilities.</li>
 </ul>
 <p>When you select a template, you get the following options:</p>
 <ul>

docs/book/searchindex.js

@@ -407,12 +407,12 @@ It customizes directory names, filenames, and file contents based on user input
 effectively bootstrapping a new application with a chosen layout.
 
 The core logic resides in the createFromTemplate function, w
-hich is invoked by higher-level functions like CreateMinimal, CreateStructured, or CreateTODO.
+hich is invoked by higher-level functions like CreateMinimal, or CreateStructured.
 It systematically processes template items to build the new project. If any step fails, the scaffolding process is halted, and an error is returned.
 
 ```mermaid
 flowchart TD
-    A_USER_CALL["User calls CreateMinimal, CreateStructured, or CreateTODO"] --> B_INVOKE_CFT["Invoke createFromTemplate(name, templateConfig, dbImport)"]
+    A_USER_CALL["User calls CreateMinimal or CreateStructured"] --> B_INVOKE_CFT["Invoke createFromTemplate(name, templateConfig, dbImport)"]
 
     B_INVOKE_CFT --> C_START_CFT["Start createFromTemplate"]
 

docs/src/design.md

@@ -2,7 +2,7 @@
 
 **scaffolding** in Nova automates project bootstrapping. It provides:
 
-- **Multiple Layouts:** Choose between Minimal, Structured, or TODO-style starter kits.
+- **Multiple Layouts:** Choose between Minimal or Structured template.
 - **Name-Aware Paths:** Template filenames and directories can include `{{.Name}}` to personalize paths.
 - **Content Templating:** File contents are processed as Go `text/template`, with access to project metadata.
 - **Database Adapter Injection:** Select between `sqlite`, `postgres`, or `mysql`; the correct Go import path is injected.
@@ -32,7 +32,6 @@ When you run `nova new`, Nova creates a new project directory based on a templat
 
 - **Minimal:** A bare-bones project with a single `main.go` file.
 - **Structured:** A more complete project with a `main.go` file, a `cmd` directory, and a `db` directory.
-- **TODO:** A full TODO CRUD API making use of all Nova's powers to show off Nova's capabilities.
 
 When you select a template, you get the following options:
 

docs/src/scaffolding.md

@@ -109,9 +109,9 @@ func (g *projectGenerator) promptUserForChoices() error {
 	var err error
 
 	// Template selection
-	templateOptions := []string{"minimal", "todo", "structured"}
+	templateOptions := []string{"minimal", "structured"}
 	g.templateChoice, err = g.ask(
-		"Select template (minimal, todo, structured): ",
+		"Select template (minimal, structured): ",
 		templateOptions,
 	)
 	if err != nil {
@@ -161,7 +161,6 @@ func (g *projectGenerator) promptUserForChoices() error {
 func (g *projectGenerator) createFromTemplate() error {
 	createFns := map[string]func(projectDir string, isVerbose bool, dbAdapter string) error{
 		"minimal":    templates.CreateMinimal,
-		"todo":       templates.CreateTODO,
 		"structured": templates.CreateStructured,
 	}
 	createFn, exists := createFns[g.templateChoice]

main.go

@@ -21,7 +21,7 @@ func main() {
 	cli, err := nova.NewCLI(&nova.CLI{
 		Name: "Nova",
 		Version: "0.0.1",
-		Description: "{{.Name}} API",
+		Description: "{{.ProjectName}} API",
 		GlobalFlags: []nova.Flag{
 			&nova.BoolFlag{
 				Name:        "verbose",
@@ -86,7 +86,7 @@ func main() {
 
 					// Register Hello route.
 					router.Get("/hello/{name}", func(w http.ResponseWriter, r *http.Request) {
-						w.Write([]byte("Hello, {{.Name}}!"))
+						w.Write([]byte("Hello, {{.ProjectName}}!"))
 					})
 
 					// Start the Nova server.

templates/minimal/main.go.tmpl

@@ -22,12 +22,12 @@ type templateConfig struct {
 }
 
 // templateData holds the data passed to path and content templates.
-// Name is the project name, DBImport is the database identifier,
+// ProjectName is the project name, DBImport is the database identifier,
 // and DBAdapter is the Go import path for the chosen database adapter.
 type templateData struct {
-	Name      string
-	DBImport  string
-	DBAdapter string
+	ProjectName string
+	DBImport    string
+	DBAdapter   string
 }
 
 // getDBAdapter returns the Go import path for a given database identifier.
@@ -49,7 +49,7 @@ func getDBAdapter(dbImport string) string {
 // createFromTemplate walks the embedded TemplateFS under TemplateDir,
 // processes each path and file as a Go text/template applied to
 // templateData, and writes the results under the new project directory
-// named by 'name'. Returns any error encountered.
+// named by 'ProjectName'. Returns any error encountered.
 func createFromTemplate(
 	projectDir string,
 	projectName string,
@@ -63,9 +63,9 @@ func createFromTemplate(
 
 	// Prepare the data for templating
 	data := templateData{
-		Name:      projectName,
-		DBImport:  dbImport,
-		DBAdapter: getDBAdapter(dbImport),
+		ProjectName: projectName,
+		DBImport:    dbImport,
+		DBAdapter:   getDBAdapter(dbImport),
 	}
 
 	// Walk the embedded filesystem and handle each entry
@@ -107,7 +107,7 @@ func createFromTemplate(
 
 // processPathTemplate applies Go text/template to a file or directory path,
 // stripping any ".tmpl" suffix from the base name. The result is joined under
-// the project root 'name'. Returns the final filesystem path.
+// the project root 'ProjectName'. Returns the final filesystem path.
 func processPathTemplate(
 	path, projectDir string, data templateData,
 ) (string, error) {
@@ -195,9 +195,6 @@ var minimalTemplate embed.FS
 //go:embed structured/*
 var structuredTemplate embed.FS
 
-//go:embed todo/*
-var todoTemplate embed.FS
-
 // CreateMinimal generates a new project using the minimal template layout.
 // name is the project directory, verbose enables logging, and dbImport
 // selects the database adapter ("sqlite", "postgres", "mysql").
@@ -221,15 +218,3 @@ func CreateStructured(projectDir string, verbose bool, dbImport string) error {
 		Verbose:     verbose,
 	}, dbImport)
 }
-
-// CreateTODO generates a new project using the TODO-style template layout.
-// name is the project directory, verbose enables logging, and dbImport
-// selects the database adapter ("sqlite", "postgres", "mysql").
-func CreateTODO(projectDir string, verbose bool, dbImport string) error {
-	projectName := filepath.Base(projectDir)
-	return createFromTemplate(projectDir, projectName, templateConfig{
-		TemplateFS:  todoTemplate,
-		TemplateDir: "todo",
-		Verbose:     verbose,
-	}, dbImport)
-}

templates/scaffolding.go

@@ -30,9 +30,9 @@ func TestGetDBAdapter(t *testing.T) {
 // TestProcessPathTemplate remains the same, no file I/O.
 func TestProcessPathTemplate(t *testing.T) {
 	data := templateData{
-		Name:      "proj",
-		DBImport:  "sqlite",
-		DBAdapter: getDBAdapter("sqlite"),
+		ProjectName: "proj",
+		DBImport:    "sqlite",
+		DBAdapter:   getDBAdapter("sqlite"),
 	}
 	in := "dir/{{.Name}}.tmpl"
 	out, err := processPathTemplate(in, "my-project", data)
@@ -53,9 +53,9 @@ func TestProcessContentTemplate(t *testing.T) {
 import "{{.DBAdapter}}"
 `
 	data := templateData{
-		Name:      "mypkg",
-		DBImport:  "sqlite",
-		DBAdapter: getDBAdapter("sqlite"),
+		ProjectName: "mypkg",
+		DBImport:    "sqlite",
+		DBAdapter:   getDBAdapter("sqlite"),
 	}
 	got, err := processContentTemplate(name, content, data)
 	if err != nil {
@@ -112,14 +112,13 @@ func TestCreateMinimalIntegration(t *testing.T) {
 	}
 }
 
-// TestCreateStructuredAndTODO is updated to use t.TempDir() for best practice.
-func TestCreateStructuredAndTODO(t *testing.T) {
+// TestCreateStructured is updated to use t.TempDir() for best practice.
+func TestCreateStructured(t *testing.T) {
 	cases := []struct {
 		name string
 		call func(string, bool, string) error
 	}{
 		{"structured", CreateStructured},
-		{"todo", CreateTODO},
 	}
 	for _, tc := range cases {
 		projectDir := t.TempDir()

templates/scaffolding_test.go

@@ -6,8 +6,8 @@ import (
 
 	"github.com/xlc-dev/nova/nova"
 
-	"{{.Name}}/internal/api"
-	"{{.Name}}/internal/config"
+	"{{.ProjectName}}/internal/api"
+	"{{.ProjectName}}/internal/config"
 )
 
 func main() {
@@ -20,7 +20,7 @@ func main() {
 	cli, err := nova.NewCLI(&nova.CLI{
 		Name:        "Nova",
 		Version:     "0.0.1",
-		Description: "{{.Name}} API",
+		Description: "{{.ProjectName}} API",
 		GlobalFlags: []nova.Flag{
 			&nova.BoolFlag{
 				Name:    "verbose",