taphound 0.2.0-dev.1

package/dist/ports/generation-prompt.js

@@ -0,0 +1,6 @@
+export class GenerationPromptCancelledError extends Error {
+    name = "GenerationPromptCancelledError";
+    constructor() {
+        super("Generation prompt was cancelled");
+    }
+}

package/dist/ports/generation-session-store.d.ts

@@ -0,0 +1,32 @@
+import type { GenerationInFlight, GenerationSession, PendingConfirmation } from "../domain/generation.js";
+export declare const GENERATION_SESSION_STORE_ERROR_CODES: readonly ["INVALID_ID", "INVALID_SESSION", "INVALID_REVISION", "SESSION_ALREADY_EXISTS", "SESSION_NOT_FOUND", "SESSION_PUBLISHED", "REVISION_CONFLICT", "INVALID_TRANSITION", "LOCK_TIMEOUT", "INVALID_EVIDENCE_PATH", "INVALID_EVIDENCE", "EVIDENCE_NOT_FOUND", "EVIDENCE_ALREADY_EXISTS", "SESSION_NOT_PUBLISHABLE", "PUBLISH_DESTINATION_EXISTS", "IO_ERROR"];
+export type GenerationSessionStoreErrorCode = typeof GENERATION_SESSION_STORE_ERROR_CODES[number];
+export declare class GenerationSessionStoreError extends Error {
+    readonly code: GenerationSessionStoreErrorCode;
+    constructor(code: GenerationSessionStoreErrorCode, message: string, options?: ErrorOptions);
+}
+export interface GenerationEvidenceFile {
+    path: string;
+    contentBase64: string;
+    byteLength: number;
+}
+export interface GenerationSessionStore {
+    create: (session: GenerationSession) => Promise<void>;
+    read: (id: string) => Promise<GenerationSession>;
+    update: (id: string, expectedRevision: number, next: GenerationSession) => Promise<void>;
+    commitSnapshot: (id: string, expectedRevision: number, next: GenerationSession) => Promise<void>;
+    updateConfirmation: (id: string, expectedRevision: number, next: GenerationSession) => Promise<void>;
+    beginStep: (id: string, expectedRevision: number, inFlight: GenerationInFlight, approvedConfirmation?: PendingConfirmation) => Promise<GenerationSession>;
+    completeStep: (id: string, expectedRevision: number, expectedInFlight: GenerationInFlight, next: GenerationSession) => Promise<void>;
+    recover: (id: string, expectedRevision: number, next: GenerationSession) => Promise<void>;
+    beginVerification: (id: string, expectedRevision: number, attemptId: string) => Promise<GenerationSession>;
+    completeVerification: (id: string, expectedRevision: number, next: GenerationSession) => Promise<void>;
+    failVerification: (id: string, expectedRevision: number, next: GenerationSession) => Promise<void>;
+    markBundlePublishable: (id: string, expectedRevision: number, next: GenerationSession) => Promise<void>;
+    writeEvidence: (id: string, relativePath: string, value: unknown) => Promise<void>;
+    writeTextEvidence: (id: string, relativePath: string, value: string) => Promise<void>;
+    produceEvidence: (id: string, relativePath: string, produce: (temporaryPath: string) => Promise<void>) => Promise<void>;
+    readEvidence: (id: string, relativePath: string) => Promise<Buffer>;
+    listEvidence: (id: string) => Promise<readonly GenerationEvidenceFile[]>;
+    publish: (id: string) => Promise<string>;
+}

package/dist/ports/generation-session-store.js

@@ -0,0 +1,26 @@
+export const GENERATION_SESSION_STORE_ERROR_CODES = [
+    "INVALID_ID",
+    "INVALID_SESSION",
+    "INVALID_REVISION",
+    "SESSION_ALREADY_EXISTS",
+    "SESSION_NOT_FOUND",
+    "SESSION_PUBLISHED",
+    "REVISION_CONFLICT",
+    "INVALID_TRANSITION",
+    "LOCK_TIMEOUT",
+    "INVALID_EVIDENCE_PATH",
+    "INVALID_EVIDENCE",
+    "EVIDENCE_NOT_FOUND",
+    "EVIDENCE_ALREADY_EXISTS",
+    "SESSION_NOT_PUBLISHABLE",
+    "PUBLISH_DESTINATION_EXISTS",
+    "IO_ERROR"
+];
+export class GenerationSessionStoreError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+        this.name = "GenerationSessionStoreError";
+    }
+}

package/dist/ports/init-prompt.d.ts

@@ -0,0 +1,8 @@
+import type { AgentId } from "../domain/init.js";
+export interface InitPromptPort {
+    selectAgents: () => Promise<AgentId[]>;
+}
+export declare class InitPromptCancelledError extends Error {
+    readonly name = "InitPromptCancelledError";
+    constructor();
+}

package/dist/ports/init-prompt.js

@@ -0,0 +1,6 @@
+export class InitPromptCancelledError extends Error {
+    name = "InitPromptCancelledError";
+    constructor() {
+        super("Init prompt was cancelled");
+    }
+}

package/dist/ports/journey-writer.d.ts

@@ -0,0 +1,10 @@
+import type { Journey } from "../domain/journey.js";
+import type { ProjectBoundFileReader, ProjectBoundPath } from "./project-bound-file.js";
+export interface JourneyWriterPort {
+    write: (outputPath: string, journey: Journey) => Promise<void>;
+}
+export interface ProjectBoundJourneyWriterPort extends JourneyWriterPort, ProjectBoundFileReader {
+    writeProjectBound: (path: ProjectBoundPath & {
+        journey: Journey;
+    }) => Promise<void>;
+}

package/dist/ports/journey-writer.js

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

package/dist/ports/process-runner.d.ts

@@ -0,0 +1,32 @@
+export interface CommandSpec {
+    executable: string;
+    args: readonly string[];
+    cwd?: string | undefined;
+    env?: Readonly<Record<string, string | undefined>> | undefined;
+    timeoutMs?: number | undefined;
+    signal?: AbortSignal | undefined;
+}
+export interface CommandResult {
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    timedOut: boolean;
+    cancelled: boolean;
+    spawnError?: string | undefined;
+}
+export interface StreamHandlers {
+    onStdoutLine?(line: string): void;
+    onStderrLine?(line: string): void;
+}
+export interface RunningCommand {
+    /** Resolves undefined once the stream remains alive through startup. */
+    readonly started: Promise<CommandResult | undefined>;
+    readonly completion: Promise<CommandResult>;
+    stop: () => Promise<CommandResult>;
+}
+export interface ProcessRunner {
+    run: (spec: CommandSpec) => Promise<CommandResult>;
+    start: (spec: CommandSpec, handlers?: StreamHandlers) => RunningCommand;
+}

package/dist/ports/process-runner.js

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

package/dist/ports/project-bound-file.d.ts

@@ -0,0 +1,8 @@
+export interface ProjectBoundPath {
+    projectRoot: string;
+    authorityRoot: string;
+    outputPath: string;
+}
+export interface ProjectBoundFileReader {
+    readProjectBound: (path: ProjectBoundPath) => Promise<Buffer>;
+}

package/dist/ports/project-bound-file.js

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

package/dist/ports/project-file-inspector.d.ts

@@ -0,0 +1,33 @@
+export type ProjectFileInspection = {
+    status: "rootNotFound";
+} | {
+    status: "rootUnreadable";
+} | {
+    status: "rootNotDirectory";
+} | {
+    status: "notFound";
+} | {
+    status: "unreadable";
+} | {
+    status: "escape";
+} | {
+    status: "changedIdentity";
+    resolvedRelativePath?: string;
+} | {
+    status: "notFile";
+    resolvedRelativePath: string;
+} | {
+    status: "tooLarge";
+    resolvedRelativePath: string;
+} | {
+    status: "inspected";
+    resolvedRelativePath: string;
+    sha256: string;
+};
+export interface ProjectFileInspector {
+    inspectProjectFile: (input: {
+        projectRoot: string;
+        relativePath: string;
+        maximumBytes: number;
+    }) => Promise<ProjectFileInspection>;
+}

package/dist/ports/project-file-inspector.js

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

package/dist/ports/recorder-prompt.d.ts

@@ -0,0 +1,29 @@
+export type RecorderAction = "click" | "longClick" | "inputText" | "swipe" | "scrollTo" | "back" | "wait" | "finish" | "cancel";
+export type ScrollDecision = {
+    kind: "select";
+    id: string;
+} | {
+    kind: "scrollMore";
+} | {
+    kind: "cancel";
+};
+export interface RecorderTargetChoice {
+    id: string;
+    label: string;
+}
+export interface SwipeOptions {
+    distancePercent: number;
+    durationMs: number;
+}
+export interface RecorderPromptPort {
+    selectAction: () => Promise<RecorderAction>;
+    selectTarget: (choices: readonly RecorderTargetChoice[]) => Promise<string>;
+    inputText: () => Promise<string>;
+    selectSwipeDirection: () => Promise<"up" | "down" | "left" | "right">;
+    longClickDuration: () => Promise<number>;
+    swipeOptions: () => Promise<SwipeOptions>;
+    selectFallbackLabel: (annotatedScreenshotPath: string) => Promise<string | undefined>;
+    notifyFailure: (message: string) => Promise<void>;
+    selectScrollContainer: (choices: readonly RecorderTargetChoice[]) => Promise<string>;
+    scrollTargetDecision: (choices: readonly RecorderTargetChoice[]) => Promise<ScrollDecision>;
+}

package/dist/ports/recorder-prompt.js

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

package/dist/ports/skill-installer.d.ts

@@ -0,0 +1,8 @@
+export interface SkillInstallResult {
+    readonly targetPath: string;
+    readonly skipped: boolean;
+}
+export interface SkillInstallerPort {
+    findPayload: () => Promise<string>;
+    installTo: (targetDir: string) => Promise<SkillInstallResult>;
+}

package/dist/ports/skill-installer.js

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "taphound",
+  "version": "0.2.0-dev.1",
+  "description": "Deterministic app journey recording and verification",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caikaidev/TapHound.git"
+  },
+  "bugs": {
+    "url": "https://github.com/caikaidev/TapHound/issues"
+  },
+  "homepage": "https://github.com/caikaidev/TapHound#readme",
+  "keywords": [
+    "android",
+    "testing",
+    "regression-testing",
+    "journey",
+    "cli",
+    "ai-agent"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "dev"
+  },
+  "type": "module",
+  "bin": {
+    "taphound": "./dist/cli/main.js"
+  },
+  "files": [
+    "dist",
+    "assets/brand/taphound-mark.svg",
+    "assets/skills"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "acceptance:device": "node scripts/acceptance-device.mjs",
+    "acceptance:generation": "node scripts/acceptance-generation.mjs",
+    "brand:render": "node scripts/render-brand-assets.mjs",
+    "build": "node scripts/build.mjs",
+    "coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "prepublishOnly": "npm test && npm run typecheck && npm run lint && npm run build",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.5.2",
+    "commander": "^15.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^26.1.1",
+    "@vitest/coverage-v8": "^4.1.10",
+    "eslint": "^10.7.0",
+    "sharp": "^0.35.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.64.0",
+    "vitest": "^4.1.10"
+  }
+}