init

Setup — First-time project initialization with migration

You are initializing PlanKit for this project. Follow these steps exactly.

Step 1: Check Existing State

Check if a PlanKit folder already exists:

• Look for PlanKit/ in the project root
• Look for plan-kit/ in the project root

If a PlanKit folder exists:

• Read .config.json from it
• Count files and approximate word counts in Ideas, Roadmap, Features
• Display current state:

  ════════════════════════════════════════════════════════════════
  📋 PlanKit already initialized
  ════════════════════════════════════════════════════════════════
  
  Folder: [PlanKit/ or plan-kit/]
  Convention: [UpperCamelCase or kebab-case]
  Ideas: [N words across M themes]
  Roadmap: [N features across M versions]
  Features: [N mission files]
  
  ════════════════════════════════════════════════════════════════
  

• Use AskUserQuestion:

  {
    "questions": [{
      "question": "PlanKit is already set up. What would you like to do?",
      "header": "Action",
      "options": [
        {"label": "Re-run migration", "description": "Import additional planning documents into existing PlanKit"},
        {"label": "Nothing, exit", "description": "Keep current setup as-is"}
      ],
      "multiSelect": false
    }]
  }
  

• If "Nothing" → exit with a brief "All good!" message.
• If "Re-run migration" → skip to Step 4.

If no PlanKit folder exists → continue to Step 2.

Step 2: Detect Naming Convention

Scan the project root directory to detect the naming convention:

UpperCamelCase indicators (Swift/Apple ecosystem):

• Sources/, Tests/, Models/, Views/, ViewModels/
• .xcodeproj, .xcworkspace, Package.swift
• Resources/, Extensions/, Helpers/, Protocols/

kebab-case indicators (JS/web ecosystem):

• src/, lib/, dist/, node_modules/
• package.json, tsconfig.json, webpack.config.js
• public/, assets/, components/

If clear match → use detected convention, tell user: "Detected [convention] based on project structure."