@fabrika/builder 0.9.0-cloudflare.3 → 0.9.0-dev.10
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 +1 -1
- package/decisions/README.md +20 -20
- package/decisions/patterns/app-deploy.md +6 -6
- package/decisions/patterns/{vozka-app-deploy.md → fabrika-app-deploy.md} +24 -24
- package/decisions/patterns/single-worker-spa.md +2 -2
- package/decisions/patterns/typed-worker-rpc.md +3 -3
- package/decisions/patterns/zerops-control-deploy.md +1 -1
- package/decisions/technologies/buzola.md +2 -2
- package/decisions/technologies/cloudflare-access.md +5 -5
- package/decisions/technologies/cloudflare.md +1 -1
- package/decisions/technologies/contember.md +1 -1
- package/decisions/technologies/{vozka.md → fabrika-control.md} +35 -30
- package/decisions/technologies/{propustka.md → fabrika-iam.md} +17 -17
- package/decisions/technologies/lopata.md +1 -1
- package/decisions/technologies/oblaka.md +6 -6
- package/decisions/technologies/workers-ai.md +1 -1
- package/decisions/technologies/wrangler.md +2 -2
- package/decisions/technologies/zerops-fabrika-auth.md +2 -2
- package/decisions/technologies/zerops-platform.md +1 -1
- package/package.json +8 -8
- package/skill/SKILL.md +1 -1
- package/skill/gates/tech.jsx +1 -1
- package/stacks/README.md +1 -1
- package/stacks/cf-internal-app.md +22 -22
- package/ui/dist/assets/client.mh3w1dvc.js +214 -0
- package/ui/dist/index.html +1 -1
- package/ui/dist/assets/client.1cjttr57.js +0 -214
|
@@ -48,7 +48,7 @@ and AI adds a summary, prioritization or explanation afterwards.
|
|
|
48
48
|
result first; store AI status/error separately and retry off the request path.
|
|
49
49
|
- Long inference belongs in `queue()` or `scheduled()`, not an HTTP request's
|
|
50
50
|
critical path.
|
|
51
|
-
- If
|
|
51
|
+
- If `@fabrika/provider-cloudflare`/oblaka lacks a first-class Workers AI resource, use a small
|
|
52
52
|
structural `Bindable` that emits `{ ai: { binding } }`; keep that workaround
|
|
53
53
|
isolated and remove it once the IaC package exposes a supported primitive.
|
|
54
54
|
|
|
@@ -20,7 +20,7 @@ sources:
|
|
|
20
20
|
|
|
21
21
|
Cloudflare's official CLI: local D1 lifecycle (`wrangler d1 migrations apply DB
|
|
22
22
|
--local`, `wrangler d1 execute DB --local --file …`), `wrangler dev` (workerd), and
|
|
23
|
-
`wrangler deploy`. Used directly on the real-CF path and internally by
|
|
23
|
+
`wrangler deploy`. Used directly on the real-CF path and internally by Fabrika Control for
|
|
24
24
|
remote D1 migrations, Worker deploy and secret sync; the local-first path uses
|
|
25
25
|
the `lopata` CLI instead.
|
|
26
26
|
|
|
@@ -28,7 +28,7 @@ the `lopata` CLI instead.
|
|
|
28
28
|
|
|
29
29
|
- The real-CF dev/deploy path (alongside `cloudflare-vite-plugin`).
|
|
30
30
|
- Local D1 migrations/seeds when not using `lopata d1`.
|
|
31
|
-
- A
|
|
31
|
+
- A Fabrika-managed app still includes a compatible wrangler dependency because
|
|
32
32
|
the deploy engine invokes its binary against the materialized config.
|
|
33
33
|
|
|
34
34
|
## Impacts & gotchas
|
|
@@ -6,8 +6,8 @@ slot: authz
|
|
|
6
6
|
provides: [authentication, authorization, proxy-enforcement]
|
|
7
7
|
requires: [zerops-platform]
|
|
8
8
|
recommends: []
|
|
9
|
-
conflicts: [
|
|
10
|
-
npm: ["@fabrika/app@0.9.0-
|
|
9
|
+
conflicts: [fabrika-iam, cloudflare-access, auth-password-kv]
|
|
10
|
+
npm: ["@fabrika/app@0.9.0-dev.10", "@fabrika/db@0.9.0-dev.10", "zod@^3.25.76"]
|
|
11
11
|
status: wip
|
|
12
12
|
sources:
|
|
13
13
|
- where: "packages/app/skill/SKILL.md in fabrika-platform (the `fabrika-app` skill)"
|
|
@@ -7,7 +7,7 @@ provides: [platform, private-services, managed-deploy]
|
|
|
7
7
|
requires: [bun, postgres]
|
|
8
8
|
recommends: []
|
|
9
9
|
conflicts: [cloudflare]
|
|
10
|
-
npm: ["@fabrika/provider-zerops@0.9.0-
|
|
10
|
+
npm: ["@fabrika/provider-zerops@0.9.0-dev.10", "@fabrika/app@0.9.0-dev.10", "@fabrika/cli@0.9.0-dev.10"]
|
|
11
11
|
status: wip
|
|
12
12
|
sources:
|
|
13
13
|
- where: "examples/zerops-app/fabrika.config.ts + zerops.yaml in fabrika-platform"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fabrika/builder",
|
|
3
|
-
"version": "0.9.0-
|
|
3
|
+
"version": "0.9.0-dev.10",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Local-first guided application design and agent-assisted implementation.",
|
|
6
6
|
"license": "MIT",
|
|
@@ -48,13 +48,13 @@
|
|
|
48
48
|
},
|
|
49
49
|
"dependencies": {
|
|
50
50
|
"zod": "^3.25.76",
|
|
51
|
-
"@fabrika/annotations": "0.9.0-
|
|
52
|
-
"@fabrika/app": "0.9.0-
|
|
53
|
-
"@fabrika/auth-core": "0.9.0-
|
|
54
|
-
"@fabrika/canvas-kernel": "0.9.0-
|
|
55
|
-
"@fabrika/control-contract": "0.9.0-
|
|
56
|
-
"@fabrika/daemon-kit": "0.9.0-
|
|
57
|
-
"@fabrika/provider-zerops": "0.9.0-
|
|
51
|
+
"@fabrika/annotations": "0.9.0-dev.10",
|
|
52
|
+
"@fabrika/app": "0.9.0-dev.10",
|
|
53
|
+
"@fabrika/auth-core": "0.9.0-dev.10",
|
|
54
|
+
"@fabrika/canvas-kernel": "0.9.0-dev.10",
|
|
55
|
+
"@fabrika/control-contract": "0.9.0-dev.10",
|
|
56
|
+
"@fabrika/daemon-kit": "0.9.0-dev.10",
|
|
57
|
+
"@fabrika/provider-zerops": "0.9.0-dev.10",
|
|
58
58
|
"preact": "^10.25.0"
|
|
59
59
|
}
|
|
60
60
|
}
|
package/skill/SKILL.md
CHANGED
|
@@ -38,7 +38,7 @@ ensure daemon → fabrika builder next → do packet work → gate → advance
|
|
|
38
38
|
Claude and Codex repo support by default, starts the daemon, and opens the
|
|
39
39
|
dashboard. Use `--agent claude` or `--agent codex` only when the user wants
|
|
40
40
|
a single host. When the brief explicitly calls for a full internal
|
|
41
|
-
Cloudflare app with native
|
|
41
|
+
Cloudflare app with native Fabrika IAM login and Fabrika Control deployment, select
|
|
42
42
|
`--profile cf-internal-app` instead of the lightweight default.
|
|
43
43
|
- Otherwise run `bunx fabrika builder ensure-daemon`.
|
|
44
44
|
|
package/skill/gates/tech.jsx
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
}
|
|
5
5
|
<Section title="Phase 4 — Tech & scaffold decision">
|
|
6
6
|
<Item id="stack" label="Stack preset" badge="stack" badgeVariant="info">
|
|
7
|
-
e.g. cf-lightweight; for a
|
|
7
|
+
e.g. cf-lightweight; for a Fabrika Control/IAM internal app use cf-internal-app.
|
|
8
8
|
</Item>
|
|
9
9
|
<Item id="data" label="Data layer" badge="data" badgeVariant="neutral">
|
|
10
10
|
Where state lives and how it is seeded for tests.
|
package/stacks/README.md
CHANGED
|
@@ -40,7 +40,7 @@ is a **starting point**, not a lock-in — add/drop decisions freely.
|
|
|
40
40
|
|
|
41
41
|
- **`cf-lightweight`** — buzola SPA + lopata + D1, **no SSR**. The preferred default and simplest end-to-end fabrika stack (bun/lopata path).
|
|
42
42
|
- **`cf-internal-app`** — the full internal-app stack: Buzola SPA +
|
|
43
|
-
Worker API, D1/R2/Queue/Cron/Workers AI, native
|
|
43
|
+
Worker API, D1/R2/Queue/Cron/Workers AI, native Fabrika IAM login and Fabrika Control deploy.
|
|
44
44
|
- **`cf-fat`** — RRv7 **SSR** + vite + `@cloudflare/vite-plugin` (workerd) + the full CF primitive set (D1/KV/R2/Queue/AE/Cron); counts behind `count-store` so it stays locally testable.
|
|
45
45
|
- **`contember-app`** — a Contember (Postgres GraphQL CMS) backend + a buzola/React admin SPA bound via bindx. A Node-backend + static-SPA shape (not Workers/D1).
|
|
46
46
|
- **`content-site`** — a Bun-native static content site: pletivo SSG + Preact islands + Tailwind. No SSR, no vite — fits the bun/non-vite preference.
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
id: cf-internal-app
|
|
3
|
-
title: "Full internal Cloudflare app — Buzola SPA +
|
|
4
|
-
goal: "From empty to a full internal app: Buzola SPA + Worker API, D1/R2/Queue/Cron/Workers AI, local Vite+lopata, native
|
|
3
|
+
title: "Full internal Cloudflare app — Buzola SPA + Fabrika IAM + Fabrika Control"
|
|
4
|
+
goal: "From empty to a full internal app: Buzola SPA + Worker API, D1/R2/Queue/Cron/Workers AI, local Vite+lopata, native Fabrika IAM login, Fabrika-managed production deploy, and green opice tests."
|
|
5
5
|
decisions:
|
|
6
6
|
- cloudflare
|
|
7
7
|
- lopata
|
|
8
8
|
- oblaka
|
|
9
|
-
-
|
|
9
|
+
- fabrika-control
|
|
10
10
|
- wrangler
|
|
11
11
|
- vite
|
|
12
12
|
- react
|
|
@@ -17,12 +17,12 @@ decisions:
|
|
|
17
17
|
- queue
|
|
18
18
|
- cron-triggers
|
|
19
19
|
- workers-ai
|
|
20
|
-
-
|
|
20
|
+
- fabrika-iam
|
|
21
21
|
- bun
|
|
22
22
|
- named-seeds
|
|
23
23
|
- single-worker-spa
|
|
24
24
|
- typed-worker-rpc
|
|
25
|
-
-
|
|
25
|
+
- fabrika-app-deploy
|
|
26
26
|
- opice
|
|
27
27
|
build: "see §build recipe below"
|
|
28
28
|
---
|
|
@@ -32,10 +32,10 @@ build: "see §build recipe below"
|
|
|
32
32
|
The production-grade **internal-app shape**: an internal, client-rendered Buzola/React
|
|
33
33
|
SPA backed by a Cloudflare Worker. It runs as a Vite SPA plus a lopata Worker
|
|
34
34
|
locally, ships as one Worker with static assets in production, logs people in
|
|
35
|
-
through native
|
|
35
|
+
through native Fabrika IAM, and delegates the whole production lifecycle to Fabrika Control.
|
|
36
36
|
|
|
37
37
|
Use `cf-lightweight` when an app only needs SPA + D1 and does not belong to the
|
|
38
|
-
|
|
38
|
+
Fabrika Control/Fabrika IAM ecosystem. This preset deliberately includes the operational
|
|
39
39
|
primitives available to the stack: R2, Queue, Cron and Workers AI. Drop any of those at the
|
|
40
40
|
tech gate when the product has no corresponding workload.
|
|
41
41
|
|
|
@@ -43,27 +43,27 @@ tech gate when the product has no corresponding workload.
|
|
|
43
43
|
|
|
44
44
|
Frontend: `react` + `buzola` + `vite` + `tailwind`. Runtime/data: `cloudflare` +
|
|
45
45
|
`d1` + `r2` + `queue` + `cron-triggers` + `workers-ai`. Local development:
|
|
46
|
-
`lopata` + `oblaka` + `bun`. Authentication/authorization: native `
|
|
47
|
-
Deployment: `
|
|
46
|
+
`lopata` + `oblaka` + `bun`. Authentication/authorization: native `fabrika-iam`.
|
|
47
|
+
Deployment: `fabrika-control` + `wrangler` through the `fabrika-app-deploy` pattern. Delivery:
|
|
48
48
|
`single-worker-spa` + `typed-worker-rpc`. Acceptance: `named-seeds` + `opice`.
|
|
49
49
|
|
|
50
50
|
requires-closure holds:
|
|
51
51
|
|
|
52
|
-
- `
|
|
53
|
-
- `
|
|
52
|
+
- `fabrika-control` → {`cloudflare`, `oblaka`, `wrangler`, `fabrika-iam`};
|
|
53
|
+
- `fabrika-iam` → {`cloudflare`, `d1`};
|
|
54
54
|
- `single-worker-spa` → {`cloudflare`, `vite`, `buzola`};
|
|
55
55
|
- `typed-worker-rpc` → {`cloudflare`, `buzola`};
|
|
56
|
-
- `
|
|
56
|
+
- `fabrika-app-deploy` → {`fabrika-control`, `fabrika-iam`, `oblaka`, `wrangler`};
|
|
57
57
|
- `buzola` → `react`; all CF resources → `cloudflare`; `named-seeds` → `d1`.
|
|
58
58
|
|
|
59
59
|
One per exclusive slot: platform, deploy-control-plane, app-delivery-shape,
|
|
60
60
|
client-worker-api, cf-dev-runtime, bundler, ui-framework, router, styling,
|
|
61
61
|
relational-db, ai-runtime, authz, js-runtime, seed-strategy and e2e-tests. There
|
|
62
62
|
is **no Cloudflare Access**
|
|
63
|
-
and no app-owned password auth; native
|
|
63
|
+
and no app-owned password auth; native Fabrika IAM owns both login and permission
|
|
64
64
|
resolution.
|
|
65
65
|
|
|
66
|
-
**Maturity:**
|
|
66
|
+
**Maturity:** Fabrika Control, Fabrika IAM, Buzola, lopata and opice are 0.x/WIP. This is a
|
|
67
67
|
curated internal production stack, not the generic default. Pin the working
|
|
68
68
|
versions, read installed sources/types before scaffolding, and typecheck the
|
|
69
69
|
actual resource/auth config.
|
|
@@ -80,10 +80,10 @@ actual resource/auth config.
|
|
|
80
80
|
API namespaces through Worker code; those paths return their own 404s and
|
|
81
81
|
never fall through to `index.html`.
|
|
82
82
|
|
|
83
|
-
### Native
|
|
83
|
+
### Native Fabrika IAM login
|
|
84
84
|
|
|
85
85
|
- Define one app id and one action/scope vocabulary shared by runtime auth and
|
|
86
|
-
the schema in `
|
|
86
|
+
the schema in `fabrika.config.ts`.
|
|
87
87
|
- Off-local, bind `IAM` to `propustka-worker` and inject `PROPUSTKA_URL` as the
|
|
88
88
|
token issuer/login origin.
|
|
89
89
|
- Pass ordered `AppGates` to `PropustkaAuth`: normally a `service` rule followed
|
|
@@ -99,16 +99,16 @@ actual resource/auth config.
|
|
|
99
99
|
inferred contract to the SPA through a type-only import.
|
|
100
100
|
- Authenticate once at the dispatcher, then require each feature handler to
|
|
101
101
|
enforce its concrete `auth.can(...)` capability.
|
|
102
|
-
- Preserve
|
|
102
|
+
- Preserve Fabrika IAM's `loginUrl`/`setCookie` across the RPC response seam.
|
|
103
103
|
|
|
104
|
-
###
|
|
104
|
+
### Fabrika Control deploy
|
|
105
105
|
|
|
106
|
-
- `
|
|
106
|
+
- `fabrika.config.ts` is the production source of truth: stable `id`, exported
|
|
107
107
|
resource builder, schema and pipeline.
|
|
108
108
|
- `ctx.domain` owns the custom domain; `pipeline.secrets` lists required runtime
|
|
109
109
|
secrets. Do not recreate deployment in `.github/workflows/deploy.yml`.
|
|
110
110
|
- A thin `oblaka.ts` reuses the resource builder only for the local lopata loop.
|
|
111
|
-
- The account operator registers repo/env/domain/trigger/secrets in
|
|
111
|
+
- The account operator registers repo/env/domain/trigger/secrets in Fabrika Control. That
|
|
112
112
|
is a deployment prerequisite, not a scaffold-time Cloudflare mutation.
|
|
113
113
|
|
|
114
114
|
## Build recipe (per-issue verify stage)
|
|
@@ -119,7 +119,7 @@ actual resource/auth config.
|
|
|
119
119
|
3. run the targeted opice scenario against the Vite URL; auth is the deterministic
|
|
120
120
|
dev operator and external AI/providers use deterministic fakes.
|
|
121
121
|
4. run unit tests + `bun run typecheck` + the SPA production build. Validate
|
|
122
|
-
`
|
|
122
|
+
`fabrika.config.ts`/`oblaka.ts` through their real config-generation command when
|
|
123
123
|
their raw-source type graph is intentionally excluded from `tsc`.
|
|
124
|
-
5. collapse the result. Production deployment remains
|
|
124
|
+
5. collapse the result. Production deployment remains Fabrika Control's responsibility;
|
|
125
125
|
do not deploy from an issue implementation loop.
|