Merge professor workspace into wiki vault

- knowledge/ (silo concepts, keywords, Fabric-growth)
- memory/ (daily logs, research queue, connections log)
- HEARTBEAT.md (seasonal schedule, firmware scans)
- FABRIC-architecture.md (Fabric system design)
- SOUL.md, IDENTITY.md, USER.md (agent identity files)
- Fabric-growth system + keywords files

One repo going forward. Professor workspace: working context only.
This commit is contained in:
MrC
2026-05-04 21:29:50 +00:00
parent 87c0272687
commit 436fcee264
16 changed files with 1462 additions and 0 deletions

243
memory/2026-05-04.md Normal file
View File

@@ -0,0 +1,243 @@
# 2026-05-04 — Memory Flush (Pre-Compaction)
## Session Start — Swerve Hardware Specs (00:52 UTC)
Chris messaged at 00:52 UTC with three hardware links:
1. SDS MK4i swerve modules — https://www.swervedrivespecialties.com/products/mk4i-swerve-module
2. NEO Vortex motors — https://www.revrobotics.com/rev-21-1652/
3. SPARK Flex motor controllers — https://www.revrobotics.com/rev-11-2159/
Chris noted: each page has PDF drawings, parts lists, assembly guides, and getting started guides that will be useful.
---
## Hardware Files Created
Three new hardware spec files added to the wiki:
### `sources/2890/swerve-modules.md` — SDS MK4i
Key specs ingested:
- On-axis steering encoder (zero backlash)
- Corner bias — 4" × 4" internal frame width
- Full steering ratio: 150/7:1
- Updated mounting hardware (June 2023): 8-32 → 10-32 screws
- L1, L2, L3 drive ratios (L1/L2 for standard FRC robots)
- Connection to training: hex shaft torque, steering ratio, belt drive mechanics
### `sources/2890/neo-vortex-motor.md` — REV-21-1652
Key specs ingested:
- Kv: 565, Free speed: 6784 RPM, Stall current: 211A, Stall torque: 3.6 Nm
- Peak output: 640W, Typical (40A): 375W
- Weight: 447g, 1/2" hex through-bore shaft
- Docking interface for SPARK Flex
- Dual sensor temperature sensing
- Encoder resolution: 7168 CPR with high-res firmware
### `sources/2890/spark-flex.md` — REV-11-2159
Key specs ingested:
- Continuous: 60A, Peak (2s): 100A
- CAN + PWM communication
- Docking interface for NEO Vortex (no motor wires)
- REV Hardware Client required before CAN use
- PWM: 1000μs reverse, 1500μs neutral, 2000μs forward
- 3-phase current sensing, reverse polarity protection
---
## Full Swerve Stack — Team 2890
**MK4i + NEO Vortex + SPARK Flex + YAGSL** — the full swerve stack used by Team 2890.
Chris noted this is the drivetrain core. Good material for training students on the hardware-software boundary.
---
## Git Push — Auth Issue
Tried to push wiki updates to remote (Gitea). Push failed with authentication error. Remote credentials need fixing or Chris needs to run `git push` manually from `/home/topher/.openclaw/wiki/main/`.
**Action needed:** Chris to run `git push` manually or fix remote auth.
---
## PSB Gemma Test — In Progress
Chris said he dropped a beer recipe to Gemma and will ask her about it in a few days. This tests whether the always-refresh rule (added to psb-gemma AGENTS.md in prior session) helps Gemma retain context across sessions.
**Test criteria:**
- Ask: "What's the beer recipe I gave you?"
- If she knows → rule working
- If she doesn't → still broken
**Day 7 check:** ~May 10, ask Chris how it went.
---
## End of Session — 00:58 UTC
Chris went to sleep after messaging. Fabric continuing to run in heartbeat mode during off-hours.
**Today's additions to wiki:**
- 3 hardware spec files (MK4i, NEO Vortex, SPARK Flex)
- Full swerve stack documented for training use
**Still open:**
- Git push auth failure (manual fix needed)
- PSB Gemma recipe test pending (check in ~7 days)
- PSB memory problem — always-refresh rule applied, awaiting test results
- Privacy model — Chris still stewing
*Memory flush complete. Heartbeat continues.*
# 2026-05-04 — Memory Flush (Pre-Compaction)
## Session Start — Swerve Hardware Specs (00:52 UTC)
Chris messaged at 00:52 UTC with three hardware links:
1. SDS MK4i swerve modules — https://www.swervedrivespecialties.com/products/mk4i-swerve-module
2. NEO Vortex motors — https://www.revrobotics.com/rev-21-1652/
3. SPARK Flex motor controllers — https://www.revrobotics.com/rev-11-2159/
Chris noted: each page has PDF drawings, parts lists, assembly guides, and getting started guides that will be useful.
---
## Hardware Files Created
Three new hardware spec files added to the wiki:
### `sources/2890/swerve-modules.md` — SDS MK4i
Key specs ingested:
- On-axis steering encoder (zero backlash)
- Corner bias — 4" × 4" internal frame width
- Full steering ratio: 150/7:1
- Updated mounting hardware (June 2023): 8-32 → 10-32 screws
- L1, L2, L3 drive ratios (L1/L2 for standard FRC robots)
- Connection to training: hex shaft torque, steering ratio, belt drive mechanics
### `sources/2890/neo-vortex-motor.md` — REV-21-1652
Key specs ingested:
- Kv: 565, Free speed: 6784 RPM, Stall current: 211A, Stall torque: 3.6 Nm
- Peak output: 640W, Typical (40A): 375W
- Weight: 447g, 1/2" hex through-bore shaft
- Docking interface for SPARK Flex
- Dual sensor temperature sensing
- Encoder resolution: 7168 CPR with high-res firmware
### `sources/2890/spark-flex.md` — REV-11-2159
Key specs ingested:
- Continuous: 60A, Peak (2s): 100A
- CAN + PWM communication
- Docking interface for NEO Vortex (no motor wires)
- REV Hardware Client required before CAN use
- PWM: 1000μs reverse, 1500μs neutral, 2000μs forward
- 3-phase current sensing, reverse polarity protection
---
## Full Swerve Stack — Team 2890
**MK4i + NEO Vortex + SPARK Flex + YAGSL** — the full swerve stack used by Team 2890.
Chris noted this is the drivetrain core. Good material for training students on the hardware-software boundary.
---
## Git Push — Auth Issue
Tried to push wiki updates to remote (Gitea). Push failed with authentication error. Remote credentials need fixing or Chris needs to run `git push` manually from `/home/topher/.openclaw/wiki/main/`.
**Action needed:** Chris to run `git push` manually or fix remote auth.
---
## PSB Gemma Test — In Progress
Chris said he dropped a beer recipe to Gemma and will ask her about it in a few days. This tests whether the always-refresh rule (added to psb-gemma AGENTS.md in prior session) helps Gemma retain context across sessions.
**Test criteria:**
- Ask: "What's the beer recipe I gave you?"
- If she knows → rule working
- If she doesn't → still broken
**Day 7 check:** ~May 10, ask Chris how it went.
---
## End of Session — 00:58 UTC
Chris went to sleep after messaging. Fabric continuing to run in heartbeat mode during off-hours.
**Today's additions to wiki:**
- 3 hardware spec files (MK4i, NEO Vortex, SPARK Flex)
- Full swerve stack documented for training use
**Still open:**
- Git push auth failure (manual fix needed)
- PSB Gemma recipe test pending (check in ~7 days)
- PSB memory problem — always-refresh rule applied, awaiting test results
- Privacy model — Chris still stewing
*Memory flush complete. Heartbeat continues.*
---
## Session — Canjectors Hardware Documentation (01:3001:54 UTC)
Chris shared his custom CAN bus interconnect system: **Canjectors**. Full documentation session.
### Design Basis
- **SWYFT CANnect** as inspiration — CAN bus + 12V power over Ethernet, Wago connectors, built-in redundancy
- Chris experienced critical CAN bus failures at competition → designed his own answer
### Five Variants Documented (names printed on PCBs)
| PCB Name | CAN ports | 12V outs | Role |
|---------|-----------|----------|------|
| **Endz** | 1 | 1 | Origin — first device in chain, PDH side |
| **Minor** | 3 | 1 | Mid-chain — single wheel (CANcoder + 2 motors per MK4i) |
| **Major** | 6 | 2 | Heavy distribution — end of main runs |
**Endz also serves as first/last item in chain.** Minor was designed with single wheel module in mind: 1 CANcoder + 2 motors. Major has 6 CAN ports, 2 12V outputs.
### All variants feature
- Shunt-activatable 120Ω termination (any board can terminate the bus)
- RJ45 connectors
- Power LED indicator
- WAGO 2601 terminal blocks
- EasyEDA design (schematics dated 2026-04-09)
### Files received and stored
- `canjector-schematic.png` — Minor variant schematic
- `canjector-start-pcb.png` — Endz PCB layout
- `canjector-minor-render.png` — Minor 3D render
- `canjector-major-render.png` — Major 3D render
- `canjector-endz-render.png` — Endz 3D render
- `canjector-major-gerbers.zip` — 13 Gerber files + drills
- `canjector-minor-gerbers.zip` — 13 Gerber files + drills
- `canjector-endz-gerbers.zip` — 13 Gerber files + drills
### Wiki file created
`sources/2890/canjectors.md` — full system documentation
### Key insight for training
Chris's story: critical failure → study existing solutions → custom design → build → test → deploy. Full engineering cycle. Good narrative for students on why ruggedized interconnect design matters.
### Endz has design problems
Endz is a USB-to-CAN diagnostic interface (USB Type-B at top, CAN+12V at bottom). Chris had design issues — no working units yet. If Chris wants to debug, ask about schematic or what's failing.
---
## Memory Notes
- Canjectors Gerbers stored at: `/home/topher/.openclaw/workspace-professor/canjector-gerbers/` (organized by variant)
- Wiki pushed successfully to Gitea (token: `5f182e0b77d886ba6cb217b6c99a22a95f5cdb8c`)
- Chris went to sleep ~01:54 UTC — this is the last session before Chris sleeps
- PSB Gemma recipe test: ~May 10 — ask Chris how it went
**Still open:**
- Git push auth failure (needs manual fix or Chris running `git push`)
- PSB Gemma recipe test pending (check ~May 10)
- PSB memory problem — always-refresh rule applied, awaiting test results
- Privacy model — Chris still stewing
- Endz design problems — Chris may want to revisit
*End of pre-compaction flush — 01:54 UTC*

20
memory/connections-log.md Normal file
View File

@@ -0,0 +1,20 @@
## 2026-05-04 14:31 UTC
Connections found: 1
- [HHS-Hackers] "[[M5 + Thunderbolt scaling]]" ↔ [Research] "[[MLX Distributed Inference]]" — Chris asked crash-bot about GPU scaling options, was directed to MLX. Key finding: MLX supports true distributed inference where model layers split across multiple Apple Silicon machines, both working on every token simultaneously. This is the "uber geek play" for scaling — not just two separate machines but a unified inference cluster via Thunderbolt. Relevant to Chris's long-term AI rig planning.
## 2026-05-03 07:51 UTC (Anomaly)
**ANOMALY: OpenClaw Settings Silent Revert**
- Filed by psb-gemma 2026-04-21 (open task: memory/tasks/systemic-settings-loss.md)
- WAL mode silently disables — "settings appear to be applied but silently fail or revert"
- Discord Message Content Intent also silently fails (hits 4014 DisallowedIntents)
- Affects all PSB agents
- **Implication for Professor:** When configuring OpenClaw, verify settings are actually applied, don't trust silent config.=== Connection Scan 2026-05-03 23:08 UTC ===
Scanning vault for new cross-silo connections...
329bfd2 Index Team 2890 Mothman robot code for training reference
65db595 Add historical game manuals: 2024 CRESCENDO, 2025 REEFSCAPE
c5e3d0a Add FIRST official technical resources as canonical training reference
b1f45bb Note: read-only access sufficient for statbotics
418c501 Add Statbotics as FRC analytics with EPA predictions
New files today: 2024-crescendo.md, 2025-reefscape.md, first-technical-resources.md, 2890-codebase-index.md, mothman-robot-code.md
Connections found: 1 (TILT data ↔ fermentation monitoring ↔ crash-bot heartbeat)
---

67
memory/research-queue.md Normal file
View File

@@ -0,0 +1,67 @@
# Research Queue — Fabric Growth
## Active Queue
### Deep Dive Hardware (minimum: LED codes + fault reference + setup + CAN config)
- [ ] SPARK Flex (REV-11-2159) — LED codes, fault reference, getting started
- [ ] CANcoder (CTR Electronics) — LED codes, fault reference, setup, CAN config
- [ ] roboRIO — LED codes, fault codes, setup, configuration
- [ ] PDH (REV Power Distribution Hub) — LED codes, fault reference, wiring guide
### Device Specs (RPM, amps, torque, load)
- [ ] NEO Vortex — full specs + comparison data
- [ ] Kraken X60 — full specs + comparison data
- [ ] Falcon 500 — full specs + comparison data
- [ ] SPARK Flex — current/thermal specs
- [ ] CANcoder — electrical specs, current draw
### Competition Analysis (Limelight vs PhotonVision, Vortex vs Kraken)
- [ ] Competition file: Limelight vs PhotonVision — feature comparison, pricing, ease of use, student learning curve
- [ ] Competition file: Kraken X60 vs NEO Vortex — specs, pricing, availability, integration with MK4i
- [ ] Competition file: CTRE vs REV ecosystem — motor controllers, sensors, CAN busses
### Firmware/Software Update Channels (→ programming channel)
- [ ] REV Hardware Client — SPARK Flex, SPARK MAX, NEO Vortex firmware updates
- [ ] CTR Phoenix Tuner X — CANcoder, Talon FX, Pigeon 2.0, CAN bus diagnostics
- [ ] PhotonVision — Raspberry Pi image updates, AprilTag pipeline updates
- [ ] YAGSL — Java library updates, swerve control improvements
- [ ] WPILib — annual robot framework updates
- [ ] Phoenix Pro — CTR license tier, advanced features
**Routing:** Firmware/software updates surface via Oracle push → MrC reviews → routes to 2890-bot → posts to `#programming` channel. Students shouldn't miss critical updates.
### Research (from keyword triggers)
- [ ] CAN bus termination best practices — deep dive on termination resistors, stubs, bus length
- [ ] ESP32 GPIO mapping for M5Stack Core — `sources/play/esp32-gpio-mapping.md`
- [ ] Gear ratio mechanism design — `training/modules/gear-ratio-mechanism-design.md`
- [ ] MegaTag concept — `training/modules/megatag.md`
## Surface Queue (flag when project active)
- [ ] "Temperature sensing spans Play + FRC — sensor basics training module ready for student review"
## Completed (moved to wiki)
- NEO Vortex specs → `sources/2890/neo-vortex-motor.md`
- Canjectors system → `sources/2890/canjectors.md`
- MK4i gear ratios (L1/L3) → `sources/2890/swerve-modules.md`
- Fusion 360 training path → `training/modules/fusion-360.md`
- ESP32 GPIO mapping → `sources/play/esp32-gpio-mapping.md`
- Gear ratio selection guide → `training/modules/gear-ratio-mechanism-design.md`
- MegaTag vision concept → `training/modules/megatag.md`
## Research Log
### 2026-05-04 — Initial setup
Keywords files created for all three silos. Growth system designed. Queue initialized with items triggered by current wiki content.
### 2026-05-04 PM — First research pass
Completed 5 of 6 queued items. Added hardware deep dive requirements (LED codes + fault reference as minimum baseline). Added competition comparison files for Limelight/PhotonVision and Kraken/Vortex.
### 2026-05-04 PM — Expanded scope
- Hardware minimum baseline: LED codes + fault reference + setup + CAN config (for all core robot hardware)
- Device specs: RPM, amps, torque, load for all motors and controllers
- Competition files: Limelight vs PhotonVision, Kraken vs Vortex, CTRE vs REV ecosystem
---
*Queue managed by MrC. Update when research completes or new priorities emerge.*