Gap
The schema reference documents @table, @export, and the field/type directives well, but there is no canonical, atomic section that maps a defined-and-exported table to the automatic REST endpoints it produces (GET /{Table}, GET /{Table}/{id}, POST /{Table}, PUT /{Table}/{id}, PATCH, DELETE, etc.), nor one that states the rest: true config requirement to enable them. This information is currently scattered across the schema and REST docs.
Impact
The @harperfast/skills rule adding-tables-with-schemas cannot be migrated from hand-authored to docs-generated because its distinctive content (the table → endpoint surface + rest: true gotcha) has no atomic doc home to source from.
Suggested fix
Add a "Tables and their automatic endpoints" section (in reference/v5/rest/overview.md or reference/v5/database/schema.md) enumerating the generated endpoints for an exported table and the rest: true requirement.
Filed while auditing rule/doc coverage for @harperfast/skills. sent with Claude Opus 4.8
Gap
The schema reference documents
@table,@export, and the field/type directives well, but there is no canonical, atomic section that maps a defined-and-exported table to the automatic REST endpoints it produces (GET /{Table},GET /{Table}/{id},POST /{Table},PUT /{Table}/{id},PATCH,DELETE, etc.), nor one that states therest: trueconfig requirement to enable them. This information is currently scattered across the schema and REST docs.Impact
The
@harperfast/skillsruleadding-tables-with-schemascannot be migrated from hand-authored to docs-generated because its distinctive content (the table → endpoint surface +rest: truegotcha) has no atomic doc home to source from.Suggested fix
Add a "Tables and their automatic endpoints" section (in
reference/v5/rest/overview.mdorreference/v5/database/schema.md) enumerating the generated endpoints for an exported table and therest: truerequirement.Filed while auditing rule/doc coverage for @harperfast/skills. sent with Claude Opus 4.8