mirrors/pikasTech-unidesk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: migrate todo note to nc01 github storage

Browse Source
This commit is contained in:
Codex
2026-07-10 03:47:30 +02:00
parent e11c140b09
commit 0184bd7334
57 changed files with 3738 additions and 350 deletions
Download Patch File Download Diff File Expand all files Collapse all files
scripts/src/microservices.ts
+23 -17
View File
@@ -4,20 +4,17 @@ import { runCommand } from "./command";
import { type UniDeskConfig, repoRoot } from "./config";
import { jsonByteLength, previewJson } from "./preview";
// Todo Note misleading-404 rewrite (issue #198) — CLI-side interim workaround
// for the upstream todo_note catch-all handler. The upstream repo
// (https://gitee.com/Lyon1998/todo_note) wraps every unregistered path in
// Todo Note misleading-404 rewrite (issue #198) for legacy deployments.
// The historical service wrapped every unregistered path in
// `404 {"ok":false,"error":"Todo Note is running in backend-only mode"}`,
// which makes agents and humans misdiagnose a path typo as a write lock.
// When the upstream fix lands, this rewrite becomes a no-op: the upstream
// body will not match `isTodoNoteMisleadingRouteNotFoundBody` anymore and
// The vendored service returns normal route errors, so this becomes a no-op:
// its body does not match `isTodoNoteMisleadingRouteNotFoundBody` and
// the CLI will pass the upstream response through unchanged.
//
// Source of truth for the writable endpoint list below is
// docs/reference/microservices.md "Todo Note On Main Server" and
// apps/server/src/server.ts in the upstream todo_note repo. If the
// upstream registered routes change, update TODO_NOTE_WRITABLE_ENDPOINTS
// and TODO_NOTE_ACTION_TYPES in lock-step.
// src/components/microservices/todo-note/src/index.ts. Keep the catalog and
// action types aligned with that service.
interface TodoNoteEndpoint {
method: string;
@@ -38,6 +35,8 @@ export const TODO_NOTE_ACTION_TYPES = [
] as const;
export const TODO_NOTE_WRITABLE_ENDPOINTS: readonly TodoNoteEndpoint[] = [
{ method: "POST", path: "/api/storage/import", hint: "Import a confirmed snapshot or gzip-packed migration request." },
{ method: "POST", path: "/api/storage/migrate", hint: "Persist the current runtime index to the configured GitHub store." },
{ method: "POST", path: "/api/instances", hint: "Create a new todo list; body {name}." },
{ method: "DELETE", path: "/api/instances/:instanceId", hint: "Delete a todo list." },
{
@@ -673,6 +672,15 @@ function methodOption(args: string[], hasBody = false): string {
return method;
}
export function parseMicroserviceProxyRequest(args: string[]): { body: unknown | undefined; method: string; checkPath: boolean } {
const body = requestBodyOption(args);
return {
body,
method: methodOption(args, body !== undefined),
checkPath: hasFlag(args, "--check-path"),
};
}
export function summarizeMicroserviceProxyResponse(response: unknown, args: string[]): unknown {
const full = args.includes("--full");
const raw = args.includes("--raw");
@@ -969,16 +977,14 @@ export async function runMicroserviceCommand(_config: UniDeskConfig, args: strin
if (action === "proxy") {
const id = requireId(idArg, "microservice proxy");
const path = requireProxyPath(pathArg);
const body = requestBodyOption(args);
const request = parseMicroserviceProxyRequest(args);
const full = hasFlag(args, "--full");
const raw = hasFlag(args, "--raw");
const checkPath = hasFlag(args, "--check-path");
const method = methodOption(args, body !== undefined);
if (checkPath) {
if (request.checkPath) {
if (id !== "todo-note") {
return {
ok: false,
command: `microservice proxy ${id} ${path} --method ${method} --check-path`,
command: `microservice proxy ${id} ${path} --method ${request.method} --check-path`,
data: {
ok: false,
error: `--check-path currently only supports service=todo-note; got ${id}`,
@@ -987,12 +993,12 @@ export async function runMicroserviceCommand(_config: UniDeskConfig, args: strin
},
};
}
return runTodoNoteCheckPath(method, path);
return runTodoNoteCheckPath(request.method, path);
}
const maxBodyBytes = full ? numberOption(args, "--max-body-bytes", 5_000_000) : cappedNumberOption(args, "--max-body-bytes", raw ? 120_000 : 60_000, 500_000);
const maxResponseBytes = full ? Math.min(Math.max(maxBodyBytes, 120_000), 5_000_000) : Math.min(Math.max(maxBodyBytes * 3, 240_000), 1_500_000);
const fetched = coreInternalFetch(`/api/microservices/${encodeId(id)}/proxy${path}`, { method, body, maxResponseBytes });
const rewritten = rewriteTodoNoteMisleadingRouteNotFound(id, method, path, fetched);
const fetched = coreInternalFetch(`/api/microservices/${encodeId(id)}/proxy${path}`, { method: request.method, body: request.body, maxResponseBytes });
const rewritten = rewriteTodoNoteMisleadingRouteNotFound(id, request.method, path, fetched);
return summarizeMicroserviceProxyResponse(rewritten, args);
}
throw new Error("microservice command must be one of: list, status, health, diagnostics, tunnel-self-test, proxy");