# Train Online plan (working draft)

## Product journeys

On 2026-10-19, a working learner journey was established in
`product-journeys.html`:

1. A logged-in learner starts or resumes an exercise.
2. Nyjah presents a coding question.
3. The learner asks clarifying questions in the workspace.
4. The learner writes code in the codepad.
5. The learner runs the saved code snapshot.
6. The learner sees stdout in a pseudo terminal.
7. The learner iterates on code and runs again.
8. The agent can inspect the current saved code and run stdout through controlled tools.

This is a product-design working draft, not a finalized interaction or API contract. The HTML document lists the decisions that remain open, including exercise entry, agent initiative, execution input/history, and academic-integrity boundaries.

### Current interaction direction

- The journey wireframes use dark mode.
- The learner interacts with Nyjah, an AI interviewer (not a coach).
- Running code opens a pseudo-terminal drawer from the bottom of the code panel; it does not cover Nyjah's chat panel.
- When Nyjah is reading code or run output, the code panel remains visually unchanged. Nyjah's working state and resulting feedback appear in the chat panel only.

## Public documentation deployment

Public documentation lives in tracked `docs/`, with a navigation homepage,
HTML product and architecture pages, and public Markdown planning sources.
Top-level `styles/` owns product tokens, controls, and workbench layouts shared
by the app and product documentation. Documentation presentation CSS stays in
`docs/css/`, and application document resets stay in `web/src/design/base.css`.

With Node.js 22, `node scripts/build-docs.mjs` copies `docs/` and `styles/` into
ignored `dist-docs/`. Cloudflare Pages should use that build command from the
repository root and publish `dist-docs/`. Git integration watches `docs/*`, `styles/*`, and
`scripts/build-docs.mjs`. Cloudflare Pages wildcards include path separators,
so nested documentation and style changes match.
Cloudflare Pages project `train-online-docs` is deployed publicly at
https://train-online-docs.pages.dev/ from `main` commit `ec73cb7`.
The initial deployment and public HTML/CSS/Markdown files were verified.
Automatic deployments and those watch paths are saved and verified in
Cloudflare. The push-triggered deployment test passed for commit `11fdcf3`
(deployment `83db04fc-dd80-4681-82cf-bb0aa0b45182`): temporary homepage text
appeared on the production URL. The test text is removed from the source.
Private working notes remain in ignored `dev-docs/`.