dailynote-mcp 0.0.0-stage → 0.1.0

package/INSTALL_CODEX.md

@@ -0,0 +1,158 @@
+# Memasang DailyNote MCP di Codex
+
+MCP lokal ini menyediakan satu tool, `add_journal_entry`. Setiap pengguna memakai
+token dari akun DailyNote sendiri. Token diteruskan melalui environment variable;
+tidak perlu file `.env` atau menyimpan token di konfigurasi Codex.
+
+## 1. Siapkan Node.js dan aplikasi DailyNote
+
+Pasang Node.js 24 beserta npm dari [nodejs.org](https://nodejs.org/).
+Periksa dari terminal:
+
+```sh
+node --version
+npx --version
+```
+
+Node harus menunjukkan versi `v24.x`. Pengguna tidak perlu clone proyek,
+memasang pnpm, menjalankan database, atau melakukan migration.
+Aplikasi DailyNote tujuan harus sudah berjalan dan mendukung fitur Token API
+serta endpoint MCP. Pengembang aplikasi menyiapkan backend tersebut.
+
+## 2. Gunakan package npm
+
+Konfigurasi berikut memakai `dailynote-mcp@0.1.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.
+
+## 3. Buat token pribadi
+
+Login ke DailyNote, buka **Profil → Token API → Buat token**, lalu salin token.
+Token lengkap hanya ditampilkan sekali. Jika perlu mengganti token yang sudah
+ada, pilih **Buat token baru**; token lama akan dinonaktifkan.
+
+Jangan kirim token ke chat, Git, atau GitHub Actions. Pengguna lain melakukan
+langkah yang sama memakai akun dan komputernya sendiri.
+
+## 4. Isi environment sesi macOS
+
+Contoh berikut memakai terminal **zsh** bawaan macOS. Tempel token ketika diminta;
+input disembunyikan dan token tidak ditulis secara literal dalam riwayat command.
+
+```sh
+export DAILYNOTE_URL="https://alamat-aplikasi-anda.example"
+read -rs 'DAILYNOTE_TOKEN?Token API DailyNote: '
+printf '\n'
+export DAILYNOTE_TOKEN
+launchctl setenv DAILYNOTE_URL "$DAILYNOTE_URL"
+launchctl setenv DAILYNOTE_TOKEN "$DAILYNOTE_TOKEN"
+```
+
+Ganti alamat contoh dengan origin HTTPS aplikasi DailyNote Anda, tanpa path,
+query, atau fragment. Token harus berasal dari akun pada aplikasi tujuan
+tersebut. `http://localhost:3000` hanya untuk development lokal.
+
+`export` mengatur terminal saat ini. `launchctl setenv` membuat aplikasi desktop
+yang dibuka setelahnya menerima variabel pada sesi login macOS ini. Variabel
+tersebut harus diisi ulang setelah logout/restart komputer. Jangan menambahkan
+token ke `.zshrc`, `.env`, atau `config.toml` bila ingin tetap tanpa file token.
+
+Untuk Codex CLI, jalankan `codex` dari terminal yang sudah menerima `export`.
+Untuk Codex desktop, tutup penuh aplikasi dengan **Quit Codex**, lalu buka lagi
+setelah langkah ini. Aplikasi yang sudah berjalan belum menerima environment baru.
+
+## 5. Daftarkan MCP
+
+Buka konfigurasi Codex `~/.codex/config.toml`. Tambahkan blok berikut, atau
+perbarui blok `dailynote-journal` yang sudah ada; pertahankan konfigurasi lainnya.
+
+```toml
+[mcp_servers.dailynote-journal]
+command = "npx"
+args = ["-y", "dailynote-mcp@0.1.0"]
+env_vars = ["DAILYNOTE_URL", "DAILYNOTE_TOKEN"]
+enabled_tools = ["add_journal_entry"]
+```
+
+Jika Codex tidak menemukan `npx`, ganti `command` dengan path absolut hasil
+`command -v npx`. Tidak ada path source code DailyNote dalam konfigurasi ini.
+`env_vars` berisi nama variabel yang diteruskan Codex,
+bukan nilai token. Konfigurasi ini mengikuti
+[dokumentasi resmi OpenAI](https://developers.openai.com/codex/mcp/).
+
+Jika sebelumnya memakai source lokal, ganti `command`/`args` dalam blok yang
+sama dengan konfigurasi di atas setelah versi npm tersedia. Pertahankan
+`env_vars`; jangan membuat koneksi kedua karena tool akan muncul ganda.
+
+## 6. Periksa koneksi
+
+Dari terminal mana pun:
+
+```sh
+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
+perlu tampil.
+Setelah Codex desktop dibuka ulang, buka chat baru dan pastikan tool
+`add_journal_entry` tersedia.
+
+## 7. Coba input jurnal
+
+Di chat yang sudah memuat MCP:
+
+> Gunakan DailyNote MCP untuk menambahkan "Tes koneksi MCP dari Codex" ke jurnal hari ini.
+
+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.
+
+## Mengganti atau melepas koneksi
+
+Untuk mengganti token, buat token baru di profil, ulangi langkah 4 dan buka ulang
+Codex. Untuk mencabut akses, gunakan **Cabut token** di DailyNote.
+
+Untuk menghapus pendaftaran MCP dan variabel sesi macOS:
+
+```sh
+codex mcp remove dailynote-journal
+launchctl unsetenv DAILYNOTE_URL
+launchctl unsetenv DAILYNOTE_TOKEN
+unset DAILYNOTE_URL DAILYNOTE_TOKEN
+```
+
+Proses yang sudah berjalan tetap memegang salinan environment lamanya sampai
+ditutup. Menghapus konfigurasi lokal tidak mencabut token atau menghapus jurnal.
+
+## Jika bermasalah
+
+- Server tidak bisa dimulai: periksa Node.js 24, path npx, akses registry, dan kedua
+  environment variable.
+- `unauthorized`: token dicabut/diganti, salah disalin, atau berasal dari aplikasi
+  tujuan lain.
+- Koneksi gagal: pastikan aplikasi tujuan hidup, URL/port tepat, dan gunakan HTTPS
+  untuk production.
+- `outcome_unknown`: periksa jurnal atau retry dengan requestId lama.
+- Tool belum terlihat: quit dan buka ulang Codex setelah environment diisi;
+  buka chat baru.
+
+## Commands to run
+
+Wajib: ikuti langkah 1–6 berurutan. Semua command pemasangan pengguna dapat
+dijalankan dari terminal lokal mana pun, tanpa folder proyek. Pemeriksaan akhir:
+
+```sh
+codex mcp get dailynote-journal
+```
+
+Hasil yang diharapkan: koneksi stdio aktif, versi npm tertentu pada argumen,
+dan satu tool `add_journal_entry` tersedia pada chat baru.
+
+Pengguna package tidak perlu menjalankan suite tes atau build aplikasi. Jika
+pemasangan gagal, kirim command, exit status, dan cuplikan error relevan tanpa
+token atau isi jurnal privat.

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# DailyNote MCP
 
-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.
+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.
+
+## Hubungkan ke Codex
+
+1. Login ke DailyNote, buka **Profil → Token API → Buat token**, lalu salin token.
+2. Atur `DAILYNOTE_URL` dan `DAILYNOTE_TOKEN` di environment proses Codex.
+   Gunakan alamat HTTPS aplikasi DailyNote Anda, tanpa path tambahan. HTTP hanya
+   didukung untuk localhost/loopback saat development. Token berasal dari akun
+   Anda pada aplikasi tujuan tersebut.
+3. Gabungkan konfigurasi ini ke `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.dailynote-journal]
+command = "npx"
+args = ["-y", "dailynote-mcp@0.1.0"]
+env_vars = ["DAILYNOTE_URL", "DAILYNOTE_TOKEN"]
+enabled_tools = ["add_journal_entry"]
+```
+
+4. Tutup penuh dan buka ulang Codex setelah environment diisi. Buka chat baru.
+
+`npx` mengunduh package beserta dependency pada penggunaan pertama, kemudian
+menjalankan MCP. Tidak perlu menjalankan server MCP di terminal terpisah.
+Jika Codex tidak menemukan `npx`, gunakan path absolut hasil `command -v npx`.
+
+[Panduan pemasangan langkah demi langkah](./INSTALL_CODEX.md), termasuk cara
+mengisi environment sesi macOS tanpa file token. Konfigurasi stdio mengikuti
+[dokumentasi resmi OpenAI](https://developers.openai.com/codex/mcp/).
+
+Contoh untuk Claude Desktop ada di `claude-desktop.example.json`. Client harus
+mewarisi kedua environment variable saat dibuka; contoh tidak menyimpan token
+atau mengandalkan interpolasi environment dalam JSON.
+
+## Tool yang tersedia
+
+Saat ini ada satu tool: **`add_journal_entry`**.
+
+```json
+{
+  "text": "Menyelesaikan pekerjaan dan dokumentasi hari ini.",
+  "date": "2026-11-05"
+}
+```
+
+- `text`: teks biasa, maksimum 20.000 unit UTF-16. Baris baru menjadi paragraf;
+  HTML dan Markdown disimpan sebagai teks literal.
+- `date`: opsional, format `YYYY-MM-DD`. Default hari ini mengikuti timezone akun.
+- `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 permintaan di Codex:
+
+> Gunakan DailyNote MCP untuk menambahkan "Tes koneksi dari Codex" ke jurnal hari ini.
+
+Permintaan tersebut menulis jurnal akun pemilik token. Hasil sukses berisi
+tanggal, status `saved`, dan `requestId`; isi jurnal tidak dikembalikan.
+
+## Token dan retry
+
+Setiap pengguna memakai token pribadi dari akunnya sendiri. Server membaca
+`DAILYNOTE_URL` dan `DAILYNOTE_TOKEN` dari environment; tidak memuat file `.env`.
+Jangan kirim token ke chat atau memasukkannya ke konfigurasi publik.
+
+**Buat token baru** menonaktifkan token lama. Setelah rotasi, perbarui environment
+dan buka ulang client. **Cabut token** di profil menghentikan akses token tersebut.
+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
+ditolak; mengganti token tidak menghilangkan deduplikasi akun.
+
+Jika proses berhenti sebelum requestId diterima, periksa jurnal lewat aplikasi
+sebelum mengirim ulang.

package/claude-desktop.example.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "dailynote-journal": {
+      "command": "npx",
+      "args": ["-y", "dailynote-mcp@0.1.0"]
+    }
+  }
+}

package/codex.example.toml

@@ -0,0 +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"]
+env_vars = ["DAILYNOTE_URL", "DAILYNOTE_TOKEN"]
+enabled_tools = ["add_journal_entry"]

package/journal.mjs

@@ -0,0 +1,149 @@
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/server";
+import packageInfo from "./package.json" with { type: "json" };
+
+export function readConfig(env) {
+  const origin = new URL(env.DAILYNOTE_URL ?? "");
+  if (
+    origin.username ||
+    origin.password ||
+    origin.search ||
+    origin.hash ||
+    origin.pathname !== "/" ||
+    !(
+      origin.protocol === "https:" ||
+      (origin.protocol === "http:" &&
+        ["localhost", "127.0.0.1", "[::1]"].includes(origin.hostname))
+    )
+  )
+    throw new Error(
+      "DAILYNOTE_URL must be an HTTPS origin or HTTP loopback origin.",
+    );
+  const token = env.DAILYNOTE_TOKEN ?? "";
+  if (!/^[A-Za-z0-9_-]{43,128}$/.test(token) || token.startsWith("replace-"))
+    throw new Error(
+      "DAILYNOTE_TOKEN must contain a personal API token from your DailyNote profile.",
+    );
+  return { endpoint: new URL("/api/mcp/journal-entry", origin), token };
+}
+
+const validDate = (value) => {
+  if (
+    typeof value !== "string" ||
+    !/^\d{4}-\d{2}-\d{2}$/.test(value) ||
+    Number(value.slice(0, 4)) < 1000
+  )
+    return false;
+  const date = new Date(`${value}T00:00:00Z`);
+  return (
+    Number.isFinite(date.valueOf()) && date.toISOString().slice(0, 10) === value
+  );
+};
+
+const safeCodes = new Set([
+  "unauthorized",
+  "forbidden",
+  "rate_limited",
+  "invalid_input",
+  "invalid_content",
+  "conflict",
+  "idempotency_conflict",
+  "outcome_unknown",
+  "payload_too_large",
+  "request_timeout",
+  "unsupported_media_type",
+]);
+
+export function createJournalServer(config) {
+  const server = new McpServer({
+    name: packageInfo.name,
+    version: packageInfo.version,
+  });
+  server.registerTool(
+    "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.",
+      inputSchema: z
+        .object({
+          text: z
+            .string()
+            .min(1)
+            .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.",
+            ),
+          date: z
+            .string()
+            .refine(validDate)
+            .optional()
+            .describe(
+              "Optional calendar date YYYY-MM-DD in the account timezone.",
+            ),
+          requestId: z
+            .uuid()
+            .optional()
+            .describe(
+              "Leave empty for a new entry. Reuse the returned ID with identical text/date to safely retry an uncertain request.",
+            ),
+        })
+        .strict(),
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+      },
+    },
+    async ({ text, date, requestId = randomUUID() }) => {
+      let result;
+      let retryAfter;
+      try {
+        const response = await fetch(config.endpoint, {
+          method: "POST",
+          redirect: "error",
+          signal: AbortSignal.timeout(30_000),
+          headers: {
+            Authorization: `Bearer ${config.token}`,
+            "Content-Type": "application/json",
+          },
+          body: JSON.stringify({ text, ...(date ? { date } : {}), requestId }),
+        });
+        const body = await response.json();
+        if (
+          response.ok &&
+          body.ok === true &&
+          body.data?.status === "saved" &&
+          validDate(body.data.date) &&
+          body.data.requestId === requestId
+        ) {
+          result = { date: body.data.date, status: "saved", requestId };
+        } else {
+          const code = safeCodes.has(body.error?.code)
+            ? body.error.code
+            : "outcome_unknown";
+          retryAfter = Number(response.headers.get("Retry-After"));
+          result = { status: "error", code, requestId };
+        }
+      } catch {
+        // A timed-out or lost response may already have committed. Never retry
+        // automatically or include remote diagnostics, URLs, token or input text.
+        result = { status: "error", code: "outcome_unknown", requestId };
+      }
+      if (
+        result.code === "rate_limited" &&
+        Number.isInteger(retryAfter) &&
+        retryAfter > 0
+      )
+        result.retryAfterSeconds = Math.min(retryAfter, 3600);
+      return {
+        content: [{ type: "text", text: JSON.stringify(result) }],
+        structuredContent: result,
+        ...(result.status === "error" ? { isError: true } : {}),
+      };
+    },
+  );
+  return server;
+}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "dailynote-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Connect AI assistants to your DailyNote account through MCP.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "bin": {
+    "dailynote-mcp": "server.mjs"
+  },
+  "files": [
+    "server.mjs",
+    "journal.mjs",
+    "INSTALL_CODEX.md",
+    "codex.example.toml",
+    "claude-desktop.example.json"
+  ],
+  "keywords": [
+    "dailynote",
+    "mcp",
+    "model-context-protocol",
+    "journal"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=24 <25"
+  },
+  "packageManager": "pnpm@11.10.0",
+  "scripts": {
+    "start": "node server.mjs",
+    "test": "node --test server.test.mjs",
+    "test:package": "node --test package.test.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "2.4.0",
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/client": "2.4.0"
+  }
+}

package/server.mjs

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
+import { createJournalServer, readConfig } from "./journal.mjs";
+
+try {
+  const server = createJournalServer(readConfig(process.env));
+  const close = async () => {
+    await server.close();
+  };
+  process.once("SIGINT", close);
+  process.once("SIGTERM", close);
+  await server.connect(new StdioServerTransport());
+} catch {
+  // stdout is exclusively the MCP protocol; diagnostics never include secrets.
+  console.error(
+    "DailyNote MCP could not start. Set DAILYNOTE_URL and DAILYNOTE_TOKEN in the client environment and check installed dependencies.",
+  );
+  process.exitCode = 1;
+}