@agent-native/core 0.91.1 → 0.92.0

package/corpus/core/src/templates/default/app/i18n/fr-FR.ts

@@ -43,6 +43,8 @@ const messages = {
       destinations: "Destinations",
       identities: "Identities",
       approvals: "Approbations",
+      automations: "Automatisations",
+      delivery: "Livraison",
       audit: "Audit",
       dreams: "Dreams",
       threadDebug: "Débogage du fil de discussion",
@@ -161,6 +163,22 @@ const messages = {
       activeUsers: "Utilisateurs actifs",
       workspaceAppsStat: "Applications d'espace de travail",
       chatThreads: "Fils de discussion",
+      also: "Aussi",
+      workspaceShortcutsAria: "Raccourcis de l’espace de travail",
+      deliveryQueue: "File de livraison",
+      failedLastHour: "{{count}} échecs au cours de la dernière heure",
+      processingCount: "{{count}} en cours",
+      queued: "En file",
+      active: "Actif",
+      done1h: "Terminé 1 h",
+      failed1h: "Échoué 1 h",
+      oldestQueued: "Plus ancien en file : {{age}}",
+      queueAgeNone: "aucun",
+      queueFailureHint:
+        "Vérifiez les identifiants, les destinations et les erreurs récentes de la file.",
+      unknownPlatform: "inconnu",
+      attemptsCount: "{{count}} tentatives",
+      noErrorMessage: "(aucun message d’erreur)",
     },
   },
   agentPanel: {
@@ -342,6 +360,9 @@ const messages = {
     contactSidebarWidget: "Widget de la barre latérale des contacts",
     contactSidebarDescription:
       "Apparaît à côté de la conversation en cours avec le contexte du contact et du fil de discussion.",
+    eventDetailWidget: "Widget de détail d'événement",
+    eventDetailDescription:
+      "Apparaît sous l'événement de calendrier ouvert avec le contexte de l'événement et des participants.",
     addWidgetHere: "Ajouter un widget ici",
     back: "Retour",
     editExtension: "Modifier l'extension",

package/corpus/core/src/templates/default/app/i18n/hi-IN.ts

@@ -41,6 +41,8 @@ const messages = {
       destinations: "Destinations",
       identities: "Identities",
       approvals: "स्वीकृतियाँ",
+      automations: "ऑटोमेशन",
+      delivery: "डिलीवरी",
       audit: "Audit",
       dreams: "Dreams",
       threadDebug: "थ्रेड डिबग",
@@ -152,6 +154,21 @@ const messages = {
       activeUsers: "सक्रिय उपयोगकर्ता",
       workspaceAppsStat: "कार्यक्षेत्र ऐप्स",
       chatThreads: "चैट सूत्र",
+      also: "और भी",
+      workspaceShortcutsAria: "कार्यस्थान शॉर्टकट",
+      deliveryQueue: "डिलीवरी कतार",
+      failedLastHour: "पिछले घंटे में {{count}} विफल",
+      processingCount: "{{count}} प्रोसेस हो रहे हैं",
+      queued: "कतार में",
+      active: "सक्रिय",
+      done1h: "पूर्ण 1घं",
+      failed1h: "विफल 1घं",
+      oldestQueued: "सबसे पुराना कतार में: {{age}}",
+      queueAgeNone: "कोई नहीं",
+      queueFailureHint: "क्रेडेंशियल, गंतव्य और हाल की कतार त्रुटियाँ जाँचें।",
+      unknownPlatform: "अज्ञात",
+      attemptsCount: "{{count}} प्रयास",
+      noErrorMessage: "(कोई त्रुटि संदेश नहीं)",
     },
   },
   agentPanel: {
@@ -327,6 +344,9 @@ const messages = {
     contactSidebarWidget: "साइडबार विजेट से संपर्क करें",
     contactSidebarDescription:
       "संपर्क और थ्रेड संदर्भ के साथ वर्तमान वार्तालाप के बगल में दिखाई देता है।",
+    eventDetailWidget: "इवेंट विवरण विजेट",
+    eventDetailDescription:
+      "खुले कैलेंडर इवेंट के नीचे इवेंट और उपस्थित लोगों के संदर्भ के साथ दिखाई देता है।",
     addWidgetHere: "यहां विजेट जोड़ें",
     back: "वापस",
     editExtension: "एक्सटेंशन संपादित करें",

package/corpus/core/src/templates/default/app/i18n/ja-JP.ts

@@ -43,6 +43,8 @@ const messages = {
       destinations: "Destinations",
       identities: "Identities",
       approvals: "承認",
+      automations: "自動化",
+      delivery: "配信",
       audit: "Audit",
       dreams: "Dreams",
       threadDebug: "スレッドのデバッグ",
@@ -157,6 +159,22 @@ const messages = {
       activeUsers: "アクティブユーザー",
       workspaceAppsStat: "ワークスペースアプリ",
       chatThreads: "チャットスレッド",
+      also: "その他",
+      workspaceShortcutsAria: "ワークスペースのショートカット",
+      deliveryQueue: "配信キュー",
+      failedLastHour: "過去 1 時間で {{count}} 件失敗",
+      processingCount: "{{count}} 件処理中",
+      queued: "待機中",
+      active: "実行中",
+      done1h: "完了 1h",
+      failed1h: "失敗 1h",
+      oldestQueued: "最古の待機: {{age}}",
+      queueAgeNone: "なし",
+      queueFailureHint:
+        "認証情報、送信先、最近のキューエラーを確認してください。",
+      unknownPlatform: "不明",
+      attemptsCount: "{{count}} 回試行",
+      noErrorMessage: "（エラーメッセージなし）",
     },
   },
   agentPanel: {
@@ -332,6 +350,9 @@ const messages = {
     contactSidebarWidget: "連絡先サイドバー ウィジェット",
     contactSidebarDescription:
       "現在の会話の横に連絡先とスレッドのコンテキストが表示されます。",
+    eventDetailWidget: "予定詳細ウィジェット",
+    eventDetailDescription:
+      "開いているカレンダー予定の下に、予定と出席者のコンテキストとともに表示されます。",
     addWidgetHere: "ここにウィジェットを追加",
     back: "戻る",
     editExtension: "拡張子の編集",

package/corpus/core/src/templates/default/app/i18n/ko-KR.ts

@@ -42,6 +42,8 @@ const messages = {
       destinations: "Destinations",
       identities: "Identities",
       approvals: "승인",
+      automations: "자동화",
+      delivery: "전달",
       audit: "Audit",
       dreams: "Dreams",
       threadDebug: "스레드 디버그",
@@ -154,6 +156,21 @@ const messages = {
       activeUsers: "활성 사용자",
       workspaceAppsStat: "작업 공간 앱",
       chatThreads: "채팅 스레드",
+      also: "또한",
+      workspaceShortcutsAria: "워크스페이스 바로가기",
+      deliveryQueue: "전달 대기열",
+      failedLastHour: "지난 1시간 동안 {{count}}건 실패",
+      processingCount: "{{count}}건 처리 중",
+      queued: "대기 중",
+      active: "진행 중",
+      done1h: "완료 1시간",
+      failed1h: "실패 1시간",
+      oldestQueued: "가장 오래된 대기: {{age}}",
+      queueAgeNone: "없음",
+      queueFailureHint: "자격 증명, 대상, 최근 대기열 오류를 확인하세요.",
+      unknownPlatform: "알 수 없음",
+      attemptsCount: "{{count}}회 시도",
+      noErrorMessage: "(오류 메시지 없음)",
     },
   },
   agentPanel: {
@@ -326,6 +343,9 @@ const messages = {
     contactSidebarWidget: "연락처 사이드바 위젯",
     contactSidebarDescription:
       "연락처 및 스레드 컨텍스트가 포함된 현재 대화 옆에 표시됩니다.",
+    eventDetailWidget: "일정 상세 위젯",
+    eventDetailDescription:
+      "열린 캘린더 일정 아래에 일정 및 참석자 컨텍스트와 함께 표시됩니다.",
     addWidgetHere: "여기에 위젯 추가",
     back: "뒤로",
     editExtension: "확장 편집",

package/corpus/core/src/templates/default/app/i18n/pt-BR.ts

@@ -43,6 +43,8 @@ const messages = {
       destinations: "Destinations",
       identities: "Identities",
       approvals: "Aprovações",
+      automations: "Automações",
+      delivery: "Entrega",
       audit: "Audit",
       dreams: "Dreams",
       threadDebug: "Depuração de thread",
@@ -161,6 +163,22 @@ const messages = {
       activeUsers: "Usuários ativos",
       workspaceAppsStat: "Aplicativos de espaço de trabalho",
       chatThreads: "Tópicos de bate-papo",
+      also: "Também",
+      workspaceShortcutsAria: "Atalhos do espaço de trabalho",
+      deliveryQueue: "Fila de entrega",
+      failedLastHour: "{{count}} falhas na última hora",
+      processingCount: "{{count}} em processamento",
+      queued: "Na fila",
+      active: "Ativo",
+      done1h: "Concluído 1 h",
+      failed1h: "Falhou 1 h",
+      oldestQueued: "Mais antigo na fila: {{age}}",
+      queueAgeNone: "nenhum",
+      queueFailureHint:
+        "Verifique credenciais, destinos e erros recentes da fila.",
+      unknownPlatform: "desconhecido",
+      attemptsCount: "{{count}} tentativas",
+      noErrorMessage: "(sem mensagem de erro)",
     },
   },
   agentPanel: {
@@ -341,6 +359,9 @@ const messages = {
     contactSidebarWidget: "Widget da barra lateral de contato",
     contactSidebarDescription:
       "Aparece ao lado da conversa atual com o contexto do contato e do tópico.",
+    eventDetailWidget: "Widget de detalhes do evento",
+    eventDetailDescription:
+      "Aparece abaixo do evento aberto do calendário com o contexto do evento e dos participantes.",
     addWidgetHere: "Adicione widget aqui",
     back: "Voltar",
     editExtension: "Editar extensão",

package/corpus/core/src/templates/default/app/i18n/zh-CN.ts

@@ -41,6 +41,8 @@ const messages = {
       destinations: "Destinations",
       identities: "Identities",
       approvals: "批准",
+      automations: "自动化",
+      delivery: "投递",
       audit: "Audit",
       dreams: "Dreams",
       threadDebug: "线程调试",
@@ -150,6 +152,21 @@ const messages = {
       activeUsers: "活跃用户",
       workspaceAppsStat: "工作区应用程序",
       chatThreads: "聊天话题",
+      also: "还有",
+      workspaceShortcutsAria: "工作区快捷入口",
+      deliveryQueue: "投递队列",
+      failedLastHour: "过去一小时失败 {{count}} 次",
+      processingCount: "{{count}} 个处理中",
+      queued: "排队中",
+      active: "进行中",
+      done1h: "完成 1 小时",
+      failed1h: "失败 1 小时",
+      oldestQueued: "最早排队：{{age}}",
+      queueAgeNone: "无",
+      queueFailureHint: "请检查凭据、目的地和最近的队列错误。",
+      unknownPlatform: "未知",
+      attemptsCount: "{{count}} 次尝试",
+      noErrorMessage: "（无错误消息）",
     },
   },
   agentPanel: {
@@ -316,6 +333,9 @@ const messages = {
     buildNewWidget: "构建一个新的小部件",
     contactSidebarWidget: "联系侧边栏小部件",
     contactSidebarDescription: "显示在当前对话旁边，包含联系人和线程上下文。",
+    eventDetailWidget: "活动详情小部件",
+    eventDetailDescription:
+      "显示在打开的日历活动下方，包含活动和与会者上下文。",
     addWidgetHere: "在这里添加小部件",
     back: "返回",
     editExtension: "编辑扩展名",

package/corpus/core/src/templates/default/app/i18n/zh-TW.ts

@@ -41,6 +41,8 @@ const messages = {
       destinations: "Destinations",
       identities: "Identities",
       approvals: "核准",
+      automations: "自動化",
+      delivery: "投遞",
       audit: "Audit",
       dreams: "Dreams",
       threadDebug: "對話串偵錯",
@@ -148,6 +150,21 @@ const messages = {
       activeUsers: "活躍使用者",
       workspaceAppsStat: "工作區應用程式",
       chatThreads: "聊天話題",
+      also: "還有",
+      workspaceShortcutsAria: "工作區快捷入口",
+      deliveryQueue: "投遞佇列",
+      failedLastHour: "過去一小時失敗 {{count}} 次",
+      processingCount: "{{count}} 個處理中",
+      queued: "排隊中",
+      active: "進行中",
+      done1h: "完成 1 小時",
+      failed1h: "失敗 1 小時",
+      oldestQueued: "最早排隊：{{age}}",
+      queueAgeNone: "無",
+      queueFailureHint: "請檢查憑證、目的地和最近的佇列錯誤。",
+      unknownPlatform: "未知",
+      attemptsCount: "{{count}} 次嘗試",
+      noErrorMessage: "（無錯誤訊息）",
     },
   },
   agentPanel: {
@@ -316,6 +333,8 @@ const messages = {
     buildNewWidget: "建置一個新的小工具",
     contactSidebarWidget: "聯絡側邊欄小工具",
     contactSidebarDescription: "顯示在目前對話旁邊，包含聯絡人和對話串脈絡。",
+    eventDetailWidget: "活動詳情小工具",
+    eventDetailDescription: "顯示在開啟的日曆活動下方，包含活動與出席者脈絡。",
     addWidgetHere: "在這裡新增小工具",
     back: "返回",
     editExtension: "編輯擴充功能名",

package/corpus/core/src/templates/default/package.json

@@ -9,7 +9,8 @@
     "typecheck": "agent-native typecheck",
     "action": "agent-native action",
     "script": "agent-native script",
-    "skills:update": "agent-native skills update scaffold --project"
+    "skills:update": "agent-native skills update scaffold --project",
+    "upgrade:agent-native": "agent-native upgrade"
   },
   "dependencies": {
     "@agent-native/core": "latest",
@@ -31,7 +32,6 @@
     "@types/node": "^24.2.1",
     "@types/react": "catalog:",
     "@types/react-dom": "catalog:",
-    "@typescript/native-preview": "catalog:",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "next-themes": "^0.4.6",
@@ -43,7 +43,8 @@
     "tailwind-merge": "^3.5.0",
     "tailwindcss": "^4.1.18",
     "tsx": "^4.20.3",
-    "typescript": "^6.0.3",
+    "typescript": "catalog:",
+    "typescript-7": "catalog:",
     "vite": "^8.0.0"
   }
 }

package/corpus/core/src/templates/headless/.agents/skills/upgrade-agent-native/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: upgrade-agent-native
+description: >-
+  Bring an older Agent Native app or workspace current. Use when updating
+  @agent-native/core, fixing a broken upgrade, or when tempted to patch or
+  override core/dispatch packages to make an old branch run.
+scope: dev
+metadata:
+  internal: true
+---
+
+# Upgrade Agent Native
+
+## Rule
+
+When an older Agent Native app/branch needs to run on current packages, use
+`agent-native upgrade`. Never "fix" upgrade breakage with
+`pnpm.overrides`, `patchedDependencies`, `resolutions`, local patches, or
+edits under `node_modules/@agent-native/*` — especially not against
+`@agent-native/core` or `@agent-native/dispatch`.
+
+## Why
+
+Agents often respond to a failed core bump by inventing framework patches and
+dispatch behavior overrides. That hides the real app-level break, drifts from
+upstream, and makes the next upgrade worse. The supported path is bump →
+install → refresh scaffold skills → verify, then fix **app** code only.
+
+## How
+
+1. **Doctor first (optional but recommended)**
+
+   ```bash
+   npx @agent-native/core@latest upgrade check
+   ```
+
+   This reports framework overrides/patches and pending `@agent-native/*`
+   bumps. If overrides/patches are present, remove them before continuing.
+
+2. **Run the upgrade**
+
+   ```bash
+   npx @agent-native/core@latest upgrade
+   ```
+
+   Or from an already-installed CLI: `pnpm exec agent-native upgrade` /
+   `agent-native upgrade`.
+
+   What it does:
+
+   - Blocks (unless `--force`) when `@agent-native/*` overrides/patches exist
+   - Rewrites non-local `@agent-native/*` dependency pins to `latest`
+   - Runs the package manager install
+   - Runs `skills update scaffold --project`
+   - Runs `typecheck` when the project has that script
+
+3. **If upgrade or typecheck fails**
+
+   - Read the concrete error
+   - Fix **app** source, actions, config, or env — not framework packages
+   - Re-run `agent-native upgrade` or `pnpm typecheck`
+   - Stop and ask the user if you cannot fix the app-level error
+
+4. **Dry-run / partial runs**
+
+   ```bash
+   agent-native upgrade --dry-run
+   agent-native upgrade --skip-verify
+   agent-native upgrade --skip-install   # package.json bumps only
+   ```
+
+## Don't
+
+- Don't add `pnpm.overrides`, `overrides`, `resolutions`, or
+  `patchedDependencies` for any `@agent-native/*` package
+- Don't edit `node_modules/@agent-native/core` or
+  `node_modules/@agent-native/dispatch`
+- Don't invent local "dispatch behavior" shims to paper over version skew
+- Don't keep iterating with more framework patches after a failed install
+- Don't skip `skills update scaffold --project` after a core bump (the
+  upgrade command does this for you)
+
+## Related Skills
+
+- **self-modifying-code** — Tier 4: framework packages are off limits
+- **agent-native-docs** — version-matched docs after the bump
+- **portability** — keep app code provider-agnostic across upgrades

package/corpus/core/src/templates/headless/AGENTS.md

@@ -38,9 +38,15 @@ first-party template patterns ships in `node_modules/@agent-native/core/corpus`.
 Read these local package docs before implementing advanced Agent Native
 features. Prefer this app's own `AGENTS.md` for app-specific rules, then use
 the corpus for reusable framework/template patterns.
-After updating `@agent-native/core`, run `pnpm skills:update` or
-`npx @agent-native/core@latest skills update scaffold --project` from the app
-root to refresh framework-provided `.agents/skills` and repair `CLAUDE.md` /
+To bring an older app current, run `pnpm upgrade:agent-native` or
+`npx @agent-native/core@latest upgrade` from the app root. That bumps
+`@agent-native/*` deps, installs, refreshes scaffold skills, and typechecks.
+Do **not** add `pnpm.overrides` / patches against `@agent-native/*` or edit
+`node_modules/@agent-native/*` when an upgrade fails — fix app code or ask.
+See the `upgrade-agent-native` and `self-modifying-code` skills.
+After a manual core bump only, `pnpm skills:update` (or
+`npx @agent-native/core@latest skills update scaffold --project`) still
+refreshes framework-provided `.agents/skills` and repairs `CLAUDE.md` /
 `.claude/skills` compatibility links.
 
 ## Actions

package/corpus/core/src/templates/headless/package.json

@@ -7,7 +7,8 @@
     "agent": "agent-native agent",
     "script": "agent-native script",
     "skills:update": "agent-native skills update scaffold --project",
-    "typecheck": "tsgo --noEmit"
+    "upgrade:agent-native": "agent-native upgrade",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@agent-native/core": "latest",
@@ -16,9 +17,9 @@
   },
   "devDependencies": {
     "@types/node": "^24.2.1",
-    "@typescript/native-preview": "catalog:",
     "oxfmt": "catalog:",
     "tsx": "^4.20.3",
-    "typescript": "^6.0.3"
+    "typescript": "catalog:",
+    "typescript-7": "catalog:"
   }
 }

package/corpus/core/src/templates/workspace-core/.agents/skills/self-modifying-code/SKILL.md

@@ -28,7 +28,19 @@ Not all modifications are equal. Use this to decide what level of care is needed
 | 1: Data       | Files in `data/`      | JSON state, generated content, markdown          | Nothing — these are routine       |
 | 2: Source     | App code              | Components, routes, styles, scripts              | Run `pnpm typecheck && pnpm lint` |
 | 3: Config     | Project config        | `package.json`, `tsconfig.json`, `vite.config.*` | Ask for explicit approval first   |
-| 4: Off limits | Secrets and framework | `.env`, `@agent-native/core` internals           | Never modify these                |
+| 4: Off limits | Secrets and framework | `.env`, `@agent-native/*` packages & overrides   | Never modify these                |
+
+Tier 4 includes **all** of the following — not only editing package source:
+
+- Files under `node_modules/@agent-native/*` (core, dispatch, scheduling, …)
+- `pnpm.overrides`, `overrides`, `resolutions`, or `patchedDependencies` that
+  target any `@agent-native/*` package
+- Local patches, vendored copies, or invented "dispatch/core behavior"
+  shims meant to paper over a version skew or failed upgrade
+
+When an older branch needs current packages, use **`agent-native upgrade`**
+(see the `upgrade-agent-native` skill). If upgrade or typecheck fails, fix
+**app** code or stop and ask — do not patch the framework.
 
 ## Git Checkpoint Pattern
 
@@ -74,13 +86,19 @@ inline strings in components.
 ## Don't
 
 - Don't modify `.env` files or files containing secrets
-- Don't modify `@agent-native/core` package internals
+- Don't modify `@agent-native/core`, `@agent-native/dispatch`, or other
+  `@agent-native/*` package internals (including under `node_modules`)
+- Don't add `pnpm.overrides` / `patchedDependencies` / `resolutions` for
+  `@agent-native/*` to "make the app run" after a version bump
+- Don't invent local dispatch/core behavior overrides when upgrade fails —
+  run `npx @agent-native/core@latest upgrade`, then fix app-level errors only
 - Don't modify `.agents/skills/` or `AGENTS.md` unless explicitly requested
 - Don't skip the typecheck/lint step after editing source code
 - Don't make source changes without a git checkpoint to roll back to
 
 ## Related Skills
 
+- **upgrade-agent-native** — supported path to bring an older app/workspace current
 - **storing-data** — Tier 1 modifications (data files) are the safest and most common
 - **actions** — The agent can create or modify actions to add new capabilities
 - **delegate-to-agent** — Self-modification requests come through the agent chat

package/corpus/core/src/templates/workspace-core/.agents/skills/upgrade-agent-native/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: upgrade-agent-native
+description: >-
+  Bring an older Agent Native app or workspace current. Use when updating
+  @agent-native/core, fixing a broken upgrade, or when tempted to patch or
+  override core/dispatch packages to make an old branch run.
+scope: dev
+metadata:
+  internal: true
+---
+
+# Upgrade Agent Native
+
+## Rule
+
+When an older Agent Native app/branch needs to run on current packages, use
+`agent-native upgrade`. Never "fix" upgrade breakage with
+`pnpm.overrides`, `patchedDependencies`, `resolutions`, local patches, or
+edits under `node_modules/@agent-native/*` — especially not against
+`@agent-native/core` or `@agent-native/dispatch`.
+
+## Why
+
+Agents often respond to a failed core bump by inventing framework patches and
+dispatch behavior overrides. That hides the real app-level break, drifts from
+upstream, and makes the next upgrade worse. The supported path is bump →
+install → refresh scaffold skills → verify, then fix **app** code only.
+
+## How
+
+1. **Doctor first (optional but recommended)**
+
+   ```bash
+   npx @agent-native/core@latest upgrade check
+   ```
+
+   This reports framework overrides/patches and pending `@agent-native/*`
+   bumps. If overrides/patches are present, remove them before continuing.
+
+2. **Run the upgrade**
+
+   ```bash
+   npx @agent-native/core@latest upgrade
+   ```
+
+   Or from an already-installed CLI: `pnpm exec agent-native upgrade` /
+   `agent-native upgrade`.
+
+   What it does:
+
+   - Blocks (unless `--force`) when `@agent-native/*` overrides/patches exist
+   - Rewrites non-local `@agent-native/*` dependency pins to `latest`
+   - Runs the package manager install
+   - Runs `skills update scaffold --project`
+   - Runs `typecheck` when the project has that script
+
+3. **If upgrade or typecheck fails**
+
+   - Read the concrete error
+   - Fix **app** source, actions, config, or env — not framework packages
+   - Re-run `agent-native upgrade` or `pnpm typecheck`
+   - Stop and ask the user if you cannot fix the app-level error
+
+4. **Dry-run / partial runs**
+
+   ```bash
+   agent-native upgrade --dry-run
+   agent-native upgrade --skip-verify
+   agent-native upgrade --skip-install   # package.json bumps only
+   ```
+
+## Don't
+
+- Don't add `pnpm.overrides`, `overrides`, `resolutions`, or
+  `patchedDependencies` for any `@agent-native/*` package
+- Don't edit `node_modules/@agent-native/core` or
+  `node_modules/@agent-native/dispatch`
+- Don't invent local "dispatch behavior" shims to paper over version skew
+- Don't keep iterating with more framework patches after a failed install
+- Don't skip `skills update scaffold --project` after a core bump (the
+  upgrade command does this for you)
+
+## Related Skills
+
+- **self-modifying-code** — Tier 4: framework packages are off limits
+- **agent-native-docs** — version-matched docs after the bump
+- **portability** — keep app code provider-agnostic across upgrades

package/corpus/core/src/templates/workspace-core/package.json

@@ -26,13 +26,13 @@
     }
   },
   "scripts": {
-    "build": "tsgo",
-    "dev": "tsgo --watch --preserveWatchOutput",
-    "typecheck": "tsgo --noEmit",
-    "prepare": "tsgo"
+    "build": "tsc",
+    "dev": "tsc --watch --preserveWatchOutput",
+    "typecheck": "tsc --noEmit",
+    "prepare": "tsc"
   },
   "devDependencies": {
-    "@typescript/native-preview": "catalog:",
-    "typescript": "^6.0.3"
+    "typescript": "catalog:",
+    "typescript-7": "catalog:"
   }
 }

package/corpus/core/src/templates/workspace-root/AGENTS.md

@@ -27,10 +27,16 @@ first-party template patterns ships in `node_modules/@agent-native/core/corpus`.
 Use package docs for framework APIs, the package corpus for reusable
 framework/template patterns, and `packages/shared/AGENTS.md` plus
 `packages/shared/.agents/skills/` for workspace-specific conventions.
-After updating `@agent-native/core`, run `pnpm skills:update` or
-`npx @agent-native/core@latest skills update scaffold --project` from the
-workspace root to refresh framework-provided shared skills and repair
-`CLAUDE.md` / `.claude/skills` compatibility links.
+To bring an older workspace current, run `pnpm upgrade:agent-native` or
+`npx @agent-native/core@latest upgrade` from the workspace root. That bumps
+`@agent-native/*` deps, installs, refreshes scaffold skills, and typechecks.
+Do **not** add `pnpm.overrides` / patches against `@agent-native/*` or edit
+`node_modules/@agent-native/*` when an upgrade fails — fix app code or ask.
+See the `upgrade-agent-native` and `self-modifying-code` skills.
+After a manual core bump only, `pnpm skills:update` (or
+`npx @agent-native/core@latest skills update scaffold --project`) still
+refreshes framework-provided shared skills and repairs `CLAUDE.md` /
+`.claude/skills` compatibility links.
 
 ## Core Agent Rule
 

package/corpus/core/src/templates/workspace-root/package.json

@@ -8,6 +8,7 @@
     "typecheck": "pnpm -r typecheck",
     "repair:workspace-org": "tsx scripts/repair-workspace-org.ts",
     "skills:update": "agent-native skills update scaffold --project",
+    "upgrade:agent-native": "agent-native upgrade",
     "fmt:check": "oxfmt --check .",
     "lint": "pnpm fmt:check"
   },
@@ -17,10 +18,10 @@
   },
   "devDependencies": {
     "@types/node": "^24.2.1",
-    "@typescript/native-preview": "catalog:",
     "oxfmt": "catalog:",
     "tsx": "catalog:",
-    "typescript": "^6.0.3"
+    "typescript": "catalog:",
+    "typescript-7": "catalog:"
   },
   "packageManager": "pnpm@10.14.0",
   "agent-native": {