Skip to content

feat: implement automatic .agent/ to docs sync via CI#8

Open
hinetapora wants to merge 204 commits into
mainfrom
feature/agent-sync-fix
Open

feat: implement automatic .agent/ to docs sync via CI#8
hinetapora wants to merge 204 commits into
mainfrom
feature/agent-sync-fix

Conversation

@hinetapora
Copy link
Copy Markdown
Owner

Implements permanent solution for lint-staged + sync:docs collision:

Changes:

  • Remove sync:docs from pre-commit (fixes collision)
  • Update lint-staged to format .agent/ source files only
  • Exclude generated docs/ from formatting (read-only artifacts)
  • Add GitHub Actions workflow for automatic .agent/ → apps/site/docs/ sync
  • .agent/ directory now committed (source of truth for docs)

Benefits:

  • No more empty commit blocks
  • Fully automatic doc sync via CI
  • Clean pre-commit workflow
  • Single source of truth (.agent/)

Workflow:

  1. Edit .agent/ files → pre-commit formats
  2. git commit/push → CI syncs to apps/site/docs/
  3. Auto-commit formatted docs to main

Resolves the destructive pre-commit sequencing issue permanently.

base-buzz and others added 30 commits October 25, 2025 16:16
BREAKING CHANGE: Project renamed to use scoped NPM package
- Package name: grok-cli-hurry-mode → @xagent/x-cli
- Binary command: grok → xcli
- Updated all documentation and references
- Maintained .grok directory for configuration compatibility
- Preserved Grok model names and API settings

Installation: npm install -g @xagent/x-cli
Usage: xcli --help

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update package.json repository and bugs URLs
- Update README.md GitHub links
- Migrate from hinetapora/x-cli-hurry-mode to x-cli-team/x-cli
- Maintain all commit history and tags

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update README header to reflect migration completion
- Test GitHub Actions with new repository secrets
- Verify PAT_TOKEN and NPM_TOKEN are working correctly

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add comprehensive logo asset suite with multiple sizes
- Create Chrome-inspired circular design with Google colors
- Update README.md to display new logo (120px width)
- Add logo variant for banner component
- Include logo assets in NPM package distribution
- Create GitHub social preview banner (1200x630)
- Add favicon for web applications (32x32)
- Document logo usage guidelines and brand standards

Assets included:
- Standard logo (100x100)
- Small logo (32x32)
- Large logo (200x200)
- Favicon (32x32)
- GitHub social preview (1200x630)
- Comprehensive documentation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Replace Chrome-inspired circular design with actual X logo
- Update all logo variants: standard, small, large, favicon, social preview
- Maintain consistent black fill design across all assets
- Keep proper scaling and positioning for each use case

Assets updated:
- x-cli-logo.svg (100x100)
- x-cli-logo-small.svg (32x32)
- x-cli-logo-large.svg (200x200)
- favicon.svg (32x32)
- github-social-preview.svg (1200x630)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update version to 1.1.38 reflecting current NPM package
- Add prominent NPM publication announcement with direct link
- Fix GitHub badge URLs to point to correct x-cli-team organization
- Add installation call-to-action in credits section
- Highlight successful automated publishing pipeline

✅ Package now live: npm install -g @xagent/x-cli

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update .grok/project-manifest.json with new project name and CLI command
- Fix CHANGELOG.md GitHub releases link to point to x-cli-team/x-cli
- Rename grok-smart.sh to x-cli-smart.sh with updated package reference
- Update GitHub Actions release.yml with correct package names and URLs
- Fix GitHub Packages scoping to use @x-cli-team organization
- Update all remaining configuration references

Rebrand cleanup complete - all references now point to @xagent/x-cli

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update install.sh to use @xagent/x-cli package name
- Remove all 'hurry-mode' references from installer
- Update Docusaurus config with new title and URLs
- Fix Husky pre-commit hook package reference
- Update project manifest root path reference

Key changes:
- install.sh: @xagent/x-cli@latest installation
- docusaurus.config.ts: X CLI branding and x-cli-team organization
- .husky/pre-commit: Updated package name reference
- Installer now handles both old and new package cleanup

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update Docusaurus config with new branding and logo
- Fix GitHub workflows to use x-cli-team/x-cli repository
- Update testimonial system for new repository URLs
- Clean up remaining grok-cli references in documentation
- Ensure consistent X CLI branding across entire project

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Updated landing page (index.tsx) with X CLI branding and new URLs
- Fixed testimonials.yml header and sample data with proper YAML format
- Updated source code references in use-input-handler.ts
- Fixed claude.md and homebrew-formula.rb with X CLI details
- Regenerated built files to remove old references

Remaining references are in .agent historical docs and .archive files

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Fixed TypeScript interface for x-cli project type
- Removed unused fs/promises import
- All grok-cli references updated to X CLI across project
- Ready for final push

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update settings manager to support both X_API_KEY and GROK_API_KEY for backwards compatibility
- Change default environment variable reference to X_API_KEY
- Update install.sh script to show X_API_KEY in setup instructions
- Add support for both .x/ and .grok/ configuration directories
- Update CLI help text and error messages to reference X_API_KEY
- Bulk update all documentation to use X_API_KEY
- Maintain backwards compatibility for existing users

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
hinetapora and others added 28 commits November 2, 2025 08:04
Smart-push script improvements:
- Update to use bun run instead of npm run for development commands
- Add NPM package verification after successful push to main branch
- Include package URL and version confirmation

GitHub Actions workflow improvements:
- Add comprehensive NPM publication verification step
- Retry logic for NPM registry propagation delays
- Version matching confirmation
- Direct package URL reporting

Both scripts now have proper verification stages to confirm
successful package publication after deployment.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Enhanced user experience for smart-push script:

Visual Improvements:
- Add animated spinner during NPM registry checks
- Show progress during GitHub Actions monitoring
- Enhanced terminal feedback with real-time status updates
- Comprehensive summary at completion

NPM Verification Enhancements:
- 6 retry attempts with 10-second intervals
- Animated spinners during wait periods
- Success feedback with package URL and install command
- Clear messaging for propagation delays

GitHub Actions Monitoring:
- Spinner during workflow start wait
- Real-time display of running/completed workflows
- Better error reporting and manual check instructions
- Repository-specific action links

User Experience:
- Clear step-by-step progress indication
- Final summary with all verification results
- Helpful guidance for manual verification when needed
- Professional CLI tool feedback style

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Auto-generated sync from .agent/ docs including:
- Comprehensive Claude Code feature analysis (667 lines)
- Master Plan v1 for vibe coding performance improvements
- Enhanced development workflow documentation
- Updated architecture analysis with Bun migration details
- Improved automation and troubleshooting guides

Major strategic additions:
- Deep analysis of Claude Code's competitive advantages
- Prioritized roadmap for X-CLI feature parity
- 20 strategic initiatives across 5 priority levels
- Success metrics and implementation guidance

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Additional doc sync updates from the comprehensive strategic analysis including:
- Enhanced development workflow with Bun migration details
- Updated automation guides with new verification steps
- Improved roadmap with strategic initiatives
- Architecture documentation with performance optimizations

All strategic documentation is now synced to public docs.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Final sync of comprehensive strategic documentation to ensure all updates
are properly reflected in the public documentation site.

Strategic content now fully synchronized across internal and public docs.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Expand README.md with comprehensive strategic framework
- Add detailed competitive positioning matrix and success metrics
- Integrate master plan alignment and progress tracking
- Establish operational excellence framework for sprint planning
- Define quantitative targets and qualitative goals for market leadership

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update architecture overview and installation guides
- Sync development workflow and troubleshooting docs
- Complete parity analysis framework integration

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add critical git workflow warnings to .husky/pre-commit
- Update smart-push.sh with comprehensive AI agent guidance
- Fix README.md automated release section (was showing dangerous commands)
- Add critical warnings to .agent/sop/development-workflow.md
- Prevent future incidents where agents bypass smart-push automation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add pre-push hook blocking direct main branch pushes
- Enhance smart-push with bypass detection and validation
- Create git protection setup script with multiple safety layers
- Add package.json script traps to catch bypass attempts
- Implement comprehensive agent protection documentation
- Block force pushes and --no-verify flag usage
- Add git aliases redirecting dangerous commands to smart-push
- Create commit templates with workflow reminders

🛡️ Protection Level: MAXIMUM - Multiple bypass prevention layers
🎯 Prevents agents from using shortcuts that break automation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
…c-automation

feat: implement automatic .agent/ to docs sync via CI
@vercel
Copy link
Copy Markdown

vercel Bot commented Nov 2, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
grok-cli-hurry-mode-4som Ready Ready Preview Comment Nov 2, 2025 10:22am

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.

3 participants