Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -511,7 +511,7 @@ LIGHTDASH_TRINO_HOST=host.docker.internal # Trino host override for Docker

## AI Agent Integration

When `dj.codingAgent` is `true`, the extension generates a project-tailored `AGENTS.md` at `.agents/dj/AGENTS.md` and copies agent-agnostic skill directories from [`templates/`](templates/) to `.agents/skills/` at workspace activation, following the [Agent Skills](https://agentskills.io) open standard (each skill is a folder with a `SKILL.md`). The agent code lives in [`src/services/agent/`](src/services/agent/); skill files are written by the Dbt service.
When `dj.codingAgent` is `true`, the extension copies the DJ agent context to `.agents/dj/` — a hub `AGENTS.md` plus on-demand `reference/` files — and copies the agent-agnostic skill directories from [`templates/`](templates/) to `.agents/skills/` at workspace activation, following the [Agent Skills](https://agentskills.io) open standard (each skill is a folder with a `SKILL.md`). The templates live under [`templates/_agents-dj/`](templates/_agents-dj/) and [`templates/skills/`](templates/skills/); both are deployed by the Dbt service ([`src/services/dbt.ts`](src/services/dbt.ts)), which strips the leading `_` from `_AGENTS.md` / `_SKILL.md` on copy.

## Additional Resources

Expand Down
20 changes: 20 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,25 @@
# Change Log

## 2.1.0

### Agent skills

- **New `dj-govern-model` skill.** Runs a read-only governance audit across a model, folder, dependency tree, or the whole workspace — ownership, PII / classification / compliance tagging, registered-group conformance, and prod-write posture — and points you to the skill that fixes each gap. Try _"Which models in the finance group have no owner?"_
- **New `dj-create-source` skill.** Registers a raw Trino table as a DJ source by reading its exact column types from the warehouse, so a model that reads a not-yet-defined `catalog.schema.table` builds instead of failing. Authoring skills detect the missing source and offer to create it, or run the `DJ: Create Source` command yourself.
- **New `dj-run-dbt`, `dj-run-trino`, and `dj-git-workflow` skills.** Compile and test models, run read-only Trino queries, and commit your `.model.json` sources together with their generated SQL/YAML — activating the right Python environment and keeping warehouse writes behind explicit confirmation.
- **Skills confirm the target and stay read-only by default.** Creating or converting a model asks which dbt project to use, requires the `group` to be registered in `models/groups.yml`, and offers optional `owner` / `pii` / `classification` / `compliance` tags (skip them and nothing is written). Anything that writes to the warehouse or production always needs your explicit confirmation.
- **Model creation builds missing upstreams and defaults BI work to marts.** A dashboard or metrics request scaffolds a mart and offers to build any missing staging / intermediate / source layers upstream-first, then reminds you to re-sync so the new columns resolve.
- **Leaner agent context.** The generated `.agents/dj/AGENTS.md` is now a slim hub, with deep reference material split into on-demand files under `.agents/dj/reference/` that skills open only when needed.

### UX improvements

- **Data Modeling dropdowns scale with zoom.** Single- and multi-select menus in the visual editor now size their text to the zoom level so it matches the node, and truncated labels show the full value on hover.
- **Monochrome sidebar icon.** Switched the Activity Bar icon to a monochrome SVG so it remains visible across light, dark, and high-contrast themes in remote workspaces.

### Documentation

- **New [Agent Skills](docs/AGENT_SKILLS.md) guide** — catalogs every DJ agent skill and when to reach for it.

## 2.0.2

- **Python model run tracking in Airflow.** DJ-generated `etl_helper.py` records each python model run (success, error, skipped, upstream_failed) to a Trino meta table configured via `run_tracking` (`catalog`, `schema`, and `table` are required in the `dj_python_source_config` Airflow Variable). Mapped tasks reconcile failures that occur before model code runs, and expose helpers your DAG can call for end-of-run reconciliation and `[Python Models]` failure email summaries.
Expand Down
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ DJ is a VS Code extension that revolutionizes dbt development through a structur
- **Data Catalog Integration**: Browse Trino catalogs and execute queries directly in VS Code.
- **BI Integration**: Built-in Lightdash support for creating dashboards from dbt models.
- **11 Model Types**: Complete coverage from staging to marts with pre-built templates.
- **AI Agent Skills**: Agent-agnostic skills that guide AI coding assistants through common DJ tasks.

## Supported Stack

Expand Down Expand Up @@ -297,6 +298,7 @@ DJ supports the following model types:
- **[Lineage Visualization](docs/LINEAGE.md)** - Model and column-level lineage
- **[Integrations Guide](docs/integrations/README.md)** - dbt, Trino, and Lightdash integration
- **[Model Types Reference](docs/models/README.md)** - All 11 model types with examples
- **[Agent Skills](docs/AGENT_SKILLS.md)** - AI agent skills for common DJ tasks

## Support & Community

Expand Down
40 changes: 40 additions & 0 deletions assets/images/dj-icon-mono.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading