GSP Commands 0.1

init

Create a minimal GSP project.

gsp init [path] [--name project-name] [--entry project.entry] [--force]

Generated structure:

project/
  gsp.manifest
  design/
    project.entry.gsp

Create AI-facing usage files for a GSP project.

gsp ai-init [--root .] [--agents] [--skill generic|codex] [--all] [--force]

Default output:

README.md
AI_USAGE.md

Optional output:

AGENTS.md
skills/gsp/SKILL.md
.codex/skills/gsp/SKILL.md

Print toolkit and protocol versions.

gsp version
gsp version --json

Validate GSP files and references.

gsp validate [--root .] [--out report.json]

Build a stable GSP index.

gsp index [--root .] [--out index.json]

Inspect relation chains from one GSP id.

gsp trace <id> [--root .] [--depth 3] [--out trace.json]

Expand one GSP id into a flat context.

gsp flatten <id> [--root .] [--depth 3] [--include-type a,b] [--exclude-type a,b] [--out flattened.json]

Create a compact AI context pack.

gsp pack <id> [--root .] [--depth 3] [--budget 12000] [--out context-pack.json]

Generate a relation graph.

gsp graph [id] [--root .] [--depth 3] [--format json|mermaid] [--out graph.json]

Check minimum resolution for a stage.

gsp stage-check --stage implement [--root .] [--out stage-report.json]