@agentrhq/webcmd 0.1.1 → 0.1.2

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
+ * ~/.webcmd/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;