@perrylink/dsh-ticktick 0.1.2

package/package.json

@@ -0,0 +1,187 @@
+{
+  "name": "@perrylink/dsh-ticktick",
+  "version": "0.1.2",
+  "description": "TickTick (Dida365) task bridge for DeepSeek Harness: a Session-header task panel (list filter, quick add, complete, delete, due dates, drag reorder) over the official TickTick MCP endpoint, a Ticktick Remote service, curated agent tools, and a plugin settings card.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PerryLink/dsh-ticktick.git"
+  },
+  "homepage": "https://github.com/PerryLink/dsh-ticktick#readme",
+  "bugs": {
+    "url": "https://github.com/PerryLink/dsh-ticktick/issues"
+  },
+  "author": "PerryLink",
+  "private": false,
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./typert": {
+      "types": "./lib/types/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "probes",
+    "cordis.patch.yml",
+    "CHANGELOG.md",
+    "README.md",
+    "README.zh.md",
+    "README.es.md",
+    "README.pt.md",
+    "README.hi.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ]
+    },
+    "dshWorkshop": {
+      "schema": "omdsh-workshop-package/v1",
+      "type": "plugin",
+      "integration": {
+        "protocol": "harness-profile",
+        "artifact": "cordis.patch.yml"
+      },
+      "install": {
+        "mode": "transactional",
+        "adapter": "profile-bundle",
+        "failurePolicy": "generation-rollback",
+        "touchesCurrentBeforeActivation": false
+      },
+      "lifecycle": {
+        "activation": "restart-plugin",
+        "dispose": "supported"
+      },
+      "permissions": [
+        "browser:local-storage",
+        "settings:read",
+        "settings:write",
+        "network:https://mcp.dida365.com"
+      ],
+      "compatibility": {
+        "dshVersions": [
+          "0.1.2-rc.1"
+        ]
+      },
+      "capability": {
+        "id": "ticktick-task-panel",
+        "kind": "ui",
+        "invocation": "open the ticktick panel from a session header",
+        "expected": "the task list renders and quick add/complete/delete operations reach the configured TickTick endpoint"
+      },
+      "evidence": {
+        "install": null,
+        "failureIsolation": null,
+        "hotReload": null,
+        "remove": null
+      }
+    }
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "deepseek",
+    "cordis",
+    "ticktick",
+    "dida365",
+    "todo",
+    "task",
+    "mcp",
+    "widget"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.8 <0.2.0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.0-rc.8 <0.2.0",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.8 <0.2.0",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.8 <0.2.0",
+    "@deepseek-ai/schemastery": "^3.18.0",
+    "@deepseek-ai/dsh-api-remotes": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.1-rc.2 <0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-api-remotes": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-primitives": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.2-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.0",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^22.19.0",
+    "@types/react": "18.3.31",
+    "@types/react-dom": "18.3.7",
+    "jsdom": "^30.0.1",
+    "oxlint": "0.18.1",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "vitest": "^4.1.10"
+  },
+  "license": "Apache-2.0",
+  "funding": {
+    "type": "individual",
+    "url": "https://github.com/sponsors/PerryLink"
+  },
+  "scripts": {
+    "build": "node scripts/prepare.mjs",
+    "typecheck": "tsc --noEmit",
+    "typecheck:ci": "tsc -p tsconfig.ci.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "oxlint",
+    "verify:self-contained": "node scripts/verify-self-contained.mjs",
+    "verify:artifacts": "node scripts/verify-artifacts.mjs"
+  }
+}

package/probes/lib.mjs

@@ -0,0 +1,65 @@
+// Shared mini MCP client for the probe scripts: no dependencies, reads the
+// token from DIDA365_TOKEN (dp_ prefix, exported by the user), never logs
+// the token. Usage: $env:DIDA365_TOKEN='dp_...'; node probes/probe-xxx.mjs
+const TOKEN = process.env.DIDA365_TOKEN ?? ''
+const URL = process.env.DIDA365_MCP_URL ?? 'https://mcp.dida365.com'
+
+if (TOKEN === '') {
+  console.error('set DIDA365_TOKEN first (export $env:DIDA365_TOKEN="dp_...")')
+  process.exit(2)
+}
+
+let sessionId
+let protocolVersion
+let nextId = 1
+
+export async function call(method, params) {
+  const headers = {
+    'content-type': 'application/json',
+    accept: 'application/json, text/event-stream',
+    authorization: `Bearer ${TOKEN}`,
+  }
+  if (sessionId !== undefined) headers['mcp-session-id'] = sessionId
+  if (protocolVersion !== undefined) headers['mcp-protocol-version'] = protocolVersion
+  const response = await fetch(URL, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify({ jsonrpc: '2.0', id: nextId++, method, params: params ?? {} }),
+  })
+  const text = await response.text()
+  if (response.status !== 200 && response.status !== 202) {
+    throw new Error(`HTTP ${response.status}: ${text.slice(0, 300)}`)
+  }
+  return { message: parse(text), text }
+}
+
+function parse(text) {
+  if (text.trim() === '') return undefined
+  const dataLines = text.split(/\r?\n/).filter(line => line.startsWith('data:'))
+  if (dataLines.length > 0) return JSON.parse(dataLines[dataLines.length - 1].slice(5).trim())
+  return JSON.parse(text)
+}
+
+export async function initialize() {
+  const { message } = await call('initialize', {
+    protocolVersion: '2025-03-26',
+    capabilities: {},
+    clientInfo: { name: 'dsh-ticktick-probe', version: '0.1.0' },
+  })
+  protocolVersion = message?.result?.protocolVersion
+  await call('notifications/initialized')
+  return protocolVersion
+}
+
+export async function tool(name, args) {
+  const { message } = await call('tools/call', { name, arguments: args ?? {} })
+  if (message?.result?.isError === true) {
+    throw new Error(`tool ${name} isError: ${message.result.content.map(b => b.text).join('\n').slice(0, 300)}`)
+  }
+  return message?.result ?? {}
+}
+
+export async function listTools() {
+  const { message } = await call('tools/list', {})
+  return message?.result?.tools ?? []
+}

package/probes/probe-bootstrap.mjs

@@ -0,0 +1,10 @@
+// Probe 1: handshake + tool catalogue. Verifies the endpoint, the token,
+// the negotiated protocol version, and prints every advertised tool name
+// (the catalogue the reorder/update pins resolve from).
+import { initialize, listTools } from './lib.mjs'
+
+const version = await initialize()
+console.log(`protocolVersion: ${version}`)
+const tools = await listTools()
+console.log(`tools: ${tools.length}`)
+for (const tool of tools) console.log(`- ${tool.name}`)

package/probes/probe-crud.mjs

@@ -0,0 +1,15 @@
+// Probe 2: CRUD round trip in the Inbox — create, read back, complete,
+// delete. Verifies the wire argument shapes the service drives.
+import { initialize, tool } from './lib.mjs'
+
+await initialize()
+const created = await tool('create_task', { task: { title: `dsh-probe-${Date.now()}` } })
+const record = JSON.parse(created.content[0].text)
+console.log(`created ${record.id} in ${record.projectId}`)
+try {
+  const completed = await tool('complete_task', { project_id: record.projectId ?? 'inbox', task_id: record.id })
+  console.log('complete_task ok:', !completed.isError)
+} finally {
+  await tool('delete_task', { project_id: record.projectId ?? 'inbox', task_id: record.id })
+  console.log('deleted')
+}

package/probes/probe-due.mjs

@@ -0,0 +1,28 @@
+// Probe 3: due-date update paths. Verifies (a) inbox update, (b) the
+// update_task crash signature for project tasks and the move-to-inbox
+// detour, (c) the epoch sentinel clear. Usage: node probes/probe-due.mjs
+// [PROJECT_ID] — a project id enables the detour half.
+import { initialize, tool } from './lib.mjs'
+
+await initialize()
+const projectId = process.argv[2] ?? ''
+const created = await tool('create_task', { task: { title: `dsh-due-probe-${Date.now()}`, ...(projectId === '' ? {} : { projectId }) } })
+const record = JSON.parse(created.content[0].text)
+console.log(`created ${record.id} in ${record.projectId ?? 'inbox'}`)
+try {
+  const direct = await tool('update_task', { task_id: record.id, task: { dueDate: '2026-09-20T23:59:59+08:00' } })
+  console.log(`direct update ok: ${!direct.isError}`)
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error)
+  console.log(`direct update FAILED: ${message.slice(0, 200)}`)
+  if (/Expecting value|char 0/i.test(message) && projectId !== '') {
+    console.log('crash signature matched — probing the detour:')
+    await tool('move_task', { moves: [{ fromProjectId: projectId, toProjectId: 'inbox', taskId: record.id }] })
+    const inboxUpdate = await tool('update_task', { task_id: record.id, task: { dueDate: '2026-09-20T23:59:59+08:00' } })
+    console.log(`inbox update ok: ${!inboxUpdate.isError}`)
+    await tool('move_task', { moves: [{ fromProjectId: 'inbox', toProjectId: projectId, taskId: record.id }] })
+    console.log('moved back ok')
+  }
+}
+await tool('delete_task', { project_id: projectId === '' ? 'inbox' : projectId, task_id: record.id })
+console.log('deleted')

package/probes/probe-queries.mjs

@@ -0,0 +1,18 @@
+// Probe 5: query-tool contract discovery for the P2 backlog — completed
+// tasks by date and undone tasks by time query. Prints each tool's raw
+// result shape (no mutation). Feeds the future completed-view and search
+// features once their wire contracts are confirmed.
+import { initialize, tool } from './lib.mjs'
+
+await initialize()
+for (const [name, args] of [
+  ['list_undone_tasks_by_time_query', { query_command: 'today' }],
+  ['list_completed_tasks_by_date', { date: new Date().toISOString().slice(0, 10) }],
+]) {
+  try {
+    const result = await tool(name, args)
+    console.log(`${name}: ${JSON.stringify(result).slice(0, 500)}`)
+  } catch (error) {
+    console.log(`${name} FAILED: ${error instanceof Error ? error.message : String(error)}`)
+  }
+}

package/probes/probe-reorder.mjs

@@ -0,0 +1,24 @@
+// Probe 4: reorder semantics. Verifies the descending sortOrder list order,
+// the inbox update path, and (with PROJECT_ID) the same-project move path.
+// Usage: node probes/probe-reorder.mjs [PROJECT_ID]
+import { initialize, tool } from './lib.mjs'
+
+await initialize()
+const projectId = process.argv[2] ?? ''
+const created = await tool('create_task', { task: { title: `dsh-reorder-probe-${Date.now()}`, ...(projectId === '' ? {} : { projectId }) } })
+const record = JSON.parse(created.content[0].text)
+console.log(`created ${record.id} (sortOrder ${record.sortOrder})`)
+try {
+  if (projectId === '') {
+    await tool('update_task', { task_id: record.id, task: { sortOrder: -1 } })
+    console.log('inbox update sortOrder ok')
+  } else {
+    await tool('move_task', { moves: [{ fromProjectId: projectId, toProjectId: projectId, taskId: record.id, sortOrder: -1 }] })
+    console.log('same-project move sortOrder ok')
+  }
+} catch (error) {
+  console.log(`reorder FAILED: ${error instanceof Error ? error.message : String(error)}`)
+} finally {
+  await tool('delete_task', { project_id: projectId === '' ? 'inbox' : projectId, task_id: record.id })
+  console.log('deleted')
+}