feat: Add support for saga init .

Author: kevinrenskers

Sources/SagaCLI/InitCommand.swift

@@ -6,43 +6,54 @@ struct Init: ParsableCommand {
     abstract: "Create a new Saga project."
   )
 
-  @Argument(help: "The name of the project to create.")
+  @Argument(help: "The name of the project to create, or '.' to create it in the current folder.")
   var name: String
 
   func run() throws {
-    let projectPath = Path.current + name
+    let createInPlace = name == "."
+    let projectPath = createInPlace ? Path.current : Path.current + name
 
-    guard !projectPath.exists else {
-      throw ValidationError("Directory '\(name)' already exists.")
+    if !createInPlace {
+      guard !projectPath.exists else {
+        throw ValidationError("Directory '\(name)' already exists.")
+      }
     }
 
-    let capitalizedName = name.prefix(1).uppercased() + name.dropFirst()
+    let projectName = createInPlace ? projectPath.absolute().lastComponent : name
+
+    guard let firstCharacter = projectName.first, firstCharacter.isLetter || firstCharacter.isNumber else {
+      throw ValidationError("Could not determine a project name from the current folder.")
+    }
+
+    let capitalizedName = projectName.prefix(1).uppercased() + projectName.dropFirst()
+
+    let files: [(Path, String)] = [
+      (Path("Package.swift"), ProjectTemplate.packageSwift(name: capitalizedName)),
+      (Path("Sources") + capitalizedName + "main.swift", ProjectTemplate.mainSwift(name: capitalizedName)),
+      (Path("Sources") + capitalizedName + "templates.swift", ProjectTemplate.templatesSwift()),
+      (Path("content") + "index.md", ProjectTemplate.indexMarkdown()),
+      (Path("content") + "articles" + "hello-world.md", ProjectTemplate.helloWorldMarkdown()),
+      (Path("content") + "static" + "style.css", ProjectTemplate.styleCss()),
+      (Path("README.md"), ProjectTemplate.readme(name: capitalizedName)),
+      (Path(".gitignore"), ProjectTemplate.gitignore()),
+    ]
 
     // Create directory structure
     try (projectPath + "Sources" + capitalizedName).mkpath()
     try (projectPath + "content" + "articles").mkpath()
     try (projectPath + "content" + "static").mkpath()
 
     // Write files
-    let files: [(Path, String)] = [
-      (projectPath + "Package.swift", ProjectTemplate.packageSwift(name: capitalizedName)),
-      (projectPath + "Sources" + capitalizedName + "main.swift", ProjectTemplate.mainSwift(name: capitalizedName)),
-      (projectPath + "Sources" + capitalizedName + "templates.swift", ProjectTemplate.templatesSwift()),
-      (projectPath + "content" + "index.md", ProjectTemplate.indexMarkdown()),
-      (projectPath + "content" + "articles" + "hello-world.md", ProjectTemplate.helloWorldMarkdown()),
-      (projectPath + "content" + "static" + "style.css", ProjectTemplate.styleCss()),
-      (projectPath + "README.md", ProjectTemplate.readme(name: capitalizedName)),
-      (projectPath + ".gitignore", ProjectTemplate.gitignore()),
-    ]
-
     for (path, content) in files {
-      try path.write(content)
+      try (projectPath + path).write(content)
     }
 
-    print("Created new Saga project in '\(name)/'")
+    print("Created new Saga project in '\(createInPlace ? projectPath.absolute().lastComponent : name)/'")
     print("")
     print("Next steps:")
-    print("  cd \(name)")
+    if !createInPlace {
+      print("  cd \(name)")
+    }
     print("  saga dev")
   }
 }

Sources/SagaCLI/ProjectTemplate.swift

@@ -382,23 +382,18 @@ enum ProjectTemplate {
 
     ## How it works
 
-    Saga runs a **Reader → Processor → Writer** pipeline. Every `register` step in `main.swift` claims
-    a folder of content, parses it into typed items, and hands those items to writers that render HTML:
+    Saga runs a **Reader → Processor → Writer** pipeline. Every `register` step in `main.swift` claims a folder of content, parses it into typed items, and hands those items to writers that render HTML:
 
-    - `content/articles/*.md` is read into `Item<ArticleMetadata>` values, and written to
-      `/articles/<slug>/`, plus an index at `/articles/` and a page per tag at `/articles/tag/<tag>/`.
+    - `content/articles/*.md` is read into `Item<ArticleMetadata>` values, and written to `/articles/<slug>/`, plus an index at `/articles/` and a page per tag at `/articles/tag/<tag>/`.
     - Every other markdown file is written as a standalone page, so `content/index.md` becomes `/`.
 
-    Metadata comes from the YAML front matter at the top of each markdown file. Add a field to
-    `ArticleMetadata` in `main.swift` to make it available in your templates.
+    Metadata comes from the YAML front matter at the top of each markdown file. Add a field to `ArticleMetadata` in `main.swift` to make it available in your templates.
 
     Anything in `content/static/` that no step claims is copied to `deploy/` untouched.
 
     ## Learn more
 
-    - [Documentation](https://getsaga.dev/docs/)
     - [Getting started](https://getsaga.dev/docs/gettingstarted/)
-    - [Architecture](https://getsaga.dev/docs/architecture/)
     - [Guides](https://getsaga.dev/docs/guides/) — search, sitemaps, syntax highlighting, Tailwind CSS, and more
     """
   }