plc-cli 0.1.3 → 0.2.0

package/dist/cli.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // src/meta.ts
 var PRODUCT_NAME = "Plane Cockpit";
 var BINARY_NAME = "plc";
-var VERSION = true ? "0.1.3" : "0.0.0-dev";
+var VERSION = true ? "0.2.0" : "0.0.0-dev";
 var AUTHOR_HANDLE = "@brunoomariano";
 
 // src/commands/auth/index.ts
@@ -233,6 +233,12 @@ var profileSchema = z.strictObject({
     // Profile-wide default sort, inherited by any view that does not declare
     // its own `sort`. Same shape as a view's sort.
     sort: sortSpecSchema.optional(),
+    // Global state ordering for `sort: state` and the quick-transition
+    // navigation. An ordered list of state slugs (matched case-insensitively,
+    // whitespace-collapsed): listed states sort first in this order, unlisted
+    // ones after by workflow group. Project states are customizable, so this
+    // lets one list rank them across every project.
+    state_order: z.array(z.string().min(1)).optional(),
     // Profile-wide default column layout, inherited by views without a layout.
     layout: layoutSchema.optional()
   }).optional(),
@@ -1059,6 +1065,31 @@ function filtersFingerprint(filters) {
   return createHash("sha256").update(json).digest("hex").slice(0, 16);
 }
 
+// src/plane/state-rank.ts
+var STATE_GROUP_RANK = {
+  backlog: 0,
+  unstarted: 1,
+  started: 2,
+  completed: 3,
+  cancelled: 4
+};
+var UNLISTED_OFFSET = 1e6;
+function normalizeStateSlug(name) {
+  return name.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function buildStateRank(stateOrder) {
+  const position = /* @__PURE__ */ new Map();
+  (stateOrder ?? []).forEach((slug, index) => {
+    const normalized = normalizeStateSlug(slug);
+    if (!position.has(normalized)) position.set(normalized, index);
+  });
+  return (state) => {
+    const listed = position.get(normalizeStateSlug(state.name));
+    if (listed !== void 0) return listed;
+    return UNLISTED_OFFSET + STATE_GROUP_RANK[state.group];
+  };
+}
+
 // src/plane/sort-issues.ts
 var PRIORITY_RANK = {
   urgent: 0,
@@ -1067,45 +1098,41 @@ var PRIORITY_RANK = {
   low: 3,
   none: 4
 };
-var STATE_GROUP_RANK = {
-  backlog: 0,
-  unstarted: 1,
-  started: 2,
-  completed: 3,
-  cancelled: 4
-};
 var DEFAULT_SORT = [
   { field: "project", direction: "asc" },
   { field: "priority", direction: "desc" },
   { field: "state", direction: "asc" },
   { field: "updated_at", direction: "desc" }
 ];
-var ASC_COMPARATORS = {
-  project: (a, b) => a.project_identifier.localeCompare(b.project_identifier),
-  priority: (a, b) => PRIORITY_RANK[b.priority] - PRIORITY_RANK[a.priority],
-  state: (a, b) => STATE_GROUP_RANK[a.state.group] - STATE_GROUP_RANK[b.state.group],
-  created_at: (a, b) => a.created_at.localeCompare(b.created_at),
-  updated_at: (a, b) => a.updated_at.localeCompare(b.updated_at),
-  assign: (a, b) => firstAssignee(a).localeCompare(firstAssignee(b))
-};
+function ascComparators(stateRank) {
+  return {
+    project: (a, b) => a.project_identifier.localeCompare(b.project_identifier),
+    priority: (a, b) => PRIORITY_RANK[b.priority] - PRIORITY_RANK[a.priority],
+    state: (a, b) => stateRank(a.state) - stateRank(b.state),
+    created_at: (a, b) => a.created_at.localeCompare(b.created_at),
+    updated_at: (a, b) => a.updated_at.localeCompare(b.updated_at),
+    assign: (a, b) => firstAssignee(a).localeCompare(firstAssignee(b))
+  };
+}
 function firstAssignee(issue) {
   return issue.assignees[0]?.display_name ?? "";
 }
-function compareKey(a, b, field, direction) {
+function compareKey(a, b, { field, direction }, comparators) {
   if (field === "assign") {
     const aUnassigned = a.assignees.length === 0;
     const bUnassigned = b.assignees.length === 0;
     if (aUnassigned !== bUnassigned) return aUnassigned ? 1 : -1;
     if (aUnassigned && bUnassigned) return 0;
   }
-  const base = ASC_COMPARATORS[field](a, b);
+  const base = comparators[field](a, b);
   return direction === "desc" ? -base : base;
 }
-function sortIssues(issues, sort) {
+function sortIssues(issues, sort, stateOrder) {
   if (!sort || sort.length === 0) return issues;
+  const comparators = ascComparators(buildStateRank(stateOrder));
   return [...issues].sort((a, b) => {
-    for (const { field, direction } of sort) {
-      const cmp = compareKey(a, b, field, direction);
+    for (const key of sort) {
+      const cmp = compareKey(a, b, key, comparators);
       if (cmp !== 0) return cmp;
     }
     return 0;
@@ -1412,18 +1439,21 @@ var IssuesService = class {
    * `defaultsSort` is the profile-level `defaults.sort`; the effective sort is
    * resolved once as `view.sort ?? defaultsSort ?? DEFAULT_SORT` and applied
    * both as the per-project server hint and the authoritative client-side sort.
+   * `stateOrder` is the profile-level `defaults.state_order`, used by the
+   * client-side `state` sort to rank states by the configured slug order.
    */
   // `signal` is threaded down to each per-project fetch so the dashboard can
   // abort an in-flight refresh (e.g. when a new one starts before the previous
   // resolves), preventing requests from piling up and timing out. The positional
   // list mirrors the call sites; the cap is waived rather than reshaping both.
   // eslint-disable-next-line max-params
-  async list(projectIdentifiers, view, queryLimit, defaultsSort, signal) {
+  async list(projectIdentifiers, view, queryLimit, defaultsSort, stateOrder, signal) {
     const { issues, failedProjects } = await this.listResilient(
       projectIdentifiers,
       view,
       queryLimit,
       defaultsSort,
+      stateOrder,
       signal
     );
     if (failedProjects.length > 0) {
@@ -1442,7 +1472,7 @@ var IssuesService = class {
    */
   // Same positional shape as `list`; the cap is waived for the same reason.
   // eslint-disable-next-line max-params
-  async listResilient(projectIdentifiers, view, queryLimit, defaultsSort, signal) {
+  async listResilient(projectIdentifiers, view, queryLimit, defaultsSort, stateOrder, signal) {
     const assigneeIds = await this.resolveAssigneeIds(view);
     const sort = resolveSort(view?.sort, defaultsSort);
     const effectiveView = view ? { ...view, sort } : { name: "", sort };
@@ -1461,7 +1491,7 @@ var IssuesService = class {
     const byGroup = refineByStateGroup(fetched, view?.filters?.state_group);
     const byState = refineByStateSearch(byGroup, view?.filters);
     const byAssignee = refineByAssignee(byState, assigneeIds);
-    const sorted = sortIssues(byAssignee, sort);
+    const sorted = sortIssues(byAssignee, sort, stateOrder);
     const issues = queryLimit !== void 0 ? sorted.slice(0, queryLimit) : sorted;
     return { issues, failedProjects };
   }
@@ -2413,7 +2443,8 @@ function registerIssue(program2) {
         projects,
         view,
         limit ?? view?.query_limit,
-        ctx.runtime.profile.defaults?.sort
+        ctx.runtime.profile.defaults?.sort,
+        ctx.runtime.profile.defaults?.state_order
       );
       process.stdout.write(renderIssues(issues, format, ctx.theme));
       process.stdout.write("\n");
@@ -2930,6 +2961,16 @@ var PRIORITY_LETTER = {
   low: "L",
   none: "\xB7"
 };
+var SORT_FIELD_COLUMN = {
+  priority: "priority",
+  state: "state",
+  assign: "assign"
+};
+function sortIndicator(column, sort) {
+  const primary = sort?.[0];
+  if (!primary || SORT_FIELD_COLUMN[primary.field] !== column) return "";
+  return primary.direction === "asc" ? " \u2191" : " \u2193";
+}
 function computeViewport(total, selected, rows, previousStart = 0) {
   if (rows <= 0 || total === 0) return { start: 0, end: 0 };
   if (rows >= total) return { start: 0, end: total };
@@ -2964,10 +3005,16 @@ function IssueList(props) {
   return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", borderStyle: "round", paddingX: 1, flexGrow: 1, children: [
     /* @__PURE__ */ jsxs4(Box4, { columnGap: 1, children: [
       /* @__PURE__ */ jsx5(Box4, { ...cell("key", cols.keyWidth), children: /* @__PURE__ */ jsx5(Text4, { bold: true, children: alignText("KEY", cols.keyWidth, cols.align.key) }) }),
-      /* @__PURE__ */ jsx5(Box4, { ...cell("priority", cols.priorityWidth), children: /* @__PURE__ */ jsx5(Text4, { bold: true, children: cols.compactPriority ? "PR" : "PRIORITY" }) }),
-      cols.showState ? /* @__PURE__ */ jsx5(Box4, { ...cell("state", cols.stateWidth), children: /* @__PURE__ */ jsx5(Text4, { bold: true, children: "STATE" }) }) : null,
+      /* @__PURE__ */ jsx5(Box4, { ...cell("priority", cols.priorityWidth), children: /* @__PURE__ */ jsx5(Text4, { bold: true, children: cols.compactPriority ? "PR" : `PRIORITY${sortIndicator("priority", props.sort)}` }) }),
+      cols.showState ? /* @__PURE__ */ jsx5(Box4, { ...cell("state", cols.stateWidth), children: /* @__PURE__ */ jsxs4(Text4, { bold: true, children: [
+        "STATE",
+        sortIndicator("state", props.sort)
+      ] }) }) : null,
       /* @__PURE__ */ jsx5(Box4, { ...cell("title", cols.title), children: /* @__PURE__ */ jsx5(Text4, { bold: true, children: "TITLE" }) }),
-      cols.showAssign ? /* @__PURE__ */ jsx5(Box4, { ...cell("assign", cols.assignWidth), children: /* @__PURE__ */ jsx5(Text4, { bold: true, children: "ASSIGN" }) }) : null
+      cols.showAssign ? /* @__PURE__ */ jsx5(Box4, { ...cell("assign", cols.assignWidth), children: /* @__PURE__ */ jsxs4(Text4, { bold: true, children: [
+        "ASSIGN",
+        sortIndicator("assign", props.sort)
+      ] }) }) : null
     ] }),
     hiddenAbove > 0 ? /* @__PURE__ */ jsxs4(Text4, { dimColor: true, children: [
       "\u2191 ",
@@ -4372,7 +4419,10 @@ var EMPTY_VIEW_DATA = {
   failedProjects: []
 };
 function useViewsData(opts) {
-  const { views, issuesService, defaultProjects, defaultsSort, logger } = opts;
+  const { views, issuesService, defaults, logger } = opts;
+  const defaultProjects = defaults?.projects;
+  const defaultsSort = defaults?.sort;
+  const stateOrder = defaults?.state_order;
   const [byView, setByView] = useState6(() => views.map(() => EMPTY_VIEW_DATA));
   const viewsRef = useRef4(views);
   viewsRef.current = views;
@@ -4414,6 +4464,7 @@ function useViewsData(opts) {
           view,
           view.query_limit ?? 100,
           defaultsSort,
+          stateOrder,
           controller.signal
         );
         patch(viewIdx, {
@@ -4446,7 +4497,7 @@ function useViewsData(opts) {
         }
       }
     },
-    [issuesService, defaultProjects, defaultsSort, logger, patch]
+    [issuesService, defaultProjects, defaultsSort, stateOrder, logger, patch]
   );
   const refreshAll = useCallback4(() => {
     const indices = viewsRef.current.map((_, idx) => idx);
@@ -4534,23 +4585,17 @@ function useIssueFilter(opts) {
 import { useCallback as useCallback5, useState as useState9 } from "react";
 
 // src/plane/state-order.ts
-var GROUP_ORDER = [
-  "backlog",
-  "unstarted",
-  "started",
-  "completed",
-  "cancelled"
-];
-function orderStates(states) {
+function orderStates(states, stateOrder) {
+  const rank = buildStateRank(stateOrder);
   return states.map((state, index) => ({ state, index })).sort((a, b) => {
-    const ga = GROUP_ORDER.indexOf(a.state.group);
-    const gb = GROUP_ORDER.indexOf(b.state.group);
-    if (ga !== gb) return ga - gb;
+    const ra = rank(a.state);
+    const rb = rank(b.state);
+    if (ra !== rb) return ra - rb;
     return a.index - b.index;
   }).map((entry) => entry.state);
 }
-function neighbourState(states, currentId, direction) {
-  const ordered = orderStates(states);
+function neighbourState(states, currentId, direction, stateOrder) {
+  const ordered = orderStates(states, stateOrder);
   const idx = ordered.findIndex((s) => s.id === currentId);
   if (idx < 0) return void 0;
   const target = idx + direction;
@@ -4581,7 +4626,8 @@ function useQuickTransition(opts) {
       if (!issue) return;
       try {
         const states = await ctx.states.list(projectOf(issue));
-        const next = neighbourState(states, issue.state.id, direction);
+        const stateOrder = ctx.runtime.profile.defaults?.state_order;
+        const next = neighbourState(states, issue.state.id, direction, stateOrder);
         if (!next) {
           setMessage(`${issue.key}: already at the ${direction === 1 ? "last" : "first"} state`);
           return;
@@ -4847,6 +4893,12 @@ function overlayStatusPosition(opts) {
   if (opts.isDetail && !opts.current) return void 0;
   return opts.listPosition;
 }
+function resolveViewPresentation(view, defaults) {
+  return {
+    layout: resolveLayout(view?.layout, defaults?.layout),
+    sort: resolveSort(view?.sort, defaults?.sort)
+  };
+}
 function Dashboard({ ctx, logger }) {
   const { exit } = useApp();
   const { rows: terminalRows, columns: terminalCols } = useTerminalSize();
@@ -4863,16 +4915,15 @@ function Dashboard({ ctx, logger }) {
   const [panel, setPanel] = useState11("list");
   const [helpOpen, setHelpOpen] = useState11(false);
   const activeView = views[viewIdx];
-  const activeLayout = useMemo6(
-    () => resolveLayout(activeView?.layout, ctx.runtime.profile.defaults?.layout),
+  const { layout: activeLayout, sort: activeSort } = useMemo6(
+    () => resolveViewPresentation(activeView, ctx.runtime.profile.defaults),
     [activeView, ctx]
   );
   const selectedKeyRef = React7.useRef(void 0);
   const viewsData = useViewsData({
     views,
     issuesService: ctx.issues,
-    defaultProjects: ctx.runtime.profile.defaults?.projects,
-    defaultsSort: ctx.runtime.profile.defaults?.sort,
+    defaults: ctx.runtime.profile.defaults,
     logger
   });
   const active = viewsData.byView[viewIdx] ?? {
@@ -5198,6 +5249,7 @@ function Dashboard({ ctx, logger }) {
       filtering,
       viewportRows,
       layout: activeLayout,
+      sort: activeSort,
       loading,
       statusBar: /* @__PURE__ */ jsx13(StatusBar, { ...statusBarBase, loading, position: listPosition })
     }
@@ -5225,6 +5277,7 @@ function ListLayout(props) {
             viewportRows: props.viewportRows,
             width: props.narrow ? props.width : props.width - SIDE_PANEL_WIDTH,
             layout: props.layout,
+            sort: props.sort,
             loading: props.loading
           }
         ),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plc-cli",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "CLI and TUI for Plane (Cloud and self-hosted), inspired by gh and gh dash.",
   "license": "MIT",
   "author": "Bruno Mariano",