Summary
This PR adds the socratiq/ source directory to the repository on a new branch.
It includes all source code, configurations, and assets for the SocratiQ
interactive tool while strictly excluding dependencies and build artifacts.
Area
Book (textbook content, figures, exercises)
TinyTorch (modules, tests, milestones)
StaffML (interview questions, challenges)
Kits (hardware labs)
Infrastructure (CI/CD, scripts, config)
Changes
Created a new feature branch feat/socratiq.
Added the socratiq/ directory as a regular folder (removed embedded .git to
avoid submodule complexity).
Implemented a local .gitignore within socratiq/ to prevent node_modules/
and dist_vite/ from being tracked.
Staged and committed 206 source files, including the src_shadow/ logic,
Vite/Webpack configurations, and assets.
Testing
Rendered the book locally (quarto render)
Ran tests (pytest tests/)
Ran tito module test NN for affected module(s)
Manual verification: Verified the commit contents using git ls-tree to
ensure zero inclusion of node_modules or dist folders. Confirmed the
directory structure is clean and follows the project's organization.
Related Issues
Related to the integration of SocratiQ interactive widgets into the Quarto
book.
🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.
## 📋 Pull Request Information
**Original PR:** https://github.com/harvard-edge/cs249r_book/pull/1394
**Author:** [@kai4avaya](https://github.com/kai4avaya)
**Created:** 4/18/2026
**Status:** 🔄 Open
**Base:** `dev` ← **Head:** `feat/socratiq`
---
### 📝 Commits (6)
- [`520bebe`](https://github.com/harvard-edge/cs249r_book/commit/520bebe9d7b06cc0b765a219d29c70f885401d6b) feat: add socratiq directory (excluding node_modules and dist)
- [`5cf0e2b`](https://github.com/harvard-edge/cs249r_book/commit/5cf0e2bcf0dd30b0d5a76ffdffba6585fa73c89f) feat: Integrate SocratiQ interactive widget and update Quarto index
- [`c198790`](https://github.com/harvard-edge/cs249r_book/commit/c198790cc433d831bb037ce37ce84484a3c4a194) feat: sync SocratiQ source changes and remove legacy bundle
- [`288e4c5`](https://github.com/harvard-edge/cs249r_book/commit/288e4c5999b552ed9754d797460adf3f42638c5e) feat: fix SocratiQ re-entry bug and add initialization loader
- [`0f85cea`](https://github.com/harvard-edge/cs249r_book/commit/0f85cea41c1f04a49109086846376f6d0b3a07d2) fix: address CodeQL security alerts and code quality warnings
- [`f73912d`](https://github.com/harvard-edge/cs249r_book/commit/f73912d2908eb849d3b99b61101397f3a9aea325) feat: redesign meditation pulse toggle button with label and icon
### 📊 Changes
**214 files changed** (+82738 additions, -10706 deletions)
<details>
<summary>View changed files</summary>
📝 `book/quarto/index.qmd` (+1 -1)
➕ `book/quarto/tools/scripts/socratiQ/assets/style.css` (+1 -0)
📝 `book/quarto/tools/scripts/socratiQ/bundle.js` (+1662 -1381)
➕ `book/quarto/tools/scripts/socratiQ/collaborative-widget-bridge.js` (+12390 -0)
➕ `book/quarto/tools/scripts/socratiQ/collaborative-widget-bridge.umd.cjs` (+4887 -0)
➖ `book/tools/scripts/socratiQ/bundle.js` (+0 -9324)
➕ `socratiq/.gitignore` (+3 -0)
➕ `socratiq/README.md` (+178 -0)
➕ `socratiq/favicon.ico` (+0 -0)
➕ `socratiq/package-lock.json` (+3446 -0)
➕ `socratiq/package.json` (+57 -0)
➕ `socratiq/serve.py` (+39 -0)
➕ `socratiq/src_shadow/.indexHtml.js.kak.GivKQW` (+631 -0)
➕ `socratiq/src_shadow/.indexHtml.js.kak.xF4mD5` (+632 -0)
➕ `socratiq/src_shadow/configs/client.config.js` (+423 -0)
➕ `socratiq/src_shadow/configs/db_configs.js` (+58 -0)
➕ `socratiq/src_shadow/configs/db_configs_one.js` (+278 -0)
➕ `socratiq/src_shadow/configs/env_configs.js` (+43 -0)
➕ `socratiq/src_shadow/configs/initial_config_styles.js` (+12 -0)
➕ `socratiq/src_shadow/cssStyles.js` (+1216 -0)
_...and 80 more files_
</details>
### 📄 Description
Summary
This PR adds the socratiq/ source directory to the repository on a new branch.
It includes all source code, configurations, and assets for the SocratiQ
interactive tool while strictly excluding dependencies and build artifacts.
Area
- [ ] Book (textbook content, figures, exercises)
- [ ] TinyTorch (modules, tests, milestones)
- [ ] StaffML (interview questions, challenges)
- [ ] Kits (hardware labs)
- [x] Infrastructure (CI/CD, scripts, config)
Changes
- Created a new feature branch feat/socratiq.
- Added the socratiq/ directory as a regular folder (removed embedded .git to
avoid submodule complexity).
- Implemented a local .gitignore within socratiq/ to prevent node_modules/
and dist_vite/ from being tracked.
- Staged and committed 206 source files, including the src_shadow/ logic,
Vite/Webpack configurations, and assets.
Testing
- [ ] Rendered the book locally (quarto render)
- [ ] Ran tests (pytest tests/)
- [ ] Ran tito module test NN for affected module(s)
- [x] Manual verification: Verified the commit contents using git ls-tree to
ensure zero inclusion of node_modules or dist folders. Confirmed the
directory structure is clean and follows the project's organization.
Related Issues
- Related to the integration of SocratiQ interactive widgets into the Quarto
book.
---
<sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
📋 Pull Request Information
Original PR: https://github.com/harvard-edge/cs249r_book/pull/1394
Author: @kai4avaya
Created: 4/18/2026
Status: 🔄 Open
Base:
dev← Head:feat/socratiq📝 Commits (6)
520bebefeat: add socratiq directory (excluding node_modules and dist)5cf0e2bfeat: Integrate SocratiQ interactive widget and update Quarto indexc198790feat: sync SocratiQ source changes and remove legacy bundle288e4c5feat: fix SocratiQ re-entry bug and add initialization loader0f85ceafix: address CodeQL security alerts and code quality warningsf73912dfeat: redesign meditation pulse toggle button with label and icon📊 Changes
214 files changed (+82738 additions, -10706 deletions)
View changed files
📝
book/quarto/index.qmd(+1 -1)➕
book/quarto/tools/scripts/socratiQ/assets/style.css(+1 -0)📝
book/quarto/tools/scripts/socratiQ/bundle.js(+1662 -1381)➕
book/quarto/tools/scripts/socratiQ/collaborative-widget-bridge.js(+12390 -0)➕
book/quarto/tools/scripts/socratiQ/collaborative-widget-bridge.umd.cjs(+4887 -0)➖
book/tools/scripts/socratiQ/bundle.js(+0 -9324)➕
socratiq/.gitignore(+3 -0)➕
socratiq/README.md(+178 -0)➕
socratiq/favicon.ico(+0 -0)➕
socratiq/package-lock.json(+3446 -0)➕
socratiq/package.json(+57 -0)➕
socratiq/serve.py(+39 -0)➕
socratiq/src_shadow/.indexHtml.js.kak.GivKQW(+631 -0)➕
socratiq/src_shadow/.indexHtml.js.kak.xF4mD5(+632 -0)➕
socratiq/src_shadow/configs/client.config.js(+423 -0)➕
socratiq/src_shadow/configs/db_configs.js(+58 -0)➕
socratiq/src_shadow/configs/db_configs_one.js(+278 -0)➕
socratiq/src_shadow/configs/env_configs.js(+43 -0)➕
socratiq/src_shadow/configs/initial_config_styles.js(+12 -0)➕
socratiq/src_shadow/cssStyles.js(+1216 -0)...and 80 more files
📄 Description
Summary
This PR adds the socratiq/ source directory to the repository on a new branch.
It includes all source code, configurations, and assets for the SocratiQ
interactive tool while strictly excluding dependencies and build artifacts.
Area
Changes
avoid submodule complexity).
and dist_vite/ from being tracked.
Vite/Webpack configurations, and assets.
Testing
ensure zero inclusion of node_modules or dist folders. Confirmed the
directory structure is clean and follows the project's organization.
Related Issues
book.
🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.