Update CONTEXT.md with resolved config-fragment terminology #13

New issue

Open

opened 2026-08-06 20:45:02 +00:00 by ginjiruu · 0 comments

ginjiruu commented

2026-08-06 20:45:02 +00:00

Owner

Follow-up from the #12 grilling session. Once #12 (per-package KCL config fragments) lands, CONTEXT.md needs the new terminology the session settled:

Config fragment: a KCL schema file shipped by a toolbelt package (db, embeddednats, embeddedfga, app) declaring that package's config fields and their service-neutral defaults; merged/imported into an app's schema at codegen.
Service-owned default: a default owned by the toolbelt package providing the service (NATS data/nats, FGA file://data/fga/openfga.db), inherited by every app that composes the fragment.
App-owned default: a default that encodes app identity or deployment (db filename data/sqlite/<app>.db, fga.store_id), authored in the app's schema composition (db: DB = DB { path = "..." }), never in a service fragment.

The Field entry may also need a cross-reference to "config fragment". Devoid of implementation detail per the domain-modeling skill's CONTEXT-FORMAT.

Blocked by #12. On close, update the Language section of CONTEXT.md.

Follow-up from the #12 grilling session. Once #12 (per-package KCL config fragments) lands, CONTEXT.md needs the new terminology the session settled: - **Config fragment**: a KCL schema file shipped by a toolbelt package (db, embeddednats, embeddedfga, app) declaring that package's config fields and their service-neutral defaults; merged/imported into an app's schema at codegen. - **Service-owned default**: a default owned by the toolbelt package providing the service (NATS `data/nats`, FGA `file://data/fga/openfga.db`), inherited by every app that composes the fragment. - **App-owned default**: a default that encodes app identity or deployment (db filename `data/sqlite/<app>.db`, `fga.store_id`), authored in the app's schema composition (`db: DB = DB { path = "..." }`), never in a service fragment. The `Field` entry may also need a cross-reference to "config fragment". Devoid of implementation detail per the domain-modeling skill's CONTEXT-FORMAT. Blocked by #12. On close, update the Language section of CONTEXT.md.

ginjiruu referenced this issue

2026-08-06 21:23:44 +00:00

Spec: Per-package KCL config fragments — service-owned defaults (db, embeddednats, embeddedfga) #14

ginjiruu added the

ready-for-agent

label

2026-08-07 03:33:42 +00:00