@shivaedev/quality 0.39.2 → 0.41.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.
- package/CHANGELOG.md +17 -0
- package/README.md +2 -2
- package/dist/appViteConfig.js +1 -1
- package/dist/appViteConfig.js.map +1 -1
- package/dist/rules/stories/namedValues.d.ts.map +1 -1
- package/dist/rules/stories/namedValues.js +47 -4
- package/dist/rules/stories/namedValues.js.map +1 -1
- package/package.json +1 -1
- package/src/appViteConfig.ts +1 -1
- package/src/rules/stories/namedValues.ts +61 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,22 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.41.0 - 2026-10-26
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
|
|
7
|
+
- Generated apps include app-owned admin navigation, Jobs health, counts, failed and dead-lettered lists, job detail, and an example note-statistics page on the existing protected RPC transport. Jobs views accept retry actions from explicitly retry-enabled registrations and retain the default read-only registration.
|
|
8
|
+
|
|
9
|
+
### Breaking
|
|
10
|
+
|
|
11
|
+
- `@shivaedev/create-app`'s starter no longer serves the pg-boss dashboard at `/admin/jobs`; the app-owned admin Jobs views replace it. Existing apps must remove `readOnlyDashboard.ts`, `readOnlyDashboardWorker.ts`, `checkDashboardVersion.ts` and `jobDashboard.ts`, remove the `@pg-boss/dashboard` dependency and catalog pin, and register the admin pages and their handlers on the existing `/rpc` host. Keep admin account provisioning through `admin:create`, `admin.ts` and `createAdmin.ts`.
|
|
12
|
+
- `@shivaedev/quality`'s `appViteConfig` leaves `/admin/jobs` on the client router. Apps that still host a server dashboard at that path must add their own Vite `server.proxy` entry for `/admin/jobs` targeting the app host.
|
|
13
|
+
|
|
14
|
+
## 0.40.0 - 2026-10-25
|
|
15
|
+
|
|
16
|
+
### Changed
|
|
17
|
+
|
|
18
|
+
- `tests/named-values` now reports a spec-local numeric const that only feeds `toBe` or `toHaveLength`. Consumers should assert the observed items or derive the value from the story's inputs.
|
|
19
|
+
|
|
3
20
|
## 0.39.2 - 2026-10-25
|
|
4
21
|
|
|
5
22
|
### Changed
|
package/README.md
CHANGED
|
@@ -154,7 +154,7 @@ Every package tests its real engine through its own story kit, so setup and acti
|
|
|
154
154
|
|
|
155
155
|
Quality's `tests/story-setup` rule reports top-level test functions named with the words `seed`, `make`, `build` or `setup`, and fixture-writing calls imported from Node's `fs` or `fs/promises`. It leaves source and `test-support/` files alone. This is a check for those syntax patterns; a passing test file still needs review of what it tests.
|
|
156
156
|
|
|
157
|
-
Specs keep expectations visible. `tests/spec-helpers` moves all module-level helper functions out of specs and into the kit; `tests/no-expect-in-support` moves `expect` calls into the spec, except in test-support files that register tests at module top level and are not imported by any module, so nested Vitest runs can execute them as test files with real assertions. `tests/named-values` rejects numeric literals passed to `toBe` or `toHaveLength` in specs, except zero and a status or exit code asserted on a `status`, `code` or `exitCode` subject: assert the observed items or
|
|
157
|
+
Specs keep expectations visible. `tests/spec-helpers` moves all module-level helper functions out of specs and into the kit; `tests/no-expect-in-support` moves `expect` calls into the spec, except in test-support files that register tests at module top level and are not imported by any module, so nested Vitest runs can execute them as test files with real assertions. `tests/named-values` rejects numeric literals passed to `toBe` or `toHaveLength` in specs, except zero and a status or exit code asserted on a `status`, `code` or `exitCode` subject: assert the observed items or use a domain name that comes from the story's inputs or the product. A spec-local numeric const that only feeds these matchers is reported, including aliases for zero and codes. `tests/no-limit-imports` rejects importing `MAX_*` constants from a `limits` module into specs, so a story proves behavior instead of copying an implementation cap.
|
|
158
158
|
|
|
159
159
|
`boundaries/queue-sql` rejects SQL mentioning the private `pgboss.` schema. Apps use their queue definitions and let workers process jobs; there is no queue-purge API by design. `boundaries/auth-sql` rejects SQL accessing Better Auth's `user`, `account`, `session` and `verification` tables. Apps use platform's auth API; `options.owners` names platform's own auth implementation and its migrations. These rules inspect SQL templates, literal query calls and query variables, and inventoried `.sql` files. They do not evaluate arbitrary runtime SQL construction.
|
|
160
160
|
|
|
@@ -327,7 +327,7 @@ import { appViteConfig } from "@shivaedev/quality/appViteConfig.ts";
|
|
|
327
327
|
export default appViteConfig([tailwindcss(), react()]);
|
|
328
328
|
```
|
|
329
329
|
|
|
330
|
-
Use this in `vite.config.ts`. Plugins belong to the app. The shared server proxies `/api/auth
|
|
330
|
+
Use this in `vite.config.ts`. Plugins belong to the app. The shared server proxies `/api/auth` and `/rpc` to the local host on port 3000, preserving the request Host. It enables TypeScript path resolution. Client routes, including administration pages, stay on Vite.
|
|
331
331
|
|
|
332
332
|
```ts
|
|
333
333
|
import { appTestConfig } from "@shivaedev/quality/appTestConfig.ts";
|
package/dist/appViteConfig.js
CHANGED
|
@@ -5,7 +5,7 @@ export function appViteConfig(plugins, conditions = []) {
|
|
|
5
5
|
server: {
|
|
6
6
|
host: "127.0.0.1",
|
|
7
7
|
port: 5173,
|
|
8
|
-
proxy: Object.fromEntries(["/
|
|
8
|
+
proxy: Object.fromEntries(["/api/auth", "/rpc"].map((path) => [path, { changeOrigin: false, target: "http://127.0.0.1:3000" }])),
|
|
9
9
|
strictPort: true,
|
|
10
10
|
},
|
|
11
11
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"appViteConfig.js","sourceRoot":"","sources":["../src/appViteConfig.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAU,OAAkB,EAAE,UAAU,GAAa,EAAE;IACnF,OAAO;QACN,OAAO;QACP,OAAO,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE;QAC5C,MAAM,EAAE;YACP,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,
|
|
1
|
+
{"version":3,"file":"appViteConfig.js","sourceRoot":"","sources":["../src/appViteConfig.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAU,OAAkB,EAAE,UAAU,GAAa,EAAE;IACnF,OAAO;QACN,OAAO;QACP,OAAO,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE;QAC5C,MAAM,EAAE;YACP,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC;YAChI,UAAU,EAAE,IAAI;SAChB;KACD,CAAC;AACH,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"namedValues.d.ts","sourceRoot":"","sources":["../../../src/rules/stories/namedValues.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"namedValues.d.ts","sourceRoot":"","sources":["../../../src/rules/stories/namedValues.ts"],"names":[],"mappings":"AAwFA,eAAO,MAAM,WAAW,0DAgBtB,CAAC"}
|
|
@@ -1,7 +1,46 @@
|
|
|
1
1
|
import ts from "typescript";
|
|
2
2
|
import { defineRule } from "#rule.ts";
|
|
3
3
|
import { isSpec, memberName, nodesWhere, numericValue, syntaxFindings, unwrapped } from "./syntax.js";
|
|
4
|
-
const MESSAGE = "Passes a numeric literal to toBe or toHaveLength. Assert the observed items,
|
|
4
|
+
const MESSAGE = "Passes a numeric literal or a matcher-only spec-local numeric const to toBe or toHaveLength. Assert the observed items, write the literal where accepted (zero, or a status or exit code), or derive the value from the story's inputs.";
|
|
5
|
+
function matcherCall(node) {
|
|
6
|
+
return ts.isCallExpression(node) && ["toBe", "toHaveLength"].includes(memberName(node.expression) ?? "");
|
|
7
|
+
}
|
|
8
|
+
function matcherAliases(source) {
|
|
9
|
+
const declarations = nodesWhere(source, (node) => ts.isVariableDeclaration(node)
|
|
10
|
+
&& ts.isIdentifier(node.name)
|
|
11
|
+
&& ts.isVariableDeclarationList(node.parent)
|
|
12
|
+
&& (node.parent.flags & ts.NodeFlags.Const) !== 0
|
|
13
|
+
&& node.initializer !== undefined
|
|
14
|
+
&& numericValue(node.initializer) !== undefined).filter(ts.isVariableDeclaration);
|
|
15
|
+
if (declarations.length === 0) {
|
|
16
|
+
return new Set();
|
|
17
|
+
}
|
|
18
|
+
const options = { allowJs: true, noLib: true, noResolve: true, types: [] };
|
|
19
|
+
const host = ts.createCompilerHost(options);
|
|
20
|
+
host.getSourceFile = (path) => (path === source.fileName ? source : undefined);
|
|
21
|
+
const checker = ts.createProgram([source.fileName], options, host).getTypeChecker();
|
|
22
|
+
const aliases = new Map();
|
|
23
|
+
for (const declaration of declarations) {
|
|
24
|
+
const symbol = checker.getSymbolAtLocation(declaration.name);
|
|
25
|
+
if (symbol !== undefined) {
|
|
26
|
+
aliases.set(symbol, []);
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
for (const node of nodesWhere(source, ts.isIdentifier)) {
|
|
30
|
+
if (!ts.isIdentifier(node) || (ts.isVariableDeclaration(node.parent) && node.parent.name === node)) {
|
|
31
|
+
continue;
|
|
32
|
+
}
|
|
33
|
+
const symbol = ts.isShorthandPropertyAssignment(node.parent)
|
|
34
|
+
? checker.getShorthandAssignmentValueSymbol(node.parent)
|
|
35
|
+
: checker.getSymbolAtLocation(node);
|
|
36
|
+
if (symbol !== undefined) {
|
|
37
|
+
aliases.get(symbol)?.push(node);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
return new Set([...aliases.values()]
|
|
41
|
+
.filter((references) => references.every((reference) => matcherCall(reference.parent) && reference.parent.arguments.includes(reference)))
|
|
42
|
+
.flatMap((references) => references.map((reference) => reference.parent)));
|
|
43
|
+
}
|
|
5
44
|
function codeSubject(expression) {
|
|
6
45
|
const value = unwrapped(expression);
|
|
7
46
|
if (!(ts.isPropertyAccessExpression(value) || ts.isElementAccessExpression(value))) {
|
|
@@ -25,8 +64,7 @@ function codeSubject(expression) {
|
|
|
25
64
|
return ["status", "code", "exitCode"].includes(ts.isIdentifier(subject) ? subject.text : (memberName(subject) ?? ""));
|
|
26
65
|
}
|
|
27
66
|
function numericAssertion(node) {
|
|
28
|
-
return (
|
|
29
|
-
&& ["toBe", "toHaveLength"].includes(memberName(node.expression) ?? "")
|
|
67
|
+
return (matcherCall(node)
|
|
30
68
|
&& !codeSubject(node.expression)
|
|
31
69
|
&& node.arguments.some((argument) => {
|
|
32
70
|
const value = numericValue(argument);
|
|
@@ -34,7 +72,12 @@ function numericAssertion(node) {
|
|
|
34
72
|
}));
|
|
35
73
|
}
|
|
36
74
|
export const namedValues = defineRule({
|
|
37
|
-
check: ({ sources }) => sources
|
|
75
|
+
check: ({ sources }) => sources
|
|
76
|
+
.filter((file) => isSpec(file.path))
|
|
77
|
+
.flatMap((file) => syntaxFindings(file, (source) => {
|
|
78
|
+
const aliases = matcherAliases(source);
|
|
79
|
+
return nodesWhere(source, (node) => numericAssertion(node) || aliases.has(node));
|
|
80
|
+
}, MESSAGE)),
|
|
38
81
|
description: "Stories assert observed items or named values instead of bare counts and numbers.",
|
|
39
82
|
id: "tests/named-values",
|
|
40
83
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"namedValues.js","sourceRoot":"","sources":["../../../src/rules/stories/namedValues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,OAAO,GACZ,
|
|
1
|
+
{"version":3,"file":"namedValues.js","sourceRoot":"","sources":["../../../src/rules/stories/namedValues.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shivaedev/quality",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.41.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": {
|
package/src/appViteConfig.ts
CHANGED
|
@@ -5,7 +5,7 @@ export function appViteConfig<TPlugin>(plugins: TPlugin[], conditions: string[]
|
|
|
5
5
|
server: {
|
|
6
6
|
host: "127.0.0.1",
|
|
7
7
|
port: 5173,
|
|
8
|
-
proxy: Object.fromEntries(["/
|
|
8
|
+
proxy: Object.fromEntries(["/api/auth", "/rpc"].map((path) => [path, { changeOrigin: false, target: "http://127.0.0.1:3000" }])),
|
|
9
9
|
strictPort: true,
|
|
10
10
|
},
|
|
11
11
|
};
|
|
@@ -3,7 +3,54 @@ import { defineRule } from "#rule.ts";
|
|
|
3
3
|
import { isSpec, memberName, nodesWhere, numericValue, syntaxFindings, unwrapped } from "./syntax.ts";
|
|
4
4
|
|
|
5
5
|
const MESSAGE =
|
|
6
|
-
"Passes a numeric literal to toBe or toHaveLength. Assert the observed items,
|
|
6
|
+
"Passes a numeric literal or a matcher-only spec-local numeric const to toBe or toHaveLength. Assert the observed items, write the literal where accepted (zero, or a status or exit code), or derive the value from the story's inputs.";
|
|
7
|
+
|
|
8
|
+
function matcherCall(node: ts.Node): node is ts.CallExpression {
|
|
9
|
+
return ts.isCallExpression(node) && ["toBe", "toHaveLength"].includes(memberName(node.expression) ?? "");
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
function matcherAliases(source: ts.SourceFile): ReadonlySet<ts.Node> {
|
|
13
|
+
const declarations = nodesWhere(
|
|
14
|
+
source,
|
|
15
|
+
(node) =>
|
|
16
|
+
ts.isVariableDeclaration(node)
|
|
17
|
+
&& ts.isIdentifier(node.name)
|
|
18
|
+
&& ts.isVariableDeclarationList(node.parent)
|
|
19
|
+
&& (node.parent.flags & ts.NodeFlags.Const) !== 0
|
|
20
|
+
&& node.initializer !== undefined
|
|
21
|
+
&& numericValue(node.initializer) !== undefined,
|
|
22
|
+
).filter(ts.isVariableDeclaration);
|
|
23
|
+
if (declarations.length === 0) {
|
|
24
|
+
return new Set();
|
|
25
|
+
}
|
|
26
|
+
const options: ts.CompilerOptions = { allowJs: true, noLib: true, noResolve: true, types: [] };
|
|
27
|
+
const host = ts.createCompilerHost(options);
|
|
28
|
+
host.getSourceFile = (path) => (path === source.fileName ? source : undefined);
|
|
29
|
+
const checker = ts.createProgram([source.fileName], options, host).getTypeChecker();
|
|
30
|
+
const aliases = new Map<ts.Symbol, ts.Identifier[]>();
|
|
31
|
+
for (const declaration of declarations) {
|
|
32
|
+
const symbol = checker.getSymbolAtLocation(declaration.name);
|
|
33
|
+
if (symbol !== undefined) {
|
|
34
|
+
aliases.set(symbol, []);
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
for (const node of nodesWhere(source, ts.isIdentifier)) {
|
|
38
|
+
if (!ts.isIdentifier(node) || (ts.isVariableDeclaration(node.parent) && node.parent.name === node)) {
|
|
39
|
+
continue;
|
|
40
|
+
}
|
|
41
|
+
const symbol = ts.isShorthandPropertyAssignment(node.parent)
|
|
42
|
+
? checker.getShorthandAssignmentValueSymbol(node.parent)
|
|
43
|
+
: checker.getSymbolAtLocation(node);
|
|
44
|
+
if (symbol !== undefined) {
|
|
45
|
+
aliases.get(symbol)?.push(node);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
return new Set(
|
|
49
|
+
[...aliases.values()]
|
|
50
|
+
.filter((references) => references.every((reference) => matcherCall(reference.parent) && reference.parent.arguments.includes(reference)))
|
|
51
|
+
.flatMap((references) => references.map((reference) => reference.parent)),
|
|
52
|
+
);
|
|
53
|
+
}
|
|
7
54
|
|
|
8
55
|
function codeSubject(expression: ts.Expression): boolean {
|
|
9
56
|
const value = unwrapped(expression);
|
|
@@ -30,8 +77,7 @@ function codeSubject(expression: ts.Expression): boolean {
|
|
|
30
77
|
|
|
31
78
|
function numericAssertion(node: ts.Node): boolean {
|
|
32
79
|
return (
|
|
33
|
-
|
|
34
|
-
&& ["toBe", "toHaveLength"].includes(memberName(node.expression) ?? "")
|
|
80
|
+
matcherCall(node)
|
|
35
81
|
&& !codeSubject(node.expression)
|
|
36
82
|
&& node.arguments.some((argument) => {
|
|
37
83
|
const value = numericValue(argument);
|
|
@@ -42,7 +88,18 @@ function numericAssertion(node: ts.Node): boolean {
|
|
|
42
88
|
|
|
43
89
|
export const namedValues = defineRule({
|
|
44
90
|
check: ({ sources }) =>
|
|
45
|
-
sources
|
|
91
|
+
sources
|
|
92
|
+
.filter((file) => isSpec(file.path))
|
|
93
|
+
.flatMap((file) =>
|
|
94
|
+
syntaxFindings(
|
|
95
|
+
file,
|
|
96
|
+
(source) => {
|
|
97
|
+
const aliases = matcherAliases(source);
|
|
98
|
+
return nodesWhere(source, (node) => numericAssertion(node) || aliases.has(node));
|
|
99
|
+
},
|
|
100
|
+
MESSAGE,
|
|
101
|
+
),
|
|
102
|
+
),
|
|
46
103
|
description: "Stories assert observed items or named values instead of bare counts and numbers.",
|
|
47
104
|
id: "tests/named-values",
|
|
48
105
|
});
|