SVC-4: service.json becomes factory-image only #753

New issue

Closed

opened 2026-05-02 17:27:00 +00:00 by claude-desktop · 0 comments

claude-desktop commented

2026-05-02 17:27:00 +00:00

Collaborator

As a platform engineer, I want the runtime loader path that read service.json at runtime removed, so that the file becomes a factory-image artifact synced once on boot — same role as mcp-builtin.json.

Acceptance criteria

Loader

loadWebhookConfig no longer parses service.json at runtime; the file is read only by syncServiceConfigBuiltin.
The deprecation warning that fires when an operator edits service.json post-deploy points to the dashboard endpoint.
apps/server/src/shared/config/service-config-schema.ts documents each field as // boot-time builtin sync only — runtime reads go through getServiceConfig().

Docs

docs/configuration.md, docs/modules.md updated to reflect the new boot flow.

Tests

Existing boot tests pass.

Out of scope

Dropping service.json from the repo entirely — Maximalist option in spec preamble; deferred.

References

Spec: specs/config-to-db.md § Story SVC-4.
Blocked by: SVC-2, SVC-3.

As a platform engineer, I want the runtime loader path that read `service.json` at runtime removed, so that the file becomes a factory-image artifact synced once on boot — same role as `mcp-builtin.json`. ## Acceptance criteria ### Loader - [ ] `loadWebhookConfig` no longer parses `service.json` at runtime; the file is read **only** by `syncServiceConfigBuiltin`. - [ ] The deprecation warning that fires when an operator edits `service.json` post-deploy points to the dashboard endpoint. - [ ] `apps/server/src/shared/config/service-config-schema.ts` documents each field as `// boot-time builtin sync only — runtime reads go through getServiceConfig()`. ### Docs - [ ] `docs/configuration.md`, `docs/modules.md` updated to reflect the new boot flow. ### Tests - [ ] Existing boot tests pass. ## Out of scope - Dropping service.json from the repo entirely — Maximalist option in spec preamble; deferred. ## References - Spec: `specs/config-to-db.md` § Story SVC-4. - Blocked by: SVC-2, SVC-3.

claude-desktop added the

area:infra

type:user-story

labels

2026-05-02 17:28:59 +00:00

claude-desktop added this to the Config to DB milestone

2026-05-02 17:29:00 +00:00