gh-duongdev-ccpm/commands/project:subdir:list.md

description, argument-hint

description	argument-hint
List all subdirectories/subprojects configured for a project	<project-id>

List Project Subdirectories

Display all subdirectories configured for a monorepo project with their detection patterns and metadata.

Arguments

• $1 - Project ID (required)

Usage

/ccpm:project:subdir:list repeat
/ccpm:project:subdir:list my-monorepo

Workflow

Step 1: Auto-Activate Skills

Skill(project-operations): Provides display guidance
Skill(project-detection): Provides detection context

Step 2: Load Project Configuration

const projectId = "$1"

if (!projectId) {
  console.log("❌ Error: Project ID required")
  console.log("Usage: /ccpm:project:subdir:list <project-id>")
  console.log("")
  console.log("Available projects:")
  console.log("  /ccpm:project:list")
  exit(1)
}

const projectConfig = Task(project-config-loader): `
Load configuration for project: ${projectId}
Include all sections: true
Validate: false
`

if (projectConfig.error) {
  console.error(`❌ ${projectConfig.error.message}`)
  exit(1)
}

Step 3: Check for Subdirectories

const hasDetection = projectConfig.context?.detection?.subdirectories?.length > 0
const hasMetadata = projectConfig.code_repository?.subprojects?.length > 0

if (!hasDetection && !hasMetadata) {
  console.log(`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 No Subdirectories Configured
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Project: ${projectConfig.project_name} (${projectId})

This project doesn't have subdirectory detection configured.

Add subdirectories for monorepo support:
  /ccpm:project:subdir:add ${projectId}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  `)
  exit(0)
}

Step 4: Get Active Subproject

const activeContext = Task(project-context-manager): `
Get active project context
Format: compact
`

const isThisProjectActive = activeContext?.project_id === projectId
const activeSubproject = isThisProjectActive ? activeContext.subproject : null

Step 5: Display Subdirectories

const detectionConfig = projectConfig.context?.detection?.subdirectories || []
const metadataConfig = projectConfig.code_repository?.subprojects || []

// Combine both sources
const allSubprojects = new Map()

// Add from metadata
metadataConfig.forEach(meta => {
  allSubprojects.set(meta.name, {
    name: meta.name,
    path: meta.path,
    description: meta.description,
    tech_stack: meta.tech_stack,
    detection: null
  })
})

// Add detection info
detectionConfig.forEach(det => {
  if (allSubprojects.has(det.subproject)) {
    allSubprojects.get(det.subproject).detection = det
  } else {
    allSubprojects.set(det.subproject, {
      name: det.subproject,
      path: null,
      description: null,
      tech_stack: null,
      detection: det
    })
  }
})

console.log(`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 Subdirectories for ${projectConfig.project_name}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Project ID:       ${projectId}
Repository:       ${projectConfig.repository.local_path || "Not configured"}
Total Subprojects: ${allSubprojects.size}
${isThisProjectActive && activeSubproject ? `Active:           ⭐ ${activeSubproject}` : ""}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
`)

allSubprojects.forEach((subproject, name) => {
  const isActive = activeSubproject === name
  const indicator = isActive ? "⭐" : "  "

  console.log(`
${indicator} ${name}
   Path:             📁 ${subproject.path || "Not configured"}
   Description:      ${subproject.description || "N/A"}`)

  if (subproject.detection) {
    console.log(`   Match Pattern:    ${subproject.detection.match_pattern}`)
    console.log(`   Priority:         ${subproject.detection.priority || 0}`)
  } else {
    console.log(`   Detection:        ⚠️  Not configured`)
  }

  if (subproject.tech_stack) {
    const langs = subproject.tech_stack.languages?.join(", ") || ""
    if (langs) console.log(`   Languages:        ${langs}`)

    if (subproject.tech_stack.frameworks) {
      const frameworks = Object.entries(subproject.tech_stack.frameworks)
        .map(([type, fws]) => `${type}: ${fws.join(", ")}`)
        .join(", ")
      if (frameworks) console.log(`   Frameworks:       ${frameworks}`)
    }

    const dbs = subproject.tech_stack.database?.join(", ") || ""
    if (dbs) console.log(`   Database:         ${dbs}`)
  }

  console.log("")
  console.log(`   Commands:`)
  console.log(`     Update:  /ccpm:project:subdir:update ${projectId} ${name}`)
  console.log(`     Remove:  /ccpm:project:subdir:remove ${projectId} ${name}`)
  console.log("")
})

console.log(`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 Quick Actions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Add new subdirectory:
  /ccpm:project:subdir:add ${projectId}

View complete project details:
  /ccpm:project:show ${projectId}

Test detection:
  cd ${projectConfig.repository.local_path}/<subproject-path>
  /ccpm:project:list

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
`)

Example Output

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 Subdirectories for Repeat
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Project ID:       repeat
Repository:       /Users/duongdev/repeat
Total Subprojects: 4
Active:           ⭐ jarvis

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   xygaming_symfony
   Path:             📁 xygaming_symfony
   Description:      Legacy Symfony 4.4 PHP web application
   Match Pattern:    */xygaming_symfony/*
   Priority:         10
   Languages:        php
   Frameworks:       backend: symfony
   Database:         mysql, redis

   Commands:
     Update:  /ccpm:project:subdir:update repeat xygaming_symfony
     Remove:  /ccpm:project:subdir:remove repeat xygaming_symfony

⭐ jarvis
   Path:             📁 jarvis
   Description:      Modern admin web application (TurboRepo)
   Match Pattern:    */jarvis/*
   Priority:         10
   Languages:        typescript
   Frameworks:       frontend: nextjs, react, backend: nestjs
   Database:         mysql, prisma

   Commands:
     Update:  /ccpm:project:subdir:update repeat jarvis
     Remove:  /ccpm:project:subdir:remove repeat jarvis

   repeat-mobile-app
   Path:             📁 repeat-mobile-app
   Description:      React Native mobile application
   Match Pattern:    */repeat-mobile-app/*
   Priority:         10
   Languages:        typescript, javascript
   Frameworks:       frontend: react-native, expo

   Commands:
     Update:  /ccpm:project:subdir:update repeat repeat-mobile-app
     Remove:  /ccpm:project:subdir:remove repeat repeat-mobile-app

   messaging
   Path:             📁 messaging
   Description:      Node.js microservice
   Match Pattern:    */messaging/*
   Priority:         10
   Languages:        javascript, typescript
   Frameworks:       backend: nodejs

   Commands:
     Update:  /ccpm:project:subdir:update repeat messaging
     Remove:  /ccpm:project:subdir:remove repeat messaging

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 Quick Actions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Add new subdirectory:
  /ccpm:project:subdir:add repeat

View complete project details:
  /ccpm:project:show repeat

Test detection:
  cd /Users/duongdev/repeat/<subproject-path>
  /ccpm:project:list

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Notes

• Active subproject (if this project is active) is marked with ⭐
• Shows both detection configuration and metadata
• Warns if detection is not configured for a subproject
• Provides commands to update or remove each subdirectory
• Use /ccpm:project:show for complete project view

Agent Integration

Uses these agents:

• project-config-loader: Loads project configuration
• project-context-manager: Checks active subproject
• project-operations skill: Provides display guidance
• project-detection skill: Provides detection context

Related Commands

• /ccpm:project:subdir:add - Add new subdirectory
• /ccpm:project:subdir:update - Update subdirectory details
• /ccpm:project:subdir:remove - Remove subdirectory
• /ccpm:project:show - View complete project configuration
• /ccpm:project:list - List all projects with active detection