Feature/sync multipart v012

.github/workflows/checks.yml

@@ -0,0 +1,58 @@
+name: Quality Checks
+
+on:
+  push:
+    branches:
+      - main
+      - feature/**
+      - enhancement/**
+      - fix/**
+      - chore/**
+      - claude/**
+      - codex/**
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true'
+
+concurrency:
+  group: checks-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  verify:
+    if: >-
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'pull_request' ||
+      github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v5
+
+      - name: Setup JDK 17
+        uses: actions/setup-java@v5
+        with:
+          distribution: temurin
+          java-version: 17
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v5
+
+      - name: Setup Android SDK
+        uses: android-actions/setup-android@v3
+
+      - name: Grant execute permission for gradlew
+        run: chmod +x gradlew
+
+      - name: Assemble Debug Variants
+        run: ./gradlew :app:assembleDebugAll
+
+      - name: Run Lint
+        run: ./gradlew :app:lintDebugAll
+
+      - name: Run Tests
+        run: ./gradlew :app:testDebugUnitTestAll

.github/workflows/dev-release.yml → .github/workflows/snapshot.yml

@@ -1,82 +1,126 @@
-name: Build Snapshot Release
+name: Snapshot Build
 
 on:
   push:
-    branches: [develop]
+    branches:
+      - main
+      - feature/**
+      - enhancement/**
+      - fix/**
+      - chore/**
+      - claude/**
+      - codex/**
+  pull_request:
+    branches: [main]
   workflow_dispatch:
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true'
 
+concurrency:
+  group: snapshot-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
 jobs:
-  build:
+  build-snapshot:
+    if: >-
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'pull_request' ||
+      github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     permissions:
-      contents: write
+      contents: read
     steps:
-      - uses: actions/checkout@v5
+      - name: Checkout Code
+        uses: actions/checkout@v5
+
       - name: Setup JDK 17
         uses: actions/setup-java@v5
         with:
           distribution: temurin
           java-version: 17
+
       - name: Setup Gradle
         uses: gradle/actions/setup-gradle@v5
+
       - name: Setup Android SDK
         uses: android-actions/setup-android@v3
+
+      - name: Grant execute permission for gradlew
+        run: chmod +x gradlew
+
       - name: Decode Keystore
         run: |
           echo "${{ secrets.SIGNING_KEY }}" | base64 --decode > ${{ github.workspace }}/keystore.jks
-      - name: Set Env Vars
+
+      - name: Set Version Vars
         id: set_env
         run: |
           echo "TIMESTAMP=$(date +%Y%m%dT%H%M%S)" >> "$GITHUB_OUTPUT"
           echo "COMMIT_SHA=$(git rev-parse --short HEAD)" >> "$GITHUB_OUTPUT"
-      - name: Build apk with Gradle
+
+      - name: Build Snapshot Release APK
         run: ./gradlew assembleGithubSnapshotRelease
         env: 
           SNAPSHOT_VERSION_NAME: ${{ steps.set_env.outputs.TIMESTAMP }}-${{ steps.set_env.outputs.COMMIT_SHA }}
           KEY_ALIAS: ${{ secrets.ALIAS }}
           KEYSTORE_PASSWORD: ${{ secrets.KEY_STORE_PASSWORD }}
           KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }}
           KEYSTORE: ${{ github.workspace }}/keystore.jks
+
       - name: Create Checksum
         id: create_checksum
         run: |
           FILENAME=$(echo app/build/outputs/apk/githubSnapshot/release/*.apk)
           sha256sum $FILENAME > checksums.txt
           echo "ARTIFACT_FILENAME=$FILENAME" >> "$GITHUB_OUTPUT"
-      - name: Create or update develop-snapshot
+
+      # Every run produces a tester-downloadable snapshot artifact.
+      - name: Upload Snapshot Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: tester-snapshot-release
+          path: |
+            ${{ steps.create_checksum.outputs.ARTIFACT_FILENAME }}
+            checksums.txt
+          retention-days: 7
+
+  publish-latest-snapshot:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: build-snapshot
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Download Snapshot Artifact
+        uses: actions/download-artifact@v5
+        with:
+          name: tester-snapshot-release
+          path: ./artifacts
+
+      - name: Update Latest Snapshot Release
         uses: joutvhu/create-tag@v1
         with:
-          tag_name: develop-snapshot
+          tag_name: latest-snapshot
           tag_sha: ${{ github.sha }}
-          message: develop-snapshot
+          message: latest-snapshot
           on_tag_exists: update
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - name: Create release
+
+      - name: Publish to GitHub Releases
         uses: ncipollo/release-action@v1.16.0
         with:
           allowUpdates: true
           prerelease: true
-          name: MyDeck Snapshot Build
+          name: MyDeck Continuous Snapshot
           body: |
-            This release represents a snapshot build from the `develop` branch. It is **not intended for production use** and may contain unstable features, bugs, or incomplete functionality. This build is released to allow for early testing of the latest changes.
+            This is an automated snapshot build from the `main` branch. It is a **Release-optimized** build but uses a separate package ID so it can be installed alongside your production version.
 
-            This build includes all commits merged into the `develop` branch up to ${{ github.sha }}.
-
-            **Thanks for testing!**
+            **Last updated from:** ${{ github.sha }}
           commit: ${{ github.sha }}
-          tag: develop-snapshot
+          tag: latest-snapshot
           removeArtifacts: true
           omitDraftDuringUpdate: true
-          artifacts: "${{ steps.create_checksum.outputs.ARTIFACT_FILENAME }},checksums.txt"
+          artifacts: "./artifacts/*.apk,./artifacts/checksums.txt"
           token: ${{ secrets.GITHUB_TOKEN }}
-      - name: Archive APK
-        uses: actions/upload-artifact@v6
-        with:
-          name: dev-release
-          path: |
-            ${{ steps.create_checksum.outputs.ARTIFACT_FILENAME }}
-            checksums.txt

.gitignore

@@ -14,6 +14,7 @@ local.properties
 .attach_pid*
 app/backup-icons/
 .vscode/
+.claude/
 
 # Ignore transient files
 
@@ -34,3 +35,5 @@ Thumbs.db
 
 screenshots/
 app/githubRelease/
+
+_notes/

CLAUDE.md

@@ -2,9 +2,14 @@
 
 This document provides guidelines for AI-assisted development on the MyDeck Android project.
 
-## Usage Efficiency
-
-**Do not run tasks in parallel.** Always execute steps sequentially, one at a time. Usage efficiency is more important than speed — do not use background agents, parallel tool calls, or concurrent subagents to accelerate work.
+## Usage Efficiency & Token Conservation
+
+**Strict Anti-Bloat Protocol:**
+1. **Sequential Only:** Never run tasks in parallel. Execute steps one at a time.
+2. **Scout Before Reading:** Before reading a file, use `grep` or `ls -R` to confirm it contains relevant logic.
+3. **File Size Limit:** Do not `cat` or read any file over 30KB without explicit permission. Summarize large files using `grep` or `sed` to extract only relevant functions.
+4. **Research Mode Constraint:** In "Plan" or "Research" mode, do not read more than 3 files per turn. Present a summary of findings after every 3 files and wait for user direction.
+5. **Memory Management:** If a session involves reading more than 10 files, recommend a "Summary & Reset" where you provide a concise report of findings and ask the user to start a fresh chat to clear the context.
 
 ## Localization Requirements