← AnsightCONTENT HISTORY

Update to Ansight

Snapshot Sep 30, 2026 · 23:15 UTC · version 0.1.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "name": "ansight-install-cordova",
  "description": "Install @ansight/capacitor with automatic simulator or emulator registration and one-shot CLI QR enrollment for physical devices. Add and sync the Capacitor bridge, initialize native defaults, expose enrollFromQrCode from a developer-only surface, keep remote tools development-only, verify web and native builds, and inspect the app through the Ansight CLI.",
  "included_files": [],
  "skill_md_contents": "---\nname: ansight-install-cordova\ndescription: Install @ansight/capacitor with automatic simulator or emulator registration and one-shot CLI QR enrollment for physical devices. Add and sync the Capacitor bridge, initialize native defaults, expose enrollFromQrCode from a developer-only surface, keep remote tools development-only, verify web and native builds, and inspect the app through the Ansight CLI.\n---\n\n## OpenAI plugin integration\n\nRun Ansight CLI commands using the execution tools in ChatGPT Work or Codex on the machine that owns the resident host. If this environment cannot execute commands or reach that host, explain the missing prerequisite and do not claim a live inspection succeeded. A remote workspace or cloud agent does not automatically have access to the developer’s local host. Resolve relative helper paths from this skill’s directory. When this workflow references another bundled skill, read its local SKILL.md completely before following it.\n\nUse these bundled files for the canonical skill URLs referenced below; keep public URLs when writing documentation for the user’s app:\n\n- https://www.ansight.ai/skills/agents/ansight-app-inspection.md → [ansight-app-inspection](../ansight-app-inspection/SKILL.md)\n- https://www.ansight.ai/skills/cordova/ansight-app-inspection-cordova.md → [ansight-app-inspection-cordova](../ansight-app-inspection-cordova/SKILL.md)\n\n\n# Ansight Cordova / Capacitor Install Skill\n\nUse this skill for Capacitor 8 apps. Classic Apache Cordova is not currently a\ndrop-in target for `@ansight/capacitor`.\n\n## Workflow\n\n1. Inspect `package.json`, Capacitor config, web bootstrap, native projects,\n   debug guard, and existing developer menu.\n2. Install and sync:\n\n```shell\nnpm install @ansight/capacitor\nnpx cap sync\n```\n\n3. Initialize from development-only bootstrap:\n\n```ts\nif (isDevelopmentBuild) {\n  await Ansight.initializeAndActivate(\n    Ansight.createOptionsBuilder()\n      .withAnsightDefaults()\n      .withReadOnlyToolAccess()\n      .build(),\n  );\n}\n```\n\n   Replace `isDevelopmentBuild` with the app's existing explicit development\n   variant flag; do not hard-code it to `true`.\n\n4. Add a developer-only scanner action:\n\n```ts\nawait Ansight.enrollFromQrCode({\n  clientName: \"My Capacitor App\",\n});\n```\n\n5. `scanPairingQrCode(...)` is an API alias. Use `connect(payload, ...)` when\n   the app already owns a scanner.\n6. Keep DOM and native tools behind the app's local-development guard. Prefer\n   read-only DOM and native inspection; leave actions, reflection, secure\n   storage, writes, and deletes off unless required.\n7. Android requires no app camera permission for the SDK scanner. On iOS, add\n   `NSCameraUsageDescription` and `NSLocalNetworkUsageDescription`. Add no ATS\n   exception or unrelated permissions.\n8. Create or update `ansight-readme.md` with the scanner location, selected\n   tools, build checks, and CLI enrollment commands. Do not include an enrollment payload.\n9. Run package checks, `npx cap sync`, and practical native debug builds.\n10. Start or reuse the resident CLI host. A simulator or emulator registers\n    automatically. For a physical device, issue one generic host QR and scan it\n    from the developer-only surface:\n\n```sh\nansight host run\nansight pairing issue --qr\nansight session list --connected --app-id <app-id> --json\nansight app tools <session-id> --detail summary --include-unavailable --max-results 50 --json\n```\n\n    Do not require `ansight app register` before the first connection. After\n    the SDK supplies its real App ID, optionally link the discovered app to the\n    repository with `ansight app register <app-id> --codebase <repository-path>`.\n\nSimulator and emulator builds register automatically through native loopback.\nThe first physical-device scan registers the native app installation. Its random installation\nid and enrollment state remain in app-private storage, so later developer\nlaunches reconnect automatically.\n\n## Recommended Inspection Skills\n\nUse the main router to select the core inspection workflow. Add the Capacitor\ncompanion only when DOM, bridge, or native-platform semantics are material:\n\n```text\nhttps://www.ansight.ai/skills/agents/ansight-app-inspection.md\nhttps://www.ansight.ai/skills/cordova/ansight-app-inspection-cordova.md\n```\n"
}

SHA-256: d90df88d4030563a776eb639dd7c13f86d0d50aa706e2ba2713ea85ce511cb3e