@ryuu-reinzz/ryuu-cli 0.5.1 → 0.5.2

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 Semua perubahan penting pada Ryuu Agent CLI didokumentasikan di sini.
 Project ini mengikuti [Semantic Versioning](https://semver.org/).
 
+## [0.5.2] - 2026-11-03
+
+### Ditambahkan
+
+- **`github_delete_repository`** — menghapus repository GitHub secara permanen.
+  Berisiko `destructive`, selalu melewati approval Ryuu, dan hanya berjalan bila
+  argumen `confirm` berisi `owner/repo` yang sama persis. Bisa dimatikan dengan
+  `/github config set confirmDestructive false`.
+- **Panduan `/github` dan `/drive` di `/help`** — `/help` kini menampilkan daftar
+  subcommand kedua plugin selama plugin dimuat, dan `/help drive` menampilkan
+  tutorial seperti `/help github`.
+
+### Diubah
+
+- Safelist proxy backend menerima `DELETE /repos/{owner}/{repo}` khusus untuk
+  tool penghapusan repository; endpoint DELETE lain tetap ditolak.
+
 ## [0.5.1] - 2026-11-03
 
 Rilis ini menambahkan integrasi GitHub App sebagai plugin opsional, dengan

package/docs/github.md

@@ -6,7 +6,7 @@ integrasi GitHub pada Ryuu CLI. Integrasi terdiri dari dua bagian:
 1. **Backend** (`/root/website/api`, modul `lib/github/`) — Integration Gateway
    yang memegang seluruh kredensial GitHub App dan token pengguna.
 2. **Plugin CLI** (`/root/agents/ryuu/plugins/github/`) — command `/github` dan
-   35 tool AI yang memanggil GitHub melalui gateway.
+   36 tool AI yang memanggil GitHub melalui gateway.
 
 Tidak ada Client Secret, Private Key, Webhook Secret, access token, atau refresh
 token di sisi CLI. CLI hanya memegang `cliToken` per akun yang disimpan
@@ -274,7 +274,7 @@ halaman instalasi App.
 | Kelompok | Tool |
 | --- | --- |
 | Akun | `github_get_me`, `github_get_user`, `github_get_rate_limit` |
-| Repository | `github_list_repositories`, `github_get_repository`, `github_create_repository`, `github_update_repository`, `github_list_branches`, `github_get_branch`, `github_list_commits`, `github_get_commit`, `github_get_file_contents`, `github_create_or_update_file`, `github_delete_file`, `github_compare_commits` |
+| Repository | `github_list_repositories`, `github_get_repository`, `github_create_repository`, `github_update_repository`, `github_delete_repository`, `github_list_branches`, `github_get_branch`, `github_list_commits`, `github_get_commit`, `github_get_file_contents`, `github_create_or_update_file`, `github_delete_file`, `github_compare_commits` |
 | Issue | `github_list_issues`, `github_get_issue`, `github_create_issue`, `github_update_issue`, `github_comment_issue`, `github_list_issue_comments` |
 | Pull request | `github_list_pull_requests`, `github_get_pull_request`, `github_create_pull_request`, `github_update_pull_request`, `github_merge_pull_request`, `github_list_pull_request_files`, `github_review_pull_request` |
 | Release | `github_list_releases`, `github_get_release`, `github_create_release` |
@@ -286,14 +286,20 @@ autentikasi, pembatasan output, dan deskripsi permission yang dibutuhkan.
 Operasi yang mengubah data selalu melewati approval Ryuu:
 
 - membuat/mengubah repository;
+- menghapus repository;
 - membuat/mengubah/menghapus file;
 - membuat/mengubah issue dan komentar;
 - membuat/mengubah/merge pull request dan review;
 - membuat release;
 - menjalankan ulang workflow.
 
-`github_delete_file` dan `github_merge_pull_request` berisiko `destructive`.
-`confirmDestructive: false` memblokirnya sepenuhnya.
+`github_delete_file`, `github_merge_pull_request`, dan `github_delete_repository`
+berisiko `destructive`. `confirmDestructive: false` memblokirnya sepenuhnya.
+
+`github_delete_repository` adalah satu-satunya tool yang menghapus repository.
+Selain approval Ryuu, handler-nya menuntut argumen `confirm` berisi
+`owner/repo` yang sama persis, sehingga model tidak bisa menghapus repository
+tanpa token konfirmasi eksplisit dari pengguna:
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuu-reinzz/ryuu-cli",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Ryuu Agent CLI - an autonomous, approval-gated AI coding agent for your terminal",
   "type": "module",
   "bin": {

package/plugins/github/README.md

@@ -35,7 +35,7 @@ CLI menyimpan cliToken terenkripsi, lalu semua tools lewat backend.
 | `auth.js` | Membuka browser + pesan kegagalan login |
 | `backend.js` | HTTP client ke backend (connect, session, status, proxy) |
 | `api.js` | Klien GitHub REST melalui gateway + pagination |
-| `tools*.js` | 35 tool AI, dikelompokkan per domain |
+| `tools*.js` | 36 tool AI, dikelompokkan per domain |
 | `tool-helpers.js` | Validasi owner/repo/ref/path + pembatasan output |
 | `errors.js` | Error plugin + kode yang stabil |
 | `command.js` | Handler `/github` |
@@ -85,12 +85,13 @@ dapat diubah dari CLI dan tidak pernah ditulis ke file konfigurasi.
 menampilkan Client Secret, Private Key, Webhook Secret, access token, refresh
 token, atau `cliToken`.
 
-## Tool yang tersedia (35)
+## Tool yang tersedia (36)
 
 **Akun (3)** — `github_get_me`, `github_get_user`, `github_get_rate_limit`
 
-**Repository (12)** — `github_list_repositories`, `github_get_repository`,
-`github_create_repository`, `github_update_repository`, `github_list_branches`,
+**Repository (13)** — `github_list_repositories`, `github_get_repository`,
+`github_create_repository`, `github_update_repository`,
+`github_delete_repository`, `github_list_branches`,
 `github_get_branch`, `github_list_commits`, `github_get_commit`,
 `github_get_file_contents`, `github_create_or_update_file`,
 `github_delete_file`, `github_compare_commits`
@@ -111,15 +112,21 @@ token, atau `cliToken`.
 `github_list_workflow_runs`, `github_get_workflow_run`,
 `github_rerun_workflow`
 
-Tidak ada tool penghapusan repository. Penghapusan file dan merge pull request
-berisiko `destructive` dan selalu melewati approval Ryuu.
+`github_delete_repository` menghapus repository secara permanen dan hanya
+berjalan bila argumen `confirm` berisi `owner/repo` yang sama persis; proxy
+backend baru mengizinkannya lewat safelist `DELETE /repos/{owner}/{repo}`.
+Penghapusan repository, penghapusan file, dan merge pull request berisiko
+`destructive` dan selalu melewati approval Ryuu.
 
 ## Approval & keamanan
 
 - `risk: read` berjalan tanpa prompt.
 - Semua tool `write` memakai `requiresApproval: true`.
-- `github_delete_file` dan `github_merge_pull_request` memakai
+- `github_delete_file`, `github_merge_pull_request`, dan
+  `github_delete_repository` memakai
   `risk: destructive` (approval wajib).
+- `github_delete_repository` menuntut `confirm` = `owner/repo`; nilai lain
+  ditolak sebagai `VALIDATION_FAILED` sebelum request dibuat.
 - `confirmDestructive: false` memblokir operasi destruktif di handler, bukan
   hanya mengandalkan prompt.
 - Tool memanggil `plugin.requireClient()` setiap kali, sehingga model yang

package/plugins/github/tools-repos.js

@@ -1,4 +1,5 @@
 import { defineTool } from '../../src/tools/registry.js';
+import { ValidationError } from '../../src/utils/errors.js';
 import {
   assertDestructiveAllowed,
   contentPath,
@@ -129,6 +130,43 @@ export function createRepoTools(plugin) {
       },
     }),
 
+    defineTool({
+      name: 'github_delete_repository',
+      description:
+        'Hapus repository secara permanen. Membutuhkan permission Administration write dan hak admin pada repository. Argumen confirm wajib berisi "owner/repo" persis sama; tanpa itu tool menolak. Operasi ini destruktif: selalu meminta approval Ryuu dan diblokir saat confirmDestructive=false. Jangan pernah dipanggil tanpa persetujuan eksplisit pengguna.',
+      risk: 'destructive',
+      requiresApproval: true,
+      schema: {
+        type: 'object',
+        properties: {
+          ...REPO_PROPS,
+          confirm: {
+            type: 'string',
+            description: 'Tulis ulang "owner/repo" dari repository yang dihapus sebagai konfirmasi eksplisit.',
+          },
+        },
+        required: ['owner', 'repo', 'confirm'],
+      },
+      async handler(args) {
+        await assertDestructiveAllowed(plugin, 'Penghapusan repository');
+        const base = repoBase(args);
+        const target = base.replace(/^\/repos\//, '');
+        const typed = String(args.confirm ?? '').trim();
+        if (typed.toLowerCase() !== target.toLowerCase()) {
+          throw new ValidationError(
+            `Konfirmasi tidak cocok. Untuk menghapus repository ini, argumen confirm harus berisi "${target}".`,
+          );
+        }
+        const api = await plugin.requireClient();
+        await api.delete(base);
+        return {
+          ok: true,
+          deleted: target,
+          note: 'Repository dihapus permanen. Tindakan ini tidak dapat dibatalkan.',
+        };
+      },
+    }),
+
     defineTool({
       name: 'github_list_branches',
       description: 'Daftar branch pada repository beserta commit SHA terakhir dan status proteksi.',

package/src/cli/commands.js

@@ -93,9 +93,17 @@ export function createCommands(state) {
 
   const commands = new Map();
 
-  // `details` is the optional tutorial shown by `/help <command>`.
-  const define = (name, description, usage, handler, details = null) => {
-    commands.set(name, { name, description, usage, handler, details });
+  // `details` is the optional tutorial shown by `/help <command>`; `meta` marks
+  // plugin commands so `/help` can list their subcommand usage separately.
+  const define = (name, description, usage, handler, details = null, meta = {}) => {
+    commands.set(name, { name, description, usage, handler, details, ...meta });
+  };
+
+  /** Usage line for `/help <command>` without printing the command name twice. */
+  const usageLine = (command) => {
+    const prefix = `/${command.name}`;
+    const usage = String(command.usage || '').trim();
+    return usage.startsWith(prefix) ? usage : `${prefix} ${usage}`.trim();
   };
 
   const stateDir = () => stateDirFor(config.workspace);
@@ -178,14 +186,23 @@ export function createCommands(state) {
       const command = commands.get(target);
       if (!command) return print(`Unknown command: /${target}. Run /help.`);
       const details = command.details ? `\n\n${command.details}` : '';
-      return print(`/${command.name} ${command.usage}\n  ${command.description}${details}`);
+      return print(`${usageLine(command)}\n  ${command.description}${details}`);
     }
     const rows = [...commands.values()].map((command) => `  /${command.name.padEnd(12)} ${command.description}`);
     const flagRows = CLI_FLAGS.map(([flag, description]) => `  ${flag.padEnd(20)} ${description}`);
+    const pluginRows = [...commands.values()]
+      .filter((command) => command.plugin)
+      .flatMap((command) => [
+        `  ${usageLine(command)}`,
+        ...(command.examples || []).map((line) => `      ${line}`),
+      ]);
     print(
       [
         'Ryuu commands',
         ...rows,
+        ...(pluginRows.length
+          ? ['', 'Plugin commands (available while the plugin is loaded; details: /help <command>):', ...pluginRows]
+          : []),
         '',
         'CLI flags (set at startup, e.g. `ryuu --auto-approve "task"`, and listed in `ryuu --help`):',
         ...flagRows,
@@ -1141,6 +1158,16 @@ export function createCommands(state) {
           '  enable         mendaftarkan tool GitHub untuk AI Agent',
           '  disable        melepas tool tanpa menghapus akun/token',
         ].join('\n'),
+        {
+          plugin: true,
+          examples: [
+            'login          open the browser and wait for the GitHub approval',
+            'login --device headless device flow, no browser needed',
+            'status | account | test   inspect connection, account and API access',
+            'enable | disable          register or remove the GitHub AI tools',
+            'config                    show settings without any secret',
+          ],
+        },
       );
       continue;
     }
@@ -1157,6 +1184,21 @@ export function createCommands(state) {
       `Google Drive integration: login | logout | account | enable | disable | status | config | test`,
       '/drive [login|logout|account|enable|disable|status|config|test]',
       async (args = '') => handler(args, print),
+      [
+        '  Autentikasi memakai OAuth Google lewat backend Ryuu; CLI tidak menyimpan token Google.',
+        '  login          menghubungkan akun Google lewat browser',
+        '  enable         mendaftarkan tool Drive untuk AI Agent',
+        '  disable        melepas tool tanpa menghapus akun/token',
+      ].join('\n'),
+      {
+        plugin: true,
+        examples: [
+          'login | logout            connect or disconnect the Google account',
+          'account | status | test   inspect the connection and the granted scopes',
+          'enable | disable          register or remove the Drive AI tools',
+          'config                    show settings without any secret',
+        ],
+      },
     );
   }