Update example project

.prettierrc

@@ -1,5 +1,14 @@
 {
   "singleQuote": true,
   "tabWidth": 2,
-  "trailingComma": "all"
+  "trailingComma": "all",
+  "overrides": [
+    {
+      "files": "docs/**/*.json",
+      "options": {
+        "parser": "json-stringify",
+        "tabWidth": 4
+      }
+    }
+  ]
 }

CHANGELOG.md

@@ -6,10 +6,18 @@
 
 - **Create and edit models with `materialization` instead of deprecated top-level fields.** The wizard writes `materialization` (string or nested strategy/partitions) rather than `materialized`, `incremental_strategy`, and `partitioned_by`. Saving an edit removes those legacy keys from the file. jaffle_shop examples use the new shape.
 
+### Agent / CLI
+
+- **CLI request examples in every workspace.** Sample request files are copied to `.dj/examples/` on activation, so `dj <operation> --help` and the agent skills point at files that exist in your project.
+
 ### Framework
 
 - **Dynamic Lightdash custom granularities and expanded time intervals.** Custom time granularities defined in `lightdash.config.yml` (under `custom_granularities`) are dynamically discovered and loaded into model schemas and editor autocomplete. Built-in time intervals also now include `MINUTE`, `SECOND`, and `MILLISECOND`.
 
+### Documentation
+
+- **Single `jaffle_shop` example project.** Consolidates the two duplicate example dbt projects into one at `docs/examples/jaffle_shop`, which now includes the Lightdash examples. Docs, links, and the example walkthroughs point at this single project.
+
 ## 2.4.0
 
 ### Agent / CLI

docs/AGENT_SKILLS_PROJECT_GUIDELINES.md

@@ -6,13 +6,13 @@ Project-specific values live in a **project-owned layer** that DJ never overwrit
 
 ## What lives where
 
-| Layer | Location | DJ Refresh |
-| ----- | -------- | ---------- |
-| Generic workflows | `templates/skills/dj-*` → `.agents/skills/dj-*` | Overwrites |
-| Framework hub | `templates/_agents-dj` → `.agents/dj/` | Overwrites |
-| **Project defaults** | `.agents/project/skills/<skill-name>/project-defaults.md` | **Never touched** |
-| Copy-paste starters (DJ repo only) | `templates/_agents-project/skills/*/project-defaults.example.md` | Not deployed |
-| CLI binary | `.dj/bin/dj` | Redeployed on activation |
+| Layer                              | Location                                                         | DJ Refresh               |
+| ---------------------------------- | ---------------------------------------------------------------- | ------------------------ |
+| Generic workflows                  | `templates/skills/dj-*` → `.agents/skills/dj-*`                  | Overwrites               |
+| Framework hub                      | `templates/_agents-dj` → `.agents/dj/`                           | Overwrites               |
+| **Project defaults**               | `.agents/project/skills/<skill-name>/project-defaults.md`        | **Never touched**        |
+| Copy-paste starters (DJ repo only) | `templates/_agents-project/skills/*/project-defaults.example.md` | Not deployed             |
+| CLI binary                         | `.dj/bin/dj`                                                     | Redeployed on activation |
 
 Some repos also commit **project-only** skills (for example custom `dbt-*` skills) under `.agents/skills/` — those are unrelated to DJ's `dj-*` templates.
 

docs/TUTORIAL.md

@@ -239,7 +239,7 @@ Let's clean up the raw customer data using the DJ (Data JSON) Framework extensio
      "group": "customers",
      "topic": "profiles",
      "name": "clean",
-     "materialized": "ephemeral",
+     "materialization": "ephemeral",
      "from": {
        "source": "development__jaffle_shop_dev_seeds.raw_customers"
      },

docs/VISUAL_EDITOR.md

@@ -402,7 +402,7 @@ _From: [int\_\_products\_\_analytics\_\_product_popularity.model.json](examples/
 - Set AI hints for semantic layer
 - Configure metric merges
 
-**Example from jaffle_shop_lightdash:**
+**Example from jaffle_shop:**
 
 ```json
 {
@@ -424,7 +424,7 @@ _From: [int\_\_products\_\_analytics\_\_product_popularity.model.json](examples/
 }
 ```
 
-_From: [mart\_\_sales\_\_reporting\_\_profitability.model.json](examples/jaffle_shop_lightdash/models/marts/sales/reporting/mart__sales__reporting__profitability.model.json)_
+_From: [mart\_\_sales\_\_reporting\_\_profitability.model.json](examples/jaffle_shop/models/marts/sales/reporting/mart__sales__reporting__profitability.model.json)_
 
 See [Lightdash Integration](integrations/lightdash-integration.md) for complete Lightdash configuration examples.
 

docs/cli_commands/README.md → docs/cli/README.md

@@ -11,11 +11,8 @@ the CLI — it is a second transport into the extension.
 
 ## Documentation
 
-- [`command-reference.md`](command-reference.md) — the full command scope, request
-  shapes, and token/accuracy rationale.
-- [`agent-verification-prompts.md`](agent-verification-prompts.md) — copy-paste
-  prompts to verify **every** command with an AI agent directly.
-- [`phase-1-plan.md`](phase-1-plan.md) — the operation plan and what remains deferred.
+- [`command-reference.md`](command-reference.md) — the full command list, request
+  shapes, and usage examples.
 
 ## How it works
 
@@ -97,13 +94,13 @@ result JSON and exits `0`.
 
 ## Exit codes
 
-| Code | Meaning                                             |
-| ---- | --------------------------------------------------- |
-| `0`  | success                                             |
-| `1`  | operation error (e.g. "Model … already exists")     |
-| `2`  | usage / malformed input JSON                        |
-| `3`  | no live DJ endpoint (VS Code not running / DJ off)  |
-| `4`  | timed out waiting for a reply                       |
+| Code | Meaning                                            |
+| ---- | -------------------------------------------------- |
+| `0`  | success                                            |
+| `1`  | operation error (e.g. "Model … already exists")    |
+| `2`  | usage / malformed input JSON                       |
+| `3`  | no live DJ endpoint (VS Code not running / DJ off) |
+| `4`  | timed out waiting for a reply                      |
 
 ## Constraints & notes