looply-cli 0.5.11 → 0.5.12

package/dist/maintenance-facts.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPackageRoots = findPackageRoots;
+exports.shipsNativeCode = shipsNativeCode;
+exports.unusedDependencies = unusedDependencies;
+exports.gatherRootFacts = gatherRootFacts;
+exports.gatherFacts = gatherFacts;
+exports.nodeFactsDeps = nodeFactsDeps;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const core_1 = require("@looply/core");
+const LOCKFILES = ['package-lock.json', 'npm-shrinkwrap.json', 'pnpm-lock.yaml', 'yarn.lock', 'bun.lockb', 'bun.lock'];
+const SKIP_DIRS = new Set(['node_modules', 'dist', 'build', 'coverage', 'out', 'vendor', 'android', 'ios', 'tmp', 'temp']);
+const MAX_ROOTS = 12;
+/** Package roots: the repository root when it has a package.json, then folders up to two levels down with a package.json and a lockfile. */
+function findPackageRoots(repo, deps) {
+    const roots = [];
+    if (deps.exists((0, node_path_1.join)(repo, 'package.json')))
+        roots.push('.');
+    const walk = (dir, depth) => {
+        if (depth > 2 || roots.length >= MAX_ROOTS)
+            return;
+        for (const e of deps.list(dir).sort((a, b) => a.name.localeCompare(b.name))) {
+            if (!e.dir || e.name.startsWith('.') || SKIP_DIRS.has(e.name))
+                continue;
+            const sub = (0, node_path_1.join)(dir, e.name);
+            if (deps.exists((0, node_path_1.join)(sub, 'package.json')) && LOCKFILES.some((l) => deps.exists((0, node_path_1.join)(sub, l)))) {
+                roots.push((0, node_path_1.relative)(repo, sub).split(node_path_1.sep).join('/'));
+                if (roots.length >= MAX_ROOTS)
+                    return;
+            }
+            walk(sub, depth + 1);
+        }
+    };
+    walk(repo, 1);
+    return roots;
+}
+function json(text) {
+    if (text === null)
+        return null;
+    try {
+        const v = JSON.parse(text);
+        return typeof v === 'object' && v !== null && !Array.isArray(v) ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+function depNames(pkg, field) {
+    const d = pkg[field];
+    return typeof d === 'object' && d !== null ? Object.keys(d) : [];
+}
+/** The first JSON value in a tool's output — npm can print a warning line before it. */
+function jsonPart(out) {
+    const i = out.search(/[{[]/);
+    return i < 0 ? '' : out.slice(i);
+}
+const outdatedArgs = (pm) => pm === 'npm' ? ['outdated', '--json', '--long'] : pm === 'pnpm' ? ['outdated', '--format', 'json'] : null;
+const auditArgs = (pm) => (pm === 'npm' ? ['audit', '--json'] : pm === 'pnpm' ? ['audit', '--json'] : null);
+/** Does this installed package ship native code an Expo app must rebuild for? */
+function shipsNativeCode(pkgDir, deps) {
+    if (['expo-module.config.json', 'react-native.config.js', 'android', 'ios'].some((f) => deps.exists((0, node_path_1.join)(pkgDir, f))))
+        return true;
+    const pkg = json(deps.readFile((0, node_path_1.join)(pkgDir, 'package.json')));
+    return pkg !== null && pkg['codegenConfig'] !== undefined;
+}
+const SOURCE = /\.(ts|tsx|js|jsx|mjs|cjs|mts|cts|vue|svelte|json|ya?ml)$/;
+const MAX_FILES = 20_000;
+const MAX_BYTES = 1_000_000;
+/** Used through a config, a CLI or by convention, not by an import. Never proposed for removal. */
+const IMPLICIT = /^(@types\/.+|typescript|ts-node|tsx|eslint.*|@eslint\/.+|@typescript-eslint\/.+|prettier.*|jest.*|ts-jest|babel-.+|@babel\/.+|vite|vitest|@vitejs\/.+|postcss.*|tailwindcss|autoprefixer|nodemon|husky|lint-staged|concurrently|cross-env|rimraf|npm-run-all.*|prisma|@prisma\/client|expo|react-native|metro.*|patch-package|dotenv-cli)$/;
+/**
+ * Dependencies nothing under `root` mentions by name in a quote — a plain text
+ * search, so a candidate list for a goal to CONFIRM, never a removal list.
+ */
+function unusedDependencies(rootDir, pkg, deps) {
+    const candidates = [...depNames(pkg, 'dependencies'), ...depNames(pkg, 'devDependencies')].filter((n) => !IMPLICIT.test(n));
+    if (candidates.length === 0)
+        return [];
+    const scripts = JSON.stringify(pkg['scripts'] ?? {});
+    const remaining = new Set(candidates.filter((n) => !scripts.includes(n)));
+    let files = 0;
+    const walk = (dir) => {
+        if (remaining.size === 0 || files >= MAX_FILES)
+            return;
+        for (const e of deps.list(dir)) {
+            if (remaining.size === 0 || files >= MAX_FILES)
+                return;
+            if (e.dir) {
+                if (e.name.startsWith('.') || SKIP_DIRS.has(e.name))
+                    continue;
+                walk((0, node_path_1.join)(dir, e.name));
+                continue;
+            }
+            if (!SOURCE.test(e.name) || e.name === 'package.json' || LOCKFILES.includes(e.name))
+                continue;
+            files += 1;
+            const text = deps.readFile((0, node_path_1.join)(dir, e.name));
+            if (text === null || text.length > MAX_BYTES)
+                continue;
+            for (const n of [...remaining]) {
+                if (text.includes(`'${n}`) || text.includes(`"${n}`) || text.includes(`\`${n}`))
+                    remaining.delete(n);
+            }
+        }
+    };
+    walk(rootDir);
+    return [...remaining].sort();
+}
+/** Every fact for one package root. Never throws: a tool that failed is a sentence on the root. */
+async function gatherRootFacts(repo, root, opts, deps) {
+    const dir = root === '.' ? repo : (0, node_path_1.join)(repo, ...root.split('/'));
+    const pkg = json(deps.readFile((0, node_path_1.join)(dir, 'package.json'))) ?? {};
+    const lockfiles = LOCKFILES.filter((l) => deps.exists((0, node_path_1.join)(dir, l)));
+    const { pm, problem } = (0, core_1.packageManagerOf)(pkg['packageManager'], lockfiles);
+    const names = [...depNames(pkg, 'dependencies'), ...depNames(pkg, 'devDependencies')];
+    const expo = names.includes('expo');
+    const facts = {
+        root,
+        packageManager: pm,
+        packageManagerProblem: problem,
+        expo,
+        outdated: null,
+        outdatedProblem: null,
+        audit: null,
+        auditProblem: null,
+        unused: [],
+        nativePackages: [],
+        changelogs: {},
+    };
+    if (pm === null)
+        return facts;
+    const installed = deps.exists((0, node_path_1.join)(dir, 'node_modules'));
+    const oArgs = outdatedArgs(pm);
+    if (oArgs === null)
+        facts.outdatedProblem = `Looply does not read ${pm} outdated reports yet`;
+    else if (!installed)
+        facts.outdatedProblem = 'its dependencies are not installed (no node_modules), so the installed versions are unknown';
+    else {
+        const r = await deps.run(pm, oArgs, dir);
+        // `outdated` exits 1 when something is outdated; only unreadable output is a failure.
+        try {
+            // Nothing outdated is `{}`; no JSON at all is a failure, not "nothing to do".
+            const body = jsonPart(r.stdout);
+            if (body === '')
+                throw new Error('no report');
+            facts.outdated = (0, core_1.parseOutdatedJson)(body);
+        }
+        catch {
+            facts.outdatedProblem = `${pm} outdated failed (exit ${r.code}): ${(r.stderr || r.stdout).trim().split(/\r?\n/)[0] ?? ''}`.slice(0, 300);
+        }
+    }
+    const aArgs = auditArgs(pm);
+    if (aArgs === null)
+        facts.auditProblem = `Looply does not read ${pm} audit reports yet`;
+    else {
+        const r = await deps.run(pm, aArgs, dir);
+        try {
+            const body = jsonPart(r.stdout);
+            if (body === '')
+                throw new Error('no report');
+            const raw = json(body);
+            if (raw !== null && raw['error'] !== undefined)
+                throw new Error(JSON.stringify(raw['error']).slice(0, 200));
+            facts.audit = (0, core_1.parseAuditJson)(body, names);
+        }
+        catch (e) {
+            facts.auditProblem = `${pm} audit failed (exit ${r.code}): ${e.message || (r.stderr || '').trim().split(/\r?\n/)[0] || ''}`.slice(0, 300);
+        }
+    }
+    if (installed) {
+        for (const o of facts.outdated ?? []) {
+            const p = json(deps.readFile((0, node_path_1.join)(dir, 'node_modules', ...o.name.split('/'), 'package.json')));
+            const url = p === null ? null : (0, core_1.changelogUrlOf)(p['repository']);
+            if (url !== null)
+                facts.changelogs[o.name] = url;
+        }
+        if (expo)
+            facts.nativePackages = names.filter((n) => shipsNativeCode((0, node_path_1.join)(dir, 'node_modules', ...n.split('/')), deps)).sort();
+    }
+    if (opts.deadCode)
+        facts.unused = unusedDependencies(dir, pkg, deps);
+    return facts;
+}
+async function gatherFacts(repo, opts, deps) {
+    const out = [];
+    for (const root of findPackageRoots(repo, deps))
+        out.push(await gatherRootFacts(repo, root, opts, deps));
+    return out;
+}
+const RUN_TIMEOUT_MS = 3 * 60_000;
+/** The real thing: hidden, bounded, no prompts, nothing written. */
+function nodeFactsDeps() {
+    return {
+        run: (command, args, cwd) => new Promise((resolve) => {
+            let stdout = '';
+            let stderr = '';
+            let settled = false;
+            const done = (r) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                resolve(r);
+            };
+            // A `.cmd` on Windows needs the shell; every argument here is a fixed word from this file.
+            const child = (0, node_child_process_1.spawn)(command, [...args], {
+                cwd,
+                shell: process.platform === 'win32',
+                windowsHide: true,
+                env: { ...process.env, NO_UPDATE_NOTIFIER: '1', npm_config_update_notifier: 'false', COREPACK_ENABLE_DOWNLOAD_PROMPT: '0' },
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            const timer = setTimeout(() => {
+                child.kill();
+                done({ code: null, stdout, stderr: `${stderr}\ntimed out after ${RUN_TIMEOUT_MS / 1000}s` });
+            }, RUN_TIMEOUT_MS);
+            child.stdout.on('data', (b) => {
+                if (stdout.length < 20_000_000)
+                    stdout += b.toString('utf8');
+            });
+            child.stderr.on('data', (b) => {
+                if (stderr.length < 100_000)
+                    stderr += b.toString('utf8');
+            });
+            child.on('error', (e) => done({ code: null, stdout, stderr: e.message }));
+            child.on('close', (code) => done({ code, stdout, stderr }));
+        }),
+        readFile: (path) => {
+            try {
+                return (0, node_fs_1.readFileSync)(path, 'utf8');
+            }
+            catch {
+                return null;
+            }
+        },
+        list: (path) => {
+            try {
+                return (0, node_fs_1.readdirSync)(path, { withFileTypes: true }).map((d) => ({ name: d.name, dir: d.isDirectory() }));
+            }
+            catch {
+                return [];
+            }
+        },
+        exists: (path) => {
+            try {
+                return (0, node_fs_1.existsSync)(path) && ((0, node_fs_1.statSync)(path).isFile() || (0, node_fs_1.statSync)(path).isDirectory());
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+//# sourceMappingURL=maintenance-facts.js.map

package/dist/maintenance-facts.js.map

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

package/dist/maintenance-tick.d.ts

@@ -0,0 +1,51 @@
+import { type MaintenancePlan, type MaintenanceSettings, type PackageRootFacts } from '@looply/core';
+/**
+ * THE WEEKLY MAINTENANCE PLAN, MADE BY THE DAEMON THAT DRIVES THE REPOSITORY.
+ *
+ * On the daemon's five-minute settings cadence: pull the project's maintenance
+ * setting (set in AutoRyn or the console) into `maintenance-settings.json`, and
+ * when the weekly slot has passed and no plan was made since, read the repository
+ * (`maintenance-facts.ts`), plan (`planMaintenance`), and propose the plan to the
+ * server. AutoRyn turns proposals into tickets and goals; this machine never
+ * creates a goal by itself.
+ *
+ * ⚠️ ONE PLAN PER SLOT. `maintenance-state.json` records when the last plan was
+ * proposed; a failure to reach the server leaves it unrecorded, so the next
+ * cadence tries again — but reading the repository again costs a few `npm`
+ * calls, so a failed plan waits 30 minutes before the next try.
+ *
+ * ⚠️ NEVER TWO AT ONCE, AND NEVER BLOCKING. The plan runs in the background of
+ * the cadence; a second cadence that finds one going does nothing.
+ */
+export declare const MAINTENANCE_SETTINGS_FILE = "maintenance-settings.json";
+export declare const MAINTENANCE_STATE_FILE = "maintenance-state.json";
+export interface MaintenanceState {
+    /** When the last plan reached the server (ms). */
+    lastPlannedAt: number | null;
+    week: string | null;
+    proposed: number;
+    skipped: string[];
+    /** The last failure and when, for a retry delay and a person reading the file. */
+    lastFailureAt: number | null;
+    lastFailure: string | null;
+}
+/** The project's maintenance setting as this machine last heard it; null when off or never heard. */
+export declare function readMaintenanceSettings(stateDir: string): MaintenanceSettings | null;
+export declare function readMaintenanceState(stateDir: string): MaintenanceState;
+export interface MaintenanceTickDeps {
+    stateDir: string;
+    fetchSettings(): Promise<unknown>;
+    propose(body: {
+        week: string;
+        items: MaintenancePlan['items'];
+    }): Promise<unknown>;
+    gather(opts: {
+        deadCode: boolean;
+    }): Promise<PackageRootFacts[]>;
+    log(line: string): void;
+    now(): number;
+}
+export type MaintenanceTickOutcome = 'off' | 'not-due' | 'busy' | 'waiting-retry' | 'proposed' | 'failed';
+/** One cadence: refresh the setting, plan when due. Never throws. Returns what happened (tests). */
+export declare function makeMaintenanceTick(deps: MaintenanceTickDeps): () => Promise<MaintenanceTickOutcome>;
+//# sourceMappingURL=maintenance-tick.d.ts.map

package/dist/maintenance-tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-tick.d.ts","sourceRoot":"","sources":["../src/maintenance-tick.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAGtB;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kFAAkF;IAClF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAkBD,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAKpF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAWvE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,MAAM,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACjE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,IAAI,MAAM,CAAC;CACf;AAED,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1G,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,CA+EpG"}

package/dist/maintenance-tick.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAINTENANCE_STATE_FILE = exports.MAINTENANCE_SETTINGS_FILE = void 0;
+exports.readMaintenanceSettings = readMaintenanceSettings;
+exports.readMaintenanceState = readMaintenanceState;
+exports.makeMaintenanceTick = makeMaintenanceTick;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const core_1 = require("@looply/core");
+const server_client_1 = require("./server-client");
+/**
+ * THE WEEKLY MAINTENANCE PLAN, MADE BY THE DAEMON THAT DRIVES THE REPOSITORY.
+ *
+ * On the daemon's five-minute settings cadence: pull the project's maintenance
+ * setting (set in AutoRyn or the console) into `maintenance-settings.json`, and
+ * when the weekly slot has passed and no plan was made since, read the repository
+ * (`maintenance-facts.ts`), plan (`planMaintenance`), and propose the plan to the
+ * server. AutoRyn turns proposals into tickets and goals; this machine never
+ * creates a goal by itself.
+ *
+ * ⚠️ ONE PLAN PER SLOT. `maintenance-state.json` records when the last plan was
+ * proposed; a failure to reach the server leaves it unrecorded, so the next
+ * cadence tries again — but reading the repository again costs a few `npm`
+ * calls, so a failed plan waits 30 minutes before the next try.
+ *
+ * ⚠️ NEVER TWO AT ONCE, AND NEVER BLOCKING. The plan runs in the background of
+ * the cadence; a second cadence that finds one going does nothing.
+ */
+exports.MAINTENANCE_SETTINGS_FILE = 'maintenance-settings.json';
+exports.MAINTENANCE_STATE_FILE = 'maintenance-state.json';
+const RETRY_AFTER_MS = 30 * 60_000;
+function readJson(path) {
+    try {
+        const v = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+        return typeof v === 'object' && v !== null && !Array.isArray(v) ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeJson(path, dir, value) {
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    const tmp = `${path}.${process.pid}.tmp`;
+    (0, node_fs_1.writeFileSync)(tmp, JSON.stringify(value, null, 2) + '\n', 'utf8');
+    (0, node_fs_1.renameSync)(tmp, path);
+}
+/** The project's maintenance setting as this machine last heard it; null when off or never heard. */
+function readMaintenanceSettings(stateDir) {
+    const raw = readJson((0, node_path_1.join)(stateDir, exports.MAINTENANCE_SETTINGS_FILE));
+    if (raw === null || raw['settings'] === null || raw['settings'] === undefined)
+        return null;
+    const v = (0, core_1.validateMaintenanceSettings)(raw['settings']);
+    return v.ok ? v.settings : null;
+}
+function readMaintenanceState(stateDir) {
+    const raw = readJson((0, node_path_1.join)(stateDir, exports.MAINTENANCE_STATE_FILE)) ?? {};
+    const num = (k) => (typeof raw[k] === 'number' && Number.isFinite(raw[k]) ? raw[k] : null);
+    return {
+        lastPlannedAt: num('lastPlannedAt'),
+        week: typeof raw['week'] === 'string' ? raw['week'] : null,
+        proposed: num('proposed') ?? 0,
+        skipped: Array.isArray(raw['skipped']) ? raw['skipped'].filter((s) => typeof s === 'string') : [],
+        lastFailureAt: num('lastFailureAt'),
+        lastFailure: typeof raw['lastFailure'] === 'string' ? raw['lastFailure'] : null,
+    };
+}
+/** One cadence: refresh the setting, plan when due. Never throws. Returns what happened (tests). */
+function makeMaintenanceTick(deps) {
+    let running = false;
+    let reportedPullFailure = false;
+    const pull = async () => {
+        let body;
+        try {
+            body = await deps.fetchSettings();
+        }
+        catch (e) {
+            if (!(e instanceof server_client_1.ServerError && (e.isOffline || e.isAuth)) && !reportedPullFailure) {
+                reportedPullFailure = true;
+                deps.log(`maint   : could not refresh the maintenance setting — ${e.message}`);
+            }
+            return;
+        }
+        reportedPullFailure = false;
+        const b = body;
+        if (typeof b !== 'object' || b === null || !('settings' in b))
+            return;
+        let settings = null;
+        if (b.settings !== null) {
+            const v = (0, core_1.validateMaintenanceSettings)(b.settings);
+            if (!v.ok) {
+                deps.log(`maint   : the server sent a maintenance setting this build refuses (${v.key}: ${v.because})`);
+                return;
+            }
+            settings = v.settings;
+        }
+        const path = (0, node_path_1.join)(deps.stateDir, exports.MAINTENANCE_SETTINGS_FILE);
+        const before = readJson(path);
+        if (before !== null && JSON.stringify(before['settings'] ?? null) === JSON.stringify(settings))
+            return;
+        try {
+            writeJson(path, deps.stateDir, { settings, updatedAt: typeof b.updatedAt === 'string' ? b.updatedAt : null, fetchedAt: new Date(deps.now()).toISOString() });
+            deps.log(`maint   : maintenance is ${settings?.enabled ? 'on' : 'off'} for this project`);
+        }
+        catch (e) {
+            deps.log(`maint   : could not write the maintenance setting (${e.message})`);
+        }
+    };
+    const plan = async (settings, week) => {
+        const state = readMaintenanceState(deps.stateDir);
+        const save = (patch) => {
+            try {
+                writeJson((0, node_path_1.join)(deps.stateDir, exports.MAINTENANCE_STATE_FILE), deps.stateDir, { ...state, ...patch });
+            }
+            catch {
+                /* the next cadence plans again; a duplicate plan is upserted, not doubled */
+            }
+        };
+        try {
+            deps.log(`maint   : making this week's maintenance plan (${week})`);
+            const facts = await deps.gather({ deadCode: settings.deadCode.enabled });
+            const result = (0, core_1.planMaintenance)({ settings, week, roots: facts });
+            await deps.propose({ week, items: result.items });
+            save({ lastPlannedAt: deps.now(), week, proposed: result.items.length, skipped: result.skipped.slice(0, 50), lastFailure: null, lastFailureAt: null });
+            deps.log(`maint   : proposed ${result.items.length} maintenance goal(s) for ${week}${result.skipped.length ? `; ${result.skipped.length} thing(s) left for later (${exports.MAINTENANCE_STATE_FILE})` : ''}`);
+            return 'proposed';
+        }
+        catch (e) {
+            const why = e.message.slice(0, 300);
+            save({ lastFailureAt: deps.now(), lastFailure: why });
+            deps.log(`maint   : the maintenance plan failed — ${why}; trying again in 30 minutes`);
+            return 'failed';
+        }
+    };
+    return async () => {
+        await pull();
+        const settings = readMaintenanceSettings(deps.stateDir);
+        const state = readMaintenanceState(deps.stateDir);
+        const due = (0, core_1.maintenanceDue)(settings, state.lastPlannedAt, deps.now());
+        if (settings === null || !settings.enabled)
+            return 'off';
+        if (!due.due)
+            return 'not-due';
+        if (running)
+            return 'busy';
+        if (state.lastFailureAt !== null && deps.now() - state.lastFailureAt < RETRY_AFTER_MS)
+            return 'waiting-retry';
+        running = true;
+        try {
+            return await plan(settings, due.week);
+        }
+        finally {
+            running = false;
+        }
+    };
+}
+//# sourceMappingURL=maintenance-tick.js.map

package/dist/maintenance-tick.js.map

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

package/dist/run-launcher.d.ts

@@ -89,6 +89,8 @@ export interface RunLauncherDeps {
      * it — a person's Start is that person's decision about their own machine.
      */
     machineSlots?: MachineRunSlots;
+    /** Is this goal a scheduled maintenance goal? Its machine-wide slot follows maintenance rules. */
+    isMaintenance?: (goalId: string | undefined) => boolean;
 }
 export type LaunchResult = 
 /**
@@ -484,6 +486,7 @@ export declare function readStartPayload(payload: unknown): StartRead;
 export declare function hoursFromPayload(payload: unknown): number | undefined;
 export declare function nodeRunLauncher(cwd: string, stateDir?: string, extra?: {
     readonly machineSlots?: MachineRunSlots;
+    readonly isMaintenance?: (goalId: string | undefined) => boolean;
 }): RunLauncher;
 /**
  * Where one launched run's stdout and stderr go: `<state>/run-logs/<when>-<request>.log`, appended. Null when the

package/dist/run-launcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-launcher.d.ts","sourceRoot":"","sources":["../src/run-launcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-launcher.d.ts","sourceRoot":"","sources":["../src/run-launcher.ts"],"names":[],"mappings":"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"}

package/dist/run-launcher.js

@@ -208,7 +208,7 @@ class RunLauncher {
          */
         const slots = req.origin.kind === 'autonomy' ? this.deps.machineSlots : undefined;
         if (slots !== undefined) {
-            const full = slots.claim(requestId);
+            const full = slots.claim(requestId, { maintenance: this.deps.isMaintenance?.(req.goalId) === true });
             if (full !== null)
                 return { started: false, reason: full };
         }
@@ -306,7 +306,7 @@ class RunLauncher {
     machineFull(req) {
         if (req.origin.kind !== 'autonomy' || this.deps.machineSlots === undefined)
             return null;
-        return this.deps.machineSlots.claim(req.requestId);
+        return this.deps.machineSlots.claim(req.requestId, { maintenance: this.deps.isMaintenance?.(req.goalId) === true });
     }
     /**
      * `looply scan`, as a child, so the lens passes stream into the ledger and
@@ -644,6 +644,7 @@ function nodeRunLauncher(cwd, stateDir, extra = {}) {
     const refusals = new run_refusal_marks_1.RunRefusalMarks(project, ledger_store_1.nodeLedgerFs);
     return new RunLauncher({
         ...(extra.machineSlots === undefined ? {} : { machineSlots: extra.machineSlots }),
+        ...(extra.isMaintenance === undefined ? {} : { isMaintenance: extra.isMaintenance }),
         ...(leases ? { peekLease: () => leases.inspect() } : {}),
         /**
          * 🔴 THE LEASE OF THE CHECKOUT BEING LAUNCHED INTO.