@getmonoceros/workbench 1.21.3 → 1.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getmonoceros/workbench",
-  "version": "1.21.3",
+  "version": "1.22.0",
   "description": "Monoceros workbench CLI — local, reproducible dev containers with first-class AI coding tooling.",
   "keywords": [
     "devcontainer",
@@ -27,7 +27,7 @@
   "files": [
     "dist",
     "templates",
-    "features",
+    "bundled-components",
     "README.md"
   ],
   "engines": {
@@ -37,8 +37,9 @@
     "start": "tsx src/bin.ts",
     "typecheck": "tsc --build",
     "test": "vitest run",
-    "manifests:sync": "node scripts/sync-feature-manifests.mjs",
-    "prebuild": "pnpm manifests:sync",
+    "components:sync": "node scripts/sync-components.mjs",
+    "manifests:generate": "tsx scripts/generate-feature-manifests.ts",
+    "prebuild": "pnpm components:sync",
     "build": "tsup",
     "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
   },

package/features/atlassian/devcontainer-feature.json

@@ -1,67 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainerFeature.schema.json",
-  "id": "atlassian",
-  "name": "Atlassian",
-  "version": "1.0.0",
-  "description": "Rovo Dev (`acli rovodev`) and Teamwork Graph (`twg`) CLIs sharing one Atlassian account. Auth persists across rebuilds.",
-  "documentationURL": "https://developer.atlassian.com/cloud/",
-  "options": {
-    "rovodev": {
-      "type": "boolean",
-      "default": true,
-      "description": "Install acli (with the Rovo Dev agent)."
-    },
-    "twg": {
-      "type": "boolean",
-      "default": true,
-      "description": "Install twg (Teamwork Graph CLI)."
-    },
-    "instance": {
-      "type": "string",
-      "default": "",
-      "description": "Atlassian site host (`yoursite.atlassian.net`); required by twg."
-    },
-    "email": {
-      "type": "string",
-      "default": "",
-      "description": "Atlassian account email; used with `apiToken` for non-interactive login."
-    },
-    "apiToken": {
-      "type": "string",
-      "default": "",
-      "description": "Atlassian API token (id.atlassian.com → Security → API tokens)."
-    },
-    "bitbucketToken": {
-      "type": "string",
-      "default": "",
-      "description": "Optional Bitbucket app password; only needed for twg's Bitbucket commands."
-    }
-  },
-  "customizations": {
-    "vscode": {
-      "extensions": ["Atlassian.atlascode"]
-    }
-  },
-  "x-monoceros": {
-    "persistentHomePaths": [
-      ".config/acli",
-      ".rovodev",
-      ".config/twg",
-      ".agents"
-    ],
-    "optionHints": ["instance", "email", "apiToken", "bitbucketToken"],
-    "usageNotes": [],
-    "briefing": {
-      "lines": [
-        {
-          "whenOption": "rovodev",
-          "text": "Atlassian Rovo Dev — invoke via `acli rovodev`. Pre-authenticated against the Atlassian account configured in the feature options (shared with twg)."
-        },
-        {
-          "whenOption": "twg",
-          "text": "Atlassian Teamwork Graph CLI (`twg`) — work-data access across Jira, Confluence, Bitbucket, JSM and Assets. Pre-authenticated. Sub-skills cover status rollups, engineering work, ops health and context discovery."
-        }
-      ]
-    }
-  }
-}

package/features/claude-code/devcontainer-feature.json

@@ -1,49 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainerFeature.schema.json",
-  "id": "claude-code",
-  "name": "Claude Code",
-  "version": "1.2.0",
-  "description": "Anthropic's CLI coding assistant. OAuth/subscription login persists across container rebuilds.",
-  "documentationURL": "https://docs.anthropic.com/en/docs/claude-code",
-  "options": {
-    "version": {
-      "type": "string",
-      "default": "latest",
-      "description": "npm-style version spec (`latest`, `^0.4`, `0.4.2`)."
-    },
-    "apiKey": {
-      "type": "string",
-      "default": "",
-      "description": "`sk-ant-…` for API auth; empty for OAuth login on first run."
-    },
-    "permissionMode": {
-      "type": "string",
-      "proposals": ["auto", "ask", "edits", "bypass"],
-      "default": "auto",
-      "description": "Default Claude permission mode in this container. `auto` = Auto Mode: no per-action prompts and no recurring warning (a background classifier vets actions) — the comfortable default for an isolated container. `ask` prompts as usual; `edits` auto-accepts file edits but prompts for other commands; `bypass` skips all prompts (its one-time warning is pre-accepted). Monoceros writes this to ~/.claude/settings.json on apply; override per-project or with a CLI flag."
-    }
-  },
-  "customizations": {
-    "vscode": {
-      "extensions": ["anthropic.claude-code"]
-    }
-  },
-  "x-monoceros": {
-    "persistentHomePaths": [".claude"],
-    "persistentHomeFiles": [
-      {
-        "path": ".claude.json",
-        "initialContent": "{}\n"
-      }
-    ],
-    "optionHints": ["apiKey"],
-    "usageNotes": [],
-    "briefing": {
-      "lines": [
-        {
-          "text": "Anthropic Claude Code CLI (`claude`) — interactive coding assistant. Authenticated via OAuth/subscription unless `apiKey` was set, in which case it runs in API-key mode."
-        }
-      ]
-    }
-  }
-}

package/features/github-cli/devcontainer-feature.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainerFeature.schema.json",
-  "id": "github-cli",
-  "name": "GitHub CLI",
-  "version": "1.0.0",
-  "description": "The official `gh` CLI. Login persists across container rebuilds.",
-  "documentationURL": "https://cli.github.com/",
-  "options": {
-    "apiToken": {
-      "type": "string",
-      "default": "",
-      "description": "GitHub PAT (scopes: repo, read:org, gist); empty for `gh auth login` on first run."
-    }
-  },
-  "customizations": {
-    "vscode": {
-      "extensions": ["github.vscode-pull-request-github"]
-    }
-  },
-  "x-monoceros": {
-    "persistentHomePaths": [".config/gh"],
-    "optionHints": ["apiToken"],
-    "usageNotes": [],
-    "briefing": {
-      "lines": [
-        {
-          "text": "GitHub CLI (`gh`) — repo, PR, issue, gist operations against github.com. Pre-authenticated; `gh auth status` reflects the active account."
-        }
-      ]
-    }
-  }
-}

package/templates/components/README.md

@@ -1,95 +0,0 @@
-# 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 the `--with-*`
-flags 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-languages=node` → `node.yml`
-- `--with-features=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-* flags). 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 own 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-features=atlassian/twg` on its own opts out of the other
-  tool, while `--with-features=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 on 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 to 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

@@ -1,14 +0,0 @@
-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

@@ -1,14 +0,0 @@
-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

@@ -1,15 +0,0 @@
-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

@@ -1,16 +0,0 @@
-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
-      # Surfaced in the generated yml so it's discoverable/editable.
-      # `auto`: no per-action prompts, no recurring warning. Others:
-      # `ask`, `edits` (auto-accept edits only), `bypass` (skip all).
-      options:
-        permissionMode: auto

package/templates/components/dotnet.yml

@@ -1,8 +0,0 @@
-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

@@ -1,10 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

@@ -1,9 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

@@ -1,9 +0,0 @@
-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

@@ -1,10 +0,0 @@
-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

@@ -1,9 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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]