Skip to content

chore: clean up root directory — move 120+ files into organized subdirectories#199

Open
blackboxprogramming wants to merge 555 commits into
mainfrom
claude/cleanup-codebase-Vj9Ab
Open

chore: clean up root directory — move 120+ files into organized subdirectories#199
blackboxprogramming wants to merge 555 commits into
mainfrom
claude/cleanup-codebase-Vj9Ab

Conversation

@blackboxprogramming

Copy link
Copy Markdown
Contributor

Move 52 markdown docs into docs/ with categorized subdirectories:
docs/agents/, docs/architecture/, docs/cli/, docs/deployment/,
docs/security/, docs/guides/, docs/hardware/, docs/features/,
docs/planning/, docs/products/, docs/brand/

Move 63 shell scripts into scripts/ with categories:
scripts/agents/, scripts/chat/, scripts/monitoring/, scripts/system/,
scripts/visual/, scripts/network/, scripts/collaboration/, scripts/launchers/

Move 5 HTML/CSS files into websites/ and websites/brand/
Move 5 Python files into python/
Move misc files (json, txt, modelfile) into appropriate docs subdirs
Delete orphan zero-byte file with non-ASCII name
Fix pre-existing test expecting 8 CLI commands (now 9 with bottlenecks)

Root now contains only essential project files:
README.md, CLAUDE.md, LICENSE, package.json, tsconfig.json,
vitest.config.ts, Dockerfile, br, and dotfiles

https://claude.ai/code/session_01XWKAkcYpzWE4MFecRLLsm2

claude and others added 30 commits February 28, 2026 07:22
…ts, motion

Self-contained HTML reference covering the full BlackRoad visual language:
9 sections (wordmark, palette, typography, text rules, gradients,
components, spacing, motion primitives, do/don't rules), 7 accent colors,
2 typefaces, 17 CSS-only motion primitives, responsive layout.

https://claude.ai/code/session_014qqaH98cQoLtjSEijtkYQt
Canonical brand reference for all BlackRoad OS orgs and projects.

Includes:
- BRAND_STYLE_GUIDE.html: Full interactive style guide with live demos
  (wordmark, 7 accent colors, typography, text rules, gradient system,
  components, spacing scale, 17 motion primitives, do/don't rules)
- brand-style-guide.css: Standalone importable stylesheet with all
  design tokens, component classes, keyframe animations, and
  utility classes for use across any project

Design System specs:
- Colors: #FF8400, #FF4400, #FF0066, #CC00AA, #8800FF, #0066FF, #2233CC
- Fonts: Space Grotesk (display), JetBrains Mono (UI/body/code)
- Text: #fff or #000 only — opacity for dimming, never gray hex
- Corners: 0–4px max — no pills
- 17 motion primitives with animation utility classes

https://claude.ai/code/session_01WKWyaYwoXKk9E23WzoJ26H
…cks, multi-row, card, minimal)

Adds a showcase page with 5 loading bar components using the BlackRoad brand
design tokens (JetBrains Mono, gradient rule, black/white palette). Includes
a reusable CSS component file at _shared/loading-bars.css for cross-project use.

https://claude.ai/code/session_017owBt8nS33YvPcCxFPX3Yx
Self-contained HTML page in visual/ featuring pulse, spin, morph, bounce, orbit,
wave, ripple, glitch, pendulum, helix, and more — all pure CSS keyframe animations
on a dark background grid layout for the BlackRoad OS design system.

https://claude.ai/code/session_01ARHfHg4mawmpdYjFspgsjQ
…ests)

Cover every local endpoint across the entire BlackRoad infrastructure:
- Gateway (8787): healthz, metrics, v1/agents, v1/worlds, v1/agent
- Auth Worker (BRAT v1): token, verify, me, revoke, status
- Copilot-CLI Worker: health, status, inbox, task, mesh
- Email Worker: registry, inbox, inbox/:agent, agents
- Email Setup Worker: setup, status, mx/switch, mx/restore
- BlackRoad OS API: dashboard, agents, railway, github
- Email Router: health, inbox/:agent, agents
- MCP Bridge (8420): exec, file/read, file/write, memory/*
- Dashboard API (Next.js): health, ready, version, gateway proxy
- Payment Gateway (3002): Stripe checkout, portal, webhook, pricing
- Simple Launch Webhook (5000): /webhook/stripe
- Metrics Webhook (4242): /webhook
- Deploy Orchestrator (8080): /webhook
- Python Webhook (9000): /webhook

Also validates agent policy, wrangler configs, Railway config,
port allocation (no conflicts), brand compliance, and CORS headers.

https://claude.ai/code/session_01TXC6wLYBnnQWexPWVmDhDY
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Replace simulated RANDOM-based metrics with real system data collection.
Adds `br bottlenecks` CLI command and `bottlenecks.sh` shell dashboard
that read actual CPU, memory, disk, swap, network, and process metrics
from /proc and os module, probe live service endpoints (Gateway, Ollama,
GitHub API), and detect bottlenecks with severity-based health scoring.

New files:
- src/core/live-data.ts — live system metrics collector and service prober
- src/core/bottlenecks.ts — bottleneck detection engine with thresholds
- src/cli/commands/bottlenecks.ts — `br bottlenecks` command (--json, --watch)
- bottlenecks.sh — standalone shell dashboard with live data

https://claude.ai/code/session_01CXfh2mcLiULV31k2ZpfjLf
…find, minimap

Single-file code editor (editor.html) with:
- Multi-tab interface with file switching (agent-core.js, memory.py, README.md)
- Line-numbered gutter with current line highlight
- Find bar with match navigation (Ctrl/Cmd+F)
- Command palette with fuzzy search (Ctrl/Cmd+K)
- Decorative minimap showing code density
- Status bar with cursor position, word/line count, language
- Save flash notification (Ctrl/Cmd+S)
- Tab-to-spaces, keyboard shortcuts, scroll sync
- BlackRoad brand gradient accents, JetBrains Mono font

https://claude.ai/code/session_018xG6vVpYdPyXxyowEVvkk1
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
blackboxprogramming and others added 20 commits March 8, 2026 23:24
…on-dict-RA8gu

feat: add Animation Dictionary — 17 CSS motion primitives
…s-paths-7onZi

test: E2E tokenless path compliance scan across 15 open PRs
…on-html-BTOdp

feat: Add branded GitHub Pages template and product plans for all 20 products
…ntation-DSe5h

docs: rewrite CLAUDE.md to reflect actual blackroad-operator codebase
…-and-merge

[WIP] Ensure all tests are passing for end-to-end functionality
…all-docs-HBzLg

docs: add mobile skill installation guide
…emplate-ktsvK

feat: add blog post template with modular component system
…ed-design-template

[WIP] Add approved design template for blog
…e-CdUt2

feat: Add BlackRoad Enterprise Web Kernel — blackroad-web-core
…blackroad-sf/eslint-10.0.1

deps(sf): Bump eslint from 9.39.3 to 10.0.1 in /blackroad-sf
…blackroad-sf/eslint-plugin-jest-29.15.0

deps(sf): Bump eslint-plugin-jest from 28.14.0 to 29.15.0 in /blackroad-sf
…ora-9.3.0

deps: Bump ora from 8.2.0 to 9.3.0
…ommander-14.0.3

deps: Bump commander from 13.1.0 to 14.0.3
- 14 test files covering client, logger, spinner, formatters, bootstrap, CLI
- Added vitest.config.ts and prettierignore
- CI now includes lint step

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

RoadChain-SHA2048: 7aaa4ac17b3eb1c9
RoadChain-Identity: alexa@sovereign
RoadChain-Full: 7aaa4ac17b3eb1c9609492295ed8931210713e1bfe59811ae28ce954c733d06162942fe2096afb694361d1c3d2bcf06b43f5f25f4b47e6433024ed375c685c47450d0ab3840a2c0dfd0bcc5d4de6626944863032058b341c675b7ddcfedcd5223996622b571bea5d88aa104fbbb1c6f62e3cf37aa95874b15de005704828a23222a532643c90ddffd61baaf7c4e557ad5b373637c7e380552a6978abfe899ead4fe7066094b98ac88e1c273f038a99b9ecafdb577f56d9c5c5428be664cab084958b42aa791687f6fd4730479a071104d04ad5335342f26505f2b77c455483d2f057cb8ffbc745ab987f8cf63157c525dd3158cff0eae4d1ca7fe877280269ab
…rectories

Move 52 markdown docs into docs/ with categorized subdirectories:
  docs/agents/, docs/architecture/, docs/cli/, docs/deployment/,
  docs/security/, docs/guides/, docs/hardware/, docs/features/,
  docs/planning/, docs/products/, docs/brand/

Move 63 shell scripts into scripts/ with categories:
  scripts/agents/, scripts/chat/, scripts/monitoring/, scripts/system/,
  scripts/visual/, scripts/network/, scripts/collaboration/, scripts/launchers/

Move 5 HTML/CSS files into websites/ and websites/brand/
Move 5 Python files into python/
Move misc files (json, txt, modelfile) into appropriate docs subdirs
Delete orphan zero-byte file with non-ASCII name
Fix pre-existing test expecting 8 CLI commands (now 9 with bottlenecks)

Root now contains only essential project files:
  README.md, CLAUDE.md, LICENSE, package.json, tsconfig.json,
  vitest.config.ts, Dockerfile, br, and dotfiles

https://claude.ai/code/session_01XWKAkcYpzWE4MFecRLLsm2
Copilot AI review requested due to automatic review settings March 10, 2026 12:05

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR reorganizes the root directory by moving 120+ files into categorized subdirectories. The goal is to leave only essential project files (README.md, CLAUDE.md, LICENSE, package.json, etc.) in the root, with all other files sorted into docs/, scripts/, python/, and websites/ directories. The test file is updated to reflect the addition of the bottlenecks command (8→9 commands).

Changes:

  • Move 52 markdown docs into docs/ with categorized subdirectories (agents, architecture, cli, deployment, security, etc.)
  • Move 63 shell scripts into scripts/ with categories (agents, chat, monitoring, system, visual, network, collaboration, launchers)
  • Update test assertion from 8 to 9 commands to account for the bottlenecks command

Reviewed changes

Copilot reviewed 1 out of 132 changed files in this pull request and generated no comments.

Show a summary per file
File Description
test/cli/program.test.ts Updates command count expectation from 8 to 9 (bottlenecks command)
scripts/visual/*.sh Moved visual/animation scripts (saver, pulse, mood, matrix, clock)
scripts/system/*.sh Moved system utility scripts (tasks, queue, mem, help, find, config, all, alert)
scripts/network/*.sh Moved network scripts (wire, traffic, net, blackroad-mesh)
scripts/monitoring/*.sh Moved monitoring scripts (timeline, status, spark, report, monitor, mission, logs, health, god, events, dash)
scripts/launchers/*.sh Moved launcher scripts (menu, intro, demo, boot)
scripts/collaboration/*.sh Moved collaboration scripts (join-collaboration, collab-task-router, collab-status)
scripts/chat/*.sh Moved chat scripts (whisper, thoughts, think, story, roundtable, focus, debate, council, convo, chat, broadcast)
scripts/agents/*.sh Moved agent scripts (wake, soul, roster, office, install-cece, inspect, handoff, bonds, agent, .cece-init)
python/chess_game.py Moved Python chess game
docs/**/*.md Moved documentation files (SECURITY, MOBILE_SKILL_INSTALL, URGENT-TASKS, ROADMAP, BR_FEATURES, BR_CLI, CHANGELOG, BLACKROAD_IP_NOTICE)
docs/agents/.json, docs/agents/.txt Moved agent profile/prompt files
docs/brand/brand.json Moved brand config
docs/index.*.txt Moved index files

You can also share your feedback on Copilot code review. Take the survey.

claude added 5 commits March 10, 2026 12:13
Directory consolidation:
- Remove empty dirs: blackroad-agents/, blackroad-operator/, cece-logs/
- Remove 53 duplicate scripts from cli-scripts/ (identical to scripts/)
- Move dashboards/ (128 files) -> tools/dashboards/
- Move features/ (security scripts) -> tools/security-features/
- Move ollama-wrapper/ -> blackroad-core/ollama-wrapper/
- Move production/ -> blackroad-infra/production/
- Move migration/ -> blackroad-infra/migration/
- Move scrapers/ -> tools/scrapers/
- Move indexer/ -> tools/indexer/
- Move extensions/ -> integrations/extensions/
- Move control-map/ -> coordination/control-map/
- Move repos/blackroad-redirect/ -> websites/blackroad-redirect/
- Move github-pages-template/ -> templates/github-pages/
- Consolidate schema/, state/, deployments/, devices/ -> config/
- Merge codex-memory/ into .codex/
- Move visual/ contents to python/ and websites/
- Move prompts/Octavia.Modelfile -> blackroad-core/

Test fixes:
- Fix flaky config test by resetting persisted config in beforeEach
- All 294 tests now pass reliably

Documentation:
- Update CLAUDE.md with new directory structure, 9 CLI commands, full test tree
- Rewrite README.md with accurate project overview and structure

Root directories reduced from ~55 to 33 meaningful ones.

https://claude.ai/code/session_01XWKAkcYpzWE4MFecRLLsm2
Replace removed cli-scripts/ with config/ and integrations/ in the
repository structure diagram.

https://claude.ai/code/session_01XWKAkcYpzWE4MFecRLLsm2
Single source of truth for all service identifiers, domains,
infrastructure references — zero secrets. Covers Cloudflare (all
subdomains), Stripe (products + webhooks), Clerk (orgs + SSO),
Railway (9 projects), Vercel, DigitalOcean, SendGrid, Mercury,
Notion, Linear, Jira, Slack, AI providers, and internal infra.

All actual API keys stay in .env files only.

https://claude.ai/code/session_01XWKAkcYpzWE4MFecRLLsm2
Self-contained single HTML file with canvas animations, live gateway
polling, agent task rotation, pixel robot mascot, and 16 portal cards
linking to all blackroad.io subdomains.

https://claude.ai/code/session_01XWKAkcYpzWE4MFecRLLsm2
- Landing page (index.html): live dynamic stat counters that poll
  gateway and drift, portal link in nav, site-nav footer bar
- Directory page: full rebuild with brand colors, gradient hero,
  infra cards, live status dots, org/domain listings with hover states
- All 7 website pages now have cross-navigation linking to each other
  (portal, platform, agents, AI, pricing, road TV, directory)

https://claude.ai/code/session_01XWKAkcYpzWE4MFecRLLsm2
@blackboxprogramming

Copy link
Copy Markdown
Contributor Author

@copilot

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants