@fermindi/pwn-cli 0.1.0

package/cli/codespaces.js

@@ -0,0 +1,303 @@
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, chmodSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cwd = process.cwd();
+
+export default async function codespaces(args) {
+  const subcommand = args[0];
+
+  switch (subcommand) {
+    case 'init':
+      await initCodespaces(args.slice(1));
+      break;
+
+    case 'status':
+      await showStatus();
+      break;
+
+    case 'open':
+      await openCodespace(args.slice(1));
+      break;
+
+    case 'list':
+      await listCodespaces();
+      break;
+
+    default:
+      showHelp();
+  }
+}
+
+function showHelp() {
+  console.log(`
+PWN Codespaces Integration
+
+Usage: pwn codespaces <command> [options]
+
+Commands:
+  init              Add devcontainer config to current project
+  init --minimal    Add minimal devcontainer (no extras)
+  init --docker     Use custom Dockerfile
+  status            Check codespaces configuration
+  open              Open project in GitHub Codespace
+  list              List active codespaces (requires gh CLI)
+
+Examples:
+  pwn codespaces init
+  pwn codespaces init --minimal
+  pwn codespaces open
+  pwn codespaces status
+
+Note: Requires GitHub CLI (gh) for some features.
+      Install: https://cli.github.com/
+`);
+}
+
+async function initCodespaces(args) {
+  const minimal = args.includes('--minimal');
+  const useDockerfile = args.includes('--docker');
+
+  console.log('Setting up Codespaces configuration...\n');
+
+  // Check if .devcontainer already exists
+  const devcontainerDir = join(cwd, '.devcontainer');
+
+  if (existsSync(devcontainerDir)) {
+    if (!args.includes('--force')) {
+      console.log('.devcontainer/ already exists.');
+      console.log('Use --force to overwrite.');
+      return;
+    }
+    console.log('Overwriting existing .devcontainer/...');
+  }
+
+  // Create directory
+  mkdirSync(devcontainerDir, { recursive: true });
+
+  // Copy template files
+  const templateDir = join(__dirname, '..', 'templates', 'codespaces');
+
+  if (minimal) {
+    // Minimal config - just devcontainer.json
+    const minimalConfig = {
+      name: getProjectName(),
+      image: 'mcr.microsoft.com/devcontainers/javascript-node:22',
+      postCreateCommand: 'npm install',
+      forwardPorts: [3000, 5173],
+      remoteUser: 'node'
+    };
+
+    writeFileSync(
+      join(devcontainerDir, 'devcontainer.json'),
+      JSON.stringify(minimalConfig, null, 2)
+    );
+    console.log('Created minimal devcontainer.json');
+
+  } else if (useDockerfile) {
+    // Copy full template with Dockerfile reference
+    const pwmDevcontainerDir = join(__dirname, '..', '.devcontainer');
+
+    cpSync(join(pwmDevcontainerDir, 'Dockerfile'), join(devcontainerDir, 'Dockerfile'));
+    cpSync(join(pwmDevcontainerDir, 'devcontainer.dockerfile.json'), join(devcontainerDir, 'devcontainer.json'));
+    cpSync(join(pwmDevcontainerDir, 'setup-codespace.sh'), join(devcontainerDir, 'setup.sh'));
+
+    console.log('Created devcontainer.json (with Dockerfile)');
+    console.log('Created Dockerfile');
+    console.log('Created setup.sh');
+
+  } else {
+    // Standard setup from templates
+    if (existsSync(templateDir)) {
+      cpSync(join(templateDir, 'devcontainer.json'), join(devcontainerDir, 'devcontainer.json'));
+      cpSync(join(templateDir, 'setup.sh'), join(devcontainerDir, 'setup.sh'));
+    } else {
+      // Fallback: copy from PWN's own devcontainer
+      const pwmDevcontainerDir = join(__dirname, '..', '.devcontainer');
+      cpSync(join(pwmDevcontainerDir, 'devcontainer.json'), join(devcontainerDir, 'devcontainer.json'));
+      cpSync(join(pwmDevcontainerDir, 'setup-codespace.sh'), join(devcontainerDir, 'setup.sh'));
+    }
+
+    // Update project name in devcontainer.json
+    const configPath = join(devcontainerDir, 'devcontainer.json');
+    const config = JSON.parse(readFileSync(configPath, 'utf8'));
+    config.name = getProjectName();
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+    console.log('Created devcontainer.json');
+    console.log('Created setup.sh');
+  }
+
+  // Make setup.sh executable (on Unix systems)
+  try {
+    const setupPath = join(devcontainerDir, 'setup.sh');
+    if (existsSync(setupPath)) {
+      chmodSync(setupPath, '755');
+    }
+  } catch {
+    // Windows doesn't support chmod
+  }
+
+  console.log('\nCodespaces configuration ready!');
+  console.log('\nNext steps:');
+  console.log('  1. Commit the .devcontainer/ folder');
+  console.log('  2. Push to GitHub');
+  console.log('  3. Open in Codespace: gh codespace create');
+  console.log('');
+}
+
+async function showStatus() {
+  console.log('Codespaces Configuration Status\n');
+
+  const devcontainerDir = join(cwd, '.devcontainer');
+  const configPath = join(devcontainerDir, 'devcontainer.json');
+
+  // Check devcontainer
+  if (!existsSync(devcontainerDir)) {
+    console.log('Status: Not configured');
+    console.log('\nRun: pwn codespaces init');
+    return;
+  }
+
+  console.log('Status: Configured');
+  console.log(`Path: ${devcontainerDir}`);
+
+  // Parse config
+  if (existsSync(configPath)) {
+    try {
+      const config = JSON.parse(readFileSync(configPath, 'utf8'));
+      console.log(`\nContainer: ${config.name || 'Unnamed'}`);
+      console.log(`Image: ${config.image || 'Custom Dockerfile'}`);
+
+      if (config.forwardPorts?.length) {
+        console.log(`Ports: ${config.forwardPorts.join(', ')}`);
+      }
+
+      if (config.customizations?.vscode?.extensions?.length) {
+        console.log(`Extensions: ${config.customizations.vscode.extensions.length} configured`);
+      }
+    } catch {
+      console.log('Warning: Could not parse devcontainer.json');
+    }
+  }
+
+  // Check for Dockerfile
+  if (existsSync(join(devcontainerDir, 'Dockerfile'))) {
+    console.log('Dockerfile: Yes (custom build)');
+  }
+
+  // Check for setup script
+  if (existsSync(join(devcontainerDir, 'setup.sh'))) {
+    console.log('Setup script: Yes');
+  }
+
+  // Check if in a codespace
+  if (process.env.PWN_CODESPACE === 'true' || process.env.CODESPACES === 'true') {
+    console.log('\nCurrently running in a Codespace!');
+  }
+
+  // Check GitHub remote
+  try {
+    const remote = execSync('git remote get-url origin', { encoding: 'utf8' }).trim();
+    if (remote.includes('github.com')) {
+      const match = remote.match(/github\.com[:/]([^/]+)\/([^/.]+)/);
+      if (match) {
+        console.log(`\nGitHub: ${match[1]}/${match[2]}`);
+        console.log(`Open: https://github.com/codespaces/new?repo=${match[1]}/${match[2]}`);
+      }
+    }
+  } catch {
+    // Not a git repo or no remote
+  }
+
+  console.log('');
+}
+
+async function openCodespace(args) {
+  // Check for gh CLI
+  try {
+    execSync('gh --version', { stdio: 'ignore' });
+  } catch {
+    console.log('GitHub CLI (gh) not found.');
+    console.log('Install from: https://cli.github.com/');
+    return;
+  }
+
+  // Check auth
+  try {
+    execSync('gh auth status', { stdio: 'ignore' });
+  } catch {
+    console.log('Not authenticated with GitHub CLI.');
+    console.log('Run: gh auth login');
+    return;
+  }
+
+  console.log('Opening project in Codespace...\n');
+
+  try {
+    // Check if there's an existing codespace
+    const existing = execSync('gh codespace list --json name,repository -q ".[] | select(.repository | contains(\\"' + getRepoName() + '\\"))"', {
+      encoding: 'utf8'
+    }).trim();
+
+    if (existing) {
+      console.log('Found existing codespace. Opening...');
+      execSync('gh codespace code', { stdio: 'inherit' });
+    } else {
+      console.log('Creating new codespace...');
+      execSync('gh codespace create --repo ' + getRepoName(), { stdio: 'inherit' });
+    }
+  } catch (error) {
+    console.log('Error:', error.message);
+    console.log('\nTry manually: gh codespace create');
+  }
+}
+
+async function listCodespaces() {
+  try {
+    execSync('gh --version', { stdio: 'ignore' });
+  } catch {
+    console.log('GitHub CLI (gh) not found.');
+    console.log('Install from: https://cli.github.com/');
+    return;
+  }
+
+  console.log('Active Codespaces:\n');
+
+  try {
+    execSync('gh codespace list', { stdio: 'inherit' });
+  } catch {
+    console.log('Could not list codespaces. Make sure you are authenticated.');
+    console.log('Run: gh auth login');
+  }
+}
+
+function getProjectName() {
+  try {
+    const pkgPath = join(cwd, 'package.json');
+    if (existsSync(pkgPath)) {
+      const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+      return pkg.name || 'Development';
+    }
+  } catch {
+    // ignore
+  }
+
+  // Use directory name
+  return cwd.split(/[/\\]/).pop() || 'Development';
+}
+
+function getRepoName() {
+  try {
+    const remote = execSync('git remote get-url origin', { encoding: 'utf8' }).trim();
+    const match = remote.match(/github\.com[:/]([^/]+\/[^/.]+)/);
+    if (match) {
+      return match[1].replace('.git', '');
+    }
+  } catch {
+    // ignore
+  }
+  return '';
+}

package/cli/index.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
+
+const command = process.argv[2];
+const args = process.argv.slice(3);
+
+// Show version
+if (command === '--version' || command === '-v') {
+  console.log(packageJson.version);
+  process.exit(0);
+}
+
+// Show help
+if (!command || command === '--help' || command === '-h') {
+  console.log('PWN - Professional AI Workspace\n');
+  console.log('Usage: pwn <command> [options]\n');
+  console.log('Commands:');
+  console.log('  inject              Inject .ai/ workspace into current project');
+  console.log('  status              Show workspace status');
+  console.log('  validate            Validate workspace structure');
+  console.log('  notify              Send notifications (test, send, config)');
+  console.log('  batch               Execute tasks autonomously');
+  console.log('  patterns            Manage patterns and triggers');
+  console.log('  knowledge           Knowledge lifecycle management');
+  console.log('  codespaces          GitHub Codespaces integration');
+  console.log('  --version, -v       Show version');
+  console.log('  --help, -h          Show help\n');
+  console.log('Options:');
+  console.log('  inject --force      Overwrite existing .ai/ directory');
+  console.log('  validate --verbose  Show detailed structure report');
+  console.log('  notify test [ch]    Test notification channel');
+  console.log('  batch --count 5     Execute 5 tasks');
+  console.log('  patterns eval <f>   Evaluate triggers for file');
+  console.log('  knowledge status    Show knowledge system status');
+  console.log('  codespaces init     Add devcontainer config\n');
+  console.log('Documentation: https://github.com/anthropics/pwn');
+  process.exit(0);
+}
+
+// Route commands
+switch (command) {
+  case 'inject':
+    const { default: inject } = await import('./inject.js');
+    await inject(args);
+    break;
+
+  case 'status':
+    const { default: status } = await import('./status.js');
+    await status();
+    break;
+
+  case 'validate':
+    const { default: validate } = await import('./validate.js');
+    await validate(args);
+    break;
+
+  case 'notify':
+    const { default: notify } = await import('./notify.js');
+    await notify(args);
+    break;
+
+  case 'batch':
+    const { default: batchCmd } = await import('./batch.js');
+    await batchCmd(args);
+    break;
+
+  case 'patterns':
+    const { default: patternsCmd } = await import('./patterns.js');
+    await patternsCmd(args);
+    break;
+
+  case 'knowledge':
+    const { default: knowledgeCmd } = await import('./knowledge.js');
+    await knowledgeCmd(args);
+    break;
+
+  case 'codespaces':
+    const { default: codespacesCmd } = await import('./codespaces.js');
+    await codespacesCmd(args);
+    break;
+
+  default:
+    console.log(`❌ Unknown command: ${command}`);
+    console.log('   Run: pwn --help');
+    process.exit(1);
+}

package/cli/inject.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { inject } from '../src/core/inject.js';
+
+export default async function injectCommand(args = []) {
+  const force = args.includes('--force') || args.includes('-f');
+
+  console.log('🚀 PWN Workspace Injection\n');
+
+  const result = await inject({ force });
+
+  if (!result.success) {
+    if (result.error === 'ALREADY_EXISTS') {
+      console.log('❌ .ai/ directory already exists in this project');
+      console.log('   Use --force to overwrite: pwn inject --force');
+    } else {
+      console.error('❌ Injection failed:', result.message);
+    }
+    process.exit(1);
+  }
+
+  console.log('\n✅ PWN workspace injected successfully!\n');
+  console.log('📁 Created structure:');
+  console.log('   .ai/');
+  console.log('   ├── memory/         (decisions, patterns, dead-ends)');
+  console.log('   ├── tasks/          (active work, backlog)');
+  console.log('   ├── patterns/       (auto-applied patterns)');
+  console.log('   ├── workflows/      (batch execution)');
+  console.log('   ├── agents/         (AI agent configs)');
+  console.log('   └── config/         (notifications, etc)\n');
+
+  // Show ntfy topic if generated
+  const notifyPath = join(process.cwd(), '.ai', 'config', 'notifications.json');
+  if (existsSync(notifyPath)) {
+    try {
+      const config = JSON.parse(readFileSync(notifyPath, 'utf8'));
+      const topic = config.channels?.ntfy?.topic;
+      if (topic && !topic.includes('your-unique')) {
+        console.log('🔔 Notifications:');
+        console.log(`   ntfy topic: ${topic}`);
+        console.log(`   Subscribe:  https://ntfy.sh/${topic}`);
+        console.log('   Enable:     Edit .ai/config/notifications.json\n');
+      }
+    } catch {
+      // Ignore
+    }
+  }
+
+  console.log('📖 Next steps:');
+  console.log('   1. Read: .ai/README.md');
+  console.log('   2. Start working with AI assistance\n');
+}