dailynote-mcp 0.1.0 → 0.2.0

package/INSTALL_CODEX.md

@@ -4,6 +4,9 @@ MCP lokal ini menyediakan satu tool, `add_journal_entry`. Setiap pengguna memaka
 token dari akun DailyNote sendiri. Token diteruskan melalui environment variable;
 tidak perlu file `.env` atau menyimpan token di konfigurasi Codex.
 
+Versi `0.2.0` menambahkan `format: "markdown"` untuk rich text Tiptap. Dukungan
+backend harus sudah dideploy sebelum dipakai; input tanpa format tetap plain.
+
 ## 1. Siapkan Node.js dan aplikasi DailyNote
 
 Pasang Node.js 24 beserta npm dari [nodejs.org](https://nodejs.org/).
@@ -21,7 +24,7 @@ serta endpoint MCP. Pengembang aplikasi menyiapkan backend tersebut.
 
 ## 2. Gunakan package npm
 
-Konfigurasi berikut memakai `dailynote-mcp@0.1.0` dan berlaku setelah versi
+Konfigurasi berikut memakai `dailynote-mcp@0.2.0` dan berlaku setelah versi
 tersebut tersedia di npm. `npx` akan mengambil package serta dependency ketika
 Codex menjalankan koneksi pertama kali. Akses registry diperlukan untuk
 pengunduhan awal. Tidak perlu menjalankan proses MCP di terminal terpisah.
@@ -70,7 +73,7 @@ perbarui blok `dailynote-journal` yang sudah ada; pertahankan konfigurasi lainny
 ```toml
 [mcp_servers.dailynote-journal]
 command = "npx"
-args = ["-y", "dailynote-mcp@0.1.0"]
+args = ["-y", "dailynote-mcp@0.2.0"]
 env_vars = ["DAILYNOTE_URL", "DAILYNOTE_TOKEN"]
 enabled_tools = ["add_journal_entry"]
 ```
@@ -94,7 +97,7 @@ codex mcp get dailynote-journal
 ```
 
 Hasil seharusnya menunjukkan `enabled: true`, `transport: stdio`, argumen
-`-y dailynote-mcp@0.1.0`, dan nama kedua environment variable. Token mentah tidak
+`-y dailynote-mcp@0.2.0`, dan nama kedua environment variable. Token mentah tidak
 perlu tampil.
 Setelah Codex desktop dibuka ulang, buka chat baru dan pastikan tool
 `add_journal_entry` tersedia.
@@ -109,8 +112,8 @@ Tindakan ini menambahkan isi jurnal akun pemilik token. Hasil yang diharapkan
 berisi tanggal, status `saved`, dan `requestId`. Periksa hasil di DailyNote;
 tanggal default mengikuti timezone akun.
 
-Jika hasil belum pasti karena koneksi terputus, ulangi dengan requestId, teks
-dan tanggal yang sama. Jangan langsung mengirim entri baru dengan ID berbeda.
+Jika hasil belum pasti karena koneksi terputus, ulangi dengan requestId, teks,
+tanggal, dan format yang sama. Jangan langsung mengirim entri baru dengan ID berbeda.
 
 ## Mengganti atau melepas koneksi
 

package/README.md

@@ -4,7 +4,7 @@ Hubungkan AI assistant ke akun DailyNote melalui MCP lokal (stdio). Pengguna
 cukup memasang **Node.js 24**; tidak perlu clone proyek, pnpm, atau database lokal.
 Aplikasi DailyNote tujuan harus sudah mendukung Token API dan endpoint MCP.
 
-Konfigurasi npm di bawah memerlukan rilis `dailynote-mcp@0.1.0` tersedia di npm.
+Konfigurasi npm di bawah memerlukan rilis `dailynote-mcp@0.2.0` tersedia di npm.
 
 ## Hubungkan ke Codex
 
@@ -18,7 +18,7 @@ Konfigurasi npm di bawah memerlukan rilis `dailynote-mcp@0.1.0` tersedia di npm.
 ```toml
 [mcp_servers.dailynote-journal]
 command = "npx"
-args = ["-y", "dailynote-mcp@0.1.0"]
+args = ["-y", "dailynote-mcp@0.2.0"]
 env_vars = ["DAILYNOTE_URL", "DAILYNOTE_TOKEN"]
 enabled_tools = ["add_journal_entry"]
 ```
@@ -48,15 +48,38 @@ Saat ini ada satu tool: **`add_journal_entry`**.
 }
 ```
 
-- `text`: teks biasa, maksimum 20.000 unit UTF-16. Baris baru menjadi paragraf;
-  HTML dan Markdown disimpan sebagai teks literal.
+- `text`: isi entri, maksimum 20.000 unit UTF-16. Pada format plain, baris baru
+  menjadi paragraf dan HTML/Markdown disimpan sebagai teks literal.
 - `date`: opsional, format `YYYY-MM-DD`. Default hari ini mengikuti timezone akun.
+- `format`: opsional, `plain` (default) atau `markdown`. Plain menyimpan karakter
+  Markdown/HTML sebagai teks literal. Markdown dikonversi di backend menjadi JSON
+  Tiptap tervalidasi, sehingga formatnya dapat diedit dari aplikasi web.
 - `requestId`: opsional untuk entri baru; gunakan kembali ID yang sama saat retry.
 
 Tool membuat jurnal tanggal tersebut bila belum ada, atau menambahkan teks di
 akhir jurnal yang ada. Isi, format, dan media lama tetap dipertahankan. Tidak
 menyediakan pembacaan/penghapusan jurnal, catatan, tugas, atau upload file.
 
+Contoh rich text, mulai versi `0.2.0`:
+
+```json
+{
+  "text": "## Kegiatan\n\n- Menyelesaikan **fitur MCP**",
+  "format": "markdown"
+}
+```
+
+Markdown mendukung heading (semua level dinormalisasi menjadi level 2 sesuai
+editor jurnal), tebal, miring, coret, daftar berpoin/bernomor bertingkat,
+checklist datar, kutipan, blok kode, line break eksplisit, dan tautan HTTP(S)/mailto
+yang lolos kebijakan jurnal. HTML ditampilkan sebagai teks literal. Tabel,
+gambar Markdown, inline code, garis pemisah, dan checklist bertingkat ditolak
+dengan `invalid_content`; tidak ada bagian entri yang disimpan.
+
+Backend DailyNote harus diperbarui lebih dahulu sebelum memakai format baru.
+Client lama tetap dapat mengirim teks biasa tanpa `format`. Metadata/isi media
+lama tetap dipertahankan; format Markdown tidak memberikan izin upload gambar.
+
 Contoh permintaan di Codex:
 
 > Gunakan DailyNote MCP untuk menambahkan "Tes koneksi dari Codex" ke jurnal hari ini.
@@ -75,8 +98,9 @@ dan buka ulang client. **Cabut token** di profil menghentikan akses token terseb
 Scope token saat ini hanya `journal:append`.
 
 Jika hasil `outcome_unknown`, periksa jurnal di aplikasi atau ulangi dengan
-**requestId, text, dan date yang sama**, termasuk tetap tanpa `date` bila sebelumnya
-kosong. Tidak ada retry otomatis. Mengirim payload berbeda dengan ID yang sama
+**requestId, text, date, dan format yang sama**, termasuk tetap tanpa `date` bila sebelumnya
+kosong. Format yang tidak dikirim setara dengan `plain`. Tidak ada retry otomatis.
+Mengirim payload berbeda, termasuk mengubah format, dengan ID yang sama
 ditolak; mengganti token tidak menghilangkan deduplikasi akun.
 
 Jika proses berhenti sebelum requestId diterima, periksa jurnal lewat aplikasi

package/claude-desktop.example.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "dailynote-journal": {
       "command": "npx",
-      "args": ["-y", "dailynote-mcp@0.1.0"]
+      "args": ["-y", "dailynote-mcp@0.2.0"]
     }
   }
 }

package/codex.example.toml

@@ -1,6 +1,6 @@
 # Merge this block into your existing Codex config; do not replace that file.
 [mcp_servers.dailynote-journal]
 command = "npx"
-args = ["-y", "dailynote-mcp@0.1.0"]
+args = ["-y", "dailynote-mcp@0.2.0"]
 env_vars = ["DAILYNOTE_URL", "DAILYNOTE_TOKEN"]
 enabled_tools = ["add_journal_entry"]

package/journal.mjs

@@ -64,7 +64,7 @@ export function createJournalServer(config) {
     "add_journal_entry",
     {
       description:
-        "Append plain text to the personal token owner's DailyNote journal. Creates the date if missing; preserves existing text and media. Date defaults to today in the account timezone. Never reads or returns journal content. On an uncertain result, retry identical text/date with the returned requestId; do not generate a new ID.",
+        "Append text to the personal token owner's DailyNote journal. Omit format for literal plain text, or use markdown for validated rich text. Creates the date if missing; preserves existing text and media. Date defaults to today in the account timezone. Never reads or returns journal content. On an uncertain result, retry identical text/date/format with the returned requestId; do not generate a new ID.",
       inputSchema: z
         .object({
           text: z
@@ -73,7 +73,13 @@ export function createJournalServer(config) {
             .max(20_000)
             .refine((text) => text.trim().length > 0)
             .describe(
-              "Plain text to append. Line breaks become paragraphs; Markdown/HTML are stored as literal text.",
+              "Text to append, up to 20,000 UTF-16 units. Plain mode stores Markdown/HTML literally. Markdown mode supports heading (normalized to level 2), bold, italic, strikethrough, lists, flat task lists, blockquotes, code blocks and safe links. HTML remains literal; tables, images, inline code and horizontal rules are rejected.",
+            ),
+          format: z
+            .enum(["plain", "markdown"])
+            .optional()
+            .describe(
+              "Optional input format, default plain. Use markdown for rich text; requires a DailyNote backend with Markdown support. Preserve this value when retrying.",
             ),
           date: z
             .string()
@@ -97,7 +103,7 @@ export function createJournalServer(config) {
         openWorldHint: true,
       },
     },
-    async ({ text, date, requestId = randomUUID() }) => {
+    async ({ text, date, format, requestId = randomUUID() }) => {
       let result;
       let retryAfter;
       try {
@@ -109,7 +115,12 @@ export function createJournalServer(config) {
             Authorization: `Bearer ${config.token}`,
             "Content-Type": "application/json",
           },
-          body: JSON.stringify({ text, ...(date ? { date } : {}), requestId }),
+          body: JSON.stringify({
+            text,
+            ...(date ? { date } : {}),
+            ...(format ? { format } : {}),
+            requestId,
+          }),
         });
         const body = await response.json();
         if (

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dailynote-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Connect AI assistants to your DailyNote account through MCP.",
   "license": "UNLICENSED",
   "type": "module",