@nankonyo/testnan 0.0.0-stage → 0.1.0

package/.opencode/command/testnan.md

@@ -0,0 +1,13 @@
+---
+description: Control testnan (on|off|version, default status)
+---
+
+Switch testnan. Subcommand = $ARGUMENTS (satu kata, case-insensitive).
+
+- `` (kosong): lapor mode aktif + versi. Tanpa ubah apa pun.
+- `on`: nyalakan kewajiban test (berlaku pesan berikut).
+- `off`: matikan sampai dinyalakan lagi.
+- `version`: lapor versi terpasang (dari package.json). Tanpa ubah apa pun.
+- Selain itu: abaikan, beri tahu pemakaian valid.
+
+When on: tutup setiap eksekusi ubah kode (semua bahasa) dengan test di `test/test_<slug>.*` (flat di root, tanpa tanggal, tanpa subfolder). Sebelum buat file baru, cek duplikat via `ls test/test_*` + `grep <keyword> test/test_*`. File cocok ada: tambah case di file itu, jangan buat baru. Belum ada: buat `test/test_<slug>.<ext>` dari template di SKILL.md (ext ikut bahasa). Runner: runner bawaan project (`python3 test/run.py`, `npm test`, `go test ./...`, dst). Stdlib/native saja, tanpa deps baru bila tak perlu.

package/.opencode/package.json

@@ -0,0 +1,5 @@
+{
+  "dependencies": {
+    "@opencode-ai/plugin": "1.18.33"
+  }
+}

package/.opencode/plugins/testnan.mjs

@@ -0,0 +1,198 @@
+// testnan — OpenCode plugin (dual API, satu file). Mirror docsnan.mjs.
+// V2: `id` + `setup`. V1: `server()`. Persist mode di `<config>/opencode/.testnan-active`.
+
+import { createRequire } from 'module';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const require = createRequire(import.meta.url);
+const { getTestnanInstructions } = require('../../hooks/testnan-instructions.cjs');
+const { getDefaultMode, normalizePersistedMode } = require('../../hooks/testnan-config.cjs');
+const { routeCommand } = require('../../hooks/testnan-command.cjs');
+import { readFileSync } from 'fs';
+
+function pluginVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(path.resolve(__dirname, '../../package.json'), 'utf8'));
+    return typeof pkg.version === 'string' ? pkg.version : '?';
+  } catch (e) {
+    return '?';
+  }
+}
+
+// ponytail: simpan state beside opencode config, sama seperti .docsnan-active.
+const statePath = path.join(
+  process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config'),
+  'opencode',
+  '.testnan-active',
+);
+
+function readMode() {
+  try {
+    return normalizePersistedMode(fs.readFileSync(statePath, 'utf8').trim()) || getDefaultMode();
+  } catch (e) {
+    return getDefaultMode();
+  }
+}
+
+function writeMode(mode) {
+  fs.mkdirSync(path.dirname(statePath), { recursive: true });
+  fs.writeFileSync(statePath, mode);
+}
+
+export function parseCommandFile(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+  if (!match) return null;
+  const description = match[1].match(/description:\s*(.+)/)?.[1]?.trim();
+  return { description, template: match[2].trim() };
+}
+
+function frontmatterField(frontmatter, key) {
+  const lines = frontmatter.split(/\r?\n/);
+  const at = lines.findIndex((line) => line.startsWith(key + ':'));
+  if (at === -1) return undefined;
+  const value = lines[at].slice(key.length + 1).trim();
+  if (value[0] !== '>' && value[0] !== '|') return value;
+  const block = [];
+  for (const line of lines.slice(at + 1)) {
+    if (line.trim() && !/^\s/.test(line)) break;
+    block.push(line.trim());
+  }
+  while (block.length && !block[block.length - 1]) block.pop();
+  const joined = block.join(value[0] === '|' ? '\n' : ' ');
+  return value.endsWith('-') ? joined : joined + '\n';
+}
+
+function readSkill() {
+  const file = path.resolve(__dirname, '../../skills/testnan/SKILL.md');
+  try {
+    const content = fs.readFileSync(file, 'utf8');
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---[^\S\n]*\r?\n?([\s\S]*)$/);
+    if (!match) return null;
+    return {
+      id: 'testnan',
+      name: frontmatterField(match[1], 'name') || 'testnan',
+      description:
+        frontmatterField(match[1], 'description') ||
+        'Wajibkan tiap ubah kode (semua bahasa) ditutup test di test/test_<slug>.*.',
+      path: file,
+      content: match[2],
+    };
+  } catch (e) {
+    return null;
+  }
+}
+
+function readCommands() {
+  const dir = path.join(__dirname, '..', 'command');
+  try {
+    return fs
+      .readdirSync(dir)
+      .filter((file) => file.endsWith('.md'))
+      .map((file) => {
+        const parsed = parseCommandFile(path.join(dir, file));
+        return parsed && { name: path.basename(file, '.md'), ...parsed };
+      })
+      .filter(Boolean);
+  } catch (e) {
+    return [];
+  }
+}
+
+function versionTag() {
+  return `(testnan ${readMode()} v${pluginVersion()})`;
+}
+
+async function server({ client } = {}) {
+  const log = (level, message) => {
+    try { client && client.app && client.app.log({ body: { service: 'testnan', level, message } }); } catch (e) {}
+  };
+
+  const skillsDir = path.resolve(__dirname, '../../skills');
+
+  return {
+    config: async (config) => {
+      if (!config.command) config.command = {};
+      for (const command of readCommands()) {
+        config.command[command.name] = { description: command.description, template: command.template };
+      }
+
+      config.skills = config.skills || {};
+      config.skills.paths = config.skills.paths || [];
+      if (!config.skills.paths.includes(skillsDir)) {
+        config.skills.paths.push(skillsDir);
+      }
+    },
+
+    'experimental.chat.system.transform': async (_input, output) => {
+      const mode = readMode();
+      if (mode === 'off') return;
+      output.system.push(getTestnanInstructions(mode));
+    },
+
+    'command.execute.before': async (input) => {
+      if (!input || input.command !== 'testnan') return;
+      const routed = routeCommand(input.arguments || '');
+      if (routed.action === 'mode') {
+        writeMode(routed.mode);
+        log('info', 'testnan ' + routed.mode);
+      } else if (routed.action === 'status') {
+        log('info', 'testnan ' + readMode() + ' (v' + pluginVersion() + ')');
+      } else if (routed.action === 'version') {
+        log('info', 'testnan v' + pluginVersion());
+      } else {
+        log('info', 'testnan: unknown arg "' + routed.arg + '". Use on|off|version.');
+      }
+    },
+  };
+}
+
+export default {
+  id: 'testnan',
+
+  async setup(ctx) {
+    const skill = readSkill();
+    if (skill) {
+      await ctx.skill.transform((editor) => {
+        editor.add(skill);
+      });
+    }
+
+    const commands = readCommands();
+    await ctx.command.transform((editor) => {
+      for (const command of commands) {
+        editor.add({
+          name: command.name,
+          description: command.description,
+          execute: async ({ sessionID, prompt, delivery }) => {
+            const routed = routeCommand(prompt.text || '');
+            if (routed.action === 'mode') writeMode(routed.mode);
+            let extra = versionTag();
+            if (routed.action === 'unknown') {
+              extra += `. Unknown arg "${routed.arg}". Use on|off|version.`;
+            }
+            await ctx.session.prompt({
+              ...prompt,
+              sessionID,
+              text: command.template.replaceAll('$ARGUMENTS', prompt.text || '') + `\n\n${extra}`,
+              delivery,
+            });
+          },
+        });
+      }
+    });
+
+    await ctx.session.hook('context', (event) => {
+      const mode = readMode();
+      if (mode === 'off') return;
+      event.system.push({ type: 'text', text: getTestnanInstructions(mode) });
+    });
+  },
+
+  server,
+};

package/AGENTS.md

@@ -0,0 +1,20 @@
+# Testnan — 1 area = 1 file test/test_<slug>.*
+
+Aturan wajib, bukan opsional. Setiap eksekusi ubah kode (bahasa apa
+pun) tutup dengan test di `test/` folder project. Hanya saat eksekusi
+(ada file kode diubah). Skip untuk obrolan biasa, plan tanpa eksekusi,
+dan baca kode tanpa perubahan.
+
+Format nama: `test/test_<slug>.<ext>` (flat, tanpa tanggal)
+Contoh: `test/test_auth_login.py`, `test/test_auth_login.test.js`
+Ext ikut bahasa + konvensi native. Cek duplikat dulu:
+`ls test/test_*` + `grep -l <keyword> test/test_*`.
+Ada cocok: tambah case di file itu. Jangan buat baru.
+
+Runner: pakai runner bawaan project (`python3 test/run.py`,
+`npm test`, `go test ./...`, `cargo test`, dst). Stdlib/native saja,
+tanpa deps baru bila tak perlu.
+
+Template isi ada di `skills/testnan/SKILL.md`.
+
+Kontrol: `/testnan on` | `/testnan off`. Default: `on`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 docsnan contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,166 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="testnan-cover.jpeg" width="700" alt="Testnan, tiap ubah kode wajib ada test">
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<h1 align="center">Testnan</h1>
+
+<p align="center">
+  <em>Satu area, satu file test. Tidak ada ubah kode tanpa bukti jalan.</em>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/works%20with-opencode-111111?style=flat-square" alt="Works with opencode">
+  <img src="https://img.shields.io/badge/tests-stdlib_native-111111?style=flat-square" alt="Stdlib native tests">
+  <img src="https://img.shields.io/badge/license-MIT-111111?style=flat-square" alt="MIT license">
+</p>
+
+---
+
+AI rajin nulis kode, malas nulis test. Testnan memaksanya.
+
+Setiap kali agent mengubah kode (bahasa apa pun) — fitur, fix, debug,
+refactor — ia wajib menutupnya dengan test di folder `test/` project
+tersebut. Satu area, satu file. Obrolan biasa dan plan tanpa eksekusi
+tidak butuh test.
+
+## Contoh hasil
+
+Selesai fix login, agent tulis `test/test_auth_login.py`:
+
+```python
+import unittest
+
+from auth.login import guard_kosong
+
+
+class TestGuardKosong(unittest.TestCase):
+    def test_tolak_password_kosong(self):
+        self.assertFalse(guard_kosong(""))
+```
+
+Lalu bukti jalan:
+
+```bash
+$ python3 test/run.py
+......
+Ran 6 tests in 0.071s
+OK
+```
+
+## Cara kerja
+
+1. Plugin injeksi aturan testnan ke system prompt setiap turn (bila mode `on`).
+2. Agent kerja seperti biasa.
+3. Sebelum tulis test, agent cek duplikat: `ls test/test_*` +
+   `grep -l <keyword> test/test_*`.
+4. File cocok ada: tambah case di file itu, jangan buat baru. Belum ada:
+   buat `test/test_<slug>.<ext>` (ext ikut bahasa, contoh `.py`,
+   `.test.js`). Slug snake_case, maks 50 char, tanpa
+   tanggal, tanpa subfolder.
+5. Verifikasi: runner bawaan project (`python3 test/run.py`,
+   `npm test`, `go test ./...`, dst). Harus hijau.
+
+Kapan wajib: ada file kode diubah/dibuat/dihapus (bahasa apa pun).
+Kapan skip: obrolan biasa, tanya jawab, plan tanpa eksekusi, baca kode
+tanpa perubahan, ubah non-kode saja (docs, config, markdown).
+Aturan putus: tidak ada file kode diubah = tidak ada test baru.
+Tapi test lama yang relevan tetap harus lolos.
+
+## Install
+
+Satu file plugin dukung OpenCode 1.x (`server()`) dan 2.x (`id`+`setup`).
+
+### OpenCode 2.x (dari checkout)
+
+Entry harus direktori, bukan file:
+
+```json
+{ "plugins": ["/abs/path/testnan-checkout"] }
+```
+
+Path `./` relatif terhadap `opencode.json` project. Untuk satu checkout
+dipakai banyak project, isi path absolut ke root checkout (ia temukan
+`hooks/` dan `skills/` relatif ke lokasi plugin).
+
+Aktifkan ulang config tanpa restart:
+
+```bash
+opencode reload
+```
+
+### OpenCode 1.x
+
+```json
+{ "plugin": ["./.opencode/plugins/testnan.mjs"] }
+```
+
+## Perintah
+
+| Perintah | Efek |
+|---|---|
+| `/testnan` | Lapor mode + versi, tanpa ubah apa pun |
+| `/testnan on` | Nyalakan kewajiban test (default) |
+| `/testnan off` | Matikan sampai dinyalakan lagi |
+| `/testnan version` | Lapor versi terpasang (dari `package.json`) |
+
+Env override default: `TESTNAN_DEFAULT_MODE=off`.
+
+## Isi test
+
+Stdlib/native saja, tanpa deps baru bila tak perlu. Python pakai
+`unittest`, JS pakai `node:test`, Go pakai `testing`, dst.
+
+- 1 file = 1 area. Class per unit, method `test_*` per case.
+- Import modul target langsung. Tak boleh ada test kosong tanpa assert.
+- Dua file test untuk satu area = salah. Extend, jangan duplikat.
+
+## Runner
+
+Pakai runner bawaan project. Stdlib saja.
+
+```bash
+python3 test/run.py              # python semua
+python3 test/run.py auth_login   # python satuan
+npm test                         # js semua
+go test ./...                    # go semua
+cargo test                       # rust semua
+```
+
+Keluar 0 bila lolos semua, non-0 bila ada gagal. Jangan tambah
+runner bash/Makefile/pytest bila sudah ada.
+
+## Tes plugin ini
+
+Repo ini dogfood pakai aturannya sendiri:
+
+```bash
+python3 test/run.py            # python semua
+python3 test/run.py naming     # python satuan
+npm test                       # js semua
+```
+
+`test/test_naming.py`: kontrak nama flat tanpa tanggal (semua bahasa).
+`test/test_runner.py`: kontrak runner python semua/satuan.
+`test/test_testnan_command.test.js`: kontrak router command JS.
+
+## Struktur
+
+```text
+index.js                        # entrypoint root (resolve direktori plugin)
+.opencode/plugins/testnan.mjs  # plugin: command, skills, injeksi prompt
+.opencode/command/testnan.md    # template /testnan
+skills/testnan/SKILL.md         # aturan test + anti-duplikat (sumber injeksi)
+hooks/testnan-config.cjs        # mode on/off
+hooks/testnan-instructions.cjs  # bangun teks injeksi
+hooks/testnan-command.cjs       # router bare/on/off/version
+test/test_naming.py             # kontrak nama flat tanpa tanggal (semua bahasa)
+test/test_runner.py             # kontrak runner python semua/satuan
+test/test_testnan_command.test.js # kontrak router command JS
+test/run.py                     # runner python: semua atau satuan via -k
+testnan-cover.jpeg              # cover
+docs/YYYYMMDD/                  # log eksekusi harian (ala docsnan)
+```
+
+## Lisensi
+
+MIT. Lihat [LICENSE](LICENSE).

package/hooks/testnan-command.cjs

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+// testnan — command router (pure, no deps).
+// Distinguishes: bare, on, off, version. No ambiguous behavior.
+
+const { normalizeMode } = require('./testnan-config.cjs');
+
+function routeCommand(rawArgs) {
+  const arg = String(rawArgs || '').trim().toLowerCase();
+  if (arg === '') return { action: 'status' };
+  if (normalizeMode(arg)) return { action: 'mode', mode: normalizeMode(arg) };
+  if (arg === 'version' || arg === '-v' || arg === '--version') return { action: 'version' };
+  return { action: 'unknown', arg: String(rawArgs || '').trim() };
+}
+
+module.exports = { routeCommand };

package/hooks/testnan-config.cjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+// testnan — shared configuration resolver (mirip docsnan-config.js).
+//
+// Resolution order:
+//   1. TESTNAN_DEFAULT_MODE env (on|off)
+//   2. $XDG_CONFIG_HOME/testnan/config.json atau ~/.config/testnan/config.json
+//   3. 'on'
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const DEFAULT_MODE = 'on';
+const VALID_MODES = ['on', 'off'];
+
+function normalizeMode(mode) {
+  if (typeof mode !== 'string') return null;
+  const m = mode.trim().toLowerCase();
+  return VALID_MODES.includes(m) ? m : null;
+}
+
+function normalizePersistedMode(mode) {
+  return normalizeMode(mode);
+}
+
+function getConfigDir() {
+  if (process.env.XDG_CONFIG_HOME) {
+    return path.join(process.env.XDG_CONFIG_HOME, 'testnan');
+  }
+  return path.join(os.homedir(), '.config', 'testnan');
+}
+
+function getConfigPath() {
+  return path.join(getConfigDir(), 'config.json');
+}
+
+function getDefaultMode() {
+  const env = process.env.TESTNAN_DEFAULT_MODE;
+  if (env && VALID_MODES.includes(String(env).toLowerCase())) {
+    return String(env).toLowerCase();
+  }
+  try {
+    const raw = fs.readFileSync(getConfigPath(), 'utf8');
+    const cfg = JSON.parse(raw);
+    if (cfg && normalizeMode(cfg.defaultMode)) return normalizeMode(cfg.defaultMode);
+  } catch (e) {}
+  return DEFAULT_MODE;
+}
+
+module.exports = {
+  DEFAULT_MODE,
+  VALID_MODES,
+  normalizeMode,
+  normalizePersistedMode,
+  getConfigDir,
+  getConfigPath,
+  getDefaultMode,
+};

package/hooks/testnan-instructions.cjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+// testnan — shared instruction builder (mirip docsnan-instructions.js).
+// SKILL.md sumber tunggal. Fallback bila file tak terbaca.
+
+const fs = require('fs');
+const path = require('path');
+const { DEFAULT_MODE, normalizePersistedMode } = require('./testnan-config.cjs');
+
+const SKILL_PATH = path.join(__dirname, '..', 'skills', 'testnan', 'SKILL.md');
+
+function getFallbackInstructions() {
+  return 'TESTNAN MODE ACTIVE — level: on\n\n' +
+    'Tutup setiap eksekusi ubah kode (semua bahasa) dengan test di test/test_<slug>.* (flat, tanpa tanggal). ' +
+    'Cek duplikat dulu via `ls test/test_*` + `grep`. Ada yang cocok: tambah case di file itu. ' +
+    'Jalankan via runner bawaan project (`python3 test/run.py`, `npm test`, `go test ./...`, dst). Stdlib/native saja.';
+}
+
+function getTestnanInstructions(mode) {
+  const m = normalizePersistedMode(mode) || DEFAULT_MODE;
+  if (m === 'off') return '';
+  try {
+    const body = String(fs.readFileSync(SKILL_PATH, 'utf8')).replace(/^---[\s\S]*?---\s*/, '');
+    return 'TESTNAN MODE ACTIVE — level: on\n\n' + body.trim();
+  } catch (e) {
+    return getFallbackInstructions();
+  }
+}
+
+module.exports = { getTestnanInstructions, getFallbackInstructions };

package/index.js

@@ -0,0 +1,7 @@
+// testnan — root entrypoint untuk OpenCode V2.
+// Loader opencode resolve direktori plugin lokal ke <dir>/index.js
+// (pola sama seperti caveman/docsnan). Teruskan ke entry .mjs.
+import plugin, { parseCommandFile } from './.opencode/plugins/testnan.mjs';
+
+export default plugin;
+export { parseCommandFile };

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@nankonyo/testnan",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Wajibkan tiap ubah kode (semua bahasa) ditutup test di test/test_<slug>.*. Mirip docsnan untuk test.",
+  "keywords": [
+    "opencode-plugin",
+    "opencode",
+    "testnan",
+    "skills"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "nankonyo"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  },
+  "main": "./.opencode/plugins/testnan.mjs",
+  "exports": {
+    ".": "./.opencode/plugins/testnan.mjs",
+    "./plugin": "./.opencode/plugins/testnan.mjs"
+  },
+  "files": [
+    "AGENTS.md",
+    "index.js",
+    "hooks/",
+    "skills/",
+    ".opencode/",
+    "testnan-cover.jpeg",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/skills/testnan/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: testnan
+description: >
+  Wajibkan tiap ubah kode (semua bahasa) ditutup test di test/test_<slug>.*.
+  Flat di root tanpa tanggal. Cek duplikat dulu, reuse file cocok.
+  Runner bawaan project untuk semua atau satuan. Stdlib/native saja.
+argument-hint: "[on|off]"
+license: MIT
+---
+
+# Testnan
+
+Tutup setiap eksekusi ubah kode (semua bahasa) dengan test. 1 area = 1 file.
+
+## Kapan wajib test
+
+Hanya saat ada file kode diubah/dibuat/dihapus — bahasa apa pun
+(`.py`, `.js`, `.ts`, `.go`, `.rs`, `.java`, dst), atau bug difix,
+fitur ditambah, refactor dijalankan. Berlaku untuk semua jenis
+eksekusi yang sentuh kode.
+
+## Kapan skip (tanpa test)
+
+- Obrolan biasa: salam, tanya jawab, penjelasan, diskusi konsep.
+- Plan / rencana saja tanpa eksekusi: belum ada file diubah.
+- Baca/browse kode saja tanpa perubahan.
+- Ubah non-kode saja (docs, config, markdown): test tak wajib, tulis
+  alasan di log bila pakai docsnan.
+
+Aturan putus: tidak ada file kode diubah = tidak ada test baru.
+Tapi test lama yang relevan tetap harus lolos.
+
+## Lokasi dan nama
+
+- Folder: `test/` di root project. Flat. Tanpa subfolder tanggal.
+- Nama: `test_<slug>.<ext>`. Contoh: `test_auth_login.py`,
+  `test_auth_login.test.js`, `test_auth_login_test.go`.
+- Ext ikut bahasa + konvensi native. Slug: dari area/fitur. Lowercase
+  snake_case. Non-alfanumerik jadi `_`. Maks 50 char. Contoh:
+  "Auth Login" jadi `auth_login`.
+- Jangan pakai tanggal/jam di nama file. Jangan buat file baru bila
+  slug sama sudah ada.
+
+## Anti-duplikat (wajib sebelum tulis)
+
+1. `ls test/test_*` — lihat file yang ada.
+2. `grep -l <keyword> test/test_*` — cari area cocok
+   (nama fungsi, modul, keyword fitur).
+3. Kena: tambah `TestCase`/`test_*` baru di file itu. Jangan buat
+   file baru.
+4. Tak kena: buat `test/test_<slug>.<ext>` baru dari template bawah.
+5. Satu area = satu file. Dua file test satu area = salah.
+
+## Isi (stdlib/native saja)
+
+Tanpa deps tambahan bila stdlib cukup. Python 3.8+ pakai `unittest`,
+JS pakai `node:test`, Go pakai `testing`, dst.
+
+Template (Python):
+
+```python
+import unittest
+
+from auth.login import guard_kosong
+
+
+class TestGuardKosong(unittest.TestCase):
+    def test_tolak_password_kosong(self):
+        self.assertFalse(guard_kosong(""))
+
+
+if __name__ == "__main__":
+    unittest.main()
+```
+
+Template (JS):
+
+```js
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+
+test('tolak password kosong', () => {
+  assert.equal(guardKosong(''), false);
+});
+```
+
+Aturan: 1 file = 1 area. Class per unit, method `test_*` per case.
+Import modul target langsung, bukan via path hack bila bisa.
+Tak boleh ada test kosong tanpa assert.
+
+## Runner
+
+Pakai runner bawaan project. Stdlib saja, jangan tambah
+runner bash/Makefile/pytest bila sudah ada.
+
+- Python: `python3 test/run.py` (semua) atau
+  `python3 test/run.py <keyword>` (satuan, cocok nama file/class/method)
+- JS: `npm test` atau `node --test test/*.test.js`
+- Go: `go test ./...`
+- Rust: `cargo test`
+
+Keluar 0 bila lolos semua, non-0 bila ada gagal.
+
+## Batas
+
+- `/testnan off` hentikan kewajiban sampai `/testnan on` lagi.
+- Mode default `on`. Env `TESTNAN_DEFAULT_MODE=off` ubah default.
+- Test tulis normal, jelas. Bukan gaya caveman/ponytail.