@fermindi/pwn-cli 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +265 -251
  3. package/cli/batch.js +333 -333
  4. package/cli/codespaces.js +303 -303
  5. package/cli/index.js +98 -91
  6. package/cli/inject.js +78 -67
  7. package/cli/knowledge.js +531 -531
  8. package/cli/migrate.js +466 -0
  9. package/cli/notify.js +135 -135
  10. package/cli/patterns.js +665 -665
  11. package/cli/status.js +91 -91
  12. package/cli/validate.js +61 -61
  13. package/package.json +70 -70
  14. package/src/core/inject.js +208 -204
  15. package/src/core/state.js +91 -91
  16. package/src/core/validate.js +202 -202
  17. package/src/core/workspace.js +176 -176
  18. package/src/index.js +20 -20
  19. package/src/knowledge/gc.js +308 -308
  20. package/src/knowledge/lifecycle.js +401 -401
  21. package/src/knowledge/promote.js +364 -364
  22. package/src/knowledge/references.js +342 -342
  23. package/src/patterns/matcher.js +218 -218
  24. package/src/patterns/registry.js +375 -375
  25. package/src/patterns/triggers.js +423 -423
  26. package/src/services/batch-service.js +849 -849
  27. package/src/services/notification-service.js +342 -342
  28. package/templates/codespaces/devcontainer.json +52 -52
  29. package/templates/codespaces/setup.sh +70 -70
  30. package/templates/workspace/.ai/README.md +164 -164
  31. package/templates/workspace/.ai/agents/README.md +204 -204
  32. package/templates/workspace/.ai/agents/claude.md +625 -625
  33. package/templates/workspace/.ai/config/README.md +79 -79
  34. package/templates/workspace/.ai/config/notifications.template.json +20 -20
  35. package/templates/workspace/.ai/memory/deadends.md +79 -79
  36. package/templates/workspace/.ai/memory/decisions.md +58 -58
  37. package/templates/workspace/.ai/memory/patterns.md +65 -65
  38. package/templates/workspace/.ai/patterns/backend/README.md +126 -126
  39. package/templates/workspace/.ai/patterns/frontend/README.md +103 -103
  40. package/templates/workspace/.ai/patterns/index.md +256 -256
  41. package/templates/workspace/.ai/patterns/triggers.json +1087 -1087
  42. package/templates/workspace/.ai/patterns/universal/README.md +141 -141
  43. package/templates/workspace/.ai/state.template.json +8 -8
  44. package/templates/workspace/.ai/tasks/active.md +77 -77
  45. package/templates/workspace/.ai/tasks/backlog.md +95 -95
  46. package/templates/workspace/.ai/workflows/batch-task.md +356 -356
package/cli/index.js CHANGED
@@ -1,91 +1,98 @@
1
- #!/usr/bin/env node
2
- import { readFileSync } from 'fs';
3
- import { fileURLToPath } from 'url';
4
- import { dirname, join } from 'path';
5
-
6
- const __dirname = dirname(fileURLToPath(import.meta.url));
7
- const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
8
-
9
- const command = process.argv[2];
10
- const args = process.argv.slice(3);
11
-
12
- // Show version
13
- if (command === '--version' || command === '-v') {
14
- console.log(packageJson.version);
15
- process.exit(0);
16
- }
17
-
18
- // Show help
19
- if (!command || command === '--help' || command === '-h') {
20
- console.log('PWN - Professional AI Workspace\n');
21
- console.log('Usage: pwn <command> [options]\n');
22
- console.log('Commands:');
23
- console.log(' inject Inject .ai/ workspace into current project');
24
- console.log(' status Show workspace status');
25
- console.log(' validate Validate workspace structure');
26
- console.log(' notify Send notifications (test, send, config)');
27
- console.log(' batch Execute tasks autonomously');
28
- console.log(' patterns Manage patterns and triggers');
29
- console.log(' knowledge Knowledge lifecycle management');
30
- console.log(' codespaces GitHub Codespaces integration');
31
- console.log(' --version, -v Show version');
32
- console.log(' --help, -h Show help\n');
33
- console.log('Options:');
34
- console.log(' inject --force Overwrite existing .ai/ directory');
35
- console.log(' validate --verbose Show detailed structure report');
36
- console.log(' notify test [ch] Test notification channel');
37
- console.log(' batch --count 5 Execute 5 tasks');
38
- console.log(' patterns eval <f> Evaluate triggers for file');
39
- console.log(' knowledge status Show knowledge system status');
40
- console.log(' codespaces init Add devcontainer config\n');
41
- console.log('Documentation: https://github.com/anthropics/pwn');
42
- process.exit(0);
43
- }
44
-
45
- // Route commands
46
- switch (command) {
47
- case 'inject':
48
- const { default: inject } = await import('./inject.js');
49
- await inject(args);
50
- break;
51
-
52
- case 'status':
53
- const { default: status } = await import('./status.js');
54
- await status();
55
- break;
56
-
57
- case 'validate':
58
- const { default: validate } = await import('./validate.js');
59
- await validate(args);
60
- break;
61
-
62
- case 'notify':
63
- const { default: notify } = await import('./notify.js');
64
- await notify(args);
65
- break;
66
-
67
- case 'batch':
68
- const { default: batchCmd } = await import('./batch.js');
69
- await batchCmd(args);
70
- break;
71
-
72
- case 'patterns':
73
- const { default: patternsCmd } = await import('./patterns.js');
74
- await patternsCmd(args);
75
- break;
76
-
77
- case 'knowledge':
78
- const { default: knowledgeCmd } = await import('./knowledge.js');
79
- await knowledgeCmd(args);
80
- break;
81
-
82
- case 'codespaces':
83
- const { default: codespacesCmd } = await import('./codespaces.js');
84
- await codespacesCmd(args);
85
- break;
86
-
87
- default:
88
- console.log(`āŒ Unknown command: ${command}`);
89
- console.log(' Run: pwn --help');
90
- process.exit(1);
91
- }
1
+ #!/usr/bin/env node
2
+ import { readFileSync } from 'fs';
3
+ import { fileURLToPath } from 'url';
4
+ import { dirname, join } from 'path';
5
+
6
+ const __dirname = dirname(fileURLToPath(import.meta.url));
7
+ const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
8
+
9
+ const command = process.argv[2];
10
+ const args = process.argv.slice(3);
11
+
12
+ // Show version
13
+ if (command === '--version' || command === '-v') {
14
+ console.log(packageJson.version);
15
+ process.exit(0);
16
+ }
17
+
18
+ // Show help
19
+ if (!command || command === '--help' || command === '-h') {
20
+ console.log('PWN - Professional AI Workspace\n');
21
+ console.log('Usage: pwn <command> [options]\n');
22
+ console.log('Commands:');
23
+ console.log(' inject Inject .ai/ workspace into current project');
24
+ console.log(' migrate Migrate existing AI files to PWN structure');
25
+ console.log(' status Show workspace status');
26
+ console.log(' validate Validate workspace structure');
27
+ console.log(' notify Send notifications (test, send, config)');
28
+ console.log(' batch Execute tasks autonomously');
29
+ console.log(' patterns Manage patterns and triggers');
30
+ console.log(' knowledge Knowledge lifecycle management');
31
+ console.log(' codespaces GitHub Codespaces integration');
32
+ console.log(' --version, -v Show version');
33
+ console.log(' --help, -h Show help\n');
34
+ console.log('Options:');
35
+ console.log(' inject --force Overwrite existing .ai/ directory');
36
+ console.log(' migrate --dry-run Preview migration without changes');
37
+ console.log(' validate --verbose Show detailed structure report');
38
+ console.log(' notify test [ch] Test notification channel');
39
+ console.log(' batch --count 5 Execute 5 tasks');
40
+ console.log(' patterns eval <f> Evaluate triggers for file');
41
+ console.log(' knowledge status Show knowledge system status');
42
+ console.log(' codespaces init Add devcontainer config\n');
43
+ console.log('Documentation: https://github.com/anthropics/pwn');
44
+ process.exit(0);
45
+ }
46
+
47
+ // Route commands
48
+ switch (command) {
49
+ case 'inject':
50
+ const { default: inject } = await import('./inject.js');
51
+ await inject(args);
52
+ break;
53
+
54
+ case 'migrate':
55
+ const { default: migrate } = await import('./migrate.js');
56
+ await migrate(args);
57
+ break;
58
+
59
+ case 'status':
60
+ const { default: status } = await import('./status.js');
61
+ await status();
62
+ break;
63
+
64
+ case 'validate':
65
+ const { default: validate } = await import('./validate.js');
66
+ await validate(args);
67
+ break;
68
+
69
+ case 'notify':
70
+ const { default: notify } = await import('./notify.js');
71
+ await notify(args);
72
+ break;
73
+
74
+ case 'batch':
75
+ const { default: batchCmd } = await import('./batch.js');
76
+ await batchCmd(args);
77
+ break;
78
+
79
+ case 'patterns':
80
+ const { default: patternsCmd } = await import('./patterns.js');
81
+ await patternsCmd(args);
82
+ break;
83
+
84
+ case 'knowledge':
85
+ const { default: knowledgeCmd } = await import('./knowledge.js');
86
+ await knowledgeCmd(args);
87
+ break;
88
+
89
+ case 'codespaces':
90
+ const { default: codespacesCmd } = await import('./codespaces.js');
91
+ await codespacesCmd(args);
92
+ break;
93
+
94
+ default:
95
+ console.log(`āŒ Unknown command: ${command}`);
96
+ console.log(' Run: pwn --help');
97
+ process.exit(1);
98
+ }
package/cli/inject.js CHANGED
@@ -1,67 +1,78 @@
1
- #!/usr/bin/env node
2
- import { existsSync, readFileSync } from 'fs';
3
- import { join } from 'path';
4
- import { inject, detectKnownAIFiles } from '../src/core/inject.js';
5
-
6
- export default async function injectCommand(args = []) {
7
- const force = args.includes('--force') || args.includes('-f');
8
-
9
- console.log('šŸš€ PWN Workspace Injection\n');
10
-
11
- const result = await inject({ force });
12
-
13
- // Show detected AI files (before success/failure message)
14
- if (result.detected && result.detected.length > 0) {
15
- console.log('āš ļø Detected existing AI instruction files:\n');
16
- for (const file of result.detected) {
17
- console.log(` šŸ“„ ${file.file}`);
18
- console.log(` Type: ${file.type} - ${file.description}`);
19
- }
20
- console.log('\n šŸ’” Consider migrating content to .ai/ structure:');
21
- console.log(' - Instructions → .ai/agents/claude.md');
22
- console.log(' - Decisions → .ai/memory/decisions.md');
23
- console.log(' - Patterns → .ai/memory/patterns.md');
24
- console.log(' - Tasks → .ai/tasks/active.md\n');
25
- }
26
-
27
- if (!result.success) {
28
- if (result.error === 'ALREADY_EXISTS') {
29
- console.log('āŒ .ai/ directory already exists in this project');
30
- console.log(' Use --force to overwrite: pwn inject --force');
31
- } else {
32
- console.error('āŒ Injection failed:', result.message);
33
- }
34
- process.exit(1);
35
- }
36
-
37
- console.log('\nāœ… PWN workspace injected successfully!\n');
38
- console.log('šŸ“ Created structure:');
39
- console.log(' .ai/');
40
- console.log(' ā”œā”€ā”€ memory/ (decisions, patterns, dead-ends)');
41
- console.log(' ā”œā”€ā”€ tasks/ (active work, backlog)');
42
- console.log(' ā”œā”€ā”€ patterns/ (auto-applied patterns)');
43
- console.log(' ā”œā”€ā”€ workflows/ (batch execution)');
44
- console.log(' ā”œā”€ā”€ agents/ (AI agent configs)');
45
- console.log(' └── config/ (notifications, etc)\n');
46
-
47
- // Show ntfy topic if generated
48
- const notifyPath = join(process.cwd(), '.ai', 'config', 'notifications.json');
49
- if (existsSync(notifyPath)) {
50
- try {
51
- const config = JSON.parse(readFileSync(notifyPath, 'utf8'));
52
- const topic = config.channels?.ntfy?.topic;
53
- if (topic && !topic.includes('your-unique')) {
54
- console.log('šŸ”” Notifications:');
55
- console.log(` ntfy topic: ${topic}`);
56
- console.log(` Subscribe: https://ntfy.sh/${topic}`);
57
- console.log(' Enable: Edit .ai/config/notifications.json\n');
58
- }
59
- } catch {
60
- // Ignore
61
- }
62
- }
63
-
64
- console.log('šŸ“– Next steps:');
65
- console.log(' 1. Read: .ai/README.md');
66
- console.log(' 2. Start working with AI assistance\n');
67
- }
1
+ #!/usr/bin/env node
2
+ import { existsSync, readFileSync } from 'fs';
3
+ import { join } from 'path';
4
+ import { inject, detectKnownAIFiles } from '../src/core/inject.js';
5
+
6
+ export default async function injectCommand(args = []) {
7
+ const force = args.includes('--force') || args.includes('-f');
8
+
9
+ console.log('šŸš€ PWN Workspace Injection\n');
10
+
11
+ const result = await inject({ force });
12
+
13
+ // Show detected AI files (before success/failure message)
14
+ if (result.detected && result.detected.length > 0) {
15
+ const migratable = result.detected.filter(f => f.migratable);
16
+ const nonMigratable = result.detected.filter(f => !f.migratable);
17
+
18
+ console.log('āš ļø Detected existing AI instruction files:\n');
19
+ for (const file of result.detected) {
20
+ const migratableTag = file.migratable ? ' [migratable]' : '';
21
+ console.log(` šŸ“„ ${file.file}${migratableTag}`);
22
+ console.log(` Type: ${file.type} - ${file.description}`);
23
+ }
24
+
25
+ if (migratable.length > 0) {
26
+ console.log('\n šŸ”„ Run "pwn migrate" to automatically migrate content:');
27
+ console.log(' pwn migrate --dry-run # Preview changes');
28
+ console.log(' pwn migrate # Execute migration\n');
29
+ } else {
30
+ console.log('\n šŸ’” Consider migrating content manually to .ai/ structure:');
31
+ console.log(' - Instructions → .ai/agents/claude.md');
32
+ console.log(' - Decisions → .ai/memory/decisions.md');
33
+ console.log(' - Patterns → .ai/memory/patterns.md');
34
+ console.log(' - Tasks → .ai/tasks/active.md\n');
35
+ }
36
+ }
37
+
38
+ if (!result.success) {
39
+ if (result.error === 'ALREADY_EXISTS') {
40
+ console.log('āŒ .ai/ directory already exists in this project');
41
+ console.log(' Use --force to overwrite: pwn inject --force');
42
+ } else {
43
+ console.error('āŒ Injection failed:', result.message);
44
+ }
45
+ process.exit(1);
46
+ }
47
+
48
+ console.log('\nāœ… PWN workspace injected successfully!\n');
49
+ console.log('šŸ“ Created structure:');
50
+ console.log(' .ai/');
51
+ console.log(' ā”œā”€ā”€ memory/ (decisions, patterns, dead-ends)');
52
+ console.log(' ā”œā”€ā”€ tasks/ (active work, backlog)');
53
+ console.log(' ā”œā”€ā”€ patterns/ (auto-applied patterns)');
54
+ console.log(' ā”œā”€ā”€ workflows/ (batch execution)');
55
+ console.log(' ā”œā”€ā”€ agents/ (AI agent configs)');
56
+ console.log(' └── config/ (notifications, etc)\n');
57
+
58
+ // Show ntfy topic if generated
59
+ const notifyPath = join(process.cwd(), '.ai', 'config', 'notifications.json');
60
+ if (existsSync(notifyPath)) {
61
+ try {
62
+ const config = JSON.parse(readFileSync(notifyPath, 'utf8'));
63
+ const topic = config.channels?.ntfy?.topic;
64
+ if (topic && !topic.includes('your-unique')) {
65
+ console.log('šŸ”” Notifications:');
66
+ console.log(` ntfy topic: ${topic}`);
67
+ console.log(` Subscribe: https://ntfy.sh/${topic}`);
68
+ console.log(' Enable: Edit .ai/config/notifications.json\n');
69
+ }
70
+ } catch {
71
+ // Ignore
72
+ }
73
+ }
74
+
75
+ console.log('šŸ“– Next steps:');
76
+ console.log(' 1. Read: .ai/README.md');
77
+ console.log(' 2. Start working with AI assistance\n');
78
+ }