@hozu/cli 0.7.0 → 0.8.0

package/dist/commands/migrate-ast.js

@@ -0,0 +1,257 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire, stripTypeScriptTypes } from 'node:module';
+import { dirname, resolve } from 'node:path';
+const require = createRequire(import.meta.url);
+const acorn = createRequire(require.resolve('@hozu/transform'))('acorn');
+let warned = false;
+function strip(source) {
+    if (warned)
+        return stripTypeScriptTypes(source, { mode: 'strip' });
+    const emit = process.emitWarning;
+    process.emitWarning = () => { };
+    try {
+        return stripTypeScriptTypes(source, { mode: 'strip' });
+    }
+    finally {
+        process.emitWarning = emit;
+        warned = true;
+    }
+}
+/** Parses TypeScript with Node's type stripping; positions match `source`. */
+export function parse(source) {
+    return acorn.parse(strip(source), { ecmaVersion: 'latest', sourceType: 'module' });
+}
+const isNode = (v) => typeof v === 'object' && v !== null && typeof v.type === 'string';
+export const children = (n) => Object.entries(n).flatMap(([, v]) => (Array.isArray(v) ? v.filter(isNode) : isNode(v) ? [v] : []));
+export function walk(n, visit, parent = null) {
+    visit(n, parent);
+    for (const c of children(n))
+        walk(c, visit, n);
+}
+export function parents(program) {
+    const map = new Map();
+    walk(program, (n, p) => {
+        if (p)
+            map.set(n, p);
+    });
+    return map;
+}
+export const lineOf = (source, at) => source.slice(0, at).split('\n').length;
+export function apply(source, edits) {
+    let code = source;
+    let last = Number.POSITIVE_INFINITY;
+    const order = edits.map((edit, i) => [edit, i]);
+    for (const [[s, e, t]] of order.sort(([a, i], [b, j]) => b[0] - a[0] || b[1] - a[1] || j - i)) {
+        if (e > last)
+            continue;
+        code = code.slice(0, s) + t + code.slice(e);
+        last = s;
+    }
+    return code;
+}
+export const keyName = (p) => p.type !== 'Property' || p.computed
+    ? null
+    : p.key.type === 'Identifier'
+        ? p.key.name
+        : typeof p.key.value === 'string'
+            ? p.key.value
+            : null;
+export const property = (obj, name) => obj?.type === 'ObjectExpression' ? (obj.properties.find((p) => keyName(p) === name) ?? null) : null;
+/** Local names of the named imports from `from` (imported name → local name). */
+export function importsFrom(program, from) {
+    const out = new Map();
+    for (const s of program.body)
+        if (s.type === 'ImportDeclaration' &&
+            (typeof from === 'string' ? s.source.value === from : from.test(s.source.value)))
+            for (const x of s.specifiers)
+                if (x.type === 'ImportSpecifier')
+                    out.set(x.imported.name ?? x.imported.value, x.local.name);
+    return out;
+}
+/** `obj.name(...)` or `name(...)` where `obj` / `name` is the given local. */
+export const callOf = (n, object, name) => n?.type === 'CallExpression' &&
+    (object === null
+        ? n.callee.type === 'Identifier' && n.callee.name === name
+        : n.callee.type === 'MemberExpression' &&
+            !n.callee.computed &&
+            n.callee.object.type === 'Identifier' &&
+            n.callee.object.name === object &&
+            n.callee.property.name === name);
+/** The specifier texts of a named import as written, `type X` included (the parser sees stripped code). */
+export function importItems(source, decl) {
+    const text = source.slice(decl.start, decl.end);
+    const open = text.indexOf('{');
+    const close = text.indexOf('}', open);
+    if (open < 0 || close < 0)
+        return [];
+    return text
+        .slice(open + 1, close)
+        .split(',')
+        .map((x) => x.trim())
+        .filter(Boolean);
+}
+export const localOf = (item) => item
+    .replace(/^type\s+/, '')
+    .split(/\s+as\s+/)
+    .pop();
+const sortItems = (items) => [...items].sort((a, b) => localOf(a).localeCompare(localOf(b)));
+export function styleOf(source) {
+    const froms = [...source.matchAll(/^(?:import\b.*?\s|\}\s*)from\s+(['"])[^'"\n]*\1(;?)/gm)];
+    const doubles = froms.filter((m) => m[1] === '"').length;
+    const semis = froms.filter((m) => m[2] === ';').length;
+    const lines = source.split('\n');
+    const unit = lines
+        .map((l, i) => (/[{([]\s*$/.test(lines[i - 1] ?? '') ? /^(\t|[ ]+)\S/.exec(l)?.[1] : undefined))
+        .find((x) => x !== undefined);
+    const longest = Math.max(0, ...lines.map((l) => l.length));
+    return {
+        quote: froms.length && doubles * 2 > froms.length ? '"' : "'",
+        semi: froms.length && semis * 2 > froms.length ? ';' : '',
+        indent: unit ?? '  ',
+        width: Math.min(120, Math.max(80, longest)),
+    };
+}
+const PLAIN = { quote: "'", semi: '', indent: '  ', width: 110 };
+export function importText(items, from, style = PLAIN, multiline = false) {
+    const sorted = sortItems(items);
+    const tail = `} from ${style.quote}${from}${style.quote}${style.semi}`;
+    const one = `import { ${sorted.join(', ')} ${tail}`;
+    if (!multiline && one.length <= style.width)
+        return one;
+    return `import {\n${sorted.map((x) => `${style.indent}${x},`).join('\n')}\n${tail}`;
+}
+const bare = (from) => (from.startsWith('.') ? `1${from}` : `0${from}`);
+/** An edit that inserts a whole import line: in source order when the imports are sorted, else after the last. */
+export function insertImport(source, program, from, text) {
+    const imports = program.body.filter((s) => s.type === 'ImportDeclaration');
+    if (!imports.length)
+        return [0, 0, `${text}\n`];
+    const keys = imports.map((s) => bare(String(s.source.value)));
+    const sorted = keys.every((k, i) => i === 0 || keys[i - 1] <= k);
+    const next = sorted ? imports.find((_, i) => keys[i] > bare(from)) : undefined;
+    if (next)
+        return [next.start, next.start, `${text}\n`];
+    const last = imports[imports.length - 1];
+    return [last.end, last.end, `\n${text}`];
+}
+/** Adds names to the `import { … } from '<from>'` of a module, or a new import in its place among the imports. */
+export function addImport(source, program, from, names) {
+    const style = styleOf(source);
+    const decl = program.body.find((s) => s.type === 'ImportDeclaration' &&
+        s.source.value === from &&
+        s.importKind !== 'type' &&
+        s.specifiers.every((x) => x.type === 'ImportSpecifier') &&
+        source.slice(s.start, s.end).includes('{'));
+    if (decl) {
+        const items = importItems(source, decl);
+        const have = new Set(items.map(localOf));
+        const missing = names.filter((n) => !have.has(n));
+        if (!missing.length)
+            return null;
+        return [decl.start, decl.end, reimport(source, decl, [...items, ...missing], style)];
+    }
+    return insertImport(source, program, from, importText(names, from, style));
+}
+const reimport = (source, decl, items, style) => importText(items, decl.source.value, style, source.slice(decl.start, decl.end).includes('\n'));
+/** Keeps only the named specifiers `keep` accepts; drops the declaration when nothing is left. */
+export function filterImport(source, decl, keep) {
+    const items = importItems(source, decl);
+    const kept = items.filter((x) => keep(localOf(x)));
+    if (kept.length === items.length)
+        return null;
+    if (!kept.length) {
+        const end = source[decl.end] === '\n' ? decl.end + 1 : decl.end;
+        return [decl.start, end, ''];
+    }
+    return [decl.start, decl.end, reimport(source, decl, kept, styleOf(source))];
+}
+/** The leading whitespace of the line holding `at`. */
+export const indentAt = (source, at) => /^[ \t]*/.exec(source.slice(source.lastIndexOf('\n', at - 1) + 1))[0];
+const cache = new Map();
+export const forget = () => cache.clear();
+export function module(file) {
+    if (!cache.has(file)) {
+        if (!existsSync(file))
+            cache.set(file, null);
+        else {
+            const source = readFileSync(file, 'utf8');
+            try {
+                cache.set(file, { source, program: parse(source) });
+            }
+            catch {
+                cache.set(file, null);
+            }
+        }
+    }
+    return cache.get(file) ?? null;
+}
+function exported(program, name) {
+    for (const s of program.body) {
+        const d = s.type === 'ExportNamedDeclaration' ? s.declaration : s;
+        if (d?.type === 'FunctionDeclaration' && d.id?.name === name)
+            return d;
+        if (d?.type === 'VariableDeclaration')
+            for (const v of d.declarations)
+                if (v.id.type === 'Identifier' && v.id.name === name && v.init)
+                    return v.init;
+    }
+    return null;
+}
+/** The initializer of `name` as seen from `file`: a local const, a named import or `ns.name`. */
+export function declaration(file, program, ref, depth = 0) {
+    if (depth > 4)
+        return null;
+    const here = module(file);
+    const at = (target, name) => {
+        const m = module(target);
+        if (!m)
+            return null;
+        const init = exported(m.program, name);
+        if (init)
+            return { file: target, source: m.source, program: m.program, init };
+        for (const s of m.program.body)
+            if (s.type === 'ExportNamedDeclaration' && s.source)
+                for (const x of s.specifiers)
+                    if ((x.exported.name ?? x.exported.value) === name)
+                        return (declaration(target, m.program, { type: 'Identifier', name: x.local.name, start: 0, end: 0 }, depth + 1) ?? at(resolve(dirname(target), s.source.value), x.local.name));
+        return null;
+    };
+    const lookup = (name, member) => {
+        for (const s of program.body) {
+            if (s.type !== 'ImportDeclaration' || !String(s.source.value).startsWith('.'))
+                continue;
+            const target = resolve(dirname(file), s.source.value);
+            for (const x of s.specifiers) {
+                if (x.local.name !== name)
+                    continue;
+                if (x.type === 'ImportNamespaceSpecifier')
+                    return member ? at(target, member) : null;
+                if (x.type === 'ImportSpecifier' && !member)
+                    return at(target, x.imported.name ?? x.imported.value);
+            }
+        }
+        if (member)
+            return null;
+        const init = exported(program, name);
+        return init && here ? { file, source: here.source, program, init } : null;
+    };
+    if (ref.type === 'Identifier')
+        return lookup(ref.name, null);
+    if (ref.type === 'MemberExpression' && !ref.computed && ref.object.type === 'Identifier')
+        return lookup(ref.object.name, ref.property.name);
+    return null;
+}
+export const literal = (n) => {
+    if (!n)
+        return null;
+    if (n.type === 'Literal')
+        return { value: n.value };
+    if (n.type === 'TemplateLiteral' && n.expressions.length === 0)
+        return { value: n.quasis[0].value.cooked };
+    if (n.type === 'UnaryExpression' && n.operator === '-' && n.argument.type === 'Literal')
+        return typeof n.argument.value === 'number' ? { value: -n.argument.value } : null;
+    if (n.type === 'Identifier' && n.name === 'undefined')
+        return { value: undefined };
+    return null;
+};
+//# sourceMappingURL=migrate-ast.js.map

package/dist/commands/migrate-ast.js.map

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

package/dist/commands/migrate-forms.d.ts

@@ -0,0 +1,4 @@
+import { type Rewrite } from './migrate-ast.ts';
+/** A string `form` attribute and the form with that `id` → one `ui.formRef()` (ADR 0043 C). */
+export declare function migrateForms(source: string, file: string): Rewrite;
+//# sourceMappingURL=migrate-forms.d.ts.map

package/dist/commands/migrate-forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-forms.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAYL,KAAK,OAAO,EAEb,MAAM,kBAAkB,CAAA;AAQzB,+FAA+F;AAC/F,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAmFlE"}

package/dist/commands/migrate-forms.js

@@ -0,0 +1,120 @@
+import { apply, declaration, filterImport, importsFrom, lineOf, literal, parse, property, walk, } from './migrate-ast.js';
+const identifier = (s) => {
+    const words = s.split(/[^A-Za-z0-9]+/).filter(Boolean);
+    const name = words.map((w, i) => (i ? w[0].toUpperCase() + w.slice(1) : w)).join('');
+    return /^[A-Za-z_]/.test(name) ? name : `form${name}`;
+};
+/** A string `form` attribute and the form with that `id` → one `ui.formRef()` (ADR 0043 C). */
+export function migrateForms(source, file) {
+    if (!/\bform\s*:/.test(source))
+        return { code: source, notes: [] };
+    const program = parse(source);
+    const ui = importsFrom(program, '@hozu/core').get('ui');
+    if (!ui)
+        return { code: source, notes: [] };
+    const text = (n) => {
+        const l = literal(n);
+        if (l)
+            return typeof l.value === 'string' ? l.value : null;
+        const d = declaration(file, program, n);
+        const v = d ? literal(d.init) : null;
+        return typeof v?.value === 'string' ? v.value : null;
+    };
+    const element = (n) => n.type === 'CallExpression' &&
+        n.callee.type === 'MemberExpression' &&
+        n.callee.object.type === 'Identifier' &&
+        n.callee.object.name === ui &&
+        !n.callee.computed;
+    const controls = [];
+    const forms = new Map();
+    walk(program, (n) => {
+        if (!element(n) || n.arguments[0]?.type !== 'ObjectExpression')
+            return;
+        const tag = n.callee.property.name;
+        if (tag === 'form') {
+            const id = property(n.arguments[0], 'id');
+            const v = id ? text(id.value) : null;
+            if (id && v !== null)
+                forms.set(v, [...(forms.get(v) ?? []), id]);
+            return;
+        }
+        const form = property(n.arguments[0], 'form');
+        const v = form ? text(form.value) : null;
+        if (form && v !== null)
+            controls.push({ prop: form, value: v });
+    });
+    if (!controls.length)
+        return { code: source, notes: [] };
+    const notes = [];
+    const edits = [];
+    const taken = new Set();
+    walk(program, (n) => {
+        if (n.type === 'Identifier')
+            taken.add(n.name);
+    });
+    const refs = new Map();
+    const replaced = new Set();
+    for (const { prop, value } of controls) {
+        const owners = forms.get(value) ?? [];
+        if (owners.length !== 1) {
+            notes.push({
+                file,
+                line: lineOf(source, prop.start),
+                rule: 'form',
+                message: owners.length
+                    ? `form: '${value}' names ${owners.length} forms in this module: declare one ui.formRef() per form by hand`
+                    : `form: '${value}' names no form of this module: declare a ui.formRef() and hold it with ui.form({ ref }) (HZ014)`,
+                see: 'forms',
+            });
+            continue;
+        }
+        let name = refs.get(value);
+        if (!name) {
+            name = identifier(value);
+            while (taken.has(name))
+                name = `${name}Form`;
+            taken.add(name);
+            refs.set(value, name);
+            edits.push([owners[0].start, owners[0].end, `ref: ${name}`]);
+            if (owners[0].value.type === 'Identifier')
+                replaced.add(owners[0].value.name);
+        }
+        if (prop.value.type === 'Identifier')
+            replaced.add(prop.value.name);
+        edits.push([prop.value.start, prop.value.end, name]);
+        notes.push({
+            file,
+            line: lineOf(source, prop.start),
+            rule: 'form',
+            message: `form: '${value}' → ui.formRef() ${name}`,
+            see: 'forms',
+        });
+    }
+    if (!refs.size)
+        return { code: source, notes };
+    const decls = [...refs.values()].map((n) => `const ${n} = ${ui}.formRef()`).join('\n');
+    const imports = program.body.filter((s) => s.type === 'ImportDeclaration');
+    const at = imports.length ? imports[imports.length - 1].end : 0;
+    edits.push([at, at, `\n\n${decls}`]);
+    let code = apply(source, edits);
+    code = dropUnused(code, replaced);
+    return { code, notes };
+}
+function dropUnused(code, names) {
+    const program = parse(code);
+    const used = new Set();
+    walk(program, (n, p) => {
+        if (n.type === 'Identifier' && p?.type !== 'ImportSpecifier')
+            used.add(n.name);
+    });
+    const edits = [];
+    for (const s of program.body) {
+        if (s.type !== 'ImportDeclaration' || !String(s.source.value).startsWith('.'))
+            continue;
+        const e = filterImport(code, s, (local) => used.has(local) || !names.has(local));
+        if (e)
+            edits.push(e);
+    }
+    return apply(code, edits);
+}
+//# sourceMappingURL=migrate-forms.js.map

package/dist/commands/migrate-forms.js.map

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

package/dist/commands/migrate-freshness.d.ts

@@ -0,0 +1,4 @@
+import { type Rewrite } from './migrate-ast.ts';
+/** User-scoped `'static'`, `{ revalidate }` and `{ swr }` → `'request'` (ADR 0043 A, HZ049). */
+export declare function migrateFreshness(source: string, file: string): Rewrite;
+//# sourceMappingURL=migrate-freshness.d.ts.map

package/dist/commands/migrate-freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-freshness.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-freshness.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,OAAO,EAEb,MAAM,kBAAkB,CAAA;AAEzB,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAuCtE"}

package/dist/commands/migrate-freshness.js

@@ -0,0 +1,47 @@
+import { apply, callOf, importsFrom, lineOf, parse, property, walk, } from './migrate-ast.js';
+/** User-scoped `'static'`, `{ revalidate }` and `{ swr }` → `'request'` (ADR 0043 A, HZ049). */
+export function migrateFreshness(source, file) {
+    if (!/\bscope\s*:\s*['"]user['"]/.test(source))
+        return { code: source, notes: [] };
+    const program = parse(source);
+    const query = importsFrom(program, '@hozu/core').get('query');
+    if (!query)
+        return { code: source, notes: [] };
+    const notes = [];
+    const edits = [];
+    walk(program, (n) => {
+        if (!callOf(n, null, query))
+            return;
+        const options = n.arguments[0];
+        const scope = property(options, 'scope');
+        const freshness = property(options, 'freshness');
+        if (scope?.value.type !== 'Literal' || scope.value.value !== 'user' || !freshness)
+            return;
+        const v = freshness.value;
+        if (v.type === 'Literal' && (v.value === 'request' || v.value === 'live'))
+            return;
+        const was = source.slice(v.start, v.end);
+        const known = (v.type === 'Literal' && v.value === 'static') ||
+            (v.type === 'ObjectExpression' && (property(v, 'revalidate') || property(v, 'swr')));
+        if (!known) {
+            notes.push({
+                file,
+                line: lineOf(source, n.start),
+                rule: 'freshness',
+                message: `user-scoped freshness ${was} is not a literal: use 'request' (or 'live' for push), HZ049`,
+                see: 'data',
+            });
+            return;
+        }
+        edits.push([v.start, v.end, `'request'`]);
+        notes.push({
+            file,
+            line: lineOf(source, n.start),
+            rule: 'freshness',
+            message: `user-scoped freshness ${was} → 'request': user data is read on every request`,
+            see: 'data',
+        });
+    });
+    return { code: apply(source, edits), notes };
+}
+//# sourceMappingURL=migrate-freshness.js.map

package/dist/commands/migrate-freshness.js.map

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

package/dist/commands/migrate-head.d.ts

@@ -0,0 +1,8 @@
+import { type Edit, type Node, type Rewrite } from './migrate-ast.ts';
+export declare function suggestion(error: string): string | null;
+/** Adds `text` as the last property of an object literal, matching its layout. */
+export declare function insertProperty(source: string, obj: Node, text: string): Edit;
+export declare function errorsOf(file: string, program: Node, query: Node): string[] | null;
+/** `head.redirects` → `head.failed`, exhaustive; an unmapped error gets 404, the 0.7 status (ADR 0043 D). */
+export declare function migrateHead(source: string, file: string): Rewrite;
+//# sourceMappingURL=migrate-head.d.ts.map

package/dist/commands/migrate-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-head.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-head.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,IAAI,EAGT,KAAK,IAAI,EAIT,KAAK,OAAO,EAEb,MAAM,kBAAkB,CAAA;AAQzB,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvD;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAa5E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,GAAG,IAAI,CASlF;AAED,6GAA6G;AAC7G,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAiFjE"}

package/dist/commands/migrate-head.js

@@ -0,0 +1,132 @@
+import { apply, declaration, keyName, lineOf, parse, property, walk, } from './migrate-ast.js';
+const SUGGEST = [
+    [/forbidden|denied|notallowed|admin/i, '403'],
+    [/gone|deleted|removed|archived|expired/i, '410'],
+    [/unauthori[sz]ed|unauthenticated|signedout|signin|login|session/i, 'a sign-in route'],
+];
+export function suggestion(error) {
+    for (const [re, status] of SUGGEST)
+        if (re.test(error))
+            return status;
+    return null;
+}
+/** Adds `text` as the last property of an object literal, matching its layout. */
+export function insertProperty(source, obj, text) {
+    const last = obj.properties[obj.properties.length - 1];
+    if (!last)
+        return [obj.start + 1, obj.end - 1, ` ${text} `];
+    const after = source.slice(last.end).match(/^\s*,/);
+    const multiline = source.slice(obj.start, obj.end).includes('\n');
+    const lineStart = source.lastIndexOf('\n', last.start) + 1;
+    const indent = source.slice(lineStart, last.start).match(/^\s*/)[0];
+    if (!multiline)
+        return [last.end, last.end, `, ${text}`];
+    if (after) {
+        const at = last.end + after[0].length;
+        return [at, at, `\n${indent}${text},`];
+    }
+    return [last.end, last.end, `,\n${indent}${text}`];
+}
+export function errorsOf(file, program, query) {
+    const decl = declaration(file, program, query);
+    if (decl?.init.type !== 'CallExpression')
+        return null;
+    const options = decl.init.arguments[0];
+    const errors = property(options, 'errors');
+    if (!errors)
+        return options?.type === 'ObjectExpression' ? [] : null;
+    if (errors.value.type !== 'ObjectExpression')
+        return null;
+    const names = errors.value.properties.map(keyName);
+    return names.includes(null) ? null : names;
+}
+/** `head.redirects` → `head.failed`, exhaustive; an unmapped error gets 404, the 0.7 status (ADR 0043 D). */
+export function migrateHead(source, file) {
+    if (!/\bhead\s*:/.test(source))
+        return { code: source, notes: [] };
+    const program = parse(source);
+    const notes = [];
+    const edits = [];
+    walk(program, (n) => {
+        if (n.type !== 'Property' || keyName(n) !== 'head' || n.value.type !== 'ObjectExpression')
+            return;
+        const head = n.value;
+        const query = property(head, 'query');
+        const redirects = property(head, 'redirects');
+        if ((!query && !redirects) || property(head, 'failed'))
+            return;
+        const line = lineOf(source, head.start);
+        const mapped = [];
+        if (redirects) {
+            if (redirects.value.type !== 'ObjectExpression') {
+                notes.push({
+                    file,
+                    line,
+                    rule: 'head',
+                    message: 'head.redirects is not an object literal: write head.failed by hand',
+                    see: 'pages',
+                });
+                return;
+            }
+            for (const p of redirects.value.properties) {
+                const k = keyName(p);
+                if (!k)
+                    continue;
+                mapped.push([source.slice(p.key.start, p.key.end), source.slice(p.value.start, p.value.end)]);
+            }
+        }
+        const errors = query ? errorsOf(file, program, query.value) : [];
+        if (errors === null) {
+            notes.push({
+                file,
+                line,
+                rule: 'head',
+                message: `cannot read the errors of the head query ${source.slice(query.value.start, query.value.end)}: map each one in head.failed (HZ051 lists them)`,
+                see: 'pages',
+            });
+            if (redirects)
+                edits.push([redirects.key.start, redirects.key.end, 'failed']);
+            return;
+        }
+        const names = new Set(mapped.map(([k]) => k.replace(/^['"]|['"]$/g, '')));
+        const filled = errors.filter((e) => !names.has(e));
+        for (const e of filled) {
+            const hint = suggestion(e);
+            notes.push({
+                file,
+                line,
+                rule: 'head',
+                message: hint
+                    ? `head.failed ${e}: 404 filled (the 0.7 status); the name suggests ${hint}`
+                    : `head.failed ${e}: 404 filled (the 0.7 status)`,
+                see: 'pages',
+                behaviour: false,
+            });
+        }
+        const entries = [...mapped.map(([k, v]) => `${k}: ${v}`), ...filled.map((e) => `${e}: 404`)];
+        const text = `failed: { ${entries.join(', ')} }`;
+        if (entries.length)
+            notes.push({
+                file,
+                line,
+                rule: 'head',
+                message: `head.${redirects ? 'redirects' : 'failed'} → ${text}`,
+                see: 'pages',
+            });
+        if (redirects) {
+            if (entries.length)
+                edits.push([redirects.start, redirects.end, text]);
+            else {
+                const props = head.properties;
+                const i = props.indexOf(redirects);
+                edits.push(i > 0
+                    ? [props[i - 1].end, redirects.end, '']
+                    : [redirects.start, props[1]?.start ?? redirects.end, '']);
+            }
+        }
+        else if (entries.length)
+            edits.push(insertProperty(source, head, text));
+    });
+    return { code: apply(source, edits), notes };
+}
+//# sourceMappingURL=migrate-head.js.map