@fractary/core-cli 0.4.9 → 0.4.15
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 +298 -121
- package/dist/cli.js +5 -2
- package/dist/cli.js.map +1 -1
- package/dist/commands/config.d.ts +6 -1
- package/dist/commands/config.d.ts.map +1 -1
- package/dist/commands/config.js +197 -12
- package/dist/commands/config.js.map +1 -1
- package/dist/commands/docs/doc.d.ts +3 -0
- package/dist/commands/docs/doc.d.ts.map +1 -1
- package/dist/commands/docs/doc.js +357 -0
- package/dist/commands/docs/doc.js.map +1 -1
- package/dist/commands/docs/index.d.ts.map +1 -1
- package/dist/commands/docs/index.js +4 -0
- package/dist/commands/docs/index.js.map +1 -1
- package/dist/commands/file/index.d.ts +3 -1
- package/dist/commands/file/index.d.ts.map +1 -1
- package/dist/commands/file/index.js +366 -57
- package/dist/commands/file/index.js.map +1 -1
- package/dist/commands/logs/index.d.ts +19 -0
- package/dist/commands/logs/index.d.ts.map +1 -1
- package/dist/commands/logs/index.js +22 -2
- package/dist/commands/logs/index.js.map +1 -1
- package/dist/commands/spec/index.d.ts +3 -1
- package/dist/commands/spec/index.d.ts.map +1 -1
- package/dist/commands/spec/index.js +16 -248
- package/dist/commands/spec/index.js.map +1 -1
- package/dist/commands/spec/spec.d.ts +13 -0
- package/dist/commands/spec/spec.d.ts.map +1 -0
- package/dist/commands/spec/spec.js +418 -0
- package/dist/commands/spec/spec.js.map +1 -0
- package/dist/commands/spec/template.d.ts +6 -0
- package/dist/commands/spec/template.d.ts.map +1 -0
- package/dist/commands/spec/template.js +38 -0
- package/dist/commands/spec/template.js.map +1 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -7,15 +7,15 @@ Command-line interface for Fractary Core SDK - work tracking, repository managem
|
|
|
7
7
|
|
|
8
8
|
## Overview
|
|
9
9
|
|
|
10
|
-
The Fractary Core CLI provides command-line access to all core operations including work tracking, repository management, specification management, logging, file storage, and documentation. It
|
|
10
|
+
The Fractary Core CLI provides command-line access to all core operations including configuration management, work tracking, repository management, specification management, logging, file storage, and documentation. It is designed for automation, scripting, and CI/CD integration.
|
|
11
11
|
|
|
12
12
|
### Key Features
|
|
13
13
|
|
|
14
|
-
- **
|
|
14
|
+
- **7 Command Modules**: config, work, repo, spec, logs, file, docs
|
|
15
15
|
- **Multi-Platform Support**: GitHub, GitLab, Bitbucket, Jira, Linear
|
|
16
|
-
- **JSON Output**: Machine-readable output for scripting
|
|
17
|
-
- **Configuration
|
|
18
|
-
- **Environment
|
|
16
|
+
- **JSON Output**: Machine-readable output for scripting (`--json` flag on all commands)
|
|
17
|
+
- **YAML Configuration**: Unified configuration at `.fractary/config.yaml`
|
|
18
|
+
- **Environment Management**: Switch between dev, staging, and production environments
|
|
19
19
|
|
|
20
20
|
## Installation
|
|
21
21
|
|
|
@@ -29,58 +29,99 @@ npx @fractary/core-cli [command]
|
|
|
29
29
|
|
|
30
30
|
## Usage
|
|
31
31
|
|
|
32
|
-
The CLI provides
|
|
32
|
+
The CLI provides seven main command categories with dash-separated subcommand names:
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
fractary-core <command> [
|
|
35
|
+
fractary-core <module> <command> [arguments] [options]
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
### Configuration
|
|
39
|
+
|
|
40
|
+
Manage Fractary Core configuration and environments:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
# Initialize configuration
|
|
44
|
+
fractary-core config configure --work-platform github --file-handler local
|
|
45
|
+
|
|
46
|
+
# Validate configuration
|
|
47
|
+
fractary-core config validate
|
|
48
|
+
|
|
49
|
+
# Show configuration (sensitive values redacted)
|
|
50
|
+
fractary-core config show
|
|
51
|
+
|
|
52
|
+
# Switch environment
|
|
53
|
+
fractary-core config env-switch prod
|
|
54
|
+
|
|
55
|
+
# List available environments
|
|
56
|
+
fractary-core config env-list
|
|
57
|
+
|
|
58
|
+
# Show current environment status
|
|
59
|
+
fractary-core config env-show
|
|
60
|
+
|
|
61
|
+
# Clear environment credentials
|
|
62
|
+
fractary-core config env-clear
|
|
36
63
|
```
|
|
37
64
|
|
|
38
65
|
### Work Tracking
|
|
39
66
|
|
|
40
|
-
Manage work items, issues, and
|
|
67
|
+
Manage work items, issues, comments, and labels:
|
|
41
68
|
|
|
42
69
|
```bash
|
|
43
70
|
# Fetch an issue
|
|
44
|
-
fractary-core work issue
|
|
71
|
+
fractary-core work issue-fetch 123
|
|
45
72
|
|
|
46
73
|
# Create a new issue
|
|
47
|
-
fractary-core work issue
|
|
74
|
+
fractary-core work issue-create --title "Add feature" --body "Description"
|
|
48
75
|
|
|
49
76
|
# Search issues
|
|
50
|
-
fractary-core work issue
|
|
77
|
+
fractary-core work issue-search --query "bug" --state open
|
|
51
78
|
|
|
52
|
-
# Add comment
|
|
53
|
-
fractary-core work comment
|
|
79
|
+
# Add a comment
|
|
80
|
+
fractary-core work issue-comment 123 --body "Fixed in PR #456"
|
|
81
|
+
|
|
82
|
+
# List comments
|
|
83
|
+
fractary-core work issue-comment-list 123
|
|
54
84
|
|
|
55
85
|
# Manage labels
|
|
56
|
-
fractary-core work label
|
|
86
|
+
fractary-core work label-add 123 --labels "bug,urgent"
|
|
87
|
+
fractary-core work label-remove 123 --labels "wontfix"
|
|
88
|
+
fractary-core work label-list
|
|
89
|
+
|
|
90
|
+
# Classify work type
|
|
91
|
+
fractary-core work issue-classify 123
|
|
57
92
|
|
|
58
|
-
#
|
|
59
|
-
fractary-core work
|
|
93
|
+
# Configure work tracking
|
|
94
|
+
fractary-core work configure --platform github
|
|
60
95
|
```
|
|
61
96
|
|
|
62
97
|
### Repository Operations
|
|
63
98
|
|
|
64
|
-
Manage Git repositories, branches, commits,
|
|
99
|
+
Manage Git repositories, branches, commits, pull requests, tags, and worktrees:
|
|
65
100
|
|
|
66
101
|
```bash
|
|
67
102
|
# Create a branch
|
|
68
|
-
fractary-core repo branch
|
|
103
|
+
fractary-core repo branch-create feature/new-feature --base main --checkout
|
|
69
104
|
|
|
70
105
|
# Commit with conventional commits
|
|
71
106
|
fractary-core repo commit --message "Add login" --type feat --scope auth
|
|
72
107
|
|
|
73
108
|
# Create pull request
|
|
74
|
-
fractary-core repo pr
|
|
109
|
+
fractary-core repo pr-create --title "Add feature" --body "Description" --draft
|
|
110
|
+
|
|
111
|
+
# Merge pull request
|
|
112
|
+
fractary-core repo pr-merge 42 --strategy squash --delete-branch
|
|
75
113
|
|
|
76
114
|
# Manage tags
|
|
77
|
-
fractary-core repo tag
|
|
115
|
+
fractary-core repo tag-create v1.0.0 --message "Release 1.0.0"
|
|
116
|
+
fractary-core repo tag-push v1.0.0
|
|
78
117
|
|
|
79
118
|
# Work with worktrees
|
|
80
|
-
fractary-core repo worktree
|
|
119
|
+
fractary-core repo worktree-create feature-branch --base main
|
|
81
120
|
|
|
82
|
-
# Check status
|
|
121
|
+
# Check status, push, and pull
|
|
83
122
|
fractary-core repo status
|
|
123
|
+
fractary-core repo push --set-upstream
|
|
124
|
+
fractary-core repo pull --rebase
|
|
84
125
|
```
|
|
85
126
|
|
|
86
127
|
### Specification Management
|
|
@@ -89,104 +130,193 @@ Create and manage technical specifications:
|
|
|
89
130
|
|
|
90
131
|
```bash
|
|
91
132
|
# Create specification
|
|
92
|
-
fractary-core spec create "User Authentication" --template feature
|
|
133
|
+
fractary-core spec spec-create-file "User Authentication" --template feature
|
|
93
134
|
|
|
94
|
-
#
|
|
95
|
-
fractary-core spec
|
|
135
|
+
# Get specification
|
|
136
|
+
fractary-core spec spec-get SPEC-00123
|
|
96
137
|
|
|
97
138
|
# List specifications
|
|
98
|
-
fractary-core spec list --status validated
|
|
139
|
+
fractary-core spec spec-list --status validated
|
|
99
140
|
|
|
100
|
-
#
|
|
101
|
-
fractary-core spec
|
|
141
|
+
# Validate specification structure
|
|
142
|
+
fractary-core spec spec-validate-check SPEC-00123
|
|
143
|
+
|
|
144
|
+
# Scan for refinement gaps
|
|
145
|
+
fractary-core spec spec-refine-scan SPEC-00123
|
|
146
|
+
|
|
147
|
+
# Archive specs for a completed issue
|
|
148
|
+
fractary-core spec spec-archive 123
|
|
149
|
+
|
|
150
|
+
# List available templates
|
|
151
|
+
fractary-core spec template-list
|
|
102
152
|
```
|
|
103
153
|
|
|
104
154
|
### Log Management
|
|
105
155
|
|
|
106
|
-
Capture and manage operational logs:
|
|
156
|
+
Capture and manage operational logs with typed schemas:
|
|
107
157
|
|
|
108
158
|
```bash
|
|
159
|
+
# List available log types
|
|
160
|
+
fractary-core logs types
|
|
161
|
+
|
|
162
|
+
# Get log type definition
|
|
163
|
+
fractary-core logs type-info session
|
|
164
|
+
|
|
165
|
+
# Validate a log file against its type schema
|
|
166
|
+
fractary-core logs validate ./logs/session-2024-01-15.md
|
|
167
|
+
|
|
109
168
|
# Start session capture
|
|
110
169
|
fractary-core logs capture 123 --model claude-3.5-sonnet
|
|
111
170
|
|
|
171
|
+
# Stop session capture
|
|
172
|
+
fractary-core logs stop
|
|
173
|
+
|
|
112
174
|
# Write log entry
|
|
113
175
|
fractary-core logs write --type build --title "Build" --content "Success"
|
|
114
176
|
|
|
177
|
+
# Read a log entry
|
|
178
|
+
fractary-core logs read log-abc123
|
|
179
|
+
|
|
115
180
|
# Search logs
|
|
116
181
|
fractary-core logs search --query "error" --type session
|
|
117
182
|
|
|
183
|
+
# List logs
|
|
184
|
+
fractary-core logs list --type build --limit 20
|
|
185
|
+
|
|
118
186
|
# Archive old logs
|
|
119
|
-
fractary-core logs archive --max-age 90
|
|
187
|
+
fractary-core logs archive --max-age 90 --compress
|
|
188
|
+
|
|
189
|
+
# Delete a log
|
|
190
|
+
fractary-core logs delete log-abc123
|
|
120
191
|
```
|
|
121
192
|
|
|
122
193
|
### File Storage
|
|
123
194
|
|
|
124
|
-
Manage file storage operations:
|
|
195
|
+
Manage file storage operations with multi-source support:
|
|
125
196
|
|
|
126
197
|
```bash
|
|
127
|
-
#
|
|
198
|
+
# Upload a local file
|
|
199
|
+
fractary-core file upload ./data.json --remote-path "backups/data.json"
|
|
200
|
+
|
|
201
|
+
# Download a file
|
|
202
|
+
fractary-core file download "backups/data.json" --local-path ./data.json
|
|
203
|
+
|
|
204
|
+
# Write content directly
|
|
128
205
|
fractary-core file write data.json --content '{"key":"value"}'
|
|
129
206
|
|
|
130
|
-
# Read file
|
|
207
|
+
# Read file content
|
|
131
208
|
fractary-core file read data.json
|
|
132
209
|
|
|
133
210
|
# List files
|
|
134
211
|
fractary-core file list --prefix "data/"
|
|
135
212
|
|
|
136
|
-
#
|
|
213
|
+
# Check if file exists
|
|
214
|
+
fractary-core file exists data.json
|
|
215
|
+
|
|
216
|
+
# Copy and move files
|
|
137
217
|
fractary-core file copy source.txt destination.txt
|
|
218
|
+
fractary-core file move old-path.txt new-path.txt
|
|
219
|
+
|
|
220
|
+
# Get a URL for a file
|
|
221
|
+
fractary-core file get-url report.pdf --expires-in 3600
|
|
222
|
+
|
|
223
|
+
# Show file plugin configuration
|
|
224
|
+
fractary-core file show-config
|
|
225
|
+
|
|
226
|
+
# Test storage connection
|
|
227
|
+
fractary-core file test-connection --source my-s3-bucket
|
|
138
228
|
```
|
|
139
229
|
|
|
140
230
|
### Documentation Management
|
|
141
231
|
|
|
142
|
-
Create and manage documentation:
|
|
232
|
+
Create and manage typed documentation:
|
|
143
233
|
|
|
144
234
|
```bash
|
|
145
235
|
# Create document
|
|
146
|
-
fractary-core docs create guide-001 \
|
|
236
|
+
fractary-core docs doc-create guide-001 \
|
|
147
237
|
--title "User Guide" \
|
|
148
238
|
--content "..." \
|
|
149
239
|
--format markdown \
|
|
240
|
+
--doc-type api \
|
|
150
241
|
--tags "guide,user"
|
|
151
242
|
|
|
243
|
+
# Get a document
|
|
244
|
+
fractary-core docs doc-get guide-001
|
|
245
|
+
|
|
152
246
|
# Search documents
|
|
153
|
-
fractary-core docs search --text "authentication" --tags "api"
|
|
247
|
+
fractary-core docs doc-search --text "authentication" --tags "api" --doc-type adr
|
|
154
248
|
|
|
155
249
|
# List documents
|
|
156
|
-
fractary-core docs list --category "guides"
|
|
250
|
+
fractary-core docs doc-list --category "guides"
|
|
251
|
+
|
|
252
|
+
# Update a document
|
|
253
|
+
fractary-core docs doc-update guide-001 --content "..." --title "Updated Guide"
|
|
254
|
+
|
|
255
|
+
# Delete a document
|
|
256
|
+
fractary-core docs doc-delete guide-001
|
|
257
|
+
|
|
258
|
+
# Archive a document
|
|
259
|
+
fractary-core docs doc-archive guide-001
|
|
260
|
+
|
|
261
|
+
# Scan for gaps and refinement areas
|
|
262
|
+
fractary-core docs doc-refine-scan guide-001
|
|
263
|
+
|
|
264
|
+
# Validate implementation fulfillment
|
|
265
|
+
fractary-core docs doc-validate-fulfillment spec-001
|
|
266
|
+
|
|
267
|
+
# List available document types
|
|
268
|
+
fractary-core docs type-list
|
|
269
|
+
|
|
270
|
+
# Get document type details
|
|
271
|
+
fractary-core docs type-info adr --template
|
|
157
272
|
```
|
|
158
273
|
|
|
159
274
|
## Configuration
|
|
160
275
|
|
|
161
|
-
The CLI uses configuration
|
|
162
|
-
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
276
|
+
The CLI uses a unified YAML configuration file at `.fractary/config.yaml`:
|
|
277
|
+
|
|
278
|
+
```yaml
|
|
279
|
+
version: "2.0"
|
|
280
|
+
|
|
281
|
+
work:
|
|
282
|
+
active_handler: github
|
|
283
|
+
handlers:
|
|
284
|
+
github:
|
|
285
|
+
owner: fractary
|
|
286
|
+
repo: core
|
|
287
|
+
token: ${GITHUB_TOKEN}
|
|
288
|
+
|
|
289
|
+
repo:
|
|
290
|
+
active_handler: github
|
|
291
|
+
handlers:
|
|
292
|
+
github:
|
|
293
|
+
owner: fractary
|
|
294
|
+
repo: core
|
|
295
|
+
token: ${GITHUB_TOKEN}
|
|
296
|
+
merge:
|
|
297
|
+
strategy: squash # options: squash, merge, rebase
|
|
298
|
+
|
|
299
|
+
file:
|
|
300
|
+
active_handler: local
|
|
301
|
+
handlers:
|
|
302
|
+
local:
|
|
303
|
+
base_path: .fractary/files
|
|
176
304
|
```
|
|
177
305
|
|
|
178
|
-
Initialize configuration
|
|
306
|
+
Initialize configuration:
|
|
179
307
|
|
|
180
308
|
```bash
|
|
181
|
-
fractary-core
|
|
309
|
+
fractary-core config configure --work-platform github --file-handler local
|
|
182
310
|
```
|
|
183
311
|
|
|
312
|
+
Environment variables are referenced using `${VAR_NAME}` syntax in the config file and resolved at runtime from `.env` files. Manage environments with `config env-*` commands.
|
|
313
|
+
|
|
184
314
|
## JSON Output
|
|
185
315
|
|
|
186
|
-
All commands support `--json` flag for machine-readable output:
|
|
316
|
+
All commands support the `--json` flag for machine-readable output:
|
|
187
317
|
|
|
188
318
|
```bash
|
|
189
|
-
fractary-core work issue
|
|
319
|
+
fractary-core work issue-fetch 123 --json
|
|
190
320
|
```
|
|
191
321
|
|
|
192
322
|
Output format:
|
|
@@ -202,6 +332,18 @@ Output format:
|
|
|
202
332
|
}
|
|
203
333
|
```
|
|
204
334
|
|
|
335
|
+
Error output format:
|
|
336
|
+
|
|
337
|
+
```json
|
|
338
|
+
{
|
|
339
|
+
"status": "error",
|
|
340
|
+
"error": {
|
|
341
|
+
"code": "NOT_FOUND",
|
|
342
|
+
"message": "Issue not found: 999"
|
|
343
|
+
}
|
|
344
|
+
}
|
|
345
|
+
```
|
|
346
|
+
|
|
205
347
|
## Programmatic Usage
|
|
206
348
|
|
|
207
349
|
Import and use CLI components programmatically:
|
|
@@ -223,87 +365,122 @@ program.parse();
|
|
|
223
365
|
|
|
224
366
|
## Command Reference
|
|
225
367
|
|
|
368
|
+
### Config Commands
|
|
369
|
+
|
|
370
|
+
| Command | Description |
|
|
371
|
+
|---------|-------------|
|
|
372
|
+
| `config configure` | Initialize or update `.fractary/config.yaml` |
|
|
373
|
+
| `config validate` | Validate `.fractary/config.yaml` |
|
|
374
|
+
| `config show` | Display configuration (sensitive values redacted) |
|
|
375
|
+
| `config env-switch <name>` | Switch to a different environment |
|
|
376
|
+
| `config env-list` | List available environments |
|
|
377
|
+
| `config env-show` | Show current environment status |
|
|
378
|
+
| `config env-clear` | Clear environment credentials |
|
|
379
|
+
|
|
226
380
|
### Work Commands
|
|
227
381
|
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
- `work init` - Initialize work tracking
|
|
382
|
+
| Command | Description |
|
|
383
|
+
|---------|-------------|
|
|
384
|
+
| `work issue-fetch <number>` | Fetch a work item by ID |
|
|
385
|
+
| `work issue-create` | Create a new work item |
|
|
386
|
+
| `work issue-update <number>` | Update a work item |
|
|
387
|
+
| `work issue-close <number>` | Close a work item |
|
|
388
|
+
| `work issue-reopen <number>` | Reopen a closed work item |
|
|
389
|
+
| `work issue-assign <number>` | Assign or unassign a work item |
|
|
390
|
+
| `work issue-classify <number>` | Classify work item type (feature, bug, chore, patch) |
|
|
391
|
+
| `work issue-search` | Search work items |
|
|
392
|
+
| `work issue-comment <number>` | Add a comment to a work item |
|
|
393
|
+
| `work issue-comment-list <number>` | List comments on a work item |
|
|
394
|
+
| `work label-add <number>` | Add labels to a work item |
|
|
395
|
+
| `work label-remove <number>` | Remove labels from a work item |
|
|
396
|
+
| `work label-list` | List all available labels |
|
|
397
|
+
| `work configure` | Configure work tracking settings |
|
|
245
398
|
|
|
246
399
|
### Repo Commands
|
|
247
400
|
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
401
|
+
| Command | Description |
|
|
402
|
+
|---------|-------------|
|
|
403
|
+
| `repo branch-create <name>` | Create a new branch |
|
|
404
|
+
| `repo branch-delete <name>` | Delete a branch |
|
|
405
|
+
| `repo branch-list` | List branches |
|
|
406
|
+
| `repo commit` | Create a commit with conventional commit format |
|
|
407
|
+
| `repo pr-create` | Create a new pull request |
|
|
408
|
+
| `repo pr-list` | List pull requests |
|
|
409
|
+
| `repo pr-merge <number>` | Merge a pull request |
|
|
410
|
+
| `repo pr-review <number>` | Review a pull request |
|
|
411
|
+
| `repo tag-create <name>` | Create a new tag |
|
|
412
|
+
| `repo tag-push <name>` | Push tag(s) to remote |
|
|
413
|
+
| `repo tag-list` | List tags |
|
|
414
|
+
| `repo worktree-create <branch>` | Create a new worktree |
|
|
415
|
+
| `repo worktree-list` | List worktrees |
|
|
416
|
+
| `repo worktree-remove <path>` | Remove a worktree |
|
|
417
|
+
| `repo worktree-cleanup` | Clean up stale worktrees |
|
|
418
|
+
| `repo status` | Show repository status |
|
|
419
|
+
| `repo push` | Push commits to remote |
|
|
420
|
+
| `repo pull` | Pull changes from remote |
|
|
266
421
|
|
|
267
422
|
### Spec Commands
|
|
268
423
|
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
424
|
+
| Command | Description |
|
|
425
|
+
|---------|-------------|
|
|
426
|
+
| `spec spec-create-file <title>` | Create a new specification file |
|
|
427
|
+
| `spec spec-get <id>` | Get a specification by ID or path |
|
|
428
|
+
| `spec spec-list` | List specifications |
|
|
429
|
+
| `spec spec-update <id>` | Update a specification |
|
|
430
|
+
| `spec spec-delete <id>` | Delete a specification |
|
|
431
|
+
| `spec spec-validate-check <id>` | Run structural validation checks |
|
|
432
|
+
| `spec spec-refine-scan <id>` | Scan for structural gaps and refinement areas |
|
|
433
|
+
| `spec spec-archive <issue_number>` | Archive specifications for a completed issue |
|
|
434
|
+
| `spec template-list` | List available specification templates |
|
|
277
435
|
|
|
278
436
|
### Logs Commands
|
|
279
437
|
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
438
|
+
| Command | Description |
|
|
439
|
+
|---------|-------------|
|
|
440
|
+
| `logs types` | List available log types |
|
|
441
|
+
| `logs type-info <type>` | Get log type definition |
|
|
442
|
+
| `logs validate <file>` | Validate a log file against its type schema |
|
|
443
|
+
| `logs capture <issue_number>` | Start session capture |
|
|
444
|
+
| `logs stop` | Stop session capture |
|
|
445
|
+
| `logs write` | Write a log entry |
|
|
446
|
+
| `logs read <id>` | Read a log entry |
|
|
447
|
+
| `logs search` | Search logs |
|
|
448
|
+
| `logs list` | List logs |
|
|
449
|
+
| `logs archive` | Archive old logs |
|
|
450
|
+
| `logs delete <id>` | Delete a log entry |
|
|
288
451
|
|
|
289
452
|
### File Commands
|
|
290
453
|
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
454
|
+
| Command | Description |
|
|
455
|
+
|---------|-------------|
|
|
456
|
+
| `file upload <local-path>` | Upload a local file to storage |
|
|
457
|
+
| `file download <remote-path>` | Download a file from storage to local path |
|
|
458
|
+
| `file write <path>` | Write content to a storage path |
|
|
459
|
+
| `file read <path>` | Read content from a storage path |
|
|
460
|
+
| `file list` | List files in storage |
|
|
461
|
+
| `file delete <path>` | Delete a file from storage |
|
|
462
|
+
| `file exists <path>` | Check if a file exists in storage |
|
|
463
|
+
| `file copy <src> <dest>` | Copy a file within storage |
|
|
464
|
+
| `file move <src> <dest>` | Move a file within storage |
|
|
465
|
+
| `file get-url <path>` | Get a URL for a file in storage |
|
|
466
|
+
| `file show-config` | Show file plugin configuration |
|
|
467
|
+
| `file test-connection` | Test storage connection |
|
|
298
468
|
|
|
299
469
|
### Docs Commands
|
|
300
470
|
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
471
|
+
| Command | Description |
|
|
472
|
+
|---------|-------------|
|
|
473
|
+
| `docs doc-create <id>` | Create a new document |
|
|
474
|
+
| `docs doc-get <id>` | Get a document |
|
|
475
|
+
| `docs doc-list` | List documents |
|
|
476
|
+
| `docs doc-update <id>` | Update a document |
|
|
477
|
+
| `docs doc-delete <id>` | Delete a document |
|
|
478
|
+
| `docs doc-search` | Search documents |
|
|
479
|
+
| `docs doc-archive <id>` | Archive a document |
|
|
480
|
+
| `docs doc-refine-scan <id>` | Scan for gaps and generate refinement questions |
|
|
481
|
+
| `docs doc-validate-fulfillment <id>` | Validate implementation fulfillment |
|
|
482
|
+
| `docs type-list` | List available document types |
|
|
483
|
+
| `docs type-info <type>` | Get detailed info about a document type |
|
|
307
484
|
|
|
308
485
|
## Platform Support
|
|
309
486
|
|
package/dist/cli.js
CHANGED
|
@@ -28,7 +28,7 @@ const packageJson = require('../package.json');
|
|
|
28
28
|
const program = new commander_1.Command();
|
|
29
29
|
program
|
|
30
30
|
.name('fractary-core')
|
|
31
|
-
.description('CLI for Fractary Core SDK - work, repo, spec, logs, file, docs')
|
|
31
|
+
.description('CLI for Fractary Core SDK - config, work, repo, spec, logs, file, docs')
|
|
32
32
|
.version(packageJson.version);
|
|
33
33
|
// Add all command trees
|
|
34
34
|
program.addCommand((0, work_1.createWorkCommand)());
|
|
@@ -42,7 +42,7 @@ program.addCommand((0, docs_1.createDocsCommand)());
|
|
|
42
42
|
// Custom help text
|
|
43
43
|
program.addHelpText('after', `
|
|
44
44
|
${chalk_1.default.bold('Commands:')}
|
|
45
|
-
config Manage configuration (validate, show)
|
|
45
|
+
config Manage configuration (configure, validate, show, env-switch, env-list, env-show)
|
|
46
46
|
work Work item tracking (issues, comments, labels, milestones)
|
|
47
47
|
repo Repository operations (branches, commits, PRs, tags, worktrees)
|
|
48
48
|
spec Specification management (create, validate, refine)
|
|
@@ -51,8 +51,11 @@ ${chalk_1.default.bold('Commands:')}
|
|
|
51
51
|
docs Documentation management (create, search, export)
|
|
52
52
|
|
|
53
53
|
${chalk_1.default.bold('Examples:')}
|
|
54
|
+
$ fractary-core config configure --work-platform github --file-handler local
|
|
54
55
|
$ fractary-core config validate
|
|
55
56
|
$ fractary-core config show
|
|
57
|
+
$ fractary-core config env-switch prod
|
|
58
|
+
$ fractary-core config env-list
|
|
56
59
|
$ fractary-core work issue fetch 123
|
|
57
60
|
$ fractary-core repo commit --message "Add feature" --type feat
|
|
58
61
|
$ fractary-core spec validate SPEC-20241216
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAEA;;;;GAIG;;;;;AAEH,yCAAoC;AACpC,kDAA0B;AAC1B,kDAAgD;AAChD,0CAAoD;AACpD,0CAAoD;AACpD,0CAAoD;AACpD,0CAAoD;AACpD,0CAAoD;AACpD,0CAAoD;AACpD,8CAA0D;AAE1D,uEAAuE;AACvE,yEAAyE;AACzE,IAAA,gBAAO,GAAE,CAAC;AAEV,sBAAsB;AACtB,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE/C,sBAAsB;AACtB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,9 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Config command -
|
|
2
|
+
* Config command - Manage Fractary Core configuration
|
|
3
3
|
*
|
|
4
4
|
* Commands:
|
|
5
|
+
* - configure: Initialize .fractary/config.yaml with defaults
|
|
5
6
|
* - validate: Validate .fractary/core/config.yaml
|
|
6
7
|
* - show: Display config (redacted)
|
|
8
|
+
* - env-switch: Switch active environment
|
|
9
|
+
* - env-list: List available environments
|
|
10
|
+
* - env-show: Show current environment status
|
|
11
|
+
* - env-clear: Clear environment credentials
|
|
7
12
|
*/
|
|
8
13
|
import { Command } from 'commander';
|
|
9
14
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4fpC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmD5D"}
|