Skip to content

Commit 1400697

Browse files
ryanmacclaude
andcommitted
fix: Create documentation map task during upgrades when missing
The installer now checks during upgrades if the critical [INIT] documentation map task exists, and creates it if missing. This ensures existing projects that were set up before PR #73 will get the documentation map task when they upgrade. Changes: - Added Step 6.5 to check for documentation map task during upgrades - Only creates the task if it doesn't exist AND no map file exists - Provides appropriate feedback for all scenarios - Maintains backward compatibility with existing installations This addresses the issue where upgrading Code Conductor doesn't create the documentation map task that was added in PR #73 for fresh installations. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
1 parent 992c345 commit 1400697

File tree

1 file changed

+72
-0
lines changed

1 file changed

+72
-0
lines changed

conductor-init.sh

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -648,6 +648,78 @@ Create GitHub Actions workflow for automated testing and deployment.
648648
fi
649649
fi
650650

651+
# Step 6.5: Create documentation map task for upgrades if missing
652+
if [ "$IS_UPGRADE" = true ]; then
653+
echo ""
654+
echo -e "${YELLOW}📝 Checking for critical documentation map task...${NC}"
655+
656+
# Check if GitHub CLI is available
657+
if command -v gh >/dev/null 2>&1 && gh auth status >/dev/null 2>&1; then
658+
# Check if documentation map task already exists
659+
DOC_MAP_EXISTS=$(gh issue list -l 'conductor:task' --search "[INIT] Build documentation" --json number 2>/dev/null | jq length 2>/dev/null || echo "0")
660+
661+
# Also check if documentation map file already exists
662+
DOC_MAP_FILE_EXISTS=false
663+
if [ -f ".conductor/documentation-map.yaml" ]; then
664+
DOC_MAP_FILE_EXISTS=true
665+
fi
666+
667+
if [ "$DOC_MAP_EXISTS" = "0" ] && [ "$DOC_MAP_FILE_EXISTS" = false ]; then
668+
echo "Creating critical documentation map task..."
669+
670+
# Create critical documentation map task
671+
gh issue create \
672+
--title "[INIT] Build documentation map and analyze codebase" \
673+
--body "## Description
674+
This is the initial discovery task that analyzes the entire codebase to create a comprehensive documentation map. This map is essential for Code Conductor to understand the project structure and generate appropriate tasks.
675+
676+
## Objective
677+
Create .conductor/documentation-map.yaml with:
678+
- Complete project analysis and structure mapping
679+
- Technology stack detection and validation
680+
- List of existing vs. missing documentation
681+
- Feature implementation status
682+
- Critical paths and dependencies
683+
- Proposed tasks based on project needs
684+
685+
## Success Criteria
686+
- Documentation map created at .conductor/documentation-map.yaml
687+
- Project structure fully analyzed and documented
688+
- Technology stack properly identified
689+
- Missing documentation identified
690+
- Generate initial task proposals based on project state
691+
- Run generate-tasks-from-map.py to create follow-up tasks
692+
693+
## Process
694+
1. Analyze entire codebase structure
695+
2. Detect all technologies, frameworks, and tools
696+
3. Identify existing documentation
697+
4. Map feature implementation status
698+
5. Create comprehensive YAML documentation map
699+
6. Generate missing documentation where possible
700+
7. Propose initial tasks based on findings
701+
702+
## Priority
703+
This task has the highest priority as all other tasks depend on the documentation map for context.
704+
705+
## Files to Create/Modify
706+
- .conductor/documentation-map.yaml (create)
707+
- .conductor/README.md (update if needed)
708+
- Project documentation files (as identified)" \
709+
--label "conductor:task" \
710+
--label "effort:large" \
711+
--label "priority:high" \
712+
2>/dev/null && echo " ✅ Created critical task: [INIT] Build documentation map"
713+
elif [ "$DOC_MAP_FILE_EXISTS" = true ]; then
714+
echo -e "${GREEN}✅ Documentation map already exists at .conductor/documentation-map.yaml${NC}"
715+
else
716+
echo -e "${GREEN}✅ Documentation map task already exists${NC}"
717+
fi
718+
else
719+
echo -e "${YELLOW}⚠️ GitHub CLI not available - cannot check for documentation map task${NC}"
720+
fi
721+
fi
722+
651723
# Step 7: Auto-commit all generated files (with user consent)
652724
echo ""
653725
if [ "$IS_UPGRADE" = true ]; then

0 commit comments

Comments
 (0)