@traqr/cli 0.1.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 (42) hide show
  1. package/README.md +84 -0
  2. package/dist/bin/traqr.d.ts +20 -0
  3. package/dist/bin/traqr.d.ts.map +1 -0
  4. package/dist/bin/traqr.js +104 -0
  5. package/dist/bin/traqr.js.map +1 -0
  6. package/dist/commands/init.d.ts +8 -0
  7. package/dist/commands/init.d.ts.map +1 -0
  8. package/dist/commands/init.js +772 -0
  9. package/dist/commands/init.js.map +1 -0
  10. package/dist/commands/projects.d.ts +9 -0
  11. package/dist/commands/projects.d.ts.map +1 -0
  12. package/dist/commands/projects.js +78 -0
  13. package/dist/commands/projects.js.map +1 -0
  14. package/dist/commands/render.d.ts +12 -0
  15. package/dist/commands/render.d.ts.map +1 -0
  16. package/dist/commands/render.js +49 -0
  17. package/dist/commands/render.js.map +1 -0
  18. package/dist/commands/setup.d.ts +8 -0
  19. package/dist/commands/setup.d.ts.map +1 -0
  20. package/dist/commands/setup.js +343 -0
  21. package/dist/commands/setup.js.map +1 -0
  22. package/dist/commands/status.d.ts +8 -0
  23. package/dist/commands/status.d.ts.map +1 -0
  24. package/dist/commands/status.js +46 -0
  25. package/dist/commands/status.js.map +1 -0
  26. package/dist/index.d.ts +8 -0
  27. package/dist/index.d.ts.map +1 -0
  28. package/dist/index.js +8 -0
  29. package/dist/index.js.map +1 -0
  30. package/dist/lib/checks.d.ts +8 -0
  31. package/dist/lib/checks.d.ts.map +1 -0
  32. package/dist/lib/checks.js +45 -0
  33. package/dist/lib/checks.js.map +1 -0
  34. package/dist/lib/prompts.d.ts +24 -0
  35. package/dist/lib/prompts.d.ts.map +1 -0
  36. package/dist/lib/prompts.js +76 -0
  37. package/dist/lib/prompts.js.map +1 -0
  38. package/dist/lib/writer.d.ts +22 -0
  39. package/dist/lib/writer.d.ts.map +1 -0
  40. package/dist/lib/writer.js +43 -0
  41. package/dist/lib/writer.js.map +1 -0
  42. package/package.json +52 -0
package/README.md ADDED
@@ -0,0 +1,84 @@
1
+ # @traqr/cli
2
+
3
+ CLI entry point for the Traqr platform. Interactive setup wizard, template rendering, and server management.
4
+
5
+ ## Quick Start
6
+
7
+ ```bash
8
+ # Initialize a new project
9
+ npx traqr init
10
+
11
+ # Re-render templates after config changes
12
+ npx traqr render
13
+
14
+ # Check config and service health
15
+ npx traqr status
16
+ ```
17
+
18
+ ## Commands
19
+
20
+ ### `traqr init`
21
+
22
+ Interactive project setup wizard:
23
+ 1. Detects git remote, package manager, framework
24
+ 2. Prompts for project name, description, GitHub org/repo
25
+ 3. Choose a starter pack (solo/smart/production/full)
26
+ 4. Renders all templates and writes to disk
27
+ 5. Creates `.traqr/config.json`
28
+
29
+ ### `traqr render`
30
+
31
+ Non-interactive template render from `.traqr/config.json`.
32
+
33
+ ```bash
34
+ traqr render # Write files (skip existing)
35
+ traqr render --dry-run # Print to stdout
36
+ traqr render --force # Overwrite existing files
37
+ ```
38
+
39
+ ### `traqr daemon`
40
+
41
+ Start the daemon orchestrator server.
42
+
43
+ ```bash
44
+ traqr daemon # Default port 4200
45
+ traqr daemon --port 4201 # Custom port
46
+ ```
47
+
48
+ ### `traqr memory`
49
+
50
+ Start the memory vector DB server.
51
+
52
+ ```bash
53
+ traqr memory # Default port 4100
54
+ traqr memory --port 4101 # Custom port
55
+ ```
56
+
57
+ Requires: `SUPABASE_URL`, `SUPABASE_SERVICE_ROLE_KEY`, `OPENAI_API_KEY`
58
+
59
+ ### `traqr guardian`
60
+
61
+ Stub — Guardian requires dependency injection. Use `GuardianPlugin` as a library via `@traqr/daemon`.
62
+
63
+ ### `traqr status`
64
+
65
+ Show project config summary and ping running services.
66
+
67
+ ```bash
68
+ traqr status
69
+ # Project: NookTraqr
70
+ # Config: /path/to/.traqr/config.json
71
+ # Tier: 4 (full)
72
+ # Score: 87/100
73
+ # Daemon: UP
74
+ # Memory: UP
75
+ ```
76
+
77
+ ## Programmatic API
78
+
79
+ ```typescript
80
+ import { writeFiles } from '@traqr/cli'
81
+
82
+ const result = await writeFiles(files, baseDir, { dryRun: false, force: true })
83
+ console.log(`Written: ${result.written.length}, Skipped: ${result.skipped.length}`)
84
+ ```
@@ -0,0 +1,20 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * @traqr/cli — Entry Point
4
+ *
5
+ * Subcommand router. Dynamic imports keep startup fast —
6
+ * only the command you run gets loaded.
7
+ *
8
+ * Universal commands only — runtime commands (daemon, memory, guardian)
9
+ * are project-level scripts, not CLI subcommands.
10
+ *
11
+ * Usage:
12
+ * traqr init Interactive project setup wizard
13
+ * traqr new Alias for init (scaffold a new project)
14
+ * traqr setup Create or update global profile (~/.traqr/config.json)
15
+ * traqr projects List and manage registered projects
16
+ * traqr render Render templates from .traqr/config.json
17
+ * traqr status Show config summary + health
18
+ */
19
+ export {};
20
+ //# sourceMappingURL=traqr.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"traqr.d.ts","sourceRoot":"","sources":["../../src/bin/traqr.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}
@@ -0,0 +1,104 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * @traqr/cli — Entry Point
4
+ *
5
+ * Subcommand router. Dynamic imports keep startup fast —
6
+ * only the command you run gets loaded.
7
+ *
8
+ * Universal commands only — runtime commands (daemon, memory, guardian)
9
+ * are project-level scripts, not CLI subcommands.
10
+ *
11
+ * Usage:
12
+ * traqr init Interactive project setup wizard
13
+ * traqr new Alias for init (scaffold a new project)
14
+ * traqr setup Create or update global profile (~/.traqr/config.json)
15
+ * traqr projects List and manage registered projects
16
+ * traqr render Render templates from .traqr/config.json
17
+ * traqr status Show config summary + health
18
+ */
19
+ const command = process.argv[2];
20
+ async function main() {
21
+ switch (command) {
22
+ case 'init':
23
+ case 'new':
24
+ await import('../commands/init.js');
25
+ break;
26
+ case 'projects':
27
+ await import('../commands/projects.js');
28
+ break;
29
+ case 'setup':
30
+ await import('../commands/setup.js');
31
+ break;
32
+ case 'render':
33
+ await import('../commands/render.js');
34
+ break;
35
+ case 'status':
36
+ await import('../commands/status.js');
37
+ break;
38
+ case '--help':
39
+ case '-h':
40
+ printUsage();
41
+ break;
42
+ case undefined: {
43
+ try {
44
+ const { loadOrgConfig } = await import('@traqr/core');
45
+ const { config } = loadOrgConfig();
46
+ if (!config) {
47
+ console.log(`
48
+ Welcome to Traqr!
49
+
50
+ Get started:
51
+ traqr init Set up Traqr in any project
52
+ traqr setup Create your global profile (optional, init can do this)
53
+ traqr --help See all commands
54
+ `);
55
+ break;
56
+ }
57
+ }
58
+ catch { /* core not available, fall through */ }
59
+ printUsage();
60
+ break;
61
+ }
62
+ case '--version':
63
+ case '-v':
64
+ console.log('0.0.1');
65
+ break;
66
+ default:
67
+ console.error(`Unknown command: ${command}`);
68
+ console.error('');
69
+ printUsage();
70
+ process.exit(1);
71
+ }
72
+ }
73
+ function printUsage() {
74
+ console.log(`
75
+ @traqr/cli v0.0.1
76
+
77
+ Usage: traqr <command> [options]
78
+
79
+ Commands:
80
+ init Interactive project setup wizard
81
+ new Alias for init (scaffold a new project)
82
+ setup Create or update global profile (~/.traqr/config.json)
83
+ projects List and manage registered projects
84
+ render Render templates from .traqr/config.json
85
+ status Show config summary + health
86
+
87
+ Options:
88
+ --help, -h Show this help message
89
+ --version, -v Show version
90
+
91
+ Examples:
92
+ npx traqr init
93
+ npx traqr render --dry-run
94
+ npx traqr status
95
+ `);
96
+ }
97
+ // Suppress unhandled rejection noise
98
+ process.on('unhandledRejection', (err) => {
99
+ console.error(err instanceof Error ? err.message : err);
100
+ process.exit(1);
101
+ });
102
+ void main();
103
+ export {};
104
+ //# sourceMappingURL=traqr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"traqr.js","sourceRoot":"","sources":["../../src/bin/traqr.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAE/B,KAAK,UAAU,IAAI;IACjB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACR,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAA;YACnC,MAAK;QACP,KAAK,UAAU;YACb,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;YACvC,MAAK;QACP,KAAK,OAAO;YACV,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAA;YACpC,MAAK;QACP,KAAK,QAAQ;YACX,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAA;YACrC,MAAK;QACP,KAAK,QAAQ;YACX,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAA;YACrC,MAAK;QACP,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,UAAU,EAAE,CAAA;YACZ,MAAK;QACP,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;gBACrD,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAAA;gBAClC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,CAAC,GAAG,CAAC;;;;;;;CAOrB,CAAC,CAAA;oBACQ,MAAK;gBACP,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,sCAAsC,CAAC,CAAC;YAClD,UAAU,EAAE,CAAA;YACZ,MAAK;QACP,CAAC;QACD,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACpB,MAAK;QACP;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAA;YAC5C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACjB,UAAU,EAAE,CAAA;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;CAqBb,CAAC,CAAA;AACF,CAAC;AAED,qCAAqC;AACrC,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE;IACvC,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA;AAEF,KAAK,IAAI,EAAE,CAAA"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * traqr init — Interactive project setup wizard
3
+ *
4
+ * Walks through project config, starter pack selection,
5
+ * and renders all templates to disk.
6
+ */
7
+ export {};
8
+ //# sourceMappingURL=init.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}