hoangsonww/Diffuse-Native-Apps

screenshots

Regenerate docs/screenshots from the live apps. Use when UI changed and README/docs images are stale, or the user asks for new screenshots.

native-apps

Change Mac, iOS, iPad, or Watch UI that sits on DiffuseUI. Use when a screen, widget, complication, or menu-bar extra is involved.

coverage

Generate first-party Swift package coverage (llvm-cov HTML, lcov, text summary). Use when the user asks for coverage, after expanding Tests/, or before claiming test work is done.

add-capability

Add something Diffuse can observe on a device (typed capability, collector, registry line, and tests). Use when the user wants a new collector, observable, or capability ID.

capture-cli

Change or debug the diffuse-dev CLI (capture, inspect, diff, validate, fixtures, privacy). Use when adding a command or the CLI disagrees with the apps.

commit

Split and describe a git commit for Diffuse. Use when the user asks to commit, or when a change should be multiple commits.

crosscheck

Type-check shared packages against the iOS and watchOS SDKs. Use after editing core packages, before verify, or when CI crosscheck fails.

debug-collector

Diagnose a collector that hangs, throws, records a placeholder, or produces noisy diffs. Use when a section is failed, timed out, permission-required, or a live capture is unstable.

diff-engine

Change comparison rules, severity, identity matching, or change correlation. Use when diffs look wrong, a capability needs a new ComparisonRule, or clustering/timeline is involved.

export

Change Markdown/plain-text reports or redacted snapshot/diff export. Use when Copy as Markdown, CLI output, or GitHub-issue paste is wrong.

fixtures

Regenerate golden snapshot and expected-diff fixtures after a collector schema or fixture-generator change. Use when integration tests fail on Fixtures/ or after changing snapshot encoding.

format

Format Swift with the repo SwiftFormat config. Use after editing .swift files, before verify, or when CI format job fails.

privacy

Classify collected fields, apply export redaction, and keep the generated privacy ledger truthful. Use when adding properties, changing RedactionPolicy, or touching export/privacy UI.

release

Cut an unsigned GitHub release of the four apps. Use when the user asks to release, tag, or ship artifacts.

retention

Change how old snapshots are pruned (age, count, size, pinned/labelled protection). Use when the library grows without bound or a named snapshot disappeared.

review-change

Review a Diffuse diff against architecture, privacy, fixtures, dependencies, and CI constraints. Use after a non-trivial edit or when the user asks for a review.

scheduler

Change automatic capture cadence, the 15-minute floor, or system-event triggers. Use when snapshots fire too often, not at all, or nextCaptureDate is wrong.

search

Change library search or comparison-screen change filtering. Use when SearchIndex ranking, limits, or ChangeSearchIndex behaviour is wrong.

storage

Change the snapshot store, SnapshotQuery, index rebuild, or on-disk layout. Use when save/load, paging, corrupt files, or FileSnapshotStore behaviour is involved.

verify

Run Diffuse's health check (format, tests, SDK cross-check, unsigned app builds). Use before claiming a change is done, after touching Packages, Apps, Tools, or Tests, or when the user asks if the checkout is healthy.

write-tests

Add Swift Testing coverage in Tests/Domain, Tests/Invariants, Tests/Integration, or package-local suites. Use when adding behaviour, reproducing a bug, or the user asks for more tests.