@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.
- package/README.md +84 -0
- package/dist/bin/traqr.d.ts +20 -0
- package/dist/bin/traqr.d.ts.map +1 -0
- package/dist/bin/traqr.js +104 -0
- package/dist/bin/traqr.js.map +1 -0
- package/dist/commands/init.d.ts +8 -0
- package/dist/commands/init.d.ts.map +1 -0
- package/dist/commands/init.js +772 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/projects.d.ts +9 -0
- package/dist/commands/projects.d.ts.map +1 -0
- package/dist/commands/projects.js +78 -0
- package/dist/commands/projects.js.map +1 -0
- package/dist/commands/render.d.ts +12 -0
- package/dist/commands/render.d.ts.map +1 -0
- package/dist/commands/render.js +49 -0
- package/dist/commands/render.js.map +1 -0
- package/dist/commands/setup.d.ts +8 -0
- package/dist/commands/setup.d.ts.map +1 -0
- package/dist/commands/setup.js +343 -0
- package/dist/commands/setup.js.map +1 -0
- package/dist/commands/status.d.ts +8 -0
- package/dist/commands/status.d.ts.map +1 -0
- package/dist/commands/status.js +46 -0
- package/dist/commands/status.js.map +1 -0
- package/dist/index.d.ts +8 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -0
- package/dist/lib/checks.d.ts +8 -0
- package/dist/lib/checks.d.ts.map +1 -0
- package/dist/lib/checks.js +45 -0
- package/dist/lib/checks.js.map +1 -0
- package/dist/lib/prompts.d.ts +24 -0
- package/dist/lib/prompts.d.ts.map +1 -0
- package/dist/lib/prompts.js +76 -0
- package/dist/lib/prompts.js.map +1 -0
- package/dist/lib/writer.d.ts +22 -0
- package/dist/lib/writer.d.ts.map +1 -0
- package/dist/lib/writer.js +43 -0
- package/dist/lib/writer.js.map +1 -0
- 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 @@
|
|
|
1
|
+
{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
|