Skip to content

See how your app actually fits together. An interactive, plain-English map of your codebase, drawn by Claude or Codex.

Floorplan 0.6.2: far fewer false alarms in Health

Hayden Smith74cd6404bd90
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 508f146..c1edb65 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "floorplan",
- "version": "0.6.1",
+ "version": "0.6.2",
"description": "See how your app actually fits together: an interactive map of your codebase where every part, file and web request has a plain-English name and description, with a health check, screens, guided flows, questions answered on the map, and highlights of what was just worked on.",
"author": {
"name": "Hayden Smith",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index c254c74..3c0dc69 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "floorplan",
- "version": "0.6.1",
+ "version": "0.6.2",
"description": "See how your app actually fits together: an interactive map of your codebase where every part, file and web request has a plain-English name and description, with a health check, screens, guided flows, questions answered on the map, and highlights of what was just worked on.",
"author": {
"name": "Hayden Smith",
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 415b6d1..1ae1f14 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,7 +1,19 @@
# Changelog
-## Unreleased
-
+## 0.6.2 (2026-11-02)
+
+- **Far fewer false alarms in Health** (thanks to @samuelpullen15-droid, who reported 13 of them from one site with the new **Not a problem** button):
+ - **Feeds and files meant for everyone:** reading `rss.xml`, `atom.xml`, `llms.txt`, `ads.txt` and similar no longer counts as an open endpoint.
+ - **Addresses you publish yourself:** an endpoint listed in your `llms.txt`, or allowed in your `robots.txt`, is public on purpose. A catch-all route counts when something under it is listed, and a blocked or merely nearby address doesn't.
+ - **Responses marked for everyone:** a `Cache-Control: public` response is public on purpose, including when a helper it imports sets the header. So is a Next.js route with `force-static` or `revalidate`.
+ - **Nothing private to give:** a Next.js `GET` that reads no database, session, cookie or server secret, directly or through what it imports, is no longer reported. A rate limiter's Redis doesn't count, an import Floorplan can't follow does, and so does reading files on a route whose address the caller chooses.
+ - **Payload CMS:** the API routes Payload generates apply its own access rules, so they no longer read as "anyone could change data".
+ - **A "POST only" reply:** a handler that only answers 405 isn't an open endpoint or a way to send fake events.
+ - **Webhooks locked with a shared secret:** comparing against a secret from the environment, `timingSafeEqual`, and helpers like `isAuthorized()` or `verifyWebhookSecret()` now count as checks on Next.js routes.
+ - **A browser tracker's site token:** a token handed to a tracker's `<script>` tag is one every visitor already has. Names like `ACCESS_TOKEN` or `AUTH_TOKEN`, and real key formats, are still reported.
+ - **Files a tool opens by name:** a file whose comment says a tool reads it, or that it's generated, no longer looks unused.
+ - Endpoints that change data are still always checked, and "Not a problem" is still there for anything Health can't work out.
+- **FastAPI checks Health missed** (#7), fixed by @Bl0ck154: dependencies named like `metrics_guard`, a token in a `Header` parameter when the handler rejects a bad one, a Twilio-style signature check inside a helper, and `/readyz` and `/livez` as public health checks.
- **Health reads each Express route's own checks:** a sign-in check in front of a handler defined elsewhere (`router.post('/books', requireAuth, createBook)`) was missed, so the endpoint was reported as open to anyone. The other way round, a route could borrow the check of the route below it, and a handler whose name sounds like a check (`updateUser`) was taken for one, so some open endpoints weren't reported. Fixed by @rudycelekli.
## 0.6.1 (2026-11-01)
diff --git a/CHECKSUMS.txt b/CHECKSUMS.txt
index 2b87697..53425db 100644
--- a/CHECKSUMS.txt
+++ b/CHECKSUMS.txt
@@ -1,11 +1,11 @@
-# Floorplan 0.6.1: SHA-256 of every file the plugin runs from.
+# Floorplan 0.6.2: SHA-256 of every file the plugin runs from.
# Check an installed copy: clone this release, then run node tools/checksums.mjs --check <installed folder>.
43adc6c187150c4b0a4841f0e7448381401be93ee65e2d212be4e7eeb67bb3e4 .agents/plugins/marketplace.json
fdce61be9c420fd16b8cbbff629baa37e8d1096094b3e90bc5ecc0fe1ffc3a78 .claude-plugin/icon.png
98cd297588a52fc7715d29ad10636f3224ee7a99bfbb94230315493dabc7147c .claude-plugin/marketplace.json
-7b27aee4483228ba9b90ef8a7e190b104edaca9a701892f4bfedb811816d1d1a .claude-plugin/plugin.json
+a4fa6ea3141aca9ddd38d9f8d3d025a8975b8d2e27795449e2c3929df27026fc .claude-plugin/plugin.json
7bdb74d57875b25ca9dcd367f79f92b9089f5f4b873bffec898cc6c3f0a84a68 .codex-plugin/icon.png
-c18146dd7995ecb76bba35338e6a833ed6ad1b54090a3f74692f851d650a44ac .codex-plugin/plugin.json
+c19b75d44d0030338e509f43d634fc0bcb6b828c8a3e140fafac5c9936e65ef5 .codex-plugin/plugin.json
e1cdfc2a2f1ae41796c8eae54eed099f95d09d25f2ec521742d3ab7a8aba1337 package.json
034dfc584f4b94bf767e7b9d2df6c16e454bfd1af445f20c0b815b5def9d5049 skills/floorplan/SKILL.md
4dde86cace299094c246604badb73b605a10f47e01a72cc6746680788a7e20f9 skills/floorplan/agents/openai.yaml
@@ -43,7 +43,7 @@ bb02ef4b60dafb05a74eb2561f22a530b5b17935783bd88731c5bea5b6d57609 skills/floorpl
2db69e2bc682c69ea2e1e760bb35badeb7fc035d3d788ee174d183e3128a2056 skills/floorplan/scripts/lib/claudemd.mjs
2baec756cdc47fffa34d945eae7c5027c1c5b9d4cb300d38970f0247ebc4800b skills/floorplan/scripts/lib/common.mjs
47e7db0180395a95e2ec9a075d970f0e03c6210b0bd88b76ae067c9ccfcec7c9 skills/floorplan/scripts/lib/extract.mjs
-aa38a39b0acca7352da8a4425b40e5953b858d72b4980f3c1192c09f6614bb6f skills/floorplan/scripts/lib/health.mjs
+42a40674db1fd06c0da4a1607ebbb1387bd851463942bbe6b607bb89b0e970f6 skills/floorplan/scripts/lib/health.mjs
7076868899b30564d1754e708b9e1907137bd06804f573cf44468e43c4a76964 skills/floorplan/scripts/lib/names.mjs
97837769b2eeebf4c39de2393822c76ab96666bc319d819dd025a0a426084d05 skills/floorplan/scripts/lib/resolve.mjs
088406c7b94ebcdaf047e25b0357c4313be6692b9391299c5f31e53a0968a8d2 skills/floorplan/scripts/lib/routes.mjs
diff --git a/README.md b/README.md
index 6f804cf..e77ffd2 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ Claude or Codex reads your codebase and draws an interactive map of it. Every pa
[![Claude Code plugin](https://img.shields.io/badge/Claude%20Code-plugin-D97757?style=flat-square)](https://code.claude.com/docs/en/overview)
[![Codex plugin](https://img.shields.io/badge/Codex-plugin-111?style=flat-square)](docs/codex.md)
[![Tests](https://img.shields.io/github/actions/workflow/status/haydenschmitty/floorplan/test.yml?branch=main&style=flat-square&label=tests)](https://github.com/haydenschmitty/floorplan/actions/workflows/test.yml)
-[![Version](https://img.shields.io/badge/version-0.6.1-111?style=flat-square)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.6.2-111?style=flat-square)](CHANGELOG.md)
[![License: MIT](https://img.shields.io/badge/license-MIT-111?style=flat-square)](LICENSE)
[![Node 18+](https://img.shields.io/badge/node-%E2%89%A518-111?style=flat-square)](https://nodejs.org)
[![Zero dependencies](https://img.shields.io/badge/dependencies-0-111?style=flat-square)](#how-it-works)
diff --git a/docs/development.md b/docs/development.md
index d2e4ed9..1b07964 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -81,6 +81,7 @@ The tests use Node's built-in test runner, so there's nothing to install (`npm t
| `helpers-lib.test.mjs` | globs, file types, command-line flags, fallback names |
| `secrets.test.mjs` | Health finds secrets, masks them, and ignores placeholders |
| `health.test.mjs` | which endpoints Health calls open to anyone (FastAPI and Express samples in `fixtures/`) |
+| `public-by-design.test.mjs` | what Health leaves alone because it's public on purpose (feeds, addresses a project publishes, cached responses, routes with nothing private, Payload CMS, tracker tokens, files a tool opens), each with a near miss it must still report |
| `stack-health.test.mjs` | Health's checks for Supabase row-level security, Firebase rules, Stripe webhook signatures, secret keys in public variables and CORS, with look-alikes each must leave alone, and a whole sample app done wrong and done right |
| `firebase.test.mjs` | Firebase Cloud Functions: callables and onRequest functions as endpoints, the website's calls to them, Screens, Health, background functions (React + Firebase sample in `fixtures/`) |
| `blueprint.test.mjs` | a map planned from a PRD before any code exists: plan.json errors, endpoints and calls, Screens, the design review, refreshing and switching to the real code (sample PRD in `fixtures/`) |
diff --git a/docs/using-the-map.md b/docs/using-the-map.md
index 8330b1b..5ff6702 100644
--- a/docs/using-the-map.md
+++ b/docs/using-the-map.md
@@ -67,6 +67,8 @@ Each issue has **Show on map**, which highlights the affected files and endpoint
Health leaves password hashes and encrypted values alone (bcrypt, argon2, dotenvx, sops, Ansible Vault and similar), and goes by the value, so a backup with one value left unencrypted is still flagged. It can only recognise encryption that marks itself, and it can't read a `.env` file that git ignores.
+It also leaves alone what's public on purpose, as long as it only reads: feeds and files for crawlers and AI tools (`rss.xml`, `llms.txt` and similar), addresses your project lists in its `llms.txt` or allows in its `robots.txt`, responses marked `Cache-Control: public`, and Next.js `GET` routes that read no database, session or server secret, even through what they import. Endpoints that change data are always checked. Payload CMS's own API routes count as checked, because Payload applies its access rules, so check those rules yourself. A token passed to a browser tracker's script is left alone too, since every visitor already has it.
+
If an issue is wrong, press **Not a problem** and add a reason if you like. It moves to the bottom of the list and out of the count, and stays that way when the map is rebuilt. Editing elsewhere in the file won't bring it back, but it does show again if the same check finds something new in that file or the issue changes severity. **Show again** undoes it. Exported copies keep the issue set apart but leave your reason out.
You can also tick the box to tell the Floorplan developer. That opens a GitHub issue for you to read, edit and send yourself, with the check's name and title, the kinds of files involved and your note. A title can name a file or an endpoint, and the preview shows you exactly what will go. It never includes your code or any values, and nothing is sent unless you send it.