# Login Reachability Probe Package

Date: 2026-07-12

## Business purpose

This package turns the login validation schema into an operator-runnable package for the 2026-07-13 logged-in environment.

It is for B-route evidence collection. It does not enable production send.

## Generated artifacts

- Package script: `scripts/package-login-reachability-probe.ps1`
- Verification script: `scripts/verify-login-reachability-probe-package.ps1`
- Package directory: `runs/login-reachability-probe-package`
- Package zip: `runs/login-reachability-probe-package.zip`
- Downloads copy: `C:\Users\zhaoy\Downloads\login-reachability-probe-package-20260712-125451.zip`

## What the package contains

- `recorder/ISphereLiveProbeRecorder.exe`
- `tools/isphere-capability-smoke.exe`
- `LOGIN-REACHABILITY-INPUTS.template.json`
- `LOGIN-REACHABILITY-INPUTS.schema.json`
- `CREATE-RETURN-ZIP.ps1`
- `RUN-LOGIN-REACHABILITY-SUITE.bat`
- numbered operator steps:
  - `00-prepare-inputs.bat`
  - `01-run-before-recorder.bat`
  - `02-run-after-text-recorder.bat`
  - `03-run-after-file-recorder.bat`
  - `04-create-return-zip.bat`
- copied reference docs:
  - `docs/login-reachability-validation-items.md`
  - `docs/send-upload-deep-dive.md`

## Operator flow

1. Run only on a machine where iSphere/IMPlatformClient is visibly logged in.
2. Fill `LOGIN-REACHABILITY-INPUTS.json` from the template.
3. Run before-recorder.
4. If text test is enabled, manually send exactly one text message in the official client, then run after-text-recorder.
5. If file test is enabled, manually send exactly one safe small file in the official client, then run after-file-recorder.
6. Run `CREATE-RETURN-ZIP.ps1` or `04-create-return-zip.bat`.
7. Return `isphere-login-reachability-return-*.zip`.

## Required returned schema

The return script writes `LOGIN-REACHABILITY-OUTPUT.json` with these top-level sections:

- `run`
- `targets`
- `runtime`
- `reachability`
- `server_auth`
- `snapshots`
- `attempts`
- `failures`
- `correlation`

## Safety and route status

- `NO_AUTOMATIC_SEND=true`: the package does not send text or files automatically.
- `production_send_enabled=false`
- `production_file_send_enabled=false`
- A-route/RPA remains `backup_only`.
- B-route remains blocked until returned evidence proves logged-in reachability and sent-record/ack correlation.

## Verification

Fresh verification command:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\verify-login-reachability-probe-package.ps1
```

Verified result:

```json
{
  "ok": true,
  "required_file_count": 21,
  "synthetic_return_verified": true,
  "online_login_required": true,
  "no_automatic_send": true,
  "production_send_enabled": false,
  "production_file_send_enabled": false
}
```

## Next decision after returned zip

- If text evidence includes one-shot target, before/after sent-record source, content hash, and ack/ref correlation, move text B-route from contract/probe toward production connector design.
- If file evidence includes FileUploadPara/server/auth data, IFileTransfer reachability, FileUploadResult/FileID or structured failure, and file sent-record/ack correlation, move file B-route to upload connector design.
- If reachability fails with structured reasons, continue offline reverse against the failed step.