@aarwitz/tapp 0.15.0 → 0.16.0

package/mcp-server/src/product-operations.js

@@ -16,8 +16,9 @@ import {
   reviewReleasePlan,
   writeInitArtifacts,
 } from "./application-model.js";
-import { baselinePathForTarget, renderGithubWorkflow, selectApplicationTarget, writeCiInstallation, writeTargetBaseline } from "./ci-setup.js";
+import { baselinePathForTarget, existingBaselinePathForTarget, renderGithubWorkflow, selectApplicationTarget, writeCiInstallation, writeTargetBaseline } from "./ci-setup.js";
 import { executeReleaseContract, runProductProcess } from "./product-execution.js";
+import { projectArtifactDirectory } from "./project-paths.js";
 
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
 const packageVersion = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8")).version;
@@ -50,8 +51,9 @@ function atomicJson(file, value) {
   fs.renameSync(temporary, file);
 }
 
-function artifactPaths(root, outDir = ".autotap") {
-  const dir = path.resolve(root, outDir);
+function artifactPaths(root, outDir = ".tapp") {
+  const selectedOutDir = projectArtifactDirectory(root, outDir);
+  const dir = path.resolve(root, selectedOutDir);
   if (!inside(root, dir)) throw new Error("Artifact directory must remain inside the repository");
   return {
     dir,
@@ -63,7 +65,7 @@ function artifactPaths(root, outDir = ".autotap") {
 }
 
 function productRunRoot(root) {
-  const home = process.env.AUTOTAP_HOME || process.env.TAPP_HOME || path.join(os.homedir(), ".tapp");
+  const home = process.env.TAPP_HOME || process.env.AUTOTAP_HOME || path.join(os.homedir(), ".tapp");
   const identity = crypto.createHash("sha256").update(root).digest("hex").slice(0, 16);
   return path.join(home, "product-runs", identity);
 }
@@ -94,7 +96,7 @@ function listProductRuns(root) {
 }
 
 function listRepositoryFlows(root) {
-  const directory = path.join(root, ".autotap", "flows");
+  const directory = path.join(root, projectArtifactDirectory(root), "flows");
   if (!fs.existsSync(directory)) return [];
   return fs.readdirSync(directory, { withFileTypes:true })
     .filter((entry) => entry.isFile() && /\.(?:ya?ml|json)$/i.test(entry.name))
@@ -127,7 +129,7 @@ function listRepositoryFlows(root) {
     .sort((left, right) => left.path.localeCompare(right.path));
 }
 
-export function readProductProject({ projectDir, outDir = ".autotap" } = {}) {
+export function readProductProject({ projectDir, outDir = ".tapp" } = {}) {
   const root = realProject(projectDir);
   const paths = artifactPaths(root, outDir);
   const model = readJson(paths.model);
@@ -137,7 +139,7 @@ export function readProductProject({ projectDir, outDir = ".autotap" } = {}) {
   const requirements = model?.requirements || [];
   const planItems = plan?.items || [];
   const baselines = (model?.targets || []).map((target) => {
-    const file = baselinePathForTarget(root, target);
+    const file = existingBaselinePathForTarget(root, target);
     return { targetId: target.id, platform: target.platform, path: file, relativePath: path.relative(root, file).replaceAll(path.sep, "/"), exists: fs.existsSync(file) };
   });
   return {
@@ -177,7 +179,7 @@ export function readProductProject({ projectDir, outDir = ".autotap" } = {}) {
 // target identity or configuration rules.
 export async function prepareProductTarget({
   projectDir,
-  outDir = ".autotap",
+  outDir = ".tapp",
   platform = "",
   target = "",
   appPath = "",
@@ -262,7 +264,7 @@ export async function prepareProductTarget({
 export async function initializeProductProject({
   projectDir,
   mode = "inspect",
-  outDir = ".autotap",
+  outDir = ".tapp",
   ownedUrl = "",
   platform = "",
   target = "",
@@ -326,7 +328,7 @@ function resolvePlan(root, outDir, planPath = "") {
   return { file, plan: readJson(file, { required: true }) };
 }
 
-export function reviewProductPlan({ projectDir, outDir = ".autotap", planPath = "", approve = [], reject = [], defer = [] } = {}) {
+export function reviewProductPlan({ projectDir, outDir = ".tapp", planPath = "", approve = [], reject = [], defer = [] } = {}) {
   const root = realProject(projectDir);
   const resolved = resolvePlan(root, outDir, planPath);
   const plan = reviewReleasePlan(resolved.plan, { approve, reject, defer });
@@ -334,7 +336,7 @@ export function reviewProductPlan({ projectDir, outDir = ".autotap", planPath =
   return { operation: "review-plan", plan, planPath: resolved.file, project: readProductProject({ projectDir: root, outDir }) };
 }
 
-export async function generateProductPlan({ projectDir, outDir = ".autotap", planPath = "" } = {}) {
+export async function generateProductPlan({ projectDir, outDir = ".tapp", planPath = "" } = {}) {
   const root = realProject(projectDir);
   const resolved = resolvePlan(root, outDir, planPath);
   const result = await generateApprovedContractProposals(resolved.plan, { projectDir: root });
@@ -344,7 +346,7 @@ export async function generateProductPlan({ projectDir, outDir = ".autotap", pla
 
 export async function validateProductPlan({
   projectDir,
-  outDir = ".autotap",
+  outDir = ".tapp",
   planPath = "",
   items = [],
   platform = "",
@@ -411,7 +413,7 @@ export async function validateProductPlan({
   return { operation: "validate-plan", platform: selectedPlatform, passed: results.every((item) => item.passed), results, plan, planPath: resolved.file, project: readProductProject({ projectDir: root, outDir }) };
 }
 
-export async function promoteProductPlan({ projectDir, outDir = ".autotap", planPath = "", items = [] } = {}) {
+export async function promoteProductPlan({ projectDir, outDir = ".tapp", planPath = "", items = [] } = {}) {
   const root = realProject(projectDir);
   const resolved = resolvePlan(root, outDir, planPath);
   const result = await promoteValidatedProposals(resolved.plan, { projectDir: root, ids: items || [] });
@@ -423,7 +425,7 @@ export async function promoteProductPlan({ projectDir, outDir = ".autotap", plan
   return { operation: "promote-plan", ...result, plan: written.plan, planPath: written.planPath, modelPath: written.modelPath, project: readProductProject({ projectDir: root, outDir }) };
 }
 
-export function prepareProductCi({ projectDir, outDir = ".autotap", modelPath = "", actionRef = DEFAULT_ACTION_REF, defaultBranch = "main" } = {}) {
+export function prepareProductCi({ projectDir, outDir = ".tapp", modelPath = "", actionRef = DEFAULT_ACTION_REF, defaultBranch = "main" } = {}) {
   const root = realProject(projectDir);
   const modelFile = modelPath ? path.resolve(root, modelPath) : artifactPaths(root, outDir).model;
   if (!inside(root, modelFile)) throw new Error("Application model must remain inside the repository");
@@ -433,7 +435,7 @@ export function prepareProductCi({ projectDir, outDir = ".autotap", modelPath =
   return { operation: "prepare-ci", ...rendered, project: readProductProject({ projectDir: root, outDir }) };
 }
 
-export function installProductCi({ projectDir, outDir = ".autotap", modelPath = "", actionRef = DEFAULT_ACTION_REF, defaultBranch = "main", workflowPath = ".github/workflows/tapp.yml", manifestPath = ".autotap/ci.json", replace = false, allowUnresolved = false } = {}) {
+export function installProductCi({ projectDir, outDir = ".tapp", modelPath = "", actionRef = DEFAULT_ACTION_REF, defaultBranch = "main", workflowPath = ".github/workflows/tapp.yml", manifestPath = ".tapp/ci.json", replace = false, allowUnresolved = false } = {}) {
   const root = realProject(projectDir);
   const rendered = prepareProductCi({ projectDir: root, outDir, modelPath, actionRef, defaultBranch });
   if (rendered.manifest.unresolved.length && !allowUnresolved) throw new Error(`CI installation is unresolved: ${rendered.manifest.unresolved.map((item) => `${item.platform}:${item.message}`).join("; ")}`);
@@ -443,7 +445,7 @@ export function installProductCi({ projectDir, outDir = ".autotap", modelPath =
 
 export async function runProductGate({
   projectDir,
-  outDir = ".autotap",
+  outDir = ".tapp",
   platform = "web",
   target = "",
   url = "",
@@ -501,7 +503,7 @@ export async function runProductGate({
     if (!inside(root, baselinePath) || !fs.existsSync(baselinePath)) throw new Error("Baseline must be an existing file inside the repository");
     args.push("--baseline", baselinePath);
   } else {
-    const targetBaseline = baselinePathForTarget(root, selected);
+    const targetBaseline = existingBaselinePathForTarget(root, selected);
     if (fs.existsSync(targetBaseline)) args.push("--baseline", targetBaseline);
   }
   onProgress({ phase: "gate", text: `Running ${selected.platform}:${selected.name} release gate` });
@@ -515,7 +517,7 @@ export async function runProductGate({
   return { operation: "run-gate", passed: execution.code === 0, code: execution.code, stdout: execution.stdout, stderr: execution.stderr, selectedTarget: selected, report, reportPath, markdownPath, runDir, project: readProductProject({ projectDir: root, outDir }) };
 }
 
-export function createProductBaseline({ projectDir, outDir = ".autotap", reportPath, platform = "web", target = "", replace = false, baselinePath = "" } = {}) {
+export function createProductBaseline({ projectDir, outDir = ".tapp", reportPath, platform = "web", target = "", replace = false, baselinePath = "" } = {}) {
   const root = realProject(projectDir);
   const project = readProductProject({ projectDir: root, outDir });
   const selected = selectApplicationTarget(project.model, { platform, target });

package/mcp-server/src/project-config.js

@@ -1,7 +1,9 @@
 import fs from "node:fs";
 import path from "node:path";
+import { LEGACY_TAPP_DIRECTORY, TAPP_DIRECTORY, projectArtifactDirectory } from "./project-paths.js";
 
-export const PROJECT_CONFIG_RELATIVE_PATH = ".autotap/project.json";
+export const PROJECT_CONFIG_RELATIVE_PATH = `${TAPP_DIRECTORY}/project.json`;
+export const LEGACY_PROJECT_CONFIG_RELATIVE_PATH = `${LEGACY_TAPP_DIRECTORY}/project.json`;
 
 const ACTOR_NAME = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
 const ENV_NAME = /^[A-Z_][A-Z0-9_]{0,127}$/;
@@ -58,15 +60,16 @@ export function validateProjectConfig(config) {
 
 export function readProjectConfig(projectDir, { required = false } = {}) {
   const root = fs.realpathSync(path.resolve(projectDir || process.cwd()));
-  const configPath = path.join(root, PROJECT_CONFIG_RELATIVE_PATH);
+  const relativePath = `${projectArtifactDirectory(root)}/project.json`;
+  const configPath = path.join(root, relativePath);
   if (!fs.existsSync(configPath)) {
     if (required) throw new Error(`Project configuration not found: ${configPath}`);
-    return { root, path: configPath, relativePath: PROJECT_CONFIG_RELATIVE_PATH, config: { kind: "tapp-project-config", schemaVersion: 1, actors: {} }, exists: false, errors: [] };
+    return { root, path: configPath, relativePath, config: { kind: "tapp-project-config", schemaVersion: 1, actors: {} }, exists: false, errors: [] };
   }
   let config;
   try { config = JSON.parse(fs.readFileSync(configPath, "utf8")); }
-  catch (error) { return { root, path: configPath, relativePath: PROJECT_CONFIG_RELATIVE_PATH, config: null, exists: true, errors: [`Invalid JSON: ${error.message}`] }; }
-  return { root, path: configPath, relativePath: PROJECT_CONFIG_RELATIVE_PATH, config, exists: true, errors: validateProjectConfig(config) };
+  catch (error) { return { root, path: configPath, relativePath, config: null, exists: true, errors: [`Invalid JSON: ${error.message}`] }; }
+  return { root, path: configPath, relativePath, config, exists: true, errors: validateProjectConfig(config) };
 }
 
 export function configureActor(projectDir, { name, role = "", session = "default", provisioning = "existing", credentials = {}, replace = false } = {}) {

package/mcp-server/src/project-paths.js

@@ -0,0 +1,32 @@
+import fs from "node:fs";
+import path from "node:path";
+
+export const TAPP_DIRECTORY = ".tapp";
+export const LEGACY_TAPP_DIRECTORY = ".autotap";
+export const TAPP_CONFIG = ".tapp.yml";
+export const LEGACY_TAPP_CONFIG = ".autotap.yml";
+
+export function projectArtifactDirectory(projectDir, requested = TAPP_DIRECTORY) {
+  const root = path.resolve(projectDir);
+  if (requested !== TAPP_DIRECTORY) return requested;
+  const canonical = path.join(root, TAPP_DIRECTORY);
+  const legacy = path.join(root, LEGACY_TAPP_DIRECTORY);
+  if (!fs.existsSync(canonical) && fs.existsSync(legacy)) return LEGACY_TAPP_DIRECTORY;
+  return TAPP_DIRECTORY;
+}
+
+export function projectArtifactPath(projectDir, ...parts) {
+  return path.join(path.resolve(projectDir), projectArtifactDirectory(projectDir), ...parts);
+}
+
+export function existingProjectArtifactPath(projectDir, ...parts) {
+  const root = path.resolve(projectDir);
+  const canonical = path.join(root, TAPP_DIRECTORY, ...parts);
+  if (fs.existsSync(canonical)) return canonical;
+  const legacy = path.join(root, LEGACY_TAPP_DIRECTORY, ...parts);
+  return fs.existsSync(legacy) ? legacy : canonical;
+}
+
+export function isProjectArtifactDirectory(name) {
+  return name === TAPP_DIRECTORY || name === LEGACY_TAPP_DIRECTORY;
+}

package/mcp-server/src/report.js

@@ -1,5 +1,5 @@
 // Pure report/gate logic shared by the MCP server (index.js) and the CI gate CLI
-// (ci-report.js). Turns a capture's OCQA markers into the same ship/no-ship report the AutoTap
+// (ci-report.js). Turns a capture's OCQA markers into the same ship/no-ship report the Tapp
 // app produces, and diffs two runs' findings into the CI regression gate. No shell, no server —
 // keep it dependency-free so the CI path stays importable and testable.
 import fs from "fs";
@@ -78,7 +78,7 @@ export function parseOcqaMarkers(markersFilePath) {
   };
 }
 
-// Map harness OCQA_ISSUE `type` -> AutoTap FindingCategory. Crashes are always critical.
+// Map harness OCQA_ISSUE `type` -> Tapp FindingCategory. Crashes are always critical.
 export const ISSUE_CATEGORY = {
   crash: "crash",
   app_hang: "app_hang",
@@ -100,7 +100,7 @@ export function severityRank(s) {
   return { critical: 0, high: 1, medium: 2, low: 3 }[s] ?? 4;
 }
 
-// Turn a capture's OCQA markers into the same ship/no-ship report the AutoTap app produces:
+// Turn a capture's OCQA markers into the same ship/no-ship report Tapp produces:
 // deduped findings + a trustworthy verdict with a coverage floor (mirrors OrchestratorService).
 export function buildQaReport(markersFilePath, { platform = "ios" } = {}) {
   const base = parseOcqaMarkers(markersFilePath);

package/mcp-server/src/task-runtime.js

@@ -7,6 +7,7 @@ import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { semanticUiKey } from "./ui-map.js";
+import { isProjectArtifactDirectory, projectArtifactDirectory } from "./project-paths.js";
 
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
 
@@ -84,12 +85,15 @@ export function loadTaskFile(taskPath) {
   return { ...task, __path: path.resolve(taskPath) };
 }
 
-function findAutotapDir(sourcePath, explicitProjectDir = "") {
-  if (explicitProjectDir) return path.join(path.resolve(explicitProjectDir), ".autotap");
+function findTappDir(sourcePath, explicitProjectDir = "") {
+  if (explicitProjectDir) {
+    const root = path.resolve(explicitProjectDir);
+    return path.join(root, projectArtifactDirectory(root));
+  }
   let current = path.dirname(path.resolve(sourcePath));
   while (current !== path.dirname(current)) {
-    if (path.basename(current) === ".autotap") return current;
-    const candidate = path.join(current, ".autotap");
+    if (isProjectArtifactDirectory(path.basename(current))) return current;
+    const candidate = path.join(current, projectArtifactDirectory(current));
     if (fs.existsSync(candidate)) return candidate;
     current = path.dirname(current);
   }
@@ -97,16 +101,16 @@ function findAutotapDir(sourcePath, explicitProjectDir = "") {
 }
 
 export function loadTaskRegistry({ sourcePath, projectDir = "", taskFiles = [] }) {
-  const autotapDir = findAutotapDir(sourcePath, projectDir);
-  const taskDir = autotapDir ? path.join(autotapDir, "tasks") : "";
+  const tappDir = findTappDir(sourcePath, projectDir);
+  const taskDir = tappDir ? path.join(tappDir, "tasks") : "";
   const reviewed = taskDir && fs.existsSync(taskDir)
     ? fs.readdirSync(taskDir).filter((name) => /\.ya?ml$|\.json$/i.test(name)).map((name) => path.join(taskDir, name))
     : [];
-  // Draft contracts generated under `.autotap/proposals/contracts` may compile
+  // Draft contracts generated under `.tapp/proposals/contracts` may compile
   // against sibling untrusted Task drafts. Ordinary committed contracts never
   // see this directory, so a proposal cannot silently enter the release gate.
-  const proposalSource = String(path.resolve(sourcePath || "")).includes(`${path.sep}.autotap${path.sep}proposals${path.sep}`);
-  const proposalDir = proposalSource && autotapDir ? path.join(autotapDir, "proposals", "tasks") : "";
+  const proposalSource = [".tapp", ".autotap"].some((directory) => String(path.resolve(sourcePath || "")).includes(`${path.sep}${directory}${path.sep}proposals${path.sep}`));
+  const proposalDir = proposalSource && tappDir ? path.join(tappDir, "proposals", "tasks") : "";
   const proposed = proposalDir && fs.existsSync(proposalDir)
     ? fs.readdirSync(proposalDir).filter((name) => /\.ya?ml$|\.json$/i.test(name)).map((name) => path.join(proposalDir, name))
     : [];
@@ -169,7 +173,7 @@ export function compileTaskSteps({ steps, registry, platform = "", flowVars = {}
     const invocation = taskCall(step);
     if (!invocation) { expanded.push(step); continue; }
     const task = registry.get(invocation.call.task);
-    if (!task) throw new Error(`Task '${invocation.call.task}' was not found in .autotap/tasks`);
+    if (!task) throw new Error(`Task '${invocation.call.task}' was not found in .tapp/tasks`);
     if (stack.includes(task.name)) throw new Error(`Task cycle detected: ${[...stack, task.name].join(" -> ")}`);
     const implementation = implementationSteps(task, platform);
     if (!implementation?.steps) throw new Error(`Task '${task.name}' has no '${platform || "shared"}' implementation`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aarwitz/tapp",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "mcpName": "io.github.aarwitz/tapp",
   "description": "Release contracts, autonomous QA, and evidence-backed CI gates for iOS, Android, and web.",
   "license": "MIT",
@@ -24,7 +24,19 @@
     "docs/application-model.md",
     "docs/scenarios.md",
     "mcp-server/src/",
-    "scripts/",
+    "scripts/ci-gate.sh",
+    "scripts/compile-contract.js",
+    "scripts/compile-flow.js",
+    "scripts/flow-platform.js",
+    "scripts/flow_ai_judge.py",
+    "scripts/flow_lib.py",
+    "scripts/platform-gate.js",
+    "scripts/pr-plan.js",
+    "scripts/quick-capture.sh",
+    "scripts/run-android-flow.js",
+    "scripts/run-flow.sh",
+    "scripts/run-web-flow.js",
+    "scripts/run-web-scenario.js",
     "Harness/OCQAHarness/",
     "Harness/OCQAHarnessUITests/",
     "Harness/OCQAHarness.xcodeproj/",
@@ -75,7 +87,7 @@
     "mobile"
   ],
   "scripts": {
-    "test": "node --test tests/report.test.js tests/regression.test.js tests/engine.test.js tests/project-config.test.js tests/application-model.test.js tests/ui-map.test.js tests/task-runtime.test.js tests/release-contract.test.js tests/pr-selection.test.js tests/flow-runtime.test.js tests/web-explorer.test.js tests/web-session.test.js tests/web-flow.test.js tests/scenario-runtime.test.js tests/android-driver.test.js tests/android-explorer.test.js tests/android-flow.test.js tests/managed-web.test.js tests/product-operations.test.js tests/browser-product.test.js tests/browser-onboarding.test.js tests/managed-operation.test.js tests/cloud-runner.test.js tests/ci-setup.test.js tests/ci-install.test.js tests/cli.test.js tests/action.test.js tests/ci-gate.test.js tests/ci-report.test.js tests/desktop-protocol.test.js tests/ios-flow-protocol.test.js",
+    "test": "node --test tests/report.test.js tests/regression.test.js tests/engine.test.js tests/project-config.test.js tests/application-model.test.js tests/ui-map.test.js tests/task-runtime.test.js tests/release-contract.test.js tests/pr-selection.test.js tests/flow-runtime.test.js tests/web-explorer.test.js tests/web-session.test.js tests/web-flow.test.js tests/scenario-runtime.test.js tests/android-driver.test.js tests/android-explorer.test.js tests/android-flow.test.js tests/managed-web.test.js tests/product-operations.test.js tests/browser-product.test.js tests/browser-onboarding.test.js tests/managed-operation.test.js tests/cloud-runner.test.js tests/ci-setup.test.js tests/ci-install.test.js tests/cli.test.js tests/action.test.js tests/package-surface.test.js tests/ci-gate.test.js tests/ci-report.test.js tests/desktop-protocol.test.js tests/ios-flow-protocol.test.js",
     "test:browser-journey": "node --test tests/browser-journey.test.js",
     "test:browser-native": "TAPP_RUN_NATIVE_BROWSER=1 node --test tests/browser-native-journey.test.js"
   }

package/scripts/ci-gate.sh

@@ -15,9 +15,9 @@
 #                      # bundle id is detected from the .app when omitted
 #                      [--actions N]              # exploration budget (default 40)
 #                      [--timeout S]              # exploration watchdog (default 600)
-#                      [--flows <glob>]           # Flow YAMLs to replay (default: <app repo>/.autotap/flows/*.yml if --project-dir given)
-#                      [--scenarios <glob>]       # Multi-actor Scenario YAMLs (web; default: <app repo>/.autotap/scenarios/*.yml)
-#                      [--contracts <glob>]       # TypeScript release contracts (default: <app repo>/.autotap/contracts/*.contract.ts)
+#                      [--flows <glob>]           # Flow YAMLs to replay (default: <app repo>/.tapp/flows/*.yml if --project-dir given)
+#                      [--scenarios <glob>]       # Multi-actor Scenario YAMLs (web; default: <app repo>/.tapp/scenarios/*.yml)
+#                      [--contracts <glob>]       # TypeScript release contracts (default: <app repo>/.tapp/contracts/*.contract.ts)
 #                      [--project-dir <dir>]      # the app repo checkout (for flows + baseline defaults)
 #                      [--pr-base <git-ref>]      # select critical + diff-relevant contracts from base...head
 #                      [--pr-head <git-ref>]      # default HEAD
@@ -79,10 +79,15 @@ if [[ -n "$PROJECT_DIR" ]]; then
   [[ -d "$PROJECT_DIR" ]] || { echo "❌ Project directory not found: $PROJECT_DIR" >&2; exit 2; }
   PROJECT_DIR="$(cd "$PROJECT_DIR" && pwd)"
 fi
-[[ -z "$FLOWS" && -n "$PROJECT_DIR" && -d "$PROJECT_DIR/.autotap/flows" ]] && FLOWS="$PROJECT_DIR/.autotap/flows/*.yml"
-[[ "$PLATFORM" == "web" && -z "$SCENARIOS" && -n "$PROJECT_DIR" && -d "$PROJECT_DIR/.autotap/scenarios" ]] && SCENARIOS="$PROJECT_DIR/.autotap/scenarios/*.yml"
-[[ -z "$CONTRACTS" && -n "$PROJECT_DIR" && -d "$PROJECT_DIR/.autotap/contracts" ]] && CONTRACTS="$PROJECT_DIR/.autotap/contracts/*.contract.ts"
-[[ -z "$BASELINE" && -n "$PROJECT_DIR" && -f "$PROJECT_DIR/.autotap/baseline.json" ]] && BASELINE="$PROJECT_DIR/.autotap/baseline.json"
+TAPP_PROJECT_ARTIFACTS=""
+if [[ -n "$PROJECT_DIR" ]]; then
+  [[ -d "$PROJECT_DIR/.tapp" ]] && TAPP_PROJECT_ARTIFACTS="$PROJECT_DIR/.tapp"
+  [[ -z "$TAPP_PROJECT_ARTIFACTS" && -d "$PROJECT_DIR/.autotap" ]] && TAPP_PROJECT_ARTIFACTS="$PROJECT_DIR/.autotap"
+fi
+[[ -z "$FLOWS" && -n "$TAPP_PROJECT_ARTIFACTS" && -d "$TAPP_PROJECT_ARTIFACTS/flows" ]] && FLOWS="$TAPP_PROJECT_ARTIFACTS/flows/*.yml"
+[[ "$PLATFORM" == "web" && -z "$SCENARIOS" && -n "$TAPP_PROJECT_ARTIFACTS" && -d "$TAPP_PROJECT_ARTIFACTS/scenarios" ]] && SCENARIOS="$TAPP_PROJECT_ARTIFACTS/scenarios/*.yml"
+[[ -z "$CONTRACTS" && -n "$TAPP_PROJECT_ARTIFACTS" && -d "$TAPP_PROJECT_ARTIFACTS/contracts" ]] && CONTRACTS="$TAPP_PROJECT_ARTIFACTS/contracts/*.contract.ts"
+[[ -z "$BASELINE" && -n "$TAPP_PROJECT_ARTIFACTS" && -f "$TAPP_PROJECT_ARTIFACTS/baseline.json" ]] && BASELINE="$TAPP_PROJECT_ARTIFACTS/baseline.json"
 [[ -z "$BASELINE" || -f "$BASELINE" ]] || { echo "❌ Baseline not found: $BASELINE" >&2; exit 2; }
 if [[ -n "$BASELINE" ]]; then
   python3 -c 'import json,sys; json.load(open(sys.argv[1]))' "$BASELINE" 2>/dev/null \
@@ -254,7 +259,7 @@ print(named[0] if named else (iphones[0] if iphones else ''))
   if [[ -z "$UDID" ]]; then
     RUNTIME="$(xcrun simctl list runtimes -j | python3 -c 'import sys,json; rts=[r for r in json.load(sys.stdin)["runtimes"] if r.get("isAvailable") and r["platform"]=="iOS"]; print(rts[-1]["identifier"] if rts else "")')"
     [[ -n "$RUNTIME" ]] || { echo "❌ No iOS simulator runtime available" >&2; exit 1; }
-    UDID="$(xcrun simctl create "AutoTap CI" "$DEVICE" "$RUNTIME")" || { echo "❌ Could not create simulator" >&2; exit 1; }
+    UDID="$(xcrun simctl create "Tapp CI" "$DEVICE" "$RUNTIME")" || { echo "❌ Could not create simulator" >&2; exit 1; }
   fi
   echo "Booting $UDID …"
   xcrun simctl boot "$UDID" || true
@@ -269,7 +274,7 @@ xcrun simctl install "$UDID" "$APP_PATH" || { echo "❌ simctl install failed
 # ── Autonomous exploration (quick-capture builds the harness itself if needed).
 step "Explore ($ACTIONS actions, ${TIMEOUT}s watchdog)"
 set +e
-CAPTURE_ROOT="${AUTOTAP_HOME:-$ROOT}/captures"
+CAPTURE_ROOT="${TAPP_HOME:-${AUTOTAP_HOME:-$ROOT}}/captures"
 mkdir -p "$CAPTURE_ROOT"
 CAPTURE_DIR="$(mktemp -d "$CAPTURE_ROOT/ci.XXXXXX")"
 TAPP_CAPTURE_DIR="$CAPTURE_DIR" OCQA_PR_TARGET_JSON="$IOS_PR_TARGET_JSON" "$ROOT/scripts/quick-capture.sh" explore "$BUNDLE_ID" --actions "$ACTIONS" --timeout "$TIMEOUT"
@@ -282,7 +287,7 @@ echo "Markers: $MARKERS"
 FLOW_LOG_ARGS=()
 if [[ "${#FLOW_FILES[@]}" -gt 0 ]]; then
   step "Flows"
-  FLOW_LOG_DIR="$(mktemp -d /tmp/autotap-ci-flows.XXXXXX)"
+  FLOW_LOG_DIR="$(mktemp -d /tmp/tapp-ci-flows.XXXXXX)"
   for flow in "${FLOW_FILES[@]}"; do
     name="$(basename "$flow" .yml)"
     log="$FLOW_LOG_DIR/$name.log"

package/scripts/flow_ai_judge.py

@@ -26,7 +26,7 @@ def _ctx():
 
 
 SSL_CTX = _ctx()
-MODEL = os.environ.get("AUTOTAP_VISION_MODEL", "claude-haiku-4-5-20251001")
+MODEL = os.environ.get("TAPP_VISION_MODEL") or os.environ.get("AUTOTAP_VISION_MODEL", "claude-haiku-4-5-20251001")
 SYSTEM = (
     "You are a QA test oracle. You are shown one iOS app screenshot and a CLAIM the test asserts about "
     "it. Decide if the claim is TRUE of what is actually visible. Be strict and literal — only pass if "

package/scripts/flow_lib.py

@@ -23,7 +23,7 @@ def load_flow(path):
 
 
 def to_yaml(json_str):
-    """Emit a recorded/inline Flow (JSON string) as tidy YAML for saving to .autotap/flows/*.yml."""
+    """Emit a recorded/inline Flow (JSON string) as tidy YAML for saving to .tapp/flows/*.yml."""
     import yaml
     flow = json.loads(json_str)
     # Order keys for readability. `platform` + `url` make the same repository-native

package/scripts/quick-capture.sh

@@ -12,27 +12,28 @@ set -euo pipefail
 #          [--timeout <secs>]                         # Hard timeout for explore command
 #   quick-capture.sh tree <bundleId>                  # Dump accessibility tree
 #
-# All output goes to ~/repos/AutoTap/captures/<timestamp>/
+# All output goes to the configured Tapp home or the repository capture directory.
 
 PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 # TAPP_CAPTURE_DIR selects one exact run directory (used by CI so a failed run can never
-# accidentally reuse stale markers). AUTOTAP_HOME redirects all writable output otherwise —
-# set by the `autotap` CLI when running as an installed npm package, where the package dir
+# accidentally reuse stale markers). TAPP_HOME redirects all writable output otherwise —
+# set by the `tapp` CLI when running as an installed npm package, where the package dir
 # must stay read-only. Unset (repo dev flow), everything lands in the repo as before.
+TAPP_RUNTIME_HOME="${TAPP_HOME:-${AUTOTAP_HOME:-}}"
 if [[ -n "${TAPP_CAPTURE_DIR:-}" ]]; then
   CAPTURE_DIR="$TAPP_CAPTURE_DIR"
-elif [[ -n "${AUTOTAP_HOME:-}" ]]; then
-  CAPTURE_DIR="$AUTOTAP_HOME/captures/$(date +%Y%m%d-%H%M%S)"
+elif [[ -n "$TAPP_RUNTIME_HOME" ]]; then
+  CAPTURE_DIR="$TAPP_RUNTIME_HOME/captures/$(date +%Y%m%d-%H%M%S)"
 else
   CAPTURE_DIR="$PROJECT_ROOT/captures/$(date +%Y%m%d-%H%M%S)"
 fi
-if [[ -n "${AUTOTAP_HOME:-}" ]]; then
-  HARNESS_DERIVED="$AUTOTAP_HOME/harness-derived"
+if [[ -n "$TAPP_RUNTIME_HOME" ]]; then
+  HARNESS_DERIVED="$TAPP_RUNTIME_HOME/harness-derived"
 else
-  HARNESS_DERIVED="/tmp/autotap-harness-derived"
+  HARNESS_DERIVED="/tmp/tapp-harness-derived"
 fi
 HARNESS_PROJECT="$PROJECT_ROOT/Harness/OCQAHarness.xcodeproj"
-DEFAULT_BUNDLE="com.autotap.demoapp"
+DEFAULT_BUNDLE="io.github.aarwitz.tapp.demoapp"
 
 get_booted_sim() {
   xcrun simctl list devices booted -j 2>/dev/null \
@@ -168,13 +169,13 @@ run_harness_test() {
   "OCQA_MAX_ACTIONS": "$max_actions",
   "OCQA_TIMEOUT_SECONDS": "$timeout_secs",
   "OCQA_TEST_EMAIL": "${OCQA_TEST_EMAIL:-qa@example.com}",
-  "OCQA_TEST_PASSWORD": "${OCQA_TEST_PASSWORD:-Autotap123!}"$interactive_line$overrides_line$launch_args_line$launch_env_line$login_steps_line$pr_target_line
+  "OCQA_TEST_PASSWORD": "${OCQA_TEST_PASSWORD:-Tapp123!}"$interactive_line$overrides_line$launch_args_line$launch_env_line$login_steps_line$pr_target_line
 }
 CONF
 
   local xctestrun=$(find "$HARNESS_DERIVED/Build/Products" -name "*.xctestrun" 2>/dev/null | head -1)
   if [[ -z "$xctestrun" ]]; then
-    echo "ERROR: No xctestrun found. Run: ./scripts/deploy-and-build.sh --harness" >&2
+    echo "ERROR: No xctestrun found. Run: tapp install" >&2
     return 1
   fi
 
@@ -382,12 +383,12 @@ case "$MODE" in
   "OCQA_SESSION_RESULT_PATH": "$SESS_RES",
   "OCQA_SESSION_TIMEOUT": "$SESS_TIMEOUT",
   "OCQA_TEST_EMAIL": "${OCQA_TEST_EMAIL:-qa@example.com}",
-  "OCQA_TEST_PASSWORD": "${OCQA_TEST_PASSWORD:-Autotap123!}"$sess_args_line$sess_env_line
+  "OCQA_TEST_PASSWORD": "${OCQA_TEST_PASSWORD:-Tapp123!}"$sess_args_line$sess_env_line
 }
 CONF
     xctestrun=$(find "$HARNESS_DERIVED/Build/Products" -name "*.xctestrun" 2>/dev/null | head -1)
     if [[ -z "$xctestrun" ]]; then
-      echo "ERROR: No xctestrun. Run: ./scripts/deploy-and-build.sh --harness" >&2
+      echo "ERROR: No xctestrun. Run: tapp install" >&2
       exit 1
     fi
     export TEST_RUNNER_OCQA_CONFIG_PATH=/tmp/ocqa-run-config.json
@@ -399,7 +400,7 @@ CONF
     ;;
 
   build-harness)
-    # Just (re)build the harness cache for the booted sim — used by `autotap install`
+    # Just (re)build the harness cache for the booted sim — used by `tapp install`
     # for a fast first tool call later. No capture output.
     ensure_harness_built "$SIM_NAME"
     rmdir "$CAPTURE_DIR" 2>/dev/null || true

package/scripts/run-flow.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Run an AutoTap Flow — a deterministic, authored/recorded E2E test (see docs/flows-architecture.md).
+# Run a Tapp Flow — a deterministic, authored/recorded E2E test.
 #
 # Replays the flow's steps against an app on the BOOTED simulator with wait-for-condition timing and
 # poll-with-timeout assertions (no sleeps), then prints a scannable pass/fail report. Deterministic by
@@ -24,14 +24,14 @@ APP="${2:-}"
 
 UDID="$(xcrun simctl list devices booted -j 2>/dev/null | python3 -c 'import sys,json; d=json.load(sys.stdin); print(next((x["udid"] for v in d["devices"].values() for x in v if x.get("state")=="Booted"), ""))')"
 [ -z "$UDID" ] && { echo "❌ No booted simulator."; exit 2; }
-# When run through the `autotap` CLI (installed npm package), the harness cache lives under
-# AUTOTAP_HOME — check there first, then the repo-dev locations.
+# When run through the installed `tapp` CLI, the harness cache lives under TAPP_HOME.
 XCTR=""
-[ -n "${AUTOTAP_HOME:-}" ] && XCTR="$(find "$AUTOTAP_HOME/harness-derived/Build/Products" -name '*.xctestrun' 2>/dev/null | head -1)"
+TAPP_RUNTIME_HOME="${TAPP_HOME:-${AUTOTAP_HOME:-}}"
+[ -n "$TAPP_RUNTIME_HOME" ] && XCTR="$(find "$TAPP_RUNTIME_HOME/harness-derived/Build/Products" -name '*.xctestrun' 2>/dev/null | head -1)"
 [ -z "$XCTR" ] && XCTR="$(find "$HOME/Library/Developer/Xcode/DerivedData/OCQAHarness-"*/Build/Products -name '*.xctestrun' 2>/dev/null | head -1)"
-[ -z "$XCTR" ] && XCTR="$(find /tmp/autotap-harness-derived/Build/Products -name '*.xctestrun' 2>/dev/null | head -1)"
+[ -z "$XCTR" ] && XCTR="$(find /tmp/tapp-harness-derived/Build/Products -name '*.xctestrun' 2>/dev/null | head -1)"
 [ -z "$XCTR" ] && XCTR="$(find /tmp/harness-build/Build/Products -name '*.xctestrun' 2>/dev/null | head -1)"
-[ -z "$XCTR" ] && { echo "❌ Harness not built. Run: scripts/deploy-and-build.sh --harness"; exit 2; }
+[ -z "$XCTR" ] && { echo "❌ Harness not built. Run: tapp install"; exit 2; }
 
 NAME="$(python3 -c "import sys,json;print(json.loads(sys.argv[1]).get('name','flow'))" "$FLOW_JSON")"
 echo "▶️  Running flow \"$NAME\" against $APP …"

package/scripts/android-corpus-e2e.sh

@@ -1,30 +0,0 @@
-#!/usr/bin/env bash
-# Build and exercise every native Android fixture through the same release gate
-# customers use. A connected, booted emulator/device is required.
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-CORPUS="$ROOT/AndroidCorpus"
-SERIAL="${1:-${ANDROID_SERIAL:-}}"
-SERIAL_ARGS=()
-[[ -n "$SERIAL" ]] && SERIAL_ARGS=(--serial "$SERIAL")
-
-"$CORPUS/gradlew" -p "$CORPUS" \
-  :demoapp:assembleDebug :logindemo:assembleDebug :shopdemo:assembleDebug --no-daemon --quiet
-
-run_fixture() {
-  local module="$1" app_id="$2" flow="$3"
-  local apk="$CORPUS/$module/build/outputs/apk/debug/$module-debug.apk"
-  local output_dir="${RUNNER_TEMP:-/tmp}/tapp-android-corpus-$module"
-  mkdir -p "$output_dir"
-  echo "Testing Android corpus fixture: $module ($app_id)"
-  "$ROOT/scripts/ci-gate.sh" --platform android --apk "$apk" --app-id "$app_id" \
-    "${SERIAL_ARGS[@]}" --actions 12 --timeout 180 --flows "$CORPUS/$module/.autotap/flows/$flow" \
-    --project-dir "$CORPUS/$module" --json-out "$output_dir/report.json" --md-out "$output_dir/report.md"
-}
-
-run_fixture demoapp io.tapp.corpus.demo smoke.yml
-run_fixture logindemo io.tapp.corpus.login sign-in.yml
-run_fixture shopdemo io.tapp.corpus.shop checkout.yml
-
-echo "All Android corpus gates passed."