@eventmodelers/cli 0.0.6 → 0.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventmodelers/cli",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Eventmodelers CLI — real-time Claude agent + skills for Claude Code, for any stack (Node, Supabase, Axon, Cratis, or modeling-only)",
   "type": "module",
   "bin": {

package/{stacks/node/templates → shared}/build-kit/README.md

@@ -9,7 +9,7 @@ Ralph's runtime directory. Contains the agent loop, realtime subscription, promp
 node .build-kit/ralph-claude.js
 
 # Local Ollama model — run `ollama serve` first
-OLLAMA_MODEL=qwen3:8b node .build-kit/ralph-ollama.js
+OLLAMA_MODEL=qwen3.5:9b node .build-kit/ralph-ollama.js
 
 # Custom project directory (defaults to the parent of .build-kit)
 node .build-kit/ralph-claude.js /path/to/project
@@ -66,13 +66,13 @@ node .build-kit/realtime-agent.js
 ## Ollama configuration
 
 ```bash
-OLLAMA_MODEL=qwen3:8b          # model to use (default: qwen3:8b)
+OLLAMA_MODEL=qwen3.5:9b         # model to use (default: qwen3.5:9b)
 OLLAMA_URL=http://host:11434   # Ollama server URL (default: http://localhost:11434)
 ```
 
 ## Config
 
-Credentials are stored in `.build-kit/.eventmodelers/config.json` (written by `ralph-li install`):
+Credentials are stored in `.build-kit/.eventmodelers/config.json` (written by `eventmodelers init`):
 
 ```json
 {

package/{stacks/axon/templates → shared}/build-kit/lib/ralph.js

@@ -8,6 +8,7 @@
 import { createClient } from '@supabase/supabase-js';
 import { readFileSync, mkdirSync, writeFileSync, existsSync, readdirSync } from 'fs';
 import { join, dirname } from 'path';
+import { homedir } from 'os';
 import { randomUUID } from 'crypto';
 
 // ── HTTP helpers ──────────────────────────────────────────────────────────────
@@ -57,9 +58,14 @@ function* configCandidates(kitDir) {
   while (true) {
     yield join(dir, '.eventmodelers', 'config.json');
     const parent = dirname(dir);
-    if (parent === dir) return;
+    if (parent === dir) break;
     dir = parent;
   }
+  // Last resort: the walk above only passes through $HOME if the project happens
+  // to live under it. A project outside $HOME (e.g. /tmp/foo) never sees it, so
+  // check it explicitly — this is where `eventmodelers init-config --global` writes
+  // account-wide defaults (organizationId/token) shared across every project.
+  yield join(homedir(), '.eventmodelers', 'config.json');
 }
 
 function loadLocalConfig(kitDir) {
@@ -67,7 +73,7 @@ function loadLocalConfig(kitDir) {
   const sources = [];
 
   for (const candidate of configCandidates(kitDir)) {
-    if (!existsSync(candidate)) continue;
+    if (sources.includes(candidate) || !existsSync(candidate)) continue;
     let cfg;
     try {
       cfg = JSON.parse(readFileSync(candidate, 'utf-8'));
@@ -83,6 +89,7 @@ function loadLocalConfig(kitDir) {
   }
 
   if (process.env.BASE_URL) merged.baseUrl = process.env.BASE_URL;
+  else if (!merged.baseUrl) merged.baseUrl = 'https://api.eventmodelers.ai';
 
   if (sources.length > 1) {
     console.log(`[ralph] Merged config from: ${sources.join(', ')}`);
@@ -90,7 +97,7 @@ function loadLocalConfig(kitDir) {
     console.log(`[ralph] Using credentials from ${sources[0]}`);
   } else if (sources.length === 0) {
     console.warn(`[ralph] Note: no .eventmodelers/config.json found — platform sync disabled.`);
-    console.warn(`        To enable board sync, follow: https://app.eventmodelers.ai/documentation#build-axon`);
+    console.warn(`        To enable board sync, follow: https://app.eventmodelers.ai/documentation#build`);
     console.warn(`        Code generation from local slice definitions will still run.`);
   }
 

package/shared/build-kit/ralph-ollama.js

@@ -2,7 +2,7 @@
 // Ralph loop + realtime agent using a local Ollama model as the executor.
 // Run `ollama serve` first.
 // Usage: node ralph-ollama.js [project_dir]
-//        OLLAMA_MODEL=qwen3:8b node ralph-ollama.js
+//        OLLAMA_MODEL=qwen3.5:9b node ralph-ollama.js
 //        OLLAMA_URL=http://host:11434 node ralph-ollama.js
 
 import { startRalph } from './lib/ralph.js';
@@ -12,7 +12,7 @@ import { fileURLToPath } from 'url';
 
 const kitDir = dirname(fileURLToPath(import.meta.url));
 const projectDir = process.argv[2] ? resolve(process.argv[2]) : resolve(kitDir, '..');
-const model = process.env.OLLAMA_MODEL || 'qwen3:8b';
+const model = process.env.OLLAMA_MODEL || 'qwen3.5:9b';
 
 console.log(`[ralph-ollama] model=${model}`);
 

package/{stacks/node/templates → shared}/build-kit/ralph.sh

@@ -23,7 +23,7 @@ AGENT_SCRIPT="$KIT_DIR/lib/agent.sh"
 HAS_CREDENTIALS=true
 if [[ ! -f "$KIT_DIR/.eventmodelers/config.json" ]]; then
   echo "[ralph] Note: no .eventmodelers/config.json found — platform sync disabled." >&2
-  echo "        To enable board sync, follow: https://app.eventmodelers.ai/documentation#build-node" >&2
+  echo "        To enable board sync, follow: https://app.eventmodelers.ai/documentation#build" >&2
   echo "        Code generation from local slice definitions will still run." >&2
   HAS_CREDENTIALS=false
 fi

package/shared/build-kit/realtime-agent.js

@@ -13,6 +13,6 @@ const kitDir = process.argv[2] ? resolve(process.argv[2]) : dirname(fileURLToPat
 const local = loadLocalConfig(kitDir);
 const cfg = await retryOn401('fetchPlatformConfig', () => fetchPlatformConfig(local));
 
-console.log(`[agent] Starting — org=${cfg.organizationId}, board=${cfg.boardId}, base=${cfg.baseUrl}`);
+console.log(`[agent] Starting — org=${cfg.organizationId}${cfg.boardId ? `, board=${cfg.boardId}` : ''}, base=${cfg.baseUrl}`);
 
 await startRealtimeAgent(cfg, kitDir);

package/{stacks/supabase/templates/.claude → shared}/skills/connect/SKILL.md

@@ -48,7 +48,7 @@ If an inline `board=<uuid>` is found, use it as `BOARD_ID` — **it takes priori
 
 ## Step 1 — Read config file
 
-Search for `.eventmodelers/config.json` starting from the current working directory and walking up through all parent directories:
+Search for `.eventmodelers/config.json` starting from the current working directory and walking up through all parent directories. This is the same file every kit installed in this project reads and writes, so credentials only need to be entered once per project:
 
 ```bash
 dir="$PWD"
@@ -66,7 +66,7 @@ done
 If a file is found (at any level), note its path and extract any values **not already set by Step 0**:
 - `token` → `TOKEN`
 - `boardId` → `BOARD_ID`
-- `organizationId` → `ORG_ID`
+- `organizationId` (or `orgId`) → `ORG_ID`
 - `baseUrl` → `BASE_URL` (default: `https://api.eventmodelers.ai` if missing)
 
 Resolution priority: **inline param > config file > ask user**
@@ -86,7 +86,12 @@ Stop asking questions. Show this hint and wait for them to paste:
 
 > "Great — please paste your config from https://app.eventmodelers.ai/account here."
 
-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.
+The paste may be either a JSON object, or a single comma-separated line of `key=value` pairs (as copied out of a URL query string), in any order, e.g.:
+```
+token=xxxxxxxx-...,boardId=xxxxxxxx-...,organizationId=xxxxxxxx-...,baseUrl=https://api.eventmodelers.ai
+```
+
+Parse either form immediately — accept both `orgId` and `organizationId` as the organization field. For the comma-separated form, split on commas and match each piece by its `key=` prefix (`token`, `boardId`, `organizationId`/`orgId`, `baseUrl`) rather than by position — do **not** assume a fixed field order, since the order the value was copied in and the order it's pasted in are not guaranteed to match. If a value has no recognizable `key=` prefix, treat it as an error and re-ask rather than guessing which field it belongs to. Apply all values, and proceed directly to Step 3.
 
 **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.
 
@@ -111,7 +116,7 @@ cat > .eventmodelers/config.json << 'EOF'
 {
   "token": "<TOKEN>",
   "boardId": "<BOARD_ID>",
-  "orgId": "<ORG_ID>",
+  "organizationId": "<ORG_ID>",
   "baseUrl": "<BASE_URL>"
 }
 EOF
@@ -162,7 +167,7 @@ curl -s -o /dev/null -w "%{http_code}" \
 {
   "token": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "boardId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
-  "orgId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+  "organizationId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "baseUrl": "http://localhost:3000"
 }
 ```

package/stacks/cratis-csharp/templates/build-kit/lib/AGENT.md

@@ -56,3 +56,4 @@ These files are always up to date — read them directly before invoking any ski
 - The `boardId` and `organizationId` from each payload provide full context — pass them to skills.
 - Node events use `node:created`, `node:changed`, `node:deleted` — always POST to `/api/org/:orgId/boards/:boardId/nodes/events`.
 - Slice metadata (title, status) lives on the SLICE_BORDER node under `meta.sliceStatus` and `meta.title`.
+- `/update-slice-status` rejects moving a slice into a status it's already in — this is a concurrency guard, not a bug. It means another agent already claimed the slice. Treat it as `ALREADY_IN_STATUS`, skip that slice, and move on to the next `Planned` one instead of erroring out.

package/stacks/modeling-kit/templates/kit/README.md

@@ -0,0 +1,79 @@
+# .agent-modeling-kit
+
+Ralph's runtime directory for modeling-only projects — skills + agent loop, no backend scaffold.
+
+## Quick start
+
+```bash
+# Claude (default)
+node .agent-modeling-kit/ralph-claude.js
+
+# Local Ollama model — run `ollama serve` first
+OLLAMA_MODEL=qwen3.5:9b node .agent-modeling-kit/ralph-ollama.js
+
+# Bash-only loop (no realtime)
+.agent-modeling-kit/ralph.sh
+
+# Custom project directory (defaults to the parent of .agent-modeling-kit)
+node .agent-modeling-kit/ralph-claude.js /path/to/project
+```
+
+## Files
+
+**Entry points** (top level):
+
+| File | Purpose |
+|------|---------|
+| `ralph-claude.js` | Runs the task loop using Claude Code as the executor |
+| `ralph-ollama.js` | Runs the task loop using a local Ollama model |
+| `ralph.sh` | Shell-based loop — alternative to the JS entry points |
+| `realtime-agent.js` | Standalone realtime agent — only needed to run it in a separate terminal |
+
+**Internals** (`lib/`):
+
+| File | Purpose |
+|------|---------|
+| `lib/ralph.js` | Shared library — realtime agent + task loop; imported by the entry points |
+| `lib/ollama-agent.js` | Ollama executor — called by `ralph-ollama.js`, can also run manually |
+| `lib/agent.sh` | Thin shell wrapper around `claude` — called by `ralph.sh` |
+
+## How it works
+
+Modeling-only mode is a single phase: whenever `tasks.json` has entries, the loop runs
+Claude (or Ollama) against the task, following the instructions in the project root
+`CLAUDE.md` — read `.agent-modeling-kit/tasks.json`, pick the highest-priority task, run
+the matching skill (`/timeline`, `/place-element`, `/storyboard`, ...), then remove the
+completed task. There is no build-a-slice-into-code phase — that's what the backend
+stacks (`node`, `supabase`, `axon`, `cratis-csharp`) add on top of this.
+
+## Running the realtime agent separately
+
+```bash
+# Terminal 1 — realtime agent only
+node .agent-modeling-kit/realtime-agent.js
+
+# Terminal 2 — loop only (poll tasks.json without the realtime subscription)
+.agent-modeling-kit/ralph.sh
+```
+
+## Ollama configuration
+
+```bash
+OLLAMA_MODEL=qwen3.5:9b         # model to use (default: qwen3.5:9b)
+OLLAMA_URL=http://host:11434   # Ollama server URL (default: http://localhost:11434)
+```
+
+## Config
+
+Credentials are stored in `.agent-modeling-kit/.eventmodelers/config.json` (written by `eventmodelers init-modeling`):
+
+```json
+{
+  "organizationId": "...",
+  "boardId": "...",
+  "token": "...",
+  "baseUrl": "https://api.eventmodelers.ai"
+}
+```
+
+Claude skills live in `.claude/skills/` and are available inside any Claude Code session started from the project root.

package/stacks/modeling-kit/templates/kit/lib/ralph.js

@@ -7,6 +7,7 @@
 import { createClient } from '@supabase/supabase-js';
 import { readFileSync, writeFileSync, existsSync } from 'fs';
 import { join, dirname } from 'path';
+import { homedir } from 'os';
 import { randomUUID } from 'crypto';
 
 // ── HTTP helpers ──────────────────────────────────────────────────────────────
@@ -56,9 +57,14 @@ function* configCandidates(kitDir) {
   while (true) {
     yield join(dir, '.eventmodelers', 'config.json');
     const parent = dirname(dir);
-    if (parent === dir) return;
+    if (parent === dir) break;
     dir = parent;
   }
+  // Last resort: the walk above only passes through $HOME if the project happens
+  // to live under it. A project outside $HOME (e.g. /tmp/foo) never sees it, so
+  // check it explicitly — this is where `eventmodelers init-config --global` writes
+  // account-wide defaults (organizationId/token) shared across every project.
+  yield join(homedir(), '.eventmodelers', 'config.json');
 }
 
 function loadLocalConfig(kitDir) {
@@ -66,7 +72,7 @@ function loadLocalConfig(kitDir) {
   const sources = [];
 
   for (const candidate of configCandidates(kitDir)) {
-    if (!existsSync(candidate)) continue;
+    if (sources.includes(candidate) || !existsSync(candidate)) continue;
     let cfg;
     try {
       cfg = JSON.parse(readFileSync(candidate, 'utf-8'));
@@ -82,6 +88,7 @@ function loadLocalConfig(kitDir) {
   }
 
   if (process.env.BASE_URL) merged.baseUrl = process.env.BASE_URL;
+  else if (!merged.baseUrl) merged.baseUrl = 'https://api.eventmodelers.ai';
 
   if (sources.length > 1) {
     console.log(`[ralph] Merged config from: ${sources.join(', ')}`);

package/stacks/modeling-kit/templates/kit/ralph.sh

@@ -14,7 +14,7 @@ AGENT_SCRIPT="$KIT_DIR/lib/agent.sh"
 
 if [[ ! -f "$KIT_DIR/.eventmodelers/config.json" ]]; then
   echo "ERROR: No .eventmodelers/config.json found in $KIT_DIR"
-  echo "Run: npx @eventmodelers/eventmodelers.ai install"
+  echo "Run: npx @eventmodelers/cli init-modeling"
   exit 1
 fi
 

package/stacks/node/templates/build-kit/lib/backend-prompt.md

@@ -149,4 +149,4 @@ If ALL slices in the current context are Done, reply with:
 
 ## When an iteration completes
 
-Use all the key learnings from the project.txt and update the Agends.md file with those learning.
+Use all the key learnings from the progress.txt and update the AGENTS.md file with those learnings.

package/stacks/supabase/templates/build-kit/lib/backend-prompt.md

@@ -149,4 +149,4 @@ If ALL slices in the current context are Done, reply with:
 
 ## When an iteration completes
 
-Use all the key learnings from the project.txt and update the Agends.md file with those learning.
+Use all the key learnings from the progress.txt and update the AGENTS.md file with those learnings.

package/stacks/axon/templates/.claude/skills/connect/SKILL.md

@@ -1,178 +0,0 @@
----
-name: connect
-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.
----
-
-# Connect — Resolve Eventmodelers Config
-
-**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.
-
----
-
-## What this skill produces
-
-After running, the following variables are available for the rest of the session:
-
-| Variable | Header sent to API | Description |
-|----------|--------------------|-------------|
-| `TOKEN` | `x-token` | API token UUID |
-| `BOARD_ID` | `x-board-id` | Target board UUID |
-| `ORG_ID` | — | Organization UUID (used in all board-scoped URLs) |
-| `BASE_URL` | — | Base URL, e.g. `http://localhost:3000` |
-
-Every API call in every skill must include these headers:
-```
-x-token: <TOKEN>
-x-board-id: <BOARD_ID>
-x-user-id: <skill-name>   ← set by each skill individually
-```
-
-All board-scoped URLs follow the pattern: `<BASE_URL>/api/org/<ORG_ID>/boards/<BOARD_ID>/...`
-
----
-
-## Step 0 — Check for inline parameters
-
-Before reading the config file, scan the prompt/arguments that invoked this skill for inline overrides. Supported formats:
-
-| Pattern | Example |
-|---------|---------|
-| `board=<uuid>` | `board=05cda19d-d5b8-4b51-ae88-c72f2611548a` |
-| `token=<uuid>` | `token=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
-| `org=<uuid>` | `org=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
-| `baseUrl=<url>` | `baseUrl=http://localhost:3000` |
-
-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.
-
----
-
-## Step 1 — Read config file
-
-Search for `.eventmodelers/config.json` starting from the current working directory and walking up through all parent directories:
-
-```bash
-dir="$PWD"
-config_file=""
-while [ "$dir" != "/" ]; do
-  if [ -f "$dir/.eventmodelers/config.json" ]; then
-    config_file="$dir/.eventmodelers/config.json"
-    break
-  fi
-  dir="$(dirname "$dir")"
-done
-[ -n "$config_file" ] && cat "$config_file"
-```
-
-If a file is found (at any level), note its path and extract any values **not already set by Step 0**:
-- `token` → `TOKEN`
-- `boardId` → `BOARD_ID`
-- `organizationId` → `ORG_ID`
-- `baseUrl` → `BASE_URL` (default: `https://api.eventmodelers.ai` if missing)
-
-Resolution priority: **inline param > config file > ask user**
-
-If all four are present (from any source), skip to **Step 4 — Verify**.
-
----
-
-## Step 2 — Ask for missing values
-
-If after Steps 0 and 1 any required field is still missing, **ask the user one question first**:
-
-> "Do you have a config from the eventmodelers accounts page? (yes / no)"
-
-**If the user answers yes:**
-Stop asking questions. Show this hint and wait for them to paste:
-
-> "Great — please paste your config from https://app.eventmodelers.ai/account here."
-
-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.
-
-**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.
-
-| Field | What to ask |
-|-------|-------------|
-| `token` | "Please provide your eventmodelers API token (a UUID from your workspace settings)." |
-| `boardId` | "Please provide the board ID you want to work with (the UUID from the board URL)." |
-| `orgId` | "Please provide your organization ID (the UUID from your organization settings)." |
-| `baseUrl` | Do **not** ask — default to `https://api.eventmodelers.ai` silently. |
-
-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.
-
----
-
-## Step 3 — Persist config
-
-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):
-
-```bash
-mkdir -p .eventmodelers
-cat > .eventmodelers/config.json << 'EOF'
-{
-  "token": "<TOKEN>",
-  "boardId": "<BOARD_ID>",
-  "orgId": "<ORG_ID>",
-  "baseUrl": "<BASE_URL>"
-}
-EOF
-```
-
-Then ensure `.eventmodelers/config.json` is in `.gitignore`. Check whether it is already present:
-
-```bash
-grep -q ".eventmodelers/config.json" .gitignore 2>/dev/null || echo "MISSING"
-```
-
-If `MISSING`, append it:
-
-```bash
-echo ".eventmodelers/config.json" >> .gitignore
-```
-
-Tell the user: `"Config saved to .eventmodelers/config.json and added to .gitignore."`
-
----
-
-## Step 4 — Verify
-
-Confirm the token and board are valid with a lightweight call:
-
-```bash
-curl -s -o /dev/null -w "%{http_code}" \
-  -H "x-token: <TOKEN>" \
-  -H "x-board-id: <BOARD_ID>" \
-  -H "x-user-id: connect-skill" \
-  "<BASE_URL>/api/org/<ORG_ID>/boards/<BOARD_ID>/nodes?type=CHAPTER"
-```
-
-| Response | Action |
-|----------|--------|
-| `200` | Config is valid. Print one line: `"Connected — board <BOARD_ID>"` and return. |
-| `401` | Token is invalid or missing. Tell the user and re-run from Step 2, clearing `token`. |
-| `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. |
-| `404` | Board not found. Tell the user and re-run from Step 2, clearing `boardId`. |
-| Any other | Print the status code and raw response. Ask the user how to proceed. |
-
----
-
-## Config file format
-
-`.eventmodelers/config.json`:
-```json
-{
-  "token": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
-  "boardId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
-  "orgId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
-  "baseUrl": "http://localhost:3000"
-}
-```
-
-The `token` field is a secret. It is never logged or shown after initial confirmation.
-
----
-
-## Security notes
-
-- The config file is workspace-local and gitignored — never commit it.
-- The token grants write access to all boards in its organization — treat it like a password.
-- If a skill receives a `401` or `403` mid-session, re-invoke this skill to refresh the config before retrying.