Rate limiting + request safeguards beyond max body bytes.
Contract test suite for API/MCP response envelopes and backward compatibility policy enforcement.
Implemented first productionization slice for Issue #9 in commit `3cb6fee`.
### Shipped
- Added explicit envelope version metadata for REST responses:
- `api_version`
- `schema_version`
- Added same version metadata for MCP tool outputs (`schemeta_compile`, `schemeta_analyze`, `schemeta_ui_bundle`).
- Added version metadata to `/health` and `/mcp/ui-bundle` endpoints.
- Documented current version values and compatibility note in README.
### Validation
- Syntax checks pass.
- Existing tests pass.
### Remaining for Issue #9
- AuthN/AuthZ model for hosted deployments.
- Rate limiting + request safeguards beyond max body bytes.
- Contract test suite for API/MCP response envelopes and backward compatibility policy enforcement.
Operations slice delivered in main via commit 7b6b176.
Delivered:
Added docs/operations-runbook.md with runtime/env vars, endpoint checks, incident playbook, release/rollback steps, and observability recommendations.
README now points to ops docs.
This complements the server-side API/schema metadata + rate-limiting hardening already shipped for #9.
Operations slice delivered in `main` via commit `7b6b176`.
Delivered:
- Added `docs/operations-runbook.md` with runtime/env vars, endpoint checks, incident playbook, release/rollback steps, and observability recommendations.
- README now points to ops docs.
This complements the server-side API/schema metadata + rate-limiting hardening already shipped for #9.
Added assertions for compile/analyze contract shape, version metadata, and stable error envelope fields.
Added MCP contract checks for schemeta_compile, schemeta_analyze, schemeta_ui_bundle, and tool listing.
Refactored src/server.js and src/mcp-server.js to be import-safe for tests (no side effects when imported).
Result: npm test now validates both compile behavior and API/MCP contract stability.
Contract-test slice completed in `main` via commit `925f807`.
Delivered:
- Added `tests/api-contract.test.js` covering stable REST/MCP contract envelopes.
- Added assertions for compile/analyze contract shape, version metadata, and stable error envelope fields.
- Added MCP contract checks for `schemeta_compile`, `schemeta_analyze`, `schemeta_ui_bundle`, and tool listing.
- Refactored `src/server.js` and `src/mcp-server.js` to be import-safe for tests (no side effects when imported).
Result: `npm test` now validates both compile behavior and API/MCP contract stability.
Hosted-mode auth controls are now implemented in main via commit bfb8275.
Delivered:
Added optional API token enforcement via SCHEMETA_AUTH_TOKEN.
When configured, all POST API routes require one of:
Authorization: Bearer <token>
x-api-key: <token>
Unauthorized requests return 401 with WWW-Authenticate: Bearer and stable error envelope.
Added automated auth tests in tests/auth.test.js.
Updated README + operations/release docs with auth env/configuration and validation steps.
Validation: npm test passes (includes auth coverage).
Hosted-mode auth controls are now implemented in `main` via commit `bfb8275`.
Delivered:
- Added optional API token enforcement via `SCHEMETA_AUTH_TOKEN`.
- When configured, all POST API routes require one of:
- `Authorization: Bearer <token>`
- `x-api-key: <token>`
- Unauthorized requests return `401` with `WWW-Authenticate: Bearer` and stable error envelope.
- Added automated auth tests in `tests/auth.test.js`.
- Updated README + operations/release docs with auth env/configuration and validation steps.
Validation: `npm test` passes (includes auth coverage).
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Problem
Schemeta has MCP + REST surfaces, but production adoption needs explicit versioning, auth/permissions boundaries, and operator guidance.
Goal
Make API/MCP integration reliable and enterprise-ready.
Scope
Acceptance Criteria
Implemented first productionization slice for Issue #9 in commit
3cb6fee.Shipped
api_versionschema_versionschemeta_compile,schemeta_analyze,schemeta_ui_bundle)./healthand/mcp/ui-bundleendpoints.Validation
Remaining for Issue #9
Implemented another Issue #9 hardening slice in commit
9ee97ff.Shipped
src/server.jsfor:/compile/analyze/layout/auto/layout/tidyMAX_REQUESTS_PER_MINUTE(default120)429 rate_limitedresponse envelope on limit exceed.MAX_BODY_BYTES,MAX_REQUESTS_PER_MINUTE).Validation
Remaining for Issue #9
Operations slice delivered in
mainvia commit7b6b176.Delivered:
docs/operations-runbook.mdwith runtime/env vars, endpoint checks, incident playbook, release/rollback steps, and observability recommendations.This complements the server-side API/schema metadata + rate-limiting hardening already shipped for #9.
Contract-test slice completed in
mainvia commit925f807.Delivered:
tests/api-contract.test.jscovering stable REST/MCP contract envelopes.schemeta_compile,schemeta_analyze,schemeta_ui_bundle, and tool listing.src/server.jsandsrc/mcp-server.jsto be import-safe for tests (no side effects when imported).Result:
npm testnow validates both compile behavior and API/MCP contract stability.Hosted-mode auth controls are now implemented in
mainvia commitbfb8275.Delivered:
SCHEMETA_AUTH_TOKEN.Authorization: Bearer <token>x-api-key: <token>401withWWW-Authenticate: Bearerand stable error envelope.tests/auth.test.js.Validation:
npm testpasses (includes auth coverage).Final closure summary:
api_version,schema_version).SCHEMETA_AUTH_TOKEN).Key commits:
3cb6fee,9ee97ff,7b6b176,925f807,bfb8275.