@aperant/framework 0.11.0 → 0.12.0

package/bin/apt-proof-video.mjs

@@ -646,13 +646,16 @@ function renderMarkdown(md) {
 }
 
 function statusBadge(status) {
+	// v0.9.0 — verdict enum is {approved, rejected, needs_human}.
+	// `approved-with-notes` is DELETED (no shim). `needs_human` is amber.
 	const colors = {
 		pass: '#22c55e',
 		approved: '#22c55e',
 		fail: '#ef4444',
 		rejected: '#ef4444',
 		partial: '#f59e0b',
-		'approved-with-notes': '#f59e0b',
+		needs_human: '#f59e0b',
+		needs_human_with_transport: '#f59e0b',
 		skip: '#6b7280',
 		error: '#ef4444',
 	}
@@ -810,7 +813,7 @@ function renderVideoCard(filename, mimeType, analysisData, index) {
 		</div>`
 }
 
-function generateReportHtml(opts) {
+export function generateReportHtml(opts) {
 	const {
 		title,
 		runDate,
@@ -950,29 +953,41 @@ function generateReportHtml(opts) {
 		</div>`
 	}
 
-	const featuresHtml =
-		v?.features?.length > 0
+	// v0.9.0 — outcome-rooted rendering. One card per outcome with
+	// `data-outcome-id` + `data-surface` attributes on the root <div>
+	// (load-bearing for AC8). Parent prose + indented inferred children
+	// + per-child evidence rendered inside.
+	const outcomeResultColors = {
+		pass: '#22c55e',
+		fail: '#ef4444',
+		blocked: '#f59e0b',
+		partial: '#f59e0b',
+		needs_human_with_transport: '#f59e0b',
+	}
+	const outcomesSource = Array.isArray(v?.outcomes) && v.outcomes.length > 0 ? v.outcomes : []
+	const outcomesHtml =
+		outcomesSource.length > 0
 			? `<div class="section">
-			<h2>Feature Verification</h2>
-			${v.features
-				.map((f) => {
-					const featureResultColors = {
-						pass: '#22c55e',
-						fail: '#ef4444',
-						blocked: '#f59e0b',
-						partial: '#f59e0b',
-					}
-					const fColor = featureResultColors[f.result] ?? '#6b7280'
-					const passCount = f.tests.filter((t) => t.result === 'pass').length
-					const totalCount = f.tests.length
-					return `<div class="card" style="border-left:3px solid ${fColor};">
+			<h2>Outcome Verification</h2>
+			${outcomesSource
+				.map((o) => {
+					const fColor = outcomeResultColors[o.result] ?? '#6b7280'
+					const passCount = o.tests.filter((t) => t.result === 'pass').length
+					const totalCount = o.tests.length
+					const heading = o.prose ? `${o.outcome_id}: ${o.prose}` : (o.outcome_id ?? '')
+					return `<div class="card" data-outcome-id="${escapeHtml(o.outcome_id ?? '')}" data-surface="${escapeHtml(o.surface ?? '')}" style="border-left:3px solid ${fColor};">
 					<div style="display:flex;align-items:center;gap:8px;margin-bottom:12px;">
-						<h3 style="font-size:15px;color:#f1f5f9;margin:0;">${escapeHtml(f.name)}</h3>
-						${statusBadge(f.result ?? 'pending')}
+						<h3 style="font-size:15px;color:#f1f5f9;margin:0;">${escapeHtml(heading)}</h3>
+						${o.surface ? `<span style="font-size:11px;color:#0B0B0F;background:#D6D876;padding:2px 8px;border-radius:8px;font-weight:600;">${escapeHtml(o.surface)}</span>` : ''}
+						${statusBadge(o.result ?? 'pending')}
 						<span style="font-size:12px;color:#64748b;margin-left:auto;">${passCount}/${totalCount} tests</span>
 					</div>
-					${f.route ? `<div style="font-size:11px;color:#64748b;margin-bottom:8px;">Route: <code style="color:#D6D876;">${escapeHtml(f.route)}</code></div>` : ''}
-					${f.tests.map((t) => renderTestRow(t, f.id)).join('')}
+					${
+						o.inferred && o.inferred.length > 0
+							? `<details style="margin-bottom:8px;"><summary style="font-size:12px;color:#94a3b8;cursor:pointer;">Inferred sub-checks (${o.inferred.length})</summary><ul style="margin:6px 0 0 20px;font-size:12px;color:#cbd5e1;list-style:disc;">${o.inferred.map((s) => `<li style="margin:2px 0;">${escapeHtml(s)}</li>`).join('')}</ul></details>`
+							: ''
+					}
+					${o.tests.map((t) => renderTestRow(t, o.outcome_id)).join('')}
 				</div>`
 				})
 				.join('')}
@@ -1207,9 +1222,17 @@ document.addEventListener('keydown', function(e) { if (e.key === 'Escape') close
 	<h1>${escapeHtml(title)}</h1>
 	<div class="meta">Generated: ${escapeHtml(runDate)}</div>
 	<div class="hero-status">${statusBadge(overallVerdict)}</div>
+	${
+		v?.gates
+			? `<div style="display:flex;justify-content:center;gap:12px;margin-top:8px;">
+		<span style="font-size:11px;color:#94a3b8;">automation_gate:</span>${statusBadge(v.gates.automation_gate ?? 'pending')}
+		<span style="font-size:11px;color:#94a3b8;">proof_gate:</span>${statusBadge(v.gates.proof_gate ?? 'pending')}
+	</div>`
+			: ''
+	}
 	<div style="margin-top:12px;">
 		<div style="display:flex;justify-content:center;gap:32px;">
-			<div class="stat"><div class="stat-value">${v?.features?.length ?? screenshots.length}</div><div class="stat-label">Features</div></div>
+			<div class="stat"><div class="stat-value">${v?.outcomes?.length ?? v?.features?.length ?? screenshots.length}</div><div class="stat-label">${v?.outcomes?.length ? 'Outcomes' : 'Features'}</div></div>
 			<div class="stat"><div class="stat-value">${passedTests}</div><div class="stat-label">Passed</div></div>
 			<div class="stat"><div class="stat-value">${failedTests}</div><div class="stat-label">Failed</div></div>
 			<div class="stat"><div class="stat-value">${blockedTests}</div><div class="stat-label">Blocked</div></div>
@@ -1224,7 +1247,7 @@ ${summaryHtml}
 ${automatedChecksHtml}
 ${coverageHtml}
 ${dimensionsHtml}
-${featuresHtml}
+${outcomesHtml}
 ${gapsHtml}
 ${skippedHtml}
 ${videosHtml}
@@ -1280,10 +1303,96 @@ function loadVerificationData(proofDir) {
 	return null
 }
 
+/**
+ * Closed-set validator for `automated_checks.{tests,typecheck,lint}.status`.
+ *
+ * v0.9.0 (verify-proof-v2-outcome-walker_27-05-26) — `status` MUST be in
+ * `{pass, fail}`. Anything else (e.g. the legacy "enforced_at_commit"
+ * dodge string) is coerced to `'fail'` so downstream gate derivation
+ * surfaces the issue. Returns the canonical lowercase value.
+ *
+ * Exported for testing.
+ */
+export function normalizeAutomatedCheckStatus(status) {
+	if (status === 'pass' || status === 'fail') return status
+	return 'fail'
+}
+
+/**
+ * Closed set of UI surfaces (electron, web, electron+web). Used by
+ * `deriveProofGate` to detect the fail-closed branch: a UI-surface test
+ * carrying `evidence: "file-evidence: ..."` is REJECTED as proof and
+ * its effective result is forced to `needs_human_with_transport`.
+ */
+const UI_SURFACES = new Set(['electron', 'web', 'electron+web'])
+
+/**
+ * Compute the effective `result` for a single test entry per AC9.
+ *
+ * - If `surface` is a UI surface AND `evidence` matches `^file-evidence:`,
+ *   the effective result is `needs_human_with_transport` regardless of
+ *   the written `result`.
+ * - Otherwise, the written `result` is honored as-is.
+ *
+ * Exported for testing.
+ */
+export function effectiveTestResult(test) {
+	if (!test || typeof test !== 'object') return 'pending'
+	const surface = typeof test.surface === 'string' ? test.surface : ''
+	const evidence = typeof test.evidence === 'string' ? test.evidence : ''
+	if (UI_SURFACES.has(surface) && /^file-evidence:/i.test(evidence)) {
+		return 'needs_human_with_transport'
+	}
+	return test.result ?? 'pending'
+}
+
+/**
+ * Derive `proof_gate` (`pass | fail`) from the per-test evidence story.
+ *
+ * v0.9.0 — `proof_gate = fail` iff ANY test's effective result is `fail`.
+ * A `needs_human_with_transport` result does NOT fail the proof_gate on
+ * its own — it bubbles up to the overall verdict as `needs_human` via
+ * `deriveVerdict`. Missing surface evidence on a UI outcome (caught by
+ * `effectiveTestResult`) becomes `needs_human_with_transport`, not `fail`.
+ *
+ * Exported for testing.
+ */
+export function deriveProofGate(verification) {
+	const tests = Array.isArray(verification?.tests) ? verification.tests : []
+	if (tests.length === 0) return 'fail'
+	for (const t of tests) {
+		if (effectiveTestResult(t) === 'fail') return 'fail'
+	}
+	return 'pass'
+}
+
+/**
+ * Derive `automation_gate` (`pass | fail`) from the three automated checks.
+ *
+ * v0.9.0 — `automation_gate = pass` iff ALL THREE of `tests`, `typecheck`,
+ * `lint` are `pass`. Missing checks count as `fail`. Per-check status is
+ * normalized via `normalizeAutomatedCheckStatus` first so the legacy
+ * `enforced_at_commit` string surfaces as `fail` rather than slipping
+ * through.
+ *
+ * Exported for testing.
+ */
+export function deriveAutomationGate(automatedChecks) {
+	if (!automatedChecks || typeof automatedChecks !== 'object') return 'fail'
+	const statuses = ['tests', 'typecheck', 'lint'].map((key) => {
+		const entry = automatedChecks[key]
+		if (!entry || typeof entry !== 'object') return 'fail'
+		return normalizeAutomatedCheckStatus(entry.status)
+	})
+	return statuses.every((s) => s === 'pass') ? 'pass' : 'fail'
+}
+
 /**
  * Map verification.json schema to the internal shape used by generateReportHtml().
+ *
+ * Exported for testing (verify-proof-renderer-outcome-grouping.test.ts).
  */
-function mapVerificationJson(json) {
+export function mapVerificationJson(json) {
 	const meta = json.meta ?? {}
 	const checks = json.automated_checks ?? {}
 	const tests = json.tests ?? []
@@ -1292,39 +1401,73 @@ function mapVerificationJson(json) {
 	const skipped = json.skipped ?? []
 	const coverage = json.coverage ?? null
 
-	// Map automated checks
+	// Map automated checks. v0.9.0 (verify-proof-v2-outcome-walker_27-05-26)
+	// — `status` MUST be in the closed set {pass, fail}. The legacy
+	// `enforced_at_commit` dodge string is no longer valid; if the input
+	// carries it (or any other non-{pass,fail} value), the per-check status
+	// becomes `fail` so the proof-gate derivation surfaces the issue.
 	const automatedChecks = {
 		tests: checks.tests
 			? {
-					status: checks.tests.status,
+					status: normalizeAutomatedCheckStatus(checks.tests.status),
 					output: checks.tests.output ?? '',
 					count: checks.tests.count,
 				}
 			: null,
 		typecheck: checks.typecheck
-			? { status: checks.typecheck.status, output: checks.typecheck.output ?? '' }
+			? {
+					status: normalizeAutomatedCheckStatus(checks.typecheck.status),
+					output: checks.typecheck.output ?? '',
+				}
 			: null,
-		lint: checks.lint ? { status: checks.lint.status, output: checks.lint.output ?? '' } : null,
+		lint: checks.lint
+			? {
+					status: normalizeAutomatedCheckStatus(checks.lint.status),
+					output: checks.lint.output ?? '',
+				}
+			: null,
+	}
+
+	// v0.9.0 (verify-proof-v2-outcome-walker_27-05-26) — group tests by
+	// `outcome_id` instead of the legacy `registry_id.split('-')[0]` prefix.
+	// `meta.outcomes[]` (when present) provides the parent prose + inferred
+	// children for each card. Per-test mapping preserves `outcome_id`,
+	// `surface`, and `transport` so the renderer can render them.
+	const metaOutcomes = Array.isArray(meta.outcomes) ? meta.outcomes : []
+	const outcomeMeta = new Map()
+	for (const o of metaOutcomes) {
+		if (o && typeof o === 'object' && typeof o.id === 'string') {
+			outcomeMeta.set(o.id, o)
+		}
 	}
 
-	// Group tests into features by registry_id prefix or as a single group
-	const featureGroups = new Map()
+	const outcomeGroups = new Map()
 	for (const t of tests) {
-		const groupKey = t.registry_id ? t.registry_id.split('-').slice(0, 1).join('-') : 'all'
-		if (!featureGroups.has(groupKey)) {
-			featureGroups.set(groupKey, {
-				name: groupKey,
-				id: groupKey,
-				route: '',
-				mcp: '',
+		const groupKey = t.outcome_id ?? 'unassigned'
+		if (!outcomeGroups.has(groupKey)) {
+			const m = outcomeMeta.get(groupKey)
+			outcomeGroups.set(groupKey, {
+				outcome_id: groupKey,
+				surface: m?.surface ?? t.surface ?? '',
+				prose: typeof m?.text === 'string' ? m.text : '',
+				inferred: Array.isArray(m?.inferred) ? m.inferred.slice() : [],
 				result: '',
 				tests: [],
 			})
 		}
-		featureGroups.get(groupKey).tests.push({
+		const group = outcomeGroups.get(groupKey)
+		// First test on the group establishes the surface if meta didn't.
+		if (!group.surface && typeof t.surface === 'string') {
+			group.surface = t.surface
+		}
+		group.tests.push({
 			name: t.name ?? t.id,
 			id: t.id,
 			registry_id: t.registry_id,
+			outcome_id: t.outcome_id ?? null,
+			surface: t.surface ?? null,
+			transport: t.transport ?? null,
+			inferred_index: typeof t.inferred_index === 'number' ? t.inferred_index : null,
 			precondition: t.precondition ?? '',
 			action: t.action ?? '',
 			expected: t.expected ?? '',
@@ -1337,19 +1480,31 @@ function mapVerificationJson(json) {
 		})
 	}
 
-	// Derive feature-level results
-	const features = []
-	for (const [, f] of featureGroups) {
-		const results = f.tests.map((t) => t.result)
-		if (results.every((r) => r === 'pass')) f.result = 'pass'
-		else if (results.some((r) => r === 'fail')) f.result = 'fail'
-		else if (results.some((r) => r === 'blocked')) f.result = 'partial'
-		else f.result = 'partial'
-		// Capitalize feature name
-		f.name = f.name.charAt(0).toUpperCase() + f.name.slice(1) + ' Features'
-		features.push(f)
+	// Derive per-outcome result roll-up.
+	const outcomes = []
+	for (const [, o] of outcomeGroups) {
+		const results = o.tests.map((t) => t.result)
+		if (results.some((r) => r === 'fail')) o.result = 'fail'
+		else if (results.some((r) => r === 'needs_human_with_transport'))
+			o.result = 'needs_human_with_transport'
+		else if (results.every((r) => r === 'pass')) o.result = 'pass'
+		else if (results.some((r) => r === 'blocked')) o.result = 'partial'
+		else o.result = 'partial'
+		outcomes.push(o)
 	}
 
+	// Legacy `features` array — kept as a deprecated alias for one release
+	// per CHANGELOG. Same payload, but keyed `name`/`id` for the legacy
+	// HTML renderer until ST8's rewrite lands.
+	const features = outcomes.map((o) => ({
+		name: o.outcome_id,
+		id: o.outcome_id,
+		route: '',
+		mcp: '',
+		result: o.result,
+		tests: o.tests,
+	}))
+
 	// Map dimensions
 	const dimensions = []
 	for (const [key, val] of Object.entries(dims)) {
@@ -1373,6 +1528,22 @@ function mapVerificationJson(json) {
 		fix_plan: g.fix_plan ?? null,
 	}))
 
+	// v0.9.0 — propagate the two-gate envelope to the renderer. Also
+	// derive automation_gate from automated_checks as a fallback when the
+	// input doesn't carry it explicitly (forward-compat for older
+	// verification.json that pre-dates the schema extension).
+	const gatesInput = json.gates && typeof json.gates === 'object' ? json.gates : {}
+	const gates = {
+		automation_gate:
+			gatesInput.automation_gate === 'pass' || gatesInput.automation_gate === 'fail'
+				? gatesInput.automation_gate
+				: deriveAutomationGate(automatedChecks),
+		proof_gate:
+			gatesInput.proof_gate === 'pass' || gatesInput.proof_gate === 'fail'
+				? gatesInput.proof_gate
+				: deriveProofGate({ tests }),
+	}
+
 	return {
 		frontmatter: {
 			run_id: meta.run_id,
@@ -1387,6 +1558,8 @@ function mapVerificationJson(json) {
 			verdictText: meta.verdict ?? '',
 		},
 		automatedChecks,
+		gates,
+		outcomes,
 		features,
 		dimensions,
 		gaps: mappedGaps,
@@ -1876,6 +2049,9 @@ async function cmdReport(args) {
 		}
 	}
 
+	// v0.9.0 — emit `outcomesCount` (the new field); `featuresCount` is
+	// retained for one release as a deprecated sentinel (always `0`) so
+	// downstream consumers don't crash on missing key. See CHANGELOG.
 	output({
 		status: 'ok',
 		report: {
@@ -1884,7 +2060,8 @@ async function cmdReport(args) {
 			screenshotCount: scanned.images.length,
 			videoCount: scanned.videos.length,
 			verdictCount: verdicts.length,
-			featuresCount: verification?.features?.length ?? 0,
+			outcomesCount: verification?.outcomes?.length ?? 0,
+			featuresCount: 0,
 			gapsCount: verification?.gaps?.length ?? 0,
 			mode: isArchive ? 'archive' : 'relative',
 			title,
@@ -2044,35 +2221,38 @@ All output is JSON to stdout. Progress goes to stderr.`
 }
 
 // ---------------------------------------------------------------------------
-// Dispatch
+// Dispatch (only runs when invoked as the CLI entry point, not when imported)
 // ---------------------------------------------------------------------------
 
-const args = process.argv.slice(2)
-const command = args[0]
+const isCliEntry = process.argv[1] === __filename
+if (isCliEntry) {
+	const args = process.argv.slice(2)
+	const command = args[0]
 
-if (!command || command === '--help' || command === '-h') {
-	printHelp()
-	process.exit(0)
-}
+	if (!command || command === '--help' || command === '-h') {
+		printHelp()
+		process.exit(0)
+	}
 
-if (command === '--version' || command === '-v') {
-	process.stdout.write(getVersion() + '\n')
-	process.exit(0)
-}
+	if (command === '--version' || command === '-v') {
+		process.stdout.write(getVersion() + '\n')
+		process.exit(0)
+	}
 
-switch (command) {
-	case 'analyze':
-		await cmdAnalyze(args.slice(1))
-		break
-	case 'capture':
-		await cmdCapture(args.slice(1))
-		break
-	case 'report':
-		await cmdReport(args.slice(1))
-		break
-	case 'models':
-		await cmdModels()
-		break
-	default:
-		fail(`Unknown command: ${command}. Run apt-proof-video --help for usage.`)
+	switch (command) {
+		case 'analyze':
+			await cmdAnalyze(args.slice(1))
+			break
+		case 'capture':
+			await cmdCapture(args.slice(1))
+			break
+		case 'report':
+			await cmdReport(args.slice(1))
+			break
+		case 'models':
+			await cmdModels()
+			break
+		default:
+			fail(`Unknown command: ${command}. Run apt-proof-video --help for usage.`)
+	}
 }

package/dist/cli/commands/apply-recipe.d.mts

@@ -0,0 +1,6 @@
+/**
+ * @param {string} projectDir
+ * @param {string[]} [extra]
+ */
+export function cmdApplyRecipe(projectDir: string, extra?: string[]): Promise<import("../util/result.mjs").CommandResult>;
+//# sourceMappingURL=apply-recipe.d.mts.map

package/dist/cli/commands/apply-recipe.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-recipe.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/apply-recipe.mjs"],"names":[],"mappings":"AA+BA;;;GAGG;AACH,2CAHW,MAAM,UACN,MAAM,EAAE,uDAuElB"}

package/dist/cli/commands/apply-recipe.mjs

@@ -0,0 +1,98 @@
+/**
+ * commands/apply-recipe.mjs — `apt-tools apply-recipe <projectDir> [--confirm] [--accept-all] [--force]`.
+ *
+ * Wraps applyRecipe() at the CLI surface.
+ *
+ *   --confirm     switches from dry-run (the default) to live writes.
+ *   --accept-all  bypasses per-change confirmation (pipeline/scripted use).
+ *   --force       overrides the TOFU user_modified guard — overwrites files
+ *                 whose SHA diverges from the recipe's expected before value.
+ *                 Files containing the recipe's marker are still skipped.
+ *
+ * The two flags compose: `--confirm` alone enters live mode but defers
+ * per-change accept/skip to the caller — without `--accept-all` and
+ * without a stdin-driven prompt, every change is SKIPPED (fail-safe per
+ * ID-02). Adopters using the interactive apt-setup SKILL.md mini-flow
+ * walk each change one at a time before invoking the CLI with
+ * `--accept-all` once they've reviewed the diff. Adopters in CI /
+ * fan-out / scripted contexts pass both flags up front.
+ *
+ * Exit codes:
+ *   0 — applyRecipe completed (dry-run or confirmed)
+ *   1 — usage error / no-recipe-match / applyRecipe threw
+ */
+import { parseFlags } from '../util/args.mjs';
+import { err, exitWith, ok } from '../util/result.mjs';
+import { loadRuntimeCapabilities } from '../util/runtime-capabilities.mjs';
+import { applyRecipe } from '../verify-proof/sandbox/apply.mjs';
+import { matchPatternForProject } from '../verify-proof/sandbox/pattern-matcher.mjs';
+import { discoverBundledRecipes } from '../verify-proof/sandbox/sandbox-config.mjs';
+/**
+ * @param {string} projectDir
+ * @param {string[]} [extra]
+ */
+export async function cmdApplyRecipe(projectDir, extra = []) {
+    if (!projectDir) {
+        return err('Usage: apt-tools apply-recipe <project-dir> [--confirm] [--accept-all]');
+    }
+    const flags = parseFlags(extra);
+    const confirm = flags.has('confirm');
+    const acceptAll = flags.has('accept-all');
+    const force = flags.has('force');
+    const recipes = discoverBundledRecipes();
+    const runtime = loadRuntimeCapabilities(projectDir);
+    const explicitRecipeId = flags.get('recipe') ?? null;
+    let recipeId;
+    let matchReason;
+    if (explicitRecipeId) {
+        recipeId = explicitRecipeId;
+        matchReason = 'explicit';
+    }
+    else {
+        const match = matchPatternForProject(projectDir, runtime, recipes);
+        recipeId = match.recipeId;
+        matchReason = match.reason;
+    }
+    if (!recipeId) {
+        return exitWith({
+            status: 'error',
+            command: 'apply-recipe',
+            code: 'E_NO_RECIPE',
+            reason: matchReason,
+            runtime,
+            docs: 'docs/verify-proof-sandbox-patterns.md',
+        }, 1);
+    }
+    try {
+        const result = await applyRecipe({
+            projectDir,
+            recipeId,
+            recipes,
+            confirm,
+            // AC8 + ID-02 — only auto-accept when the caller passed
+            // --accept-all explicitly. Without the flag the underlying
+            // applyRecipe defaults to skip (every change recorded as
+            // `user_declined`); callers driving per-change UX wrap the
+            // applier directly with their own confirmer.
+            perChangeConfirm: acceptAll ? async () => 'accept' : undefined,
+            force,
+        });
+        return ok({
+            status: 'ok',
+            command: 'apply-recipe',
+            project_dir: projectDir,
+            recipe_id: recipeId,
+            recipe_version: result.recipe_version,
+            confirm,
+            accept_all: acceptAll,
+            aborted: result.aborted,
+            writes: result.writes,
+            skips: result.skips,
+            audit_path: result.audit_path,
+        });
+    }
+    catch (e) {
+        return err(`apply-recipe: ${e?.message ?? String(e)}`);
+    }
+}
+//# sourceMappingURL=apply-recipe.mjs.map

package/dist/cli/commands/apply-recipe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-recipe.mjs","sourceRoot":"","sources":["../../../src/cli/commands/apply-recipe.mjs"],"names":[],"mappings":"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"}

package/dist/cli/commands/mobile-prepare.d.mts

@@ -0,0 +1,53 @@
+/**
+ * @typedef {{ binary: string, args: string[] }} LocalCommand
+ */
+/**
+ * Resolve the ordered launch sequence for a (platform, mode, device).
+ *
+ * - mode 'expo' — `npx expo run:ios|run:android` builds, installs, launches,
+ *   and starts Metro in one step (the common Expo/RN path).
+ * - mode 'native' — device-prep only (`xcrun simctl boot` / `adb
+ *   wait-for-device`); the native build+install+launch is delegated (gradle /
+ *   the XcodeBuildMCP escalation per D-02), out of scope for v1's planner.
+ *
+ * @param {{ platform?: string, mode?: string, device?: string }} [opts]
+ * @returns {LocalCommand[]}
+ */
+export function planLaunchSequence(opts?: {
+    platform?: string;
+    mode?: string;
+    device?: string;
+}): LocalCommand[];
+/**
+ * Launch-readiness predicate (D-04). A successful screenshot alone is NOT
+ * enough — for RN/Expo it can capture a native splash, an Expo loading
+ * overlay, a redbox, or the dev-client launcher. ALL signals must hold before
+ * UI driving starts. For a pure-native app (no JS bundle) the caller passes
+ * `bundleConnected: true` and `launcherState: false`.
+ *
+ * @param {{ foregrounded?: boolean, bundleConnected?: boolean, redbox?: boolean, launcherState?: boolean }} [signals]
+ * @returns {boolean}
+ */
+export function isAppReady(signals?: {
+    foregrounded?: boolean;
+    bundleConnected?: boolean;
+    redbox?: boolean;
+    launcherState?: boolean;
+}): boolean;
+/**
+ * `apt-tools mobile prepare <project-dir> --platform <ios|android>
+ *  [--mode <expo|native>] [--device <id>]`
+ *
+ * @param {string} projectDir
+ * @param {string[]} args
+ * @returns {{ envelope: object, exitCode: number }}
+ */
+export function cmdMobilePrepare(projectDir: string, args: string[]): {
+    envelope: object;
+    exitCode: number;
+};
+export type LocalCommand = {
+    binary: string;
+    args: string[];
+};
+//# sourceMappingURL=mobile-prepare.d.mts.map

package/dist/cli/commands/mobile-prepare.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-prepare.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/mobile-prepare.mjs"],"names":[],"mappings":"AAoBA;;GAEG;AAEH;;;;;;;;;;;GAWG;AACH,0CAHW;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,YAAY,EAAE,CAsB1B;AAED;;;;;;;;;GASG;AACH,qCAHW;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9F,OAAO,CAUnB;AA+BD;;;;;;;GAOG;AACH,6CAJW,MAAM,QACN,MAAM,EAAE,GACN;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAqClD;2BAjIY;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE"}