@tenyokjs/devdevian-cli 0.6.1-alpha.1 → 0.7.1-alpha.1

package/README.md

@@ -38,7 +38,7 @@ The default `devdevian` command and `devdevian tui` open an alternate terminal s
 - **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 ordinary replies or code feedback; **S** resolves/reopens a code remark or accepts/removes a reply as the solution (question/review author only); **!** reports selected code feedback.
 - **Ctrl+E** opens the current multiline field in `$VISUAL` / `$EDITOR` (use `code --wait` for VS Code). Closing the editor restores the form; publishing still requires preview and confirmation. **Ctrl+L** saves an active draft and returns to sign-in.
-- 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 auto-save locally after a short pause and can be restored from **Local drafts** or `/drafts`.
+- In forms, **Tab/Shift+Tab** change fields or focus the step controls, arrows choose options or move the text cursor, **Enter** adds a line inside multiline text, and **Ctrl+S** opens the preview. Publication requires a separate confirmation; Escape asks before discarding a draft. Drafts auto-save locally after a short pause and can be restored from **Local drafts** or `/drafts`.
 - **Ctrl+C** exits. With an unsent draft, confirm saving and leaving or press Ctrl+C again to force exit.
 
 `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.
@@ -59,6 +59,16 @@ 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 / Shift+Tab** move through the current step and its **Back / Next** controls. Use arrows to choose a control and **Enter** to activate it; the last step offers **Preview**, not immediate publication. **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.
+
+Active fields explain their input: Space stays a space, Enter adds a line in multiline fields, and Tab leaves the field. Project feedback accepts text and URLs; dedicated website/repository/additional links are in **People & links**. Additional links use one `Label | https://example.com` per line. Context hints stay below the editor on larger terminals and use the status/hint lines on compact ones. **Ctrl+S** checks the complete form and opens a preview; drafts autosave locally and publication still requires explicit confirmation.
+
 ## 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.
@@ -158,7 +168,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,23 @@ 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.1-alpha.1 — Clearer forms
+
+- Added visible, keyboard-focusable Back / Next controls to staged forms. Tab reaches the controls at step boundaries, arrows choose an available action and Enter activates it. The final action is Preview; publication remains a separate confirmation. Ctrl+N/P shortcuts remain available.
+- Pinned input guidance distinguishes Space, multiline Enter, field navigation and image/code pickers. Project help explicitly points to the dedicated People & links step. Compact layouts prioritize the caret and keep guidance in status/hint lines.
+- Clarified additional-link syntax, preview versus autosaved drafts, and optional URL fields. Opening a new form clears stale success notices.
+- Regression coverage publishes a project through the real terminal and isolated API, checks text spaces/newlines and multiple labeled links from a second account, exercises Back/Next/Preview, preserves Git/image selections and checks multiline editing at 60×18.
+- No API/schema change, new dependency or production-data reset. Per-version history is recorded here; no separate GitHub release is required for this patch.
+
+## 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
 

package/bin/devdevian.mjs

@@ -115,7 +115,11 @@ const help = `Devdevian CLI ${version} · alpha
   devdevian communities [--page 2]
 
   Inside the workspace: /projects, /project ID, /events, /event ID
-  N creates · F filters · E edits your publication · X opens actions
+  Ctrl+K or /actions opens quick actions; type to filter
+  Ctrl+N / Ctrl+P moves between form steps; Ctrl+S validates and previews
+  Forms: Tab fields/buttons, Enter selects Back/Next or adds a line in multiline text
+  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

package/lib/form-guidance.mjs

@@ -0,0 +1,38 @@
+export function fieldGuidance(field, { wizard = false, project = false } = {}) {
+  if (!field)
+    return {
+      detail: "",
+      keys: wizard
+        ? "Enter selects the highlighted action"
+        : "Enter opens the preview",
+    };
+  let detail = field.hint || "";
+  if (project && field.key === "help")
+    detail =
+      "Text and links are allowed. Dedicated links: People & links step.";
+  if (["url", "repo", "demo_url"].includes(field.key) && !detail)
+    detail = "Use a complete https:// or http:// URL.";
+  if (["logo", "banner"].includes(field.key))
+    return { detail, keys: "Ctrl+O selects an image · Tab next field" };
+  if (field.key === "file")
+    return { detail, keys: "Ctrl+O file · Ctrl+G Git diff · Tab next field" };
+  const keys = field.options
+    ? "← / → choose · Tab next field"
+    : field.multiline
+      ? "Space inserts a space · Enter adds a line · Tab next field"
+      : "Space inserts a space · Enter / Tab next field";
+  return { detail, keys };
+}
+export function stepControls(steps, index) {
+  return [
+    { id: "back", label: "← Back", enabled: index > 0 },
+    {
+      id: "next",
+      label:
+        index === steps.length - 1
+          ? "Preview →"
+          : "Next: " + steps[index + 1]?.label + " →",
+      enabled: true,
+    },
+  ];
+}

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,15 @@ import {
   appearanceFlags,
 } from "./appearance.mjs";
 import { liveLoop, anchoredIndex } from "./live.mjs";
+import { fieldGuidance, stepControls } from "./form-guidance.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 +115,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 [
@@ -276,17 +290,29 @@ function InputText({ value, cursor, width, height = 1 }) {
     }),
   );
 }
-function FormView({ form, active, cursor, width, height }) {
+function FormView({ form, active, cursor, width, height, navFocus }) {
   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];
+  const guidance = fieldGuidance(navFocus ? null : fields[active], {
+    wizard: !!step,
+    project: form.kind === "catalog" && form.entity === "project",
+  });
+  const helpRows =
+      form.kind === "appearance" ? 0 : height >= 8 ? 2 : height >= 5 ? 1 : 0,
+    navRows = step && height >= 3 ? 1 : 0;
+  const editorHeight = Math.max(1, height - helpRows - navRows);
+  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,
-      color: index === active ? colors.purple : colors.muted,
-      bold: index === active,
+      text: (index === active && !navFocus ? "› " : "  ") + field.label,
+      color: index === active && !navFocus ? colors.purple : colors.muted,
+      bold: index === active && !navFocus,
     });
     if (field.options) {
       const option = field.options.find(
@@ -295,12 +321,12 @@ function FormView({ form, active, cursor, width, height }) {
       rows.push({
         text:
           "  ‹ " + (option?.[1] || form.values[field.key] || "Choose") + " ›",
-        color: index === active ? colors.blue : colors.text,
+        color: index === active && !navFocus ? colors.blue : colors.text,
       });
     } else {
       const value = form.values[field.key] || "";
       const text =
-        index === active
+        index === active && !navFocus
           ? cursorLines(value, cursor, width - 3).lines
           : wrap(value || "…", width - 3);
       const caretLine =
@@ -311,35 +337,90 @@ 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, editorHeight - 2))
+                : 3,
+              Math.max(2, text.length),
+            )
           : 1,
         start = index === active ? Math.max(0, caretLine - visible + 1) : 0;
       rows.push(
         ...text.slice(start, start + visible).map((line) => ({
           text: "  " + line,
-          color: index === active ? colors.text : colors.muted,
+          color: index === active && !navFocus ? colors.text : colors.muted,
         })),
       );
     }
-    if (field.hint && active === index)
-      rows.push({ text: "  " + field.hint, color: colors.muted });
     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)
+    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),
+    Math.min(
+      selectedLine - (editorHeight >= 4 ? 1 : 0),
+      rows.length - editorHeight,
+    ),
+  );
+  return h(
+    Box,
+    { flexDirection: "column", height, overflow: "hidden" },
+    h(FrameRows, { rows, width, height: editorHeight, offset }),
+    helpRows === 2
+      ? h(TextLine, {
+          text:
+            guidance.detail ||
+            (form.kind === "catalogFilter"
+              ? "Ctrl+S applies these filters."
+              : form.kind === "calendar"
+                ? "Ctrl+S exports a new calendar file."
+                : "Ctrl+S opens a preview; publishing requires separate confirmation."),
+          width,
+          color: colors.muted,
+        })
+      : null,
+    helpRows
+      ? h(TextLine, { text: guidance.keys, width, color: colors.muted })
+      : null,
+    navRows
+      ? h(
+          Text,
+          { wrap: "truncate" },
+          ...stepControls(steps, stepIndex).map((control) =>
+            h(
+              Text,
+              {
+                key: control.id,
+                color: !control.enabled
+                  ? colors.muted
+                  : navFocus === control.id
+                    ? colors.blue
+                    : colors.purple,
+                bold: navFocus === control.id,
+                dimColor: !control.enabled,
+                backgroundColor:
+                  navFocus === control.id ? colors.selected : undefined,
+              },
+              ` ${navFocus === control.id ? "›" : " "}[ ${control.label} ] `,
+            ),
+          ),
+        )
+      : null,
   );
-  return h(FrameRows, { rows, width, height, offset });
 }
 function listRows(route, data, index, width, colors, density = "comfortable") {
   const items = data.items || [];
@@ -566,6 +647,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
     [notice, setNotice] = useState(initialAppearance.warning || "");
   const [form, setForm] = useState(null),
     [field, setField] = useState(0),
+    [formNav, setFormNav] = useState(null),
     [cursor, setCursor] = useState(0),
     [preview, setPreview] = useState(null),
     [dialog, setDialog] = useState(null),
@@ -576,6 +658,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 +671,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 +699,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 +737,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       dialog ||
       reading ||
       actionIndex !== null ||
+      palette ||
       loading ||
       pending ||
       focus === "prompt"
@@ -715,6 +809,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 +846,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 +897,124 @@ 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) {
+    setFormNav(null);
+    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;
@@ -1234,6 +1450,8 @@ function App({ initialConfig, flags, root, initialAppearance }) {
     );
   }
   function openForm(next) {
+    setFormNav(null);
+    setNotice("");
     setBooting(false);
     setForm({
       ...next,
@@ -1398,6 +1616,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
   }
   async function prepare() {
     if (!form) return;
+    setFormNav(null);
     if (form.kind === "catalogFilter") {
       await task(async () => {
         const values = validateFilter(form.values);
@@ -1678,8 +1897,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 +1913,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       return;
     }
     if (route.view === "feedback") {
-      setReading(item);
-      setScroll(0);
+      readItem(item);
       return;
     }
     navigate({
@@ -1864,8 +2081,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 +2107,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 +2140,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;
@@ -1969,7 +2189,19 @@ function App({ initialConfig, flags, root, initialAppearance }) {
   }
   function changeField(next) {
     const fields = fieldsFor(form),
-      selected = (next + fields.length + 1) % (fields.length + 1);
+      steps = formSteps(form, fields),
+      stepIndex = stepAt(steps, field, fields.length),
+      step = steps[stepIndex];
+    if (
+      step &&
+      !formNav &&
+      ((next > field && field === step.indexes.at(-1)) ||
+        (next < field && field === step.indexes[0]))
+    ) {
+      setFormNav(next < field && stepIndex > 0 ? "back" : "next");
+      return;
+    }
+    const selected = (next + fields.length + 1) % (fields.length + 1);
     setField(selected);
     setCursor(
       selected < fields.length
@@ -2033,6 +2265,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 +2314,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) {
@@ -2097,7 +2397,12 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       return;
     }
     if (form) {
-      if (keyEvent.ctrl && input === "o" && form.kind === "catalog") {
+      if (
+        keyEvent.ctrl &&
+        input === "o" &&
+        form.kind === "catalog" &&
+        !formNav
+      ) {
         const active = fieldsFor(form)[field];
         if (["logo", "banner", "screenshots"].includes(active?.key)) {
           setPicker({ mediaKey: active.key });
@@ -2124,7 +2429,15 @@ function App({ initialConfig, flags, root, initialAppearance }) {
         setNotice("Default preview restored. Ctrl+S saves; Esc cancels.");
         return;
       }
-      if (keyEvent.ctrl && input === "e") {
+      if (
+        keyEvent.ctrl &&
+        ["n", "p"].includes(input) &&
+        formSteps(form, fieldsFor(form)).length
+      ) {
+        moveStep(input === "n" ? 1 : -1);
+        return;
+      }
+      if (keyEvent.ctrl && input === "e" && !formNav) {
         externalEdit();
         return;
       }
@@ -2132,6 +2445,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
         keyEvent.ctrl &&
         ["o", "g"].includes(input) &&
         form.kind === "publication" &&
+        !formNav &&
         form.values.kind === "review"
       ) {
         setPicker(input === "g" ? "changes" : "files");
@@ -2155,6 +2469,39 @@ function App({ initialConfig, flags, root, initialAppearance }) {
         prepare();
         return;
       }
+      if (formNav) {
+        const fields = fieldsFor(form),
+          steps = formSteps(form, fields),
+          i = stepAt(steps, field, fields.length),
+          step = steps[i];
+        if (keyEvent.return) {
+          moveStep(formNav === "back" ? -1 : 1);
+          return;
+        }
+        if (keyEvent.leftArrow || keyEvent.upArrow) {
+          setFormNav(i > 0 ? "back" : "next");
+          return;
+        }
+        if (keyEvent.rightArrow || keyEvent.downArrow) {
+          setFormNav("next");
+          return;
+        }
+        if (keyEvent.tab) {
+          if (keyEvent.shift && formNav === "next" && i > 0) {
+            setFormNav("back");
+            return;
+          }
+          if (!keyEvent.shift && formNav === "back") {
+            setFormNav("next");
+            return;
+          }
+          const next = keyEvent.shift ? step.indexes.at(-1) : step.indexes[0];
+          setFormNav(null);
+          setField(next);
+          setCursor(graphemes(form.values[fields[next].key] || "").length);
+        }
+        return;
+      }
       if (keyEvent.tab) {
         changeField(field + (keyEvent.shift ? -1 : 1));
         return;
@@ -2409,8 +2756,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       selected &&
       ["post", "thread", "feedback"].includes(route.view)
     ) {
-      setReading(selected);
-      setScroll(0);
+      readItem(selected);
       return;
     }
     if (keyEvent.return) {
@@ -2501,15 +2847,23 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       reportSelected();
     }
   });
+  const compactFieldHelp =
+    form && !formNav && form.kind !== "appearance" && contentHeight < 8
+      ? fieldGuidance(fieldsFor(form)[field], {
+          wizard: !!activeSteps.length,
+          project: form.kind === "catalog" && form.entity === "project",
+        }).detail
+      : "";
   const status =
     error ||
+    compactFieldHelp ||
     liveStatus ||
     notice ||
     (pending
       ? "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 +3006,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 +3099,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 =
@@ -2777,6 +3207,7 @@ function App({ initialConfig, flags, root, initialAppearance }) {
       body = h(form.kind === "appearance" ? AppearanceView : FormView, {
         form,
         active: field,
+        navFocus: formNav,
         cursor,
         width: contentWidth,
         height: contentHeight,
@@ -3021,7 +3452,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 +3529,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 +3547,17 @@ 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"
+                      ? formNav
+                        ? `${stepControls(activeSteps, activeStep).find((control) => control.id === formNav)?.label || "Next"} · Enter select · Tab fields · Ctrl+S preview`
+                        : fieldsFor(form)[field]?.multiline
+                          ? "Enter new line · Tab next field · Ctrl+N next step · Ctrl+S preview"
+                          : "Enter/Tab next field · Ctrl+N/P steps · 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.1-alpha.1",
+  "version": "0.7.1-alpha.1",
   "description": "Devdevian in your terminal: discussions, questions and human code reviews.",
   "type": "module",
   "bin": {