Template

Files

lmiranda f35706e621 chore: remove obsolete docs/references/ planning documents

Deleted (obsolete planning docs from pre-implementation phase):
- docs/references/MCP-GITEA.md - wrong MCP server location
- docs/references/MCP-WIKIJS.md - Wiki.js MCP never implemented
- docs/references/PLUGIN-PMO.md - projman-pmo not yet built
- docs/references/PLUGIN-PROJMAN.md - superseded by plugins/projman/README.md
- docs/references/PROJECT-SUMMARY.md - outdated architecture

Updated references in:
- CLAUDE.md - removed docs/references/ from documentation index
- docs/CANONICAL-PATHS.md - removed references directory from structure
- docs/UPDATING.md - updated to reference current documentation
- plugins/projman/mcp-servers/gitea/README.md - fixed related docs links
- plugins/projman/mcp-servers/gitea/TESTING.md - fixed resource links

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

2026-01-20 10:52:35 -05:00

2.2 KiB

Raw Blame History

Updating support-claude-mktplace

This guide covers how to update your local installation when new versions are released.

Quick Update

# 1. Pull latest changes
cd /path/to/support-claude-mktplace
git pull origin main

# 2. Run post-update script
./scripts/post-update.sh

What the Post-Update Script Does

Updates Python dependencies for MCP servers
Shows recent changelog entries so you know what changed
Validates your configuration is still compatible

Manual Steps After Update

Some updates may require manual configuration changes:

New Environment Variables

If the changelog mentions new environment variables:

Check the variable name and purpose in the changelog
Add it to the appropriate config file:
- Gitea variables → ~/.config/claude/gitea.env
- Project variables → .env in your project root

New MCP Server Features

If a new MCP server tool is added:

The post-update script handles dependency installation
Check plugins/projman/README.md for usage documentation
New tools are available immediately after update

Breaking Changes

Breaking changes will be clearly marked in CHANGELOG.md with migration instructions.

Troubleshooting

Dependencies fail to install

# Rebuild virtual environment
cd plugins/projman/mcp-servers/gitea
rm -rf .venv
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
deactivate

Configuration no longer works

Check CHANGELOG.md for breaking changes
Compare your config files with updated .env.example (if provided)
Run ./scripts/setup.sh to validate configuration

MCP server won't start

Check Python version: python3 --version (requires 3.10+)
Verify venv exists: ls plugins/projman/mcp-servers/gitea/.venv
Check logs for specific errors

Version Pinning

To stay on a specific version:

# List available tags
git tag

# Checkout specific version
git checkout v2.2.0

# Run post-update
./scripts/post-update.sh

Getting Help

Check plugins/projman/README.md for projman documentation
Check plugins/projman/CONFIGURATION.md for setup guide
Review CHANGELOG.md for recent changes
Search existing issues in Gitea

2.2 KiB Raw Blame History