Distillation

Date: Aug 5, 2026

• 🔴 (13:37) User stated that AT Protocol record keys will always be valid Unicode and will never be relaxed to allow arbitrary byte-strings.
• 🔴 (13:38) User stated that TIDs are always 13 ASCII characters, use sortable Base32 alphabet 234567abcdefghijklmnopqrstuvwxyz, and have a first character restricted to 234567abcdefghij.
• 🔴 (13:38) User stated that their agent must stop blocking on sleep and must not silently give up while waiting for background work.
• 🟡 (13:37) AT Protocol record-key documentation identified tid, nsid, literal:<value>, and any as supported record-key types; generic record keys allow only ASCII alphanumerics plus ., -, _, :, and ~, with lengths from 1 through 512 characters.
• 🟡 (13:38) TID documentation specified a 64-bit value encoded without padding, with the top bit clear, 53 timestamp bits, and 10 random clock-identifier bits; the reference syntax is /^[234567abcdefghij][234567abcdefghijklmnopqrstuvwxyz]{12}$/.
• 🟡 (13:38) Implementation decision: deterministic slug-derived TIDs were chosen over time-generated TIDs because stable keys preserve repeated-publish upserts and avoid changing AT-URIs; SHA-style hashing was considered, while FNV-1a 64-bit was used because a framework-free deterministic implementation was available.
• 🟡 (13:38) src/lib/standard-site.ts replaced slug validation with slugHash(slug: string), using FNV-1a 64-bit constants 14695981039346656037n and 1099511628211n, masking with (1n << 63n) - 1n, and encoding 13 characters using TID_ALPHABET = "234567abcdefghijklmnopqrstuvwxyz".
• 🟡 (13:38) documentRkey(slug: string) now rejects only an empty slug with Cannot derive a standard.site document key from an empty slug. and derives the rkey by repeatedly taking value & 31n and shifting right by 5n; the human-readable slug remains the document path and canonical URL.
• 🟡 (13:38) scripts/publish-standard-site.mjs documentation was updated to state that document rkeys are TIDs derived from post slugs, while publication rkey remains self; deterministic keys continue to support putRecord upserts without duplicates and pruning of deleted or renamed posts.
• 🟡 (13:38) astro build completed successfully in /home/byk/Code/byk.github.io, producing static output in dist/; 17 pages were built in 5.27s, including /standard-site.json and /posts/ultimate-setup-labs/index.html.
• 🟡 (13:38) Generated dist/standard-site.json assigned ultimate-setup-labs rkey 3ddlziywd523h, with URI at://did:plc:kl3s4yablm3fgnxfkn47uy5r/site.standard.document/3ddlziywd523h.
• 🟡 (13:39) Validation found 13 unique document TIDs; 3ddlziywd523h was confirmed as the generated key for ultimate-setup-labs.
• 🟡 (13:39) Rendered /home/byk/Code/byk.github.io/dist/posts/ultimate-setup-labs/index.html contains the same site.standard.document URI as the manifest, while preserving canonical URL https://byk.im/posts/ultimate-setup-labs/.
• 🟡 (13:38) Direct node execution failed because Node is managed through Volta and no default version was configured; validation was rerun through pnpm’s managed runtime.
• 🟡 (13:38) The working tree showed modifications to .lore.md, scripts/publish-standard-site.mjs, and src/lib/standard-site.ts, plus untracked src/content/posts/teaching-my-agent-to-wait.mdx; the existing .lore.md change and untracked draft post were left untouched.
• 🟡 (13:39) git diff --check completed without errors.
• 🟡 (13:39) The implementation task list was completed: inspect Standard.site implementation and latest output; implement TID-compatible document rkeys; run targeted build and generated-record validation.