@alejandrochaves/devflow-cli 1.3.2 → 1.5.0

package/dist/commands/init.js

@@ -4,6 +4,7 @@ import { confirm, input, select } from "@inquirer/prompts";
 import { execSync } from "child_process";
 import { PRESETS } from "../config.js";
 import { writeVersionInfo, getCliVersion } from "../devflow-version.js";
+import { selectWithBack, inputWithBack, confirmWithBack, BACK_VALUE, } from "../prompts.js";
 const DEFAULT_CHECKLIST = [
     "Code follows project conventions",
     "Self-reviewed the changes",
@@ -42,6 +43,95 @@ function getGitHubIssuesUrl() {
     }
     return undefined;
 }
+function getGitHubRepo() {
+    try {
+        const remoteUrl = execSync("git remote get-url origin", {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        const sshMatch = remoteUrl.match(/git@github\.com:([^/]+)\/(.+?)(?:\.git)?$/);
+        const httpsMatch = remoteUrl.match(/https:\/\/github\.com\/([^/]+)\/(.+?)(?:\.git)?$/);
+        const match = sshMatch || httpsMatch;
+        if (match) {
+            return { owner: match[1], name: match[2] };
+        }
+    }
+    catch {
+        // Not a git repo or no remote
+    }
+    return undefined;
+}
+function hasProjectScopes() {
+    try {
+        // Try to list projects - if it fails with scope error, we don't have permissions
+        execSync("gh project list --owner @me --limit 1", {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return true;
+    }
+    catch (error) {
+        const errorMessage = error.message || "";
+        return !errorMessage.includes("missing required scopes") && !errorMessage.includes("read:project");
+    }
+}
+function getRepoLinkedProjects(repo) {
+    try {
+        const query = `{
+      repository(owner: "${repo.owner}", name: "${repo.name}") {
+        projectsV2(first: 20) {
+          nodes { number title }
+        }
+      }
+    }`;
+        const result = execSync(`gh api graphql -f query='${query}'`, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        if (!result)
+            return [];
+        const data = JSON.parse(result);
+        const nodes = data?.data?.repository?.projectsV2?.nodes || [];
+        return nodes.map((p) => ({
+            number: p.number,
+            title: p.title,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+function refreshProjectScopes() {
+    try {
+        execSync("gh auth refresh -s project", {
+            stdio: "inherit",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function createAndLinkProject(repo, title) {
+    try {
+        // Create the project
+        const createResult = execSync(`gh project create --owner ${repo.owner} --title "${title}" --format json`, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        const project = JSON.parse(createResult);
+        const projectNumber = project.number;
+        // Link it to the repo
+        execSync(`gh project link ${projectNumber} --owner ${repo.owner} --repo ${repo.name}`, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return { number: projectNumber, title };
+    }
+    catch {
+        return null;
+    }
+}
 function writePackageJson(cwd, pkg) {
     const pkgPath = resolve(cwd, "package.json");
     writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
@@ -52,133 +142,376 @@ export async function initCommand() {
         const devflowDir = resolve(cwd, ".devflow");
         const configPath = resolve(devflowDir, "config.json");
         if (existsSync(configPath)) {
-            const overwrite = await confirm({
+            const overwrite = await confirmWithBack({
                 message: "Devflow config already exists. Overwrite?",
                 default: false,
+                showBack: false,
             });
-            if (!overwrite) {
+            if (overwrite !== true) {
                 console.log("Aborted.");
                 process.exit(0);
             }
         }
         console.log("\n  devflow setup\n");
-        // 0. Preset selection
-        const preset = await select({
-            message: "Select a workflow preset:",
-            choices: [
-                { value: "scrum", name: "Scrum - User stories, sprints, acceptance criteria" },
-                { value: "kanban", name: "Kanban - Simple flow-based workflow" },
-                { value: "simple", name: "Simple - Minimal configuration, no ticket required" },
-                { value: "custom", name: "Custom - Configure everything manually" },
-            ],
-        });
-        const presetConfig = PRESETS[preset];
-        console.log("");
-        // 1. Ticket base URL (skip for simple preset since no tickets)
-        let ticketBaseUrl = "";
-        let useGitHubIssues = false;
-        if (preset !== "simple") {
-            const detectedIssuesUrl = getGitHubIssuesUrl();
-            ticketBaseUrl = await input({
-                message: "Ticket base URL (e.g., https://github.com/org/repo/issues):",
-                default: detectedIssuesUrl,
-            });
-            // 1b. GitHub Issues integration
-            useGitHubIssues = await confirm({
-                message: "Use GitHub Issues for ticket tracking? (enables issue picker in branch command)",
-                default: ticketBaseUrl.includes("github.com"),
-            });
-        }
-        // 2. Scopes
-        const scopes = [];
-        const scopeChoice = await select({
-            message: "How would you like to configure commit scopes?",
-            choices: [
-                { value: "defaults", name: "Use defaults (core, ui, api, config, deps, ci)" },
-                { value: "custom", name: "Define custom scopes" },
-                { value: "skip", name: "Skip - configure later" },
-            ],
-        });
-        if (scopeChoice === "defaults") {
-            scopes.push({ value: "core", description: "Core functionality" }, { value: "ui", description: "UI components" }, { value: "api", description: "API layer" }, { value: "config", description: "Configuration" }, { value: "deps", description: "Dependencies" }, { value: "ci", description: "CI/CD" });
-        }
-        else if (scopeChoice === "custom") {
-            console.log("\nAdd scopes one at a time. Press Enter with empty name to finish.\n");
-            let addingScopes = true;
-            while (addingScopes) {
-                const value = await input({
-                    message: `Scope name${scopes.length > 0 ? " (blank to finish)" : ""}:`,
-                });
-                if (!value.trim()) {
-                    addingScopes = false;
+        const state = {
+            preset: "scrum",
+            ticketBaseUrl: "",
+            useGitHubIssues: false,
+            projectEnabled: false,
+            projectNumber: null,
+            scopeChoice: "",
+            scopes: [],
+            checklistChoice: "",
+            checklist: [...DEFAULT_CHECKLIST],
+            customizeFormats: false,
+            branchFormat: "",
+            commitFormat: "{type}[{ticket}]{breaking}({scope}): {message}",
+        };
+        let currentStep = "preset";
+        while (currentStep !== "done") {
+            switch (currentStep) {
+                case "preset": {
+                    const result = await selectWithBack({
+                        message: "Select a workflow preset:",
+                        choices: [
+                            { value: "scrum", name: "Scrum - User stories, sprints, acceptance criteria" },
+                            { value: "kanban", name: "Kanban - Simple flow-based workflow" },
+                            { value: "simple", name: "Simple - Minimal configuration, no ticket required" },
+                            { value: "custom", name: "Custom - Configure everything manually" },
+                        ],
+                        default: state.preset,
+                        showBack: false, // First step
+                    });
+                    if (result === BACK_VALUE) {
+                        // Can't go back from first step
+                    }
+                    else {
+                        state.preset = result;
+                        state.branchFormat = PRESETS[state.preset].branchFormat;
+                        console.log("");
+                        // Skip ticket URL for simple preset
+                        currentStep = state.preset === "simple" ? "scopes" : "ticketUrl";
+                    }
+                    break;
                 }
-                else {
-                    const description = await input({
-                        message: `Description for "${value.trim()}":`,
+                case "ticketUrl": {
+                    const detectedIssuesUrl = getGitHubIssuesUrl();
+                    const result = await inputWithBack({
+                        message: "Ticket base URL (e.g., https://github.com/org/repo/issues):",
+                        default: state.ticketBaseUrl || detectedIssuesUrl,
+                        showBack: true,
                     });
-                    scopes.push({
-                        value: value.trim().toLowerCase(),
-                        description: description.trim() || value.trim(),
+                    if (result === BACK_VALUE) {
+                        currentStep = "preset";
+                    }
+                    else {
+                        state.ticketBaseUrl = result;
+                        currentStep = "githubIssues";
+                    }
+                    break;
+                }
+                case "githubIssues": {
+                    const result = await confirmWithBack({
+                        message: "Use GitHub Issues for ticket tracking? (enables issue picker in branch command)",
+                        default: state.useGitHubIssues || state.ticketBaseUrl.includes("github.com"),
+                        showBack: true,
                     });
+                    if (result === BACK_VALUE) {
+                        currentStep = "ticketUrl";
+                    }
+                    else {
+                        state.useGitHubIssues = result === true;
+                        // If using GitHub issues, offer project integration
+                        currentStep = result === true ? "projectSetup" : "scopes";
+                    }
+                    break;
                 }
-            }
-        }
-        // 3. Checklist (shown in PR descriptions)
-        let checklist = [...DEFAULT_CHECKLIST];
-        const checklistChoice = await select({
-            message: "PR checklist items (shown in pull request descriptions):",
-            choices: [
-                {
-                    value: "defaults",
-                    name: `Use defaults (${DEFAULT_CHECKLIST.length} items: conventions, self-review, no warnings)`,
-                },
-                { value: "custom", name: "Define custom checklist" },
-                { value: "skip", name: "Skip - no checklist" },
-            ],
-        });
-        if (checklistChoice === "custom") {
-            console.log("\nAdd checklist items one at a time. Press Enter with empty text to finish.\n");
-            checklist = [];
-            let addingChecklist = true;
-            while (addingChecklist) {
-                const item = await input({
-                    message: `Checklist item${checklist.length > 0 ? " (blank to finish)" : ""}:`,
-                });
-                if (!item.trim()) {
-                    if (checklist.length === 0) {
-                        checklist = [...DEFAULT_CHECKLIST];
-                        console.log("Using default checklist.");
+                case "projectSetup": {
+                    // Check if we have project scopes
+                    const hasScopes = hasProjectScopes();
+                    if (!hasScopes) {
+                        console.log("\n  GitHub Projects Integration\n");
+                        console.log("  Connecting to a GitHub Project enables:");
+                        console.log("  • Auto-move issues to 'In Progress' when you start a branch");
+                        console.log("  • Auto-move issues to 'In Review' when you open a PR");
+                        console.log("  • View project issues with `devflow issues`\n");
+                        console.log("  This requires the 'project' OAuth scope for your GitHub CLI.");
+                        console.log("  If you skip this, you can still use GitHub Issues without board automation.\n");
+                        const addScopes = await confirmWithBack({
+                            message: "Authorize project access?",
+                            default: true,
+                            showBack: true,
+                        });
+                        if (addScopes === BACK_VALUE) {
+                            currentStep = "githubIssues";
+                            break;
+                        }
+                        if (addScopes === true) {
+                            console.log("\nOpening GitHub to authorize project permissions...\n");
+                            const success = refreshProjectScopes();
+                            if (!success) {
+                                console.log("⚠ Failed to add project permissions. Skipping project integration.");
+                                currentStep = "scopes";
+                                break;
+                            }
+                            console.log("✓ Project permissions added\n");
+                        }
+                        else {
+                            // Skip project integration
+                            state.projectEnabled = false;
+                            currentStep = "scopes";
+                            break;
+                        }
+                    }
+                    // Now we have scopes, list available projects
+                    const repo = getGitHubRepo();
+                    if (!repo) {
+                        console.log("⚠ Could not determine repository. Skipping project integration.");
+                        currentStep = "scopes";
+                        break;
+                    }
+                    // First, try to get projects linked to this repo
+                    const linkedProjects = getRepoLinkedProjects(repo);
+                    if (linkedProjects.length > 0) {
+                        // Show only linked projects
+                        const projectResult = await selectWithBack({
+                            message: "Select a GitHub Project for issue tracking:",
+                            choices: [
+                                ...linkedProjects.map((p) => ({
+                                    value: p.number,
+                                    name: `#${p.number} ${p.title}`,
+                                })),
+                                { value: -1, name: "Skip - don't use project integration" },
+                            ],
+                            showBack: true,
+                        });
+                        if (projectResult === BACK_VALUE) {
+                            currentStep = "githubIssues";
+                        }
+                        else if (projectResult === -1) {
+                            state.projectEnabled = false;
+                            currentStep = "scopes";
+                        }
+                        else {
+                            state.projectEnabled = true;
+                            state.projectNumber = projectResult;
+                            console.log(`✓ Will use project #${projectResult}\n`);
+                            currentStep = "scopes";
+                        }
+                        break;
                     }
-                    addingChecklist = false;
+                    // No linked projects - offer to create one
+                    console.log(`\n  No GitHub Projects are linked to ${repo.owner}/${repo.name}.`);
+                    const createChoice = await selectWithBack({
+                        message: "What would you like to do?",
+                        choices: [
+                            { value: "create", name: "Create a new project" },
+                            { value: "skip", name: "Skip project integration for now" },
+                        ],
+                        showBack: true,
+                    });
+                    if (createChoice === BACK_VALUE) {
+                        currentStep = "githubIssues";
+                        break;
+                    }
+                    if (createChoice === "skip") {
+                        state.projectEnabled = false;
+                        currentStep = "scopes";
+                        break;
+                    }
+                    // Ask for project name
+                    const defaultProjectName = `${repo.name} Board`;
+                    const projectName = await inputWithBack({
+                        message: "Project name:",
+                        default: defaultProjectName,
+                        showBack: true,
+                    });
+                    if (projectName === BACK_VALUE) {
+                        // Go back to the create/skip choice - stay on this step
+                        break;
+                    }
+                    // Create and link a new project
+                    console.log(`\nCreating project "${projectName}"...`);
+                    const newProject = createAndLinkProject(repo, projectName);
+                    if (newProject) {
+                        console.log(`✓ Created and linked project #${newProject.number}\n`);
+                        state.projectEnabled = true;
+                        state.projectNumber = newProject.number;
+                    }
+                    else {
+                        console.log("⚠ Failed to create project. Skipping project integration.");
+                        state.projectEnabled = false;
+                    }
+                    currentStep = "scopes";
+                    break;
                 }
-                else {
-                    checklist.push(item.trim());
+                case "scopes": {
+                    const result = await selectWithBack({
+                        message: "How would you like to configure commit scopes?",
+                        choices: [
+                            { value: "defaults", name: "Use defaults (core, ui, api, config, deps, ci)" },
+                            { value: "custom", name: "Define custom scopes" },
+                            { value: "skip", name: "Skip - configure later" },
+                        ],
+                        default: state.scopeChoice || undefined,
+                        showBack: true,
+                    });
+                    if (result === BACK_VALUE) {
+                        // Go back to appropriate step based on config
+                        if (state.preset === "simple") {
+                            currentStep = "preset";
+                        }
+                        else if (state.useGitHubIssues) {
+                            currentStep = "projectSetup";
+                        }
+                        else {
+                            currentStep = "githubIssues";
+                        }
+                    }
+                    else {
+                        state.scopeChoice = result;
+                        state.scopes = [];
+                        if (result === "defaults") {
+                            state.scopes = [
+                                { value: "core", description: "Core functionality" },
+                                { value: "ui", description: "UI components" },
+                                { value: "api", description: "API layer" },
+                                { value: "config", description: "Configuration" },
+                                { value: "deps", description: "Dependencies" },
+                                { value: "ci", description: "CI/CD" },
+                            ];
+                            currentStep = "checklist";
+                        }
+                        else if (result === "custom") {
+                            console.log("\nAdd scopes one at a time. Press Enter with empty name to finish.\n");
+                            let addingScopes = true;
+                            while (addingScopes) {
+                                const scopeValue = await input({
+                                    message: `Scope name${state.scopes.length > 0 ? " (blank to finish)" : ""}:`,
+                                });
+                                if (!scopeValue.trim()) {
+                                    addingScopes = false;
+                                }
+                                else {
+                                    const description = await input({
+                                        message: `Description for "${scopeValue.trim()}":`,
+                                    });
+                                    state.scopes.push({
+                                        value: scopeValue.trim().toLowerCase(),
+                                        description: description.trim() || scopeValue.trim(),
+                                    });
+                                }
+                            }
+                            currentStep = "checklist";
+                        }
+                        else {
+                            currentStep = "checklist";
+                        }
+                    }
+                    break;
+                }
+                case "checklist": {
+                    const result = await selectWithBack({
+                        message: "PR checklist items (shown in pull request descriptions):",
+                        choices: [
+                            {
+                                value: "defaults",
+                                name: `Use defaults (${DEFAULT_CHECKLIST.length} items: conventions, self-review, no warnings)`,
+                            },
+                            { value: "custom", name: "Define custom checklist" },
+                            { value: "skip", name: "Skip - no checklist" },
+                        ],
+                        default: state.checklistChoice || undefined,
+                        showBack: true,
+                    });
+                    if (result === BACK_VALUE) {
+                        currentStep = "scopes";
+                    }
+                    else {
+                        state.checklistChoice = result;
+                        if (result === "custom") {
+                            console.log("\nAdd checklist items one at a time. Press Enter with empty text to finish.\n");
+                            state.checklist = [];
+                            let addingChecklist = true;
+                            while (addingChecklist) {
+                                const item = await input({
+                                    message: `Checklist item${state.checklist.length > 0 ? " (blank to finish)" : ""}:`,
+                                });
+                                if (!item.trim()) {
+                                    if (state.checklist.length === 0) {
+                                        state.checklist = [...DEFAULT_CHECKLIST];
+                                        console.log("Using default checklist.");
+                                    }
+                                    addingChecklist = false;
+                                }
+                                else {
+                                    state.checklist.push(item.trim());
+                                }
+                            }
+                        }
+                        else if (result === "skip") {
+                            state.checklist = [];
+                        }
+                        else {
+                            state.checklist = [...DEFAULT_CHECKLIST];
+                        }
+                        currentStep = "formats";
+                    }
+                    break;
                 }
+                case "formats": {
+                    const result = await confirmWithBack({
+                        message: "Customize branch/commit formats? (advanced)",
+                        default: state.customizeFormats,
+                        showBack: true,
+                    });
+                    if (result === BACK_VALUE) {
+                        currentStep = "checklist";
+                    }
+                    else {
+                        state.customizeFormats = result === true;
+                        if (state.customizeFormats) {
+                            console.log("\nAvailable placeholders:");
+                            console.log("  Branch: {type}, {ticket}, {description}");
+                            console.log("  Commit: {type}, {ticket}, {scope}, {message}, {breaking}\n");
+                            const branchResult = await inputWithBack({
+                                message: "Branch format:",
+                                default: state.branchFormat,
+                                showBack: true,
+                            });
+                            if (branchResult === BACK_VALUE) {
+                                // Stay on formats step
+                                break;
+                            }
+                            state.branchFormat = branchResult;
+                            const commitResult = await inputWithBack({
+                                message: "Commit format:",
+                                default: state.commitFormat,
+                                showBack: true,
+                            });
+                            if (commitResult === BACK_VALUE) {
+                                // Stay on formats step
+                                break;
+                            }
+                            state.commitFormat = commitResult;
+                        }
+                        currentStep = "done";
+                    }
+                    break;
+                }
+                default:
+                    currentStep = "done";
             }
         }
-        else if (checklistChoice === "skip") {
-            checklist = [];
-        }
-        // 4. Format customization
-        let branchFormat = presetConfig.branchFormat;
-        let commitFormat = "{type}[{ticket}]{breaking}({scope}): {message}";
-        const customizeFormats = await confirm({
-            message: "Customize branch/commit formats? (advanced)",
-            default: false,
-        });
-        if (customizeFormats) {
-            console.log("\nAvailable placeholders:");
-            console.log("  Branch: {type}, {ticket}, {description}");
-            console.log("  Commit: {type}, {ticket}, {scope}, {message}, {breaking}\n");
-            branchFormat = await input({
-                message: "Branch format:",
-                default: branchFormat,
-            });
-            commitFormat = await input({
-                message: "Commit format:",
-                default: commitFormat,
-            });
-        }
+        // Extract configuration from state
+        const preset = state.preset;
+        const presetConfig = PRESETS[preset];
+        const ticketBaseUrl = state.ticketBaseUrl;
+        const useGitHubIssues = state.useGitHubIssues;
+        const scopes = state.scopes;
+        const checklist = state.checklist;
+        const branchFormat = state.branchFormat || presetConfig.branchFormat;
+        const commitFormat = state.commitFormat;
         // 5. Commitlint setup (validates commit messages on git commit)
         const commitlintChoice = await select({
             message: "Set up commitlint? (rejects commits that don't match the format)",
@@ -416,6 +749,19 @@ devflow amend           # If you need to add more changes
         if (useGitHubIssues) {
             config.ticketProvider = { type: "github" };
         }
+        if (state.projectEnabled && state.projectNumber) {
+            config.project = {
+                enabled: true,
+                number: state.projectNumber,
+                statusField: "Status",
+                statuses: {
+                    todo: "Todo",
+                    inProgress: "In Progress",
+                    inReview: "In Review",
+                    done: "Done",
+                },
+            };
+        }
         if (preset === "custom") {
             config.issueTypes = presetConfig.issueTypes;
             config.prTemplate = presetConfig.prTemplate;