@arvoretech/hub 0.9.0 → 0.11.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.
package/README.md CHANGED
@@ -36,9 +36,9 @@ One CLI command generates the config your editor needs. Done.
36
36
 
37
37
  ## What is this, actually?
38
38
 
39
- ### It's a YAML file
39
+ ### It's a config file
40
40
 
41
- Everything starts with `hub.yaml`. Here's a minimal example:
41
+ Everything starts with a config file — either `hub.yaml` or `hub.config.ts`. Here's a minimal YAML example:
42
42
 
43
43
  ```yaml
44
44
  name: my-company
@@ -65,6 +65,34 @@ workflow:
65
65
  actions: [create-pr, notify-slack]
66
66
  ```
67
67
 
68
+ And the same thing in TypeScript with type-safe helpers:
69
+
70
+ ```typescript
71
+ import { defineConfig, repo, mcp } from "@arvoretech/hub/config";
72
+
73
+ export default defineConfig({
74
+ name: "my-company",
75
+ repos: [
76
+ repo.nestjs("api", "git@github.com:company/api.git"),
77
+ repo.nextjs("frontend", "git@github.com:company/frontend.git"),
78
+ ],
79
+ mcps: [
80
+ mcp.postgresql("main-db"),
81
+ mcp.playwright(),
82
+ ],
83
+ workflow: {
84
+ pipeline: [
85
+ { step: "refinement", agent: "refinement" },
86
+ { step: "coding", agents: ["coding-backend", "coding-frontend"] },
87
+ { step: "review", agent: "code-reviewer" },
88
+ { step: "deliver", actions: ["create-pr", "notify-slack"] },
89
+ ],
90
+ },
91
+ });
92
+ ```
93
+
94
+ The CLI auto-detects which format you're using (`hub.config.ts` takes priority over `hub.yaml`).
95
+
68
96
  ### It becomes editor instructions
69
97
 
70
98
  When you run `hub generate --editor <editor>`, the CLI reads your YAML and produces config files your editor understands:
@@ -116,13 +144,21 @@ Examples:
116
144
 
117
145
  ```bash
118
146
  npx @arvoretech/hub init my-hub
119
- cd my-hub
147
+ ```
120
148
 
121
- npx @arvoretech/hub add-repo git@github.com:company/api.git --tech nestjs
122
- npx @arvoretech/hub add-repo git@github.com:company/frontend.git --tech nextjs
149
+ This launches an interactive TUI that walks you through:
150
+ 1. Naming your workspace
151
+ 2. Choosing your AI editor (Cursor, Kiro, Claude Code, OpenCode)
152
+ 3. Adding repositories with tech stack detection
153
+ 4. Selecting agents and skills from the registry
154
+ 5. Picking MCP servers for tool access
155
+ 6. Choosing config format (YAML or TypeScript)
123
156
 
124
- npx @arvoretech/hub setup
157
+ Once done:
125
158
 
159
+ ```bash
160
+ cd my-hub
161
+ npx @arvoretech/hub setup
126
162
  npx @arvoretech/hub generate --editor cursor
127
163
  ```
128
164