@simpleapps-com/augur-config 2.4.0 → 2026.11.1
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/EXPORTS.md +43 -44
- package/README.md +41 -29
- package/dist/augur-doctor.d.ts +13 -0
- package/dist/augur-doctor.d.ts.map +1 -0
- package/dist/augur-doctor.js +742 -0
- package/dist/augur-doctor.js.map +1 -0
- package/dist/chunk-RY3GDLDS.js +26 -0
- package/dist/chunk-RY3GDLDS.js.map +1 -0
- package/dist/chunk-ZV56KMH3.js +172 -0
- package/dist/chunk-ZV56KMH3.js.map +1 -0
- package/dist/doctor/checks.d.ts +34 -0
- package/dist/doctor/checks.d.ts.map +1 -0
- package/dist/doctor/cli.d.ts +11 -0
- package/dist/doctor/cli.d.ts.map +1 -0
- package/dist/doctor/node-reader.d.ts +7 -0
- package/dist/doctor/node-reader.d.ts.map +1 -0
- package/dist/doctor/report.d.ts +5 -0
- package/dist/doctor/report.d.ts.map +1 -0
- package/dist/doctor/rules.d.ts +227 -0
- package/dist/doctor/rules.d.ts.map +1 -0
- package/dist/eslint-next.d.ts +9 -0
- package/dist/eslint-next.d.ts.map +1 -0
- package/dist/eslint-next.js +35 -0
- package/dist/eslint-next.js.map +1 -0
- package/dist/eslint-shared.d.ts +36 -0
- package/dist/eslint-shared.d.ts.map +1 -0
- package/dist/eslint.d.ts +6 -0
- package/dist/eslint.d.ts.map +1 -0
- package/dist/eslint.js +30 -0
- package/dist/eslint.js.map +1 -0
- package/dist/lighthouse.d.ts +62 -0
- package/dist/lighthouse.d.ts.map +1 -0
- package/dist/lighthouse.js +68 -0
- package/dist/lighthouse.js.map +1 -0
- package/dist/prettier-next.d.ts +5 -0
- package/dist/prettier-next.d.ts.map +1 -0
- package/{src → dist}/prettier-next.js +9 -7
- package/dist/prettier-next.js.map +1 -0
- package/dist/prettier.d.ts +5 -0
- package/dist/prettier.d.ts.map +1 -0
- package/dist/prettier.js +17 -0
- package/dist/prettier.js.map +1 -0
- package/llms.txt +40 -20
- package/package.json +49 -12
- package/bin/augur-doctor.mjs +0 -1038
- package/src/eslint-next.js +0 -40
- package/src/eslint.js +0 -35
- package/src/lighthouse.js +0 -108
- package/src/prettier.js +0 -12
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/doctor/cli.ts","../src/doctor/checks.ts","../src/doctor/node-reader.ts","../src/doctor/report.ts","../src/augur-doctor.ts"],"sourcesContent":["/** augur-doctor's command line: `augur-doctor [site]` (the current directory by default). */\n\nimport { existsSync } from \"node:fs\";\nimport { basename, resolve } from \"node:path\";\nimport { runChecks, type SiteReader } from \"./checks\";\nimport { nodeReader } from \"./node-reader\";\nimport { reportLines } from \"./report\";\nimport { exitCodeOf } from \"./rules\";\n\n/** Where the CLI writes, and how it reads a site (the real file system by default). */\nexport interface CliIo {\n log: (line: string) => void;\n error: (line: string) => void;\n reader?: (siteDir: string) => SiteReader;\n}\n\nconst USAGE = [\n \"\",\n \"Usage: augur-doctor [/path/to/site]\",\n \"\",\n \"Run from a site directory, or pass the path as an argument.\",\n \"Examples:\",\n \" npx augur-doctor\",\n \" npx augur-doctor ./sites/example-site\",\n];\n\n/** Runs the doctor and returns its exit code: 1 for a missing site or any failing check. */\nexport function runDoctor(args: string[], io: CliIo): number {\n const siteDir = resolve(args[0] || \".\");\n if (!existsSync(siteDir)) {\n io.error(`Site directory not found: ${siteDir}`);\n return 1;\n }\n if (!existsSync(resolve(siteDir, \"package.json\"))) {\n io.error(`No package.json found in: ${siteDir}`);\n USAGE.forEach((line) => io.error(line));\n return 1;\n }\n const results = runChecks((io.reader ?? nodeReader)(siteDir));\n reportLines(basename(siteDir), siteDir, results).forEach((line) => io.log(line));\n return exitCodeOf(results.map((r) => r.status));\n}\n","/**\n * augur-doctor's checks: each reads facts from the site through a {@link SiteReader} and takes\n * its outcome from the proved rules (rules.ts). Labels and details are the original\n * bin/augur-doctor.mjs text, except the version checks (no lockstep, owner 2026-11-05).\n */\n\nimport {\n actionsStatus,\n apiVersionStatus,\n authStatus,\n contractTestsStatus,\n deprecatedStatus,\n fileUses,\n headersStatus,\n iconsStatus,\n imageLoaderStatus,\n ioredisStatus,\n knipStatus,\n latestStatus,\n localHooksStatus,\n nextExternalStatus,\n noOffenderStatus,\n noWrapperStatus,\n optimizeStatus,\n packageStateOf,\n preCommitStatus,\n presetStatus,\n qualityStatus,\n serverQueryStatus,\n siteHooksStatus,\n strictStatus,\n tailwindStatus,\n tsconfigStatus,\n type NextFacts,\n type PackageState,\n type Status,\n} from \"./rules\";\n\n/** What the checks may ask of a site. Paths are relative to the site directory. */\nexport interface SiteReader {\n /** Whether the path exists. */\n exists(relPath: string): boolean;\n /** The file's text, or null when it is missing. */\n read(relPath: string): string | null;\n /** The first of these names found walking up from the site to its git root: its path and text. */\n readUpward(names: string[]): { path: string; content: string } | null;\n /** The package's latest published version, or \"\" when npm cannot say. */\n latestVersion(packageName: string): string;\n}\n\n/** One line of the scorecard. */\nexport interface CheckResult {\n status: Status;\n id: string;\n label: string;\n detail: string;\n}\n\ntype Deps = Record<string, string | undefined>;\n\n/** The parts of a site's package.json the checks read. */\ninterface PackageJson {\n dependencies?: Deps;\n devDependencies?: Deps;\n scripts?: Record<string, string | undefined>;\n prettier?: unknown;\n \"lint-staged\"?: unknown;\n}\n\n/** Files where proxy pattern wiring commonly lives across different site layouts. */\nconst PROXY_FILES = [\n \"lib/augur-query.ts\",\n \"src/lib/augur-query.ts\",\n \"lib/augur.ts\",\n \"src/lib/augur.ts\",\n \"lib/augur-options.ts\",\n \"src/lib/augur-options.ts\",\n \"app/providers.tsx\",\n \"src/app/providers.tsx\",\n \"app/context/ReactQueryProvider.tsx\",\n \"src/app/context/ReactQueryProvider.tsx\",\n];\n\nconst PROXY_PATTERN = /createServerQueryProxy|queryAction|createAugurOptions|registerQueryAction/;\nconst MODULE_SCOPE_CLIENT = /^(?:export\\s+)?(?:const|let|var)\\s+\\w+\\s*=\\s*new QueryClient\\(/m;\n// Allowed: Infinity, resolveGcTime(...), 0 (fires next tick). Anything else is finite.\nconst FINITE_GC_TIME = /gcTime\\s*:\\s*(?!Infinity\\b|resolveGcTime\\(|0\\b)\\S/;\n\n/** The augur packages a site may install; each is checked against its own latest. */\nexport const AUGUR_PACKAGES = [\n \"@simpleapps-com/augur-config\",\n \"@simpleapps-com/augur-core\",\n \"@simpleapps-com/augur-hooks\",\n \"@simpleapps-com/augur-mobile\",\n \"@simpleapps-com/augur-server\",\n \"@simpleapps-com/augur-tailwind\",\n \"@simpleapps-com/augur-utils\",\n \"@simpleapps-com/augur-web\",\n];\n\n/** The migration runbook on augur.build, which the scorecard and the checks' details link to. */\nexport const RUNBOOK = \"https://augur.build/docs/packages/migration-runbook\";\nconst GETTING_STARTED = \"https://augur.build/docs/packages/getting-started\";\n\n/**\n * A check's result for a status, with a label (and detail) per status. Each check lists every\n * status its rule can return (rules.ts and its ensures), so the lookup always finds one.\n */\nfunction result(\n id: string,\n status: Status,\n labels: Partial<Record<Status, [string, string]>>,\n): CheckResult {\n const [label, detail] = labels[status]!;\n return { status, id, label, detail };\n}\n\n/** The reads every check shares. */\nclass Site {\n constructor(private readonly reader: SiteReader) {}\n\n find(...candidates: string[]): string | null {\n return candidates.find((c) => this.reader.exists(c)) ?? null;\n }\n\n read(relPath: string): string | null {\n return this.reader.read(relPath);\n }\n\n contains(relPath: string | null, pattern: string | RegExp): boolean {\n const content = relPath === null ? null : this.reader.read(relPath);\n if (!content) return false;\n return typeof pattern === \"string\" ? content.includes(pattern) : pattern.test(content);\n }\n\n json<T>(relPath: string): T | null {\n const content = this.reader.read(relPath);\n if (!content) return null;\n try {\n return JSON.parse(content) as T;\n } catch {\n return null;\n }\n }\n\n /** The proxy files that exist and match the pattern. */\n proxyFilesMatching(pattern: RegExp): string[] {\n return PROXY_FILES.filter((f) => this.contains(f, pattern));\n }\n}\n\nfunction siteConfig(site: Site): CheckResult {\n const file = site.find(\n \"lib/augur-config.ts\",\n \"src/lib/augur-config.ts\",\n \"config/augur-config.ts\",\n );\n return result(\"site-config\", fileUses(file !== null, site.contains(file, \"defineSite\")), {\n PASS: [\"augur-config.ts with defineSite()\", file ?? \"\"],\n WARN: [\"augur-config.ts exists but does not use defineSite()\", file ?? \"\"],\n FAIL: [\"augur-config.ts with defineSite()\", \"Expected lib/augur-config.ts\"],\n });\n}\n\nfunction serverSite(site: Site): CheckResult {\n const file = site.find(\"lib/augur-site.ts\", \"src/lib/augur-site.ts\", \"config/augur-site.ts\");\n return result(\"server-site\", fileUses(file !== null, site.contains(file, \"createServerSite\")), {\n PASS: [\"augur-site.ts using createServerSite()\", file ?? \"\"],\n WARN: [\"augur-site.ts exists but does not use createServerSite()\", file ?? \"\"],\n FAIL: [\"augur-site.ts using createServerSite()\", \"Expected lib/augur-site.ts\"],\n });\n}\n\nfunction actions(site: Site): CheckResult {\n const file = site.find(\"lib/augur-actions.ts\", \"src/lib/augur-actions.ts\", \"lib/actions.ts\");\n const reExports = site.contains(file, /site\\.actions|actions\\./);\n const usesProxy = site.proxyFilesMatching(PROXY_PATTERN).length > 0;\n const status = actionsStatus(file !== null, reExports, usesProxy);\n return result(\"actions\", status, {\n PASS: file\n ? [\"augur-actions.ts re-exporting site.actions\", file]\n : [\"Using proxy pattern (augur-actions.ts not needed)\", \"\"],\n WARN: [\"augur-actions.ts exists but may not re-export site.actions\", file ?? \"\"],\n FAIL: [\n \"augur-actions.ts re-exporting site.actions.*\",\n \"Expected lib/augur-actions.ts or createServerQueryProxy usage\",\n ],\n });\n}\n\nfunction siteHooks(site: Site): CheckResult {\n const file = site.find(\n \"lib/augur.ts\",\n \"src/lib/augur.ts\",\n \"lib/augur-hooks.ts\",\n \"src/lib/augur-hooks.ts\",\n );\n const createSiteHooks = site.contains(file, \"createSiteHooks\");\n const status = siteHooksStatus(\n file !== null,\n createSiteHooks,\n site.contains(file, /AugurHooksProvider|augur-hooks/),\n );\n return result(\"site-hooks\", status, {\n PASS: [\n createSiteHooks ? \"augur.ts with createSiteHooks()\" : \"augur.ts with hooks setup\",\n file ?? \"\",\n ],\n WARN: [\"augur.ts exists but does not use createSiteHooks()\", file ?? \"\"],\n FAIL: [\"augur.ts with createSiteHooks()\", \"Expected lib/augur.ts\"],\n });\n}\n\nfunction ssrOptions(site: Site): CheckResult {\n const file = site.find(\"lib/augur-options.ts\", \"src/lib/augur-options.ts\");\n return result(\"ssr-options\", fileUses(file !== null, site.contains(file, /Options/)), {\n PASS: [\"augur-options.ts for SSR prefetching\", file ?? \"\"],\n WARN: [\"augur-options.ts exists but may not export options\", file ?? \"\"],\n FAIL: [\"augur-options.ts for SSR prefetching\", \"Expected lib/augur-options.ts\"],\n });\n}\n\nfunction tsconfig(site: Site): CheckResult {\n const config = site.json<{ extends?: string }>(\"tsconfig.json\");\n const extendsVal = config?.extends || \"\";\n const status = tsconfigStatus(\n config !== null,\n extendsVal.includes(\"augur-config/tsconfig/next\"),\n extendsVal.includes(\"augur-config\"),\n );\n return result(\"tsconfig\", status, {\n PASS: [\"tsconfig.json extends augur-config/tsconfig/next\", \"\"],\n WARN: [\"tsconfig.json extends augur-config but not /tsconfig/next\", `extends: ${extendsVal}`],\n FAIL: config\n ? [\n \"tsconfig.json extends augur-config/tsconfig/next\",\n extendsVal ? `extends: ${extendsVal}` : \"No extends field\",\n ]\n : [\"tsconfig.json exists\", \"File not found\"],\n });\n}\n\nfunction eslintFailDetail(site: Site, file: string | null): [string, string] {\n if (file) {\n return [\n \"eslint.config.mjs uses augur-config/eslint/next\",\n \"Config exists but does not import augur-config/eslint\",\n ];\n }\n if (site.find(\".eslintrc.json\", \".eslintrc.js\", \".eslintrc\", \".eslintrc.cjs\")) {\n return [\n \"eslint.config.mjs uses augur-config/eslint/next\",\n \"Site uses legacy .eslintrc format -- migrate to eslint.config.mjs\",\n ];\n }\n return [\"eslint.config.mjs exists\", \"No ESLint config found\"];\n}\n\nfunction eslint(site: Site, file: string | null): CheckResult {\n return result(\"eslint\", presetStatus(file !== null, site.contains(file, \"augur-config/eslint\")), {\n PASS: [\"eslint.config.mjs uses augur-config/eslint/next\", file ?? \"\"],\n FAIL: eslintFailDetail(site, file),\n });\n}\n\nfunction eslintDeprecated(site: Site, file: string | null): CheckResult {\n const status = deprecatedStatus(\n file !== null,\n site.contains(file, /no-deprecated[\"']?\\s*:\\s*[\"'](error|warn)[\"']/),\n site.contains(file, \"no-deprecated\"),\n );\n return result(\"eslint-deprecated\", status, {\n SKIP: [\"ESLint: no-deprecated rule\", \"No ESLint config found\"],\n PASS: [\"ESLint: no-deprecated rule enabled\", \"\"],\n WARN: [\n \"ESLint: no-deprecated found but may not be warn/error\",\n \"Set @typescript-eslint/no-deprecated to warn or error\",\n ],\n FAIL: [\n \"ESLint: @typescript-eslint/no-deprecated rule\",\n 'Add \"@typescript-eslint/no-deprecated\": \"warn\" to eslint.config.mjs rules',\n ],\n });\n}\n\nfunction prettierFailDetail(\n site: Site,\n file: string | null,\n pkg: PackageJson | null,\n): [string, string] {\n const label = \"Prettier uses augur-config/prettier preset\";\n if (file) return [label, \"Config exists but does not import augur-config/prettier\"];\n if (pkg?.prettier) {\n return [label, \"Prettier config is inline in package.json -- move to prettier.config.mjs\"];\n }\n if (site.find(\".prettierrc\", \".prettierrc.json\", \".prettierrc.yaml\")) {\n return [\n label,\n \"Site uses static prettier config -- migrate to prettier.config.mjs with augur-config/prettier\",\n ];\n }\n return [\"Prettier config exists\", \"No Prettier config found\"];\n}\n\nfunction prettier(site: Site, pkg: PackageJson | null): CheckResult {\n const file = site.find(\n \"prettier.config.mjs\",\n \"prettier.config.js\",\n \".prettierrc.mjs\",\n \".prettierrc.js\",\n );\n return result(\n \"prettier\",\n presetStatus(file !== null, site.contains(file, \"augur-config/prettier\")),\n {\n PASS: [\"Prettier uses augur-config/prettier preset\", file ?? \"\"],\n FAIL: prettierFailDetail(site, file, pkg),\n },\n );\n}\n\nfunction knip(site: Site, pkg: PackageJson | null): CheckResult {\n const config = site.find(\n \"knip.json\",\n \"knip.jsonc\",\n \"knip.ts\",\n \"knip.config.ts\",\n \"knip.config.js\",\n );\n return result(\"knip\", knipStatus(config !== null, hasDep(pkg, \"knip\")), {\n PASS: [\"Knip configured for dead code detection\", config ?? \"\"],\n WARN: [\n \"Knip installed but no config file found\",\n \"Add knip.json or knip.ts -- see https://knip.dev/overview/configuration\",\n ],\n FAIL: config\n ? [\n \"Knip for dead code detection\",\n \"Config exists but knip not in devDependencies -- run pnpm add -D knip\",\n ]\n : [\n \"Knip for dead code detection\",\n \"Add knip to devDependencies and create knip.json -- see https://knip.dev\",\n ],\n });\n}\n\n/** Whether package.json lists the package in its dependencies or devDependencies. */\nfunction hasDep(pkg: PackageJson | null, name: string): boolean {\n return !!(pkg?.dependencies?.[name] || pkg?.devDependencies?.[name]);\n}\n\n/** The text holds every one of the strings. */\nfunction includesAll(text: string, parts: string[]): boolean {\n return parts.every((part) => text.includes(part));\n}\n\n/** What next.config (and package.json's ioredis) tell the Next.js checks. */\nfunction nextFacts(site: Site, pkg: PackageJson | null): NextFacts {\n const file = site.find(\"next.config.ts\", \"next.config.mjs\", \"next.config.js\");\n const text = (file === null ? null : site.read(file)) ?? \"\";\n return {\n hasConfig: file !== null,\n hasExternal: text.includes(\"serverExternalPackages\"),\n externalHasServer: text.includes(\"augur-server\"),\n usesIoredis: hasDep(pkg, \"ioredis\"),\n externalHasIoredis: text.includes(\"ioredis\"),\n hasAllHeaders: includesAll(text, [\n \"Strict-Transport-Security\",\n \"X-Content-Type-Options\",\n \"Permissions-Policy\",\n ]),\n hasHeaders: text.includes(\"headers\"),\n hasOptimize: text.includes(\"optimizePackageImports\"),\n hasStrict: text.includes(\"reactStrictMode\"),\n hasAgrMedia: /agr\\.media|agrMedia/.test(text),\n hasImages: text.includes(\"images\"),\n };\n}\n\nfunction nextExternal(n: NextFacts): CheckResult {\n return result(\"next-external\", nextExternalStatus(n), {\n PASS: [\"next.config: serverExternalPackages correct\", \"\"],\n WARN: [\n \"next.config: no serverExternalPackages found\",\n \"Add serverExternalPackages for native Node modules\",\n ],\n FAIL: n.hasConfig\n ? [\n \"next.config: augur-server NOT in serverExternalPackages\",\n \"augur-server must be bundled, not externalized\",\n ]\n : [\"next.config exists\", \"No next.config found\"],\n });\n}\n\nfunction ioredisSkipDetail(n: NextFacts): string {\n if (!n.hasConfig) return \"No next.config\";\n if (!n.hasExternal) return \"No serverExternalPackages\";\n return \"Site does not use ioredis\";\n}\n\nfunction nextIoredis(n: NextFacts): CheckResult {\n return result(\"next-ioredis\", ioredisStatus(n), {\n SKIP: [\"next.config: ioredis check\", ioredisSkipDetail(n)],\n PASS: [\"next.config: ioredis in serverExternalPackages\", \"\"],\n WARN: [\n \"next.config: ioredis should be in serverExternalPackages\",\n \"Site uses ioredis but it is not externalized\",\n ],\n });\n}\n\nfunction nextHeaders(n: NextFacts): CheckResult {\n return result(\"next-headers\", headersStatus(n), {\n PASS: [\"next.config: security headers\", \"\"],\n WARN: [\n \"next.config: security headers incomplete\",\n \"Missing HSTS, X-Content-Type-Options, or Permissions-Policy\",\n ],\n FAIL: [\n \"next.config: security headers\",\n n.hasConfig ? \"No headers() function found\" : \"No next.config\",\n ],\n });\n}\n\nfunction nextOptimize(n: NextFacts): CheckResult {\n return result(\"next-optimize\", optimizeStatus(n), {\n PASS: [\"next.config: optimizePackageImports\", \"\"],\n FAIL: [\n \"next.config: optimizePackageImports\",\n n.hasConfig ? \"Add experimental.optimizePackageImports for augur packages\" : \"No next.config\",\n ],\n });\n}\n\nfunction nextStrict(n: NextFacts): CheckResult {\n return result(\"next-strict\", strictStatus(n), {\n SKIP: [\"next.config: reactStrictMode\", \"No next.config\"],\n PASS: [\"next.config: reactStrictMode\", \"\"],\n WARN: [\"next.config: reactStrictMode not set\", \"Recommended for development error detection\"],\n });\n}\n\nfunction imageLoader(n: NextFacts): CheckResult {\n return result(\"image-loader\", imageLoaderStatus(n), {\n SKIP: [\"Image loader check\", \"No next.config\"],\n PASS: [\"Image loader for agr.media CDN\", \"\"],\n WARN: n.hasImages\n ? [\n \"next.config has images config but no agr.media\",\n \"Add agr.media to remotePatterns if site has product images\",\n ]\n : [\"No image configuration found\", \"Add agr.media CDN to next.config images.remotePatterns\"],\n });\n}\n\nfunction contractTests(site: Site): CheckResult {\n const present =\n site.find(\n \"__tests__/sdk-contracts\",\n \"src/__tests__/sdk-contracts\",\n \"__tests__/sdk-contract.test.ts\",\n \"src/__tests__/sdk-contract.test.ts\",\n ) !== null;\n return result(\"contract-tests\", contractTestsStatus(present), {\n PASS: [\"SDK contract tests present\", \"\"],\n FAIL: [\"SDK contract tests in __tests__/sdk-contracts/\", \"No contract tests found\"],\n });\n}\n\nfunction noWrapper(site: Site): CheckResult {\n const file = site.find(\n \"lib/augur-client.ts\",\n \"src/lib/augur-client.ts\",\n \"lib/augurClient.ts\",\n \"src/lib/augurClient.ts\",\n );\n const wraps = site.contains(file, \"class AugurClient\") || site.contains(file, \"extends AugurAPI\");\n const hasLib = site.find(\"lib\", \"src/lib\") !== null;\n return result(\"no-wrapper\", noWrapperStatus(hasLib, wraps), {\n SKIP: [\"No custom AugurClient wrapper\", \"No lib/ directory\"],\n PASS: [\"No custom AugurClient wrapper\", file ? \"Uses augur-api directly\" : \"\"],\n FAIL: [\"No custom AugurClient wrapper\", `${file} wraps AugurAPI -- use augur-api directly`],\n });\n}\n\nfunction auth(site: Site): CheckResult {\n const file = site.find(\"auth.ts\", \"lib/auth.ts\", \"src/lib/auth.ts\", \"src/auth.ts\");\n const usesFactory =\n site.contains(file, \"site.auth\") ||\n site.contains(file, \"createAuthConfig\") ||\n site.contains(file, \"createServerSite\");\n const status = authStatus(file !== null, usesFactory, site.contains(file, \"NextAuth\"));\n return result(\"auth\", status, {\n PASS: [\"Auth uses createAuthConfig or site.auth\", file ?? \"\"],\n FAIL: [\n \"Auth uses createAuthConfig or site.auth\",\n `${file} uses raw NextAuth -- migrate to createAuthConfig()`,\n ],\n WARN: file\n ? [\"Auth pattern unclear\", file]\n : [\"No auth.ts found\", \"Expected auth.ts or lib/auth.ts\"],\n });\n}\n\nfunction qualityScript(pkg: PackageJson | null): CheckResult {\n const quality = pkg?.scripts?.[\"quality\"];\n const complete =\n !!quality &&\n quality.includes(\"typecheck\") &&\n quality.includes(\"lint\") &&\n quality.includes(\"test\");\n return result(\"quality-script\", qualityStatus(!!quality, complete), {\n PASS: [\"quality script: typecheck + lint + test\", \"\"],\n WARN: [\"quality script exists but may be incomplete\", `\"quality\": \"${quality}\"`],\n FAIL: [\n \"quality script in package.json\",\n 'Add \"quality\": \"pnpm typecheck && pnpm lint && pnpm test\"',\n ],\n });\n}\n\nfunction allDeps(pkg: PackageJson): Deps {\n return { ...pkg.dependencies, ...pkg.devDependencies };\n}\n\nfunction icons(pkg: PackageJson): CheckResult {\n const deps = allDeps(pkg);\n const heroicons = !!deps[\"@heroicons/react\"];\n const status = iconsStatus(!!deps[\"react-icons\"], heroicons, !!deps[\"lucide-react\"]);\n return result(\"icons\", status, {\n PASS: [\"Uses react-icons (platform standard)\", \"\"],\n FAIL: [\n \"Uses react-icons (platform standard)\",\n heroicons\n ? \"Site uses @heroicons/react -- migrate to react-icons/lu\"\n : \"Site uses lucide-react -- migrate to react-icons/lu\",\n ],\n WARN: [\"No icon library found\", \"Expected react-icons\"],\n });\n}\n\nfunction tailwind(pkg: PackageJson): CheckResult {\n const range = allDeps(pkg)[\"tailwindcss\"] || \"\";\n return result(\"tailwind\", tailwindStatus(range), {\n PASS: [\"Tailwind v4 (platform standard)\", \"\"],\n FAIL: [\"Tailwind v4\", `Found tailwindcss: ${range} -- upgrade to ^4.0.0`],\n WARN: range\n ? [\"Tailwind version unclear\", `tailwindcss: ${range}`]\n : [\"No tailwindcss dependency found\", \"\"],\n });\n}\n\nfunction preCommitSuggestion(\n site: Site,\n lefthookFile: string | null,\n hasPreCommit: boolean,\n hasLefthook: boolean,\n): [string, string] {\n const see = `See ${RUNBOOK}#pre-commit-hooks`;\n if (hasPreCommit) return [\"Pre-commit hooks: lefthook found but no lint-staged config\", see];\n if (lefthookFile) return [\"Pre-commit hooks: lefthook found but no pre-commit section\", see];\n if (hasLefthook) {\n return [\n \"Pre-commit hooks: lefthook in devDependencies but no config file\",\n `Add lefthook.yml -- see ${RUNBOOK}#pre-commit-hooks`,\n ];\n }\n if (site.find(\".husky/pre-commit\", \".husky/_/pre-commit\")) {\n return [\"Pre-commit hooks: husky found -- consider switching to lefthook\", see];\n }\n return [\"No pre-commit hooks found -- recommended for code quality\", see];\n}\n\n/** The site's own lefthook config, else one in a parent folder (monorepo layouts). */\nfunction lefthookConfig(\n site: Site,\n reader: SiteReader,\n): { file: string | null; hasPreCommit: boolean } {\n const local = site.find(\"lefthook.yml\", \".lefthook.yml\");\n if (local) return { file: local, hasPreCommit: site.contains(local, \"pre-commit\") };\n const upward = reader.readUpward([\"lefthook.yml\", \".lefthook.yml\"]);\n if (upward === null) return { file: null, hasPreCommit: false };\n return { file: upward.path, hasPreCommit: upward.content.includes(\"pre-commit\") };\n}\n\nfunction hasLintStaged(site: Site, pkg: PackageJson | null): boolean {\n const files = [\n \".lintstagedrc\",\n \".lintstagedrc.json\",\n \"lint-staged.config.js\",\n \"lint-staged.config.mjs\",\n ];\n return !!pkg?.[\"lint-staged\"] || site.find(...files) !== null;\n}\n\nfunction preCommit(site: Site, reader: SiteReader, pkg: PackageJson | null): CheckResult {\n const { file: lefthookFile, hasPreCommit } = lefthookConfig(site, reader);\n const hasLefthook = lefthookFile !== null || hasDep(pkg, \"lefthook\");\n return result(\"pre-commit\", preCommitStatus(hasPreCommit, hasLintStaged(site, pkg)), {\n PASS: [\"Pre-commit hooks: lefthook + lint-staged\", lefthookFile ?? \"package.json\"],\n SUGGEST: preCommitSuggestion(site, lefthookFile, hasPreCommit, hasLefthook),\n });\n}\n\nfunction proxyLocalHooks(site: Site): CheckResult {\n const file = site.find(\"lib/augur.ts\", \"src/lib/augur.ts\", \"hooks/augur.ts\");\n const hasUseQuery = site.contains(file, /useQuery|useInfiniteQuery/);\n const wrapsActions = site.contains(file, /unwrap\\(|serverAction|augur-server\\/actions/);\n return result(\"proxy-local-hooks\", localHooksStatus(hasUseQuery), {\n PASS: [\"No local hook wrappers detected\", \"\"],\n SUGGEST: wrapsActions\n ? [\n \"Local hooks wrapping server actions -- replace with createServerQueryProxy\",\n `${file} -- see ${RUNBOOK}#proxy-migration`,\n ]\n : [\"Local hooks found -- check if createServerQueryProxy can replace them\", file ?? \"\"],\n });\n}\n\nfunction proxyServerQuery(site: Site): CheckResult {\n const serverProxy =\n site.proxyFilesMatching(/createServerQueryProxy|createAugurOptions/).length > 0;\n const augurOptions = site.proxyFilesMatching(/useAugurOptions|registerQueryAction/).length > 0;\n return result(\"proxy-server-query\", serverQueryStatus(serverProxy, augurOptions), {\n PASS: serverProxy\n ? [\"Uses createServerQueryProxy for data fetching\", \"\"]\n : [\"Uses useAugurOptions for data fetching\", \"\"],\n SUGGEST: [\n \"No proxy-based data fetching detected\",\n \"Consider createServerQueryProxy (augur-server/hooks) or useAugurOptions (augur-hooks)\",\n ],\n });\n}\n\nfunction queryClientScope(site: Site): CheckResult {\n const files = site.proxyFilesMatching(MODULE_SCOPE_CLIENT);\n return result(\"query-client-scope\", noOffenderStatus(files.length), {\n PASS: [\"No module-scope QueryClient\", \"\"],\n FAIL: [\n \"QueryClient created at module scope (shared across server requests)\",\n `${files.join(\", \")}: create it per request (see ${GETTING_STARTED}#provider-setup)`,\n ],\n });\n}\n\nfunction queryGcTime(site: Site): CheckResult {\n const files = site.proxyFilesMatching(FINITE_GC_TIME);\n return result(\"query-gc-time\", noOffenderStatus(files.length), {\n PASS: [\"No finite gcTime in provider/query setup\", \"\"],\n FAIL: [\n \"Finite gcTime in provider/query setup (leaks memory during SSR)\",\n `${files.join(\", \")}: remove it, or wrap with resolveGcTime() from augur-core`,\n ],\n });\n}\n\nfunction apiVersion(pkg: PackageJson): CheckResult {\n const range = allDeps(pkg)[\"@simpleapps-com/augur-api\"] || \"\";\n const match = /(\\d{4})\\.(\\d+)\\.(\\d+)/.exec(range);\n const status = apiVersionStatus(\n match !== null,\n Number(match?.[1]),\n Number(match?.[2]),\n Number(match?.[3]),\n );\n return result(\"api-version\", status, {\n PASS: [\"augur-api SDK version supports typed proxies\", range],\n WARN: match\n ? [\n \"augur-api SDK may lack typed proxy support\",\n `${range} -- upgrade to >= 2026.3.7 for typed responses`,\n ]\n : range\n ? [\"augur-api version format not recognized\", range]\n : [\"No augur-api dependency found\", \"\"],\n });\n}\n\n/** The short name of an augur package (`augur-core`). */\nfunction shortName(name: string): string {\n return name.replace(\"@simpleapps-com/\", \"\");\n}\n\n/** augur-version-latest: each installed augur package against its own latest (no lockstep). */\nfunction augurVersionLatest(reader: SiteReader, pkg: PackageJson | null): CheckResult {\n const deps = pkg ? allDeps(pkg) : {};\n const installed = AUGUR_PACKAGES.filter((name) => deps[name]);\n const latest = installed.map((name) => reader.latestVersion(name));\n const states: PackageState[] = installed.map((name, k) =>\n packageStateOf(deps[name] as string, latest[k] as string),\n );\n const behind = installed.filter((_, k) => states[k] === \"behind\");\n return result(\"augur-version-latest\", latestStatus(states), {\n SKIP: installed.length\n ? [\n \"Augur latest version check\",\n \"Could not fetch latest version from npm (offline or not published)\",\n ]\n : [\"Augur latest version check\", pkg ? \"No augur packages found\" : \"No package.json\"],\n PASS: [\n \"Augur packages on their latest versions\",\n installed.map((name, k) => `${shortName(name)}: ${latest[k]}`).join(\", \"),\n ],\n FAIL: [\n \"Augur packages should be on their latest versions\",\n `${behind\n .map(\n (name) =>\n `${shortName(name)}: installed ${deps[name]}, latest ${latest[installed.indexOf(name)]}`,\n )\n .join(\", \")} -- set the latest in package.json, then run pnpm install (not pnpm update)`,\n ],\n });\n}\n\n/** Every check, in the original order; the package.json checks only when there is one. */\nexport function runChecks(reader: SiteReader): CheckResult[] {\n const site = new Site(reader);\n const pkg = site.json<PackageJson>(\"package.json\");\n const eslintFile = site.find(\"eslint.config.mjs\", \"eslint.config.js\");\n const next = nextFacts(site, pkg);\n return [\n siteConfig(site),\n serverSite(site),\n actions(site),\n siteHooks(site),\n ssrOptions(site),\n tsconfig(site),\n eslint(site, eslintFile),\n eslintDeprecated(site, eslintFile),\n prettier(site, pkg),\n knip(site, pkg),\n nextExternal(next),\n nextIoredis(next),\n nextHeaders(next),\n nextOptimize(next),\n nextStrict(next),\n contractTests(site),\n noWrapper(site),\n auth(site),\n imageLoader(next),\n qualityScript(pkg),\n ...(pkg ? [icons(pkg), tailwind(pkg)] : []),\n preCommit(site, reader, pkg),\n proxyLocalHooks(site),\n proxyServerQuery(site),\n queryClientScope(site),\n queryGcTime(site),\n ...(pkg ? [apiVersion(pkg)] : []),\n augurVersionLatest(reader, pkg),\n ];\n}\n","/** The {@link SiteReader} over the real file system and npm. */\n\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport type { SiteReader } from \"./checks\";\n\n/** The first of `names` found walking up from `start`, stopping at a git repo root. */\nfunction findUpward(start: string, names: string[]): string | null {\n let dir = start;\n const root = resolve(\"/\");\n while (dir !== root) {\n const hit = names.map((name) => resolve(dir, name)).find((path) => existsSync(path));\n if (hit) return hit;\n if (existsSync(resolve(dir, \".git\"))) break;\n dir = dirname(dir);\n }\n return null;\n}\n\n/** A package's latest published version from `npm view`, or \"\" when npm cannot say. */\nfunction npmLatest(packageName: string): string {\n try {\n return execFileSync(\"npm\", [\"view\", packageName, \"version\"], {\n encoding: \"utf-8\",\n stdio: [\"ignore\", \"pipe\", \"ignore\"],\n }).trim();\n } catch {\n return \"\";\n }\n}\n\nexport function nodeReader(siteDir: string, latestVersion = npmLatest): SiteReader {\n const read = (path: string) => (existsSync(path) ? readFileSync(path, \"utf-8\") : null);\n return {\n exists: (relPath) => existsSync(resolve(siteDir, relPath)),\n read: (relPath) => read(resolve(siteDir, relPath)),\n readUpward: (names) => {\n const path = findUpward(siteDir, names);\n return path === null ? null : { path, content: readFileSync(path, \"utf-8\") };\n },\n latestVersion,\n };\n}\n","/** augur-doctor's scorecard: the check results as terminal lines, grouped as before. */\n\nimport { RUNBOOK, type CheckResult } from \"./checks\";\nimport { countStatusFrom, scoredTotal, type Status } from \"./rules\";\n\nconst ICONS: Record<Status, string> = {\n PASS: \"\\x1b[32m[PASS]\\x1b[0m\",\n FAIL: \"\\x1b[31m[FAIL]\\x1b[0m\",\n WARN: \"\\x1b[33m[WARN]\\x1b[0m\",\n SUGGEST: \"\\x1b[36m[SUGGEST]\\x1b[0m\",\n SKIP: \"\\x1b[90m[SKIP]\\x1b[0m\",\n};\n\n/** The scorecard's groups, in order (no lockstep: the one-version check is gone). */\nconst GROUPS: [string, string[]][] = [\n [\"Site Architecture\", [\"site-config\", \"server-site\", \"actions\", \"site-hooks\", \"ssr-options\"]],\n [\n \"Config Alignment\",\n [\"tsconfig\", \"eslint\", \"eslint-deprecated\", \"prettier\", \"knip\", \"tailwind\", \"icons\"],\n ],\n [\n \"Next.js Config\",\n [\"next-external\", \"next-ioredis\", \"next-headers\", \"next-optimize\", \"next-strict\"],\n ],\n [\"Testing & Quality\", [\"contract-tests\", \"quality-script\", \"pre-commit\"]],\n [\n \"Proxy Adoption\",\n [\n \"proxy-local-hooks\",\n \"proxy-server-query\",\n \"query-client-scope\",\n \"query-gc-time\",\n \"api-version\",\n ],\n ],\n [\"Package Versions\", [\"augur-version-latest\"]],\n [\"Patterns\", [\"no-wrapper\", \"auth\", \"image-loader\"]],\n];\n\n/** A group's lines: its heading, each of its results, a blank line. */\nfunction groupLines(name: string, ids: string[], results: CheckResult[]): string[] {\n const lines = ids.flatMap((id) => {\n const r = results.find((x) => x.id === id);\n if (!r) return [];\n const detail = r.detail ? ` \\x1b[90m${r.detail}\\x1b[0m` : \"\";\n return [` ${ICONS[r.status]} ${r.label}${detail}`];\n });\n return [`\\x1b[1m${name}\\x1b[0m`, ...lines, \"\"];\n}\n\n/** The score line: passing out of the scored total, then the failing, warning, suggestion counts. */\nfunction scoreLine(statuses: Status[]): string {\n const count = (s: Status) => countStatusFrom(statuses, s, 0);\n const failing = count(\"FAIL\");\n const warnings = count(\"WARN\");\n const suggestions = count(\"SUGGEST\");\n return (\n `\\x1b[1mScore: ${count(\"PASS\")}/${scoredTotal(statuses)}\\x1b[0m` +\n (failing > 0 ? ` \\x1b[31m(${failing} failing)\\x1b[0m` : \"\") +\n (warnings > 0 ? ` \\x1b[33m(${warnings} warnings)\\x1b[0m` : \"\") +\n (suggestions > 0 ? ` \\x1b[36m(${suggestions} suggestions)\\x1b[0m` : \"\")\n );\n}\n\n/** The whole scorecard for a site. */\nexport function reportLines(siteName: string, siteDir: string, results: CheckResult[]): string[] {\n const statuses = results.map((r) => r.status);\n const runbook =\n countStatusFrom(statuses, \"FAIL\", 0) > 0\n ? [\"See the migration runbook for fixes:\", RUNBOOK, \"\"]\n : [];\n return [\n \"\",\n `\\x1b[1mAugur Doctor: ${siteName}\\x1b[0m`,\n `Path: ${siteDir}`,\n \"\",\n ...GROUPS.flatMap(([name, ids]) => groupLines(name, ids, results)),\n scoreLine(statuses),\n \"\",\n ...runbook,\n ];\n}\n","#!/usr/bin/env node\n/**\n * augur-doctor -- Site health check against the Augur platform standard.\n *\n * Usage:\n * npx augur-doctor (runs against current directory)\n * npx augur-doctor /path/to/site\n *\n * Checks a consumer site for alignment with the reference implementation and prints a\n * pass/fail/warn scorecard.\n */\n\nimport { runDoctor } from \"./doctor/cli\";\n\nprocess.exit(\n runDoctor(process.argv.slice(2), {\n log: (line) => console.log(line),\n error: (line) => console.error(line),\n }),\n);\n"],"mappings":"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","names":["existsSync","resolve","resolve","existsSync"]}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
// src/eslint-shared.ts
|
|
2
|
+
import tsParser from "@typescript-eslint/parser";
|
|
3
|
+
var languageOptions = {
|
|
4
|
+
parser: tsParser,
|
|
5
|
+
parserOptions: {
|
|
6
|
+
ecmaFeatures: { jsx: true }
|
|
7
|
+
}
|
|
8
|
+
};
|
|
9
|
+
var sharedRules = {
|
|
10
|
+
"@typescript-eslint/no-unused-vars": [
|
|
11
|
+
"error",
|
|
12
|
+
{ argsIgnorePattern: "^_", varsIgnorePattern: "^_" }
|
|
13
|
+
],
|
|
14
|
+
"@typescript-eslint/no-explicit-any": "warn",
|
|
15
|
+
complexity: ["warn", 15],
|
|
16
|
+
"max-depth": ["warn", 4],
|
|
17
|
+
"max-nested-callbacks": ["warn", 3]
|
|
18
|
+
};
|
|
19
|
+
var ignored = { ignores: ["dist/", "node_modules/", ".turbo/", ".next/"] };
|
|
20
|
+
|
|
21
|
+
export {
|
|
22
|
+
languageOptions,
|
|
23
|
+
sharedRules,
|
|
24
|
+
ignored
|
|
25
|
+
};
|
|
26
|
+
//# sourceMappingURL=chunk-RY3GDLDS.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/eslint-shared.ts"],"sourcesContent":["import tsParser from \"@typescript-eslint/parser\";\n\n/**\n * A flat-config entry as these presets build it. Typed by its own shape, not ESLint's\n * `Linter.Config`: the presets serve the consumer's ESLint (peer `^9`), and the plugins'\n * declarations are written for that version, so the consumer's ESLint is what checks it.\n */\nexport interface PresetConfig {\n files?: string[];\n ignores?: string[];\n languageOptions?: Record<string, unknown>;\n plugins?: Record<string, unknown>;\n rules?: Record<string, unknown>;\n}\n\n/** The TypeScript parser with JSX, for both presets. */\nexport const languageOptions = {\n parser: tsParser,\n parserOptions: {\n ecmaFeatures: { jsx: true },\n },\n};\n\n/** The rules both presets set after the plugins' recommended ones. */\nexport const sharedRules = {\n \"@typescript-eslint/no-unused-vars\": [\n \"error\",\n { argsIgnorePattern: \"^_\", varsIgnorePattern: \"^_\" },\n ],\n \"@typescript-eslint/no-explicit-any\": \"warn\",\n complexity: [\"warn\", 15],\n \"max-depth\": [\"warn\", 4],\n \"max-nested-callbacks\": [\"warn\", 3],\n};\n\n/** The folders both presets leave alone. */\nexport const ignored: PresetConfig = { ignores: [\"dist/\", \"node_modules/\", \".turbo/\", \".next/\"] };\n"],"mappings":";AAAA,OAAO,cAAc;AAgBd,IAAM,kBAAkB;AAAA,EAC7B,QAAQ;AAAA,EACR,eAAe;AAAA,IACb,cAAc,EAAE,KAAK,KAAK;AAAA,EAC5B;AACF;AAGO,IAAM,cAAc;AAAA,EACzB,qCAAqC;AAAA,IACnC;AAAA,IACA,EAAE,mBAAmB,MAAM,mBAAmB,KAAK;AAAA,EACrD;AAAA,EACA,sCAAsC;AAAA,EACtC,YAAY,CAAC,QAAQ,EAAE;AAAA,EACvB,aAAa,CAAC,QAAQ,CAAC;AAAA,EACvB,wBAAwB,CAAC,QAAQ,CAAC;AACpC;AAGO,IAAM,UAAwB,EAAE,SAAS,CAAC,SAAS,iBAAiB,WAAW,QAAQ,EAAE;","names":[]}
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
// ../utils/src/strings.ts
|
|
2
|
+
function codeAt(s, i) {
|
|
3
|
+
return i >= 0 && i < s.length ? s.charCodeAt(i) : -1;
|
|
4
|
+
}
|
|
5
|
+
function startsWithAt(s, x, pos) {
|
|
6
|
+
const at = Math.min(pos, s.length);
|
|
7
|
+
return s.slice(at, Math.min(at + x.length, s.length)) === x;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
// src/doctor/rules.ts
|
|
11
|
+
function fileUses(found, uses) {
|
|
12
|
+
if (found && uses) return "PASS";
|
|
13
|
+
return found ? "WARN" : "FAIL";
|
|
14
|
+
}
|
|
15
|
+
function actionsStatus(found, reExports, usesProxy) {
|
|
16
|
+
if (found) return reExports ? "PASS" : "WARN";
|
|
17
|
+
return usesProxy ? "PASS" : "FAIL";
|
|
18
|
+
}
|
|
19
|
+
function siteHooksStatus(found, createSiteHooks, hooksSetup) {
|
|
20
|
+
return fileUses(found, createSiteHooks || hooksSetup);
|
|
21
|
+
}
|
|
22
|
+
function tsconfigStatus(found, extendsNext, extendsAugur) {
|
|
23
|
+
if (!found) return "FAIL";
|
|
24
|
+
if (extendsNext) return "PASS";
|
|
25
|
+
return extendsAugur ? "WARN" : "FAIL";
|
|
26
|
+
}
|
|
27
|
+
function presetStatus(found, usesPreset) {
|
|
28
|
+
return found && usesPreset ? "PASS" : "FAIL";
|
|
29
|
+
}
|
|
30
|
+
function deprecatedStatus(hasEslint, ruleOn, named) {
|
|
31
|
+
if (!hasEslint) return "SKIP";
|
|
32
|
+
if (ruleOn) return "PASS";
|
|
33
|
+
return named ? "WARN" : "FAIL";
|
|
34
|
+
}
|
|
35
|
+
function knipStatus(hasConfig, hasDep) {
|
|
36
|
+
if (!hasDep) return "FAIL";
|
|
37
|
+
return hasConfig ? "PASS" : "WARN";
|
|
38
|
+
}
|
|
39
|
+
function iconsStatus(reactIcons, heroicons, lucide) {
|
|
40
|
+
if (heroicons || lucide) return "FAIL";
|
|
41
|
+
return reactIcons ? "PASS" : "WARN";
|
|
42
|
+
}
|
|
43
|
+
function tailwindStatus(range) {
|
|
44
|
+
if (startsWithAt(range, "^4", 0) || startsWithAt(range, "4", 0)) return "PASS";
|
|
45
|
+
if (startsWithAt(range, "^3", 0) || startsWithAt(range, "3", 0)) return "FAIL";
|
|
46
|
+
return "WARN";
|
|
47
|
+
}
|
|
48
|
+
function nextExternalStatus(n) {
|
|
49
|
+
if (!n.hasConfig) return "FAIL";
|
|
50
|
+
if (n.hasExternal) return n.externalHasServer ? "FAIL" : "PASS";
|
|
51
|
+
return "WARN";
|
|
52
|
+
}
|
|
53
|
+
function ioredisStatus(n) {
|
|
54
|
+
if (!n.hasConfig || !n.hasExternal || !n.usesIoredis) return "SKIP";
|
|
55
|
+
return n.externalHasIoredis ? "PASS" : "WARN";
|
|
56
|
+
}
|
|
57
|
+
function headersStatus(n) {
|
|
58
|
+
if (!n.hasConfig) return "FAIL";
|
|
59
|
+
if (n.hasAllHeaders) return "PASS";
|
|
60
|
+
return n.hasHeaders ? "WARN" : "FAIL";
|
|
61
|
+
}
|
|
62
|
+
function optimizeStatus(n) {
|
|
63
|
+
return n.hasConfig && n.hasOptimize ? "PASS" : "FAIL";
|
|
64
|
+
}
|
|
65
|
+
function strictStatus(n) {
|
|
66
|
+
if (!n.hasConfig) return "SKIP";
|
|
67
|
+
return n.hasStrict ? "PASS" : "WARN";
|
|
68
|
+
}
|
|
69
|
+
function imageLoaderStatus(n) {
|
|
70
|
+
if (!n.hasConfig) return "SKIP";
|
|
71
|
+
return n.hasAgrMedia ? "PASS" : "WARN";
|
|
72
|
+
}
|
|
73
|
+
function contractTestsStatus(present) {
|
|
74
|
+
return present ? "PASS" : "FAIL";
|
|
75
|
+
}
|
|
76
|
+
function noWrapperStatus(hasLib, wraps) {
|
|
77
|
+
if (!hasLib) return "SKIP";
|
|
78
|
+
return wraps ? "FAIL" : "PASS";
|
|
79
|
+
}
|
|
80
|
+
function authStatus(found, usesFactory, rawNextAuth) {
|
|
81
|
+
if (found && usesFactory) return "PASS";
|
|
82
|
+
return found && rawNextAuth ? "FAIL" : "WARN";
|
|
83
|
+
}
|
|
84
|
+
function qualityStatus(hasScript, complete) {
|
|
85
|
+
if (!hasScript) return "FAIL";
|
|
86
|
+
return complete ? "PASS" : "WARN";
|
|
87
|
+
}
|
|
88
|
+
function preCommitStatus(hasPreCommit, hasLintStaged) {
|
|
89
|
+
return hasPreCommit && hasLintStaged ? "PASS" : "SUGGEST";
|
|
90
|
+
}
|
|
91
|
+
function localHooksStatus(hasUseQuery) {
|
|
92
|
+
return hasUseQuery ? "SUGGEST" : "PASS";
|
|
93
|
+
}
|
|
94
|
+
function serverQueryStatus(usesServerProxy, usesAugurOptions) {
|
|
95
|
+
return usesServerProxy || usesAugurOptions ? "PASS" : "SUGGEST";
|
|
96
|
+
}
|
|
97
|
+
function noOffenderStatus(offenders) {
|
|
98
|
+
return offenders > 0 ? "FAIL" : "PASS";
|
|
99
|
+
}
|
|
100
|
+
function typedProxyVersion(year, minor, patch) {
|
|
101
|
+
return year > 2026 || year === 2026 && minor > 3 || year === 2026 && minor === 3 && patch >= 7;
|
|
102
|
+
}
|
|
103
|
+
function apiVersionStatus(parsed, year, minor, patch) {
|
|
104
|
+
return parsed && typedProxyVersion(year, minor, patch) ? "PASS" : "WARN";
|
|
105
|
+
}
|
|
106
|
+
function rangeMark(c) {
|
|
107
|
+
return c === 94 || c === 126 || c === 62 || c === 61 || c === 60 || c === 32 || c === 9 || c === 10 || c === 13;
|
|
108
|
+
}
|
|
109
|
+
function stripRange(s) {
|
|
110
|
+
if (!rangeMark(codeAt(s, 0))) return s;
|
|
111
|
+
return stripRange(s.slice(1));
|
|
112
|
+
}
|
|
113
|
+
function packageStateOf(range, latest) {
|
|
114
|
+
if (latest === "") return "unknown";
|
|
115
|
+
return stripRange(range) === latest ? "current" : "behind";
|
|
116
|
+
}
|
|
117
|
+
function countStateFrom(states, s, i) {
|
|
118
|
+
if (i >= states.length) return 0;
|
|
119
|
+
return (states[i] === s ? 1 : 0) + countStateFrom(states, s, i + 1);
|
|
120
|
+
}
|
|
121
|
+
function latestStatus(states) {
|
|
122
|
+
if (states.length === 0) return "SKIP";
|
|
123
|
+
if (countStateFrom(states, "behind", 0) > 0) return "FAIL";
|
|
124
|
+
return countStateFrom(states, "unknown", 0) > 0 ? "SKIP" : "PASS";
|
|
125
|
+
}
|
|
126
|
+
function countStatusFrom(results, s, i) {
|
|
127
|
+
if (i >= results.length) return 0;
|
|
128
|
+
return (results[i] === s ? 1 : 0) + countStatusFrom(results, s, i + 1);
|
|
129
|
+
}
|
|
130
|
+
function scoredTotal(results) {
|
|
131
|
+
return results.length - countStatusFrom(results, "SKIP", 0) - countStatusFrom(results, "SUGGEST", 0);
|
|
132
|
+
}
|
|
133
|
+
function exitCodeOf(results) {
|
|
134
|
+
return countStatusFrom(results, "FAIL", 0) > 0 ? 1 : 0;
|
|
135
|
+
}
|
|
136
|
+
function resolveUrl(u, baseUrl) {
|
|
137
|
+
return startsWithAt(u, "http", 0) ? u : baseUrl + u;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
export {
|
|
141
|
+
fileUses,
|
|
142
|
+
actionsStatus,
|
|
143
|
+
siteHooksStatus,
|
|
144
|
+
tsconfigStatus,
|
|
145
|
+
presetStatus,
|
|
146
|
+
deprecatedStatus,
|
|
147
|
+
knipStatus,
|
|
148
|
+
iconsStatus,
|
|
149
|
+
tailwindStatus,
|
|
150
|
+
nextExternalStatus,
|
|
151
|
+
ioredisStatus,
|
|
152
|
+
headersStatus,
|
|
153
|
+
optimizeStatus,
|
|
154
|
+
strictStatus,
|
|
155
|
+
imageLoaderStatus,
|
|
156
|
+
contractTestsStatus,
|
|
157
|
+
noWrapperStatus,
|
|
158
|
+
authStatus,
|
|
159
|
+
qualityStatus,
|
|
160
|
+
preCommitStatus,
|
|
161
|
+
localHooksStatus,
|
|
162
|
+
serverQueryStatus,
|
|
163
|
+
noOffenderStatus,
|
|
164
|
+
apiVersionStatus,
|
|
165
|
+
packageStateOf,
|
|
166
|
+
latestStatus,
|
|
167
|
+
countStatusFrom,
|
|
168
|
+
scoredTotal,
|
|
169
|
+
exitCodeOf,
|
|
170
|
+
resolveUrl
|
|
171
|
+
};
|
|
172
|
+
//# sourceMappingURL=chunk-ZV56KMH3.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../utils/src/strings.ts","../src/doctor/rules.ts"],"sourcesContent":["//@ backend dafny\nimport {\n isAlnumChar,\n isBase64UrlChar,\n isDigit,\n isHexChar,\n isJsSpace,\n isLineTerminator,\n isLowerHexChar,\n isSnakeChar,\n isWordChar,\n lowerCode,\n} from \"./chars\";\n\n/* String scans and slices, verified with LemmaScript → Dafny (hand lemmas in strings.dfy;\n model: models/Utils.dfy; link: models/links/utils-strings.dfy). Recursive and\n expression-bodied so specs can use them, and each contract pins the result exactly, so\n an importer (which sees only the contract) knows what it returns. Two of them stand in\n for constructs lsc mistranslates: `prefix` for an unclamped `slice`, and the code-unit\n scans for \"\\r\" / \"\\n\" literals. */\n\n/**\n * The code unit at `i`, or -1 when `i` is outside `s`. JS `charCodeAt` gives NaN there,\n * which no code equals, so a scan's own bounds test would change no result and no test\n * could tell it from none (an equivalent mutant); with the bound here once, the boundary is\n * observable (tests pin -1) and the scans that use it carry no bound of their own. A code\n * unit is never negative, so -1 matches no `code` a caller passes (`requires code >= 0`).\n *\n * @ensures 0 ≤ i < |s| ⟹ result = s[i]; otherwise result = -1\n */\nexport function codeAt(s: string, i: number): number {\n //@ verify\n //@ ensures (i >= 0 && i < s.length) ==> \\result === s.charCodeAt(i)\n //@ ensures !(i >= 0 && i < s.length) ==> \\result === -1\n return i >= 0 && i < s.length ? s.charCodeAt(i) : -1;\n}\n\n/**\n * Every character of `s` from index `i` on is base64url.\n *\n * @ensures result ⟺ ∀ k ∈ [i, |s|). isBase64UrlChar(s[k])\n */\nexport function base64UrlFrom(s: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ decreases s.length - i\n //@ ensures \\result <==> forall(k: nat, (i <= k && k < s.length) ==> isBase64UrlChar(s.charCodeAt(k)))\n return i >= s.length || (isBase64UrlChar(s.charCodeAt(i)) && base64UrlFrom(s, i + 1));\n}\n\n/**\n * The base64url digit for `v` (RFC 4648 §5): A-Z a-z 0-9 - _.\n *\n * @ensures exactly the model's Base64UrlDigit\n */\nexport function base64UrlDigit(v: number): string {\n //@ verify\n //@ type v nat\n //@ requires v >= 0 && v < 64\n //@ ensures \\result === \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_\".slice(v, v + 1)\n return \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_\".slice(v, v + 1);\n}\n\n/**\n * Bytes from `i` on as unpadded base64url: each three as four digits, a last one or two as two or\n * three (JS `btoa` with `+/` as `-_` and the `=` dropped). One frame per three bytes: a JWT part\n * is a few hundred.\n *\n * @ensures exactly the model's Base64UrlFrom (links/utils-strings.dfy)\n */\nexport function encodeBase64UrlFrom(b: number[], i: number): string {\n //@ verify\n //@ type i nat\n //@ requires i >= 0 && forall(k: nat, k < b.length ==> (b[k] >= 0 && b[k] < 256))\n //@ decreases b.length - i\n //@ ensures i >= b.length ==> \\result === \"\"\n if (i >= b.length) return \"\";\n const x = b[i] as number;\n const first = base64UrlDigit(Math.floor(x / 4));\n if (i + 1 === b.length) return first + base64UrlDigit((x % 4) * 16);\n const y = b[i + 1] as number;\n const second = base64UrlDigit((x % 4) * 16 + Math.floor(y / 16));\n if (i + 2 === b.length) return first + second + base64UrlDigit((y % 16) * 4);\n const z = b[i + 2] as number;\n return (\n first +\n second +\n base64UrlDigit((y % 16) * 4 + Math.floor(z / 64)) +\n base64UrlDigit(z % 64) +\n encodeBase64UrlFrom(b, i + 3)\n );\n}\n\n/**\n * Every character of `s` from index `i` on is lowercase hex.\n *\n * @ensures result ⟺ ∀ k ∈ [i, |s|). isLowerHexChar(s[k])\n */\nexport function lowerHexFrom(s: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ decreases s.length - i\n //@ ensures \\result <==> forall(k: nat, (i <= k && k < s.length) ==> isLowerHexChar(s.charCodeAt(k)))\n return i >= s.length || (isLowerHexChar(s.charCodeAt(i)) && lowerHexFrom(s, i + 1));\n}\n\n/**\n * Every character of `s` from index `i` on is hex, either case.\n *\n * @ensures result ⟺ ∀ k ∈ [i, |s|). isHexChar(s[k])\n */\nexport function hexFrom(s: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ decreases s.length - i\n //@ ensures \\result <==> forall(k: nat, (i <= k && k < s.length) ==> isHexChar(s.charCodeAt(k)))\n return i >= s.length || (isHexChar(s.charCodeAt(i)) && hexFrom(s, i + 1));\n}\n\n/**\n * Every character of `s` from index `i` on is an ASCII digit (`\\d` without the `u` flag).\n *\n * @ensures result ⟺ ∀ k ∈ [i, |s|). isDigit(s[k])\n */\nexport function digitsFrom(s: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ decreases s.length - i\n //@ ensures \\result <==> forall(k: nat, (i <= k && k < s.length) ==> isDigit(s.charCodeAt(k)))\n return i >= s.length || (isDigit(s.charCodeAt(i)) && digitsFrom(s, i + 1));\n}\n\n/**\n * Every character of `s` from index `i` on is a word character (`\\w`: `[A-Za-z0-9_]`).\n *\n * @ensures result ⟺ ∀ k ∈ [i, |s|). isWordChar(s[k])\n */\nexport function wordCharsFrom(s: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ decreases s.length - i\n //@ ensures \\result <==> forall(k: nat, (i <= k && k < s.length) ==> isWordChar(s.charCodeAt(k)))\n return i >= s.length || (isWordChar(s.charCodeAt(i)) && wordCharsFrom(s, i + 1));\n}\n\n/**\n * Every character of `s` from index `i` on is a snake_case character (`[a-z0-9_]`).\n *\n * @ensures result ⟺ ∀ k ∈ [i, |s|). isSnakeChar(s[k])\n */\nexport function snakeCharsFrom(s: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ decreases s.length - i\n //@ ensures \\result <==> forall(k: nat, (i <= k && k < s.length) ==> isSnakeChar(s.charCodeAt(k)))\n return i >= s.length || (isSnakeChar(s.charCodeAt(i)) && snakeCharsFrom(s, i + 1));\n}\n\n/**\n * Every character of `s` from index `i` on is an ASCII letter or digit (`[A-Za-z0-9]`).\n *\n * @ensures result ⟺ ∀ k ∈ [i, |s|). isAlnumChar(s[k])\n */\nexport function alnumFrom(s: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ decreases s.length - i\n //@ ensures \\result <==> forall(k: nat, (i <= k && k < s.length) ==> isAlnumChar(s.charCodeAt(k)))\n return i >= s.length || (isAlnumChar(s.charCodeAt(i)) && alnumFrom(s, i + 1));\n}\n\n/**\n * Every character of `s` from index `i` on is an ASCII letter, digit or `-` (`[A-Za-z0-9-]`):\n * a domain label's tail, a service name's tail.\n *\n * @ensures result ⟺ ∀ k ∈ [i, |s|). isAlnumChar(s[k]) ∨ s[k] = \"-\" — the model's AlnumDashFrom\n */\nexport function alnumDashFrom(s: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ decreases s.length - i\n //@ ensures \\result <==> forall(k: nat, (i <= k && k < s.length) ==> (isAlnumChar(s.charCodeAt(k)) || s.charCodeAt(k) === 45))\n if (i >= s.length) return true;\n const c = s.charCodeAt(i);\n return (isAlnumChar(c) || c === 45) && alnumDashFrom(s, i + 1);\n}\n\n/**\n * The last index before `end` holding `code`, or -1 (JS `s.lastIndexOf(c)` at end = |s|).\n *\n * @ensures result = -1 ∨ (0 ≤ result < end ∧ s[result] = code ∧ no `code` in (result, end))\n */\nexport function lastIndexOfCode(s: string, code: number, end: number): number {\n //@ verify\n //@ type end nat\n //@ requires end <= s.length\n //@ decreases end\n //@ ensures \\result === -1 || (0 <= \\result && \\result < end)\n //@ ensures \\result >= 0 ==> s.charCodeAt(\\result) === code\n //@ ensures \\result >= 0 ==> forall(k: nat, (\\result < k && k < end) ==> s.charCodeAt(k) !== code)\n //@ ensures \\result === -1 ==> forall(k: nat, k < end ==> s.charCodeAt(k) !== code)\n if (end === 0) return -1;\n if (s.charCodeAt(end - 1) === code) return end - 1;\n return lastIndexOfCode(s, code, end - 1);\n}\n\n/**\n * No character of `s` from index `i` on is `code`.\n *\n * @ensures result ⟺ ∀ k ∈ [i, |s|). s[k] ≠ code\n */\nexport function lacksCode(s: string, code: number, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ requires i <= s.length\n //@ decreases s.length - i\n //@ ensures \\result <==> forall(k: nat, (i <= k && k < s.length) ==> s.charCodeAt(k) !== code)\n // `===`, not `>=`: past the end a read is NaN !== code, so `>=` vs `>` would be equivalent\n return i === s.length || (s.charCodeAt(i) !== code && lacksCode(s, code, i + 1));\n}\n\n/**\n * The end of the run of `code` starting at `i`: the first index ≥ i that isn't `code`\n * (skip spaces: `codeRunEnd(header, 32, i)`).\n *\n * @requires i ≤ |s|\n * @ensures i ≤ result ≤ |s| ∧ ∀ k ∈ [i, result). s[k] = code ∧ (result < |s| ⟹ s[result] ≠ code)\n * — exactly the run's end\n */\nexport function codeRunEnd(s: string, code: number, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires 0 <= i && i <= s.length\n //@ requires code >= 0\n //@ decreases s.length - i\n //@ ensures i <= \\result && \\result <= s.length\n //@ ensures forall(k: nat, (i <= k && k < \\result) ==> s.charCodeAt(k) === code)\n //@ ensures \\result < s.length ==> s.charCodeAt(\\result) !== code\n return codeAt(s, i) === code ? codeRunEnd(s, code, i + 1) : i;\n}\n\n/**\n * The first index ≥ `from` holding `code`, or -1 (`indexOf` for one code unit, so \"\\n\" is\n * passed as 10, never as a literal).\n *\n * @ensures result = -1 ∨ (from ≤ result < |s| ∧ s[result] = code), with no `code` in\n * [from, result) — the first one; result = -1 ⟹ none from `from` on\n */\nexport function indexOfCode(s: string, code: number, from: number): number {\n //@ verify\n //@ type from nat\n //@ requires code >= 0\n //@ decreases s.length - from\n //@ ensures \\result === -1 || (from <= \\result && \\result < s.length)\n //@ ensures \\result >= 0 ==> s.charCodeAt(\\result) === code\n //@ ensures \\result >= 0 ==> forall(k: nat, (from <= k && k < \\result) ==> s.charCodeAt(k) !== code)\n //@ ensures \\result === -1 ==> forall(k: nat, (from <= k && k < s.length) ==> s.charCodeAt(k) !== code)\n const c = codeAt(s, from);\n if (c === code) return from;\n if (c === -1) return -1;\n return indexOfCode(s, code, from + 1);\n}\n\n/**\n * The first index ≥ `i` holding `a` or `b`, or |s| (a run either code ends: a path segment's\n * run to \"/\" or \"?\"). One scan: the lesser of two `indexOfCode` ends is the same index, but\n * its two sides are equal only when both are |s|, a boundary no test can observe.\n *\n * @requires i ≤ |s|\n * @ensures i ≤ result ≤ |s| ∧ ∀ k ∈ [i, result). s[k] ∉ {a, b} ∧ (result < |s| ⟹ s[result] ∈ {a, b})\n * — exactly the first such index\n */\nexport function eitherCodeEnd(s: string, a: number, b: number, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires 0 <= i && i <= s.length\n //@ requires a >= 0 && b >= 0\n //@ decreases s.length - i\n //@ ensures i <= \\result && \\result <= s.length\n //@ ensures forall(k: nat, (i <= k && k < \\result) ==> (s.charCodeAt(k) !== a && s.charCodeAt(k) !== b))\n //@ ensures \\result < s.length ==> (s.charCodeAt(\\result) === a || s.charCodeAt(\\result) === b)\n const c = codeAt(s, i);\n if (c === -1 || c === a || c === b) return i;\n return eitherCodeEnd(s, a, b, i + 1);\n}\n\n/**\n * `s` without one trailing `code` (\"\\r\" before a \"\\n\", say); unchanged otherwise.\n *\n * @ensures s ends with code ⟹ result = s[0, |s| − 1)\n * @ensures otherwise result = s\n */\nexport function dropLast(s: string, code: number): string {\n //@ verify\n //@ requires code >= 0\n //@ ensures (s.length > 0 && s.charCodeAt(s.length - 1) === code) ==> \\result === s.slice(0, s.length - 1)\n //@ ensures !(s.length > 0 && s.charCodeAt(s.length - 1) === code) ==> \\result === s\n return codeAt(s, s.length - 1) === code ? s.slice(0, s.length - 1) : s;\n}\n\n/**\n * `s` without its leading `code` units (every one of them).\n *\n * @ensures exactly the model's LStripCode\n */\nexport function lStripCode(s: string, code: number): string {\n //@ verify\n //@ requires code >= 0\n //@ decreases s.length\n //@ ensures \\result.length <= s.length\n if (codeAt(s, 0) === code) return lStripCode(s.slice(1), code);\n return s;\n}\n\n/**\n * `s` without its trailing `code` units (every one of them).\n *\n * @ensures exactly the model's RStripCode\n */\nexport function rStripCode(s: string, code: number): string {\n //@ verify\n //@ requires code >= 0\n //@ decreases s.length\n //@ ensures \\result.length <= s.length\n if (codeAt(s, s.length - 1) === code) {\n return rStripCode(s.slice(0, s.length - 1), code);\n }\n return s;\n}\n\n/**\n * `s` without its leading and trailing `code` units, the middle kept (`/a/b/` with `/` →\n * `a/b`).\n *\n * @ensures exactly the model's StripCode — neither end is `code` (StripCodeTrims)\n */\nexport function stripCode(s: string, code: number): string {\n //@ verify\n //@ requires code >= 0\n //@ ensures \\result === rStripCode(lStripCode(s, code), code)\n return rStripCode(lStripCode(s, code), code);\n}\n\n/**\n * JS `s.startsWith(x, pos)`, which lsc mistranslates (it drops `pos`). Like JS, a `pos`\n * past the end counts as the end, so the empty string matches anywhere.\n *\n * @ensures pos ≤ |s| ⟹ (result ⟺ pos + |x| ≤ |s| ∧ s[pos, pos + |x|) = x) — so a true\n * result also gives the bounds for slicing after the match\n * @ensures pos > |s| ⟹ (result ⟺ x = \"\")\n */\nexport function startsWithAt(s: string, x: string, pos: number): boolean {\n //@ verify\n //@ type pos nat\n //@ requires pos >= 0\n //@ ensures pos <= s.length ==> (\\result <==> (pos + x.length <= s.length && s.slice(pos, pos + x.length) === x))\n //@ ensures pos > s.length ==> (\\result <==> x.length === 0)\n // Math.min, not a ternary: at pos = |s| both branches agree, so `<` vs `<=` is equivalent\n const at = Math.min(pos, s.length);\n // The slice is clamped to the end, so a too-long x differs by length: no separate fit test\n // (JS slice clamps too, which made one unobservable)\n return s.slice(at, Math.min(at + x.length, s.length)) === x;\n}\n\n/**\n * `s` with A-Z lowercased and every other character kept: what lsc's proofs take\n * `toLowerCase()` to be. JS's `toLowerCase()` also maps non-ASCII letters, some onto ASCII\n * (the Kelvin sign K, U+212A, becomes \"k\") or onto two characters (İ, U+0130), so a proved\n * function that lowercases MUST use this, or the runtime does what the proof says it\n * doesn't.\n *\n * @ensures result = s with A-Z lowercased — same length, every other character unchanged\n */\nexport function lowerAscii(s: string): string {\n //@ verify\n //@ decreases s.length\n //@ ensures \\result === s.toLowerCase()\n if (s.length === 0) return \"\";\n const c = s.charCodeAt(0);\n const head =\n c >= 65 && c <= 90 ? \"abcdefghijklmnopqrstuvwxyz\".slice(c - 65, c - 64) : s.slice(0, 1);\n return head + lowerAscii(s.slice(1));\n}\n\n/**\n * `lowerAscii` as a loop: a constant stack depth (and linear time) on long text, where the\n * recursive spec takes a frame and a slice per character.\n *\n * @ensures result = lowerAscii(s)\n */\nexport function lowerAsciiText(s: string): string {\n //@ verify\n //@ ensures \\result === lowerAscii(s)\n let out = \"\";\n let i = 0;\n while (i !== s.length) {\n //@ invariant 0 <= i && i <= s.length\n //@ invariant out + lowerAscii(s.slice(i)) === lowerAscii(s)\n //@ decreases s.length - i\n const c = s.charCodeAt(i);\n out =\n out +\n (c >= 65 && c <= 90 ? \"abcdefghijklmnopqrstuvwxyz\".slice(c - 65, c - 64) : s.slice(i, i + 1));\n i = i + 1;\n }\n return out;\n}\n\n/**\n * Whether `x` from index `k` matches `s` from `pos + k`, code by code, ASCII-lowered. A code\n * past the end of `s` is -1 (`codeAt`), which no code of `x` is, so there is no bound to\n * check (a `pos + |x| ≤ |s|` guard before a slice never changed the answer at runtime, where\n * `slice` clamps: an equivalent mutant, 2026-11-02).\n *\n * @ensures exactly the model's CaselessFrom\n */\nexport function caselessFrom(s: string, x: string, pos: number, k: number): boolean {\n //@ verify\n //@ type pos nat\n //@ type k nat\n //@ requires pos >= 0 && k >= 0 && k <= x.length\n //@ decreases x.length - k\n //@ ensures k === x.length ==> \\result\n if (k === x.length) return true;\n return lowerCode(codeAt(s, pos + k)) === x.charCodeAt(k) && caselessFrom(s, x, pos, k + 1);\n}\n\n/**\n * Whether the text of `s` at `pos`, ASCII-lowered, is `x` (`x` given lowercase): a case-free\n * `startsWith`; callers carry no length guard of their own. Only `pos ≤ |s|` is checked: it\n * decides an empty `x` past the end, the one case the code-by-code test can't see.\n *\n * @ensures result ⟺ pos + |x| ≤ |s| ∧ lowerAscii(s[pos, pos + |x|)) = x — Utils.StartsWithCaseless\n */\nexport function startsWithCaseless(s: string, x: string, pos: number): boolean {\n //@ verify\n //@ type pos nat\n //@ requires pos >= 0\n //@ ensures \\result <==> (pos + x.length <= s.length && s.slice(pos, pos + x.length).toLowerCase() === x)\n return pos <= s.length && caselessFrom(s, x, pos, 0);\n}\n\n/**\n * Whether `s` ends with `suffix` (JS one-argument `endsWith`, which lsc reads as its\n * two-argument form; moved from the augur-api generator 2026-11-01).\n *\n * @ensures result ⟺ |s| ≥ |suffix| ∧ s[|s| − |suffix|, |s|) = suffix — exactly the model's EndsWith\n */\nexport function endsWith(s: string, suffix: string): boolean {\n //@ verify\n //@ ensures \\result <==> (s.length >= suffix.length && s.slice(s.length - suffix.length) === suffix)\n // No length test: from max(|s| − |suffix|, 0), a too-long suffix compares unequal by length\n return s.slice(Math.max(s.length - suffix.length, 0)) === suffix;\n}\n\n/**\n * The order of `a` and `b` by UTF-16 code unit from index `i`, as a recursive spec: -1, 0\n * or 1 (JS `<` on strings; a proper prefix comes first). Locale-free, unlike `localeCompare`.\n *\n * @ensures result ∈ {-1, 0, 1} — exactly the model's CompareFrom\n */\nexport function compareFrom(a: string, b: string, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires i >= 0\n //@ decreases a.length - i\n //@ ensures \\result === -1 || \\result === 0 || \\result === 1\n if (i >= a.length) return i >= b.length ? 0 : -1;\n if (i >= b.length) return 1;\n const x = a.charCodeAt(i);\n const y = b.charCodeAt(i);\n if (x < y) return -1;\n if (x > y) return 1;\n return compareFrom(a, b, i + 1);\n}\n\n/**\n * The order of two strings by UTF-16 code unit, for `sort` (what the default `sort` uses on\n * strings), so sorted output never depends on locale.\n *\n * @ensures result = compareFrom(a, b, 0)\n */\nexport function compareCodeUnits(a: string, b: string): number {\n //@ verify\n //@ ensures \\result === compareFrom(a, b, 0)\n return compareFrom(a, b, 0);\n}\n\n/**\n * JS `s.slice(0, n)`: at most `n` characters, clamped to the length. lsc reads a bare\n * `slice(0, n)` without JS's clamp, so use this instead.\n *\n * @ensures result = s[0, min(n, |s|))\n */\nexport function prefix(s: string, n: number): string {\n //@ verify\n //@ type n nat\n //@ requires n >= 0\n //@ ensures n < s.length ==> \\result === s.slice(0, n)\n //@ ensures n >= s.length ==> \\result === s\n // Math.min, not a ternary: JS slice already clamps, so a ternary's branch is unobservable\n return s.slice(0, Math.min(n, s.length));\n}\n\n/**\n * The end of the JS-whitespace (`\\s`) run starting at `i`: the first index ≥ i that is not\n * whitespace, or |s|.\n *\n * @ensures i ≤ result ≤ |s| ∧ s[i, result) all whitespace ∧ (result = |s| ∨ ¬space(s[result]))\n */\nexport function spaceRunEnd(s: string, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires 0 <= i && i <= s.length\n //@ decreases s.length - i\n //@ ensures i <= \\result && \\result <= s.length\n //@ ensures forall(k: nat, (i <= k && k < \\result) ==> isJsSpace(s.charCodeAt(k)))\n //@ ensures \\result < s.length ==> !isJsSpace(s.charCodeAt(\\result))\n // codeAt is -1 at the end, which is no space: the bound needs no test of its own here\n if (!isJsSpace(codeAt(s, i))) return i;\n return spaceRunEnd(s, i + 1);\n}\n\n/**\n * A natural number written canonically (`^(0|[1-9][0-9]*)$`): the keys JS objects move\n * first, ahead of their source order.\n *\n * @ensures exactly the model's CanonicalNat, stated over the codes themselves so an importer\n * can use it (a contract naming `digitsFrom` can't be resolved there, models/LSC-GAPS.md)\n */\nexport function isCanonicalNat(s: string): boolean {\n //@ verify\n //@ ensures \\result <==> (s === \"0\" || (s.length > 0 && s.charCodeAt(0) >= 49 && s.charCodeAt(0) <= 57 && forall(k: nat, (1 <= k && k < s.length) ==> (s.charCodeAt(k) >= 48 && s.charCodeAt(k) <= 57))))\n if (s === \"0\") return true;\n const first = codeAt(s, 0);\n return first >= 49 && first <= 57 && digitsFrom(s, 1);\n}\n\n/**\n * The value of a run of decimal digits, most significant first (\"\" is 0).\n *\n * @requires ∀ k ∈ [0, |s|). isDigit(s[k])\n * @ensures exactly the model's DigitsValue (proved in links/utils-strings.dfy)\n */\nexport function digitsValue(s: string): number {\n //@ verify\n //@ requires forall(k: nat, k < s.length ==> (s.charCodeAt(k) >= 48 && s.charCodeAt(k) <= 57))\n //@ decreases s.length\n //@ ensures \\result >= 0\n if (s.length === 0) return 0;\n return digitsValue(s.slice(0, s.length - 1)) * 10 + (s.charCodeAt(s.length - 1) - 48);\n}\n\n/**\n * What a number from the environment means (owner 2026-11-04: a bad one fails at start):\n * \"default\" when unset (\"\": the wrapper reads a missing variable as \"\"), \"value\" when it is\n * a canonical natural number at least `min` (its value is `digitsValue(raw)`), and \"bad\"\n * otherwise: a sign, a space, a fraction, an exponent, hex, text, or below `min`.\n *\n * @ensures exactly the model's EnvNumberOf (proved in links/utils-strings.dfy)\n */\nexport function envNumberKind(raw: string, min: number): string {\n //@ verify\n //@ type min nat\n //@ ensures raw === \"\" ==> \\result === \"default\"\n //@ ensures (raw !== \"\" && !isCanonicalNat(raw)) ==> \\result === \"bad\"\n if (raw === \"\") return \"default\";\n if (!isCanonicalNat(raw)) return \"bad\";\n return digitsValue(raw) < min ? \"bad\" : \"value\";\n}\n\n/**\n * The first index ≥ `i` holding a line terminator, or |s|: where a regex `.+` started at `i`\n * stops.\n *\n * @ensures i ≤ result ≤ |s| ∧ no terminator in s[i, result) ∧ (result = |s| ∨ terminator at result)\n */\nexport function lineEnd(s: string, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires 0 <= i && i <= s.length\n //@ decreases s.length - i\n //@ ensures i <= \\result && \\result <= s.length\n //@ ensures forall(k: nat, (i <= k && k < \\result) ==> !isLineTerminator(s.charCodeAt(k)))\n //@ ensures \\result < s.length ==> isLineTerminator(s.charCodeAt(\\result))\n if (i === s.length || isLineTerminator(s.charCodeAt(i))) return i;\n return lineEnd(s, i + 1);\n}\n\n/**\n * The largest p with lo ≤ p < hi whose character is not a line terminator, or -1: where a\n * backtracking regex `.` can start.\n *\n * @ensures result = -1 ∨ (lo ≤ result < hi ∧ ¬terminator(s[result]) ∧ only terminators in (result, hi))\n */\nexport function lastLineCharBelow(s: string, hi: number, lo: number): number {\n //@ verify\n //@ type hi nat\n //@ type lo nat\n //@ requires 0 <= lo && 0 <= hi && hi <= s.length\n //@ decreases hi\n //@ ensures \\result === -1 || (lo <= \\result && \\result < hi)\n //@ ensures \\result >= 0 ==> !isLineTerminator(s.charCodeAt(\\result))\n //@ ensures \\result >= 0 ==> forall(k: nat, (\\result < k && k < hi) ==> isLineTerminator(s.charCodeAt(k)))\n //@ ensures \\result === -1 ==> forall(k: nat, (lo <= k && k < hi) ==> isLineTerminator(s.charCodeAt(k)))\n if (hi <= lo) return -1;\n if (!isLineTerminator(s.charCodeAt(hi - 1))) return hi - 1;\n return lastLineCharBelow(s, hi - 1, lo);\n}\n\n/**\n * Nothing but JS whitespace (`s.trim() === \"\"`).\n *\n * @ensures exactly the model's Blank\n */\nexport function isBlank(s: string): boolean {\n //@ verify\n //@ ensures \\result <==> s.trim() === \"\"\n return s.trim() === \"\";\n}\n\n/**\n * The first index ≥ `i` where `x` occurs in `s`, or -1 (JS `s.indexOf(x, i)` for i ≤ |s|).\n *\n * @ensures result = -1 ∨ (i ≤ result ∧ s[result, result + |x|) = x) — and the first such\n * index: links/utils-strings.dfy proves it is exactly the model's IndexOfFrom (lsc can't\n * give the \"no earlier match\" quantifier a trigger)\n */\nexport function indexOfFrom(s: string, x: string, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires i >= 0 && i <= s.length\n //@ decreases s.length - i\n //@ ensures \\result === -1 || (i <= \\result && \\result + x.length <= s.length)\n //@ ensures \\result >= 0 ==> s.slice(\\result, \\result + x.length) === x\n // A match here, else the end, else the next index: stopping at `i === |s|` (not \"x no\n // longer fits\") leaves no bound whose slip a later, harmless step would hide\n if (startsWithAt(s, x, i)) return i;\n if (i === s.length) return -1;\n return indexOfFrom(s, x, i + 1);\n}\n\n/**\n * `indexOfFrom` as a loop: the same answer at a constant stack depth, for text long enough that\n * one frame per character would overflow the stack (a rendered page, 50–60 KB with its inlined\n * stylesheet). Specs and links use `indexOfFrom`; runtime scans over long text use this.\n *\n * @ensures result = indexOfFrom(s, x, i)\n */\nexport function findFrom(s: string, x: string, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires i >= 0 && i <= s.length\n //@ ensures \\result === indexOfFrom(s, x, i)\n let k = i;\n while (k !== s.length) {\n //@ invariant i <= k && k <= s.length\n //@ invariant indexOfFrom(s, x, k) === indexOfFrom(s, x, i)\n //@ decreases s.length - k\n if (startsWithAt(s, x, k)) return k;\n k = k + 1;\n }\n return startsWithAt(s, x, k) ? k : -1;\n}\n\n/**\n * `indexOfCode` as a loop: the same answer at a constant stack depth (see `findFrom`).\n *\n * @ensures result = indexOfCode(s, code, from)\n */\nexport function findCodeFrom(s: string, code: number, from: number): number {\n //@ verify\n //@ type from nat\n //@ requires code >= 0 && from >= 0\n //@ ensures \\result === indexOfCode(s, code, from)\n let k = from;\n while (k < s.length) {\n //@ invariant from <= k\n //@ invariant indexOfCode(s, code, k) === indexOfCode(s, code, from)\n //@ decreases s.length - k\n if (s.charCodeAt(k) === code) return k;\n k = k + 1;\n }\n return -1;\n}\n\n/**\n * How many times `x` occurs in `s` from `i` on, left to right without overlaps (repeated JS\n * `s.indexOf(x, at + x.length)`).\n *\n * @requires |x| > 0\n * @ensures result ≥ 0 — exactly the model's CountFrom (links/utils-strings.dfy)\n */\nexport function countFrom(s: string, x: string, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires x.length > 0 && i >= 0 && i <= s.length\n //@ decreases s.length - i\n //@ ensures \\result >= 0\n const at = indexOfFrom(s, x, i);\n if (at === -1) return 0;\n return 1 + countFrom(s, x, at + x.length);\n}\n\n/**\n * `countFrom(s, x, 0)` as a loop: a constant stack depth on long text (see `findFrom`).\n *\n * @requires |x| > 0\n * @ensures result = countFrom(s, x, 0)\n */\nexport function countOf(s: string, x: string): number {\n //@ verify\n //@ requires x.length > 0\n //@ ensures \\result === countFrom(s, x, 0)\n let n = 0;\n let i = 0;\n let at = findFrom(s, x, 0);\n while (at !== -1) {\n //@ invariant 0 <= i && i <= s.length\n //@ invariant at === indexOfFrom(s, x, i)\n //@ invariant n + countFrom(s, x, i) === countFrom(s, x, 0)\n //@ decreases s.length - i\n n = n + 1;\n i = at + x.length;\n at = findFrom(s, x, i);\n }\n return n;\n}\n\n/**\n * The text before the first `code`, or all of it when there is none (JS `s.split(c)[0]`).\n *\n * @ensures result = s[0, first code) when s holds one, else s — the model's UntilCode\n */\nexport function untilCode(s: string, code: number): string {\n //@ verify\n //@ requires code >= 0\n //@ ensures \\result === (indexOfCode(s, code, 0) >= 0 && indexOfCode(s, code, 0) <= s.length ? s.slice(0, indexOfCode(s, code, 0)) : s)\n const k = indexOfCode(s, code, 0);\n return k >= 0 ? s.slice(0, k) : s;\n}\n\n/**\n * `s` from `i` on split at every `code` (JS `s.split(c)` at i = 0, for a one-character\n * separator): always at least one part.\n *\n * @ensures |result| ≥ 1 — exactly the model's SplitCodeFrom (links/utils-strings.dfy)\n */\nexport function splitCodeFrom(s: string, code: number, i: number): string[] {\n //@ verify\n //@ type i nat\n //@ requires code >= 0 && i >= 0 && i <= s.length\n //@ decreases s.length - i\n //@ ensures \\result.length > 0\n const k = indexOfCode(s, code, i);\n if (k === -1) return [s.slice(i)];\n return [s.slice(i, k), ...splitCodeFrom(s, code, k + 1)];\n}\n\n/**\n * Every run of JS whitespace in `s` from `i` on as one space (JS `s.replace(/\\s+/g, \" \")` at\n * i = 0).\n *\n * @ensures |result| ≤ |s| − i — exactly the model's CollapseSpacesFrom (links/utils-strings.dfy)\n */\nexport function collapseSpacesFrom(s: string, i: number): string {\n //@ verify\n //@ type i nat\n //@ requires 0 <= i && i <= s.length\n //@ decreases s.length - i\n //@ ensures \\result.length <= s.length - i\n if (i === s.length) return \"\";\n if (isJsSpace(s.charCodeAt(i))) return \" \" + collapseSpacesFrom(s, spaceRunEnd(s, i));\n return s.slice(i, i + 1) + collapseSpacesFrom(s, i + 1);\n}\n\n/**\n * `collapseSpacesFrom(s, 0)` at a constant stack depth (a page's text is tens of KB).\n *\n * @ensures result = collapseSpacesFrom(s, 0)\n */\nexport function collapseSpaces(s: string): string {\n //@ verify\n //@ ensures \\result === collapseSpacesFrom(s, 0)\n let out = \"\";\n let i = 0;\n while (i < s.length) {\n //@ invariant 0 <= i && i <= s.length\n //@ invariant out + collapseSpacesFrom(s, i) === collapseSpacesFrom(s, 0)\n //@ decreases s.length - i\n if (isJsSpace(s.charCodeAt(i))) {\n out = out + \" \";\n i = spaceRunEnd(s, i);\n } else {\n out = out + s.slice(i, i + 1);\n i = i + 1;\n }\n }\n return out;\n}\n\n/**\n * `n` spaces.\n *\n * @ensures result = \" \" repeated n times — the model's Spaces\n */\nexport function spaces(n: number): string {\n //@ verify\n //@ type n nat\n //@ requires n >= 0\n //@ decreases n\n //@ ensures \\result.length === n\n //@ ensures forall(k: nat, k < n ==> \\result.charCodeAt(k) === 32)\n if (n === 0) return \"\";\n return \" \" + spaces(n - 1);\n}\n\n/**\n * A line feed, `\"\\n\"`, for proved text that spans lines: lsc emits a `\"\\n\"` escape raw, which\n * Dafny cannot parse (models/LSC-GAPS.md), so the contract pins it by code unit and the body is\n * a template literal holding the line break itself.\n *\n * @ensures result = \"\\n\" — one code unit, 10\n */\nexport function lineFeed(): string {\n //@ verify\n //@ ensures \\result.length === 1 && \\result.charCodeAt(0) === 10\n return `\n`;\n}\n\n/**\n * `s` padded on the left with spaces to `width` (JS `s.padStart(width)`).\n *\n * @ensures result = Spaces(width − |s|) + s when width > |s|, else s\n */\nexport function padLeft(s: string, width: number): string {\n //@ verify\n //@ ensures width <= s.length ==> \\result === s\n // width > |s| ⟹ spaces(width − |s|) + s: a hand ensures in strings.dfy, so importers'\n // axioms name no helper (models/LSC-GAPS.md). Math.max, not a ternary: at width = |s|\n // both branches agree (spaces(0) is \"\"), so `>` vs `>=` would be equivalent.\n return spaces(Math.max(width - s.length, 0)) + s;\n}\n\n/**\n * `s` padded on the right with spaces to `width` (JS `s.padEnd(width)`).\n *\n * @ensures result = s + Spaces(width − |s|) when width > |s|, else s\n */\nexport function padRight(s: string, width: number): string {\n //@ verify\n //@ ensures width <= s.length ==> \\result === s\n // width > |s| ⟹ s + spaces(width − |s|): a hand ensures in strings.dfy, as padLeft's.\n return s + spaces(Math.max(width - s.length, 0));\n}\n\n/**\n * An optional part of a key: `tag` then `text`, or nothing when `text` is empty, so an absent\n * part never leaves a bare tag.\n *\n * @ensures result = \"\" when text = \"\", else tag + text — exactly the model's KeyPart\n */\nexport function keyPart(tag: string, text: string): string {\n //@ verify\n //@ ensures \\result === (text === \"\" ? \"\" : tag + text)\n return text === \"\" ? \"\" : tag + text;\n}\n\n/**\n * Two texts joined by one space: the one rule behind a loader key's `<column> <direction>`, a\n * sync line's `METHOD /path` and a field's description then note.\n *\n * @ensures result = a + \" \" + b — exactly the model's SpaceJoined\n */\nexport function spaceJoined(a: string, b: string): string {\n //@ verify\n //@ ensures \\result === a + \" \" + b\n return a + \" \" + b;\n}\n\n/**\n * Whether `x` occurs in `s` at some index ≥ `i` (JS `s.includes(x, i)` for i ≤ |s|).\n *\n * @ensures result ⟺ ∃ k. i ≤ k ≤ |s| ∧ startsWithAt(s, x, k) — exactly the model's\n * IncludesFrom: a hand lemma in strings.dfy (`includesFrom_exists`), so importers' axioms\n * name no helper (models/LSC-GAPS.md)\n */\nexport function includesFrom(s: string, x: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ requires i >= 0\n //@ decreases s.length + 1 - i\n if (i > s.length) return false;\n if (startsWithAt(s, x, i)) return true;\n return includesFrom(s, x, i + 1);\n}\n\n/**\n * `s` with a-z uppercased and every other character kept, the mirror of `lowerAscii`: JS's\n * `toUpperCase()` also maps non-ASCII letters (ß becomes \"SS\").\n *\n * @ensures result = s with a-z uppercased — same length, every other character unchanged\n */\nexport function upperAscii(s: string): string {\n //@ verify\n //@ decreases s.length\n //@ ensures \\result === s.toUpperCase()\n if (s.length === 0) return \"\";\n const c = s.charCodeAt(0);\n const head =\n c >= 97 && c <= 122 ? \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\".slice(c - 97, c - 96) : s.slice(0, 1);\n return head + upperAscii(s.slice(1));\n}\n","//@ backend dafny\nimport { codeAt, startsWithAt } from \"@atlas/utils/strings\";\n\n/* augur-doctor's decisions, verified with LemmaScript → Dafny (model: models/AugurConfig.dfy;\n link: models/links/augur-config-doctor-rules.dfy). What a check reads from the site (a file\n exists, its text holds a string or matches a regex) is a fact handed in by facts.ts. */\n\n/** A check's outcome. */\nexport type Status = \"PASS\" | \"FAIL\" | \"WARN\" | \"SUGGEST\" | \"SKIP\";\n\n/**\n * A file that should use a factory: there and using it passes; there without it warns; missing\n * fails (site-config, server-site, ssr-options).\n *\n * @ensures exactly the model's FileUses\n */\nexport function fileUses(found: boolean, uses: boolean): Status {\n //@ verify\n //@ ensures found && uses ==> \\result === \"PASS\"\n //@ ensures found && !uses ==> \\result === \"WARN\"\n //@ ensures !found ==> \\result === \"FAIL\"\n if (found && uses) return \"PASS\";\n return found ? \"WARN\" : \"FAIL\";\n}\n\n/**\n * actions: re-exporting passes, there otherwise warns; missing passes with the proxy pattern.\n *\n * @ensures exactly the model's ActionsStatus\n */\nexport function actionsStatus(found: boolean, reExports: boolean, usesProxy: boolean): Status {\n //@ verify\n //@ ensures found && reExports ==> \\result === \"PASS\"\n //@ ensures found && !reExports ==> \\result === \"WARN\"\n //@ ensures !found && usesProxy ==> \\result === \"PASS\"\n //@ ensures !found && !usesProxy ==> \\result === \"FAIL\"\n if (found) return reExports ? \"PASS\" : \"WARN\";\n return usesProxy ? \"PASS\" : \"FAIL\";\n}\n\n/**\n * site-hooks: createSiteHooks or another hooks setup passes; a file without either warns.\n *\n * @ensures exactly the model's SiteHooksStatus\n */\nexport function siteHooksStatus(\n found: boolean,\n createSiteHooks: boolean,\n hooksSetup: boolean,\n): Status {\n //@ verify\n //@ ensures found && (createSiteHooks || hooksSetup) ==> \\result === \"PASS\"\n //@ ensures found && !(createSiteHooks || hooksSetup) ==> \\result === \"WARN\"\n //@ ensures !found ==> \\result === \"FAIL\"\n return fileUses(found, createSiteHooks || hooksSetup);\n}\n\n/**\n * tsconfig: extends augur-config/tsconfig/next passes; another augur-config preset warns; else\n * (or no tsconfig.json) fails.\n *\n * @ensures exactly the model's TsconfigStatus\n */\nexport function tsconfigStatus(\n found: boolean,\n extendsNext: boolean,\n extendsAugur: boolean,\n): Status {\n //@ verify\n //@ ensures !found ==> \\result === \"FAIL\"\n //@ ensures found && extendsNext ==> \\result === \"PASS\"\n //@ ensures found && !extendsNext && extendsAugur ==> \\result === \"WARN\"\n //@ ensures found && !extendsNext && !extendsAugur ==> \\result === \"FAIL\"\n if (!found) return \"FAIL\";\n if (extendsNext) return \"PASS\";\n return extendsAugur ? \"WARN\" : \"FAIL\";\n}\n\n/**\n * eslint and prettier: a config using the shared preset passes; every other case fails.\n *\n * @ensures exactly the model's PresetStatus\n */\nexport function presetStatus(found: boolean, usesPreset: boolean): Status {\n //@ verify\n //@ ensures \\result === (found && usesPreset ? \"PASS\" : \"FAIL\")\n return found && usesPreset ? \"PASS\" : \"FAIL\";\n}\n\n/**\n * eslint-deprecated: skipped without an ESLint config; on passes; named otherwise warns.\n *\n * @ensures exactly the model's DeprecatedStatus\n */\nexport function deprecatedStatus(hasEslint: boolean, ruleOn: boolean, named: boolean): Status {\n //@ verify\n //@ ensures !hasEslint ==> \\result === \"SKIP\"\n //@ ensures hasEslint && ruleOn ==> \\result === \"PASS\"\n //@ ensures hasEslint && !ruleOn && named ==> \\result === \"WARN\"\n //@ ensures hasEslint && !ruleOn && !named ==> \\result === \"FAIL\"\n if (!hasEslint) return \"SKIP\";\n if (ruleOn) return \"PASS\";\n return named ? \"WARN\" : \"FAIL\";\n}\n\n/**\n * knip: config and dependency pass; the dependency alone warns; else fails.\n *\n * @ensures exactly the model's KnipStatus\n */\nexport function knipStatus(hasConfig: boolean, hasDep: boolean): Status {\n //@ verify\n //@ ensures hasConfig && hasDep ==> \\result === \"PASS\"\n //@ ensures !hasConfig && hasDep ==> \\result === \"WARN\"\n //@ ensures !hasDep ==> \\result === \"FAIL\"\n if (!hasDep) return \"FAIL\";\n return hasConfig ? \"PASS\" : \"WARN\";\n}\n\n/**\n * icons: react-icons alone passes; heroicons or lucide fails; none warns.\n *\n * @ensures exactly the model's IconsStatus\n */\nexport function iconsStatus(reactIcons: boolean, heroicons: boolean, lucide: boolean): Status {\n //@ verify\n //@ ensures reactIcons && !heroicons && !lucide ==> \\result === \"PASS\"\n //@ ensures (heroicons || lucide) ==> \\result === \"FAIL\"\n //@ ensures !reactIcons && !heroicons && !lucide ==> \\result === \"WARN\"\n if (heroicons || lucide) return \"FAIL\";\n return reactIcons ? \"PASS\" : \"WARN\";\n}\n\n/**\n * tailwind: a range starting \"^4\" or \"4\" passes, \"^3\" or \"3\" fails, anything else warns.\n *\n * @ensures exactly the model's TailwindStatus\n */\nexport function tailwindStatus(range: string): Status {\n //@ verify\n //@ ensures (startsWithAt(range, \"^4\", 0) || startsWithAt(range, \"4\", 0)) ==> \\result === \"PASS\"\n //@ ensures !(startsWithAt(range, \"^4\", 0) || startsWithAt(range, \"4\", 0)) && (startsWithAt(range, \"^3\", 0) || startsWithAt(range, \"3\", 0)) ==> \\result === \"FAIL\"\n //@ ensures !(startsWithAt(range, \"^4\", 0) || startsWithAt(range, \"4\", 0)) && !(startsWithAt(range, \"^3\", 0) || startsWithAt(range, \"3\", 0)) ==> \\result === \"WARN\"\n if (startsWithAt(range, \"^4\", 0) || startsWithAt(range, \"4\", 0)) return \"PASS\";\n if (startsWithAt(range, \"^3\", 0) || startsWithAt(range, \"3\", 0)) return \"FAIL\";\n return \"WARN\";\n}\n\n/** What augur-doctor reads from next.config. */\nexport interface NextFacts {\n hasConfig: boolean;\n hasExternal: boolean;\n externalHasServer: boolean;\n usesIoredis: boolean;\n externalHasIoredis: boolean;\n hasAllHeaders: boolean;\n hasHeaders: boolean;\n hasOptimize: boolean;\n hasStrict: boolean;\n hasAgrMedia: boolean;\n hasImages: boolean;\n}\n\n/**\n * next-external: augur-server MUST NOT be externalized; no serverExternalPackages warns.\n *\n * @ensures exactly the model's NextExternalStatus\n */\nexport function nextExternalStatus(n: NextFacts): Status {\n //@ verify\n //@ ensures !n.hasConfig ==> \\result === \"FAIL\"\n //@ ensures n.hasConfig && n.hasExternal ==> \\result === (n.externalHasServer ? \"FAIL\" : \"PASS\")\n //@ ensures n.hasConfig && !n.hasExternal ==> \\result === \"WARN\"\n if (!n.hasConfig) return \"FAIL\";\n if (n.hasExternal) return n.externalHasServer ? \"FAIL\" : \"PASS\";\n return \"WARN\";\n}\n\n/**\n * next-ioredis: checked only when the site uses ioredis and has serverExternalPackages.\n *\n * @ensures exactly the model's IoredisStatus\n */\nexport function ioredisStatus(n: NextFacts): Status {\n //@ verify\n //@ ensures (!n.hasConfig || !n.hasExternal || !n.usesIoredis) ==> \\result === \"SKIP\"\n //@ ensures n.hasConfig && n.hasExternal && n.usesIoredis ==> \\result === (n.externalHasIoredis ? \"PASS\" : \"WARN\")\n if (!n.hasConfig || !n.hasExternal || !n.usesIoredis) return \"SKIP\";\n return n.externalHasIoredis ? \"PASS\" : \"WARN\";\n}\n\n/**\n * next-headers: HSTS, X-Content-Type-Options and Permissions-Policy all pass; some warns.\n *\n * @ensures exactly the model's HeadersStatus\n */\nexport function headersStatus(n: NextFacts): Status {\n //@ verify\n //@ ensures !n.hasConfig ==> \\result === \"FAIL\"\n //@ ensures n.hasConfig && n.hasAllHeaders ==> \\result === \"PASS\"\n //@ ensures n.hasConfig && !n.hasAllHeaders && n.hasHeaders ==> \\result === \"WARN\"\n //@ ensures n.hasConfig && !n.hasAllHeaders && !n.hasHeaders ==> \\result === \"FAIL\"\n if (!n.hasConfig) return \"FAIL\";\n if (n.hasAllHeaders) return \"PASS\";\n return n.hasHeaders ? \"WARN\" : \"FAIL\";\n}\n\n/**\n * next-optimize: optimizePackageImports set passes, else fails.\n *\n * @ensures exactly the model's OptimizeStatus\n */\nexport function optimizeStatus(n: NextFacts): Status {\n //@ verify\n //@ ensures \\result === (n.hasConfig && n.hasOptimize ? \"PASS\" : \"FAIL\")\n return n.hasConfig && n.hasOptimize ? \"PASS\" : \"FAIL\";\n}\n\n/**\n * next-strict: reactStrictMode set passes, else warns; skipped with no config.\n *\n * @ensures exactly the model's StrictStatus\n */\nexport function strictStatus(n: NextFacts): Status {\n //@ verify\n //@ ensures !n.hasConfig ==> \\result === \"SKIP\"\n //@ ensures n.hasConfig ==> \\result === (n.hasStrict ? \"PASS\" : \"WARN\")\n if (!n.hasConfig) return \"SKIP\";\n return n.hasStrict ? \"PASS\" : \"WARN\";\n}\n\n/**\n * image-loader: agr.media in next.config passes, else warns; skipped with no config.\n *\n * @ensures exactly the model's ImageLoaderStatus\n */\nexport function imageLoaderStatus(n: NextFacts): Status {\n //@ verify\n //@ ensures !n.hasConfig ==> \\result === \"SKIP\"\n //@ ensures n.hasConfig ==> \\result === (n.hasAgrMedia ? \"PASS\" : \"WARN\")\n if (!n.hasConfig) return \"SKIP\";\n return n.hasAgrMedia ? \"PASS\" : \"WARN\";\n}\n\n/**\n * contract-tests: present passes, else fails.\n *\n * @ensures exactly the model's ContractTestsStatus\n */\nexport function contractTestsStatus(present: boolean): Status {\n //@ verify\n //@ ensures \\result === (present ? \"PASS\" : \"FAIL\")\n return present ? \"PASS\" : \"FAIL\";\n}\n\n/**\n * no-wrapper: skipped without lib/; a client file that wraps AugurAPI fails.\n *\n * @ensures exactly the model's NoWrapperStatus\n */\nexport function noWrapperStatus(hasLib: boolean, wraps: boolean): Status {\n //@ verify\n //@ ensures !hasLib ==> \\result === \"SKIP\"\n //@ ensures hasLib ==> \\result === (wraps ? \"FAIL\" : \"PASS\")\n if (!hasLib) return \"SKIP\";\n return wraps ? \"FAIL\" : \"PASS\";\n}\n\n/**\n * auth: a factory passes; raw NextAuth fails; otherwise (or no auth file) warns.\n *\n * @ensures exactly the model's AuthStatus\n */\nexport function authStatus(found: boolean, usesFactory: boolean, rawNextAuth: boolean): Status {\n //@ verify\n //@ ensures found && usesFactory ==> \\result === \"PASS\"\n //@ ensures found && !usesFactory && rawNextAuth ==> \\result === \"FAIL\"\n //@ ensures !(found && usesFactory) && !(found && rawNextAuth) ==> \\result === \"WARN\"\n if (found && usesFactory) return \"PASS\";\n return found && rawNextAuth ? \"FAIL\" : \"WARN\";\n}\n\n/**\n * quality-script: typecheck, lint and test all named passes; incomplete warns; none fails.\n *\n * @ensures exactly the model's QualityStatus\n */\nexport function qualityStatus(hasScript: boolean, complete: boolean): Status {\n //@ verify\n //@ ensures !hasScript ==> \\result === \"FAIL\"\n //@ ensures hasScript ==> \\result === (complete ? \"PASS\" : \"WARN\")\n if (!hasScript) return \"FAIL\";\n return complete ? \"PASS\" : \"WARN\";\n}\n\n/**\n * pre-commit: lefthook's pre-commit section with lint-staged passes; else a suggestion.\n *\n * @ensures exactly the model's PreCommitStatus\n */\nexport function preCommitStatus(hasPreCommit: boolean, hasLintStaged: boolean): Status {\n //@ verify\n //@ ensures \\result === (hasPreCommit && hasLintStaged ? \"PASS\" : \"SUGGEST\")\n return hasPreCommit && hasLintStaged ? \"PASS\" : \"SUGGEST\";\n}\n\n/**\n * proxy-local-hooks: local useQuery hooks are a suggestion.\n *\n * @ensures exactly the model's LocalHooksStatus\n */\nexport function localHooksStatus(hasUseQuery: boolean): Status {\n //@ verify\n //@ ensures \\result === (hasUseQuery ? \"SUGGEST\" : \"PASS\")\n return hasUseQuery ? \"SUGGEST\" : \"PASS\";\n}\n\n/**\n * proxy-server-query: either proxy form passes, else a suggestion.\n *\n * @ensures exactly the model's ServerQueryStatus\n */\nexport function serverQueryStatus(usesServerProxy: boolean, usesAugurOptions: boolean): Status {\n //@ verify\n //@ ensures \\result === (usesServerProxy || usesAugurOptions ? \"PASS\" : \"SUGGEST\")\n return usesServerProxy || usesAugurOptions ? \"PASS\" : \"SUGGEST\";\n}\n\n/**\n * query-client-scope and query-gc-time: any offending file fails.\n *\n * @ensures exactly the model's NoOffenderStatus\n */\nexport function noOffenderStatus(offenders: number): Status {\n //@ verify\n //@ ensures \\result === (offenders > 0 ? \"FAIL\" : \"PASS\")\n return offenders > 0 ? \"FAIL\" : \"PASS\";\n}\n\n/**\n * An augur-api CalVer at or after 2026.3.7 has typed proxies.\n *\n * @ensures exactly the model's TypedProxyVersion\n */\nexport function typedProxyVersion(year: number, minor: number, patch: number): boolean {\n //@ verify\n //@ ensures \\result === (year > 2026 || (year === 2026 && minor > 3) || (year === 2026 && minor === 3 && patch >= 7))\n return (\n year > 2026 || (year === 2026 && minor > 3) || (year === 2026 && minor === 3 && patch >= 7)\n );\n}\n\n/**\n * api-version: a recognised, typed CalVer passes; anything else warns.\n *\n * @ensures exactly the model's ApiVersionStatus\n */\nexport function apiVersionStatus(\n parsed: boolean,\n year: number,\n minor: number,\n patch: number,\n): Status {\n //@ verify\n //@ ensures \\result === (parsed && typedProxyVersion(year, minor, patch) ? \"PASS\" : \"WARN\")\n return parsed && typedProxyVersion(year, minor, patch) ? \"PASS\" : \"WARN\";\n}\n\n/**\n * A range mark: ^ ~ > = < or whitespace (space, tab, line feed, carriage return).\n *\n * @ensures exactly the model's RangeMark on the code unit\n */\nexport function rangeMark(c: number): boolean {\n //@ verify\n //@ ensures \\result === (c === 94 || c === 126 || c === 62 || c === 61 || c === 60 || c === 32 || c === 9 || c === 10 || c === 13)\n return (\n c === 94 ||\n c === 126 ||\n c === 62 ||\n c === 61 ||\n c === 60 ||\n c === 32 ||\n c === 9 ||\n c === 10 ||\n c === 13\n );\n}\n\n/**\n * A range's version: its leading range marks stripped.\n *\n * @ensures exactly the model's StripRange\n */\nexport function stripRange(s: string): string {\n //@ verify\n //@ decreases s.length\n //@ ensures !rangeMark(codeAt(s, 0)) ==> \\result === s\n if (!rangeMark(codeAt(s, 0))) return s;\n return stripRange(s.slice(1));\n}\n\n/** One installed augur package against its own latest. */\nexport type PackageState = \"current\" | \"behind\" | \"unknown\";\n\n/**\n * A package's state: unknown when npm could not say (\"\" here), current when its range's\n * version is the latest, else behind.\n *\n * @ensures exactly the model's PackageStateOf\n */\nexport function packageStateOf(range: string, latest: string): PackageState {\n //@ verify\n //@ ensures latest === \"\" ==> \\result === \"unknown\"\n //@ ensures latest !== \"\" && stripRange(range) === latest ==> \\result === \"current\"\n //@ ensures latest !== \"\" && stripRange(range) !== latest ==> \\result === \"behind\"\n if (latest === \"\") return \"unknown\";\n return stripRange(range) === latest ? \"current\" : \"behind\";\n}\n\n/**\n * How many of the states from index `i` are `s`.\n *\n * @ensures exactly the model's CountState\n */\nexport function countStateFrom(states: PackageState[], s: PackageState, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires i >= 0\n //@ decreases states.length - i\n //@ ensures i >= states.length ==> \\result === 0\n //@ ensures i < states.length ==> \\result === (states[i] === s ? 1 : 0) + countStateFrom(states, s, i + 1)\n if (i >= states.length) return 0;\n return ((states[i] as PackageState) === s ? 1 : 0) + countStateFrom(states, s, i + 1);\n}\n\n/**\n * augur-version-latest: skipped with none installed; any package behind its own latest fails;\n * else any unknown skips; else passes.\n *\n * @ensures exactly the model's LatestStatus\n */\nexport function latestStatus(states: PackageState[]): Status {\n //@ verify\n //@ ensures states.length === 0 ==> \\result === \"SKIP\"\n //@ ensures states.length > 0 && countStateFrom(states, \"behind\", 0) > 0 ==> \\result === \"FAIL\"\n //@ ensures states.length > 0 && countStateFrom(states, \"behind\", 0) === 0 && countStateFrom(states, \"unknown\", 0) > 0 ==> \\result === \"SKIP\"\n //@ ensures states.length > 0 && countStateFrom(states, \"behind\", 0) === 0 && countStateFrom(states, \"unknown\", 0) === 0 ==> \\result === \"PASS\"\n if (states.length === 0) return \"SKIP\";\n if (countStateFrom(states, \"behind\", 0) > 0) return \"FAIL\";\n return countStateFrom(states, \"unknown\", 0) > 0 ? \"SKIP\" : \"PASS\";\n}\n\n/**\n * How many of the results from index `i` are `s`.\n *\n * @ensures exactly the model's CountStatus\n */\nexport function countStatusFrom(results: Status[], s: Status, i: number): number {\n //@ verify\n //@ type i nat\n //@ requires i >= 0\n //@ decreases results.length - i\n //@ ensures i >= results.length ==> \\result === 0\n //@ ensures i < results.length ==> \\result === (results[i] === s ? 1 : 0) + countStatusFrom(results, s, i + 1)\n if (i >= results.length) return 0;\n return ((results[i] as Status) === s ? 1 : 0) + countStatusFrom(results, s, i + 1);\n}\n\n/**\n * The scored total: skips and suggestions left out.\n *\n * @ensures exactly the model's ScoredTotal\n */\nexport function scoredTotal(results: Status[]): number {\n //@ verify\n //@ ensures \\result === results.length - countStatusFrom(results, \"SKIP\", 0) - countStatusFrom(results, \"SUGGEST\", 0)\n return (\n results.length - countStatusFrom(results, \"SKIP\", 0) - countStatusFrom(results, \"SUGGEST\", 0)\n );\n}\n\n/**\n * The exit code: 1 on any failure, else 0.\n *\n * @ensures exactly the model's ExitCode\n */\nexport function exitCodeOf(results: Status[]): number {\n //@ verify\n //@ ensures \\result === (countStatusFrom(results, \"FAIL\", 0) > 0 ? 1 : 0)\n return countStatusFrom(results, \"FAIL\", 0) > 0 ? 1 : 0;\n}\n\n/**\n * Lighthouse: a URL starting \"http\" is used as is; a path gets the base URL in front.\n *\n * @ensures exactly the model's ResolveUrl\n */\nexport function resolveUrl(u: string, baseUrl: string): string {\n //@ verify\n //@ ensures startsWithAt(u, \"http\", 0) ==> \\result === u\n //@ ensures !startsWithAt(u, \"http\", 0) ==> \\result === baseUrl + u\n return startsWithAt(u, \"http\", 0) ? u : baseUrl + u;\n}\n"],"mappings":"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","names":[]}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* augur-doctor's checks: each reads facts from the site through a {@link SiteReader} and takes
|
|
3
|
+
* its outcome from the proved rules (rules.ts). Labels and details are the original
|
|
4
|
+
* bin/augur-doctor.mjs text, except the version checks (no lockstep, owner 2026-11-05).
|
|
5
|
+
*/
|
|
6
|
+
import { type Status } from "./rules";
|
|
7
|
+
/** What the checks may ask of a site. Paths are relative to the site directory. */
|
|
8
|
+
export interface SiteReader {
|
|
9
|
+
/** Whether the path exists. */
|
|
10
|
+
exists(relPath: string): boolean;
|
|
11
|
+
/** The file's text, or null when it is missing. */
|
|
12
|
+
read(relPath: string): string | null;
|
|
13
|
+
/** The first of these names found walking up from the site to its git root: its path and text. */
|
|
14
|
+
readUpward(names: string[]): {
|
|
15
|
+
path: string;
|
|
16
|
+
content: string;
|
|
17
|
+
} | null;
|
|
18
|
+
/** The package's latest published version, or "" when npm cannot say. */
|
|
19
|
+
latestVersion(packageName: string): string;
|
|
20
|
+
}
|
|
21
|
+
/** One line of the scorecard. */
|
|
22
|
+
export interface CheckResult {
|
|
23
|
+
status: Status;
|
|
24
|
+
id: string;
|
|
25
|
+
label: string;
|
|
26
|
+
detail: string;
|
|
27
|
+
}
|
|
28
|
+
/** The augur packages a site may install; each is checked against its own latest. */
|
|
29
|
+
export declare const AUGUR_PACKAGES: string[];
|
|
30
|
+
/** The migration runbook on augur.build, which the scorecard and the checks' details link to. */
|
|
31
|
+
export declare const RUNBOOK = "https://augur.build/docs/packages/migration-runbook";
|
|
32
|
+
/** Every check, in the original order; the package.json checks only when there is one. */
|
|
33
|
+
export declare function runChecks(reader: SiteReader): CheckResult[];
|
|
34
|
+
//# sourceMappingURL=checks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../src/doctor/checks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EA6BL,KAAK,MAAM,EACZ,MAAM,SAAS,CAAC;AAEjB,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,mDAAmD;IACnD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,kGAAkG;IAClG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtE,yEAAyE;IACzE,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAgCD,qFAAqF;AACrF,eAAO,MAAM,cAAc,UAS1B,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,OAAO,wDAAwD,CAAC;AAymB7E,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE,CAmC3D"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/** augur-doctor's command line: `augur-doctor [site]` (the current directory by default). */
|
|
2
|
+
import { type SiteReader } from "./checks";
|
|
3
|
+
/** Where the CLI writes, and how it reads a site (the real file system by default). */
|
|
4
|
+
export interface CliIo {
|
|
5
|
+
log: (line: string) => void;
|
|
6
|
+
error: (line: string) => void;
|
|
7
|
+
reader?: (siteDir: string) => SiteReader;
|
|
8
|
+
}
|
|
9
|
+
/** Runs the doctor and returns its exit code: 1 for a missing site or any failing check. */
|
|
10
|
+
export declare function runDoctor(args: string[], io: CliIo): number;
|
|
11
|
+
//# sourceMappingURL=cli.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/doctor/cli.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAI7F,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAKtD,uFAAuF;AACvF,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,UAAU,CAAC;CAC1C;AAYD,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,MAAM,CAc3D"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/** The {@link SiteReader} over the real file system and npm. */
|
|
2
|
+
import type { SiteReader } from "./checks";
|
|
3
|
+
/** A package's latest published version from `npm view`, or "" when npm cannot say. */
|
|
4
|
+
declare function npmLatest(packageName: string): string;
|
|
5
|
+
export declare function nodeReader(siteDir: string, latestVersion?: typeof npmLatest): SiteReader;
|
|
6
|
+
export {};
|
|
7
|
+
//# sourceMappingURL=node-reader.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"node-reader.d.ts","sourceRoot":"","sources":["../../src/doctor/node-reader.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAKhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAe3C,uFAAuF;AACvF,iBAAS,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,mBAAY,GAAG,UAAU,CAWjF"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
/** augur-doctor's scorecard: the check results as terminal lines, grouped as before. */
|
|
2
|
+
import { type CheckResult } from "./checks";
|
|
3
|
+
/** The whole scorecard for a site. */
|
|
4
|
+
export declare function reportLines(siteName: string, siteDir: string, results: CheckResult[]): string[];
|
|
5
|
+
//# sourceMappingURL=report.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/doctor/report.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAExF,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AA8DrD,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAgB/F"}
|