create-dql-app 1.6.15 → 1.6.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-dql-app",
3
- "version": "1.6.15",
3
+ "version": "1.6.17",
4
4
  "description": "Scaffold a new DQL project. Run with: npx create-dql-app <name>",
5
5
  "license": "MIT",
6
6
  "author": "DuckCode AI Labs",
@@ -54,6 +54,26 @@ Open `notebooks/welcome.dqlnb` first. It shows the starter workflow:
54
54
  4. Compose business outcomes under `business-views/`.
55
55
  5. Use Lineage to trace source data into business views and consumption.
56
56
 
57
+ ## Connect an AI agent
58
+
59
+ After `npm run doctor` passes, DQL can expose the same governed project context
60
+ to Claude Code, Codex, Cursor, Claude Desktop, or any MCP client:
61
+
62
+ ```bash
63
+ npm run compile
64
+ npx dql mcp test
65
+ npx dql connect claude-code
66
+ # or: npx dql connect codex
67
+ # or: npx dql connect all
68
+ ```
69
+
70
+ Claude Code uses project `.mcp.json` and `CLAUDE.md`. Codex uses project
71
+ `.codex/config.toml` and `AGENTS.md`. Agents should start with
72
+ `inspect_dql_project`, route questions through `ask_dql`, use certified blocks
73
+ when the grain exactly fits, and mark generated SQL as uncertified.
74
+ The generated `.mcp.json`, `.codex/`, and `.cursor/` files are ignored by
75
+ default because they can contain local machine paths.
76
+
57
77
  ## Have a dbt project?
58
78
 
59
79
  Point `dql.config.json` at it (auto-wired if a sibling dbt project was
@@ -3,6 +3,11 @@
3
3
  dql-manifest.json
4
4
  *.run.json
5
5
 
6
+ # Local AI agent client config generated by `dql connect`
7
+ .mcp.json
8
+ .codex/
9
+ .cursor/
10
+
6
11
  # Warehouses
7
12
  *.duckdb
8
13
  *.duckdb.wal
@@ -11,7 +11,7 @@
11
11
  "validate": "dql validate"
12
12
  },
13
13
  "devDependencies": {
14
- "@duckcodeailabs/dql-cli": "^1.6.15"
14
+ "@duckcodeailabs/dql-cli": "^1.6.17"
15
15
  },
16
16
  "engines": {
17
17
  "node": ">=20 <23"