118 lines
1.7 KiB
Markdown
118 lines
1.7 KiB
Markdown
# GSP Commands 0.1
|
|
|
|
## init
|
|
|
|
Create a minimal GSP project.
|
|
|
|
```bash
|
|
gsp init [path] [--name project-name] [--entry project.entry] [--force]
|
|
```
|
|
|
|
Generated structure:
|
|
|
|
```text
|
|
project/
|
|
gsp.manifest
|
|
design/
|
|
project.entry.gsp
|
|
```
|
|
|
|
## ai-init
|
|
|
|
Create AI-facing usage files for a GSP project.
|
|
|
|
```bash
|
|
gsp ai-init [--root .] [--agents] [--skill generic|codex] [--all] [--force]
|
|
```
|
|
|
|
Default output:
|
|
|
|
```text
|
|
README.md
|
|
AI_USAGE.md
|
|
```
|
|
|
|
Optional output:
|
|
|
|
```text
|
|
AGENTS.md
|
|
skills/gsp/SKILL.md
|
|
.codex/skills/gsp/SKILL.md
|
|
```
|
|
|
|
## version
|
|
|
|
Print toolkit and protocol versions.
|
|
|
|
```bash
|
|
gsp version
|
|
gsp version --json
|
|
```
|
|
|
|
## validate
|
|
|
|
Validate GSP files and references.
|
|
|
|
```bash
|
|
gsp validate [--root .] [--out report.json]
|
|
```
|
|
|
|
## index
|
|
|
|
Build a stable GSP index.
|
|
|
|
```bash
|
|
gsp index [--root .] [--out index.json]
|
|
```
|
|
|
|
## trace
|
|
|
|
Inspect relation chains from one GSP id.
|
|
|
|
```bash
|
|
gsp trace <id> [--root .] [--depth 3] [--out trace.json]
|
|
```
|
|
|
|
## flatten
|
|
|
|
Expand one GSP id into a flat context.
|
|
|
|
```bash
|
|
gsp flatten <id> [--root .] [--depth 3] [--include-type a,b] [--exclude-type a,b] [--out flattened.json]
|
|
```
|
|
|
|
## pack
|
|
|
|
Create a compact AI context pack.
|
|
|
|
```bash
|
|
gsp pack <id> [--root .] [--depth 3] [--budget 12000] [--out context-pack.json]
|
|
```
|
|
|
|
## graph
|
|
|
|
Generate a relation graph.
|
|
|
|
```bash
|
|
gsp graph [id] [--root .] [--depth 3] [--format json|mermaid|md|canvas] [--out graph.json]
|
|
```
|
|
|
|
Formats:
|
|
|
|
```text
|
|
json Machine-readable graph.
|
|
mermaid Mermaid graph body.
|
|
md Markdown file with Mermaid block.
|
|
canvas Obsidian JSON Canvas file.
|
|
```
|
|
|
|
Graph display uses `title` when present and falls back to `id`.
|
|
|
|
## stage-check
|
|
|
|
Check minimum resolution for a stage.
|
|
|
|
```bash
|
|
gsp stage-check --stage implement [--root .] [--out stage-report.json]
|
|
```
|