# 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]
```