@getmonoceros/workbench 1.6.12 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/dist/bin.js +1109 -298
  2. package/dist/bin.js.map +1 -1
  3. package/package.json +1 -1
  4. package/templates/monoceros-config.sample.yml +76 -38
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getmonoceros/workbench",
3
- "version": "1.6.12",
3
+ "version": "1.7.0",
4
4
  "description": "Monoceros workbench CLI — local, reproducible dev containers with first-class AI coding tooling.",
5
5
  "keywords": [
6
6
  "devcontainer",
package/templates/monoceros-config.sample.yml CHANGED
@@ -1,46 +1,84 @@
1
- # Monoceros — global defaults for `monoceros apply`.
1
+ # Monoceros — builder-global config for `monoceros apply`.
2
2
  #
3
- # This file is optional. The top two keys (schemaVersion, defaults)
4
- # are uncommented so the file parses as valid YAML out of the box;
5
- # every actual setting under `defaults` is commented out, so a
6
- # fresh-installed Monoceros behaves like there's no file at all.
3
+ # This file is optional. Everything below is commented out by default;
4
+ # a fresh-installed Monoceros behaves as if it didn't exist. To enable
5
+ # a setting: remove the leading "# " from each line of that block.
7
6
  #
8
- # To set a value: uncomment one block (git, features, ...) — remove
9
- # the leading "# " from each line of that block. The keys above
10
- # (schemaVersion + defaults) stay as-is.
7
+ # Two top-level sections:
8
+ # - `defaults` — fall-throughs for container-yml fields (git
9
+ # identity, per-feature options).
10
+ # - `routing` — machine-global settings for the shared Traefik
11
+ # singleton (only `hostPort` today).
11
12
  #
12
- # To verify what the resolved config looks like after edits:
13
- # monoceros init --dry-run <name>
13
+ # Per-container yml ALWAYS wins over these defaults. Setting a value
14
+ # here just spares you from repeating it across every container.
14
15
 
15
16
  schemaVersion: 1
16
17
 
18
+ # ──────────────────────────────────────────────────────────────────
19
+ # defaults — fall-throughs for container-yml fields.
20
+ # ──────────────────────────────────────────────────────────────────
21
+
17
22
  defaults:
18
- # Git identity for any container the host hasn't already
19
- # configured. Container yml's `git.user` overrides this;
20
- # `git config --global` on the host overrides both. Removed →
21
- # `monoceros apply` prompts at first run and persists per
22
- # container.
23
- # git:
24
- # user:
25
- # name: Your Name
26
- # email: you@example.com
23
+ # Git committer identity for any container whose yml omits
24
+ # `git.user`. Resolution order at apply time:
25
+ # 1. container yml's `git.user`
26
+ # 2. this `defaults.git.user`
27
+ # 3. host's `git config --global user.{name,email}`
28
+ # 4. `.monoceros/gitconfig` left by a previous apply
29
+ # 5. interactive prompt (skipped in non-TTY)
30
+ git:
31
+ # user:
32
+ # name: Your Name
33
+ # email: you@example.com
34
+
35
+ # Per-feature option defaults, keyed by the feature's OCI ref.
36
+ # A container yml that activates the same feature without setting a
37
+ # given option falls back to whatever's here. The list below shows
38
+ # EVERY option each Monoceros-curated feature accepts, with its
39
+ # default value. Refs without an entry here behave as if every
40
+ # option were unset.
41
+ features:
42
+ # ── Anthropic Claude Code CLI ───────────────────────────────
43
+ # ghcr.io/getmonoceros/monoceros-features/claude-code:1:
44
+ # version: latest # npm-style spec ('latest', '0.4.2', '^0.4')
45
+ # apiKey: '' # Anthropic API key (`sk-ant-…`). Set →
46
+ # # ANTHROPIC_API_KEY is exported and Claude
47
+ # # Code uses API auth; empty → OAuth /
48
+ # # subscription login inside the container.
49
+ #
50
+ # ── GitHub CLI ──────────────────────────────────────────────
51
+ # ghcr.io/getmonoceros/monoceros-features/github-cli:1:
52
+ # apiToken: '' # GitHub PAT (github.com → Settings →
53
+ # # Developer settings → PAT, scopes
54
+ # # repo + read:org + gist). Set → exported
55
+ # # as GH_TOKEN; empty → no auto-login,
56
+ # # `gh auth login` interactively in shell.
57
+ #
58
+ # ── Atlassian (Rovo Dev acli + Teamwork Graph twg) ──────────
59
+ # ghcr.io/getmonoceros/monoceros-features/atlassian:1:
60
+ # rovodev: true # install acli + Rovo Dev agent
61
+ # twg: true # install twg (Teamwork Graph CLI)
62
+ # instance: '' # site host like 'yoursite.atlassian.net',
63
+ # # required for twg auto-login (Rovo Dev
64
+ # # asks for it on first `acli rovodev run`)
65
+ # email: '' # Atlassian-account email — paired with
66
+ # # apiToken for both CLIs' non-interactive
67
+ # # login
68
+ # apiToken: '' # Atlassian API token from
69
+ # # id.atlassian.com → Security → API tokens
70
+ # bitbucketToken: '' # optional, Bitbucket Cloud app-password.
71
+ # # Used by twg's Bitbucket commands only.
72
+
73
+ # ──────────────────────────────────────────────────────────────────
74
+ # routing — machine-global Traefik singleton settings.
75
+ # ──────────────────────────────────────────────────────────────────
27
76
 
28
- # Default options for Monoceros-curated devcontainer features,
29
- # keyed by OCI ref. Per-container yml options override these.
30
- # The feature itself decides what to do with the values (typically
31
- # a post-create hook does a non-interactive login).
32
- # features:
33
- # ghcr.io/getmonoceros/monoceros-features/claude-code:1:
34
- # apiKey: sk-ant-… # set → API auth; omit → OAuth/subscription login inside the container
35
- #
36
- # ghcr.io/getmonoceros/monoceros-features/github-cli:1:
37
- # apiToken: ghp_… # PAT with scopes: repo, read:org, gist
38
- #
39
- # ghcr.io/getmonoceros/monoceros-features/atlassian:1:
40
- # # Both CLIs are on by default — toggle individually:
41
- # # rovodev: false # `acli rovodev` (Rovo Dev agent)
42
- # # twg: false # `twg` (Teamwork Graph)
43
- # instance: yoursite.atlassian.net # required for twg auto-login
44
- # email: you@example.com
45
- # apiToken: ATATT3xFf…
46
- # # bitbucketToken: ATBB… # optional, only for twg's Bitbucket commands
77
+ routing:
78
+ # Host port the Traefik singleton binds. Default 80 → URLs are
79
+ # http://<name>.localhost/. If port 80 is permanently held on this
80
+ # machine (system nginx, Pi-hole, …) set any free port here, e.g.
81
+ # 8080. URLs then become http://<name>.localhost:8080/. The
82
+ # pre-flight check before apply / start / add-port reads this value
83
+ # and asks you to free the port or change this setting on conflict.
84
+ # hostPort: 80