@nac3/forge-cli 0.2.0-alpha.9 → 1.0.0

package/src/i18n/catalogs/zh.json

@@ -1,86 +1,223 @@
-{
-  "panel.brand": "Yujin Forge",
-  "panel.brand.kanji": "侑",
-  "panel.tagline": "语音优先开发助手",
-  "panel.input.placeholder": "向Yujin提问",
-  "panel.button.send": "发送",
-  "panel.button.mic": "讲话（按住）",
-  "panel.button.mic.recording": "按下以停止录音",
-  "panel.button.tts": "语音已开启",
-  "panel.button.keys": "密钥",
-  "panel.button.minimise": "缩小",
-  "panel.button.maximise": "最大化",
-  "panel.button.close": "关闭",
-  "panel.button.language": "语言",
-
-  "panel.trace.title": "操作记录",
-  "panel.trace.count.one": "{n}次工具调用",
-  "panel.trace.count.other": "{n}次工具调用",
-  "panel.trace.empty.kanji": "空",
-  "panel.trace.empty.body": "Yujin Forge会在此显示它为回答你而调用的每个工具：读取清单、搜索SPEC、编辑组件、读取文档。请提一个需要查阅这些的问题。",
-  "panel.trace.badge.tool": "工具",
-  "panel.trace.badge.voice": "语音",
-  "panel.trace.badge.error": "错误",
-
-  "panel.stream.empty.kanji": "侑仁",
-  "panel.stream.empty.body": "Yujin Forge 已上线。请求修改项目。",
-
-  "panel.status.no_audio": "未捕获音频。麦克风可能没有接收到任何内容。",
-  "panel.status.did_not_catch": "我没听清。请再试一次。",
-  "panel.status.mic_denied": "麦克风权限被拒绝或不可用：{error}",
-  "panel.status.voice_failed": "语音失败：{error}",
-  "panel.status.voice_reply_failed": "无法播放回复：{error}",
-  "panel.status.audio_play_error": "无法播放音频：{error}",
-  "panel.status.reading": "正在读取{filename}...",
-  "panel.status.ingest_failed": "导入失败：{error}",
-  "panel.status.read_failed": "无法读取规范：{error}",
-
-  "panel.drop.title": "在此处放置规范",
-  "panel.drop.hint": "PDF, DOCX, HTML, MD, RTF, EPUB, CSV, XLSX, TXT",
-
-  "panel.ingest.spec_attached": "已附加规范：{filename}，{kb} KB",
-  "panel.ingest.read_label": "已读取。",
-  "panel.ingest.title_label": "标题：{title}",
-  "panel.ingest.no_title": "（无标题）",
-  "panel.ingest.format_label": "格式：{format} / {sections}个章节 / {kb} KB",
-  "panel.ingest.first_lines": "开头几行：",
-  "panel.ingest.action_done": "操作{tool}已完成。",
-
-  "vault.modal.title": "凭据（保险库）",
-  "vault.modal.aria.close": "关闭凭据模态框",
-  "vault.tab.list": "已加载的插槽",
-  "vault.tab.add": "添加",
-  "vault.list.loading": "加载中...",
-  "vault.list.empty": "你还没有加载任何密钥。点击\"添加\"开始。",
-  "vault.add.slot_label": "插槽名称",
-  "vault.add.slot_hint": "小写字母、数字、下划线、连字符。必须以字母开头。",
-  "vault.add.value_label": "明文值（已掩码）",
-  "vault.add.value_hint": "仅在保存时显示一次。之后只能替换，无法再次读取。",
-  "vault.add.button_save": "保存",
-  "vault.add.button_cancel": "取消",
-  "vault.add.success": "已保存插槽{slot}。",
-  "vault.add.overwrite": "已覆盖插槽{slot}。",
-
-  "manual.intro": "Yujin Forge -- 用户手册",
-  "manual.section.welcome": "欢迎",
-  "manual.section.install": "安装",
-  "manual.section.first_run": "首次运行",
-  "manual.section.voice": "语音命令",
-  "manual.section.spec_ingest": "规范导入",
-  "manual.section.troubleshooting": "故障排除",
-  "manual.section.support": "支持",
-
-  "lang.name.es": "西班牙语",
-  "lang.name.en": "英语",
-  "lang.name.pt": "葡萄牙语",
-  "lang.name.fr": "法语",
-  "lang.name.ja": "日语",
-  "lang.name.zh": "中文",
-  "lang.name.hi": "印地语",
-  "lang.name.ar": "阿拉伯语",
-  "lang.name.de": "德语",
-  "lang.name.it": "意大利语",
-
-  "recap.fallback_period": "。",
-  "recap.empty": "暂时没有可以回顾的内容。"
-}
+{
+  "panel.brand": "Yujin Forge",
+  "panel.brand.kanji": "侑",
+  "panel.tagline": "语音优先开发助手",
+  "panel.input.placeholder": "向Yujin提问",
+  "panel.button.send": "发送",
+  "panel.button.mic": "讲话（按住）",
+  "panel.button.mic.recording": "按下以停止录音",
+  "panel.button.tts": "语音已开启",
+  "panel.button.keys": "密钥",
+  "panel.button.minimise": "缩小",
+  "panel.button.maximise": "最大化",
+  "panel.button.close": "关闭",
+  "panel.button.language": "语言",
+  "panel.trace.title": "操作记录",
+  "panel.trace.count.one": "{n}次工具调用",
+  "panel.trace.count.other": "{n}次工具调用",
+  "panel.trace.empty.kanji": "空",
+  "panel.trace.empty.body": "Yujin Forge会在此显示它为回答你而调用的每个工具：读取清单、搜索SPEC、编辑组件、读取文档。请提一个需要查阅这些的问题。",
+  "panel.trace.badge.tool": "工具",
+  "panel.trace.badge.voice": "语音",
+  "panel.trace.badge.error": "错误",
+  "panel.stream.empty.kanji": "侑仁",
+  "panel.stream.empty.body": "Yujin Forge 已上线。请求修改项目。",
+  "panel.status.no_audio": "未捕获音频。麦克风可能没有接收到任何内容。",
+  "panel.status.did_not_catch": "我没听清。请再试一次。",
+  "panel.status.mic_denied": "麦克风权限被拒绝或不可用：{error}",
+  "panel.status.voice_failed": "语音失败：{error}",
+  "panel.status.voice_reply_failed": "无法播放回复：{error}",
+  "panel.status.audio_play_error": "无法播放音频：{error}",
+  "panel.status.reading": "正在读取{filename}...",
+  "panel.status.ingest_failed": "导入失败：{error}",
+  "panel.status.read_failed": "无法读取规范：{error}",
+  "panel.drop.title": "在此处放置规范",
+  "panel.drop.hint": "PDF, DOCX, HTML, MD, RTF, EPUB, CSV, XLSX, TXT",
+  "panel.ingest.spec_attached": "已附加规范：{filename}，{kb} KB",
+  "panel.ingest.read_label": "已读取。",
+  "panel.ingest.title_label": "标题：{title}",
+  "panel.ingest.no_title": "（无标题）",
+  "panel.ingest.format_label": "格式：{format} / {sections}个章节 / {kb} KB",
+  "panel.ingest.first_lines": "开头几行：",
+  "panel.ingest.action_done": "操作{tool}已完成。",
+  "vault.modal.title": "凭据（保险库）",
+  "vault.modal.aria.close": "关闭凭据模态框",
+  "vault.tab.list": "已加载的插槽",
+  "vault.tab.add": "添加",
+  "vault.list.loading": "加载中...",
+  "vault.list.empty": "你还没有加载任何密钥。点击\"添加\"开始。",
+  "vault.add.slot_label": "插槽名称",
+  "vault.add.slot_hint": "小写字母、数字、下划线、连字符。必须以字母开头。",
+  "vault.add.value_label": "明文值（已掩码）",
+  "vault.add.value_hint": "仅在保存时显示一次。之后只能替换，无法再次读取。",
+  "vault.add.button_save": "保存",
+  "vault.add.button_cancel": "取消",
+  "vault.add.success": "已保存插槽{slot}。",
+  "vault.add.overwrite": "已覆盖插槽{slot}。",
+  "manual.intro": "Yujin Forge -- 用户手册",
+  "manual.section.welcome": "欢迎",
+  "manual.section.install": "安装",
+  "manual.section.first_run": "首次运行",
+  "manual.section.voice": "语音命令",
+  "manual.section.spec_ingest": "规范导入",
+  "manual.section.troubleshooting": "故障排除",
+  "manual.section.support": "支持",
+  "lang.name.es": "西班牙语",
+  "lang.name.en": "英语",
+  "lang.name.pt": "葡萄牙语",
+  "lang.name.fr": "法语",
+  "lang.name.ja": "日语",
+  "lang.name.zh": "中文",
+  "lang.name.hi": "印地语",
+  "lang.name.ar": "阿拉伯语",
+  "lang.name.de": "德语",
+  "lang.name.it": "意大利语",
+  "recap.fallback_period": "。",
+  "recap.empty": "暂时没有可以回顾的内容。",
+  "error_ui.severity.info": "信息",
+  "error_ui.severity.warning": "警告",
+  "error_ui.severity.error": "错误",
+  "error_ui.severity.fatal": "致命",
+  "error_ui.label.what": "发生了什么",
+  "error_ui.label.why": "原因",
+  "error_ui.label.fix": "如何解决",
+  "error_ui.label.cmd": "命令",
+  "error_ui.label.docs": "本地文档",
+  "error_ui.label.retry": "稍后重试",
+  "error_ui.copy_btn": "复制命令",
+  "error_ui.unknown.what": "Forge遇到内部错误(未知代码)。",
+  "error_ui.unknown.why": "代码 {code} 不在目录中。这是一个bug。",
+  "error_ui.unknown.fix": "请在 https://github.com/yujinapp/yujin-forge/issues 提交issue,附上代码和traceback。",
+  "error.cap_frontier_exhausted.what": "frontier层级(大模型)月度令牌上限已用完。",
+  "error.cap_frontier_exhausted.why": "您的方案 {plan} 在frontier上允许每月最多 {cap} 令牌。您已使用 {used}。下个UTC月初重置。",
+  "error.cap_frontier_exhausted.fix": "切换到直接的Anthropic BYOK: 绕过worker月度上限。您的成本将变为Anthropic直接收费。",
+  "error.cap_frontier_exhausted.cmd": "yf brain config --frontier-provider anthropic --frontier-model claude-opus-4-7",
+  "error.cap_eco_exhausted.what": "eco层级(小模型)月度令牌上限已用完。",
+  "error.cap_eco_exhausted.why": "您的方案 {plan} 在eco上允许每月最多 {cap} 令牌。您已使用 {used}。下个UTC月初重置。",
+  "error.cap_eco_exhausted.fix": "切换到直接BYOK或升级方案。BYOK绕过worker上限。",
+  "error.cap_eco_exhausted.cmd": "yf brain config --eco-provider google_ai --eco-model gemini-2.5-flash-lite",
+  "error.tier_not_in_plan.what": "您的方案未启用层级 {tier}。",
+  "error.tier_not_in_plan.why": "您的方案 {plan} 不包含 {tier} 层级。您可能在free-public或您的许可证已过期。",
+  "error.tier_not_in_plan.fix": "激活付费许可证,或切换到直接BYOK(您的成本,无worker上限)。",
+  "error.tier_not_in_plan.cmd": "yf license activate --key <jwt>",
+  "error.response_truncated.what": "模型响应在结束前被截断。",
+  "error.response_truncated.why": "managed_max_tokens_per_turn = {limit} 令牌限制在轮次中途达到。模型停止生成。",
+  "error.response_truncated.fix": "通过 yf limits 提高限制。下一轮生效,无需重启chat。",
+  "error.response_truncated.cmd": "yf limits set managed_max_tokens_per_turn 16384",
+  "error.response_truncated.banner": "[响应被 max_tokens={max} 截断。请提高限制: yf limits set managed_max_tokens_per_turn {suggested}]",
+  "error.modal_trace_stale.what": "审批模态框已过期或孤立。",
+  "error.modal_trace_stale.why": "trace_id {trace_id} 在dispatcher中没有待处理的审批。可能是invoke和panel状态之间的竞争条件,或之前的取消使trace成为僵尸。",
+  "error.modal_trace_stale.fix": "从chat重新调用verb: 启动一个干净的新trace。如果持续,运行 yf doctor 检查panel。",
+  "error.modal_trace_stale.cmd": "yf doctor",
+  "error.byok_key_missing.what": "缺少提供商 {provider} 的API密钥。",
+  "error.byok_key_missing.why": "您将 {provider} 配置为 {tier} 层级的提供商,但插槽 byok_{slot} 不在加密的Vault中。",
+  "error.byok_key_missing.fix": "使用 yf keys set 配置密钥(原子,mode 0600,从不记录日志)。",
+  "error.byok_key_missing.cmd": "yf keys set {slot}",
+  "error.worker_unreachable.what": "无法连接到yujin.app worker。",
+  "error.worker_unreachable.why": "网络超时或worker宕机 (HTTP {status})。已重试 {attempts} 次。",
+  "error.worker_unreachable.fix": "检查您的互联网。如果正常,临时切换到直接BYOK以避免worker依赖。",
+  "error.worker_unreachable.cmd": "yf brain config --frontier-provider anthropic",
+  "error.vault_decrypt_failed.what": "无法解密Vault中的密钥。",
+  "error.vault_decrypt_failed.why": "主密钥不正确或Vault文件已损坏。如果您在机器之间移动配置而没有迁移主密钥,或由于磁盘错误,可能会发生。",
+  "error.vault_decrypt_failed.fix": "如果您有服务器备份激活,拉取服务器副本(用您的本地主密钥重新加密)。",
+  "error.vault_decrypt_failed.cmd": "yf keys setup --pull",
+  "error.shell_exec_rejected.what": "您拒绝了 yujin.shell.exec 的R8模态框。",
+  "error.shell_exec_rejected.why": "命令 {command} 被分类为 {classification}。shell.exec 始终出于安全考虑请求审批,即使命令是只读的。",
+  "error.shell_exec_rejected.fix": "如果命令是只读的 (yf projects active, git status, ls),请使用等效的原生verb。如果是必要的而您错误地拒绝了,请重新调用。",
+  "error.project_not_registered.what": "没有注册的adopter项目。",
+  "error.project_not_registered.why": "调用的verb需要活动的project root,但 ~/.yujin-forge/projects.json 没有条目。",
+  "error.project_not_registered.fix": "用 yujin.project.init 创建一个或用 yf projects add 注册一个现有的。",
+  "error.project_not_registered.cmd": "yf projects scan",
+  "panel.button.agents": "智能体",
+  "panel.agents.title": "智能体",
+  "panel.agents.subtitle": "本项目已注册的总监和子智能体",
+  "panel.agents.empty.title": "尚无智能体",
+  "panel.agents.empty.body": "运行 `yf agent install --defaults` 来注册总监和4个子智能体（分析师、编码器、测试员、脚手架）。",
+  "panel.agents.legend.eco": "经济",
+  "panel.agents.legend.managed": "托管",
+  "panel.agents.legend.frontier": "前沿",
+  "panel.agents.status.disabled": "智能体运行时未启动",
+  "panel.agents.event.running": "运行中",
+  "panel.agents.event.idle": "空闲",
+  "panel.agents.tick.live": "已连接",
+  "panel.agents.tick.lost": "连接已断",
+  "workflow.phase.i": "分类与意图",
+  "workflow.phase.ii": "澄清（功能 + 4项NFR + 区块计划）",
+  "workflow.phase.iii": "规范（RFP + 架构 + 设计 + 审批）",
+  "workflow.phase.iv": "初始化",
+  "workflow.phase.v": "区块开发",
+  "workflow.phase.vi": "部署与发布后",
+  "wizard.title": "欢迎使用 Yujin Forge",
+  "wizard.close": "关闭",
+  "wizard.intro": "开始之前，请选择 Forge 如何连接到您的 AI 模型。稍后可在 Settings 中更改。",
+  "wizard.back": "返回",
+  "wizard.start": "开始",
+  "wizard.plan.badge": "推荐",
+  "wizard.plan.title": "Claude 套餐",
+  "wizard.plan.desc": "Claude 月度订阅。持续使用最经济的选项。Forge 使用您的 claude -p 会话。",
+  "wizard.plan.price": "固定月费 (套餐)",
+  "wizard.plan.step.title": "连接您的 Claude 套餐",
+  "wizard.plan.step.1": "打开新终端。",
+  "wizard.plan.step.2": "运行命令 claude (无参数) 并在浏览器中完成登录。",
+  "wizard.plan.step.3": "返回此处点击 已登录 进行验证。",
+  "wizard.plan.done": "已登录",
+  "wizard.byok.title": "Console API 密钥 (BYOK)",
+  "wizard.byok.desc": "您自己的 Anthropic Console 密钥。按用量付费。更灵活但成本浮动。",
+  "wizard.byok.price": "按用量付费 (Console)",
+  "wizard.byok.step.title": "粘贴您的 Anthropic API 密钥",
+  "wizard.byok.step.intro": "您的密钥以 sk-ant- 开头，在 console.anthropic.com 获取。Forge 将其加密存储在本地 Vault 中；永远不会离开您的机器。",
+  "wizard.byok.test": "验证并保存",
+  "wizard.skip.title": "我已配置好",
+  "wizard.skip.desc": "跳过向导。稍后可在 Settings 中重新打开。",
+  "wizard.done.kanji": "完",
+  "wizard.done.title": "完成",
+  "wizard.done.msg": "Forge 已配置。开始聊天吧。",
+  "pizarron.button.read": "朗读",
+  "pizarron.button.copy": "复制",
+  "pizarron.button.edit": "编辑",
+  "pizarron.graph.refresh": "刷新",
+  "pizarron.graph.regenerating": "重新生成中...",
+  "pizarron.graph.detail.hint": "点击节点查看详情。",
+  "pizarron.graph.detail.empty": "该节点没有详情。",
+  "pizarron.graph.detail.weight": "权重",
+  "startup.tab.graph": "可视化图",
+  "startup.tab.graphSem": "语义图",
+  "startup.tab.pendings": "待办",
+  "startup.tab.workflow": "工作流",
+  "settings.startupTabs": "启动时的标签页（图、待办、工作流）",
+  "graph.term.nodes": "节点",
+  "graph.term.edges": "边",
+  "coding.read": "正在读取 {x}",
+  "coding.read_bare": "正在读取文件",
+  "coding.edit": "正在编辑 {x}",
+  "coding.edit_bare": "正在编辑文件",
+  "coding.write": "正在写入 {x}",
+  "coding.write_bare": "正在写入文件",
+  "coding.notebook_bare": "正在编辑笔记本",
+  "coding.bash": "正在执行: {x}",
+  "coding.bash_bare": "正在执行命令",
+  "coding.grep": "正在搜索 \"{x}\"",
+  "coding.grep_bare": "正在搜索代码",
+  "coding.glob": "正在列出 {x}",
+  "coding.glob_bare": "正在列出文件",
+  "coding.web_bare": "正在读取网页",
+  "coding.websearch": "网页搜索: {x}",
+  "coding.websearch_bare": "正在搜索网页",
+  "coding.task": "子代理: {x}",
+  "coding.task_bare": "正在启动子代理",
+  "coding.todo": "正在更新任务列表",
+  "coding.verb_bare": "正在执行 yujin 动作",
+  "panel.button.stop": "停止",
+  "panel.status.stopping": "正在停止...",
+  "panel.status.noActiveTurn": "没有正在进行的回合。",
+  "panel.status.interruptFailed": "无法发送中断。",
+  "panel.status.turnInterrupted": "回合已中断。",
+  "panel.label.interrupted": "（已中断）",
+  "panel.queue.label": "队列中",
+  "panel.queue.remove": "从队列中移除",
+  "panel.project.switchHint": "切换项目",
+  "panel.project.title": "项目",
+  "panel.project.add": "添加项目...",
+  "panel.project.addPrompt": "要添加的项目的绝对路径：",
+  "panel.project.switching": "正在切换项目..."
+}

package/templates/nextjs-app/README.md

@@ -0,0 +1,48 @@
+# %%PROJECT_NAME%%
+
+A Yujin Forge **Next.js (App Router)** starter, NAC-3 conformant by construction.
+
+## Stack
+
+- **Next.js 15** with the App Router (`src/app/`).
+- **React 18** + TypeScript 5.
+- **@yujin/nac 2.3.x** -- NAC-3 runtime + manifest types.
+- **Vitest** for unit tests, **Playwright** for e2e.
+
+## Why Next.js (vs the react-app starter)
+
+Pick this starter when you need:
+- Server-side rendering / streaming for SEO or fast first paint.
+- Route-level code splitting + edge runtime.
+- Built-in API routes (no separate backend yet).
+- File-based routing (App Router conventions).
+
+If you just want a SPA, the `react-app` template is leaner (Vite,
+no server runtime, fastest dev).
+
+## Quick start
+
+```bash
+npm install
+npm run dev          # http://localhost:3000
+```
+
+## Tests
+
+```bash
+npm run test            # Vitest unit tests
+npm run test:e2e        # Playwright e2e (requires `npx playwright install` once)
+npm run typecheck       # TypeScript strict mode
+npm run lint            # next lint (eslint-config-next)
+```
+
+## Yujin Forge integration
+
+Open the project in `yf chat` to drive development via voice + chat:
+
+```bash
+yf chat
+```
+
+The chat panel reads `src/nac/manifest.ts` and exposes each
+manifest element as a tool the AI can invoke.

package/templates/nextjs-app/next.config.js

@@ -0,0 +1,8 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  /* NAC-3 attributes are non-standard data-* attributes; React 18+
+   * passes them through unchanged. No config needed. */
+};
+
+module.exports = nextConfig;

package/templates/nextjs-app/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "%%PROJECT_SLUG%%",
+  "version": "0.1.0",
+  "private": true,
+  "description": "%%PROJECT_NAME%% -- Yujin Forge Next.js app (App Router), NAC-3 conformant by construction.",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "lint": "next lint",
+    "typecheck": "tsc --noEmit",
+    "yf": "yf"
+  },
+  "dependencies": {
+    "next": "15.0.4",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "@yujin/nac": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.10.2",
+    "@types/react": "18.3.18",
+    "@types/react-dom": "18.3.5",
+    "@playwright/test": "1.49.1",
+    "eslint": "9.17.0",
+    "eslint-config-next": "15.0.4",
+    "typescript": "5.7.2",
+    "vitest": "2.1.8"
+  }
+}

package/templates/nextjs-app/src/app/globals.css

@@ -0,0 +1,43 @@
+:root {
+  --bg:           #fafafa;
+  --fg:           #1a1a1a;
+  --accent:       #c0392b;
+  --border:       #e0e0e0;
+}
+
+* { box-sizing: border-box; }
+
+body {
+  margin: 0;
+  padding: 2rem;
+  font-family: ui-sans-serif, system-ui, -apple-system, sans-serif;
+  background: var(--bg);
+  color: var(--fg);
+}
+
+main {
+  max-width: 32rem;
+  margin: 0 auto;
+}
+
+h1 { font-weight: 500; margin-bottom: 1rem; }
+
+input {
+  width: 70%;
+  padding: 0.5rem 0.75rem;
+  border: 1px solid var(--border);
+  border-radius: 0.25rem;
+  margin-right: 0.5rem;
+}
+
+button {
+  padding: 0.5rem 1rem;
+  background: var(--accent);
+  color: white;
+  border: none;
+  border-radius: 0.25rem;
+  cursor: pointer;
+}
+
+ul { list-style: none; padding: 0; margin: 1.5rem 0 0; }
+li { padding: 0.5rem; border-bottom: 1px solid var(--border); }

package/templates/nextjs-app/src/app/layout.tsx

@@ -0,0 +1,29 @@
+/**
+ * Root layout for the App Router. Every route renders inside
+ * the <html> + <body> here, so this is where Yujin Pilot would
+ * inject its panel + NAC-3 runtime in a real project.
+ */
+import type { Metadata, Viewport } from 'next';
+import './globals.css';
+
+export const metadata: Metadata = {
+  title:       '%%PROJECT_NAME%%',
+  description: 'Built with Yujin Forge -- NAC-3 by construction.',
+};
+
+export const viewport: Viewport = {
+  width:        'device-width',
+  initialScale: 1,
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="es" data-nac-app="%%PROJECT_SLUG%%">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/nextjs-app/src/app/page.tsx

@@ -0,0 +1,63 @@
+'use client';
+/**
+ * Home page -- a single-input todo list, decorated with NAC-3 attrs
+ * so the chat panel can drive it ("add task X", "mark task 1 done").
+ *
+ * Same shape as the react-app template's App.tsx, ported to the
+ * Next.js App Router. Client component because we use useState.
+ */
+import { useState } from 'react';
+
+interface Todo { id: number; text: string; done: boolean }
+
+export default function Home() {
+  const [todos, setTodos] = useState<Todo[]>([]);
+  const [draft, setDraft] = useState('');
+
+  function addTodo(): void {
+    const text = draft.trim();
+    if (!text) return;
+    setTodos((cur) => [...cur, { id: Date.now(), text, done: false }]);
+    setDraft('');
+  }
+
+  function toggleTodo(id: number): void {
+    setTodos((cur) => cur.map((t) =>
+      t.id === id ? { ...t, done: !t.done } : t,
+    ));
+  }
+
+  return (
+    <main data-nac-id="todos.app">
+      <h1>%%PROJECT_NAME%%</h1>
+      <input
+        type="text"
+        value={draft}
+        onChange={(e) => setDraft(e.target.value)}
+        onKeyDown={(e) => { if (e.key === 'Enter') addTodo(); }}
+        data-nac-id="todos.input"
+        data-nac-role="field"
+        data-nac-action="input"
+        placeholder="New task..."
+      />
+      <button
+        onClick={addTodo}
+        data-nac-id="todos.add_button"
+        data-nac-role="action"
+        data-nac-action="add_todo"
+      >Add</button>
+      <ul data-nac-id="todos.list" data-nac-role="list">
+        {todos.map((t) => (
+          <li
+            key={t.id}
+            data-nac-id={'todos.item.' + t.id}
+            data-nac-role="item"
+            data-nac-state={t.done ? 'done' : 'pending'}
+            onClick={() => toggleTodo(t.id)}
+            style={{ textDecoration: t.done ? 'line-through' : 'none', cursor: 'pointer' }}
+          >{t.text}</li>
+        ))}
+      </ul>
+    </main>
+  );
+}

package/templates/nextjs-app/src/nac/manifest.ts

@@ -0,0 +1,36 @@
+/**
+ * NAC-3 manifest for the todos plugin. Same shape as the
+ * react-app template; the runtime reads this on boot and
+ * exposes each verb to agents + the chat panel.
+ *
+ * label_i18n covers the 10 NAC default locales.
+ */
+import type { Manifest } from '@yujin/nac';
+
+export const TODOS_MANIFEST: Manifest = {
+  plugin: 'todos',
+  version: '1.0.0',
+  elements: [
+    {
+      nac_id: 'todos.input',
+      role:   'field',
+      kind:   'text',
+      label_i18n: {
+        es: 'Nueva tarea',     en: 'New task',     pt: 'Nova tarefa',
+        fr: 'Nouvelle tache',  de: 'Neue Aufgabe', it: 'Nuovo compito',
+        ja: 'New task',        zh: 'New task',     hi: 'New task',
+        ar: 'New task',
+      },
+    },
+    {
+      nac_id: 'todos.add_button',
+      role:   'action',
+      verb:   'add_todo',
+      label_i18n: {
+        es: 'Agregar', en: 'Add',     pt: 'Adicionar',  fr: 'Ajouter',
+        de: 'Add',     it: 'Add',     ja: 'Add',        zh: 'Add',
+        hi: 'Add',     ar: 'Add',
+      },
+    },
+  ],
+};

package/templates/nextjs-app/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "jsx": "preserve",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "allowJs": true,
+    "incremental": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./src/*"] }
+  },
+  "include": ["next-env.d.ts", "src/**/*.ts", "src/**/*.tsx"],
+  "exclude": ["node_modules", ".next"]
+}

package/templates/nextjs-app/yujin.forge.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://yujin.app/schemas/yujin.forge.json",
+  "project_slug": "%%PROJECT_SLUG%%",
+  "project_name": "%%PROJECT_NAME%%",
+  "forge_version": "0.1.0",
+  "nac_version":   "2.3.x",
+  "license_ref":   "%%LICENSE_REF%%",
+  "framework":     "nextjs",
+  "telemetry": { "opt_out": false },
+  "generate":  { "tests": true, "mocks": true }
+}