@thiagodiogo/pastelsdd 1.0.0-beta.2 → 1.0.0-beta.3

package/README.md

@@ -1,142 +1,142 @@
-# pastelsdd
-
-> Spec-driven, AI-native development workflow CLI
-
-[![npm](https://img.shields.io/npm/v/@thiagodiogo/pastelsdd)](https://www.npmjs.com/package/@thiagodiogo/pastelsdd)
-[![license](https://img.shields.io/npm/l/@thiagodiogo/pastelsdd)](LICENSE)
-[![node](https://img.shields.io/node/v/@thiagodiogo/pastelsdd)](https://nodejs.org)
-
-Pastelsdd installs a planning pipeline inside your repo. Every feature goes through **proposal → specs → design → tasks → apply**, tracked as versioned files and exposed as slash commands to your AI agent.
-
----
-
-## Requirements
-
-- Node.js `>= 20.19.0`
-- At least one supported AI tool: **Claude Code**, **Cursor**, **Gemini CLI**, **GitHub Copilot**, or **Codex CLI**
-
----
-
-## Install
-
-```bash
-npm install -g @thiagodiogo/pastelsdd
-# or
-pnpm add -g @thiagodiogo/pastelsdd
-```
-
----
-
-## Quick Start
-
-```bash
-cd your-project
-pastelsdd init
-```
-
-The init wizard auto-detects which AI tools you have (`.claude/`, `.cursor/`, etc.), installs skill files and slash commands, and creates the planning folder:
-
-```
-pastelsdd/
-├── changes/        ← one subfolder per active change
-│   └── archive/    ← completed changes
-├── specs/          ← project capability specs
-└── config.yaml     ← local schema config
-```
-
-Once initialized, use slash commands in your AI agent:
-
-```
-/pastel:propose "add dark mode"   ← creates a new change
-/pastel:continue                  ← advances to the next artifact
-/pastel:apply                     ← applies pending tasks
-/pastel:archive                   ← archives a completed change
-```
-
----
-
-## How It Works
-
-Each change lives in `pastelsdd/changes/<name>/` and follows a DAG of artifacts defined by a workflow schema:
-
-```
-pastelsdd/changes/dark-mode/
-├── proposal.md    ← why this change
-├── specs/         ← what the system must do
-├── design.md      ← how to implement it
-└── tasks.md       ← implementation checklist
-```
-
-The AI agent reads these files at each step and generates the next artifact using enriched instructions from the schema.
-
----
-
-## CLI Reference
-
-| Command | Description |
-|---------|-------------|
-| `pastelsdd init [path]` | Initialize Pastelsdd in a project |
-| `pastelsdd update [path]` | Regenerate skill/command files after an upgrade |
-| `pastelsdd list` | List active changes |
-| `pastelsdd list --specs` | List project specs |
-| `pastelsdd status` | Show artifact completion for the current change |
-| `pastelsdd instructions [artifact]` | Print enriched instructions for an artifact |
-| `pastelsdd validate [name]` | Validate a change or spec |
-| `pastelsdd validate --all` | Validate everything |
-| `pastelsdd show [name]` | Display a change or spec |
-| `pastelsdd archive [name]` | Archive a completed change |
-| `pastelsdd new change <name>` | Create a new change directory |
-| `pastelsdd schemas` | List available workflow schemas |
-| `pastelsdd view` | Interactive dashboard |
-| `pastelsdd feedback <message>` | Submit feedback |
-| `pastelsdd completion install` | Install shell completions |
-
-### `init` options
-
-| Flag | Description |
-|------|-------------|
-| `--tools <list>` | Skip interactive selection. Use `all`, `none`, or e.g. `claude,cursor` |
-| `--force` | Skip all confirmations (CI-friendly) |
-| `--profile <name>` | Workflow profile: `core` (default) or `custom` |
-
-**Non-interactive example:**
-
-```bash
-pastelsdd init --tools claude --force
-```
-
----
-
-## Supported AI Tools
-
-| Tool | Skills dir |
-|------|-----------|
-| Claude Code | `.claude/` |
-| Codex CLI | `.codex/` |
-| Cursor | `.cursor/` |
-| Gemini CLI | `.gemini/` |
-| GitHub Copilot | `.github/` |
-
----
-
-## Migrating from OpenSpec
-
-If your project used the old `openspec` tool, `pastelsdd init` detects `.openspec/` automatically and offers to migrate your changes and specs — no manual steps needed.
-
----
-
-## After Upgrading
-
-Re-run `pastelsdd init` (or `pastelsdd update`) to regenerate skill files with the latest instructions:
-
-```bash
-pastelsdd update
-```
-
----
-
-## Links
-
-- [npm](https://www.npmjs.com/package/@thiagodiogo/pastelsdd)
-- [Repository](https://github.com/thiagodiogo/pastelsdd)
-- [Issues / Feedback](https://github.com/thiagodiogo/pastelsdd/issues)
+# pastelsdd
+
+> Spec-driven, AI-native development workflow CLI
+
+[![npm](https://img.shields.io/npm/v/@thiagodiogo/pastelsdd)](https://www.npmjs.com/package/@thiagodiogo/pastelsdd)
+[![license](https://img.shields.io/npm/l/@thiagodiogo/pastelsdd)](LICENSE)
+[![node](https://img.shields.io/node/v/@thiagodiogo/pastelsdd)](https://nodejs.org)
+
+Pastelsdd installs a planning pipeline inside your repo. Every feature goes through **proposal → specs → design → tasks → apply**, tracked as versioned files and exposed as slash commands to your AI agent.
+
+---
+
+## Requirements
+
+- Node.js `>= 20.19.0`
+- At least one supported AI tool: **Claude Code**, **Cursor**, **Gemini CLI**, **GitHub Copilot**, or **Codex CLI**
+
+---
+
+## Install
+
+```bash
+npm install -g @thiagodiogo/pastelsdd
+# or
+pnpm add -g @thiagodiogo/pastelsdd
+```
+
+---
+
+## Quick Start
+
+```bash
+cd your-project
+pastelsdd init
+```
+
+The init wizard auto-detects which AI tools you have (`.claude/`, `.cursor/`, etc.), installs skill files and slash commands, and creates the planning folder:
+
+```
+pastelsdd/
+├── changes/        ← one subfolder per active change
+│   └── archive/    ← completed changes
+├── specs/          ← project capability specs
+└── config.yaml     ← local schema config
+```
+
+Once initialized, use slash commands in your AI agent:
+
+```
+/pstl:propose "add dark mode"   ← creates a new change
+/pstl:continue                  ← advances to the next artifact
+/pstl:apply                     ← applies pending tasks
+/pstl:archive                   ← archives a completed change
+```
+
+---
+
+## How It Works
+
+Each change lives in `pastelsdd/changes/<name>/` and follows a DAG of artifacts defined by a workflow schema:
+
+```
+pastelsdd/changes/dark-mode/
+├── proposal.md    ← why this change
+├── specs/         ← what the system must do
+├── design.md      ← how to implement it
+└── tasks.md       ← implementation checklist
+```
+
+The AI agent reads these files at each step and generates the next artifact using enriched instructions from the schema.
+
+---
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `pastelsdd init [path]` | Initialize Pastelsdd in a project |
+| `pastelsdd update [path]` | Regenerate skill/command files after an upgrade |
+| `pastelsdd list` | List active changes |
+| `pastelsdd list --specs` | List project specs |
+| `pastelsdd status` | Show artifact completion for the current change |
+| `pastelsdd instructions [artifact]` | Print enriched instructions for an artifact |
+| `pastelsdd validate [name]` | Validate a change or spec |
+| `pastelsdd validate --all` | Validate everything |
+| `pastelsdd show [name]` | Display a change or spec |
+| `pastelsdd archive [name]` | Archive a completed change |
+| `pastelsdd new change <name>` | Create a new change directory |
+| `pastelsdd schemas` | List available workflow schemas |
+| `pastelsdd view` | Interactive dashboard |
+| `pastelsdd feedback <message>` | Submit feedback |
+| `pastelsdd completion install` | Install shell completions |
+
+### `init` options
+
+| Flag | Description |
+|------|-------------|
+| `--tools <list>` | Skip interactive selection. Use `all`, `none`, or e.g. `claude,cursor` |
+| `--force` | Skip all confirmations (CI-friendly) |
+| `--profile <name>` | Workflow profile: `core` (default) or `custom` |
+
+**Non-interactive example:**
+
+```bash
+pastelsdd init --tools claude --force
+```
+
+---
+
+## Supported AI Tools
+
+| Tool | Skills dir |
+|------|-----------|
+| Claude Code | `.claude/` |
+| Codex CLI | `.codex/` |
+| Cursor | `.cursor/` |
+| Gemini CLI | `.gemini/` |
+| GitHub Copilot | `.github/` |
+
+---
+
+## Migrating from OpenSpec
+
+If your project used the old `openspec` tool, `pastelsdd init` detects `.openspec/` automatically and offers to migrate your changes and specs — no manual steps needed.
+
+---
+
+## After Upgrading
+
+Re-run `pastelsdd init` (or `pastelsdd update`) to regenerate skill files with the latest instructions:
+
+```bash
+pastelsdd update
+```
+
+---
+
+## Links
+
+- [npm](https://www.npmjs.com/package/@thiagodiogo/pastelsdd)
+- [Repository](https://github.com/eipastel/pastelsdd)
+- [Issues / Feedback](https://github.com/eipastel/pastelsdd/issues)

package/dist/core/command-generation/adapters/claude.d.ts

@@ -6,7 +6,7 @@
 import type { ToolCommandAdapter } from '../types.js';
 /**
  * Claude Code adapter for command generation.
- * File path: .claude/commands/pastel/<id>.md
+ * File path: .claude/commands/pstl/<id>.md
  * Frontmatter: name, description, category, tags
  */
 export declare const claudeAdapter: ToolCommandAdapter;

package/dist/core/command-generation/adapters/claude.js

@@ -27,13 +27,13 @@ function formatTagsArray(tags) {
 }
 /**
  * Claude Code adapter for command generation.
- * File path: .claude/commands/pastel/<id>.md
+ * File path: .claude/commands/pstl/<id>.md
  * Frontmatter: name, description, category, tags
  */
 export const claudeAdapter = {
     toolId: 'claude',
     getFilePath(commandId) {
-        return path.join('.claude', 'commands', 'pastel', `${commandId}.md`);
+        return path.join('.claude', 'commands', 'pstl', `${commandId}.md`);
     },
     formatFile(content) {
         return `---

package/dist/core/command-generation/adapters/codex.d.ts

@@ -9,7 +9,7 @@
 import type { ToolCommandAdapter } from '../types.js';
 /**
  * Codex adapter for command generation.
- * File path: <CODEX_HOME>/prompts/pastel-<id>.md (absolute, global)
+ * File path: <CODEX_HOME>/prompts/pstl-<id>.md (absolute, global)
  * Frontmatter: description, argument-hint
  */
 export declare const codexAdapter: ToolCommandAdapter;

package/dist/core/command-generation/adapters/codex.js

@@ -18,13 +18,13 @@ function getCodexHome() {
 }
 /**
  * Codex adapter for command generation.
- * File path: <CODEX_HOME>/prompts/pastel-<id>.md (absolute, global)
+ * File path: <CODEX_HOME>/prompts/pstl-<id>.md (absolute, global)
  * Frontmatter: description, argument-hint
  */
 export const codexAdapter = {
     toolId: 'codex',
     getFilePath(commandId) {
-        return path.join(getCodexHome(), 'prompts', `pastel-${commandId}.md`);
+        return path.join(getCodexHome(), 'prompts', `pstl-${commandId}.md`);
     },
     formatFile(content) {
         return `---

package/dist/core/command-generation/adapters/cursor.d.ts

@@ -7,8 +7,8 @@
 import type { ToolCommandAdapter } from '../types.js';
 /**
  * Cursor adapter for command generation.
- * File path: .cursor/commands/pastel-<id>.md
- * Frontmatter: name (as /pastel-<id>), id, category, description
+ * File path: .cursor/commands/pstl-<id>.md
+ * Frontmatter: name (as /pstl-<id>), id, category, description
  */
 export declare const cursorAdapter: ToolCommandAdapter;
 //# sourceMappingURL=cursor.d.ts.map

package/dist/core/command-generation/adapters/cursor.js

@@ -21,18 +21,18 @@ function escapeYamlValue(value) {
 }
 /**
  * Cursor adapter for command generation.
- * File path: .cursor/commands/pastel-<id>.md
- * Frontmatter: name (as /pastel-<id>), id, category, description
+ * File path: .cursor/commands/pstl-<id>.md
+ * Frontmatter: name (as /pstl-<id>), id, category, description
  */
 export const cursorAdapter = {
     toolId: 'cursor',
     getFilePath(commandId) {
-        return path.join('.cursor', 'commands', `pastel-${commandId}.md`);
+        return path.join('.cursor', 'commands', `pstl-${commandId}.md`);
     },
     formatFile(content) {
         return `---
-name: /pastel-${content.id}
-id: pastel-${content.id}
+name: /pstl-${content.id}
+id: pstl-${content.id}
 category: ${escapeYamlValue(content.category)}
 description: ${escapeYamlValue(content.description)}
 ---

package/dist/core/command-generation/adapters/gemini.d.ts

@@ -6,7 +6,7 @@
 import type { ToolCommandAdapter } from '../types.js';
 /**
  * Gemini adapter for command generation.
- * File path: .gemini/commands/pastel/<id>.toml
+ * File path: .gemini/commands/pstl/<id>.toml
  * Format: TOML with description and prompt fields
  */
 export declare const geminiAdapter: ToolCommandAdapter;

package/dist/core/command-generation/adapters/gemini.js

@@ -6,13 +6,13 @@
 import path from 'path';
 /**
  * Gemini adapter for command generation.
- * File path: .gemini/commands/pastel/<id>.toml
+ * File path: .gemini/commands/pstl/<id>.toml
  * Format: TOML with description and prompt fields
  */
 export const geminiAdapter = {
     toolId: 'gemini',
     getFilePath(commandId) {
-        return path.join('.gemini', 'commands', 'pastel', `${commandId}.toml`);
+        return path.join('.gemini', 'commands', 'pstl', `${commandId}.toml`);
     },
     formatFile(content) {
         return `description = "${content.description}"

package/dist/core/command-generation/adapters/github-copilot.d.ts

@@ -6,7 +6,7 @@
 import type { ToolCommandAdapter } from '../types.js';
 /**
  * GitHub Copilot adapter for command generation.
- * File path: .github/prompts/pastel-<id>.prompt.md
+ * File path: .github/prompts/pstl-<id>.prompt.md
  * Frontmatter: description
  */
 export declare const githubCopilotAdapter: ToolCommandAdapter;

package/dist/core/command-generation/adapters/github-copilot.js

@@ -6,13 +6,13 @@
 import path from 'path';
 /**
  * GitHub Copilot adapter for command generation.
- * File path: .github/prompts/pastel-<id>.prompt.md
+ * File path: .github/prompts/pstl-<id>.prompt.md
  * Frontmatter: description
  */
 export const githubCopilotAdapter = {
     toolId: 'github-copilot',
     getFilePath(commandId) {
-        return path.join('.github', 'prompts', `pastel-${commandId}.prompt.md`);
+        return path.join('.github', 'prompts', `pstl-${commandId}.prompt.md`);
     },
     formatFile(content) {
         return `---

package/dist/core/command-generation/types.d.ts

@@ -33,7 +33,7 @@ export interface ToolCommandAdapter {
     /**
      * Returns the file path for a command.
      * @param commandId - The command identifier (e.g., 'explore')
-     * @returns Path from project root (e.g., '.claude/commands/pastel/explore.md').
+     * @returns Path from project root (e.g., '.claude/commands/pstl/explore.md').
      *          May be absolute for tools with global-scoped prompts (e.g., Codex).
      */
     getFilePath(commandId: string): string;

package/dist/core/init.d.ts

@@ -1,7 +1,7 @@
 /**
  * Init Command
  *
- * Sets up Pastelsdd with Agent Skills and /pastel:* slash commands.
+ * Sets up Pastelsdd with Agent Skills and /pstl:* slash commands.
  * This is the unified setup command that replaces both the old init and experimental commands.
  */
 type InitCommandOptions = {
@@ -20,8 +20,8 @@ export declare class InitCommand {
     private validate;
     private canPromptInteractively;
     private resolveProfileOverride;
-    private handleOpenspecMigration;
-    private performOpenspecMigration;
+    private handleLegacyToolMigration;
+    private performLegacyToolMigration;
     private handleLegacyCleanup;
     private performLegacyCleanup;
     private getSelectedTools;

package/dist/core/init.js

@@ -1,7 +1,7 @@
 /**
  * Init Command
  *
- * Sets up Pastelsdd with Agent Skills and /pastel:* slash commands.
+ * Sets up Pastelsdd with Agent Skills and /pstl:* slash commands.
  * This is the unified setup command that replaces both the old init and experimental commands.
  */
 import path from 'path';
@@ -17,7 +17,7 @@ import { isInteractive } from '../utils/interactive.js';
 import { serializeConfig } from './config-prompts.js';
 import { generateCommands, CommandAdapterRegistry, } from './command-generation/index.js';
 import { detectLegacyArtifacts, cleanupLegacyArtifacts, formatCleanupSummary, formatDetectionSummary, } from './legacy-cleanup.js';
-import { detectOpenspecArtifacts, migrateFromOpenspec, formatOpenspecDetectionSummary, formatOpenspecMigrationSummary, pastelsddDirExists, } from './openspec-migration.js';
+import { detectLegacyToolArtifacts, runLegacyToolMigration, formatLegacyToolDetectionSummary, formatLegacyToolMigrationSummary, pastelsddDirExists, } from './openspec-migration.js';
 import { runTrelloInitPrompt } from './trello-init-prompt.js';
 import { getToolsWithSkillsDir, getToolStates, getSkillTemplates, getCommandContents, generateSkillContent, } from './shared/index.js';
 import { getGlobalConfig } from './global-config.js';
@@ -70,8 +70,8 @@ export class InitCommand {
         const pastelsddPath = path.join(projectPath, pastelsddDir);
         // Validation happens silently in the background
         const extendMode = await this.validate(projectPath, pastelsddPath);
-        // Check for openspec migration first (before legacy cleanup)
-        await this.handleOpenspecMigration(projectPath);
+        // Check for legacy tool migration first (before legacy cleanup)
+        await this.handleLegacyToolMigration(projectPath);
         // Check for legacy artifacts and handle cleanup
         await this.handleLegacyCleanup(projectPath, extendMode);
         // Detect available tools in the project (task 7.1)
@@ -134,29 +134,29 @@ export class InitCommand {
         throw new Error(`Invalid profile "${this.profileOverride}". Available profiles: core, custom`);
     }
     // ═══════════════════════════════════════════════════════════
-    // OPENSPEC MIGRATION
+    // LEGACY TOOL MIGRATION
     // ═══════════════════════════════════════════════════════════
-    async handleOpenspecMigration(projectPath) {
-        const detection = await detectOpenspecArtifacts(projectPath);
-        if (!detection.hasOpenspecArtifacts) {
+    async handleLegacyToolMigration(projectPath) {
+        const detection = await detectLegacyToolArtifacts(projectPath);
+        if (!detection.hasLegacyArtifacts) {
             return;
         }
         // Determine whether pastelsdd/ already exists so we can show the right summary
         const alreadyExists = await pastelsddDirExists(projectPath);
         console.log();
-        console.log(formatOpenspecDetectionSummary(detection, alreadyExists));
+        console.log(formatLegacyToolDetectionSummary(detection, alreadyExists));
         console.log();
         const canPrompt = this.canPromptInteractively();
         if (this.force || !canPrompt) {
             // Non-interactive or --force: migrate automatically
-            await this.performOpenspecMigration(projectPath, detection);
+            await this.performLegacyToolMigration(projectPath, detection);
             return;
         }
         const { confirm } = await import('@inquirer/prompts');
-        const dirName = detection.openspecDirName;
+        const dirName = detection.legacyDirName;
         const migrateLabel = alreadyExists
             ? `Merge ${dirName}/ into pastelsdd/ and complete the migration?`
-            : `Migrate this project from OpenSpec to Pastelsdd?`;
+            : `Migrate this project from the legacy tool to Pastelsdd?`;
         const shouldMigrate = await confirm({
             message: migrateLabel,
             default: true,
@@ -165,13 +165,13 @@ export class InitCommand {
             console.log(chalk.dim('Migration cancelled. Re-run with --force to skip this prompt.'));
             process.exit(0);
         }
-        await this.performOpenspecMigration(projectPath, detection);
+        await this.performLegacyToolMigration(projectPath, detection);
     }
-    async performOpenspecMigration(projectPath, detection) {
-        const spinner = ora('Migrating from OpenSpec...').start();
-        const result = await migrateFromOpenspec(projectPath, detection);
-        spinner.succeed('OpenSpec migration complete');
-        const summary = formatOpenspecMigrationSummary(result);
+    async performLegacyToolMigration(projectPath, detection) {
+        const spinner = ora('Migrating from legacy tool...').start();
+        const result = await runLegacyToolMigration(projectPath, detection);
+        spinner.succeed('Migration to Pastelsdd complete');
+        const summary = formatLegacyToolMigrationSummary(result);
         if (summary) {
             console.log();
             console.log(summary);
@@ -435,7 +435,7 @@ export class InitCommand {
         const delivery = globalConfig.delivery ?? 'both';
         const profileWorkflows = getProfileWorkflows(profile, globalConfig.workflows);
         // Trello workflows are always generated regardless of profile, so users can
-        // run /pastel:trello-setup to configure the integration at any time.
+        // run /pstl:trello-setup to configure the integration at any time.
         const TRELLO_WORKFLOWS = ['trello-setup', 'task', 'draft'];
         const workflowsSet = new Set([...profileWorkflows, ...TRELLO_WORKFLOWS]);
         const workflows = [...workflowsSet];
@@ -598,11 +598,11 @@ export class InitCommand {
         console.log();
         if (activeWorkflows.includes('propose')) {
             console.log(chalk.bold('Getting started:'));
-            console.log('  Start your first change: /pastel:propose "your idea"');
+            console.log('  Start your first change: /pstl:propose "your idea"');
         }
         else if (activeWorkflows.includes('new')) {
             console.log(chalk.bold('Getting started:'));
-            console.log('  Start your first change: /pastel:new "your idea"');
+            console.log('  Start your first change: /pstl:new "your idea"');
         }
         else {
             console.log("Done. Run 'pastelsdd config profile' to configure your workflows.");
@@ -612,7 +612,7 @@ export class InitCommand {
             console.log();
             console.log(chalk.bold('Trello Integration'));
             console.log(`  Preferences saved to ${chalk.cyan('pastelsdd/trello.yaml')}`);
-            console.log(`  Run ${chalk.cyan('/pastel:trello-setup')} in Claude Code to connect your Trello lists.`);
+            console.log(`  Run ${chalk.cyan('/pstl:trello-setup')} in Claude Code to connect your Trello lists.`);
         }
         // Links
         console.log();

package/dist/core/legacy-cleanup.js

@@ -306,7 +306,7 @@ export function formatCleanupSummary(result) {
             lines.push(`  ✓ Removed ${file}`);
         }
         for (const dir of result.deletedDirs) {
-            lines.push(`  ✓ Removed ${dir}/ (replaced by /pastel:*)`);
+            lines.push(`  ✓ Removed ${dir}/ (replaced by /pstl:*)`);
         }
         for (const file of result.modifiedFiles) {
             lines.push(`  ✓ Removed Pastelsdd markers from ${file}`);

package/dist/core/migration.js

@@ -103,6 +103,6 @@ export function migrateIfNeeded(projectPath, tools) {
     }
     saveGlobalConfig(config);
     console.log(`Migrated: custom profile with ${installedWorkflows.length} workflows`);
-    console.log("New in this version: /pastel:propose. Try 'pastelsdd config profile core' for the streamlined experience.");
+    console.log("New in this version: /pstl:propose. Try 'pastelsdd config profile core' for the streamlined experience.");
 }
 //# sourceMappingURL=migration.js.map