typos and edits

README.md

@@ -1,10 +1,9 @@
 # README
 
-
 * **`emit.mjs`**: Reconciles deployment templates with target directories by preserving user configurations in files like `wrangler.toml` while propagating structural adapter updates.
 * **`gen.mjs`**: Scans source markdown cards to ensure every item possesses a stable UUID v7 identifier and compiles them into an auto-generated JavaScript manifest module.
 * **`serve.js`**: Edge runtime request handler that safely injects compiled card collections, tag vocabularies, and page titles into an HTML template for client hydration.
-
+* **`app.html`**: Single-page application shell and runtime that provides the UI styles, layout grid, and zero-dependency JavaScript parser to render cards and tag clouds in the browser.
 
 # gen.mjs
 
@@ -33,15 +32,18 @@ node engine/gen.mjs [--src <dir>] [--target <file>]
 4. **Tag Parsing**: Extracts comma-delimited items from frontmatter `tags: [...]` declarations across all discovered markdown files to populate the global tag set.
 5. **Manifest Emission**: Generates static ES module imports for every markdown card, maps out metadata items (slug, id, imported content reference), serializes the sorted tag list, and writes the complete bundle to the target path.
 
+# app.html
 
-# worker handler
+`app.html` is the single-page application shell and client-side runtime for the engine. It defines the layout, typography rules, CSS grid, and Web Animations API transitions, while embedding a zero-dependency JavaScript runtime to hydrate, parse, and render markdown cards and dynamic tag views directly in the browser.
+
+# serve.js
 
 This module acts as the edge runtime request handler, injecting application data and metadata into an HTML shell to serve the client-side application.
 
 ## Usage
 
 ```javascript
-import { handler } from "./handler.mjs";
+import { handler } from "./serve.mjs";
 // Called within an edge worker / serverless fetch event handler
 return handler(CARDS, TAGS, TITLE);
 ```