@eventmodelers/cli 0.0.6 → 0.0.8

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 (48) hide show
  1. package/README.md +42 -9
  2. package/cli.js +633 -175
  3. package/package.json +1 -1
  4. package/{stacks/node/templates → shared}/build-kit/README.md +3 -3
  5. package/{stacks/axon/templates → shared}/build-kit/lib/ralph.js +10 -3
  6. package/shared/build-kit/ralph-ollama.js +2 -2
  7. package/{stacks/node/templates → shared}/build-kit/ralph.sh +1 -1
  8. package/shared/build-kit/realtime-agent.js +1 -1
  9. package/{stacks/supabase/templates/.claude → shared}/skills/connect/SKILL.md +10 -5
  10. package/stacks/cratis-csharp/templates/build-kit/lib/AGENT.md +1 -0
  11. package/stacks/modeling-kit/templates/kit/README.md +79 -0
  12. package/stacks/modeling-kit/templates/kit/lib/ralph.js +9 -2
  13. package/stacks/modeling-kit/templates/kit/ralph.sh +1 -1
  14. package/stacks/node/templates/build-kit/lib/backend-prompt.md +1 -1
  15. package/stacks/supabase/templates/build-kit/lib/backend-prompt.md +1 -1
  16. package/stacks/axon/templates/.claude/skills/connect/SKILL.md +0 -178
  17. package/stacks/axon/templates/.claude/skills/learn-eventmodelers-api/SKILL.md +0 -611
  18. package/stacks/axon/templates/.claude/skills/update-slice-status/SKILL.md +0 -105
  19. package/stacks/axon/templates/build-kit/ralph.sh +0 -98
  20. package/stacks/cratis-csharp/templates/.claude/skills/connect/SKILL.md +0 -178
  21. package/stacks/cratis-csharp/templates/.claude/skills/learn-eventmodelers-api/SKILL.md +0 -609
  22. package/stacks/cratis-csharp/templates/.claude/skills/update-slice-status/SKILL.md +0 -105
  23. package/stacks/cratis-csharp/templates/build-kit/lib/agent.sh +0 -20
  24. package/stacks/cratis-csharp/templates/build-kit/lib/ralph.js +0 -302
  25. package/stacks/cratis-csharp/templates/build-kit/ralph-claude.js +0 -37
  26. package/stacks/cratis-csharp/templates/build-kit/ralph.sh +0 -98
  27. package/stacks/modeling-kit/templates/.claude/skills/connect/SKILL.md +0 -178
  28. package/stacks/modeling-kit/templates/.claude/skills/learn-eventmodelers-api/SKILL.md +0 -441
  29. package/stacks/modeling-kit/templates/.claude/skills/update-slice-status/SKILL.md +0 -110
  30. package/stacks/modeling-kit/templates/kit/lib/agent.sh +0 -20
  31. package/stacks/modeling-kit/templates/kit/lib/ollama-agent.js +0 -147
  32. package/stacks/modeling-kit/templates/kit/ralph-ollama.js +0 -38
  33. package/stacks/modeling-kit/templates/kit/realtime-agent.js +0 -18
  34. package/stacks/node/templates/.claude/skills/connect/SKILL.md +0 -178
  35. package/stacks/node/templates/build-kit/lib/agent.sh +0 -20
  36. package/stacks/node/templates/build-kit/lib/ralph.js +0 -369
  37. package/stacks/node/templates/build-kit/ralph-claude.js +0 -44
  38. package/stacks/supabase/templates/.claude/skills/learn-eventmodelers-api/SKILL.md +0 -628
  39. package/stacks/supabase/templates/.claude/skills/update-slice-status/SKILL.md +0 -110
  40. package/stacks/supabase/templates/build-kit/README.md +0 -86
  41. package/stacks/supabase/templates/build-kit/lib/agent.sh +0 -20
  42. package/stacks/supabase/templates/build-kit/lib/ralph.js +0 -369
  43. package/stacks/supabase/templates/build-kit/ralph-claude.js +0 -44
  44. package/stacks/supabase/templates/build-kit/ralph.sh +0 -98
  45. /package/{stacks/axon/templates → shared}/build-kit/lib/agent.sh +0 -0
  46. /package/{stacks/axon/templates → shared}/build-kit/ralph-claude.js +0 -0
  47. /package/{stacks/node/templates/.claude → shared}/skills/learn-eventmodelers-api/SKILL.md +0 -0
  48. /package/{stacks/node/templates/.claude → shared}/skills/update-slice-status/SKILL.md +0 -0
@@ -1,98 +0,0 @@
1
- #!/bin/bash
2
- # Ralph agent loop — two independent loops, each triggered by their own condition
3
- #
4
- # onTask: tasks.json has entries → load slice from board, update .build-kit/.slices/
5
- # onPlannedSlice: .build-kit/.slices/ has a "Planned" slice → build it
6
- #
7
- # The loops are NOT causally linked — either can trigger on its own.
8
- #
9
- # Usage: ./ralph.sh [iterations] [project_dir]
10
- # iterations — number of loop cycles to run; 0 or omitted means run forever
11
- # project_dir — path to the project root; defaults to the parent of .build-kit
12
-
13
- set -euo pipefail
14
-
15
- KIT_DIR="$(cd "$(dirname "$0")" && pwd)"
16
- ITERATIONS="${1:-0}"
17
- PROJECT_DIR="${2:-"$KIT_DIR/.."}"
18
- TASKS_FILE="$KIT_DIR/tasks.json"
19
- PROMPT_FILE="$KIT_DIR/lib/prompt.md"
20
- BACKEND_PROMPT_FILE="$KIT_DIR/lib/backend-prompt.md"
21
- AGENT_SCRIPT="$KIT_DIR/lib/agent.sh"
22
-
23
- HAS_CREDENTIALS=true
24
- if [[ ! -f "$KIT_DIR/.eventmodelers/config.json" ]]; then
25
- echo "[ralph] Note: no .eventmodelers/config.json found — platform sync disabled." >&2
26
- echo " To enable board sync, follow: https://app.eventmodelers.ai/documentation#build-axon" >&2
27
- echo " Code generation from local slice definitions will still run." >&2
28
- HAS_CREDENTIALS=false
29
- fi
30
-
31
- echo "Ralph — kit: $KIT_DIR project: $PROJECT_DIR"
32
-
33
- # Returns 0 if tasks.json has at least one task
34
- has_pending_tasks() {
35
- [[ -f "$TASKS_FILE" ]] || return 1
36
- local content
37
- content=$(cat "$TASKS_FILE")
38
- [[ "$content" != "[]" && -n "$content" ]]
39
- }
40
-
41
- # Returns 0 if any JSON under .build-kit/.slices/ contains a "Planned" status
42
- has_planned_slices() {
43
- grep -rqi '"status"[[:space:]]*:[[:space:]]*"planned"' "$KIT_DIR/.slices/" --include='index.json' 2>/dev/null
44
- }
45
-
46
- # Returns the title of the first "Planned" slice, or empty string
47
- get_planned_slice_title() {
48
- for index_file in "$KIT_DIR/.slices/"*/index.json; do
49
- [[ -f "$index_file" ]] || continue
50
- local title
51
- title=$(node -e "
52
- try {
53
- const d = JSON.parse(require('fs').readFileSync(process.argv[1], 'utf-8'));
54
- const s = (d.slices||[]).find(s => (s.status||'').toLowerCase() === 'planned');
55
- if (s) process.stdout.write(s.slice || s.id || '');
56
- } catch(e) {}
57
- " "$index_file" 2>/dev/null)
58
- if [[ -n "$title" ]]; then
59
- echo "$title"
60
- return
61
- fi
62
- done
63
- }
64
-
65
- # Runs agent.sh with the given prompt; retries on non-zero exit
66
- run_agent() {
67
- local label="$1"
68
- local prompt="$2"
69
- while true; do
70
- echo "[$(date -u +%H:%M:%S)] $label"
71
- (cd "$PROJECT_DIR" && bash "$AGENT_SCRIPT" "$prompt") 2>&1 && return 0
72
- echo "[$(date -u +%H:%M:%S)] Agent error — retrying in 60s..."
73
- sleep 60
74
- done
75
- }
76
-
77
- cycle=0
78
- while [[ "$ITERATIONS" -eq 0 || "$cycle" -lt "$ITERATIONS" ]]; do
79
- ran_something=false
80
-
81
- if [[ "$HAS_CREDENTIALS" == true ]] && has_pending_tasks; then
82
- run_agent "onTask: loading slice from board..." "$(cat "$PROMPT_FILE")"
83
- ran_something=true
84
- fi
85
-
86
- if has_planned_slices; then
87
- slice_title=$(get_planned_slice_title)
88
- run_agent "onPlannedSlice: building \"$slice_title\"..." "$(cat "$BACKEND_PROMPT_FILE")"
89
- echo "[$(date -u +%H:%M:%S)] Slice \"$slice_title\" build complete — waiting for next slice"
90
- ran_something=true
91
- fi
92
-
93
- if [[ "$ran_something" == false ]]; then
94
- sleep 3
95
- fi
96
-
97
- (( cycle++ )) || true
98
- done
@@ -1,178 +0,0 @@
1
- ---
2
- name: connect
3
- description: Resolve eventmodelers connection config (token, boardId, baseUrl) from inline params or .eventmodelers/config.json — ask the user for missing values, persist them, and add the file to .gitignore. All other skills invoke this first.
4
- ---
5
-
6
- # Connect — Resolve Eventmodelers Config
7
-
8
- **Every other skill invokes this skill first** before making any API calls. Do not proceed past this skill until all four values (`TOKEN`, `BOARD_ID`, `ORG_ID`, `BASE_URL`) are resolved.
9
-
10
- ---
11
-
12
- ## What this skill produces
13
-
14
- After running, the following variables are available for the rest of the session:
15
-
16
- | Variable | Header sent to API | Description |
17
- |----------|--------------------|-------------|
18
- | `TOKEN` | `x-token` | API token UUID |
19
- | `BOARD_ID` | `x-board-id` | Target board UUID |
20
- | `ORG_ID` | — | Organization UUID (used in all board-scoped URLs) |
21
- | `BASE_URL` | — | Base URL, e.g. `http://localhost:3000` |
22
-
23
- Every API call in every skill must include these headers:
24
- ```
25
- x-token: <TOKEN>
26
- x-board-id: <BOARD_ID>
27
- x-user-id: <skill-name> ← set by each skill individually
28
- ```
29
-
30
- All board-scoped URLs follow the pattern: `<BASE_URL>/api/org/<ORG_ID>/boards/<BOARD_ID>/...`
31
-
32
- ---
33
-
34
- ## Step 0 — Check for inline parameters
35
-
36
- Before reading the config file, scan the prompt/arguments that invoked this skill for inline overrides. Supported formats:
37
-
38
- | Pattern | Example |
39
- |---------|---------|
40
- | `board=<uuid>` | `board=05cda19d-d5b8-4b51-ae88-c72f2611548a` |
41
- | `token=<uuid>` | `token=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
42
- | `org=<uuid>` | `org=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
43
- | `baseUrl=<url>` | `baseUrl=http://localhost:3000` |
44
-
45
- If an inline `board=<uuid>` is found, use it as `BOARD_ID` — **it takes priority over the config file**. Same for `token`, `org`, and `baseUrl`. Record which values came from inline params so they are not overwritten in Step 3.
46
-
47
- ---
48
-
49
- ## Step 1 — Read config file
50
-
51
- Search for `.eventmodelers/config.json` starting from the current working directory and walking up through all parent directories:
52
-
53
- ```bash
54
- dir="$PWD"
55
- config_file=""
56
- while [ "$dir" != "/" ]; do
57
- if [ -f "$dir/.eventmodelers/config.json" ]; then
58
- config_file="$dir/.eventmodelers/config.json"
59
- break
60
- fi
61
- dir="$(dirname "$dir")"
62
- done
63
- [ -n "$config_file" ] && cat "$config_file"
64
- ```
65
-
66
- If the file exists and is valid JSON, extract any values **not already set by Step 0**:
67
- - `token` → `TOKEN`
68
- - `boardId` → `BOARD_ID`
69
- - `organizationId` → `ORG_ID`
70
- - `baseUrl` → `BASE_URL` (default: `https://api.eventmodelers.ai` if missing)
71
-
72
- Resolution priority: **inline param > config file > ask user**
73
-
74
- If all four are present (from any source), skip to **Step 4 — Verify**.
75
-
76
- ---
77
-
78
- ## Step 2 — Ask for missing values
79
-
80
- If after Steps 0 and 1 any required field is still missing, **ask the user one question first**:
81
-
82
- > "Do you have a config from the eventmodelers accounts page? (yes / no)"
83
-
84
- **If the user answers yes:**
85
- Stop asking questions. Show this hint and wait for them to paste:
86
-
87
- > "Great — please paste your config from https://app.eventmodelers.ai/account here."
88
-
89
- When they paste a JSON object, parse it immediately — accept both `orgId` and `organizationId` as the organization field — apply all values, and proceed directly to Step 3.
90
-
91
- **If the user answers no** (or pastes only a partial config), ask for each still-missing field one at a time, in this order: `token`, then `boardId`, then `orgId`. Wait for the answer before asking the next.
92
-
93
- | Field | What to ask |
94
- |-------|-------------|
95
- | `token` | "Please provide your eventmodelers API token (a UUID from your workspace settings)." |
96
- | `boardId` | "Please provide the board ID you want to work with (the UUID from the board URL)." |
97
- | `orgId` | "Please provide your organization ID (the UUID from your organization settings)." |
98
- | `baseUrl` | Do **not** ask — default to `https://api.eventmodelers.ai` silently. |
99
-
100
- Where to find the token: users generate API tokens in their workspace settings at the eventmodelers platform. The token is shown only once at creation time. It is a UUID and must belong to the same organization as the board.
101
-
102
- ---
103
-
104
- ## Step 3 — Persist config
105
-
106
- Once all values are collected, write the config file. When writing, merge with any existing config — do **not** overwrite fields that were provided as inline params with values from a previous config (the inline param is the user's explicit intent for this session, but the persisted value should reflect the most recently user-supplied value):
107
-
108
- ```bash
109
- mkdir -p .eventmodelers
110
- cat > .eventmodelers/config.json << 'EOF'
111
- {
112
- "token": "<TOKEN>",
113
- "boardId": "<BOARD_ID>",
114
- "orgId": "<ORG_ID>",
115
- "baseUrl": "<BASE_URL>"
116
- }
117
- EOF
118
- ```
119
-
120
- Then ensure `.eventmodelers/config.json` is in `.gitignore`. Check whether it is already present:
121
-
122
- ```bash
123
- grep -q ".eventmodelers/config.json" .gitignore 2>/dev/null || echo "MISSING"
124
- ```
125
-
126
- If `MISSING`, append it:
127
-
128
- ```bash
129
- echo ".eventmodelers/config.json" >> .gitignore
130
- ```
131
-
132
- Tell the user: `"Config saved to .eventmodelers/config.json and added to .gitignore."`
133
-
134
- ---
135
-
136
- ## Step 4 — Verify
137
-
138
- Confirm the token and board are valid with a lightweight call:
139
-
140
- ```bash
141
- curl -s -o /dev/null -w "%{http_code}" \
142
- -H "x-token: <TOKEN>" \
143
- -H "x-board-id: <BOARD_ID>" \
144
- -H "x-user-id: connect-skill" \
145
- "<BASE_URL>/api/org/<ORG_ID>/boards/<BOARD_ID>/nodes?type=CHAPTER"
146
- ```
147
-
148
- | Response | Action |
149
- |----------|--------|
150
- | `200` | Config is valid. Print one line: `"Connected — board <BOARD_ID>"` and return. |
151
- | `401` | Token is invalid or missing. Tell the user and re-run from Step 2, clearing `token`. |
152
- | `403` | Token organization does not match board. Tell the user to check that the token was issued for the correct workspace. Re-run from Step 2 for both fields. |
153
- | `404` | Board not found. Tell the user and re-run from Step 2, clearing `boardId`. |
154
- | Any other | Print the status code and raw response. Ask the user how to proceed. |
155
-
156
- ---
157
-
158
- ## Config file format
159
-
160
- `.eventmodelers/config.json`:
161
- ```json
162
- {
163
- "token": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
164
- "boardId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
165
- "orgId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
166
- "baseUrl": "http://localhost:3000"
167
- }
168
- ```
169
-
170
- The `token` field is a secret. It is never logged or shown after initial confirmation.
171
-
172
- ---
173
-
174
- ## Security notes
175
-
176
- - The config file is workspace-local and gitignored — never commit it.
177
- - The token grants write access to all boards in its organization — treat it like a password.
178
- - If a skill receives a `401` or `403` mid-session, re-invoke this skill to refresh the config before retrying.