@fermindi/pwn-cli 0.3.0 → 0.3.1

package/cli/inject.js

@@ -65,7 +65,9 @@ export default async function injectCommand(args = []) {
   console.log('   ├── patterns/       (auto-applied patterns)');
   console.log('   ├── workflows/      (batch execution)');
   console.log('   ├── agents/         (AI agent configs)');
-  console.log('   └── config/         (notifications, etc)\n');
+  console.log('   └── config/         (notifications, etc)');
+  console.log('   .claude/');
+  console.log('   └── commands/       (slash commands: /save)\n');
 
   // Show ntfy topic if generated
   const notifyPath = join(process.cwd(), '.ai', 'config', 'notifications.json');

package/cli/update.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync, writeFileSync, cpSync, renameSync } from 'fs';
+import { existsSync, readFileSync, writeFileSync, cpSync, renameSync, mkdirSync, readdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
@@ -21,6 +21,13 @@ const FRAMEWORK_FILES = [
   'README.md',
 ];
 
+/**
+ * Claude Code slash commands (in .claude/commands/)
+ */
+const CLAUDE_COMMANDS = [
+  'save.md',
+];
+
 /**
  * Files that should NOT be updated (user data)
  * These contain user customizations
@@ -148,6 +155,39 @@ export default async function updateCommand(args = []) {
     }
   }
 
+  // Update .claude/commands/ (slash commands)
+  const claudeCommandsDir = join(cwd, '.claude', 'commands');
+  const templateCommandsDir = join(__dirname, '../templates/workspace/.claude/commands');
+
+  if (existsSync(templateCommandsDir)) {
+    for (const cmdFile of CLAUDE_COMMANDS) {
+      const templateFile = join(templateCommandsDir, cmdFile);
+      const targetFile = join(claudeCommandsDir, cmdFile);
+
+      if (!existsSync(templateFile)) {
+        continue;
+      }
+
+      const templateContent = readFileSync(templateFile, 'utf8');
+      const targetExists = existsSync(targetFile);
+      const targetContent = targetExists ? readFileSync(targetFile, 'utf8') : '';
+
+      if (templateContent !== targetContent) {
+        if (dryRun) {
+          console.log(`   📝 Would update: .claude/commands/${cmdFile}`);
+        } else {
+          // Ensure directory exists
+          if (!existsSync(claudeCommandsDir)) {
+            mkdirSync(claudeCommandsDir, { recursive: true });
+          }
+          writeFileSync(targetFile, templateContent);
+          console.log(`   📝 Updated: .claude/commands/${cmdFile}`);
+        }
+        updated.push(`.claude/commands/${cmdFile}`);
+      }
+    }
+  }
+
   // Update state.json with new version
   if (!dryRun && existsSync(statePath)) {
     try {
@@ -185,5 +225,6 @@ export default async function updateCommand(args = []) {
   console.log('🔒 Preserved (user data):');
   console.log('   .ai/memory/     (decisions, patterns, deadends)');
   console.log('   .ai/tasks/      (active, backlog)');
-  console.log('   .ai/state.json  (session state)\n');
+  console.log('   .ai/state.json  (session state)');
+  console.log('   .claude/        (your custom commands preserved)\n');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fermindi/pwn-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Professional AI Workspace - Inject structured memory and automation into any project for AI-powered development",
   "type": "module",
   "bin": {

package/src/core/inject.js

@@ -86,6 +86,14 @@ export function getTemplatePath() {
   return join(__dirname, '../../templates/workspace/.ai');
 }
 
+/**
+ * Get the path to the .claude commands template
+ * @returns {string} Path to .claude template directory
+ */
+export function getClaudeCommandsTemplatePath() {
+  return join(__dirname, '../../templates/workspace/.claude');
+}
+
 /**
  * Inject PWN workspace into a project
  * @param {object} options - Injection options
@@ -104,7 +112,9 @@ export async function inject(options = {}) {
   } = options;
 
   const templateDir = getTemplatePath();
+  const claudeTemplateDir = getClaudeCommandsTemplatePath();
   const targetDir = join(cwd, '.ai');
+  const claudeDir = join(cwd, '.claude');
 
   const log = silent ? () => {} : console.log;
 
@@ -193,6 +203,24 @@ export async function inject(options = {}) {
       }
     }
 
+    // Copy .claude/commands/ for slash commands
+    if (existsSync(claudeTemplateDir)) {
+      // Create .claude/commands/ if it doesn't exist
+      const commandsDir = join(claudeDir, 'commands');
+      if (!existsSync(commandsDir)) {
+        mkdirSync(commandsDir, { recursive: true });
+      }
+
+      // Copy all command files
+      const claudeCommandsSource = join(claudeTemplateDir, 'commands');
+      if (existsSync(claudeCommandsSource)) {
+        cpSync(claudeCommandsSource, commandsDir, { recursive: true });
+        if (!silent) {
+          console.log('📝 Created .claude/commands/ with PWN slash commands');
+        }
+      }
+    }
+
     // Backup other AI files (not CLAUDE.md) to .ai/
     const otherFiles = Object.fromEntries(
       Object.entries(backedUpContent).filter(([k]) => k.toLowerCase() !== 'claude.md')

package/templates/workspace/.claude/commands/save.md

@@ -0,0 +1,142 @@
+# /save - PWN Session Save
+
+Save your current work state to PWN framework files (.ai/state.json and .ai/memory/).
+
+## What this command does
+
+1. Updates .ai/state.json with current session state
+2. Updates .ai/tasks/active.md with task progress
+3. Logs new dead ends to .ai/memory/deadends.md
+4. Optionally updates .ai/memory/decisions.md with new decisions
+5. Creates archive entry in .ai/memory/archive/
+
+---
+
+## Instructions
+
+First, identify the current developer by running:
+
+```bash
+git config user.name
+```
+
+Then, analyze the current session and update PWN files accordingly.
+
+## Files to Update
+
+### 1. State File (.ai/state.json)
+
+Update the session state:
+
+```json
+{
+  "developer": "{username from git config}",
+  "session_started": "{ISO timestamp}",
+  "session_mode": "interactive",
+  "current_task": "{task ID or null}",
+  "context_loaded": ["memory", "patterns", "tasks"],
+  "last_save": "{current ISO timestamp}"
+}
+```
+
+### 2. Active Tasks (.ai/tasks/active.md)
+
+If there are tasks in progress:
+- Update checkbox status ([ ] or [x])
+- Add notes about blockers
+- Update priority if changed
+
+### 3. Dead Ends (.ai/memory/deadends.md)
+
+When a new dead end is discovered:
+
+1. **Get next ID** from existing entries (last DE-XXX + 1)
+
+2. **Add detailed entry**:
+```markdown
+## DE-XXX: Title
+
+**Date:** YYYY-MM-DD
+**Attempted:** What was tried
+**Problem:** Why it failed
+**Solution:** What worked instead
+**Tags:** relevant, keywords
+```
+
+### 4. Decisions (.ai/memory/decisions.md)
+
+If new architectural decisions were made:
+
+1. **Get next ID** from existing entries (last DEC-XXX + 1)
+
+2. **Add entry**:
+```markdown
+## DEC-XXX: Decision Title
+
+**Date:** YYYY-MM-DD
+**Status:** Active
+**Context:** Why this decision was needed
+**Decision:** What was decided
+**Rationale:** Why this is the best choice
+```
+
+### 5. Archive Entry (.ai/memory/archive/{date}-session.md)
+
+Create a session summary:
+
+```markdown
+# Session: YYYY-MM-DD
+
+## Summary
+{brief description of what was done this session}
+
+## Tasks
+### Completed
+- [x] Task descriptions...
+
+### In Progress
+- [ ] Task descriptions...
+
+## Decisions Made
+- DEC-XXX: description (if any)
+
+## Dead Ends
+- DE-XXX: description (if any)
+
+---
+*Saved: {ISO timestamp}*
+```
+
+---
+
+## Output Format
+
+After updating all files, confirm to the user:
+
+```
+PWN Save Complete:
+- State: .ai/state.json updated (developer: {username})
+- Tasks: {X} active, {Y} completed
+- Dead Ends: {new count or "no new"}
+- Decisions: {new count or "no new"}
+- Archive: .ai/memory/archive/{filename}
+- Last updated: {timestamp}
+```
+
+---
+
+## Rules
+
+1. **state.json**: Only current session state, no history
+2. **deadends.md**: Detailed entries with proper DE-XXX IDs
+3. **decisions.md**: Organized entries with proper DEC-XXX IDs
+4. **active.md**: Only current sprint tasks
+5. **archive/**: One file per session with summary
+
+---
+
+## Notes
+
+- This command replaces the old /checkpoint command
+- Uses PWN framework structure in .ai/ directory
+- Always get the next available ID number before adding entries