Kanbn4droid/docs/superpowers/plans/2026-03-18-settings-view-implementation-handoff.md

Settings View Implementation Handoff (2026-03-18)

Task 9 Outcome (Required vs Actual)

Required final quality gate scope:

1. Run verification suite:
   • ./gradlew :app:test
   • ./gradlew :app:assembleDebug
   • ./gradlew :app:lintDebug
2. Check short git status (git status --short).
3. Produce handoff note with evidence and deferred items.

Actual outcome:

• Succeeded: :app:test and :app:assembleDebug completed with BUILD SUCCESSFUL.
• Failed (blocking): :app:lintDebug completed with BUILD FAILED due to 3 lint errors.
• Succeeded: short status captured (?? .kotlin/).
• Succeeded: handoff note written in this worktree and committed.

Reproducibility Anchors

• Run context: local CLI run in worktree /home/micost/Documentos/Repos/Kanbn4Droid/.worktrees/settings-side-panel.
• Run date: 2026-03-18.
• Commands executed exactly:
  • ./gradlew :app:test
  • ./gradlew :app:assembleDebug
  • ./gradlew :app:lintDebug
  • git status --short
• Output source: all evidence in this note comes from those local command outputs in this same worktree.

Verification Evidence Summary

• ./gradlew :app:test -> PASS (BUILD SUCCESSFUL), including :app:testDebugUnitTest and :app:testReleaseUnitTest.
• ./gradlew :app:assembleDebug -> PASS (BUILD SUCCESSFUL), :app:assembleDebug up-to-date.
• ./gradlew :app:lintDebug -> FAIL (BUILD FAILED), reported 3 errors, 89 warnings.
• git status --short -> ?? .kotlin/.

Lint Blocking Errors (All 3)

1. app/src/main/java/space/hackenslacker/kanbn4droid/app/settings/SettingsPreferencesFragment.kt:25

   • Error: RestrictedApi (Preference.performClick() call on KEY_BASE_URL).
   • Remediation hint: avoid direct performClick(); trigger editable preference flow through supported public APIs (for example direct navigation/focus flow or extracting edit logic into app-owned method).

2. app/src/main/java/space/hackenslacker/kanbn4droid/app/settings/SettingsPreferencesFragment.kt:26

   • Error: RestrictedApi (Preference.performClick() call on KEY_API_KEY).
   • Remediation hint: same fix strategy as above; remove restricted API calls and replace with app-side explicit edit action.

3. app/src/main/res/layout/item_card_activity_timeline.xml:27

   • Error: UseAppTint (android:tint used).
   • Remediation hint: replace android:tint with app:tint and ensure xmlns:app is declared on the root element.

Deferred Items with Exit Criteria

1. Clear lint blocking errors.

   • Exit criteria:
     • ./gradlew :app:lintDebug exits 0.
     • lint report shows 0 errors.
   • Suggested next commands:
     • ./gradlew :app:lintDebug
     • ./gradlew :app:test
     • ./gradlew :app:assembleDebug

2. Resolve .kotlin/ untracked handling policy.

   • Recommendation: keep .kotlin/ out of version control and add/confirm ignore coverage in repo-level .gitignore for deterministic clean status.
   • Exit criteria:
     • git status --short no longer reports .kotlin/ after a fresh local build/test run.
     • .kotlin/ is not tracked in commits.
   • Suggested next commands:
     • git status --short
     • git check-ignore -v .kotlin/