@hailer/mcp 2.0.0-beta.7 → 2.0.0-beta.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.
|
@@ -30,10 +30,12 @@ Apps are scaffolded and published exclusively through the scripts: `npx @hailer/
|
|
|
30
30
|
npx @hailer/create-app <project-name> --template react-ts
|
|
31
31
|
```
|
|
32
32
|
|
|
33
|
-
|
|
34
|
-
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
33
|
+
**This exact form is non-interactive — it runs with zero prompts. Do NOT deviate:**
|
|
34
|
+
- **`<project-name>` is a POSITIONAL argument, not a flag.** `--name <x>` is silently ignored and the CLI drops to an interactive "Project name:" prompt that hangs an agent. Put the name first, bare.
|
|
35
|
+
- **`--template` must be a real template name:** `react-ts` (recommended), `react`, `react-swc-ts`, `vanilla-ts`, `vanilla`, `preact-ts`, `preact`, `svelte-ts`, `svelte`. NOT `minimal` (invalid → drops to a "Select a framework" prompt that hangs).
|
|
36
|
+
- **Use a fresh, lowercase, kebab-case name** in an empty target dir — that skips the overwrite prompt AND the package-name prompt. e.g. `injured-players-cost`.
|
|
37
|
+
- Never run `npx @hailer/create-app` bare and never pipe input to it (`echo …|`, `printf`, `expect`) — the one-line form above already needs no input.
|
|
38
|
+
- Run from a parent directory (`mkdir -p apps` first if needed), NEVER copy an existing app, then `cd <project-name> && npm install`.
|
|
37
39
|
</scaffold>
|
|
38
40
|
|
|
39
41
|
<build>
|
|
@@ -33,7 +33,7 @@ The goal of the first version is **showing the correct data the user asked for**
|
|
|
33
33
|
<critical-rules>
|
|
34
34
|
## CRITICAL: Scaffolding and Data Sources
|
|
35
35
|
|
|
36
|
-
**Scaffold
|
|
36
|
+
**Scaffold with the exact non-interactive form: `npx @hailer/create-app <name> --template react-ts`.** The name is POSITIONAL (not `--name`), the template must be valid (`react-ts`/`react`/`vanilla-ts`/`svelte-ts`/…, NOT `minimal`), and the dir must be fresh — that combination runs with zero prompts. A bare `npx @hailer/create-app`, a wrong `--name` flag, an invalid template, or piping input all drop into an interactive prompt that hangs the agent. Scaffold fresh, never copy an existing app, never hand-create the structure. (Apps are script-only — no MCP scaffold tool exists.)
|
|
37
37
|
|
|
38
38
|
**For project data structure (workflows, fields, phases):**
|
|
39
39
|
- READ workspace/ TypeScript files directly (fields.ts, phases.ts, enums.ts)
|
package/CLAUDE.md
CHANGED
|
@@ -25,7 +25,7 @@ Before any MCP call, ask: "Is this answerable from `workspace/` files or a CLI?"
|
|
|
25
25
|
| Create / modify insights config | Edit `insights.ts` → `npm run insights-push:force` | — (runtime `run_insight` is fine) |
|
|
26
26
|
| Create / modify document templates | Edit `templates/` → `npm run templates-sync:force` | — |
|
|
27
27
|
| Test function field code | vitest locally | `test_function_field` |
|
|
28
|
-
| Scaffold an app | `npx @hailer/create-app` (
|
|
28
|
+
| Scaffold an app | `npx @hailer/create-app <name> --template react-ts` (name is POSITIONAL, not `--name`; bare command PROMPTS and hangs agents) | — (script-only; no MCP tool exists) |
|
|
29
29
|
| Publish an app | `cd app && npm run publish-production -- --force` (add `--market` for marketplace versions) | — (script-only; no MCP tool exists) |
|
|
30
30
|
| Create / modify apps registry | Edit `workspace/apps.ts` → `npx hailer-sdk ws-config apps push --force` | `manage_app` |
|
|
31
31
|
| Create / update activities | MCP `create_activity`, `update_activity` | — |
|
|
@@ -99,7 +99,7 @@ Always use `:force` — the non-force variants prompt interactively.
|
|
|
99
99
|
|
|
100
100
|
| Step | How |
|
|
101
101
|
|------|-----|
|
|
102
|
-
| Scaffold | `npx @hailer/create-app` — scaffold fresh, never copy an existing app |
|
|
102
|
+
| Scaffold | `npx @hailer/create-app <name> --template react-ts` (name POSITIONAL; bare = interactive prompt that hangs agents) — scaffold fresh, never copy an existing app |
|
|
103
103
|
| Local dev | `cd app && npm run dev` |
|
|
104
104
|
| Publish | `cd app && npm run publish-production -- --force` (add `--market` for marketplace; `--force` skips the overwrite prompt that hangs agents); then share via `manage_app` add_member |
|
|
105
105
|
| Register / share | Edit `workspace/apps.ts` → `npx hailer-sdk ws-config apps push --force` |
|