@shivaedev/quality 0.49.0 → 0.50.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 (75) hide show
  1. package/CHANGELOG.md +23 -0
  2. package/README.md +8 -2
  3. package/dist/cli/args.d.ts +1 -0
  4. package/dist/cli/args.d.ts.map +1 -1
  5. package/dist/cli/args.js +8 -34
  6. package/dist/cli/args.js.map +1 -1
  7. package/dist/cli/baseline.d.ts +1 -1
  8. package/dist/cli/baseline.d.ts.map +1 -1
  9. package/dist/cli/baseline.js +9 -3
  10. package/dist/cli/baseline.js.map +1 -1
  11. package/dist/cli/messages.d.ts +1 -1
  12. package/dist/cli/messages.d.ts.map +1 -1
  13. package/dist/cli/messages.js +2 -1
  14. package/dist/cli/messages.js.map +1 -1
  15. package/dist/cli/options.d.ts +45 -0
  16. package/dist/cli/options.d.ts.map +1 -0
  17. package/dist/cli/options.js +35 -0
  18. package/dist/cli/options.js.map +1 -0
  19. package/dist/cli/program.js +1 -1
  20. package/dist/cli/program.js.map +1 -1
  21. package/dist/imports/classifyRuntime.d.ts.map +1 -1
  22. package/dist/imports/classifyRuntime.js +4 -1
  23. package/dist/imports/classifyRuntime.js.map +1 -1
  24. package/dist/imports/runtime.d.ts +6 -3
  25. package/dist/imports/runtime.d.ts.map +1 -1
  26. package/dist/imports/runtime.js +15 -21
  27. package/dist/imports/runtime.js.map +1 -1
  28. package/dist/naming/migrationFile.d.ts.map +1 -1
  29. package/dist/naming/migrationFile.js +3 -1
  30. package/dist/naming/migrationFile.js.map +1 -1
  31. package/dist/naming/moduleRoot.d.ts +2 -0
  32. package/dist/naming/moduleRoot.d.ts.map +1 -0
  33. package/dist/naming/moduleRoot.js +13 -0
  34. package/dist/naming/moduleRoot.js.map +1 -0
  35. package/dist/rules/builtIn.d.ts +1 -1
  36. package/dist/rules/effect/boundary.d.ts.map +1 -1
  37. package/dist/rules/effect/boundary.js +30 -6
  38. package/dist/rules/effect/boundary.js.map +1 -1
  39. package/dist/rules/effect/boundaryCalls.d.ts +3 -0
  40. package/dist/rules/effect/boundaryCalls.d.ts.map +1 -0
  41. package/dist/rules/effect/boundaryCalls.js +121 -0
  42. package/dist/rules/effect/boundaryCalls.js.map +1 -0
  43. package/dist/rules/effect/boundaryReference.d.ts +4 -0
  44. package/dist/rules/effect/boundaryReference.d.ts.map +1 -0
  45. package/dist/rules/effect/boundaryReference.js +80 -0
  46. package/dist/rules/effect/boundaryReference.js.map +1 -0
  47. package/dist/rules/effect/program.d.ts +1 -1
  48. package/dist/rules/effect/program.d.ts.map +1 -1
  49. package/dist/rules/effect/program.js +4 -1
  50. package/dist/rules/effect/program.js.map +1 -1
  51. package/dist/rules/effect/promiseParameter.d.ts +3 -0
  52. package/dist/rules/effect/promiseParameter.d.ts.map +1 -0
  53. package/dist/rules/effect/promiseParameter.js +24 -0
  54. package/dist/rules/effect/promiseParameter.js.map +1 -0
  55. package/dist/rules/imports/runtime.d.ts +1 -1
  56. package/dist/rules/imports/runtime.d.ts.map +1 -1
  57. package/dist/rules/stories/groupedOutcomes.js +1 -1
  58. package/dist/rules/stories/groupedOutcomes.js.map +1 -1
  59. package/docs/debt-and-hooks.md +3 -1
  60. package/package.json +2 -2
  61. package/src/cli/args.ts +15 -43
  62. package/src/cli/baseline.ts +9 -2
  63. package/src/cli/messages.ts +2 -1
  64. package/src/cli/options.ts +43 -0
  65. package/src/cli/program.ts +1 -1
  66. package/src/imports/classifyRuntime.ts +4 -1
  67. package/src/imports/runtime.ts +19 -21
  68. package/src/naming/migrationFile.ts +3 -1
  69. package/src/naming/moduleRoot.ts +13 -0
  70. package/src/rules/effect/boundary.ts +48 -24
  71. package/src/rules/effect/boundaryCalls.ts +130 -0
  72. package/src/rules/effect/boundaryReference.ts +85 -0
  73. package/src/rules/effect/program.ts +4 -1
  74. package/src/rules/effect/promiseParameter.ts +26 -0
  75. package/src/rules/stories/groupedOutcomes.ts +1 -1
@@ -1,10 +1,12 @@
1
1
  import { posix } from "node:path";
2
+ import { moduleRoot } from "./moduleRoot.js";
2
3
  export const MIGRATIONS_DIRECTORY = "src/server/migrations";
3
4
  export const MIGRATION_FILE_PATTERN = /^[0-9]{4}_[a-z][a-z0-9]*(?:_[a-z0-9]+)*\.ts$/u;
4
5
  export function isMigrationFile(path) {
5
6
  const directory = posix.dirname(path);
6
7
  const conventional = directory === MIGRATIONS_DIRECTORY || directory.endsWith(`/${MIGRATIONS_DIRECTORY}`);
7
- const modular = /(?:^|\/)src\/modules\/[^/]+\/server\/migrations$/u.test(directory);
8
+ const root = moduleRoot(path);
9
+ const modular = root !== undefined && directory === `${root}/server/migrations`;
8
10
  return (conventional || modular) && MIGRATION_FILE_PATTERN.test(posix.basename(path));
9
11
  }
10
12
  //# sourceMappingURL=migrationFile.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"migrationFile.js","sourceRoot":"","sources":["../../src/naming/migrationFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,+CAA+C,CAAC;AAEtF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,SAAS,KAAK,oBAAoB,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAC1G,MAAM,OAAO,GAAG,mDAAmD,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpF,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACvF,CAAC"}
1
+ {"version":3,"file":"migrationFile.js","sourceRoot":"","sources":["../../src/naming/migrationFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,+CAA+C,CAAC;AAEtF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,SAAS,KAAK,oBAAoB,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAC1G,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,IAAI,SAAS,KAAK,GAAG,IAAI,oBAAoB,CAAC;IAChF,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACvF,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare function moduleRoot(path: string): string | undefined;
2
+ //# sourceMappingURL=moduleRoot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"moduleRoot.d.ts","sourceRoot":"","sources":["../../src/naming/moduleRoot.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU3D"}
@@ -0,0 +1,13 @@
1
+ const RUNTIME = /^(?:client|server|test-support)\//u;
2
+ export function moduleRoot(path) {
3
+ const match = /^(?<root>(?:.*\/)?src\/modules\/[^/]+)\/(?<local>.+)$/u.exec(path)?.groups;
4
+ if (match?.root === undefined || match.local === undefined) {
5
+ return undefined;
6
+ }
7
+ if (RUNTIME.test(match.local)) {
8
+ return match.root;
9
+ }
10
+ const separator = match.local.indexOf("/");
11
+ return separator > 0 && RUNTIME.test(match.local.slice(separator + 1)) ? `${match.root}/${match.local.slice(0, separator)}` : undefined;
12
+ }
13
+ //# sourceMappingURL=moduleRoot.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"moduleRoot.js","sourceRoot":"","sources":["../../src/naming/moduleRoot.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,oCAAoC,CAAC;AAErD,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,wDAAwD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAC1F,IAAI,KAAK,EAAE,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,SAAS,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACzI,CAAC"}
@@ -14,7 +14,7 @@ export declare const builtInRules: readonly [import("../rule.ts").Rule<"code/unu
14
14
  }[];
15
15
  }, never>, import("../rule.ts").Rule<"suppressions/biome-recommended", undefined, import("../rule.ts").RuleServices>, import("../rule.ts").Rule<"biome", undefined, import("../rule.ts").RuleServices>, import("../rule.ts").Rule<"imports/cycles", undefined, never>, import("../rule.ts").Rule<"imports/fences", {
16
16
  readonly fences?: readonly import("../imports/fences/model.ts").Fence[];
17
- }, never>, import("../rule.ts").Rule<"imports/runtime", undefined, never>, import("../rule.ts").Rule<"imports/resolvable", {
17
+ }, never>, import("../rule.ts").Rule<"imports/runtime", undefined, import("effect/FileSystem").FileSystem>, import("../rule.ts").Rule<"imports/resolvable", {
18
18
  readonly generated?: readonly string[];
19
19
  }, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>, import("../rule.ts").Rule<"imports/manifest", undefined, never>, import("../rule.ts").Rule<"imports/aliased", undefined, never>, import("../rule.ts").Rule<"imports/no-test-code", undefined, never>, import("../rule.ts").Rule<"manifests/valid", undefined, never>, import("../rule.ts").Rule<"manifests/sorted", undefined, never>, import("../rule.ts").Rule<"manifests/source-first", undefined, never>, import("../rule.ts").Rule<"manifests/exports-shape", undefined, never>, import("../rule.ts").Rule<"manifests/application", undefined, never>, import("../rule.ts").Rule<"files/named-after-export", {
20
20
  readonly toolOwned?: readonly string[];
@@ -1 +1 @@
1
- {"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../../src/rules/effect/boundary.ts"],"names":[],"mappings":"AA8CA,eAAO,MAAM,cAAc,8DA4BzB,CAAC"}
1
+ {"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../../src/rules/effect/boundary.ts"],"names":[],"mappings":"AAgFA,eAAO,MAAM,cAAc,8DAkBzB,CAAC"}
@@ -1,5 +1,10 @@
1
+ import { join } from "node:path";
1
2
  import ts from "typescript";
2
3
  import { defineRule } from "#rule.ts";
4
+ import { boundaryCalls } from "#rules/effect/boundaryCalls.ts";
5
+ import { boundaryEntryPoint } from "#rules/effect/boundaryReference.ts";
6
+ import { effectProgram } from "#rules/effect/program.ts";
7
+ import { promiseParameter } from "#rules/effect/promiseParameter.ts";
3
8
  import { parse } from "#rules/parse.ts";
4
9
  function asyncConstruct(node) {
5
10
  if (!(ts.isFunctionLike(node) && ts.canHaveModifiers(node) && ts.getModifiers(node)?.some((modifier) => modifier.kind === ts.SyntaxKind.AsyncKeyword))) {
@@ -36,15 +41,19 @@ function construct(node) {
36
41
  }
37
42
  return ts.isThrowStatement(node) ? "throw statement" : asyncConstruct(node);
38
43
  }
39
- export const effectBoundary = defineRule({
40
- check: ({ sources }) => sources.flatMap((file) => {
44
+ function checkBoundary(inputs) {
45
+ const program = effectProgram(inputs, false);
46
+ const checker = program.getTypeChecker();
47
+ const call = boundaryCalls(checker);
48
+ return inputs.sources.flatMap((file) => {
41
49
  if (/(?:^|\/)(?:adapters|test-support)\//u.test(file.path)) {
42
50
  return [];
43
51
  }
44
- const source = parse(file);
52
+ const source = parse(file) === undefined ? undefined : program.getSourceFile(join(inputs.root, file.path));
45
53
  const findings = [];
54
+ const entryPoint = source !== undefined && boundaryEntryPoint(file.path, source, checker);
46
55
  function visit(node) {
47
- const name = construct(node);
56
+ const name = construct(node) ?? call(node, entryPoint) ?? promiseParameter(checker, node);
48
57
  if (name !== undefined && source !== undefined) {
49
58
  findings.push({
50
59
  file: file.path,
@@ -58,8 +67,23 @@ export const effectBoundary = defineRule({
58
67
  visit(source);
59
68
  }
60
69
  return findings;
61
- }),
62
- description: "All checked source, tooling and specs use Effect instead of async, await, new Promise, .then, try or throw. Only adapters/ and test-support/ folders at any depth are exempt. adapters/ bridges outside libraries to Effect; it remains subject to service-parameter and ambient runtime bans. Use tagged errors or Effect.die for defects. Config exceptions and inline suppressions are refused; baseline existing debt.",
70
+ });
71
+ }
72
+ export const effectBoundary = defineRule({
73
+ check: (inputs) => {
74
+ const groups = new Map();
75
+ for (const source of inputs.sources) {
76
+ if (/(?:^|\/)(?:adapters|test-support)\//u.test(source.path) || !/\.[cm]?[jt]sx?$/u.test(source.path)) {
77
+ continue;
78
+ }
79
+ const group = /^(?:packages|examples)\/[^/]+/u.exec(source.path)?.[0] ?? ".";
80
+ const sources = groups.get(group) ?? [];
81
+ sources.push(source);
82
+ groups.set(group, sources);
83
+ }
84
+ return [...groups.values()].flatMap((sources) => checkBoundary({ ...inputs, sources }));
85
+ },
86
+ description: "Use Effect instead of Promise syntax and parameters, synchronous Node IO, throwing helper calls or Effect.sync with throwing APIs. Runners belong at entry points, tool configs and tests. Only adapters/ and test-support/ folders are exempt. Use Effect services and tagged errors; bridge outside libraries in adapters/. No config exceptions or inline suppressions; baseline existing debt.",
63
87
  id: "effect/boundary",
64
88
  registrable: false,
65
89
  });
@@ -1 +1 @@
1
- {"version":3,"file":"boundary.js","sourceRoot":"","sources":["../../../src/rules/effect/boundary.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"boundary.js","sourceRoot":"","sources":["../../../src/rules/effect/boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAiC,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,SAAS,cAAc,CAAC,IAAa;IACpC,IACC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EACjJ,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC;IACtB,CAAC;IACD,OAAO,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACzE,CAAC;AAED,SAAS,QAAQ,CAAC,IAAa;IAC9B,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;IAC/B,OAAO,CACN,CAAC,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;WACnE,CAAC,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,MAAM,CAAC,kBAAkB,CAAC,IAAI,KAAK,MAAM,CAAC,CACvI,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAa;IAC/B,IAAI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC9G,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,EAAE,CAAC;QACnG,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACxG,OAAO,kBAAkB,CAAC;IAC3B,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC;IACrB,CAAC;IACD,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,aAAa,CAAC,MAAkB;IACxC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACtC,IAAI,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5D,OAAO,EAAE,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3G,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1F,SAAS,KAAK,CAAC,IAAa;YAC3B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1F,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChD,QAAQ,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,MAAM,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;oBAC1E,OAAO,EAAE,QAAQ,IAAI,6KAA6K;iBAClM,CAAC,CAAC;YACJ,CAAC;YACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,KAAK,CAAC,MAAM,CAAC,CAAC;QACf,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACxC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2C,CAAC;QAClE,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,sCAAsC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvG,SAAS;YACV,CAAC;YACD,MAAM,KAAK,GAAG,gCAAgC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;YAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACzF,CAAC;IACD,WAAW,EACV,oYAAoY;IACrY,EAAE,EAAE,iBAAiB;IACrB,WAAW,EAAE,KAAK;CAClB,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ import ts from "typescript";
2
+ export declare function boundaryCalls(checker: ts.TypeChecker): (node: ts.Node, entryPoint: boolean) => string | undefined;
3
+ //# sourceMappingURL=boundaryCalls.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"boundaryCalls.d.ts","sourceRoot":"","sources":["../../../src/rules/effect/boundaryCalls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AA+D5B,wBAAgB,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,UAiDtC,EAAE,CAAC,IAAI,cAAc,OAAO,KAAG,MAAM,GAAG,SAAS,CAiB/D"}
@@ -0,0 +1,121 @@
1
+ import ts from "typescript";
2
+ import { boundaryReference } from "#rules/effect/boundaryReference.ts";
3
+ function synchronousIo(reference) {
4
+ return /^(?:node:)?fs\.[^.]+Sync$/u.test(reference) || /^(?:node:)?child_process\.(?:execSync|execFileSync|spawnSync)$/u.test(reference);
5
+ }
6
+ function knownThrowing(reference) {
7
+ return ((synchronousIo(reference) && !/^(?:node:)?fs\.existsSync$/u.test(reference))
8
+ || /^(?:JSON\.parse|decodeURI|decodeURIComponent|encodeURI|encodeURIComponent|BigInt)$/u.test(reference)
9
+ || /^(?:effect\.Schema|effect\/Schema)\.(?:decodeUnknownSync|decodeSync|encodeUnknownSync|encodeSync)$/u.test(reference));
10
+ }
11
+ function immediateBody(node) {
12
+ if (!(ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node) || ts.isArrowFunction(node) || ts.isFunctionExpression(node))) {
13
+ return undefined;
14
+ }
15
+ if (node.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.AsyncKeyword)
16
+ || ("asteriskToken" in node && node.asteriskToken !== undefined)) {
17
+ return undefined;
18
+ }
19
+ return node.body;
20
+ }
21
+ function functionBody(checker, expression) {
22
+ if (ts.isArrowFunction(expression) || ts.isFunctionExpression(expression)) {
23
+ return immediateBody(expression);
24
+ }
25
+ const symbol = checker.getSymbolAtLocation(expression);
26
+ const target = symbol !== undefined && symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol;
27
+ for (const declaration of target?.declarations ?? []) {
28
+ if (declaration.getSourceFile().isDeclarationFile || /(?:^|\/)node_modules\//u.test(declaration.getSourceFile().fileName)) {
29
+ continue;
30
+ }
31
+ if (ts.isVariableDeclaration(declaration) && declaration.initializer !== undefined) {
32
+ return functionBody(checker, declaration.initializer);
33
+ }
34
+ const body = immediateBody(declaration);
35
+ if (body !== undefined) {
36
+ return body;
37
+ }
38
+ }
39
+ return undefined;
40
+ }
41
+ function runnerReference(node) {
42
+ if (ts.isCallExpression(node)) {
43
+ return ts.isIdentifier(node.expression) ? node.expression : undefined;
44
+ }
45
+ if (!ts.isIdentifier(node)) {
46
+ return ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node) ? node : undefined;
47
+ }
48
+ const parent = node.parent;
49
+ if (ts.isCallExpression(parent) && parent.expression === node) {
50
+ return undefined;
51
+ }
52
+ return "name" in parent && parent.name === node && !ts.isShorthandPropertyAssignment(parent) ? undefined : node;
53
+ }
54
+ export function boundaryCalls(checker) {
55
+ const throwing = new Map();
56
+ function throws(body) {
57
+ const previous = throwing.get(body);
58
+ if (previous !== undefined) {
59
+ return previous;
60
+ }
61
+ function visit(node) {
62
+ return ts.isThrowStatement(node) || (!ts.isFunctionLike(node) && (ts.forEachChild(node, visit) ?? false));
63
+ }
64
+ const result = visit(body);
65
+ throwing.set(body, result);
66
+ return result;
67
+ }
68
+ function guard(call) {
69
+ const body = functionBody(checker, call.expression);
70
+ return body !== undefined && throws(body);
71
+ }
72
+ function unsafeSync(call) {
73
+ const callback = call.arguments[0];
74
+ const body = callback === undefined ? undefined : functionBody(checker, callback);
75
+ if (body === undefined) {
76
+ return callback !== undefined && knownThrowing(boundaryReference(checker, callback) ?? "");
77
+ }
78
+ function visit(node) {
79
+ if (ts.isFunctionLike(node)) {
80
+ return false;
81
+ }
82
+ if (ts.isThrowStatement(node)) {
83
+ return true;
84
+ }
85
+ if (ts.isCallExpression(node) && (knownThrowing(boundaryReference(checker, node.expression) ?? "") || guard(node))) {
86
+ return true;
87
+ }
88
+ return ts.forEachChild(node, visit) ?? false;
89
+ }
90
+ return visit(body);
91
+ }
92
+ function runner(node, entryPoint) {
93
+ if (entryPoint) {
94
+ return undefined;
95
+ }
96
+ const expression = runnerReference(node);
97
+ if (expression === undefined) {
98
+ return undefined;
99
+ }
100
+ const reference = boundaryReference(checker, expression);
101
+ return /^effect(?:\.Effect|\/Effect)\.run/u.test(reference ?? "") ? `${reference} outside an entry point` : undefined;
102
+ }
103
+ return (node, entryPoint) => {
104
+ const runtime = runner(node, entryPoint);
105
+ if (runtime !== undefined) {
106
+ return runtime;
107
+ }
108
+ if (!ts.isCallExpression(node)) {
109
+ return undefined;
110
+ }
111
+ const reference = boundaryReference(checker, node.expression) ?? "";
112
+ if (synchronousIo(reference)) {
113
+ return `synchronous IO (${reference})`;
114
+ }
115
+ if (/^effect(?:\.Effect|\/Effect)\.sync$/u.test(reference) && unsafeSync(node)) {
116
+ return "Effect.sync with a throwing body";
117
+ }
118
+ return guard(node) ? `throwing helper call (${node.expression.getText()})` : undefined;
119
+ };
120
+ }
121
+ //# sourceMappingURL=boundaryCalls.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"boundaryCalls.js","sourceRoot":"","sources":["../../../src/rules/effect/boundaryCalls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,SAAS,aAAa,CAAC,SAAiB;IACvC,OAAO,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,iEAAiE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC1I,CAAC;AAED,SAAS,aAAa,CAAC,SAAiB;IACvC,OAAO,CACN,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;WACzE,qFAAqF,CAAC,IAAI,CAAC,SAAS,CAAC;WACrG,qGAAqG,CAAC,IAAI,CAAC,SAAS,CAAC,CACxH,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAa;IACnC,IAAI,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACpI,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IACC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;WAC7E,CAAC,eAAe,IAAI,IAAI,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,EAC/D,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,OAAuB,EAAE,UAAyB;IACvE,IAAI,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3E,OAAO,aAAa,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACvH,KAAK,MAAM,WAAW,IAAI,MAAM,EAAE,YAAY,IAAI,EAAE,EAAE,CAAC;QACtD,IAAI,WAAW,CAAC,aAAa,EAAE,CAAC,iBAAiB,IAAI,yBAAyB,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3H,SAAS;QACV,CAAC;QACD,IAAI,EAAE,CAAC,qBAAqB,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACpF,OAAO,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,IAAa;IACrC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrG,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC/D,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,6BAA6B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAuB;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,SAAS,MAAM,CAAC,IAAa;QAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QACjB,CAAC;QACD,SAAS,KAAK,CAAC,IAAa;YAC3B,OAAO,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAC3G,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IACf,CAAC;IACD,SAAS,KAAK,CAAC,IAAuB;QACrC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,OAAO,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,SAAS,UAAU,CAAC,IAAuB;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,QAAQ,KAAK,SAAS,IAAI,aAAa,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,SAAS,KAAK,CAAC,IAAa;YAC3B,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,OAAO,KAAK,CAAC;YACd,CAAC;YACD,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACb,CAAC;YACD,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACpH,OAAO,IAAI,CAAC;YACb,CAAC;YACD,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC;QAC9C,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,SAAS,MAAM,CAAC,IAAa,EAAE,UAAmB;QACjD,IAAI,UAAU,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACzD,OAAO,oCAAoC,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC;IACvH,CAAC;IACD,OAAO,CAAC,IAAa,EAAE,UAAmB,EAAsB,EAAE;QACjE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACpE,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,mBAAmB,SAAS,GAAG,CAAC;QACxC,CAAC;QACD,IAAI,sCAAsC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChF,OAAO,kCAAkC,CAAC;QAC3C,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,CAAC,CAAC;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import ts from "typescript";
2
+ export declare function boundaryReference(checker: ts.TypeChecker, node: ts.Node, seen?: Set<ts.Symbol>): string | undefined;
3
+ export declare function boundaryEntryPoint(path: string, source: ts.SourceFile, checker: ts.TypeChecker): boolean;
4
+ //# sourceMappingURL=boundaryReference.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"boundaryReference.d.ts","sourceRoot":"","sources":["../../../src/rules/effect/boundaryReference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAuD5B,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,iBAAuB,GAAG,MAAM,GAAG,SAAS,CAUzH;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,OAAO,CAiBxG"}
@@ -0,0 +1,80 @@
1
+ import ts from "typescript";
2
+ function importedReference(declaration) {
3
+ if (ts.isImportSpecifier(declaration)) {
4
+ const module = declaration.parent.parent.parent.moduleSpecifier;
5
+ return ts.isStringLiteral(module) ? `${module.text}.${(declaration.propertyName ?? declaration.name).text}` : undefined;
6
+ }
7
+ if (ts.isNamespaceImport(declaration) || ts.isImportClause(declaration)) {
8
+ const module = ts.isNamespaceImport(declaration) ? declaration.parent.parent.moduleSpecifier : declaration.parent.moduleSpecifier;
9
+ return ts.isStringLiteral(module) ? module.text : undefined;
10
+ }
11
+ return undefined;
12
+ }
13
+ function memberName(node) {
14
+ if (ts.isPropertyAccessExpression(node)) {
15
+ return node.name.text;
16
+ }
17
+ return ts.isStringLiteralLike(node.argumentExpression) ? node.argumentExpression.text : undefined;
18
+ }
19
+ function bindingReference(checker, declaration, seen) {
20
+ if (!(ts.isBindingElement(declaration) && ts.isObjectBindingPattern(declaration.parent))) {
21
+ return undefined;
22
+ }
23
+ const variable = declaration.parent.parent;
24
+ const name = declaration.propertyName ?? declaration.name;
25
+ if (!ts.isVariableDeclaration(variable) || variable.initializer === undefined || !(ts.isIdentifier(name) || ts.isStringLiteral(name))) {
26
+ return undefined;
27
+ }
28
+ const owner = boundaryReference(checker, variable.initializer, seen);
29
+ return owner === undefined ? undefined : `${owner}.${name.text}`;
30
+ }
31
+ function symbolReference(checker, node, seen) {
32
+ const symbol = checker.getSymbolAtLocation(node);
33
+ if (symbol === undefined) {
34
+ return node.text;
35
+ }
36
+ if (seen.has(symbol)) {
37
+ return undefined;
38
+ }
39
+ seen.add(symbol);
40
+ for (const declaration of symbol.declarations ?? []) {
41
+ if (ts.isVariableDeclaration(declaration) && declaration.initializer !== undefined) {
42
+ return boundaryReference(checker, declaration.initializer, seen);
43
+ }
44
+ const imported = importedReference(declaration) ?? bindingReference(checker, declaration, seen);
45
+ if (imported !== undefined) {
46
+ return imported;
47
+ }
48
+ }
49
+ return symbol.declarations?.some((declaration) => !declaration.getSourceFile().isDeclarationFile) ? undefined : node.text;
50
+ }
51
+ export function boundaryReference(checker, node, seen = new Set()) {
52
+ if (ts.isParenthesizedExpression(node)) {
53
+ return boundaryReference(checker, node.expression, seen);
54
+ }
55
+ if (ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node)) {
56
+ const member = memberName(node);
57
+ const owner = boundaryReference(checker, node.expression, seen);
58
+ return owner === undefined || member === undefined ? undefined : `${owner}.${member}`;
59
+ }
60
+ return ts.isIdentifier(node) ? symbolReference(checker, node, seen) : undefined;
61
+ }
62
+ export function boundaryEntryPoint(path, source, checker) {
63
+ if (/(?:^|\/)(?:cli|main|[^/]+-cli)\.[cm]?[jt]sx?$|\.(?:config|test|spec)\.[cm]?[jt]sx?$/u.test(path)) {
64
+ return true;
65
+ }
66
+ function visit(node) {
67
+ if (ts.isCallExpression(node)) {
68
+ const reference = boundaryReference(checker, node.expression);
69
+ if (reference?.endsWith(".runMain") || (ts.isIdentifier(node.expression) && node.expression.text === "runMain")) {
70
+ return true;
71
+ }
72
+ }
73
+ if (ts.isBinaryExpression(node) && node.getText(source).replace(/\s/gu, "") === "fileURLToPath(import.meta.url)===process.argv[1]") {
74
+ return true;
75
+ }
76
+ return ts.forEachChild(node, visit) ?? false;
77
+ }
78
+ return visit(source);
79
+ }
80
+ //# sourceMappingURL=boundaryReference.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"boundaryReference.js","sourceRoot":"","sources":["../../../src/rules/effect/boundaryReference.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
1
  import ts from "typescript";
2
2
  import type { RuleInputs } from "#rule.ts";
3
- export declare function effectProgram(inputs: RuleInputs): ts.Program;
3
+ export declare function effectProgram(inputs: RuleInputs, externalTypes?: boolean): ts.Program;
4
4
  //# sourceMappingURL=program.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../../src/rules/effect/program.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,EAAE,CAAC,OAAO,CAoB5D"}
1
+ {"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../../src/rules/effect/program.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,UAAO,GAAG,EAAE,CAAC,OAAO,CAuBlF"}
@@ -1,7 +1,7 @@
1
1
  import { join } from "node:path";
2
2
  import ts from "typescript";
3
3
  import { projectsFor } from "#imports/projects.ts";
4
- export function effectProgram(inputs) {
4
+ export function effectProgram(inputs, externalTypes = true) {
5
5
  const projectOf = projectsFor(inputs.root);
6
6
  const options = {
7
7
  allowJs: true,
@@ -16,6 +16,9 @@ export function effectProgram(inputs) {
16
16
  const read = host.readFile;
17
17
  host.readFile = (path) => texts.get(path) ?? read(path);
18
18
  host.resolveModuleNames = (names, from) => names.map((name) => {
19
+ if (!(externalTypes || name.startsWith(".") || name.startsWith("#") || name.startsWith("@shivaedev/"))) {
20
+ return undefined;
21
+ }
19
22
  const project = projectOf(from);
20
23
  return ts.resolveModuleName(name, from, project.typesOptions, host, project.typesCache).resolvedModule;
21
24
  });
@@ -1 +1 @@
1
- {"version":3,"file":"program.js","sourceRoot":"","sources":["../../../src/rules/effect/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC/C,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAuB;QACnC,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ;QACxB,YAAY,EAAE,IAAI;QAClB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;QAC9B,KAAK,EAAE,EAAE;KACT,CAAC;IACF,MAAM,IAAI,GAAG,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrG,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,kBAAkB,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACzC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC;IACxG,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC"}
1
+ {"version":3,"file":"program.js","sourceRoot":"","sources":["../../../src/rules/effect/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,aAAa,GAAG,IAAI;IACrE,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAuB;QACnC,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ;QACxB,YAAY,EAAE,IAAI;QAClB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;QAC9B,KAAK,EAAE,EAAE;KACT,CAAC;IACF,MAAM,IAAI,GAAG,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrG,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,kBAAkB,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACzC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClB,IAAI,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;YACxG,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC;IACxG,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC"}
@@ -0,0 +1,3 @@
1
+ import ts from "typescript";
2
+ export declare function promiseParameter(checker: ts.TypeChecker, node: ts.Node): string | undefined;
3
+ //# sourceMappingURL=promiseParameter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"promiseParameter.d.ts","sourceRoot":"","sources":["../../../src/rules/effect/promiseParameter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM,GAAG,SAAS,CAuB3F"}
@@ -0,0 +1,24 @@
1
+ import ts from "typescript";
2
+ export function promiseParameter(checker, node) {
3
+ if (!ts.isParameter(node)) {
4
+ return undefined;
5
+ }
6
+ const seen = new Set();
7
+ function carries(type) {
8
+ if (seen.has(type)) {
9
+ return false;
10
+ }
11
+ seen.add(type);
12
+ if (["Promise", "PromiseLike"].includes(type.getSymbol()?.name ?? "")) {
13
+ return true;
14
+ }
15
+ if (type.isUnionOrIntersection()) {
16
+ return type.types.some(carries);
17
+ }
18
+ const constraint = checker.getBaseConstraintOfType(type);
19
+ return ((constraint !== undefined && carries(constraint))
20
+ || type.getCallSignatures().some((signature) => carries(checker.getReturnTypeOfSignature(signature))));
21
+ }
22
+ return carries(checker.getTypeAtLocation(node)) ? `Promise-typed parameter (${node.name.getText()})` : undefined;
23
+ }
24
+ //# sourceMappingURL=promiseParameter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"promiseParameter.js","sourceRoot":"","sources":["../../../src/rules/effect/promiseParameter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,UAAU,gBAAgB,CAAC,OAAuB,EAAE,IAAa;IACtE,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,SAAS,OAAO,CAAC,IAAa;QAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;YACvE,OAAO,IAAI,CAAC;QACb,CAAC;QACD,IAAI,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO,CACN,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;eAC9C,IAAI,CAAC,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAAC,CACrG,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,4BAA4B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAClH,CAAC"}
@@ -1,2 +1,2 @@
1
- export declare const importsRuntime: import("#rule.ts").Rule<"imports/runtime", undefined, never>;
1
+ export declare const importsRuntime: import("#rule.ts").Rule<"imports/runtime", undefined, import("effect/FileSystem").FileSystem>;
2
2
  //# sourceMappingURL=runtime.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/rules/imports/runtime.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,cAAc,8DAsBzB,CAAC"}
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/rules/imports/runtime.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,cAAc,+FAsBzB,CAAC"}
@@ -4,7 +4,7 @@ import { defineRule } from "#rule.ts";
4
4
  import { importBindings } from "./importBindings.js";
5
5
  import { storySources } from "./sources.js";
6
6
  import { memberName, syntaxFindings, unwrapped } from "./syntax.js";
7
- const MESSAGE = 'Checks several outcomes with consecutive expect(yield* …) lines. Let the story\'s words lead: yield* outcomes({ "label": [readout, expected], … }) from @shivaedev/test-story/server/outcomes.ts, one row per outcome. Keep a plain expect for a single outcome.';
7
+ const MESSAGE = 'Checks several outcomes with consecutive expect(yield* …) lines. Let the story\'s words lead: yield* outcomes([["label", () => readout(), expected], …]) from @shivaedev/test-story/server/outcomes.ts, one row per outcome. Keep a plain expect for a single outcome.';
8
8
  const EXPECT_MODULES = ["vitest", "@effect/vitest"];
9
9
  function yields(node) {
10
10
  return ((ts.isYieldExpression(node) && node.asteriskToken !== undefined)
@@ -1 +1 @@
1
- {"version":3,"file":"groupedOutcomes.js","sourceRoot":"","sources":["../../../src/rules/stories/groupedOutcomes.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"groupedOutcomes.js","sourceRoot":"","sources":["../../../src/rules/stories/groupedOutcomes.ts"],"names":[],"mappings":"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"}
@@ -4,6 +4,8 @@ The [README](../README.md) introduces the gate. This page explains how the basel
4
4
 
5
5
  ## Baseline
6
6
 
7
+ For a shared policy upgrade, `quality baseline write --first-adoption --rule <id>` records existing findings of explicitly named rules that refuse config exceptions, including unchanged files. This mode covers first adoption of a rule or new detection shapes; it does not change ordinary file-scoped writes. Review each new or raised entry and state why that debt needs a separate migration. Rules that permit exceptions and unnamed rules refuse this mode.
8
+
7
9
  ```jsonl
8
10
  {"path":"src/legacy/sync.ts","rule":"comments/no-jsdoc","count":3}
9
11
  {"path":"src/server/db.ts","rule":"structure/max-lines","count":262}
@@ -12,7 +14,7 @@ The [README](../README.md) introduces the gate. This page explains how the basel
12
14
  The baseline is sharded: `packages/<package>/quality-baseline.jsonl` holds paths inside that package, and the root `quality-baseline.jsonl` holds all other paths. Packages without entries have no file. Each shard is JSON Lines with one entry per line: the violations of one rule in one file. `count` is how many violations the file may have. For a rule that counts occurrences, such as `comments/no-jsdoc`, that is the number of occurrences. For a rule with a limit, it is the amount over the limit: the entry above lets `src/server/db.ts` have 412 lines under a limit of 150. A new baseline is sorted by path and then rule. Later edits preserve unrelated lines, including their formatting and order, so the diff shows the entries that changed.
13
15
 
14
16
  `quality lint` fails when a baselined file has more violations than its `count`; the report then lists all of that file's violations for the rule. A file at or below its entry passes. An entry that allows more than is left, including a file with no violations left, is listed as a note and does not fail, so fixing debt never breaks the build; `tighten` and `prune` lower it. An entry for an unknown rule fails until it is pruned.
15
- - `quality baseline write` records every error-level violation when there is no baseline yet. Once a baseline exists, both `--rule <id>` and `--file <path>` are required. Repeat either option for multiple selections. Each path is relative to the config folder and must be changed since `HEAD`, staged or unstaged; new files need `git add` first. An unchanged file refuses the whole write. Only selected rule/file entries are replaced; all other entries stay as they are. With no baseline and no file selection, initial adoption records the repository once.
17
+ - `quality baseline write` records every error-level violation when there is no baseline yet. For ordinary writes after a baseline exists, both `--rule <id>` and `--file <path>` are required. Repeat either option for multiple selections. Each path is relative to the config folder and must be changed since `HEAD`, staged or unstaged; new files need `git add` first. An unchanged file refuses the whole write. Only selected rule/file entries are replaced; all other entries stay as they are. With no baseline and no file selection, initial adoption records the repository once.
16
18
  - `quality baseline tighten` lowers and removes the entries of files changed since `HEAD`, and with `--staged`, of the files staged for the next commit. It carries the entry of a file that git sees as moved to the new path. Every other line stays byte for byte.
17
19
  - `quality baseline prune` does the same for every entry. It carries the entries of files moved since the merge base (see `--against` under [Command line](../README.md#command-line)), and prunes without following moves outside a git work tree.
18
20
  - `quality baseline migrate` moves a baseline from the earlier JSON format, `quality/baseline.json` or the file `--from` names, to the root and package shards, and removes the old one. `--from quality/baseline.jsonl` splits a single JSON Lines baseline without changing its counts. An old entry that stored a size, such as a line count, becomes that size less the rule's current limit; an entry whose file is now within the limit is dropped.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shivaedev/quality",
3
- "version": "0.49.0",
3
+ "version": "0.50.0",
4
4
  "description": "Repository quality gate with typed rules, a baseline of existing debt and a registry of reasoned exceptions",
5
5
  "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/quality#readme",
6
6
  "bugs": {
@@ -62,7 +62,7 @@
62
62
  "@effect/platform-node": "4.0.6",
63
63
  "@effect/platform-node-shared": "4.0.6",
64
64
  "@effect/vitest": "4.0.6",
65
- "@shivaedev/test-story": "0.29.0",
65
+ "@shivaedev/test-story": "0.30.0",
66
66
  "@types/node": "24.19.2",
67
67
  "@typescript/native": "npm:typescript@7.0.2",
68
68
  "effect": "4.0.6",