@shivaedev/quality 0.61.1 → 0.62.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 +13 -0
- package/README.md +24 -4
- package/dist/adapters/agentLinkFindings.d.ts +7 -0
- package/dist/adapters/agentLinkFindings.d.ts.map +1 -0
- package/dist/adapters/agentLinkFindings.js +18 -0
- package/dist/adapters/agentLinkFindings.js.map +1 -0
- package/dist/adapters/asciiFindings.d.ts +10 -0
- package/dist/adapters/asciiFindings.d.ts.map +1 -0
- package/dist/adapters/asciiFindings.js +31 -0
- package/dist/adapters/asciiFindings.js.map +1 -0
- package/dist/adapters/catalogEntries.d.ts +14 -0
- package/dist/adapters/catalogEntries.d.ts.map +1 -0
- package/dist/adapters/catalogEntries.js +58 -0
- package/dist/adapters/catalogEntries.js.map +1 -0
- package/dist/adapters/catalogWorkspace.d.ts +7 -0
- package/dist/adapters/catalogWorkspace.d.ts.map +1 -0
- package/dist/adapters/catalogWorkspace.js +18 -0
- package/dist/adapters/catalogWorkspace.js.map +1 -0
- package/dist/adapters/repositoryPathFindings.d.ts +4 -0
- package/dist/adapters/repositoryPathFindings.d.ts.map +1 -0
- package/dist/adapters/repositoryPathFindings.js +60 -0
- package/dist/adapters/repositoryPathFindings.js.map +1 -0
- package/dist/adapters/serviceFolderFindings.d.ts +3 -0
- package/dist/adapters/serviceFolderFindings.d.ts.map +1 -0
- package/dist/adapters/serviceFolderFindings.js +65 -0
- package/dist/adapters/serviceFolderFindings.js.map +1 -0
- package/dist/inventory/walk.js +1 -1
- package/dist/inventory/walk.js.map +1 -1
- package/dist/rules/builtIn.d.ts +3 -1
- package/dist/rules/builtIn.d.ts.map +1 -1
- package/dist/rules/builtIn.js +10 -0
- package/dist/rules/builtIn.js.map +1 -1
- package/dist/rules/docs/agentLinks.d.ts +2 -0
- package/dist/rules/docs/agentLinks.d.ts.map +1 -0
- package/dist/rules/docs/agentLinks.js +8 -0
- package/dist/rules/docs/agentLinks.js.map +1 -0
- package/dist/rules/docs/repositoryPaths.d.ts +2 -0
- package/dist/rules/docs/repositoryPaths.d.ts.map +1 -0
- package/dist/rules/docs/repositoryPaths.js +8 -0
- package/dist/rules/docs/repositoryPaths.js.map +1 -0
- package/dist/rules/effect/serviceFolders.d.ts +2 -0
- package/dist/rules/effect/serviceFolders.d.ts.map +1 -0
- package/dist/rules/effect/serviceFolders.js +9 -0
- package/dist/rules/effect/serviceFolders.js.map +1 -0
- package/dist/rules/files/ascii.d.ts +4 -0
- package/dist/rules/files/ascii.d.ts.map +1 -0
- package/dist/rules/files/ascii.js +13 -0
- package/dist/rules/files/ascii.js.map +1 -0
- package/dist/rules/files/folderNames.d.ts.map +1 -1
- package/dist/rules/files/folderNames.js +7 -4
- package/dist/rules/files/folderNames.js.map +1 -1
- package/dist/rules/manifestsDependencyPins.d.ts +2 -0
- package/dist/rules/manifestsDependencyPins.d.ts.map +1 -0
- package/dist/rules/manifestsDependencyPins.js +50 -0
- package/dist/rules/manifestsDependencyPins.js.map +1 -0
- package/dist/testing/adapters/hookRepository.d.ts.map +1 -1
- package/dist/testing/adapters/hookRepository.js +1 -1
- package/dist/testing/adapters/hookRepository.js.map +1 -1
- package/package.json +3 -3
- package/src/adapters/agentLinkFindings.ts +23 -0
- package/src/adapters/asciiFindings.ts +39 -0
- package/src/adapters/catalogEntries.ts +81 -0
- package/src/adapters/catalogWorkspace.ts +19 -0
- package/src/adapters/repositoryPathFindings.ts +68 -0
- package/src/adapters/serviceFolderFindings.ts +75 -0
- package/src/inventory/walk.ts +1 -1
- package/src/rules/builtIn.ts +10 -0
- package/src/rules/docs/agentLinks.ts +8 -0
- package/src/rules/docs/repositoryPaths.ts +9 -0
- package/src/rules/effect/serviceFolders.ts +10 -0
- package/src/rules/files/ascii.ts +14 -0
- package/src/rules/files/folderNames.ts +7 -4
- package/src/rules/manifestsDependencyPins.ts +66 -0
- package/src/testing/adapters/hookRepository.ts +5 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agentLinks.d.ts","sourceRoot":"","sources":["../../../src/rules/docs/agentLinks.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,gGAIrB,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { agentLinkFindings } from "#adapters/agentLinkFindings.ts";
|
|
2
|
+
import { defineRule } from "#rule.ts";
|
|
3
|
+
export const agentLinks = defineRule({
|
|
4
|
+
check: agentLinkFindings,
|
|
5
|
+
description: "Every CLAUDE.md is a symlink to the AGENTS.md file beside it.",
|
|
6
|
+
id: "docs/agent-links",
|
|
7
|
+
});
|
|
8
|
+
//# sourceMappingURL=agentLinks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agentLinks.js","sourceRoot":"","sources":["../../../src/rules/docs/agentLinks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;IACpC,KAAK,EAAE,iBAAiB;IACxB,WAAW,EAAE,+DAA+D;IAC5E,EAAE,EAAE,kBAAkB;CACtB,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repositoryPaths.d.ts","sourceRoot":"","sources":["../../../src/rules/docs/repositoryPaths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,qGAK1B,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { repositoryPathFindings } from "#adapters/repositoryPathFindings.ts";
|
|
2
|
+
import { defineRule } from "#rule.ts";
|
|
3
|
+
export const repositoryPaths = defineRule({
|
|
4
|
+
check: repositoryPathFindings,
|
|
5
|
+
description: "Repository paths in Markdown backticks exist. Check explicit relative paths and paths beneath known repository folders; leave examples, globs, commands and URLs alone.",
|
|
6
|
+
id: "docs/repository-paths",
|
|
7
|
+
});
|
|
8
|
+
//# sourceMappingURL=repositoryPaths.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repositoryPaths.js","sourceRoot":"","sources":["../../../src/rules/docs/repositoryPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACzC,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACV,yKAAyK;IAC1K,EAAE,EAAE,uBAAuB;CAC3B,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serviceFolders.d.ts","sourceRoot":"","sources":["../../../src/rules/effect/serviceFolders.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,qEAMzB,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { serviceFolderFindings } from "#adapters/serviceFolderFindings.ts";
|
|
2
|
+
import { defineRule } from "#rule.ts";
|
|
3
|
+
export const serviceFolders = defineRule({
|
|
4
|
+
check: serviceFolderFindings,
|
|
5
|
+
description: "Each services/<name> folder has service.ts, and its service.ts exports one named const initialized by defineService. The service-definition-assembly rule checks its operation inventory.",
|
|
6
|
+
id: "effect/service-folders",
|
|
7
|
+
registrable: false,
|
|
8
|
+
});
|
|
9
|
+
//# sourceMappingURL=serviceFolders.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serviceFolders.js","sourceRoot":"","sources":["../../../src/rules/effect/serviceFolders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACxC,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACV,2LAA2L;IAC5L,EAAE,EAAE,wBAAwB;IAC5B,WAAW,EAAE,KAAK;CAClB,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ascii.d.ts","sourceRoot":"","sources":["../../../src/rules/files/ascii.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,KAAK;;0CAKhB,CAAC"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { Effect, Schema } from "effect";
|
|
2
|
+
import { asciiFindings } from "#adapters/asciiFindings.ts";
|
|
3
|
+
import { defineRule } from "#rule.ts";
|
|
4
|
+
const AsciiOptions = Schema.Struct({
|
|
5
|
+
files: Schema.Array(Schema.NonEmptyString).pipe(Schema.withDecodingDefaultKey(Effect.succeed([]))),
|
|
6
|
+
});
|
|
7
|
+
export const ascii = defineRule({
|
|
8
|
+
check: asciiFindings,
|
|
9
|
+
description: "Chosen text files contain only ASCII characters. No files are selected by default.",
|
|
10
|
+
id: "files/ascii",
|
|
11
|
+
options: Schema.toStandardSchemaV1(AsciiOptions, { parseOptions: { errors: "all", onExcessProperty: "error" } }),
|
|
12
|
+
});
|
|
13
|
+
//# sourceMappingURL=ascii.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ascii.js","sourceRoot":"","sources":["../../../src/rules/files/ascii.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;CAClG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAAC;IAC/B,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,oFAAoF;IACjG,EAAE,EAAE,aAAa;IACjB,OAAO,EAAE,MAAM,CAAC,kBAAkB,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,CAAC;CAChH,CAAC,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"folderNames.d.ts","sourceRoot":"","sources":["../../../src/rules/files/folderNames.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"folderNames.d.ts","sourceRoot":"","sources":["../../../src/rules/files/folderNames.ts"],"names":[],"mappings":"AA8EA,eAAO,MAAM,WAAW;;;;;;;;;mCAsBtB,CAAC"}
|
|
@@ -29,9 +29,12 @@ function isModule(folder, stems) {
|
|
|
29
29
|
const name = posix.basename(folder);
|
|
30
30
|
return stems.has(`${folder}/${name}`) || stems.has(`${posix.dirname(folder)}/${name}`);
|
|
31
31
|
}
|
|
32
|
-
function packageMessage(
|
|
32
|
+
function packageMessage(folder, packageName) {
|
|
33
33
|
const expected = packageName.replace(/^@[^/]+\//u, "");
|
|
34
|
-
|
|
34
|
+
const nested = folder.split("/").slice(1).join("-");
|
|
35
|
+
return posix.basename(folder) === expected || nested === expected
|
|
36
|
+
? undefined
|
|
37
|
+
: `The folder of the package ${packageName} must be named "${expected}", in kebab-case after the package name, or its path below the workspace package root must join with "-" to "${expected}".`;
|
|
35
38
|
}
|
|
36
39
|
function groupMessage(name) {
|
|
37
40
|
if (PASCAL.test(name)) {
|
|
@@ -48,7 +51,7 @@ function messageFor(folder, context) {
|
|
|
48
51
|
}
|
|
49
52
|
const packageName = context.names.get(folder);
|
|
50
53
|
if (packageName !== undefined) {
|
|
51
|
-
return packageMessage(
|
|
54
|
+
return packageMessage(folder, packageName);
|
|
52
55
|
}
|
|
53
56
|
if (context.content.ignores(`${folder}/`)) {
|
|
54
57
|
return SNAKE.test(name) ? undefined : `"${name}" holds content, so it is named in snake_case, such as forest_path/.`;
|
|
@@ -71,7 +74,7 @@ export const folderNames = defineRule({
|
|
|
71
74
|
return message === undefined ? [] : [{ file: folder, message }];
|
|
72
75
|
});
|
|
73
76
|
}),
|
|
74
|
-
description: "A package folder
|
|
77
|
+
description: "A package folder's final name or its path below the workspace package root joined with hyphens matches its unscoped package name. A module folder is named after its main file, a content folder in snake_case and every other folder in kebab-case. TanStack Router configuration owns route folder names.",
|
|
75
78
|
id: "files/folder-names",
|
|
76
79
|
options: Schema.toStandardSchemaV1(FolderNamesOptions, { parseOptions: { errors: "all", onExcessProperty: "error" } }),
|
|
77
80
|
validate: validateGlobs,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"folderNames.js","sourceRoot":"","sources":["../../../src/rules/files/folderNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAsB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAgB,MAAM,UAAU,CAAC;AAEpD,MAAM,KAAK,GAAG,6BAA6B,CAAC;AAE5C,MAAM,IAAI,GAAG,kBAAkB,CAAC;AAEhC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,gBAAgB;IACzB,SAAS,EAAE,gBAAgB;CAC3B,CAAC,CAAC;AAEH,SAAS,SAAS,CAAC,KAAwB;IAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,KAAK,IAAI,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACvF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,OAAO,CAAC,KAAwB;IACxC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3I,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,KAA0B;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,cAAc,CAAC,
|
|
1
|
+
{"version":3,"file":"folderNames.js","sourceRoot":"","sources":["../../../src/rules/files/folderNames.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manifestsDependencyPins.d.ts","sourceRoot":"","sources":["../../src/rules/manifestsDependencyPins.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,uBAAuB,wEA4BlC,CAAC"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { Effect } from "effect";
|
|
2
|
+
import { catalogEntries } from "#adapters/catalogEntries.ts";
|
|
3
|
+
import { catalogWorkspace } from "#adapters/catalogWorkspace.ts";
|
|
4
|
+
import { manifestFiles, readPackageManifest } from "#adapters/manifestInventory.ts";
|
|
5
|
+
import { defineRule } from "#rule.ts";
|
|
6
|
+
const SECTIONS = ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"];
|
|
7
|
+
const EXACT = /^(?:npm:(?:@[^/\s]+\/)?[^@\s]+@)?(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[\dA-Za-z-]+(?:\.[\dA-Za-z-]+)*)?(?:\+[\dA-Za-z-]+(?:\.[\dA-Za-z-]+)*)?$/u;
|
|
8
|
+
const LOCAL = /^(?:workspace:|file:|link:)/u;
|
|
9
|
+
function dependencyFinding(file, section, name, version, catalogs) {
|
|
10
|
+
if (LOCAL.test(version)) {
|
|
11
|
+
return [];
|
|
12
|
+
}
|
|
13
|
+
const catalog = version.startsWith("catalog:") ? version.slice("catalog:".length) : undefined;
|
|
14
|
+
const valid = catalog === undefined
|
|
15
|
+
? !catalogs.present && EXACT.test(version)
|
|
16
|
+
: catalogs.entries.some((entry) => entry.catalog === catalog && entry.name === name);
|
|
17
|
+
return valid
|
|
18
|
+
? []
|
|
19
|
+
: [
|
|
20
|
+
{
|
|
21
|
+
file,
|
|
22
|
+
message: `${section} entry "${name}: ${version}" must ${catalogs.present || catalog !== undefined ? 'use "catalog:" (or a named catalog) with an entry for this dependency in pnpm-workspace.yaml' : "pin an exact version, including for npm aliases"}. Workspace, file and link dependencies stay local.`,
|
|
23
|
+
subject: `${section}.${name}`,
|
|
24
|
+
},
|
|
25
|
+
];
|
|
26
|
+
}
|
|
27
|
+
export const manifestsDependencyPins = defineRule({
|
|
28
|
+
check: (inputs) => Effect.gen(function* () {
|
|
29
|
+
const workspace = yield* catalogWorkspace(inputs);
|
|
30
|
+
const catalogs = catalogEntries(workspace.text);
|
|
31
|
+
const findings = catalogs.findings.map((finding) => ({ ...finding, file: workspace.file }));
|
|
32
|
+
for (const entry of catalogs.entries) {
|
|
33
|
+
if (!EXACT.test(entry.version)) {
|
|
34
|
+
findings.push({
|
|
35
|
+
file: workspace.file,
|
|
36
|
+
line: entry.line,
|
|
37
|
+
message: `Catalog entry "${entry.name}: ${entry.version}" is not an exact version. Pin one version, including for npm aliases.`,
|
|
38
|
+
});
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
for (const file of manifestFiles(inputs)) {
|
|
42
|
+
const manifest = yield* Effect.promise(() => readPackageManifest(inputs.readText, file));
|
|
43
|
+
findings.push(...SECTIONS.flatMap((section) => Object.entries(manifest?.[section] ?? {}).flatMap(([name, version]) => dependencyFinding(file, section, name, version, catalogs))));
|
|
44
|
+
}
|
|
45
|
+
return findings;
|
|
46
|
+
}),
|
|
47
|
+
description: "Pin external dependencies to exact versions; use catalog references when pnpm-workspace.yaml declares catalogs, and pin their entries too.",
|
|
48
|
+
id: "manifests/dependency-pins",
|
|
49
|
+
});
|
|
50
|
+
//# sourceMappingURL=manifestsDependencyPins.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manifestsDependencyPins.js","sourceRoot":"","sources":["../../src/rules/manifestsDependencyPins.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hookRepository.d.ts","sourceRoot":"","sources":["../../../src/testing/adapters/hookRepository.ts"],"names":[],"mappings":"AAKA,OAAO,EAAe,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGjD,OAAO,EAA8B,KAAK,QAAQ,EAAY,MAAM,WAAW,CAAC;AAEhF,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAaD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAWD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGxE;AAYD,wBAAgB,cAAc,CAAC,EAC9B,UAAkB,EAClB,KAA4C,EAC5C,MAAW,EACX,OAAY,GACZ,GAAE,SAAc,GAAG,cAAc,CAyBjC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAGpH;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,
|
|
1
|
+
{"version":3,"file":"hookRepository.d.ts","sourceRoot":"","sources":["../../../src/testing/adapters/hookRepository.ts"],"names":[],"mappings":"AAKA,OAAO,EAAe,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGjD,OAAO,EAA8B,KAAK,QAAQ,EAAY,MAAM,WAAW,CAAC;AAEhF,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAaD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAWD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGxE;AAYD,wBAAgB,cAAc,CAAC,EAC9B,UAAkB,EAClB,KAA4C,EAC5C,MAAW,EACX,OAAY,GACZ,GAAE,SAAc,GAAG,cAAc,CAyBjC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAGpH;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAS9E;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,SAAe,GAAG,MAAM,CAGtG;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAOzD;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAE3D"}
|
|
@@ -69,7 +69,7 @@ export function withScripts(root, scripts, packageManager) {
|
|
|
69
69
|
}
|
|
70
70
|
export function withQualityAt(repository, path) {
|
|
71
71
|
writes(repository.root, path, 'import "@shivaedev/quality/cli.ts";\n');
|
|
72
|
-
writes(repository.root, "package.json", manifest({ bin: { quality: `./${path}` }, devDependencies: { "@shivaedev/quality": "
|
|
72
|
+
writes(repository.root, "package.json", manifest({ bin: { quality: `./${path}` }, devDependencies: { "@shivaedev/quality": "file:./node_modules/@shivaedev/quality" } }));
|
|
73
73
|
formatTree(repository.root);
|
|
74
74
|
return join(repository.root, path);
|
|
75
75
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hookRepository.js","sourceRoot":"","sources":["../../../src/testing/adapters/hookRepository.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"hookRepository.js","sourceRoot":"","sources":["../../../src/testing/adapters/hookRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAY,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAiB,QAAQ,EAAE,MAAM,WAAW,CAAC;AAehF,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,MAAM,cAAc,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC;QAC5B,CAAC,mBAAmB,EAAE,YAAY,CAAC;QACnC,CAAC,OAAO,EAAE,eAAe,CAAC;QAC1B,CAAC,SAAS,EAAE,aAAa,CAAC;KAC1B,CAAC;CACF,CAAC;AAEF,sHAAsH;AACtH,MAAM,UAAU,IAAI,CAAC,IAAY;IAChC,OAAO,QAAQ,IAAI,OAAO,UAAU,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACrC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/F,CAAC;AAED,MAAM,KAAK,GAAa,EAAE,OAAO,EAAE,oDAAoD,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAE/G,MAAM,GAAG,GAAG,wBAAwB,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;AAEzE,MAAM,MAAM,GAAa;IACxB,OAAO,EAAE,sGAAsG;IAC/G,IAAI,EAAE,mBAAmB;CACzB,CAAC;AAEF,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe;IACjE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,QAAQ,CAAC,MAAyC;IAC1D,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;AACnH,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC5B,MAAM,CAAC,IAAI,EAAE,2BAA2B,EAAE,GAAG,CAAC,CAAC;IAC/C,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,2BAA2B,CAAC,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,EAC9B,UAAU,GAAG,KAAK,EAClB,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAC5C,MAAM,GAAG,EAAE,EACX,OAAO,GAAG,EAAE,GACZ,GAAc,EAAE;IAChB,MAAM,IAAI,GAAG,QAAQ,CACpB;QACC,GAAG,CAAC,UAAU;YACb,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACA,MAAM;gBACN,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,EAAE;gBAClD,EAAE,OAAO,EAAE,2DAA2D,EAAE,IAAI,EAAE,YAAY,EAAE;aAC5F,CAAC;QACJ,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChD,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE;QACxD,GAAG,KAAK;KACR,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChB,GAAG,IAAI;QACP,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;KAC7B,CAAC,CAAC,EACH,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CACpD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5B,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAyC,EAAE,cAAuB;IAC3G,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAA0B,EAAE,IAAY;IACrE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,uCAAuC,CAAC,CAAC;IACvE,MAAM,CACL,UAAU,CAAC,IAAI,EACf,cAAc,EACd,QAAQ,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,oBAAoB,EAAE,wCAAwC,EAAE,EAAE,CAAC,CAChI,CAAC;IACF,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAA0B,EAAE,IAAY,EAAE,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC7F,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAA0B,EAAE,IAAY,EAAE,EAAW;IACjF,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,OAAe;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QAC7F,GAAG;QACH,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,mBAAmB,CAAC,GAAG,CAAC;KAC7B,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,UAA0B;IAClD,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,UAA0B;IAClD,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;AAC/C,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shivaedev/quality",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.62.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": {
|
|
@@ -65,7 +65,7 @@
|
|
|
65
65
|
"@effect/platform-node-shared": "4.0.7",
|
|
66
66
|
"@effect/vitest": "4.0.7",
|
|
67
67
|
"@shivaedev/test": "0.15.1",
|
|
68
|
-
"@shivaedev/test-story": "0.39.
|
|
68
|
+
"@shivaedev/test-story": "0.39.2",
|
|
69
69
|
"@types/node": "24.19.2",
|
|
70
70
|
"@typescript/native": "npm:typescript@7.0.2",
|
|
71
71
|
"effect": "4.0.7",
|
|
@@ -74,7 +74,7 @@
|
|
|
74
74
|
"peerDependencies": {
|
|
75
75
|
"@effect/platform-node": "4.0.7",
|
|
76
76
|
"@effect/platform-node-shared": "4.0.7",
|
|
77
|
-
"@shivaedev/test-story": "0.39.
|
|
77
|
+
"@shivaedev/test-story": "0.39.2",
|
|
78
78
|
"effect": "4.0.7",
|
|
79
79
|
"vitest": "5.0.5"
|
|
80
80
|
},
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { dirname, join, resolve } from "node:path";
|
|
2
|
+
import { Effect, FileSystem } from "effect";
|
|
3
|
+
import { orWhenAbsent } from "#inventory/filesystem.ts";
|
|
4
|
+
import type { RuleInputs } from "#rule.ts";
|
|
5
|
+
|
|
6
|
+
export const agentLinkFindings = Effect.fn("Quality.agentLinkFindings")(function* ({ files, root }: RuleInputs) {
|
|
7
|
+
const fs = yield* FileSystem.FileSystem;
|
|
8
|
+
const findings = yield* Effect.forEach(
|
|
9
|
+
files.filter((file) => file === "CLAUDE.md" || file.endsWith("/CLAUDE.md")),
|
|
10
|
+
(file) =>
|
|
11
|
+
Effect.gen(function* () {
|
|
12
|
+
const path = join(root, file);
|
|
13
|
+
const info = yield* fs.lstat(path);
|
|
14
|
+
const target = info.type === "SymbolicLink" ? yield* fs.readLink(path) : undefined;
|
|
15
|
+
const agents = join(dirname(path), "AGENTS.md");
|
|
16
|
+
const sibling = yield* orWhenAbsent<FileSystem.File.Info | undefined>(agents, fs.stat(agents), undefined);
|
|
17
|
+
return target !== undefined && resolve(dirname(path), target) === agents && sibling?.type === "File"
|
|
18
|
+
? []
|
|
19
|
+
: [{ file, message: "Replace CLAUDE.md with a symlink to the AGENTS.md file beside it, and keep the instructions in AGENTS.md." }];
|
|
20
|
+
}),
|
|
21
|
+
);
|
|
22
|
+
return findings.flat();
|
|
23
|
+
});
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { join } from "node:path";
|
|
2
|
+
import { Effect, FileSystem } from "effect";
|
|
3
|
+
import { globMatcher } from "#imports/globMatcher.ts";
|
|
4
|
+
import type { RuleContext } from "#rule.ts";
|
|
5
|
+
|
|
6
|
+
function nonAsciiLines(bytes: Uint8Array): readonly number[] {
|
|
7
|
+
const lines = new Set<number>();
|
|
8
|
+
let line = 1;
|
|
9
|
+
for (const byte of bytes) {
|
|
10
|
+
if (byte > 127) {
|
|
11
|
+
lines.add(line);
|
|
12
|
+
}
|
|
13
|
+
if (byte === 10) {
|
|
14
|
+
line += 1;
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
return [...lines];
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
export const asciiFindings = Effect.fn("Quality.asciiFindings")(function* ({
|
|
21
|
+
files,
|
|
22
|
+
options,
|
|
23
|
+
root,
|
|
24
|
+
}: RuleContext<{ readonly files: readonly string[] }>) {
|
|
25
|
+
const fs = yield* FileSystem.FileSystem;
|
|
26
|
+
const patterns = options.files.map(globMatcher);
|
|
27
|
+
const selected = files.filter((file) => patterns.some((matches) => matches(file)));
|
|
28
|
+
const findings = yield* Effect.forEach(selected, (file) =>
|
|
29
|
+
Effect.gen(function* () {
|
|
30
|
+
const bytes = yield* fs.readFile(join(root, file));
|
|
31
|
+
return nonAsciiLines(bytes).map((line) => ({
|
|
32
|
+
file,
|
|
33
|
+
line,
|
|
34
|
+
message: "This file is ASCII-only. Replace non-ASCII characters with ASCII text or escapes.",
|
|
35
|
+
}));
|
|
36
|
+
}),
|
|
37
|
+
);
|
|
38
|
+
return findings.flat();
|
|
39
|
+
});
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import type { Finding } from "#rule.ts";
|
|
2
|
+
|
|
3
|
+
interface CatalogEntry {
|
|
4
|
+
readonly catalog: string;
|
|
5
|
+
readonly line: number;
|
|
6
|
+
readonly name: string;
|
|
7
|
+
readonly version: string;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
interface CatalogScan {
|
|
11
|
+
active: boolean;
|
|
12
|
+
catalog: string;
|
|
13
|
+
catalogIndent: number;
|
|
14
|
+
readonly entries: CatalogEntry[];
|
|
15
|
+
readonly findings: Finding[];
|
|
16
|
+
named: boolean;
|
|
17
|
+
present: boolean;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
const HEADING = /^(?:catalog|["']catalog["'])\s*:\s*(?<default>.*)$|^(?:catalogs|["']catalogs["'])\s*:\s*(?<named>.*)$/u;
|
|
21
|
+
const MEMBER = /^(?<indent> +)(?:"(?<double>[^"]+)"|'(?<single>[^']+)'|(?<plain>[^\s:][^:]*)):\s*(?<value>.*)$/u;
|
|
22
|
+
|
|
23
|
+
function scalar(text: string): string {
|
|
24
|
+
return text
|
|
25
|
+
.replace(/(?:^|\s+)#.*$/u, "")
|
|
26
|
+
.trim()
|
|
27
|
+
.replace(/^["']|["']$/gu, "");
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
function finding(scan: CatalogScan, line: number, message: string): void {
|
|
31
|
+
scan.findings.push({ file: "pnpm-workspace.yaml", line, message });
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
function heading(scan: CatalogScan, fields: Readonly<Record<string, string>>, line: number): void {
|
|
35
|
+
scan.active = true;
|
|
36
|
+
scan.present = true;
|
|
37
|
+
scan.named = fields.named !== undefined;
|
|
38
|
+
scan.catalog = "";
|
|
39
|
+
scan.catalogIndent = 0;
|
|
40
|
+
if (scalar(fields.named ?? fields.default ?? "") !== "") {
|
|
41
|
+
finding(scan, line, "Write catalogs as indented block mappings so every dependency pin can be checked.");
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function member(scan: CatalogScan, text: string, line: number): void {
|
|
46
|
+
const fields = MEMBER.exec(text)?.groups;
|
|
47
|
+
const name = fields?.double ?? fields?.single ?? fields?.plain;
|
|
48
|
+
if (fields === undefined || name === undefined) {
|
|
49
|
+
finding(scan, line, "Write this catalog entry as a name and an exact version in an indented block mapping.");
|
|
50
|
+
return;
|
|
51
|
+
}
|
|
52
|
+
const indent = fields.indent?.length ?? 0;
|
|
53
|
+
const value = scalar(fields.value ?? "");
|
|
54
|
+
if (scan.named && (scan.catalogIndent === 0 || indent <= scan.catalogIndent)) {
|
|
55
|
+
scan.catalog = name;
|
|
56
|
+
scan.catalogIndent = indent;
|
|
57
|
+
if (value !== "") {
|
|
58
|
+
finding(scan, line, "Write this named catalog as an indented block mapping of exact dependency pins.");
|
|
59
|
+
}
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
scan.entries.push({ catalog: scan.catalog, line, name: name.trim(), version: value });
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
export function catalogEntries(text: string) {
|
|
66
|
+
const scan: CatalogScan = { active: false, catalog: "", catalogIndent: 0, entries: [], findings: [], named: false, present: false };
|
|
67
|
+
for (const [index, line] of text.split("\n").entries()) {
|
|
68
|
+
const fields = HEADING.exec(line)?.groups;
|
|
69
|
+
if (fields !== undefined) {
|
|
70
|
+
heading(scan, fields, index + 1);
|
|
71
|
+
continue;
|
|
72
|
+
}
|
|
73
|
+
if (/^[^\s#]/u.test(line)) {
|
|
74
|
+
scan.active = false;
|
|
75
|
+
}
|
|
76
|
+
if (scan.active && !/^\s*(?:#.*)?$/u.test(line)) {
|
|
77
|
+
member(scan, line, index + 1);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
return { entries: scan.entries, findings: scan.findings, present: scan.present };
|
|
81
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { dirname, join, relative, sep } from "node:path";
|
|
2
|
+
import { Effect } from "effect";
|
|
3
|
+
import type { RuleInputs } from "#rule.ts";
|
|
4
|
+
|
|
5
|
+
export const catalogWorkspace = Effect.fn("Manifests.catalogWorkspace")(function* ({ readText, root }: Pick<RuleInputs, "readText" | "root">) {
|
|
6
|
+
let directory = root;
|
|
7
|
+
for (;;) {
|
|
8
|
+
const file = relative(root, join(directory, "pnpm-workspace.yaml")).split(sep).join("/");
|
|
9
|
+
const text = yield* Effect.promise(() => readText(file));
|
|
10
|
+
if (text !== undefined) {
|
|
11
|
+
return { file, text };
|
|
12
|
+
}
|
|
13
|
+
const parent = dirname(directory);
|
|
14
|
+
if (parent === directory) {
|
|
15
|
+
return { file: "pnpm-workspace.yaml", text: "" };
|
|
16
|
+
}
|
|
17
|
+
directory = parent;
|
|
18
|
+
}
|
|
19
|
+
});
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { join, posix } from "node:path";
|
|
2
|
+
import { Effect, FileSystem } from "effect";
|
|
3
|
+
import { isDocument } from "#docs/isDocument.ts";
|
|
4
|
+
import { codeSpans, markdownLines } from "#docs/markdownLines.ts";
|
|
5
|
+
import type { Finding, RuleInputs } from "#rule.ts";
|
|
6
|
+
|
|
7
|
+
function pathIn(span: string): string | undefined {
|
|
8
|
+
if (
|
|
9
|
+
!(span.includes("/") && (span.startsWith(".") || span.endsWith("/") || /\.[a-z0-9]+(?::\d+(?::\d+)?|#.*)?$/iu.test(span)))
|
|
10
|
+
|| /[\s*?<>${}\\]/u.test(span)
|
|
11
|
+
|| /^(?:\/|@|~|[\w+.-]+:)/u.test(span)
|
|
12
|
+
|| /(?:^|\/)node_modules(?:\/|$)/u.test(span)
|
|
13
|
+
) {
|
|
14
|
+
return;
|
|
15
|
+
}
|
|
16
|
+
return span.replace(/(?::\d+(?::\d+)?|#.*)$/u, "").replace(/\/+$/u, "");
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
function references(text: string) {
|
|
20
|
+
return markdownLines(text)
|
|
21
|
+
.filter((line) => line.kind === "prose")
|
|
22
|
+
.flatMap((line) =>
|
|
23
|
+
codeSpans(line.text).flatMap((span) => {
|
|
24
|
+
const path = pathIn(span);
|
|
25
|
+
return path === undefined ? [] : [{ line: line.number, path, span }];
|
|
26
|
+
}),
|
|
27
|
+
);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
const missingPath = Effect.fn("Docs.missingPath")(function* (root: string, file: string, path: string) {
|
|
31
|
+
const fs = yield* FileSystem.FileSystem;
|
|
32
|
+
const explicit = path.startsWith("./") || path.startsWith("../");
|
|
33
|
+
const local = posix.join(posix.dirname(file), path);
|
|
34
|
+
const target = explicit ? local : posix.normalize(path);
|
|
35
|
+
if (target === ".." || target.startsWith("../")) {
|
|
36
|
+
return true;
|
|
37
|
+
}
|
|
38
|
+
if (yield* fs.exists(join(root, target))) {
|
|
39
|
+
return false;
|
|
40
|
+
}
|
|
41
|
+
if (path.startsWith("./") && (yield* fs.exists(join(root, path)))) {
|
|
42
|
+
return false;
|
|
43
|
+
}
|
|
44
|
+
return explicit || !(yield* fs.exists(join(root, local)));
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
export const repositoryPathFindings = Effect.fn("Docs.repositoryPathFindings")(function* ({ files, readText, root }: RuleInputs) {
|
|
48
|
+
const roots = new Set(files.map((file) => file.split("/")[0]));
|
|
49
|
+
const findings: Finding[] = [];
|
|
50
|
+
for (const file of files.filter((path) => isDocument(path) && posix.basename(path) !== "CLAUDE.md")) {
|
|
51
|
+
const text = yield* Effect.promise(() => readText(file));
|
|
52
|
+
for (const reference of references(text ?? "")) {
|
|
53
|
+
const { path, span, line } = reference;
|
|
54
|
+
if (!(path.startsWith("./") || path.startsWith("../") || roots.has(path.split("/")[0]))) {
|
|
55
|
+
continue;
|
|
56
|
+
}
|
|
57
|
+
if (yield* missingPath(root, file, path)) {
|
|
58
|
+
findings.push({
|
|
59
|
+
file,
|
|
60
|
+
line,
|
|
61
|
+
message: `Repository path "${span}" does not resolve to an existing path inside the repository. Use its current path, relative to this document (./ or ../) or the repository root.`,
|
|
62
|
+
subject: span,
|
|
63
|
+
});
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
return findings;
|
|
68
|
+
});
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { posix } from "node:path";
|
|
2
|
+
import ts from "typescript";
|
|
3
|
+
import { serviceAssemblyImports } from "#adapters/serviceAssemblyImports.ts";
|
|
4
|
+
import { directServiceDefinitions, unwrapExpression } from "#adapters/serviceAssemblySyntax.ts";
|
|
5
|
+
import type { Finding, RuleInputs, SourceFile } from "#rule.ts";
|
|
6
|
+
import { parse } from "#rules/parse.ts";
|
|
7
|
+
|
|
8
|
+
function exported(statement: ts.Statement): boolean {
|
|
9
|
+
return ts.canHaveModifiers(statement) && (ts.getModifiers(statement)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword) ?? false);
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
function runtimeReexport(node: ts.Node): boolean {
|
|
13
|
+
if (!ts.isExportDeclaration(node) || node.isTypeOnly) {
|
|
14
|
+
return false;
|
|
15
|
+
}
|
|
16
|
+
const clause = node.exportClause;
|
|
17
|
+
return clause === undefined || !ts.isNamedExports(clause) || clause.elements.length === 0 || clause.elements.some((item) => !item.isTypeOnly);
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
function serviceShape(file: SourceFile): readonly Finding[] {
|
|
21
|
+
const source = parse(file);
|
|
22
|
+
if (source === undefined) {
|
|
23
|
+
return [];
|
|
24
|
+
}
|
|
25
|
+
const definitions = directServiceDefinitions(source, serviceAssemblyImports(source).definitions);
|
|
26
|
+
const runtime = source.statements.filter(
|
|
27
|
+
(candidate) => exported(candidate) && !ts.isInterfaceDeclaration(candidate) && !ts.isTypeAliasDeclaration(candidate),
|
|
28
|
+
);
|
|
29
|
+
const [statement] = runtime;
|
|
30
|
+
const declaration = statement !== undefined && ts.isVariableStatement(statement) ? statement.declarationList.declarations[0] : undefined;
|
|
31
|
+
const valid =
|
|
32
|
+
runtime.length === 1
|
|
33
|
+
&& definitions.length === 1
|
|
34
|
+
&& statement !== undefined
|
|
35
|
+
&& ts.isVariableStatement(statement)
|
|
36
|
+
&& (statement.declarationList.flags & ts.NodeFlags.Const) !== 0
|
|
37
|
+
&& statement.declarationList.declarations.length === 1
|
|
38
|
+
&& declaration?.initializer !== undefined
|
|
39
|
+
&& ts.isIdentifier(declaration.name)
|
|
40
|
+
&& definitions[0] === unwrapExpression(declaration.initializer)
|
|
41
|
+
&& !source.statements.some((node) => ts.isExportAssignment(node) || runtimeReexport(node));
|
|
42
|
+
return valid
|
|
43
|
+
? []
|
|
44
|
+
: [
|
|
45
|
+
{
|
|
46
|
+
file: file.path,
|
|
47
|
+
line: 1,
|
|
48
|
+
message:
|
|
49
|
+
"Export exactly one named const initialized by a direct defineService call from service.ts. Move other runtime exports to their own files; type exports may stay.",
|
|
50
|
+
},
|
|
51
|
+
];
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export function serviceFolderFindings({ files, sources }: RuleInputs): readonly Finding[] {
|
|
55
|
+
const folders = new Set(
|
|
56
|
+
files.flatMap((file) => {
|
|
57
|
+
const match = /^(?<folder>(?:.*\/)?services\/[^/]+)\//u.exec(file)?.groups?.folder;
|
|
58
|
+
return match === undefined ? [] : [match];
|
|
59
|
+
}),
|
|
60
|
+
);
|
|
61
|
+
const findings: Finding[] = [];
|
|
62
|
+
for (const folder of folders) {
|
|
63
|
+
const service = `${folder}/service.ts`;
|
|
64
|
+
if (!files.includes(service)) {
|
|
65
|
+
findings.push({
|
|
66
|
+
file: folder,
|
|
67
|
+
message: "Give this service folder a service.ts that exports its defineService declaration. Keep operations in focused sibling files.",
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
return [
|
|
72
|
+
...findings,
|
|
73
|
+
...sources.filter((file) => posix.basename(file.path) === "service.ts" && folders.has(posix.dirname(file.path))).flatMap(serviceShape),
|
|
74
|
+
];
|
|
75
|
+
}
|
package/src/inventory/walk.ts
CHANGED
|
@@ -79,7 +79,7 @@ const walkEntry = Effect.fnUntraced(function* (
|
|
|
79
79
|
tracked: ReadonlySet<string>,
|
|
80
80
|
): Effect.fn.Return<readonly string[], FilesystemFailure, FileSystem.FileSystem> {
|
|
81
81
|
const fs = yield* FileSystem.FileSystem;
|
|
82
|
-
const info = yield* orWhenAbsent<FileSystem.File.Info | undefined>(path, fs.stat(path), undefined);
|
|
82
|
+
const info = yield* orWhenAbsent<FileSystem.File.Info | undefined>(path, path.endsWith("/CLAUDE.md") ? fs.lstat(path) : fs.stat(path), undefined);
|
|
83
83
|
if (info === undefined) {
|
|
84
84
|
return [];
|
|
85
85
|
}
|