gistajs 0.1.2 → 0.1.3

package/README.md

@@ -1,6 +1,6 @@
 # gistajs
 
-Small CLI for creating Gista.js starter projects.
+Small CLI for scaffolding and managing Gista.js starter projects.
 
 ## Usage
 
@@ -9,6 +9,9 @@ npx gistajs create my-app
 npx gistajs create my-app --starter website --no-install --no-git
 ```
 
+Today the CLI covers project creation, starter diffs, pin management, and Turso provisioning.
+Vercel provisioning is the next intended provider in the same command family.
+
 ### Diff
 
 Compare the starter changes since your project's pinned release:
@@ -31,6 +34,32 @@ Advance your project pin after accepting an upgrade:
 npx gistajs pin 2026-04-01-001
 ```
 
+### Pin Model
+
+Scaffolded projects carry one base starter lineage for their lifetime.
+That baseline lives in `package.json` as `gistajs.pin`:
+
+```json
+{
+  "gistajs": {
+    "pin": "form:2026-04-01-001"
+  }
+}
+```
+
+`gistajs diff --latest` uses that pin as the starting point and compares it to the latest published release for the same starter.
+After you accept an upgrade, advance the pin explicitly with `gistajs pin <release-key>`.
+
+### Provision
+
+Provision a Turso database for the current project and write `DB_URL` plus `DB_AUTH_TOKEN` into `.env`:
+
+```bash
+npx gistajs provision turso
+```
+
+The command is interactive. It checks Turso login state, lets you choose an org when needed, prompts for a database name and group, and asks before overwriting existing database credentials in `.env`.
+
 ## Development
 
 ```bash