Release 1.2.0: Cleanup, new helpers, and documentation

Breaking change: CrossModule dependencies now opt-in
- Removed automatic scalatest and scala-java-time dependencies
- Use With.Scalatest() and With.ScalaJavaTime() explicitly

New helpers:
- With.Publishing (defaults to GitHub, .sonatype option available)
- With.ScalaJavaTime() for cross-platform java.time support
- With.ClassPathJar, With.UnmanagedJars, With.ShellPrompt exposed

Cleanup:
- Removed NodeTarget dead code from CrossModule
- Removed placeholder Packaging methods (jdkPackager, linuxDebian, linuxRPM)
- Removed obsolete project/SonatypePublishing.scala
- Made Root project ID configurable via projectId parameter
- Parameterized versions in ScalaJS and Native helpers

Documentation:
- Updated README with migration notes for 1.2.0
- Documented all new helpers and parameters

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: reidspencer

NOTEBOOK.md

@@ -2,13 +2,16 @@
 
 ## Current Status
 
-Version 1.1.0 released. Significant maintenance work completed Jan 17, 2026
-addressing most of the 15 UX issues identified in the maintenance analysis.
-All 16 scripted tests now passing (100%). Key changes include:
+**Version 1.2.0 ready for release.** Significant maintenance work completed Jan 17, 2026
+addressing all 15 UX issues identified in the maintenance analysis.
+All 16 scripted tests passing (100%). Key changes since 1.1.0:
 - CrossModule dependencies now opt-in (breaking change)
-- New helpers: `With.Publishing`, `With.ScalaJavaTime()`
+- New helpers: `With.Publishing`, `With.ScalaJavaTime()`, `With.ClassPathJar`, `With.UnmanagedJars`, `With.ShellPrompt`
 - Improved error messages when Root() not configured
 - Parameterized dependency versions in ScalaJS/Native helpers
+- Configurable Root project ID
+- Removed dead code (NodeTarget, placeholder Packaging methods)
+- Removed obsolete project/SonatypePublishing.scala
 
 ## Work Completed (Recent)
 

README.md

@@ -82,7 +82,7 @@ In your `project/plugins.sbt` file, add the GitHub Packages resolver and the plu
 // GitHub Packages resolver for sbt-ossuminc
 resolvers += "GitHub Packages" at "https://maven.pkg.github.com/ossuminc/sbt-ossuminc"
 
-addSbtPlugin("com.ossuminc" % "sbt-ossuminc" % "1.1.0")
+addSbtPlugin("com.ossuminc" % "sbt-ossuminc" % "1.2.0")
 ```
 
 ### ~/sbt/1.0/github.sbt
@@ -225,15 +225,16 @@ then your commands get passed down to the sub-projects.
 
 For example, this:
 
-```scala 
+```scala
 lazy val riddl: Project = Root(
   ghRepoName = "my-project",
   ghOrgName = "my-organization",
   orgPackage = "com.my_org.my_proj",
   orgName = "My Organization",
   orgPage = url("https://my_org.com/"),
-  maintainerEmail = "somebody@my_org.com",
-  startYr = 2024)
+  startYr = 2024,
+  projectId = "root"  // Optional: customize sbt project ID (default: "root")
+)
   .configure(With.noPublishing, With.git, With.dynver)
   .aggregate(
     module0, // a sub-component of your project
@@ -412,6 +413,10 @@ These helpers take no parameters (or use all defaults):
 * **`With.scalajs`** - Enable Scala.js compilation (default configuration)
 * **`With.noMiMa`** - Disable binary compatibility checking
 * **`With.noPublishing`** - Disable artifact publishing (useful for root aggregator projects)
+* **`With.ScalaJavaTime()`** - Add `scala-java-time` dependency for cross-platform `java.time` API
+* **`With.ClassPathJar`** - Use classpath JAR for packaging (reduces command line length)
+* **`With.UnmanagedJars`** - Use unmanaged JAR files from `libs/` directory
+* **`With.ShellPrompt`** - Custom shell prompt showing project name, git branch, and version
 * **`With.release`** - Enable `sbt-release` plugin
 * **`With.resolvers`** - Add standard resolvers (Maven Local, JCenter, Typesafe)
 * **`With.scala2`** - Configure for Scala 2.13 (latest)
@@ -420,10 +425,13 @@ These helpers take no parameters (or use all defaults):
 
 ### Publishing Helpers
 
-* **`With.GithubPublishing`** - Configure publishing to GitHub Packages
-* **`With.SonatypePublishing`** - Configure publishing to Sonatype/Maven Central
+* **`With.Publishing`** - Configure publishing (defaults to GitHub Packages)
+* **`With.Publishing.github`** - Explicitly configure GitHub Packages publishing
+* **`With.Publishing.sonatype`** - Configure publishing to Sonatype/Maven Central
+* **`With.GithubPublishing`** - Alias for `With.Publishing.github`
+* **`With.SonatypePublishing`** - Alias for `With.Publishing.sonatype`
 
-> **Note**: Do not combine GithubPublishing and SonatypePublishing in the same project.
+> **Note**: Do not combine GitHub and Sonatype publishing in the same project.
 
 ### Composite Helpers
 
@@ -521,13 +529,16 @@ Configure Scala.js compilation.
 - **`hasMain`**: Enable main module initializer
 - **`forProd`**: Enable optimizer (production mode)
 - **`withCommonJSModule`**: Use CommonJS modules instead of ES modules
+- **`scalaJavaTimeVersion`**: Override scala-java-time version (default: `"2.6.0"`)
+- **`scalatestVersion`**: Override scalatest version (default: `"3.2.19"`)
 
 ```scala
 CrossModule("my-ui", "ui")(JVM, JS)
   .jsConfigure(With.ScalaJS(
     header = "My App UI v1.0",
     hasMain = true,
-    forProd = true
+    forProd = true,
+    scalaJavaTimeVersion = "2.6.0"
   ))
 ```
 
@@ -573,12 +584,14 @@ Configure Scala Native compilation.
 - **`verbose`**: Verbose compilation output
 - **`targetTriple`**: Target platform triple (optional)
 - **`linkOptions`**: Additional linker options
+- **`scalatestVersion`**: Override scalatest version (default: `"3.2.19"`)
 
 ```scala
 CrossModule("cli-tool", "tool")(JVM, Native)
   .nativeConfigure(With.Native(
     mode = "release",
-    buildTarget = "application"
+    buildTarget = "application",
+    scalatestVersion = "3.2.19"
   ))
 ```
 
@@ -684,6 +697,42 @@ DocSite(
 )
 ```
 
-  
+## Migration Notes
+
+### Migrating from 1.1.0 to 1.2.0
+
+#### Breaking Change: CrossModule Dependencies Now Opt-In
+
+In 1.1.0, `CrossModule` automatically included testing and time dependencies. In 1.2.0, these are now opt-in for cleaner, more explicit builds.
+
+```scala
+// Old (1.1.0) - dependencies were automatic
+CrossModule("foo", "bar")(JVM, JS)
+
+// New (1.2.0) - explicitly add what you need
+CrossModule("foo", "bar")(JVM, JS)
+  .configure(With.Scalatest())      // Add if you need testing
+  .configure(With.ScalaJavaTime())  // Add if you need java.time API
+```
+
+#### New Helpers in 1.2.0
+
+* **`With.Publishing`** - Generic publishing helper (defaults to GitHub Packages)
+  - Use `With.Publishing` for default (GitHub) publishing
+  - Use `With.Publishing.github` to explicitly use GitHub Packages
+  - Use `With.Publishing.sonatype` for Sonatype/Maven Central
+
+* **`With.ScalaJavaTime()`** - Add `scala-java-time` dependency for cross-platform date/time support
+
+* **`With.ClassPathJar`** - Use classpath JAR to reduce command line length on Windows
+
+* **`With.UnmanagedJars`** - Configure unmanaged JAR files from `libs/` directory
+
+* **`With.ShellPrompt`** - Custom sbt shell prompt with project, branch, and version info
+
+#### Other Changes
+
+* **`Root()` project ID is now configurable** - Use `projectId` parameter to customize (default: `"root"`)
+* **Parameterized versions** - `With.ScalaJS()` and `With.Native()` now accept version parameters to override defaults
 
 

project/SonatypePublishing.scala

@@ -17,7 +17,6 @@ object CrossModule {
   sealed trait Target { def platform: Platform }
   case object JVMTarget extends Target { def platform: Platform = JVMPlatform }
   case object JSTarget extends Target { def platform: Platform = JSPlatform }
-  case object NodeTarget extends Target { def platform: Platform = NodePlatform }
   case object NativeTarget extends Target { def platform: Platform = NativePlatform }
 
   /** Define a subproject or module of the root project. Make sure to use the [[Root]] function
@@ -67,9 +66,3 @@ object CrossModule {
     } else cp4
   }
 }
-
-case object NodePlatform extends Platform {
-  def identifier: String = "node"
-  def sbtSuffix: String = "NODE"
-  def enable(project: Project): Project = project
-}

src/main/scala/com/ossuminc/sbt/CrossModule.scala

@@ -185,6 +185,16 @@ object OssumIncPlugin extends AutoPlugin {
       /** Do not configure binary compatibility checking */
       def noMiMa: ConfigFunc = helpers.MiMa.without
 
+      /** Use a classpath JAR for packaging (reduces command line length) */
+      def ClassPathJar: ConfigFunc = helpers.Miscellaneous.useClassPathJar
+
+      /** Use unmanaged JAR files from libs/ directory */
+      def UnmanagedJars: ConfigFunc = helpers.Miscellaneous.useUnmanagedJarLibs
+
+      /** Custom shell prompt showing project name, branch, and version */
+      def ShellPrompt: Def.Initialize[State => String] =
+        helpers.Miscellaneous.buildShellPrompt
+
       /** Configure project to produce no artifact and not be published */
       def noPublishing(project: Project): Project =
         project.settings(

src/main/scala/com/ossuminc/sbt/OssumIncPlugin.scala

@@ -2,15 +2,19 @@ package com.ossuminc.sbt
 
 import sbt.{Developer, Project, URL, file, url}
 
-/** A configuration object for a root project of a monorepo composed of subordinate sbt projects */
+/** A configuration object for a root project of a monorepo composed of
+  * subordinate sbt projects
+  */
 object Root {
 
-  /** Define a Root level project whether it is for a single-project repo or an unirepo with many subprojects. This
-    * project is configured with a shell prompt, and the standard project information at ThisBuild scope
+  /** Define a Root level project whether it is for a single-project repo or
+    * a unirepo with many subprojects. This project is configured with a shell
+    * prompt, and the standard project information at ThisBuild scope.
+    *
     * @param ghRepoName
     *   The name of the GitHub repository we are building
     * @param ghOrgName
-    *   THe name of the GitHub organization/user that contains the `ghRepoName`
+    *   The name of the GitHub organization/user that contains the `ghRepoName`
     * @param orgPackage
     *   The organization part of the JVM package this repo uses for its code
     * @param orgName
@@ -21,6 +25,10 @@ object Root {
     *   The year in which this project started, for copyright purposes
     * @param devs
     *   A list of Developer specifications to include in POM (required by Maven)
+    * @param spdx
+    *   The SPDX license identifier (e.g., "Apache-2.0", "MIT")
+    * @param projectId
+    *   The sbt project ID (default: "root")
     * @return
     *   The project that was created and configured.
     */
@@ -32,10 +40,11 @@ object Root {
     orgPage: URL = url("https://ossuminc.com/"),
     startYr: Int = 2023,
     devs: List[Developer] = List.empty,
-    spdx: String = "Apache-2.0"
+    spdx: String = "Apache-2.0",
+    projectId: String = "root"
   ): Project = {
     Project
-      .apply("root", file(System.getProperty("user.dir")))
+      .apply(projectId, file(System.getProperty("user.dir")))
       .enablePlugins(OssumIncPlugin)
       .configure(
         helpers.RootProjectInfo.initialize(

src/main/scala/com/ossuminc/sbt/Root.scala

@@ -64,10 +64,4 @@ object Packaging extends AutoPluginHelper {
         graalVMNativeImageCommand := native_image_path.getAbsolutePath
       )
   }
-
-  def jdkPackager()(project: Project): Project = project
-
-  def linuxDebian()(project: Project): Project = project
-
-  def linuxRPM()(project: Project): Project = project
 }