@michaelmagan/dnumb 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michaelmagan/dnumb",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Turns a rendered page into measurements an agent can read: element geometry, overflow, clipping, and a text diff of what changed between two states.",
   "keywords": [
     "agent",
@@ -33,12 +33,13 @@
   "files": [
     "dist",
     "skills",
-    "AGENTS.md"
+    "AGENTS.md",
+    "docs/digest.md"
   ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
-  "packageManager": "pnpm@11.24.0",
   "intent": {
     "version": 1,
     "repo": "michaelmagan/dnumb",
@@ -55,21 +56,6 @@
       "dnumb": "./src/cli.ts"
     }
   },
-  "scripts": {
-    "build": "zshy --project tsconfig.build.json && node scripts/exports-map.mjs",
-    "postbuild": "node scripts/exports-map.mjs",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check --error-on-warnings .",
-    "format": "biome check --write .",
-    "test": "vitest run --project unit",
-    "test:browser": "vitest run --project browser",
-    "test:all": "vitest run",
-    "test:travel": "bash scripts/travel-test.sh",
-    "check:package": "publint --strict && attw --pack .",
-    "prepack": "pnpm run build",
-    "prepublishOnly": "pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run test:browser && pnpm run check:package",
-    "release": "changeset publish"
-  },
   "peerDependencies": {
     "playwright-core": ">=1.17.0"
   },
@@ -137,5 +123,19 @@
         "./dist/spec/index.d.cts"
       ]
     }
+  },
+  "scripts": {
+    "build": "zshy --project tsconfig.build.json && node scripts/exports-map.mjs",
+    "postbuild": "node scripts/exports-map.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check --error-on-warnings .",
+    "format": "biome check --write .",
+    "test": "vitest run --project unit",
+    "test:browser": "vitest run --project browser",
+    "test:all": "vitest run",
+    "test:travel": "bash scripts/travel-test.sh",
+    "check": "pnpm run typecheck && pnpm run lint && pnpm run test",
+    "check:package": "publint --strict && attw --pack .",
+    "release": "changeset publish"
   }
-}
+}

package/skills/dnumb/SKILL.md

@@ -27,12 +27,13 @@ e5 nav.menu "Actions" @39,104 182x109 →-110 [clipped by e2 div; overflow:hidde
 A menu overlapping the sibling before it — negative gap — clipped by its own parent's
 `overflow: hidden` with only a 5px sliver surviving. Neither line says "bug". You decide that.
 
-## Status: pre-release
+## Status: published
 
-Not yet published to npm. The library surface below is built and tested. The CLI has a stable verb
-set — `capture`, `look`, `diff`, and `q describe|find|at|within|distance|nearest|facts|color` — worked in
-[README § From the CLI](https://github.com/michaelmagan/dnumb/blob/main/README.md#from-the-cli) and
-[§ Reading a diff](https://github.com/michaelmagan/dnumb/blob/main/README.md#reading-a-diff). This
+`npm install --save-dev @michaelmagan/dnumb` — MIT, zero dependencies. The library surface below is
+built and tested. The CLI has a stable verb set — `capture`, `look`, `diff`, and
+`q describe|find|at|within|distance|nearest|facts|color` — worked in
+[README § From the CLI](../../README.md#from-the-cli) and
+[§ Reading a diff](../../README.md#reading-a-diff). This
 file does not restate flags: run `dnumb --help` for the exhaustive, versioned list of what your
 installed copy supports, and trust it over any prose here or there.
 
@@ -53,7 +54,7 @@ Read the digest. The header names the URL, the viewport, the capture state, and
 carry facts. Most elements get their own line; a run of repeated siblings (a list, a table body)
 folds into one summary line instead, naming each folded sibling's id and position but not its
 descendants — see [`docs/digest.md` § The fold
-line](https://github.com/michaelmagan/dnumb/blob/main/docs/digest.md#the-fold-line) before reading
+line](../../docs/digest.md#the-fold-line) before reading
 an absent element in a fold as absent from the page. Anything measurable that does not fit its box
 gets a bracketed fact on its own line.
 
@@ -70,6 +71,15 @@ npm install --save-dev @michaelmagan/dnumb
 everything — dnumb reuses your browsers and never downloads its own. If it does not, everything
 downstream of a saved bundle still works with no browser at all.
 
+**No install, just try the CLI:** `npx @michaelmagan/dnumb --help` (or, on a bun project, `bunx
+@michaelmagan/dnumb --help`). **After installing — via npm, pnpm, or `bun add -d
+@michaelmagan/dnumb` — the shorter `npx dnumb --help` / `bunx dnumb --help` also works**, either
+one, since all three package managers populate `node_modules/.bin/dnumb` the same way and both
+`npx` and `bunx` resolve a local bin from it before ever touching the registry. **A bare `npx dnumb
+...` or `bunx dnumb ...` with nothing installed 404s against the registry**, because the tool is
+then resolving `dnumb` as a package name, not a bin name, and no unscoped `dnumb` package exists. A
+404 there means "install it," not "the tool doesn't exist."
+
 ## Read this before you use the output
 
 **Facts come with counter-facts, and a fact is not a verdict.** The same number means different
@@ -92,9 +102,9 @@ contrast, it never says whether a ratio is good enough — that threshold lives
 Five kinds of fact exist in total — `overflow-x`, `overflow-y`, `zero-box`, `clipped`, and `color`
 (the one that never prints inline on an element line — only in the digest's `# colors:` header and
 `q color`) — one line each on what the measurement *is* in
-[AGENTS.md](https://github.com/michaelmagan/dnumb/blob/main/AGENTS.md#facts-with-counter-facts),
+[AGENTS.md](../../AGENTS.md#facts-with-counter-facts),
 full grammar in
-[`docs/digest.md`](https://github.com/michaelmagan/dnumb/blob/main/docs/digest.md#color).
+[`docs/digest.md`](../../docs/digest.md#color).
 
 **Element ids are stable within one capture only.** `e13` is an index in capture order, not a DOM
 id. Inserting one element earlier in the document shifts every id after it. Never carry an id
@@ -131,6 +141,6 @@ Spend a round-trip when a visual impression needs checking. Do not sweep a page
 
 The digest grammar — every token, every fact form, the fold and collapse syntax, and the parser
 contract — is specified in
-[`docs/digest.md`](https://github.com/michaelmagan/dnumb/blob/main/docs/digest.md). `diffCaptures`
+[`docs/digest.md`](../../docs/digest.md). `diffCaptures`
 and the CLI's `diff` verb share one grammar, worked in
-[README § Reading a diff](https://github.com/michaelmagan/dnumb/blob/main/README.md#reading-a-diff).
+[README § Reading a diff](../../README.md#reading-a-diff).