npm - @ikenga/pkg-tasks - Versions diffs - 0.2.0 - Mend

@ikenga/pkg-tasks 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/LICENSE +201 -0
package/README.md +100 -0
package/dist/app.js +219 -0
package/dist/features/tasks/agenda-view.js +113 -0
package/dist/features/tasks/task-detail-pane.js +398 -0
package/dist/features/tasks/task-row.js +70 -0
package/dist/features/tasks/tasks-view.js +361 -0
package/dist/features/tasks/triage-view.js +124 -0
package/dist/features/tasks/view-tabs.js +38 -0
package/dist/index.html +49 -0
package/dist/lib/bridge.js +140 -0
package/dist/lib/esm-sh.d.ts +39 -0
package/dist/lib/queries.js +193 -0
package/dist/lib/query-keys.js +14 -0
package/dist/lib/shared.js +315 -0
package/dist/lib/supabase.js +35 -0
package/dist/lib/tasks-css.js +5 -0
package/dist/lib/tokens-css.js +5 -0
package/dist/lib/ui.js +102 -0
package/dist/tasks.css +1046 -0
package/manifest.json +53 -0
package/package.json +24 -0

package/dist/lib/bridge.js ADDED Viewed

@@ -0,0 +1,140 @@
+// MCP Apps SDK bridge — the canonical iframe⇄host protocol Ikenga uses.
+//
+// Pattern from @modelcontextprotocol/ext-apps Quickstart + the shell's
+// pkg-iframe-host.tsx implementation:
+//   1. new App(...) — register handlers before connect
+//   2. await app.connect() — runs ui/initialize handshake automatically
+//   3. app.getHostContext() — read theme / styles / supabase / royaltiAuth
+//   4. app.callServerTool({ name: 'host.<x>', arguments }) — invoke host tools
+//      (shell intercepts `host.*` names in dispatchHostCall; everything else
+//      proxies to pkg MCP servers if any).
+//
+// The host re-emits hostContext on theme change via onhostcontextchanged.
+// Use the bundled `app-with-deps` build — the default entry pulls
+// `zod/v4` as a peer-via-esm.sh and dependency resolution sometimes
+// produces a Zod build missing `.custom()`. The bundled variant
+// inlines its deps so it works regardless of esm.sh's resolver state.
+// NOTE: we deliberately do NOT import the SDK's applyDocumentTheme /
+// applyHostStyleVariables / applyHostFonts helpers. Theme is owned by app.js's
+// parent-<html> mirror (the artifact pattern). applyDocumentTheme in particular
+// clobbers our workspace `data-theme` (A/B/C) with 'light'|'dark', breaking the
+// bundled @ikenga/tokens palette — so the bridge stays out of theming entirely.
+import { App } from 'https://esm.sh/@modelcontextprotocol/ext-apps@1.7.1/app-with-deps';
+let app = null;
+export async function connectBridge({ name, version, onContextChange }) {
+  app = new App({ name, version }, {
+    // Capabilities the pkg advertises to the host. Keep minimal — declare only
+    // what we actually use.
+    tools: { listChanged: false },
+  });
+  app.onerror = (err) => console.error('[tasks] bridge error', err);
+  // Theme is NOT applied here — app.js mirrors it from the parent <html>.
+  // We still forward context so live Supabase/auth updates reach the app.
+  app.onhostcontextchanged = (ctx) => {
+    onContextChange?.(ctx);
+  };
+  app.onteardown = async () => ({});
+  await app.connect();
+  return app.getHostContext();
+}
+/** Navigate the focused shell pane (cross-pkg or in-pkg sub-route). */
+export async function hostNavigate(path) {
+  if (!app) throw new Error('bridge not connected');
+  return app.callServerTool({
+    name: 'host.navigate',
+    arguments: { path },
+  });
+}
+/** Open an external link via the host. */
+export async function openLink(url) {
+  if (!app) throw new Error('bridge not connected');
+  return app.openLink({ url });
+}
+/** Publish the pkg's sidebar menu to the shell. PkgMode renders these items in
+ *  the left side panel when this pkg's pane is focused (normal AppMode). Item
+ *  clicks come back as hostContext changes via `royaltiSuite.activeFeature` —
+ *  listen via onContextChange in connectBridge.
+ *  items: [{ id, label, icon?, badge? }] */
+export async function setMenu(items) {
+  if (!app) throw new Error('bridge not connected');
+  return app.callServerTool({
+    name: 'host.pkg.setMenu',
+    arguments: { items },
+  });
+}
+/**
+ * Seed a user turn into the shell's active Claude session. This is how the
+ * Tasks pkg "creates" work: anon RLS only grants UPDATE of status/completed_at
+ * (never INSERT), so a new task can't be written client-side. Instead we
+ * dispatch a natural-language request to the agent, which creates the task via
+ * its privileged path. Verb confirmed in shell/src/components/pkg/
+ * pkg-iframe-host.tsx (`host.sendToActiveSession`).
+ *
+ *   prompt: string   — the instruction shown as the user turn
+ *   source?: string  — provenance tag (defaults to the pkg id)
+ */
+export async function hostSendToActiveSession(prompt, source = 'com.ikenga.tasks') {
+  if (!app) throw new Error('bridge not connected');
+  return app.callServerTool({
+    name: 'host.sendToActiveSession',
+    arguments: { prompt, source },
+  });
+}
+/**
+ * Dispatch a structured PA action through the host. Kept as a thin alias for
+ * forward-compat: if/when the shell exposes a dedicated `host.paActionsRun`
+ * verb, point this at it. Today the shell does NOT expose that verb (only
+ * host.navigate / host.sendToActiveSession / host.openSessionDialog /
+ * host.pkg.setMenu exist), so the create path uses hostSendToActiveSession.
+ */
+export async function hostPaActionsRun(args) {
+  if (!app) throw new Error('bridge not connected');
+  return app.callServerTool({
+    name: 'host.paActionsRun',
+    arguments: args,
+  });
+}
+/**
+ * Read the local `pa.db` via the host's `host.dbQuery` verb (WP-04 read-swap).
+ * SELECT/WITH only — the shell rejects writes and gates this on the pkg
+ * declaring `capabilities.sqlite`. Returns the row array
+ * (`structuredContent.rows`); throws on a closed/failed bridge so callers can
+ * surface the error in the query layer. Requires a connected bridge — there is
+ * no standalone fallback (reads no longer go through supabase-js).
+ *
+ *   sql:    string         — a single SELECT/WITH statement with `?` params
+ *   params: SqlValue[]      — positional bind values
+ */
+export async function hostDbQuery(sql, params = []) {
+  if (!app) throw new Error('[tasks] bridge not connected — db_query unavailable');
+  const res = await app.callServerTool({
+    name: 'host.dbQuery',
+    arguments: { sql, params },
+  });
+  const sc = res?.structuredContent;
+  if (!sc || sc.ok !== true) {
+    throw new Error(sc?.error ?? res?.content?.[0]?.text ?? 'host.dbQuery failed');
+  }
+  return Array.isArray(sc.rows) ? sc.rows : [];
+}
+/** Read the current hostContext snapshot. */
+export function getContext() {
+  return app?.getHostContext() ?? null;
+}
+/** Detect standalone-dev (no parent shell). */
+export function isStandalone() {
+  return typeof window !== 'undefined' && window.parent === window;
+}

package/dist/lib/esm-sh.d.ts ADDED Viewed

@@ -0,0 +1,39 @@
+// Dev-only ambient declarations so `tsc -p tsconfig.dev.json --checkJs` can
+// resolve the https://esm.sh/* import URLs (TypeScript cannot fetch them).
+// NEVER referenced by the publish path — the browser resolves these natively.
+declare module 'https://esm.sh/react@19.0.0' {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const React: any;
+  export = React;
+}
+declare module 'https://esm.sh/react-dom@19.0.0/client' {
+  export const createRoot: (el: Element | null) => { render: (node: unknown) => void };
+}
+declare module 'https://esm.sh/htm@3.1.1' {
+  const htm: { bind: (h: unknown) => (...args: unknown[]) => unknown };
+  export default htm;
+}
+declare module 'https://esm.sh/@tanstack/react-query@5?deps=react@19.0.0' {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export const QueryClient: any;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export const QueryClientProvider: any;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export const useQuery: any;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export const useMutation: any;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export const useQueryClient: any;
+}
+declare module 'https://esm.sh/@supabase/supabase-js@2' {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export const createClient: any;
+}
+declare module 'https://esm.sh/@modelcontextprotocol/ext-apps@1.7.1/app-with-deps' {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export const App: any;
+  export const applyDocumentTheme: (theme: unknown) => void;
+  export const applyHostStyleVariables: (vars: unknown) => void;
+  export const applyHostFonts: (fonts: unknown) => void;
+}

package/dist/lib/queries.js ADDED Viewed

@@ -0,0 +1,193 @@
+// Query layer — ported from src/lib/queries/tasks.ts. JSDoc carries the TS
+// types. Schema verified against the local pa.db `tasks` table (shell
+// migration 0025_tasks_domain.sql): every selected column exists.
+//
+// WP-04 read-swap: reads go through the host's `host.dbQuery` verb (local
+// pa.db) instead of an in-iframe supabase-js client. The status-update WRITE
+// (task-detail-pane.js) still uses supabase-js — moving it needs a host write
+// verb that does not exist yet (follow-up WP).
+import { hostDbQuery } from './bridge.js';
+import { queryKeys } from './query-keys.js';
+// pa.db stores former Postgres array/json columns as TEXT (the Pg→SQLite
+// down-map, shell migration 0025). `tags` arrives as a string, not a JS array
+// — normalize it back so the Task shape matches the JSDoc + the detail pane's
+// `.map`/`.length` usage. JSON first (the canonical ETL encoding), then a
+// comma split as a tolerant fallback, then [].
+/** @param {any} row */
+function normalizeTaskRow(row) {
+  if (!row || typeof row !== 'object') return row;
+  const t = row.tags;
+  if (typeof t === 'string') {
+    const s = t.trim();
+    if (!s) {
+      row.tags = null;
+    } else {
+      try {
+        const parsed = JSON.parse(s);
+        row.tags = Array.isArray(parsed) ? parsed : [String(parsed)];
+      } catch {
+        row.tags = s.split(',').map((x) => x.trim()).filter(Boolean);
+      }
+    }
+  }
+  return row;
+}
+/** @typedef {'pending'|'in_progress'|'completed'|'cancelled'|'blocked'} TaskStatus */
+/** @typedef {'critical'|'high'|'medium'|'low'} TaskPriority */
+/** @typedef {'human'|'agent'} AssigneeType */
+/**
+ * @typedef {Object} Task
+ * @property {string} id
+ * @property {string} title
+ * @property {string|null} description
+ * @property {TaskStatus} status
+ * @property {TaskPriority} priority
+ * @property {string|null} assigned_to
+ * @property {AssigneeType|null} assignee_type
+ * @property {string|null} category
+ * @property {string[]|null} tags
+ * @property {string|null} due_date
+ * @property {string|null} completed_at
+ * @property {string} created_at
+ * @property {string} updated_at
+ * @property {number|null} progress_pct
+ * @property {string|null} outcome_notes
+ * @property {string|null} parent_task_id
+ * @property {string|null} blocked_by_task_id
+ * @property {string|null} source_email_id
+ * @property {string|null} agent_source
+ * @property {string|null} initiative_id
+ * @property {string|null} risk_id
+ * @property {string|null} effort_estimate
+ * @property {'autonomous'|'report'|'approval_required'|null} execution_mode
+ * @property {string|null} task_result
+ * @property {string|null} claude_session_id
+ * @property {string|null} working_dir
+ */
+export const TASKS_LIST_COLUMNS =
+  'id, title, description, status, priority, assigned_to, assignee_type, category, due_date, created_at, updated_at, progress_pct, outcome_notes, execution_mode';
+/** @type {readonly TaskStatus[]} */
+const ACTIVE_STATUSES = ['pending', 'in_progress', 'blocked'];
+const STALE_DAYS = 7;
+/**
+ * @typedef {Object} TriageCounts
+ * @property {number} overdue
+ * @property {number} stale
+ * @property {number} unassigned
+ * @property {number} blocked
+ * @property {number} needsAttention Deduplicated overdue-OR-unassigned badge total.
+ */
+/**
+ * Server-side health counts for the Triage badge (R16-followup: server-side,
+ * so the badge is correct independent of the list's filter + 200-row cap).
+ * Four `head:true` count() selects, run in parallel (+ the deduped total).
+ */
+export function triageCountsQuery() {
+  return {
+    queryKey: queryKeys.tasks.triageCounts(),
+    /** @returns {Promise<TriageCounts>} */
+    queryFn: async () => {
+      // "Overdue" = due before the start of today, matching the app's own
+      // convention (groupTasks / dueLabel treat a task due *today* as "Today",
+      // not overdue, until the day rolls over).
+      const startOfTodayIso = (() => {
+        const d = new Date();
+        d.setHours(0, 0, 0, 0);
+        return d.toISOString();
+      })();
+      const staleIso = new Date(
+        Date.now() - STALE_DAYS * 24 * 60 * 60 * 1000,
+      ).toISOString();
+      // `?,?,?` placeholders for the active-status set, reused per count.
+      const activePlaceholders = ACTIVE_STATUSES.map(() => '?').join(',');
+      const countOne = async (where, params) => {
+        const rows = await hostDbQuery(
+          `SELECT count(*) AS n FROM tasks WHERE ${where}`,
+          params,
+        );
+        return Number(rows[0]?.n ?? 0);
+      };
+      const [overdue, stale, unassigned, blocked, needsAttention] = await Promise.all([
+        countOne(`status IN (${activePlaceholders}) AND due_date < ?`, [
+          ...ACTIVE_STATUSES,
+          startOfTodayIso,
+        ]),
+        countOne(`status IN (${activePlaceholders}) AND updated_at < ?`, [
+          ...ACTIVE_STATUSES,
+          staleIso,
+        ]),
+        countOne(`status IN (${activePlaceholders}) AND assigned_to IS NULL`, [
+          ...ACTIVE_STATUSES,
+        ]),
+        countOne(`status = ?`, ['blocked']),
+        // overdue OR unassigned, counted once (the deduplicated badge total).
+        countOne(
+          `status IN (${activePlaceholders}) AND (due_date < ? OR assigned_to IS NULL)`,
+          [...ACTIVE_STATUSES, startOfTodayIso],
+        ),
+      ]);
+      return {
+        overdue,
+        stale,
+        unassigned,
+        blocked,
+        needsAttention,
+      };
+    },
+  };
+}
+/** @param {string} id */
+export function taskDetailQuery(id) {
+  return {
+    queryKey: queryKeys.tasks.detail(id),
+    /** @returns {Promise<Task|null>} */
+    queryFn: async () => {
+      const rows = await hostDbQuery('SELECT * FROM tasks WHERE id = ? LIMIT 1', [id]);
+      if (rows.length === 0) return null;
+      return /** @type {Task} */ (normalizeTaskRow(rows[0]));
+    },
+  };
+}
+/** @param {string} parentId */
+export function subtasksQuery(parentId) {
+  return {
+    queryKey: queryKeys.tasks.subtasks(parentId),
+    /** @returns {Promise<Task[]>} */
+    queryFn: async () => {
+      const rows = await hostDbQuery(
+        'SELECT * FROM tasks WHERE parent_task_id = ? ORDER BY created_at ASC',
+        [parentId],
+      );
+      return /** @type {Task[]} */ (rows.map(normalizeTaskRow));
+    },
+  };
+}
+/** @param {string|null} blockingId */
+export function blockingTaskQuery(blockingId) {
+  return {
+    queryKey: queryKeys.tasks.detail(blockingId ?? 'none'),
+    /** @returns {Promise<Task|null>} */
+    queryFn: async () => {
+      if (!blockingId) return null;
+      const rows = await hostDbQuery('SELECT * FROM tasks WHERE id = ? LIMIT 1', [
+        blockingId,
+      ]);
+      if (rows.length === 0) return null;
+      return /** @type {Task} */ (normalizeTaskRow(rows[0]));
+    },
+    enabled: !!blockingId,
+  };
+}

package/dist/lib/query-keys.js ADDED Viewed

@@ -0,0 +1,14 @@
+// TanStack Query cache keys — ported from src/lib/query-keys.ts.
+export const queryKeys = {
+  tasks: {
+    all: ['tasks'],
+    /** @param {string} filter */
+    list: (filter) => [...queryKeys.tasks.all, 'list', filter],
+    /** @param {string} id */
+    detail: (id) => [...queryKeys.tasks.all, 'detail', id],
+    /** @param {string} parentId */
+    subtasks: (parentId) => [...queryKeys.tasks.all, 'subtasks', parentId],
+    triageCounts: () => [...queryKeys.tasks.all, 'triage-counts'],
+  },
+};