harnery 0.40.0 → 0.41.0

package/dist/lib/browser/index.d.ts.map

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

package/dist/lib/browser/index.js

@@ -3,7 +3,7 @@ export { Browser, BrowserSessionActionError, } from "./client.js";
 export { bandRects, DEFAULT_CRITIQUE_RUBRIC, normalizeFindings, runCritique, tilesFromFullPage, } from "./critique.js";
 export { captureDevOverlay, } from "./dev-overlay.js";
 export { buildLayoutLintCheck } from "./geometry.js";
-export { isWSL, wslHeadedLaunchArgs } from "./launch-args.js";
+export { AUTOMATION_DEFAULT_ARGS_TO_DROP, automationDisguiseArgs, installedChromeChannel, installedChromePath, isWSL, wslHeadedLaunchArgs, } from "./launch-args.js";
 export { serializeNetscapeCookies, writeNetscapeCookieFile, } from "./netscape-cookies.js";
 export { nativePixelDigest } from "./page-review-evidence.js";
 export { judgePageReviewPack, toCritiqueRecords, } from "./page-review-judge.js";
@@ -15,3 +15,4 @@ export { computeVerdict, contextIdFor, mergeCoverage, QA_RUN_JOB_SCHEMA_VERSION,
 export { listQaSnapshotTargets, loadQaSnapshot, QA_SNAPSHOT_DIR, qaSnapshotKey, resolveQaBaseline, saveQaSnapshot, } from "./qa-snapshot.js";
 export { BROWSER_SESSION_MAX_FILL_BYTES, BROWSER_SESSION_MAX_FRAME_BYTES, BROWSER_SESSION_MAX_INSPECTION_TEXT_BYTES, BROWSER_SESSION_PROTOCOL_VERSION, BrowserSessionError, browserSessionTransport, readBrowserSessionDescriptor, sendBrowserSessionRequest, startBrowserSessionServer, } from "./session-control.js";
 export { bandOversizedRect, cutCost, snappedBandRects, } from "./tiling.js";
+export { chromeMajorFromExecutable, hostFamily, normalUserAgent, readStoredUserAgent, resolveUserAgent, } from "./user-agent.js";

package/dist/lib/browser/launch-args.d.ts

@@ -18,4 +18,30 @@ export declare function isWSL(): boolean;
  * headed launches. See the module doc for the failure mode.
  */
 export declare function wslHeadedLaunchArgs(): string[];
+/**
+ * Playwright's bundled browser is "Chrome for Testing", launched with
+ * `--enable-automation`. Both are visible to the page: the User-Agent brand
+ * list carries "Chrome for Testing" and `navigator.webdriver` reads true, so
+ * sign-in flows on sites that screen for automation (X, some banks, some
+ * Cloudflare-fronted apps) silently refuse clicks in a headed window that a
+ * person is driving. Headed sessions therefore launch the operator's real
+ * Google Chrome when one is installed and drop the automation signals.
+ */
+/** Default Chromium args Playwright adds that a headed session must not carry. */
+export declare const AUTOMATION_DEFAULT_ARGS_TO_DROP: readonly string[];
+/** Launch flags that stop Blink from reporting the automation state to pages. */
+export declare function automationDisguiseArgs(): string[];
+/**
+ * `"chrome"` when a stable Google Chrome install is present at a well-known
+ * path for this platform, else `undefined` (use Playwright's bundled
+ * Chromium). Playwright resolves the `chrome` channel to the same install, so
+ * the check only has to answer whether asking for it can succeed.
+ */
+export declare function installedChromeChannel(platform?: NodeJS.Platform, exists?: (path: string) => boolean): "chrome" | undefined;
+/**
+ * Filesystem path of the installed stable Google Chrome for this platform, or
+ * `undefined`. Used to spawn Chrome with nothing attached for sign-in flows
+ * whose verification vendors detect the DevTools protocol itself.
+ */
+export declare function installedChromePath(platform?: NodeJS.Platform, exists?: (path: string) => boolean): string | undefined;
 //# sourceMappingURL=launch-args.d.ts.map

package/dist/lib/browser/launch-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch-args.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/launch-args.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,kDAAkD;AAClD,wBAAgB,KAAK,IAAI,OAAO,CAO/B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}
+{"version":3,"file":"launch-args.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/launch-args.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,kDAAkD;AAClD,wBAAgB,KAAK,IAAI,OAAO,CAO/B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,eAAO,MAAM,+BAA+B,EAAE,SAAS,MAAM,EAA4B,CAAC;AAE1F,iFAAiF;AACjF,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD;AAWD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GAC7C,QAAQ,GAAG,SAAS,CAEtB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GAC7C,MAAM,GAAG,SAAS,CAEpB"}

package/dist/lib/browser/launch-args.js

@@ -1,4 +1,4 @@
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 /**
  * Chromium launch-arg helpers for environment-specific workarounds.
  *
@@ -30,3 +30,43 @@ export function isWSL() {
 export function wslHeadedLaunchArgs() {
     return isWSL() ? ["--disable-gpu"] : [];
 }
+/**
+ * Playwright's bundled browser is "Chrome for Testing", launched with
+ * `--enable-automation`. Both are visible to the page: the User-Agent brand
+ * list carries "Chrome for Testing" and `navigator.webdriver` reads true, so
+ * sign-in flows on sites that screen for automation (X, some banks, some
+ * Cloudflare-fronted apps) silently refuse clicks in a headed window that a
+ * person is driving. Headed sessions therefore launch the operator's real
+ * Google Chrome when one is installed and drop the automation signals.
+ */
+/** Default Chromium args Playwright adds that a headed session must not carry. */
+export const AUTOMATION_DEFAULT_ARGS_TO_DROP = ["--enable-automation"];
+/** Launch flags that stop Blink from reporting the automation state to pages. */
+export function automationDisguiseArgs() {
+    return ["--disable-blink-features=AutomationControlled"];
+}
+const CHROME_PATHS = {
+    linux: ["/usr/bin/google-chrome", "/usr/bin/google-chrome-stable", "/opt/google/chrome/chrome"],
+    darwin: ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"],
+    win32: [
+        "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
+        "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
+    ],
+};
+/**
+ * `"chrome"` when a stable Google Chrome install is present at a well-known
+ * path for this platform, else `undefined` (use Playwright's bundled
+ * Chromium). Playwright resolves the `chrome` channel to the same install, so
+ * the check only has to answer whether asking for it can succeed.
+ */
+export function installedChromeChannel(platform = process.platform, exists = existsSync) {
+    return installedChromePath(platform, exists) ? "chrome" : undefined;
+}
+/**
+ * Filesystem path of the installed stable Google Chrome for this platform, or
+ * `undefined`. Used to spawn Chrome with nothing attached for sign-in flows
+ * whose verification vendors detect the DevTools protocol itself.
+ */
+export function installedChromePath(platform = process.platform, exists = existsSync) {
+    return (CHROME_PATHS[platform] ?? []).find((candidate) => exists(candidate));
+}

package/dist/lib/browser/user-agent.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Present as a normal browser.
+ *
+ * A desktop-Linux user agent is itself a block signal: web application
+ * firewalls commonly deny "X11; Linux" outright because almost no customer
+ * browses from desktop Linux, and headless builds announce "HeadlessChrome".
+ * Sunbelt Network's Cloudflare rule was the reported case: the same page
+ * answered 200 the moment the browser said Windows. Every Harnery page load
+ * therefore uses a user agent for the host the operator actually sits at
+ * (Windows under WSL or on Windows, macOS on a Mac), never Linux, with the
+ * Chrome major version of the browser that is really running.
+ *
+ * The resolved string is persisted at `~/.cache/harnery/user-agent.json` so
+ * every process reuses the one that works; `HARNERY_BROWSER_UA` overrides it
+ * for a run (`native` disables the override), and `--user-agent` on `browse`
+ * rewrites the stored value.
+ */
+export type HostFamily = "windows" | "mac";
+/** Windows unless the operator is on a Mac. Linux never presents as Linux. */
+export declare function hostFamily(platform?: NodeJS.Platform): HostFamily;
+/** A current-shape Chrome user agent for the host family and Chrome major. */
+export declare function normalUserAgent(chromeMajor: number, family: HostFamily): string;
+/** Major version from `<chrome> --version` output, or `undefined`. */
+export declare function parseChromeMajor(versionOutput: string): number | undefined;
+/** Ask an installed Chrome binary for its major version. */
+export declare function chromeMajorFromExecutable(executable: string): number | undefined;
+export interface StoredUserAgent {
+    userAgent: string;
+    source: "auto" | "manual";
+    chromeMajor?: number;
+    updatedAt: string;
+}
+export declare function readStoredUserAgent(path?: string): StoredUserAgent | undefined;
+export declare function writeStoredUserAgent(entry: StoredUserAgent, path?: string): void;
+export interface ResolveUserAgentInput {
+    /** Explicit `--user-agent` value: a string, `"native"`, or `"auto"`. */
+    requested?: string;
+    /** `HARNERY_BROWSER_UA` from the environment. */
+    env?: string;
+    /** Major version of the Chrome that will actually launch, when known. */
+    chromeMajor?: number;
+    platform?: NodeJS.Platform;
+    storePath?: string;
+    now?: () => string;
+}
+/**
+ * The user agent to launch with, or `undefined` for the browser's native
+ * string. Precedence: explicit request, then environment, then the stored
+ * value (refreshed when the Chrome major moved), then a fresh auto value.
+ * An explicit string or `auto` request rewrites the store; `native` does not.
+ */
+export declare function resolveUserAgent(input?: ResolveUserAgentInput): string | undefined;
+//# sourceMappingURL=user-agent.d.ts.map

package/dist/lib/browser/user-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/user-agent.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;AAI3C,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,UAAU,CAEnF;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAG/E;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOhF;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,MAAmB,GAAG,eAAe,GAAG,SAAS,CAU1F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,GAAE,MAAmB,GAAG,IAAI,CAG5F;AAED,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,qBAA0B,GAAG,MAAM,GAAG,SAAS,CAiCtF"}

package/dist/lib/browser/user-agent.js

@@ -0,0 +1,79 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+const STORE_PATH = resolve(homedir(), ".cache", "harnery", "user-agent.json");
+/** Windows unless the operator is on a Mac. Linux never presents as Linux. */
+export function hostFamily(platform = process.platform) {
+    return platform === "darwin" ? "mac" : "windows";
+}
+/** A current-shape Chrome user agent for the host family and Chrome major. */
+export function normalUserAgent(chromeMajor, family) {
+    const os = family === "mac" ? "Macintosh; Intel Mac OS X 10_15_7" : "Windows NT 10.0; Win64; x64";
+    return `Mozilla/5.0 (${os}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${chromeMajor}.0.0.0 Safari/537.36`;
+}
+/** Major version from `<chrome> --version` output, or `undefined`. */
+export function parseChromeMajor(versionOutput) {
+    const match = /(\d+)\.\d+\.\d+\.\d+/.exec(versionOutput);
+    return match ? Number(match[1]) : undefined;
+}
+/** Ask an installed Chrome binary for its major version. */
+export function chromeMajorFromExecutable(executable) {
+    try {
+        const res = spawnSync(executable, ["--version"], { encoding: "utf8", timeout: 5000 });
+        return parseChromeMajor(`${res.stdout ?? ""}${res.stderr ?? ""}`);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function readStoredUserAgent(path = STORE_PATH) {
+    try {
+        if (!existsSync(path))
+            return undefined;
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        return typeof parsed.userAgent === "string" && parsed.userAgent.length > 0
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function writeStoredUserAgent(entry, path = STORE_PATH) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(entry, null, 2)}\n`, { mode: 0o600 });
+}
+/**
+ * The user agent to launch with, or `undefined` for the browser's native
+ * string. Precedence: explicit request, then environment, then the stored
+ * value (refreshed when the Chrome major moved), then a fresh auto value.
+ * An explicit string or `auto` request rewrites the store; `native` does not.
+ */
+export function resolveUserAgent(input = {}) {
+    const now = input.now ?? (() => new Date().toISOString());
+    const family = hostFamily(input.platform);
+    const requested = input.requested?.trim();
+    if (requested && requested !== "auto") {
+        if (requested === "native")
+            return undefined;
+        writeStoredUserAgent({ userAgent: requested, source: "manual", updatedAt: now() }, input.storePath);
+        return requested;
+    }
+    const env = input.env?.trim();
+    if (env && requested !== "auto") {
+        return env === "native" ? undefined : env;
+    }
+    const stored = readStoredUserAgent(input.storePath);
+    if (stored &&
+        requested !== "auto" &&
+        (stored.source === "manual" ||
+            input.chromeMajor === undefined ||
+            stored.chromeMajor === input.chromeMajor)) {
+        return stored.userAgent;
+    }
+    const major = input.chromeMajor ?? stored?.chromeMajor ?? 149;
+    const userAgent = normalUserAgent(major, family);
+    writeStoredUserAgent({ userAgent, source: "auto", chromeMajor: major, updatedAt: now() }, input.storePath);
+    return userAgent;
+}

package/dist/lib/docs-metadata-managed.d.ts

@@ -1,4 +1,5 @@
 import { type DocsMetadataType } from "./docs-metadata-v2.js";
+export declare function initDocsMetadataExclusions(prefixes: readonly string[] | undefined): void;
 /**
  * Paths whose Markdown carries frontmatter belonging to another system:
  * generated mirrors of documents that live elsewhere, vendored vendor

package/dist/lib/docs-metadata-managed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-metadata-managed.d.ts","sourceRoot":"","sources":["../../src/lib/docs-metadata-managed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAwC,MAAM,uBAAuB,CAAC;AAMpG;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAahE;AAmBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,OAAO,GACtB,gBAAgB,GAAG,IAAI,CAczB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,OAAO,GACtB,OAAO,CAIT"}
+{"version":3,"file":"docs-metadata-managed.d.ts","sourceRoot":"","sources":["../../src/lib/docs-metadata-managed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAwC,MAAM,uBAAuB,CAAC;AAgBpG,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,CAExF;AAQD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAchE;AAmBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,OAAO,GACtB,gBAAgB,GAAG,IAAI,CAczB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,OAAO,GACtB,OAAO,CAIT"}

package/dist/lib/docs-metadata-managed.js

@@ -3,6 +3,21 @@ import { isDocsMetadataType, isDocsMetadataV2 } from "./docs-metadata-v2.js";
 function normalized(path) {
     return path.replaceAll("\\", "/");
 }
+/** Host-supplied path prefixes that carry another system's frontmatter.
+ *
+ * Hosts declare these once (harnery's `extraDocsExcludedPrefixes`) for
+ * generated reference dumps and vendored upstream trees. Every metadata
+ * consumer reads them through `isExcludedDocsMetadataPath`, so a prefix
+ * listed by the host is honored by the audit and the sync, not only by the
+ * lint's own file discovery.
+ */
+let EXTRA_EXCLUDED_PREFIXES = [];
+export function initDocsMetadataExclusions(prefixes) {
+    EXTRA_EXCLUDED_PREFIXES = prefixes ?? [];
+}
+function hasExcludedPrefix(rel) {
+    return EXTRA_EXCLUDED_PREFIXES.some((prefix) => rel.startsWith(prefix) || rel.includes(`/${prefix}`));
+}
 /**
  * Paths whose Markdown carries frontmatter belonging to another system:
  * generated mirrors of documents that live elsewhere, vendored vendor
@@ -11,7 +26,8 @@ function normalized(path) {
 export function isExcludedDocsMetadataPath(path) {
     const rel = normalized(path);
     const segments = rel.split("/");
-    return (segments.includes(".wiki-data") ||
+    return (hasExcludedPrefix(rel) ||
+        segments.includes(".wiki-data") ||
         // Dashboard surfaces render from copies of other repositories' documents.
         /(?:^|\/)content\/dashboards\//.test(rel) ||
         /(?:^|\/)docs\/shopify\/admin-api\//.test(rel) ||

package/dist/lib/identities/assume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assume.d.ts","sourceRoot":"","sources":["../../../src/lib/identities/assume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAuBH,MAAM,MAAM,uBAAuB,GAC/B,eAAe,GACf,iBAAiB,GACjB,sBAAsB,GACtB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,GACb,mBAAmB,CAAC;AAExB,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,uBAAuB;gBAA7B,IAAI,EAAE,uBAAuB,EAC7C,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+DAA+D;IAC/D,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAOD;+EAC+E;AAC/E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAa,EAClB,mBAAmB,GAAE,WAAW,CAAC,MAAM,CAAa,GACnD,gBAAgB,GAAG,IAAI,CA6BzB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAyCT;AA0ED,gEAAgE;AAChE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,oBAAoB,CAyHtB"}
+{"version":3,"file":"assume.d.ts","sourceRoot":"","sources":["../../../src/lib/identities/assume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA0BH,MAAM,MAAM,uBAAuB,GAC/B,eAAe,GACf,iBAAiB,GACjB,sBAAsB,GACtB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,GACb,mBAAmB,CAAC;AAExB,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,uBAAuB;gBAA7B,IAAI,EAAE,uBAAuB,EAC7C,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+DAA+D;IAC/D,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAOD;+EAC+E;AAC/E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAa,EAClB,mBAAmB,GAAE,WAAW,CAAC,MAAM,CAAa,GACnD,gBAAgB,GAAG,IAAI,CA6BzB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAyCT;AAuED,gEAAgE;AAChE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,oBAAoB,CAyHtB"}

package/dist/lib/identities/assume.js

@@ -20,7 +20,8 @@ import { recordLiveSweepObservationV3 } from "../../core/agents/live-lifecycle-v
 import { readLiveCoordinationRow, readLiveCoordinationRows, } from "../../core/agents/state/live-coordination-view.js";
 import { resolveForkAncestry } from "../../core/agents/state/names.js";
 import { instanceHasLivePid, removePidmapRowsForInstance } from "../../core/agents/state/pidmap.js";
-import { coordFreshnessSeconds } from "../../core/config.js";
+import { coordFreshnessSeconds, resolveBinName } from "../../core/config.js";
+import { eventAdapterIdV3FromPlatform, } from "../../core/events/v3/adapter-id.js";
 import { readRemoteMachines } from "../../core/presence/index.js";
 import { bareName, ensureIdentity, lookupById, lookupByName } from "./index.js";
 const ASSUME_LOCK = "identity-assume.lock";
@@ -175,13 +176,7 @@ function acquireLock(coordRoot) {
     throw new IdentityAssumeError("identity_busy", "another identity assumption is in progress; retry in a moment");
 }
 function adapterOf(platform) {
-    if (platform === "cursor")
-        return "cursor";
-    if (platform === "codex")
-        return "codex";
-    if (platform === "openclaw")
-        return "openclaw";
-    return "claude-code";
+    return eventAdapterIdV3FromPlatform(platform, { context: "identity-assume" });
 }
 /** Assume `target` for one live main session. Safe to retry. */
 export function assumeIdentity(coordRoot, instanceId, target, opts) {
@@ -189,7 +184,7 @@ export function assumeIdentity(coordRoot, instanceId, target, opts) {
     try {
         const hb = readLiveCoordinationRow(coordRoot, instanceId);
         if (!hb) {
-            throw new IdentityAssumeError("no_live_generation", `no authority-safe live V3 generation for instance '${instanceId}'`);
+            throw new IdentityAssumeError("no_live_generation", `no authority-safe live V3 generation for instance '${instanceId}'; run \`${resolveBinName(coordRoot)} agents lifecycle active\` to open a fresh generation for this continuing session, then assume again`);
         }
         if (hb.kind && hb.kind !== "session") {
             throw new IdentityAssumeError("not_session", `identity assumption is limited to main sessions (current kind: ${hb.kind})`);

package/dist/lib/instructions/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/lib/instructions/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAyFH,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAYlE;AAmBD,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAoInF;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,CA8FrF;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC,WAAW,CA2Db"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/lib/instructions/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA2FH,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAYlE;AAmBD,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAoInF;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,CA8FrF;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC,WAAW,CA2Db"}

package/dist/lib/instructions/apply.js

@@ -33,6 +33,8 @@ const ADAPTER_SKILLS_DIR = {
     "claude-code": join(".claude", "skills"),
     cursor: join(".agents", "skills"),
     codex: join(".agents", "skills"),
+    // OpenCode natively discovers .agents/skills (and .claude/skills); no mirror needed.
+    opencode: join(".agents", "skills"),
 };
 function adapterSkillsDir(adapter) {
     return ADAPTER_SKILLS_DIR[adapter] ?? null;

package/dist/lib/pace/index.d.ts

@@ -0,0 +1,2 @@
+export { commandPaceGate, DEFAULT_PACE_LEDGER, DEFAULT_PACE_MAX_MS, DEFAULT_PACE_MIN_MS, describePaceWait, PaceGate, type PaceGateDeps, type PacePolicy, type PaceWait, pacePolicyFromEnv, paceSiteKey, sleepSync, } from "./pace.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/pace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/pace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,iBAAiB,EACjB,WAAW,EACX,SAAS,GACV,MAAM,WAAW,CAAC"}

package/dist/lib/pace/index.js

@@ -0,0 +1 @@
+export { commandPaceGate, DEFAULT_PACE_LEDGER, DEFAULT_PACE_MAX_MS, DEFAULT_PACE_MIN_MS, describePaceWait, PaceGate, pacePolicyFromEnv, paceSiteKey, sleepSync, } from "./pace.js";

package/dist/lib/pace/pace.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Human-pace gate for page loads.
+ *
+ * Every Harnery surface that loads a web page (`browse`, `browse-ai`, `fetch`,
+ * and the headed browse-session verbs) reserves a slot here before the request
+ * goes out. Consecutive loads against the same registrable site are spaced by
+ * a random gap inside `[minMs, maxMs]`, the way a person reads one page before
+ * opening the next. Loads against different sites do not wait on each other.
+ * Loopback, private-network, single-label, and reserved-suffix hosts are exempt
+ * so local development and page QA keep running at machine speed.
+ *
+ * The ledger is a small machine-local JSON file (`~/.cache/harnery/pace.json`)
+ * shared by every process, so separate `harn fetch` calls in a shell loop are
+ * paced the same as one long `harn browse` session. A caller reserves the next
+ * slot before it sleeps, so concurrent processes queue behind each other
+ * instead of all firing at once.
+ *
+ * The gate is on by default. `HARNERY_PACE=off` disables it machine-wide and
+ * each command carries `--no-pace` for a single run.
+ */
+export declare const DEFAULT_PACE_MIN_MS = 3000;
+export declare const DEFAULT_PACE_MAX_MS = 9000;
+export declare const DEFAULT_PACE_LEDGER: string;
+export interface PacePolicy {
+    /** False turns the gate into a no-op. Default true. */
+    enabled: boolean;
+    /** Shortest gap between two loads of the same site, in ms. */
+    minMs: number;
+    /** Longest gap between two loads of the same site, in ms. */
+    maxMs: number;
+    /** Extra exempt host suffixes (`example.test` matches itself and `*.example.test`). */
+    exemptSuffixes: string[];
+    /** Path of the shared reservation ledger. */
+    ledgerPath: string;
+}
+export interface PaceWait {
+    /** Registrable site the reservation was made against. */
+    site: string;
+    /** Milliseconds the caller waited (0 when the slot was free). */
+    waitMs: number;
+}
+export interface PaceGateDeps {
+    now?: () => number;
+    random?: () => number;
+    /** Called after a reservation, whether or not it waited. */
+    onWait?: (wait: PaceWait) => void;
+}
+/**
+ * Resolve the pace policy from the environment.
+ *
+ * - `HARNERY_PACE`: `off` (or `0`, `false`, `no`) disables the gate. Unset or
+ *   `human` keeps the default.
+ * - `HARNERY_PACE_MIN_MS` / `HARNERY_PACE_MAX_MS`: gap bounds in ms. Both must
+ *   be non-negative integers with min <= max.
+ * - `HARNERY_PACE_EXEMPT`: comma-separated host suffixes that never wait.
+ * - `HARNERY_PACE_LEDGER`: ledger path override.
+ */
+export declare function pacePolicyFromEnv(env?: NodeJS.ProcessEnv): PacePolicy;
+/**
+ * Registrable site a URL belongs to for pacing purposes, or `null` when the
+ * URL is exempt: a non-HTTP scheme, a loopback or private address, a
+ * single-label or reserved-suffix host, or a configured exemption.
+ */
+export declare function paceSiteKey(url: string, exemptSuffixes?: readonly string[]): string | null;
+/** Block the current thread for `ms`. Used by clients that drive a child process synchronously. */
+export declare function sleepSync(ms: number): void;
+export declare class PaceGate {
+    readonly policy: PacePolicy;
+    private readonly now;
+    private readonly random;
+    private readonly onWait;
+    constructor(policy: PacePolicy, deps?: PaceGateDeps);
+    /** A gate that never waits, for callers that opted out. */
+    static disabled(): PaceGate;
+    /**
+     * Reserve the next slot for `url` without sleeping. Returns how long the
+     * caller should wait before loading, or `null` when the URL is exempt or the
+     * gate is disabled. The reservation is recorded even when the wait is zero,
+     * so the next load of the same site owes a gap.
+     */
+    reserve(url: string): PaceWait | null;
+    /** Reserve a slot and wait it out asynchronously. */
+    before(url: string): Promise<PaceWait | null>;
+    /** Reserve a slot and block the thread for it. For `spawnSync`-driven clients. */
+    beforeSync(url: string): PaceWait | null;
+}
+/**
+ * Gate for a CLI command run. `null` when the run passed `--no-pace`;
+ * otherwise the environment policy, with every non-zero wait reported through
+ * `log` so the operator can see why a load took longer.
+ */
+export declare function commandPaceGate(optedIn: boolean, log: (message: string) => void): PaceGate | null;
+/** Describe a wait for a human-facing log line. */
+export declare function describePaceWait(wait: PaceWait): string;
+//# sourceMappingURL=pace.d.ts.map

package/dist/lib/pace/pace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pace.d.ts","sourceRoot":"","sources":["../../../src/lib/pace/pace.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AACzC,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AACzC,eAAO,MAAM,mBAAmB,QAAuD,CAAC;AAUxF,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;CACnC;AAgBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,UAAU,CAuBlF;AAwED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,GAAG,IAAI,CAmB9F;AAED,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED,qBAAa,QAAQ;IAMjB,QAAQ,CAAC,MAAM,EAAE,UAAU;IAL7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAGrD,MAAM,EAAE,UAAU,EAC3B,IAAI,GAAE,YAAiB;IAOzB,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,IAAI,QAAQ;IAI3B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAqBrC,qDAAqD;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAQnD,kFAAkF;IAClF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;CAKzC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,QAAQ,GAAG,IAAI,CAOjG;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAGvD"}