Back to Nappakura
SOURCE / PINNED RELEASE

Made of little things.

Nappakura

Release
a75ca0f8b596…
Author-recorded commit
4463126213fa…
License
LICENSE
Author’s source reference
nostr://npub182jczunncwe0jn6frpqwq3e0qjws7yqqnc3auccqv9nte2dnd63scjm4rf/wss%3A%2F%2Fgit.napplet.soy%2F/n-8db03001b62

Archive hash verified: b448d77b767ae754…. The source-to-build association is the author’s claim; it has not been independently rebuilt.

docs/verification.md
# Nappakura v1 verification

Verified locally on 2026-11-12 with soyLI 0.34.0 and Chromium. Not published.
Final artifact SHA-256: `2fb5972b43952a3224a5a4754bc9fa2ddcc1bce2f1ef05f5efbb528434015f47`.

## Automated checks

- `pnpm type-check`: passed.
- `pnpm build`: passed; `dist/` contains one self-contained `index.html`.
- `pnpm test:guidance`: 6 passed; existing boundary scans retained.
- `pnpm test:geometry`: 13 passed. Covers OBJ polygons/negative indices, ASCII and
  binary STL, malformed input, concave triangulation, preserved edge lengths,
  non-overlapping unfolded faces, cut/rejoin/cycle rejection, tab ownership and
  collision avoidance, off-page/overlap export refusal, project/PDF round-trips,
  physical PDF dimensions and cross-reference offsets, paper-aware splitting,
  inverted normals, stable edge IDs after winding repair, and unused vertices.
- `pnpm test:conformance`: **5 passed, 0 failed, 5 skipped**. Passed sandbox,
  injected global, clean startup, forbidden-global scan and domain absence.
  Three manifest checks skipped because no signed event was supplied; wire skipped
  because the harness recorded no envelopes; lifecycle teardown not measured.
  These skips do not establish manifest, wire or lifecycle conformance.
- `pnpm test:browser`: passed with no fs/storage/config/theme; example editing,
  cutting and undo work and missing-domain actions are disabled.
- `NAPPLET_PREVIEW_URL=<soyli dev URL> pnpm test:browser`: passed real hosted
  OBJ import, paper-aware unfolding and PDF download through NAP-FS.
- `soyli check`: passed startup in `space-playback-9-llm-cvm-payments`, Chromium
  153.0.8010.12. Its interaction recipe was not configured; interaction evidence
  below comes from separate Playwright tests. Media is not used. Independent-host
  compatibility was not measured by this check.
- Source authority audit: no direct network, browser storage, signer, parent DOM
  or shim calls. SDK is the only host integration. No relay escape hatches.

## Hosted interaction and visual review

Used the URL printed by `soyli dev`, not a raw Vite server. Observed host `fs`,
`storage` and `config` availability. Exercised host file prompts, downloaded a
three-page cube PDF and an editable project, and re-imported the project. Saved
and restored a draft through host storage. Cut a seam (3 → 4 pieces), switched
its tab, undid both changes and restored the original 3-piece project.

Selected another face in Tools, then clicked the actual 3D model to select face 1.
Dragged a piece on the paper canvas (X 14.2 → 21.9 mm), then undid it back to
14.2 mm. Checked both view tabs and print preview. No optional domain is needed
for the geometry engine or example.

Inspected the generated gem PDF and all three cube pages rendered with Poppler.
Verified A4 MediaBox dimensions, vector lines, readable matched numbers, tabs,
footer and a 20 mm reference bar. Print instructions explicitly require Actual
size / 100%; the exporter never scales to fit.

Actual iframe sizes tested: **200×160**, **320×560**, **900×600**, and **1440×865**.
The first shows the useful minimum-size notice; the others have no horizontal
page overflow. Test-only overrides explicitly set the iframe width/height and
removed the host's 300px minimum so these are measured inner dimensions.

Touch contexts used outer viewports **390×844**, **360×640**, **844×390**. Measured
inner frames were **390×709**, **360×505**, **844×300**, respectively; the host
retains its minimum in landscape. Coarse-pointer media matched. Tapped view
switches, print preview, numeric settings and camera controls. Rechecked the
portrait toolbar with all file actions wrapped into visible rows. These are
browser emulation checks, not real-device claims.

Switched host appearance through light and dark: the app-owned palette and canvas
remained unchanged and the document stayed intact. The missing-domain browser
fixture also ran without theme. Preview cover `preview.png` is a real 1200×750
capture of the final artifact and was visually inspected. No promotional clip or
portrait video was produced.

During repeated source hot reloads, the host logged transient `/revision` 400
responses. Final fresh-load host checks and file operations passed; no napplet
page errors were observed in the fallback test.

## Remaining coverage

No real iOS/Android device, screen-reader session, independent production shell
(such as Paja), physical printer/paper assembly, signed publication manifest, or
large adversarial mesh corpus has been tested. The editor deliberately limits
models to 2,000 triangles and uses a basic packer/CPU renderer. Automatic results
on complex meshes still need manual seam and tab review.


## Modelling / tool reference — 2026-11-13

Implemented and verified locally on `codex/nappakura-webmcp`, based on `2a6187e`.
Publication identifier and manifest requirements are unchanged. Not published.

- `pnpm verify`: passed guidance (6), geometry (17), TypeScript and production build.
  New geometry cases cover polygon operations, stale revisions, rollback, undo/redo,
  document-context boundaries and v1/v2 project round trips.
- `pnpm test:conformance`: **5 passed, 0 failed, 5 skipped**, with the same
  manifest/wire/teardown evidence limitations described above.
- `pnpm test:browser`: passed the existing absent-domain editing and hosted
  OBJ import / NAP-FS PDF export workflows.
- `NAPPLET_PREVIEW_URL=<updated soyLI preview> pnpm test:modelling:browser`:
  passed manual box creation, explicit tool consent, extrusion, inset, edge split,
  vertex movement, stale-write rejection, undo/redo, unfolding, arrangement and
  printability checks. Denying the independent file approval rejects PDF export;
  accepting it prepares a valid PDF which was downloaded through the host panel.
- The shell's isolated browser suite also loaded this real built artifact in the
  website player. Both website and preview use the actual injected shared runtime.
  Fullscreen tool controls stay usable. Frame checks covered 200×160 (minimum-size
  notice), 320×560 and 900×600 without horizontal document overflow.
- Browser artifacts: ignored `.napplet-space/ui-checks/modelling-*.png` and
  `modelled-box.pdf`. Geometry and UI assertions establish a usable local workflow,
  not physical print assembly or native external-agent interoperability.

The tested Chromium does not implement `document.modelContext`. Native WebMCP
registration/cancellation is tested against the reviewed API with a mock in the
shell repository; internal dispatch is tested in real browser contexts. There is
no shell-chat/inference loop in this reference. The experimental tool profile is
optional and does not change NIP-5D authority. See [MODELLING.md](MODELLING.md) for
implemented semantics, validation bounds and remaining limitations.


## Assembly validation repair — 2026-11-13

The live tool-created signal tower reproduced nine missing tabs at 80 mm. Tab
planning now tries both faces and automatic seam repair. The same original mesh
gets all its tabs, but its crowded cap is correctly rejected for missing readable
labels. The prepared print version explicitly widens the cap and uses 180 mm
finished size: eight pieces, 60 paired joins, five A4 sheets. All 60 joins have
one tab and two non-overlapping numbers at least 2 mm in font size. No export
operation silently changes physical size. All five PDF pages were rendered and
visually inspected, including fold/cut lines, labels, footer and scale bar.

- `pnpm verify`: 6 guidance and 20 geometry tests, type-check and build passed.
- Regressions cover omitted/hidden/disabled/tiny tabs, the original tower, blocked
  unreadable labels, alternate-side ownership, ownership independent of sheet
  placement, preservation of seams by arrangement, shared tool/PDF failures,
  label collisions, and exact PDF bytes after project serialization.
- Conformance: 5 passed, 0 failed, 5 skipped; the earlier evidence limitations apply.
- Absent-domain browser editing passed. The real soyLI preview tool workflow passed
  through modelling, stale-write rejection, explicit print sizing, unfolding,
  print checks, denied/approved file export and actual PDF download. Fullscreen
  and small-frame checks passed. No inference or public relay traffic was used.

This reference and its print artifact are local; the napplet has not been
republished. Physical cutting/gluing and arbitrary complex meshes remain untested.
See MODELLING.md for what the shared printability check can and cannot establish.


## Polygon modelling, gizmos and exports — 2026-11-14

Implemented on `codex/polygon-print-polish`; publication identity is preserved.
Coplanar input triangles form logical polygons and do not create diagonal paper
seams. Extrusions preserve quad sidewalls. Glue tabs taper to, and are checked
against, the receiving polygon. The opaque renderer uses a depth buffer.

- `pnpm verify`: 6 guidance and 25 geometry tests, type-check and build passed.
  Regressions cover polygon preservation, legacy diagonal-seam migration,
  receiving-face tab fit, depth-order-independent rendering/picking, hidden lines,
  planar-edit rejection and projected gizmo transforms/snapping.
- Conformance: 5 passed, 0 failed, 5 skipped; manifest/wire/teardown evidence remains
  outside the unsigned fixture. No claim of an independent production-shell test.
- Actual shared soyLI sandbox: manual and agent-tool modelling, stale-write
  rejection, undo/redo, unfolding, denied/approved NAP-FS export and downloaded PDF
  passed. The two A4 PDF pages were rendered and visually inspected for readable
  join numbers, tapered tabs, cut/fold lines, page margins and scale legend.
- `node tests/gizmo-browser.mjs` with `NAPPLET_PREVIEW_URL` exercises axis/XY-plane
  movement, single-axis scaling, rotation, one revision per drag, Escape rollback
  and invalid planar edits without mutation. Handles appear for vertex, edge and
  polygon selections. Numeric operations remain a non-drag alternative.
- Fullscreen and 200×160, 320×560 and 900×600 frame checks passed. The minimum-size
  notice remains at 200×160; the 320×560 model viewport retains at least 120 px
  height with all nine tools accessible in the compact toolbar. Touch emulation at
  320×560 moves the operation toolbar into Tools; creation and returning to the
  model are tested, as is the 900×600 landscape layout. No horizontal
  document overflow. Absent-domain UI/import/export browser checks also passed.
- Matching shell regressions exercise real chunked PDF downloads in fullscreen,
  nested shell-dialog actions and global tool revocation. These use the actual
  injected runtime, not a replacement app shim.

Physical cutting/gluing, real touch devices and exhaustive adversarial geometry
remain unverified. The geometric checks cannot guarantee assembly order or account
for paper thickness. Native external-agent interoperability is not claimed by the
mock registration checks. The NAP draft remains deferred.