publishport-opencli 1.0.0

package/dist/src/browser-session-lock.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 在机器级浏览器会话锁的保护下执行 fn。并发调用会排队串行；顺序调用无等待。
+ * fn 抛出会原样冒泡，锁始终在 finally 里释放。
+ * scope 非空时按 scope 独立加锁（托管 profile 名），不同 scope 互不阻塞。
+ */
+export declare function withBrowserSessionLock<T>(fn: () => Promise<T>, scope?: string): Promise<T>;
+/** 条件加锁：locked 为真时走串行锁，否则直接执行（前台/交互命令用独立窗口，无需串行）。 */
+export declare function withBrowserSessionLockIf<T>(locked: boolean, fn: () => Promise<T>, scope?: string): Promise<T>;
+export declare const __lockInternals: {
+    LOCK_PATH: string;
+    ACQUIRE_TIMEOUT_MS: number;
+    STALE_AFTER_MS: number;
+};

package/dist/src/browser-session-lock.js

@@ -0,0 +1 @@
+import{openSync as q,closeSync as H,writeSync as b,readFileSync as j,unlinkSync as Y,statSync as v,mkdirSync as D,utimesSync as Q}from"node:fs";import{join as N}from"node:path";import{homedir as F}from"node:os";const V=N(F(),".opencli"),Z=N(V,"browser-adapter-session.lock");function m(z){if(!z)return Z;const x=z.replace(/[^A-Za-z0-9_-]/g,"_");return N(V,`browser-adapter-session.${x}.lock`)}const W=180000,$=600000,u=60;function w(z){return new Promise((x)=>setTimeout(x,z))}function K(z){try{process.kill(z,0);return!0}catch(x){return x?.code==="EPERM"}}function U(z){try{const x=parseInt(j(z,"utf8").trim(),10);return Number.isFinite(x)?x:null}catch{return null}}function g(z){try{const x=q(z,"wx");try{b(x,String(process.pid))}finally{H(x)}return!0}catch(x){if(x?.code==="EEXIST")return!1;throw x}}function C(z){try{const x=U(z),G=Date.now()-v(z).mtimeMs;if(x!==null&&!K(x)||G>$)Y(z)}catch{}}export async function withBrowserSessionLock(z,x){try{D(V,{recursive:!0})}catch{}const G=m(x),B=Date.now()+W;while(!g(G)){C(G);if(g(G))break;if(Date.now()>=B)throw Error(`browser session lock busy: waited ${Math.round(W/1000)}s for another browser command to finish`);await w(u)}const J=setInterval(()=>{try{const X=new Date;Q(G,X,X)}catch{}},60000);if(typeof J.unref==="function")J.unref();try{return await z()}finally{clearInterval(J);try{Y(G)}catch{}}}export async function withBrowserSessionLockIf(z,x,G){return z?withBrowserSessionLock(x,G):x()}export const __lockInternals={LOCK_PATH:Z,ACQUIRE_TIMEOUT_MS:W,STALE_AFTER_MS:$};

package/dist/src/browser-session-lock.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/browser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/build-manifest.d.ts

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * Build-time CLI manifest compiler.
+ *
+ * Scans all JS CLI definitions in clis/ and pre-compiles them into a single
+ * manifest.json for instant cold-start registration.
+ *
+ * Usage: npx tsx src/build-manifest.ts [--allow-removals[=N]]
+ *
+ * Output: cli-manifest.json next to clis/
+ *
+ * Safety invariants:
+ *   - Adapters whose source file does not call `cli(...)` are silently
+ *     skipped (they are helpers / type modules, not commands).
+ *   - Adapters that look like commands but fail to import are reported as
+ *     failures, the manifest is NOT written, and the process exits 1. This
+ *     prevents a stale dist or a broken adapter from silently dropping
+ *     other adapters' entries (root cause of the "manifest lost 478 lines"
+ *     incident).
+ *   - Net-deletions vs the existing committed manifest abort the build by
+ *     default; pass `--allow-removals=N` (or just `--allow-removals` for any
+ *     amount) to confirm an intentional removal.
+ */
+import type { ManifestEntry } from './manifest-types.js';
+export type { ManifestEntry } from './manifest-types.js';
+/**
+ * Thrown by `loadManifestEntries` when an adapter file looks like a CLI
+ * module (matches CLI_MODULE_PATTERN) but cannot be imported. Callers
+ * decide whether to abort or aggregate failures across the whole scan.
+ */
+export declare class ManifestImportError extends Error {
+    readonly filePath: string;
+    readonly cause: unknown;
+    constructor(filePath: string, cause: unknown);
+}
+export interface BuildManifestResult {
+    entries: ManifestEntry[];
+    /** Adapters that look like CLI modules but failed to import. */
+    failures: ManifestImportError[];
+}
+export interface BuildManifestArgs {
+    /** Maximum number of entries that may be removed vs the existing manifest.
+     *  `Number.POSITIVE_INFINITY` disables the safety net entirely. */
+    allowRemovals: number;
+}
+export declare function normalizeManifestPath(relativePath: string): string;
+/**
+ * Load all manifest entries from a single adapter file.
+ *
+ * Returns `[]` for files that do not register a CLI command (helpers, types).
+ * Throws `ManifestImportError` when a file looks like a CLI module but its
+ * import or post-import processing fails — callers must decide whether to
+ * surface or aggregate the failure.
+ *
+ * The third argument `clisDir` is used to compute the POSIX-style
+ * `sourceFile` relative path; it defaults to the package's `clis/` dir so
+ * existing test callers stay backward-compatible.
+ */
+export declare function loadManifestEntries(filePath: string, site: string, importer?: (moduleHref: string) => Promise<unknown>, clisDir?: string): Promise<ManifestEntry[]>;
+/**
+ * Scan a `clis/` directory and aggregate per-adapter results. Import
+ * failures are collected in `failures` instead of crashing the whole scan,
+ * but the caller (e.g. `main()`) is expected to fail loud if any failure
+ * is present.
+ */
+export declare function scanClisDir(clisDir: string, importer?: (moduleHref: string) => Promise<unknown>): Promise<BuildManifestResult>;
+export declare function buildManifest(): Promise<BuildManifestResult>;
+export declare function serializeManifest(manifest: ManifestEntry[]): string;
+/**
+ * Metadata audit: every positional arg must carry a non-empty `help` string.
+ *
+ * Why this is a hard gate (not advisory):
+ *   - `opencli twitter followers --help` rendered `Arguments:\n  user  ` with
+ *     an empty trailing column. Agents and humans both saw a blank field —
+ *     impossible to recover the parameter's purpose without reading source.
+ *   - This is metadata completeness, not stylistic taste; failing closed is
+ *     the only way to keep the help surface trustworthy as adapters land.
+ *
+ * Note: semantic quality (e.g. "what does the optional positional mean when
+ * omitted?") is intentionally NOT enforced here. That belongs to a follow-up
+ * advisory audit — see PR plan `Arg metadata v2` for the structured
+ * `when_omitted / when_present / value_format` schema.
+ */
+export interface ManifestMetadataIssue {
+    site: string;
+    command: string;
+    arg: string;
+    sourceFile?: string;
+    reason: string;
+}
+export declare function findManifestMetadataIssues(entries: readonly ManifestEntry[]): ManifestMetadataIssue[];
+/**
+ * Diff helper: returns site/name keys that exist in `prev` but not in
+ * `next`. Used as a safety net to detect accidental mass-deletions caused
+ * by silently failing adapter imports.
+ */
+export declare function diffRemovedEntries(prev: readonly ManifestEntry[], next: readonly ManifestEntry[]): string[];
+/**
+ * Parse `--allow-removals` and `--allow-removals=N` from argv.
+ * Bare `--allow-removals` disables the safety net (`Infinity`); the
+ * numeric form sets an explicit upper bound.
+ */
+export declare function parseBuildManifestArgs(argv: readonly string[]): BuildManifestArgs;

package/dist/src/build-manifest.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import*as V from"node:fs";import*as $ from"node:path";import{fileURLToPath as A,pathToFileURL as L}from"node:url";import{getErrorMessage as O}from"./errors.js";import{fullName as C,getRegistry as b}from"./registry.js";import{findPackageRoot as k,getCliManifestPath as E}from"./package-paths.js";import{isRecord as U}from"./utils.js";const j=k(A(import.meta.url)),w=$.join(j,"clis"),H=E(w),I=/\bcli\s*\(|\bregisterSiteAuthCommands\s*\(|\bregisterArticleLogin\s*\(|\bregisterTokenAuth\s*\(|\bmake[A-Z]\w*Command\s*\(/;export class ManifestImportError extends Error{filePath;cause;constructor(q,J){super(`failed to scan ${q}: ${O(J)}`);this.filePath=q;this.cause=J;this.name="ManifestImportError"}}function T(q){return q.map((J)=>({name:J.name,type:J.type??"str",default:J.default,required:!!J.required,valueRequired:!!J.valueRequired||void 0,positional:J.positional||void 0,help:J.help??"",choices:J.choices}))}function D(q,J){const W=$.basename(q,$.extname(q));return`${J}/${W}.js`}export function normalizeManifestPath(q){return q.replace(/\\/g,"/")}function M(q,J){return normalizeManifestPath($.relative(J,q))}function y(q,J){return U(q)&&typeof q.site==="string"&&q.site===J&&typeof q.name==="string"&&(q.access==="read"||q.access==="write")&&Array.isArray(q.args)}function R(q,J,W){return{site:q.site,name:q.name,aliases:q.aliases,description:q.description??"",access:q.access,example:q.example,domain:q.domain,strategy:(q.strategy??"public").toString().toLowerCase(),browser:q.browser??!0,args:T(q.args),columns:q.columns,defaultFormat:q.defaultFormat,type:"js",modulePath:J,sourceFile:W,navigateBefore:q.navigateBefore,siteSession:q.siteSession,defaultWindowMode:q.defaultWindowMode}}export async function loadManifestEntries(q,J,W=(G)=>import(G),X=w){let G;try{G=V.readFileSync(q,"utf-8")}catch(Q){throw new ManifestImportError(q,Q)}if(!I.test(G))return[];try{const Q=D(q,J),Y=b(),Z=new Map(Y.entries()),F=await W(L(q).href),z=Object.values(U(F)?F:{}).filter((B)=>y(B,J)),N=z.length>0?z:[...Y.entries()].filter(([B,S])=>{if(S.site!==J)return!1;const x=Z.get(B);return!x||x!==S}).map(([,B])=>B),K=M(q,X),_=new Set;return N.filter((B)=>{const S=C(B);if(_.has(S))return!1;_.add(S);return!0}).sort((B,S)=>B.name.localeCompare(S.name)).map((B)=>R(B,Q,K))}catch(Q){throw new ManifestImportError(q,Q)}}export async function scanClisDir(q,J=(W)=>import(W)){const W=new Map,X=[];if(!V.existsSync(q))return{entries:[],failures:X};for(const Q of V.readdirSync(q)){const Y=$.join(q,Q);if(!V.statSync(Y).isDirectory())continue;for(const Z of V.readdirSync(Y))if(Z.endsWith(".js")&&!Z.endsWith(".d.js")&&!Z.endsWith(".test.js")&&Z!=="index.js"){const F=$.join(Y,Z);try{const z=await loadManifestEntries(F,Q,J,q);for(const N of z){const K=`${N.site}/${N.name}`;W.set(K,N)}}catch(z){if(z instanceof ManifestImportError){X.push(z);continue}throw z}}}return{entries:[...W.values()].sort((Q,Y)=>Q.site.localeCompare(Y.site)||Q.name.localeCompare(Y.name)),failures:X}}export async function buildManifest(){return scanClisDir(w)}export function serializeManifest(q){return`${JSON.stringify(q,null,2)}
+`}export function findManifestMetadataIssues(q){const J=[];for(const W of q){if(!Array.isArray(W.args))continue;for(const X of W.args){if(!X.positional)continue;if((typeof X.help==="string"?X.help.trim():"")==="")J.push({site:W.site,command:W.name,arg:X.name,sourceFile:W.sourceFile,reason:"positional arg missing non-empty `help` text"})}}return J}export function diffRemovedEntries(q,J){const W=new Set(J.map((X)=>`${X.site}/${X.name}`));return q.map((X)=>`${X.site}/${X.name}`).filter((X)=>!W.has(X)).sort()}export function parseBuildManifestArgs(q){let J=0;for(const W of q){if(W==="--allow-removals"){J=Number.POSITIVE_INFINITY;continue}const X=W.match(/^--allow-removals=(\d+)$/);if(X){J=Number.parseInt(X[1],10);continue}}return{allowRemovals:J}}function v(q){try{if(!V.existsSync(q))return null;const J=V.readFileSync(q,"utf-8"),W=JSON.parse(J);return Array.isArray(W)?W:null}catch{return null}}async function g(){if(A(import.meta.url).includes(`${$.sep}dist${$.sep}`)){process.stderr.write(`❌ Refusing to run build-manifest from dist/.
+`+"   Stale compiled output silently drops adapters that import renamed/removed exports.\n   Run `npm run build-manifest` (or `tsx src/build-manifest.ts`) from the source tree instead.\n");process.exit(1)}const q=parseBuildManifestArgs(process.argv.slice(2)),{entries:J,failures:W}=await buildManifest();if(W.length>0){process.stderr.write(`❌ ${W.length} adapter(s) failed to load:
+`);for(const Q of W){const Y=$.relative(j,Q.filePath)||Q.filePath;process.stderr.write(`  - ${Y}: ${O(Q.cause)}
+`)}process.stderr.write(`
+Manifest NOT written. Likely cause: stale dist/ or a broken adapter import.
+Always run via tsx (\`npm run build-manifest\`), not against compiled dist/.
+`);process.exit(1)}const X=findManifestMetadataIssues(J);if(X.length>0){process.stderr.write(`❌ ${X.length} positional arg(s) missing \`help\` text:
+`);for(const Q of X){const Y=Q.sourceFile?` (${Q.sourceFile})`:"";process.stderr.write(`  - ${Q.site}/${Q.command} positional "${Q.arg}"${Y}
+`)}process.stderr.write("\nEvery positional arg must declare a non-empty `help` string so\n`opencli <site> <cmd> --help` shows callers what the parameter is for.\nAdd `help: '...'` to each arg above and re-run the build.\n");process.exit(1)}const G=v(H);if(G){const Q=diffRemovedEntries(G,J);if(Q.length>q.allowRemovals){process.stderr.write(`❌ ${Q.length} manifest entries would be removed; refusing to overwrite.
+`);const Y=Q.slice(0,20);for(const Z of Y)process.stderr.write(`  - ${Z}
+`);if(Q.length>Y.length)process.stderr.write(`  ... ${Q.length-Y.length} more
+`);process.stderr.write(`
+If this removal is intentional, rerun with \`--allow-removals=${Q.length}\` (or \`--allow-removals\` to disable the check).
+`);process.exit(1)}}V.mkdirSync($.dirname(H),{recursive:!0});V.writeFileSync(H,serializeManifest(J));console.log(`✅ Manifest compiled: ${J.length} entries → ${H}`);if(process.platform!=="win32"){const Q=j,Y=$.resolve(Q,"package.json");try{const Z=JSON.parse(V.readFileSync(Y,"utf-8")),F=typeof Z.bin==="string"?{[Z.name??"cli"]:Z.bin}:Z.bin??{};for(const z of Object.values(F)){const N=$.resolve(Q,z);if(V.existsSync(N)){V.chmodSync(N,493);console.log(`✅ Restored executable permission: ${z}`)}}}catch{}}}const p=process.argv[1]?L($.resolve(process.argv[1])).href:null;if(p===import.meta.url)g();

package/dist/src/build-manifest.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/capabilityRouting.d.ts

@@ -0,0 +1,19 @@
+import type { CliCommand } from './registry.js';
+/**
+ * Pipeline steps that require a live browser session.
+ *
+ * Note: this is the *subset* of registered pipeline steps that need a page;
+ * non-browser steps (fetch, select, map, filter, sort, limit, download)
+ * deliberately stay out. The full registered-step list lives in
+ * `src/pipeline/registry.ts` and is re-derived elsewhere via
+ * `getRegisteredStepNames()` (e.g. in `validate.ts`). When you add a new
+ * pipeline step, decide whether it belongs here based on whether its handler
+ * touches the IPage object — and `src/capabilityRouting.test.ts` verifies the
+ * subset relationship is intact.
+ */
+export declare const BROWSER_ONLY_STEPS: Set<string>;
+/** Internal helper: ensure BROWSER_ONLY_STEPS is a subset of registered pipeline steps. */
+export declare function _validateBrowserOnlyStepsAgainstRegistry(): {
+    extras: string[];
+};
+export declare function shouldUseBrowserSession(cmd: CliCommand): boolean;

package/dist/src/capabilityRouting.js

@@ -0,0 +1 @@
+import{getRegisteredStepNames as C}from"./pipeline/registry.js";export const BROWSER_ONLY_STEPS=new Set(["navigate","click","type","fill","wait","press","snapshot","evaluate","intercept","tap"]);export function _validateBrowserOnlyStepsAgainstRegistry(){const k=new Set(C()),z=[];for(const A of BROWSER_ONLY_STEPS)if(!k.has(A))z.push(A);return{extras:z}}function D(k){return k.some((z)=>{if(!z||typeof z!=="object")return!1;return Object.keys(z).some((A)=>BROWSER_ONLY_STEPS.has(A))})}export function shouldUseBrowserSession(k){if(!k.browser)return!1;if(k.func)return!0;if(!k.pipeline||k.pipeline.length===0)return!0;if(k.navigateBefore)return!0;return D(k.pipeline)}

package/dist/src/capabilityRouting.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/cli-argv-preprocess.d.ts

@@ -0,0 +1,63 @@
+/**
+ * argv preprocessing: rewrite `opencli browser <session> <subcommand> ...`
+ * into `opencli browser --session <session> <subcommand> ...` so commander
+ * (which can't combine a parent positional with subcommand dispatch) can parse it.
+ *
+ * The user-facing form is positional; the internal form uses --session. Help text
+ * for the `browser` command is overridden to advertise the positional form.
+ */
+/**
+ * Returns the set of reserved subcommand names (exposed for tests so they stay
+ * synced with the actual registrations in cli.ts).
+ */
+export declare function getBrowserSubcommandNames(): ReadonlySet<string>;
+/**
+ * Rewrite `argv` to convert the positional `<session>` after `browser`
+ * into the internal `--session <name>` flag form.
+ *
+ * Only acts when `browser` is the root command (i.e. the first non-flag token
+ * after any leading root options), so it can't mis-interpret occurrences of
+ * the literal word `browser` deeper in the argv (e.g. `opencli adapter init
+ * browser/x`, or a URL value containing `browser`).
+ *
+ * Leaves argv unchanged when:
+ *   - root command is not `browser`
+ *   - the token after `browser` is a flag (e.g. `--help`)
+ *   - the token after `browser` is a known subcommand name (session was
+ *     omitted; commander will surface its own required-flag error)
+ */
+export declare function rewriteBrowserArgv(argv: readonly string[]): string[];
+/**
+ * Thrown by the preprocessor when user argv uses a retired/old form that we
+ * intentionally refuse to accept. main.ts catches this and exits with a
+ * usage error so it does not bubble up as an internal stacktrace.
+ */
+export declare class BrowserSessionArgvError extends Error {
+    constructor(message: string);
+}
+/**
+ * Minimal manifest shape consumed by escapeLeadingDashPositional. Imported
+ * lazily by main.ts so this module stays dependency-free.
+ */
+export interface DashPositionalManifestEntry {
+    site: string;
+    name: string;
+    args?: Array<{
+        name: string;
+        positional?: boolean;
+        required?: boolean;
+        valueRequired?: boolean;
+        default?: unknown;
+    }>;
+    browser?: boolean;
+}
+/**
+ * `opencli boss detail -abc123def` fails because commander parses
+ * `-abc123def` as an unknown option rather than the required
+ * `<security-id>` positional. BOSS 直聘 securityId tokens are opaque
+ * strings that can legitimately start with `-` (issue #1160), and the
+ * same shape can show up in any adapter that takes an opaque-id
+ * positional. Insert a `--` separator so commander treats the next
+ * token as the positional value.
+ */
+export declare function escapeLeadingDashPositional(argv: readonly string[], manifest: readonly DashPositionalManifestEntry[]): string[];

package/dist/src/cli-argv-preprocess.js

@@ -0,0 +1 @@
+const C=new Set(["analyze","back","bind","check","click","close","console","dblclick","dialog","drag","eval","extract","fill","find","focus","frames","get","help","hover","init","keys","network","open","screenshot","scroll","select","state","tab","type","unbind","uncheck","upload","verify","wait"]),W=new Set(["--profile"]);export function getBrowserSubcommandNames(){return C}export function rewriteBrowserArgv(X){const H=[...X];let z=0;while(z<H.length){const Z=H[z];if(!Z.startsWith("-"))break;if(Z.includes("=")){z+=1;continue}if(W.has(Z)&&z+1<H.length)z+=2;else z+=1}if(H[z]!=="browser")return H;const J=z+1,Q=H[J];if(Q===void 0)return H;if(Q==="--session"||Q==="--session="||Q.startsWith("--session="))throw new BrowserSessionArgvError("The `--session` flag is no longer a public option. Use the positional form: opencli browser <session> <command>");if(Q.startsWith("-"))return H;if(C.has(Q))return H;H.splice(J,1,"--session",Q);f(H,J+2);return H}function f(X,H){const z=X.findIndex((J,Q)=>Q>=H&&C.has(J));if(z===-1)return;for(let J=z+1;J<X.length;J+=1){const Q=X[J];if(Q==="--")return;if(Q.startsWith("--window=")){const Z=X.splice(J,1);X.splice(z,0,...Z);return}if(Q==="--window"){const Z=X[J+1];if(Z===void 0||Z==="--")return;const G=X.splice(J,2);X.splice(z,0,...G);return}}}export class BrowserSessionArgvError extends Error{constructor(X){super(X);this.name="BrowserSessionArgvError"}}function q(X){const H=new Map([["-h","none"],["--help","none"],["-v","none"],["--verbose","none"],["-f","required"],["--format","required"],["--trace","required"]]);if(X.browser){H.set("--window","required");H.set("--site-session","required");H.set("--keep-tab","required")}for(const z of X.args??[]){if(z.positional)continue;H.set(`--${z.name}`,z.required||z.valueRequired?"required":"optional")}return H}function U(X,H,z){const J=X[H];if(!J||J==="--")return null;const Q=J.indexOf("="),Z=Q===-1?J:J.slice(0,Q),G=z.get(Z);if(!G&&Q===-1&&J.startsWith("-")&&!J.startsWith("--")&&J.length>2){const V=J.slice(0,2);if(z.get(V)==="required")return{values:[J],nextIndex:H+1}}if(!G)return null;if(Q!==-1||G==="none")return{values:[J],nextIndex:H+1};const T=X[H+1];if(G==="required")return T===void 0?{values:[J],nextIndex:H+1}:{values:[J,T],nextIndex:H+2};if(T!==void 0&&!T.startsWith("-"))return{values:[J,T],nextIndex:H+2};return{values:[J],nextIndex:H+1}}export function escapeLeadingDashPositional(X,H){const z=[...X],J=new Map;for(const Y of H)if(Y.args?.find((y)=>y.positional)?.required)J.set(Y.site+"/"+Y.name,Y);let Q=0;while(Q<z.length){const Y=z[Q];if(!Y.startsWith("-"))break;if(Y.includes("=")){Q+=1;continue}if(W.has(Y)&&Q+1<z.length)Q+=2;else Q+=1}const Z=z[Q],G=z[Q+1],T=Q+2;if(!Z||!G||T>=z.length)return z;const V=J.get(Z+"/"+G);if(!V)return z;const K=q(V),F=[];let $=T;while($<z.length){const Y=z[$];if(Y==="--")return z;const D=U(z,$,K);if(D){F.push(...D.values);$=D.nextIndex;continue}if(!Y.startsWith("-"))return z;if(Y.startsWith("--"))return z;break}if($>=z.length)return z;const N=z[$],L=[],P=[];$+=1;while($<z.length){const Y=U(z,$,K);if(Y){L.push(...Y.values);$=Y.nextIndex;continue}P.push(z[$]);$+=1}return[...z.slice(0,T),...F,...L,"--",N,...P]}

package/dist/src/cli-argv-preprocess.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/cli.d.ts

@@ -0,0 +1,79 @@
+/**
+ * CLI entry point: registers built-in commands and wires up Commander.
+ *
+ * Built-in commands are registered inline here (list, validate, explore, etc.).
+ * Dynamic adapter commands are registered via commanderAdapter.ts.
+ */
+import { Command } from 'commander';
+import { findPackageRoot } from './package-paths.js';
+import { type CliCommand } from './registry.js';
+export declare function selectFreshByTimestamp<T extends {
+    timestamp?: unknown;
+}>(items: T[], lastSeenTs: number): {
+    fresh: T[];
+    lastSeenTs: number;
+};
+/**
+ * Check whether the site-memory scaffolding exists under
+ * ~/.opencli/sites/<site>/. Agents have a strong tendency to forget to write
+ * endpoints.json / notes.md after a successful verify, which dooms the next
+ * agent to redo recon from scratch. Surfacing the current state as part of
+ * verify's final report converts that "silent skip" into a visible nudge;
+ * `--strict-memory` escalates it to a failure so agents driving a hardened
+ * workflow can't forget.
+ */
+export type SiteMemoryReport = {
+    ok: boolean;
+    siteDir: string;
+    endpoints: {
+        present: boolean;
+        count: number;
+        path: string;
+    };
+    notes: {
+        present: boolean;
+        path: string;
+    };
+};
+export type SitemapAvailability = {
+    site: string;
+    available: true;
+    source: 'local' | 'global' | 'local+global';
+    hint: string;
+    paths: {
+        local?: string;
+        global?: string;
+    };
+};
+type SitemapAvailabilityOptions = {
+    homeDir?: string;
+    packageRoot?: string;
+    registry?: Map<string, CliCommand>;
+    fileExists?: (candidate: string) => boolean;
+};
+export declare function resolveSitemapAvailabilityForUrl(url: string, options?: SitemapAvailabilityOptions): SitemapAvailability | null;
+export declare function checkSiteMemory(site: string): SiteMemoryReport;
+export declare function printSiteMemoryReport(report: SiteMemoryReport, strict: boolean | undefined): void;
+/** Coerce adapter JSON output into a row array. Accepts `[{...}]`, single `{}`, or `{items:[...]}`-style envelopes. */
+export declare function normalizeVerifyRows(data: unknown): Record<string, unknown>[];
+/** Render up to 10 rows as a compact padded table for eyeball inspection during verify. */
+export declare function renderVerifyPreview(rows: Record<string, unknown>[], opts?: {
+    maxRows?: number;
+    maxCols?: number;
+    cellMax?: number;
+}): string;
+export declare function createProgram(BUILTIN_CLIS: string, USER_CLIS: string): Command;
+export declare function runCli(BUILTIN_CLIS: string, USER_CLIS: string): void;
+export interface BrowserVerifyInvocation {
+    binary: string;
+    args: string[];
+    cwd: string;
+    shell?: boolean;
+}
+export { findPackageRoot };
+export declare function resolveBrowserVerifyInvocation(opts?: {
+    projectRoot?: string;
+    platform?: NodeJS.Platform;
+    fileExists?: (path: string) => boolean;
+    readFile?: (path: string) => string;
+}): BrowserVerifyInvocation;