taphound 0.2.0-dev.1 → 0.2.0-dev.11

package/dist/ports/ui-stability.d.ts

@@ -0,0 +1,19 @@
+import type { LayoutElement } from "../domain/layout.js";
+export interface UiStabilitySampleOptions {
+    deviceSerial: string;
+    packageName?: string | undefined;
+    stabilityBackend?: "frameStats" | "uiautomator" | undefined;
+    signal?: AbortSignal | undefined;
+    timeoutMs?: number | undefined;
+}
+export interface UiStabilityObservation {
+    changes: readonly unknown[];
+    layout?: readonly LayoutElement[] | undefined;
+    backend?: "uiautomator" | "androidCli" | "gfxFrameStats" | "mobileMcp" | undefined;
+    durationMs?: number | undefined;
+}
+export type UiStabilitySampleResult = readonly unknown[] | UiStabilityObservation;
+export interface UiStabilityProbe {
+    reset: () => void;
+    sample: (options: UiStabilitySampleOptions) => Promise<UiStabilitySampleResult>;
+}

package/dist/ports/ui-stability.js

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

package/dist/ports/workspace-layout.d.ts

@@ -0,0 +1,4 @@
+export interface WorkspaceLayoutPort {
+    ensureBuildIgnored: (projectRoot: string) => Promise<void>;
+    ensureBuildLayout: (projectRoot: string) => Promise<void>;
+}

package/dist/ports/workspace-layout.js

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

package/dist/shared/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function errnoCode(error: unknown): string | undefined;
+export declare function isErrnoException(error: unknown): error is NodeJS.ErrnoException;

package/dist/shared/errors.js

@@ -0,0 +1,22 @@
+// Shared error classification helpers.
+//
+// Node filesystem operations throw errors whose `code` property identifies the
+// errno (ENOENT, EEXIST, ELOOP, ...). Two complementary helpers cover the two
+// common consumption patterns:
+//
+//   - errnoCode: returns the string code or undefined (replaces the repeated
+//     `errorCode` helper that was duplicated across filesystem adapters).
+//   - isErrnoException: type guard that narrows to NodeJS.ErrnoException so
+//     callers can access `.code` after the guard (replaces the repeated
+//     `isNodeError` helper that was duplicated across filesystem adapters).
+export function errnoCode(error) {
+    return (typeof error === "object"
+        && error !== null
+        && "code" in error
+        && typeof error.code === "string")
+        ? error.code
+        : undefined;
+}
+export function isErrnoException(error) {
+    return error instanceof Error && "code" in error;
+}

package/dist/shared/paths.d.ts

@@ -0,0 +1,2 @@
+export declare function isContained(root: string, path: string): boolean;
+export declare function projectRelativePath(projectRoot: string, path: string, createError: (message: string) => Error): string;

package/dist/shared/paths.js

@@ -0,0 +1,24 @@
+// Shared path containment and project-relative path utilities.
+//
+// These helpers were duplicated across filesystem adapters and application
+// context services. They are pure path calculations with no side effects.
+import { isAbsolute, relative, resolve, sep } from "node:path";
+export function isContained(root, path) {
+    const fromRoot = relative(root, path);
+    return (fromRoot === ""
+        || (fromRoot !== ".."
+            && !fromRoot.startsWith(`..${sep}`)
+            && !isAbsolute(fromRoot)));
+}
+export function projectRelativePath(projectRoot, path, createError) {
+    const absolutePath = isAbsolute(path) ? path : resolve(projectRoot, path);
+    const result = relative(resolve(projectRoot), absolutePath)
+        .replaceAll("\\", "/");
+    if (result.length === 0
+        || result === ".."
+        || result.startsWith("../")
+        || result.startsWith("/")) {
+        throw createError("Project Context path must stay within the project");
+    }
+    return result;
+}

package/dist/shared/strings.d.ts

@@ -0,0 +1,2 @@
+export declare function compareStrings(left: string, right: string): number;
+export declare function sortStrings(values: string[]): string[];

package/dist/shared/strings.js

@@ -0,0 +1,16 @@
+// Deterministic string comparison utilities shared across layers.
+//
+// localeCompare is locale/ICU dependent and can produce different orderings
+// across platforms or Node ICU builds. Any data that feeds a hash (inventory
+// path sets, evidence manifests, canonicalized evidence keys) must be sorted
+// with a stable, environment-independent comparator. Use compareStrings for
+// hashed or persisted orderings; reserve localeCompare for display-only sorts.
+export function compareStrings(left, right) {
+    if (left === right) {
+        return 0;
+    }
+    return left < right ? -1 : 1;
+}
+export function sortStrings(values) {
+    return [...values].sort(compareStrings);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taphound",
-  "version": "0.2.0-dev.1",
+  "version": "0.2.0-dev.11",
   "description": "Deterministic app journey recording and verification",
   "license": "Apache-2.0",
   "repository": {
@@ -38,9 +38,13 @@
   "scripts": {
     "acceptance:device": "node scripts/acceptance-device.mjs",
     "acceptance:generation": "node scripts/acceptance-generation.mjs",
+    "acceptance:mobile-mcp": "node scripts/acceptance-mobile-mcp.mjs",
+    "bench:false-done": "tsc -p tsconfig.tools.json && node .build-tools/tools/false-done/main.js",
     "brand:render": "node scripts/render-brand-assets.mjs",
     "build": "node scripts/build.mjs",
+    "skills:schemas": "node scripts/render-skill-schemas.mjs",
     "coverage": "vitest run --coverage",
+    "dev:setup": "node scripts/dev-setup.mjs",
     "lint": "eslint .",
     "prepublishOnly": "npm test && npm run typecheck && npm run lint && npm run build",
     "test": "vitest run",
@@ -48,6 +52,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
+    "@modelcontextprotocol/sdk": "1.26.0",
     "commander": "^15.0.0",
     "zod": "^4.4.3"
   },