Skip to content

feat: classify and gate publishable templates - #59

Closed
xiongxz wants to merge 6 commits into
InsForge:mainfrom
lexmount:codex/template-publisher-compat
Closed

feat: classify and gate publishable templates#59
xiongxz wants to merge 6 commits into
InsForge:mainfrom
lexmount:codex/template-publisher-compat

Conversation

@xiongxz

@xiongxz xiongxz commented Sep 2, 2026

Copy link
Copy Markdown

Summary

  • classify every catalog template with an immutable publishing compatibility contract
  • add controlled native profiles and runtime-config bootstrapping for publishable Vite templates
  • convert the Todo starter to a verified Next.js static export
  • add CI admission for lockfiles, fixed build scripts, dependency install, production output, runtime config, credentials, homepage and deep-link routing

Compatibility

  • Native: admin-dashboard, insight-flow-agent-chat, web-research-agent, website-change-monitor, React starter, Todo starter
  • Requires Node runtime: e-commerce, landing, crm, booking, chatbot, ai-pdf-chatbot, workspace
  • Generic Next.js starter remains Node-runtime-only

Validation

  • npm --prefix scripts test (17 passed)
  • node scripts/validate-registry.mjs (11 templates)
  • real production builds and artifact admission for all 4 registry-native Vite templates
  • real Vite+pnpm build for insight-flow-agent-chat
  • real Next.js static-export build for Todo (out/index.html, out/404.html, 20 files)
  • React starter production build and admission

Companion platform and UI PRs will be linked after creation.


Summary by cubic

Classifies every catalog template with an immutable publishing compatibility contract and makes native templates buildable and gated by CI. Previously templates were static references; now registry.json declares publishingCompatibility, buildProfile, and optional requiredCapabilities, and CI builds native templates and admits their production output.

Migration

  • Registry entries must now declare publishingCompatibility; buildProfile is required for native entries.
  • Contributors must add requiredCapabilities only for capabilities a template actually uses.

Template changes

  • Chatbot starter now runs AI and storage through the Platform runtime instead of the Vercel AI Gateway; provider API keys are no longer read from app code.
  • Todo starter is a verified Next.js static export with runtime-config bootstrapping.
  • Adds three native Vite templates (insight-flow-agent-chat, web-research-agent, website-change-monitor) plus runtime config loading for existing native templates.
  • Forks no longer trigger the production sync endpoint.

Written for commit 27144c1. Summary will update on new commits.

Review in cubic

xiongxz and others added 6 commits August 18, 2026 16:52
Co-authored-by: bruinxz <bruinxz@bruinxzdeMacBook-Pro.local>
Co-authored-by: bruinxz <bruinxz@bruinxzdeMacBook-Pro.local>
Co-authored-by: bruinxz <bruinxz@bruinxzdeMacBook-Pro.local>
Co-authored-by: bruinxz <bruinxz@bruinxzdeMacBook-Pro.local>
* feat: add Insight Flow Agent chat template

* refactor: move agent config behind chat UI

* refactor: simplify agent key storage

* fix: harden streaming agent template

* fix: normalize agent endpoint hosts

* fix: surface function errors in the template

---------

Co-authored-by: bruinxz <bruinxz@bruinxzdeMacBook-Pro.local>
@agent-zhang-beihai

Copy link
Copy Markdown

Thanks for the PR, @xiongxz! A quick note on our workflow: we ask contributors to open an issue first, get it assigned, then submit a PR that links it (e.g. "Closes #123"). This PR isn't linked to any issue. It'll still be reviewed, but please open an issue and claim it (comment that you'd like it assigned to you) so the work is tracked.

@agent-zhang-beihai agent-zhang-beihai Bot added the needs-issue PR isn't linked to any issue — open and claim an issue first, then link it label Sep 2, 2026
@xiongxz

xiongxz commented Sep 2, 2026

Copy link
Copy Markdown
Author

Companion PRs for the same delivery line:

@xiongxz

xiongxz commented Sep 2, 2026

Copy link
Copy Markdown
Author

Closing as superseded: this PR was mistakenly opened against upstream and therefore included five pre-existing fork commits outside this delivery. The corrected one-commit, task-scoped PR targets the production fork baseline at lexmount#6. No changes from this oversized PR were merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-issue PR isn't linked to any issue — open and claim an issue first, then link it

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants