Sync upstream Silo (silo-android) into Prairie Android

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,154 @@
+name: Bug report
+description: Report something broken in the Android phone or TV app
+title: "[bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Report behavior you reproduced yourself. Keep what you observed separate from any theory about the cause. Redact credentials, tokens, personal data, server addresses, and private media details, and mark each redaction.
+
+        [Reporting a problem](https://prairieserver.org/docs/report-a-problem) explains where to find versions, stats, and diagnostics. Using Claude Code or Codex? The [Prairie troubleshooting skill](https://github.com/Prairie-Server/prairie-troubleshooting-skill) helps you collect the details and drafts this report, then has independent reviewers check it before you post. Problems that also happen in the web app usually come from the server and belong in [prairie-server](https://github.com/Prairie-Server/prairie-server/issues/new/choose). Problems in the Apple apps belong in [silo-apple](https://github.com/Prairie-Server/silo-apple/issues/new/choose).
+
+        Fabricated or AI-hallucinated reports are an immediate block. Read [CONTRIBUTING.md](https://github.com/Prairie-Server/prairie-android/blob/main/CONTRIBUTING.md) first.
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened
+      description: What did you actually observe? Include how often it happens (for example "3 of 3 attempts") and what still works, such as the same item in the web app.
+    validations:
+      required: true
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to reproduce
+      description: Exact steps you ran, from a stated starting point.
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected behavior
+      description: What should have happened, and where that expectation comes from.
+    validations:
+      required: true
+  - type: dropdown
+    id: device-type
+    attributes:
+      label: Device
+      multiple: true
+      options:
+        - "Phone"
+        - "Tablet"
+        - "Android TV / Google TV"
+        - "Other"
+    validations:
+      required: true
+  - type: input
+    id: device-details
+    attributes:
+      label: Device model and OS version
+      placeholder: NVIDIA SHIELD TV Pro, Android TV 11
+    validations:
+      required: true
+  - type: input
+    id: app-version
+    attributes:
+      label: App version and build
+      description: "**Settings > About > Version** on phones and tablets, or **Settings > Server > About > App Version** on TVs."
+      placeholder: "0.3.11 (5)"
+    validations:
+      required: true
+  - type: dropdown
+    id: install-source
+    attributes:
+      label: Installed from
+      options:
+        - "Google Play"
+        - "APK from GitHub Releases"
+        - "Built from source"
+        - "Other"
+    validations:
+      required: true
+  - type: input
+    id: server-version
+    attributes:
+      label: Prairie server version
+      description: The **Build** value at the bottom of the server's admin sidebar, for example `412 · 1a2b3c4d`. Ask your server admin if that is not you.
+    validations:
+      required: true
+  - type: textarea
+    id: playback-details
+    attributes:
+      label: Playback details
+      description: "For playback problems. On phones, **Playback settings** > **Playback stats**. On TVs, the **Stats** tab; the **Audio** tab shows whether audio is passed through or decoded to PCM. Include the delivery or route, container, video, audio, and dynamic range, plus the subtitle format and your audio setup (TV speakers, soundbar, receiver)."
+  - type: input
+    id: diagnostics-reference
+    attributes:
+      label: Diagnostics report reference
+      description: "In the app, open **Settings > Support > Diagnostics** (TV: **Settings > Diagnostics**), send to **Prairie Diagnostics**, and choose **Copy reference ID**. **Start Diagnostic Capture** records while you reproduce the problem."
+      placeholder: PRAIRIE-XXXXXXXX
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots or recording
+      description: Optional. Drag files here. Crop or blur server addresses, account names, and anything else private first.
+  - type: textarea
+    id: relevant-logs
+    attributes:
+      label: Relevant server logs
+      description: Optional. Raw lines from the server's **Admin > Logs**, filtered by playback session when you can.
+      render: shell
+  - type: textarea
+    id: technical-notes
+    attributes:
+      label: Technical notes
+      description: Optional suspected root cause or related observations. Keep this separate from what you observed above.
+  - type: input
+    id: ai-harness
+    attributes:
+      label: AI harness
+      description: Enter the exact agent harness or application, or "none".
+    validations:
+      required: true
+  - type: input
+    id: ai-tools
+    attributes:
+      label: AI tool(s)
+      description: Enter the exact tool name(s), or "none".
+    validations:
+      required: true
+  - type: input
+    id: ai-models
+    attributes:
+      label: AI model(s)
+      description: Enter the exact model identifier(s) reported by each tool, or "n/a".
+    validations:
+      required: true
+  - type: dropdown
+    id: ai-involvement
+    attributes:
+      label: AI involvement
+      options:
+        - No AI used
+        - Human-written, AI-reviewed
+        - AI-assisted
+        - Fully AI-generated, human verified
+    validations:
+      required: true
+  - type: textarea
+    id: ai-review
+    attributes:
+      label: Independent or adversarial review
+      description: Summarize the scope, method, findings, and resolutions, or enter "n/a" when this issue does not require independent or adversarial review.
+    validations:
+      required: true
+  - type: checkboxes
+    id: confirmations
+    attributes:
+      label: Confirmations
+      options:
+        - label: I searched open and recently closed issues and pull requests, and this is not already reported
+          required: true
+        - label: I reproduced this myself on the device and app version above
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,20 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Problem with the server or web app
+    url: https://github.com/Prairie-Server/prairie-server/issues/new/choose
+    about: Report it in prairie-server, especially if it also happens in the web app.
+  - name: Problem in the iOS, tvOS, or macOS app
+    url: https://github.com/Prairie-Server/silo-apple/issues/new/choose
+    about: Report it in silo-apple.
+  - name: Questions and setup help
+    url: https://discord.gg/prairieserver
+    about: Ask how to set up or use Prairie in the Prairie Discord.
+  - name: Report a security vulnerability
+    url: https://github.com/Prairie-Server/prairie-android/security/advisories/new
+    about: Report it privately. Do not open a public issue.
+  - name: How to report a problem
+    url: https://prairieserver.org/docs/report-a-problem
+    about: Where to find versions, player stats, and diagnostics, and what to include.
+  - name: Troubleshoot with an AI agent
+    url: https://github.com/Prairie-Server/prairie-troubleshooting-skill
+    about: Use Claude Code or Codex to collect the details and draft a reviewed report.

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,97 @@
+name: Feature request
+description: Suggest an improvement to the Android phone or TV app
+title: "[feature] "
+labels: ["enhancement", "feature-request"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        A request is most useful when it explains the problem you hit, with a concrete example, rather than prescribing a solution. One request per issue. Requests that need new server behavior belong in [prairie-server](https://github.com/Prairie-Server/prairie-server/issues/new/choose).
+
+        Prairie will not accept Live TV, OTA/DVB tuners, IPTV, EPG/XMLTV guides, DVR, or `.strm` remote-stream files; [Project non-goals](https://github.com/Prairie-Server/prairie-server/blob/main/docs/non-goals.md) explains why.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What you are trying to do, and what stops you today. Give a concrete example.
+    validations:
+      required: true
+  - type: dropdown
+    id: device-type
+    attributes:
+      label: Device
+      multiple: true
+      options:
+        - "Phone"
+        - "Tablet"
+        - "Android TV / Google TV"
+        - "Other"
+    validations:
+      required: true
+  - type: textarea
+    id: current-workaround
+    attributes:
+      label: Current workaround
+      description: What you do instead today, or "none".
+    validations:
+      required: true
+  - type: textarea
+    id: proposed-behavior
+    attributes:
+      label: Proposed behavior
+      description: What you would like the app to do. Describe the outcome, not an implementation.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches, including other apps, and why they fall short.
+  - type: input
+    id: ai-harness
+    attributes:
+      label: AI harness
+      description: Enter the exact agent harness or application, or "none".
+    validations:
+      required: true
+  - type: input
+    id: ai-tools
+    attributes:
+      label: AI tool(s)
+      description: Enter the exact tool name(s), or "none".
+    validations:
+      required: true
+  - type: input
+    id: ai-models
+    attributes:
+      label: AI model(s)
+      description: Enter the exact model identifier(s) reported by each tool, or "n/a".
+    validations:
+      required: true
+  - type: dropdown
+    id: ai-involvement
+    attributes:
+      label: AI involvement
+      options:
+        - No AI used
+        - Human-written, AI-reviewed
+        - AI-assisted
+        - Fully AI-generated, human verified
+    validations:
+      required: true
+  - type: textarea
+    id: ai-review
+    attributes:
+      label: Independent or adversarial review
+      description: Summarize the scope, method, findings, and resolutions, or enter "n/a" when this issue does not require independent or adversarial review.
+    validations:
+      required: true
+  - type: checkboxes
+    id: confirmations
+    attributes:
+      label: Confirmations
+      options:
+        - label: I searched open and closed issues, including ones closed as not planned, and this is not already requested
+          required: true
+        - label: This is not one of Prairie's non-goals
+          required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,71 @@
+<!-- Follow CONTRIBUTING.md: plain summary first, no restated diff, no working history. -->
+
+## Problem
+
+Closes #NNN
+<!-- One "Closes #NNN" line per issue this change fully resolves, so GitHub closes it
+when the PR merges into main. Use "Closes Prairie-Server/<repo>#NNN" for an issue in
+another repository. Delete the line when the PR only partly addresses an issue. -->
+Related issue: #NNN
+<!-- An epic, sub-issue, or partly addressed issue this work serves and that should
+stay open, or "N/A". An open issue is not required — the Problem section below must
+stand on its own. -->
+Validation tasks: #NNN C1
+<!-- Until 1.0 ships: v1.0 board tasks and cases this change unblocks or changes,
+e.g. "unblocks #1144 C3; changes #1200 C1". Write "none" when no validation task is
+affected. -->
+
+A short plain-language summary: what goes wrong, who it affects, and what this
+change does about it. Details come after.
+
+## Approach
+
+What changed and why this way, and which surfaces and repositories it affects.
+Mention an alternative only if a reviewer would ask about it. Do not walk through
+the diff.
+
+## Validation
+
+One line per kind of check and its result; do not list tests by name. Name required
+checks that were not run or did not pass. Include a short output excerpt only when it
+explains a failure.
+<!-- Do not include private domains, hostnames, IPs, Tailscale or Report Shelf URLs,
+local paths, credentials, personal data, or private media details. -->
+
+## Evidence
+
+| Before | After |
+| ------ | ----- |
+| | |
+
+Surface and build:
+<!-- Required when this change alters what a user sees: UI, or which items or what
+item details a screen shows, such as search results, home sections, recommendations,
+metadata, artwork, sorting, or filtering. See "Show visible changes" in
+CONTRIBUTING.md. Use before-and-after screenshots of the same screen and data for each
+affected surface, and a short recording when motion, timing, or focus matters. Crop or
+blur private details in anything attached here. To keep captures private instead,
+publish them to evidence.prairieserver.org, where only you and Prairie maintainers can open
+them, and replace the table with
+`Evidence: https://evidence.prairieserver.org/r/prairie-android/pr-<number>/`. When nothing
+visible changes, replace this section's content with "Evidence: none, no user-visible
+change". -->
+
+## Risks
+
+Migration, compatibility, security, operational, or release impact, or "None
+identified".
+
+## Checklist
+
+- [ ] I read and can explain the complete diff.
+- [ ] This pull request addresses one concern.
+- [ ] The Evidence section shows every change a user can see, or says there is none.
+
+## AI Disclosure
+
+- Harness: exact agent harness or application, or "none"
+- Tool(s): exact tool name(s), or "none"
+- Model(s): exact model identifier(s) reported by each tool, or "n/a"
+- Involvement: Fully AI-generated, human verified | AI-assisted | Human-written, AI-reviewed | No AI used
+- Adversarial review: scope, method, findings, and resolutions, or "n/a" when this change does not require independent or adversarial review

.github/evidence.yml

@@ -0,0 +1,8 @@
+# Pull requests that change the phone app, the TV app, or the Android code they share
+# need evidence before the Evidence check passes. The check reads this file at a pull
+# request's base commit. Maintainers override it with the evidence-required and
+# evidence-not-needed labels. See "Show visible changes" in CONTRIBUTING.md.
+require:
+  - androidApp/src/androidMain/**
+  - androidTvApp/src/androidMain/**
+  - android-shared/src/androidMain/**