android-skills 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +130 -2
  3. package/android-ui-minimal/SKILL.md +98 -0
  4. package/android-ui-minimal/references/anti-slop-checklist.md +61 -0
  5. package/android-ui-minimal/references/clarifying-questions.md +55 -0
  6. package/android-ui-minimal/references/color-and-contrast.md +104 -0
  7. package/android-ui-minimal/references/compose-patterns.md +120 -0
  8. package/android-ui-minimal/references/reconstruction-workflow.md +74 -0
  9. package/android-ui-minimal/references/typography-spacing.md +93 -0
  10. package/android-ui-minimal/scripts/contrast.py +68 -0
  11. package/android-ui-minimal/scripts/gen_tokens.py +165 -0
  12. package/android-ui-minimal/scripts/lint_ui.py +189 -0
  13. package/android-ui-security-review/SKILL.md +93 -0
  14. package/android-ui-security-review/references/checklist.md +95 -0
  15. package/android-ui-security-review/references/components-intents.md +74 -0
  16. package/android-ui-security-review/references/compose-risks.md +86 -0
  17. package/android-ui-security-review/references/input-and-state.md +77 -0
  18. package/android-ui-security-review/references/network-storage.md +87 -0
  19. package/android-ui-security-review/references/report-template.md +71 -0
  20. package/android-ui-security-review/references/sensitive-data-ui.md +73 -0
  21. package/android-ui-security-review/references/webview.md +105 -0
  22. package/android-ui-security-review/scripts/scan.py +411 -0
  23. package/bin/android-skills.js +47 -0
  24. package/install.py +337 -0
  25. package/opencode/commands/ui-minimal.md +9 -0
  26. package/opencode/commands/ui-security.md +9 -0
  27. package/package.json +43 -4
@@ -0,0 +1,411 @@
1
+ #!/usr/bin/env python3
2
+ """Pemindai statis risiko keamanan frontend Android (Kotlin, Java, XML, Manifest).
3
+
4
+ Ini pemindai berbasis pola, bukan analisis aliran data. Setiap temuan harus
5
+ diverifikasi manual. ID aturan sama dengan references/checklist.md.
6
+
7
+ Pemakaian:
8
+ python3 scan.py <path> [--format text|md|json] [--out FILE]
9
+ [--min-severity info|low|medium|high|critical]
10
+ [--fail-on high] [--include-tests]
11
+
12
+ Tekan temuan dengan komentar (alasan wajib): // sec-ignore: RULE_ID alasan
13
+ (di AndroidManifest.xml: <!-- sec-ignore: RULE_ID alasan -->, tepat di atas elemen)
14
+ Kode keluar: 1 jika ada temuan >= --fail-on, selain itu 0.
15
+ """
16
+ import argparse
17
+ import json
18
+ import os
19
+ import re
20
+ import sys
21
+ import xml.etree.ElementTree as ET
22
+ from collections import Counter
23
+
24
+ SEV = ["info", "low", "medium", "high", "critical"]
25
+ SKIP_DIRS = {"build", ".git", ".gradle", ".idea", ".cxx", "node_modules", "generated"}
26
+ TEST_DIRS = {"test", "androidTest", "testDebug", "sharedTest"}
27
+ CODE_EXT = (".kt", ".java", ".kts", ".gradle")
28
+ ANDROID_NS = "{http://schemas.android.com/apk/res/android}"
29
+ IGNORE = re.compile(r"sec-ignore:\s*([A-Z0-9-]+)")
30
+ SENS = r"(password|passwd|token|secret|otp|\bpin\b|cvv|api[_-]?key)"
31
+
32
+
33
+ class Rule:
34
+ def __init__(self, rid, sev, title, pat, advice, kinds="code", neg=None, need=None,
35
+ window=0, conf="medium", flags=0):
36
+ self.rid, self.sev, self.title, self.advice = rid, sev, title, advice
37
+ self.kinds, self.conf, self.window = kinds, conf, window
38
+ self.pat = re.compile(pat, flags)
39
+ self.neg = re.compile(neg, flags) if neg else None
40
+ self.need = re.compile(need, flags) if need else None
41
+
42
+
43
+ I = re.I
44
+ RULES = [
45
+ # WebView
46
+ Rule("W-JS", "medium", "JavaScript aktif di WebView",
47
+ r"setJavaScriptEnabled\(\s*true\s*\)|javaScriptEnabled\s*=\s*true",
48
+ "Aktifkan hanya jika perlu dan hanya untuk konten tepercaya. Batasi origin yang dimuat."),
49
+ Rule("W-INTERFACE", "high", "addJavascriptInterface",
50
+ r"addJavascriptInterface\(",
51
+ "Hanya untuk konten lokal tepercaya. Beri @JavascriptInterface pada metode minimal, atau pakai WebMessageListener dengan allowedOriginRules."),
52
+ Rule("W-FILE", "high", "Akses file WebView terlalu longgar",
53
+ r"(setAllowUniversalAccessFromFileURLs|setAllowFileAccessFromFileURLs)\(\s*true|allow(UniversalAccessFromFileURLs|FileAccessFromFileURLs)\s*=\s*true",
54
+ "Nonaktifkan. Muat aset lokal lewat WebViewAssetLoader."),
55
+ Rule("W-FILE2", "medium", "allowFileAccess aktif",
56
+ r"setAllowFileAccess\(\s*true|allowFileAccess\s*=\s*true",
57
+ "Matikan, atau pakai WebViewAssetLoader."),
58
+ Rule("W-CONTENT", "medium", "allowContentAccess aktif",
59
+ r"setAllowContentAccess\(\s*true|allowContentAccess\s*=\s*true",
60
+ "Matikan jika tidak butuh konten provider."),
61
+ Rule("W-MIXED", "high", "Mixed content diizinkan",
62
+ r"MIXED_CONTENT_ALWAYS_ALLOW", "Gunakan MIXED_CONTENT_NEVER_ALLOW dan HTTPS saja."),
63
+ Rule("W-DEBUG", "medium", "WebView debugging aktif",
64
+ r"setWebContentsDebuggingEnabled\(\s*true",
65
+ "Bungkus dengan BuildConfig.DEBUG atau (applicationInfo.flags and FLAG_DEBUGGABLE)."),
66
+ Rule("W-LOADURL-HTTP", "high", "WebView memuat URL http",
67
+ r"(loadUrl|loadDataWithBaseURL)\(\s*\"http://", "Gunakan HTTPS."),
68
+ Rule("W-LOADURL-DYN", "low", "loadUrl dengan nilai dinamis",
69
+ r"\.loadUrl\(\s*[^\"\s)]", "Pastikan URL divalidasi terhadap allowlist skema dan host sebelum dimuat.",
70
+ neg=r"javascript:", conf="low"),
71
+ Rule("W-LOADDATA", "medium", "loadData dengan interpolasi",
72
+ r"(loadData|loadDataWithBaseURL)\(.*(\$\{?\w|\+\s*\w)",
73
+ "Escape atau hindari menyisipkan data tak tepercaya ke HTML."),
74
+ Rule("W-EVALJS", "medium", "evaluateJavascript dengan interpolasi",
75
+ r"evaluateJavascript\(.*(\$\{?\w|\"\s*\+|\+\s*\")",
76
+ "Kirim data lewat JSON yang di-escape atau postWebMessage, jangan merangkai string."),
77
+ Rule("W-SSL", "critical", "Mengabaikan error SSL di WebView",
78
+ r"onReceivedSslError", "Jangan panggil handler.proceed(). Panggil cancel().",
79
+ need=r"\.proceed\(\)", window=6),
80
+ # Komponen dan intent
81
+ Rule("C-REDIRECT", "medium", "Kemungkinan intent redirection",
82
+ r"getParcelableExtra(<Intent>)?\(|getParcelable(<Intent>)?\(.*Intent",
83
+ "Jangan meluncurkan Intent yang diterima dari luar. Validasi komponen tujuan dan hapus flag URI permission.",
84
+ need=r"Intent", conf="low"),
85
+ Rule("C-PENDING", "high", "PendingIntent tanpa flag mutability",
86
+ r"PendingIntent\.get(Activity|Broadcast|Service|Activities|ForegroundService)\(",
87
+ "Tambahkan FLAG_IMMUTABLE (atau FLAG_MUTABLE bila benar-benar perlu) dan Intent eksplisit.",
88
+ neg=r"FLAG_IMMUTABLE|FLAG_MUTABLE", window=3),
89
+ Rule("C-RECEIVER", "medium", "registerReceiver tanpa flag export",
90
+ r"registerReceiver\(", "Pada Android 13+ tentukan RECEIVER_NOT_EXPORTED bila tidak untuk aplikasi lain.",
91
+ neg=r"RECEIVER_NOT_EXPORTED|RECEIVER_EXPORTED", window=2),
92
+ Rule("C-BROADCAST", "low", "sendBroadcast tanpa batas penerima",
93
+ r"sendBroadcast\(", "Gunakan setPackage atau izin penerima agar data tidak bocor ke aplikasi lain.",
94
+ neg=r"setPackage|permission|Permission", window=2, conf="low"),
95
+ Rule("C-IMPLICIT", "medium", "startActivity dengan Intent implisit dari data dinamis",
96
+ r"Intent\(\s*Intent\.ACTION_VIEW\s*,\s*Uri\.parse\(\s*[^\"\s)]",
97
+ "Validasi skema dan host Uri sebelum membuka. Tangani ActivityNotFoundException.", conf="low"),
98
+ Rule("C-FILEPROVIDER", "high", "FileProvider membuka path root",
99
+ r"<root-path|<external-path\s+[^>]*path=\"\.?/?\"", "Batasi path FileProvider ke subfolder spesifik.", kinds="xml"),
100
+ # Data sensitif di UI
101
+ Rule("U-LOG", "high", "Data sensitif ditulis ke log",
102
+ r"(Log\.[dviwe]|Timber\.[dviwe]|println)\s*\(.*" + SENS,
103
+ "Hapus log atau jangan sertakan nilai sensitif. Pastikan log debug dibuang di release.", flags=I),
104
+ Rule("U-STACKTRACE", "low", "printStackTrace dan pesan exception ke UI",
105
+ r"printStackTrace\(\)|Toast\.makeText\(.*(\.message|\.localizedMessage|\.toString\(\))",
106
+ "Log ringkas via logger yang dimatikan di release. Tampilkan pesan generik ke pengguna."),
107
+ Rule("U-CLIPBOARD", "medium", "Data sensitif disalin ke clipboard",
108
+ r"(setPrimaryClip|ClipData\.newPlainText)\(.*" + SENS,
109
+ "Hindari menyalin data sensitif. Jika perlu, tandai ClipDescription.EXTRA_IS_SENSITIVE dan hapus otomatis.", flags=I),
110
+ Rule("U-SAVEABLE", "medium", "Data sensitif disimpan di rememberSaveable",
111
+ r"(rememberSaveable.*" + SENS + r"|" + SENS + r".*rememberSaveable)",
112
+ "State disimpan ke Bundle dan bisa bertahan di process death. Pakai remember biasa untuk rahasia.", flags=I),
113
+ Rule("U-PWFIELD", "medium", "Field password tanpa transformasi atau tipe keyboard",
114
+ r"\b(Outlined)?(Basic)?TextField\(", "Gunakan PasswordVisualTransformation dan KeyboardType.Password. Pertimbangkan tombol tampilkan sementara.",
115
+ need=r"password|passwd|kata sandi", neg=r"PasswordVisualTransformation|KeyboardType\.(Password|NumberPassword)",
116
+ window=25, flags=I),
117
+ Rule("U-INPUTTYPE", "medium", "EditText sensitif tanpa inputType password",
118
+ r"<EditText|<com\.google\.android\.material\.textfield\.TextInputEditText", "Set android:inputType=\"textPassword\" untuk field rahasia.",
119
+ kinds="xml", need=r"password|pin|otp", neg=r"inputType=\"[^\"]*(Password|numberPassword)", window=8, flags=I, conf="low"),
120
+ Rule("U-AUTOFILL", "info", "AutoFill diaktifkan manual",
121
+ r"importantForAutofill\s*=\s*\"yes\"", "Pastikan field sensitif tidak mengirim data ke layanan autofill pihak ketiga yang tidak diinginkan.", kinds="xml"),
122
+ # Secret
123
+ Rule("S-SECRET", "high", "Secret hardcode",
124
+ r"(api[_-]?key|secret|passwd|password|token|bearer|client[_-]?secret)\w*\s*(=|:)\s*\"(?=[A-Za-z_\-/+=.]*\d)(?=[0-9_\-/+=.]*[A-Za-z])[A-Za-z0-9_\-/+=.]{16,}\"",
125
+ "Jangan simpan secret di APK. Pindahkan ke backend atau gunakan proxy. Rotasi kunci yang sudah terlanjur dikomit.",
126
+ kinds="all", neg=r"BuildConfig|R\.string|getString|stringResource|example|your_|changeme|xxxx", flags=I, conf="low"),
127
+ Rule("S-PRIVKEY", "critical", "Kunci privat di source",
128
+ r"-----BEGIN (RSA |EC |OPENSSH |DSA )?PRIVATE KEY-----", "Hapus dari repo, rotasi, dan bersihkan histori git.", kinds="all"),
129
+ Rule("S-AWS", "critical", "Access key AWS",
130
+ r"\bAKIA[0-9A-Z]{16}\b", "Cabut dan rotasi segera.", kinds="all"),
131
+ Rule("S-GOOGLEKEY", "medium", "API key Google di source",
132
+ r"\bAIza[0-9A-Za-z_\-]{35}\b", "Batasi key di console (package name + SHA-1, daftar API). Jangan pakai key tanpa batasan.", kinds="all"),
133
+ Rule("S-TOKENFMT", "high", "Token berformat dikenal",
134
+ r"\b(ghp_[A-Za-z0-9]{36}|xox[baprs]-[A-Za-z0-9-]{10,}|sk-[A-Za-z0-9]{32,})\b", "Cabut dan rotasi.", kinds="all"),
135
+ # Penyimpanan
136
+ Rule("S-PREFS", "medium", "Data sensitif di SharedPreferences biasa",
137
+ r"(putString|edit\(\).*put\w+)\(\s*\"[^\"]*" + SENS, "Simpan rahasia dengan enkripsi berbasis Android Keystore (cek rekomendasi terbaru untuk library enkripsi yang dipakai).", flags=I),
138
+ Rule("S-WORLD", "high", "Mode file world-readable/writable",
139
+ r"MODE_WORLD_(READABLE|WRITEABLE)", "Gunakan MODE_PRIVATE."),
140
+ Rule("S-EXTERNAL", "low", "Penyimpanan eksternal",
141
+ r"getExternalStorageDirectory\(|Environment\.getExternalStorage", "Jangan simpan data sensitif di eksternal. Pakai penyimpanan privat aplikasi."),
142
+ # Jaringan
143
+ Rule("N-HTTP", "medium", "URL http (cleartext)",
144
+ r"\"http://(?!localhost|127\.0\.0\.1|10\.0\.2\.2|schemas\.android\.com|www\.w3\.org|schemas\.microsoft)", "Gunakan HTTPS.", kinds="all"),
145
+ Rule("N-HOSTNAME", "critical", "HostnameVerifier menerima semua",
146
+ r"ALLOW_ALL_HOSTNAME_VERIFIER|HostnameVerifier\s*\{[^}]*\btrue\b|hostnameVerifier\s*\{\s*_\s*,\s*_\s*->\s*true",
147
+ "Hapus. Gunakan verifikasi default."),
148
+ Rule("N-TRUSTALL", "critical", "TrustManager menerima semua",
149
+ r"object\s*:\s*X509TrustManager|implements\s+X509TrustManager|new\s+X509TrustManager", "Jangan implementasi TrustManager kustom yang melewati validasi. Gunakan network_security_config atau CertificatePinner.",
150
+ need=r"checkServerTrusted\s*\([^)]*\)\s*(:\s*\w+\s*)?\{\s*(//[^\n]*\n\s*)*\}", window=12),
151
+ Rule("N-PINNING", "info", "OkHttp tanpa CertificatePinner (cek manual)",
152
+ r"OkHttpClient\.Builder\(\)", "Untuk aplikasi berisiko tinggi, pertimbangkan certificate pinning dengan strategi rotasi.",
153
+ neg=r"certificatePinner|CertificatePinner", window=15, conf="low"),
154
+ # Input dan injeksi
155
+ Rule("I-SQL", "high", "SQL dirangkai dari string",
156
+ r"(rawQuery|execSQL|SimpleSQLiteQuery)\(.*(\+\s*\w|\$\{?\w)", "Gunakan parameter binding (?) atau Room dengan @Query berparameter."),
157
+ Rule("I-PATH", "medium", "Path file dari input luar",
158
+ r"File\(.*(getStringExtra|getQueryParameter|lastPathSegment|\.path\b|getString\()",
159
+ "Normalisasi dengan canonicalPath dan pastikan berada di direktori yang diizinkan. Tolak '..'.", conf="low"),
160
+ Rule("I-DEEPLINK", "info", "Parameter deep link dipakai",
161
+ r"getQueryParameter\(|intent\??\.data\b|intent\??\.getStringExtra\(", "Validasi tipe, panjang, dan nilai. Jangan pakai langsung untuk navigasi atau query.", conf="low"),
162
+ Rule("I-HTML", "low", "Html.fromHtml dari data dinamis",
163
+ r"Html\.fromHtml\(\s*[^\"\s)]", "Pastikan sumber tepercaya. Hindari merender HTML dari input pengguna.", conf="low"),
164
+ Rule("I-RANDOM", "medium", "Random non-kriptografis untuk nilai keamanan",
165
+ r"\bjava\.util\.Random\(|\bRandom\(\)|Math\.random\(\)", "Pakai SecureRandom untuk token, OTP, nonce.",
166
+ need=r"token|otp|session|password|nonce|key", window=3, flags=I),
167
+ Rule("I-HASH", "medium", "Hash lemah",
168
+ r"MessageDigest\.getInstance\(\s*\"(MD5|SHA-?1)\"\s*\)", "Pakai SHA-256 atau lebih kuat. Untuk password gunakan KDF di server."),
169
+ Rule("I-CIPHER", "high", "Cipher lemah atau mode ECB",
170
+ r"Cipher\.getInstance\(\s*\"(AES|DES|DESede|RC4|Blowfish)(/ECB/\w+)?\"\s*\)", "Pakai AES/GCM/NoPadding dengan IV acak per pesan."),
171
+ ]
172
+
173
+ PROJECT_NOTES = []
174
+
175
+
176
+ def walk(root, include_tests):
177
+ if os.path.isfile(root):
178
+ yield root
179
+ return
180
+ for d, dirs, files in os.walk(root):
181
+ dirs[:] = [x for x in dirs if x not in SKIP_DIRS and (include_tests or x not in TEST_DIRS)]
182
+ for f in files:
183
+ if f.endswith(CODE_EXT + (".xml",)):
184
+ yield os.path.join(d, f)
185
+
186
+
187
+ def kind_ok(rule, path):
188
+ is_xml = path.endswith(".xml")
189
+ if rule.kinds == "all":
190
+ return True
191
+ return is_xml if rule.kinds == "xml" else not is_xml
192
+
193
+
194
+ def find_line(text, needle):
195
+ idx = text.find(needle)
196
+ return text.count("\n", 0, idx) + 1 if idx >= 0 else 1
197
+
198
+
199
+ def scan_lines(path, text, findings):
200
+ lines = text.splitlines()
201
+ for rule in RULES:
202
+ if not kind_ok(rule, path):
203
+ continue
204
+ for i, line in enumerate(lines):
205
+ s = line.strip()
206
+ if s.startswith(("//", "*", "/*", "<!--")):
207
+ continue
208
+ if not rule.pat.search(line):
209
+ continue
210
+ win = "\n".join(lines[i:i + 1 + rule.window])
211
+ if rule.need and not rule.need.search(win):
212
+ continue
213
+ if rule.neg and rule.neg.search(win if rule.window else line):
214
+ continue
215
+ ctx = "\n".join(lines[max(0, i - 1):i + 1])
216
+ m = IGNORE.search(ctx)
217
+ if m and m.group(1) == rule.rid:
218
+ continue
219
+ findings.append(dict(rule=rule.rid, severity=rule.sev, title=rule.title, file=path,
220
+ line=i + 1, snippet=s[:160], advice=rule.advice, confidence=rule.conf))
221
+
222
+
223
+ def is_debug_path(path):
224
+ return "/debug/" in path.replace("\\", "/")
225
+
226
+
227
+ def scan_manifest(path, text, findings):
228
+ mlines = text.splitlines()
229
+
230
+ def add(rid, sev, title, needle, advice, conf="high"):
231
+ ln = find_line(text, needle)
232
+ ctx = "\n".join(mlines[max(0, ln - 3):ln])
233
+ m = IGNORE.search(ctx)
234
+ if m and m.group(1) == rid:
235
+ return
236
+ if is_debug_path(path) and sev in ("high", "medium"):
237
+ sev = "info"
238
+ title += " (source set debug)"
239
+ findings.append(dict(rule=rid, severity=sev, title=title, file=path, line=ln,
240
+ snippet=needle[:160], advice=advice, confidence=conf))
241
+
242
+ try:
243
+ root = ET.fromstring(text)
244
+ except ET.ParseError:
245
+ return
246
+ app = root.find("application")
247
+ if app is not None:
248
+ if app.get(ANDROID_NS + "debuggable") == "true":
249
+ add("M-DEBUGGABLE", "high", "debuggable=true", "android:debuggable", "Hapus atribut. Biarkan build type yang mengatur.")
250
+ if app.get(ANDROID_NS + "allowBackup") == "true":
251
+ add("M-BACKUP", "medium", "allowBackup=true", "android:allowBackup",
252
+ "Set false atau definisikan dataExtractionRules dan fullBackupContent yang mengecualikan data sensitif.")
253
+ if app.get(ANDROID_NS + "usesCleartextTraffic") == "true":
254
+ add("M-CLEARTEXT", "high", "usesCleartextTraffic=true", "android:usesCleartextTraffic", "Set false dan gunakan HTTPS.")
255
+ for comp in app:
256
+ tag = comp.tag
257
+ if tag not in ("activity", "activity-alias", "service", "receiver", "provider"):
258
+ continue
259
+ name = comp.get(ANDROID_NS + "name", "?")
260
+ exported = comp.get(ANDROID_NS + "exported")
261
+ perm = comp.get(ANDROID_NS + "permission")
262
+ filters = comp.findall("intent-filter")
263
+ launcher = any(c.get(ANDROID_NS + "name") == "android.intent.category.LAUNCHER"
264
+ for f in filters for c in f.findall("category"))
265
+ if filters and exported is None:
266
+ add("M-EXPORT-IMPLICIT", "high", f"{tag} dengan intent-filter tanpa android:exported ({name})", name,
267
+ "Android 12+ mewajibkan atribut eksplisit. Set true hanya jika memang untuk aplikasi lain.")
268
+ if exported == "true" and not launcher:
269
+ if tag == "activity" or tag == "activity-alias":
270
+ add("M-EXPORT", "medium", f"Activity exported ({name})", name,
271
+ "Validasi semua extra dan data intent. Pertimbangkan izin atau exported=false.", "medium")
272
+ elif not perm and tag != "provider":
273
+ add("M-EXPORT", "high", f"{tag} exported tanpa permission ({name})", name,
274
+ "Set exported=false atau lindungi dengan permission signature-level.")
275
+ if tag == "provider":
276
+ if exported == "true":
277
+ add("M-PROVIDER", "high", f"ContentProvider exported ({name})", name,
278
+ "Set exported=false, atau lindungi dengan readPermission/writePermission dan batasi path.")
279
+ if comp.get(ANDROID_NS + "grantUriPermissions") == "true":
280
+ add("M-GRANT", "medium", f"grantUriPermissions=true ({name})", name,
281
+ "Batasi dengan <grant-uri-permission> pada path tertentu.", "medium")
282
+ for f in filters:
283
+ cats = {c.get(ANDROID_NS + "name") for c in f.findall("category")}
284
+ datas = f.findall("data")
285
+ if "android.intent.category.BROWSABLE" in cats and datas:
286
+ schemes = {d.get(ANDROID_NS + "scheme") for d in datas if d.get(ANDROID_NS + "scheme")}
287
+ web = bool(schemes & {"http", "https"})
288
+ if web and f.get(ANDROID_NS + "autoVerify") != "true":
289
+ add("M-APPLINK", "low", f"Link web tanpa autoVerify ({name})", name,
290
+ "Gunakan Android App Links terverifikasi (assetlinks.json) agar tidak bisa dibajak aplikasi lain.", "medium")
291
+ add("M-DEEPLINK", "info", f"Deep link {sorted(schemes)} ({name})", name,
292
+ "Perlakukan semua parameter sebagai input tak tepercaya.", "medium")
293
+ risky = {
294
+ "SYSTEM_ALERT_WINDOW": ("medium", "Izin overlay meningkatkan risiko tapjacking dan phishing UI."),
295
+ "MANAGE_EXTERNAL_STORAGE": ("medium", "Akses semua file. Gunakan SAF atau MediaStore."),
296
+ "REQUEST_INSTALL_PACKAGES": ("low", "Pastikan benar-benar perlu memasang paket."),
297
+ "READ_EXTERNAL_STORAGE": ("low", "Pertimbangkan Photo Picker atau SAF."),
298
+ "WRITE_EXTERNAL_STORAGE": ("low", "Pertimbangkan MediaStore atau SAF."),
299
+ "READ_SMS": ("medium", "Gunakan SMS Retriever API untuk OTP."),
300
+ "RECEIVE_SMS": ("medium", "Gunakan SMS Retriever API untuk OTP."),
301
+ }
302
+ for up in root.findall("uses-permission"):
303
+ n = (up.get(ANDROID_NS + "name") or "").split(".")[-1]
304
+ if n in risky:
305
+ sev, adv = risky[n]
306
+ add("M-PERM", sev, f"Izin {n}", n, adv, "medium")
307
+
308
+
309
+ def scan_nsc(path, text, findings):
310
+ debug_start = text.find("<debug-overrides")
311
+ debug_end = text.find("</debug-overrides>")
312
+ for m in re.finditer(r'cleartextTrafficPermitted\s*=\s*"true"', text):
313
+ findings.append(dict(rule="N-NSC-CLEAR", severity="high", title="network_security_config mengizinkan cleartext",
314
+ file=path, line=text.count("\n", 0, m.start()) + 1, snippet=m.group(0),
315
+ advice="Set false. Kecualikan hanya domain dev tertentu di debug-overrides.", confidence="high"))
316
+ for m in re.finditer(r'<certificates\s+src\s*=\s*"user"', text):
317
+ in_debug = debug_start != -1 and debug_start < m.start() < (debug_end if debug_end != -1 else len(text))
318
+ findings.append(dict(rule="N-NSC-USER", severity="info" if in_debug else "medium",
319
+ title="Trust anchor sertifikat pengguna" + (" (debug-overrides)" if in_debug else ""),
320
+ file=path, line=text.count("\n", 0, m.start()) + 1, snippet=m.group(0),
321
+ advice="Jangan percayai CA pengguna di release.", confidence="high"))
322
+
323
+
324
+ def project_checks(files_text, findings):
325
+ sensitive = [p for p, t in files_text.items()
326
+ if re.search(r"PasswordVisualTransformation|KeyboardType\.(Password|NumberPassword)|textPassword|numberPassword", t)]
327
+ if sensitive:
328
+ all_text = "\n".join(files_text.values())
329
+ if "FLAG_SECURE" not in all_text and "setSecure" not in all_text:
330
+ findings.append(dict(rule="U-SECURE", severity="medium", title="Layar sensitif tanpa FLAG_SECURE",
331
+ file=sensitive[0], line=1, snippet="(tingkat proyek: FLAG_SECURE tidak ditemukan)",
332
+ advice="Set WindowManager.LayoutParams.FLAG_SECURE pada layar login, OTP, PIN, dan pembayaran untuk mencegah screenshot dan pratinjau recents.",
333
+ confidence="medium"))
334
+ if not re.search(r"filterTouchesWhenObscured|FLAG_WINDOW_IS_OBSCURED|MotionEvent\.FLAG_WINDOW_IS_PARTIALLY_OBSCURED", all_text):
335
+ findings.append(dict(rule="U-TAPJACK", severity="low", title="Tidak ada perlindungan tapjacking",
336
+ file=sensitive[0], line=1, snippet="(tingkat proyek)",
337
+ advice="Untuk tombol aksi sensitif, set filterTouchesWhenObscured=true (View) atau periksa flag obscured pada event sentuh di Compose.",
338
+ confidence="low"))
339
+
340
+
341
+ def main():
342
+ ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
343
+ ap.add_argument("path")
344
+ ap.add_argument("--format", choices=["text", "md", "json"], default="text")
345
+ ap.add_argument("--out")
346
+ ap.add_argument("--min-severity", choices=SEV, default="info")
347
+ ap.add_argument("--fail-on", choices=SEV)
348
+ ap.add_argument("--include-tests", action="store_true")
349
+ a = ap.parse_args()
350
+
351
+ findings, files_text = [], {}
352
+ for path in walk(a.path, a.include_tests):
353
+ try:
354
+ with open(path, encoding="utf-8", errors="replace") as fh:
355
+ text = fh.read()
356
+ except OSError:
357
+ continue
358
+ files_text[path] = text
359
+ base = os.path.basename(path)
360
+ if base == "AndroidManifest.xml":
361
+ scan_manifest(path, text, findings)
362
+ elif path.endswith(".xml") and "<network-security-config" in text:
363
+ scan_nsc(path, text, findings)
364
+ scan_lines(path, text, findings)
365
+ project_checks(files_text, findings)
366
+
367
+ floor = SEV.index(a.min_severity)
368
+ findings = [f for f in findings if SEV.index(f["severity"]) >= floor]
369
+ findings.sort(key=lambda f: (-SEV.index(f["severity"]), f["file"], f["line"]))
370
+ counts = Counter(f["severity"] for f in findings)
371
+
372
+ if a.format == "json":
373
+ body = json.dumps({"counts": counts, "files_scanned": len(files_text), "findings": findings}, indent=2, ensure_ascii=False)
374
+ elif a.format == "md":
375
+ out = ["# Laporan pemindaian keamanan UI Android", "",
376
+ f"File dipindai: {len(files_text)}", "",
377
+ "| Tingkat | Jumlah |", "|---|---|"]
378
+ out += [f"| {s} | {counts.get(s, 0)} |" for s in reversed(SEV)]
379
+ out += ["", "Pemindai ini berbasis pola. Verifikasi setiap temuan secara manual sebelum menyimpulkan.", ""]
380
+ for f in findings:
381
+ out += [f"## [{f['severity'].upper()}] {f['rule']}: {f['title']}", "",
382
+ f"- Lokasi: `{f['file']}:{f['line']}`",
383
+ f"- Keyakinan: {f['confidence']}",
384
+ f"- Cuplikan: `{f['snippet']}`",
385
+ f"- Perbaikan: {f['advice']}", ""]
386
+ body = "\n".join(out)
387
+ else:
388
+ out = []
389
+ for f in findings:
390
+ out.append(f"[{f['severity'].upper():8}] {f['rule']:18} {f['file']}:{f['line']} ({f['confidence']})")
391
+ out.append(f" {f['title']}")
392
+ out.append(f" > {f['snippet']}")
393
+ out.append(f" -> {f['advice']}")
394
+ out.append("")
395
+ out.append("Ringkasan: " + ", ".join(f"{counts.get(s, 0)} {s}" for s in reversed(SEV))
396
+ + f" | file dipindai: {len(files_text)}")
397
+ body = "\n".join(out)
398
+
399
+ if a.out:
400
+ with open(a.out, "w", encoding="utf-8") as fh:
401
+ fh.write(body + "\n")
402
+ print(f"Laporan ditulis ke {a.out} ({len(findings)} temuan)")
403
+ else:
404
+ print(body)
405
+
406
+ if a.fail_on and any(SEV.index(f["severity"]) >= SEV.index(a.fail_on) for f in findings):
407
+ sys.exit(1)
408
+
409
+
410
+ if __name__ == "__main__":
411
+ main()
@@ -0,0 +1,47 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ /**
4
+ * Wrapper npm untuk android-skills.
5
+ * Menjalankan install.py dengan argumen yang sama.
6
+ *
7
+ * Contoh:
8
+ * npx tamvanpr/android-skills --target claude --project .
9
+ * npx tamvanpr/android-skills --target cursor
10
+ * npm i -g android-skills && android-skills --help
11
+ *
12
+ * Catatan: installer ini ditulis dalam Python (butuh python3 di mesin).
13
+ * Bila python3 tidak ada, pesan instalasi diberikan.
14
+ */
15
+ const { spawnSync } = require("child_process");
16
+ const fs = require("fs");
17
+ const path = require("path");
18
+
19
+ function findPython() {
20
+ for (const cand of process.platform === "win32" ? ["py", "python", "python3"] : ["python3", "python"]) {
21
+ const r = spawnSync(cand, ["--version"], { stdio: "ignore" });
22
+ if (r.status === 0 && !r.error) return cand;
23
+ }
24
+ return null;
25
+ }
26
+
27
+ const py = findPython();
28
+ if (!py) {
29
+ console.error(
30
+ "python3 tidak ditemukan di PATH.\n" +
31
+ "Installer android-skills ditulis dalam Python.\n" +
32
+ "Pilihan:\n" +
33
+ " 1) Install Python: pkg install python / apt install python3 / winget install Python.Python.3.12\n" +
34
+ " 2) Atau gunakan git clone langsung: git clone https://github.com/tamvanpr/android-skills && python3 install.py --help"
35
+ );
36
+ process.exit(1);
37
+ }
38
+
39
+ const script = path.join(__dirname, "..", "install.py");
40
+ if (!fs.existsSync(script)) {
41
+ console.error("install.py tidak ditemukan di " + script);
42
+ process.exit(1);
43
+ }
44
+
45
+ const args = process.argv.slice(2);
46
+ const r = spawnSync(py, [script, ...args], { stdio: "inherit" });
47
+ process.exit(r.status === null ? 1 : r.status);