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

package/README.md

@@ -1,3 +1,142 @@
-# pastelsdd
-
-> Work in progress.
+# 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/bin/pastelsdd.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { runCli } from '../dist/cli/index.js';
 

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/adapters/index.d.ts

@@ -3,30 +3,9 @@
  *
  * Re-exports all tool command adapters.
  */
-export { amazonQAdapter } from './amazon-q.js';
-export { antigravityAdapter } from './antigravity.js';
-export { auggieAdapter } from './auggie.js';
-export { bobAdapter } from './bob.js';
 export { claudeAdapter } from './claude.js';
-export { clineAdapter } from './cline.js';
 export { codexAdapter } from './codex.js';
-export { codebuddyAdapter } from './codebuddy.js';
-export { continueAdapter } from './continue.js';
-export { costrictAdapter } from './costrict.js';
-export { crushAdapter } from './crush.js';
 export { cursorAdapter } from './cursor.js';
-export { factoryAdapter } from './factory.js';
 export { geminiAdapter } from './gemini.js';
 export { githubCopilotAdapter } from './github-copilot.js';
-export { iflowAdapter } from './iflow.js';
-export { junieAdapter } from './junie.js';
-export { kilocodeAdapter } from './kilocode.js';
-export { kiroAdapter } from './kiro.js';
-export { opencodeAdapter } from './opencode.js';
-export { piAdapter } from './pi.js';
-export { qoderAdapter } from './qoder.js';
-export { lingmaAdapter } from './lingma.js';
-export { qwenAdapter } from './qwen.js';
-export { roocodeAdapter } from './roocode.js';
-export { windsurfAdapter } from './windsurf.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -3,30 +3,9 @@
  *
  * Re-exports all tool command adapters.
  */
-export { amazonQAdapter } from './amazon-q.js';
-export { antigravityAdapter } from './antigravity.js';
-export { auggieAdapter } from './auggie.js';
-export { bobAdapter } from './bob.js';
 export { claudeAdapter } from './claude.js';
-export { clineAdapter } from './cline.js';
 export { codexAdapter } from './codex.js';
-export { codebuddyAdapter } from './codebuddy.js';
-export { continueAdapter } from './continue.js';
-export { costrictAdapter } from './costrict.js';
-export { crushAdapter } from './crush.js';
 export { cursorAdapter } from './cursor.js';
-export { factoryAdapter } from './factory.js';
 export { geminiAdapter } from './gemini.js';
 export { githubCopilotAdapter } from './github-copilot.js';
-export { iflowAdapter } from './iflow.js';
-export { junieAdapter } from './junie.js';
-export { kilocodeAdapter } from './kilocode.js';
-export { kiroAdapter } from './kiro.js';
-export { opencodeAdapter } from './opencode.js';
-export { piAdapter } from './pi.js';
-export { qoderAdapter } from './qoder.js';
-export { lingmaAdapter } from './lingma.js';
-export { qwenAdapter } from './qwen.js';
-export { roocodeAdapter } from './roocode.js';
-export { windsurfAdapter } from './windsurf.js';
 //# sourceMappingURL=index.js.map

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

@@ -18,5 +18,5 @@
 export type { CommandContent, ToolCommandAdapter, GeneratedCommand, } from './types.js';
 export { CommandAdapterRegistry } from './registry.js';
 export { generateCommand, generateCommands } from './generator.js';
-export { claudeAdapter, cursorAdapter, windsurfAdapter } from './adapters/index.js';
+export { claudeAdapter, codexAdapter, cursorAdapter, geminiAdapter, githubCopilotAdapter } from './adapters/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/command-generation/index.js

@@ -20,5 +20,5 @@ export { CommandAdapterRegistry } from './registry.js';
 // Generator functions
 export { generateCommand, generateCommands } from './generator.js';
 // Adapters (for direct access if needed)
-export { claudeAdapter, cursorAdapter, windsurfAdapter } from './adapters/index.js';
+export { claudeAdapter, codexAdapter, cursorAdapter, geminiAdapter, githubCopilotAdapter } from './adapters/index.js';
 //# sourceMappingURL=index.js.map

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

@@ -2,7 +2,6 @@
  * Command Adapter Registry
  *
  * Centralized registry for tool command adapters.
- * Similar pattern to existing SlashCommandRegistry in the codebase.
  */
 import type { ToolCommandAdapter } from './types.js';
 /**

package/dist/core/command-generation/registry.js

@@ -2,34 +2,12 @@
  * Command Adapter Registry
  *
  * Centralized registry for tool command adapters.
- * Similar pattern to existing SlashCommandRegistry in the codebase.
  */
-import { amazonQAdapter } from './adapters/amazon-q.js';
-import { antigravityAdapter } from './adapters/antigravity.js';
-import { auggieAdapter } from './adapters/auggie.js';
-import { bobAdapter } from './adapters/bob.js';
 import { claudeAdapter } from './adapters/claude.js';
-import { clineAdapter } from './adapters/cline.js';
 import { codexAdapter } from './adapters/codex.js';
-import { codebuddyAdapter } from './adapters/codebuddy.js';
-import { continueAdapter } from './adapters/continue.js';
-import { costrictAdapter } from './adapters/costrict.js';
-import { crushAdapter } from './adapters/crush.js';
 import { cursorAdapter } from './adapters/cursor.js';
-import { factoryAdapter } from './adapters/factory.js';
 import { geminiAdapter } from './adapters/gemini.js';
 import { githubCopilotAdapter } from './adapters/github-copilot.js';
-import { iflowAdapter } from './adapters/iflow.js';
-import { junieAdapter } from './adapters/junie.js';
-import { kilocodeAdapter } from './adapters/kilocode.js';
-import { kiroAdapter } from './adapters/kiro.js';
-import { opencodeAdapter } from './adapters/opencode.js';
-import { piAdapter } from './adapters/pi.js';
-import { qoderAdapter } from './adapters/qoder.js';
-import { lingmaAdapter } from './adapters/lingma.js';
-import { qwenAdapter } from './adapters/qwen.js';
-import { roocodeAdapter } from './adapters/roocode.js';
-import { windsurfAdapter } from './adapters/windsurf.js';
 /**
  * Registry for looking up tool command adapters.
  */
@@ -37,32 +15,11 @@ export class CommandAdapterRegistry {
     static adapters = new Map();
     // Static initializer - register built-in adapters
     static {
-        CommandAdapterRegistry.register(amazonQAdapter);
-        CommandAdapterRegistry.register(antigravityAdapter);
-        CommandAdapterRegistry.register(auggieAdapter);
-        CommandAdapterRegistry.register(bobAdapter);
         CommandAdapterRegistry.register(claudeAdapter);
-        CommandAdapterRegistry.register(clineAdapter);
         CommandAdapterRegistry.register(codexAdapter);
-        CommandAdapterRegistry.register(codebuddyAdapter);
-        CommandAdapterRegistry.register(continueAdapter);
-        CommandAdapterRegistry.register(costrictAdapter);
-        CommandAdapterRegistry.register(crushAdapter);
         CommandAdapterRegistry.register(cursorAdapter);
-        CommandAdapterRegistry.register(factoryAdapter);
         CommandAdapterRegistry.register(geminiAdapter);
         CommandAdapterRegistry.register(githubCopilotAdapter);
-        CommandAdapterRegistry.register(iflowAdapter);
-        CommandAdapterRegistry.register(junieAdapter);
-        CommandAdapterRegistry.register(kilocodeAdapter);
-        CommandAdapterRegistry.register(kiroAdapter);
-        CommandAdapterRegistry.register(opencodeAdapter);
-        CommandAdapterRegistry.register(piAdapter);
-        CommandAdapterRegistry.register(qoderAdapter);
-        CommandAdapterRegistry.register(lingmaAdapter);
-        CommandAdapterRegistry.register(qwenAdapter);
-        CommandAdapterRegistry.register(roocodeAdapter);
-        CommandAdapterRegistry.register(windsurfAdapter);
     }
     /**
      * Register a tool command adapter.

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/config.js

@@ -4,35 +4,10 @@ export const PASTELSDD_MARKERS = {
     end: '<!-- PASTELSDD:END -->'
 };
 export const AI_TOOLS = [
-    { name: 'Amazon Q Developer', value: 'amazon-q', available: true, successLabel: 'Amazon Q Developer', skillsDir: '.amazonq' },
-    { name: 'Antigravity', value: 'antigravity', available: true, successLabel: 'Antigravity', skillsDir: '.agent' },
-    { name: 'Auggie (Augment CLI)', value: 'auggie', available: true, successLabel: 'Auggie', skillsDir: '.augment' },
-    { name: 'Bob Shell', value: 'bob', available: true, successLabel: 'Bob Shell', skillsDir: '.bob' },
     { name: 'Claude Code', value: 'claude', available: true, successLabel: 'Claude Code', skillsDir: '.claude' },
-    { name: 'Cline', value: 'cline', available: true, successLabel: 'Cline', skillsDir: '.cline' },
     { name: 'Codex', value: 'codex', available: true, successLabel: 'Codex', skillsDir: '.codex' },
-    { name: 'ForgeCode', value: 'forgecode', available: true, successLabel: 'ForgeCode', skillsDir: '.forge' },
-    { name: 'CodeBuddy Code (CLI)', value: 'codebuddy', available: true, successLabel: 'CodeBuddy Code', skillsDir: '.codebuddy' },
-    { name: 'Continue', value: 'continue', available: true, successLabel: 'Continue (VS Code / JetBrains / Cli)', skillsDir: '.continue' },
-    { name: 'CoStrict', value: 'costrict', available: true, successLabel: 'CoStrict', skillsDir: '.cospec' },
-    { name: 'Crush', value: 'crush', available: true, successLabel: 'Crush', skillsDir: '.crush' },
     { name: 'Cursor', value: 'cursor', available: true, successLabel: 'Cursor', skillsDir: '.cursor' },
-    { name: 'Factory Droid', value: 'factory', available: true, successLabel: 'Factory Droid', skillsDir: '.factory' },
     { name: 'Gemini CLI', value: 'gemini', available: true, successLabel: 'Gemini CLI', skillsDir: '.gemini' },
     { name: 'GitHub Copilot', value: 'github-copilot', available: true, successLabel: 'GitHub Copilot', skillsDir: '.github', detectionPaths: ['.github/copilot-instructions.md', '.github/instructions', '.github/workflows/copilot-setup-steps.yml', '.github/prompts', '.github/agents', '.github/skills', '.github/.mcp.json'] },
-    { name: 'iFlow', value: 'iflow', available: true, successLabel: 'iFlow', skillsDir: '.iflow' },
-    { name: 'Junie', value: 'junie', available: true, successLabel: 'Junie', skillsDir: '.junie' },
-    { name: 'Kilo Code', value: 'kilocode', available: true, successLabel: 'Kilo Code', skillsDir: '.kilocode' },
-    { name: 'Kimi CLI', value: 'kimi', available: true, successLabel: 'Kimi CLI', skillsDir: '.kimi' },
-    { name: 'Kiro', value: 'kiro', available: true, successLabel: 'Kiro', skillsDir: '.kiro' },
-    { name: 'OpenCode', value: 'opencode', available: true, successLabel: 'OpenCode', skillsDir: '.opencode' },
-    { name: 'Pi', value: 'pi', available: true, successLabel: 'Pi', skillsDir: '.pi' },
-    { name: 'Qoder', value: 'qoder', available: true, successLabel: 'Qoder', skillsDir: '.qoder' },
-    { name: 'Lingma', value: 'lingma', available: true, successLabel: 'Lingma', skillsDir: '.lingma' },
-    { name: 'Qwen Code', value: 'qwen', available: true, successLabel: 'Qwen Code', skillsDir: '.qwen' },
-    { name: 'RooCode', value: 'roocode', available: true, successLabel: 'RooCode', skillsDir: '.roo' },
-    { name: 'Trae', value: 'trae', available: true, successLabel: 'Trae', skillsDir: '.trae' },
-    { name: 'Windsurf', value: 'windsurf', available: true, successLabel: 'Windsurf', skillsDir: '.windsurf' },
-    { name: 'AGENTS.md (works with Amp, VS Code, …)', value: 'agents', available: false, successLabel: 'your AGENTS.md-compatible assistant' }
 ];
 //# sourceMappingURL=config.js.map

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,11 +20,14 @@ export declare class InitCommand {
     private validate;
     private canPromptInteractively;
     private resolveProfileOverride;
+    private handleLegacyToolMigration;
+    private performLegacyToolMigration;
     private handleLegacyCleanup;
     private performLegacyCleanup;
     private getSelectedTools;
     private resolveToolsArg;
     private validateTools;
+    private handleTrelloSetup;
     private createDirectoryStructure;
     private generateSkillsAndCommands;
     private createConfig;