@aglyn/plugins-ai 1.0.0-beta.264 → 1.0.0-beta.268

package/src/lib/jobs/ai-empty-site-sweep.d.ts

@@ -0,0 +1,154 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type PluginSiteEraseRequest, type PluginSiteEraseResult } from '@aglyn/aglyn/plugin-manager/plugin-site-erase';
+import type { AiJob } from '../model/ai-jobs.types';
+/**
+ * THE EMPTY SITE A GUIDED START LEFT IS REMOVED (AGL-3936).
+ *
+ * Since AGL-3859 a site is created only when its start is admitted: the
+ * starter, Skip, or "Plan my site". A site start cancelled or failed before
+ * it built anything leaves that site with no page, public, answering "This
+ * site is coming soon". The build page offers Start again, Try again and Use
+ * the starter, and a person who leaves without choosing used to leave the
+ * placeholder behind for good (kc-x-carder 2026-10-15, cancelled 13 s in;
+ * pflomo 2026-10-17, 35 s in).
+ *
+ * So when a site job settles `canceled` or `failed` with nothing built, a due
+ * marker is written, `aiEmptySiteSweeps/{hostId}`, an hour out. The AI jobs
+ * beat reads the markers that are due, a few a beat, and checks every
+ * condition again at that moment; only a site that is still truly empty is
+ * deleted, through `core.site-erase` — the console's own delete path, so the
+ * subdomain, the routing index, the org's site count, the members' rows and
+ * the cache all go as they do for a site its admin deletes. Anything a person
+ * did in the hour keeps the site and drops the marker. The starter is never
+ * written for them: the starter is written only when a person chooses it.
+ *
+ * The marker is server-only (the rules deny every client), holds ids and
+ * instants and nothing a person wrote, and is deleted once it is decided.
+ */
+/** The due markers, top level, one per site, keyed by the site's id. */
+export declare const AI_EMPTY_SITE_SWEEPS_COLLECTION = "aiEmptySiteSweeps";
+/** How long a person has to come back and choose before the empty site goes. */
+export declare const AI_EMPTY_SITE_GRACE_MS: number;
+/** Markers one beat decides; the rest wait for the next minute's beat. */
+export declare const AI_EMPTY_SITE_SWEEP_MAX = 3;
+/** Wall clock one beat gives the removals before it runs any job's step. */
+export declare const AI_EMPTY_SITE_SWEEP_BUDGET_MS = 20000;
+/** A removal the eraser could not make is tried again this much later. */
+export declare const AI_EMPTY_SITE_RETRY_MS: number;
+/** Removals tried this many times without an answer are given up and logged. */
+export declare const AI_EMPTY_SITE_MAX_ATTEMPTS = 5;
+/** The workspace feed's words for it; the feed names the site beside them. */
+export declare const AI_EMPTY_SITE_ACTIVITY = "Removed an empty site";
+/** Why, on the staff audit row. */
+export declare const AI_EMPTY_SITE_REASON = "ai-start-empty";
+/**
+ * What a site holds that a person, or a start, put there. One document in
+ * any of them keeps the site: pages and emails (`screens`), layouts, forms,
+ * media, components, templates, content collections, redirects and plugin
+ * settings. `activity` and the visitors' `analytics` beacon are not on the
+ * list, and are read on their own terms below.
+ */
+export declare const AI_EMPTY_SITE_CONTENT_COLLECTIONS: readonly ["screens", "layouts", "forms", "media", "components", "templates", "collections", "redirects", "pluginSettings"];
+type Firestore = FirebaseFirestore.Firestore;
+/** The due marker, as stored. */
+export interface AiEmptySiteSweep {
+    hostId: string;
+    orgId: string;
+    jobId: string;
+    /** What the job ended as. */
+    status: 'canceled' | 'failed';
+    settledAt: Date;
+    dueAt: Date;
+    attempts: number;
+}
+/**
+ * Whether a job leaves the empty site this sweep is for: a site start that
+ * ended `canceled` or `failed` with nothing built — no output but the
+ * site's listing proposal, which rides out with the first unit and builds
+ * nothing (the rule `aiSiteStarterFallbackOffered` offers the starter by).
+ */
+export declare function aiJobLeavesEmptySite(job: Pick<AiJob, 'kind' | 'status' | 'hostId' | 'outputs' | 'siteRemoved'>): boolean;
+/**
+ * Writes the due marker for a job that just ended, when it leaves an empty
+ * site. Never throws: a marker that could not be written leaves the site as
+ * it was before this existed, and must not fail the write it follows.
+ */
+export declare function scheduleAiEmptySiteSweep(firestore: Firestore, job: Pick<AiJob, '$id' | 'orgId' | 'kind' | 'status' | 'hostId' | 'outputs' | 'siteRemoved'>, now?: Date): Promise<boolean>;
+/**
+ * Drops a site's marker: a job started, resumed or retried on the site, so
+ * it is not empty for long. Never throws; the beat's check at due time says
+ * the same thing if this write is lost.
+ */
+export declare function clearAiEmptySiteSweep(firestore: Firestore, hostId: string | null | undefined): Promise<void>;
+/** What the check at due time found. */
+export type AiEmptySiteVerdict = {
+    kind: 'empty';
+    name: string | null;
+}
+/** The job settled again after the marker was written: wait a full grace from then. */
+ | {
+    kind: 'later';
+    dueAt: Date;
+}
+/** The site is kept; the marker is dropped. */
+ | {
+    kind: 'keep';
+    reason: string;
+};
+/**
+ * Every condition, read again as the site is now (AGL-3936). The site is
+ * removed only when all of them hold:
+ *
+ * - it exists, in the marker's workspace, with no custom domain, no sending
+ *   domain, no page on its routing map, and no staff hold;
+ * - the job is still the one that ended, still `canceled` or `failed`, and
+ *   still built nothing — not resumed, retried or finished since;
+ * - no other AI job names the site;
+ * - nothing in {@link AI_EMPTY_SITE_CONTENT_COLLECTIONS}: no page, email,
+ *   layout, form or media file;
+ * - the site's own feed holds nothing but "Created the site" and the AI
+ *   job's own `ai.job.*` entries: nobody edited it.
+ */
+export declare function aiEmptySiteVerdict(firestore: Firestore, marker: Pick<AiEmptySiteSweep, 'hostId' | 'orgId' | 'jobId' | 'dueAt'>): Promise<AiEmptySiteVerdict>;
+export interface AiEmptySiteSweepResult {
+    /** Markers that were due. */
+    due: number;
+    /** Sites removed. */
+    removed: number;
+    /** Markers dropped because the site was kept, or was already gone. */
+    kept: number;
+    /** Markers moved later: the job settled again, or the eraser did not answer. */
+    later: number;
+}
+export interface SweepAiEmptySitesOptions {
+    firestore: Firestore;
+    now?: () => number;
+    max?: number;
+    budgetMs?: number;
+    /** The site's removal; `core.site-erase` unless a spec replaces it. */
+    erase?: (request: PluginSiteEraseRequest) => Promise<PluginSiteEraseResult>;
+}
+/**
+ * One beat's removals (AGL-3936): the markers due now, oldest first, a few
+ * at a time and inside a few seconds of wall clock, each decided against the
+ * site as it is at that moment. The marker goes once it is decided; one the
+ * eraser could not answer is tried again later, and given up after
+ * {@link AI_EMPTY_SITE_MAX_ATTEMPTS}.
+ */
+export declare function sweepAiEmptySites(options: SweepAiEmptySitesOptions): Promise<AiEmptySiteSweepResult>;
+export {};

package/src/lib/jobs/ai-empty-site-sweep.js

@@ -0,0 +1,346 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { erasePluginSite } from "@aglyn/aglyn/plugin-manager/plugin-site-erase";
+/**
+ * THE EMPTY SITE A GUIDED START LEFT IS REMOVED (AGL-3936).
+ *
+ * Since AGL-3859 a site is created only when its start is admitted: the
+ * starter, Skip, or "Plan my site". A site start cancelled or failed before
+ * it built anything leaves that site with no page, public, answering "This
+ * site is coming soon". The build page offers Start again, Try again and Use
+ * the starter, and a person who leaves without choosing used to leave the
+ * placeholder behind for good (kc-x-carder 2026-10-15, cancelled 13 s in;
+ * pflomo 2026-10-17, 35 s in).
+ *
+ * So when a site job settles `canceled` or `failed` with nothing built, a due
+ * marker is written, `aiEmptySiteSweeps/{hostId}`, an hour out. The AI jobs
+ * beat reads the markers that are due, a few a beat, and checks every
+ * condition again at that moment; only a site that is still truly empty is
+ * deleted, through `core.site-erase` — the console's own delete path, so the
+ * subdomain, the routing index, the org's site count, the members' rows and
+ * the cache all go as they do for a site its admin deletes. Anything a person
+ * did in the hour keeps the site and drops the marker. The starter is never
+ * written for them: the starter is written only when a person chooses it.
+ *
+ * The marker is server-only (the rules deny every client), holds ids and
+ * instants and nothing a person wrote, and is deleted once it is decided.
+ */ /** The due markers, top level, one per site, keyed by the site's id. */ export const AI_EMPTY_SITE_SWEEPS_COLLECTION = 'aiEmptySiteSweeps';
+/** How long a person has to come back and choose before the empty site goes. */ export const AI_EMPTY_SITE_GRACE_MS = 60 * 60000;
+/** Markers one beat decides; the rest wait for the next minute's beat. */ export const AI_EMPTY_SITE_SWEEP_MAX = 3;
+/** Wall clock one beat gives the removals before it runs any job's step. */ export const AI_EMPTY_SITE_SWEEP_BUDGET_MS = 20000;
+/** A removal the eraser could not make is tried again this much later. */ export const AI_EMPTY_SITE_RETRY_MS = 15 * 60000;
+/** Removals tried this many times without an answer are given up and logged. */ export const AI_EMPTY_SITE_MAX_ATTEMPTS = 5;
+/** The workspace feed's words for it; the feed names the site beside them. */ export const AI_EMPTY_SITE_ACTIVITY = 'Removed an empty site';
+/** Why, on the staff audit row. */ export const AI_EMPTY_SITE_REASON = 'ai-start-empty';
+/** The org's jobs, as `AI_JOBS_COLLECTION` in `ai-jobs.ts` names them (that module imports this one). */ const JOBS_COLLECTION = 'aiJobs';
+/**
+ * What a site holds that a person, or a start, put there. One document in
+ * any of them keeps the site: pages and emails (`screens`), layouts, forms,
+ * media, components, templates, content collections, redirects and plugin
+ * settings. `activity` and the visitors' `analytics` beacon are not on the
+ * list, and are read on their own terms below.
+ */ export const AI_EMPTY_SITE_CONTENT_COLLECTIONS = [
+    'screens',
+    'layouts',
+    'forms',
+    'media',
+    'components',
+    'templates',
+    'collections',
+    'redirects',
+    'pluginSettings'
+];
+/** The site's own feed entries that are not a person editing it. */ const UNEDITED_ACTIVITY = new Set([
+    'Created the site'
+]);
+/** More feed entries than this and the site was worked on. */ const ACTIVITY_SCAN = 20;
+function toMillis(value) {
+    if (value === null || value === undefined) return null;
+    if (value instanceof Date) return value.getTime();
+    if (typeof value === 'number') return value;
+    if (typeof value === 'string') {
+        const parsed = Date.parse(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return typeof value.toMillis === 'function' ? value.toMillis() : null;
+}
+/**
+ * Whether a job leaves the empty site this sweep is for: a site start that
+ * ended `canceled` or `failed` with nothing built — no output but the
+ * site's listing proposal, which rides out with the first unit and builds
+ * nothing (the rule `aiSiteStarterFallbackOffered` offers the starter by).
+ */ export function aiJobLeavesEmptySite(job) {
+    var _job_outputs;
+    if (job.kind !== 'site' || !job.hostId || job.siteRemoved) return false;
+    if (job.status !== 'canceled' && job.status !== 'failed') return false;
+    return ((_job_outputs = job.outputs) != null ? _job_outputs : []).every((output)=>output.resource === 'seo');
+}
+/**
+ * Writes the due marker for a job that just ended, when it leaves an empty
+ * site. Never throws: a marker that could not be written leaves the site as
+ * it was before this existed, and must not fail the write it follows.
+ */ export async function scheduleAiEmptySiteSweep(firestore, job, now = new Date()) {
+    if (!aiJobLeavesEmptySite(job) || !job.hostId) return false;
+    const marker = {
+        hostId: job.hostId,
+        orgId: job.orgId,
+        jobId: job.$id,
+        status: job.status,
+        settledAt: now,
+        dueAt: new Date(now.getTime() + AI_EMPTY_SITE_GRACE_MS),
+        attempts: 0
+    };
+    try {
+        await firestore.collection(AI_EMPTY_SITE_SWEEPS_COLLECTION).doc(job.hostId).set(marker);
+        return true;
+    } catch (error) {
+        console.warn('ai empty site: the removal could not be scheduled', {
+            orgId: job.orgId,
+            jobId: job.$id,
+            hostId: job.hostId,
+            error: error instanceof Error ? error.message : String(error)
+        });
+        return false;
+    }
+}
+/**
+ * Drops a site's marker: a job started, resumed or retried on the site, so
+ * it is not empty for long. Never throws; the beat's check at due time says
+ * the same thing if this write is lost.
+ */ export async function clearAiEmptySiteSweep(firestore, hostId) {
+    if (!hostId) return;
+    try {
+        await firestore.collection(AI_EMPTY_SITE_SWEEPS_COLLECTION).doc(hostId).delete();
+    } catch (unused) {
+    // A marker left behind is decided at its due time, against the site as it is then.
+    }
+}
+/**
+ * Every condition, read again as the site is now (AGL-3936). The site is
+ * removed only when all of them hold:
+ *
+ * - it exists, in the marker's workspace, with no custom domain, no sending
+ *   domain, no page on its routing map, and no staff hold;
+ * - the job is still the one that ended, still `canceled` or `failed`, and
+ *   still built nothing — not resumed, retried or finished since;
+ * - no other AI job names the site;
+ * - nothing in {@link AI_EMPTY_SITE_CONTENT_COLLECTIONS}: no page, email,
+ *   layout, form or media file;
+ * - the site's own feed holds nothing but "Created the site" and the AI
+ *   job's own `ai.job.*` entries: nobody edited it.
+ */ export async function aiEmptySiteVerdict(firestore, marker) {
+    const hostRef = firestore.collection('hosts').doc(marker.hostId);
+    const host = await hostRef.get();
+    if (!host.exists) return {
+        kind: 'keep',
+        reason: 'site-gone'
+    };
+    if (host.get('orgId') !== marker.orgId) return {
+        kind: 'keep',
+        reason: 'site-moved'
+    };
+    const text = (field)=>{
+        var _host_get;
+        return String((_host_get = host.get(field)) != null ? _host_get : '').trim();
+    };
+    if (text('cname') || host.get('hasCustomDomain') === true) return {
+        kind: 'keep',
+        reason: 'custom-domain'
+    };
+    if (text('sendingLabel')) return {
+        kind: 'keep',
+        reason: 'sending-domain'
+    };
+    if (host.get('suspended') === true || host.get('suspendedAt')) return {
+        kind: 'keep',
+        reason: 'staff-hold'
+    };
+    const routes = host.get('screens');
+    if (routes && typeof routes === 'object' && Object.keys(routes).length > 0) {
+        return {
+            kind: 'keep',
+            reason: 'routed-pages'
+        };
+    }
+    const jobSnapshot = await firestore.collection('orgs').doc(marker.orgId).collection(JOBS_COLLECTION).doc(marker.jobId).get();
+    if (!jobSnapshot.exists) return {
+        kind: 'keep',
+        reason: 'job-gone'
+    };
+    const job = _extends({}, jobSnapshot.data(), {
+        $id: jobSnapshot.id
+    });
+    if (job.hostId !== marker.hostId || !aiJobLeavesEmptySite(job)) return {
+        kind: 'keep',
+        reason: 'job-moved-on'
+    };
+    const settledMs = toMillis(job.updatedAt);
+    const markedMs = marker.dueAt.getTime() - AI_EMPTY_SITE_GRACE_MS;
+    if (settledMs !== null && settledMs > markedMs + 1000) {
+        return {
+            kind: 'later',
+            dueAt: new Date(settledMs + AI_EMPTY_SITE_GRACE_MS)
+        };
+    }
+    const [others, ...contents] = await Promise.all([
+        firestore.collection('orgs').doc(marker.orgId).collection(JOBS_COLLECTION).where('hostId', '==', marker.hostId).limit(2).get(),
+        ...AI_EMPTY_SITE_CONTENT_COLLECTIONS.map((name)=>hostRef.collection(name).limit(1).get())
+    ]);
+    if (others.docs.some((doc)=>doc.id !== marker.jobId)) return {
+        kind: 'keep',
+        reason: 'another-job'
+    };
+    const held = AI_EMPTY_SITE_CONTENT_COLLECTIONS.find((_, index)=>!contents[index].empty);
+    if (held) return {
+        kind: 'keep',
+        reason: `has-${held}`
+    };
+    const activity = await hostRef.collection('activity').limit(ACTIVITY_SCAN + 1).get();
+    if (activity.size > ACTIVITY_SCAN) return {
+        kind: 'keep',
+        reason: 'edited'
+    };
+    const edited = activity.docs.some((doc)=>{
+        var _doc_get;
+        const action = String((_doc_get = doc.get('action')) != null ? _doc_get : '');
+        return !UNEDITED_ACTIVITY.has(action) && !action.startsWith('ai.job.');
+    });
+    if (edited) return {
+        kind: 'keep',
+        reason: 'edited'
+    };
+    const name = host.get('displayName');
+    return {
+        kind: 'empty',
+        name: typeof name === 'string' && name ? name : null
+    };
+}
+/**
+ * One beat's removals (AGL-3936): the markers due now, oldest first, a few
+ * at a time and inside a few seconds of wall clock, each decided against the
+ * site as it is at that moment. The marker goes once it is decided; one the
+ * eraser could not answer is tried again later, and given up after
+ * {@link AI_EMPTY_SITE_MAX_ATTEMPTS}.
+ */ export async function sweepAiEmptySites(options) {
+    var _options_now, _options_budgetMs, _options_erase, _options_max;
+    const now = (_options_now = options.now) != null ? _options_now : Date.now;
+    const startedAt = now();
+    const budgetMs = (_options_budgetMs = options.budgetMs) != null ? _options_budgetMs : AI_EMPTY_SITE_SWEEP_BUDGET_MS;
+    const erase = (_options_erase = options.erase) != null ? _options_erase : erasePluginSite;
+    const markers = options.firestore.collection(AI_EMPTY_SITE_SWEEPS_COLLECTION);
+    const due = await markers.where('dueAt', '<=', new Date(startedAt)).orderBy('dueAt', 'asc').limit((_options_max = options.max) != null ? _options_max : AI_EMPTY_SITE_SWEEP_MAX).get();
+    const result = {
+        due: due.size,
+        removed: 0,
+        kept: 0,
+        later: 0
+    };
+    for (const doc of due.docs){
+        var _stored_hostId, _stored_orgId, _stored_jobId, _toMillis, _stored_attempts;
+        if (now() - startedAt >= budgetMs) break;
+        const stored = doc.data();
+        const marker = {
+            hostId: String((_stored_hostId = stored.hostId) != null ? _stored_hostId : doc.id),
+            orgId: String((_stored_orgId = stored.orgId) != null ? _stored_orgId : ''),
+            jobId: String((_stored_jobId = stored.jobId) != null ? _stored_jobId : ''),
+            dueAt: new Date((_toMillis = toMillis(stored.dueAt)) != null ? _toMillis : startedAt),
+            attempts: Number((_stored_attempts = stored.attempts) != null ? _stored_attempts : 0)
+        };
+        try {
+            if (!marker.orgId || !marker.jobId) {
+                await doc.ref.delete();
+                result.kept += 1;
+                continue;
+            }
+            const verdict = await aiEmptySiteVerdict(options.firestore, marker);
+            if (verdict.kind === 'keep') {
+                await doc.ref.delete();
+                result.kept += 1;
+                console.info('ai empty site kept', _extends({}, marker, {
+                    reason: verdict.reason
+                }));
+                continue;
+            }
+            if (verdict.kind === 'later') {
+                await doc.ref.set({
+                    dueAt: verdict.dueAt
+                }, {
+                    merge: true
+                });
+                result.later += 1;
+                continue;
+            }
+            const erased = await erase({
+                hostId: marker.hostId,
+                orgId: marker.orgId,
+                activity: AI_EMPTY_SITE_ACTIVITY,
+                reason: AI_EMPTY_SITE_REASON
+            });
+            if (erased.erased) {
+                // Said on the job only once the site is gone, so its pages can say so.
+                await options.firestore.collection('orgs').doc(marker.orgId).collection(JOBS_COLLECTION).doc(marker.jobId).set({
+                    siteRemoved: {
+                        at: new Date(now()),
+                        name: verdict.name
+                    }
+                }, {
+                    merge: true
+                });
+                await doc.ref.delete();
+                result.removed += 1;
+                console.info('ai empty site removed', marker);
+                continue;
+            }
+            const refused = 'reason' in erased ? erased.reason : 'unavailable';
+            if (refused !== 'unavailable') {
+                await doc.ref.delete();
+                result.kept += 1;
+                console.info('ai empty site kept', _extends({}, marker, {
+                    reason: refused
+                }));
+                continue;
+            }
+            await retryLater(doc.ref, marker, now());
+            result.later += 1;
+        } catch (error) {
+            console.error('ai empty site sweep failed', _extends({}, marker, {
+                error
+            }));
+            await retryLater(doc.ref, marker, now()).catch(()=>undefined);
+            result.later += 1;
+        }
+    }
+    return result;
+}
+/** Moves a marker the eraser could not answer later, or gives it up. */ async function retryLater(ref, marker, nowMs) {
+    const attempts = marker.attempts + 1;
+    if (attempts >= AI_EMPTY_SITE_MAX_ATTEMPTS) {
+        console.error('ai empty site: removal given up', _extends({}, marker, {
+            attempts
+        }));
+        await ref.delete();
+        return;
+    }
+    await ref.set({
+        attempts,
+        dueAt: new Date(nowMs + AI_EMPTY_SITE_RETRY_MS)
+    }, {
+        merge: true
+    });
+}
+
+//# sourceMappingURL=ai-empty-site-sweep.js.map

package/src/lib/jobs/ai-empty-site-sweep.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-empty-site-sweep.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  erasePluginSite,\n  type PluginSiteEraseRequest,\n  type PluginSiteEraseResult,\n} from '@aglyn/aglyn/plugin-manager/plugin-site-erase'\nimport type { AiJob } from '../model/ai-jobs.types'\n\n/**\n * THE EMPTY SITE A GUIDED START LEFT IS REMOVED (AGL-3936).\n *\n * Since AGL-3859 a site is created only when its start is admitted: the\n * starter, Skip, or \"Plan my site\". A site start cancelled or failed before\n * it built anything leaves that site with no page, public, answering \"This\n * site is coming soon\". The build page offers Start again, Try again and Use\n * the starter, and a person who leaves without choosing used to leave the\n * placeholder behind for good (kc-x-carder 2026-10-15, cancelled 13 s in;\n * pflomo 2026-10-17, 35 s in).\n *\n * So when a site job settles `canceled` or `failed` with nothing built, a due\n * marker is written, `aiEmptySiteSweeps/{hostId}`, an hour out. The AI jobs\n * beat reads the markers that are due, a few a beat, and checks every\n * condition again at that moment; only a site that is still truly empty is\n * deleted, through `core.site-erase` — the console's own delete path, so the\n * subdomain, the routing index, the org's site count, the members' rows and\n * the cache all go as they do for a site its admin deletes. Anything a person\n * did in the hour keeps the site and drops the marker. The starter is never\n * written for them: the starter is written only when a person chooses it.\n *\n * The marker is server-only (the rules deny every client), holds ids and\n * instants and nothing a person wrote, and is deleted once it is decided.\n */\n\n/** The due markers, top level, one per site, keyed by the site's id. */\nexport const AI_EMPTY_SITE_SWEEPS_COLLECTION = 'aiEmptySiteSweeps'\n\n/** How long a person has to come back and choose before the empty site goes. */\nexport const AI_EMPTY_SITE_GRACE_MS = 60 * 60_000\n\n/** Markers one beat decides; the rest wait for the next minute's beat. */\nexport const AI_EMPTY_SITE_SWEEP_MAX = 3\n\n/** Wall clock one beat gives the removals before it runs any job's step. */\nexport const AI_EMPTY_SITE_SWEEP_BUDGET_MS = 20_000\n\n/** A removal the eraser could not make is tried again this much later. */\nexport const AI_EMPTY_SITE_RETRY_MS = 15 * 60_000\n\n/** Removals tried this many times without an answer are given up and logged. */\nexport const AI_EMPTY_SITE_MAX_ATTEMPTS = 5\n\n/** The workspace feed's words for it; the feed names the site beside them. */\nexport const AI_EMPTY_SITE_ACTIVITY = 'Removed an empty site'\n\n/** Why, on the staff audit row. */\nexport const AI_EMPTY_SITE_REASON = 'ai-start-empty'\n\n/** The org's jobs, as `AI_JOBS_COLLECTION` in `ai-jobs.ts` names them (that module imports this one). */\nconst JOBS_COLLECTION = 'aiJobs'\n\n/**\n * What a site holds that a person, or a start, put there. One document in\n * any of them keeps the site: pages and emails (`screens`), layouts, forms,\n * media, components, templates, content collections, redirects and plugin\n * settings. `activity` and the visitors' `analytics` beacon are not on the\n * list, and are read on their own terms below.\n */\nexport const AI_EMPTY_SITE_CONTENT_COLLECTIONS = [\n  'screens',\n  'layouts',\n  'forms',\n  'media',\n  'components',\n  'templates',\n  'collections',\n  'redirects',\n  'pluginSettings',\n] as const\n\n/** The site's own feed entries that are not a person editing it. */\nconst UNEDITED_ACTIVITY = new Set(['Created the site'])\n\n/** More feed entries than this and the site was worked on. */\nconst ACTIVITY_SCAN = 20\n\ntype Firestore = FirebaseFirestore.Firestore\ntype Instant = Date | { toMillis(): number } | number | string | null | undefined\n\nfunction toMillis(value: Instant): number | null {\n  if (value === null || value === undefined) return null\n  if (value instanceof Date) return value.getTime()\n  if (typeof value === 'number') return value\n  if (typeof value === 'string') {\n    const parsed = Date.parse(value)\n    return Number.isFinite(parsed) ? parsed : null\n  }\n  return typeof value.toMillis === 'function' ? value.toMillis() : null\n}\n\n/** The due marker, as stored. */\nexport interface AiEmptySiteSweep {\n  hostId: string\n  orgId: string\n  jobId: string\n  /** What the job ended as. */\n  status: 'canceled' | 'failed'\n  settledAt: Date\n  dueAt: Date\n  attempts: number\n}\n\n/**\n * Whether a job leaves the empty site this sweep is for: a site start that\n * ended `canceled` or `failed` with nothing built — no output but the\n * site's listing proposal, which rides out with the first unit and builds\n * nothing (the rule `aiSiteStarterFallbackOffered` offers the starter by).\n */\nexport function aiJobLeavesEmptySite(\n  job: Pick<AiJob, 'kind' | 'status' | 'hostId' | 'outputs' | 'siteRemoved'>,\n): boolean {\n  if (job.kind !== 'site' || !job.hostId || job.siteRemoved) return false\n  if (job.status !== 'canceled' && job.status !== 'failed') return false\n  return (job.outputs ?? []).every((output) => output.resource === 'seo')\n}\n\n/**\n * Writes the due marker for a job that just ended, when it leaves an empty\n * site. Never throws: a marker that could not be written leaves the site as\n * it was before this existed, and must not fail the write it follows.\n */\nexport async function scheduleAiEmptySiteSweep(\n  firestore: Firestore,\n  job: Pick<AiJob, '$id' | 'orgId' | 'kind' | 'status' | 'hostId' | 'outputs' | 'siteRemoved'>,\n  now = new Date(),\n): Promise<boolean> {\n  if (!aiJobLeavesEmptySite(job) || !job.hostId) return false\n  const marker: AiEmptySiteSweep = {\n    hostId: job.hostId,\n    orgId: job.orgId,\n    jobId: job.$id,\n    status: job.status as AiEmptySiteSweep['status'],\n    settledAt: now,\n    dueAt: new Date(now.getTime() + AI_EMPTY_SITE_GRACE_MS),\n    attempts: 0,\n  }\n  try {\n    await firestore.collection(AI_EMPTY_SITE_SWEEPS_COLLECTION).doc(job.hostId).set(marker)\n    return true\n  } catch (error) {\n    console.warn('ai empty site: the removal could not be scheduled', {\n      orgId: job.orgId,\n      jobId: job.$id,\n      hostId: job.hostId,\n      error: error instanceof Error ? error.message : String(error),\n    })\n    return false\n  }\n}\n\n/**\n * Drops a site's marker: a job started, resumed or retried on the site, so\n * it is not empty for long. Never throws; the beat's check at due time says\n * the same thing if this write is lost.\n */\nexport async function clearAiEmptySiteSweep(firestore: Firestore, hostId: string | null | undefined): Promise<void> {\n  if (!hostId) return\n  try {\n    await firestore.collection(AI_EMPTY_SITE_SWEEPS_COLLECTION).doc(hostId).delete()\n  } catch {\n    // A marker left behind is decided at its due time, against the site as it is then.\n  }\n}\n\n/** What the check at due time found. */\nexport type AiEmptySiteVerdict =\n  | { kind: 'empty'; name: string | null }\n  /** The job settled again after the marker was written: wait a full grace from then. */\n  | { kind: 'later'; dueAt: Date }\n  /** The site is kept; the marker is dropped. */\n  | { kind: 'keep'; reason: string }\n\n/**\n * Every condition, read again as the site is now (AGL-3936). The site is\n * removed only when all of them hold:\n *\n * - it exists, in the marker's workspace, with no custom domain, no sending\n *   domain, no page on its routing map, and no staff hold;\n * - the job is still the one that ended, still `canceled` or `failed`, and\n *   still built nothing — not resumed, retried or finished since;\n * - no other AI job names the site;\n * - nothing in {@link AI_EMPTY_SITE_CONTENT_COLLECTIONS}: no page, email,\n *   layout, form or media file;\n * - the site's own feed holds nothing but \"Created the site\" and the AI\n *   job's own `ai.job.*` entries: nobody edited it.\n */\nexport async function aiEmptySiteVerdict(\n  firestore: Firestore,\n  marker: Pick<AiEmptySiteSweep, 'hostId' | 'orgId' | 'jobId' | 'dueAt'>,\n): Promise<AiEmptySiteVerdict> {\n  const hostRef = firestore.collection('hosts').doc(marker.hostId)\n  const host = await hostRef.get()\n  if (!host.exists) return { kind: 'keep', reason: 'site-gone' }\n  if (host.get('orgId') !== marker.orgId) return { kind: 'keep', reason: 'site-moved' }\n  const text = (field: string) => String(host.get(field) ?? '').trim()\n  if (text('cname') || host.get('hasCustomDomain') === true) return { kind: 'keep', reason: 'custom-domain' }\n  if (text('sendingLabel')) return { kind: 'keep', reason: 'sending-domain' }\n  if (host.get('suspended') === true || host.get('suspendedAt')) return { kind: 'keep', reason: 'staff-hold' }\n  const routes = host.get('screens')\n  if (routes && typeof routes === 'object' && Object.keys(routes as object).length > 0) {\n    return { kind: 'keep', reason: 'routed-pages' }\n  }\n\n  const jobSnapshot = await firestore\n    .collection('orgs')\n    .doc(marker.orgId)\n    .collection(JOBS_COLLECTION)\n    .doc(marker.jobId)\n    .get()\n  if (!jobSnapshot.exists) return { kind: 'keep', reason: 'job-gone' }\n  const job = { ...(jobSnapshot.data() as Omit<AiJob, '$id'>), $id: jobSnapshot.id } as AiJob\n  if (job.hostId !== marker.hostId || !aiJobLeavesEmptySite(job)) return { kind: 'keep', reason: 'job-moved-on' }\n  const settledMs = toMillis(job.updatedAt as Instant)\n  const markedMs = marker.dueAt.getTime() - AI_EMPTY_SITE_GRACE_MS\n  if (settledMs !== null && settledMs > markedMs + 1_000) {\n    return { kind: 'later', dueAt: new Date(settledMs + AI_EMPTY_SITE_GRACE_MS) }\n  }\n\n  const [others, ...contents] = await Promise.all([\n    firestore\n      .collection('orgs')\n      .doc(marker.orgId)\n      .collection(JOBS_COLLECTION)\n      .where('hostId', '==', marker.hostId)\n      .limit(2)\n      .get(),\n    ...AI_EMPTY_SITE_CONTENT_COLLECTIONS.map((name) => hostRef.collection(name).limit(1).get()),\n  ])\n  if (others.docs.some((doc) => doc.id !== marker.jobId)) return { kind: 'keep', reason: 'another-job' }\n  const held = AI_EMPTY_SITE_CONTENT_COLLECTIONS.find((_, index) => !contents[index].empty)\n  if (held) return { kind: 'keep', reason: `has-${held}` }\n\n  const activity = await hostRef.collection('activity').limit(ACTIVITY_SCAN + 1).get()\n  if (activity.size > ACTIVITY_SCAN) return { kind: 'keep', reason: 'edited' }\n  const edited = activity.docs.some((doc) => {\n    const action = String(doc.get('action') ?? '')\n    return !UNEDITED_ACTIVITY.has(action) && !action.startsWith('ai.job.')\n  })\n  if (edited) return { kind: 'keep', reason: 'edited' }\n\n  const name = host.get('displayName')\n  return { kind: 'empty', name: typeof name === 'string' && name ? name : null }\n}\n\nexport interface AiEmptySiteSweepResult {\n  /** Markers that were due. */\n  due: number\n  /** Sites removed. */\n  removed: number\n  /** Markers dropped because the site was kept, or was already gone. */\n  kept: number\n  /** Markers moved later: the job settled again, or the eraser did not answer. */\n  later: number\n}\n\nexport interface SweepAiEmptySitesOptions {\n  firestore: Firestore\n  now?: () => number\n  max?: number\n  budgetMs?: number\n  /** The site's removal; `core.site-erase` unless a spec replaces it. */\n  erase?: (request: PluginSiteEraseRequest) => Promise<PluginSiteEraseResult>\n}\n\n/**\n * One beat's removals (AGL-3936): the markers due now, oldest first, a few\n * at a time and inside a few seconds of wall clock, each decided against the\n * site as it is at that moment. The marker goes once it is decided; one the\n * eraser could not answer is tried again later, and given up after\n * {@link AI_EMPTY_SITE_MAX_ATTEMPTS}.\n */\nexport async function sweepAiEmptySites(options: SweepAiEmptySitesOptions): Promise<AiEmptySiteSweepResult> {\n  const now = options.now ?? Date.now\n  const startedAt = now()\n  const budgetMs = options.budgetMs ?? AI_EMPTY_SITE_SWEEP_BUDGET_MS\n  const erase = options.erase ?? erasePluginSite\n  const markers = options.firestore.collection(AI_EMPTY_SITE_SWEEPS_COLLECTION)\n  const due = await markers\n    .where('dueAt', '<=', new Date(startedAt))\n    .orderBy('dueAt', 'asc')\n    .limit(options.max ?? AI_EMPTY_SITE_SWEEP_MAX)\n    .get()\n  const result: AiEmptySiteSweepResult = { due: due.size, removed: 0, kept: 0, later: 0 }\n\n  for (const doc of due.docs) {\n    if (now() - startedAt >= budgetMs) break\n    const stored = doc.data() as Partial<AiEmptySiteSweep> & { dueAt?: Instant; settledAt?: Instant }\n    const marker = {\n      hostId: String(stored.hostId ?? doc.id),\n      orgId: String(stored.orgId ?? ''),\n      jobId: String(stored.jobId ?? ''),\n      dueAt: new Date(toMillis(stored.dueAt) ?? startedAt),\n      attempts: Number(stored.attempts ?? 0),\n    }\n    try {\n      if (!marker.orgId || !marker.jobId) {\n        await doc.ref.delete()\n        result.kept += 1\n        continue\n      }\n      const verdict = await aiEmptySiteVerdict(options.firestore, marker)\n      if (verdict.kind === 'keep') {\n        await doc.ref.delete()\n        result.kept += 1\n        console.info('ai empty site kept', { ...marker, reason: verdict.reason })\n        continue\n      }\n      if (verdict.kind === 'later') {\n        await doc.ref.set({ dueAt: verdict.dueAt }, { merge: true })\n        result.later += 1\n        continue\n      }\n      const erased = await erase({\n        hostId: marker.hostId,\n        orgId: marker.orgId,\n        activity: AI_EMPTY_SITE_ACTIVITY,\n        reason: AI_EMPTY_SITE_REASON,\n      })\n      if (erased.erased) {\n        // Said on the job only once the site is gone, so its pages can say so.\n        await options.firestore\n          .collection('orgs')\n          .doc(marker.orgId)\n          .collection(JOBS_COLLECTION)\n          .doc(marker.jobId)\n          .set({ siteRemoved: { at: new Date(now()), name: verdict.name } }, { merge: true })\n        await doc.ref.delete()\n        result.removed += 1\n        console.info('ai empty site removed', marker)\n        continue\n      }\n      const refused = 'reason' in erased ? erased.reason : 'unavailable'\n      if (refused !== 'unavailable') {\n        await doc.ref.delete()\n        result.kept += 1\n        console.info('ai empty site kept', { ...marker, reason: refused })\n        continue\n      }\n      await retryLater(doc.ref, marker, now())\n      result.later += 1\n    } catch (error) {\n      console.error('ai empty site sweep failed', { ...marker, error })\n      await retryLater(doc.ref, marker, now()).catch(() => undefined)\n      result.later += 1\n    }\n  }\n  return result\n}\n\n/** Moves a marker the eraser could not answer later, or gives it up. */\nasync function retryLater(\n  ref: FirebaseFirestore.DocumentReference,\n  marker: { hostId: string; orgId: string; jobId: string; attempts: number },\n  nowMs: number,\n): Promise<void> {\n  const attempts = marker.attempts + 1\n  if (attempts >= AI_EMPTY_SITE_MAX_ATTEMPTS) {\n    console.error('ai empty site: removal given up', { ...marker, attempts })\n    await ref.delete()\n    return\n  }\n  await ref.set({ attempts, dueAt: new Date(nowMs + AI_EMPTY_SITE_RETRY_MS) }, { merge: true })\n}\n"],"names":["erasePluginSite","AI_EMPTY_SITE_SWEEPS_COLLECTION","AI_EMPTY_SITE_GRACE_MS","AI_EMPTY_SITE_SWEEP_MAX","AI_EMPTY_SITE_SWEEP_BUDGET_MS","AI_EMPTY_SITE_RETRY_MS","AI_EMPTY_SITE_MAX_ATTEMPTS","AI_EMPTY_SITE_ACTIVITY","AI_EMPTY_SITE_REASON","JOBS_COLLECTION","AI_EMPTY_SITE_CONTENT_COLLECTIONS","UNEDITED_ACTIVITY","Set","ACTIVITY_SCAN","toMillis","value","undefined","Date","getTime","parsed","parse","Number","isFinite","aiJobLeavesEmptySite","job","kind","hostId","siteRemoved","status","outputs","every","output","resource","scheduleAiEmptySiteSweep","firestore","now","marker","orgId","jobId","$id","settledAt","dueAt","attempts","collection","doc","set","error","console","warn","Error","message","String","clearAiEmptySiteSweep","delete","aiEmptySiteVerdict","hostRef","host","get","exists","reason","text","field","trim","routes","Object","keys","length","jobSnapshot","data","id","settledMs","updatedAt","markedMs","others","contents","Promise","all","where","limit","map","name","docs","some","held","find","_","index","empty","activity","size","edited","action","has","startsWith","sweepAiEmptySites","options","startedAt","budgetMs","erase","markers","due","orderBy","max","result","removed","kept","later","stored","ref","verdict","info","merge","erased","at","refused","retryLater","catch","nowMs"],"mappings":"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"}

package/src/lib/jobs/ai-job-page-language.d.ts

@@ -161,6 +161,15 @@ export interface AiLayoutStartPage {
  * the model. Empty when the page has no words to show.
  */
 export declare function aiLayoutStartPageLines(start: AiLayoutStartPage | null | undefined): string[];
+/**
+ * What a page is told about the site's form (AGL-3899). A page whose plan
+ * places the form, or a site whose form has no page of its own, is told the
+ * form; any other page is told where the form lives and that its call to
+ * action links there. Told "The site's form: …" on every page, two of the
+ * newest production homes drew the form on their own, beside the Contact
+ * page that held it.
+ */
+export declare function aiLayoutFormLine(screen: Pick<AiBuildPlanScreen, 'sections'>, targets: AiLayoutTargets): string;
 /** The page's user turn: the page, the brief, the plan, its sections and where its links may go. */
 export declare function aiLayoutPagePrompt(input: {
     job: Pick<AiJob, 'brief' | 'inputs' | '$id'>;

package/src/lib/jobs/ai-job-page-language.js

@@ -286,6 +286,21 @@ export const AI_JOB_PAGE_LANGUAGE_BUDGET = aiJobStepBudget({
         shown
     ];
 }
+/**
+ * What a page is told about the site's form (AGL-3899). A page whose plan
+ * places the form, or a site whose form has no page of its own, is told the
+ * form; any other page is told where the form lives and that its call to
+ * action links there. Told "The site's form: …" on every page, two of the
+ * newest production homes drew the form on their own, beside the Contact
+ * page that held it.
+ */ export function aiLayoutFormLine(screen, targets) {
+    if (!targets.forms.length) return 'The site has no saved form: place none.';
+    const ids = new Set(targets.forms.map((form)=>form.id));
+    const placed = screen.sections.some((section)=>section.uses.some((ref)=>ids.has(ref)));
+    const page = targets.formPageId ? targets.pages.find((entry)=>entry.id === targets.formPageId) : undefined;
+    if (placed || !page) return `The site's form: ${targets.forms.map((form)=>`${form.name} (${form.id})`).join(', ')}.`;
+    return `The site's form is on the ${page.label} page (page:${page.id}): place no form on this page, and make a call to action that asks visitors to get in touch a button to that page.`;
+}
 /** The page's user turn: the page, the brief, the plan, its sections and where its links may go. */ export function aiLayoutPagePrompt(input) {
     const { job, plan, screen, targets } = input;
     const sections = screen.sections.map((section, index)=>{
@@ -312,8 +327,11 @@ export const AI_JOB_PAGE_LANGUAGE_BUDGET = aiJobStepBudget({
             return `${index + 1}. "${section.name}"${places}; the platform places the newsletter sign-up field here: write its heading and one line on what subscribers hear about, from the brief, and no form, button or offer the brief does not make`;
         }
         if ((listed == null ? void 0 : listed.listing.kind) === 'records') {
+            var _listed_filter;
             // One of the site's datasets (AGL-3616), repeated by the platform over its records.
-            const names = listed.listing.records.length ? ` (${listed.listing.records.slice(0, 6).map((name)=>`“${name}”`).join(', ')})` : '';
+            // A section named for one group lists that group's records alone (AGL-3921).
+            const shown = ((_listed_filter = listed.filter) == null ? void 0 : _listed_filter.records.length) ? listed.filter.records : listed.listing.records;
+            const names = shown.length ? ` (${shown.slice(0, 6).map((name)=>`“${name}”`).join(', ')})` : '';
             return `${index + 1}. "${section.name}"${places}; the platform lists the records of the dataset “${listed.listing.name}”${names} here itself, one card each: write only its heading and a line about them, and no cards, list or images for them`;
         }
         if (listed) {
@@ -335,7 +353,7 @@ export const AI_JOB_PAGE_LANGUAGE_BUDGET = aiJobStepBudget({
         `Sections to design, in order:`,
         ...sections,
         pages.length ? `Other pages of this site: ${pages.join(', ')}.` : 'This site has no other page to link.',
-        targets.forms.length ? `The site's form: ${targets.forms.map((form)=>`${form.name} (${form.id})`).join(', ')}.` : 'The site has no saved form: place none.',
+        aiLayoutFormLine(screen, targets),
         ...components.length ? [
             `Components this page may place: ${components.join('; ')}.`
         ] : [],