create-restforge-skills 0.1.1 → 0.3.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 +158 -150
- package/package.json +1 -1
- package/skills/restforge/SKILL.md +740 -512
- package/skills/restforge/references/auth.md +10 -7
- package/skills/restforge/references/rdf-advanced.md +538 -488
- package/skills/restforge/references/udf-catalog.md +14 -6
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Reference: Auth Extension
|
|
2
2
|
|
|
3
3
|
> **Offline mirror.** This file mirrors the auth commands of the installed
|
|
4
|
-
> RESTForge platform and Designer (`restforge project auth`, `
|
|
5
|
-
> auth`). The live tools/CLI are authoritative — when this file and them disagree,
|
|
4
|
+
> RESTForge platform and Designer (`restforge project auth`, `npx
|
|
5
|
+
> restforge-designer auth`). The live tools/CLI are authoritative — when this file and them disagree,
|
|
6
6
|
> trust the tools, then update this file.
|
|
7
7
|
|
|
8
8
|
**This file documents the auth EXTENSION — auth WITHOUT RBAC.** It is one of two
|
|
@@ -70,11 +70,11 @@ Embedded login / signup / forget-password overlay (`rfx_auth`), mounted at route
|
|
|
70
70
|
`/api/<project>/rfx_auth`. Independent of the `vanilla-js-auth` plugin.
|
|
71
71
|
|
|
72
72
|
MCP tools: `designer_auth_create`, `designer_auth_remove` — wrap
|
|
73
|
-
`restforge-designer auth --create | --remove`.
|
|
73
|
+
`npx restforge-designer auth --create | --remove`.
|
|
74
74
|
|
|
75
75
|
```
|
|
76
|
-
restforge-designer auth --create --project=<name> [options]
|
|
77
|
-
restforge-designer auth --remove --project=<name> [--frontend-path <path>] --force
|
|
76
|
+
npx restforge-designer auth --create --project=<name> [options]
|
|
77
|
+
npx restforge-designer auth --remove --project=<name> [--frontend-path <path>] --force
|
|
78
78
|
```
|
|
79
79
|
|
|
80
80
|
`--create` and `--remove` are mutually exclusive; exactly one is required.
|
|
@@ -113,7 +113,10 @@ injected automatically when `designer_generate` creates pages later.
|
|
|
113
113
|
3. Strips the auth guard from all `*.html` pages (other content untouched).
|
|
114
114
|
4. Removes the `embeddedAuth` key from `payload/app-config.json` (other keys kept).
|
|
115
115
|
|
|
116
|
-
**Prerequisites:** the `restforge-designer`
|
|
116
|
+
**Prerequisites:** the Designer is invoked via `npx restforge-designer` and is
|
|
117
|
+
bundled inside the `@restforgejs/platform` package; the prerequisite is that
|
|
118
|
+
`@restforgejs/platform` is installed in the project (e.g. a project created with
|
|
119
|
+
`npx create-restforge-app`), not a standalone binary on PATH.
|
|
117
120
|
|
|
118
121
|
Both are idempotent. **`--remove` is destructive** — confirm project name and
|
|
119
122
|
intent with the user before running (MCP always passes `--force`).
|
|
@@ -138,5 +141,5 @@ separate mechanisms. If the user needs RBAC, only plugin auth provides it.
|
|
|
138
141
|
|---|---|---|
|
|
139
142
|
| Backend: "package not installed" precondition | `@restforgejs/platform` missing in the project | Install the package, then re-run |
|
|
140
143
|
| Backend: project does not exist / DB not reachable | Auth runs against an existing project + live DB | Create the project + endpoints first; verify DB config |
|
|
141
|
-
| Frontend:
|
|
144
|
+
| Frontend: Designer (`npx restforge-designer`) cannot run | `@restforgejs/platform` (which bundles the Designer) missing in the project | Install `@restforgejs/platform` in the project (e.g. via `npx create-restforge-app`), then re-run |
|
|
142
145
|
| Frontend: files already exist, not overwritten | Auth already installed | Use `--overwrite` (create) only if you intend to replace |
|