Skip to content

Roadmap: diagnostic-bundle export from apw doctor #56

@jmcte

Description

@jmcte

Context

apw doctor and apw doctor --json (issue #27 expanded the CI environment diagnostics) report structured health for the broker, app install, AASA reachability, fallback providers, and CI environment. Today operators triaging an issue have to copy-paste each output stream individually.

A single apw doctor --bundle <path> (or --export) that gathers the JSON diagnostics, broker logs (subject to ~/.apw perms), bundle metadata, and signature info into a redacted tarball would dramatically shorten support cycles.

Proposed Fix

  • Add apw doctor --bundle <path> that writes a tar/zip with: doctor.json, sanitized ~/.apw/native-app/ metadata, bundle codesign info, OS/Xcode versions.
  • Redact secret material aggressively — no env vars, no token-like strings, no AASA payloads beyond domain names.
  • Document expected contents in docs/SECURITY_POSTURE_AND_TESTING.md so operators know what they're sharing.

Acceptance criteria

  • apw doctor --bundle <path> produces a deterministic archive layout.
  • Redaction tested with a fixture that includes plausible secrets — none survive.
  • Bundle layout and redaction guarantees documented.
  • Bundle creation is idempotent and fails closed if redaction would be incomplete.

Metadata

Metadata

Assignees

Labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions