@fermindi/pwn-cli 0.1.0

package/src/services/notification-service.js

@@ -0,0 +1,342 @@
+/**
+ * PWN Notification Service
+ *
+ * Multi-channel notification system for task completion alerts.
+ * Supports: ntfy.sh, desktop notifications, and extensible channels.
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * @typedef {Object} NotificationConfig
+ * @property {boolean} enabled - Global enable/disable
+ * @property {string} defaultChannel - Default channel to use
+ * @property {Object} channels - Channel-specific configurations
+ */
+
+/**
+ * @typedef {Object} NotificationPayload
+ * @property {string} title - Notification title
+ * @property {string} message - Notification body
+ * @property {string} [priority] - Priority level (low, default, high, urgent)
+ * @property {string[]} [tags] - Tags/emojis for the notification
+ * @property {string} [url] - Click action URL
+ */
+
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+  enabled: true,
+  defaultChannel: 'desktop',
+  channels: {
+    ntfy: {
+      enabled: false,
+      server: 'https://ntfy.sh',
+      topic: '',
+      priority: 'default'
+    },
+    desktop: {
+      enabled: true
+    },
+    pushover: {
+      enabled: false,
+      userKey: '',
+      apiToken: ''
+    }
+  }
+};
+
+/**
+ * Load notification configuration from workspace
+ * @param {string} cwd - Working directory
+ * @returns {NotificationConfig}
+ */
+export function loadConfig(cwd = process.cwd()) {
+  const configPath = join(cwd, '.ai', 'config', 'notifications.json');
+
+  if (!existsSync(configPath)) {
+    return DEFAULT_CONFIG;
+  }
+
+  try {
+    const content = readFileSync(configPath, 'utf8');
+    const userConfig = JSON.parse(content);
+
+    // Merge with defaults
+    return {
+      ...DEFAULT_CONFIG,
+      ...userConfig,
+      channels: {
+        ...DEFAULT_CONFIG.channels,
+        ...userConfig.channels
+      }
+    };
+  } catch {
+    return DEFAULT_CONFIG;
+  }
+}
+
+/**
+ * Send notification through configured channels
+ * @param {NotificationPayload} payload - Notification data
+ * @param {Object} options - Send options
+ * @param {string} [options.channel] - Specific channel to use
+ * @param {string} [options.cwd] - Working directory
+ * @returns {Promise<{success: boolean, channel: string, error?: string}>}
+ */
+export async function send(payload, options = {}) {
+  const { channel: specificChannel, cwd = process.cwd() } = options;
+  const config = loadConfig(cwd);
+
+  if (!config.enabled) {
+    return { success: false, channel: 'none', error: 'Notifications disabled' };
+  }
+
+  const channelName = specificChannel || config.defaultChannel;
+  const channelConfig = config.channels[channelName];
+
+  if (!channelConfig) {
+    return { success: false, channel: channelName, error: `Unknown channel: ${channelName}` };
+  }
+
+  if (!channelConfig.enabled) {
+    return { success: false, channel: channelName, error: `Channel ${channelName} is disabled` };
+  }
+
+  try {
+    switch (channelName) {
+      case 'ntfy':
+        return await sendNtfy(payload, channelConfig);
+      case 'desktop':
+        return await sendDesktop(payload, channelConfig);
+      case 'pushover':
+        return await sendPushover(payload, channelConfig);
+      default:
+        return { success: false, channel: channelName, error: `No handler for channel: ${channelName}` };
+    }
+  } catch (error) {
+    return { success: false, channel: channelName, error: error.message };
+  }
+}
+
+/**
+ * Send notification via ntfy.sh
+ * @param {NotificationPayload} payload
+ * @param {Object} config
+ */
+async function sendNtfy(payload, config) {
+  const { server = 'https://ntfy.sh', topic, priority = 'default' } = config;
+
+  if (!topic) {
+    return { success: false, channel: 'ntfy', error: 'ntfy topic not configured' };
+  }
+
+  const url = `${server}/${topic}`;
+
+  const headers = {
+    'Title': payload.title,
+    'Priority': payload.priority || priority,
+  };
+
+  if (payload.tags && payload.tags.length > 0) {
+    headers['Tags'] = payload.tags.join(',');
+  }
+
+  if (payload.url) {
+    headers['Click'] = payload.url;
+  }
+
+  const response = await fetch(url, {
+    method: 'POST',
+    headers,
+    body: payload.message
+  });
+
+  if (!response.ok) {
+    return { success: false, channel: 'ntfy', error: `HTTP ${response.status}` };
+  }
+
+  return { success: true, channel: 'ntfy' };
+}
+
+/**
+ * Send desktop notification
+ * Uses native OS notifications via child process
+ * @param {NotificationPayload} payload
+ * @param {Object} config
+ */
+async function sendDesktop(payload, config) {
+  const { title, message } = payload;
+
+  // Use PowerShell on Windows for native toast notifications
+  if (process.platform === 'win32') {
+    const { exec } = await import('child_process');
+    const { promisify } = await import('util');
+    const execAsync = promisify(exec);
+
+    // Escape quotes in message
+    const escapedTitle = title.replace(/"/g, '`"');
+    const escapedMessage = message.replace(/"/g, '`"');
+
+    const script = `
+      [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null
+      [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime] | Out-Null
+      $template = @"
+      <toast>
+        <visual>
+          <binding template="ToastText02">
+            <text id="1">${escapedTitle}</text>
+            <text id="2">${escapedMessage}</text>
+          </binding>
+        </visual>
+      </toast>
+"@
+      $xml = New-Object Windows.Data.Xml.Dom.XmlDocument
+      $xml.LoadXml($template)
+      $toast = [Windows.UI.Notifications.ToastNotification]::new($xml)
+      [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier("PWN").Show($toast)
+    `;
+
+    try {
+      await execAsync(`powershell -Command "${script.replace(/\n/g, ' ')}"`, {
+        windowsHide: true
+      });
+      return { success: true, channel: 'desktop' };
+    } catch (error) {
+      // Fallback to simple msg command
+      try {
+        await execAsync(`msg %username% "${escapedTitle}: ${escapedMessage}"`, {
+          windowsHide: true
+        });
+        return { success: true, channel: 'desktop' };
+      } catch {
+        return { success: false, channel: 'desktop', error: 'Desktop notifications not available' };
+      }
+    }
+  }
+
+  // macOS
+  if (process.platform === 'darwin') {
+    const { exec } = await import('child_process');
+    const { promisify } = await import('util');
+    const execAsync = promisify(exec);
+
+    const escapedTitle = title.replace(/"/g, '\\"');
+    const escapedMessage = message.replace(/"/g, '\\"');
+
+    try {
+      await execAsync(`osascript -e 'display notification "${escapedMessage}" with title "${escapedTitle}"'`);
+      return { success: true, channel: 'desktop' };
+    } catch (error) {
+      return { success: false, channel: 'desktop', error: error.message };
+    }
+  }
+
+  // Linux (notify-send)
+  if (process.platform === 'linux') {
+    const { exec } = await import('child_process');
+    const { promisify } = await import('util');
+    const execAsync = promisify(exec);
+
+    try {
+      await execAsync(`notify-send "${title}" "${message}"`);
+      return { success: true, channel: 'desktop' };
+    } catch (error) {
+      return { success: false, channel: 'desktop', error: 'notify-send not available' };
+    }
+  }
+
+  return { success: false, channel: 'desktop', error: `Unsupported platform: ${process.platform}` };
+}
+
+/**
+ * Send notification via Pushover
+ * @param {NotificationPayload} payload
+ * @param {Object} config
+ */
+async function sendPushover(payload, config) {
+  const { userKey, apiToken } = config;
+
+  if (!userKey || !apiToken) {
+    return { success: false, channel: 'pushover', error: 'Pushover credentials not configured' };
+  }
+
+  const priorityMap = {
+    'low': -1,
+    'default': 0,
+    'high': 1,
+    'urgent': 2
+  };
+
+  const body = new URLSearchParams({
+    token: apiToken,
+    user: userKey,
+    title: payload.title,
+    message: payload.message,
+    priority: priorityMap[payload.priority || 'default'] || 0
+  });
+
+  if (payload.url) {
+    body.append('url', payload.url);
+  }
+
+  const response = await fetch('https://api.pushover.net/1/messages.json', {
+    method: 'POST',
+    body
+  });
+
+  if (!response.ok) {
+    const data = await response.json().catch(() => ({}));
+    return { success: false, channel: 'pushover', error: data.errors?.join(', ') || `HTTP ${response.status}` };
+  }
+
+  return { success: true, channel: 'pushover' };
+}
+
+/**
+ * Test notification configuration
+ * @param {string} channel - Channel to test
+ * @param {string} cwd - Working directory
+ * @returns {Promise<{success: boolean, channel: string, error?: string}>}
+ */
+export async function test(channel, cwd = process.cwd()) {
+  return send({
+    title: 'PWN Test Notification',
+    message: 'If you see this, notifications are working!',
+    tags: ['white_check_mark', 'robot']
+  }, { channel, cwd });
+}
+
+/**
+ * Send task completion notification
+ * @param {string} taskId - Task identifier
+ * @param {string} taskName - Task description
+ * @param {Object} options - Additional options
+ */
+export async function notifyTaskComplete(taskId, taskName, options = {}) {
+  return send({
+    title: 'Task Completed',
+    message: `${taskId}: ${taskName}`,
+    tags: ['white_check_mark'],
+    priority: 'default',
+    ...options
+  }, options);
+}
+
+/**
+ * Send error notification
+ * @param {string} title - Error title
+ * @param {string} message - Error details
+ * @param {Object} options - Additional options
+ */
+export async function notifyError(title, message, options = {}) {
+  return send({
+    title,
+    message,
+    tags: ['x', 'warning'],
+    priority: 'high',
+    ...options
+  }, options);
+}

package/templates/codespaces/devcontainer.json

@@ -0,0 +1,52 @@
+{
+  "name": "PWN Development Environment",
+  "image": "mcr.microsoft.com/devcontainers/javascript-node:22",
+
+  "features": {
+    "ghcr.io/devcontainers/features/github-cli:1": {},
+    "ghcr.io/devcontainers/features/git:1": {}
+  },
+
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "bash",
+        "editor.formatOnSave": true,
+        "editor.tabSize": 2,
+        "files.trimTrailingWhitespace": true,
+        "files.insertFinalNewline": true,
+        "javascript.preferences.importModuleSpecifierEnding": "js",
+        "typescript.preferences.importModuleSpecifierEnding": "js"
+      },
+      "extensions": [
+        "dbaeumer.vscode-eslint",
+        "esbenp.prettier-vscode",
+        "bradlc.vscode-tailwindcss",
+        "formulahendry.auto-rename-tag",
+        "christian-kohler.path-intellisense",
+        "usernamehw.errorlens",
+        "eamodio.gitlens",
+        "github.copilot",
+        "anthropics.claude-code"
+      ]
+    }
+  },
+
+  "postCreateCommand": "bash .devcontainer/setup.sh",
+  "postStartCommand": "echo '🚀 Development environment ready!'",
+
+  "forwardPorts": [3000, 5173, 8080],
+
+  "portsAttributes": {
+    "3000": { "label": "App", "onAutoForward": "notify" },
+    "5173": { "label": "Vite", "onAutoForward": "notify" },
+    "8080": { "label": "Server", "onAutoForward": "notify" }
+  },
+
+  "remoteUser": "node",
+
+  "containerEnv": {
+    "PWN_CODESPACE": "true",
+    "NODE_ENV": "development"
+  }
+}

package/templates/codespaces/setup.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+# PWN Codespace Setup Script
+# Runs automatically when codespace is created
+
+set -e
+
+echo "=========================================="
+echo "  Setting up development environment"
+echo "=========================================="
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+print_step() { echo -e "${BLUE}>>>${NC} $1"; }
+print_ok() { echo -e "${GREEN}[OK]${NC} $1"; }
+
+# 1. Install dependencies
+print_step "Installing dependencies..."
+if [ -f "pnpm-lock.yaml" ]; then
+  npm install -g pnpm 2>/dev/null || true
+  pnpm install
+elif [ -f "package-lock.json" ]; then
+  npm ci
+elif [ -f "yarn.lock" ]; then
+  npm install -g yarn 2>/dev/null || true
+  yarn install --frozen-lockfile
+elif [ -f "package.json" ]; then
+  npm install
+fi
+print_ok "Dependencies installed"
+
+# 2. Setup PWN if available
+if command -v pwn &> /dev/null; then
+  print_step "Initializing PWN workspace..."
+  if [ ! -d ".ai" ]; then
+    pwn inject
+  fi
+  pwn knowledge sync 2>/dev/null || true
+  print_ok "PWN workspace ready"
+fi
+
+# 3. Configure git
+print_step "Configuring git..."
+if [ -n "$GITHUB_USER" ]; then
+  git config --global user.name "${GITHUB_USER}" 2>/dev/null || true
+  git config --global user.email "${GITHUB_USER}@users.noreply.github.com" 2>/dev/null || true
+fi
+print_ok "Git configured"
+
+# 4. Setup aliases
+cat >> ~/.bashrc << 'ALIASES'
+
+# Quick aliases
+alias dev='npm run dev'
+alias build='npm run build'
+alias test='npm test'
+alias gs='git status'
+alias gd='git diff'
+alias gc='git commit'
+alias gp='git push'
+ALIASES
+print_ok "Aliases configured"
+
+echo ""
+echo "=========================================="
+echo -e "${GREEN}  Setup complete!${NC}"
+echo "=========================================="
+echo ""

package/templates/workspace/.ai/README.md

@@ -0,0 +1,164 @@
+# AI Workspace
+
+This directory contains all AI-related context, memory, and configuration for this project.
+
+## 📁 Structure
+
+```
+.ai/
+├── README.md                     # This file
+├── state.json                    # Current session state (git-ignored)
+├── memory/                       # Persistent knowledge
+│   ├── decisions.md              # Architectural decisions
+│   ├── patterns.md               # Codebase patterns
+│   ├── deadends.md               # Failed approaches
+│   └── archive/                  # Historical context
+├── tasks/                        # Work tracking
+│   ├── active.md                 # Current tasks
+│   └── backlog.md                # Future tasks
+├── patterns/                     # Auto-applied patterns
+│   ├── index.md                  # Trigger map
+│   ├── frontend/                 # Frontend patterns
+│   ├── backend/                  # Backend patterns
+│   └── universal/                # Cross-cutting patterns
+├── config/                       # Configurations (git-ignored)
+│   └── notifications.json        # Notification settings
+├── workflows/                    # Automation templates
+│   └── batch-task.md             # Batch execution prompt
+└── agents/                       # AI agent configs
+    ├── README.md                 # Agent documentation
+    └── claude.md                 # Claude Code bootstrap
+```
+
+## 🧠 Memory System
+
+### decisions.md
+Tracks major architectural decisions with rationale and impact.
+
+**Format:**
+```markdown
+## DEC-001: Decision Title
+**Date:** YYYY-MM-DD
+**Context:** Why this decision was needed
+**Decision:** What was decided
+**Rationale:** Why this is the best choice
+**Impact:** What this affects
+```
+
+### patterns.md
+Captures recurring patterns learned during development.
+
+**Format:**
+```markdown
+## Pattern Category
+
+### Pattern Name
+**Context:** When this applies
+**Pattern:** Code example or description
+**Rationale:** Why this is better
+```
+
+### deadends.md
+Documents approaches that failed to avoid repeating mistakes.
+
+**Format:**
+```markdown
+## DE-001: Failed Approach
+**Date:** YYYY-MM-DD
+**Attempted:** What we tried
+**Problem:** Why it failed
+**Solution:** What worked instead
+```
+
+## 📋 Tasks System
+
+### active.md
+Current work in progress. Use checkboxes for tracking:
+```markdown
+- [ ] US-001: Pending task
+- [x] US-002: Completed task
+```
+
+### backlog.md
+Future tasks, prioritized from top to bottom.
+
+## 🎯 Patterns System
+
+Patterns are auto-applied based on triggers defined in `patterns/index.md`.
+
+**How it works:**
+1. AI reads `patterns/index.md` on session start
+2. Registers triggers (file extensions, imports, commands)
+3. Auto-loads relevant patterns when triggered
+4. Applies patterns to current work
+
+**Example:**
+```
+User edits: src/components/Button.tsx
+→ Triggers: *.tsx
+→ Auto-loads: patterns/frontend/react/
+→ Applies React patterns automatically
+```
+
+## 🔄 Workflows
+
+### batch-task.md
+Template for autonomous batch execution. Used by `pwn batch` command.
+
+Defines:
+- Task selection logic
+- Quality gates (tests, lint, typecheck)
+- Commit patterns
+- Completion signals
+
+## 🤖 Agents
+
+### agent/claude.md
+Bootstrap instructions for Claude Code.
+
+Contains:
+- Session start protocol
+- Context loading order
+- Pattern auto-application rules
+- Batch execution mode
+
+### Adding New Agents
+Copy `agents/claude.md` as template for other AI agents (Cursor, Copilot, etc).
+
+## 🔒 Git Ignore
+
+**Tracked (committed):**
+- memory/ (shared team knowledge)
+- tasks/ (work visibility)
+- patterns/ (team patterns)
+- workflows/ (team automation)
+- agents/ (team AI configs)
+
+**Ignored (local only):**
+- state.json (personal session state)
+- config/notifications.json (personal notification settings)
+
+## 🚀 Getting Started
+
+### For AI Agents
+1. Read `agents/<your-agent>.md` for bootstrap instructions
+2. Load `memory/` files for context
+3. Register patterns from `patterns/index.md`
+4. Check `tasks/active.md` for current work
+
+### For Humans
+1. Review `memory/decisions.md` for architectural context
+2. Check `tasks/active.md` for team's current work
+3. Add tasks to `tasks/backlog.md` for AI to pick up
+4. Update patterns in `memory/patterns.md` when you discover new ones
+
+## 📚 Learn More
+
+- [PWN Documentation](https://github.com/yourusername/pwn)
+- [Quick Start Guide](https://github.com/yourusername/pwn/docs/quick-start.md)
+- [Pattern Guide](https://github.com/yourusername/pwn/docs/patterns-guide.md)
+
+---
+
+**PWN Version:** 1.0.0
+**Injected:** (automatically set on injection)