@intoinside/praxis 1.0.1

package/src/commands/init.ts

@@ -0,0 +1,47 @@
+import fs from 'fs';
+import path from 'path';
+
+export async function initCommand() {
+    const rootDir = process.cwd();
+    const praxisDir = path.join(rootDir, '.praxis');
+    const templatesDir = path.join(praxisDir, 'templates');
+    const intentsDir = path.join(praxisDir, 'intents');
+    const intentsWipDir = path.join(praxisDir, 'intents', 'wip');
+    const intentsArchiveDir = path.join(praxisDir, 'intents', 'archive');
+    const specsDir = path.join(praxisDir, 'specs');
+
+    const dirs = [praxisDir, templatesDir, intentsDir, intentsWipDir, intentsArchiveDir, specsDir];
+
+    for (const dir of dirs) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+            console.log(`Created directory: ${path.relative(rootDir, dir)}`);
+
+            // Create a .gitkeep file to ensure the directory is tracked by git
+            fs.writeFileSync(path.join(dir, '.gitkeep'), '');
+        } else {
+            console.log(`Directory already exists: ${path.relative(rootDir, dir)}`);
+        }
+    }
+
+    // Copy templates from root templates/ to .praxis/templates/
+    const sourceTemplatesDir = path.join(rootDir, 'templates');
+    if (fs.existsSync(sourceTemplatesDir)) {
+        console.log('\nCopying templates...');
+        const templateFiles = fs.readdirSync(sourceTemplatesDir);
+        for (const file of templateFiles) {
+            const sourcePath = path.join(sourceTemplatesDir, file);
+            const targetPath = path.join(templatesDir, file);
+
+            if (fs.statSync(sourcePath).isFile()) {
+                fs.copyFileSync(sourcePath, targetPath);
+                console.log(`- Copied: ${file}`);
+            }
+        }
+    } else {
+        console.log('\nNo source templates directory found at root. Skipping template copy.');
+    }
+
+    console.log('\nPraxis project structure initialized successfully!');
+    console.log('You can now start defining intents in .praxis/intents/wip/');
+}

package/src/commands/integration/generate.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Action for 'praxis integration generate-slash-commands <tool>'
+ */
+export declare function generateSlashCommandsAction(toolId: string): Promise<void>;

package/src/commands/integration/generate.js

@@ -0,0 +1,69 @@
+import fs from 'fs';
+import path from 'path';
+import { manifest } from '../../manifest.js';
+import { CommandAdapterRegistry } from '../../core/command-generation/index.js';
+import { generateCommand } from '../../core/command-generation/generator.js';
+/**
+ * Action for 'praxis integration generate-slash-commands <tool>'
+ */
+export async function generateSlashCommandsAction(toolId) {
+    const adapter = CommandAdapterRegistry.get(toolId);
+    if (!adapter) {
+        console.error(`Error: Adapter for tool '${toolId}' not found.`);
+        console.log(`Available tools: ${CommandAdapterRegistry.getAll().map(a => a.toolId).join(', ')}`);
+        return;
+    }
+    console.log(`Generating slash commands for tool: ${toolId}...`);
+    const contents = flattenCommands(manifest);
+    let count = 0;
+    for (const content of contents) {
+        const generated = generateCommand(content, adapter);
+        const fullPath = path.join(process.cwd(), generated.path);
+        // Ensure directory exists
+        const dir = path.dirname(fullPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(fullPath, generated.fileContent);
+        console.log(`- Generated: ${generated.path}`);
+        count++;
+    }
+    console.log(`\nSuccess! ${count} slash commands generated.`);
+}
+/**
+ * Flattens the command manifest into a tool-agnostic CommandContent array.
+ */
+function flattenCommands(commands, parentName) {
+    let result = [];
+    for (const cmd of commands) {
+        const fullName = parentName ? `${parentName} ${cmd.name}` : cmd.name;
+        const id = fullName.replace(/\s+/g, '-');
+        if (cmd.subcommands) {
+            result = result.concat(flattenCommands(cmd.subcommands, fullName));
+        }
+        else {
+            // It's a runnable leaf command
+            result.push({
+                id: id,
+                name: `Praxis ${fullName}`,
+                description: cmd.description,
+                category: 'Praxis',
+                tags: ['praxis', cmd.name],
+                body: generateBody(fullName, cmd)
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Generates the body content for a command workflow.
+ */
+function generateBody(fullName, cmd) {
+    const args = cmd.arguments ? cmd.arguments.map(arg => `"$${arg.name}"`).join(' ') : '';
+    const cliCommand = `node --loader ts-node/esm src/index.ts ${fullName} ${args}`.trim();
+    let body = `To execute this Praxis command, run:\n\n// turbo\n${cliCommand}\n`;
+    if (fullName === 'intent create') {
+        body += `\nOnce the command is executed, follow the prompt generated in the output to complete the intent document with the AI.`;
+    }
+    return body;
+}

package/src/commands/integration/generate.ts

@@ -0,0 +1,85 @@
+import fs from 'fs';
+import path from 'path';
+import { manifest, type CommandDefinition } from '../../manifest.js';
+import { CommandAdapterRegistry } from '../../core/command-generation/index.js';
+import { generateCommand } from '../../core/command-generation/generator.js';
+import type { CommandContent } from '../../core/command-generation/types.js';
+
+/**
+ * Action for 'praxis integration generate-slash-commands <tool>'
+ */
+export async function generateSlashCommandsAction(toolId: string) {
+    const adapter = CommandAdapterRegistry.get(toolId);
+
+    if (!adapter) {
+        console.error(`Error: Adapter for tool '${toolId}' not found.`);
+        console.log(`Available tools: ${CommandAdapterRegistry.getAll().map(a => a.toolId).join(', ')}`);
+        return;
+    }
+
+    console.log(`Generating slash commands for tool: ${toolId}...`);
+
+    const contents = flattenCommands(manifest);
+    let count = 0;
+
+    for (const content of contents) {
+        const generated = generateCommand(content, adapter);
+        const fullPath = path.join(process.cwd(), generated.path);
+
+        // Ensure directory exists
+        const dir = path.dirname(fullPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+
+        fs.writeFileSync(fullPath, generated.fileContent);
+        console.log(`- Generated: ${generated.path}`);
+        count++;
+    }
+
+    console.log(`\nSuccess! ${count} slash commands generated.`);
+}
+
+/**
+ * Flattens the command manifest into a tool-agnostic CommandContent array.
+ */
+function flattenCommands(commands: CommandDefinition[], parentName?: string): CommandContent[] {
+    let result: CommandContent[] = [];
+
+    for (const cmd of commands) {
+        const fullName = parentName ? `${parentName} ${cmd.name}` : cmd.name;
+        const id = fullName.replace(/\s+/g, '-');
+
+        if (cmd.subcommands) {
+            result = result.concat(flattenCommands(cmd.subcommands, fullName));
+        } else {
+            // It's a runnable leaf command
+            result.push({
+                id: id,
+                name: `Praxis ${fullName}`,
+                description: cmd.description,
+                category: 'Praxis',
+                tags: ['praxis', cmd.name],
+                body: generateBody(fullName, cmd)
+            });
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Generates the body content for a command workflow.
+ */
+function generateBody(fullName: string, cmd: CommandDefinition): string {
+    const args = cmd.arguments ? cmd.arguments.map(arg => `"$${arg.name}"`).join(' ') : '';
+    const cliCommand = `node --loader ts-node/esm src/index.ts ${fullName} ${args}`.trim();
+
+    let body = `To execute this Praxis command, run:\n\n// turbo\n${cliCommand}\n`;
+
+    if (fullName === 'intent create') {
+        body += `\nOnce the command is executed, follow the prompt generated in the output to complete the intent document with the AI.`;
+    }
+
+    return body;
+}

package/src/commands/intent/create.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Action for 'praxis intent create <intent-description>'
+ */
+export declare function intentCreateAction(description: string): Promise<void>;

package/src/commands/intent/create.js

@@ -0,0 +1,55 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Action for 'praxis intent create <intent-description>'
+ */
+export async function intentCreateAction(description) {
+    const rootDir = process.cwd();
+    const templatePath = path.join(rootDir, '.praxis', 'templates', 'intent-template.md');
+    if (!fs.existsSync(templatePath)) {
+        console.error(`Error: Template not found at ${templatePath}`);
+        console.error('Please run `praxis init` first to initialize the project structure.');
+        return;
+    }
+    const templateContent = fs.readFileSync(templatePath, 'utf8');
+    // Generate and display the AI prompt
+    const prompt = generateAiPrompt(description, templateContent);
+    console.log('\n--- IDE AI CHAT PROMPT ---');
+    console.log('Copy and paste the following into your IDE chat to complete the intent:');
+    console.log('--------------------------');
+    console.log(prompt);
+    console.log('--------------------------\n');
+}
+/**
+ * Generate a prompt for the AI to complete the intent definition.
+ */
+function generateAiPrompt(description, templateContent) {
+    return `You are an expert product manager and software architect.
+I need to create a new Intent in my Praxis project for the following feature:
+"${description}"
+
+Please perform the following actions:
+
+1. **Analyze** the request to understand the core intent.
+2. **Generate a Short ID**: Create a representative, kebab-case identifier for this intent. 
+   - It MUST be concise (max 20 characters).
+   - Example: "user-login", "export-pdf", "dark-mode".
+3. **Create the Intent File**:
+   - Create a new directory: \`.praxis/intents/wip/<your-generated-id>/\`
+   - Create a new file: \`.praxis/intents/wip/<your-generated-id>/intent.md\`
+4. **Fill the Template**:
+   - Use the template content provided below.
+   - Smartly fill in ALL placeholders (like [FEATURE NAME], [DATE], etc.) based on the user's description.
+   - Write at least one draft User Story based on the description.
+   - Define initial Functional Requirements.
+   - Set the Status to "Draft".
+   - Keep the language used for the intent description.
+   
+Here is the template content to use:
+
+\`\`\`markdown
+${templateContent}
+\`\`\`
+
+Now, please generate the file creation tool call and the filled content.`;
+}

package/src/commands/intent/create.ts

@@ -0,0 +1,61 @@
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Action for 'praxis intent create <intent-description>'
+ */
+export async function intentCreateAction(description: string) {
+    const rootDir = process.cwd();
+    const templatePath = path.join(rootDir, '.praxis', 'templates', 'intent-template.md');
+
+    if (!fs.existsSync(templatePath)) {
+        console.error(`Error: Template not found at ${templatePath}`);
+        console.error('Please run `praxis init` first to initialize the project structure.');
+        return;
+    }
+
+    const templateContent = fs.readFileSync(templatePath, 'utf8');
+
+    // Generate and display the AI prompt
+    const prompt = generateAiPrompt(description, templateContent);
+
+    console.log('\n--- IDE AI CHAT PROMPT ---');
+    console.log('Copy and paste the following into your IDE chat to complete the intent:');
+    console.log('--------------------------');
+    console.log(prompt);
+    console.log('--------------------------\n');
+}
+
+/**
+ * Generate a prompt for the AI to complete the intent definition.
+ */
+function generateAiPrompt(description: string, templateContent: string): string {
+    return `You are an expert product manager and software architect.
+I need to create a new Intent in my Praxis project for the following feature:
+"${description}"
+
+Please perform the following actions:
+
+1. **Analyze** the request to understand the core intent.
+2. **Generate a Short ID**: Create a representative, kebab-case identifier for this intent. 
+   - It MUST be concise (max 20 characters).
+   - Example: "user-login", "export-pdf", "dark-mode".
+3. **Create the Intent File**:
+   - Create a new directory: \`.praxis/intents/wip/<your-generated-id>/\`
+   - Create a new file: \`.praxis/intents/wip/<your-generated-id>/intent.md\`
+4. **Fill the Template**:
+   - Use the template content provided below.
+   - Smartly fill in ALL placeholders (like [FEATURE NAME], [DATE], etc.) based on the user's description.
+   - Write at least one draft User Story based on the description.
+   - Define initial Functional Requirements.
+   - Set the Status to "Draft".
+   - Keep the language used for the intent description.
+   
+Here is the template content to use:
+
+\`\`\`markdown
+${templateContent}
+\`\`\`
+
+Now, please generate the file creation tool call and the filled content.`;
+}

package/src/commands/intent/list.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Action for 'praxis intent list'
+ */
+export declare function intentListAction(): Promise<void>;

package/src/commands/intent/list.js

@@ -0,0 +1,52 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Action for 'praxis intent list'
+ */
+export async function intentListAction() {
+    const rootDir = process.cwd();
+    const intentsDir = path.join(rootDir, '.praxis', 'intents');
+    if (!fs.existsSync(intentsDir)) {
+        console.log('No intents found (directory .praxis/intents does not exist).');
+        return;
+    }
+    const intentFiles = findAllIntentFiles(intentsDir);
+    if (intentFiles.length === 0) {
+        console.log('No intents found.');
+        return;
+    }
+    // Print header
+    console.log('%-25s %-15s %s', 'ID', 'Status', 'Created');
+    console.log('-'.repeat(60));
+    for (const file of intentFiles) {
+        const content = fs.readFileSync(file, 'utf8');
+        const id = path.basename(path.dirname(file));
+        // Parse metadata using simple regex
+        const statusMatch = content.match(/\*\*Status\*\*:\s*(.+)/);
+        const createdMatch = content.match(/\*\*Created\*\*:\s*(.+)/);
+        const status = statusMatch ? statusMatch[1].trim() : 'Unknown';
+        const created = createdMatch ? createdMatch[1].trim() : 'Unknown';
+        // Simple column formatting
+        console.log(`${id.padEnd(25)} ${status.padEnd(15)} ${created}`);
+    }
+}
+function findAllIntentFiles(dir) {
+    let results = [];
+    try {
+        const list = fs.readdirSync(dir);
+        for (const file of list) {
+            const filePath = path.join(dir, file);
+            const stat = fs.statSync(filePath);
+            if (stat.isDirectory()) {
+                results = results.concat(findAllIntentFiles(filePath));
+            }
+            else if (file === 'intent.md') {
+                results.push(filePath);
+            }
+        }
+    }
+    catch (e) {
+        console.error(`Error reading directory ${dir}:`, e);
+    }
+    return results;
+}

package/src/commands/intent/list.ts

@@ -0,0 +1,63 @@
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Action for 'praxis intent list'
+ */
+export async function intentListAction() {
+    const rootDir = process.cwd();
+    const intentsDir = path.join(rootDir, '.praxis', 'intents');
+
+    if (!fs.existsSync(intentsDir)) {
+        console.log('No intents found (directory .praxis/intents does not exist).');
+        return;
+    }
+
+    const intentFiles = findAllIntentFiles(intentsDir);
+
+    if (intentFiles.length === 0) {
+        console.log('No intents found.');
+        return;
+    }
+
+    // Print header
+    console.log('%-25s %-15s %s', 'ID', 'Status', 'Created');
+    console.log('-'.repeat(60));
+
+    for (const file of intentFiles) {
+        const content = fs.readFileSync(file, 'utf8');
+        const id = path.basename(path.dirname(file));
+
+        // Parse metadata using simple regex
+        const statusMatch = content.match(/\*\*Status\*\*:\s*(.+)/);
+        const createdMatch = content.match(/\*\*Created\*\*:\s*(.+)/);
+
+        const status = statusMatch ? statusMatch[1].trim() : 'Unknown';
+        const created = createdMatch ? createdMatch[1].trim() : 'Unknown';
+
+        // Simple column formatting
+        console.log(`${id.padEnd(25)} ${status.padEnd(15)} ${created}`);
+    }
+}
+
+function findAllIntentFiles(dir: string): string[] {
+    let results: string[] = [];
+    try {
+        const list = fs.readdirSync(dir);
+
+        for (const file of list) {
+            const filePath = path.join(dir, file);
+            const stat = fs.statSync(filePath);
+
+            if (stat.isDirectory()) {
+                results = results.concat(findAllIntentFiles(filePath));
+            } else if (file === 'intent.md') {
+                results.push(filePath);
+            }
+        }
+    } catch (e) {
+        console.error(`Error reading directory ${dir}:`, e);
+    }
+
+    return results;
+}

package/src/commands/spec/apply.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Action for 'praxis spec apply <spec-id>'
+ */
+export declare function specApplyAction(specId: string): Promise<void>;

package/src/commands/spec/apply.js

@@ -0,0 +1,99 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Action for 'praxis spec apply <spec-id>'
+ */
+export async function specApplyAction(specId) {
+    const rootDir = process.cwd();
+    const specsDir = path.join(rootDir, '.praxis', 'specs');
+    // 1. Validate environment
+    if (!fs.existsSync(specsDir)) {
+        // As requested: "Se la spec specificata con l'id non esiste, il comando non deve fare niente."
+        return;
+    }
+    // 2. Find spec directory
+    const specDir = findSpecDirectory(specsDir, specId);
+    if (!specDir) {
+        // As requested: "Se la spec specificata con l'id non esiste, il comando non deve fare niente."
+        return;
+    }
+    // 3. Collect artifacts
+    const specFile = path.join(specDir, 'spec.md');
+    let specContent = '';
+    if (fs.existsSync(specFile)) {
+        specContent = fs.readFileSync(specFile, 'utf8');
+    }
+    const otherArtifacts = [];
+    const files = fs.readdirSync(specDir);
+    for (const file of files) {
+        if (file === 'spec.md' || file === '.gitkeep')
+            continue;
+        const filePath = path.join(specDir, file);
+        if (fs.statSync(filePath).isFile()) {
+            otherArtifacts.push({
+                name: file,
+                content: fs.readFileSync(filePath, 'utf8')
+            });
+        }
+    }
+    // 4. Generate Prompt
+    const prompt = generateApplyPrompt(specId, specContent, otherArtifacts);
+    // 5. Output
+    console.log('\n--- IDE AI CHAT PROMPT ---');
+    console.log('Copy and paste the following into your IDE chat to implement the specification:');
+    console.log('--------------------------');
+    console.log(prompt);
+    console.log('--------------------------\n');
+}
+function findSpecDirectory(dir, targetId) {
+    try {
+        const list = fs.readdirSync(dir);
+        // Check if direct match exists
+        const directPath = path.join(dir, targetId);
+        if (fs.existsSync(directPath) && fs.statSync(directPath).isDirectory()) {
+            if (fs.existsSync(path.join(directPath, 'spec.md'))) {
+                return directPath;
+            }
+        }
+        // Recursive search
+        for (const file of list) {
+            const filePath = path.join(dir, file);
+            const stat = fs.statSync(filePath);
+            if (stat.isDirectory()) {
+                if (file === targetId) {
+                    if (fs.existsSync(path.join(filePath, 'spec.md'))) {
+                        return filePath;
+                    }
+                }
+                const found = findSpecDirectory(filePath, targetId);
+                if (found)
+                    return found;
+            }
+        }
+    }
+    catch (e) {
+        // Ignore errors
+    }
+    return null;
+}
+function generateApplyPrompt(specId, specContent, artifacts) {
+    let artifactsSection = '';
+    if (artifacts.length > 0) {
+        artifactsSection = '\n**Additional Artifacts found in spec directory**:\n';
+        artifacts.forEach(art => {
+            artifactsSection += `\n- **${art.name}**:\n\`\`\`\n${art.content}\n\`\`\`\n`;
+        });
+    }
+    return `I want to implement the specification with ID: **${specId}**.
+
+Please carefully review the specification content and any associated artifacts provided below. 
+Your task is to proceed with the implementation in the codebase, following the requirements and design decisions documented in these files.
+
+**SPECIFICATION CONTENT**:
+\`\`\`markdown
+${specContent || 'No spec.md content found.'}
+\`\`\`
+${artifactsSection}
+
+Please start the implementation now.`;
+}

package/src/commands/spec/apply.ts

@@ -0,0 +1,109 @@
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Action for 'praxis spec apply <spec-id>'
+ */
+export async function specApplyAction(specId: string) {
+    const rootDir = process.cwd();
+    const specsDir = path.join(rootDir, '.praxis', 'specs');
+
+    // 1. Validate environment
+    if (!fs.existsSync(specsDir)) {
+        // As requested: "Se la spec specificata con l'id non esiste, il comando non deve fare niente."
+        return;
+    }
+
+    // 2. Find spec directory
+    const specDir = findSpecDirectory(specsDir, specId);
+    if (!specDir) {
+        // As requested: "Se la spec specificata con l'id non esiste, il comando non deve fare niente."
+        return;
+    }
+
+    // 3. Collect artifacts
+    const specFile = path.join(specDir, 'spec.md');
+    let specContent = '';
+    if (fs.existsSync(specFile)) {
+        specContent = fs.readFileSync(specFile, 'utf8');
+    }
+
+    const otherArtifacts: { name: string, content: string }[] = [];
+    const files = fs.readdirSync(specDir);
+    for (const file of files) {
+        if (file === 'spec.md' || file === '.gitkeep') continue;
+        const filePath = path.join(specDir, file);
+        if (fs.statSync(filePath).isFile()) {
+            otherArtifacts.push({
+                name: file,
+                content: fs.readFileSync(filePath, 'utf8')
+            });
+        }
+    }
+
+    // 4. Generate Prompt
+    const prompt = generateApplyPrompt(specId, specContent, otherArtifacts);
+
+    // 5. Output
+    console.log('\n--- IDE AI CHAT PROMPT ---');
+    console.log('Copy and paste the following into your IDE chat to implement the specification:');
+    console.log('--------------------------');
+    console.log(prompt);
+    console.log('--------------------------\n');
+}
+
+function findSpecDirectory(dir: string, targetId: string): string | null {
+    try {
+        const list = fs.readdirSync(dir);
+
+        // Check if direct match exists
+        const directPath = path.join(dir, targetId);
+        if (fs.existsSync(directPath) && fs.statSync(directPath).isDirectory()) {
+            if (fs.existsSync(path.join(directPath, 'spec.md'))) {
+                return directPath;
+            }
+        }
+
+        // Recursive search
+        for (const file of list) {
+            const filePath = path.join(dir, file);
+            const stat = fs.statSync(filePath);
+
+            if (stat.isDirectory()) {
+                if (file === targetId) {
+                    if (fs.existsSync(path.join(filePath, 'spec.md'))) {
+                        return filePath;
+                    }
+                }
+                const found = findSpecDirectory(filePath, targetId);
+                if (found) return found;
+            }
+        }
+    } catch (e) {
+        // Ignore errors
+    }
+    return null;
+}
+
+function generateApplyPrompt(specId: string, specContent: string, artifacts: { name: string, content: string }[]): string {
+    let artifactsSection = '';
+    if (artifacts.length > 0) {
+        artifactsSection = '\n**Additional Artifacts found in spec directory**:\n';
+        artifacts.forEach(art => {
+            artifactsSection += `\n- **${art.name}**:\n\`\`\`\n${art.content}\n\`\`\`\n`;
+        });
+    }
+
+    return `I want to implement the specification with ID: **${specId}**.
+
+Please carefully review the specification content and any associated artifacts provided below. 
+Your task is to proceed with the implementation in the codebase, following the requirements and design decisions documented in these files.
+
+**SPECIFICATION CONTENT**:
+\`\`\`markdown
+${specContent || 'No spec.md content found.'}
+\`\`\`
+${artifactsSection}
+
+Please start the implementation now.`;
+}

package/src/commands/spec/archive.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Action for 'praxis spec archive <spec-id>'
+ */
+export declare function specArchiveAction(specId: string): Promise<void>;