diff --git a/.claude/skills/claude-plugin-developer/references/manifest-schema.md b/.claude/skills/claude-plugin-developer/references/manifest-schema.md index 3d48783..1d1df58 100644 --- a/.claude/skills/claude-plugin-developer/references/manifest-schema.md +++ b/.claude/skills/claude-plugin-developer/references/manifest-schema.md @@ -98,19 +98,19 @@ Complete JSON schema reference for `.claude-plugin/plugin.json` files. "version": "2.1.0", "description": "Automated deployment tools for cloud platforms", "author": { - "name": "Bandit Labs", - "email": "plugins@hyperhivelabs.com", - "url": "https://hyperhivelabs.com" + "name": "Your Name", + "email": "plugins@example.com", + "url": "https://example.com" }, "license": "MIT", "keywords": ["deployment", "automation", "cloud", "devops"], - "homepage": "https://github.com/hyperhivelabs/deploy-automation", + "homepage": "https://github.com/yourorg/deploy-automation", "repository": { "type": "git", - "url": "https://github.com/hyperhivelabs/deploy-automation.git" + "url": "https://github.com/yourorg/deploy-automation.git" }, "bugs": { - "url": "https://github.com/hyperhivelabs/deploy-automation/issues" + "url": "https://github.com/yourorg/deploy-automation/issues" }, "dependencies": { "node": ">=18.0.0", diff --git a/.mcp.json b/.mcp.json new file mode 100644 index 0000000..7377919 --- /dev/null +++ b/.mcp.json @@ -0,0 +1,28 @@ +{ + "mcpServers": { + "gitea": { + "command": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/gitea/.venv/bin/python", + "args": ["-m", "mcp_server.server"], + "cwd": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/gitea", + "env": { + "PYTHONPATH": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/gitea" + } + }, + "wikijs": { + "command": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/wikijs/.venv/bin/python", + "args": ["-m", "mcp_server.server"], + "cwd": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/wikijs", + "env": { + "PYTHONPATH": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/wikijs" + } + }, + "netbox": { + "command": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/netbox/.venv/bin/python", + "args": ["-m", "mcp_server.server"], + "cwd": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/netbox", + "env": { + "PYTHONPATH": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/netbox" + } + } + } +} diff --git a/CLAUDE.md b/CLAUDE.md index 9537692..37d7191 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -212,20 +212,19 @@ The label system includes: **Critical Feature:** After 15 sprints without lesson capture, repeated mistakes occurred (e.g., Claude Code infinite loops on similar issues 2-3 times). -**Wiki.js Structure:** +**Wiki.js Structure (Example):** ``` -Wiki.js: https://wiki.hyperhivelabs.com -└── /hyper-hive-labs/ +Wiki.js: https://wiki.your-company.com +└── /your-org/ ├── projects/ # Project-specific documentation - │ ├── cuisineflow/ + │ ├── project-a/ │ │ ├── lessons-learned/ │ │ │ ├── sprints/ │ │ │ ├── patterns/ │ │ │ └── INDEX.md │ │ └── documentation/ - │ ├── cuisineflow-site/ - │ ├── intuit-engine/ - │ └── hhl-site/ + │ ├── project-b/ + │ └── project-c/ ├── company/ # Company-wide documentation │ ├── processes/ │ ├── standards/ @@ -376,11 +375,11 @@ bandit/support-claude-mktplace/ ## Multi-Project Context (PMO Plugin) -The `projman-pmo` plugin will coordinate interdependent projects: -- **CuisineFlow** - Main product -- **CuisineFlow-Site** - Demo sync + customer gateway -- **Intuit Engine Service** - API aggregator extraction (imminent) -- **HHL-Site** - Company presence +The `projman-pmo` plugin coordinates interdependent projects across an organization. Example use cases: +- Main product repository +- Marketing/documentation sites +- Extracted services +- Supporting tools PMO plugin adds: - Cross-project issue aggregation (all repos in organization) @@ -392,7 +391,7 @@ PMO plugin adds: **Configuration Difference:** - PMO operates at company level (no `GITEA_REPO` or `WIKIJS_PROJECT`) -- Accesses entire `/hyper-hive-labs` Wiki.js namespace +- Accesses entire organization Wiki.js namespace - Queries all repositories in organization Build PMO plugin AFTER projman is working and validated. @@ -409,7 +408,7 @@ Create local marketplace for plugin development: ``` **Integration Testing:** -Test in real CuisineFlow repository with actual Gitea instance before distribution. +Test in a real repository with actual Gitea instance before distribution. **Success Metrics:** - Sprint planning time reduced 40% @@ -426,7 +425,7 @@ Test in real CuisineFlow repository with actual Gitea instance before distributi - **Type/Refactor label** - Newly implemented at org level for architectural work - **Branch detection must be 100% reliable** - Prevents production accidents - **Python for MCP servers** - Use Python 3.8+ with virtual environments -- **Wiki.js structure** - All HHL content under `/hyper-hive-labs` namespace +- **Wiki.js structure** - Organization content under configured base namespace ## CRITICAL: Rules You MUST Follow @@ -501,7 +500,7 @@ This repository contains comprehensive planning documentation: - Two-MCP-server approach confirmed (Gitea + Wiki.js) - Python selected for MCP server implementation - Hybrid configuration strategy defined (system + project level) -- Wiki.js structure planned at `/hyper-hive-labs` +- Wiki.js structure planned with configurable base path - Repository structure designed with shared MCP servers - `claude-plugin-developer` skill added to project diff --git a/docs/references/MCP-WIKIJS.md b/docs/references/MCP-WIKIJS.md index a3b31fa..5ba9e9e 100644 --- a/docs/references/MCP-WIKIJS.md +++ b/docs/references/MCP-WIKIJS.md @@ -25,12 +25,12 @@ The MCP server operates in two modes based on environment variables: **Project Mode (projman):** - When `WIKIJS_PROJECT` is present -- Operates within project path: `/hyper-hive-labs/projects/cuisineflow` +- Operates within project path: `/your-org/projects/my-project` - Used by projman plugin **Company Mode (pmo):** - When `WIKIJS_PROJECT` is absent -- Operates on entire namespace: `/hyper-hive-labs` +- Operates on entire namespace: `/your-org` - Used by projman-pmo plugin ```python @@ -38,8 +38,8 @@ The MCP server operates in two modes based on environment variables: def load(self): # ... load configs ... - self.base_path = os.getenv('WIKIJS_BASE_PATH') # /hyper-hive-labs - self.project_path = os.getenv('WIKIJS_PROJECT') # projects/cuisineflow (optional) + self.base_path = os.getenv('WIKIJS_BASE_PATH') # /your-org + self.project_path = os.getenv('WIKIJS_PROJECT') # projects/my-project (optional) # Compose full path if self.project_path: @@ -66,10 +66,10 @@ def load(self): ### Company-Wide Organization ``` -Wiki.js: https://wiki.hyperhivelabs.com -└── /hyper-hive-labs/ # Base path +Wiki.js: https://wiki.your-company.com +└── /your-org/ # Base path ├── projects/ # Project-specific documentation - │ ├── cuisineflow/ + │ ├── my-project/ │ │ ├── lessons-learned/ │ │ │ ├── sprints/ │ │ │ │ ├── sprint-01-auth.md @@ -83,13 +83,13 @@ Wiki.js: https://wiki.hyperhivelabs.com │ │ ├── architecture/ │ │ ├── api/ │ │ └── deployment/ - │ ├── cuisineflow-site/ + │ ├── my-project-site/ │ │ ├── lessons-learned/ │ │ └── documentation/ │ ├── intuit-engine/ │ │ ├── lessons-learned/ │ │ └── documentation/ - │ └── hhl-site/ + │ └── company-site/ │ ├── lessons-learned/ │ └── documentation/ ├── company/ # Company-wide documentation @@ -124,11 +124,11 @@ Wiki.js: https://wiki.hyperhivelabs.com **Project Mode (projman):** - Full path = `{WIKIJS_BASE_PATH}/{WIKIJS_PROJECT}` -- Example: `/hyper-hive-labs/projects/cuisineflow` +- Example: `/your-org/projects/my-project` **Company Mode (pmo):** - Full path = `{WIKIJS_BASE_PATH}` -- Example: `/hyper-hive-labs` +- Example: `/your-org` --- @@ -139,14 +139,14 @@ Wiki.js: https://wiki.hyperhivelabs.com **File:** `~/.config/claude/wikijs.env` ```bash -WIKIJS_API_URL=https://wiki.hyperhivelabs.com/graphql +WIKIJS_API_URL=https://wiki.your-company.com/graphql WIKIJS_API_TOKEN=your_wikijs_token -WIKIJS_BASE_PATH=/hyper-hive-labs +WIKIJS_BASE_PATH=/your-org ``` **Generating Wiki.js API Token:** -1. Log into Wiki.js: https://wiki.hyperhivelabs.com +1. Log into Wiki.js: https://wiki.your-company.com 2. Navigate to: **User Menu (top-right)** → **Administration** 3. In the sidebar, go to: **API Access** 4. Click **Create New Token** @@ -170,9 +170,9 @@ mkdir -p ~/.config/claude # Create wikijs.env cat > ~/.config/claude/wikijs.env << EOF -WIKIJS_API_URL=https://wiki.hyperhivelabs.com/graphql +WIKIJS_API_URL=https://wiki.your-company.com/graphql WIKIJS_API_TOKEN=your_token_here -WIKIJS_BASE_PATH=/hyper-hive-labs +WIKIJS_BASE_PATH=/your-org EOF # Secure the file (important!) @@ -188,13 +188,13 @@ cat ~/.config/claude/wikijs.env ```bash # Wiki.js project path (relative to base path) -WIKIJS_PROJECT=projects/cuisineflow +WIKIJS_PROJECT=projects/my-project ``` **Setup:** ```bash # In each project root -echo "WIKIJS_PROJECT=projects/cuisineflow" >> .env +echo "WIKIJS_PROJECT=projects/my-project" >> .env # Add to .gitignore (if not already) echo ".env" >> .gitignore @@ -243,8 +243,8 @@ class WikiJSConfig: # Extract values self.api_url = os.getenv('WIKIJS_API_URL') self.api_token = os.getenv('WIKIJS_API_TOKEN') - self.base_path = os.getenv('WIKIJS_BASE_PATH') # /hyper-hive-labs - self.project_path = os.getenv('WIKIJS_PROJECT') # projects/cuisineflow (optional) + self.base_path = os.getenv('WIKIJS_BASE_PATH') # /your-org + self.project_path = os.getenv('WIKIJS_PROJECT') # projects/my-project (optional) # Compose full path if self.project_path: @@ -691,7 +691,7 @@ class WikiJSClient: by_project = {} for result in results: # Extract project name from path - # e.g., "/hyper-hive-labs/projects/cuisineflow/..." -> "cuisineflow" + # e.g., "/your-org/projects/my-project/..." -> "my-project" path_parts = result['path'].split('/') if len(path_parts) >= 4: project = path_parts[3] @@ -957,7 +957,7 @@ Agent: Any architectural insights for similar future work? User: [Response] Agent: I'll create a lesson in Wiki.js: - Path: /hyper-hive-labs/projects/cuisineflow/lessons-learned/sprints/sprint-16-intuit-engine + Path: /your-org/projects/my-project/lessons-learned/sprints/sprint-16-intuit-engine Tags detected: #service-extraction #api #refactoring #claude-code-loops @@ -965,7 +965,7 @@ Agent: I'll create a lesson in Wiki.js: Creating page in Wiki.js... ✅ Updating INDEX.md... ✅ - View at: https://wiki.hyperhivelabs.com/hyper-hive-labs/projects/cuisineflow/lessons-learned/sprints/sprint-16-intuit-engine + View at: https://wiki.your-company.com/your-org/projects/my-project/lessons-learned/sprints/sprint-16-intuit-engine ``` --- @@ -1011,14 +1011,14 @@ def test_project_config_path_composition(tmp_path, monkeypatch): system_config.write_text( "WIKIJS_API_URL=https://wiki.test.com/graphql\n" "WIKIJS_API_TOKEN=test_token\n" - "WIKIJS_BASE_PATH=/hyper-hive-labs\n" + "WIKIJS_BASE_PATH=/your-org\n" ) project_dir = tmp_path / 'project' project_dir.mkdir() project_config = project_dir / '.env' - project_config.write_text("WIKIJS_PROJECT=projects/cuisineflow\n") + project_config.write_text("WIKIJS_PROJECT=projects/my-project\n") monkeypatch.setenv('HOME', str(tmp_path)) monkeypatch.chdir(project_dir) @@ -1026,8 +1026,8 @@ def test_project_config_path_composition(tmp_path, monkeypatch): config = WikiJSConfig() result = config.load() - assert result['project_path'] == 'projects/cuisineflow' - assert result['full_path'] == '/hyper-hive-labs/projects/cuisineflow' + assert result['project_path'] == 'projects/my-project' + assert result['full_path'] == '/your-org/projects/my-project' assert result['mode'] == 'project' ``` @@ -1116,7 +1116,7 @@ pytest tests/test_config.py::test_project_config_path_composition ### Initial Structure Creation -**Status:** Base structure `/hyper-hive-labs` **does not exist** and needs to be created during Phase 1.1b. +**Status:** Base structure `/your-org` **does not exist** and needs to be created during Phase 1.1b. **Setup Script:** Run this script during Phase 1.1b to create the base structure: @@ -1134,7 +1134,7 @@ from mcp_server.wikijs_client import WikiJSClient async def initialize_wiki_structure(): - """Create base Wiki.js structure for Bandit Labs""" + """Create base Wiki.js structure for Your Organization""" print("Initializing Wiki.js base structure...") print("=" * 60) @@ -1153,17 +1153,17 @@ async def initialize_wiki_structure(): # Base structure to create base_pages = [ { - 'path': 'hyper-hive-labs', - 'title': 'Bandit Labs', - 'content': '''# Bandit Labs Documentation + 'path': 'your-org', + 'title': 'Your Organization', + 'content': '''# Your Organization Documentation -Welcome to the Bandit Labs knowledge base. +Welcome to the Your Organization knowledge base. ## Organization -- **[Projects](hyper-hive-labs/projects)** - Project-specific documentation and lessons learned -- **[Company](hyper-hive-labs/company)** - Company-wide processes, standards, and tools -- **[Shared](hyper-hive-labs/shared)** - Cross-project architecture patterns and best practices +- **[Projects](your-org/projects)** - Project-specific documentation and lessons learned +- **[Company](your-org/company)** - Company-wide processes, standards, and tools +- **[Shared](your-org/shared)** - Cross-project architecture patterns and best practices ## Purpose @@ -1176,10 +1176,10 @@ This knowledge base captures: All content is searchable and tagged for easy discovery across projects. ''', 'tags': ['company', 'index'], - 'description': 'Bandit Labs company knowledge base' + 'description': 'Your Organization company knowledge base' }, { - 'path': 'hyper-hive-labs/projects', + 'path': 'your-org/projects', 'title': 'Projects', 'content': '''# Project Documentation @@ -1187,10 +1187,10 @@ Project-specific documentation and lessons learned. ## Active Projects -- **[CuisineFlow](hyper-hive-labs/projects/cuisineflow)** - Main product -- **[CuisineFlow-Site](hyper-hive-labs/projects/cuisineflow-site)** - Demo and customer gateway -- **[Intuit-Engine](hyper-hive-labs/projects/intuit-engine)** - API aggregator service -- **[HHL-Site](hyper-hive-labs/projects/hhl-site)** - Company website +- **[My-Project](your-org/projects/my-project)** - Main product +- **[My-Project-Site](your-org/projects/my-project-site)** - Demo and customer gateway +- **[Intuit-Engine](your-org/projects/intuit-engine)** - API aggregator service +- **[Company-Site](your-org/projects/company-site)** - Company website Each project maintains: - Lessons learned from sprints @@ -1201,7 +1201,7 @@ Each project maintains: 'description': 'Index of all project documentation' }, { - 'path': 'hyper-hive-labs/company', + 'path': 'your-org/company', 'title': 'Company', 'content': '''# Company Documentation @@ -1209,9 +1209,9 @@ Company-wide processes, standards, and tools. ## Sections -- **[Processes](hyper-hive-labs/company/processes)** - Development workflows, onboarding, deployment -- **[Standards](hyper-hive-labs/company/standards)** - Code style, API design, security practices -- **[Tools](hyper-hive-labs/company/tools)** - Gitea, Wiki.js, Claude Code plugin guides +- **[Processes](your-org/company/processes)** - Development workflows, onboarding, deployment +- **[Standards](your-org/company/standards)** - Code style, API design, security practices +- **[Tools](your-org/company/tools)** - Gitea, Wiki.js, Claude Code plugin guides These standards apply to all projects and team members. ''', @@ -1219,7 +1219,7 @@ These standards apply to all projects and team members. 'description': 'Company processes and standards' }, { - 'path': 'hyper-hive-labs/shared', + 'path': 'your-org/shared', 'title': 'Shared Resources', 'content': '''# Shared Resources @@ -1227,9 +1227,9 @@ Cross-project architecture patterns, best practices, and technical knowledge. ## Sections -- **[Architecture Patterns](hyper-hive-labs/shared/architecture-patterns)** - Microservices, service extraction, API design -- **[Best Practices](hyper-hive-labs/shared/best-practices)** - Error handling, logging, testing strategies -- **[Tech Stack](hyper-hive-labs/shared/tech-stack)** - Python ecosystem, Docker, CI/CD pipelines +- **[Architecture Patterns](your-org/shared/architecture-patterns)** - Microservices, service extraction, API design +- **[Best Practices](your-org/shared/best-practices)** - Error handling, logging, testing strategies +- **[Tech Stack](your-org/shared/tech-stack)** - Python ecosystem, Docker, CI/CD pipelines These patterns are distilled from lessons learned across all projects. ''', @@ -1238,40 +1238,40 @@ These patterns are distilled from lessons learned across all projects. }, # Project placeholders { - 'path': 'hyper-hive-labs/projects/cuisineflow', - 'title': 'CuisineFlow', - 'content': '''# CuisineFlow + 'path': 'your-org/projects/my-project', + 'title': 'My-Project', + 'content': '''# My-Project Main product - recipe management and meal planning platform. ## Documentation -- **[Lessons Learned](hyper-hive-labs/projects/cuisineflow/lessons-learned)** - Sprint retrospectives and insights -- **[Architecture](hyper-hive-labs/projects/cuisineflow/documentation/architecture)** - System architecture -- **[API](hyper-hive-labs/projects/cuisineflow/documentation/api)** - API documentation +- **[Lessons Learned](your-org/projects/my-project/lessons-learned)** - Sprint retrospectives and insights +- **[Architecture](your-org/projects/my-project/documentation/architecture)** - System architecture +- **[API](your-org/projects/my-project/documentation/api)** - API documentation Sprint lessons will be automatically captured here by the projman plugin. ''', - 'tags': ['project', 'cuisineflow'], - 'description': 'CuisineFlow project documentation' + 'tags': ['project', 'my-project'], + 'description': 'My-Project project documentation' }, { - 'path': 'hyper-hive-labs/projects/cuisineflow/lessons-learned', - 'title': 'CuisineFlow - Lessons Learned', - 'content': '''# CuisineFlow - Lessons Learned + 'path': 'your-org/projects/my-project/lessons-learned', + 'title': 'My-Project - Lessons Learned', + 'content': '''# My-Project - Lessons Learned -Sprint retrospectives and insights from CuisineFlow development. +Sprint retrospectives and insights from My-Project development. ## Organization -- **[Sprints](hyper-hive-labs/projects/cuisineflow/lessons-learned/sprints)** - Sprint-specific lessons -- **[Patterns](hyper-hive-labs/projects/cuisineflow/lessons-learned/patterns)** - Recurring patterns and solutions -- **[INDEX](hyper-hive-labs/projects/cuisineflow/lessons-learned/INDEX)** - Complete index with tags +- **[Sprints](your-org/projects/my-project/lessons-learned/sprints)** - Sprint-specific lessons +- **[Patterns](your-org/projects/my-project/lessons-learned/patterns)** - Recurring patterns and solutions +- **[INDEX](your-org/projects/my-project/lessons-learned/INDEX)** - Complete index with tags Lessons are automatically captured during sprint close via `/sprint-close` command. ''', - 'tags': ['lessons-learned', 'cuisineflow'], - 'description': 'CuisineFlow lessons learned index' + 'tags': ['lessons-learned', 'my-project'], + 'description': 'My-Project lessons learned index' } ] @@ -1308,7 +1308,7 @@ Lessons are automatically captured during sprint close via `/sprint-close` comma sys.exit(1) else: print(f"\n✅ All pages created successfully!") - print(f"\nView at: https://wiki.hyperhivelabs.com/hyper-hive-labs") + print(f"\nView at: https://wiki.your-company.com/your-org") if __name__ == '__main__': @@ -1326,13 +1326,13 @@ python setup_wiki_structure.py ``` Initializing Wiki.js base structure... ============================================================ -✅ Connected to Wiki.js at https://wiki.hyperhivelabs.com/graphql - Base path: /hyper-hive-labs +✅ Connected to Wiki.js at https://wiki.your-company.com/graphql + Base path: /your-org -Creating: /hyper-hive-labs +Creating: /your-org ✅ Created successfully -Creating: /hyper-hive-labs/projects +Creating: /your-org/projects ✅ Created successfully ... @@ -1343,12 +1343,12 @@ Setup complete! ✅ All pages created successfully! -View at: https://wiki.hyperhivelabs.com/hyper-hive-labs +View at: https://wiki.your-company.com/your-org ``` **Post-Setup:** After running the script: -1. Visit https://wiki.hyperhivelabs.com/hyper-hive-labs to verify structure +1. Visit https://wiki.your-company.com/your-org to verify structure 2. Add additional project directories as needed 3. The structure is now ready for projman plugin to use @@ -1451,13 +1451,13 @@ if __name__ == '__main__': curl -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"query":"{ pages { list { id title } } }"}' \ - https://wiki.hyperhivelabs.com/graphql + https://wiki.your-company.com/graphql ``` **Issue:** Path not found ```bash # Solution: Verify base structure exists -# Check in Wiki.js web interface that /hyper-hive-labs path exists +# Check in Wiki.js web interface that /your-org path exists ``` **Issue:** Tags not working diff --git a/docs/references/PLUGIN-PMO.md b/docs/references/PLUGIN-PMO.md index 477aa99..67bbe50 100644 --- a/docs/references/PLUGIN-PMO.md +++ b/docs/references/PLUGIN-PMO.md @@ -197,7 +197,7 @@ projman-pmo/ **Critical Differences from projman:** - **NO** `GITEA_REPO` → operates on all repositories -- **NO** `WIKIJS_PROJECT` → operates on entire `/hyper-hive-labs` namespace +- **NO** `WIKIJS_PROJECT` → operates on entire `/your-org` namespace - Same shared MCP servers at `../mcp-servers/` ### Environment Variables @@ -282,10 +282,10 @@ User: /pmo-status PMO: Projects Overview: - CuisineFlow: Sprint in progress, 60% complete - └─ Blocking: CuisineFlow-Site deployment + Main-App: Sprint in progress, 60% complete + └─ Blocking: Main-App-Site deployment - I notice CuisineFlow-Site is waiting on API changes. + I notice Main-App-Site is waiting on API changes. Use projman in the cuisineflow-site repo to plan the sync work. ``` @@ -309,7 +309,7 @@ User: /pmo-status PMO: Projects Overview ================ - CuisineFlow (main product) + Main-App (main product) ├── Sprint: Intuit Engine Extraction ├── Status: In Progress (60%) ├── Issue: #47 @@ -317,13 +317,13 @@ PMO: Projects Overview ├── Next: API testing └── Timeline: On track (1 week remaining) - CuisineFlow-Site (demo) + Main-App-Site (demo) ├── Sprint: Dashboard Updates ├── Status: Waiting on dependencies ├── Issue: #12 - ├── Blockers: Depends on CuisineFlow #47 (API changes) + ├── Blockers: Depends on Main-App #47 (API changes) ├── Next: Deploy when API ready - └── Timeline: Blocked (waiting on CuisineFlow) + └── Timeline: Blocked (waiting on Main-App) Intuit-Engine (service) ├── Sprint: Initial Setup @@ -333,7 +333,7 @@ PMO: Projects Overview ├── Next: Service boundary definition └── Timeline: Not started - HHL-Site (marketing) + Company-Site (marketing) ├── Sprint: Content Updates ├── Status: Complete ├── Issue: #8 (closed) @@ -342,14 +342,14 @@ PMO: Projects Overview └── Timeline: Ready for deployment Cross-Project Insights: - - CuisineFlow-Site blocked by CuisineFlow #47 + - Main-App-Site blocked by Main-App #47 - Intuit-Engine needs architectural guidance - - HHL-Site ready for deployment + - Company-Site ready for deployment Suggested Actions: - 1. Prioritize CuisineFlow #47 completion (unblocks Site) + 1. Prioritize Main-App #47 completion (unblocks Site) 2. Schedule architecture review for Intuit-Engine - 3. Deploy HHL-Site content updates + 3. Deploy Company-Site content updates ``` **Success Criteria:** @@ -375,15 +375,15 @@ PMO: Priority Analysis Across Projects ================================= Critical (Blocks launches): - 1. CuisineFlow #47 - Intuit Engine Extraction - → Blocks: CuisineFlow v2.0 launch (Nov 15) - → Blocks: CuisineFlow-Site deployment + 1. Main-App #47 - Intuit Engine Extraction + → Blocks: Main-App v2.0 launch (Nov 15) + → Blocks: Main-App-Site deployment → Status: 60% complete, 1 week remaining → Recommendation: Maintain focus High (Important features): - 2. CuisineFlow-Site #12 - Dashboard Updates - → Depends on: CuisineFlow #47 + 2. Main-App-Site #12 - Dashboard Updates + → Depends on: Main-App #47 → Status: Waiting → Recommendation: Begin planning, wait for #47 @@ -393,14 +393,14 @@ PMO: Priority Analysis Across Projects → Recommendation: Schedule architecture review Medium (Enhancements): - 4. HHL-Site #8 - Content Updates + 4. Company-Site #8 - Content Updates → Status: Complete, ready to deploy → Recommendation: Deploy this week Resource Analysis: Leo (primary developer): - - Working on: CuisineFlow #47 (Critical) - - Next: CuisineFlow-Site #12 (High) + - Working on: Main-App #47 (Critical) + - Next: Main-App-Site #12 (High) - Later: Intuit-Engine #3 (High) ⚠️ Potential Conflict: @@ -438,27 +438,27 @@ PMO: Project Dependencies Intuit-Engine (service) ↓ (must complete before) - CuisineFlow (main) + Main-App (main) ↓ (API changes required by) - CuisineFlow-Site (demo) + Main-App-Site (demo) ↓ (deploy together) Customer VPS (deployments) Detailed Dependencies: - 1. CuisineFlow → Intuit-Engine + 1. Main-App → Intuit-Engine Type: Service extraction Status: In progress Blocker: Must complete #47 before v2.0 launch Impact: High (blocks launch) - 2. CuisineFlow → CuisineFlow-Site + 2. Main-App → Main-App-Site Type: Feature sync Status: Waiting Blocker: Dashboard updates need API changes from #47 Impact: Medium (demo consistency) - 3. CuisineFlow → Customer VPS + 3. Main-App → Customer VPS Type: Deployment Status: Pending Blocker: v2.0 launch must complete before customer updates @@ -466,16 +466,16 @@ PMO: Project Dependencies Deployment Order: 1. Complete Intuit-Engine service extraction - 2. Deploy CuisineFlow v2.0 to production - 3. Sync CuisineFlow-Site demo + 2. Deploy Main-App v2.0 to production + 3. Sync Main-App-Site demo 4. Update customer VPS instances Critical Path: - Intuit-Engine (#3) → CuisineFlow (#47) → Site (#12) → Customer VPS + Intuit-Engine (#3) → Main-App (#47) → Site (#12) → Customer VPS Estimated timeline: 3 weeks total Risks: - - CuisineFlow #47 delay would cascade to all downstream + - Main-App #47 delay would cascade to all downstream - Customer VPS updates have Nov 20 deadline ``` @@ -505,9 +505,9 @@ PMO: Resource Conflict Analysis Leo (Developer): Assigned to: - - CuisineFlow #47: Intuit Engine extraction (Priority: Critical) - - CuisineFlow-Site #12: Dashboard redesign (Priority: High) - - HHL-Site #8: Content update (Priority: Medium) + - Main-App #47: Intuit Engine extraction (Priority: Critical) + - Main-App-Site #12: Dashboard redesign (Priority: High) + - Company-Site #8: Content update (Priority: Medium) - Intuit-Engine #3: Service setup (Priority: High) Conflict Analysis: @@ -517,15 +517,15 @@ PMO: Resource Conflict Analysis - Timeline: 2 weeks available Recommendations: - 1. FOCUS: CuisineFlow #47 (Critical, blocks launch) + 1. FOCUS: Main-App #47 (Critical, blocks launch) → Keep as primary focus → Estimated completion: 1 week - 2. QUEUE: CuisineFlow-Site #12 (High, depends on #47) + 2. QUEUE: Main-App-Site #12 (High, depends on #47) → Start after #47 completes → Natural sequencing - 3. DELEGATE: HHL-Site #8 (Medium, content work) + 3. DELEGATE: Company-Site #8 (Medium, content work) → Can be handled by marketing team → Low technical complexity @@ -536,14 +536,14 @@ PMO: Resource Conflict Analysis Timeline Conflict: Without changes: - Week 1-2: CuisineFlow #47 + Week 1-2: Main-App #47 Week 3-4: Site #12 + Engine #3 (CONFLICT) With recommendations: - Week 1-2: CuisineFlow #47 (FOCUS) - Week 3: CuisineFlow-Site #12 (QUEUE) + Week 1-2: Main-App #47 (FOCUS) + Week 3: Main-App-Site #12 (QUEUE) Week 4: Intuit-Engine #3 (SCHEDULE) - HHL-Site #8: Marketing (DELEGATE) + Company-Site #8: Marketing (DELEGATE) Apply recommendations? ``` @@ -571,18 +571,18 @@ PMO: Deployment Schedule =================== Week of Nov 6: - - CuisineFlow: Continue Sprint #47 (Intuit Engine) - - HHL-Site: Deploy content updates (#8) ✅ + - Main-App: Continue Sprint #47 (Intuit Engine) + - Company-Site: Deploy content updates (#8) ✅ Week of Nov 13: - - CuisineFlow: Complete Sprint #47 ⚠️ + - Main-App: Complete Sprint #47 ⚠️ → Critical: Must complete by Nov 15 for launch - - CuisineFlow-Site: Begin Dashboard updates (#12) + - Main-App-Site: Begin Dashboard updates (#12) Week of Nov 20: - - CuisineFlow: Deploy v2.0 to production 🚀 + - Main-App: Deploy v2.0 to production 🚀 → Deployment window: Nov 20-22 - - CuisineFlow-Site: Sync demo with v2.0 + - Main-App-Site: Sync demo with v2.0 - Customer VPS: Begin rollout (Deadline: Nov 20) Week of Nov 27: @@ -590,19 +590,19 @@ PMO: Deployment Schedule - Intuit-Engine: Begin service implementation (#3) Critical Dates: - - Nov 15: CuisineFlow v2.0 feature freeze + - Nov 15: Main-App v2.0 feature freeze - Nov 20: Production deployment - Nov 20: Customer VPS deadline - Nov 22: Demo site sync Dependencies: ✅ Intuit-Engine service boundaries defined - 🔄 CuisineFlow #47 in progress (60%) - ⏳ CuisineFlow-Site #12 waiting + 🔄 Main-App #47 in progress (60%) + ⏳ Main-App-Site #12 waiting ⏳ Customer VPS rollout pending Risks: - ⚠️ CuisineFlow #47 delay would impact: + ⚠️ Main-App #47 delay would impact: - v2.0 launch date (Nov 20) - Customer VPS deadline (Nov 20) - Demo site sync (Nov 22) @@ -632,7 +632,7 @@ PMO: Searching lessons across all projects... Found 5 relevant lessons: - CuisineFlow: + Main-App: - Sprint 08: Service boundary issues with shared DB Tags: #service-extraction #database #refactoring Key: Define boundaries at data model level first @@ -646,13 +646,13 @@ PMO: Searching lessons across all projects... Tags: #service-extraction #dependencies Key: Watch for import cycles - CuisineFlow-Site: + Main-App-Site: - Sprint 05: Sync issues during backend refactor Tags: #sync #refactoring Key: Coordinate deployments during major changes Shared Patterns: - - /hyper-hive-labs/shared/architecture-patterns/service-extraction + - /your-org/shared/architecture-patterns/service-extraction Key: Service Extraction Playbook Common Themes: @@ -672,15 +672,15 @@ User: /pmo-status PMO: [Shows status] Resource Analysis: - - Leo: 3 active projects (CuisineFlow, Site, Engine) - - Marketing: 1 project (HHL-Site) + - Leo: 3 active projects (Main-App, Site, Engine) + - Marketing: 1 project (Company-Site) Bottleneck detected: Leo is on critical path for all technical work Recommendations: 1. Prioritize work that unblocks others 2. Consider hiring/contracting for parallel work - 3. Delegate non-critical work (HHL-Site content) + 3. Delegate non-critical work (Company-Site content) Would you like a detailed resource allocation report? ``` @@ -690,18 +690,18 @@ PMO: [Shows status] ``` User: Plan the v2.0 release across all affected projects -PMO: Release Coordination: CuisineFlow v2.0 +PMO: Release Coordination: Main-App v2.0 ====================================== Affected Projects: - 1. CuisineFlow (main product) + 1. Main-App (main product) 2. Intuit-Engine (new service) - 3. CuisineFlow-Site (demo) + 3. Main-App-Site (demo) 4. Customer VPS instances Pre-Release Checklist: ✅ Intuit-Engine service deployed - 🔄 CuisineFlow #47 complete (60%) + 🔄 Main-App #47 complete (60%) ⏳ Integration tests pending ⏳ Demo site updates pending ⏳ Customer migration scripts ready @@ -712,12 +712,12 @@ PMO: Release Coordination: CuisineFlow v2.0 → Duration: 2 hours → Rollback plan: Ready - 2. Deploy CuisineFlow v2.0 (main app) + 2. Deploy Main-App v2.0 (main app) → Date: Nov 20 → Duration: 4 hours → Rollback plan: Ready - 3. Sync CuisineFlow-Site (demo) + 3. Sync Main-App-Site (demo) → Date: Nov 22 → Duration: 1 hour → Dependencies: Step 2 complete @@ -767,11 +767,11 @@ shared_patterns = await wikijs.get_shared_docs("architecture-patterns") User: Create a shared pattern document for service extraction PMO: I'll create a pattern document based on lessons from: - - CuisineFlow Sprint 08 - - CuisineFlow Sprint 12 + - Main-App Sprint 08 + - Main-App Sprint 12 - Intuit-Engine Sprint 02 - Creating: /hyper-hive-labs/shared/architecture-patterns/service-extraction + Creating: /your-org/shared/architecture-patterns/service-extraction Service Extraction Pattern ========================= @@ -855,7 +855,7 @@ PMO: I'll create a pattern document based on lessons from: **Deliverable:** Validated PMO plugin integrated with projman **Tasks:** -1. Test with multiple projects (CuisineFlow, Site, Engine, HHL-Site) +1. Test with multiple projects (Main-App, Site, Engine, Company-Site) 2. Simulate deployment coordination scenarios 3. Test priority conflict resolution 4. Validate dependency tracking @@ -911,10 +911,10 @@ PMO: I'll create a pattern document based on lessons from: ``` User: /pmo-status -PMO: CuisineFlow-Site: Waiting on dependencies - Blocked by: CuisineFlow #47 (API changes) +PMO: Main-App-Site: Waiting on dependencies + Blocked by: Main-App #47 (API changes) - Recommendation: Focus resources on CuisineFlow #47 to unblock Site work + Recommendation: Focus resources on Main-App #47 to unblock Site work ``` ### Example 2: Resource Conflict Resolution @@ -926,8 +926,8 @@ PMO: Leo assigned to 4 tasks across 3 projects Estimated: 4 weeks work in 2 weeks timeline Recommendations: - - Maintain focus on Critical priority (CuisineFlow #47) - - Delegate content work (HHL-Site #8) to marketing + - Maintain focus on Critical priority (Main-App #47) + - Delegate content work (Company-Site #8) to marketing - Schedule architectural review (Intuit-Engine #3) as team session ``` @@ -936,13 +936,13 @@ PMO: Leo assigned to 4 tasks across 3 projects ``` User: /pmo-schedule -PMO: Critical Path: Engine → CuisineFlow → Site → Customer VPS +PMO: Critical Path: Engine → Main-App → Site → Customer VPS Deadline: Nov 20 (Customer VPS commitment) Current: Week 1 of 3 Status: On track - Risk: If CuisineFlow #47 delayed, entire timeline at risk + Risk: If Main-App #47 delayed, entire timeline at risk Mitigation: Daily progress monitoring ``` diff --git a/docs/references/PLUGIN-PROJMAN.md b/docs/references/PLUGIN-PROJMAN.md index b279124..ed8311d 100644 --- a/docs/references/PLUGIN-PROJMAN.md +++ b/docs/references/PLUGIN-PROJMAN.md @@ -925,13 +925,13 @@ Orchestrator: I'll create a lesson in Wiki.js: #service-extraction #api #database #refactoring #claude-code-loops Creating page in Wiki.js... ✅ - Path: /hyper-hive-labs/projects/cuisineflow/lessons-learned/sprints/sprint-16-intuit-engine + Path: /your-org/projects/my-project/lessons-learned/sprints/sprint-16-intuit-engine Updating INDEX.md... ✅ Closing sprint issue #47... ✅ - View lesson at: https://wiki.hyperhivelabs.com/hyper-hive-labs/projects/cuisineflow/lessons-learned/sprints/sprint-16-intuit-engine + View lesson at: https://wiki.your-company.com/your-org/projects/my-project/lessons-learned/sprints/sprint-16-intuit-engine ``` **Success Criteria:** diff --git a/docs/references/PROJECT-SUMMARY.md b/docs/references/PROJECT-SUMMARY.md index 374c3c0..4920e58 100644 --- a/docs/references/PROJECT-SUMMARY.md +++ b/docs/references/PROJECT-SUMMARY.md @@ -155,9 +155,9 @@ GITEA_API_TOKEN=your_token GITEA_OWNER=bandit # ~/.config/claude/wikijs.env -WIKIJS_API_URL=https://wiki.hyperhivelabs.com/graphql +WIKIJS_API_URL=https://wiki.your-company.com/graphql WIKIJS_API_TOKEN=your_token -WIKIJS_BASE_PATH=/hyper-hive-labs +WIKIJS_BASE_PATH=/your-org ``` **Project-Level:** @@ -271,18 +271,18 @@ WIKIJS_PROJECT=projects/cuisineflow ## Wiki.js Structure ``` -Wiki.js: https://wiki.hyperhivelabs.com -└── /hyper-hive-labs/ +Wiki.js: https://wiki.your-company.com +└── /your-org/ ├── projects/ # Project-specific - │ ├── cuisineflow/ + │ ├── project-a/ │ │ ├── lessons-learned/ │ │ │ ├── sprints/ │ │ │ ├── patterns/ │ │ │ └── INDEX.md │ │ └── documentation/ - │ ├── cuisineflow-site/ - │ ├── intuit-engine/ - │ └── hhl-site/ + │ ├── project-b/ + │ ├── project-c/ + │ └── company-site/ ├── company/ # Company-wide │ ├── processes/ │ ├── standards/ @@ -373,9 +373,9 @@ EOF # Wiki.js config cat > ~/.config/claude/wikijs.env << EOF -WIKIJS_API_URL=https://wiki.hyperhivelabs.com/graphql +WIKIJS_API_URL=https://wiki.your-company.com/graphql WIKIJS_API_TOKEN=your_wikijs_token -WIKIJS_BASE_PATH=/hyper-hive-labs +WIKIJS_BASE_PATH=/your-org EOF # Secure files @@ -565,7 +565,7 @@ Previous attempts failed due to: ### Immediate Actions 1. **Set up system configuration** (Gitea + Wiki.js tokens) -2. **Create Wiki.js base structure** at `/hyper-hive-labs` +2. **Create Wiki.js base structure** at `/your-org` 3. **Begin Phase 1.1a** - Gitea MCP Server implementation 4. **Begin Phase 1.1b** - Wiki.js MCP Server implementation @@ -597,10 +597,10 @@ These decisions were finalized before development: - **Minimum:** Python 3.10.0 ### 2. Wiki.js Base Structure: Needs Creation -- **Status:** `/hyper-hive-labs` structure does NOT exist yet +- **Status:** `/your-org` structure does NOT exist yet - **Action:** Run `setup_wiki_structure.py` during Phase 1.1b - **Script:** See MCP-WIKIJS.md for complete setup script -- **Post-setup:** Verify at https://wiki.hyperhivelabs.com/hyper-hive-labs +- **Post-setup:** Verify at https://wiki.your-company.com/your-org ### 3. Testing Strategy: Both Mocks and Real APIs - **Unit tests:** Use mocks for fast feedback during development diff --git a/mcp-servers/wikijs/README.md b/mcp-servers/wikijs/README.md index 99778aa..66f26e1 100644 --- a/mcp-servers/wikijs/README.md +++ b/mcp-servers/wikijs/README.md @@ -110,7 +110,7 @@ cat > ~/.config/claude/wikijs.env << 'EOF' # Wiki.js API Configuration WIKIJS_API_URL=http://wikijs.hotport/graphql WIKIJS_API_TOKEN=your_api_token_here -WIKIJS_BASE_PATH=/hyper-hive-labs +WIKIJS_BASE_PATH=/your-org EOF chmod 600 ~/.config/claude/wikijs.env @@ -216,7 +216,7 @@ The MCP server is referenced in plugin `.mcp.json`: |----------|-------------|---------| | `WIKIJS_API_URL` | Wiki.js GraphQL endpoint | `http://wiki.example.com/graphql` | | `WIKIJS_API_TOKEN` | API authentication token (JWT) | `eyJhbGciOiJSUzI1...` | -| `WIKIJS_BASE_PATH` | Base path in Wiki.js | `/hyper-hive-labs` | +| `WIKIJS_BASE_PATH` | Base path in Wiki.js | `/your-org` | ### Optional Variables @@ -234,7 +234,7 @@ The MCP server is referenced in plugin `.mcp.json`: ### Recommended Organization ``` -/hyper-hive-labs/ # Base path +/your-org/ # Base path ├── projects/ # Project-specific │ ├── your-project/ │ │ ├── lessons-learned/ diff --git a/mcp-servers/wikijs/TESTING.md b/mcp-servers/wikijs/TESTING.md index dea137c..3d9febc 100644 --- a/mcp-servers/wikijs/TESTING.md +++ b/mcp-servers/wikijs/TESTING.md @@ -52,7 +52,7 @@ mkdir -p ~/.config/claude cat > ~/.config/claude/wikijs.env << 'EOF' WIKIJS_API_URL=http://wikijs.hotport/graphql WIKIJS_API_TOKEN=your_real_token_here -WIKIJS_BASE_PATH=/hyper-hive-labs +WIKIJS_BASE_PATH=/your-org EOF # Run integration tests @@ -198,7 +198,7 @@ echo '{ "success": true, "page": { "id": 123, - "path": "/hyper-hive-labs/projects/test-project/documentation/test-api", + "path": "/your-org/projects/test-project/documentation/test-api", "title": "Test API Documentation" } } diff --git a/mcp-servers/wikijs/mcp_server/wikijs_client.py b/mcp-servers/wikijs/mcp_server/wikijs_client.py index 0cac344..a42f3b4 100644 --- a/mcp-servers/wikijs/mcp_server/wikijs_client.py +++ b/mcp-servers/wikijs/mcp_server/wikijs_client.py @@ -21,8 +21,8 @@ class WikiJSClient: Args: api_url: Wiki.js GraphQL API URL (e.g., http://wiki.example.com/graphql) api_token: Wiki.js API token - base_path: Base path in Wiki.js (e.g., /hyper-hive-labs) - project: Project path (e.g., projects/cuisineflow) for project mode + base_path: Base path in Wiki.js (e.g., /your-org) + project: Project path (e.g., projects/my-project) for project mode """ self.api_url = api_url self.api_token = api_token diff --git a/plugins/cmdb-assistant/.claude-plugin/plugin.json b/plugins/cmdb-assistant/.claude-plugin/plugin.json index 865f796..d17b9ea 100644 --- a/plugins/cmdb-assistant/.claude-plugin/plugin.json +++ b/plugins/cmdb-assistant/.claude-plugin/plugin.json @@ -37,12 +37,6 @@ "file": "agents/cmdb-assistant.md" } }, - "mcpServers": { - "netbox": { - "description": "NetBox API integration via MCP", - "configFile": ".mcp.json" - } - }, "configuration": { "required": [ { diff --git a/plugins/cmdb-assistant/.mcp.json b/plugins/cmdb-assistant/.mcp.json index f9209c4..e6b3260 100644 --- a/plugins/cmdb-assistant/.mcp.json +++ b/plugins/cmdb-assistant/.mcp.json @@ -1,9 +1,12 @@ { "mcpServers": { "netbox": { - "command": "${CLAUDE_PLUGIN_ROOT}/../../mcp-servers/netbox/.venv/bin/python", + "command": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/netbox/.venv/bin/python", "args": ["-m", "mcp_server.server"], - "cwd": "${CLAUDE_PLUGIN_ROOT}/../../mcp-servers/netbox" + "cwd": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/netbox", + "env": { + "PYTHONPATH": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/netbox" + } } } } diff --git a/plugins/projman/.mcp.json b/plugins/projman/.mcp.json index 98395b5..6ce0b42 100644 --- a/plugins/projman/.mcp.json +++ b/plugins/projman/.mcp.json @@ -1,14 +1,20 @@ { "mcpServers": { "gitea": { - "command": "${CLAUDE_PLUGIN_ROOT}/../../mcp-servers/gitea/.venv/bin/python", + "command": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/gitea/.venv/bin/python", "args": ["-m", "mcp_server.server"], - "cwd": "${CLAUDE_PLUGIN_ROOT}/../../mcp-servers/gitea" + "cwd": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/gitea", + "env": { + "PYTHONPATH": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/gitea" + } }, "wikijs": { - "command": "${CLAUDE_PLUGIN_ROOT}/../../mcp-servers/wikijs/.venv/bin/python", + "command": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/wikijs/.venv/bin/python", "args": ["-m", "mcp_server.server"], - "cwd": "${CLAUDE_PLUGIN_ROOT}/../../mcp-servers/wikijs" + "cwd": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/wikijs", + "env": { + "PYTHONPATH": "/home/lmiranda/repos/bandit/support-claude-mktplace/mcp-servers/wikijs" + } } } } diff --git a/plugins/projman/CONFIGURATION.md b/plugins/projman/CONFIGURATION.md index a0ee8e8..300060b 100644 --- a/plugins/projman/CONFIGURATION.md +++ b/plugins/projman/CONFIGURATION.md @@ -112,7 +112,7 @@ python -c "from mcp_server import server; print('Wiki.js MCP Server installed su ### 2.2 Generate Wiki.js API Token -1. Log into Wiki.js: https://wiki.hyperhivelabs.com +1. Log into Wiki.js: https://wiki.your-company.com 2. Navigate to: **Administration** (top right) 3. Click **API Access** in the left sidebar 4. Click **New API Key** @@ -166,9 +166,9 @@ chmod 600 ~/.config/claude/gitea.env ```bash cat > ~/.config/claude/wikijs.env << 'EOF' # Wiki.js API Configuration -WIKIJS_API_URL=https://wiki.hyperhivelabs.com/graphql +WIKIJS_API_URL=https://wiki.your-company.com/graphql WIKIJS_API_TOKEN=your_wikijs_token_here -WIKIJS_BASE_PATH=/hyper-hive-labs +WIKIJS_BASE_PATH=/your-org EOF # Secure the file (owner read/write only) @@ -180,7 +180,7 @@ chmod 600 ~/.config/claude/wikijs.env **Configuration Variables:** - `WIKIJS_API_URL` - Wiki.js GraphQL endpoint (includes `/graphql`) - `WIKIJS_API_TOKEN` - API key from Step 2.2 (JWT format) -- `WIKIJS_BASE_PATH` - Base path in Wiki.js (e.g., `/hyper-hive-labs`) +- `WIKIJS_BASE_PATH` - Base path in Wiki.js (e.g., `/your-org`) ### 3.4 Verify System Configuration @@ -263,7 +263,7 @@ curl -H "Authorization: token YOUR_GITEA_TOKEN" \ curl -H "Authorization: Bearer YOUR_WIKIJS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"query": "{ pages { list { id title } } }"}' \ - https://wiki.hyperhivelabs.com/graphql + https://wiki.your-company.com/graphql # Should return pages data in JSON format ``` @@ -320,17 +320,17 @@ GITEA_OWNER=bandit **`~/.config/claude/wikijs.env`:** ```bash -WIKIJS_API_URL=https://wiki.hyperhivelabs.com/graphql +WIKIJS_API_URL=https://wiki.your-company.com/graphql WIKIJS_API_TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9... -WIKIJS_BASE_PATH=/hyper-hive-labs +WIKIJS_BASE_PATH=/your-org ``` ### Project-Level Files **`.env` (in project root):** ```bash -GITEA_REPO=cuisineflow -WIKIJS_PROJECT=projects/cuisineflow +GITEA_REPO=your-repo-name +WIKIJS_PROJECT=projects/your-project-name ``` **`.gitignore` (must include):** @@ -371,25 +371,25 @@ To use Projman with multiple projects: 1. **System config:** Set up once (already done in Step 3) 2. **Project config:** Create `.env` in each project root: -**Project 1: CuisineFlow** +**Project 1: Main App** ```bash -# ~/projects/cuisineflow/.env -GITEA_REPO=cuisineflow -WIKIJS_PROJECT=projects/cuisineflow +# ~/projects/my-app/.env +GITEA_REPO=my-app +WIKIJS_PROJECT=projects/my-app ``` -**Project 2: CuisineFlow-Site** +**Project 2: App Site** ```bash -# ~/projects/cuisineflow-site/.env -GITEA_REPO=cuisineflow-site -WIKIJS_PROJECT=projects/cuisineflow-site +# ~/projects/my-app-site/.env +GITEA_REPO=my-app-site +WIKIJS_PROJECT=projects/my-app-site ``` -**Project 3: HHL-Site** +**Project 3: Company Site** ```bash -# ~/projects/hhl-site/.env -GITEA_REPO=hhl-site -WIKIJS_PROJECT=projects/hhl-site +# ~/projects/company-site/.env +GITEA_REPO=company-site +WIKIJS_PROJECT=projects/company-site ``` Each project operates independently with its own issues and lessons learned. @@ -421,7 +421,7 @@ curl -H "Authorization: token YOUR_TOKEN" \ # Test Wiki.js token curl -H "Authorization: Bearer YOUR_TOKEN" \ - https://wiki.hyperhivelabs.com/graphql + https://wiki.your-company.com/graphql # If fails, regenerate token (Step 2) ``` diff --git a/plugins/projman/README.md b/plugins/projman/README.md index 9c0dce1..7ed1a66 100644 --- a/plugins/projman/README.md +++ b/plugins/projman/README.md @@ -59,9 +59,9 @@ EOF # Wiki.js configuration cat > ~/.config/claude/wikijs.env << EOF -WIKIJS_API_URL=https://wiki.hyperhivelabs.com/graphql +WIKIJS_API_URL=https://wiki.your-company.com/graphql WIKIJS_API_TOKEN=your_wikijs_token_here -WIKIJS_BASE_PATH=/hyper-hive-labs +WIKIJS_BASE_PATH=/your-org EOF # Secure the files @@ -327,7 +327,7 @@ See [CONFIGURATION.md](./CONFIGURATION.md) for detailed configuration instructio ### Cannot connect to Wiki.js - Verify `~/.config/claude/wikijs.env` exists and has correct URL and token -- Check Wiki.js GraphQL endpoint: `https://wiki.hyperhivelabs.com/graphql` +- Check Wiki.js GraphQL endpoint: `https://wiki.your-company.com/graphql` - Verify API token has pages read/write permissions ### Labels not syncing