Skip to content

v2: Make Photos a PhotoKit-first evidence-backed provider #94

Description

@jmcte

Problem / intent

photos list currently walks files inside the Photos library package; it cannot reliably represent logical assets, albums, favorites, cloud availability, or stable Photos identifiers. OpenClaw's photoscrawl demonstrates a PhotoKit-first, read-only archive with evidence/provenance and no implicit iCloud downloads.

Acceptance criteria

  • Use PhotoKit as the primary logical asset source with explicit authorization status.
  • Preserve current read-only commands while returning real asset ids, media type, dates, dimensions, favorite/hidden state, album membership, and local/cloud availability where public APIs expose them.
  • Do not export pixels or trigger iCloud downloads by default.
  • Classify filesystem/private-store fallback output as degraded and preserve source provenance.
  • Separate source facts from any later derived OCR/classification observations.
  • Add synthetic/provider-boundary tests and a privacy-preserving live smoke path.
  • Document unsupported fields and macOS-version behavior.

Dependencies

Metadata

Metadata

Assignees

Labels

area:dataData, schema, storage, privacy, or migration surface.area:securitySecurity, auth, secret, permission, or policy surface.autonomy:review-gatedClass 2; autonomous work allowed, review/gate required.kind:featureFeature/product behavior work.lane:hermesHermes macOS/native lane.review:architectureNeeds architecture review.review:securityNeeds security review.risk:domainDomain correctness risk requiring subject-matter review.state:needs-reviewPR needs review.

Type

No type

Fields

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