@agent-native/core 0.107.2 → 0.109.0

package/corpus/templates/clips/app/i18n/hi-IN.ts

@@ -616,6 +616,15 @@ const messages = {
     languageDescription:
       "इस खाते के लिए इंटरफ़ेस भाषा चुनें। Clips इसे आपके डिवाइसों पर याद रखेगा।",
     languageLabel: "इंटरफ़ेस भाषा",
+    uploadWorkspaceTitle: "सक्रिय वर्कस्पेस",
+    uploadWorkspaceDescription:
+      "वह वर्कस्पेस चुनें जिसका उपयोग Clips डेस्कटॉप अपलोड सहित नई रिकॉर्डिंग के लिए करेगा।",
+    uploadWorkspaceLabel: "वर्तमान वर्कस्पेस",
+    uploadWorkspacePlaceholder: "वर्कस्पेस चुनें",
+    uploadWorkspaceHint: "इसे बदलने पर वर्कस्पेस से जुड़ी Clips दृश्य भी अपडेट होती हैं।",
+    uploadWorkspaceSaving: "वर्कस्पेस सहेजा जा रहा है…",
+    uploadWorkspaceSaved: "सक्रिय वर्कस्पेस अपडेट किया गया",
+    uploadWorkspaceSaveFailed: "सक्रिय वर्कस्पेस अपडेट नहीं किया जा सका",
     whatsNew: "नया क्या है",
     changelogEmpty: "अभी कोई अपडेट नहीं है।",
     viewAllUpdates: "सभी अपडेट देखें",
@@ -1356,7 +1365,7 @@ Clips में उपयोगकर्ताओं को दिखने व
     uploadFailed: "अपलोड विफल",
     connectStorageToFinish: "स्टोरेज कनेक्ट करके सेव पूरा करने के लिए खोलें।",
     retryFromClipsMenu:
-      "Clips मेनू से फिर कोशिश करें; दोबारा रिकॉर्ड करने की जरूरत नहीं।",
+      "इस सहेजे गए अपलोड को फिर आज़माने के लिए मेनू बार से Clips खोलें; दोबारा रिकॉर्ड करने की ज़रूरत नहीं।",
     removeFailedClip: "यह विफल क्लिप हटाएं।",
     remove: "हटाएं",
     viewsCount: "{{count}} बार देखा गया",

package/corpus/templates/clips/app/i18n/ja-JP.ts

@@ -630,6 +630,17 @@ const messages = {
     languageDescription:
       "このアカウントのインターフェイス言語を選択します。Clips はデバイス間で設定を記憶します。",
     languageLabel: "インターフェイス言語",
+    uploadWorkspaceTitle: "アクティブなワークスペース",
+    uploadWorkspaceDescription:
+      "デスクトップからのアップロードを含む新しい Clips 録画で使用するワークスペースを選択します。",
+    uploadWorkspaceLabel: "現在のワークスペース",
+    uploadWorkspacePlaceholder: "ワークスペースを選択",
+    uploadWorkspaceHint:
+      "変更すると、ワークスペースに関連する Clips の表示も更新されます。",
+    uploadWorkspaceSaving: "ワークスペースを保存中…",
+    uploadWorkspaceSaved: "アクティブなワークスペースを更新しました",
+    uploadWorkspaceSaveFailed:
+      "アクティブなワークスペースを更新できませんでした",
     whatsNew: "最新情報",
     changelogEmpty: "まだ更新はありません。",
     viewAllUpdates: "すべての更新を見る",
@@ -1383,7 +1394,7 @@ Clips のユーザー向けの主な変更はここに記録されます。コ
     uploadFailed: "アップロードに失敗しました",
     connectStorageToFinish: "開いてストレージを接続し、保存を完了します。",
     retryFromClipsMenu:
-      "Clips メニューから再試行できます。録画し直す必要はありません。",
+      "メニューバーからClipsを開いて、この保存済みアップロードを再試行できます。録画し直す必要はありません。",
     removeFailedClip: "失敗したクリップを削除します。",
     remove: "削除",
     viewsCount: "{{count}} 回表示",

package/corpus/templates/clips/app/i18n/ko-KR.ts

@@ -623,6 +623,16 @@ const messages = {
     languageDescription:
       "이 계정의 인터페이스 언어를 선택하세요. Clips가 여러 기기에서 기억합니다.",
     languageLabel: "인터페이스 언어",
+    uploadWorkspaceTitle: "활성 워크스페이스",
+    uploadWorkspaceDescription:
+      "데스크톱 업로드를 포함한 새 Clips 녹화에 사용할 워크스페이스를 선택하세요.",
+    uploadWorkspaceLabel: "현재 워크스페이스",
+    uploadWorkspacePlaceholder: "워크스페이스 선택",
+    uploadWorkspaceHint:
+      "변경하면 워크스페이스와 관련된 Clips 화면도 업데이트됩니다.",
+    uploadWorkspaceSaving: "워크스페이스 저장 중…",
+    uploadWorkspaceSaved: "활성 워크스페이스가 업데이트됨",
+    uploadWorkspaceSaveFailed: "활성 워크스페이스를 업데이트할 수 없음",
     whatsNew: "새 소식",
     changelogEmpty: "아직 업데이트가 없습니다.",
     viewAllUpdates: "모든 업데이트 보기",
@@ -1366,7 +1376,7 @@ Clips의 모든 사용자 대상 변경 사항은 여기에 기록됩니다. 명
     uploadFailed: "업로드 실패",
     connectStorageToFinish: "열어서 저장소를 연결하고 저장을 완료하세요.",
     retryFromClipsMenu:
-      "Clips 메뉴에서 다시 시도하세요. 다시 녹화할 필요는 없습니다.",
+      "메뉴 막대에서 Clips를 열어 저장된 업로드를 다시 시도하세요. 다시 녹화할 필요가 없습니다.",
     removeFailedClip: "실패한 클립 제거.",
     remove: "제거",
     viewsCount: "조회수 {{count}}회",

package/corpus/templates/clips/app/i18n/pt-BR.ts

@@ -633,6 +633,16 @@ const messages = {
     languageDescription:
       "Escolha o idioma da interface para esta conta. O Clips lembrará em todos os seus dispositivos.",
     languageLabel: "Idioma da interface",
+    uploadWorkspaceTitle: "Espaço ativo",
+    uploadWorkspaceDescription:
+      "Escolha o espaço que o Clips usará para novas gravações, incluindo uploads do desktop.",
+    uploadWorkspaceLabel: "Espaço atual",
+    uploadWorkspacePlaceholder: "Escolha um espaço",
+    uploadWorkspaceHint:
+      "Isso também atualiza as telas do Clips vinculadas ao espaço.",
+    uploadWorkspaceSaving: "Salvando espaço…",
+    uploadWorkspaceSaved: "Espaço ativo atualizado",
+    uploadWorkspaceSaveFailed: "Não foi possível atualizar o espaço ativo",
     whatsNew: "Novidades",
     changelogEmpty: "Ainda não há atualizações.",
     viewAllUpdates: "Ver todas as atualizações",
@@ -1386,7 +1396,7 @@ Todas as mudanças visíveis para usuários do Clips são documentadas aqui. Voc
     connectStorageToFinish:
       "Abra para conectar o armazenamento e concluir o salvamento.",
     retryFromClipsMenu:
-      "Tente novamente pelo menu do Clips; não precisa gravar de novo.",
+      "Abra o Clips pela barra de menus para tentar novamente este upload salvo; não é preciso gravar de novo.",
     removeFailedClip: "Remover este clip com falha.",
     remove: "Remover",
     viewsCount: "{{count}} visualizações",

package/corpus/templates/clips/app/i18n/zh-CN.ts

@@ -598,6 +598,15 @@ const messages = {
     languageDescription:
       "选择此账号的界面语言。Clips 会在不同设备上记住你的选择。",
     languageLabel: "界面语言",
+    uploadWorkspaceTitle: "当前工作区",
+    uploadWorkspaceDescription:
+      "选择 Clips 用于新录制内容（包括桌面上传）的工作区。",
+    uploadWorkspaceLabel: "当前工作区",
+    uploadWorkspacePlaceholder: "选择工作区",
+    uploadWorkspaceHint: "切换后，Clips 中与工作区相关的视图也会更新。",
+    uploadWorkspaceSaving: "正在保存工作区…",
+    uploadWorkspaceSaved: "当前工作区已更新",
+    uploadWorkspaceSaveFailed: "无法更新当前工作区",
     whatsNew: "最新变化",
     changelogEmpty: "暂无更新。",
     viewAllUpdates: "查看所有更新",
@@ -1326,7 +1335,8 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
     savedLocally: "已保存到本地",
     uploadFailed: "上传失败",
     connectStorageToFinish: "打开以连接存储并完成保存。",
-    retryFromClipsMenu: "从 Clips 菜单重试；无需重新录制。",
+    retryFromClipsMenu:
+      "从菜单栏打开 Clips，重试这个已保存的上传；无需重新录制。",
     removeFailedClip: "移除此失败剪辑。",
     remove: "移除",
     viewsCount: "{{count}} 次观看",

package/corpus/templates/clips/app/i18n/zh-TW.ts

@@ -598,6 +598,15 @@ const messages = {
     languageDescription:
       "選取此帳號的介面語言。Clips 會在不同設備上記住你的選取。",
     languageLabel: "介面語言",
+    uploadWorkspaceTitle: "目前工作區",
+    uploadWorkspaceDescription:
+      "選擇 Clips 用於新錄製內容（包括桌面上傳）的工作區。",
+    uploadWorkspaceLabel: "目前工作區",
+    uploadWorkspacePlaceholder: "選擇工作區",
+    uploadWorkspaceHint: "切換後，Clips 中與工作區相關的檢視也會更新。",
+    uploadWorkspaceSaving: "正在儲存工作區…",
+    uploadWorkspaceSaved: "目前工作區已更新",
+    uploadWorkspaceSaveFailed: "無法更新目前工作區",
     whatsNew: "最新變化",
     changelogEmpty: "暫無更新。",
     viewAllUpdates: "檢視所有更新",
@@ -1302,7 +1311,8 @@ const messages = {
     savedLocally: "已儲存到本機",
     uploadFailed: "上傳失敗",
     connectStorageToFinish: "開啟以連線儲存並完成儲存。",
-    retryFromClipsMenu: "從 Clips 選單重試；不需要重新錄製。",
+    retryFromClipsMenu:
+      "從選單列開啟 Clips 以重試這個已儲存的上傳；不需要重新錄製。",
     removeFailedClip: "移除此失敗剪輯。",
     remove: "移除",
     viewsCount: "{{count}} 次觀看",

package/corpus/templates/clips/app/routes/_app.settings._index.tsx

@@ -12,7 +12,7 @@ import {
   useT,
   type SettingsSearchEntry,
 } from "@agent-native/core/client";
-import { TeamPage } from "@agent-native/core/client/org";
+import { TeamPage, useOrg, useSwitchOrg } from "@agent-native/core/client/org";
 import {
   BUILDER_CREDITS_UPGRADE_URL,
   type BuilderCreditsStatus,
@@ -30,6 +30,7 @@ import {
   IconServer,
   IconTrash,
   IconUser,
+  IconUsersGroup,
 } from "@tabler/icons-react";
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { toast } from "sonner";
@@ -394,6 +395,8 @@ export default function SettingsIndexRoute() {
   const { session } = useSession();
   const t = useT();
   const agentSettingsTabs = useAgentSettingsTabs();
+  const { data: org } = useOrg();
+  const switchOrg = useSwitchOrg();
   const email = session?.email ?? "";
   const storageStatus = useVideoStorageStatus();
   const builderStatus = useBuilderStatus();
@@ -505,6 +508,22 @@ export default function SettingsIndexRoute() {
     void refreshApiKeyStatus();
   }, [refreshApiKeyStatus]);
 
+  const orgs = org?.orgs ?? [];
+
+  async function handleUploadWorkspaceChange(organizationId: string) {
+    if (!organizationId || organizationId === org?.orgId) return;
+    try {
+      await switchOrg.mutateAsync(organizationId);
+      toast.success(t("settings.uploadWorkspaceSaved"));
+    } catch (err) {
+      toast.error(
+        err instanceof Error
+          ? err.message
+          : t("settings.uploadWorkspaceSaveFailed"),
+      );
+    }
+  }
+
   async function handleSave() {
     setSaving(true);
     try {
@@ -761,6 +780,13 @@ export default function SettingsIndexRoute() {
         keywords: "storage s3 builder bucket cloud video",
         hash: "video-storage",
       },
+      {
+        id: "clips-upload-workspace",
+        label: t("settings.uploadWorkspaceTitle"),
+        keywords:
+          "upload recordings desktop destination organization workspace",
+        hash: "upload-workspace",
+      },
       {
         id: "clips-slack",
         label: t("settings.slackTitle"),
@@ -835,6 +861,51 @@ export default function SettingsIndexRoute() {
                 </CardContent>
               </Card>
 
+              {orgs.length > 0 ? (
+                <Card id="upload-workspace" className="scroll-mt-16">
+                  <CardHeader>
+                    <CardTitle className="flex items-center gap-2 text-base">
+                      <IconUsersGroup className="size-4 text-primary" />
+                      {t("settings.uploadWorkspaceTitle")}
+                    </CardTitle>
+                    <CardDescription>
+                      {t("settings.uploadWorkspaceDescription")}
+                    </CardDescription>
+                  </CardHeader>
+                  <CardContent className="max-w-md space-y-1.5">
+                    <Label htmlFor="upload-workspace-select">
+                      {t("settings.uploadWorkspaceLabel")}
+                    </Label>
+                    <Select
+                      value={org?.orgId ?? undefined}
+                      onValueChange={handleUploadWorkspaceChange}
+                      disabled={switchOrg.isPending || orgs.length < 2}
+                    >
+                      <SelectTrigger id="upload-workspace-select">
+                        <SelectValue
+                          placeholder={t("settings.uploadWorkspacePlaceholder")}
+                        />
+                      </SelectTrigger>
+                      <SelectContent>
+                        {orgs.map((workspace) => (
+                          <SelectItem
+                            key={workspace.orgId}
+                            value={workspace.orgId}
+                          >
+                            {workspace.orgName}
+                          </SelectItem>
+                        ))}
+                      </SelectContent>
+                    </Select>
+                    <p className="text-xs text-muted-foreground">
+                      {switchOrg.isPending
+                        ? t("settings.uploadWorkspaceSaving")
+                        : t("settings.uploadWorkspaceHint")}
+                    </p>
+                  </CardContent>
+                </Card>
+              ) : null}
+
               <Card id="video-storage" className="scroll-mt-16">
                 <CardHeader>
                   <CardTitle className="text-base flex items-center gap-2">

package/corpus/templates/clips/changelog/2026-07-17-choose-which-workspace-receives-new-clips-recordings-and-des.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+Choose which workspace receives new Clips recordings and desktop uploads

package/corpus/templates/clips/changelog/2026-07-17-create-folders-directly-from-the-move-menu.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+Create folders directly from the move menu

package/corpus/templates/clips/changelog/2026-07-17-failed-desktop-uploads-now-offer-a-direct-way-to-reopen-clip.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-17
+---
+
+Failed desktop uploads now offer a direct way to reopen Clips and retry without re-recording.

package/corpus/templates/clips/desktop/src/app.tsx

@@ -4569,7 +4569,7 @@ function Setup({
       <div className="setup-section">
         <SettingLabel
           label="Clip Drafts"
-          hint="Clips dismissed after an upload problem stay in Movies/Clips/Drafts until you remove them in Finder."
+          hint="Only clips you dismiss from the saved-upload card appear in Movies/Clips/Drafts. To retry a failed upload, return to the Clips popover and use Retry."
         />
         <button
           type="button"

package/corpus/templates/clips/server/plugins/feature-flags.ts

@@ -0,0 +1,11 @@
+import { createFeatureFlagsPlugin } from "@agent-native/core/server";
+
+import { CLIPS_FEATURE_FLAGS } from "../../shared/feature-flags.js";
+
+export default createFeatureFlagsPlugin({
+  flags: CLIPS_FEATURE_FLAGS,
+  legacyBooleanSetting: {
+    settingKey: "feature-flags",
+    flagKeys: CLIPS_FEATURE_FLAGS.map(({ key }) => key),
+  },
+});

package/corpus/templates/clips/shared/feature-flags.ts

@@ -1,41 +1,34 @@
+import {
+  defineFeatureFlag,
+  defineFeatureFlags,
+} from "@agent-native/core/feature-flags";
+
 /**
- * Server-controlled feature flags, readable from the action surface so
- * behavior can change without a redeploy. Stored under one global `settings`
- * key (not per-user/org) — these gate app-wide rollout decisions, not
- * individual preferences.
- *
- * Add new flags here as they're needed; `get-feature-flags` stays generic
- * and doesn't need to change.
+ * Desktop app: use the custom ScreenCaptureKit (SCK) capture pipeline
+ * (fragmented MP4 writer + live audio mixer) instead of Apple's stock
+ * `SCRecordingOutput`. See `desktop/src-tauri/src/native_screen/custom_capture.rs`.
  */
+export const USE_CUSTOM_SCK_PIPELINE_FLAG = defineFeatureFlag({
+  key: "useCustomSCKPipeline",
+  displayName: "Custom ScreenCaptureKit pipeline",
+  description:
+    "Use the fragmented MP4 writer and live audio mixer for desktop capture.",
+});
 
-export const FEATURE_FLAGS_KEY = "feature-flags";
-
-export type FeatureFlags = {
-  /**
-   * Desktop app: use the custom ScreenCaptureKit (SCK) capture pipeline
-   * (fragmented MP4 writer + live audio mixer) instead of Apple's stock
-   * `SCRecordingOutput`. See `desktop/src-tauri/src/native_screen/custom_capture.rs`.
-   */
-  useCustomSCKPipeline?: boolean;
-  /**
-   * Desktop app: stream the recording to the server in chunks while it is
-   * being recorded, instead of uploading the whole file after Stop. Only
-   * effective when `useCustomSCKPipeline` is also on. See
-   * `desktop/src-tauri/src/native_screen/live_upload.rs`.
-   */
-  customSCKPipelineLiveUploadEnabled?: boolean;
-};
-
-export const FEATURE_FLAG_DEFAULTS: Required<FeatureFlags> = {
-  useCustomSCKPipeline: false,
-  customSCKPipelineLiveUploadEnabled: false,
-};
+/**
+ * Desktop app: stream the recording to the server in chunks while it is
+ * being recorded, instead of uploading the whole file after Stop. Only
+ * effective when the custom SCK pipeline is also on. See
+ * `desktop/src-tauri/src/native_screen/live_upload.rs`.
+ */
+export const CUSTOM_SCK_LIVE_UPLOAD_FLAG = defineFeatureFlag({
+  key: "customSCKPipelineLiveUploadEnabled",
+  displayName: "Live capture upload",
+  description:
+    "Upload recording chunks while capture is still in progress. Requires the custom ScreenCaptureKit pipeline.",
+});
 
-export function withFeatureFlagDefaults(
-  flags: FeatureFlags | Record<string, unknown> | null | undefined,
-): Required<FeatureFlags> {
-  return {
-    ...FEATURE_FLAG_DEFAULTS,
-    ...(flags as FeatureFlags | undefined),
-  };
-}
+export const CLIPS_FEATURE_FLAGS = defineFeatureFlags([
+  USE_CUSTOM_SCK_PIPELINE_FLAG,
+  CUSTOM_SCK_LIVE_UPLOAD_FLAG,
+]);

package/corpus/templates/content/.agents/skills/feature-flags/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: feature-flags
+description: >-
+  Declare, evaluate, manage, and remove framework feature flags. Use when
+  shipping a capability gradually, targeting users or organizations, or
+  replacing a compile-time rollout switch with a production-safe runtime flag.
+scope: dev
+metadata:
+  internal: true
+---
+
+# Feature Flags
+
+A feature flag is a boolean declared in app code, evaluated locally by Core,
+and managed from the Analytics fleet control plane. Code owns whether a flag
+exists. Runtime settings own only its rollout state.
+
+Flags let an app deploy dormant code and turn it on in the real environment
+without another deployment. They are not experiments: do not add variants,
+hypotheses, conversion metrics, exposure tracking, or lifecycle states.
+
+## When to use one
+
+Use a flag for a reversible rollout of a user-facing capability whose dormant
+code is safe to deploy. Flags are useful for production dogfooding, exact-user
+or organization pilots, and deterministic percentage rollouts.
+
+Do not use a flag for authentication, authorization, secrets, audit enablement,
+SSR cache behavior, or another security boundary. Client hiding is presentation
+only; every guarded server action must evaluate the same registered flag.
+
+## Agent workflow
+
+### 1. Declare
+
+Keep definitions in a shared TypeScript module so server and client code use the
+same stable key. Flags are boolean and default-off.
+
+```ts
+import { defineFeatureFlag } from "@agent-native/core/feature-flags";
+
+export const FULL_APP_BUILDING = defineFeatureFlag({
+  key: "full-app-building",
+  displayName: "Full app building",
+  description: "Create and edit Fusion-backed applications.",
+});
+```
+
+Keys are immutable, never reused, and contain only letters, numbers, dots,
+underscores, or hyphens. Prefer a concise app-owned name. Do not create flag
+definitions or rollout rows from Analytics.
+
+### 2. Register
+
+Register app definitions from a Nitro plugin before actions are discovered.
+Do not add app-specific flags to a Core registry.
+
+```ts
+import { createFeatureFlagsPlugin } from "@agent-native/core/server";
+
+import { FULL_APP_BUILDING } from "../../shared/feature-flags.js";
+
+export default createFeatureFlagsPlugin({ flags: [FULL_APP_BUILDING] });
+```
+
+### 3. Guard server and client
+
+The server action is the enforcement boundary:
+
+```ts
+import { isFeatureFlagEnabled } from "@agent-native/core/feature-flags";
+
+run: async (args, ctx) => {
+  if (!(await isFeatureFlagEnabled(FULL_APP_BUILDING, ctx))) {
+    throw new Error("Full app building is not enabled for this account.");
+  }
+  // guarded operation
+}
+```
+
+Use the client hook only to hide or reveal hydrated UI:
+
+```tsx
+import { useFeatureFlag } from "@agent-native/core/client";
+
+const enabled = useFeatureFlag(FULL_APP_BUILDING.key);
+return enabled ? <FullAppOption /> : null;
+```
+
+The client hook intentionally returns false while loading or for an unknown
+flag. Never replace that fail-closed behavior with app-local bucketing or a
+compile-time fallback. Never evaluate personalized flags in the public SSR
+shell; it is shared and cached for every visitor.
+
+### 4. Verify and roll out
+
+1. Verify the off path before changing rollout state.
+2. Confirm the registered flag appears in **Analytics → Feature flags** for the
+   app and is Off by default.
+3. Use **Enable for me** for initial production dogfood.
+4. Expand to exact emails, organization IDs, or a percentage only from
+   Analytics.
+5. Confirm the client presentation and authoritative server action agree.
+
+## Management contract
+
+Core mounts three actions in registered apps:
+
+| Action | Purpose |
+| --- | --- |
+| `get-feature-flags` | Return the current caller's evaluated boolean values. |
+| `list-feature-flags` | Return definitions and rollout metadata to an authorized operator. |
+| `set-feature-flag` | Atomically turn a flag off, enable it for the operator, or replace targeting rules. |
+
+Analytics calls the app-local operator actions through narrowly scoped A2A
+delegation. Tokens require an exact audience, organization, scope, operator
+role, and audit correlation id. Management is permission-checked and audited
+by the target app. Never manage flags through generic settings routes, raw SQL,
+or per-app toggle UIs.
+
+## Rollout semantics
+
+The operator modes are **Off**, **Targeted**, and **Everyone**. Core stores them
+as `off`, `rules`, and `on`.
+
+Targeted rules combine exact normalized emails, exact organization IDs, and a
+percentage with OR semantics. Exact matches are checked first. Percentage
+buckets use Core's stable hash of the flag key and authenticated user identity;
+anonymous callers fail closed. Raising a percentage preserves the users already
+included at a lower percentage. Do not implement bucketing in app code.
+
+Unknown definitions, missing state, malformed state, storage errors, and
+evaluation errors all return the code default (`false` in v1). Explicit Off
+wins over every target; Everyone enables every authenticated caller.
+
+## Remove a flag
+
+After a rollout is permanent:
+
+1. Replace guarded branches with the chosen behavior.
+2. Delete the server and client gates.
+3. Delete the definition and registration entry.
+4. Verify the flag disappears from the Analytics fleet.
+5. Remove stale tests and rollout instructions.
+
+A permanent flag is just an if statement with a pension plan.
+
+## Verification checklist
+
+- Unknown and unregistered keys evaluate false.
+- UI hiding and server enforcement use the same registered key.
+- Exact-user, organization, deterministic percentage, Everyone, and Off paths
+  have focused tests.
+- Increasing a percentage is monotonic; anonymous percentage evaluation is off.
+- Unauthorized callers cannot list targeting details or mutate flags.
+- Mutations are atomic, read back stored state, emit refresh, and appear in the
+  audit log with the flag key.
+- Analytics represents ready, no-definition, unsupported, forbidden, legacy,
+  and unreachable directory apps honestly.
+- Future agents can find this skill from root `AGENTS.md`, and
+  `pnpm guard:workspace-skills` passes after syncing generated copies.
+
+## Related skills
+
+- **adding-a-feature** — preserve UI/action/instruction/application-state parity
+- **actions** — define and call guarded app operations
+- **audit-log** — inspect automatic action mutation history
+- **reliable-mutations** — make rollout changes atomic and provable
+- **security** — keep security controls out of feature flags

package/corpus/templates/content/app/entry.client.tsx

@@ -1,7 +1,12 @@
-import { appBasePath } from "@agent-native/core/client/api-path";
+import {
+  appBasePath,
+  installRouteChunkRecovery,
+} from "@agent-native/core/client";
 import { hydrateRoot } from "react-dom/client";
 import { HydratedRouter } from "react-router/dom";
 
+installRouteChunkRecovery();
+
 const basePath = appBasePath();
 const pathname = window.location.pathname;
 const routerBasePath =