chore: prepare 0.27.9-next.0 release

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to the TypeScript package will be documented in this file.
 
+## [0.27.9-next.0] - 2026-06-03
+
+### Added
+
+- **Adoption proof surfaces now cover the full next-track rollout bundle**: Madar now ships a public multi-repo benchmark suite and language fixtures, the one-command `madar try` first-run flow, verified agent-specific quickstarts and smoke-tested install docs, a design-partner feedback loop with reproducible receipts, and the proof-first launch/distribution checklist. Closes #469, #470, #472, #473, and #474.
+
+### Changed
+
+- **Public adoption messaging and instrumentation are now aligned across the next track**: the README/npm discovery path now reflects the Madar positioning and legacy-name cleanup, prerelease docs stay on `blob/next`, and the opt-in telemetry funnel records coarse install/generate/pack/prompt/doctor/status/compare adoption stages without collecting source text or paths. Closes #467, #468, and #471.
+
+### Fixed
+
+- **Graph freshness and stale-context guarantees are now scoped and git-backed**: `madar pack`, `madar prompt`, `madar handoff`, `madar doctor`, and `madar status` now report whole-repo vs selected-context freshness using the graph build revision plus current git diff as the source of truth on git workspaces, with privacy-safe governance receipts and tighter stale-context behavior for follow-up flows. Closes #477 and #479.
+
 ## [0.27.8] - 2026-06-02
 
 ### Added

docs/concepts/context-packs.md

@@ -61,7 +61,7 @@ Runtime-generation prompts stay compact by following the strongest backend path
 
 ## When to use `--spi`
 
-`--spi` is still opt-in in `0.27.8`. Use it when your repo is framework-heavy TypeScript/JavaScript and you want extra framework-shaped metadata plus disk cache behavior.
+`--spi` is still opt-in in `0.27.9-next.0`. Use it when your repo is framework-heavy TypeScript/JavaScript and you want extra framework-shaped metadata plus disk cache behavior.
 
 `--spi` is usually worth it for NestJS, Next.js App Router, Prisma, tRPC, Hono, Fastify, and similar repos where users ask storage-oriented prompts, client/server boundary questions, or request-flow questions. The default pipeline is still fine for simpler repos, non-JS/TS workspaces, or quick first runs when you do not need the extra framework detail yet.
 

docs/design-partners.md

@@ -79,6 +79,6 @@ Use the receipt issue as the evidence anchor, then open a focused follow-up when
 
 ## Related docs
 
-- [Proof workflows](https://github.com/mohanagy/madar/blob/main/docs/proof-workflows.md)
-- [Claims and evidence map](https://github.com/mohanagy/madar/blob/main/docs/claims-and-evidence.md)
-- [Getting started](https://github.com/mohanagy/madar/blob/main/docs/tutorials/getting-started.md)
+- [Proof workflows](https://github.com/mohanagy/madar/blob/next/docs/proof-workflows.md)
+- [Claims and evidence map](https://github.com/mohanagy/madar/blob/next/docs/claims-and-evidence.md)
+- [Getting started](https://github.com/mohanagy/madar/blob/next/docs/tutorials/getting-started.md)

docs/integrations/compatibility.md

@@ -2,7 +2,7 @@
 
 This guide is the user-facing install matrix for the current CLI contract. It focuses on the commands users actually run, the files each path writes, how to verify the result, and the most important behavior or limitation to know before choosing a surface.
 
-If you want one copy/paste walkthrough per main agent target, use the [agent quickstarts](https://github.com/mohanagy/madar/blob/main/docs/tutorials/agent-quickstarts.md) after you pick a row from this matrix.
+If you want one copy/paste walkthrough per main agent target, use the [agent quickstarts](https://github.com/mohanagy/madar/blob/next/docs/tutorials/agent-quickstarts.md) after you pick a row from this matrix.
 
 ## Dedicated project install commands
 

docs/mcp-registry/server.json

@@ -9,13 +9,13 @@
         "source": "github",
         "url": "https://github.com/mohanagy/madar"
     },
-    "version": "0.27.8",
+    "version": "0.27.9-next.0",
     "packages": [
         {
             "registryType": "npm",
             "registryBaseUrl": "https://registry.npmjs.org",
             "identifier": "@lubab/madar",
-            "version": "0.27.8",
+            "version": "0.27.9-next.0",
             "runtimeHint": "npx",
             "transport": {
                 "type": "stdio"

docs/tutorials/agent-quickstarts.md

@@ -2,7 +2,7 @@
 
 Use this page when you already know which agent you want to wire and you want one verified install path plus one copy/paste Smoke test.
 
-Before any agent-specific install, start with the [getting started tutorial](https://github.com/mohanagy/madar/blob/main/docs/tutorials/getting-started.md) and its one-command trial flow so the repo has a graph and you know Madar itself is behaving locally:
+Before any agent-specific install, start with the [getting started tutorial](https://github.com/mohanagy/madar/blob/next/docs/tutorials/getting-started.md) and its one-command trial flow so the repo has a graph and you know Madar itself is behaving locally:
 
 ```bash
 madar try "how does auth work?"

docs/tutorials/getting-started.md

@@ -124,6 +124,6 @@ This does **not** measure model quality. It is a safe local smoke check that pro
 ## Optional next steps
 
 - Replace the local compare runner with your real CLI model command from [`docs/proof-workflows.md`](../proof-workflows.md).
-- Turn the same workflow into a public share-safe receipt with the [design-partner program](https://github.com/mohanagy/madar/blob/main/docs/design-partners.md).
+- Turn the same workflow into a public share-safe receipt with the [design-partner program](https://github.com/mohanagy/madar/blob/next/docs/design-partners.md).
 - Install one of the agent profiles from the README after the sample graph is generated.
 - Move from `examples/sample-workspace/` to your own workspace and rerun the same `generate` → `pack` → `prompt` flow.

package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lubab/madar",
-    "version": "0.27.8",
+    "version": "0.27.9-next.0",
     "description": "Stop AI coding agents from rediscovering large TypeScript/Node repos. Madar compiles task-aware local context packs from what runs for this task.",
     "license": "MIT",
     "author": "mohanagy",