Solana x Agents x Workflow Contracts
用 Agent 真正能理解的方式构建 Solana 项目。
Geppetto 把 new、init、test、audit、deploy 变成稳定的工作流契约，让开发者和 AI Agent 都能可靠执行。
# 一个 repo-local 工作流契约
bun ./bin/geppetto-cli.ts deploy --output json --write-back
{
"status": "success",
"cluster": "devnet",
"program_id": "...",
"steps": ["buildProgram", "deployProgram"]
}不只是部署工具，而是工作流契约。
很多 Solana 项目的关键流程藏在 shell history、本地状态和过期笔记里。Geppetto 让 repo 本身更清晰：配置、示例、检查、输出和 agent 指令都能对齐。
Repo
Agent 可读的结构
统一的 agent 入口文件、示例和知识模块，让 Agent 知道真相源在哪里。
CLI
可执行的工程原语
new、init、test、audit、deploy 提供稳定命令面。
Artifacts
结构化输出
部署结果会写成机器可读 artifact，方便人和 Agent 从同一状态继续工作。
工作流表面
Deploy 是第一个产品化路径，但 Geppetto 的产品形态更大：面向 Agent 的 Solana 工程工作流。
geppetto new
创建最小 Pinocchio + Geppetto 项目骨架，并带上 canonical agent guidance。
geppetto init
给已有项目补齐 agent 入口文件，让 repo 更容易被继续维护。
geppetto test
通过稳定命令契约运行约定好的验证面。
geppetto audit
运行格式、编译和可选 clippy 门禁，作为基础 review surface。
geppetto deploy
构建、部署、输出 artifact，并可把 program_id 写回配置。
下一步：Review 报告
把 audit 从静态门禁扩展成结构化 PR finding 和 anti-pattern 检查。
现在已经可用
当前仓库已经包含 CLI、SDK 知识面、deploy pipeline、mock E2E、release checks，以及 Cloudflare-ready 的多语言站点。