@shivaedev/quality 0.27.0 → 0.28.0

package/dist/rules/stories/noExpect.js

@@ -0,0 +1,33 @@
+import ts from "typescript";
+import { isTestSupport } from "#naming/testName.ts";
+import { defineRule } from "#rule.ts";
+import { memberName, nodesWhere, syntaxFindings, unwrapped } from "./syntax.js";
+const MESSAGE = "Calls expect in test-support. Return the engine's observed state from the verb and put the expectation in the spec; throw if an action cannot run.";
+function assertionReference(expression, names) {
+    const node = unwrapped(expression);
+    if (ts.isIdentifier(node)) {
+        return names.has(node.text);
+    }
+    return (memberName(node) === "expect"
+        || ((ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node)) && assertionReference(node.expression, names)));
+}
+function assertionsIn(source) {
+    const names = new Set(["expect"]);
+    for (const statement of source.statements) {
+        const bindings = ts.isImportDeclaration(statement) ? statement.importClause?.namedBindings : undefined;
+        if (bindings !== undefined && ts.isNamedImports(bindings)) {
+            for (const element of bindings.elements) {
+                if ((element.propertyName ?? element.name).text === "expect") {
+                    names.add(element.name.text);
+                }
+            }
+        }
+    }
+    return nodesWhere(source, (node) => ts.isCallExpression(node) && assertionReference(node.expression, names));
+}
+export const noExpect = defineRule({
+    check: ({ sources }) => sources.filter((file) => isTestSupport(file.path)).flatMap((file) => syntaxFindings(file, assertionsIn, MESSAGE)),
+    description: "Test-support performs actions and exposes observations; specs own expectations.",
+    id: "tests/no-expect-in-support",
+});
+//# sourceMappingURL=noExpect.js.map

package/dist/rules/stories/noExpect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noExpect.js","sourceRoot":"","sources":["../../../src/rules/stories/noExpect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,OAAO,GACZ,oJAAoJ,CAAC;AAEtJ,SAAS,kBAAkB,CAAC,UAAyB,EAAE,KAA0B;IAChF,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CACN,UAAU,CAAC,IAAI,CAAC,KAAK,QAAQ;WAC1B,CAAC,CAAC,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAC9H,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAqB;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QACvG,IAAI,QAAQ,KAAK,SAAS,IAAI,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACzC,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC9D,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9B,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACzI,WAAW,EAAE,iFAAiF;IAC9F,EAAE,EAAE,4BAA4B;CAChC,CAAC,CAAC"}

package/dist/rules/stories/noLimitImports.d.ts

@@ -0,0 +1,2 @@
+export declare const noLimitImports: import("#rule.ts").Rule<"tests/no-limit-imports", undefined>;
+//# sourceMappingURL=noLimitImports.d.ts.map

package/dist/rules/stories/noLimitImports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noLimitImports.d.ts","sourceRoot":"","sources":["../../../src/rules/stories/noLimitImports.ts"],"names":[],"mappings":"AA2EA,eAAO,MAAM,cAAc,8DAIzB,CAAC"}

package/dist/rules/stories/noLimitImports.js

@@ -0,0 +1,66 @@
+import ts from "typescript";
+import { defineRule } from "#rule.ts";
+import { isSpec, memberName, nodesWhere, syntaxFindings, unwrapped } from "./syntax.js";
+const MESSAGE = "Imports a MAX_* constant from a limits module. Tell a story about the observed behavior instead of asserting a copy of the implementation's cap.";
+const LIMITS_MODULE = /(?:^|[/#])limits(?:\.[cm]?[jt]s)?(?:\/|$)/u;
+const MAX_CONSTANT = /^MAX_/u;
+function literalLimitsImport(expression) {
+    const node = unwrapped(expression);
+    if (ts.isAwaitExpression(node)) {
+        return literalLimitsImport(node.expression);
+    }
+    return (ts.isCallExpression(node)
+        && node.expression.kind === ts.SyntaxKind.ImportKeyword
+        && node.arguments[0] !== undefined
+        && ts.isStringLiteralLike(node.arguments[0])
+        && LIMITS_MODULE.test(node.arguments[0].text));
+}
+function capBinding(binding) {
+    if (binding.dotDotDotToken !== undefined) {
+        return false;
+    }
+    const name = binding.propertyName ?? binding.name;
+    if (ts.isComputedPropertyName(name)) {
+        return ts.isStringLiteralLike(name.expression) && MAX_CONSTANT.test(name.expression.text);
+    }
+    return (ts.isIdentifier(name) || ts.isStringLiteralLike(name)) && MAX_CONSTANT.test(name.text);
+}
+function capImports(source) {
+    const namespaces = new Set();
+    const imports = source.statements.flatMap((statement) => {
+        if (!(ts.isImportDeclaration(statement) && ts.isStringLiteralLike(statement.moduleSpecifier) && LIMITS_MODULE.test(statement.moduleSpecifier.text))) {
+            return [];
+        }
+        const bindings = statement.importClause?.namedBindings;
+        if (bindings !== undefined && ts.isNamespaceImport(bindings)) {
+            namespaces.add(bindings.name.text);
+        }
+        return bindings !== undefined && ts.isNamedImports(bindings)
+            ? bindings.elements.filter((element) => MAX_CONSTANT.test((element.propertyName ?? element.name).text))
+            : [];
+    });
+    const dynamic = nodesWhere(source, ts.isVariableDeclaration).flatMap((node) => {
+        if (!ts.isVariableDeclaration(node) || node.initializer === undefined || !literalLimitsImport(node.initializer)) {
+            return [];
+        }
+        if (ts.isIdentifier(node.name)) {
+            namespaces.add(node.name.text);
+            return [];
+        }
+        return ts.isObjectBindingPattern(node.name) ? node.name.elements.filter(capBinding) : [];
+    });
+    return [
+        ...imports,
+        ...dynamic,
+        ...nodesWhere(source, (node) => (ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node))
+            && ts.isIdentifier(node.expression)
+            && namespaces.has(node.expression.text)
+            && MAX_CONSTANT.test(memberName(node) ?? "")),
+    ];
+}
+export const noLimitImports = defineRule({
+    check: ({ sources }) => sources.filter((file) => isSpec(file.path)).flatMap((file) => syntaxFindings(file, capImports, MESSAGE)),
+    description: "Stories prove behavior instead of importing implementation caps from limits modules.",
+    id: "tests/no-limit-imports",
+});
+//# sourceMappingURL=noLimitImports.js.map

package/dist/rules/stories/noLimitImports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noLimitImports.js","sourceRoot":"","sources":["../../../src/rules/stories/noLimitImports.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,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExF,MAAM,OAAO,GACZ,kJAAkJ,CAAC;AAEpJ,MAAM,aAAa,GAAG,4CAA4C,CAAC;AACnE,MAAM,YAAY,GAAG,QAAQ,CAAC;AAE9B,SAAS,mBAAmB,CAAC,UAAyB;IACrD,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,CACN,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;WACtB,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa;WACpD,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS;WAC/B,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;WACzC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7C,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,OAA0B;IAC7C,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB;IACxC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACvD,IACC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,EAC9I,CAAC;YACF,OAAO,EAAE,CAAC;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC;QACvD,IAAI,QAAQ,KAAK,SAAS,IAAI,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9D,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,QAAQ,KAAK,SAAS,IAAI,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC;YAC3D,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YACvG,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAU,CAAC,IAAI,EAAE,EAAE;QACtF,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACjH,OAAO,EAAE,CAAC;QACX,CAAC;QACD,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,CAAC;QACX,CAAC;QACD,OAAO,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,CAAC,CAAC,CAAC;IACH,OAAO;QACN,GAAG,OAAO;QACV,GAAG,OAAO;QACV,GAAG,UAAU,CACZ,MAAM,EACN,CAAC,IAAI,EAAE,EAAE,CACR,CAAC,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;eACxE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;eAChC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;eACpC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAC7C;KACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACxC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAChI,WAAW,EAAE,sFAAsF;IACnG,EAAE,EAAE,wBAAwB;CAC5B,CAAC,CAAC"}

package/dist/rules/stories/queueSql.d.ts

@@ -0,0 +1,2 @@
+export declare const queueSql: import("#rule.ts").Rule<"boundaries/queue-sql", undefined>;
+//# sourceMappingURL=queueSql.d.ts.map

package/dist/rules/stories/queueSql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueSql.d.ts","sourceRoot":"","sources":["../../../src/rules/stories/queueSql.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,QAAQ,4DAYnB,CAAC"}

package/dist/rules/stories/queueSql.js

@@ -0,0 +1,15 @@
+import { defineRule } from "#rule.ts";
+import { sqlTexts } from "./sqlText.js";
+const QUEUE_SCHEMA = /\bpgboss\b"?\s*\./iu;
+export const queueSql = defineRule({
+    check: async (inputs) => (await sqlTexts(inputs))
+        .filter((query) => QUEUE_SCHEMA.test(query.text))
+        .map((query) => ({
+        file: query.file,
+        line: query.line,
+        message: "SQL mentions pgboss. Use the app's public queue definitions and let workers process jobs; apps never edit or purge queue tables, and there is no queue-purge API by design.",
+    })),
+    description: "Apps never read, edit or purge pg-boss's private queue schema.",
+    id: "boundaries/queue-sql",
+});
+//# sourceMappingURL=queueSql.js.map

package/dist/rules/stories/queueSql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueSql.js","sourceRoot":"","sources":["../../../src/rules/stories/queueSql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAE3C,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IAClC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CACvB,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;SACtB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAChD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EACN,6KAA6K;KAC9K,CAAC,CAAC;IACL,WAAW,EAAE,gEAAgE;IAC7E,EAAE,EAAE,sBAAsB;CAC1B,CAAC,CAAC"}

package/dist/rules/stories/specHelpers.d.ts

@@ -0,0 +1,2 @@
+export declare const specHelpers: import("#rule.ts").Rule<"tests/spec-helpers", undefined>;
+//# sourceMappingURL=specHelpers.d.ts.map

package/dist/rules/stories/specHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specHelpers.d.ts","sourceRoot":"","sources":["../../../src/rules/stories/specHelpers.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,0DAItB,CAAC"}

package/dist/rules/stories/specHelpers.js

@@ -0,0 +1,9 @@
+import { defineRule } from "#rule.ts";
+import { isSpec, syntaxFindings, topLevelHelpers } from "./syntax.js";
+const MESSAGE = "Declares a top-level helper in a spec. Move the action into the story kit's verbs or the setup into its traits in test-support/.";
+export const specHelpers = defineRule({
+    check: ({ sources }) => sources.filter((file) => isSpec(file.path)).flatMap((file) => syntaxFindings(file, topLevelHelpers, MESSAGE)),
+    description: "Specs state expectations; story-kit traits and verbs in test-support own helpers.",
+    id: "tests/spec-helpers",
+});
+//# sourceMappingURL=specHelpers.js.map

package/dist/rules/stories/specHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specHelpers.js","sourceRoot":"","sources":["../../../src/rules/stories/specHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,OAAO,GAAG,kIAAkI,CAAC;AAEnJ,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;IACrC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IACrI,WAAW,EAAE,mFAAmF;IAChG,EAAE,EAAE,oBAAoB;CACxB,CAAC,CAAC"}

package/dist/rules/stories/sqlText.d.ts

@@ -0,0 +1,8 @@
+import type { RuleInputs } from "#rule.ts";
+export interface SqlText {
+    readonly file: string;
+    readonly line: number;
+    readonly text: string;
+}
+export declare function sqlTexts(inputs: RuleInputs): Promise<readonly SqlText[]>;
+//# sourceMappingURL=sqlText.d.ts.map

package/dist/rules/stories/sqlText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlText.d.ts","sourceRoot":"","sources":["../../../src/rules/stories/sqlText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAyED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAiB9E"}

package/dist/rules/stories/sqlText.js

@@ -0,0 +1,86 @@
+import ts from "typescript";
+import { parse } from "#rules/syntax.ts";
+import { unwrapped } from "./syntax.js";
+const SQL_START = /^\s*(?:(?:--[^\n]*\n|\/\*[\s\S]*?\*\/)\s*)*(?:select|with|insert|update|delete|truncate|alter|drop|create|grant|revoke|comment)\b/iu;
+const SQL_CALLEE = /^(?:sql|query|execute|exec|raw)(?:\.|$)|\.(?:sql|unsafe|query|execute|exec|raw)$/iu;
+function interpolation(node) {
+    if (ts.isStringLiteralLike(node)) {
+        return node.text;
+    }
+    return ts.isCallExpression(node) && node.arguments.every(ts.isStringLiteralLike)
+        ? node.arguments
+            .filter(ts.isStringLiteralLike)
+            .map((argument) => argument.text)
+            .join(".")
+        : " ? ";
+}
+function templateText(node) {
+    return ts.isNoSubstitutionTemplateLiteral(node)
+        ? node.text
+        : node.head.text + node.templateSpans.map((span) => interpolation(span.expression) + span.literal.text).join("");
+}
+function textOf(expression) {
+    const node = unwrapped(expression);
+    if (ts.isStringLiteralLike(node)) {
+        return node.text;
+    }
+    if (ts.isTemplateExpression(node)) {
+        return templateText(node);
+    }
+    if (ts.isObjectLiteralExpression(node)) {
+        const query = node.properties.find((property) => ts.isPropertyAssignment(property) && property.name.getText() === "text");
+        return query !== undefined && ts.isPropertyAssignment(query) ? textOf(query.initializer) : undefined;
+    }
+    if (ts.isBinaryExpression(node) && node.operatorToken.kind === ts.SyntaxKind.PlusToken) {
+        return `${textOf(node.left) ?? " ? "}${textOf(node.right) ?? " ? "}`;
+    }
+    return undefined;
+}
+function queryAt(node, source) {
+    let text;
+    let explicit = false;
+    if (ts.isTaggedTemplateExpression(node)) {
+        text = templateText(node.template);
+        explicit = SQL_CALLEE.test(node.tag.getText(source));
+    }
+    else if (ts.isCallExpression(node)) {
+        text = node.arguments[0] === undefined ? undefined : textOf(node.arguments[0]);
+        explicit = SQL_CALLEE.test(node.expression.getText(source));
+    }
+    else if (ts.isVariableDeclaration(node) && node.initializer !== undefined) {
+        text = textOf(node.initializer);
+    }
+    return text !== undefined && (explicit || SQL_START.test(text)) ? text : undefined;
+}
+function queriesIn(file, source) {
+    const queries = [];
+    function visit(node) {
+        const text = queryAt(node, source);
+        if (text !== undefined) {
+            queries.push({ file, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, text });
+            return;
+        }
+        if (!ts.isTaggedTemplateExpression(node)) {
+            ts.forEachChild(node, visit);
+        }
+    }
+    visit(source);
+    return queries;
+}
+export async function sqlTexts(inputs) {
+    const code = inputs.sources.flatMap((file) => {
+        const source = parse(file);
+        return source === undefined ? [] : queriesIn(file.path, source);
+    });
+    const sql = await Promise.all(inputs.files
+        .filter((file) => file.endsWith(".sql"))
+        .map(async (file) => {
+        const text = inputs.sources.find((source) => source.path === file)?.text ?? (await inputs.readText(file));
+        if (text === undefined) {
+            throw new Error(`Cannot read SQL file ${file}. Restore the file or repair its read permissions.`);
+        }
+        return { file, line: 1, text };
+    }));
+    return [...code, ...sql];
+}
+//# sourceMappingURL=sqlText.js.map

package/dist/rules/stories/sqlText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlText.js","sourceRoot":"","sources":["../../../src/rules/stories/sqlText.ts"],"names":[],"mappings":"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"}

package/dist/rules/stories/supportImports.d.ts

@@ -0,0 +1,4 @@
+export declare const supportImports: import("#rule.ts").Rule<"tests/support-imports", {
+    readonly modules?: readonly string[];
+}>;
+//# sourceMappingURL=supportImports.d.ts.map

package/dist/rules/stories/supportImports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportImports.d.ts","sourceRoot":"","sources":["../../../src/rules/stories/supportImports.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,cAAc;;EAoBzB,CAAC"}

package/dist/rules/stories/supportImports.js

@@ -0,0 +1,28 @@
+import { Effect, Schema } from "effect";
+import { importGraph } from "#imports/graph.ts";
+import { isTestSupport } from "#naming/testName.ts";
+import { defineRule } from "#rule.ts";
+import { matchesAny } from "./matchesAny.js";
+const SupportImportsOptions = Schema.Struct({
+    modules: Schema.Array(Schema.String).pipe(Schema.withDecodingDefaultKey(Effect.succeed([]))),
+});
+export const supportImports = defineRule({
+    check: async ({ options, ...inputs }) => {
+        if (!inputs.sources.some((file) => isTestSupport(file.path))) {
+            return [];
+        }
+        const graph = await importGraph(inputs);
+        return graph.edges
+            .filter((edge) => isTestSupport(edge.from) && edge.to.kind === "file" && !isTestSupport(edge.to.path) && !matchesAny(edge.to.path, options.modules))
+            .map((edge) => ({
+            file: edge.from,
+            line: edge.line,
+            message: `Test-support imports "${edge.specifier}" outside its allowed public surface. Drive the app through its host, schemas or queue definitions; list those public module paths in tests/support-imports.options.modules in the repository's quality config.`,
+            subject: edge.specifier,
+        }));
+    },
+    description: "Test-support reaches repository modules only through the public surface named by the repository's module allowlist.",
+    id: "tests/support-imports",
+    options: Schema.toStandardSchemaV1(SupportImportsOptions, { parseOptions: { errors: "all", onExcessProperty: "error" } }),
+});
+//# sourceMappingURL=supportImports.js.map

package/dist/rules/stories/supportImports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportImports.js","sourceRoot":"","sources":["../../../src/rules/stories/supportImports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;CAC5F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACxC,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE;QACvC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC9D,OAAO,EAAE,CAAC;QACX,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,KAAK;aAChB,MAAM,CACN,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAC3I;aACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,yBAAyB,IAAI,CAAC,SAAS,iNAAiN;YACjQ,OAAO,EAAE,IAAI,CAAC,SAAS;SACvB,CAAC,CAAC,CAAC;IACN,CAAC;IACD,WAAW,EAAE,qHAAqH;IAClI,EAAE,EAAE,uBAAuB;IAC3B,OAAO,EAAE,MAAM,CAAC,kBAAkB,CAAC,qBAAqB,EAAE,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,CAAC;CACzH,CAAC,CAAC"}

package/dist/rules/stories/syntax.d.ts

@@ -0,0 +1,11 @@
+import ts from "typescript";
+import type { Finding, SourceFile } from "#rule.ts";
+export declare function isSpec(path: string): boolean;
+export declare function unwrapped(node: ts.Expression): ts.Expression;
+export declare function memberName(node: ts.Expression): string | undefined;
+export declare function numericValue(node: ts.Expression): number | undefined;
+export declare function findingAt(source: ts.SourceFile, node: ts.Node, message: string): Finding;
+export declare function nodesWhere(source: ts.SourceFile, accepts: (node: ts.Node) => boolean): readonly ts.Node[];
+export declare function topLevelHelpers(source: ts.SourceFile): readonly ts.Node[];
+export declare function syntaxFindings(file: SourceFile, select: (source: ts.SourceFile) => readonly ts.Node[], message: string): readonly Finding[];
+//# sourceMappingURL=syntax.d.ts.map

package/dist/rules/stories/syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.d.ts","sourceRoot":"","sources":["../../../src/rules/stories/syntax.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGpD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,UAAU,CAI5D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAMlE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAUpE;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAExF;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,GAAG,SAAS,EAAE,CAAC,IAAI,EAAE,CAUzG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,GAAG,SAAS,EAAE,CAAC,IAAI,EAAE,CAYzE;AAaD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,CAG3I"}

package/dist/rules/stories/syntax.js

@@ -0,0 +1,71 @@
+import ts from "typescript";
+import { isTestSupport, testName } from "#naming/testName.ts";
+import { parse } from "#rules/syntax.ts";
+export function isSpec(path) {
+    return testName(path)?.kind === "spec" && !isTestSupport(path);
+}
+export function unwrapped(node) {
+    return ts.isParenthesizedExpression(node) || ts.isAsExpression(node) || ts.isSatisfiesExpression(node) || ts.isNonNullExpression(node)
+        ? unwrapped(node.expression)
+        : node;
+}
+export function memberName(node) {
+    const value = unwrapped(node);
+    if (ts.isPropertyAccessExpression(value)) {
+        return value.name.text;
+    }
+    return ts.isElementAccessExpression(value) && ts.isStringLiteralLike(value.argumentExpression) ? value.argumentExpression.text : undefined;
+}
+export function numericValue(node) {
+    const value = unwrapped(node);
+    if (ts.isNumericLiteral(value)) {
+        return Number(value.text);
+    }
+    if (ts.isPrefixUnaryExpression(value) && (value.operator === ts.SyntaxKind.MinusToken || value.operator === ts.SyntaxKind.PlusToken)) {
+        const operand = numericValue(value.operand);
+        return operand === undefined ? undefined : operand * (value.operator === ts.SyntaxKind.MinusToken ? -1 : 1);
+    }
+    return undefined;
+}
+export function findingAt(source, node, message) {
+    return { file: source.fileName, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, message };
+}
+export function nodesWhere(source, accepts) {
+    const found = [];
+    function visit(node) {
+        if (accepts(node)) {
+            found.push(node);
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(source);
+    return found;
+}
+export function topLevelHelpers(source) {
+    return source.statements.flatMap((statement) => {
+        if (ts.isFunctionDeclaration(statement)) {
+            return statement.body === undefined ? [] : [statement.name ?? statement];
+        }
+        return ts.isVariableStatement(statement)
+            ? statement.declarationList.declarations.flatMap((declaration) => {
+                const value = declaration.initializer === undefined ? undefined : unwrapped(declaration.initializer);
+                return value !== undefined && functionValue(value) ? [declaration.name] : [];
+            })
+            : [];
+    });
+}
+function functionValue(value) {
+    const node = unwrapped(value);
+    if (ts.isArrowFunction(node) || ts.isFunctionExpression(node)) {
+        return true;
+    }
+    if (!ts.isCallExpression(node)) {
+        return false;
+    }
+    return ["fn", "fnUntraced"].includes(memberName(node.expression) ?? "") || (ts.isCallExpression(node.expression) && functionValue(node.expression));
+}
+export function syntaxFindings(file, select, message) {
+    const source = parse(file);
+    return source === undefined ? [] : select(source).map((node) => findingAt(source, node, message));
+}
+//# sourceMappingURL=syntax.js.map

package/dist/rules/stories/syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.js","sourceRoot":"","sources":["../../../src/rules/stories/syntax.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,MAAM,UAAU,MAAM,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAmB;IAC5C,OAAO,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;QACrI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;QAC5B,CAAC,CAAC,IAAI,CAAC;AACT,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,0BAA0B,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5I,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACtI,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAqB,EAAE,IAAa,EAAE,OAAe;IAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC;AACvH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAqB,EAAE,OAAmC;IACpF,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,SAAS,KAAK,CAAC,IAAa;QAC3B,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,CAAC;IACd,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAqB;IACpD,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAU,CAAC,SAAS,EAAE,EAAE;QACvD,IAAI,EAAE,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC;YACvC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;gBAC/D,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;gBACrG,OAAO,KAAK,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,CAAC,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAoB;IAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AACrJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,MAAqD,EAAE,OAAe;IACtH,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACnG,CAAC"}

package/docs/debt-and-hooks.md

@@ -76,6 +76,8 @@ help: fix what the output above reports, then commit again; `quality hooks pre-c
 
 The hook is a short script in the repository's common git directory, `.git/hooks/pre-commit`, which every worktree of the repository shares. It changes to the root of the worktree that commits, then to the config's folder in it, and runs that worktree's quality with that worktree's config, so a branch that changes the checks commits under its own rules. It runs quality the way `hooks install` ran: when that was a file inside the repository, such as a workspace's own source, it runs `node` with the same Node options on that file; otherwise it runs `node_modules/.bin/quality` in the config's folder. When that file does not exist, as in a new worktree whose dependencies are not installed yet, the hook blocks the commit and says to install them. A config file not named `quality.config.ts` is passed with `--config`.
 
-`hooks install` never sets `core.hooksPath`, so a hooks path set for the whole machine, such as a check that calls each repository's own hook after its own, keeps working. When `core.hooksPath` is set, git runs the hook found there instead, and `hooks install` notes that the installed hook runs only when that one calls it.
+`hooks install` sets repository-local `core.hooksPath` to the common git directory's `hooks` folder and prints that path. It never changes global or system git configuration. At commit time, the hook reads global `core.hooksPath` and runs its executable `pre-commit` hook from the committing worktree's root, before Quality's checks. Relative global paths resolve from that root; a global path pointing to Quality's own hook is not chained. Quality still runs when the global hook fails, and either failure blocks the commit. Installation reports whether there is an executable global hook to chain.
 
-A pre-commit hook that quality did not write is kept: `hooks install` warns, says how to call quality from it, and exits 0. `--force` replaces it. `quality hooks uninstall` removes quality's hook and keeps any other.
+`quality hooks status` reports whether git's effective hooks path runs an executable Quality pre-commit hook, and exits 1 with an installation hint when it does not. It also reports global chaining when Quality is active.
+
+A pre-commit hook that quality did not write is kept: `hooks install` warns, says how to call quality from it, and exits 0 without setting the hooks path. `--force` replaces it. `quality hooks uninstall` removes quality's hook and keeps any other. It removes the repository-local hooks path only when that setting still points to Quality's hooks directory, letting global hooks take effect again.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/quality",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Repository quality gate with typed rules, a baseline of existing debt and a registry of reasoned exceptions",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/quality#readme",
   "bugs": {
@@ -34,7 +34,10 @@
     "./package.json": "./package.json",
     "./domEnvironment.config.ts": null,
     "./imports/isTooling.ts": null,
-    "./rules/imports/bundleInputs.ts": null
+    "./rules/imports/bundleInputs.ts": null,
+    "./inventory/shadcnFolders.ts": null,
+    "./inventory/shadcnAlias.ts": null,
+    "./naming/migrationFile.ts": null
   },
   "bin": {
     "quality": "./dist/cli.js"

package/src/biome/run.ts

@@ -1,7 +1,10 @@
 import { execFile } from "node:child_process";
 import { createRequire } from "node:module";
 import process from "node:process";
+import { NodeFileSystem } from "@effect/platform-node";
+import { Effect } from "effect";
 import type { ExceptionDeclaration } from "#exceptions/declaration.ts";
+import { shadcnFolders } from "#inventory/shadcnFolders.ts";
 import { withExceptionConfig } from "./exceptionConfig.ts";
 
 export interface BiomeRun {
@@ -12,10 +15,21 @@ export interface BiomeRun {
 
 const BIN = createRequire(import.meta.url).resolve("@biomejs/biome/bin/biome");
 
-export function runBiome(root: string, args: readonly string[], exceptions: readonly ExceptionDeclaration[] = []): Promise<BiomeRun> {
+export async function runBiome(root: string, args: readonly string[], exceptions: readonly ExceptionDeclaration[] = []): Promise<BiomeRun> {
+	const folders = await Effect.runPromise(shadcnFolders(root).pipe(Effect.provide(NodeFileSystem.layer)));
+	const toolOwned: readonly ExceptionDeclaration[] =
+		folders.length === 0
+			? []
+			: [
+					{
+						files: ["**", ...folders.map((folder) => `!${folder}`)],
+						reason: "components.json assigns these folders to the shadcn CLI.",
+						rules: ["biome/files/includes"],
+					},
+				];
 	return withExceptionConfig(
 		root,
-		exceptions,
+		[...exceptions, ...toolOwned],
 		(configArgs) =>
 			new Promise((resolve, reject) => {
 				execFile(process.execPath, [BIN, ...args, ...configArgs, "--colors=off"], { cwd: root, maxBuffer: 2 ** 30 }, (error, stdout, stderr) => {

package/src/cli/args.ts

@@ -12,6 +12,7 @@ export type Command =
 	| { readonly _tag: "BaselineMigrate"; readonly config: string | undefined; readonly from: string | undefined }
 	| { readonly _tag: "HooksInstall"; readonly config: string | undefined; readonly force: boolean }
 	| { readonly _tag: "HooksUninstall" }
+	| { readonly _tag: "HooksStatus" }
 	| { readonly _tag: "HooksPreCommit"; readonly config: string | undefined }
 	| { readonly _tag: "Help" };
 
@@ -52,6 +53,7 @@ const ACCEPTS: Readonly<Record<string, readonly Option[]>> = {
 	fix: [],
 	"hooks install": ["force"],
 	"hooks pre-commit": [],
+	"hooks status": [],
 	"hooks uninstall": [],
 	lint: [],
 };
@@ -85,6 +87,8 @@ function commandFor(name: string, values: Values): Parsed {
 			return parsed({ _tag: "HooksInstall", config, force: values.force === true });
 		case "hooks uninstall":
 			return parsed({ _tag: "HooksUninstall" });
+		case "hooks status":
+			return parsed({ _tag: "HooksStatus" });
 		case "hooks pre-commit":
 			return parsed({ _tag: "HooksPreCommit", config });
 		default:

package/src/cli/messages.ts

@@ -8,6 +8,7 @@ export const USAGE = `Usage:
   quality baseline migrate [--config <file>] [--from <file>]
   quality hooks install [--config <file>] [--force]
   quality hooks uninstall
+  quality hooks status
   quality hooks pre-commit [--config <file>]
 
 lint              Run every rule. Exits 1 on an error-level violation, a file over its baseline, a stale registry entry
@@ -21,6 +22,7 @@ baseline migrate  Move a baseline from the earlier JSON format (--from, quality/
 hooks install     Install the git pre-commit hook, shared by every worktree, that runs hooks pre-commit. Keeps a hook that is not quality's
                   unless --force replaces it.
 hooks uninstall   Remove quality's pre-commit hook. Keeps a hook that is not quality's.
+hooks status      Check that git's effective hooks path runs Quality's pre-commit hook and report global chaining.
 hooks pre-commit  What the hook runs: lint, then package.json scripts typecheck and quality:commit when present.
 
 --config <file>  Config file; its directory is the repository root. Without this option, uses ./quality.config.ts when present, otherwise defaults.
@@ -30,5 +32,5 @@ Exit codes: 0 passed, 1 failed the gate, 2 could not run.`;
 export const SUBCOMMANDS: Readonly<Record<string, string>> = {
 	baseline: "baseline takes write, prune, tighten or migrate.",
 	exceptions: "exceptions takes migrate.",
-	hooks: "hooks takes install, uninstall or pre-commit.",
+	hooks: "hooks takes install, uninstall, status or pre-commit.",
 };

package/src/cli/program.ts

@@ -10,6 +10,7 @@ import { SetupFailure } from "#failure.ts";
 import type { Launch } from "#hooks/command.ts";
 import { installHook } from "#hooks/install.ts";
 import { preCommitHook } from "#hooks/preCommit.ts";
+import { hookStatus } from "#hooks/status.ts";
 import { uninstallHook } from "#hooks/uninstall.ts";
 
 export interface Invocation {
@@ -44,6 +45,8 @@ export const program = Effect.fn("Cli.program")(function* (args: readonly string
 			return yield* installHook({ config: command.config, cwd, force: command.force, launch });
 		case "HooksUninstall":
 			return yield* uninstallHook(cwd);
+		case "HooksStatus":
+			return yield* hookStatus(cwd);
 		case "HooksPreCommit":
 			return yield* preCommitHook(cwd, command.config);
 	}

package/src/hooks/install.ts

@@ -1,12 +1,14 @@
-import { basename, dirname, join, relative, resolve } from "node:path";
+import { basename, dirname, join, relative } from "node:path";
 import { Console, Effect, FileSystem } from "effect";
 import { CONFIG_FILE } from "#config/file.ts";
 import { loadConfig } from "#config/load.ts";
 import { SetupFailure } from "#failure.ts";
+import { gitOrFail } from "#git/command.ts";
 import { readOptionalText } from "#inventory/filesystem.ts";
 import { commandWords, hookCommand, type Launch, shellWords } from "./command.ts";
-import { type HookLocation, hookLocation } from "./location.ts";
+import { hookLocation } from "./location.ts";
 import { hookShim, isHookShim } from "./shim.ts";
+import { globalHookStatus } from "./status.ts";
 
 export interface HookInstall {
 	readonly config: string | undefined;
@@ -33,14 +35,6 @@ const write = Effect.fnUntraced(function* (file: string, text: string) {
 	);
 });
 
-function elsewhere(location: HookLocation): Effect.Effect<void> {
-	return location.hooksPath === undefined || resolve(location.toplevel, location.hooksPath) === dirname(location.file)
-		? Effect.void
-		: Console.error(
-				`note: core.hooksPath is ${location.hooksPath}, so git runs the pre-commit hook there; ${location.file} runs only when that hook calls it.`,
-			);
-}
-
 export const installHook = Effect.fn("Hooks.installHook")(function* (install: HookInstall) {
 	const config = yield* loadConfig(install.cwd, install.config);
 	const location = yield* hookLocation(config.root);
@@ -58,12 +52,17 @@ export const installHook = Effect.fn("Hooks.installHook")(function* (install: Ho
 		yield* Console.error(
 			`quality: kept ${location.file}: it is not quality's pre-commit hook, so quality does not check commits.\nhelp: call \`${call}\` from that hook, or replace it with \`quality hooks install --force\`.`,
 		);
-	} else if (existing === shim) {
+		return;
+	}
+	if (existing === shim) {
 		yield* Console.log(`quality: the pre-commit hook at ${location.file} is up to date.`);
 	} else {
 		yield* write(location.file, shim);
 		const done = foreign ? `replaced ${location.file}, which was not quality's hook` : `installed the pre-commit hook at ${location.file}`;
 		yield* Console.log(`quality: ${done}; each commit runs \`${words}\`.`);
 	}
-	yield* elsewhere(location);
+	const hooks = dirname(location.file);
+	yield* gitOrFail(config.root, ["config", "--local", "core.hooksPath", hooks]);
+	yield* Console.log(`quality: set repository-local core.hooksPath to ${hooks}.`);
+	yield* globalHookStatus(location);
 });