Obsidian iOS Real Device Smoke

Workflow

Prerequisite: complete obsidian-test-vault-smoke at least at app-runtime tier.

1. Bound the changed surface:

git status --short --branch
git diff --stat
git diff --name-only

2. Reuse automated local checks with verified inputs/results under AGENTS.md Validation Planning And Reuse. Complete missing or invalidated Local Validation Gate checks, counting checks covered by the selected enclosing command and supplementing the runtime <style> / innerHTML / outerHTML source scan. Treat rg exit code 1 with no output as PASS and inspect every match. Reuse observed local app smoke only within the same turn while its target/runtime state is unchanged; otherwise renew the affected local app proof. For broad UI/runtime changes, retain make deploy (or its eligible current-build target) and local app smoke before device validation.

3. Sync only the changed artifact after the user requested real-device smoke:

• Runner-only change: use that runner's preparation/sync workflow, compare its destination hash with the source, and keep the current plugin instance and Inspector session. Skip plugin deployment and reload.
• Plugin runtime or CSS change: deploy the current plugin assets:

make deploy-icloud

If the required checks already passed for the current changes (for example, during desktop smoke), use make deploy-icloud-current to verify and copy the same current production build. It checks build identity, not test results; follow AGENTS.md Local Deployment reuse conditions. If both destinations are authorized together, make deploy deploy-icloud shares full validation once.

This writes only plugin assets under:

~/Library/Mobile Documents/iCloud~md~obsidian/Documents/test/.obsidian/plugins/personal-assistant

Request escalated permissions if the sandbox blocks this expected iCloud write.

4. For a plugin-asset change, verify all copied assets deterministically:

ICLOUD_PLUGIN_DIR="$HOME/Library/Mobile Documents/iCloud~md~obsidian/Documents/test/.obsidian/plugins/personal-assistant"
for file in main.js manifest.json manifest-beta.json styles.css; do
  if ! cmp -s "dist/$file" "$ICLOUD_PLUGIN_DIR/$file"; then
    printf 'MISMATCH %s\n' "$file"
    exit 1
  fi
  printf 'MATCH %s\n' "$file"
done

Stop with FAIL if any source or destination file is missing or differs. For a runner-only change, verify only the runner source/destination identity and confirm the already-loaded plugin identity is still current; do not manufacture a plugin lifecycle transition as extra evidence.

5. Load the changed artifact on iPhone using the cheapest sufficient path:

• Runner-only: re-evaluate the synced runner in the existing page. Do not reload the plugin, vault, or App.
• Plugin assets: after byte comparison passes, reload only personal-assistant first, using Obsidian's plugin reload lifecycle. Capture the previous plugin object before reload.
• Before product assertions, require the new plugin object to exist and differ from the previous object, then call getLoadedPluginBuildIdentity() and require no blocker plus loadedPluginArtifactSha256 equal to the matched iCloud main.js SHA-256. Also preserve its load timestamp/version in the evidence.
• If plugin reload is unavailable or identity proves it did not load the matched artifact, allow exactly one vault reload or normal App reopen as a fallback, not both. Recheck loaded identity before continuing.
• Force-quit Obsidian from the iPhone background only when the declared evidence target is process startup, OPFS persistence, or complete unload, or when the reload path above has been proven ineffective by identity evidence. Record that reason; stale-state suspicion alone is insufficient.
• Stop repeated attempts if Obsidian stalls at body.in-progress.
• Do not classify an unresponsive tap as a product bug until asset comparison passed and the iPhone loaded the new build.

6. Use the available native UI tools to inspect Safari Web Inspector attached to the iPhone target named like -- Obsidian -- localhost and to operate iPhone Mirroring when available.

• If the target, device trust, Develop menu, or Web Inspector connection is unavailable, report BLOCKED; do not guess from desktop/mobile emulation.
• Use paste for long Console probes and verify history/output; do not submit a value populated only through Accessibility set_value.

For a Pagelet Action Ring geometry-only change, expose the Ring with one real long press and capture the Mirroring screenshot. If it auto-closes before Inspector measurement, let this single probe reopen it through the production keyboard/context-menu path solely for DOM geometry. Do not count that synthetic reopen as touch evidence.

(()=>{
  const trigger=document.querySelector(".pa-pagelet-pet-trigger");
  if(!trigger){
    console.log('PA_ACTION_RING_LAYOUT {"error":"pet-missing"}');
    return;
  }
  if(!document.querySelector(".pa-pagelet-action-ring")){
    trigger.dispatchEvent(new KeyboardEvent("keydown",{key:"ContextMenu",bubbles:true,cancelable:true}));
  }
  requestAnimationFrame(()=>requestAnimationFrame(()=>{
    const items=[...document.querySelectorAll(".pa-pagelet-action-ring-item")];
    const viewport=window.visualViewport;
    const box=viewport
      ? {left:viewport.offsetLeft,top:viewport.offsetTop,right:viewport.offsetLeft+viewport.width,bottom:viewport.offsetTop+viewport.height}
      : {left:0,top:0,right:innerWidth,bottom:innerHeight};
    const read=(el)=>{
      const r=el.getBoundingClientRect();
      const hit=document.elementFromPoint(r.left+r.width/2,r.top+r.height/2);
      return {
        text:el.textContent?.trim(),
        rect:[r.left,r.top,r.width,r.height].map((n)=>+n.toFixed(1)),
        hitSelf:hit===el||el.contains(hit),
      };
    };
    const rows=items.map(read);
    console.log("PA_ACTION_RING_LAYOUT "+JSON.stringify({
      trigger:read(trigger),
      actions:rows,
      count:rows.length,
      sameTop:rows.length===3&&rows.every((x)=>Math.abs(x.rect[1]-rows[0].rect[1])<=1),
      increasingLeft:rows.every((x,i)=>i===0||x.rect[0]>rows[i-1].rect[0]),
      nonOverlapping:rows.every((x,i)=>i===0||x.rect[0]>=rows[i-1].rect[0]+rows[i-1].rect[2]),
      min44:rows.every((x)=>x.rect[2]>=44&&x.rect[3]>=44),
      insideViewport:rows.every((x)=>x.rect[0]>=box.left&&x.rect[1]>=box.top&&x.rect[0]+x.rect[2]<=box.right&&x.rect[1]+x.rect[3]<=box.bottom),
      allHitSelf:rows.every((x)=>x.hitSelf),
    }));
  }));
})()

Require count=3, all boolean assertions true, the intended label order, and a matching visible screenshot. If gesture code did not change, stop there after fresh error capture; do not repeat movement-cancel or exactly-once checks.

Probe real Obsidian chrome before tuning plugin UI. Adjust thresholds for device and orientation:

(()=>{const q=[...document.querySelectorAll('button,.clickable-icon,.pa-pagelet-pet')].filter(e=>{const r=e.getBoundingClientRect();return r.top<130&&r.left<430&&r.width>10&&r.height>10}).map(e=>{const r=e.getBoundingClientRect(),s=getComputedStyle(e),svg=e.querySelector('svg'),p=svg&&svg.querySelector('path,line,polyline,rect,circle');return{cls:String(e.className),title:e.title,aria:e.getAttribute('aria-label'),rect:[r.x,r.y,r.width,r.height].map(n=>+n.toFixed(1)),color:s.color,svg:svg&&{rect:[svg.getBoundingClientRect().x,svg.getBoundingClientRect().y,svg.getBoundingClientRect().width,svg.getBoundingClientRect().height].map(n=>+n.toFixed(1)),viewBox:svg.getAttribute('viewBox'),w:svg.getAttribute('width'),h:svg.getAttribute('height')},path:p&&{tag:p.tagName,stroke:p.getAttribute('stroke'),sw:p.getAttribute('stroke-width'),cssStroke:getComputedStyle(p).stroke,cssSw:getComputedStyle(p).strokeWidth}}});console.log('PA_ICON_PROBE '+JSON.stringify(q))})()

Use a null-safe focused pet/system-button comparison. .sidebar-toggle-button.mod-left is an Obsidian internal class and may be absent after an app update:

(()=>{let l=document.querySelector('.sidebar-toggle-button.mod-left'),p=document.querySelector('.pa-pagelet-pet');let f=e=>{if(!e)return null;let r=e.getBoundingClientRect(),s=e.querySelector('svg'),a=s?[...s.querySelectorAll('path,rect,line,polyline,circle')]:[];return{r:[r.x,r.y,r.width,r.height].map(n=>+n.toFixed(1)),svg:s&&[s.getAttribute('viewBox'),+s.getBoundingClientRect().width.toFixed(1),+s.getBoundingClientRect().height.toFixed(1)],sw:[...new Set(a.map(x=>(x.getAttribute('stroke-width')||getComputedStyle(x).strokeWidth)))],csw:[...new Set(a.map(x=>getComputedStyle(x).strokeWidth))].slice(0,6)}};console.log('PA_MIN '+JSON.stringify({left:f(l),pet:f(p)}))})()

Pitfalls and Stop Conditions

• Measure SVG geometry and stroke width; do not infer apparent weight from screenshots alone.
• Verify asset matches and reload before treating stale iCloud behavior as a regression.
• Treat Reduce Motion as a hypothesis until verified.
• Do not generalize phone placement to iPad without separate evidence.
• Stop automated reloads if body.in-progress persists and preserve the user's manual testing path.
• Do not escalate runner refresh into plugin reload, or plugin reload into vault/App restart, without the identity evidence required above.
• Stop after the selected lane's evidence is complete; do not expand scope to improve an already sufficient proof.
• Stop before writing outside the iCloud test plugin directory or the declared runner/fixture paths, and never delete vault data.

Output

iOS real-device smoke:
- Lane: `<geometry-only/interaction/broad-release>`
- Local prerequisite: PASS/FAIL
- Reused evidence: `<same-state evidence or none>`
- Device preflight: PASS/BLOCKED
- Artifact sync/deploy: PASS/FAIL/NOT_RUN
- Artifact evidence: `<runner-only: source/destination runner hash + unchanged current plugin identity | plugin-assets: four MATCH lines>`
- Load path: `<runner re-evaluation / plugin reload / single fallback / justified process restart>`
- Loaded identity: `<runner-only: unchanged loaded SHA/version | plugin-assets: instance transition + loaded SHA/version/load timestamp>`
- iPhone observation: PASS/FAIL/BLOCKED - `<Mirroring / Inspector / user>`
- Findings:
  - PASS: `<path>` - `<observed behavior>`
  - FAIL: `<path>` - `<issue and user impact>`
  - BLOCKED: `<path>` - `<external blocker>`
- Inspector evidence: `<rects, CSS, console, DOM state>`
- Explicit skips: `<unaffected gestures, surfaces, orientations, or devices>`
- Stop point: `<sufficient evidence or retry limit reached>`
- Residual risk: `<untested paths or stale-state concern>`

Separate “deployed and asset-matched” from “observed on iPhone.” Never promote the former into a real-device PASS.

Related Skills

• Use obsidian-test-vault-smoke first at app-runtime tier or higher.
• Use available native UI tools for Safari and iPhone Mirroring UI control.
• Use obsidian-community-check only for an authorized hosted community scan.
• Use personal-assistant-review for code-level review gates.