@getmonoceros/workbench 1.0.0

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@getmonoceros/workbench",
+  "version": "1.0.0",
+  "description": "Monoceros workbench CLI — local, reproducible dev containers with first-class AI coding tooling.",
+  "keywords": [
+    "devcontainer",
+    "docker",
+    "cli",
+    "ai-coding",
+    "claude-code",
+    "monoceros"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getmonoceros/workbench.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/getmonoceros/workbench#readme",
+  "bugs": {
+    "url": "https://github.com/getmonoceros/workbench/issues"
+  },
+  "type": "module",
+  "bin": {
+    "monoceros": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "start": "tsx src/bin.ts",
+    "typecheck": "tsc --build",
+    "test": "vitest run",
+    "build": "tsup",
+    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
+  },
+  "dependencies": {
+    "@devcontainers/cli": "^0.86.1",
+    "citty": "^0.2.2",
+    "consola": "^3.4.2",
+    "diff": "^9.0.0",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}

package/templates/components/README.md

@@ -0,0 +1,95 @@
+# Monoceros Components Catalog
+
+Every file under this directory is a **component** — a small,
+composable yaml snippet that contributes to a `SolutionConfig`. The
+`monoceros init` command picks components by name (via `--with=…`
+or by rendering them all as commented-out hints in the documented
+default) and merges them into the user's container-config yml.
+
+## File layout
+
+- `<name>.yml` — a top-level component (e.g. `node.yml`, `postgres.yml`).
+- `<group>/<name>.yml` — a sub-component of a parent feature
+  (e.g. `atlassian/twg.yml` is a sub-component of `atlassian/`).
+
+Component names map 1:1 to their `--with=…` identifier:
+
+- `--with=node` → `node.yml`
+- `--with=atlassian/twg` → `atlassian/twg.yml`
+
+## File schema
+
+```yaml
+# Short label shown next to the active line (or "- node" entry) in
+# the generated yml.
+displayName: Node 22 + pnpm
+
+# Longer block, shown as a comment above the section in documented
+# mode (i.e. `monoceros init <name>` with no --with). English, free
+# prose, can mention what it adds, where credentials come from, etc.
+description: |
+  Node 22 + pnpm are already in the base image; this component
+  declares the runtime as active so the scaffold wires it up.
+
+# Which top-level yml section this component contributes to. Drives
+# how the documented-mode renderer groups components.
+category: language | service | feature
+
+# The actual yml fragment merged into the final SolutionConfig.
+# Must be a valid fragment for the declared category:
+#   - language → contributes.languages must be a non-empty string array
+#   - service  → contributes.services must be a non-empty string array
+#   - feature  → contributes.features must hold one feature entry
+contributes:
+  # …
+```
+
+## Conventions
+
+- **Comments and prose are English**, even though the broader user
+  docs are German. The rendered yml is a tool output and English
+  reads more cleanly for the typical dev-yml shape.
+- **Sub-components set their flag to `true` AND every sibling flag
+  to `false`.** Both `atlassian/twg.yml` and `atlassian/rovodev.yml`
+  set both `rovodev` and `twg`, just with opposite truth values.
+  The init merge applies OR-semantics on booleans: when two
+  components contribute the same boolean key, `true` wins. That
+  way `--with=atlassian/twg` on its own opts out of the other
+  tool, while `--with=atlassian/twg,atlassian/rovodev` merges to
+  both `true`. Without the explicit `false`, the manifest defaults
+  (`true` for both) would silently re-enable the unwanted tool.
+- **Auth/credential options live with the feature, not the
+  component.** Each feature manifest under `images/features/`
+  declares an `x-monoceros.optionHints` array that the init
+  generator uses to render commented-out auth options beneath the
+  active options block whenever the feature is included.
+
+## Adding a new component
+
+1. Decide the name and (if it's a sub-component) the group folder.
+2. Drop the yml file in. Use an existing component of the same
+   category as a starting point.
+3. If the component activates a Monoceros feature, make sure that
+   feature's manifest under `images/features/<feature>/` carries
+   the right `x-monoceros.optionHints` for auth.
+4. Add a short note in this README's "Current components" table if
+   you want it discoverable at a glance.
+
+## Current components
+
+| Component           | Category | Contributes                                             |
+| ------------------- | -------- | ------------------------------------------------------- |
+| `node`              | language | Node runtime (declared; package already in base image)  |
+| `python`            | language | Python via devcontainers/features/python                |
+| `java`              | language | JDK via devcontainers/features/java                     |
+| `go`                | language | Go toolchain via devcontainers/features/go              |
+| `rust`              | language | Rust toolchain via devcontainers/features/rust          |
+| `dotnet`            | language | .NET SDK via devcontainers/features/dotnet:2            |
+| `postgres`          | service  | Compose service: Postgres                               |
+| `mysql`             | service  | Compose service: MySQL                                  |
+| `redis`             | service  | Compose service: Redis                                  |
+| `claude`            | feature  | `claude-code` feature (Claude Code CLI)                 |
+| `github`            | feature  | `github-cli` feature (`gh`) with auto-auth via apiToken |
+| `atlassian`         | feature  | atlassian feature: Rovo Dev + twg both on               |
+| `atlassian/rovodev` | feature  | atlassian feature with just `rovodev: true`             |
+| `atlassian/twg`     | feature  | atlassian feature with just `twg: true`                 |

package/templates/components/atlassian/rovodev.yml

@@ -0,0 +1,14 @@
+displayName: Atlassian Rovo Dev only (via acli rovodev)
+description: |
+  Sub-component of the atlassian feature. Activates only the
+  `acli rovodev` AI agent and explicitly opts out of `twg`.
+  Combine with `atlassian/twg` to get both tools — booleans
+  OR-merge during component composition so `--with=atlassian/rovodev,atlassian/twg`
+  yields both `true`.
+category: feature
+contributes:
+  features:
+    - ref: ghcr.io/getmonoceros/monoceros-features/atlassian:1
+      options:
+        rovodev: true
+        twg: false

package/templates/components/atlassian/twg.yml

@@ -0,0 +1,14 @@
+displayName: Atlassian Teamwork Graph CLI only (twg)
+description: |
+  Sub-component of the atlassian feature. Activates only the
+  `twg` CLI and explicitly opts out of `rovodev`. Combine with
+  `atlassian/rovodev` to get both tools — booleans OR-merge
+  during component composition so
+  `--with=atlassian/rovodev,atlassian/twg` yields both `true`.
+category: feature
+contributes:
+  features:
+    - ref: ghcr.io/getmonoceros/monoceros-features/atlassian:1
+      options:
+        rovodev: false
+        twg: true

package/templates/components/atlassian.yml

@@ -0,0 +1,15 @@
+displayName: Atlassian CLIs (Rovo Dev + Teamwork Graph), both on
+description: |
+  Installs both Atlassian CLIs that share a single Atlassian
+  account: Rovo Dev (the `acli rovodev` AI agent) and Teamwork
+  Graph (`twg`). Use the sub-components `atlassian/rovodev` or
+  `atlassian/twg` instead of this one if you only want one of
+  the two tools. Both can be combined: `--with=atlassian/rovodev,atlassian/twg`
+  yields the same result as `--with=atlassian`.
+category: feature
+contributes:
+  features:
+    - ref: ghcr.io/getmonoceros/monoceros-features/atlassian:1
+      options:
+        rovodev: true
+        twg: true

package/templates/components/claude.yml

@@ -0,0 +1,11 @@
+displayName: Anthropic Claude Code CLI
+description: |
+  Installs the Claude Code CLI via npm and bind-mounts a per-
+  container `.claude/` so login + skills + session history
+  survive `monoceros apply`. Without an apiKey, the CLI uses
+  Anthropic's subscription/OAuth flow on first run; with an
+  apiKey, it switches to API-key mode via ANTHROPIC_API_KEY.
+category: feature
+contributes:
+  features:
+    - ref: ghcr.io/getmonoceros/monoceros-features/claude-code:1

package/templates/components/dotnet.yml

@@ -0,0 +1,8 @@
+displayName: .NET via devcontainers/features/dotnet:2
+description: |
+  Adds the upstream `ghcr.io/devcontainers/features/dotnet:2`
+  feature to the container, which installs the .NET SDK (and
+  optionally specific runtimes via the feature's own options).
+category: language
+contributes:
+  languages: [dotnet]

package/templates/components/github.yml

@@ -0,0 +1,10 @@
+displayName: GitHub CLI (gh)
+description: |
+  Installs the official `gh` CLI from the upstream apt repo and
+  wires GH_TOKEN via /etc/profile.d so a Personal Access Token
+  set via this feature's `apiToken` option authenticates every
+  login shell automatically.
+category: feature
+contributes:
+  features:
+    - ref: ghcr.io/getmonoceros/monoceros-features/github-cli:1

package/templates/components/go.yml

@@ -0,0 +1,8 @@
+displayName: Go via devcontainers/features/go
+description: |
+  Adds the upstream `ghcr.io/devcontainers/features/go` feature to
+  the container, which installs the Go toolchain plus common dev
+  utilities (gopls, dlv, …).
+category: language
+contributes:
+  languages: [go]

package/templates/components/java.yml

@@ -0,0 +1,9 @@
+displayName: Java via devcontainers/features/java
+description: |
+  Adds the upstream `ghcr.io/devcontainers/features/java` feature to
+  the container, which installs a JDK plus Maven/Gradle scaffolding.
+  Pin a version through the feature's own options if you need
+  something other than the default.
+category: language
+contributes:
+  languages: [java]

package/templates/components/mysql.yml

@@ -0,0 +1,8 @@
+displayName: MySQL 8 compose service
+description: |
+  Adds a `mysql` service to compose mode. Inside the container it
+  is reachable as host `mysql`:
+    mysql://monoceros:monoceros@mysql:3306/monoceros
+category: service
+contributes:
+  services: [mysql]

package/templates/components/node.yml

@@ -0,0 +1,9 @@
+displayName: Node 22 + pnpm
+description: |
+  Node 22 + pnpm + corepack are already in the base runtime image.
+  This component just declares `node` as the active language so
+  scaffold steps that key off the language list (post-create
+  package detection, default extensions, …) see it.
+category: language
+contributes:
+  languages: [node]

package/templates/components/postgres.yml

@@ -0,0 +1,10 @@
+displayName: PostgreSQL 16 compose service
+description: |
+  Adds a `postgres` service to compose mode. Inside the container
+  it is reachable as host `postgres`:
+    postgresql://monoceros:monoceros@postgres:5432/monoceros
+  Swap to an external Postgres by replacing this component with an
+  `externalServices.postgres: postgresql://…` block in the yml.
+category: service
+contributes:
+  services: [postgres]

package/templates/components/python.yml

@@ -0,0 +1,9 @@
+displayName: Python 3.x via devcontainers/features/python
+description: |
+  Adds the upstream `ghcr.io/devcontainers/features/python` feature
+  to the container, which installs a recent CPython plus pip and
+  the usual scaffolding. Pin a version through the feature's own
+  options if you need something other than the default.
+category: language
+contributes:
+  languages: [python]

package/templates/components/redis.yml

@@ -0,0 +1,7 @@
+displayName: Redis 7 compose service
+description: |
+  Adds a `redis` service to compose mode. Inside the container it
+  is reachable as host `redis` on the default port 6379.
+category: service
+contributes:
+  services: [redis]

package/templates/components/rust.yml

@@ -0,0 +1,8 @@
+displayName: Rust via devcontainers/features/rust
+description: |
+  Adds the upstream `ghcr.io/devcontainers/features/rust` feature
+  to the container, which installs rustup, the current stable
+  toolchain, and cargo.
+category: language
+contributes:
+  languages: [rust]

package/templates/default/.devcontainer/devcontainer.json

@@ -0,0 +1,16 @@
+{
+  "name": "monoceros-default",
+  "image": "monoceros-runtime:dev",
+  "remoteUser": "node",
+  "mounts": [
+    "source=${localEnv:HOME}/.claude,target=/home/node/.claude,type=bind,consistency=cached"
+  ],
+  "runArgs": ["--cap-add=NET_ADMIN"],
+  "forwardPorts": [3000, 4000],
+  "postCreateCommand": ".devcontainer/post-create.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": ["anthropic.claude-code"]
+    }
+  }
+}