@tenyokjs/devdevian-cli 0.6.0-alpha.1 → 0.7.0-alpha.1

package/README.md

@@ -12,6 +12,22 @@ Login opens a browser. Compare the code shown in the terminal, sign in to Devdev
 
 Version-by-version changes and the customization roadmap: [CLI version history](VERSIONS.md).
 
+## A look inside
+
+Actual CLI captures from isolated demonstration accounts. Your terminal uses your real forum account and permissions.
+
+![Devdevian terminal feed](https://raw.githubusercontent.com/Tenyokj/devdevian/main/public/screenshots/cli-feed.png)
+
+<details>
+<summary>Code review and appearance</summary>
+
+![Side-by-side human code review](https://raw.githubusercontent.com/Tenyokj/devdevian/main/public/screenshots/cli-review.png)
+![Appearance controls](https://raw.githubusercontent.com/Tenyokj/devdevian/main/public/screenshots/cli-appearance.png)
+
+</details>
+
+Run `devdevian --help` for script commands and workspace shortcuts. Interactive help has a large wordmark and selective accents; `NO_COLOR=1` keeps it uncolored, narrow terminals use a compact heading, and redirected output stays plain.
+
 ## 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.
@@ -43,6 +59,14 @@ Calendar export from **X** writes a new `.ics` file inside the open workspace an
 
 Forms autosave locally. Successful upload IDs are retained if validation fails; edits require the latest server revision. If a publication response is lost, the CLI preserves the draft and asks you to check My projects / Hosting or attending before trying another copy. It does not automatically retry an uncertain write. Upload quotas and public visibility are the same as the website. These catalog operations are currently interactive TUI features, not separate script subcommands.
 
+## Quick actions and focused work
+
+Press **Ctrl+K** outside a form or command input, or run **/actions**, to search actions, sections and creation flows. Recent views stay in memory for the current account/session; the palette offers up to eight. Type `project 7`, `event 9` or `open 142` for an explicit ID, or choose the forum-search result for a text query. Typing stays local; actions run only after Enter. Destructive actions retain their separate confirmation. **Esc** returns to the previous view without moving your selection.
+
+Conversation, Project and Event forms show one step at a time. **Ctrl+N** validates the current step and moves forward; **Ctrl+P** returns to the previous step. **Tab** still moves through all fields and crosses steps. **Ctrl+S** checks every required field and opens the full publication preview; a missing value returns you to its step. Step changes preserve text, image paths, code selections and locally saved drafts. No upload or publication happens just by advancing a step.
+
+In full-text reading (**Space** on a reply or remark), **/** opens local text search. **Enter** locates a matching rendered line; **n / Shift+N** cycles forward/backward. **Home / End** jumps to the start/end. **Esc** returns to the underlying view, and reopening the same unchanged item restores your place. This is bounded session memory, not cross-device or permanent reading history. In text fields and the command bar, **Ctrl+K** continues to delete to the end of the line.
+
 ## Meet Devi
 
 Devi is the Devdevian mascot: a small ghost with a laptop and an orbit. The terminal uses colored ASCII art, so it needs no image protocol or image downloads. A compact drawing is used when space is limited; authentication codes, addresses and controls take priority over decoration.
@@ -142,7 +166,7 @@ Commands are examples; replace IDs, file paths and topic IDs with your own. Run
 
 A selected file is read only when explicitly named. Before publication, the client previews the payload and audience and asks for confirmation. Use `--community ID` for an approved private community, `--json` for machine-readable API output and `--yes` to explicitly publish without a prompt. Noninteractive publishing requires the relevant text flags and `--yes`. No repository discovery or background file collection runs.
 
-`--editor` uses `$VISUAL`, then `$EDITOR`, then `vi` (`notepad` on Windows). The editor is launched without a shell. File, body and API limits also apply in the terminal. This client uses ordinary HTTPS API calls, not a direct database connection, and sends no background polling traffic when idle. Device login polls every five seconds for at most ten minutes.
+`--editor` uses `$VISUAL`, then `$EDITOR`, then `vi` (`notepad` on Windows). The editor is launched without a shell. File, body and API limits also apply in the terminal. This client uses ordinary HTTPS API calls, not a direct database connection, and performs no background polling in script commands. The live workspace polls at bounded active/idle intervals unless paused or launched with `--no-live`. Device login polls every five seconds for at most ten minutes.
 
 ## Connected devices and credentials
 

package/VERSIONS.md

@@ -6,7 +6,22 @@ Every published npm artifact has a unique immutable version. We record each vers
 
 ## Current milestone
 
-**0.6.0 brings Projects and Events into the terminal**, using the same hosted data and permissions as the browser.
+**0.7.0 focuses on everyday terminal use**: discoverable quick actions, staged forms and resumable reading.
+
+## 0.7.0-alpha.1 — Everyday flow
+
+- Added a searchable quick-action workspace via `Ctrl+K` or `/actions`: scoped actions, navigation, creation, up to eight recent views, explicit ID opening and a regular forum-search fallback. Typing performs no requests or mutations; existing server permissions and confirmation dialogs still apply.
+- Conversation, Project and Event forms show one step at a time. `Ctrl+N` validates the current step and advances; `Ctrl+P` goes back. `Tab` continues to traverse fields across steps. `Ctrl+S` validates the complete form and opens the existing explicit publication preview. All draft values and file selections survive step changes.
+- Full reply/remark reading remembers positions within the current terminal session, restores the underlying view on close, and offers literal rendered-line search (`/`, `n`/`N`) plus Home/End and line-position indicators. Thread headings identify the parent reply and conversation. Reading memory is bounded and cleared on account reset.
+- Quick actions pause live reads while open. Text editing retains `Ctrl+K` for deleting to the end of the line. Compact terminal layout, themes, external editor and draft workflows remain supported.
+- No API/schema change, production-data reset or new dependency. Real pseudo-terminal checks cover staged publication into an isolated API visible to another browser account, reader search/return, scoped actions, and 60×18 navigation.
+
+## 0.6.1-alpha.1 — A clearer first impression
+
+- Added a large terminal wordmark and selective blue/violet accents to `--help`. Compact terminals, `NO_COLOR`, redirected output and JSON help remain readable without ANSI decoration.
+- Help now points to the interactive Projects/Events commands and actions. CLI documentation includes real terminal captures and install/login/workspace guidance.
+- The website introduces the CLI near the top, with keyboard-accessible screenshot tabs, copyable install/review commands and GitHub documentation links. A cached public-only activity counter updates while visible and respects reduced motion.
+- No schema migration, account/credential change or production-data reset. The CLI package and web/API keep independent versions.
 
 ## 0.6.0-alpha.1 — Projects and Events
 

package/bin/devdevian.mjs

@@ -23,6 +23,7 @@ import {
   loadAppearance,
   saveAppearance,
 } from "../lib/appearance.mjs";
+import { renderHelp } from "../lib/help.mjs";
 const version = packageInfo.version;
 const options = {
   host: { type: "string" },
@@ -113,6 +114,12 @@ const help = `Devdevian CLI ${version} · alpha
   devdevian review reopen POST_ID REVIEW_ID
   devdevian communities [--page 2]
 
+  Inside the workspace: /projects, /project ID, /events, /event ID
+  Ctrl+K or /actions opens quick actions; type to filter
+  Ctrl+N / Ctrl+P moves between form steps; Ctrl+S validates and previews
+  Full reply text: / find, n/N matches, Home/End, Esc remembers your place
+  N creates · F filters · E edits your publication · X opens context actions
+
   --theme NAME       midnight | nebula | daylight | contrast
   --accent NAME      blue | violet | cyan | rose
   --density NAME     comfortable | compact
@@ -257,7 +264,15 @@ async function login(flags) {
 }
 async function execute(args, flags) {
   if (flags.help) {
-    out(help);
+    process.stdout.write(
+      renderHelp(help, {
+        tty: !!process.stdout.isTTY,
+        columns: process.stdout.columns || 80,
+        noColor:
+          process.env.NO_COLOR !== undefined || process.env.TERM === "dumb",
+        json: !!flags.json,
+      }) + "\n",
+    );
     return;
   }
   if (flags.version) {

package/lib/help.mjs

@@ -0,0 +1,40 @@
+// Static wordmark; no terminal probes, image protocols or account reads.
+const font = {
+  D: ["████ ", "█   █", "█   █", "█   █", "████ "],
+  E: ["█████", "█    ", "████ ", "█    ", "█████"],
+  V: ["█   █", "█   █", "█   █", " █ █ ", "  █  "],
+  I: ["█████", "  █  ", "  █  ", "  █  ", "█████"],
+  A: [" ███ ", "█   █", "█████", "█   █", "█   █"],
+  N: ["█   █", "██  █", "█ █ █", "█  ██", "█   █"],
+};
+export function renderHelp(
+  text,
+  { tty = false, columns = 80, noColor = false, json = false } = {},
+) {
+  if (!tty || json) return text;
+  const paint = (value, color) =>
+    noColor ? value : `\x1b[38;5;${color}m${value}\x1b[0m`;
+  const banner =
+    columns >= 56
+      ? Array.from({ length: 5 }, (_, row) =>
+          paint(
+            [..."DEVDEVIAN"].map((c) => font[c][row]).join(" "),
+            [111, 105, 141, 177, 183][row],
+          ),
+        ).join("\n")
+      : paint("DEVDEVIAN", 141);
+  const content = text
+    .split("\n")
+    .map((line) => {
+      if (line.startsWith("Devdevian CLI")) return paint(line, 183);
+      return line.replace(
+        /^(  devdevian)(\s+[a-z]+(?:\s+(?:open|create|list|comment|thread|reply|resolve|reopen))?)?|(--[a-z][a-z-]*)/g,
+        (match, command, rest) =>
+          command
+            ? paint(command, 111) + (rest ? paint(rest, 183) : "")
+            : paint(match, 147),
+      );
+    })
+    .join("\n");
+  return `\n${banner}\n\n${content}`;
+}

package/lib/palette.mjs

@@ -0,0 +1,65 @@
+import { navigation } from "./tui-data.mjs";
+import { clean } from "./client.mjs";
+export function paletteItems({
+  query = "",
+  actions = [],
+  history = [],
+  route = {},
+} = {}) {
+  const items = actions.map((action) => ({
+    ...action,
+    id: "action:" + action.id,
+    group: "This view",
+  }));
+  navigation.forEach(([id, label, description], index) =>
+    items.push({ id: "nav:" + index, label, description, group: "Go to" }),
+  );
+  for (const [kind, label] of [
+    ["discussion", "Start a discussion"],
+    ["question", "Ask a question"],
+    ["review", "Request a code review"],
+    ["showcase", "Share what you built"],
+    ["project", "Create a project"],
+    ["event", "Create an event"],
+  ])
+    items.push({ id: "create:" + kind, label, group: "Create" });
+  const seen = new Set([JSON.stringify(route)]);
+  [...history].reverse().forEach((item) => {
+    const key = JSON.stringify(item.route);
+    if (!seen.has(key) && item.route.view !== "help") {
+      seen.add(key);
+      if (seen.size <= 9)
+        items.push({
+          id: "recent:" + key,
+          label: clean(item.label || item.route.view),
+          group: "Recent",
+          route: item.route,
+        });
+    }
+  });
+  const q = clean(query).trim().replace(/^\//, "");
+  const words = q.toLocaleLowerCase().split(/\s+/).filter(Boolean);
+  const result = items.filter((item) =>
+    words.every((word) =>
+      `${item.label} ${item.description || ""} ${item.group}`
+        .toLocaleLowerCase()
+        .includes(word),
+    ),
+  );
+  const direct = q.match(/^(?:open|project|event)\s+([1-9]\d*)$/i);
+  if (direct && Number.isSafeInteger(Number(direct[1])))
+    result.unshift({
+      id: "command",
+      command: "/" + q.toLowerCase(),
+      label: "Open " + q,
+      group: "Command",
+    });
+  if (q)
+    result.push({
+      id: "search",
+      query: q,
+      label: "Search forum for “" + q + "”",
+      group: "Search",
+    });
+  return result;
+}

package/lib/tui-data.mjs

@@ -183,7 +183,13 @@ export async function loadPage(api, route, signal) {
         ...replies.items,
       ],
       title: "Reply thread",
-      subtitle: "Replying to " + (parent?.name || route.parent.name),
+      subtitle:
+        "Reply #" +
+        route.parent.id +
+        " · " +
+        (parent?.name || route.parent.name) +
+        " · " +
+        post.title,
     };
   }
   if (route.view === "feedback") {
@@ -220,6 +226,7 @@ export function contentLines(route, data) {
     return [
       "A developer workspace, in your terminal.",
       "",
+      "Ctrl+K / /actions Search quick actions, sections and recent views",
       "Tab              Switch navigation / content / command bar",
       "↑ ↓              Select a section, conversation or reply",
       "Enter            Open the selected item",
@@ -243,7 +250,9 @@ export function contentLines(route, data) {
       "/                Focus the command / search bar",
       "Ctrl+E           Edit a multiline field in VISUAL / EDITOR",
       "Ctrl+L           Save a draft and reconnect an expired session",
-      "Ctrl+S           Preview the current form",
+      "Ctrl+N / Ctrl+P  Next / previous step in conversation/project/event forms",
+      "Ctrl+S           Validate all steps and preview the current form",
+      "Full text        / finds text; n/N cycles; Home/End; Esc remembers position",
       "Ctrl+O / Ctrl+G  Select a code file / Git diff in a review form",
       "Ctrl+O           Pick a workspace image on logo/banner/screenshot fields",
       "/drafts          Restore locally saved drafts for this account/project",

package/lib/tui-model.mjs

@@ -130,6 +130,7 @@ export function parseCommand(text) {
       "devices",
       "drafts",
       "appearance",
+      "actions",
       "projects",
       "events",
     ].includes(cmd)
@@ -143,7 +144,7 @@ export function parseCommand(text) {
     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, /drafts, /appearance, /help or /quit.",
+    "Use /feed, /inbox, /search words, /open ID, /ask, /review, /communities, /devices, /drafts, /appearance, /actions, /projects, /events, /help or /quit.",
   );
 }
 export class PageCache {

package/lib/tui.mjs

@@ -43,6 +43,14 @@ import {
   appearanceFlags,
 } from "./appearance.mjs";
 import { liveLoop, anchoredIndex } from "./live.mjs";
+import { paletteItems } from "./palette.mjs";
+import {
+  formSteps,
+  stepAt,
+  readingMatches,
+  nextReadingMatch,
+  ReadingMemory,
+} from "./workflow.mjs";
 import { contextActions } from "./context-actions.mjs";
 import { editExternal } from "./external-editor.mjs";
 import { markdownRows } from "./rich-text.mjs";
@@ -106,8 +114,13 @@ function openBrowser(url) {
   child.unref();
 }
 function fieldsFor(form) {
-  if (["catalog", "catalogFilter", "calendar"].includes(form.kind))
-    return catalogFields(form);
+  if (["catalog", "catalogFilter", "calendar"].includes(form.kind)) {
+    const fields = catalogFields(form),
+      steps = formSteps(form, fields);
+    return steps.length
+      ? steps.flatMap((step) => step.indexes.map((i) => fields[i]))
+      : fields;
+  }
   if (form.kind === "appearance") return appearanceFields;
   if (form.kind === "publication")
     return [
@@ -280,8 +293,12 @@ function FormView({ form, active, cursor, width, height }) {
   const colors = useTheme();
   const fields = fieldsFor(form),
     rows = [];
-  let selectedLine = 0;
+  const steps = formSteps(form, fields),
+    stepIndex = stepAt(steps, active, fields.length),
+    step = steps[stepIndex];
+  let selectedLine = rows.length;
   fields.forEach((field, index) => {
+    if (step && !step.indexes.includes(index)) return;
     if (index === active) selectedLine = rows.length;
     rows.push({
       text: (index === active ? "› " : "  ") + field.label,
@@ -311,7 +328,10 @@ function FormView({ form, active, cursor, width, height }) {
             )
           : 0;
       const visible = field.multiline
-          ? Math.min(4, Math.max(2, text.length))
+          ? Math.min(
+              index === active ? Math.max(1, Math.min(12, height - 3)) : 3,
+              Math.max(2, text.length),
+            )
           : 1,
         start = index === active ? Math.max(0, caretLine - visible + 1) : 0;
       rows.push(
@@ -326,15 +346,20 @@ function FormView({ form, active, cursor, width, height }) {
     rows.push("");
   });
   if (active === fields.length) selectedLine = rows.length;
-  rows.push({
-    text:
-      (active === fields.length ? "› " : "  ") +
-      (form.kind === "appearance"
-        ? "Save appearance  [Ctrl+S]"
-        : "Preview publication  [Ctrl+S]"),
-    color: colors.blue,
-    bold: true,
-  });
+  if (!step || stepIndex === steps.length - 1)
+    rows.push({
+      text:
+        (active === fields.length ? "› " : "  ") +
+        (form.kind === "appearance"
+          ? "Save appearance  [Ctrl+S]"
+          : form.kind === "catalogFilter"
+            ? "Apply filters  [Ctrl+S]"
+            : form.kind === "calendar"
+              ? "Export calendar  [Ctrl+S]"
+              : "Preview publication  [Ctrl+S]"),
+      color: colors.blue,
+      bold: true,
+    });
   const offset = Math.max(
     0,
     Math.min(selectedLine - (height >= 4 ? 1 : 0), rows.length - height),
@@ -576,6 +601,12 @@ function App({ initialConfig, flags, root, initialAppearance }) {
     [picker, setPicker] = useState(null),
     [draftSaved, setDraftSaved] = useState(false),
     [actionIndex, setActionIndex] = useState(null),
+    [palette, setPalette] = useState(null),
+    [readerFind, setReaderFind] = useState({
+      query: "",
+      cursor: 0,
+      editing: false,
+    }),
     [reviewFocus, setReviewFocus] = useState("notes"),
     [reviewLine, setReviewLine] = useState(0),
     [reviewAnchor, setReviewAnchor] = useState(null),
@@ -583,6 +614,8 @@ function App({ initialConfig, flags, root, initialAppearance }) {
     [live, setLive] = useState(!flags["no-live"]),
     [unread, setUnread] = useState(0),
     [liveStatus, setLiveStatus] = useState("");
+  const readingMemory = useRef(new ReadingMemory()),
+    readingReturn = useRef(0);
   const activity = useRef(Date.now()),
     liveView = useRef(null),
     notificationGeneration = useRef(0);
@@ -609,7 +642,10 @@ function App({ initialConfig, flags, root, initialAppearance }) {
   );
   const effectiveAppearance =
     form?.kind === "appearance" ? normalizeAppearance(form.values) : appearance;
-  const colors = themeFor(effectiveAppearance),
+  const colors = useMemo(
+      () => themeFor(effectiveAppearance),
+      [effectiveAppearance],
+    ),
     stride = effectiveAppearance.density === "compact" ? 3 : 4;
   const width = Math.max(1, columns),
     height = Math.max(1, rows - 1),
@@ -644,6 +680,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       dialog ||
       reading ||
       actionIndex !== null ||
+      palette ||
       loading ||
       pending ||
       focus === "prompt"
@@ -715,6 +752,9 @@ function App({ initialConfig, flags, root, initialAppearance }) {
   const resetAccount = () => {
     cache.current.clear();
     history.current = [];
+    readingMemory.current.clear();
+    setPalette(null);
+    setReaderFind({ query: "", cursor: 0, editing: false });
     setData(null);
     setForm(null);
     setPicker(null);
@@ -749,6 +789,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
     if (!replace)
       history.current.push({
         route,
+        label: current?.title || labelOf(route),
         index,
         scroll,
         selectedId: selected?.id,
@@ -799,6 +840,123 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       setError("");
     } else setFocus("nav");
   }
+  function readerKey(item) {
+    const kind =
+      item.entryType === "feedbackReply"
+        ? "feedbackReply"
+        : item.entryType === "note" ||
+            route.view === "feedback" ||
+            route.tab === "feedback"
+          ? "feedback"
+          : "reply";
+    return `${config?.origin}:${user?.id}:${current?.post?.id}:${kind}:${item.id}:${item.revision || ""}`;
+  }
+  const readerRows = useMemo(
+    () =>
+      reading
+        ? markdownRows(
+            reading.deleted_at
+              ? "[deleted — discussion preserved]"
+              : reading.body || "",
+            contentWidth,
+            colors,
+          )
+        : [],
+    [reading, contentWidth, colors],
+  );
+  const readerHeight = Math.max(1, contentHeight - 2);
+  const readerHits = readingMatches(readerRows, readerFind.query);
+  useEffect(() => {
+    if (reading)
+      readingMemory.current.save(
+        readerKey(reading),
+        Math.min(scroll, Math.max(0, readerRows.length - readerHeight)),
+        readerRows,
+      );
+  }, [reading, scroll, readerRows, readerHeight]);
+  function readItem(item) {
+    if (!reading) readingReturn.current = scroll;
+    const lines = markdownRows(
+      item.deleted_at ? "[deleted — discussion preserved]" : item.body || "",
+      contentWidth,
+      colors,
+    );
+    setScroll(
+      readingMemory.current.restore(readerKey(item), lines, readerHeight),
+    );
+    setReaderFind({ query: "", cursor: 0, editing: false });
+    setReading(item);
+  }
+  function closeReading() {
+    setReading(null);
+    setScroll(readingReturn.current);
+    setReaderFind({ query: "", cursor: 0, editing: false });
+  }
+  function moveStep(direction) {
+    const fields = fieldsFor(form),
+      steps = formSteps(form, fields),
+      currentStep = stepAt(steps, field, fields.length);
+    const next = currentStep + direction;
+    if (direction > 0)
+      for (const i of steps[currentStep]?.indexes || []) {
+        const f = fields[i],
+          value = form.values[f.key] || "";
+        if (f.min && value.trim().length < f.min) {
+          setField(i);
+          setCursor(graphemes(value).length);
+          setError(f.label + " needs at least " + f.min + " characters.");
+          return;
+        }
+      }
+    if (next >= steps.length) {
+      prepare();
+      return;
+    }
+    if (next < 0) return;
+    setField(steps[next].indexes[0]);
+    setCursor(
+      graphemes(form.values[fields[steps[next].indexes[0]].key] || "").length,
+    );
+    setError("");
+  }
+  const activeSteps = form ? formSteps(form, fieldsFor(form)) : [],
+    activeStep = form ? stepAt(activeSteps, field, fieldsFor(form).length) : 0;
+  const quickItems = palette
+    ? paletteItems({
+        query: palette.query,
+        actions,
+        history: history.current,
+        route,
+      })
+    : [];
+  function chooseQuick(item) {
+    if (!item) return;
+    setPalette(null);
+    if (item.route) {
+      navigate(item.route);
+      return;
+    }
+    if (item.id.startsWith("action:")) {
+      runAction(item.id.slice(7));
+      return;
+    }
+    if (item.id.startsWith("nav:")) {
+      chooseNav(Number(item.id.slice(4)));
+      return;
+    }
+    if (item.id.startsWith("create:")) {
+      const kind = item.id.slice(7);
+      if (["project", "event"].includes(kind)) composeCatalog(kind);
+      else composePublication(kind);
+      return;
+    }
+    if (item.id === "command") {
+      runCommand(item.command);
+      return;
+    }
+    if (item.id === "search")
+      navigate({ view: "search", query: item.query, page: 1 });
+  }
   async function task(work) {
     if (busy.current) return;
     busy.current = true;
@@ -1678,8 +1836,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       return;
     }
     if (route.view === "thread" && item.entryType === "parent") {
-      setReading(item);
-      setScroll(0);
+      readItem(item);
       return;
     }
     if (
@@ -1695,8 +1852,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       return;
     }
     if (route.view === "feedback") {
-      setReading(item);
-      setScroll(0);
+      readItem(item);
       return;
     }
     navigate({
@@ -1864,8 +2020,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
     }
     if (id === "read") {
       if (current?.post) {
-        setReading(selected);
-        setScroll(0);
+        readItem(selected);
       } else openSelected();
     } else if (id === "reply") reply();
     else if (id === "comment") lineFeedback();
@@ -1891,8 +2046,8 @@ function App({ initialConfig, flags, root, initialAppearance }) {
         invalidate("Received notifications marked as read.");
       });
   }
-  async function runCommand() {
-    const value = command.trim();
+  async function runCommand(override) {
+    const value = (override ?? command).trim();
     if (!value) return;
     setCommand("");
     setCommandCursor(0);
@@ -1924,6 +2079,10 @@ function App({ initialConfig, flags, root, initialAppearance }) {
         navigate({ view: parsed.command, id: parsed.arg, page: 1 });
         return;
       }
+      if (parsed.command === "actions") {
+        setPalette({ query: "", cursor: 0, index: 0 });
+        return;
+      }
       if (parsed.command === "appearance") {
         openAppearance();
         return;
@@ -2033,6 +2192,45 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       reconnect();
       return;
     }
+    if (palette) {
+      if (keyEvent.escape) {
+        setPalette(null);
+        return;
+      }
+      if (keyEvent.upArrow || keyEvent.downArrow) {
+        setPalette((old) => ({
+          ...old,
+          index: Math.max(
+            0,
+            Math.min(
+              quickItems.length - 1,
+              old.index + (keyEvent.downArrow ? 1 : -1),
+            ),
+          ),
+        }));
+        return;
+      }
+      if (keyEvent.return) {
+        chooseQuick(quickItems[palette.index]);
+        return;
+      }
+      const updated = editText(palette.query, palette.cursor, input, keyEvent, {
+        max: 120,
+      });
+      setPalette({ query: updated.value, cursor: updated.cursor, index: 0 });
+      return;
+    }
+    if (
+      keyEvent.ctrl &&
+      input === "k" &&
+      !form &&
+      !preview &&
+      focus !== "prompt"
+    ) {
+      setActionIndex(null);
+      setPalette({ query: "", cursor: 0, index: 0 });
+      return;
+    }
     if (actionIndex !== null) {
       if (keyEvent.escape || input === "x" || input === "X")
         setActionIndex(null);
@@ -2043,36 +2241,65 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       return;
     }
     if (reading) {
-      const lines = markdownRows(
-          reading.deleted_at
-            ? "[deleted — discussion preserved]"
-            : reading.body || "",
-          contentWidth,
-          colors,
-        ),
-        maximum = Math.max(0, lines.length - contentHeight);
+      const maximum = Math.max(0, readerRows.length - readerHeight);
+      if (readerFind.editing) {
+        if (keyEvent.escape) {
+          setReaderFind((old) => ({ ...old, editing: false }));
+          return;
+        }
+        if (keyEvent.return) {
+          setReaderFind((old) => ({ ...old, editing: false }));
+          if (readerHits.length)
+            setScroll(readerHits.find((n) => n >= scroll) ?? readerHits[0]);
+          return;
+        }
+        const updated = editText(
+          readerFind.query,
+          readerFind.cursor,
+          input,
+          keyEvent,
+          { max: 120 },
+        );
+        setReaderFind({
+          query: updated.value,
+          cursor: updated.cursor,
+          editing: true,
+        });
+        return;
+      }
+      if (input === "/") {
+        setReaderFind((old) => ({ ...old, editing: true }));
+        return;
+      }
+      if ((input === "n" || input === "N") && readerFind.query) {
+        setScroll(nextReadingMatch(readerHits, scroll, input === "n" ? 1 : -1));
+        return;
+      }
       if (keyEvent.escape || keyEvent.return || input === " ") {
-        setReading(null);
+        closeReading();
+        return;
+      }
+      if (keyEvent.home) {
         setScroll(0);
         return;
       }
+      if (keyEvent.end) {
+        setScroll(maximum);
+        return;
+      }
       if (keyEvent.upArrow || keyEvent.pageUp)
-        setScroll((v) =>
-          Math.max(0, v - (keyEvent.pageUp ? contentHeight : 1)),
-        );
+        setScroll((v) => Math.max(0, v - (keyEvent.pageUp ? readerHeight : 1)));
       else if (keyEvent.downArrow || keyEvent.pageDown)
         setScroll((v) =>
-          Math.min(maximum, v + (keyEvent.pageDown ? contentHeight : 1)),
+          Math.min(maximum, v + (keyEvent.pageDown ? readerHeight : 1)),
         );
       else if (input === "r") {
-        setReading(null);
+        closeReading();
         reply();
       } else if (input === "e" || input === "E") {
-        setReading(null);
+        closeReading();
         editSelected();
-      } else if (input === "d" || input === "D") {
-        deleteSelected();
-      }
+      } else if (input === "d" || input === "D") deleteSelected();
       return;
     }
     if (preview) {
@@ -2124,6 +2351,14 @@ function App({ initialConfig, flags, root, initialAppearance }) {
         setNotice("Default preview restored. Ctrl+S saves; Esc cancels.");
         return;
       }
+      if (
+        keyEvent.ctrl &&
+        ["n", "p"].includes(input) &&
+        formSteps(form, fieldsFor(form)).length
+      ) {
+        moveStep(input === "n" ? 1 : -1);
+        return;
+      }
       if (keyEvent.ctrl && input === "e") {
         externalEdit();
         return;
@@ -2409,8 +2644,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       selected &&
       ["post", "thread", "feedback"].includes(route.view)
     ) {
-      setReading(selected);
-      setScroll(0);
+      readItem(selected);
       return;
     }
     if (keyEvent.return) {
@@ -2509,7 +2743,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       ? "Saving…"
       : loading
         ? "Loading…"
-        : "Shared account · shared conversations · same permissions");
+        : "Ctrl+K quick actions · Shared account · same permissions");
   const spin =
     effectiveAppearance.motion === "reduced" ? "·" : ["◐", "◓", "◑", "◒"][tick];
   let center;
@@ -2652,6 +2886,60 @@ function App({ initialConfig, flags, root, initialAppearance }) {
         animate: true,
       }),
     );
+  } else if (palette) {
+    const count = Math.max(1, bodyHeight - 5),
+      first = Math.max(0, palette.index - count + 1);
+    center = h(
+      Box,
+      {
+        borderStyle: colors.frame,
+        borderColor: colors.purple,
+        backgroundColor: colors.panel,
+        flexDirection: "column",
+        paddingX: 1,
+        height: bodyHeight,
+        overflow: "hidden",
+      },
+      h(TextLine, {
+        text: "QUICK ACTIONS · type to filter",
+        width: width - 6,
+        color: colors.purple,
+        bold: true,
+      }),
+      h(InputText, {
+        value: palette.query,
+        cursor: palette.cursor,
+        width: width - 6,
+      }),
+      h(
+        Box,
+        { flexDirection: "column", height: count, overflow: "hidden" },
+        ...quickItems.slice(first, first + count).map((item, i) =>
+          h(
+            Text,
+            {
+              key: item.id,
+              wrap: "truncate",
+              color: first + i === palette.index ? colors.blue : colors.text,
+              backgroundColor:
+                first + i === palette.index ? colors.selected : undefined,
+            },
+            clip(
+              (first + i === palette.index ? "› " : "  ") +
+                item.label +
+                " · " +
+                item.group,
+              width - 6,
+            ),
+          ),
+        ),
+      ),
+      h(TextLine, {
+        text: "↑↓ choose · Enter open · Esc return · No action runs while typing",
+        width: width - 6,
+        color: colors.muted,
+      }),
+    );
   } else if (dialog) {
     center = h(
       Box,
@@ -2691,19 +2979,41 @@ function App({ initialConfig, flags, root, initialAppearance }) {
   } else {
     let body;
     if (reading) {
-      const lines = markdownRows(
-        reading.deleted_at
-          ? "[deleted — discussion preserved]"
-          : reading.body || "",
-        contentWidth,
-        colors,
+      const position = Math.min(
+        scroll,
+        Math.max(0, readerRows.length - readerHeight),
+      );
+      const matches = new Set(readerHits);
+      body = h(
+        Box,
+        { flexDirection: "column", height: contentHeight, overflow: "hidden" },
+        readerFind.editing
+          ? h(InputText, {
+              value: readerFind.query,
+              cursor: readerFind.cursor,
+              width: contentWidth,
+            })
+          : h(TextLine, {
+              text: readerFind.query
+                ? `Find: ${readerFind.query} · ${readerHits.length} matching lines · n next / N previous`
+                : `Reply #${reading.id} · ${stamp(reading.created)} · / find in text`,
+              width: contentWidth,
+              color: colors.muted,
+            }),
+        h(FrameRows, {
+          rows: readerRows.map((row, i) =>
+            matches.has(i) ? { ...row, bold: true, color: colors.blue } : row,
+          ),
+          width: contentWidth,
+          height: readerHeight,
+          offset: position,
+        }),
+        h(TextLine, {
+          text: `Lines ${Math.min(position + 1, readerRows.length)}–${Math.min(position + readerHeight, readerRows.length)} of ${readerRows.length} · Home / End · Esc returns`,
+          width: contentWidth,
+          color: colors.muted,
+        }),
       );
-      body = h(FrameRows, {
-        rows: lines,
-        width: contentWidth,
-        height: contentHeight,
-        offset: Math.min(scroll, Math.max(0, lines.length - contentHeight)),
-      });
     } else if (preview) {
       const payload = preview.payload,
         audience =
@@ -3021,7 +3331,9 @@ function App({ initialConfig, flags, root, initialAppearance }) {
             text: form
               ? (form.kind === "appearance"
                   ? "Local preferences · Preview now · Ctrl+S save · Esc cancel"
-                  : "Tab next field · Ctrl+E editor · Ctrl+S preview") +
+                  : (activeSteps.length
+                      ? `Step ${activeStep + 1}/${activeSteps.length} · ${activeSteps[activeStep].label} · `
+                      : "") + "Tab field · Ctrl+N/P steps · Ctrl+S preview") +
                 (draftSaved ? " · Draft saved locally" : "")
               : preview
                 ? "Scroll to review · ← → choose · Enter confirms"
@@ -3096,8 +3408,12 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       compact && focus === "nav" ? null : pane,
     );
   }
-  const hint =
-    ["projects", "events"].includes(route.view) && !form && !preview && !picker
+  const hint = palette
+    ? "Type to filter · ↑↓ choose · Enter open · Esc return"
+    : ["projects", "events"].includes(route.view) &&
+        !form &&
+        !preview &&
+        !picker
       ? "↑↓ select · Enter open · F filters · N new · [ ] pages · / search"
       : ["project", "event"].includes(route.view) && !form && !preview
         ? "↑↓ scroll · X actions · E edit your publication · Esc back"
@@ -3110,11 +3426,13 @@ function App({ initialConfig, flags, root, initialAppearance }) {
               : picker
                 ? "Project files stay local until publication is confirmed"
                 : reading
-                  ? "↑↓ scroll · R reply · E edit · D delete · Esc close"
+                  ? readerFind.editing
+                    ? "Find in this text · Enter locate · Esc finish search"
+                    : "↑↓ scroll · / find · n/N match · Home/End · Esc return"
                   : preview
                     ? "← → choose · Enter confirm · Esc edit"
                     : form
-                      ? "Tab field · Ctrl+E editor · Ctrl+O files · Ctrl+G diff · Ctrl+S preview"
+                      ? "Tab field · Ctrl+N/P steps · Ctrl+E editor · Ctrl+S preview"
                       : phase !== "ready"
                         ? "Enter connect / open browser · Ctrl+C exit"
                         : route.view === "feedback"

package/lib/workflow.mjs

@@ -0,0 +1,91 @@
+import { clean } from "./client.mjs";
+// Steps only organize local input. The existing full validation/preview still gates writes.
+export function formSteps(form, fields) {
+  let groups;
+  if (form.kind === "publication")
+    groups = [
+      ["About", ["kind", "title", "topic", "community_id"]],
+      ["Content", ["file", "lines", "review_focus", "demo_url", "body"]],
+    ];
+  else if (form.kind === "catalog")
+    groups =
+      form.entity === "project"
+        ? [
+            ["Basics", ["name", "tagline", "topic", "stage", "stack"]],
+            ["Story", ["description", "help", "problem", "audience"]],
+            ["People & links", ["url", "repo", "team", "links"]],
+            ["Images", ["logo", "screenshots"]],
+          ]
+        : [
+            [
+              "Schedule",
+              ["title", "topic", "local_start", "timezone", "duration"],
+            ],
+            ["Details", ["url", "description", "links"]],
+            ["Banner", ["banner"]],
+          ];
+  else return [];
+  return groups
+    .map(([label, keys]) => ({
+      label,
+      indexes: fields.flatMap((field, i) =>
+        keys.includes(field.key) ? [i] : [],
+      ),
+    }))
+    .filter((step) => step.indexes.length);
+}
+export function stepAt(steps, active, length) {
+  return Math.max(
+    0,
+    active === length
+      ? steps.length - 1
+      : steps.findIndex((step) => step.indexes.includes(active)),
+  );
+}
+export const rowText = (row) =>
+  clean(
+    typeof row === "string"
+      ? row
+      : (row.text ?? row.spans?.map((s) => s.text).join("") ?? ""),
+  );
+export function readingMatches(rows, query) {
+  const term = clean(query).normalize("NFKC").toLocaleLowerCase();
+  return term
+    ? rows.flatMap((row, i) =>
+        rowText(row).normalize("NFKC").toLocaleLowerCase().includes(term)
+          ? [i]
+          : [],
+      )
+    : [];
+}
+export function nextReadingMatch(matches, offset, direction = 1) {
+  if (!matches.length) return offset;
+  return direction > 0
+    ? (matches.find((n) => n > offset) ?? matches[0])
+    : ([...matches].reverse().find((n) => n < offset) ?? matches.at(-1));
+}
+export class ReadingMemory {
+  constructor(limit = 80) {
+    this.limit = limit;
+    this.items = new Map();
+  }
+  save(key, offset, rows) {
+    this.items.delete(key);
+    this.items.set(key, { offset, anchor: rowText(rows[offset] || "") });
+    while (this.items.size > this.limit)
+      this.items.delete(this.items.keys().next().value);
+  }
+  restore(key, rows, height) {
+    const entry = this.items.get(key);
+    if (!entry) return 0;
+    let offset = entry.offset;
+    if (entry.anchor && rowText(rows[offset] || "") !== entry.anchor) {
+      const found = rows.findIndex((row) => rowText(row) === entry.anchor);
+      if (found >= 0) offset = found;
+    }
+    return Math.max(0, Math.min(offset, rows.length - height));
+  }
+  clear() {
+    this.items.clear();
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenyokjs/devdevian-cli",
-  "version": "0.6.0-alpha.1",
+  "version": "0.7.0-alpha.1",
   "description": "Devdevian in your terminal: discussions, questions and human code reviews.",
   "type": "module",
   "bin": {