convene-cli 1.8.0 → 1.9.0

package/dist/api.js

@@ -86,6 +86,17 @@ class ConveneApi {
         const p = slug ? `/projects/${encodeURIComponent(slug)}/inbox` : '/inbox';
         return this.request('GET', p, { timeoutMs });
     }
+    /**
+     * GET /projects/:slug/feedback — the maintainer-facing feature_feedback list
+     * (read counterpart to `convene suggest`). Member-gated server-side; returns
+     * `{ items: FeedbackItem[], role }` with metadata flattened (lifecycle /
+     * category / upvotes / source_*). Read-only — the `convene feedback` command
+     * is fail-open, so callers pass a short explicit timeout.
+     */
+    listFeedback(slug, opts = {}, timeoutMs) {
+        const qs = opts.limit ? `?limit=${opts.limit}` : '';
+        return this.request('GET', `/projects/${encodeURIComponent(slug)}/feedback${qs}`, { timeoutMs });
+    }
     /**
      * GET /poll — the long-poll stream `convene watch` consumes. `since` is the
      * resume cursor (Last-Event-ID semantics, a messages.id); `wait` is the server

package/dist/commands/feedback.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterFeedback = filterFeedback;
+exports.feedback = feedback;
+/**
+ * `convene feedback [id]` — the READ counterpart to `convene suggest`. Lists the
+ * feature_feedback (feature requests / bugs / notes) filed for this project, or
+ * shows one item by short_id/id.
+ *
+ * FAIL-OPEN, like `convene lanes`: reading your own backlog must NEVER break a
+ * workflow. Any read failure prints a short stderr note and returns (exit 0) —
+ * it never dies/throws. (Contrast `convene inbox`, which is die-loud.)
+ *
+ * The server endpoint already exists (GET /projects/:slug/feedback, member-gated,
+ * returns `{ items, role }`); this command is CLI-only. Filters (--status, --mine,
+ * by-id) are applied CLIENT-SIDE over the returned items. The item `body` is
+ * UNTRUSTED member free-text and only ever reaches the terminal through the
+ * inertToken-sanitizing renderers in render.ts — never inlined here.
+ */
+const ctx_1 = require("../ctx");
+const render_1 = require("../render");
+const FEEDBACK_TIMEOUT_MS = 2500; // explicit short timeout — NEVER the 10s default
+/** Apply the client-side filters in a pure, testable way. */
+function filterFeedback(items, opts) {
+    let out = items;
+    if (opts.id) {
+        out = out.filter((f) => f.short_id === opts.id || f.id === opts.id);
+    }
+    if (opts.status) {
+        const want = opts.status.toLowerCase();
+        out = out.filter((f) => (f.lifecycle || '').toLowerCase() === want);
+    }
+    if (opts.mine && opts.member) {
+        out = out.filter((f) => f.source_member === opts.member);
+    }
+    return out;
+}
+async function feedback(id, opts) {
+    try {
+        const ctx = (0, ctx_1.getContext)({ project: opts.project });
+        const slug = (0, ctx_1.requireSlug)(ctx);
+        const res = await ctx.api.listFeedback(slug, {}, FEEDBACK_TIMEOUT_MS);
+        if (!res.ok || !res.json) {
+            // Fail-open: a backlog read failure is informational, never blocking.
+            process.stderr.write(`convene: feedback UNVERIFIED — could not reach the bus (${res.error ?? res.status})\n`);
+            return;
+        }
+        const all = Array.isArray(res.json.items) ? res.json.items : [];
+        const items = filterFeedback(all, {
+            id,
+            status: opts.status,
+            mine: opts.mine,
+            member: ctx.member,
+        });
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(items, null, 2) + '\n');
+            return;
+        }
+        // Single-item show.
+        if (id) {
+            if (items.length === 0) {
+                process.stdout.write(`no feedback matching "${id}" in ${slug}.\n`);
+                return;
+            }
+            for (const f of items)
+                process.stdout.write((0, render_1.feedbackDetail)(f) + '\n');
+            return;
+        }
+        // List view.
+        if (items.length === 0) {
+            if (opts.status || opts.mine) {
+                process.stdout.write(`no feedback matches that filter in ${slug}.\n`);
+            }
+            else {
+                process.stdout.write(`no feedback filed yet — file one with \`convene suggest "<text>"\`.\n`);
+            }
+            return;
+        }
+        process.stdout.write(`${items.length} feedback item(s) for ${slug}:\n`);
+        for (const f of items)
+            process.stdout.write((0, render_1.feedbackLine)(f) + '\n');
+    }
+    catch (err) {
+        // Defensive: the command must never throw out of fail-open.
+        process.stderr.write(`convene: feedback UNVERIFIED — ${err?.message ?? 'unknown error'}\n`);
+        return;
+    }
+}

package/dist/index.js

@@ -43,6 +43,7 @@ const fetch_1 = require("./commands/fetch");
 const notify_1 = require("./commands/notify");
 const post = __importStar(require("./commands/post"));
 const inbox_1 = require("./commands/inbox");
+const feedback_1 = require("./commands/feedback");
 const auth_1 = require("./commands/auth");
 const init_1 = require("./commands/init");
 const offboard_1 = require("./commands/offboard");
@@ -244,6 +245,14 @@ program
     .option('--project <slug>')
     .option('--json')
     .action((opts) => (0, inbox_1.inbox)(opts));
+program
+    .command('feedback [id]')
+    .description('list or show filed feedback (feature requests / bugs / notes) for this project')
+    .option('--status <lifecycle>', 'filter: new|triaged|planned|shipped|declined')
+    .option('--mine', 'only feedback you filed')
+    .option('--project <slug>')
+    .option('--json')
+    .action((id, opts) => (0, feedback_1.feedback)(id, opts));
 program
     .command('explain [question]')
     .description('ask how Convene itself works (protocol, lanes, halts, privacy, …) — fail-soft, public')

package/dist/render.js

@@ -5,6 +5,8 @@ exports.inertToken = inertToken;
 exports.renderHealthLine = renderHealthLine;
 exports.renderRecentLine = renderRecentLine;
 exports.renderOpenItem = renderOpenItem;
+exports.feedbackLine = feedbackLine;
+exports.feedbackDetail = feedbackDetail;
 exports.renderChannelBlock = renderChannelBlock;
 exports.renderSessionOpenBlock = renderSessionOpenBlock;
 exports.renderRelocateBlock = renderRelocateBlock;
@@ -136,6 +138,65 @@ function renderOpenItem(m, member) {
     // question
     return `  [QUESTION] ${from} [id: ${m.short_id}] ${m.body ?? ''}`.trimEnd();
 }
+/**
+ * One terse feedback line for the list view. Consistent with laneLine/inbox rows:
+ * a `[short_id]` lead, then server-derived structured tokens (lifecycle, category,
+ * age, upvotes, source), and the UNTRUSTED `body` rendered inert + length-capped
+ * via `inertToken`. NEVER inlines the raw body.
+ */
+function feedbackLine(f) {
+    const age = agoLabel(f.created_at);
+    const bits = [`[${f.short_id}]`, f.lifecycle];
+    if (f.category)
+        bits.push(f.category);
+    if (age)
+        bits.push(`${age} ago`);
+    if (f.upvotes > 0)
+        bits.push(`+${f.upvotes}`);
+    const src = f.source_member
+        ? `${f.source_member}${f.source_tool ? `/${f.source_tool}` : ''}`
+        : null;
+    if (src)
+        bits.push(`(${inertToken(src, 48)})`);
+    const body = inertToken(f.body);
+    return `  ${bits.join(' ')}${body ? ` — ${body}` : ''}`;
+}
+/**
+ * The expanded single-item view (`convene feedback <id>`). Full body (still inert)
+ * plus every flattened field, one per line. Mirrors the terse-row grammar but
+ * gives the human the complete picture for one item.
+ */
+function feedbackDetail(f) {
+    const L = [];
+    L.push(`[${f.short_id}] feedback`);
+    L.push(`  lifecycle: ${f.lifecycle}`);
+    if (f.category)
+        L.push(`  category:  ${f.category}`);
+    if (f.severity)
+        L.push(`  severity:  ${f.severity}`);
+    if (f.tags.length)
+        L.push(`  tags:      ${f.tags.map((t) => inertToken(t, 32)).join(', ')}`);
+    L.push(`  upvotes:   ${f.upvotes}`);
+    const age = agoLabel(f.created_at);
+    L.push(`  filed:     ${f.created_at}${age ? ` (${age} ago)` : ''}`);
+    const src = f.source_member
+        ? `${f.source_member}${f.source_tool ? ` / ${f.source_tool}` : ''}`
+        : null;
+    if (src)
+        L.push(`  source:    ${inertToken(src, 64)}`);
+    if (f.source_project)
+        L.push(`  project:   ${inertToken(f.source_project, 64)}`);
+    if (f.from_handle || f.from_session) {
+        L.push(`  from:      ${inertToken(f.from_session || f.from_handle || '', 64)}`);
+    }
+    if (f.bridge_of)
+        L.push(`  bridge_of: ${f.bridge_of}`);
+    if (f.bridged_to)
+        L.push(`  bridged_to: ${f.bridged_to}`);
+    L.push('  body (UNTRUSTED member free-text):');
+    L.push(`    ${inertToken(f.body, 400)}`);
+    return L.join('\n');
+}
 /**
  * One inert lane line. Only server-derived structured tokens reach the agent:
  * the validated holder_handle, numeric ages/ETAs, the canonical lane name. The

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convene-cli",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Convene CLI — AI development coordination bus client + UserPromptSubmit hook. Install: npm i -g convene-cli; then `convene setup`.",
   "license": "MIT",
   "homepage": "https://dev.convene.live",