@agentsean/launch 1.0.0

package/dist/doctor.d.ts

@@ -0,0 +1,30 @@
+export type DoctorCheck = {
+    id: string;
+    ok: boolean;
+    severity: "fail" | "warn" | "info";
+    detail: string;
+};
+export type DoctorInput = {
+    home: string;
+    nodeVersion?: string | undefined;
+    port?: number | undefined;
+    pidAlive?: boolean | undefined;
+    tokenPresent?: boolean | undefined;
+    tokenLength?: number | undefined;
+    halted?: boolean | undefined;
+    dbExists?: boolean | undefined;
+    dbMode?: number | undefined;
+    googleConnected?: boolean | undefined;
+    googleExpiresAt?: string | null | undefined;
+    playwright?: boolean | undefined;
+    platform?: string | undefined;
+};
+export type DoctorReport = {
+    ok: boolean;
+    version: string;
+    node: string;
+    checks: DoctorCheck[];
+};
+export declare function portOpen(host: string, port: number): Promise<boolean>;
+export declare function runDoctor(input: DoctorInput): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAUF,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa3E;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAmJzE"}

package/dist/doctor.js

@@ -0,0 +1,170 @@
+import fs from "node:fs";
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+import { MIN_NODE, nodeMeetsMin, VERSION } from "./version.js";
+import { MIN_TOKEN_LENGTH } from "./token-strength.js";
+function modeOf(file) {
+    try {
+        return fs.statSync(file).mode & 0o777;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function portOpen(host, port) {
+    return new Promise((resolve) => {
+        const sock = net.connect({ host, port });
+        sock.once("connect", () => {
+            sock.destroy();
+            resolve(true);
+        });
+        sock.once("error", () => resolve(false));
+        sock.setTimeout(400, () => {
+            sock.destroy();
+            resolve(false);
+        });
+    });
+}
+export async function runDoctor(input) {
+    const nodeVersion = input.nodeVersion ?? process.versions.node;
+    const port = input.port ?? 7777;
+    const platform = input.platform ?? process.platform;
+    const checks = [];
+    const nodeOk = nodeMeetsMin(nodeVersion);
+    checks.push({
+        id: "node",
+        ok: nodeOk,
+        severity: nodeOk ? "info" : "fail",
+        detail: nodeOk
+            ? `Node ${nodeVersion} (>= ${MIN_NODE})`
+            : `Node ${nodeVersion} is too old; need >= ${MIN_NODE}`,
+    });
+    let homeWritable = false;
+    try {
+        fs.mkdirSync(input.home, { recursive: true, mode: 0o700 });
+        fs.accessSync(input.home, fs.constants.W_OK);
+        homeWritable = true;
+    }
+    catch {
+        homeWritable = false;
+    }
+    const homeMode = modeOf(input.home);
+    const homeModeOk = platform === "win32" || homeMode === undefined || (homeMode & 0o077) === 0;
+    checks.push({
+        id: "home",
+        ok: homeWritable && homeModeOk,
+        severity: homeWritable ? (homeModeOk ? "info" : "warn") : "fail",
+        detail: homeWritable
+            ? `writable ${input.home}` +
+                (homeModeOk ? "" : ` (mode ${homeMode?.toString(8)} should be 700)`)
+            : `cannot write ${input.home}`,
+    });
+    const listening = await portOpen("127.0.0.1", port);
+    if (input.pidAlive) {
+        checks.push({
+            id: "daemon",
+            ok: true,
+            severity: "info",
+            detail: listening
+                ? `daemon running on 127.0.0.1:${port}`
+                : "pid file is alive; health endpoint not reachable yet",
+        });
+    }
+    else {
+        checks.push({
+            id: "port",
+            ok: !listening,
+            severity: listening ? "warn" : "info",
+            detail: listening
+                ? `127.0.0.1:${port} is in use and no Sean pid file`
+                : `127.0.0.1:${port} is free`,
+        });
+    }
+    if (input.tokenPresent === false) {
+        checks.push({
+            id: "token",
+            ok: true,
+            severity: "info",
+            detail: "no token yet — first start will generate a 32-byte token",
+        });
+    }
+    else if (typeof input.tokenLength === "number") {
+        const strong = input.tokenLength >= MIN_TOKEN_LENGTH;
+        checks.push({
+            id: "token",
+            ok: strong,
+            severity: strong ? "info" : "fail",
+            detail: strong
+                ? `auth token length ${input.tokenLength}`
+                : `auth token length ${input.tokenLength} < ${MIN_TOKEN_LENGTH}`,
+        });
+    }
+    if (input.halted) {
+        checks.push({
+            id: "halt",
+            ok: true,
+            severity: "warn",
+            detail: "writes are frozen (HALT). sean unfreeze to resume",
+        });
+    }
+    const dbFile = path.join(input.home, "sean.db");
+    const dbExists = input.dbExists ?? fs.existsSync(dbFile);
+    if (dbExists) {
+        const dbMode = input.dbMode ?? modeOf(dbFile);
+        const privateDb = platform === "win32" || dbMode === undefined || (dbMode & 0o077) === 0;
+        checks.push({
+            id: "db",
+            ok: privateDb,
+            severity: privateDb ? "info" : "fail",
+            detail: privateDb
+                ? "database is not world-readable"
+                : `database mode ${dbMode?.toString(8)} is world-readable`,
+        });
+    }
+    else {
+        checks.push({
+            id: "db",
+            ok: true,
+            severity: "info",
+            detail: "no database yet — created on first crawl",
+        });
+    }
+    if (input.googleConnected) {
+        const exp = input.googleExpiresAt;
+        const stale = exp ? Date.parse(exp) < Date.now() : false;
+        checks.push({
+            id: "google",
+            ok: !stale,
+            severity: stale ? "warn" : "info",
+            detail: stale
+                ? "Google grant looks expired — reconnect with sean connect google"
+                : "Google grant present",
+        });
+    }
+    else {
+        checks.push({
+            id: "google",
+            ok: true,
+            severity: "info",
+            detail: "Google not connected (optional; audit works without it)",
+        });
+    }
+    checks.push({
+        id: "playwright",
+        ok: true,
+        severity: input.playwright ? "info" : "warn",
+        detail: input.playwright
+            ? "Playwright is available"
+            : "Playwright/Chromium not installed — JS rendering skipped until first crawl that needs it (not downloaded at install)",
+    });
+    checks.push({
+        id: "memory",
+        ok: true,
+        severity: "info",
+        detail: `${Math.round(os.freemem() / 1024 / 1024)} MB free`,
+    });
+    const ok = checks.every((c) => c.ok || c.severity !== "fail");
+    return { ok, version: VERSION, node: nodeVersion, checks };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { VERSION, CHANNELS, MIN_NODE, isChannel, nodeMeetsMin, type Channel, } from "./version.js";
+export { MIN_TOKEN_LENGTH, MIN_TOKEN_UNIQUE_CHARS, TokenStrengthError, assertTokenStrength, envAuthToken, } from "./token-strength.js";
+export { TELEMETRY_EVENTS, dntHonored, previewPayload, assertSafePayload, loadTelemetryConfig, saveTelemetryConfig, isTelemetryEnabled, recordEvent, readTelemetryLog, consentTelemetry, telemetryPath, telemetryLogPath, type TelemetryPayload, type TelemetryConfig, type TelemetryEventName, } from "./telemetry.js";
+export { ONBOARD_QUESTIONS, CMS_KINDS, SERVICE_HINT, NOT_OUR_JOB, parseCms, parseSiteUrl, type OnboardQuestion, type OnboardAnswers, type CmsKind, } from "./onboard.js";
+export { runDoctor, portOpen, type DoctorCheck, type DoctorInput, type DoctorReport, } from "./doctor.js";
+export { serviceKind, planService, writeService, removeServiceFile, type ServiceKind, type ServicePlan, type ServicePlanInput, } from "./service.js";
+export { RECIPES, recipeById, type Recipe } from "./recipes.js";
+export { provisionHome, readInstallMethod, isOnboarded, markOnboarded, onboardedPath, hasPostinstallScripts, type InstallMethod, } from "./provision.js";
+export { checkUpdate } from "./update.js";
+export { INSTALL_FLAGS, planInstall, type InstallPlan } from "./install.js";
+export { POSITIONING, OPENSEO_CREDIT, recipePage, recipesIndex } from "./site.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,KAAK,OAAO,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,OAAO,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { VERSION, CHANNELS, MIN_NODE, isChannel, nodeMeetsMin, } from "./version.js";
+export { MIN_TOKEN_LENGTH, MIN_TOKEN_UNIQUE_CHARS, TokenStrengthError, assertTokenStrength, envAuthToken, } from "./token-strength.js";
+export { TELEMETRY_EVENTS, dntHonored, previewPayload, assertSafePayload, loadTelemetryConfig, saveTelemetryConfig, isTelemetryEnabled, recordEvent, readTelemetryLog, consentTelemetry, telemetryPath, telemetryLogPath, } from "./telemetry.js";
+export { ONBOARD_QUESTIONS, CMS_KINDS, SERVICE_HINT, NOT_OUR_JOB, parseCms, parseSiteUrl, } from "./onboard.js";
+export { runDoctor, portOpen, } from "./doctor.js";
+export { serviceKind, planService, writeService, removeServiceFile, } from "./service.js";
+export { RECIPES, recipeById } from "./recipes.js";
+export { provisionHome, readInstallMethod, isOnboarded, markOnboarded, onboardedPath, hasPostinstallScripts, } from "./provision.js";
+export { checkUpdate } from "./update.js";
+export { INSTALL_FLAGS, planInstall } from "./install.js";
+export { POSITIONING, OPENSEO_CREDIT, recipePage, recipesIndex } from "./site.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,YAAY,GAEb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GAIjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,YAAY,GAIb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,QAAQ,GAIT,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,GAIlB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,cAAc,CAAC;AAChE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EACb,qBAAqB,GAEtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,22 @@
+/** Canonical installer flag surface. install.sh and install.ps1 must match. */
+export declare const INSTALL_FLAGS: readonly ["--no-onboard", "--version=", "--prefix=", "--channel=", "--from-source=", "--dry-run", "--help"];
+export declare const INSTALL_CHANNELS: readonly ["stable", "extended-stable", "dev"];
+export type InstallPlan = {
+    prefix: string;
+    channel: string;
+    onboard: boolean;
+    fromSource: string | null;
+    version: string | null;
+    dryRun: boolean;
+    steps: string[];
+};
+export declare function planInstall(args: {
+    prefix?: string | undefined;
+    channel?: string | undefined;
+    onboard?: boolean | undefined;
+    fromSource?: string | null | undefined;
+    version?: string | null | undefined;
+    dryRun?: boolean | undefined;
+    nodePresent?: boolean | undefined;
+}): InstallPlan;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,aAAa,6GAQhB,CAAC;AAEX,eAAO,MAAM,gBAAgB,+CAAgD,CAAC;AAE9E,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC,GAAG,WAAW,CA6Bd"}

package/dist/install.js

@@ -0,0 +1,42 @@
+/** Canonical installer flag surface. install.sh and install.ps1 must match. */
+export const INSTALL_FLAGS = [
+    "--no-onboard",
+    "--version=",
+    "--prefix=",
+    "--channel=",
+    "--from-source=",
+    "--dry-run",
+    "--help",
+];
+export const INSTALL_CHANNELS = ["stable", "extended-stable", "dev"];
+export function planInstall(args) {
+    const prefix = args.prefix ?? "~/.sean";
+    const channel = args.channel ?? "stable";
+    const onboard = args.onboard ?? true;
+    const fromSource = args.fromSource ?? null;
+    const version = args.version ?? null;
+    const dryRun = args.dryRun ?? false;
+    const nodePresent = args.nodePresent ?? true;
+    const steps = [];
+    if (!nodePresent) {
+        steps.push(`download Node >= 22.19 into ${prefix}/runtime (official nodejs.org tarball)`);
+    }
+    else {
+        steps.push("use Node already on PATH");
+    }
+    if (fromSource) {
+        steps.push(`link CLI from source at ${fromSource} (no npm lifecycle scripts)`);
+    }
+    else {
+        steps.push(version
+            ? `npm install -g agentsean@${version} (no postinstall; npm 12+ safe)`
+            : `npm install -g agentsean@${channel === "stable" ? "latest" : channel} (no postinstall; npm 12+ safe)`);
+    }
+    steps.push(`provision ${prefix} on first run, not at install`);
+    if (onboard)
+        steps.push("run sean onboard");
+    else
+        steps.push("skip onboard (--no-onboard)");
+    return { prefix, channel, onboard, fromSource, version, dryRun, steps };
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,cAAc;IACd,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,CAAU,CAAC;AAY9E,MAAM,UAAU,WAAW,CAAC,IAQ3B;IACC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CACR,+BAA+B,MAAM,wCAAwC,CAC9E,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,UAAU,6BAA6B,CAAC,CAAC;IACjF,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,OAAO;YACL,CAAC,CAAC,4BAA4B,OAAO,iCAAiC;YACtE,CAAC,CAAC,4BAA4B,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,iCAAiC,CAC3G,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,+BAA+B,CAAC,CAAC;IAC/D,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;;QACvC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC1E,CAAC"}

package/dist/onboard.d.ts

@@ -0,0 +1,21 @@
+export declare const CMS_KINDS: readonly ["wordpress", "shopify", "git", "cloudflare", "other"];
+export type CmsKind = (typeof CMS_KINDS)[number];
+export type OnboardQuestion = {
+    id: "url" | "cms" | "google" | "telemetry";
+    prompt: string;
+    required: boolean;
+    options?: string[];
+};
+/** Four questions. Service install is a separate command (marketplace guideline). */
+export declare const ONBOARD_QUESTIONS: OnboardQuestion[];
+export type OnboardAnswers = {
+    url: string;
+    cms: CmsKind;
+    google: "yes" | "later";
+    telemetry: boolean;
+};
+export declare function parseCms(raw: string | undefined): CmsKind | undefined;
+export declare function parseSiteUrl(raw: string | undefined): string | undefined;
+export declare const SERVICE_HINT = "Sean is running for this session. To survive reboot, run `sean service install` \u2014 it prints the exact files it will write and is never a side effect of npm or onboard.";
+export declare const NOT_OUR_JOB: string[];
+//# sourceMappingURL=onboard.d.ts.map

package/dist/onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../src/onboard.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,iEAMZ,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAyB9C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAIrE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASxE;AAED,eAAO,MAAM,YAAY,iLACkJ,CAAC;AAE5K,eAAO,MAAM,WAAW,UAIvB,CAAC"}

package/dist/onboard.js

@@ -0,0 +1,59 @@
+export const CMS_KINDS = [
+    "wordpress",
+    "shopify",
+    "git",
+    "cloudflare",
+    "other",
+];
+/** Four questions. Service install is a separate command (marketplace guideline). */
+export const ONBOARD_QUESTIONS = [
+    {
+        id: "url",
+        prompt: "What site should Sean work on?",
+        required: true,
+    },
+    {
+        id: "cms",
+        prompt: "Where does the site live?",
+        required: true,
+        options: [...CMS_KINDS],
+    },
+    {
+        id: "google",
+        prompt: "Connect Google Search Console now? Audit works without it.",
+        required: false,
+        options: ["yes", "later"],
+    },
+    {
+        id: "telemetry",
+        prompt: "Share anonymous usage events? Never domains, URLs, queries, keys, or IPs. Honor DO_NOT_TRACK=1.",
+        required: false,
+        options: ["yes", "no"],
+    },
+];
+export function parseCms(raw) {
+    if (!raw)
+        return undefined;
+    const v = raw.trim().toLowerCase();
+    return CMS_KINDS.includes(v) ? v : undefined;
+}
+export function parseSiteUrl(raw) {
+    if (!raw)
+        return undefined;
+    try {
+        const u = new URL(raw);
+        if (u.protocol !== "http:" && u.protocol !== "https:")
+            return undefined;
+        return u.origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+export const SERVICE_HINT = "Sean is running for this session. To survive reboot, run `sean service install` — it prints the exact files it will write and is never a side effect of npm or onboard.";
+export const NOT_OUR_JOB = [
+    "stakeholder negotiation",
+    "strategy arguments",
+    "deciding whether a business should want the traffic",
+];
+//# sourceMappingURL=onboard.js.map

package/dist/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../src/onboard.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW;IACX,SAAS;IACT,KAAK;IACL,YAAY;IACZ,OAAO;CACC,CAAC;AAUX,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD;QACE,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,gCAAgC;QACxC,QAAQ,EAAE,IAAI;KACf;IACD;QACE,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,2BAA2B;QACnC,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC;KACxB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,MAAM,EAAE,4DAA4D;QACpE,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;KAC1B;IACD;QACE,EAAE,EAAE,WAAW;QACf,MAAM,EACJ,iGAAiG;QACnG,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC;KACvB;CACF,CAAC;AASF,MAAM,UAAU,QAAQ,CAAC,GAAuB;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,OAAQ,SAA+B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAuB;IAClD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACxE,OAAO,CAAC,CAAC,MAAM,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GACvB,yKAAyK,CAAC;AAE5K,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,yBAAyB;IACzB,oBAAoB;IACpB,qDAAqD;CACtD,CAAC"}

package/dist/provision.d.ts

@@ -0,0 +1,13 @@
+/**
+ * First-run provisioning. npm v12 disables preinstall/install/postinstall
+ * by default — nothing in this package runs at install time. Chromium is
+ * not downloaded here; the crawler fetches it lazily on first JS render.
+ */
+export type InstallMethod = "npx" | "npm" | "curl" | "homebrew" | "docker" | "source";
+export declare function provisionHome(home: string, method?: InstallMethod): string;
+export declare function readInstallMethod(home: string): InstallMethod;
+export declare function onboardedPath(home: string): string;
+export declare function isOnboarded(home: string): boolean;
+export declare function markOnboarded(home: string): void;
+export declare function hasPostinstallScripts(scripts: Record<string, string> | undefined): boolean;
+//# sourceMappingURL=provision.d.ts.map

package/dist/provision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,aAAqB,GAAG,MAAM,CAcjF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAiB7D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC1C,OAAO,CAGT"}

package/dist/provision.js

@@ -0,0 +1,52 @@
+import fs from "node:fs";
+import path from "node:path";
+export function provisionHome(home, method = "npx") {
+    fs.mkdirSync(home, { recursive: true, mode: 0o700 });
+    if (process.platform !== "win32") {
+        try {
+            fs.chmodSync(home, 0o700);
+        }
+        catch {
+            // best-effort
+        }
+    }
+    const marker = path.join(home, "install-method");
+    if (!fs.existsSync(marker)) {
+        fs.writeFileSync(marker, method + "\n", { mode: 0o600 });
+    }
+    return home;
+}
+export function readInstallMethod(home) {
+    try {
+        const raw = fs.readFileSync(path.join(home, "install-method"), "utf8").trim();
+        if (raw === "npx" ||
+            raw === "npm" ||
+            raw === "curl" ||
+            raw === "homebrew" ||
+            raw === "docker" ||
+            raw === "source") {
+            return raw;
+        }
+    }
+    catch {
+        // first run
+    }
+    return "npx";
+}
+export function onboardedPath(home) {
+    return path.join(home, "onboarded");
+}
+export function isOnboarded(home) {
+    return fs.existsSync(onboardedPath(home));
+}
+export function markOnboarded(home) {
+    fs.writeFileSync(onboardedPath(home), new Date().toISOString() + "\n", {
+        mode: 0o600,
+    });
+}
+export function hasPostinstallScripts(scripts) {
+    if (!scripts)
+        return false;
+    return Boolean(scripts["preinstall"] || scripts["install"] || scripts["postinstall"]);
+}
+//# sourceMappingURL=provision.js.map

package/dist/provision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.js","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,SAAwB,KAAK;IACvE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9E,IACE,GAAG,KAAK,KAAK;YACb,GAAG,KAAK,KAAK;YACb,GAAG,KAAK,MAAM;YACd,GAAG,KAAK,UAAU;YAClB,GAAG,KAAK,QAAQ;YAChB,GAAG,KAAK,QAAQ,EAChB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,IAAI,EAAE;QACrE,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA2C;IAE3C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/recipes.d.ts

@@ -0,0 +1,11 @@
+export type Recipe = {
+    id: string;
+    title: string;
+    summary: string;
+    cms: string[];
+    href: string;
+    steps: string[];
+};
+export declare const RECIPES: Recipe[];
+export declare function recipeById(id: string): Recipe | undefined;
+//# sourceMappingURL=recipes.d.ts.map

package/dist/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAAM,EAwO3B,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzD"}