check-workspace-constraints.ts 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539
  1. /**
  2. * Workspace package invariant checks for package-manager-independent quality
  3. * gates.
  4. *
  5. * Run: `tsx scripts/check-workspace-constraints.ts`.
  6. */
  7. import { existsSync, readdirSync, readFileSync } from 'node:fs'
  8. import { join, relative, resolve } from 'node:path'
  9. import { pathToFileURL } from 'node:url'
  10. import { hasTypertRemoteNavigation, isForbiddenPublicationFile } from './publication-payload.ts'
  11. import { collectProjectReferenceFaceViolations } from './project-reference-faces.ts'
  12. const root = resolve(import.meta.dirname, '..')
  13. // vendor/* is single-level; packages/<group>/<pkg> nests one level deeper
  14. // (the group dirs — core/llm/shell/… — are pure containers with no manifest).
  15. const workspaceGlobs = [
  16. { dir: 'vendor', depth: 1 },
  17. { dir: 'packages', depth: 2 },
  18. { dir: 'native', depth: 1 },
  19. { dir: 'native/landlock-run/packages', depth: 1 },
  20. { dir: 'apps', depth: 1 },
  21. ] as const
  22. const vendoredPackages = new Set([
  23. '@deepseek-ai/cordis',
  24. '@deepseek-ai/cosmokit',
  25. '@deepseek-ai/schemastery',
  26. '@deepseek-ai/cordis-plugin-loader',
  27. '@deepseek-ai/cordis-plugin-include',
  28. '@deepseek-ai/cordis-plugin-group',
  29. '@deepseek-ai/cordis-plugin-timer',
  30. '@deepseek-ai/cordis-plugin-hmr',
  31. '@deepseek-ai/cordis-plugin-logger-console',
  32. ])
  33. const publicLandlockPackages = new Set([
  34. '@deepseek-ai/node-addon-landlock-run',
  35. '@deepseek-ai/node-addon-landlock-run-linux-arm64',
  36. '@deepseek-ai/node-addon-landlock-run-linux-x64',
  37. ])
  38. /** Deliberate source payloads whose exact bytes are part of the package's audit surface. */
  39. const publicationSourceAllowlist: Readonly<Record<string, readonly string[]>> = {
  40. '@deepseek-ai/node-addon-landlock-run': ['src/main.c'],
  41. }
  42. const repositoryUrl = 'git+https://github.com/deepseek-harness/deepseek-harness.git'
  43. /**
  44. * Source home the published packages point consumers at. It differs from
  45. * {@link repositoryUrl}, which the Landlock packages keep because npm resolves
  46. * their trusted publishing against the repository that runs the workflow.
  47. */
  48. const publishedRepositoryUrl = 'git+https://github.com/deepseek-ai/deepseek-harness.git'
  49. /** Private packages that participate in workspace checks but not releases. */
  50. const experimentalPackageDirectory = /^packages\/experimental\/[^/]+$/
  51. /** npm namespace reserved for private experimental packages. */
  52. const experimentalPackageNamePrefix = '@deepseek-ai/dsh-experimental-'
  53. /** Directories whose packages this repository publishes: one release member each. */
  54. const releaseMemberDirectory = /^(?:packages\/(?!experimental\/)[^/]+\/[^/]+|apps\/(?!desktop(?:-host)?$)[^/]+|vendor\/[^/]+)$/
  55. /** Installable application assembled by electron-builder rather than published to npm. */
  56. const desktopApplicationDirectory = 'apps/desktop'
  57. const localArtifactDirs = new Set(['node_modules'])
  58. const appPackageFiles: Readonly<Record<string, readonly string[]>> = {
  59. '@deepseek-ai/dsh': ['lib/*.js'],
  60. '@deepseek-ai/dsh-desktop-host': [
  61. 'lib/index.js',
  62. 'config/desktop.cordis.patch.yml',
  63. ],
  64. // Sourcemaps stay out by payload policy; the worker-preview surface
  65. // (dist/preview.html and dist/preview/) backs private experimental
  66. // packages and is not published.
  67. '@deepseek-ai/dsh-web-frontend': ['dist', '!dist/**/*.map', '!dist/preview.html', '!dist/preview'],
  68. }
  69. /** The subset of package.json fields this constraint check cares about. */
  70. export interface PackageManifest {
  71. name?: string
  72. version?: string
  73. private?: boolean
  74. type?: string
  75. main?: string
  76. types?: string
  77. bin?: string | Record<string, string>
  78. exports?: Record<
  79. string,
  80. | string
  81. | {
  82. types?: string
  83. default?: string
  84. }
  85. | null
  86. | undefined
  87. >
  88. files?: string[]
  89. publishConfig?: { access?: string }
  90. repository?: { type?: string; url?: string; directory?: string }
  91. peerDependencies?: Record<string, string>
  92. devDependencies?: Record<string, string>
  93. dependencies?: Record<string, string>
  94. optionalDependencies?: Record<string, string>
  95. dsh?: {
  96. bundle?: {
  97. patch?: string
  98. }
  99. }
  100. }
  101. /** One workspace manifest and its repo-relative path. */
  102. export interface WorkspaceManifest {
  103. dir: string
  104. manifest: PackageManifest
  105. }
  106. function readJson(path: string): PackageManifest {
  107. return JSON.parse(readFileSync(path, 'utf8')) as PackageManifest
  108. }
  109. const rootManifest = readJson(join(root, 'package.json'))
  110. const repositoryVersion = rootManifest.version
  111. const landlockWorkspaceManifest = readJson(join(root, 'native/landlock-run/package.json'))
  112. const landlockVersion = landlockWorkspaceManifest.version
  113. /** Repo-relative dirs holding a package.json, walked to the configured depth. */
  114. function packageDirs(base: string, depth: number): string[] {
  115. if (depth === 1) {
  116. return readdirSync(join(root, base), { withFileTypes: true })
  117. .filter(entry => entry.isDirectory())
  118. .filter(entry => !localArtifactDirs.has(entry.name))
  119. .filter(entry => existsSync(join(root, base, entry.name, 'package.json')))
  120. .map(entry => `${base}/${entry.name}`)
  121. }
  122. return readdirSync(join(root, base), { withFileTypes: true })
  123. .filter(entry => entry.isDirectory())
  124. .filter(entry => !localArtifactDirs.has(entry.name))
  125. .flatMap(group => packageDirs(`${base}/${group.name}`, depth - 1))
  126. }
  127. function workspaceManifests(): WorkspaceManifest[] {
  128. const manifests: WorkspaceManifest[] = [
  129. { dir: '.', manifest: rootManifest },
  130. ]
  131. for (const { dir: base, depth } of workspaceGlobs) {
  132. for (const dir of packageDirs(base, depth)) {
  133. manifests.push({ dir, manifest: readJson(join(root, dir, 'package.json')) })
  134. }
  135. }
  136. return manifests
  137. }
  138. const packageFileExtras: Readonly<Record<string, readonly string[]>> = {
  139. // Statically linked client libraries keep their stylesheets next to the emitted
  140. // JavaScript, which imports them by relative path: the compile shell runs
  141. // them through its own CSS pipeline, so the sheets are published artifacts.
  142. // The glob covers whichever sheets a package emits; sourcemaps stay
  143. // unpublished, as everywhere else in the repository.
  144. '@deepseek-ai/dsh-client-ui-primitives': ['lib/**/*.css'],
  145. '@deepseek-ai/dsh-client-ui-dockkit': ['lib/**/*.css'],
  146. '@deepseek-ai/dsh-client-web': ['lib/**/*.css'],
  147. '@deepseek-ai/dsh-client-ui-theme': ['lib/styles'],
  148. // The CPython side ships as source .py files, published as-is rather than built.
  149. '@deepseek-ai/dsh-experimental-code-runtime-python': ['py/**/*.py'],
  150. // The shipped preset compositions travel inside the roster package.
  151. '@deepseek-ai/dsh-agent-presets': ['presets'],
  152. // The Web Host mounts the default-off settings owner independently of each
  153. // Agent-scoped delegation-tool instance.
  154. '@deepseek-ai/dsh-tool-subagent': ['lib/model-selection-settings.js'],
  155. // The JSONL backend resolves its private verification Worker relative to
  156. // import.meta.url; it is shipped without a public package subpath.
  157. '@deepseek-ai/dsh-session-persistence-jsonl': ['lib/worker.cjs'],
  158. // The argv-prefix runner entry ships beside the lib as its own bundle;
  159. // sandbox-local resolves it through the package's ./runner export. tsdown
  160. // also shares its generated FFI code through a hashed runtime chunk.
  161. '@deepseek-ai/dsh-sandbox-windows-acl': ['lib/runner.js', 'lib/types-*.js'],
  162. '@deepseek-ai/dsh-skill-badge': ['assets'],
  163. // Ordinary native containment ships a path-loaded runner and its shared
  164. // runner chunk beside the existing node-pty permission repair.
  165. '@deepseek-ai/dsh-subprocess-local': [
  166. 'lib/runner.js',
  167. 'lib/runner-*.js',
  168. 'scripts/ensure-spawn-helper.mjs',
  169. ],
  170. // tsdown shares the repository/pack code between the lib entry and the bin
  171. // through a hashed chunk. The committed bin.js is the link target pnpm can
  172. // resolve at install time, before the build produces lib/bin.js.
  173. '@deepseek-ai/dsh-experimental-webworker-packer': ['bin.js', 'lib/repository-*.js'],
  174. }
  175. function sameStringList(actual: readonly string[] | undefined, expected: readonly string[]): boolean {
  176. return !!actual && actual.length === expected.length && actual.every((value, index) => value === expected[index])
  177. }
  178. export function expectedDshPackageFiles(manifest: PackageManifest): readonly string[] {
  179. const declaredPatch = manifest.dsh?.bundle?.patch
  180. const bundleFiles = declaredPatch === undefined ? [] : [declaredPatch.replace(/^\.\//, '')]
  181. const extras = [
  182. ...bundleFiles,
  183. ...(manifest.name ? packageFileExtras[manifest.name] ?? [] : []),
  184. ]
  185. return [
  186. 'lib/index.js',
  187. // Packages with an invariant export publish its runtime as a separate
  188. // bundle; the package-invariant gate validates the source/export pairing.
  189. ...manifest.exports?.['./invariant'] ? ['lib/invariant.js'] : [],
  190. ...manifest.bin ? ['lib/bin.js'] : [],
  191. // Worker-thread packages ship a CJS worker entry; the browser worker
  192. // bundle is an ES module a page loads with `new Worker(type: 'module')`.
  193. // Keyed on the artifact path, like ./client below.
  194. ...exportDefault(manifest, './worker') === './lib/worker.cjs' ? ['lib/worker.cjs'] : [],
  195. ...exportDefault(manifest, './worker') === './lib/worker.js' ? ['lib/worker.js'] : [],
  196. // UI plugin packages ship their browser bundle beside the node lib
  197. // (single-artifact ruling: dist/ retired, ./client resolves lib/client.js).
  198. // Keyed on the artifact path, not the subpath name: a package's ./client is
  199. // a browser-safe source channel, not a bundle.
  200. ...exportDefault(manifest, './client') === './lib/client.js' ? ['lib/client.js'] : [],
  201. // runtime's shell-held loader subpath ships as its own bundle beside the client half.
  202. ...exportDefault(manifest, './loader') === './lib/loader.js' ? ['lib/loader.js'] : [],
  203. // A store subpath ships its own bundle (single-entry builds; no shared chunk).
  204. ...exportDefault(manifest, './store') === './lib/store/index.js' ? ['lib/store/index.js'] : [],
  205. // A surface bundle's startup row is its own bundle: the Loader imports it
  206. // as a row module, so it cannot ride inside the package entry.
  207. ...exportDefault(manifest, './startup') === './lib/startup.js' ? ['lib/startup.js'] : [],
  208. ...extras,
  209. // Subpaths whose runtime default is the tsc-emitted tree (lib/types/*.js —
  210. // browser-safe source channels rehomed off src so plain Node can import
  211. // them without type stripping) publish the emitted JS alongside the
  212. // declarations.
  213. ...usesEmittedTreeDefaults(manifest) ? ['lib/types/**/*.js'] : [],
  214. 'lib/types/**/*.d.ts',
  215. ...hasExportPair(manifest, './typert', './lib/typert.host.d.ts', './lib/typert.host.js')
  216. ? ['lib/typert.host.js', 'lib/typert.host.d.ts']
  217. : [],
  218. ...hasExportPair(manifest, './client/typert', './lib/typert.client.d.ts', './lib/typert.client.js')
  219. ? ['lib/typert.client.js', 'lib/typert.client.d.ts']
  220. : [],
  221. ...hasTypertRemoteNavigation(manifest)
  222. ? ['lib/typert.remote-client.js', 'lib/typert.remote-client.d.ts']
  223. : [],
  224. ]
  225. }
  226. /** Whether one conditional export exactly names the generated runtime and declaration pair. */
  227. function hasExportPair(
  228. manifest: PackageManifest,
  229. subpath: string,
  230. types: string,
  231. runtime: string,
  232. ): boolean {
  233. const entry = manifest.exports?.[subpath]
  234. return typeof entry === 'object'
  235. && entry !== null
  236. && entry.types === types
  237. && entry.default === runtime
  238. }
  239. /** Runtime target of an export entry: conditional `default`, or the bare-string shorthand. */
  240. function exportDefault(manifest: PackageManifest, subpath: string): string | undefined {
  241. const entry = manifest.exports?.[subpath]
  242. if (typeof entry === 'string') return entry
  243. if (typeof entry === 'object' && entry !== null) return entry.default
  244. return undefined
  245. }
  246. /** Whether any export's runtime default points into the tsc-emitted lib/types tree. */
  247. function usesEmittedTreeDefaults(manifest: PackageManifest): boolean {
  248. return Object.keys(manifest.exports ?? {}).some(subpath =>
  249. exportDefault(manifest, subpath)?.startsWith('./lib/types/') === true)
  250. }
  251. /** Experimental manifest requirements enforced independently from release metadata. */
  252. export function checkExperimentalManifest({ dir, manifest }: WorkspaceManifest): string[] {
  253. if (!experimentalPackageDirectory.test(dir)) return []
  254. const label = manifest.name ?? dir
  255. const errors: string[] = []
  256. if (manifest.name?.startsWith(experimentalPackageNamePrefix) !== true) {
  257. errors.push(`${label}: experimental package name must start with ${JSON.stringify(experimentalPackageNamePrefix)}`)
  258. }
  259. if (manifest.private !== true) errors.push(`${label}: experimental package must set "private": true`)
  260. if (manifest.publishConfig !== undefined) errors.push(`${label}: experimental package must omit publishConfig`)
  261. return errors
  262. }
  263. /**
  264. * Require a dsh-family manifest to carry the workspace version.
  265. *
  266. * The dsh release sequence publishes packages/ and apps/ members and every
  267. * private dsh package on one shared version, written by `release:dsh` and
  268. * shared with the workspace root. This name test is that boundary: it covers
  269. * the family wherever the manifest lives, so apps/ members cannot drift with
  270. * only the release lane noticing.
  271. * @param manifest - the workspace package manifest.
  272. * @param expected - the version every dsh-family manifest must carry (the root's).
  273. * @returns one violation naming the manifest and the expected version, or
  274. * undefined when the manifest is compliant or not in the family.
  275. */
  276. export function checkDshFamilyVersion(manifest: PackageManifest, expected: string | undefined): string | undefined {
  277. const name = manifest.name
  278. if (name !== '@deepseek-ai/dsh' && name?.startsWith('@deepseek-ai/dsh-') !== true) return undefined
  279. if (manifest.version !== expected) {
  280. return `${name}: package.json version must match root version ${expected ?? '(missing)'}`
  281. }
  282. return undefined
  283. }
  284. /**
  285. * Check one workspace manifest against publication and dsh-package policy.
  286. * @param workspace - package directory and parsed manifest.
  287. * @returns path-qualified policy violations.
  288. */
  289. export function checkWorkspaceManifest({ dir, manifest }: WorkspaceManifest): string[] {
  290. const errors = checkExperimentalManifest({ dir, manifest })
  291. const label = manifest.name ?? dir
  292. const familyVersionError = checkDshFamilyVersion(manifest, repositoryVersion)
  293. if (familyVersionError !== undefined) errors.push(familyVersionError)
  294. const isLandlockPackageDir = dir.startsWith('native/landlock-run/packages/')
  295. const isPublicLandlockPackage = isLandlockPackageDir
  296. && manifest.name !== undefined
  297. && publicLandlockPackages.has(manifest.name)
  298. if (isPublicLandlockPackage) {
  299. if (manifest.private === true) {
  300. errors.push(`${label}: published Landlock package must not set "private": true`)
  301. }
  302. if (manifest.publishConfig?.access !== 'public') {
  303. errors.push(`${label}: published Landlock package must set publishConfig.access to "public"`)
  304. }
  305. const expectedDirectory = dir
  306. if (manifest.repository?.type !== 'git'
  307. || manifest.repository.url !== repositoryUrl
  308. || manifest.repository.directory !== expectedDirectory) {
  309. errors.push(`${label}: published Landlock package repository must use ${repositoryUrl} with directory ${expectedDirectory} for trusted publishing`)
  310. }
  311. } else if (releaseMemberDirectory.test(dir)) {
  312. // Release members state that they are publishable: npm refuses a private
  313. // package, and the repository field is how a consumer finds the source of
  314. // the package it installed.
  315. //
  316. // Access is per release sequence, not per scope: the vendored framework and
  317. // the Landlock packages publish publicly because outside consumers install
  318. // them, and the dsh family published publicly with its own sequence on
  319. // 2026-08-13. No publish path passes `--access`; each packed manifest declares
  320. // it, and this gate requires every release member to be public.
  321. if (manifest.private === true) {
  322. errors.push(`${label}: release member must not set "private": true`)
  323. }
  324. if (manifest.publishConfig?.access !== 'public') {
  325. errors.push(`${label}: release member must set publishConfig.access to "public"`)
  326. }
  327. if (manifest.repository?.type !== 'git'
  328. || manifest.repository.url !== publishedRepositoryUrl
  329. || manifest.repository.directory !== dir) {
  330. errors.push(`${label}: release member repository must use ${publishedRepositoryUrl} with directory ${dir}`)
  331. }
  332. } else if (!experimentalPackageDirectory.test(dir) && manifest.private !== true) {
  333. errors.push(`${label}: package.json must set "private": true`)
  334. }
  335. if (manifest.name && vendoredPackages.has(manifest.name)) {
  336. return errors
  337. }
  338. if (manifest.name?.startsWith('@deepseek-ai/')) {
  339. const allowedSources = publicationSourceAllowlist[manifest.name] ?? []
  340. for (const file of manifest.files ?? []) {
  341. if (isForbiddenPublicationFile(file) && !allowedSources.includes(file)) {
  342. errors.push(`${label}: package.json files must not publish ${JSON.stringify(file)}`)
  343. }
  344. }
  345. }
  346. if (dir.startsWith('apps/') && dir !== desktopApplicationDirectory && manifest.name?.startsWith('@deepseek-ai/')) {
  347. const expectedFiles = appPackageFiles[manifest.name]
  348. if (expectedFiles === undefined) {
  349. errors.push(`${label}: app package has no publication files policy`)
  350. } else if (!sameStringList(manifest.files, expectedFiles)) {
  351. errors.push(`${label}: package.json files must be ${JSON.stringify(expectedFiles)}`)
  352. }
  353. }
  354. if (isLandlockPackageDir) {
  355. if (!isPublicLandlockPackage) {
  356. errors.push(`${label}: unexpected package in the public Landlock package family`)
  357. }
  358. if (manifest.version !== landlockVersion) {
  359. errors.push(`${label}: package.json version must match Landlock workspace version ${landlockVersion ?? '(missing)'}`)
  360. }
  361. }
  362. if (dir.startsWith('packages/') && manifest.name?.startsWith('@deepseek-ai/dsh-')) {
  363. const peer = manifest.peerDependencies?.['@deepseek-ai/cordis']
  364. const dev = manifest.devDependencies?.['@deepseek-ai/cordis']
  365. if (!peer) errors.push(`${label}: @deepseek-ai/cordis must be a peerDependency`)
  366. if (!dev) errors.push(`${label}: @deepseek-ai/cordis must also be a devDependency`)
  367. if (peer && dev && peer !== dev) {
  368. errors.push(`${label}: @deepseek-ai/cordis peer (${peer}) and dev (${dev}) ranges must match`)
  369. }
  370. if (manifest.type !== 'module') {
  371. errors.push(`${label}: package.json must set "type": "module"`)
  372. }
  373. if (manifest.main !== 'lib/index.js') {
  374. errors.push(`${label}: package.json must set "main": "lib/index.js"`)
  375. }
  376. if (manifest.types !== 'lib/types/index.d.ts') {
  377. errors.push(`${label}: package.json must set "types": "lib/types/index.d.ts"`)
  378. }
  379. const rootExport = manifest.exports?.['.']
  380. const rootEntry = typeof rootExport === 'object' && rootExport !== null ? rootExport : undefined
  381. if (rootEntry?.types !== './lib/types/index.d.ts') {
  382. errors.push(`${label}: package.json exports["."].types must be "./lib/types/index.d.ts"`)
  383. }
  384. if (rootEntry?.default !== './lib/index.js') {
  385. errors.push(`${label}: package.json exports["."].default must be "./lib/index.js"`)
  386. }
  387. const invariantRaw = manifest.exports?.['./invariant']
  388. const invariantExport = typeof invariantRaw === 'object' && invariantRaw !== null ? invariantRaw : undefined
  389. if (invariantExport?.types !== undefined && invariantExport.types !== './lib/types/invariant.d.ts') {
  390. errors.push(`${label}: package.json exports["./invariant"].types must be "./lib/types/invariant.d.ts"`)
  391. }
  392. if (invariantExport?.default !== undefined && invariantExport.default !== './lib/invariant.js') {
  393. errors.push(`${label}: package.json exports["./invariant"].default must be "./lib/invariant.js"`)
  394. }
  395. if (invariantExport && (invariantExport.types === undefined || invariantExport.default === undefined)) {
  396. errors.push(`${label}: package.json exports["./invariant"] must declare both types and default targets`)
  397. }
  398. const expectedFiles = expectedDshPackageFiles(manifest)
  399. if (!sameStringList(manifest.files, expectedFiles)) {
  400. errors.push(`${label}: package.json files must be ${JSON.stringify(expectedFiles)}`)
  401. }
  402. }
  403. return errors.map(error => `${relative(root, join(root, dir, 'package.json'))}: ${error}`)
  404. }
  405. /**
  406. * Enforce `packages/<group>/<pkg>`: groups are open-named containers without a
  407. * package.json, and packages may be neither flat nor more deeply nested.
  408. */
  409. function checkHierarchyShape(): string[] {
  410. const errors: string[] = []
  411. const packagesRoot = join(root, 'packages')
  412. for (const group of readdirSync(packagesRoot, { withFileTypes: true })) {
  413. if (!group.isDirectory()) continue
  414. const groupRel = join('packages', group.name)
  415. if (existsSync(join(packagesRoot, group.name, 'package.json'))) {
  416. errors.push(`${groupRel}: a group dir must not contain a package.json — packages live at packages/<group>/<pkg>, not directly under packages/`)
  417. continue
  418. }
  419. for (const pkg of readdirSync(join(packagesRoot, group.name), { withFileTypes: true })) {
  420. if (!pkg.isDirectory()) continue
  421. if (localArtifactDirs.has(pkg.name)) continue
  422. const pkgRel = join(groupRel, pkg.name)
  423. if (!existsSync(join(packagesRoot, group.name, pkg.name, 'package.json'))) {
  424. errors.push(`${pkgRel}: expected a package here (no package.json found) — the hierarchy is exactly packages/<group>/<pkg>, no deeper nesting`)
  425. }
  426. }
  427. }
  428. return errors
  429. }
  430. function checkRepositoryVersion(): string[] {
  431. // The root carries the dsh release family's version, so a prerelease such as
  432. // 0.0.1-rc.1 is a valid state between `release:dsh` and its publication.
  433. if (repositoryVersion && /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(repositoryVersion)) return []
  434. return ['package.json: version must be X.Y.Z with an optional prerelease segment']
  435. }
  436. /** Dependency sections whose ranges reach a published tarball or a local install. */
  437. const dependencySections = ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies'] as const
  438. /** Dependency sections present in an installed runtime. */
  439. const runtimeDependencySections = ['dependencies', 'optionalDependencies', 'peerDependencies'] as const
  440. /**
  441. * Prevent an official runtime from requiring a package its release omits.
  442. * @param manifests - release, private experimental, and deployment-root manifests.
  443. * @returns One error for each forbidden runtime dependency.
  444. */
  445. export function checkExperimentalDependencyIsolation(manifests: readonly WorkspaceManifest[]): string[] {
  446. const experimentalNames = new Set(manifests
  447. .filter(entry => experimentalPackageDirectory.test(entry.dir))
  448. .map(entry => entry.manifest.name)
  449. .filter(name => name !== undefined))
  450. const errors: string[] = []
  451. for (const { dir, manifest } of manifests) {
  452. if (!releaseMemberDirectory.test(dir) && dir !== 'python/sdk-runtime') continue
  453. for (const section of runtimeDependencySections) {
  454. for (const name of Object.keys(manifest[section] ?? {})) {
  455. if (!experimentalNames.has(name)) continue
  456. errors.push(`${manifest.name ?? dir}: ${section}.${name} must not reference an experimental package`)
  457. }
  458. }
  459. }
  460. return errors
  461. }
  462. /**
  463. * Require the `workspace:` protocol for every reference to a workspace member.
  464. *
  465. * A hand-written range says nothing about the version the workspace actually
  466. * carries, and `pnpm pack` leaves it alone: `^0.0.1` published from version
  467. * `0.0.2` names a version that does not exist. The protocol makes pack
  468. * substitute the member's real version, so no release step rewrites ranges.
  469. * @param manifests - every workspace manifest.
  470. * @returns One error per reference that names a workspace member without the protocol.
  471. */
  472. function checkWorkspaceProtocol(manifests: readonly WorkspaceManifest[]): string[] {
  473. const members = new Set(manifests.map(entry => entry.manifest.name).filter(name => name !== undefined))
  474. const errors: string[] = []
  475. for (const { dir, manifest } of manifests) {
  476. for (const section of dependencySections) {
  477. for (const [name, range] of Object.entries(manifest[section] ?? {})) {
  478. if (!members.has(name) || range.startsWith('workspace:')) continue
  479. errors.push(`${manifest.name ?? dir}: ${section}.${name} must use the workspace: protocol, got ${range}`)
  480. }
  481. }
  482. }
  483. return errors
  484. }
  485. /** Run the repository constraint gate. */
  486. export function main(): void {
  487. const manifests = workspaceManifests()
  488. const dependencyManifests = [
  489. ...manifests,
  490. { dir: 'python/sdk-runtime', manifest: readJson(join(root, 'python/sdk-runtime/package.json')) },
  491. ]
  492. const errors = [
  493. ...checkRepositoryVersion(),
  494. ...manifests.flatMap(checkWorkspaceManifest),
  495. ...checkWorkspaceProtocol(manifests),
  496. ...checkExperimentalDependencyIsolation(dependencyManifests),
  497. ...checkHierarchyShape(),
  498. ...collectProjectReferenceFaceViolations(root),
  499. ]
  500. if (errors.length > 0) {
  501. console.error(errors.join('\n'))
  502. process.exitCode = 1
  503. }
  504. }
  505. if (process.argv[1] !== undefined && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) main()