@reddoorla/maintenance 0.9.0 → 0.10.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as Site, b as AuditResult, a as AuditName, c as RecipeResult, R as RecipeName, I as InventoryProvider } from './sync-configs-pMPW4wTq.js';
-export { C as ConfigName, d as SyncConfigsOptions, s as syncConfigs } from './sync-configs-pMPW4wTq.js';
+import { S as Site, b as AuditResult, a as AuditName, c as RecipeResult, R as RecipeName, I as InventoryProvider } from './sync-configs-Dn6KhjrW.js';
+export { C as ConfigName, d as SyncConfigsOptions, s as syncConfigs } from './sync-configs-Dn6KhjrW.js';
 import * as airtable_lib_airtable_base_js from 'airtable/lib/airtable_base.js';
 
 type SpawnResult = {
@@ -82,6 +82,63 @@ type OnboardOptions = {
 };
 declare function onboard(site: Site, opts?: OnboardOptions): Promise<RecipeResult>;
 
+/**
+ * Writes a starter `src/routes/dev/a11y-fixtures/+page.svelte` if the route
+ * doesn't already exist. The hardcoded URL in `src/configs/lighthouse.ts` +
+ * `src/configs/playwright-a11y.ts` targets this path — newly-onboarded sites
+ * need the route to exist for either audit to pass. Operator edits to an
+ * existing page are never clobbered (noop on existing file).
+ */
+declare function a11yFixturesPage(site: Site): Promise<RecipeResult>;
+
+type InitStepResult = {
+    kind: "recipe";
+    result: RecipeResult;
+} | {
+    kind: "audit";
+    results: AuditResult[];
+} | {
+    kind: "error";
+    message: string;
+};
+type InitStep = {
+    name: string;
+    run: (site: Site) => Promise<InitStepResult>;
+};
+type InitResult = {
+    site: string;
+    steps: Array<{
+        name: string;
+        result: InitStepResult;
+    }>;
+    /** True if every step ran; false if an `error` or `failed` recipe result
+     * short-circuited the chain. `noop` recipes do not break completeness. */
+    complete: boolean;
+};
+type InitOptions = {
+    /** Override the default step list. Tests inject mocked steps; production
+     * code relies on the default. */
+    steps?: InitStep[];
+};
+/** convert-to-pnpm → onboard → sync-configs → svelte-codemods →
+ * a11y-fixtures-page → audit. Order is deliberate — every step depends on
+ * the prior one's output (pnpm before onboard's installs, onboard's deps
+ * before sync-configs writes lighthouserc, fixtures page before audit
+ * actually has a route to hit). */
+declare const DEFAULT_INIT_STEPS: InitStep[];
+/**
+ * One-shot guided onboarding. Runs the default step sequence against a
+ * site, collecting per-step results into an InitResult. Each underlying
+ * recipe still creates its own branch — init is a thin orchestrator, not
+ * a branch-collapser; the operator ends up with one stack of branches per
+ * mutated step (recipes that noop don't branch).
+ *
+ * Stops the chain on the first uncaught error or `failed` recipe result.
+ * `noop` results are expected (e.g. running init twice) and continue the
+ * chain. The final audit pass runs if no prior step errored.
+ */
+declare function init(site: Site, opts?: InitOptions): Promise<InitResult>;
+
 declare const ALL_RECIPE_NAMES: RecipeName[];
 declare function isRecipeName(value: string): value is RecipeName;
 
@@ -294,4 +351,4 @@ type DueItem = {
  */
 declare function findDueReports(websites: WebsiteRow[], reports: ReportRow[], today: Date): DueItem[];
 
-export { ALL_AUDIT_NAMES, ALL_RECIPE_NAMES, type AirtableInventoryOptions, AuditName, AuditResult, type BumpDepsOptions, type ConvertToPnpmOptions, type DraftOptions, type DraftResult, type DueItem, type HeaderImage, InventoryProvider, type LighthouseScores, type LocalPathOptions, type OnboardAudit, type OnboardOptions, type OrchestrateOptions, RecipeName, RecipeResult, type RenderResult, type ReportData, type ReportType, Site, type UpgradeSvelte4to5Options, a11yAudit, bumpDeps, convertToPnpm, depsAudit, draftReportForSite, findDueReports, fromAirtableBase, fromJsonFile, isRecipeName, lighthouseAudit, lintAudit, localPath, onboard, renderReportHtml, runAudits, runAuditsAcross, securityAudit, sendApprovedReports, svelteCodemods, upgradeSvelte4to5 };
+export { ALL_AUDIT_NAMES, ALL_RECIPE_NAMES, type AirtableInventoryOptions, AuditName, AuditResult, type BumpDepsOptions, type ConvertToPnpmOptions, DEFAULT_INIT_STEPS, type DraftOptions, type DraftResult, type DueItem, type HeaderImage, type InitOptions, type InitResult, type InitStep, type InitStepResult, InventoryProvider, type LighthouseScores, type LocalPathOptions, type OnboardAudit, type OnboardOptions, type OrchestrateOptions, RecipeName, RecipeResult, type RenderResult, type ReportData, type ReportType, Site, type UpgradeSvelte4to5Options, a11yAudit, a11yFixturesPage, bumpDeps, convertToPnpm, depsAudit, draftReportForSite, findDueReports, fromAirtableBase, fromJsonFile, init, isRecipeName, lighthouseAudit, lintAudit, localPath, onboard, renderReportHtml, runAudits, runAuditsAcross, securityAudit, sendApprovedReports, svelteCodemods, upgradeSvelte4to5 };

package/dist/index.js

@@ -1908,6 +1908,116 @@ async function onboard(site, opts = {}) {
   });
 }
 
+// src/recipes/a11y-fixtures-page/index.ts
+import { access, mkdir, writeFile as writeFile9 } from "fs/promises";
+import { dirname as dirname2, join as join18 } from "path";
+
+// src/recipes/a11y-fixtures-page/template.ts
+var A11Y_FIXTURES_PAGE_RELATIVE = "src/routes/dev/a11y-fixtures/+page.svelte";
+var A11Y_FIXTURES_PAGE_TEMPLATE = `<svelte:head>
+  <title>a11y fixtures \u2014 Reddoor</title>
+  <meta
+    name="description"
+    content="Reddoor accessibility fixtures \u2014 semantic landmarks, heading hierarchy, and a stable target for @lhci/cli and Playwright + axe-core coverage. Not linked from the public site."
+  />
+</svelte:head>
+
+<main>
+  <header>
+    <h1>Accessibility fixtures</h1>
+    <p>
+      This page exists so <code>@lhci/cli</code> and Playwright + axe-core have a
+      stable target with predictable a11y characteristics. It is not linked from
+      the public site.
+    </p>
+  </header>
+
+  <section aria-labelledby="landmarks-heading">
+    <h2 id="landmarks-heading">Landmarks</h2>
+    <p>
+      A single <code>main</code> wraps the page; sections each declare
+      <code>aria-labelledby</code> matched to their heading id so screen readers
+      and axe both see a clean outline.
+    </p>
+  </section>
+
+  <section aria-labelledby="links-heading">
+    <h2 id="links-heading">Links</h2>
+    <p>
+      <a href="/">Back to home</a> \u2014 relative link with descriptive visible text,
+      so no <code>aria-label</code> override is needed.
+    </p>
+  </section>
+</main>
+`;
+
+// src/recipes/a11y-fixtures-page/index.ts
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function a11yFixturesPage(site) {
+  const target = join18(site.path, A11Y_FIXTURES_PAGE_RELATIVE);
+  return withRecipe({
+    name: "a11y-fixtures-page",
+    site,
+    plan: async () => {
+      if (await fileExists(target)) {
+        return { kind: "noop", notes: `${A11Y_FIXTURES_PAGE_RELATIVE} already exists` };
+      }
+      return { kind: "apply", plan: { target } };
+    },
+    apply: async (planned, { commit: commit2 }) => {
+      await mkdir(dirname2(planned.target), { recursive: true });
+      await writeFile9(planned.target, A11Y_FIXTURES_PAGE_TEMPLATE, "utf-8");
+      await commit2("feat: add /dev/a11y-fixtures starter route");
+      return { kind: "ok" };
+    }
+  });
+}
+
+// src/recipes/init.ts
+function recipeStep(name, fn) {
+  return {
+    name,
+    run: async (site) => ({ kind: "recipe", result: await fn(site) })
+  };
+}
+var DEFAULT_INIT_STEPS = [
+  recipeStep("convert-to-pnpm", convertToPnpm),
+  recipeStep("onboard", onboard),
+  recipeStep("sync-configs", syncConfigs),
+  recipeStep("svelte-codemods", svelteCodemods),
+  recipeStep("a11y-fixtures-page", a11yFixturesPage),
+  {
+    name: "audit",
+    run: async (site) => ({ kind: "audit", results: await runAudits(site) })
+  }
+];
+async function init(site, opts = {}) {
+  const steps = opts.steps ?? DEFAULT_INIT_STEPS;
+  const out = [];
+  for (const step of steps) {
+    let result;
+    try {
+      result = await step.run(site);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      out.push({ name: step.name, result: { kind: "error", message } });
+      return { site: siteLabel(site), steps: out, complete: false };
+    }
+    out.push({ name: step.name, result });
+    if (result.kind === "recipe" && result.result.status === "failed") {
+      return { site: siteLabel(site), steps: out, complete: false };
+    }
+  }
+  return { site: siteLabel(site), steps: out, complete: true };
+}
+
 // src/recipes/index.ts
 var ALL_RECIPE_NAMES = [
   "sync-configs",
@@ -1915,7 +2025,9 @@ var ALL_RECIPE_NAMES = [
   "svelte-4-to-5",
   "svelte-codemods",
   "convert-to-pnpm",
-  "onboard"
+  "onboard",
+  "a11y-fixtures-page",
+  "init"
 ];
 function isRecipeName(value) {
   return ALL_RECIPE_NAMES.includes(value);
@@ -2027,23 +2139,23 @@ function fromAirtableBase(base, opts = {}) {
 }
 
 // src/reports/draft.ts
-import { mkdir, writeFile as writeFile9 } from "fs/promises";
-import { dirname as dirname3 } from "path";
+import { mkdir as mkdir2, writeFile as writeFile10 } from "fs/promises";
+import { dirname as dirname4 } from "path";
 
 // src/reports/render.ts
 import mjml2html from "mjml";
 
 // src/reports/maintenance-email/assets/index.ts
 import { readFile as readFile11 } from "fs/promises";
-import { dirname as dirname2, join as join18 } from "path";
+import { dirname as dirname3, join as join19 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-var here = dirname2(fileURLToPath2(import.meta.url));
+var here = dirname3(fileURLToPath2(import.meta.url));
 var CHECK_CID = "rd-check-png";
 var BLURRED_CID = "rd-blurred-tests-jpg";
 async function loadBundledImages() {
   const [check, blurred] = await Promise.all([
-    readFile11(join18(here, "check.png")),
-    readFile11(join18(here, "blurredTests.jpg"))
+    readFile11(join19(here, "check.png")),
+    readFile11(join19(here, "blurredTests.jpg"))
   ]);
   return {
     check: {
@@ -2407,8 +2519,8 @@ async function draftReportForSite(base, siteRow, reportType, options = {}) {
   });
   if (options.previewOnly) {
     const path = options.previewPath ?? `reports/${slug}/draft.html`;
-    await mkdir(dirname3(path), { recursive: true });
-    await writeFile9(path, html, "utf-8");
+    await mkdir2(dirname4(path), { recursive: true });
+    await writeFile10(path, html, "utf-8");
     return { reportRow: null, htmlPath: path, html };
   }
   if (base === null) throw new Error("base required when previewOnly=false");
@@ -2674,7 +2786,9 @@ function findDueReports(websites, reports, today) {
 export {
   ALL_AUDIT_NAMES,
   ALL_RECIPE_NAMES,
+  DEFAULT_INIT_STEPS,
   a11yAudit,
+  a11yFixturesPage,
   bumpDeps,
   convertToPnpm,
   depsAudit,
@@ -2682,6 +2796,7 @@ export {
   findDueReports,
   fromAirtableBase,
   fromJsonFile,
+  init,
   isRecipeName,
   lighthouseAudit,
   lintAudit,