@astrake/lumora-ui 0.2.1 → 0.7.2

package/CHANGELOG.md

@@ -1,141 +1,230 @@
-# Changelog
-
-## [0.2.1] — 2026-05-12
-
-### Fixed
-- Package publishing now ships compiled `dist` outputs (`.js` + `.d.ts`) and exports no longer point to raw `src/*.ts` entrypoints, preventing downstream strict TypeScript checks from surfacing Lumora internals.
-- Cleaned internal type noise in core source (`unused imports/params`, `type`-only `VNode` import) so workspace `vue-tsc` checks remain clean.
-
----
-
-## [0.2.0] — 2026-04-27
-
-### Maintenance
-
-- bump version to 0.2.0 (`d52e5c1`)
-
-
----
-
-## [0.2.0] — 2026-04-27
-
-### Added
-- `LuCodeBlock` — Native Shiki-powered syntax highlighter with `default` and `preview` variants (supporting `tabbed` and `split` layouts).
-- `LuToggleGroup` & `LuToggleButton` — New layout primitives for grouped button selections.
-- `LuMenu` — Refactored and renamed from legacy `LuDropdown` to align with the core primitives naming convention.
-- New showcase documentation dedicated to Toggle Group and components.
-
-### Fixed
-- WPF-like edge-docking regressions in `LuDock` via a newly implemented programmatic render function.
-- Reactivity bugs in `LuSplit` (`LuSplitPane`, `LuSplitResizer`) failing to unwrap injected `direction` refs.
-- Missing `LuSplit` component skins.
-- Various visual hierarchy issues in documentation via typography `LuText` adjustments.
-
-### Changed
-- **Zero-Raw-HTML Adherence**: Removed all raw DOM nodes (`div`, `span`, etc.) and `PreviewBlock` from the showcase application in favor of 100% native `Lu*` primitives. 
-- Integrated Shiki to `@astrake/lumora-ui` core package dependencies.
-
----
-
-## [0.1.7] — 2026-04-26
-
-### Breaking Changes (structurally additive — no API surface removed)
-- Framework now ships `lumora.css` — consumers must add `import '@astrake/lumora-ui/style'` to their app entry
-
-### Fixed
-- Shell components (`LuDesktopShell`, `LuMobileShell`, `LuEmbeddedShell`) no longer require Tailwind CSS to be configured for `node_modules` — structural layout is now framework-owned CSS
-- Layout primitives (`LuDock`, `LuStack`, `LuFill`, `LuScroll`, `LuGrid`, etc.) structural classes are now framework-owned, not Tailwind fallbacks
-- `LuDesktopRailItem` icon and label structural defaults are now framework-owned
-- Plugin config is now `shallowReactive` — dynamic skin switching and `config.skin = newSkin` mutations now correctly trigger reactive re-renders in all components
-
-### Added
-- `lumora.css` — zero-dependency CSS baseline for all structural/layout defaults; exported at `@astrake/lumora-ui/style`
-- `tailwindContent()` helper exported at `@astrake/lumora-ui/tailwind` — resolves correct `node_modules` source glob for Tailwind `content` config
-
----
-
-## [0.1.6] — 2026-04-25
-
-### Maintenance
-
-- bump version to 0.1.6 - add LuForm validation orchestrator (`1f11734`)
-
----
-
-## [0.1.6] — 2026-04-26
-
-### Added
-- `LuForm` — headless validation orchestrator component with slot-based API
-- `LuForm.types.ts` — `LuFormRules`, `LuFormErrors`, `LuFormValidator`, `LuFormContext` types
-- Form context integration for `LuInput`, `LuSelect`, `LuSwitch` — `name`, `error` props; register/unregister lifecycle
-- `LuFormContextKey` injection key (internal Symbol) for child-field coordination
-- 10 vitest test cases covering submit, validation, reset, blur, disabled, and programmatic API
-
----
-
-## [0.1.5] — 2026-04-25
-
-### Fixed
-
-- ci workflow errors — npm publish auth and correct artifact path (`af81e69`)
-
----
-
-## [0.1.4] — 2026-04-25
-
-### Fixed
-
-- prepack hook to include README and CHANGELOG in npm tarball (`e69bdfb`)
-
-
----
-
-## [0.1.3] — 2026-04-25
-
-### Maintenance
-
-- fix CI pipeline failures (`cde8248`)
-- verify automated release pipeline (`c153464`)
-
-All notable changes to `@astrake/lumora-ui` are documented here.
-
-Format: [Keep a Changelog](https://keepachangelog.com/) · Commits: [Conventional Commits](https://www.conventionalcommits.org/)
-
-
----
-
-## [0.1.0] — 2026-04-25
-
-### Added
-
-- Initial workspace scaffold (`packages/core`, `apps/showcase`, `tools/`)
-- Headless Vue 3 primitive component library targeting three surface types:
-  - **Mobile (`LuM*`):** touch-first components for PWA apps (≥44px targets, bottom nav, swipe)
-  - **Desktop (`LuD*`):** feature-rich browser/Electron components (sidebars, tables, modals)
-  - **Embedded (`LuE*`):** fixed-viewport components for kiosk/IoT/in-car screens
-  - **Shared (`Lu*`):** cross-surface primitives (`LuIcon`, `LuSpinner`, `LuBadge`, `LuPortal`)
-- Design token system (`--lu-*` CSS custom properties) — color, typography, spacing, radius, shadow, motion
-- Three package entry points: `@astrake/lumora-ui`, `/mobile`, `/desktop`, `/embedded`
-- Skin configuration system via `LumoraUI` Vue plugin
-- Shell components (`LuMobileShell`, `LuDesktopShell`, `LuEmbeddedShell`) with named-slot architecture
-- Layout primitives and composable layer
-- Reference showcase app (Vite + Vue 3) with `/mobile`, `/desktop`, `/embedded` routes
-- `tools/build.ts` — Vite library-mode build (three entry points)
-- `tools/check.ts` — vue-tsc typecheck
-- `tools/version.ts` — VERSION → package.json sync
-- `tools/changelog.ts` — automated changelog generator (zero npm deps)
-- `LICENSE` — MIT license
-- `SECURITY.md` — responsible disclosure policy
-- `README.md` — badges, install, usage, design token overview, automation table, disclaimer
-- `docs/LEGAL.md` — full warranty disclaimer and legal notice
-- `docs/PROJECT.md` — project overview
-- `docs/ARCHITECTURE.md` — architecture guide
-- `docs/DEVELOPMENT.md` — development workflow
-- `docs/RELEASES.md` — release workflow documentation
-- `docs/AI_AGENT_GUIDE.md` — AI coding agent guide
-- `AGENTS.md` — agent working rules and repo map
-- `.npmrc` — `@astrake` scope, `git-tag-version=false`
-- GitHub Actions: `ci.yml` — install, version-check, typecheck, test, build, artifact upload
-- GitHub Actions: `release.yml` — dual trigger, changelog, GitHub Release, npm publish
-- GitHub Actions: `version-check.yml` — VERSION single-source-of-truth enforcement
-- GitHub Actions: `codeql.yml` — weekly TypeScript security scan
+# Changelog
+
+## Unreleased
+
+---
+
+## [0.7.2] — 2026-05-23
+
+### Fixed
+- Fixed CI release workflow git authentication: added `token: ${{ secrets.GITHUB_TOKEN }}` to checkout step and explicit remote URL configuration before tag push to resolve "No such device or address" error.
+
+---
+
+## [0.7.1] — 2026-05-23
+
+### Fixed
+- Fixed GitHub Actions release workflow `npm publish` double-packing issue.
+
+---
+
+## [0.7.0] — 2026-05-23
+
+### Added
+- `LuPlanner` — Weekly scheduling grid with absolute-positioned time slots, event blocks, and `slot-click` / `event-click` emissions
+- `LuSelect` — Rebuilt with text search/filter, option groups, chip-based multi-select, clearable state, and async-ready slot API
+- `LuDataGrid` — Column sorting (asc/desc/none cycle), header select-all checkbox, local text search bar, per-column filter support
+- `LuTimeline` — `compact` and `numbered` layout variants; `status` prop for per-item color coding (success/warning/error/info)
+- `LuSwitch` — Indeterminate / tri-state variant via `indeterminate` prop
+- `LuCalendar` — `size="mini"` compact variant and `showEventLabels` boolean prop
+- Showcase: `LuCodeBlock` dedicated documentation page
+- New skin keys: `timeline.*`, `calendar.*`, `planner.*`, `select.*` (chip, group, search, clearable styles)
+- Test coverage: 5 new test files — `LuCheckbox`, `LuRadio`, `LuSwitch`, `LuSelect`, `LuPlanner`
+
+### Fixed
+- `LuFormWizard` — Step navigation regressions and layout rendering corrected
+- `LuCheckbox` / `LuRadio` / `LuSwitch` — Complete default-skin visual overhaul: accessible focus rings, checked/disabled states, label alignment
+
+---
+
+## [0.6.0] — 2026-05-23
+
+### ⚠ Breaking Changes
+- Removed from core exports: `LuEntityCard`, `LuEntityCardStat`, `LuPageHeader`, `LuNotificationCenter`, `LuDashboardGrid`, `LuThemeSwitch`, `LuThemeSelect`, `LuEmbeddedPOS*` (5 components). Moved to showcase recipes.
+
+### Added
+- `LuDrawer` — Overlay/push drawer panel (left/right/top/bottom)
+- `LuList`, `LuListItem`, `LuListDivider`, `LuListSubheader` — Structured list primitives
+- `LuPopover` — Rich content anchored to trigger (floating-ui)
+- `LuBottomSheet` — Mobile-friendly bottom panel with drag support
+- `LuToast` + `useLuToast()` — Non-blocking notification system
+- `LuChip`, `LuChipGroup` — Interactive selection chips
+- `LuAccordion` — Grouped collapsibles with exclusive-open mode
+- `useFloating()` — Shared floating-ui composable
+- Showcase: 11 functional navigation categories + Recipes section
+
+### Changed
+- `LuTooltip` — Now uses floating-ui for precise positioning with auto-flip
+- `LuMenu` — Now uses floating-ui, replaces hardcoded CSS alignment
+- `LuDesktopRailBar` promoted as the recommended rail/mini-drawer pattern
+
+---
+
+## [0.5.0] — 2026-05-22
+
+### Added
+
+- **`LuEntityCard` + `LuEntityCardStat`** — Rich entity summary cards with avatar, meta, stats grid, and actions slots.
+- Complete v0.3.0 to v0.5.0 roadmap implementation.
+
+---
+
+## [0.2.2] — 2026-05-14
+
+### Fixed
+
+- **`LuButton`** — `to` and `href` declared props are now explicitly re-bound on the dynamic
+  `<component>`, fixing Vue Router console warnings (`Missing required prop: "to"`) when rendering
+  as `RouterLink` with `inheritAttrs: false`.
+- **`LuTab` active indicator** — Changed `border-rose-500` → `border-b-rose-500` so the bottom
+  underline correctly overrides the `border-transparent` default in light mode (was invisible).
+- **`LuToggleButton` active skin** — `activeSkin` resolver is now variant-aware: resolves
+  `${variant}-active` (e.g. `ghost-active`) before falling back to the generic `active` skin key.
+- **`LuCodeBlock` copy button** — Hover style uses `hover:bg-white/10 hover:text-zinc-100`
+  (alpha overlay) instead of the mode-sensitive `hover:bg-zinc-700 hover:text-white`, ensuring
+  icon visibility on the always-dark `#282c34` code header in both light and dark themes.
+- **`LuCollapsibleTrigger` default skin** — Removed hard-coded sidebar typography
+  (`text-[10px] uppercase tracking-widest text-zinc-400`). The skin is now a generic neutral
+  trigger container; label typography is delegated to slot content via `LuText variant="label"`.
+- **Tab list borders** — `LuTabList` default and `card-header` variants changed from
+  `dark:border-zinc-800` → `dark:border-zinc-700`, normalising separator visual weight across modes.
+- **Showcase build** — `apps/showcase/vite.config.ts` now uses an ordered alias array covering all
+  `@astrake/lumora-ui` sub-path exports (`/style`, `/composables`, `/layout`, `/shell`,
+  `/components`, `/skins`), fixing standalone `bun run build` without pre-built core artifacts.
+
+### Added
+
+- **`LuToggleGroup ghost` variant** — Removes the segmented-control background container for use
+  in minimal topbar / toolbar contexts.
+- **`LuToggleButton ghost` + `ghost-active` variants** — Subtle icon-button states with an elevated
+  `ring` on the active element; consumed by the documentation `ThemeToggle` topbar widget.
+
+### Refactored (Showcase)
+
+- **`DocsSearch`** — Rebuilt as a floating dropdown (`absolute top-full z-50`) with styled result
+  rows: muted section caption, bold item label, per-row hover highlight, Escape-key dismiss, and
+  external-link icon indicator.
+- **`DocsSidebar`** — Removed redundant nested `LuStack` wrappers inside the `#trigger` slot that
+  created double padding and triple hover-layer stacking in dark mode.
+
+---
+
+## [0.2.1] — 2026-05-12
+
+- Package publishing now ships compiled `dist` outputs (`.js` + `.d.ts`) and exports no longer point to raw `src/*.ts` entrypoints, preventing downstream strict TypeScript checks from surfacing Lumora internals.
+- Cleaned internal type noise in core source (`unused imports/params`, `type`-only `VNode` import) so workspace `vue-tsc` checks remain clean.
+
+---
+
+## [0.2.0] — 2026-04-27
+
+### Added
+- `LuCodeBlock` — Native Shiki-powered syntax highlighter with `default` and `preview` variants (supporting `tabbed` and `split` layouts).
+- `LuToggleGroup` & `LuToggleButton` — New layout primitives for grouped button selections.
+- `LuMenu` — Refactored and renamed from legacy `LuDropdown` to align with the core primitives naming convention.
+- New showcase documentation dedicated to Toggle Group and components.
+
+### Fixed
+- WPF-like edge-docking regressions in `LuDock` via a newly implemented programmatic render function.
+- Reactivity bugs in `LuSplit` (`LuSplitPane`, `LuSplitResizer`) failing to unwrap injected `direction` refs.
+- Missing `LuSplit` component skins.
+- Various visual hierarchy issues in documentation via typography `LuText` adjustments.
+
+### Changed
+- **Zero-Raw-HTML Adherence**: Removed all raw DOM nodes (`div`, `span`, etc.) and `PreviewBlock` from the showcase application in favor of 100% native `Lu*` primitives.
+- Integrated Shiki to `@astrake/lumora-ui` core package dependencies.
+
+---
+
+## [0.1.7] — 2026-04-26
+
+### Breaking Changes (structurally additive — no API surface removed)
+- Framework now ships `lumora.css` — consumers must add `import '@astrake/lumora-ui/style'` to their app entry
+
+### Fixed
+- Shell components (`LuDesktopShell`, `LuMobileShell`, `LuEmbeddedShell`) no longer require Tailwind CSS to be configured for `node_modules` — structural layout is now framework-owned CSS
+- Layout primitives (`LuDock`, `LuStack`, `LuFill`, `LuScroll`, `LuGrid`, etc.) structural classes are now framework-owned, not Tailwind fallbacks
+- `LuDesktopRailItem` icon and label structural defaults are now framework-owned
+- Plugin config is now `shallowReactive` — dynamic skin switching and `config.skin = newSkin` mutations now correctly trigger reactive re-renders in all components
+
+### Added
+- `lumora.css` — zero-dependency CSS baseline for all structural/layout defaults; exported at `@astrake/lumora-ui/style`
+- `tailwindContent()` helper exported at `@astrake/lumora-ui/tailwind` — resolves correct `node_modules` source glob for Tailwind `content` config
+
+---
+
+## [0.1.6] — 2026-04-26
+
+### Added
+- `LuForm` — headless validation orchestrator component with slot-based API
+- `LuForm.types.ts` — `LuFormRules`, `LuFormErrors`, `LuFormValidator`, `LuFormContext` types
+- Form context integration for `LuInput`, `LuSelect`, `LuSwitch` — `name`, `error` props; register/unregister lifecycle
+- `LuFormContextKey` injection key (internal Symbol) for child-field coordination
+- 10 vitest test cases covering submit, validation, reset, blur, disabled, and programmatic API
+
+---
+
+## [0.1.5] — 2026-04-25
+
+### Fixed
+
+- ci workflow errors — npm publish auth and correct artifact path (`af81e69`)
+
+---
+
+## [0.1.4] — 2026-04-25
+
+### Fixed
+
+- prepack hook to include README and CHANGELOG in npm tarball (`e69bdfb`)
+
+---
+
+## [0.1.3] — 2026-04-25
+
+### Maintenance
+
+- fix CI pipeline failures (`cde8248`)
+- verify automated release pipeline (`c153464`)
+
+All notable changes to `@astrake/lumora-ui` are documented here.
+
+Format: [Keep a Changelog](https://keepachangelog.com/) · Commits: [Conventional Commits](https://www.conventionalcommits.org/)
+
+---
+
+## [0.1.0] — 2026-04-25
+
+### Added
+
+- Initial workspace scaffold (`packages/core`, `apps/showcase`, `tools/`)
+- Headless Vue 3 primitive component library targeting three surface types:
+  - **Mobile (`LuM*`):** touch-first components for PWA apps (≥44px targets, bottom nav, swipe)
+  - **Desktop (`LuD*`):** feature-rich browser/Electron components (sidebars, tables, modals)
+  - **Embedded (`LuE*`):** fixed-viewport components for kiosk/IoT/in-car screens
+  - **Shared (`Lu*`):** cross-surface primitives (`LuIcon`, `LuSpinner`, `LuBadge`, `LuPortal`)
+- Design token system (`--lu-*` CSS custom properties) — color, typography, spacing, radius, shadow, motion
+- Three package entry points: `@astrake/lumora-ui`, `/mobile`, `/desktop`, `/embedded`
+- Skin configuration system via `LumoraUI` Vue plugin
+- Shell components (`LuMobileShell`, `LuDesktopShell`, `LuEmbeddedShell`) with named-slot architecture
+- Layout primitives and composable layer
+- Reference showcase app (Vite + Vue 3) with `/mobile`, `/desktop`, `/embedded` routes
+- `tools/build.ts` — Vite library-mode build (three entry points)
+- `tools/check.ts` — vue-tsc typecheck
+- `tools/version.ts` — VERSION → package.json sync
+- `tools/changelog.ts` — automated changelog generator (zero npm deps)
+- `LICENSE` — MIT license
+- `SECURITY.md` — responsible disclosure policy
+- `README.md` — badges, install, usage, design token overview, automation table, disclaimer
+- `docs/LEGAL.md` — full warranty disclaimer and legal notice
+- `docs/PROJECT.md` — project overview
+- `docs/ARCHITECTURE.md` — architecture guide
+- `docs/DEVELOPMENT.md` — development workflow
+- `docs/RELEASES.md` — release workflow documentation
+- `docs/AI_AGENT_GUIDE.md` — AI coding agent guide
+- `AGENTS.md` — agent working rules and repo map
+- `.npmrc` — `@astrake` scope, `git-tag-version=false`
+- GitHub Actions: `ci.yml` — install, version-check, typecheck, test, build, artifact upload
+- GitHub Actions: `release.yml` — dual trigger, changelog, GitHub Release, npm publish
+- GitHub Actions: `version-check.yml` — VERSION single-source-of-truth enforcement
+- GitHub Actions: `codeql.yml` — weekly TypeScript security scan

package/README.md

@@ -20,10 +20,10 @@
 
 | Target | Components | Use case |
 |--------|-----------|---------|
-| **Mobile** (`LuM*`) | `LuMButton`, `LuMInput`, `LuMCard`, `LuMList`, `LuMBottomSheet`, `LuMNavBar` | PWA-ready apps — touch targets ≥44px, swipe gestures, bottom nav |
-| **Desktop** (`LuD*`) | `LuDButton`, `LuDInput`, `LuDTable`, `LuDSidebar`, `LuDDropdown`, `LuDModal` | Feature-rich browser / Electron apps — data tables, keyboard shortcuts |
-| **Embedded** (`LuE*`) | `LuEButton`, `LuEDisplay`, `LuEGrid`, `LuEStatusBar`, `LuEAlert`, `LuENumpad` | Kiosk, IoT, in-car screens — fixed viewport, high contrast, minimal JS |
-| **Shared** (`Lu*`) | `LuIcon`, `LuSpinner`, `LuBadge`, `LuPortal` | Cross-surface primitives |
+| **Mobile** (`LuMobile*`) | `LuMobileShell`, `LuMobileHeader`, `LuMobileNavBar` | PWA-ready apps — touch targets ≥44px, swipe gestures, bottom nav |
+| **Desktop** (`LuDesktop*`) | `LuDesktopShell`, `LuDesktopSidebar`, `LuDesktopTopBar` | Feature-rich browser / Electron apps — resizable splits, keyboard shortcuts |
+| **Embedded** (`LuEmbedded*`) | `LuEmbeddedShell` | Retail POS, Kiosk, IoT, in-car screens — fixed viewport, high contrast, touch-first |
+| **Shared** (`Lu*`) | `LuDataGrid`, `LuKanban`, `LuBarChart`, `LuRichTextEditor`, `LuButton` | Cross-surface primitives, data-rich components, and operational features |
 
 ---
 
@@ -48,13 +48,11 @@ bun add vue@^3.5.0
 ## Usage
 
 ```ts
-// Import all targets
-import { LuIcon, LuSpinner } from "@astrake/lumora-ui"
+// Import shared components and layout primitives
+import { LuButton, LuDataGrid, LuKanban, LuStack } from "@astrake/lumora-ui"
 
-// Import a specific target (recommended for tree-shaking)
-import { LuMButton, LuMCard } from "@astrake/lumora-ui/mobile"
-import { LuDTable, LuDSidebar } from "@astrake/lumora-ui/desktop"
-import { LuEDisplay, LuEGrid } from "@astrake/lumora-ui/embedded"
+// Import surface-specific shells
+import { LuMobileShell, LuDesktopShell, LuEmbeddedShell } from "@astrake/lumora-ui"
 ```
 
 **Register the plugin:**
@@ -62,10 +60,11 @@ import { LuEDisplay, LuEGrid } from "@astrake/lumora-ui/embedded"
 ```ts
 // main.ts
 import { createApp } from "vue"
-import { LumoraUI } from "@astrake/lumora-ui"
+import { createLumoraUI } from "@astrake/lumora-ui"
+import "@astrake/lumora-ui/style"
 import App from "./App.vue"
 
-createApp(App).use(LumoraUI).mount("#app")
+createApp(App).use(createLumoraUI()).mount("#app")
 ```
 
 ---
@@ -94,9 +93,10 @@ Each target root overrides tokens as appropriate (e.g., Embedded reduces shadow
 | Component framework | Vue 3.5+ (Composition API) |
 | Language | TypeScript 5.9+ |
 | Bundler | Vite (library mode, three entry points) |
+| Interactive Add-ons (Peer) | Apache ECharts, Tiptap, Sortable.js (`vue-draggable-plus`) |
 | Type check | vue-tsc |
 | Tests | Vitest + @vue/test-utils |
-| Package manager | Bun 1.3.12 |
+| Package manager | Bun 1.3+ |
 
 ---
 
@@ -106,14 +106,16 @@ Each target root overrides tokens as appropriate (e.g., Embedded reduces shadow
 LumoraUI/
 ├── packages/core/        ← @astrake/lumora-ui (published package)
 │   └── src/
-│       ├── tokens/       ← CSS custom properties (--lu-*)
-│       ├── shared/       ← cross-target primitives (Lu*)
-│       ├── mobile/       ← Mobile components (LuM*)
-│       ├── desktop/      ← Desktop components (LuD*)
-│       ├── embedded/     ← Embedded components (LuE*)
+│       ├── components/   ← shared primitives + complex components (Lu*)
+│       ├── layout/       ← layout primitives (LuStack, LuGrid, LuDock, etc.)
+│       ├── shell/        ← surface shells (LuDesktopShell, LuMobileShell, etc.)
+│       ├── composables/  ← shared composition functions
+│       ├── skins/        ← SkinMap default theme
+│       ├── lumora.css    ← structural CSS baseline
 │       └── index.ts
-├── apps/showcase/        ← reference Vite + Vue 3 app
+├── apps/showcase/        ← reference Vite + Vue 3 showcase app
 ├── tools/                ← build, check, version, changelog scripts
+├── .agent/               ← AI agent rules and authoring guides
 └── docs/                 ← architecture, development, releases, legal
 ```
 
@@ -126,7 +128,7 @@ git clone https://github.com/madlybong/LumoraUI.git
 cd LumoraUI
 bun install
 bun run check      # typecheck
-bun test           # run test suite
+bun run test --run # run test suite
 bun run dev        # start the showcase app
 ```
 
@@ -138,7 +140,7 @@ bun run dev        # start the showcase app
 - [Architecture Guide](./docs/ARCHITECTURE.md)
 - [Development Workflow](./docs/DEVELOPMENT.md)
 - [Release Workflow](./docs/RELEASES.md)
-- [AI Agent Guide](./docs/AI_AGENT_GUIDE.md)
+- [AI Agent Knowledge Base](./.agent/README.md)
 - [Legal Notice & Disclaimer](./docs/LEGAL.md)
 
 ---