phronesis · laserbrain

laserbrain docs

Your documentation is a set of claims about a running system, true on the day it was written. Nothing errors when they stop agreeing — the page still renders, the tests still pass, the endpoint still answers. It just answers something the docs no longer describe, and the first person to find out is someone following them.

Only claims with a mechanical referent are checked: an endpoint either answers or it does not, a field is either in the response or it is not. Nothing here grades your prose, and a claim it cannot resolve is reported unchecked — never as passing.

your documentation

the API it describes — optional

nothing probed yet

0
holds
0
drifted
7
unchecked

Everything reads unchecked because nothing has been looked at. That is the honest state, and it is what the numbers would say if this page pretended to check without a target. Give it a base URL to actually probe.

every claim, and what happened to it

uncheckedGET /line 3
not probed
uncheckedGET /healthline 5
not probed
uncheckedGET /v1/widgetsline 7
not probed
uncheckedPOST /v1/widgetsline 9
not probed
uncheckedDELETE /v1/widgets/{id}line 11
path contains a placeholder — probing it would test the literal string, not the route
uncheckedwidget_idline 7
GET /v1/widgets was not probed
uncheckedcreated_atline 7
GET /v1/widgets was not probed

it never sends a write

Only GET, HEAD and OPTIONS are ever sent. A documented POST or DELETE is reported unchecked, permanently, and there is no flag to change that. A documentation checker that fires writes at a live system to see whether they are documented correctly would, on a good day, create junk records — and on a bad day, delete a customer.

Public httpshosts only. IP literals, loopback and private names are refused: this reaches a URL you typed from inside Cloudflare’s network, and one that would follow you into private space is a hole rather than a product.

*.workers.devis refused too, for a different reason: a Worker’s request into that zone comes back 404 for every route whatever the route does, so every finding would be drift that is not there. This page found that by probing its own prober, whose /healthanswers 200 to everyone else. Point it at the API’s custom domain.

read from your docs · 5 endpoints (4 probeable) · 2 field claims

laserbrain AI · logic engine · the engine