Skip to content

Entity files are entities/<Name>.json, not the .schema.json sync dump - #1

Open
nesbtesh wants to merge 1 commit into
mainfrom
fix/entity-json-not-schema-dump
Open

nesbtesh wants to merge 1 commit into
mainfrom
fix/entity-json-not-schema-dump

Conversation

@nesbtesh

@nesbtesh nesbtesh commented Sep 25, 2026 •

Copy link
Copy Markdown
Collaborator

The skills told assistants that every table is entities/<Name>.schema.json and to create new tables with that name.

That file is the table dump older CLIs wrote on sync ({ name, schema, workflowId }, untracked by the manifest). push accepted it as a new entity and created a fieldless <Name>.schema entity per table. It happened in a real session: 11 ghost entities.

The CLI fix (agentUI repo, apps/cli): sync stops writing the dump and deletes old ones, push/deploy ignore them (ignoredSchemaDumps in push --dry-run --json), validate names them as a leftover.

This PR aligns the skills with apps/cli/src and the generated AGENTS.md (entities/Example.json):

  • agentui-app-data: entities/<Name>.json; agentui data entities for the live tables; never push a .schema.json dump.
  • agentui-platform, agentui-ship-app: path examples.

npm test: 18 passed, 0 failed.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only changes to skill markdown and changelog; no runtime or CLI code in this repo.

Overview
Aligns AgentUI assistant skills with the real entity file convention (entities/<Name>.json per AGENTS.md and the fixed CLI), replacing guidance that pointed at entities/<Name>.schema.json.

The data skill now documents name + properties JSON files, agentui data entities for live schema inspection, and an explicit rule not to create or push legacy sync dumps ({ name, schema, workflowId }) that previously produced fieldless ghost entities on push. Platform and ship-app skills update path examples in the capability table, quickstart comment, and project layout tree. CHANGELOG records the mismatch and fix under Unreleased.

Reviewed by Cursor Bugbot for commit 61f1430. Bugbot is set up for automated code reviews on this repo. Configure here.

The skills taught entities/<Name>.schema.json. That is the table dump older
CLIs wrote on sync; push created each as a fieldless <Name>.schema entity.
AGENTS.md and the CLI use entities/<Name>.json.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant