Add GSP init and AI usage tooling

specs/versions/0.1/commands.md

@@ -0,0 +1,106 @@
+# 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] [--out graph.json]
+```
+
+## stage-check
+
+Check minimum resolution for a stage.
+
+```bash
+gsp stage-check --stage implement [--root .] [--out stage-report.json]
+```