metabot-create-metaapp

name	metabot-create-metaapp
description	MetaBot 专属的 MetaApp 开发与交付套件。基于 IDFramework (No-Build, MVC) 架构，支持从零构建链上前端应用、编写业务指令 (Commands)、组件开发 (Web Components) 以及最终的打包交付 (Zip)。
dependencies	python >= 3.x, alpine.js, unocss

metabot-create-metaapp

赋予 MetaBot 开发 MetaWeb 链上原生应用 (MetaApp) 的能力。集成了架构设计、代码生成与发布打包的全流程。

核心工作流 (Workflows)

1. 应用开发 (Development)

当用户指令涉及“创建 MetaApp”、“开发前端”、“增加功能”时，MetaBot 必须严格遵循 IDFramework 架构。

1.0 硬检查清单门禁 (生成前/交付前，强制执行)

为避免“生成产物看似可运行但不符合 MetaApp 规范”的问题，必须执行如下两阶段门禁。任一失败即停止，不得继续生成或交付。

• 生成前门禁 (pregen，强制)
  在仓库根目录执行：
  python3 metabot-create-metaapp/scripts/validate_metaapp_checklist.py --phase pregen --project ./<project_name>
  通过条件：目标目录位置合规、模板/基线文件完整、开发指南文件存在。

• 交付前门禁 (predeliver，强制)
  在仓库根目录执行：
  python3 metabot-create-metaapp/scripts/validate_metaapp_checklist.py --phase predeliver --project ./<project_name>
  通过条件：最小可运行文件集齐全、index.html 核心脚本与 id-connect-button 渲染存在、app.js 基础命令注册齐全、登录核心文件与 idframework/ 基线对齐、无上级运行依赖引用。

• 启动验收门禁 (smoke test，强制)
  在通过 predeliver 后，必须执行“可启动 + 控制台无报错”验收，未通过不得交付：

  1. 在仓库根目录启动本地服务：
     npx http-server . -a 127.0.0.1 -p 5602 -o /<project_name>/index.html -c-1
  2. 打开页面后执行首屏验证：页面能正常渲染、id-connect-button 显示正常、业务主组件可见。