@rawsql-ts/ztd-cli 0.17.0 → 0.20.0

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.
Files changed (240) hide show
  1. package/README.md +532 -366
  2. package/package.json +26 -15
  3. package/templates/.editorconfig +16 -16
  4. package/templates/.prettierignore +2 -2
  5. package/templates/.prettierrc +24 -24
  6. package/templates/AGENTS.md +30 -52
  7. package/templates/CONTEXT.md +11 -0
  8. package/templates/CONTEXT.webapi.md +11 -0
  9. package/templates/DESIGN.md +17 -0
  10. package/templates/DEV_NOTES.md +14 -0
  11. package/templates/PROMPT_DOGFOOD.webapi.md +49 -0
  12. package/templates/README.md +46 -14
  13. package/templates/README.webapi.md +38 -0
  14. package/templates/scripts/local-source-guard.mjs +189 -0
  15. package/templates/src/AGENTS.md +26 -26
  16. package/templates/src/application/AGENTS.md +15 -0
  17. package/templates/src/application/README.md +6 -0
  18. package/templates/src/catalog/AGENTS.md +28 -37
  19. package/templates/src/catalog/runtime/AGENTS.md +28 -75
  20. package/templates/src/catalog/runtime/_coercions.ts +30 -1
  21. package/templates/src/catalog/runtime/_smoke.runtime.ts +21 -21
  22. package/templates/src/catalog/specs/AGENTS.md +41 -48
  23. package/templates/src/catalog/specs/_smoke.spec.arktype.ts +21 -21
  24. package/templates/src/catalog/specs/_smoke.spec.zod.ts +20 -20
  25. package/templates/src/db/sql-client-adapters.ts +32 -0
  26. package/templates/src/db/sql-client.ts +24 -24
  27. package/templates/src/domain/AGENTS.md +15 -0
  28. package/templates/src/domain/README.md +6 -0
  29. package/templates/src/infrastructure/AGENTS.md +14 -0
  30. package/templates/src/infrastructure/README.md +6 -0
  31. package/templates/src/infrastructure/db/AGENTS.md +14 -0
  32. package/templates/src/infrastructure/db/sql-client-adapters.ts +34 -0
  33. package/templates/{dist/ztd-cli/templates/src → src/infrastructure}/db/sql-client.ts +3 -3
  34. package/templates/src/infrastructure/persistence/AGENTS.md +18 -0
  35. package/templates/src/infrastructure/persistence/README.md +8 -0
  36. package/templates/src/infrastructure/persistence/repositories/AGENTS.md +17 -0
  37. package/templates/src/infrastructure/persistence/repositories/tables/AGENTS.md +20 -0
  38. package/templates/src/infrastructure/persistence/repositories/tables/README.md +5 -0
  39. package/templates/src/infrastructure/persistence/repositories/views/AGENTS.md +16 -0
  40. package/templates/src/infrastructure/persistence/repositories/views/README.md +5 -0
  41. package/templates/src/infrastructure/telemetry/AGENTS.md +14 -0
  42. package/templates/src/infrastructure/telemetry/consoleRepositoryTelemetry.ts +66 -0
  43. package/templates/src/infrastructure/telemetry/repositoryTelemetry.ts +26 -0
  44. package/templates/src/infrastructure/telemetry/types.ts +48 -0
  45. package/templates/src/jobs/AGENTS.md +25 -26
  46. package/templates/src/jobs/README.md +2 -2
  47. package/templates/src/presentation/AGENTS.md +15 -0
  48. package/templates/src/presentation/http/AGENTS.md +15 -0
  49. package/templates/src/presentation/http/README.md +6 -0
  50. package/templates/src/repositories/AGENTS.md +30 -118
  51. package/templates/src/repositories/tables/AGENTS.md +29 -94
  52. package/templates/src/repositories/tables/README.md +5 -3
  53. package/templates/src/repositories/views/AGENTS.md +25 -25
  54. package/templates/src/repositories/views/README.md +5 -3
  55. package/templates/src/sql/AGENTS.md +30 -77
  56. package/templates/src/sql/README.md +5 -5
  57. package/templates/tests/AGENTS.md +29 -62
  58. package/templates/tests/generated/AGENTS.md +23 -16
  59. package/templates/tests/smoke.test.ts +25 -5
  60. package/templates/tests/smoke.validation.test.ts +34 -34
  61. package/templates/tests/support/AGENTS.md +24 -26
  62. package/templates/tests/support/global-setup.ts +15 -15
  63. package/templates/tests/support/testkit-client.ts +14 -14
  64. package/templates/tests/support/testkit-client.webapi.ts +14 -0
  65. package/templates/tests/ztd-layout.generated.ts +6 -6
  66. package/templates/tsconfig.json +15 -15
  67. package/templates/vitest.config.ts +13 -13
  68. package/templates/ztd/AGENTS.md +23 -18
  69. package/templates/ztd/README.md +5 -5
  70. package/templates/ztd/ddl/AGENTS.md +26 -34
  71. package/templates/ztd/ddl/demo.sql +74 -74
  72. package/LICENSE +0 -21
  73. package/dist/commands/ddl.d.ts +0 -7
  74. package/dist/commands/ddl.js +0 -118
  75. package/dist/commands/ddl.js.map +0 -1
  76. package/dist/commands/diff.d.ts +0 -10
  77. package/dist/commands/diff.js +0 -38
  78. package/dist/commands/diff.js.map +0 -1
  79. package/dist/commands/genEntities.d.ts +0 -6
  80. package/dist/commands/genEntities.js +0 -50
  81. package/dist/commands/genEntities.js.map +0 -1
  82. package/dist/commands/init.d.ts +0 -79
  83. package/dist/commands/init.js +0 -1083
  84. package/dist/commands/init.js.map +0 -1
  85. package/dist/commands/lint.d.ts +0 -59
  86. package/dist/commands/lint.js +0 -358
  87. package/dist/commands/lint.js.map +0 -1
  88. package/dist/commands/options.d.ts +0 -9
  89. package/dist/commands/options.js +0 -48
  90. package/dist/commands/options.js.map +0 -1
  91. package/dist/commands/pull.d.ts +0 -10
  92. package/dist/commands/pull.js +0 -105
  93. package/dist/commands/pull.js.map +0 -1
  94. package/dist/commands/ztdConfig.d.ts +0 -23
  95. package/dist/commands/ztdConfig.js +0 -216
  96. package/dist/commands/ztdConfig.js.map +0 -1
  97. package/dist/commands/ztdConfigCommand.d.ts +0 -5
  98. package/dist/commands/ztdConfigCommand.js +0 -157
  99. package/dist/commands/ztdConfigCommand.js.map +0 -1
  100. package/dist/index.d.ts +0 -2
  101. package/dist/index.js +0 -22
  102. package/dist/index.js.map +0 -1
  103. package/dist/utils/agents.d.ts +0 -1
  104. package/dist/utils/agents.js +0 -48
  105. package/dist/utils/agents.js.map +0 -1
  106. package/dist/utils/collectSqlFiles.d.ts +0 -9
  107. package/dist/utils/collectSqlFiles.js +0 -58
  108. package/dist/utils/collectSqlFiles.js.map +0 -1
  109. package/dist/utils/connectionSummary.d.ts +0 -3
  110. package/dist/utils/connectionSummary.js +0 -29
  111. package/dist/utils/connectionSummary.js.map +0 -1
  112. package/dist/utils/dbConnection.d.ts +0 -29
  113. package/dist/utils/dbConnection.js +0 -210
  114. package/dist/utils/dbConnection.js.map +0 -1
  115. package/dist/utils/fs.d.ts +0 -1
  116. package/dist/utils/fs.js +0 -12
  117. package/dist/utils/fs.js.map +0 -1
  118. package/dist/utils/normalizePulledSchema.d.ts +0 -12
  119. package/dist/utils/normalizePulledSchema.js +0 -213
  120. package/dist/utils/normalizePulledSchema.js.map +0 -1
  121. package/dist/utils/optionalDependencies.d.ts +0 -35
  122. package/dist/utils/optionalDependencies.js +0 -96
  123. package/dist/utils/optionalDependencies.js.map +0 -1
  124. package/dist/utils/pgDump.d.ts +0 -11
  125. package/dist/utils/pgDump.js +0 -55
  126. package/dist/utils/pgDump.js.map +0 -1
  127. package/dist/utils/sqlLintHelpers.d.ts +0 -18
  128. package/dist/utils/sqlLintHelpers.js +0 -270
  129. package/dist/utils/sqlLintHelpers.js.map +0 -1
  130. package/dist/utils/typeMapper.d.ts +0 -4
  131. package/dist/utils/typeMapper.js +0 -76
  132. package/dist/utils/typeMapper.js.map +0 -1
  133. package/dist/utils/ztdProjectConfig.d.ts +0 -40
  134. package/dist/utils/ztdProjectConfig.js +0 -167
  135. package/dist/utils/ztdProjectConfig.js.map +0 -1
  136. package/templates/dist/drivers/pg-testkit/src/driver/PgTestkitClient.d.ts +0 -38
  137. package/templates/dist/drivers/pg-testkit/src/driver/PgTestkitClient.js +0 -117
  138. package/templates/dist/drivers/pg-testkit/src/driver/PgTestkitClient.js.map +0 -1
  139. package/templates/dist/drivers/pg-testkit/src/driver/createPgTestkitPool.d.ts +0 -4
  140. package/templates/dist/drivers/pg-testkit/src/driver/createPgTestkitPool.js +0 -71
  141. package/templates/dist/drivers/pg-testkit/src/driver/createPgTestkitPool.js.map +0 -1
  142. package/templates/dist/drivers/pg-testkit/src/index.d.ts +0 -5
  143. package/templates/dist/drivers/pg-testkit/src/index.js +0 -11
  144. package/templates/dist/drivers/pg-testkit/src/index.js.map +0 -1
  145. package/templates/dist/drivers/pg-testkit/src/proxy/wrapPgClient.d.ts +0 -3
  146. package/templates/dist/drivers/pg-testkit/src/proxy/wrapPgClient.js +0 -79
  147. package/templates/dist/drivers/pg-testkit/src/proxy/wrapPgClient.js.map +0 -1
  148. package/templates/dist/drivers/pg-testkit/src/types.d.ts +0 -69
  149. package/templates/dist/drivers/pg-testkit/src/types.js +0 -3
  150. package/templates/dist/drivers/pg-testkit/src/types.js.map +0 -1
  151. package/templates/dist/drivers/pg-testkit/src/utils/fixtureState.d.ts +0 -15
  152. package/templates/dist/drivers/pg-testkit/src/utils/fixtureState.js +0 -34
  153. package/templates/dist/drivers/pg-testkit/src/utils/fixtureState.js.map +0 -1
  154. package/templates/dist/drivers/pg-testkit/src/utils/fixtureValidation.d.ts +0 -12
  155. package/templates/dist/drivers/pg-testkit/src/utils/fixtureValidation.js +0 -53
  156. package/templates/dist/drivers/pg-testkit/src/utils/fixtureValidation.js.map +0 -1
  157. package/templates/dist/mapper-core/src/index.d.ts +0 -160
  158. package/templates/dist/mapper-core/src/index.js +0 -637
  159. package/templates/dist/mapper-core/src/index.js.map +0 -1
  160. package/templates/dist/testkit-core/src/errors/index.d.ts +0 -49
  161. package/templates/dist/testkit-core/src/errors/index.js +0 -111
  162. package/templates/dist/testkit-core/src/errors/index.js.map +0 -1
  163. package/templates/dist/testkit-core/src/fixtures/ColumnAffinity.d.ts +0 -5
  164. package/templates/dist/testkit-core/src/fixtures/ColumnAffinity.js +0 -29
  165. package/templates/dist/testkit-core/src/fixtures/ColumnAffinity.js.map +0 -1
  166. package/templates/dist/testkit-core/src/fixtures/DdlFixtureLoader.d.ts +0 -37
  167. package/templates/dist/testkit-core/src/fixtures/DdlFixtureLoader.js +0 -182
  168. package/templates/dist/testkit-core/src/fixtures/DdlFixtureLoader.js.map +0 -1
  169. package/templates/dist/testkit-core/src/fixtures/FixtureProvider.d.ts +0 -20
  170. package/templates/dist/testkit-core/src/fixtures/FixtureProvider.js +0 -121
  171. package/templates/dist/testkit-core/src/fixtures/FixtureProvider.js.map +0 -1
  172. package/templates/dist/testkit-core/src/fixtures/FixtureStore.d.ts +0 -51
  173. package/templates/dist/testkit-core/src/fixtures/FixtureStore.js +0 -199
  174. package/templates/dist/testkit-core/src/fixtures/FixtureStore.js.map +0 -1
  175. package/templates/dist/testkit-core/src/fixtures/TableDefinitionSchemaRegistry.d.ts +0 -10
  176. package/templates/dist/testkit-core/src/fixtures/TableDefinitionSchemaRegistry.js +0 -28
  177. package/templates/dist/testkit-core/src/fixtures/TableDefinitionSchemaRegistry.js.map +0 -1
  178. package/templates/dist/testkit-core/src/fixtures/TableNameResolver.d.ts +0 -18
  179. package/templates/dist/testkit-core/src/fixtures/TableNameResolver.js +0 -80
  180. package/templates/dist/testkit-core/src/fixtures/TableNameResolver.js.map +0 -1
  181. package/templates/dist/testkit-core/src/fixtures/ddlLint.d.ts +0 -59
  182. package/templates/dist/testkit-core/src/fixtures/ddlLint.js +0 -489
  183. package/templates/dist/testkit-core/src/fixtures/ddlLint.js.map +0 -1
  184. package/templates/dist/testkit-core/src/fixtures/naming.d.ts +0 -1
  185. package/templates/dist/testkit-core/src/fixtures/naming.js +0 -6
  186. package/templates/dist/testkit-core/src/fixtures/naming.js.map +0 -1
  187. package/templates/dist/testkit-core/src/index.d.ts +0 -17
  188. package/templates/dist/testkit-core/src/index.js +0 -47
  189. package/templates/dist/testkit-core/src/index.js.map +0 -1
  190. package/templates/dist/testkit-core/src/logger/NoopLogger.d.ts +0 -8
  191. package/templates/dist/testkit-core/src/logger/NoopLogger.js +0 -16
  192. package/templates/dist/testkit-core/src/logger/NoopLogger.js.map +0 -1
  193. package/templates/dist/testkit-core/src/provider/TestkitProvider.d.ts +0 -57
  194. package/templates/dist/testkit-core/src/provider/TestkitProvider.js +0 -149
  195. package/templates/dist/testkit-core/src/provider/TestkitProvider.js.map +0 -1
  196. package/templates/dist/testkit-core/src/rewriter/ResultSelectRewriter.d.ts +0 -43
  197. package/templates/dist/testkit-core/src/rewriter/ResultSelectRewriter.js +0 -473
  198. package/templates/dist/testkit-core/src/rewriter/ResultSelectRewriter.js.map +0 -1
  199. package/templates/dist/testkit-core/src/rewriter/SelectAnalyzer.d.ts +0 -9
  200. package/templates/dist/testkit-core/src/rewriter/SelectAnalyzer.js +0 -38
  201. package/templates/dist/testkit-core/src/rewriter/SelectAnalyzer.js.map +0 -1
  202. package/templates/dist/testkit-core/src/rewriter/SelectFixtureRewriter.d.ts +0 -42
  203. package/templates/dist/testkit-core/src/rewriter/SelectFixtureRewriter.js +0 -298
  204. package/templates/dist/testkit-core/src/rewriter/SelectFixtureRewriter.js.map +0 -1
  205. package/templates/dist/testkit-core/src/sql/SqliteValuesBuilder.d.ts +0 -12
  206. package/templates/dist/testkit-core/src/sql/SqliteValuesBuilder.js +0 -63
  207. package/templates/dist/testkit-core/src/sql/SqliteValuesBuilder.js.map +0 -1
  208. package/templates/dist/testkit-core/src/types/index.d.ts +0 -69
  209. package/templates/dist/testkit-core/src/types/index.js +0 -3
  210. package/templates/dist/testkit-core/src/types/index.js.map +0 -1
  211. package/templates/dist/testkit-core/src/utils/queryHelpers.d.ts +0 -28
  212. package/templates/dist/testkit-core/src/utils/queryHelpers.js +0 -81
  213. package/templates/dist/testkit-core/src/utils/queryHelpers.js.map +0 -1
  214. package/templates/dist/writer-core/src/index.d.ts +0 -34
  215. package/templates/dist/writer-core/src/index.js +0 -115
  216. package/templates/dist/writer-core/src/index.js.map +0 -1
  217. package/templates/dist/ztd-cli/templates/src/db/sql-client.d.ts +0 -20
  218. package/templates/dist/ztd-cli/templates/src/db/sql-client.js +0 -3
  219. package/templates/dist/ztd-cli/templates/src/db/sql-client.js.map +0 -1
  220. package/templates/dist/ztd-cli/templates/src/repositories/user-accounts.d.ts +0 -36
  221. package/templates/dist/ztd-cli/templates/src/repositories/user-accounts.js +0 -85
  222. package/templates/dist/ztd-cli/templates/src/repositories/user-accounts.js.map +0 -1
  223. package/templates/dist/ztd-cli/templates/tests/generated/ztd-row-map.generated.d.ts +0 -20
  224. package/templates/dist/ztd-cli/templates/tests/generated/ztd-row-map.generated.js +0 -33
  225. package/templates/dist/ztd-cli/templates/tests/generated/ztd-row-map.generated.js.map +0 -1
  226. package/templates/dist/ztd-cli/templates/tests/support/global-setup.d.ts +0 -10
  227. package/templates/dist/ztd-cli/templates/tests/support/global-setup.js +0 -29
  228. package/templates/dist/ztd-cli/templates/tests/support/global-setup.js.map +0 -1
  229. package/templates/dist/ztd-cli/templates/tests/support/testkit-client.d.ts +0 -66
  230. package/templates/dist/ztd-cli/templates/tests/support/testkit-client.js +0 -552
  231. package/templates/dist/ztd-cli/templates/tests/support/testkit-client.js.map +0 -1
  232. package/templates/dist/ztd-cli/templates/tests/user-profiles.test.d.ts +0 -1
  233. package/templates/dist/ztd-cli/templates/tests/user-profiles.test.js +0 -82
  234. package/templates/dist/ztd-cli/templates/tests/user-profiles.test.js.map +0 -1
  235. package/templates/dist/ztd-cli/templates/tests/writer-constraints.test.d.ts +0 -1
  236. package/templates/dist/ztd-cli/templates/tests/writer-constraints.test.js +0 -29
  237. package/templates/dist/ztd-cli/templates/tests/writer-constraints.test.js.map +0 -1
  238. package/templates/dist/ztd-cli/templates/tests/ztd-layout.generated.d.ts +0 -7
  239. package/templates/dist/ztd-cli/templates/tests/ztd-layout.generated.js +0 -10
  240. package/templates/dist/ztd-cli/templates/tests/ztd-layout.generated.js.map +0 -1
@@ -1,14 +1,14 @@
1
- import type { SqlClient } from '../../src/db/sql-client';
2
-
3
- /**
4
- * Placeholder for wiring an SQL client that tests can reuse.
5
- *
6
- * Replace this implementation with your chosen adapter (pg, mysql2, etc.) or a
7
- * fixture-based helper that fulfills the `SqlClient` contract. Avoid committing
8
- * production credentials inside this file.
9
- */
10
- export async function createTestkitClient(): Promise<SqlClient> {
11
- throw new Error(
12
- 'Provide a SqlClient implementation here (for example by importing @rawsql-ts/adapter-node-pg or another driver).',
13
- );
14
- }
1
+ import type { SqlClient } from '../../src/db/sql-client';
2
+
3
+ /**
4
+ * Placeholder for wiring an SQL client that tests can reuse.
5
+ *
6
+ * Replace this implementation with your chosen adapter (pg, mysql2, etc.) or a
7
+ * fixture-based helper that fulfills the `SqlClient` contract. Avoid committing
8
+ * production credentials inside this file.
9
+ */
10
+ export async function createTestkitClient(): Promise<SqlClient> {
11
+ throw new Error(
12
+ 'Provide a SqlClient implementation here (for example by adapting pg via src/db/sql-client-adapters.ts, or by importing @rawsql-ts/adapter-node-pg for ZTD-backed tests).',
13
+ );
14
+ }
@@ -0,0 +1,14 @@
1
+ import type { SqlClient } from '../../src/infrastructure/db/sql-client';
2
+
3
+ /**
4
+ * Placeholder for wiring an SQL client that tests can reuse.
5
+ *
6
+ * Replace this implementation with your chosen adapter (pg, mysql2, etc.) or a
7
+ * fixture-based helper that fulfills the `SqlClient` contract. Avoid committing
8
+ * production credentials inside this file.
9
+ */
10
+ export async function createTestkitClient(): Promise<SqlClient> {
11
+ throw new Error(
12
+ 'Provide a SqlClient implementation here (for example by adapting pg via src/infrastructure/db/sql-client-adapters.ts, or by importing @rawsql-ts/adapter-node-pg for ZTD-backed tests).',
13
+ );
14
+ }
@@ -1,6 +1,6 @@
1
- // GENERATED FILE. DO NOT EDIT.
2
-
3
- export default {
4
- ztdRootDir: 'ztd',
5
- ddlDir: 'ztd/ddl',
6
- };
1
+ // GENERATED FILE. DO NOT EDIT.
2
+
3
+ export default {
4
+ ztdRootDir: 'ztd',
5
+ ddlDir: 'ztd/ddl',
6
+ };
@@ -1,15 +1,15 @@
1
- {
2
- "compilerOptions": {
3
- "target": "ES2022",
4
- "lib": ["ES2022"],
5
- "module": "NodeNext",
6
- "moduleResolution": "NodeNext",
7
- "strict": true,
8
- "esModuleInterop": true,
9
- "forceConsistentCasingInFileNames": true,
10
- "skipLibCheck": true,
11
- "outDir": "dist",
12
- "tsBuildInfoFile": "dist/.tsbuildinfo"
13
- },
14
- "include": ["src/**/*.ts", "tests/**/*.ts"]
15
- }
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "lib": ["ES2022"],
5
+ "module": "NodeNext",
6
+ "moduleResolution": "NodeNext",
7
+ "strict": true,
8
+ "esModuleInterop": true,
9
+ "forceConsistentCasingInFileNames": true,
10
+ "skipLibCheck": true,
11
+ "outDir": "dist",
12
+ "tsBuildInfoFile": "dist/.tsbuildinfo"
13
+ },
14
+ "include": ["src/**/*.ts", "tests/**/*.ts"]
15
+ }
@@ -1,13 +1,13 @@
1
- import { defineConfig } from 'vitest/config';
2
-
3
- export default defineConfig({
4
- test: {
5
- include: ['tests/**/*.test.ts'],
6
- environment: 'node',
7
- globals: true,
8
- globalSetup: ['tests/support/global-setup.ts'],
9
- // Starting a Postgres testcontainer can exceed the default 5s timeout on some machines.
10
- testTimeout: 60_000,
11
- hookTimeout: 60_000,
12
- },
13
- });
1
+ import { defineConfig } from 'vitest/config';
2
+
3
+ export default defineConfig({
4
+ test: {
5
+ include: ['tests/**/*.test.ts'],
6
+ environment: 'node',
7
+ globals: true,
8
+ globalSetup: ['tests/support/global-setup.ts'],
9
+ // Starting a Postgres testcontainer can exceed the default 5s timeout on some machines.
10
+ testTimeout: 60_000,
11
+ hookTimeout: 60_000,
12
+ },
13
+ });
@@ -1,18 +1,23 @@
1
- # ztd AGENTS
2
-
3
- This directory contains ZTD inputs and related documentation.
4
-
5
- ## Core rule
6
-
7
- - "ztd/ddl/" is the only human-owned source of truth inside "ztd/".
8
- - Do not create new subdirectories under "ztd/" unless explicitly instructed.
9
-
10
- ## Boundaries
11
-
12
- - Runtime code must not depend on "ztd/".
13
- - Tests may reference DDL and generated outputs via ZTD tooling.
14
-
15
- ## Editing policy
16
-
17
- - Avoid modifying "ztd/README.md" unless explicitly asked.
18
- - Prefer adding rules to "ztd/ddl/AGENTS.md" for DDL-related guidance.
1
+ # Package Scope
2
+ - Applies to `packages/ztd-cli/templates/ztd`.
3
+ - Governs ZTD inputs and related metadata used for generation.
4
+
5
+ # Policy
6
+ ## REQUIRED
7
+ - `ztd/ddl` MUST remain the human-owned source of truth inside `ztd`.
8
+
9
+ ## ALLOWED
10
+ - Tests MAY reference ZTD DDL and generated outputs through ZTD tooling.
11
+
12
+ ## PROHIBITED
13
+ - Creating new `ztd` subdirectories without explicit instruction.
14
+ - Modifying `ztd/README.md` without explicit instruction.
15
+
16
+ # Mandatory Workflow
17
+ - DDL-related rule updates MUST be made in `ztd/ddl/AGENTS.md`.
18
+
19
+ # Hygiene
20
+ - Keep runtime code independent from `ztd` subtree dependencies.
21
+
22
+ # References
23
+ - DDL policy: [./ddl/AGENTS.md](./ddl/AGENTS.md)
@@ -1,6 +1,6 @@
1
- # ztd/
2
-
3
- This directory stores ZTD schema artifacts.
4
-
5
- - `ztd/ddl/<schema>.sql` is the source of truth for schema.
1
+ # ztd/
2
+
3
+ This directory stores ZTD schema artifacts.
4
+
5
+ - `ztd/ddl/<schema>.sql` is the source of truth for schema.
6
6
  - Run `npx ztd ztd-config` to regenerate `tests/generated` outputs.
@@ -1,34 +1,26 @@
1
- # ztd/ddl AGENTS
2
-
3
- This folder contains physical schema definitions (DDL). Human-led.
4
-
5
- ## Ownership
6
-
7
- - Humans own DDL semantics.
8
- - AI may assist with mechanical edits, but must not invent domain rules.
9
-
10
- ## Conventions (Postgres-oriented)
11
-
12
- - Table names: singular (example: "user", "order", "invoice")
13
- - Primary key: "serial8" (bigserial) by default
14
- - Timestamps: default "current_timestamp" where applicable
15
-
16
- ## Comments (required)
17
-
18
- Add comments for tables and important columns.
19
-
20
- Postgres syntax:
21
- - "comment on table <schema>.<table> is '...';"
22
- - "comment on column <schema>.<table>.<column> is '...';"
23
-
24
- ## Constraints
25
-
26
- - Prefer explicit NOT NULL where appropriate.
27
- - Prefer explicit unique constraints for business keys.
28
- - Foreign keys are allowed, but keep them intentional and explain rationale in comments.
29
-
30
- ## File strategy
31
-
32
- - Keep schema DDL in a clear and reviewable form.
33
- - If using one file per schema (example: "public.sql"), keep it consistent.
34
- - Avoid random splitting unless there is a strong reason.
1
+ # Package Scope
2
+ - Applies to `packages/ztd-cli/templates/ztd/ddl`.
3
+ - Defines contract rules for human-owned physical schema definitions.
4
+
5
+ # Policy
6
+ ## REQUIRED
7
+ - DDL semantics MUST remain human-owned.
8
+ - Table and column comments MUST be included for important schema elements.
9
+ - DDL naming and file organization MUST stay consistent within the selected strategy.
10
+
11
+ ## ALLOWED
12
+ - AI MAY assist with mechanical DDL edits when explicitly requested.
13
+ - Foreign keys MAY be used when intentional and documented.
14
+
15
+ ## PROHIBITED
16
+ - Inventing domain rules without explicit instruction.
17
+ - Inconsistent schema splitting strategy within this subtree.
18
+
19
+ # Mandatory Workflow
20
+ - DDL changes MUST preserve comment statements and naming conventions.
21
+
22
+ # Hygiene
23
+ - Maintain explicit NOT NULL and unique constraints where contract semantics require them.
24
+
25
+ # References
26
+ - Parent ZTD policy: [../AGENTS.md](../AGENTS.md)
@@ -1,74 +1,74 @@
1
- create table "user" (
2
- user_id serial8 primary key,
3
- user_name text not null,
4
- email text not null,
5
- created_at timestamptz not null default current_timestamp
6
- );
7
-
8
- comment on table "user" is
9
- 'User master. Referenced by task_assignment.';
10
-
11
- comment on column "user".user_id is
12
- 'Primary key of user.';
13
- comment on column "user".user_name is
14
- 'Display name of the user.';
15
- comment on column "user".email is
16
- 'Email address of the user.';
17
- comment on column "user".created_at is
18
- 'Timestamp when the user was created.';
19
-
20
- create table task (
21
- task_id serial8 primary key,
22
- title text not null,
23
- status text not null,
24
- priority integer not null,
25
- due_date date,
26
- created_at timestamptz not null default current_timestamp
27
- );
28
-
29
- comment on table task is
30
- 'Task entity. Current assignee is derived from task_assignment history.';
31
-
32
- comment on column task.task_id is
33
- 'Primary key of task.';
34
- comment on column task.title is
35
- 'Short description of the task.';
36
- comment on column task.status is
37
- 'Task status. Example: open, in_progress, done.';
38
- comment on column task.priority is
39
- 'Priority of the task. Higher value means higher priority.';
40
- comment on column task.due_date is
41
- 'Optional due date of the task.';
42
- comment on column task.created_at is
43
- 'Timestamp when the task was created.';
44
-
45
- create table task_assignment (
46
- task_assignment_id serial8 primary key,
47
- task_id bigint not null,
48
- user_id bigint not null,
49
- assigned_at timestamptz not null default current_timestamp
50
- );
51
-
52
- comment on table task_assignment is
53
- 'Assignment history of tasks. Latest assigned_at defines current assignee.';
54
-
55
- comment on column task_assignment.task_assignment_id is
56
- 'Primary key of task_assignment.';
57
- comment on column task_assignment.task_id is
58
- 'Referenced task identifier.';
59
- comment on column task_assignment.user_id is
60
- 'Referenced user identifier.';
61
- comment on column task_assignment.assigned_at is
62
- 'Timestamp when the task was assigned to the user.';
63
-
64
- create index idx_task_assignment_task
65
- on task_assignment(task_id);
66
-
67
- create index idx_task_assignment_task_time
68
- on task_assignment(task_id, assigned_at desc);
69
-
70
- comment on index idx_task_assignment_task is
71
- 'Index for joining task_assignment by task_id.';
72
-
73
- comment on index idx_task_assignment_task_time is
74
- 'Index for resolving latest assignment per task.';
1
+ create table "user" (
2
+ user_id serial8 primary key,
3
+ user_name text not null,
4
+ email text not null,
5
+ created_at timestamptz not null default current_timestamp
6
+ );
7
+
8
+ comment on table "user" is
9
+ 'User master. Referenced by task_assignment.';
10
+
11
+ comment on column "user".user_id is
12
+ 'Primary key of user.';
13
+ comment on column "user".user_name is
14
+ 'Display name of the user.';
15
+ comment on column "user".email is
16
+ 'Email address of the user.';
17
+ comment on column "user".created_at is
18
+ 'Timestamp when the user was created.';
19
+
20
+ create table task (
21
+ task_id serial8 primary key,
22
+ title text not null,
23
+ status text not null,
24
+ priority integer not null,
25
+ due_date date,
26
+ created_at timestamptz not null default current_timestamp
27
+ );
28
+
29
+ comment on table task is
30
+ 'Task entity. Current assignee is derived from task_assignment history.';
31
+
32
+ comment on column task.task_id is
33
+ 'Primary key of task.';
34
+ comment on column task.title is
35
+ 'Short description of the task.';
36
+ comment on column task.status is
37
+ 'Task status. Example: open, in_progress, done.';
38
+ comment on column task.priority is
39
+ 'Priority of the task. Higher value means higher priority.';
40
+ comment on column task.due_date is
41
+ 'Optional due date of the task.';
42
+ comment on column task.created_at is
43
+ 'Timestamp when the task was created.';
44
+
45
+ create table task_assignment (
46
+ task_assignment_id serial8 primary key,
47
+ task_id bigint not null,
48
+ user_id bigint not null,
49
+ assigned_at timestamptz not null default current_timestamp
50
+ );
51
+
52
+ comment on table task_assignment is
53
+ 'Assignment history of tasks. Latest assigned_at defines current assignee.';
54
+
55
+ comment on column task_assignment.task_assignment_id is
56
+ 'Primary key of task_assignment.';
57
+ comment on column task_assignment.task_id is
58
+ 'Referenced task identifier.';
59
+ comment on column task_assignment.user_id is
60
+ 'Referenced user identifier.';
61
+ comment on column task_assignment.assigned_at is
62
+ 'Timestamp when the task was assigned to the user.';
63
+
64
+ create index idx_task_assignment_task
65
+ on task_assignment(task_id);
66
+
67
+ create index idx_task_assignment_task_time
68
+ on task_assignment(task_id, assigned_at desc);
69
+
70
+ comment on index idx_task_assignment_task is
71
+ 'Index for joining task_assignment by task_id.';
72
+
73
+ comment on index idx_task_assignment_task_time is
74
+ 'Index for resolving latest assignment per task.';
package/LICENSE DELETED
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 MSugiura
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
@@ -1,7 +0,0 @@
1
- import { Command } from 'commander';
2
- /**
3
- * Registers all DDL-related commands (`pull`, `gen-entities`, `diff`) on the top-level CLI program.
4
- * @param program - The Commander program instance to extend.
5
- */
6
- export declare function registerDdlCommands(program: Command): void;
7
- export { collectDirectories, parseExtensions, DEFAULT_EXTENSIONS, DEFAULT_DDL_DIRECTORY } from './options';
@@ -1,118 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.DEFAULT_DDL_DIRECTORY = exports.DEFAULT_EXTENSIONS = exports.parseExtensions = exports.collectDirectories = void 0;
7
- exports.registerDdlCommands = registerDdlCommands;
8
- const node_path_1 = __importDefault(require("node:path"));
9
- const diff_1 = require("./diff");
10
- const genEntities_1 = require("./genEntities");
11
- const pull_1 = require("./pull");
12
- const ztdProjectConfig_1 = require("../utils/ztdProjectConfig");
13
- const dbConnection_1 = require("../utils/dbConnection");
14
- const options_1 = require("./options");
15
- /**
16
- * Registers all DDL-related commands (`pull`, `gen-entities`, `diff`) on the top-level CLI program.
17
- * @param program - The Commander program instance to extend.
18
- */
19
- function registerDdlCommands(program) {
20
- const ddl = program.command('ddl').description('DDL-focused workflows');
21
- ddl
22
- .command('pull')
23
- .description('Retrieve the current schema DDL from a PostgreSQL database')
24
- .option('--url <databaseUrl>', 'Connection string to use for pg_dump (optional; fallback to env/config)')
25
- .option('--out <directory>', 'Destination directory for the pulled DDL', options_1.DEFAULT_DDL_DIRECTORY)
26
- .option('--db-host <host>', 'Database host to use instead of DATABASE_URL')
27
- .option('--db-port <port>', 'Database port (defaults to 5432)')
28
- .option('--db-user <user>', 'Database user to connect as')
29
- .option('--db-password <password>', 'Database password')
30
- .option('--db-name <name>', 'Database name to connect to')
31
- .option('--pg-dump-path <path>', 'Custom pg_dump executable path')
32
- .option('--schema <schema>', 'Schema name to include (repeatable)', options_1.collectValues, [])
33
- .option('--table <table>', 'Table spec (schema.table) to include (repeatable)', options_1.collectValues, [])
34
- .action(async (options) => {
35
- var _a, _b, _c;
36
- const connection = resolveCliConnection(options);
37
- await (0, pull_1.runPullSchema)({
38
- url: connection.url,
39
- out: (_a = options.out) !== null && _a !== void 0 ? _a : options_1.DEFAULT_DDL_DIRECTORY,
40
- pgDumpPath: options.pgDumpPath,
41
- schemas: (_b = options.schema) !== null && _b !== void 0 ? _b : [],
42
- tables: (_c = options.table) !== null && _c !== void 0 ? _c : [],
43
- connectionContext: connection.context
44
- });
45
- });
46
- ddl
47
- .command('gen-entities')
48
- .description('Generate optional entities.ts helpers from the DDL snapshot')
49
- .option('--ddl-dir <directory>', 'DDL directory to scan (repeatable)', options_1.collectDirectories, [])
50
- .option('--extensions <list>', 'Comma-separated extensions to include', options_1.parseExtensions, options_1.DEFAULT_EXTENSIONS)
51
- .option('--out <file>', 'Destination TypeScript file', node_path_1.default.join('src', 'entities.ts'))
52
- .action(async (options) => {
53
- var _a;
54
- const directories = (0, options_1.normalizeDirectoryList)(options.ddlDir, options_1.DEFAULT_DDL_DIRECTORY);
55
- const extensions = (0, options_1.resolveExtensions)(options.extensions, options_1.DEFAULT_EXTENSIONS);
56
- await (0, genEntities_1.runGenerateEntities)({
57
- directories,
58
- extensions,
59
- out: (_a = options.out) !== null && _a !== void 0 ? _a : node_path_1.default.join('src', 'entities.ts')
60
- });
61
- });
62
- ddl
63
- .command('diff')
64
- .description('Compare local DDL against a live PostgreSQL database and emit a plan')
65
- .option('--ddl-dir <directory>', 'DDL directory to scan (repeatable)', options_1.collectDirectories, [])
66
- .option('--extensions <list>', 'Comma-separated extensions to include', options_1.parseExtensions, options_1.DEFAULT_EXTENSIONS)
67
- .option('--url <databaseUrl>', 'Connection string to use for pg_dump (optional; fallback to env/config)')
68
- .requiredOption('--out <file>', 'Output path for the generated plan file')
69
- .option('--db-host <host>', 'Database host to use instead of DATABASE_URL')
70
- .option('--db-port <port>', 'Database port (defaults to 5432)')
71
- .option('--db-user <user>', 'Database user to connect as')
72
- .option('--db-password <password>', 'Database password')
73
- .option('--db-name <name>', 'Database name to connect to')
74
- .option('--pg-dump-path <path>', 'Custom pg_dump executable path')
75
- .action(async (options) => {
76
- var _a;
77
- const directories = (0, options_1.normalizeDirectoryList)((_a = options.ddlDir) !== null && _a !== void 0 ? _a : [], options_1.DEFAULT_DDL_DIRECTORY);
78
- const extensions = (0, options_1.resolveExtensions)(options.extensions, options_1.DEFAULT_EXTENSIONS);
79
- const connection = resolveCliConnection(options);
80
- await (0, diff_1.runDiffSchema)({
81
- directories,
82
- extensions,
83
- url: connection.url,
84
- out: options.out,
85
- pgDumpPath: options.pgDumpPath,
86
- connectionContext: connection.context
87
- });
88
- });
89
- }
90
- /**
91
- * Resolves connection metadata for CLI commands using flags, environment, and project config.
92
- * @param options - CLI options containing optional overrides.
93
- * @returns The resolved connection and context.
94
- */
95
- function resolveCliConnection(options) {
96
- // Gather configuration once per command so overrides and defaults stay synchronized.
97
- return (0, dbConnection_1.resolveDatabaseConnection)(buildFlagSet(options), (0, ztdProjectConfig_1.loadZtdProjectConfig)(), options.url);
98
- }
99
- /**
100
- * Normalizes the incoming CLI flag values into the shared DbConnectionFlags shape.
101
- * @param options - CLI options exposing partial connection pieces.
102
- * @returns Flag object consumed by the `resolveDatabaseConnection` helper.
103
- */
104
- function buildFlagSet(options) {
105
- return {
106
- host: options.dbHost,
107
- port: options.dbPort,
108
- user: options.dbUser,
109
- password: options.dbPassword,
110
- database: options.dbName
111
- };
112
- }
113
- var options_2 = require("./options");
114
- Object.defineProperty(exports, "collectDirectories", { enumerable: true, get: function () { return options_2.collectDirectories; } });
115
- Object.defineProperty(exports, "parseExtensions", { enumerable: true, get: function () { return options_2.parseExtensions; } });
116
- Object.defineProperty(exports, "DEFAULT_EXTENSIONS", { enumerable: true, get: function () { return options_2.DEFAULT_EXTENSIONS; } });
117
- Object.defineProperty(exports, "DEFAULT_DDL_DIRECTORY", { enumerable: true, get: function () { return options_2.DEFAULT_DDL_DIRECTORY; } });
118
- //# sourceMappingURL=ddl.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ddl.js","sourceRoot":"","sources":["../../src/commands/ddl.ts"],"names":[],"mappings":"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"}
@@ -1,10 +0,0 @@
1
- import type { DbConnectionContext } from '../utils/dbConnection';
2
- export interface DiffSchemaOptions {
3
- directories: string[];
4
- extensions: string[];
5
- url: string;
6
- out: string;
7
- pgDumpPath?: string;
8
- connectionContext?: DbConnectionContext;
9
- }
10
- export declare function runDiffSchema(options: DiffSchemaOptions): void;
@@ -1,38 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.runDiffSchema = runDiffSchema;
7
- const node_fs_1 = require("node:fs");
8
- const node_path_1 = __importDefault(require("node:path"));
9
- const diff_1 = require("diff");
10
- const collectSqlFiles_1 = require("../utils/collectSqlFiles");
11
- const fs_1 = require("../utils/fs");
12
- const pgDump_1 = require("../utils/pgDump");
13
- const connectionSummary_1 = require("../utils/connectionSummary");
14
- function runDiffSchema(options) {
15
- const localSources = (0, collectSqlFiles_1.collectSqlFiles)(options.directories, options.extensions);
16
- if (localSources.length === 0) {
17
- throw new Error(`No SQL files were discovered under ${options.directories.join(', ')}`);
18
- }
19
- // Concatenate the local DDL files in a stable order for deterministic diff outputs.
20
- const localSql = localSources.map((source) => source.sql).join('\n\n');
21
- const remoteSql = (0, pgDump_1.runPgDump)({
22
- url: options.url,
23
- pgDumpPath: options.pgDumpPath,
24
- connectionContext: options.connectionContext
25
- });
26
- const hasChanges = localSql !== remoteSql;
27
- // Create a unified diff patch only when there are material differences to report.
28
- const patch = hasChanges
29
- ? (0, diff_1.createTwoFilesPatch)('local', 'database', localSql, remoteSql, '', '', { context: 3 })
30
- : '-- No schema differences detected.';
31
- const databaseTarget = (0, connectionSummary_1.formatConnectionTarget)(options.connectionContext) || 'target: unknown';
32
- const header = `-- ztd ddl diff plan\n-- Local DDL: ${options.directories.join(', ')}\n-- Database: ${databaseTarget}\n-- Generated: ${new Date().toISOString()}\n\n`;
33
- // Guarantee the target path exists before emitting the plan file.
34
- (0, fs_1.ensureDirectory)(node_path_1.default.dirname(options.out));
35
- (0, node_fs_1.writeFileSync)(options.out, `${header}${patch}\n`, 'utf8');
36
- console.log(`DDL diff plan written to ${options.out}`);
37
- }
38
- //# sourceMappingURL=diff.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":";;;;;AAkBA,sCA2BC;AA7CD,qCAAwC;AACxC,0DAA6B;AAC7B,+BAA2C;AAC3C,8DAA2D;AAC3D,oCAA8C;AAC9C,4CAA4C;AAC5C,kEAAoE;AAYpE,SAAgB,aAAa,CAAC,OAA0B;IACtD,MAAM,YAAY,GAAG,IAAA,iCAAe,EAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,oFAAoF;IACpF,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,IAAA,kBAAS,EAAC;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC7C,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,QAAQ,KAAK,SAAS,CAAC;IAC1C,kFAAkF;IAClF,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,IAAA,0BAAmB,EAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC,CAAC,oCAAoC,CAAC;IAEzC,MAAM,cAAc,GAAG,IAAA,0CAAsB,EAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,CAAC;IAC9F,MAAM,MAAM,GAAG,uCAAuC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,cAAc,mBAAmB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtK,kEAAkE;IAClE,IAAA,oBAAe,EAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAA,uBAAa,EAAC,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,KAAK,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACzD,CAAC"}
@@ -1,6 +0,0 @@
1
- export interface GenerateEntitiesOptions {
2
- directories: string[];
3
- extensions: string[];
4
- out: string;
5
- }
6
- export declare function runGenerateEntities(options: GenerateEntitiesOptions): void;