@mc1global/opencode-jarvis 0.12.0 → 0.13.0

package/dist/tools/wiki-feedback-tools.js

@@ -0,0 +1,189 @@
+/**
+ * Wiki Feedback Tools — plugin tool definitions for wiki feedback operations.
+ *
+ * 5 tools: scan, list, triage, create-card, dismiss.
+ * Thin adapter layer — delegates to WikiFeedbackUseCases.
+ *
+ * SOLID: SRP — tool definitions only
+ * SOLID: DIP — depends on use case abstractions
+ */
+import { tool } from "@opencode-ai/plugin";
+const z = tool.schema;
+// ── Result Formatting ─────────────────────────────────────────────────
+function formatResult(result, formatter) {
+    if (!result.success)
+        return `ERROR: ${result.error}`;
+    return formatter(result.data);
+}
+function formatFeedbackItem(f) {
+    const lines = [
+        `Feedback: ${f.id} [${f.status}]`,
+        `  Comment: ${f.commentText.length > 120 ? f.commentText.substring(0, 117) + "..." : f.commentText}`,
+        `  Author: ${f.authorDisplayName} (${f.authorUniqueName})`,
+        `  Page: ${f.pagePath} (id=${f.pageId})`,
+        `  Comment Date: ${f.commentCreatedDate}`,
+        `  Detected: ${f.detectedAt}`,
+    ];
+    if (f.feedbackType !== null)
+        lines.push(`  Type: ${f.feedbackType}`);
+    if (f.priority !== null)
+        lines.push(`  Priority: ${f.priority}`);
+    if (f.cardId !== null)
+        lines.push(`  Card: ${f.cardId}`);
+    if (f.dismissReason !== null)
+        lines.push(`  Dismiss Reason: ${f.dismissReason}`);
+    if (f.triagedAt !== null)
+        lines.push(`  Triaged: ${f.triagedAt}`);
+    if (f.resolvedAt !== null)
+        lines.push(`  Resolved: ${f.resolvedAt}`);
+    return lines.join("\n");
+}
+// ── Tool Factory ──────────────────────────────────────────────────────
+export function createWikiFeedbackTools(deps) {
+    const { useCases, pollService } = deps;
+    // ── wiki-feedback-scan ────────────────────────────────────────────
+    const feedbackScan = tool({
+        description: "Scan monitored wiki pages for new feedback comments. " +
+            "Detects new comments, filters auto-replies, and persists " +
+            "new WikiFeedbackItems. Also shows poll service status if running.",
+        args: {},
+        async execute() {
+            const result = await useCases.scan();
+            let output = formatResult(result, (scan) => {
+                const lines = [
+                    `Scan complete:`,
+                    `  Pages scanned: ${scan.pagesScanned}`,
+                    `  New comments found: ${scan.newCommentsFound}`,
+                    `  Existing skipped: ${scan.existingSkipped}`,
+                    `  Auto-replies filtered: ${scan.autoRepliesFiltered}`,
+                ];
+                return lines.join("\n");
+            });
+            // Append poll service status if available
+            if (pollService) {
+                output += `\n\nPoll Service: ${pollService.running ? "running" : "stopped"}`;
+                output += ` | Polls: ${pollService.pollCount}`;
+                if (pollService.lastPollAt) {
+                    output += ` | Last: ${pollService.lastPollAt}`;
+                }
+            }
+            return output;
+        },
+    });
+    // ── wiki-feedback-list ────────────────────────────────────────────
+    const feedbackList = tool({
+        description: "List wiki feedback items. Defaults to pending (untriaged) items. " +
+            "Optionally filter by status: pending, triaged, card_created, dismissed.",
+        args: {
+            status: z
+                .enum(["pending", "triaged", "card_created", "dismissed"])
+                .optional()
+                .describe("Filter by status (default: pending)"),
+            limit: z
+                .number()
+                .int()
+                .optional()
+                .describe("Max items to return (default: 50)"),
+        },
+        async execute(args) {
+            const limit = args.limit ?? 50;
+            if (args.status !== undefined) {
+                const result = await useCases.listByStatus(args.status, limit);
+                return formatResult(result, formatFeedbackList);
+            }
+            const result = await useCases.listPending(limit);
+            return formatResult(result, formatFeedbackList);
+        },
+    });
+    // ── wiki-feedback-triage ──────────────────────────────────────────
+    const feedbackTriage = tool({
+        description: "Triage a pending wiki feedback item: assign type and priority. " +
+            "Moves status from pending → triaged. " +
+            "Types: feature, bug, improvement, question, documentation. " +
+            "Priorities: high, medium, low.",
+        args: {
+            feedback_id: z.string().describe("Feedback ID (e.g., WF-001)"),
+            feedback_type: z
+                .enum(["feature", "bug", "improvement", "question", "documentation"])
+                .describe("Classification of the feedback"),
+            priority: z
+                .enum(["high", "medium", "low"])
+                .describe("Suggested priority for the resulting card"),
+        },
+        async execute(args) {
+            const result = await useCases.triage({
+                feedbackId: args.feedback_id,
+                feedbackType: args.feedback_type,
+                priority: args.priority,
+            });
+            return formatResult(result, formatFeedbackItem);
+        },
+    });
+    // ── wiki-feedback-create-card ─────────────────────────────────────
+    const feedbackCreateCard = tool({
+        description: "Create a kanban card from a triaged wiki feedback item. " +
+            "The feedback must be in triaged status. Optionally override " +
+            "title, description, and epic. Posts auto-reply on wiki if enabled.",
+        args: {
+            feedback_id: z.string().describe("Feedback ID (e.g., WF-001)"),
+            title: z
+                .string()
+                .optional()
+                .describe("Custom card title (auto-generated if omitted)"),
+            description: z
+                .string()
+                .optional()
+                .describe("Custom card description (auto-generated if omitted)"),
+            epic_id: z
+                .string()
+                .optional()
+                .describe("Epic ID to assign the card to (e.g., EP-001)"),
+        },
+        async execute(args) {
+            const result = await useCases.createCard({
+                feedbackId: args.feedback_id,
+                ...(args.title !== undefined ? { title: args.title } : {}),
+                ...(args.description !== undefined ? { description: args.description } : {}),
+                ...(args.epic_id !== undefined ? { epicId: args.epic_id } : {}),
+            });
+            return formatResult(result, (f) => {
+                const lines = [formatFeedbackItem(f)];
+                if (f.cardId) {
+                    lines.push(`\nKanban card ${f.cardId} created successfully.`);
+                }
+                return lines.join("\n");
+            });
+        },
+    });
+    // ── wiki-feedback-dismiss ─────────────────────────────────────────
+    const feedbackDismiss = tool({
+        description: "Dismiss a wiki feedback item with a reason. " +
+            "Can dismiss from pending or triaged status. " +
+            "Use when the feedback is not actionable, duplicate, or irrelevant.",
+        args: {
+            feedback_id: z.string().describe("Feedback ID (e.g., WF-001)"),
+            reason: z.string().describe("Reason for dismissal"),
+        },
+        async execute(args) {
+            const result = await useCases.dismiss({
+                feedbackId: args.feedback_id,
+                reason: args.reason,
+            });
+            return formatResult(result, formatFeedbackItem);
+        },
+    });
+    return {
+        "wiki-feedback-scan": feedbackScan,
+        "wiki-feedback-list": feedbackList,
+        "wiki-feedback-triage": feedbackTriage,
+        "wiki-feedback-create-card": feedbackCreateCard,
+        "wiki-feedback-dismiss": feedbackDismiss,
+    };
+}
+// ─── List Formatter ───────────────────────────────────────────────────────────
+function formatFeedbackList(items) {
+    if (items.length === 0)
+        return "No feedback items found.";
+    return items.map(formatFeedbackItem).join("\n---\n");
+}
+//# sourceMappingURL=wiki-feedback-tools.js.map

package/dist/tools/wiki-feedback-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-feedback-tools.js","sourceRoot":"","sources":["../../src/tools/wiki-feedback-tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mc1global/opencode-jarvis",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "JARVIS Framework - OpenCode native plugin for multi-agent development with DDD architecture",
   "author": "Julio Fabio de O. Chagas <julio.fabio@mc1global.com>",
   "license": "SEE LICENSE IN LICENSE",

package/templates/agents-md.template.md

@@ -57,6 +57,7 @@ snippets). The implementing agent decides those during the `doing` phase.
 - Read `.yaml/.yml` directly — use `data-yaml-get` tool
 - Read `.env`, `.pem`, `.key`, credentials files — blocked by governance
 - Run `git push --force` on main/master
+- Push directly to `main`/`master` — use Epic branches (`epic/<id>-<slug>`) and merge via PR
 - Run `sqlite3` CLI — use repository methods
 - Create `TODO.md`, `PLAN.md`, or `ROADMAP.md` — use kanban tools
 - Bypass the kanban pipeline for trackable work
@@ -73,14 +74,14 @@ snippets). The implementing agent decides those during the `doing` phase.
 - Track context with sessions, TODOs, and notes
 - Meet all gate tasks before moving cards through review/tested/done
 
-## Governance Policies (13 Runtime Enforced)
+## Governance Policies (14 Runtime Enforced)
 
 Governance policies are evaluated by the `tool.execute.before` hook on every
 tool invocation. Violations with `error` severity throw and block execution.
 
 Policy groups:
 - **File access** — Block direct CSV, YAML, env file reads (use specialized tools)
-- **Shell safety** — Block force push, direct SQLite CLI, warn on destructive ops
+- **Shell safety** — Block force push, direct push to main/master, direct SQLite CLI, warn on destructive ops
 - **Security** — Block env dump, sensitive file reads, credential file access
 - **Pipeline** — Warn when running pipeline without linked card
 - **Kanban** — Require gate tasks before status transitions, warn on rapid transitions
@@ -160,6 +161,10 @@ search, table-read, table-update).
 
 ## Git Strategy
 
+- **Epic branches** — Every Epic `in_progress` MUST have a dedicated branch: `epic/<epic-id>-<slug>`
+  - All cards within an Epic are committed to that branch
+  - Merge to `main` only via PR when Epic is complete
+  - Example: `epic/EP-012-branch-governance`
 - Work on feature branches (never commit directly to `main`)
 - Commit messages: imperative verb + summary + card reference
   - `Add feature X (CD-001)`