esedre 0.1.11 → 1.0.0

package/CHANGELOG.md

@@ -1,74 +1,116 @@
-# Changelog
-
-All notable changes to Esedre are documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [0.1.11] - 2026-09-26
-
-### Fixed
-- **Prevent Project Query Leak in Embedded Mode**: Guarded `window.history.replaceState` behind `!isEmbedded` in `PlannedWorkView` when switching project filters, added an explicit `isEmbedded` prop to `PlannedWorkViewProps`, and introduced `detectIsEmbedded` and `updateProjectUrlSearchParam` helpers to ensure embedded planners never mutate the host window's URL search parameters.
-- **Published Version Collision Guard**: Added upfront registry version pre-check to `scripts/publish.js` to immediately detect and reject attempts to republish already-published versions before running the full build/test lifecycle.
-
-## [0.1.10] - 2026-09-26
-
-### Added
-- **Single-Step Ticket Creation (`--detail` & `--file`)**: `ese create` accepts `--detail "<md>"` and `--file <path>` to populate `detail.md` specifications during ticket creation without requiring a secondary `ese plan` call.
-- **MCP `esedre_create_ticket` Specification Markdown**: Added optional `detail` parameter to the MCP create tool for agents to mint tickets with full specifications in a single turn.
-- **`ese refresh` CLI Alias**: Added `refresh` as a direct alias for `ese snapshot` to regenerate the `.esedre/snapshot.json` projection.
-
-### Fixed
-- **Windows CMD Batch Label Syntax Error**: Refactored `WRAPPER_CMD` (`ese.cmd` / `esedre.cmd`) to eliminate parenthesized `if (...)` blocks around `goto` statements, converted jump points to top-level labels, and prefixed all batch script invocations with `call` to prevent `'The system cannot find the batch label specified - done'` crashes on Windows.
-- **PowerShell Console Stream UTF-8 Encoding**: Enforced `[Console]::OutputEncoding`, `[Console]::InputEncoding`, and `$OutputEncoding = UTF-8` in `ese.ps1` to prevent Unicode characters (en-dashes, quotes) from rendering as mojibake.
-- **Structured JSON Output for `ese plan --json`**: Corrected `ese plan <id> --json` to emit a machine-readable JSON payload (`{ success, ticketId, project, planMarkdown, sha1 }`) instead of ANSI terminal text.
-
-## [0.1.9] - 2026-09-25
-
-### Added
-- **Smart npm Publish Lifecycle Wrapper (`npm run pub`)**: Upfront authentication pre-check (`npm whoami`) with automatic interactive login before compilation, executing full prepublish test/lint/build lifecycle.
-- **Multi-Layer Zero-Crawl Protection**: Edge and Vite middleware security preventing search spiders and AI crawler cataloging on development tunnels (`esedre.aroomwithamoose.com`).
-- **Canonical Apex Ecosystem Links**: Standardized all portfolio ecosystem references to canonical apex `https://arwam.com`.
-
-## [0.1.8] - 2026-09-11
-
-### Added
-- **Dynamic Configuration & Manifest Reloading**: 3-second TTL polling (`ensureFreshConfig`) reloading external hubs and manifests in real time without daemon restarts.
-
-### Changed
-- **Gateway Server Portfolio Decoupling**: Background daemon and gateway cluster (`ese start`) serve unconstrained portfolio views across all registered data hubs regardless of which workspace directory the server was launched from.
-- **Slug Normalization**: Removed redundant `slug` field from `ProjectDescriptor`, manifests, and storage adapters in favor of canonical case-remembering `code`.
-
-## [0.1.7] - 2026-09-11
-
-### Added
-- **Case-Remembering Project Resolution**: Preserves canonical casing for project codes up to 8 characters on disk and manifests while supporting case-insensitive lookups across CLI, MCP, and REST endpoints.
-- **Workspaceless & Multi-Hub Project Init**: `ese init --project <Code> [--hub <name|path>]` creates projects directly in configured hubs without overwriting existing workspace configurations.
-
-## [0.1.6] - 2026-09-10
-
-### Added
-- **Multi-Manifest Detection in `ese init`**: Auto-detects project codes and names from `Cargo.toml`, `pyproject.toml`, `settings.gradle.kts`, `app/build.gradle.kts`, and `go.mod`.
-- **Global Port Settings**: Centralized port configuration in `~/.esedre/config.json` with CLI overrides and workspace inheritance.
-- **Agent Project Allow-List Isolation**: Multi-tenant workspace scoping strictly limiting CLI and MCP access to declared `allowedProjects`.
-
-## [0.1.5] - 2026-09-09
-
-### Added
-- **Interactive Web UI Assets & Previews**: Standalone React 19 web dashboard assets, dark and light preview cards, and documentation guides.
-
-## [0.1.4] - 2026-09-08
-
-### Added
-- **MPL-2.0 License Transition**: Open source licensing under Mozilla Public License 2.0.
-- **LLM Agent Long-Term Grounding Mission**: Formalized ground-truth architecture providing persistent context across compaction events.
-
-## [0.1.1] - 2026-09-08
-
-### Added
-- **Project Onboarding & Configuration Tools**: Initial interactive setup via `ese configure` and `ese init`.
-
-## [0.1.0] - 2026-09-08
-
-### Added
-- Initial release of the Esedre ticketing engine, CLI (`ese` / `esedre`), background daemon, and Model Context Protocol (MCP) server.
+# Changelog
+
+All notable changes to Esedre are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-09-27
+
+### Added
+- **Cross-Project Milestones & Deliverables Tracking**:
+  - Support cross-project milestone grouping allowing tickets across multiple projects to be associated with a unified milestone deliverable.
+  - Compound milestone selector syntax (`ProjectCode:MilestoneTitle` or `ProjectCode:MilestoneId`) for precise cross-project targeting and filtering.
+  - Embedded view and allow-list isolation: Out-of-scope tickets in a milestone render as masked placeholders when viewed in embedded host applications or restricted agent scopes.
+  - Dedicated CLI commands: `ese milestone list`, `ese milestone get`, `ese milestone create`, `ese milestone update`, `ese milestone delete`.
+  - Dedicated MCP tools: `esedre_list_milestones`, `esedre_get_milestone`, `esedre_create_milestone`, `esedre_update_milestone`.
+  - Web UI: Milestones view with real-time completion progress bars, umbrella feature flag status, and assigned ticket chips.
+- **Cross-Project Ticket Linking & Dependencies**:
+  - Support bi-directional linked issues across tickets in the same project or across different projects (e.g. `Profe-136` relates to `Lab151-1`).
+  - Standard relations with inverse pairs: `relates-to` <-> `relates-to` (symmetric), `blocks` <-> `blocked-by` (inverse), `parent-of` <-> `child-of` (inverse), and `duplicates` <-> `duplicated-by` (inverse).
+  - Cycle detection preventing circular dependencies on `blocks` and `parent-of` trees.
+  - Automatic blocker detection (`isBlocked: true`) on tickets with uncompleted blockers.
+  - Agent Project Allow-List isolation: Redacts target metadata to `[Restricted Project]` when target project is outside `allowedProjects`.
+  - CLI commands: `ese link <sourceId> <relation> <targetId>` and `ese unlink <sourceId> <targetId>`, plus `--blocked` and `--linked-to <ticketKey>` query filters for `ese list`.
+  - MCP tools: `esedre_link_ticket` and `esedre_unlink_ticket`, with `isBlocked` and `linkedTo` filter arguments on `esedre_list_tickets`.
+  - Web UI: Standalone `LinkTicketModal`, Sub-tab 5: "Links" with relation badges and unlink actions, and `Blocked` warning pill in ticket headers.
+- **Project Settings & Code Rename Engine**:
+  - CLI commands: `ese rename-project <oldCode> <newCode> [--name "<name>"]` and `ese project set <code> [--name "<name>"]`.
+  - Web UI: Project settings modal supporting live display name and code updates with automatic link and ticket migration.
+- **Table of Contents Alignment & Layout Stability**:
+  - Web UI: Fixed-width ticket numbering eliminating zig-zag alignment in All Projects view, expanded title area, and static Type and Status pills at the far right.
+
+### Fixed
+- **Windows CMD Batch Label Search Bug (`ese.cmd` / `esedre.cmd`)**:
+  - Refactored `WRAPPER_CMD` to dispatch through a `:run` subroutine and return via `goto :eof`, eliminating user-defined `:done` labels entirely.
+  - Resolved `cmd.exe` error `'The system cannot find the batch label specified - done'` caused when nested `call` invocations corrupted parent label search contexts.
+  - Added direct in-repo (`..\dist\esedre.mjs`) and local `node_modules` detection to invoke Node directly without batch hopping.
+
+### Security
+- **API Server Hardening**:
+  - Added 10MB payload ceiling to `readJsonBody` to prevent runaway memory allocation.
+  - Added `x-esedre-allowed-projects` to CORS preflight `Access-Control-Allow-Headers` response for cross-origin browser requests.
+  - Cleaned developer machine paths from staging tunnel configurations.
+
+## [0.1.12] - 2026-09-26
+
+### Fixed
+- **UTF-8 En-Dash Mojibake Normalization**: Added `normalizeDashesAndMojibake` and `normalizeTicketFields` to transparently sanitize Windows-1252 mojibake (`–`), double-encoded UTF-8, and non-ASCII Unicode dashes (`\u2013`, `\u2014`, `\u2015`, `\u2012`, `\u2212`) into clean standard ASCII hyphens (`-`) across CLI tables, JSON projections, storage reads, and ticket mutations.
+
+## [0.1.11] - 2026-09-26
+
+### Fixed
+- **Prevent Project Query Leak in Embedded Mode**: Guarded `window.history.replaceState` behind `!isEmbedded` in `PlannedWorkView` when switching project filters, added an explicit `isEmbedded` prop to `PlannedWorkViewProps`, and introduced `detectIsEmbedded` and `updateProjectUrlSearchParam` helpers to ensure embedded planners never mutate the host window's URL search parameters.
+- **Published Version Collision Guard**: Added upfront registry version pre-check to `scripts/publish.js` to immediately detect and reject attempts to republish already-published versions before running the full build/test lifecycle.
+
+## [0.1.10] - 2026-09-26
+
+### Added
+- **Single-Step Ticket Creation (`--detail` & `--file`)**: `ese create` accepts `--detail "<md>"` and `--file <path>` to populate `detail.md` specifications during ticket creation without requiring a secondary `ese plan` call.
+- **MCP `esedre_create_ticket` Specification Markdown**: Added optional `detail` parameter to the MCP create tool for agents to mint tickets with full specifications in a single turn.
+- **`ese refresh` CLI Alias**: Added `refresh` as a direct alias for `ese snapshot` to regenerate the `.esedre/snapshot.json` projection.
+
+### Fixed
+- **Windows CMD Batch Label Syntax Error**: Refactored `WRAPPER_CMD` (`ese.cmd` / `esedre.cmd`) to eliminate parenthesized `if (...)` blocks around `goto` statements, converted jump points to top-level labels, and prefixed all batch script invocations with `call` to prevent `'The system cannot find the batch label specified - done'` crashes on Windows.
+- **PowerShell Console Stream UTF-8 Encoding**: Enforced `[Console]::OutputEncoding`, `[Console]::InputEncoding`, and `$OutputEncoding = UTF-8` in `ese.ps1` to prevent Unicode characters (en-dashes, quotes) from rendering as mojibake.
+- **Structured JSON Output for `ese plan --json`**: Corrected `ese plan <id> --json` to emit a machine-readable JSON payload (`{ success, ticketId, project, planMarkdown, sha1 }`) instead of ANSI terminal text.
+
+## [0.1.9] - 2026-09-25
+
+### Added
+- **Smart npm Publish Lifecycle Wrapper (`npm run pub`)**: Upfront authentication pre-check (`npm whoami`) with automatic interactive login before compilation, executing full prepublish test/lint/build lifecycle.
+- **Multi-Layer Zero-Crawl Protection**: Edge and Vite middleware security preventing search spiders and AI crawler cataloging on development tunnels (`esedre.aroomwithamoose.com`).
+- **Canonical Apex Ecosystem Links**: Standardized all portfolio ecosystem references to canonical apex `https://arwam.com`.
+
+## [0.1.8] - 2026-09-11
+
+### Added
+- **Dynamic Configuration & Manifest Reloading**: 3-second TTL polling (`ensureFreshConfig`) reloading external hubs and manifests in real time without daemon restarts.
+
+### Changed
+- **Gateway Server Portfolio Decoupling**: Background daemon and gateway cluster (`ese start`) serve unconstrained portfolio views across all registered data hubs regardless of which workspace directory the server was launched from.
+- **Slug Normalization**: Removed redundant `slug` field from `ProjectDescriptor`, manifests, and storage adapters in favor of canonical case-remembering `code`.
+
+## [0.1.7] - 2026-09-11
+
+### Added
+- **Case-Remembering Project Resolution**: Preserves canonical casing for project codes up to 8 characters on disk and manifests while supporting case-insensitive lookups across CLI, MCP, and REST endpoints.
+- **Workspaceless & Multi-Hub Project Init**: `ese init --project <Code> [--hub <name|path>]` creates projects directly in configured hubs without overwriting existing workspace configurations.
+
+## [0.1.6] - 2026-09-10
+
+### Added
+- **Multi-Manifest Detection in `ese init`**: Auto-detects project codes and names from `Cargo.toml`, `pyproject.toml`, `settings.gradle.kts`, `app/build.gradle.kts`, and `go.mod`.
+- **Global Port Settings**: Centralized port configuration in `~/.esedre/config.json` with CLI overrides and workspace inheritance.
+- **Agent Project Allow-List Isolation**: Multi-tenant workspace scoping strictly limiting CLI and MCP access to declared `allowedProjects`.
+
+## [0.1.5] - 2026-09-09
+
+### Added
+- **Interactive Web UI Assets & Previews**: Standalone React 19 web dashboard assets, dark and light preview cards, and documentation guides.
+
+## [0.1.4] - 2026-09-08
+
+### Added
+- **MPL-2.0 License Transition**: Open source licensing under Mozilla Public License 2.0.
+- **LLM Agent Long-Term Grounding Mission**: Formalized ground-truth architecture providing persistent context across compaction events.
+
+## [0.1.1] - 2026-09-08
+
+### Added
+- **Project Onboarding & Configuration Tools**: Initial interactive setup via `ese configure` and `ese init`.
+
+## [0.1.0] - 2026-09-08
+
+### Added
+- Initial release of the Esedre ticketing engine, CLI (`ese` / `esedre`), background daemon, and Model Context Protocol (MCP) server.

package/README.md

@@ -8,7 +8,8 @@
 
 [![License: MPL 2.0](https://img.shields.io/badge/License-MPL_2.0-blue.svg)](LICENSE)
 [![Tests](https://img.shields.io/badge/Tests-100%25%20Passing-emerald.svg)](tests/)
-[![Website: arwam.com](https://img.shields.io/badge/Website-arwam.com-cyan.svg)](https://arwam.com)
+[![Website: esedre.com](https://img.shields.io/badge/Website-esedre.com-indigo.svg)](https://esedre.com)
+[![Ecosystem: arwam.com](https://img.shields.io/badge/Ecosystem-arwam.com-cyan.svg)](https://arwam.com)
 
 ---
 
@@ -39,6 +40,7 @@ LLM coding agents possess extraordinary implementation speed, but face a fundame
 4. **Agent Project Allow-List (Multi-Project Isolation)**: Informs each LLM agent only of the projects it is authorized to access, keeping unrelated project tickets, specifications, and plans completely isolated.
 5. **Optimistic Concurrency Control**: SHA-1 content hashing on all tickets and plans, preventing concurrent agents or humans from clobbering each other's edits.
 6. **Local Web Dashboard & Embeddable Component**: Run a visual dashboard with `ese start` to manage tickets in your browser, or embed `<esedre-planner>` into any web app without adding UI framework dependencies to your project.
+7. **Project Milestones & Umbrella Flags**: Group tickets into release deliverables with real-time completion progress and umbrella feature flag propagation.
 
 ---
 
@@ -93,7 +95,7 @@ The server launches with unconstrained portfolio visibility across all registere
 ### 4. Create Your First Ticket
 
 ```bash
-ese create --title "Build authentication flow" --type Feature
+ese create --title "Build authentication flow" --type Feature --priority High
 ese list
 ese get 1
 ```
@@ -112,11 +114,14 @@ Core day-to-day workflow commands for scoping, viewing, planning, and verifying
 
 | Command | Usage | Description |
 |---|---|---|
-| `list` | `ese list [-p\|--project <code\|all>] [-s\|--status <status>] [-t\|--type <type>] [--json]` | List roadmap tickets with optional filters. Defaults to the active project. |
-| `get` | `ese get <id> [--json]` | View ticket specifications, feature breakdown, comments, and SHA-1 hash. |
+| `list` | `ese list [-p\|--project <code\|all>] [-s\|--status <status>] [-t\|--type <type>] [-P\|--priority <priority>] [-m\|--milestone <name>] [--blocked] [--linked-to <key>] [--json]` | List roadmap tickets with optional filters. Defaults to the active project. |
+| `get` | `ese get <id> [--json]` | View ticket specifications, feature breakdown, comments, links, and SHA-1 hash. |
 | `plan` | `ese plan <id> [--set "<markdown>"] [--file <path>] [--last-hash <h>]` | Read or update the active implementation plan markdown. |
-| `create` | `ese create --title "..." [-p\|--project <code>] [-t\|--type <type>] [--detail "<md>"] [--file <path>]` | Create a new ticket with auto-sequential ID and optional specification markdown. Title strictly capped at 48 chars. |
-| `update` | `ese update <id> [-s\|--status <status>] [-t\|--type <type>] [--title "..."] [--last-hash <h>]` | Update ticket status, type, or title with optimistic concurrency protection. |
+| `create` | `ese create --title "..." [-p\|--project <code>] [-t\|--type <type>] [-P\|--priority <priority>] [-m\|--milestone <name>] [--detail "<md>"] [--file <path>]` | Create a new ticket with auto-sequential ID, optional priority, optional milestone, and specification markdown. Title strictly capped at 48 chars. |
+| `update` | `ese update <id> [-s\|--status <status>] [-t\|--type <type>] [-P\|--priority <priority\|none>] [-m\|--milestone <name\|none>] [--title "..."] [--last-hash <h>]` | Update ticket status, type, priority, milestone, or title with optimistic concurrency protection. |
+| `link` | `ese link <sourceId> <relation> <targetId> [--author "..."]` | Establish a bi-directional link between two tickets. Relations: `relates-to`, `blocks`, `parent-of`, `duplicates`. |
+| `unlink` | `ese unlink <sourceId> <targetId> [--relation <relation>]` | Remove a bi-directional link between two tickets. |
+| `milestone` | `ese milestone [list\|get\|create\|update\|delete] [args...]` | Manage project milestones and umbrella feature flags with deliverables tracking. |
 | `comment` | `ese comment <id> ["<text>"] [--text "..."] [--author "..."]` | Append a developer or LLM agent note to ticket history. |
 | `snapshot`, `refresh` | `ese snapshot [--project <code>] [--json]` | Generate or refresh projection `.esedre/snapshot.json` for zero-latency agent context. |
 | `projects` | `ese projects [--json]` | List registered projects within authorized scope. |
@@ -141,6 +146,8 @@ Commands for repository onboarding, central machine linking, and maintenance:
 |---|---|---|
 | `init` | `ese init [<path>] [--project <code>] [--name <name>] [--hub <name\|path>] [-y]` | Bring a project repository online, bootstrap a dedicated data hub (`--hub`), or create a project directly in a data hub (`--project <code>`). |
 | `configure` | `ese configure [add <path> \| remove <code\|path> \| set <k> <v>]` | Inspect or mutate central configuration (`~/.esedre/config.json`). Link external project repositories or data hubs. |
+| `rename-project` | `ese rename-project <oldCode> <newCode> [--name "<name>"]` | Rename a project code across directory storage paths, manifests, and tickets. |
+| `project set` | `ese project set <code> [--name "<name>"]` | Update metadata for an existing project (e.g. display name). |
 | `upgrade` | `ese upgrade [<path>] [--force \| -f]` | Upgrade workspace configuration schema, in-repo wrappers, and agent skills. |
 
 > **Human vs LLM Agent Workflows**: Developer Administration commands (`init`, `configure`, `upgrade`) manage system-level repository linking and central machine configuration. They are intended for human developers during initial setup. Autonomous LLM coding partners operate within the authorized workspace scope using Roadmap and Service Daemon commands (`list`, `get`, `plan`, `create`, `update`, `comment`, `snapshot`, `start`, `status`).
@@ -183,13 +190,49 @@ To connect Esedre to **Google Antigravity**, **Claude Code**, **Cursor**, or any
 ```
 
 ### Registered Tools
-- `esedre_list_tickets`: List tickets with optional project, status, category, or search filter.
-- `esedre_get_ticket`: Retrieve full specification, summary, comments, revision, and content hash (`sha1`).
+- `esedre_list_tickets`: List tickets with optional project, status, type, priority, milestone, isBlocked, linkedTo, or search filter.
+- `esedre_get_ticket`: Retrieve full specification, summary, comments, revision, links, blocker status, and content hash (`sha1`).
 - `esedre_get_plan` & `esedre_save_plan`: Inspect and update implementation plans with optimistic concurrency (`lastHash`).
-- `esedre_create_ticket`: Mint new roadmap tickets with project code validation (up to 8 chars) and optional specification detail markdown.
-- `esedre_update_ticket`: Modify status, title, complexity, or effort with optimistic concurrency (`lastHash`).
+- `esedre_create_ticket`: Mint new roadmap tickets with project code validation (up to 8 chars), optional priority, optional milestone, and specification detail markdown.
+- `esedre_update_ticket`: Modify status, title, type, priority, milestone, complexity, or effort with optimistic concurrency (`lastHash`).
+- `esedre_link_ticket`: Establish a bi-directional link between two tickets (`relates-to`, `blocks`, `parent-of`, `duplicates`).
+- `esedre_unlink_ticket`: Remove a bi-directional relationship between two tickets.
+- `esedre_list_milestones`: List milestones and progress metrics for a project.
+- `esedre_get_milestone`: Retrieve milestone specifications, umbrella feature flag, and member tickets.
+- `esedre_create_milestone`: Create a project milestone with optional umbrella feature flag and target date.
+- `esedre_update_milestone`: Update milestone status, title, description, or umbrella feature flag.
 - `esedre_add_comment`: Append developer or LLM agent verification notes.
 
+### Cross-Project Linked Issues & Dependencies
+
+Esedre supports bi-directional ticket relationships across tickets within the same project or across different projects:
+
+- **Semantic Relations**:
+  - `relates-to` <-> `relates-to` (symmetric)
+  - `blocks` <-> `blocked-by` (inverse)
+  - `parent-of` <-> `child-of` (inverse)
+  - `duplicates` <-> `duplicated-by` (inverse)
+- **Automatic Reciprocal Linking**: Creating a link on Ticket A automatically establishes the reciprocal inverse relationship on Ticket B when both are in writable storage scope. Unlinking either removes both sides.
+- **Blocker Tracking & Dependency Awareness**: Tickets with uncompleted `blocked-by` links are computed as `isBlocked: true`. The CLI highlights blocked items with `[BLOCKED]` warning badges, and LLM agents can query ready work via `ese list --blocked` or `isBlocked: false` in MCP.
+- **Cycle Prevention**: Cycle detection on `blocks` and `parent-of` chains rejects circular dependencies that would deadlock workflows.
+- **Agent Allow-List Redaction**: Links to external projects outside the active workspace's `allowedProjects` have target metadata redacted to `[Restricted Project]` to prevent cross-workspace information leakage.
+
+### Project Milestones & Umbrella Feature Flags
+
+Esedre introduces first-class milestone management to group related tickets toward target deliverables and release cycles:
+
+- **Target Deliverables**: Organize tickets under sequential project milestones (e.g. `#1 Lab 151 Platform Foundation`, `#2 Public Release`).
+- **Cross-Project Milestone Deliverables**: Milestones can group member tickets across multiple projects (e.g. platform, web, and tooling repositories) toward a unified delivery target.
+- **Compound Milestone Notation**: In multi-project or portfolio context, milestones are addressed and filtered using compound notation (`ProjectCode:MilestoneTitle` or `ProjectCode:MilestoneId`).
+- **Umbrella Feature Flag Inheritance**: Milestones can optionally link to an umbrella feature flag, which automatically propagates to all tickets in the milestone unless individually overridden.
+- **Embed & Allow-List Isolation**: When viewed from embedded host applications or scoped agent environments, tickets belonging to external projects outside `allowedProjects` render as masked placeholders, preserving project security boundaries.
+- **Visual Progress Tracking**: Real-time progress bars, completion metrics, and assigned ticket chips in the Web UI dashboard.
+- **Full CLI & MCP Parity**: Manage milestones from the terminal via `ese milestone list`, `ese milestone create`, and `ese milestone update`, or let autonomous LLM coding agents inspect deliverables via MCP tools (`esedre_list_milestones`, `esedre_get_milestone`).
+
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/npm/esedre/docs/assets/esedre-milestones.png" alt="Esedre Milestones & Deliverables Tracking" width="100%" />
+</p>
+
 ### Resources
 - URI Scheme: `esedre://tickets/{id}` (MIME type: `text/markdown`)