@tenyokjs/devdevian-cli 0.1.0-alpha.1 → 0.2.0-alpha.1

package/README.md

@@ -4,12 +4,28 @@ An official terminal client for [Devdevian](https://devdevian.vercel.app), the o
 
 ```sh
 npm install -g @tenyokjs/devdevian-cli@alpha
-devdevian login
-devdevian
+devdevian open     # a separate terminal window
+# or: devdevian tui  (the current terminal)
 ```
 
 Login opens a browser. Compare the code shown in the terminal, sign in to Devdevian, then authorize the terminal. Google, GitHub and email login happen on the website; no provider credentials are collected by this package. Use `--no-open` to open the printed address yourself, including when connecting over SSH.
 
+## Live workspace
+
+The default `devdevian` command and `devdevian tui` open an alternate terminal screen. Navigation, conversations, inline forms, previews and search update in that screen; exiting restores your normal terminal. The blue and purple layout adapts to the terminal size, with compact navigation below 90 columns. Minimum size: 60 columns × 18 rows.
+
+- **Tab** switches between navigation, content and the command bar. **↑/↓** select; **Enter** opens; **Esc** goes back.
+- **/** focuses search and commands: `/feed`, `/inbox`, `/search query`, `/open 142`, `/ask`, `/review`, `/communities`, `/devices`, `/help`, `/logout`, `/quit`.
+- **←/→** switch conversation tabs; **Space** reads the selected reply/remark in full. **[ / ]** paginate; **Page Up/Down** scroll.
+- **N** creates a conversation (a community on the Communities screen); **A** asks a question; **R** replies inside a conversation; **Shift+R** refreshes.
+- **C** comments on snippet lines; **E/D** edit/delete your own feedback; **S** resolves/reopens a code remark as the publication author; **!** reports selected code feedback.
+- In forms, **Tab/Shift+Tab** change fields, arrows choose options or move the text cursor, **Enter** adds a line, **Ctrl+S** opens the preview. Publication requires a separate confirmation; Escape asks before discarding a draft. Drafts are kept in memory only.
+- **Ctrl+C** exits. With an unsent draft, confirm leaving or press Ctrl+C again.
+
+`devdevian open` launches Terminal on macOS, Windows Terminal on Windows, or GNOME Terminal/Konsole/xterm on a Linux desktop. A graphical desktop and an installed supported terminal are required; over SSH and inside an editor, use `devdevian tui`. Window launchers still need platform-specific user testing; terminal rendering and input are covered by macOS/Linux pseudo-terminal checks.
+
+Pages have a bounded 30-second in-memory cache. Refresh explicitly with Shift+R. Network errors stay inside the workspace; failed writes are never automatically retried. Existing web permissions and server validation apply to every operation.
+
 ## Everyday commands
 
 ```sh
@@ -47,6 +63,6 @@ For local development use `devdevian login --host http://127.0.0.1:4173`. Remote
 
 ## Alpha scope
 
-This first release covers login/logout, inbox, paginated feeds and search, discussions and replies, questions, code review creation, line feedback and feedback threads/status, and community discovery/private publication. Profile/media editing, events administration and moderation remain available in the browser. There is no offline mode or automatic GitHub repository synchronization.
+This alpha covers login/logout, inbox, paginated feeds and search, discussions and replies, questions, code review creation, line feedback and feedback threads/status, and community discovery, creation and private publication. Profile/media editing, events administration and moderation remain available in the browser. There is no offline mode or automatic GitHub repository synchronization.
 
 Source, contributions and issue reporting: [Tenyokj/devdevian](https://github.com/Tenyokj/devdevian). Report security issues through the repository's [security policy](https://github.com/Tenyokj/devdevian/blob/main/SECURITY.md), not a public issue containing private data. Licensed GPL-3.0-only.

package/bin/devdevian.mjs

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import packageInfo from "../package.json" with { type: "json" };
 import { parseArgs } from "node:util";
 import { readFile, writeFile, mkdtemp, rm } from "node:fs/promises";
 import { hostname, tmpdir } from "node:os";
@@ -14,7 +16,7 @@ import {
   removeConfig,
   clean,
 } from "../lib/client.mjs";
-const version = "0.1.0-alpha.1";
+const version = packageInfo.version;
 const options = {
   host: { type: "string" },
   page: { type: "string" },
@@ -71,7 +73,9 @@ const positive = (value, label = "ID") => {
 };
 const help = `Devdevian CLI ${version} · alpha
 
-  devdevian                       Interactive menu
+  devdevian                       Live terminal workspace
+  devdevian tui                   Live workspace in this terminal
+  devdevian open                  Open the workspace in a new terminal window
   devdevian login                 Authorize in your browser
   devdevian logout                Revoke this terminal
   devdevian whoami
@@ -455,59 +459,7 @@ async function execute(args, flags) {
   }
   throw Error("Unknown command. Run devdevian --help.");
 }
-async function menu(flags) {
-  const config = await loadConfig();
-  if (!config) {
-    out("Devdevian · developer commons");
-    if (
-      (await prompt("Connect your account? (yes/no)", "yes")).toLowerCase() !==
-      "yes"
-    )
-      return;
-    await login(flags);
-  }
-  const identityConfig = await loadConfig(),
-    identity = await client(identityConfig.origin, identityConfig.token)("/me");
-  while (true) {
-    out(
-      `\nDEVDEVIAN · @${identity.user.username}\n  1  Inbox\n  2  Public feed\n  3  Open conversation\n  4  Ask a question\n  5  Request code review\n  6  Communities\n  7  Review feedback\n  8  Search\n  9  Reply to a conversation\n  0  Exit`,
-    );
-    const choice = await prompt("Choose", "0");
-    if (choice === "0") return;
-    try {
-      if (choice === "1") await execute(["inbox"], flags);
-      else if (choice === "2") await execute(["feed"], flags);
-      else if (choice === "3")
-        await execute(["conversation", "open", await prompt("Post ID")], flags);
-      else if (choice === "4") await execute(["ask"], flags);
-      else if (choice === "5") await execute(["review", "create"], flags);
-      else if (choice === "6") await execute(["communities"], flags);
-      else if (choice === "7") {
-        const post = await prompt("Review post ID");
-        await execute(["review", "list", post], flags);
-        const action = await prompt(
-          "Action: thread / comment / reply / resolve / reopen / back",
-          "back",
-        );
-        if (action !== "back") {
-          const id = action === "comment" ? null : await prompt("Feedback ID");
-          const next = { ...flags };
-          if (action === "comment") {
-            next["start-line"] = await prompt("Start line");
-            next["end-line"] = await prompt("End line", next["start-line"]);
-          }
-          await execute(["review", action, post, ...(id ? [id] : [])], next);
-        }
-      } else if (choice === "9")
-        await execute(["reply", await prompt("Post ID")], flags);
-      else if (choice === "8")
-        await execute(["search", await prompt("Search")], flags);
-      else out("Choose one of the listed actions.");
-    } catch (e) {
-      out("Error: " + e.message);
-    }
-  }
-}
+
 try {
   const { values, positionals } = parseArgs({
     options,
@@ -515,8 +467,19 @@ try {
     strict: true,
   });
   if (!positionals.length && !values.help && !values.version)
-    await menu(values);
-  else await execute(positionals, values);
+    await (await import("../lib/tui.mjs")).startTui(values);
+  else if (positionals[0] === "tui")
+    await (await import("../lib/tui.mjs")).startTui(values);
+  else if (positionals[0] === "open") {
+    const args = [];
+    for (const key of ["host", "name"])
+      if (values[key]) args.push("--" + key, values[key]);
+    if (values["no-open"]) args.push("--no-open");
+    await (
+      await import("../lib/window.mjs")
+    ).openWindow({ entry: fileURLToPath(import.meta.url), args });
+    out("Devdevian opened in a separate terminal window.");
+  } else await execute(positionals, values);
 } catch (e) {
   process.stderr.write("Devdevian: " + clean(e.message) + "\n");
   process.exitCode = 1;

package/lib/client.mjs

@@ -90,7 +90,7 @@ export async function removeConfig() {
 }
 export function client(origin, token = null) {
   origin = originOf(origin);
-  return async (path, { method = "GET", body } = {}) => {
+  return async (path, { method = "GET", body, signal } = {}) => {
     if (!path.startsWith("/") || path.startsWith("//"))
       throw Error("Invalid API path.");
     let response;
@@ -104,9 +104,12 @@ export function client(origin, token = null) {
           ...(token ? { Authorization: "Bearer " + token } : {}),
         },
         body: body ? JSON.stringify(body) : undefined,
-        signal: AbortSignal.timeout(20000),
+        signal: signal
+          ? AbortSignal.any([signal, AbortSignal.timeout(20000)])
+          : AbortSignal.timeout(20000),
       });
-    } catch {
+    } catch (error) {
+      if (signal?.aborted) throw error;
       throw Error(
         "Could not reach Devdevian. Check your connection and server address.",
       );

package/lib/tui-data.mjs

@@ -0,0 +1,199 @@
+export const navigation = [
+  ["inbox", "Inbox", "Replies & mentions"],
+  ["feed", "Public feed", "Developer commons"],
+  ["open", "Open conversation", "Jump to a post"],
+  ["ask", "Ask a question", "Find a way forward"],
+  ["review", "Request code review", "Another pair of eyes"],
+  ["communities", "Communities", "Your private spaces"],
+  ["search", "Search", "Find a conversation"],
+  ["devices", "Connected terminals", "Manage CLI access"],
+  ["help", "Help", "Keys & commands"],
+];
+export async function loadPage(api, route, signal) {
+  const get = (path) => api(path, { signal }),
+    page = route.page || 1;
+  if (route.view === "feed")
+    return {
+      ...(await get("/posts?limit=12&page=" + page)),
+      title: "Public feed",
+      subtitle: "Questions, ideas and code worth discussing.",
+    };
+  if (route.view === "inbox")
+    return {
+      ...(await get("/notifications?page=" + page)),
+      title: "Inbox",
+      subtitle: "Your replies, mentions and review updates.",
+    };
+  if (route.view === "communities")
+    return {
+      ...(await get("/communities?limit=12&page=" + page)),
+      title: "Communities",
+      subtitle: "Private spaces, shared context. Enter opens a community.",
+    };
+  if (route.view === "search")
+    return {
+      ...(await get(
+        "/search?type=" +
+          (route.type || "posts") +
+          "&q=" +
+          encodeURIComponent(route.query || "") +
+          "&page=" +
+          page,
+      )),
+      title: "Search",
+      subtitle: route.query
+        ? "Results for “" + route.query + "”"
+        : "Press / and type /search followed by your query.",
+    };
+  if (route.view === "devices")
+    return {
+      ...(await get("/cli/sessions")),
+      title: "Connected terminals",
+      subtitle: "Enter to revoke a terminal. Revoking this one signs it out.",
+    };
+  if (route.view === "community") {
+    const community = await get("/communities/" + encodeURIComponent(route.id));
+    const posts = community.is_member
+      ? await get(
+          "/posts?limit=12&community=" +
+            encodeURIComponent(route.id) +
+            "&page=" +
+            page,
+        )
+      : { items: [] };
+    return {
+      ...posts,
+      community,
+      title: community.name,
+      subtitle: community.is_member
+        ? "Members-only conversations. N creates a conversation here."
+        : community.requested
+          ? "Your access request is pending."
+          : "Private community. J requests access.",
+    };
+  }
+  if (route.view === "post") {
+    const post = await get("/posts/" + route.id + "?reply_page=" + page);
+    let items = post.replies,
+      pagination = post.reply_pagination;
+    if (route.tab === "feedback") {
+      const feedback = await get(
+        "/posts/" + route.id + "/code-reviews?page=" + page,
+      );
+      items = feedback.items;
+      pagination = feedback.pagination;
+    }
+    return {
+      post,
+      items,
+      pagination,
+      title: post.title,
+      subtitle:
+        (post.community_id ? "Private community" : "Public feed") +
+        " · " +
+        post.kind +
+        " · by " +
+        post.name,
+    };
+  }
+  if (route.view === "thread") {
+    const post = await get("/posts/" + route.postId),
+      replies = await get(
+        `/posts/${route.postId}/replies?parent_id=${route.parent.id}&page=${page}`,
+      );
+    return {
+      post,
+      ...replies,
+      title: "Reply thread",
+      subtitle: "Replying to " + route.parent.name,
+    };
+  }
+  if (route.view === "feedback") {
+    const [post, notes] = await Promise.all([
+      get("/posts/" + route.postId),
+      get(`/posts/${route.postId}/code-reviews?target_id=${route.id}`),
+    ]);
+    const note = notes.items.find((item) => item.id === Number(route.id));
+    if (!note) throw Error("This feedback is no longer available.");
+    const replies = await get(
+      `/posts/${route.postId}/code-reviews/${route.id}/replies?page=${page}${route.targetReply ? "&target_id=" + route.targetReply : ""}`,
+    );
+    return {
+      post,
+      note,
+      items: [
+        { ...note, entryType: "note" },
+        ...replies.items.map((item) => ({
+          ...item,
+          entryType: "feedbackReply",
+        })),
+      ],
+      pagination: replies.pagination,
+      title: "Code feedback",
+      subtitle: `Lines ${note.start_line}–${note.end_line} · ${note.resolved ? "resolved" : "open"}`,
+    };
+  }
+  return { items: [], title: "Your workspace", subtitle: "" };
+}
+export function contentLines(route, data) {
+  if (route.view === "help")
+    return [
+      "A developer workspace, in your terminal.",
+      "",
+      "Tab              Switch navigation / content / command bar",
+      "↑ ↓              Select a section, conversation or reply",
+      "Enter            Open the selected item",
+      "Esc              Back / leave an input",
+      "← →              Switch conversation tabs",
+      "Page Up / Down   Scroll a conversation or list",
+      "N / A            New conversation / ask a question",
+      "R                Reply in a conversation; refresh a list",
+      "C                Add feedback on code lines",
+      "S                Resolve / reopen selected code feedback",
+      "E / D            Edit / delete your own feedback or reply",
+      "O                Open this conversation in your browser",
+      "/                Focus the command / search bar",
+      "Ctrl+S           Preview the current form",
+      "Ctrl+C           Exit and restore the original terminal",
+      "",
+      "Commands: /feed  /inbox  /search words  /open 142",
+      "          /ask  /review  /communities  /devices  /logout  /quit",
+      "",
+      "Text fields: arrows move the caret; Home/End move within a line.",
+      "Multiline fields: Enter adds a line; Tab changes field.",
+      "Nothing is published until you confirm the preview.",
+      "A -> Z: your browser account and this terminal use the same data.",
+    ];
+  if (route.view === "community" && !data.community?.is_member)
+    return [
+      data.community?.description || "",
+      "",
+      data.community?.requested
+        ? "Access requested. The owner or validators will review it."
+        : "Press J to request access.",
+    ];
+  if (route.view === "post" && (!route.tab || route.tab === "overview")) {
+    const p = data.post;
+    if (!p) return [];
+    const lines = [p.body || ""];
+    if (p.review_focus) lines.push("", "REVIEW FOCUS", p.review_focus);
+    if (p.code)
+      lines.push(
+        "",
+        "CODE SNIPPET",
+        ...p.code
+          .split("\n")
+          .map((line, index) => String(index + 1).padStart(4) + "  " + line),
+      );
+    if (p.links?.length)
+      lines.push(
+        "",
+        "LINKS",
+        ...p.links.map((link) => link.label + " · " + link.url),
+      );
+    if (p.archived_at || p.locked_at)
+      lines.push("", "Replies are paused for this conversation.");
+    return lines;
+  }
+  return [];
+}

package/lib/tui-model.mjs

@@ -0,0 +1,167 @@
+import stringWidth from "string-width";
+import wrapAnsi from "wrap-ansi";
+import { clean } from "./client.mjs";
+const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+export const graphemes = (value) =>
+  Array.from(segmenter.segment(value), (part) => part.segment);
+export function clip(value, width) {
+  const text = clean(value).replace(/\n/g, " ");
+  if (width <= 0) return "";
+  if (stringWidth(text) <= width) return text;
+  let result = "";
+  for (const part of graphemes(text)) {
+    if (stringWidth(result + part) > width - 1) break;
+    result += part;
+  }
+  return result + "…";
+}
+export function wrap(value, width) {
+  return wrapAnsi(clean(value).replace(/\t/g, "  "), Math.max(1, width), {
+    hard: true,
+    trim: false,
+  }).split("\n");
+}
+export function editText(
+  value,
+  cursor,
+  input,
+  key,
+  { multiline = false, max = 15000 } = {},
+) {
+  const chars = graphemes(value),
+    at = Math.max(0, Math.min(cursor, chars.length));
+  if (multiline && (key.upArrow || key.downArrow)) {
+    const start = chars.slice(0, at).lastIndexOf("\n") + 1,
+      column = at - start;
+    if (key.upArrow) {
+      if (!start) return { value, cursor: 0 };
+      const previous = chars.slice(0, start - 1).lastIndexOf("\n") + 1;
+      return { value, cursor: Math.min(start - 1, previous + column) };
+    }
+    const end = chars.indexOf("\n", at);
+    if (end < 0) return { value, cursor: chars.length };
+    const next = chars.indexOf("\n", end + 1);
+    return {
+      value,
+      cursor: Math.min(next < 0 ? chars.length : next, end + 1 + column),
+    };
+  }
+  if (key.leftArrow) return { value, cursor: Math.max(0, at - 1) };
+  if (key.rightArrow) return { value, cursor: Math.min(chars.length, at + 1) };
+  if (key.home || (key.ctrl && input === "a")) {
+    const previous = chars.slice(0, at).lastIndexOf("\n");
+    return { value, cursor: previous + 1 };
+  }
+  if (key.end || (key.ctrl && input === "e")) {
+    const next = chars.indexOf("\n", at);
+    return { value, cursor: next < 0 ? chars.length : next };
+  }
+  if (key.ctrl && input === "u") {
+    let start = chars.slice(0, at).lastIndexOf("\n") + 1;
+    return {
+      value: [...chars.slice(0, start), ...chars.slice(at)].join(""),
+      cursor: start,
+    };
+  }
+  if (key.ctrl && input === "k") {
+    const end = chars.indexOf("\n", at);
+    return {
+      value: [...chars.slice(0, at), ...(end < 0 ? [] : chars.slice(end))].join(
+        "",
+      ),
+      cursor: at,
+    };
+  }
+  if (key.backspace) {
+    if (!at) return { value, cursor: at };
+    return {
+      value: [...chars.slice(0, at - 1), ...chars.slice(at)].join(""),
+      cursor: at - 1,
+    };
+  }
+  if (key.delete)
+    return {
+      value: [...chars.slice(0, at), ...chars.slice(at + 1)].join(""),
+      cursor: at,
+    };
+  if (key.ctrl || key.meta || key.escape || key.tab)
+    return { value, cursor: at };
+  let insertion = key.return
+    ? multiline
+      ? "\n"
+      : ""
+    : clean(input).replace(/\r/g, "");
+  if (!multiline) insertion = insertion.replace(/\n/g, " ");
+  if (!insertion) return { value, cursor: at };
+  const remaining = Math.max(0, max - value.length),
+    parts = [];
+  let length = 0;
+  for (const part of graphemes(insertion)) {
+    if (length + part.length > remaining) break;
+    parts.push(part);
+    length += part.length;
+  }
+  return {
+    value: [...chars.slice(0, at), ...parts, ...chars.slice(at)].join(""),
+    cursor: at + parts.length,
+  };
+}
+export function cursorLines(value, cursor, width) {
+  const parts = graphemes(value),
+    lines = wrap(
+      parts.slice(0, cursor).join("") + "▏" + parts.slice(cursor).join(""),
+      width,
+    );
+  const marker = lines.findIndex((line) => line.includes("▏"));
+  return { lines, line: Math.max(0, marker) };
+}
+export function parseCommand(text) {
+  const [cmd, ...rest] = text.trim().replace(/^\//, "").split(/\s+/);
+  const arg = rest.join(" ");
+  if (
+    [
+      "feed",
+      "inbox",
+      "communities",
+      "search",
+      "ask",
+      "review",
+      "help",
+      "devices",
+    ].includes(cmd)
+  )
+    return { command: cmd, arg };
+  if (
+    cmd === "open" &&
+    /^[1-9]\d*$/.test(arg) &&
+    Number.isSafeInteger(Number(arg))
+  )
+    return { command: cmd, arg: Number(arg) };
+  if (["quit", "logout"].includes(cmd)) return { command: cmd };
+  throw Error(
+    "Use /feed, /inbox, /search words, /open ID, /ask, /review, /communities, /devices, /help or /quit.",
+  );
+}
+export class PageCache {
+  constructor({ max = 40, ttl = 30000 } = {}) {
+    this.rows = new Map();
+    this.max = max;
+    this.ttl = ttl;
+  }
+  get(key) {
+    const row = this.rows.get(key);
+    if (!row || Date.now() - row.time > this.ttl) return null;
+    this.rows.delete(key);
+    this.rows.set(key, row);
+    return row.value;
+  }
+  set(key, value) {
+    this.rows.delete(key);
+    this.rows.set(key, { value, time: Date.now() });
+    while (this.rows.size > this.max)
+      this.rows.delete(this.rows.keys().next().value);
+  }
+  clear() {
+    this.rows.clear();
+  }
+}