@agent-native/core 0.85.6 → 0.86.0

package/corpus/README.md

@@ -27,5 +27,5 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- core files: 2046
-- template files: 5041
+- core files: 2043
+- template files: 4825

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,135 @@
 # @agent-native/core
 
+## 0.86.0
+
+### Minor Changes
+
+- 622d552: Collaborative editing kit: agent edits now behave like a visible collaborator
+  and undo is per-user everywhere.
+  - Agent presence lingers (~6s) after edits instead of vanishing instantly;
+    any agent-sourced collab write (`applyText`, `searchAndReplace`, `applyJson`,
+    `applyPatchOps`) automatically publishes presence plus lingering edit
+    attribution — no per-action wiring required (`agentTouchDocument`).
+  - New `recentEdits` awareness convention with `useRecentEdits`,
+    `publishRecentEdit`, and the `RecentEditHighlights` overlay — fading,
+    name/avatar-flagged highlights over regions a human or the AI just edited.
+  - New shared per-user undo primitives: `useCollabUndo` (Y.UndoManager
+    lifecycle with local-origin scoping) and `useLocalOpUndo` /
+    `createLocalOpUndoController` (inverse-op undo for op-based apps that never
+    reverts other participants' work).
+  - `CollabUser.avatarUrl` renders profile images in `PresenceBar`,
+    `LiveCursorOverlay`, and `RemoteSelectionRings`; selection descriptors may
+    now carry labels (`{ selector, label }`), and agent selection tags no longer
+    render as "AI — AI".
+  - Presence now survives multi-instance/serverless deployments: awareness
+    state is mirrored to a new `_collab_awareness` table (SQLite/Postgres
+    portable, additive, best-effort with throttled writes), so cursors and the
+    agent's presence written in one invocation are visible to clients polling
+    any other instance.
+  - Surgical reconcile: `useCollabReconcile` now applies authoritative external
+    content by diffing top-level nodes and replacing only the changed run
+    (new `parseValue` option, `applyDocSurgically`/`diffTopLevel` exports)
+    instead of a whole-document `setContent` — unchanged block NodeViews are
+    never torn down, remote carets stop jumping, and Collaboration sees minimal
+    Yjs ops. Falls back to `setContent` when no parsed doc is available.
+
+- 622d552: Add `ensureAdditiveColumns` (`@agent-native/core/db`), a boot-time helper that diffs each Drizzle table's declared columns against the live database and additively `ALTER TABLE ... ADD COLUMN`s any that are missing. This closes the gap where a column added to a Drizzle schema without a matching hand-written migration silently 500s every query on pre-existing production tables (fresh dev databases don't show the bug because `CREATE TABLE IF NOT EXISTS` always includes new columns). It only ever adds missing columns — never drops, renames, or retypes existing ones — skips `NOT NULL` columns with no safe backfill default, and is wired into the analytics template's `server/plugins/db.ts` after its authoritative migrations run.
+- 622d552: Add optional name-based tracking to `runMigrations` (`@agent-native/core/db`): a migration entry can now set a stable, unique `name` slug that is tracked independently of its `version` number in a companion `<table>_named` bookkeeping table. This fixes a collision class where two branches that each independently extend the same migration list under the same version numbers cause whichever deploys first to "claim" those version numbers, silently skipping the other branch's DDL forever — the exact failure that left the analytics template's `analytics_alert_rules`, `analytics_alert_incidents`, and `session_recordings.network_error_count` missing in production despite `analytics_migrations` reporting every version as applied. Unnamed migrations keep the exact legacy `version > MAX(version)` behavior; a duplicate `name` in a migration list throws at startup.
+- 622d552: Session replay network capture now records a bounded, redacted response-body snippet for 5xx (server error) responses, so agents can see the actual server error message. Request bodies and headers are still never captured, and non-5xx or network-failure responses never carry a body. Configurable via `sessionReplay.network.captureErrorBodies` (default `true`) and `maxErrorBodyLength` (default 2048 chars).
+
+### Patch Changes
+
+- 622d552: Live collab updates now push over SSE to read-only viewer sharees, not just the
+  resource owner and org members. Collab events are tagged with their
+  resourceType/resourceId, and the per-user delivery filter runs an access-aware
+  (cached, fail-closed) check against the same `resolveAccess` authority used by
+  the collab routes — so a viewer with explicit access sees edits at push latency
+  instead of falling back to the poll cycle, while unauthorized users are never
+  delivered events.
+- 622d552: Shared rich-markdown editors can now disable the default markdown surgical
+  parser when they own a custom value format, preventing JSON-backed editor content
+  from being interpreted as literal markdown.
+- 622d552: Data-fetch hot-path hardening: faster loads, bounded hangs, fewer round trips.
+  - `useActionQuery` now threads React Query's per-fetch `AbortSignal` into the
+    network request, so superseded fetches (key change, unmount, rapid refetch)
+    actually cancel instead of holding a per-origin connection slot.
+  - Every action fetch is bounded by a 60s timeout (override via
+    `callAction(..., { timeoutMs })`); a hung server surfaces a typed timeout
+    error instead of an infinite spinner, and timeouts are not silently retried.
+  - Action query retries back off in ~0.5–2s steps instead of React Query's
+    1s/2s/4s, so real failures surface in about a quarter of the time.
+  - Collaborative docs no longer open their own `EventSource` per doc (one for
+    updates, one for awareness): they subscribe to the shared sync transport via
+    the new `subscribeSyncEvents` API, so a tab holds exactly ONE SSE connection
+    no matter how many docs are mounted — previously 3+ streams could starve the
+    browser's per-origin connection budget and stall unrelated data fetches.
+  - Awareness (cursor/presence) events no longer trigger the framework-level
+    query-invalidation sweep on every peer keystroke.
+  - The `/_agent-native/poll` fallback now backs off exponentially (cap 30s) on
+    consecutive non-auth failures instead of hammering a down server at full
+    cadence.
+  - Session org backfill and `getOrgContext` now share one per-request
+    `org_members` lookup, and `getSetting`/`getUserSetting` reads are memoized
+    per request — several DB round trips removed from every authenticated
+    action call.
+  - Chat-thread share links resolve through a new indexed `share_token_hash`
+    column (additive, with legacy-blob fallback + opportunistic backfill)
+    instead of a `LIKE '%hash%'` scan over every thread's full message blob.
+  - Queued-message saves no longer pre-read the full thread blob a second time
+    on every debounced composer write.
+  - The Drizzle non-Neon Postgres path gets the same per-op timeout +
+    connection-error retry protection as every other Postgres path, and the
+    Drizzle SQLite path now sets `busy_timeout` like the raw exec path.
+  - `agent_checkpoints` gains indexes on `(thread_id, created_at)` and `run_id`.
+  - Schema-prompt introspection coalesces concurrent cache-miss rebuilds;
+    recurring-job runs no longer leak a live 5-minute backstop timer; a failed
+    migration-connection open no longer poisons the shared exec singleton;
+    `detachThread` no longer applies its optimistic update when the server
+    rejects the change; `useAgentEngineConfigured` guards against out-of-order
+    responses overwriting newer state.
+
+- 622d552: Add a token-gated `POST /list-files` endpoint to the `design connect` localhost bridge (recursive walk honoring a simple `.gitignore` subset, always-ignored build/dependency directories, binary/size filtering, and a 20,000-entry cap), broaden the bridge's writable text-file extension allowlist beyond `.html`/`.htm`/`.css` to common web/code/text formats, and add a secret-path blocklist (`.env*`, `*.pem`, `*.key`, `id_rsa*`, anything under `.git/`) enforced across `/read-file`, `/write-file`, `/apply-edit`, and `/list-files`. The manifest now advertises additive `listFiles`/`readTextFiles`/`writeTextFiles` capabilities for the Design app's code workbench.
+
+  Harden the bridge further: `assertPathInside` now also rejects a symlink at
+  the target path itself (not just a symlink in an ancestor directory), closing
+  a confinement bypass where a pre-existing symlink leaf inside the root could
+  point outside it and be silently followed by `/read-file`, `/write-file`, or
+  `/apply-edit`. The secret-path blocklist is now case-insensitive end to end
+  (bridge and the Design app's `write-local-file` action), so uppercase or
+  mixed-case variants like `.ENV`, `ID_RSA`, or `KEY.PEM` are blocked the same
+  as their lowercase form — required on case-insensitive filesystems such as
+  macOS's default APFS. `/read-file` now returns a `versionHash` derived from
+  the file's mtime/size, and `/write-file` and `/apply-edit` accept an optional
+  `expectedVersionHash`: when provided and the file's current hash does not
+  match, the bridge responds `409` with `{ error: "version conflict",
+currentVersionHash }` instead of overwriting concurrent changes, and
+  successful writes echo back the new `versionHash`. The Design app's
+  `write-local-file` and `read-local-file` actions and the code workbench's
+  localhost workspace provider forward this version chain end to end, and the
+  workbench now polls open localhost tabs every 5 seconds so external edits
+  (made directly on disk or by the agent through the bridge) show up without a
+  manual reload.
+
+- 622d552: Keep Electron Google sign-in polling active after the desktop app regains focus.
+- 622d552: Add server helpers for the Builder Fusion app-building backend: ensure branch
+  containers and resolve preview URLs, send fire-and-forget prompts to the
+  in-container coding agent, push branch code to git, reserve hosting slugs, and
+  trigger/poll hosted deploys.
+- 622d552: Make durable agent run recovery quieter by idempotently handling retried run rows and waiting longer for server-owned background continuations.
+- 622d552: Emit PostHog-compatible `$ai_generation` tracking events from instrumented agent runs so LLM cost, latency, tokens, and errors can flow through configured tracking providers, and expose the shared database admin page through the client barrel for app-owned admin surfaces.
+- 622d552: Persist local Plan bridge comments to comments.json so local visual plans and recaps can collect feedback without hosted database writes.
+- 622d552: Upgrade React Router to 8.1.0 to silence Vite's deprecated `envFile` warning during dev startup.
+- 622d552: Remove retired scaffold aliases from template catalogs and app pickers.
+- 622d552: Fix duplicate tool-call cards and parallel duplicate text streaming in agent chat: the reconnect reader and the adapter's own stream can no longer attach to the same run concurrently (single-reader ownership — reconnect probes skip while the adapter runtime is live, and an adapter takeover aborts any active reconnect reader and discards its accumulator), journal/ledger-replayed tool results now merge into the original card instead of rendering a second stuck-spinner copy, and reconnect content drops pending tool cards whose call already completed in the rendered messages.
+- 622d552: Add shared visual style controls for template editor inspector surfaces.
+- 622d552: Add `/visualize-repo` and a local visual docs CLI for repo-backed Plan workspaces.
+
+## 0.85.7
+
+### Patch Changes
+
+- b2e1b6c: Fix presence local-echo re-renders and coalesce pinch-zoom updates through requestAnimationFrame. `usePresence` no longer re-derives and re-renders subscribers when an awareness "change" event only reflects the local client's own state (e.g. cursor/selection echoes), and `usePinchZoom` now batches wheel and touch pinch zoom updates to at most one state update per animation frame instead of one per input event. When multiple wheel events land in the same animation frame, the cursor-anchored scroll compensation now accumulates across all of them (matching the pre-batching, one-event-at-a-time result) instead of anchoring later events in the burst against the stale pre-burst scroll position.
+
 ## 0.85.6
 
 ### Patch Changes
@@ -4857,7 +4987,6 @@ alt? }>`. A self-contained ProseMirror plugin wires paste-image and
 ### Patch Changes
 
 - 966838d: Propagate agent team parent thread metadata through background runs.
-- 966838d: Expose the Contracts template in public metadata with its dedicated icon alias.
 - 966838d: Stop a dropped Neon connection from crashing the whole serverless function. `@neondatabase/serverless` mirrors `pg-pool`, which removes its idle `error` listener while a client is checked out — so a WebSocket that drops mid-query (Lambda freeze/thaw, Neon "terminating connection due to administrator command", an idle socket the pooler closed) made the client emit an `error` event with no listener, which Node escalated to an uncaught exception that killed the function. This was the single highest-volume production crash. `attachNeonPoolErrorLogger` now attaches a persistent `error` listener to every client at connect time (covering all three pools — app, per-app, and Better Auth), so a dropped connection degrades to a logged warning and a reconnect on the next query instead of a process crash.
 
 ## 0.32.16

package/corpus/core/README.md

@@ -113,17 +113,6 @@ Generate and edit React-based presentations via prompt or point-and-click.
 <tr>
 <td width="33%" align="center" valign="top">
 
-**Video**
-
-<a href="https://agent-native.com/templates/video"><img src="https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F6b8bfcc18a1d4c47a491da3b2d4148a4?format=webp&width=800" alt="Video template" width="100%" /></a>
-
-**Agent-Native video editing**
-
-Create and edit Remotion video compositions with agent assistance.
-
-</td>
-<td width="33%" align="center" valign="top">
-
 **Analytics**
 
 <a href="https://agent-native.com/templates/analytics"><img src="https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F4933a80cc3134d7e874631f688be828a?format=webp&width=800" alt="Analytics template" width="100%" /></a>

package/corpus/core/docs/content/cloneable-saas.mdx

@@ -22,7 +22,6 @@ Each one is a real app you could use today, and the launching pad for your own v
 | [**Brain**](/docs/template-brain)         | Clean company chat backed by cited institutional memory, approved sources, review gates, and citations.        |
 | [**Assets**](/docs/template-assets)       | Digital asset manager for brand libraries, uploads, references, and on-brand image/video generation.           |
 | [**Slides**](/docs/template-slides)       | An agent-native Google Slides. React-based decks the agent generates and edits directly.                       |
-| [**Video**](/docs/template-videos)        | Programmatic motion graphics and product-demo videos on Remotion.                                              |
 | [**Analytics**](/docs/template-analytics) | An agent-native Amplitude/Mixpanel. Connect data sources, prompt for charts, pin to dashboards.                |
 | [**Clips**](/docs/template-clips)         | Async screen + camera recording with transcription, chapters, and AI summaries.                                |
 | [**Design**](/docs/template-design)       | Agent-native HTML prototyping studio for interactive Alpine/Tailwind designs.                                  |

package/corpus/core/docs/content/locales/ar-SA/cloneable-saas.mdx

@@ -22,7 +22,6 @@ description: "ابتكر منتج SaaS فعالاً واجعله ملكك - بم
 | [**Brain**](/docs/template-brain)         | دردشة واضحة للشركة مدعومة بالذاكرة المؤسسية المستشهد بها، والمصادر المعتمدة، وبوابات المراجعة، والاستشهادات.                               |
 | [**Assets**](/docs/template-assets)       | مدير الأصول الرقمية لمكتبات العلامات التجارية، والتحميلات، والمراجع، وإنشاء الصور/مقاطع الفيديو المتعلقة بالعلامة التجارية.                |
 | [**Slides**](/docs/template-slides)       | عروض Google التقديمية الأصلية للوكيل. التشكيلات المستندة إلى React يقوم الوكيل بإنشائها وتحريرها مباشرة.                                   |
-| [**Video**](/docs/template-videos)        | رسومات متحركة آلية ومقاطع فيديو توضيحية للمنتج على Remotion.                                                                               |
 | [**Analytics**](/docs/template-analytics) | السعة/Mixpanel الأصلية للوكيل. قم بتوصيل مصادر البيانات، والمطالبة بالمخططات، والتثبيت على لوحات المعلومات.                                |
 | [**Clips**](/docs/template-clips)         | شاشة غير متزامنة + تسجيل بالكاميرا مع النسخ والفصول وملخصات الذكاء الاصطناعي.                                                              |
 | [**Design**](/docs/template-design)       | استوديو النماذج الأولية HTML للوكيل الأصلي لتصميمات Alpine/Tailwind التفاعلية.                                                             |

package/corpus/core/docs/content/locales/ar-SA/plan-plugin.mdx

@@ -1,20 +1,20 @@
 ---
 title: "المكون الإضافي للخطة والسوق"
-description: "قم بتثبيت خطة Agent-Native skills (/visual-plan، /visual-recap) بالإضافة إلى موصل Plan MCP المستضاف كرمز Claude أو مكون إضافي Codex، أو باستخدام CLI العام. كيفية عمل التحديثات وما إذا كنت بحاجة إلى إرسال أي شيء."
+description: "قم بتثبيت مهارات Agent-Native Plan (/visual-plan، /visual-recap، /visualize-repo) بالإضافة إلى موصل Plan MCP المستضاف كمكوّن Claude Code أو Codex، أو باستخدام CLI العام. كيفية عمل التحديثات وما إذا كنت بحاجة إلى إرسال أي شيء."
 ---
 
 # المكون الإضافي للخطة والسوق
 
-يأتي تطبيق Agent-Native **Plan** كحزمة واحدة قابلة للتثبيت. يؤدي التثبيت الفردي إلى إضافة أمر الشرطة المائلة للخطة skills ** و** إلى موصل Plan MCP المستضاف، حتى يتمكن الوكيل من إنشاء الخطط ويمكن لـ skills نشرها مباشرة في تطبيق الخطة.
+يأتي تطبيق Agent-Native **Plan** كحزمة واحدة قابلة للتثبيت. يضيف التثبيت الواحد مهارات أوامر Plan المائلة **و** يوصّل موصل Plan MCP المستضاف، حتى يتمكن الوكيل من إنشاء الخطط ويمكن للمهارات نشرها مباشرة في تطبيق Plan.
 
 ## ما تحصل عليه {#what-you-get}
 
 تمنحك عملية التثبيت الواحدة ما يلي:
 
-- **اثنان skills** — `/visual-plan` (نقطة الدخول الأساسية) و`/visual-recap`.
+- **ثلاث skills** — `/visual-plan` (نقطة الدخول الأساسية)، و`/visual-recap`، و`/visualize-repo`.
 - **موصل Plan MCP** — مسجل في التطبيق المستضاف على `https://plan.agent-native.com` (نقطة نهاية MCP `https://plan.agent-native.com/_agent-native/mcp`، اسم الخادم `plan`).
 
-<Diagram id="doc-block-10bw7bb" title={"ثلاث طرق، حزمة واحدة"} summary={"يقوم كل من المكون الإضافي CLI، وClaude Code، والمكون الإضافي Codex بتثبيت نفس المهارتين بالإضافة إلى موصل الخطة المستضاف."}>
+<Diagram id="doc-block-10bw7bb" title={"ثلاث طرق، حزمة واحدة"} summary={"يقوم كل من CLI العام ومكوّن Claude Code ومكوّن Codex بتثبيت مهارات Plan نفسها بالإضافة إلى موصل Plan المستضاف."}>
 
 ```html
 <div class="diagram-routes">
@@ -37,7 +37,8 @@ description: "قم بتثبيت خطة Agent-Native skills (/visual-plan، /visu
   <div class="diagram-panel center">
     <span class="diagram-pill accent">/visual-plan</span
     ><span class="diagram-pill accent">/visual-recap</span
-    ><small class="diagram-muted">two skills</small>
+    ><span class="diagram-pill accent">/visualize-repo</span
+    ><small class="diagram-muted">three skills</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-box">
@@ -78,7 +79,7 @@ description: "قم بتثبيت خطة Agent-Native skills (/visual-plan، /visu
 
 </Diagram>
 
-افتراضيًا، يقوم كل من skills بالنشر على تطبيق الخطة المستضاف - حيث يقومان بإنشاء خطة عبر
+افتراضيًا، ينشر `/visual-plan` و`/visual-recap` إلى تطبيق Plan المستضاف — فهما ينشئان خطة عبر
 موصل MCP ويسلمك رابطًا أو خطة مضمنة للمراجعة. إنهم لا يتخلصون أبدًا
 خطة Markdown/ASCII المضمنة في الدردشة باعتبارها التسليم. إذا كانت أداة الخطة
 إرجاع `needs auth`، أو `Unauthorized`، أو `Session terminated`، وإعادة المصادقة
@@ -194,13 +195,13 @@ npx @agent-native/core@latest plan local serve --dir plans/<slug> --kind plan --
 
 ### مسار المهارة العالمي (أي مضيف MCP) {#universal}
 
-يعمل مع أي مضيف - Claude Code، وCodex، وCursor، وCline، وGoose، وتطبيقات ChatGPT المخصصة MCP، وClaude Cowork، وأي شيء آخر متوافق مع MCP. يقوم Agent-Native CLI بتثبيت كل من skills، وتسجيل موصل الخطة المستضافة MCP، ** وتشغيل المصادقة للعميل (العملاء) المحليين المحددين في نفس الخطوة **، بحيث لا يصل استدعاء الأداة الأول إلى جدار OAuth:
+يعمل مع أي مضيف — Claude Code وCodex وCursor وCline وGoose وتطبيقات ChatGPT المخصصة MCP وClaude Cowork وأي شيء آخر متوافق مع MCP. يثبت Agent-Native CLI مهارات Plan، ويسجل موصل Plan MCP المستضاف، **ويشغل المصادقة للعميل (العملاء) المحليين المحددين في نفس الخطوة**، حتى لا يصطدم أول استدعاء للأداة بجدار OAuth:
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-يؤدي هذا إلى تثبيت `visual-plan` بالإضافة إلى مهارة `visual-recap` المصاحبة، ثم تسجيل موصل `plan`، ثم تشغيل المصادقة (مطالبة OAuth بالمشاركة المستضافة/المدعومة بالحساب). إشارات مفيدة:
+يؤدي هذا إلى تثبيت `visual-plan` بالإضافة إلى مهارتي `visual-recap` و`visualize-repo` المصاحبتين، ثم تسجيل موصل `plan`، ثم تشغيل المصادقة (مطالبة OAuth للمشاركة المستضافة/المدعومة بالحساب). إشارات مفيدة:
 
 - `--client codex|claude-code|claude-code-cli|cowork|all` — أي الوكلاء المحليين سيكتبون تهيئة MCP لهم (`all` الافتراضي).
 - `--no-connect` - تسجيل الموصل دون المصادقة؛ قم بتشغيل `npx @agent-native/core@latest connect https://plan.agent-native.com --client all` لاحقًا، أو اختر `--client` الأضيق.
@@ -236,7 +237,7 @@ npx @agent-native/core@latest recap doctor
 /mcp        # authenticate the Plan connector (one OAuth approval)
 ```
 
-يضيف `/plugin install` كلاً من الخطة skills وتكوين **URL فقط** MCP (لا توجد أسرار في الحزمة)؛ `/mcp` → **المصادقة** تكمل مصافحة OAuth. استخدم المسار CLI العالمي بدلاً من ذلك عندما تريد ملفات محلية أو وضع الاستضافة الذاتية.
+`/plugin install` يضيف مهارات Plan وتكوين MCP **خاصًا بعنوان URL فقط** (لا توجد أسرار في الحزمة)؛ `/mcp` → **المصادقة** تكمل مصافحة OAuth. استخدم مسار CLI العام بدلاً من ذلك عندما تريد الملفات المحلية أو وضع الاستضافة الذاتية.
 
 > يُسمى كتالوج السوق `agent-native-apps` والمكون الإضافي للخطة هو `agent-native-visual-plans`، لذا يكون هدف التثبيت دائمًا هو `agent-native-visual-plans@agent-native-apps`.
 

package/corpus/core/docs/content/locales/ar-SA/sharing.mdx

@@ -5,7 +5,7 @@ description: "المشاركة بأسلوب Google-Docs، المضمنة في إ
 
 # المشاركة والخصوصية
 
-كل مورد ينشئه المستخدم في تطبيق وكيل أصلي - مستند، أو لوحة معلومات، أو تصميم، أو مجموعة، أو تحرير فيديو، أو تسجيل شاشة، أو نص اجتماع، أو نموذج، أو رابط حجز - يكون **خاصًا بالمنشئ بشكل افتراضي**. ولا يراها الأشخاص الآخرون إلا عندما يشاركها منشئ المحتوى بشكل صريح، أو يغير مستوى رؤيتها إلى `org` أو `public`.
+كل مورد ينشئه المستخدم في تطبيق وكيل أصلي - مستند، أو لوحة معلومات، أو تصميم، أو مجموعة، أو تسجيل شاشة، أو نص اجتماع، أو نموذج، أو رابط حجز - يكون **خاصًا بالمنشئ بشكل افتراضي**. ولا يراها الأشخاص الآخرون إلا عندما يشاركها منشئ المحتوى بشكل صريح، أو يغير مستوى رؤيتها إلى `org` أو `public`.
 
 يبدو ويعمل مثل مستندات Google. نفس زر المشاركة، ونفس مربع الحوار، ونفس نموذج الرؤية ثلاثي المستويات، ونفس المنح لكل مستخدم/لكل مؤسسة - عبر كل قالب، بدون إعادة اختراع لكل تطبيق.
 
@@ -92,7 +92,6 @@ description: "المشاركة بأسلوب Google-Docs، المضمنة في إ
 - **المحتوى** — المستندات
 - **الشرائح** — التشكيلات
 - **التصميم** — التصاميم والأصول
-- **الفيديو** — المقطوعات الموسيقية
 - **المقاطع** — تسجيلات الشاشة (نمط المنوال)
 - **النماذج** — تعريفات النماذج
 - **التقويم** — الأحداث وروابط الحجز

package/corpus/core/docs/content/locales/ar-SA/skills-guide.mdx

@@ -118,9 +118,7 @@ Skills موجود في `.agents/skills/<name>/SKILL.md` ويحتوي على إر
 
 ## skills المدعوم بالتطبيق {#app-backed-skills}
 
-تشمل skills المدعومة بالتطبيق حاليا `visual-plan` و`visual-recap` من Plan،
-و`visual-edit` من Design، و`assets` من Assets، و`content` لتحرير docs/blog/MDX
-من المستودع.
+تشمل skills المدعومة بالتطبيق حاليًا `visual-plan` و`visual-recap` و`visualize-repo` من Plan، و`visual-edit` من Design، و`assets` من Assets، و`content` لتحرير docs/blog/MDX المدعوم بالمستودع.
 
 تحزم skills المدعومة بالتطبيق تطبيقًا أصليًا للوكيل باعتباره قطعة أثرية في سوق المهارات. يمكن أن تتضمن الحزمة تعليمات الوكيل، وبيانات تعريف موصل skills المصدرة، وتعليمات التشغيل المستضافة/المحلية، وأسطح UI مثل تطبيقات MCP.
 
@@ -332,6 +330,7 @@ scope: dev
 ```bash
 # المسار السعيد: التعليمات المصدرة بالإضافة إلى موصل MCP المستضاف.
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visualize-repo
 npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 

package/corpus/core/docs/content/locales/ar-SA/template-plan.mdx

@@ -5,12 +5,7 @@ description: "تعمل خطط Agent-Native على تحويل خطة وكيل ا
 
 # الخطط المرئية
 
-> **يقوم معظم الأشخاص بتثبيت الخطة كمهارة، وليس كتطبيق داعم.** أمر CLI واحد
-> يضيف `/visual-plan` و`/visual-recap` skills بالإضافة إلى الخطة المستضافة
-> بوكيل الترميز الخاص بك — راجع [Plan plugin & marketplace](/docs/plan-plugin)
-> للمكون الإضافي ومسارات السوق. تفرع قالب الخطة (مغطى تحت
-> [For developers](#for-developers)) هو المسار الثانوي للاستضافة الذاتية أو
-> البناء على الخطة نفسها.
+> **يقوم معظم الأشخاص بتثبيت Plan كمهارة، وليس كتطبيق داعم.** يضيف أمر CLI واحد مهارات `/visual-plan` و`/visual-recap` و`/visualize-repo` بالإضافة إلى موصل Plan المستضاف إلى وكيل الترميز الخاص بك — راجع [Plan plugin & marketplace](/docs/plan-plugin) لمسارات الإضافة والسوق. يبقى تفريع قالب Plan (الموضح في [For developers](#for-developers)) هو المسار الثانوي للاستضافة الذاتية أو البناء على Plan نفسه.
 
 خطط Agent-Native هي وضع خطة مرئية لوكلاء الترميز. يتحول إلى عادي
 Codex، أو رمز Claude، أو Markdown، أو خطة التنفيذ الملصقة في خطة منظمة
@@ -115,7 +110,7 @@ Codex، أو رمز Claude، أو Markdown، أو خطة التنفيذ المل
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-يقوم الأمر بتثبيت كلا الأمرين: `/visual-plan` و`/visual-recap`.
+يقوم الأمر بتثبيت ثلاثة أوامر: `/visual-plan` و`/visual-recap` و`/visualize-repo`.
 
 إذا كنت تستخدم مضيفًا يستند إلى الدردشة ويقبل موصل MCP URLs مباشرةً
 (بدلاً من عميل تم تكوينه بواسطة CLI)، قم بتوصيل موصل الخطط المستضاف على
@@ -358,6 +353,25 @@ http://localhost:<port>/local-plans/<slug>?path=plans%2F<slug>
 جعل LLM محليًا لوكيل الترميز الخاص بك تلقائيًا؛ اختر محليًا أو معتمدًا
 نموذج إذا كانت حدود الخصوصية هذه مهمة أيضًا.
 
+## المستندات المرئية للمستودع {#visualize-repo}
+
+استخدم `/visualize-repo` عندما تريد طبقة توثيق مرئية ودائمة لقاعدة الكود بدلاً من خطة أو ملخص لمرة واحدة. ينشئ أو يفتح مساحة عمل Plan MDX محلية، ويحدّث `agent-native.json` بقسم `apps.visualize-repo` في وضع local-files، ويعرض المستندات عبر جسر localhost نفسه:
+
+```bash
+npx @agent-native/core@latest visualize-repo --open
+```
+
+إذا لم يكن `agent-native.json` موجودًا، يبدأ الأمر ملفًا جديدًا ويوصي بمجموعة بداية صغيرة من بنية المستودع، مثل `actions/` و`app/components/` و`app/pages/` و`server/db/schema.ts` و`src/` و`packages/` و`templates/` و`docs/` أو `content/`. يمكنك استهداف نقاط ربط مصدر محددة:
+
+```bash
+npx @agent-native/core@latest visualize-repo \
+  --target actions/webhooks.ts \
+  --target server/db/schema.ts \
+  --target app/components/PromptComposer.tsx
+```
+
+يعيش مجلد البداية افتراضيًا في `.agent-native/visual-docs/repo-overview`. تبقى التعليقات محلية في `comments.json`، حتى يتمكن المراجعون من تحديد الأقسام لوكيل برمجة، ويمكن للوكيل تحديث الكود وملفات MDX في التغيير نفسه. شغّل `visualize-repo check` للفحص المحلي، و`visualize-repo verify` عندما تريد أن يتحقق مخطط عارض Plan من MDX.
+
 ## مزامنة الملفات المحلية على سطح المكتب {#desktop-local-sync}
 
 يوفر Agent Native Desktop أيضًا للخطط المستضافة جسر مجلد محلي أصلي. هذا
@@ -410,6 +424,8 @@ http://localhost:<port>/local-plans/<slug>?path=plans%2F<slug>
 - "استخدم `/visual-recap` في الفرق بين `main` وهذا الفرع."
 - "استخدم `/visual-recap` في وضع الملفات المحلية حتى لا تتم كتابة محتوى التلخيص في قاعدة بيانات الخطة."
 
+- "قم بتشغيل `/visualize-repo` وابدأ بإجراءات API العامة والمخطط لدينا."
+
 ## الاسترداد من أخطاء المصادقة {#auth-errors}
 
 إذا قامت أداة الخطط بإرجاع `needs auth` أو `Unauthorized` أو `Session

package/corpus/core/docs/content/locales/ar-SA/tracking.mdx

@@ -235,7 +235,7 @@ VITE_AGENT_NATIVE_SESSION_REPLAY_SAMPLE_RATE=0.1
 - يتم تنظيف عناوين URL باستخدام نفس مساعد `scrubUrl()` المستخدم بواسطة تحليلات المتصفح.
 - التقاط إعادة التشغيل مخصص للويب فقط وباختيار المستخدم؛ فهو لا يسجل شاشات سطح المكتب الأصلية.
 
-أثناء التسجيل، تلتقط إعادة تشغيل الجلسة أيضًا مخرجات وحدة تحكم المتصفح (`log`، و`info`، و`warn`، و`error`، و`debug`، بالإضافة إلى `error` / `unhandledrejection` الخاصة بالنافذة) وبيانات وصفية لطلبات الشبكة (`fetch` و XHR) كأحداث rrweb مخصصة موسومة، بحيث يمكن للوكلاء وعارض إعادة التشغيل تصحيح المشكلات التي يبلغ عنها المستخدمون. الالتقاط مفعّل افتراضيًا عند تفعيل إعادة التشغيل؛ اضبطه أو عطّله باستخدام خياري `sessionReplay.console` و`sessionReplay.network`، حيث يقبل كل منهما قيمة منطقية (boolean) أو كائن خيارات. لا يتم التقاط نصوص/رؤوس الطلبات والاستجابات مطلقًا، ويتم تنظيف عناوين URL، ويتم اقتطاع الرسائل، ويُستثنى حركة استيعاب/تتبع المسجِّل نفسه، وتضيف ميزانيات كل جلسة (1000 حدث وحدة تحكم / 2000 حدث شبكة) إشعار اقتطاع عند تجاوزها.
+أثناء التسجيل، تلتقط إعادة تشغيل الجلسة أيضًا مخرجات وحدة تحكم المتصفح (`log`، و`info`، و`warn`، و`error`، و`debug`، بالإضافة إلى `error` / `unhandledrejection` الخاصة بالنافذة) وبيانات وصفية لطلبات الشبكة (`fetch` و XHR) كأحداث rrweb مخصصة موسومة، بحيث يمكن للوكلاء وعارض إعادة التشغيل تصحيح المشكلات التي يبلغ عنها المستخدمون. الالتقاط مفعّل افتراضيًا عند تفعيل إعادة التشغيل؛ اضبطه أو عطّله باستخدام خياري `sessionReplay.console` و`sessionReplay.network`، حيث يقبل كل منهما قيمة منطقية (boolean) أو كائن خيارات (`{ maxEvents?: number }`، مع قبول `network` إضافيًا لـ `captureErrorBodies` و`maxErrorBodyLength`). لا يتم التقاط نصوص/رؤوس الطلبات مطلقًا؛ أما نصوص الاستجابات فلا تُلتقط إلا كمقتطف محدود ومُنقّح لاستجابات 5xx (أخطاء الخادم) فقط (`captureErrorBodies`، الافتراضي true، بحد أقصى `maxErrorBodyLength` حرفًا، الافتراضي 2048) — استجابات غير 5xx وحالات فشل الشبكة لا تحمل أي نص استجابة أبدًا. يتم تنظيف عناوين URL، ويتم اقتطاع الرسائل، ويُستثنى حركة استيعاب/تتبع المسجِّل نفسه، وتضيف ميزانيات كل جلسة (1000 حدث وحدة تحكم / 2000 حدث شبكة) إشعار اقتطاع عند تجاوزها.
 
 يخزّن قالب Analytics بيانات إعادة التشغيل الوصفية في SQL (`session_recordings`) ويخزّن الأجزاء عبر مراجع blob خاصة (`session_replay_chunks`). لا تتلقى المتصفحات والوكلاء أبدًا عناوين URL الخاصة بالموفر. تمر إعادة التشغيل عبر مسارات خادم محددة النطاق، وتُرجع أدوات الوكيل الافتراضية ملخصات أو أحداث إعادة تشغيل محدودة، وليس وصولاً خامًا إلى جدول الأجزاء.
 

package/corpus/core/docs/content/locales/ar-SA/workspace-connections.mdx

@@ -255,17 +255,17 @@ if (workspaceConnectionProviderSupports("slack", "messages")) {
 
 معرفات الموفر الأولية هي:
 
-| المزود         | القدرات                                 | الاستخدامات الشائعة            |
-| -------------- | --------------------------------------- | ------------------------------ |
-| `slack`        | البحث والاستيراد والرسائل               | العقل، الإرسال، التحليلات      |
-| `github`       | البحث والاستيراد والرمز والمستندات      | العقل، التحليلات، الإرسال      |
-| `notion`       | بحث، استيراد، مستندات                   | العقل، المحتوى، الإرسال        |
-| `gmail`        | البحث والاستيراد والرسائل               | البريد، العقل، الإرسال         |
-| `google_drive` | البحث والاستيراد والمستندات             | العقل، المحتوى، الشرائح        |
-| `hubspot`      | بحث، استيراد، إدارة علاقات العملاء      | التحليلات والدماغ والبريد      |
-| `granola`      | البحث والاستيراد والاجتماعات والمستندات | العقل، التقويم، الإرسال        |
-| `clips`        | البحث والاستيراد والاجتماعات            | الدماغ والمقاطع ومقاطع الفيديو |
-| `generic`      | البحث والاستيراد والمستندات             | webhooks مخصص وإسقاط الملفات   |
+| المزود         | القدرات                                 | الاستخدامات الشائعة          |
+| -------------- | --------------------------------------- | ---------------------------- |
+| `slack`        | البحث والاستيراد والرسائل               | العقل، الإرسال، التحليلات    |
+| `github`       | البحث والاستيراد والرمز والمستندات      | العقل، التحليلات، الإرسال    |
+| `notion`       | بحث، استيراد، مستندات                   | العقل، المحتوى، الإرسال      |
+| `gmail`        | البحث والاستيراد والرسائل               | البريد، العقل، الإرسال       |
+| `google_drive` | البحث والاستيراد والمستندات             | العقل، المحتوى، الشرائح      |
+| `hubspot`      | بحث، استيراد، إدارة علاقات العملاء      | التحليلات والدماغ والبريد    |
+| `granola`      | البحث والاستيراد والاجتماعات والمستندات | العقل، التقويم، الإرسال      |
+| `clips`        | البحث والاستيراد والاجتماعات            | الدماغ والمقاطع              |
+| `generic`      | البحث والاستيراد والمستندات             | webhooks مخصص وإسقاط الملفات |
 
 مفاتيح بيانات الاعتماد هي أسماء فقط، مثل `SLACK_BOT_TOKEN` أو `GITHUB_TOKEN`. يجب ألا تتضمن البيانات الوصفية للموفر أبدًا قيم بيانات اعتماد فعلية.
 

package/corpus/core/docs/content/locales/de-DE/cloneable-saas.mdx

@@ -22,7 +22,6 @@ Jede davon ist eine echte App, die Sie heute verwenden können, und die Startram
 | [**Brain**](/docs/template-brain)         | Sauberer Unternehmenschat, gestützt durch zitiertes institutionelles Gedächtnis, genehmigte Quellen, Überprüfungstore und Zitate.                          |
 | [**Assets**](/docs/template-assets)       | Digital Asset Manager für Markenbibliotheken, Uploads, Referenzen und die Erstellung von markenbezogenen Bildern/Videos.                                   |
 | [**Slides**](/docs/template-slides)       | Eine agentennative Google Slides. React-basierte Decks, die der Agent direkt generiert und bearbeitet.                                                     |
-| [**Video**](/docs/template-videos)        | Programmatische Bewegungsgrafiken und Produktdemovideos zu Remotion.                                                                                       |
 | [**Analytics**](/docs/template-analytics) | Ein agentennatives Amplitude/Mixpanel. Datenquellen verbinden, Diagramme anfordern, an Dashboards anpinnen.                                                |
 | [**Clips**](/docs/template-clips)         | Asynchrone Bildschirm- und Kameraaufzeichnung mit Transkription, Kapiteln und KI-Zusammenfassungen.                                                        |
 | [**Design**](/docs/template-design)       | Agent-natives HTML-Prototyping-Studio für interaktive Alpine/Tailwind-Designs.                                                                             |

package/corpus/core/docs/content/locales/de-DE/plan-plugin.mdx

@@ -1,20 +1,20 @@
 ---
 title: "Plugin und Marktplatz planen"
-description: "Installieren Sie den Agent-Native-Plan skills (/visual-plan, /visual-recap) sowie den gehosteten Plan MCP-Connector als Claude-Code oder Codex-Plugin oder mit dem universellen CLI. Wie Updates funktionieren und ob Sie etwas einreichen müssen."
+description: "Installieren Sie die Agent-Native-Plan-Skills (/visual-plan, /visual-recap, /visualize-repo) sowie den gehosteten Plan-MCP-Connector als Claude-Code- oder Codex-Plugin oder mit der universellen CLI. Wie Updates funktionieren und ob Sie etwas einreichen müssen."
 ---
 
 # Plugin und Marktplatz planen
 
-Die Agent-Native **Plan**-App wird als ein installierbares Paket geliefert. Eine einzige Installation fügt sowohl den Plan-Slash-Befehl skills hinzu **und** verkabelt den gehosteten Plan-MCP-Connector, sodass der Agent Pläne generieren und der skills sie direkt in der Plan-App veröffentlichen kann.
+Die Agent-Native **Plan**-App wird als ein installierbares Paket geliefert. Eine einzige Installation fügt die Plan-Slash-Command-Skills hinzu **und** verbindet den gehosteten Plan-MCP-Connector, sodass der Agent Pläne generieren und die Skills sie direkt in der Plan-App veröffentlichen können.
 
 ## Was Sie bekommen {#what-you-get}
 
 Eine Installation bietet Ihnen:
 
-- **Zwei skills** – `/visual-plan` (der kanonische Einstiegspunkt) und `/visual-recap`.
+- **Drei Skills** – `/visual-plan` (der kanonische Einstiegspunkt), `/visual-recap` und `/visualize-repo`.
 - **Der Plan MCP-Connector** – registriert für die gehostete App unter `https://plan.agent-native.com` (MCP-Endpunkt `https://plan.agent-native.com/_agent-native/mcp`, Servername `plan`).
 
-<Diagram id="doc-block-zzy087" title="Drei Routen, ein Paket" summary="Die universellen Plugins CLI, Claude Code und Codex installieren alle dieselben zwei Skills sowie den gehosteten Plan-Connector.">
+<Diagram id="doc-block-zzy087" title="Drei Routen, ein Paket" summary={"Die universelle CLI, das Claude-Code-Plugin und das Codex-Plugin installieren alle dieselben Plan-Skills plus den gehosteten Plan-Connector."}>
 
 ```html
 <div class="diagram-routes">
@@ -37,7 +37,8 @@ Eine Installation bietet Ihnen:
   <div class="diagram-panel center">
     <span class="diagram-pill accent">/visual-plan</span
     ><span class="diagram-pill accent">/visual-recap</span
-    ><small class="diagram-muted">two skills</small>
+    ><span class="diagram-pill accent">/visualize-repo</span
+    ><small class="diagram-muted">three skills</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-box">
@@ -78,7 +79,7 @@ Eine Installation bietet Ihnen:
 
 </Diagram>
 
-Standardmäßig veröffentlichen beide skills in der gehosteten Plan-App – sie erstellen einen Plan über
+Standardmäßig veröffentlichen `/visual-plan` und `/visual-recap` in der gehosteten Plan-App – sie erstellen einen Plan über
 den MCP-Anschluss und überreichen Ihnen einen Link oder einen Inline-Plan zur Überprüfung. Sie entleeren nie
 ein Inline-Plan Markdown/ASCII im Chat als Ergebnis. Wenn ein Plan-Tool
 gibt `needs auth`, `Unauthorized` oder `Session terminated` zurück, erneut authentifizieren
@@ -194,13 +195,13 @@ Es gibt drei Möglichkeiten. Die **universelle CLI-Route** ist diejenige, die wi
 
 ### Universelle Skill-Route (jeder MCP-Host) {#universal}
 
-Funktioniert für jeden Host – Claude Code, Codex, Cursor, Cline, Goose, benutzerdefinierte MCP-Apps von ChatGPT, Claude Cowork und alles andere, was mit MCP kompatibel ist. Der Agent-Native CLI installiert beide skills, registriert den gehosteten Plan MCP-Connector **und führt im selben Schritt die Authentifizierung für die ausgewählten lokalen Clients aus**, sodass Ihr erster Tool-Aufruf nicht auf eine OAuth-Wand stößt:
+Funktioniert für jeden Host – Claude Code, Codex, Cursor, Cline, Goose, benutzerdefinierte MCP-Apps von ChatGPT, Claude Cowork und alles andere, was mit MCP kompatibel ist. Die Agent-Native CLI installiert die Plan-Skills, registriert den gehosteten Plan-MCP-Connector **und führt im selben Schritt die Authentifizierung für die ausgewählten lokalen Clients aus**, sodass Ihr erster Tool-Aufruf nicht auf eine OAuth-Wand stößt:
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-Dadurch werden `visual-plan` und der begleitende `visual-recap`-Skill installiert, dann wird der `plan`-Connector registriert und dann wird die Authentifizierung ausgeführt (OAuth-Eingabeaufforderung für gehostete/kontogestützte Freigabe). Nützliche Flags:
+Dadurch werden `visual-plan` sowie die begleitenden Skills `visual-recap` und `visualize-repo` installiert, dann wird der `plan`-Connector registriert und anschließend die Authentifizierung ausgeführt (OAuth-Eingabeaufforderung für gehostete/kontogestützte Freigabe). Nützliche Flags:
 
 - `--client codex|claude-code|claude-code-cli|cowork|all` – welche lokalen Agenten die MCP-Konfiguration schreiben sollen (Standard `all`).
 - `--no-connect` – Registrieren Sie den Connector ohne Authentifizierung. Führen Sie `npx @agent-native/core@latest connect https://plan.agent-native.com --client all` später aus oder wählen Sie ein schmaleres `--client`.
@@ -236,7 +237,7 @@ Das öffentliche `BuilderIO/agent-native`-Repo ist selbst ein Claude-Code-Plugin
 /mcp        # authenticate the Plan connector (one OAuth approval)
 ```
 
-`/plugin install` fügt sowohl den Plan skills als auch eine **nur für URL** verfügbare MCP-Konfiguration hinzu (keine Geheimnisse im Paket); `/mcp` → **Authentifizieren** schließt den OAuth-Handshake ab. Verwenden Sie stattdessen die universelle CLI-Route, wenn Sie lokale Dateien oder den selbstgehosteten Modus wünschen.
+`/plugin install` fügt die Plan-Skills und eine **nur für URLs** verfügbare MCP-Konfiguration hinzu (keine Geheimnisse im Paket); `/mcp` → **Authenticate** schließt den OAuth-Handshake ab. Verwenden Sie stattdessen die universelle CLI-Route, wenn Sie lokale Dateien oder den selbstgehosteten Modus wünschen.
 
 > Der Marktplatzkatalog heißt `agent-native-apps` und das Plan-Plugin heißt `agent-native-visual-plans`, daher ist das Installationsziel immer `agent-native-visual-plans@agent-native-apps`.
 

package/corpus/core/docs/content/locales/de-DE/sharing.mdx

@@ -5,7 +5,7 @@ description: "Freigabe im Google-Docs-Stil, in das Framework integriert. Jede vo
 
 # Freigabe und Datenschutz
 
-Jede Ressource, die ein Benutzer in einer agentennativen App erstellt – ein Dokument, ein Dashboard, ein Design, eine Präsentation, eine Videobearbeitung, eine Bildschirmaufzeichnung, ein Besprechungsprotokoll, ein Formular, ein Buchungslink – ist **standardmäßig privat für den Ersteller**. Andere sehen es nur, wenn der Ersteller es ausdrücklich teilt oder seine Sichtbarkeit in `org` oder `public` ändert.
+Jede Ressource, die ein Benutzer in einer agentennativen App erstellt – ein Dokument, ein Dashboard, ein Design, eine Präsentation, eine Bildschirmaufzeichnung, ein Besprechungsprotokoll, ein Formular, ein Buchungslink – ist **standardmäßig privat für den Ersteller**. Andere sehen es nur, wenn der Ersteller es ausdrücklich teilt oder seine Sichtbarkeit in `org` oder `public` ändert.
 
 Es sieht aus und funktioniert wie Google Docs. Die gleiche Schaltfläche zum Teilen, derselbe Dialog, das gleiche dreistufige Sichtbarkeitsmodell, die gleichen Gewährungen pro Benutzer/pro Organisation – für jede Vorlage, ohne Neuerfindung pro App.
 
@@ -92,7 +92,6 @@ Jede Vorlage, die vom Benutzer erstellte Arbeiten speichert, verwendet dieses Mo
 - **Inhalt** – Dokumente
 - **Folien** – Decks
 - **Design** – Designs und Assets
-- **Video** – Kompositionen
 - **Clips** – Bildschirmaufnahmen (Loom-Stil)
 - **Formulare** – Formulardefinitionen
 - **Kalender** – Veranstaltungen und Buchungslinks

package/corpus/core/docs/content/locales/de-DE/skills-guide.mdx

@@ -118,9 +118,7 @@ Domäne skills folgt demselben Format wie das Framework skills. Sie kodieren Mus
 
 ## App-gestütztes skills {#app-backed-skills}
 
-Aktuelle appgestützte Skills sind `visual-plan` und `visual-recap` aus Plan,
-`visual-edit` aus Design, `assets` aus Assets und `content` für repo-basiertes
-Bearbeiten von docs/blog/MDX.
+Aktuelle appgestützte Skills sind `visual-plan`, `visual-recap` und `visualize-repo` aus Plan, `visual-edit` aus Design, `assets` aus Assets und `content` für repo-gestützte docs/blog/MDX-Bearbeitung.
 
 App-gestütztes skills-Paket einer agentennativen App als Skill-Marktplatz-Artefakt. Das Paket kann Agentenanweisungen, exportierte skills-, MCP-Connector-Metadaten, gehostete/lokale Startanweisungen und UI-Oberflächen wie MCP-Apps enthalten.
 
@@ -332,6 +330,7 @@ Offline-Arbeit oder datenschutzrelevante Nutzung.
 ```bash
 # Glücklicher Weg: exportierte Anweisungen plus gehosteter MCP-Connector.
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visualize-repo
 npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 

package/corpus/core/docs/content/locales/de-DE/template-plan.mdx

@@ -5,12 +5,7 @@ description: "Agent-Native Plans verwandelt den Plan Ihres Programmieragenten in
 
 # Visuelle Pläne
 
-> **Die meisten Leute installieren Plan als Skill und nicht als Gerüst-App.** Ein CLI-Befehl
-> fügt `/visual-plan` und `/visual-recap` skills sowie den gehosteten Plan hinzu
-> -Connector zu Ihrem Codierungsagenten – siehe [Plan plugin & marketplace](/docs/plan-plugin)
-> für die Plugin- und Marktplatzrouten. Forken der Planvorlage (behandelt unter
-> [For developers](#for-developers)) ist der sekundäre Pfad für Selbsthosting oder
-> baut auf Plan selbst auf.
+> **Die meisten Leute installieren Plan als Skill und nicht als Gerüst-App.** Ein CLI-Befehl fügt die Skills `/visual-plan`, `/visual-recap` und `/visualize-repo` sowie den gehosteten Plan-Connector zu Ihrem Codierungsagenten hinzu — siehe [Plan plugin & marketplace](/docs/plan-plugin) für die Plugin- und Marktplatzrouten. Das Forken der Planvorlage (unter [For developers](#for-developers)) ist der sekundäre Pfad für Selbsthosting oder das Bauen auf Plan selbst.
 
 Agent-Native Plans ist ein visueller Planmodus für Codierungsagenten. Es wird zu einem gewöhnlichen
 Codex-, Claude-Code, Markdown oder eingefügter Implementierungsplan in eine strukturierte Datei
@@ -117,7 +112,7 @@ gegen eine OAuth-Wand stoßen:
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-Der Befehl installiert beide Befehle: `/visual-plan` und `/visual-recap`.
+Der Befehl installiert drei Befehle: `/visual-plan`, `/visual-recap` und `/visualize-repo`.
 
 Wenn Sie einen Chat-basierten Host verwenden, der MCP-Connector URLs direkt akzeptiert
 (anstelle eines CLI-konfigurierten Clients) verbinden Sie den gehosteten Plans-Connector unter
@@ -360,6 +355,25 @@ und kommentieren und gibt den gehosteten URL zurück. Der Modus „Lokale Dateie
 Machen Sie LLM Ihres Codierungsagenten automatisch lokal. Wählen Sie ein lokales oder zugelassenes
 Modell, wenn diese Datenschutzgrenze ebenfalls wichtig ist.
 
+## Visuelle Repo-Dokumentation {#visualize-repo}
+
+Verwenden Sie `/visualize-repo`, wenn Sie eine dauerhafte visuelle Dokumentationsschicht für eine Codebase statt eines einmaligen Plans oder Recaps wollen. Der Befehl erstellt oder öffnet einen lokalen Plan-MDX-Arbeitsbereich, aktualisiert `agent-native.json` mit einem `apps.visualize-repo`-Abschnitt im local-files-Modus und stellt die Dokumentation über dieselbe localhost-Bridge bereit:
+
+```bash
+npx @agent-native/core@latest visualize-repo --open
+```
+
+Wenn kein `agent-native.json` existiert, legt der Befehl eines an und empfiehlt aus der Repo-Struktur einen kleinen Startsatz, zum Beispiel `actions/`, `app/components/`, `app/pages/`, `server/db/schema.ts`, `src/`, `packages/`, `templates/`, `docs/` oder `content/`. Sie können bestimmte Source-Anker angeben:
+
+```bash
+npx @agent-native/core@latest visualize-repo \
+  --target actions/webhooks.ts \
+  --target server/db/schema.ts \
+  --target app/components/PromptComposer.tsx
+```
+
+Der Starter-Ordner liegt standardmäßig unter `.agent-native/visual-docs/repo-overview`. Kommentare bleiben lokal in `comments.json`, sodass Reviewer Abschnitte für einen Coding-Agent markieren können und der Agent Code und MDX in derselben Änderung aktualisieren kann. Führen Sie `visualize-repo check` für lokales Linting aus und `visualize-repo verify`, wenn das Plan-Renderer-Schema das MDX validieren soll.
+
 ## Lokale Desktop-Dateisynchronisierung {#desktop-local-sync}
 
 Agent Native Desktop bietet gehosteten Plänen außerdem eine native lokale Ordnerbrücke. Dies
@@ -412,6 +426,8 @@ lokale Dateien berühren.
 - „Verwenden Sie `/visual-recap` für den Unterschied zwischen `main` und diesem Zweig.“
 - „Verwenden Sie `/visual-recap` im lokalen Dateimodus, damit kein Zusammenfassungsinhalt in die Plan-Datenbank geschrieben wird.“
 
+- „Führen Sie `/visualize-repo` aus und beginnen Sie mit unseren öffentlichen API-Actions und dem Schema.“
+
 ## Wiederherstellung nach Authentifizierungsfehlern {#auth-errors}
 
 Wenn ein Plan-Tool jemals `needs auth`, `Unauthorized` oder „Sitzung“ zurückgibt