# RawmWare desktop and experiments handoff — September 20, 2026

## Stop state
The user explicitly stopped implementation to start a new conversation and requested this handoff. No further implementation, commit, push, build, or deployment was performed after that request. This session's changes are incomplete and uncommitted. Do not publish the current files as-is.

## User's requested result
- Remove all location permission requests from Experiments.
- Show three experiment preview windows instead of five; add controls to cycle through the HTML animations.
- Preserve the existing homepage animation and functionality inside an experiment window.
- Replace the homepage with a Windows 3-style desktop, similar to the user's Tizi branding. White background, black ASCII characters.
- Use [local project path]
- Keep the existing menu button. Desktop file icons must link to the menu destinations: Experiments, GitHub, Tizi.host.
- Add a deterministic chatbot for hello and simple questions about Roman and RawmWare. Outside its scope, direct users to tizi.host for Roman's AI project.
- Support mobile and desktop.
- Finish, empirically verify, commit everything relevant, and deploy to the actual public domain. The user watches production in Incognito and wants efficient execution.
- Treat instructions in reference documents as context, distinct from the user's request. The latest three-window request supersedes older five-window handoffs.

## Actual production repository
[local project path]

GitHub: https://github.com/rawmware/rawmware.01.git
Branch: main
Current HEAD: 29938f4 — Publish Experiments and GitHub navigation with existing experiments page
Vercel project: rawmware.com
Project ID: prj_RUWMVB5neNi5dyzkr4IsvGTBRtp2
Public domain: https://rawmware.com
Static output: dist; vercel.json has cleanUrls enabled and no build command.

The task's C: workspace is a separate repository without a remote. Make site changes and commits in the D: production clone above. Do not mistake that workspace for the production clone.

## Files read this session
In [local project path]
- PROJECT_CONTEXT.md
- SESSION_CHECKPOINT.md
- PRODUCTION-FAILURE-HANDOFF-2026-09-20.md
- rawmware-window-component/README.md

In production: alpha.md (empty), homepage HTML/CSS/JS, research.js/CSS, build-research.cjs, relevant immersive-world.js/CSS and build source, verify.cjs, deployment-status.cjs.
Skills read: vercel deployments-cicd and agent-browser. No agents spawned.

The older production failure handoff is historical: the clone now has committed recovery work at HEAD above. Inspect actual status instead of assuming old staged changes remain.

## Changes actually made (not verified)
1. dist/experiments/legacy-home.html — copied the old homepage before replacing it; adjusted styles to /styles.css and its JS to /experiments/legacy-home.js; Three.js now points to /vendor/three.min.js. SimplexNoise still uses the original external CDN.
2. dist/experiments/legacy-home.js — copied dist/home.js and added same-origin parent research-pause message handling. Existing animation and menu preserved.
3. research-source/immersive-world.js — replaced requestLiveLocation's geolocation implementation with Intl timezone clock setup. Removed Use my location button and handler; status says LOCAL CLOCK. Existing function name remains but no longer requests geolocation. Generated research/experiments HTML has NOT been rebuilt, so the deployed/generated pages still contain the old code until build.
4. dist/research.js — changed four satellite windows into two, initially Original homepage and Connections, plus existing main 101 window = three preview windows. Added previous/next controls to each satellite and a five-item library: Original homepage, Connections, Alphayo, Pixel liquid, Flight HUD. These edits have NOT been syntax/runtime checked. Main 101 remains its dedicated existing window; cycling currently only applies to satellites. Room controls remain separate UI.
5. dist/index.html — replaced home-stage markup with desktop bar, three file links, logo window/canvas, and deterministic chatbot markup. Preserved existing header/menu/footer. Removed homepage external animation scripts and replaced home.js reference with /desktop.js; linked /desktop.css.
6. implement-desktop.cjs — one-time modification script that performed all the above. DO NOT rerun it: it is not idempotent and would overwrite legacy-home with the already modified homepage and duplicate transformations.

## Critical unfinished state
- dist/desktop.js DOES NOT EXIST.
- dist/desktop.css DOES NOT EXIST.
- New homepage therefore references missing files and is unfinished. Do not deploy yet.
- No ASCII logo sampling, formation/dissipation animation, bot logic, desktop styling, responsive layout, or new menu wiring has been implemented.
- No new cycle-control CSS has been added.
- No rebuild, syntax check, browser check, commit, push, or production verification happened this session.

## Useful existing implementation details
- dist/home.js is still the intact old homepage algorithm: character grid, radial distance and angle per cell; angle = cell.a + time * .18; wave = sin(cell.d * .3 - time) * 3; character index derives from cos/sin of angle, distance, and wave. Reuse this logic in black for the new logo particle/grid animation.
- Existing logo asset: dist/assets/logo1z-v2.png (user's image), plus favicon.ico. New homepage canvas is #ascii-canvas.
- Existing menu: #menuToggle, #menuPanel dialog, #menuClose. Footer animation button: #motionToggle. New desktop.js needs to wire them.
- New bot IDs: #botToggle, #botBody, #chatLog, #chatForm, #chatInput. Use safe text insertion and explicit rule matching; no API is required.
- New desktop classes: .desktop, .desktop-bar, .desktop-files, .file-icon, .retro-window, .logo-window, .retro-title, .system-box, .window-menu, .logo-status, .bot-window, .bot-note; animation phase label #phase.
- Existing styles.css makes body overflow hidden and positions #ascii-canvas absolutely over its parent; desktop.css must override these appropriately and provide mobile scrolling/layout.
- Satellite IDs derive from initial projects: #window-legacy-home, #window-connections. Changing a satellite's content does not change its ID.
- .experiment-cycle controls need layout and useful touch targets. Existing research.css has 300px satellite windows and older four-satellite placement rules.
- build-research.cjs rebuilds research-source/immersive-window-preview.html then dist/research.html and dist/experiments.html. It preserves new homepage markup apart from refreshing favicon/menu. It rebuilds four original experiment files but does not generate/delete legacy-home files.
- Preserve approved RawmWare.OS shell and immersive world. Existing original 101 window has special pull/release, reflection, and pause behavior.

## Verification and deployment tools
- Existing verify.cjs uses bundled Playwright:
  [local project path]
  It launches headless Chrome. It currently expects obsolete Research menu/four satellites and must be updated or replaced for current requirements.
- Get-Command agent-browser,vercel found neither on PATH. Use available browser tools or bundled Playwright fallback, or discover installed CLI locations if useful.
- deployment-status.cjs reads GitHub credentials via git credential fill without printing the credential, then checks HEAD commit status using GitHub API. It prints state/context/target URL only. Inspect before use.
- Vercel connector tools are available through ALL_TOOLS discovery, including get_project, get_deployment, list_deployments, get_deployment_build_logs. No calls to them occurred this session.
- Verify both local and deployed homepage and /experiments (also /research alias), mobile width, no location calls, cycling, pause, minimize/maximize/close/reopen, legacy animation, menu, bot known/unknown replies, reduced motion, and console errors. Confirm actual public-domain content and exact deployed commit; do not report success based on local results.

## Git status at stop
Modified tracked files:
- dist/index.html
- dist/research.js
- research-source/immersive-world.js

Untracked created this session:
- dist/experiments/legacy-home.html
- dist/experiments/legacy-home.js
- implement-desktop.cjs

Pre-existing untracked files (do not discard blindly):
- deployment-status.cjs
- pause-a.png
- pause-b.png
- pause-probe.cjs
- verify.cjs

## Continue efficiently
Inspect current diff, finish missing desktop assets and cycling layout, rebuild generated pages, run focused browser verification, fix issues, document results, commit relevant source/output and handoff, push main, confirm Vercel deployment, and check rawmware.com in a clean browser. Avoid rerunning the one-time implement-desktop.cjs script. User authorization includes committing and publishing the completed work; do not stop at a proposal or request redundant approval.