kankaku-pi 1.0.0

package/src/adapters/panel/screens/doctor.ts

@@ -0,0 +1,89 @@
+/**
+ * The `/kankaku` panel's `doctor` screen (see odd/tasks/kankaku-panel.md):
+ * renders `buildDoctorLines`' output (the exact lines `/kankaku doctor`
+ * shows) in a bounded body, with `pin`/`refresh` actions.
+ */
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { Component, SettingsListTheme, TuiMouseEvent, TuiMouseEventResult } from "@earendil-works/pi-tui";
+import { SettingsList } from "@earendil-works/pi-tui";
+import { buildDoctorLines } from "../../kankaku-command.ts";
+import type { KankakuCommandDeps, KankakuReportData } from "../../kankaku-command.ts";
+import type { PanelHost, PanelScreenFactory } from "../kankaku-panel.ts";
+import { actionItem } from "../panel-items.ts";
+import { renderBoundedLines } from "../panel-lines.ts";
+import { buildSettingsListTheme } from "../panel-theme.ts";
+
+export interface DoctorScreenDeps {
+  commandDeps: KankakuCommandDeps;
+  ctx: ExtensionContext;
+  pinReport: (report: KankakuReportData) => void;
+}
+
+const MAX_VISIBLE = 4;
+const MAX_BODY_LINES = 14;
+
+class DoctorScreenComponent implements Component {
+  readonly searchable = false;
+  private readonly deps: DoctorScreenDeps;
+  private readonly host: PanelHost;
+  private readonly settingsTheme: SettingsListTheme;
+  private lines: string[];
+  private list: SettingsList;
+
+  constructor(deps: DoctorScreenDeps, host: PanelHost) {
+    this.deps = deps;
+    this.host = host;
+    this.settingsTheme = buildSettingsListTheme(host.theme);
+    this.lines = buildDoctorLines(deps.commandDeps, deps.ctx);
+    this.list = this.buildList();
+  }
+
+  private buildList(): SettingsList {
+    const items = [
+      actionItem(this.settingsTheme, {
+        id: "pin",
+        label: "Pin to chat",
+        run: () => {
+          this.deps.pinReport({ title: "doctor", lines: this.lines });
+          return ["pinned to the chat transcript"];
+        },
+        onOpen: () => this.host.setBodyCapturesEscape(true),
+        onClose: () => this.host.setBodyCapturesEscape(false),
+        onDone: () => this.host.requestRender(),
+      }),
+      actionItem(this.settingsTheme, {
+        id: "refresh",
+        label: "Refresh",
+        run: () => {
+          this.lines = buildDoctorLines(this.deps.commandDeps, this.deps.ctx);
+          return ["refreshed"];
+        },
+        onOpen: () => this.host.setBodyCapturesEscape(true),
+        onClose: () => this.host.setBodyCapturesEscape(false),
+        onDone: () => this.host.requestRender(),
+      }),
+    ];
+    return new SettingsList(items, MAX_VISIBLE, this.settingsTheme, () => {}, () => this.host.back(), { enableSearch: false });
+  }
+
+  invalidate(): void {
+    this.list.invalidate();
+  }
+
+  render(width: number): string[] {
+    return [...this.list.render(width), "", ...renderBoundedLines(this.lines, MAX_BODY_LINES)];
+  }
+
+  handleInput(data: string): void {
+    this.list.handleInput(data);
+  }
+
+  handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined {
+    return this.list.handleMouse?.(event);
+  }
+}
+
+/** `openKankakuPanel`'s `screens.doctor` factory; see {@link DoctorScreenDeps}. */
+export function createDoctorScreen(deps: DoctorScreenDeps): PanelScreenFactory {
+  return (host: PanelHost) => new DoctorScreenComponent(deps, host);
+}

package/src/adapters/panel/screens/export.ts

@@ -0,0 +1,123 @@
+/**
+ * The `/kankaku` panel's `export` screen (see odd/tasks/kankaku-panel.md
+ * P4): `Format`/`Range` rows plus a `Write file` action that computes the
+ * export content through the exact same `buildExportContent`
+ * (`adapters/report-views.ts`) `/kankaku export` uses, so the panel and the
+ * subcommand can never drift. `Pin to chat` pins a short note of the last
+ * write (or the current selection, before anything has been written).
+ */
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { Component, SettingItem, SettingsListTheme, TuiMouseEvent, TuiMouseEventResult } from "@earendil-works/pi-tui";
+import { SettingsList } from "@earendil-works/pi-tui";
+import type { KankakuReportData } from "../../kankaku-command.ts";
+import { buildExportContent } from "../../report-views.ts";
+import type { WorkLog } from "../../../ports/work-log.ts";
+import type { PanelHost, PanelScreenFactory } from "../kankaku-panel.ts";
+import { actionItem } from "../panel-items.ts";
+import { buildSettingsListTheme } from "../panel-theme.ts";
+
+export interface ExportScreenDeps {
+  log: WorkLog;
+  /**
+   * Write an export file (name, content) under the kankaku dir and return
+   * its absolute path — the same dep `/kankaku export` uses. When absent,
+   * `Write file` reports the exact message the subcommand gives today
+   * ("export is not configured").
+   */
+  writeExportFile?: (name: string, content: string) => string;
+  ctx: ExtensionContext;
+  pinReport: (report: KankakuReportData) => void;
+}
+
+type ExportFormat = "csv" | "json";
+type ExportRange = "today" | "all";
+
+const FORMAT_VALUES: ExportFormat[] = ["csv", "json"];
+const RANGE_VALUES: ExportRange[] = ["today", "all"];
+const MAX_VISIBLE = 4;
+const EXPORT_NOT_CONFIGURED = "export is not configured";
+
+class ExportScreenComponent implements Component {
+  readonly searchable = false;
+  private readonly deps: ExportScreenDeps;
+  private readonly host: PanelHost;
+  private readonly settingsTheme: SettingsListTheme;
+  private format: ExportFormat = "csv";
+  private range: ExportRange = "today";
+  private lastNote = "nothing written yet";
+  private list: SettingsList;
+
+  constructor(deps: ExportScreenDeps, host: PanelHost) {
+    this.deps = deps;
+    this.host = host;
+    this.settingsTheme = buildSettingsListTheme(host.theme);
+    this.list = this.buildList();
+  }
+
+  private buildList(): SettingsList {
+    const items: SettingItem[] = [
+      { id: "format", label: "Format", currentValue: this.format, values: FORMAT_VALUES },
+      { id: "range", label: "Range", currentValue: this.range, values: RANGE_VALUES },
+      actionItem(this.settingsTheme, {
+        id: "write",
+        label: "Write file",
+        run: () => {
+          if (!this.deps.writeExportFile) {
+            throw new Error(EXPORT_NOT_CONFIGURED);
+          }
+          const { name, content } = buildExportContent(this.deps.log.readAll(), { format: this.format, all: this.range === "all" });
+          const path = this.deps.writeExportFile(name, content);
+          this.lastNote = `wrote ${path}`;
+          return [this.lastNote];
+        },
+        onOpen: () => this.host.setBodyCapturesEscape(true),
+        onClose: () => this.host.setBodyCapturesEscape(false),
+        onDone: () => this.host.requestRender(),
+      }),
+      actionItem(this.settingsTheme, {
+        id: "pin",
+        label: "Pin to chat",
+        run: () => {
+          this.deps.pinReport({ title: "export", lines: [this.lastNote] });
+          return ["pinned to the chat transcript"];
+        },
+        onOpen: () => this.host.setBodyCapturesEscape(true),
+        onClose: () => this.host.setBodyCapturesEscape(false),
+        onDone: () => this.host.requestRender(),
+      }),
+    ];
+    return new SettingsList(items, MAX_VISIBLE, this.settingsTheme, (id, value) => this.onChange(id, value), () => this.host.back(), {
+      enableSearch: false,
+    });
+  }
+
+  private onChange(id: string, value: string): void {
+    if (id === "format") this.format = value as ExportFormat;
+    else if (id === "range") this.range = value as ExportRange;
+
+    this.list = this.buildList();
+    this.list.selectItem(id);
+    this.host.requestRender();
+  }
+
+  invalidate(): void {
+    this.list.invalidate();
+  }
+
+  render(width: number): string[] {
+    return this.list.render(width);
+  }
+
+  handleInput(data: string): void {
+    this.list.handleInput(data);
+  }
+
+  handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined {
+    return this.list.handleMouse?.(event);
+  }
+}
+
+/** `openKankakuPanel`'s `screens.export` factory; see {@link ExportScreenDeps}. */
+export function createExportScreen(deps: ExportScreenDeps): PanelScreenFactory {
+  return (host: PanelHost) => new ExportScreenComponent(deps, host);
+}

package/src/adapters/panel/screens/report.ts

@@ -0,0 +1,143 @@
+/**
+ * The `/kankaku` panel's `report` screen (see odd/tasks/kankaku-panel.md):
+ * `view`/`range`/`scope` rows drive the same five report builders
+ * (`adapters/report-views.ts`) the `/kankaku` subcommands use, so this
+ * screen can never drift from `tasks`/`sessions`/`clients`/`projects`/the
+ * plain summary. A `pin` action appends the current view's report as a
+ * durable chat entry, exactly like every subcommand already does.
+ */
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { Component, SettingItem, SettingsListTheme, TuiMouseEvent, TuiMouseEventResult } from "@earendil-works/pi-tui";
+import { SettingsList } from "@earendil-works/pi-tui";
+import type { KankakuReportData } from "../../kankaku-command.ts";
+import { buildClientsView, buildProjectsView, buildSessionsView, buildSummaryView, buildTasksView } from "../../report-views.ts";
+import type { WorkLog } from "../../../ports/work-log.ts";
+import type { PanelHost, PanelScreenFactory } from "../kankaku-panel.ts";
+import { renderBoundedLines } from "../panel-lines.ts";
+import { actionItem } from "../panel-items.ts";
+import { buildSettingsListTheme } from "../panel-theme.ts";
+
+export interface ReportScreenDeps {
+  log: WorkLog;
+  ctx: ExtensionContext;
+  pi: ExtensionAPI;
+  /** Resolves this session's id, e.g. `() => ctx.sessionManager.getSessionId()`. Used by the `tasks` view's `scope` row. */
+  sessionId?: () => string | undefined;
+  pinReport: (report: KankakuReportData) => void;
+}
+
+type ReportView = "summary" | "tasks" | "sessions" | "clients" | "projects";
+type RangeValue = "today" | "all";
+type ScopeValue = "session" | "all sessions";
+
+const VIEW_VALUES: ReportView[] = ["summary", "tasks", "sessions", "clients", "projects"];
+const RANGE_VALUES: RangeValue[] = ["today", "all"];
+const SCOPE_VALUES: ScopeValue[] = ["session", "all sessions"];
+const MAX_VISIBLE = 6;
+const MAX_BODY_LINES = 14;
+const NOT_APPLICABLE = "n/a";
+
+class ReportScreenComponent implements Component {
+  readonly searchable = false;
+  private readonly deps: ReportScreenDeps;
+  private readonly host: PanelHost;
+  private readonly settingsTheme: SettingsListTheme;
+  private view: ReportView = "summary";
+  private range: RangeValue = "today";
+  private scope: ScopeValue = "session";
+  private report: KankakuReportData;
+  private list: SettingsList;
+
+  constructor(deps: ReportScreenDeps, host: PanelHost) {
+    this.deps = deps;
+    this.host = host;
+    this.settingsTheme = buildSettingsListTheme(host.theme);
+    this.report = this.computeReport();
+    this.list = this.buildList();
+  }
+
+  private computeReport(): KankakuReportData {
+    const records = this.deps.log.readAll();
+    switch (this.view) {
+      case "tasks":
+        return buildTasksView(records, { all: this.scope === "all sessions", sessionId: this.deps.sessionId?.() });
+      case "sessions":
+        return buildSessionsView(records, { all: this.range === "all" });
+      case "clients":
+        return buildClientsView(records, { all: this.range === "all" });
+      case "projects":
+        return buildProjectsView(records, { all: this.range === "all" });
+      case "summary":
+      default:
+        return buildSummaryView(records, { all: this.range === "all" });
+    }
+  }
+
+  private buildRangeItem(): SettingItem {
+    if (this.view === "tasks") {
+      return { id: "range", label: "Range", currentValue: NOT_APPLICABLE, description: "the tasks view uses scope, not range" };
+    }
+    return { id: "range", label: "Range", currentValue: this.range, values: RANGE_VALUES };
+  }
+
+  private buildScopeItem(): SettingItem {
+    if (this.view !== "tasks") {
+      return { id: "scope", label: "Scope", currentValue: NOT_APPLICABLE, description: "applies only to the tasks view" };
+    }
+    return { id: "scope", label: "Scope", currentValue: this.scope, values: SCOPE_VALUES };
+  }
+
+  private buildList(): SettingsList {
+    const items: SettingItem[] = [
+      { id: "view", label: "View", currentValue: this.view, values: VIEW_VALUES },
+      this.buildRangeItem(),
+      this.buildScopeItem(),
+      actionItem(this.settingsTheme, {
+        id: "pin",
+        label: "Pin to chat",
+        run: () => {
+          this.deps.pinReport(this.report);
+          return ["pinned to the chat transcript"];
+        },
+        onOpen: () => this.host.setBodyCapturesEscape(true),
+        onClose: () => this.host.setBodyCapturesEscape(false),
+        onDone: () => this.host.requestRender(),
+      }),
+    ];
+    return new SettingsList(items, MAX_VISIBLE, this.settingsTheme, (id, value) => this.onChange(id, value), () => this.host.back(), {
+      enableSearch: false,
+    });
+  }
+
+  private onChange(id: string, value: string): void {
+    if (id === "view") this.view = value as ReportView;
+    else if (id === "range") this.range = value as RangeValue;
+    else if (id === "scope") this.scope = value as ScopeValue;
+
+    this.report = this.computeReport();
+    this.list = this.buildList();
+    this.list.selectItem(id);
+    this.host.requestRender();
+  }
+
+  invalidate(): void {
+    this.list.invalidate();
+  }
+
+  render(width: number): string[] {
+    return [...this.list.render(width), "", ...renderBoundedLines(this.report.lines, MAX_BODY_LINES)];
+  }
+
+  handleInput(data: string): void {
+    this.list.handleInput(data);
+  }
+
+  handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined {
+    return this.list.handleMouse?.(event);
+  }
+}
+
+/** `openKankakuPanel`'s `screens.report` factory; see {@link ReportScreenDeps}. */
+export function createReportScreen(deps: ReportScreenDeps): PanelScreenFactory {
+  return (host: PanelHost) => new ReportScreenComponent(deps, host);
+}

package/src/adapters/panel/screens/sync.ts

@@ -0,0 +1,136 @@
+/**
+ * The `/kankaku` panel's `sync` screen (see odd/tasks/kankaku-panel.md P4):
+ * status lines (`hub-actions.ts#buildSyncStatusLines`) plus `Sync now`,
+ * `Sync all`, `Backfill` and `Refresh catalog` actions, all sharing the
+ * exact line-building the `/kankaku sync`/`backfill`/`catalog refresh`
+ * subcommands use (`adapters/hub-actions.ts`), so this screen can never
+ * drift from them. `Pin to chat` pins the current status lines, exactly
+ * like `/kankaku sync status` already does.
+ */
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { Component, SettingItem, SettingsListTheme, TuiMouseEvent, TuiMouseEventResult } from "@earendil-works/pi-tui";
+import { SettingsList } from "@earendil-works/pi-tui";
+import type { SyncCommandDeps, KankakuReportData } from "../../kankaku-command.ts";
+import { buildSyncStatusLines, formatBackfillLines, formatCatalogRefreshLines, formatSyncSummaryLines } from "../../hub-actions.ts";
+import type { Catalog } from "../../../ports/catalog.ts";
+import type { PanelHost, PanelScreenFactory } from "../kankaku-panel.ts";
+import { actionItem } from "../panel-items.ts";
+import { renderBoundedLines } from "../panel-lines.ts";
+import { buildSettingsListTheme } from "../panel-theme.ts";
+
+export interface SyncScreenDeps {
+  sync: SyncCommandDeps;
+  /** Present only when the hub is configured; the `Refresh catalog` row is omitted entirely without one. */
+  catalog?: Catalog;
+  ctx: ExtensionContext;
+  refreshIdleStatus: (ctx: ExtensionContext) => void;
+  pinReport: (report: KankakuReportData) => void;
+}
+
+const MAX_VISIBLE = 5;
+const MAX_BODY_LINES = 14;
+const STATUS_TITLE = "sync status";
+
+class SyncScreenComponent implements Component {
+  readonly searchable = false;
+  private readonly deps: SyncScreenDeps;
+  private readonly host: PanelHost;
+  private readonly settingsTheme: SettingsListTheme;
+  private statusLines: string[];
+  private list: SettingsList;
+
+  constructor(deps: SyncScreenDeps, host: PanelHost) {
+    this.deps = deps;
+    this.host = host;
+    this.settingsTheme = buildSettingsListTheme(host.theme);
+    this.statusLines = buildSyncStatusLines(this.deps.sync.status());
+    this.list = this.buildList();
+  }
+
+  /** Refreshed after every action, per the feature doc: recompute the status body, refresh the idle status line, and re-render. */
+  private refreshStatus(): void {
+    this.statusLines = buildSyncStatusLines(this.deps.sync.status());
+    this.deps.refreshIdleStatus(this.deps.ctx);
+    this.host.requestRender();
+  }
+
+  private buildList(): SettingsList {
+    const items: SettingItem[] = [
+      actionItem(this.settingsTheme, {
+        id: "sync-now",
+        label: "Sync now",
+        run: async () => formatSyncSummaryLines(await this.deps.sync.run({})),
+        onOpen: () => this.host.setBodyCapturesEscape(true),
+        onClose: () => this.host.setBodyCapturesEscape(false),
+        onDone: () => this.refreshStatus(),
+      }),
+      actionItem(this.settingsTheme, {
+        id: "sync-all",
+        label: "Sync all",
+        run: async () => formatSyncSummaryLines(await this.deps.sync.run({ full: true })),
+        onOpen: () => this.host.setBodyCapturesEscape(true),
+        onClose: () => this.host.setBodyCapturesEscape(false),
+        onDone: () => this.refreshStatus(),
+      }),
+      actionItem(this.settingsTheme, {
+        id: "backfill",
+        label: "Backfill",
+        run: async () => formatBackfillLines(await this.deps.sync.run({ full: true })),
+        onOpen: () => this.host.setBodyCapturesEscape(true),
+        onClose: () => this.host.setBodyCapturesEscape(false),
+        onDone: () => this.refreshStatus(),
+      }),
+    ];
+
+    const catalog = this.deps.catalog;
+    if (catalog) {
+      items.push(
+        actionItem(this.settingsTheme, {
+          id: "catalog-refresh",
+          label: "Refresh catalog",
+          run: async () => formatCatalogRefreshLines(await catalog.refresh()),
+          onOpen: () => this.host.setBodyCapturesEscape(true),
+          onClose: () => this.host.setBodyCapturesEscape(false),
+          onDone: () => this.refreshStatus(),
+        }),
+      );
+    }
+
+    items.push(
+      actionItem(this.settingsTheme, {
+        id: "pin",
+        label: "Pin to chat",
+        run: () => {
+          this.deps.pinReport({ title: STATUS_TITLE, lines: this.statusLines });
+          return ["pinned to the chat transcript"];
+        },
+        onOpen: () => this.host.setBodyCapturesEscape(true),
+        onClose: () => this.host.setBodyCapturesEscape(false),
+        onDone: () => this.host.requestRender(),
+      }),
+    );
+
+    return new SettingsList(items, MAX_VISIBLE, this.settingsTheme, () => {}, () => this.host.back(), { enableSearch: false });
+  }
+
+  invalidate(): void {
+    this.list.invalidate();
+  }
+
+  render(width: number): string[] {
+    return [...this.list.render(width), "", ...renderBoundedLines(this.statusLines, MAX_BODY_LINES)];
+  }
+
+  handleInput(data: string): void {
+    this.list.handleInput(data);
+  }
+
+  handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined {
+    return this.list.handleMouse?.(event);
+  }
+}
+
+/** `openKankakuPanel`'s `screens.sync` factory; see {@link SyncScreenDeps}. */
+export function createSyncScreen(deps: SyncScreenDeps): PanelScreenFactory {
+  return (host: PanelHost) => new SyncScreenComponent(deps, host);
+}