[DOC-GLOSSARY-001] Add a newcomer terminology glossary
ready
docs · good first issue · P2
GitHub issue snapshot
What’s next.
Tested local work. Clear external gates.
Refreshed 2026-10-07T13:15:29Z. GitHub Issues are authoritative; this page is a saved snapshot.
[DOC-TROUBLE-001] Add a verified simulator troubleshooting lookup
ready
docs · good first issue · P2 · simulator
[HARD-001] Complete six audit corrections and release acceptance
done
help wanted · integration · maintenance · P1
[HARD-GROK-REMOTE-001] Implement authenticated cloud-to-local HTTPS MCP transport
blocked
Remote HTTPS/OAuth transport is unimplemented; separate design and service activation approval required
[HARD-SIM-EXPORT-001] Browser export overwrites the hash-protected simulator default
done
bug · gateway · P1 · website
[HARD-WEB-001] Persist honest activity failure states
done
bug · help wanted · P2 · website
[HARD-WEB-002] Render safe usable source-relative documentation
done
bug · help wanted · P2 · website
[HUB-001] Foundation and architecture
done
feature · P1 · protocol
[HUB-COM-001] Community package and tested dry-run recognition
done
community · feature · P1
[HUB-DEMO-001] Customize and export the browser simulator
done
feature · P1 · website
[HUB-ESP-001] Reusable C124 USB firmware and compilation
done
esp32 · feature · P1
[HUB-GROK-001] Actual existing Grok Bot tool execution
blocked
Exact current native tool receipts require a supported scoped connector update/reload. Existing detail has no such control; reported account-wide restart would affect unrelated connectors. Installation-only computer evidence recorded for grok-launch-20261005-a.
[HUB-GW-001] Protocol, gateway, simulator and MCP acceptance
done
feature · gateway · P1
[HUB-HA-001] Upstream MCP integration and fixtures
done
feature · home-assistant · P1
[HUB-HW-001] Physical LED/button/recovery verification
blocked
C124 hardware unavailable
[HUB-KIT-001] Provide an inspectable configurable Grok simulator kit
done
feature · gateway · P1
[HUB-LIN-001] Reusable Linux SDK and gateway contract
done
feature · linux · P1
[HUB-LIN-002] Real Linux execution
done
feature · linux · P1
[HUB-PUB-001] Publication package and external activation
done
docs · feature · P1
[HUB-PUBLISH-001] Activate approved public repositories/releases/site
blocked
Source publication, website deployment and the five GitHub alpha prereleases are complete. ESP32 is deliberately source-only. Registry uploads and binary firmware distribution are excluded from this release scope. The separate GitHub Project remains an external gate; Project activation was not independently verifiable with the available token during the earlier audit. Native Grok, hardware, systemd and real-home operation remain unverified.
[HUB-REP-001] Independent installation by second tester
blocked
Second tester unavailable
[HUB-SERVICE-001] Verify systemd service lifecycle on real Linux host
blocked
Container is not a systemd target host
[HUB-WEB-001] Source-driven website and local visual verification
done
feature · P1 · website
[HUB-WEB-002] Use approved identity and create selective interactive homepage
done
feature · P1 · website
[HUB-WEB-003] Homepage must list the full SDK and tool collection
done
feature · P1 · website
[LAUNCH-001] L0: prepare contributor-friendly GitHub alpha
done
maintenance · P1 · website
[LAUNCH-CANDIDATE-001] L7: prepare contributor-friendly GitHub alpha
done
maintenance · P1 · website
[LAUNCH-CI-001] L5: prepare contributor-friendly GitHub alpha
done
maintenance · P1 · website
[LAUNCH-DOCS-001] L2: prepare contributor-friendly GitHub alpha
done
maintenance · P1 · website
[LAUNCH-FIRMWARE-DIST-001] Prepare the required third-party redistribution material before firmware binary uploads
blocked
Corresponding-source/relinking redistribution package has not been assembled or cleared; source-only publication package excludes binaries.
[LAUNCH-GROK-001] Obtain actual Grok simulator invocation evidence
blocked
Exact current native tool receipts require a supported scoped connector update/reload. Existing detail has no such control; reported account-wide restart would affect unrelated connectors.
[LAUNCH-ISSUES-001] L4: prepare contributor-friendly GitHub alpha
done
maintenance · P1 · website
[LAUNCH-META-001] L1: prepare contributor-friendly GitHub alpha
done
maintenance · P1 · website
[LAUNCH-PUBLIC-001] L6: prepare contributor-friendly GitHub alpha
done
maintenance · P1 · website
[LAUNCH-VIS-001] L3: prepare contributor-friendly GitHub alpha
done
maintenance · P1 · website
[WEB-COPY-001] Copy documentation commands with accessible feedback
ready
feature · help wanted · P2 · website
AUDIT-HOST-001: Prevent older successful builds from replacing newer production
ready
bug · P2 · website
AUDIT-WEB-001: Make activity freshness accurate between daily builds
ready
bug · P2 · website
AUDIT-DOC-001: Reconcile live publication status and experimental Grok onboarding copy
ready
community · docs · P2 · website
AUDIT-COM-001: Complete reviewed Reddit flairs, rules and contributor recognition rollout
done
community · P2
WEB-DOCS-NAV-001: Organize documentation into nested task-based navigation
done
docs · enhancement · P2 · website
[FUT-KIT-WIN-001] Verify the distributed simulator kit on native Windows
proposed
docs · maintenance · P2 · simulator
HUB-EMAIL-001: Retire the private-email commit check (D1)
done
maintenance · P0
HUB-KIT-002: Build the simulator kit from gateway main and pin it by input hash (H6)
done
maintenance · P0 · simulator
HUB-INT-MAIN-001: Integrate all five main branches on push and nightly
done
integration · maintenance · P0
HUB-READY-001: Link each repository's own contributor queue
done
community · docs · P1
HUB-PROOF-001: Show the MCP Inspector first-success recording on the website
done
P1 · simulator · website
HUB-KIT-003: Advisory kit job fails Hub checks and blocks the deploy
done
bug · maintenance · P0
HUB-PY-001: One hub Python version; fix run-together component text (L5, M10)
done
maintenance · P2
HUB-NAV-001: Move maintainer and process docs out of the public docs nav (M8)
done
docs · P1 · website
HUB-STATUS-001: One status page that every page links to; short hub README (M9)
done
docs · P1 · website
HUB-HERO-001: Homepage says what it does, with a status chip and three paths (M11)
done
P1 · website
HUB-DOCS-001: The site's component docs lag component main
done
docs · P1 · website
HUB-REL-001: Draft v0.1.0-alpha.1 release notes per repository (Q1)
done
maintenance · P2
HUB-RED-001: Prepare the r/GrokGadgets launch package (port the record)
done
community · docs · P1
HUB-ARCHIVE-001: Archive one-off launch tooling
proposed
good first issue · maintenance · P2
HUB-README-002: Clearer hub README; affiliation notice and Reddit invitation on the site
done
community · docs · P2 · website
HUB-REL-002: Record the v0.1.0-alpha.1 release plan
done
maintenance · P2
REL-003: Guard main against non-release PRs; correct the branch docs on main
done
maintenance · P1
STE-001: Keep the README and newcomer pages within ASD-STE100 sentence limits
proposed
docs · P2
HUB-CONTRIB-001: Document the contribution acceptance bar
done
docs · P2
HUB-WEB-005: Keep the desktop Grok Bot mark inside the hero scene
done
bug · P2 · website
[AUDIT-CONTRIB-002] Make fork setup start from upstream/dev in all five repositories
proposed
docs · help wanted · P2
[AUDIT-SEC-002] Enable and verify dependency vulnerability alerts across the five repositories
proposed
maintenance · P2
HUB-WEB-006: Replace the crowded homepage with a clear motion canvas
done
enhancement · P1 · website
HUB-WEB-007: Interactive motion scenes, roadmap and author credit
done
enhancement · P1 · website
HUB-WEB-008: Make motion diagrams explain Grok Bot and hardware
done
enhancement · P1 · website
HUB-WEB-009: Connect grokgadgets.org and publish canonical domain URLs
done
maintenance · P2 · website
[ESP-001] Independent open-source repository foundation
done
esp32 · maintenance · P1
[ESP-002] Portable independently useful ESP32 SDK
done
esp32 · feature · P1 · protocol
[ESP-003] C124 USB firmware and lifecycle
done
esp32 · feature · P1
[ESP-004] Physical C124 acceptance
blocked
esp32 · feature · help wanted · needs hardware · P1
[ESP-005] Secure Wi-Fi transport and provisioning
blocked
esp32 · feature · P2 · protocol
[ESP-006] Independent reproduction
blocked
docs · esp32 · help wanted · P2
[ESP-007] Undeclared history_lost event causes repeated session reset after button queue overflow
done
bug · esp32 · P1 · protocol
[HARD-ESP-001] Preserve ACKs across repeated retries
done
bug · esp32 · help wanted · P1
[LAUNCH-CI-ESP-001] Pin and bound standalone read-only checks
done
esp32 · maintenance · P1
[LAUNCH-DOCS-ESP-001] Prepare an independently buildable C124 SDK guide and public contributor/support policies
done
docs · esp32 · P1
[FUT-ESP-PREFLIGHT-001] Explain registration failures and validate the authenticated hello budget
proposed
esp32 · feature · P2 · protocol
ESP-CI-MAIN-001: Run the README Quickstart and gateway-main USB integration in CI
done
integration · maintenance · P1
ESP-GFI-001: Make the ACK cache size configurable (review L3)
proposed
esp32 · good first issue · P2
ESP-GFI-002: Document adding a second command to the generic LED/button sketch
proposed
docs · good first issue · P2
ESP-ACK-001: late_ack resets the firmware session (M3)
done
bug · esp32 · P1
ESP-README-001: README at 150 words or fewer above the fold (M9)
done
docs · esp32 · P2
ESP-PKG-001: Prepare PlatformIO and Arduino packaging without publishing (M7)
done
esp32 · maintenance · P2
ESP-GFI-003: Arduino IDE layout for the examples
proposed
esp32 · good first issue · P2
ESP-README-002: Clearer README with community link and affiliation notice
done
docs · esp32 · P2
REL-003: Guard main against non-release PRs; correct the branch docs on main
done
maintenance · P1
STE-001: Keep the README and newcomer pages within ASD-STE100 sentence limits
proposed
docs · P2
[GW-001] Contribution-ready local foundation
done
gateway · maintenance · P0
[GW-002] Canonical versioned device protocol and lifecycle
done
feature · P0 · protocol
[GW-003] Usable simulator MCP and authenticated transports
done
feature · gateway · P0
[GW-004] Real Grok Bot and physical C124 acceptance
blocked
Inspectable native Grok invocation evidence and physical C124 observations remain unavailable for this component.
[HARD-GW-001] Route simulator commands by command capability
done
bug · gateway · help wanted · P1
[HARD-GW-002] Isolate bounded event duplicate windows per device and boot
done
bug · help wanted · P2 · protocol
[LAUNCH-CI-GW-001] Pin and bound standalone read-only checks
done
gateway · maintenance · P1
[LAUNCH-DOCS-GW-001] Prepare a newcomer gateway journey and public-alpha component policies
done
docs · gateway · P1
[SIM-GW-001] Configurable installable Grok Gadgets software simulator
done
feature · gateway · P1 · simulator
[FUT-GW-TOKEN-001] Rotate a device credential without changing its identity
done
feature · gateway · P1
[FUT-GW-USB-001] Reopen USB devices by explicitly selected stable identity
proposed
esp32 · feature · gateway · P2
[FUT-GW-RETIRE-001] Reclaim retired device slots while preserving retry evidence
proposed
feature · gateway · P2
GW-FIRST-001: First success with MCP Inspector, checked in CI from a clean checkout
done
documentation · integration · P1
GW-GFI-001: Add --version to grok-gadgets-gateway
proposed
gateway · good first issue · P2
GW-GFI-002: Add a warm-white lamp example to the simulator guide, checked by a test
proposed
docs · good first issue · P2
GW-ACK-WAIT-001: gadgets_command returns before the device acts (M1)
done
bug · gateway · P1
GW-PROTO-DOC-001: Document late_ack and split the protocol README into sections (M3, M9)
done
docs · P1 · protocol
GW-SERVE-001: serve advertises loopback OAuth metadata; SIGTERM skips cleanup (M16, L2)
done
bug · gateway · P1
GW-CLI-001: init config does not work when pasted; CLI is surprising (M4, M5)
done
bug · gateway · P1
GW-DESC-001: Capability descriptions for Grok and larger TCP hellos (M2)
done
feature · P1 · protocol
GW-README-001: README at 150 words or fewer above the fold (M9)
done
docs · P2
PKG-001: Prepare PyPI packaging without publishing (M7)
done
maintenance · P2
GW-README-002: Clearer README with community link and affiliation notice
done
docs · P2
REL-003: Guard main against non-release PRs; correct the branch docs on main
done
maintenance · P1
STE-001: Keep the README and newcomer pages within ASD-STE100 sentence limits
proposed
docs · P2
[HA-001] Establish contribution foundation
done
home-assistant · maintenance · P1
[HA-002] Choose upstream reuse and investigate Grok route
done
home-assistant · P0 · research
[HA-003] Provide read-only compatibility diagnostics
done
feature · home-assistant · P1
[HA-004] Verify actual Grok and selected home entities
blocked
help wanted · home-assistant · needs hardware · P1
[LAUNCH-CI-HA-001] Pin and bound standalone read-only checks
done
home-assistant · maintenance · P1
[LAUNCH-DOCS-HA-001] Prepare an independently reproducible Home Assistant fixture journey and public contribution/support policies
done
docs · home-assistant · P1
[FUT-HA-COMPAT-001] Test discovery against pinned upstream Home Assistant versions
proposed
home-assistant · maintenance · P2
HA-CI-README-001: Check the README Quickstart and its documented output in CI
done
integration · maintenance · P2
HA-GFI-001: Add --version to ha-probe
proposed
good first issue · home-assistant · P2
HA-GFI-002: Add a fixture with no prompts, with a probe test
proposed
good first issue · home-assistant · P2
HA-README-001: README at 150 words or fewer above the fold (M9)
done
docs · home-assistant · P2
PKG-001: Prepare PyPI packaging without publishing (M7)
done
maintenance · P2
HA-README-002: Clearer README with community link and affiliation notice
done
docs · home-assistant · P2
REL-003: Guard main against non-release PRs; correct the branch docs on main
done
maintenance · P1
STE-001: Keep the README and newcomer pages within ASD-STE100 sentence limits
proposed
docs · P2
[HARD-LIN-001] Make documented custom gadget installation work
done
bug · help wanted · linux · P1
[LAUNCH-CI-LIN-001] Pin and bound standalone read-only checks
done
linux · maintenance · P1
[LAUNCH-DOCS-LIN-001] Prepare a standalone custom-device newcomer journey and public-alpha policies
done
docs · linux · P1
[LIN-001] Independent contribution foundation
done
linux · maintenance · P1
[LIN-002] Reusable capability registry and pinned contracts
done
feature · linux · P1 · protocol
[LIN-003] Agent and real gateway transport integration
done
feature · linux · P1
[LIN-004] Linux runtime and physical peripheral evidence
blocked
help wanted · linux · needs hardware · P1
AUDIT-LIN-001: Preserve command deduplication when an ACK exceeds the frame limit
done
bug · linux · P1 · protocol
[FUT-LIN-CANCEL-001] Expose cooperative cancellation and cleanup outcomes for blocking handlers
proposed
feature · linux · P1
[FUT-LIN-SENSOR-001] Add a background sensor example with complete lifecycle handling
proposed
docs · feature · good first issue · help wanted · linux · P2
LIN-CI-MAIN-001: Run gateway integration against gateway main and the README quick start in CI
done
integration · maintenance · P1
LIN-GFI-001: Add --version to grok-linux-agent
proposed
good first issue · linux · P2
LIN-ACK-001: late_ack and slow handlers end the session (M3, L1)
done
bug · linux · P1
LIN-DOC-001: README says hosted CI runs are pending (M10)
done
docs · linux · P2
LIN-DECOR-001: Decorator API with schemas from type hints and capability descriptions (M2, M8)
done
feature · linux · P1
LIN-DEV-001: One install, one command, no copied tokens for a local hello world (M6)
done
feature · linux · P1
PKG-001: Prepare PyPI packaging without publishing (M7)
done
maintenance · P2
LIN-README-002: Clearer README with community link and affiliation notice
done
docs · P2
REL-003: Guard main against non-release PRs; correct the branch docs on main
done
maintenance · P1
STE-001: Keep the README and newcomer pages within ASD-STE100 sentence limits
proposed
docs · P2