docs: reassessment — README, ROADMAP, AGENTS, cockpit spec, implementation plan#12
Merged
Conversation
… implementation plan README - Rewrite to reflect v1.6.1 state: 6 Workbench plugins, grid-messenger, internal LAN proxy (Caddy + Pi-hole), node registry at ~/.config/faigrid - Add ecosystem table with faisignal integration note - Add Workbench Plugins and Grid Messenger sections with current feature detail - Add repository layout tree and troubleshooting table ROADMAP - Replace outdated versioning (v1.3.0 bridge) with accurate current baseline - Add Phase 1 (Signal Readiness v1.7-v1.9): /api/v1/health, structured event log, grid-doctor --json, faisignal integration guide - Add Phase 2 (Operator Cockpit v2.0): faigate-inspired dashboard spec - Add Phase 3 (Execution Classes & GitOps) and Phase 4 (fusionAIzeOS) - Align with faisignal ROADMAP integration points (runtime health signals, event stream, cross-layer correlation) AGENTS.md - Update node list with current services (openclaw, codenomad, faigate, grid-messenger, Restic, Pi-hole) - Add faisignal integration note and registry path correction - Add cockpit scope clarification (lightweight, no-build, stays in-scope) docs/IMPLEMENTATION-PLAN.md (new) - Gap analysis from v1.6.1 baseline - v1.7-v1.9 release line: health API, structured events, Signal integration - v2.0 cockpit: full technical spec (file layout, HTTP API, system service) docs/COCKPIT.md (new) - Full design spec for Grid operator cockpit - faigate design language inheritance + Grid-specific differentiation (green) - 7-section IA: Overview / Nodes / Services / Messenger / Workbench / Signals / Setup - Color tokens, layout spec, navigation rail, scope boundary Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…inux systemd macOS path: - Detects Homebrew-managed faigrid-messenger bin (brew services start faigrid) - Falls back to standalone venv + LaunchAgent plist if brew not available - Config at ~/.config/grid-messenger/config.env (600) - Logs at ~/.local/share/grid-messenger/grid-messenger.log Linux path (unchanged behavior): - apt-get / dnf package manager detection - systemd service + /etc/grid-messenger/ config pattern - system user isolation (grid-messenger:grid-messenger) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…private repos) Will be re-evaluated when repos move to self-hosted Forgejo. CodeQL scans showed no findings — removal is safe. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…pattern) - Add ci.yml with jobs: shellcheck, python-lint, version-check, bats (matrix ubuntu/macos), forbid-artifacts, gate - gate job (name: CI Gate) aggregates all required checks — matches branch protection required_status_checks context - Remove lint.yml and test.yml (jobs consolidated into ci.yml) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Post-v1.6.1 documentation reassessment. Brings all docs to current implementation state and adds forward-looking specs aligned with the faisignal roadmap.
Changes:
Test plan
🤖 Generated with Claude Code