de3f3b9204
feat( #156 ): Create coordinator bot user documentation and setup scripts
...
Add comprehensive documentation and automated scripts for setting up the mosaic
coordinator bot user in Gitea. This enables the coordinator system to manage
issue assignments, comments, and orchestration.
Changes:
- docs/1-getting-started/3-configuration/4-gitea-coordinator.md: Complete setup guide
* Step-by-step bot user creation via UI and API
* Repository permission configuration
* API token generation and storage
* Comprehensive testing procedures
* Security best practices and troubleshooting
- scripts/coordinator/create-gitea-bot.sh: Automated bot creation script
* Creates mosaic bot user with proper configuration
* Sets up repository permissions
* Generates API token
* Tests authentication
* Provides credential output for secure storage
- scripts/coordinator/test-gitea-bot.sh: Bot functionality test suite
* Tests authentication
* Verifies repository access
* Tests issue operations (read, list, assign, comment)
* Validates label management
* Confirms all required permissions
- scripts/coordinator/README.md: Scripts usage documentation
* Workflow guides
* Configuration reference
* Troubleshooting section
* Token rotation procedures
- .env.example: Added Gitea coordinator configuration template
* GITEA_URL, GITEA_BOT_USERNAME, GITEA_BOT_TOKEN
* GITEA_BOT_PASSWORD, GITEA_REPO_OWNER, GITEA_REPO_NAME
* Security notes for credential storage
All acceptance criteria met:
✓ Documentation for bot user creation
✓ Automated setup script
✓ Testing procedures and scripts
✓ Configuration templates
✓ Security best practices
✓ Troubleshooting guide
Addresses Milestone: M4.1-Coordinator
Relates to: #140 , #157 , #158
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 17:32:03 -06:00
38f22f0b4e
fix(scripts): Improve base URL configuration display clarity
...
ci/woodpecker/push/woodpecker Pipeline was successful
When detecting existing configuration, the setup script now shows a
detailed breakdown instead of just "Current base URL: ...":
Mode: Traefik reverse proxy
Web URL: https://app.mosaicstack.dev
API URL: https://api.mosaicstack.dev
Auth: https://auth.mosaicstack.dev
This makes it clear:
- What access mode is configured (localhost/IP/domain/Traefik)
- What each URL is used for (Web UI, API, Authentication)
- Whether to change the configuration
Added helper functions:
- detect_access_mode(): Determines mode from existing .env values
- display_access_config(): Formats the URL breakdown display
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-01 00:57:23 -06:00
98f80eaf51
fix(scripts): Fix awk env parsing for POSIX compatibility
...
ci/woodpecker/push/woodpecker Pipeline failed
- Use index() instead of regex capture groups for key extraction
- More portable across different awk implementations
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-01 00:24:31 -06:00
e63c19d158
chore: Cleanup QA reports and improve setup scripts
...
ci/woodpecker/push/woodpecker Pipeline was successful
Scripts:
- common.sh: Fix select_option to use /dev/tty for interactive prompts
- common.sh: Improve check_docker with detailed error messages
- setup.sh: Add Traefik configuration options
- setup.sh: Add argument validation for --mode, --external-authentik, etc.
- setup.sh: Add fun taglines
QA Reports:
- Remove stale remediation reports
- Keep current pending reports
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-31 22:53:47 -06:00
fd93be6032
feat: Add comprehensive setup wizard foundation
...
Modeled after Calibr setup.sh pattern (~/src/calibr/scripts/setup.sh).
Implemented (Foundation):
- Platform detection (Ubuntu, Arch, macOS, Fedora)
- Dependency checking and installation
- Mode selection (Docker vs Native)
- Interactive + non-interactive modes
- Comprehensive logging (clean console + full trace to log file)
- Common utility functions library (450+ lines)
Features in common.sh:
- Output formatting (colors, headers, success/error/warning)
- User input (confirm, select_option)
- Platform detection
- Dependency checking (Docker, Node, pnpm, PostgreSQL)
- Package installation (apt, pacman, dnf, brew)
- Validation (URL, email, port, domain)
- Secret generation (cryptographically secure)
- .env file parsing and management
- Port conflict detection
- File backup with timestamps
To Be Implemented (See scripts/README.md):
- Complete configuration collection
- .env generation with smart preservation
- Port conflict detection
- Password/secret generation
- Authentik blueprint auto-configuration
- Docker deployment execution
- Post-install instructions
Usage:
./scripts/setup.sh # Interactive
./scripts/setup.sh --help # Show options
./scripts/setup.sh --dry-run # Preview
./scripts/setup.sh --non-interactive # CI/CD
Refs: Setup wizard issue (created)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-31 16:45:56 -06:00
Jason Woltje
973502f26e
feat(#37-41): Add domains, ideas, relationships, agents, widgets schema
...
Schema additions for issues #37-41:
New models:
- Domain (#37 ): Life domains (work, marriage, homelab, etc.)
- Idea (#38 ): Brain dumps with pgvector embeddings
- Relationship (#39 ): Generic entity linking (blocks, depends_on)
- Agent (#40 ): ClawdBot agent tracking with metrics
- AgentSession (#40 ): Conversation session tracking
- WidgetDefinition (#41 ): HUD widget registry
- UserLayout (#41 ): Per-user dashboard configuration
Updated models:
- Task, Event, Project: Added domainId foreign key
- User, Workspace: Added new relations
New enums:
- IdeaStatus: CAPTURED, PROCESSING, ACTIONABLE, ARCHIVED, DISCARDED
- RelationshipType: BLOCKS, BLOCKED_BY, DEPENDS_ON, etc.
- AgentStatus: IDLE, WORKING, WAITING, ERROR, TERMINATED
- EntityType: Added IDEA, DOMAIN
Migration: 20260129182803_add_domains_ideas_agents_widgets
2026-01-29 12:29:21 -06:00
