@thiagodiogo/pscode 2.3.0 → 2.5.0

package/dist/core/templates/workflows/propose.js

@@ -64,12 +64,52 @@ When ready to implement, run /ps:apply
 
    Os artefatos gerados a partir do Passo 2 SHALL refletir esse entendimento refinado.
 
+1c. **PR Integration — abrir PR draft no início (opcional)**
+
+   Use the **Read tool** (NOT a shell command) to read \`pscode/config.yaml\` from the current working directory.
+   If the Read tool returns an error (file not found), or \`pr.enabled\` is not \`true\`, **skip this step entirely** — no PR, no branch, no checkpoint commits — and continue to Step 2. Opening the PR is then left to \`/ps:apply\`. Set \`PR_OPENED = false\`.
+
+   **If \`pscode/config.yaml\` exists and \`pr.enabled: true\`:**
+
+   Ask **once**, using the **AskUserQuestion tool**, whether to open the draft PR now:
+   > "Quer abrir o Pull Request em DRAFT agora? O PR nasce em draft e cresce junto com o refinamento."
+   > - ✅ Sim, abrir o PR draft agora (Recomendada)
+   > - ❌ Não, deixar para o apply
+
+   **If the user declines (Não):** continue the normal flow from Step 2 without any PR steps. Do NOT create a branch or commit automatically. The PR will be opened later by \`/ps:apply\`. Set \`PR_OPENED = false\`.
+
+   **If the user accepts (Sim):** proceed **without asking for any further authorization**:
+   1. Resolve the branch name from \`pr.branch.pattern\`, substituting \`{change-name}\` with the change name, \`{type}\` with feat/fix/chore (infer from the change; default \`feat\`), and \`{ticket}\` with the ticket ID if available.
+   2. Create and switch to the branch: \`git checkout -b <branch>\`.
+   3. Create the change scaffold (this is Step 2): \`pscode new change "<name>"\`.
+   4. Stage and commit the scaffold: \`git add -A && git commit -m "chore(<name>): scaffold change"\`.
+   5. Push and set upstream: \`git push -u origin <branch>\`.
+   6. Open the PR in **DRAFT**, deriving the title from \`pr.title.template\` and the body from \`pr.description.template\` (substitute \`{change-name}\`/\`{type}\`/\`{ticket}\`):
+      \`gh pr create --draft --title "<resolved title>" --body "<resolved description>"\`.
+   7. Capture the PR URL from the \`gh\` output, save it as \`prUrl\`, and set \`PR_OPENED = true\`.
+
+   **Comentário do link no tracker:** after the PR is opened, if \`pr.comments.linkInTask: true\` and a Trello \`cardId\` exists, comment the PR link on the card:
+   \`\`\`tool
+   mcp__claude_ai_Trello_Custom__add_comment
+     card_id: "<cardId>"
+     text: |
+       🔀 Pull Request (DRAFT) aberto: <prUrl>
+   \`\`\`
+   The \`cardId\` is resolved in Step 3 — if it is not available yet when the PR is opened, post this comment right after Step 3 instead.
+
+   **Tratamento de falha (não-bloqueante):** if \`gh\` or \`git\` fails — \`gh\` not installed, not authenticated, or no GitHub remote — **do NOT block**:
+   - Clearly state what failed and how to fix it (e.g., "instale o \`gh\` CLI", "rode \`gh auth login\`", "configure um remote GitHub").
+   - Ask whether the user wants the agent to resolve it in parallel (e.g., run \`gh auth login\`).
+   - **Continue the propose flow regardless.** Any branch already created and local commits are preserved; set \`PR_OPENED = true\` only if the PR was actually opened.
+
 2. **Create the change directory**
    \`\`\`bash
    pscode new change "<name>"
    \`\`\`
    This creates a scaffolded change in the planning home resolved by the CLI with \`.pscode.yaml\`.
 
+   **If you already created the change scaffold in Step 1c** (PR accepted), skip this step — the change directory already exists.
+
 3. **Trello Integration (optional)**
 
    Use the **Read tool** (NOT a shell command) to read \`pscode/trello.yaml\` from the current working directory.
@@ -190,6 +230,14 @@ When ready to implement, run /ps:apply
    pscode status --change "<name>"
    \`\`\`
 
+7. **Checkpoint commit — após gerar os artefatos (only if \`PR_OPENED = true\`)**
+
+   If a draft PR was opened in Step 1c, commit and push the generated artifacts as a checkpoint so the PR reflects the refined plan:
+   \`\`\`bash
+   git add -A && git commit -m "docs(<name>): add planning artifacts" && git push
+   \`\`\`
+   If \`PR_OPENED = false\`, skip — no automatic commits. Failures here are non-blocking (same handling as Step 1c).
+
 ---
 
 ## Refinement Validation Loop
@@ -334,7 +382,14 @@ ${applyNextStep}
    - Changes to technical approach → update \`design.md\`
    - Changes to tasks → update \`tasks.md\`
 
-3. **Go back to Step R1** and show the updated refinement summary, then **re-run Step R1b**
+3. **Checkpoint commit — após o ajuste (only if \`PR_OPENED = true\`)**:
+   If a draft PR was opened in Step 1c, commit and push the adjusted artifacts as a checkpoint:
+   \`\`\`bash
+   git add -A && git commit -m "docs(<name>): refine plan" && git push
+   \`\`\`
+   If \`PR_OPENED = false\`, skip. Failures here are non-blocking (same handling as Step 1c).
+
+4. **Go back to Step R1** and show the updated refinement summary, then **re-run Step R1b**
    so the Trello card description and comment reflect the adjusted plan before asking again.
    Keep looping until the user approves or cancels.
 

package/dist/core/update.d.ts

@@ -38,26 +38,6 @@ export declare class UpdateCommand {
      * Displays a note about extra workflows installed that aren't in the active profile.
      */
     private displayExtraWorkflowsNote;
-    /**
-     * Removes skill directories for workflows when delivery changed to commands-only.
-     * Returns the number of directories removed.
-     */
-    private removeSkillDirs;
-    /**
-     * Removes skill directories for workflows that are no longer selected in the active profile.
-     * Returns the number of directories removed.
-     */
-    private removeUnselectedSkillDirs;
-    /**
-     * Removes command files for workflows when delivery changed to skills-only.
-     * Returns the number of files removed.
-     */
-    private removeCommandFiles;
-    /**
-     * Removes command files for workflows that are no longer selected in the active profile.
-     * Returns the number of files removed.
-     */
-    private removeUnselectedCommandFiles;
     /**
      * Detect and handle legacy Pscode artifacts.
      * Unlike init, update warns but continues if legacy files found in non-interactive mode.

package/dist/core/update.js

@@ -7,19 +7,18 @@
 import path from 'path';
 import chalk from 'chalk';
 import ora from 'ora';
-import * as fs from 'fs';
 import { createRequire } from 'module';
 import { FileSystemUtils } from '../utils/file-system.js';
 import { transformToHyphenCommands } from '../utils/command-references.js';
 import { AI_TOOLS, PSCODE_DIR_NAME } from './config.js';
 import { generateCommands, CommandAdapterRegistry, } from './command-generation/index.js';
-import { getToolVersionStatus, getSkillTemplates, getCommandContents, generateSkillContent, getToolsWithSkillsDir, } from './shared/index.js';
+import { getToolVersionStatus, getSkillTemplates, getCommandContents, generateSkillContent, getToolsWithSkillsDir, pruneOrphans, pruneOrphansForTool, } from './shared/index.js';
 import { detectLegacyArtifacts, cleanupLegacyArtifacts, formatCleanupSummary, formatDetectionSummary, getToolsFromLegacyArtifacts, } from './legacy-cleanup.js';
 import { isInteractive } from '../utils/interactive.js';
 import { getGlobalConfig } from './global-config.js';
-import { getProfileWorkflows, isValidProfile, DEFAULT_PROFILE, ALL_WORKFLOWS } from './profiles.js';
+import { getProfileWorkflows, isValidProfile, DEFAULT_PROFILE } from './profiles.js';
 import { getAvailableTools } from './available-tools.js';
-import { WORKFLOW_TO_SKILL_DIR, getCommandConfiguredTools, getConfiguredToolsForProfileSync, getToolsNeedingProfileSync, } from './profile-sync-drift.js';
+import { getCommandConfiguredTools, getConfiguredToolsForProfileSync, getToolsNeedingProfileSync, } from './profile-sync-drift.js';
 import { scanInstalledWorkflows as scanInstalledWorkflowsShared, migrateIfNeeded as migrateIfNeededShared, } from './migration.js';
 const require = createRequire(import.meta.url);
 const { version: PSCODE_VERSION } = require('../../package.json');
@@ -91,6 +90,15 @@ export class UpdateCommand {
         if (!this.force && toolsToUpdateSet.size === 0) {
             // All tools are up to date
             this.displayUpToDateMessage(toolStatuses);
+            // Even when up to date, prune orphan artifacts (e.g. skills/commands of
+            // workflows deleted or renamed in a previous version) by filesystem scan.
+            const pruned = pruneOrphans(resolvedProjectPath, configuredTools, desiredWorkflows, delivery);
+            if (pruned.removedSkillDirs > 0) {
+                console.log(chalk.dim(`Removed: ${pruned.removedSkillDirs} orphan skill directories`));
+            }
+            if (pruned.removedCommandFiles > 0) {
+                console.log(chalk.dim(`Removed: ${pruned.removedCommandFiles} orphan command files`));
+            }
             // Still check for new tool directories and extra workflows
             this.detectNewTools(resolvedProjectPath, configuredTools);
             this.displayExtraWorkflowsNote(resolvedProjectPath, configuredTools, desiredWorkflows);
@@ -132,11 +140,6 @@ export class UpdateCommand {
                         const skillContent = generateSkillContent(template, PSCODE_VERSION, transformer);
                         await FileSystemUtils.writeFile(skillFile, skillContent);
                     }
-                    removedDeselectedSkillCount += await this.removeUnselectedSkillDirs(skillsDir, desiredWorkflows);
-                }
-                // Delete skill directories if delivery is commands-only
-                if (!shouldGenerateSkills) {
-                    removedSkillCount += await this.removeSkillDirs(skillsDir);
                 }
                 // Generate commands if delivery includes commands
                 if (shouldGenerateCommands) {
@@ -147,12 +150,23 @@ export class UpdateCommand {
                             const commandFile = path.isAbsolute(cmd.path) ? cmd.path : path.join(resolvedProjectPath, cmd.path);
                             await FileSystemUtils.writeFile(commandFile, cmd.fileContent);
                         }
-                        removedDeselectedCommandCount += await this.removeUnselectedCommandFiles(resolvedProjectPath, toolId, desiredWorkflows);
                     }
                 }
-                // Delete command files if delivery is skills-only
-                if (!shouldGenerateCommands) {
-                    removedCommandCount += await this.removeCommandFiles(resolvedProjectPath, toolId);
+                // Prune by filesystem scan: remove any Pscode-managed skill dir or
+                // command file that is not desired for the active profile/delivery —
+                // including orphans of workflows deleted or renamed in the enum.
+                const pruned = pruneOrphansForTool(resolvedProjectPath, toolId, desiredWorkflows, delivery);
+                if (shouldGenerateSkills) {
+                    removedDeselectedSkillCount += pruned.removedSkillDirs;
+                }
+                else {
+                    removedSkillCount += pruned.removedSkillDirs;
+                }
+                if (shouldGenerateCommands) {
+                    removedDeselectedCommandCount += pruned.removedCommandFiles;
+                }
+                else {
+                    removedCommandCount += pruned.removedCommandFiles;
                 }
                 spinner.succeed(`Updated ${tool.name}`);
                 updatedTools.push(tool.name);
@@ -189,9 +203,9 @@ export class UpdateCommand {
         if (newlyConfiguredTools.length > 0) {
             console.log();
             console.log(chalk.bold('Getting started:'));
-            console.log('  /ps:new       Start a new change');
-            console.log('  /ps:continue  Create the next artifact');
+            console.log('  /ps:propose   Propose a new change');
             console.log('  /ps:apply     Implement tasks');
+            console.log('  /ps:complete  Finalize and archive a change');
             console.log();
             console.log(`Learn more: ${chalk.cyan('https://github.com/thiagodiogo/Pscode')}`);
         }
@@ -263,106 +277,6 @@ export class UpdateCommand {
             console.log(chalk.dim(`Note: ${extraWorkflows.length} extra workflows not in profile (use \`pscode config profile\` to switch profiles)`));
         }
     }
-    /**
-     * Removes skill directories for workflows when delivery changed to commands-only.
-     * Returns the number of directories removed.
-     */
-    async removeSkillDirs(skillsDir) {
-        let removed = 0;
-        for (const workflow of ALL_WORKFLOWS) {
-            const dirName = WORKFLOW_TO_SKILL_DIR[workflow];
-            if (!dirName)
-                continue;
-            const skillDir = path.join(skillsDir, dirName);
-            try {
-                if (fs.existsSync(skillDir)) {
-                    await fs.promises.rm(skillDir, { recursive: true, force: true });
-                    removed++;
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return removed;
-    }
-    /**
-     * Removes skill directories for workflows that are no longer selected in the active profile.
-     * Returns the number of directories removed.
-     */
-    async removeUnselectedSkillDirs(skillsDir, desiredWorkflows) {
-        const desiredSet = new Set(desiredWorkflows);
-        let removed = 0;
-        for (const workflow of ALL_WORKFLOWS) {
-            if (desiredSet.has(workflow))
-                continue;
-            const dirName = WORKFLOW_TO_SKILL_DIR[workflow];
-            if (!dirName)
-                continue;
-            const skillDir = path.join(skillsDir, dirName);
-            try {
-                if (fs.existsSync(skillDir)) {
-                    await fs.promises.rm(skillDir, { recursive: true, force: true });
-                    removed++;
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return removed;
-    }
-    /**
-     * Removes command files for workflows when delivery changed to skills-only.
-     * Returns the number of files removed.
-     */
-    async removeCommandFiles(projectPath, toolId) {
-        let removed = 0;
-        const adapter = CommandAdapterRegistry.get(toolId);
-        if (!adapter)
-            return 0;
-        for (const workflow of ALL_WORKFLOWS) {
-            const cmdPath = adapter.getFilePath(workflow);
-            const fullPath = path.isAbsolute(cmdPath) ? cmdPath : path.join(projectPath, cmdPath);
-            try {
-                if (fs.existsSync(fullPath)) {
-                    await fs.promises.unlink(fullPath);
-                    removed++;
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return removed;
-    }
-    /**
-     * Removes command files for workflows that are no longer selected in the active profile.
-     * Returns the number of files removed.
-     */
-    async removeUnselectedCommandFiles(projectPath, toolId, desiredWorkflows) {
-        let removed = 0;
-        const adapter = CommandAdapterRegistry.get(toolId);
-        if (!adapter)
-            return 0;
-        const desiredSet = new Set(desiredWorkflows);
-        for (const workflow of ALL_WORKFLOWS) {
-            if (desiredSet.has(workflow))
-                continue;
-            const cmdPath = adapter.getFilePath(workflow);
-            const fullPath = path.isAbsolute(cmdPath) ? cmdPath : path.join(projectPath, cmdPath);
-            try {
-                if (fs.existsSync(fullPath)) {
-                    await fs.promises.unlink(fullPath);
-                    removed++;
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return removed;
-    }
     /**
      * Detect and handle legacy Pscode artifacts.
      * Unlike init, update warns but continues if legacy files found in non-interactive mode.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thiagodiogo/pscode",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "pscode",

package/dist/core/templates/workflows/bulk-archive-change.d.ts

@@ -1,10 +0,0 @@
-/**
- * Skill Template Workflow Modules
- *
- * This file is generated by splitting the legacy monolithic
- * templates file into workflow-focused modules.
- */
-import type { SkillTemplate, CommandTemplate } from '../types.js';
-export declare function getBulkArchiveChangeSkillTemplate(): SkillTemplate;
-export declare function getPsBulkArchiveCommandTemplate(): CommandTemplate;
-//# sourceMappingURL=bulk-archive-change.d.ts.map