@a9n-shoji/rvw 0.2.0 → 0.2.1

package/skills/rvw-watch-comments/scripts/preflight.mjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+import { runRvw } from "./rvw-command.mjs";
+
+const REQUIRED_NODE = [24, 15, 0];
+const REQUIRED_PROTOCOL = 3;
+const REQUIRED_CAPABILITIES = [
+  "agent.transport",
+  "comment.watch",
+  "comment.read",
+  "comment.reply",
+  "comment.edit",
+  "comment.codeReferences",
+  "pullRequest.sync",
+];
+
+function nodeIsSupported(version) {
+  const actual = version.split(".").map(Number);
+  for (let index = 0; index < REQUIRED_NODE.length; index += 1) {
+    if ((actual[index] ?? 0) > REQUIRED_NODE[index]) return true;
+    if ((actual[index] ?? 0) < REQUIRED_NODE[index]) return false;
+  }
+  return true;
+}
+
+function commandSummary(result) {
+  return {
+    exitCode: result.code,
+    signal: result.signal,
+    output: result.json,
+    ...(result.stderr.trim() ? { stderr: result.stderr.trim() } : {}),
+    ...(!result.json && result.stdout.trim() ? { stdout: result.stdout.trim() } : {}),
+  };
+}
+
+async function main() {
+  const settled = await Promise.allSettled([
+    runRvw(["protocol", "--json"]),
+    runRvw(["agent", "status", "--json"]),
+    runRvw(["agent", "ping", "--json"]),
+  ]);
+  const [protocolResult, statusResult, pingResult] = settled.map((result) =>
+    result.status === "fulfilled" ? result.value : null,
+  );
+  const protocol = protocolResult?.json;
+  const agentStatus = statusResult?.json;
+  const agentPing = pingResult?.json;
+  const capabilities = Array.isArray(protocol?.capabilities) ? protocol.capabilities : [];
+  const missingCapabilities = REQUIRED_CAPABILITIES.filter(
+    (capability) => !capabilities.includes(capability),
+  );
+  const checks = {
+    nodeVersion: nodeIsSupported(process.versions.node),
+    rvwBinary: protocolResult !== null,
+    appVersion: typeof protocol?.appVersion === "string" && protocol.appVersion.length > 0,
+    protocol: protocol?.protocolVersion === REQUIRED_PROTOCOL,
+    capabilities: missingCapabilities.length === 0,
+    agentStatus: agentStatus?.ok === true && agentStatus.selectedTransport !== "unavailable",
+    agentPingInspected: agentPing !== null && typeof agentPing === "object",
+    agentPingConnected: agentPing?.ok === true && agentPing.connected === true,
+  };
+  const ok =
+    checks.nodeVersion &&
+    checks.rvwBinary &&
+    checks.appVersion &&
+    checks.protocol &&
+    checks.capabilities &&
+    checks.agentStatus &&
+    checks.agentPingInspected;
+  const output = {
+    ok,
+    node: {
+      version: process.versions.node,
+      required: ">=24.15.0",
+      ok: checks.nodeVersion,
+    },
+    rvw: {
+      binary: protocolResult?.binary ?? process.env.RVW_BIN ?? "rvw",
+      appVersion: typeof protocol?.appVersion === "string" ? protocol.appVersion : null,
+      protocolVersion:
+        typeof protocol?.protocolVersion === "number" ? protocol.protocolVersion : null,
+      requiredProtocolVersion: REQUIRED_PROTOCOL,
+      capabilities,
+      requiredCapabilities: REQUIRED_CAPABILITIES,
+      missingCapabilities,
+    },
+    agent: {
+      status: statusResult ? commandSummary(statusResult) : null,
+      ping: pingResult ? commandSummary(pingResult) : null,
+      pingRequired: false,
+    },
+    checks,
+    errors: settled.flatMap((result, index) =>
+      result.status === "rejected"
+        ? [
+            {
+              command: ["protocol", "agent status", "agent ping"][index],
+              error: String(result.reason),
+            },
+          ]
+        : [],
+    ),
+  };
+  process.stdout.write(`${JSON.stringify(output)}\n`);
+  if (!ok) process.exitCode = 1;
+}
+
+await main();

package/skills/rvw-watch-comments/scripts/rvw-command.mjs

@@ -0,0 +1,80 @@
+import { spawn } from "node:child_process";
+
+const MAX_CAPTURE_BYTES = 40 * 1024 * 1024;
+
+function commandPrefix() {
+  const binary = process.env.RVW_BIN?.trim() || "rvw";
+  const rawPrefix = process.env.RVW_BIN_ARGS_JSON;
+  if (!rawPrefix) return { binary, prefix: [] };
+  let parsed;
+  try {
+    parsed = JSON.parse(rawPrefix);
+  } catch (error) {
+    throw new Error(`RVW_BIN_ARGS_JSON must be a JSON string array: ${String(error)}`, {
+      cause: error,
+    });
+  }
+  if (!Array.isArray(parsed) || parsed.some((value) => typeof value !== "string")) {
+    throw new Error("RVW_BIN_ARGS_JSON must be a JSON string array");
+  }
+  return { binary, prefix: parsed };
+}
+
+export function spawnRvw(args, options = {}) {
+  const { binary, prefix } = commandPrefix();
+  return spawn(binary, [...prefix, ...args], {
+    stdio: options.stdio ?? ["pipe", "pipe", "pipe"],
+    env: process.env,
+  });
+}
+
+export async function runRvw(args, options = {}) {
+  const child = spawnRvw(args);
+  const stdout = [];
+  const stderr = [];
+  let stdoutBytes = 0;
+  let stderrBytes = 0;
+  child.stdout.on("data", (chunk) => {
+    stdoutBytes += chunk.length;
+    if (stdoutBytes <= MAX_CAPTURE_BYTES) stdout.push(chunk);
+  });
+  child.stderr.on("data", (chunk) => {
+    stderrBytes += chunk.length;
+    if (stderrBytes <= MAX_CAPTURE_BYTES) stderr.push(chunk);
+  });
+  if (options.input === undefined) child.stdin.end();
+  else
+    child.stdin.end(
+      typeof options.input === "string" ? options.input : JSON.stringify(options.input),
+    );
+  const status = await new Promise((resolve, reject) => {
+    child.once("error", reject);
+    child.once("close", (code, signal) => resolve({ code, signal }));
+  });
+  if (stdoutBytes > MAX_CAPTURE_BYTES || stderrBytes > MAX_CAPTURE_BYTES) {
+    throw new Error("rvw command output exceeded 40 MiB");
+  }
+  const stdoutText = Buffer.concat(stdout).toString("utf8");
+  const stderrText = Buffer.concat(stderr).toString("utf8");
+  let json = null;
+  if (stdoutText.trim()) {
+    try {
+      json = JSON.parse(stdoutText);
+    } catch {
+      // The caller reports malformed output with the original stdout attached.
+    }
+  }
+  return {
+    args,
+    binary: commandPrefix().binary,
+    code: status.code,
+    signal: status.signal,
+    stdout: stdoutText,
+    stderr: stderrText,
+    json,
+  };
+}
+
+export function successfulJson(result) {
+  return result.code === 0 && result.json && result.json.ok !== false;
+}

package/skills/rvw-watch-comments/scripts/watch-driver.mjs

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { StringDecoder } from "node:string_decoder";
+import { fileURLToPath } from "node:url";
+import { spawnRvw } from "./rvw-command.mjs";
+
+const EXIT_WATCH = 20;
+const EXIT_SEQUENCE = 21;
+const EXIT_INGEST = 22;
+const EXIT_AUTO_ACK = 23;
+const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
+const stateScript = path.join(scriptDirectory, "watch-state.mjs");
+const autoAckScript = path.join(scriptDirectory, "auto-ack.mjs");
+
+class DriverError extends Error {
+  constructor(message, exitCode, details = null) {
+    super(message);
+    this.exitCode = exitCode;
+    this.details = details;
+  }
+}
+
+function parseArguments(values) {
+  let state = null;
+  let autoAck = false;
+  for (let index = 0; index < values.length; index += 1) {
+    const value = values[index];
+    if (value === "--auto-ack") {
+      autoAck = true;
+      continue;
+    }
+    if (value === "--state") {
+      const next = values[index + 1];
+      if (!next || next.startsWith("--")) {
+        throw new DriverError("--state requires a path", EXIT_WATCH);
+      }
+      state = next;
+      index += 1;
+      continue;
+    }
+    if (!value.startsWith("--") && state === null) {
+      state = value;
+      continue;
+    }
+    throw new DriverError(`Unexpected argument: ${value}`, EXIT_WATCH);
+  }
+  if (!state) throw new DriverError("Pass the task state database path", EXIT_WATCH);
+  return { state: path.resolve(state), autoAck };
+}
+
+async function runNodeScript(script, args, input) {
+  const child = spawn(process.execPath, [script, ...args], {
+    stdio: ["pipe", "pipe", "pipe"],
+  });
+  const stdout = [];
+  const stderr = [];
+  child.stdout.on("data", (chunk) => stdout.push(chunk));
+  child.stderr.on("data", (chunk) => stderr.push(chunk));
+  child.stdin.end(input === undefined ? undefined : JSON.stringify(input));
+  const status = await new Promise((resolve, reject) => {
+    child.once("error", reject);
+    child.once("close", (code, signal) => resolve({ code, signal }));
+  });
+  const stdoutText = Buffer.concat(stdout).toString("utf8");
+  const stderrText = Buffer.concat(stderr).toString("utf8");
+  let json = null;
+  try {
+    json = JSON.parse(stdoutText);
+  } catch {
+    // The caller selects the appropriate driver exit contract.
+  }
+  return { ...status, stdout: stdoutText, stderr: stderrText, json };
+}
+
+async function stateCommand(state, command, args = [], input) {
+  const result = await runNodeScript(stateScript, [command, "--state", state, ...args], input);
+  if (result.code !== 0 || !result.json?.ok) {
+    throw new DriverError(`watch-state ${command} failed`, EXIT_INGEST, result);
+  }
+  return result.json;
+}
+
+function write(value) {
+  process.stdout.write(`${JSON.stringify(value)}\n`);
+}
+
+async function dispatchAutoAck(state, pullRequest) {
+  const pending = await stateCommand(state, "list");
+  if (!pending.pending.some((batch) => batch.pullRequest === pullRequest)) {
+    write({ ok: true, type: "queued", pullRequest, reason: "batch-not-yet-eligible" });
+    return;
+  }
+  const result = await runNodeScript(autoAckScript, [
+    "--state",
+    state,
+    "--pull-request",
+    pullRequest,
+  ]);
+  if (result.code !== 0 || !result.json?.ok) {
+    throw new DriverError(`auto-ack failed for ${pullRequest}`, EXIT_AUTO_ACK, result);
+  }
+  write({ ...result.json, type: "batch-acknowledged" });
+}
+
+async function dispatchPendingAutoAcks(state) {
+  const pending = await stateCommand(state, "list");
+  for (const batch of pending.pending) {
+    await dispatchAutoAck(state, batch.pullRequest);
+  }
+}
+
+async function processFrame(state, frame, autoAck, pullRequests) {
+  if (!frame || typeof frame !== "object" || typeof frame.type !== "string") {
+    throw new DriverError("Invalid RFC 7464 frame", EXIT_SEQUENCE, frame);
+  }
+  if (frame.type === "error") {
+    throw new DriverError("rvw comment watch returned an error frame", EXIT_WATCH, frame);
+  }
+  const ingested = await stateCommand(state, "ingest", [], frame);
+  if (frame.type === "ready") {
+    write({
+      ok: true,
+      type: "watch-ready",
+      cursor: ingested.cursor,
+      databaseId: frame.databaseId,
+      anchoredAtCurrent: frame.anchoredAtCurrent,
+      autoAck,
+    });
+  } else if (frame.type === "comment-posted" && ingested.status === "queued") {
+    if (autoAck) pullRequests.add(frame.event.pullRequestUrl);
+    else {
+      write({
+        ok: true,
+        type: "pending",
+        pullRequest: frame.event.pullRequestUrl,
+        commentRef: frame.event.commentRef,
+        cursor: ingested.cursor,
+      });
+    }
+  }
+}
+
+async function runWatchOnce(state, autoAck, stopping) {
+  const current = await stateCommand(state, "status");
+  const args = ["comment", "watch"];
+  if (current.cursor) args.push("--after", current.cursor);
+  args.push("--interval", "1", "--json-seq");
+  const child = spawnRvw(args);
+  stopping.child = child;
+  let stderr = "";
+  child.stderr.setEncoding("utf8");
+  child.stderr.on("data", (chunk) => {
+    stderr += chunk;
+    process.stderr.write(chunk);
+  });
+  const statusPromise = new Promise((resolve, reject) => {
+    child.once("error", reject);
+    child.once("close", (code, signal) => resolve({ code, signal }));
+  });
+  child.stdin.end();
+  const decoder = new StringDecoder("utf8");
+  let buffered = "";
+  let readySeen = false;
+  let stoppedSeen = false;
+  try {
+    for await (const chunk of child.stdout) {
+      buffered += decoder.write(chunk);
+      const lines = buffered.split("\n");
+      buffered = lines.pop() ?? "";
+      const pullRequests = new Set();
+      for (const rawLine of lines) {
+        if (!rawLine) continue;
+        if (!rawLine.startsWith("\u001e")) {
+          throw new DriverError("RFC 7464 frame does not start with RS", EXIT_SEQUENCE, rawLine);
+        }
+        let frame;
+        try {
+          frame = JSON.parse(rawLine.slice(1));
+        } catch (error) {
+          throw new DriverError("RFC 7464 frame is not valid JSON", EXIT_SEQUENCE, String(error));
+        }
+        readySeen ||= frame.type === "ready";
+        stoppedSeen ||= frame.type === "stopped";
+        await processFrame(state, frame, autoAck, pullRequests);
+      }
+      for (const pullRequest of pullRequests) await dispatchAutoAck(state, pullRequest);
+    }
+    buffered += decoder.end();
+    if (buffered.trim()) {
+      throw new DriverError(
+        "rvw comment watch ended with a truncated frame",
+        EXIT_SEQUENCE,
+        buffered,
+      );
+    }
+    const status = await statusPromise;
+    stopping.child = null;
+    return { ...status, stderr, readySeen, stoppedSeen };
+  } catch (error) {
+    child.kill("SIGTERM");
+    await statusPromise.catch(() => undefined);
+    stopping.child = null;
+    throw error;
+  }
+}
+
+function retryDelay(attempt) {
+  const base = Number(process.env.RVW_WATCH_DRIVER_RETRY_MS ?? "1000");
+  const safeBase = Number.isFinite(base) && base >= 0 ? base : 1000;
+  return Math.min(safeBase * 2 ** Math.max(0, attempt - 1), 30_000);
+}
+
+function delay(milliseconds) {
+  return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+
+async function main() {
+  const { state, autoAck } = parseArguments(process.argv.slice(2));
+  const stopping = { requested: false, child: null };
+  const stop = () => {
+    stopping.requested = true;
+    stopping.child?.kill("SIGTERM");
+  };
+  process.once("SIGINT", stop);
+  process.once("SIGTERM", stop);
+  const maxRestarts = Number(process.env.RVW_WATCH_DRIVER_MAX_RESTARTS ?? "5");
+  let restarts = 0;
+  try {
+    while (!stopping.requested) {
+      const startedAt = Date.now();
+      if (autoAck) await dispatchPendingAutoAcks(state);
+      const result = await runWatchOnce(state, autoAck, stopping);
+      if (stopping.requested) return;
+      if (Date.now() - startedAt >= 30_000) restarts = 0;
+      restarts += 1;
+      if (restarts > maxRestarts) {
+        throw new DriverError("rvw comment watch exceeded its reconnect limit", EXIT_WATCH, result);
+      }
+      const delayMs = retryDelay(restarts);
+      write({
+        ok: true,
+        type: "reconnecting",
+        attempt: restarts,
+        delayMs,
+        lastExitCode: result.code,
+        lastSignal: result.signal,
+        readySeen: result.readySeen,
+      });
+      await delay(delayMs);
+    }
+  } finally {
+    process.off("SIGINT", stop);
+    process.off("SIGTERM", stop);
+  }
+}
+
+try {
+  await main();
+} catch (error) {
+  const exitCode = error instanceof DriverError ? error.exitCode : EXIT_WATCH;
+  process.stderr.write(
+    `${JSON.stringify({
+      ok: false,
+      error: error instanceof Error ? error.message : String(error),
+      details: error?.details ?? null,
+      exitCode,
+    })}\n`,
+  );
+  process.exitCode = exitCode;
+}

package/skills/rvw-watch-comments/scripts/watch-state.mjs

@@ -11,20 +11,37 @@ function fail(message) {
 
 function parseOptions(values) {
   const result = {};
+  const flags = new Set(["follow"]);
   for (let index = 0; index < values.length; index += 1) {
     const key = values[index];
     if (!key?.startsWith("--")) fail(`Unexpected argument: ${key ?? ""}`);
+    const name = key.slice(2);
     const value = values[index + 1];
-    if (value === undefined || value.startsWith("--")) fail(`${key} requires a value`);
-    result[key.slice(2)] = value;
-    index += 1;
+    if (value === undefined || value.startsWith("--")) {
+      if (!flags.has(name)) fail(`${key} requires a value`);
+      result[name] = true;
+    } else {
+      result[name] = value;
+      index += 1;
+    }
   }
   return result;
 }
 
 function required(options, key) {
   const value = options[key];
-  if (!value) fail(`--${key} is required`);
+  if (typeof value !== "string" || value.length === 0) fail(`--${key} is required`);
+  return value;
+}
+
+function positiveIntegerOption(options, key, defaultValue) {
+  const raw = options[key];
+  if (raw === undefined) return defaultValue;
+  if (typeof raw !== "string" || !/^\d+$/.test(raw)) {
+    fail(`--${key} must be a positive integer`);
+  }
+  const value = Number(raw);
+  if (!Number.isSafeInteger(value) || value < 1) fail(`--${key} must be a positive integer`);
   return value;
 }
 
@@ -39,6 +56,10 @@ function write(value) {
   process.stdout.write(`${JSON.stringify(value)}\n`);
 }
 
+function waitFor(milliseconds) {
+  return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+
 function openState(statePath, create) {
   const absolute = path.resolve(statePath);
   if (create) {
@@ -376,6 +397,34 @@ function listPending(database) {
     });
 }
 
+async function waitForPending(database, options) {
+  const intervalMs = positiveIntegerOption(options, "interval-ms", 250);
+  const follow = options.follow === true;
+  let wasNonEmpty = false;
+  do {
+    const pending = listPending(database);
+    const isNonEmpty = pending.length > 0;
+    if (isNonEmpty && !wasNonEmpty) {
+      write({
+        ok: true,
+        type: "pending",
+        pullRequests: pending.map((batch) => batch.pullRequest),
+        pending,
+      });
+      if (!follow) return;
+    }
+    wasNonEmpty = isNonEmpty;
+    await waitFor(intervalMs);
+  } while (follow || !wasNonEmpty);
+}
+
+function normalizeWriteKey(writeKey) {
+  if (typeof writeKey !== "string" || !/^[^/\s]+\/[^/\s]+$/.test(writeKey)) {
+    fail("--write-key must be owner/repository");
+  }
+  return writeKey.toLowerCase();
+}
+
 function createBatch(database, pullRequestUrl, now) {
   const batchId = randomUUID();
   const events = database
@@ -405,10 +454,7 @@ function createBatch(database, pullRequestUrl, now) {
 }
 
 function claim(database, pullRequestUrl, writeKey) {
-  if (writeKey !== undefined && !/^[^/\s]+\/[^/\s]+$/.test(writeKey)) {
-    fail("--write-key must be owner/repository");
-  }
-  const canonicalWriteKey = writeKey?.toLowerCase();
+  const canonicalWriteKey = writeKey === undefined ? undefined : normalizeWriteKey(writeKey);
   return transaction(database, () => {
     const now = new Date().toISOString();
     const active = database
@@ -481,6 +527,36 @@ function claim(database, pullRequestUrl, writeKey) {
   });
 }
 
+function reserveWrite(database, leaseId, writeKey) {
+  const canonicalWriteKey = normalizeWriteKey(writeKey);
+  return transaction(database, () => {
+    const batch = database
+      .prepare("SELECT * FROM batches WHERE lease_id = ? AND status = 'in_flight'")
+      .get(leaseId);
+    if (!batch) fail("Active lease was not found");
+    if (batch.write_key !== null && batch.write_key !== canonicalWriteKey) {
+      fail(`Active lease already owns repository ${batch.write_key}`);
+    }
+    try {
+      database
+        .prepare("UPDATE batches SET write_key = ?, updated_at = ? WHERE id = ?")
+        .run(canonicalWriteKey, new Date().toISOString(), batch.id);
+    } catch (error) {
+      if (String(error).includes("UNIQUE constraint failed")) {
+        fail(`Another write-capable batch owns repository ${canonicalWriteKey}`);
+      }
+      throw error;
+    }
+    return {
+      leaseId,
+      batchId: batch.id,
+      pullRequest: batch.pull_request_url,
+      writeKey: canonicalWriteKey,
+      status: batch.write_key === canonicalWriteKey ? "existing" : "reserved",
+    };
+  });
+}
+
 function acknowledge(database, leaseId, input) {
   if (typeof input.commentRef !== "string" || input.commentRef.length === 0) {
     fail("commentRef is required");
@@ -635,6 +711,21 @@ function status(database) {
   const unbatched = database
     .prepare("SELECT count(*) AS count FROM events WHERE status = 'pending' AND batch_id IS NULL")
     .get();
+  const inFlightBatches = database
+    .prepare(
+      `SELECT id, pull_request_url, attempts, lease_id, write_key, updated_at
+      FROM batches WHERE status = 'in_flight' ORDER BY created_at`,
+    )
+    .all()
+    .map((batch) => ({
+      batchId: batch.id,
+      leaseId: batch.lease_id,
+      pullRequest: batch.pull_request_url,
+      attempts: Number(batch.attempts),
+      writeKey: batch.write_key,
+      updatedAt: batch.updated_at,
+      operations: batchStatusOperations(database, batch.id),
+    }));
   return {
     taskId: getMeta(database, "task_id"),
     databaseId: getMeta(database, "database_id"),
@@ -649,6 +740,7 @@ function status(database) {
       quarantined: batchCounts.quarantined ?? 0,
       unbatchedEvents: Number(unbatched.count),
     },
+    inFlightBatches,
     quarantinedBatches: quarantinedBatches(database),
   };
 }
@@ -683,6 +775,10 @@ async function main() {
       write({ ok: true, pending: listPending(database) });
       return;
     }
+    if (command === "wait") {
+      await waitForPending(database, options);
+      return;
+    }
     if (command === "claim") {
       write({
         ok: true,
@@ -690,6 +786,13 @@ async function main() {
       });
       return;
     }
+    if (command === "reserve-write") {
+      write({
+        ok: true,
+        ...reserveWrite(database, required(options, "lease"), required(options, "write-key")),
+      });
+      return;
+    }
     if (command === "complete") {
       write({ ok: true, ...complete(database, required(options, "lease"), await readInput()) });
       return;

package/dist/web/assets/WalkthroughViewer-BVB3ETHG.js

@@ -1 +0,0 @@
-import{r as e}from"./rolldown-runtime-hePW80VL.js";import{B as t,F as n,H as r,L as i,M as a,N as o,P as s,T as c,U as l,V as u,b as d,c as f,d as p,g as m,l as h,o as g,s as _,w as v,x as y,y as b,z as x}from"./index-Coye1BY5.js";import{a as S,i as C,n as w,r as T,t as E}from"./markdown-source-map-_dS1q5Dg.js";var D=e(l(),1),O=r(),k=2400,A={...d,protocols:{...d.protocols,href:[...d.protocols?.href??[],`rvw-ref`]}};function j(e){return e?.startsWith(`rvw-ref:`)?e.slice(8):null}function M(e){return D.Children.toArray(e).map(e=>typeof e==`string`||typeof e==`number`?String(e):(0,D.isValidElement)(e)?M(e.props.children):``).join(``)}function N(e){return e.startLine===null||e.endLine===null?null:e.startLine===e.endLine?`L${e.startLine}`:`L${e.startLine}–${e.endLine}`}function P(e){let t=N(e);return t?`${e.path}:${t}`:e.path}function F(e,t){return!!(e&&t&&e.startLine===t.startLine&&e.endLine===t.endLine)}function I(){return(0,O.jsx)(`svg`,{"aria-hidden":`true`,viewBox:`0 0 16 16`,width:`16`,height:`16`,children:(0,O.jsx)(`path`,{fill:`currentColor`,d:`M5.5 1.75A1.75 1.75 0 0 1 7.25 0h1.5a1.75 1.75 0 0 1 1.75 1.75V2h3a.75.75 0 0 1 0 1.5h-.64l-.68 10.03A2.5 2.5 0 0 1 9.69 16H6.31a2.5 2.5 0 0 1-2.49-2.47L3.14 3.5H2.5a.75.75 0 0 1 0-1.5h3v-.25Zm1.5 0V2h2v-.25a.25.25 0 0 0-.25-.25h-1.5a.25.25 0 0 0-.25.25ZM4.65 3.5l.67 9.96c.02.58.46 1.04.99 1.04h3.38c.53 0 .97-.46.99-1.04l.67-9.96h-6.7Z`})})}function L({source:e,sourceRange:t,commented:n,bindings:r,references:i,themePreference:o,onOpenReference:s,onCommentRange:c,commentComposer:l}){let u=(0,D.useRef)(null),d=!!l;(0,D.useLayoutEffect)(()=>{if(!d)return;let e=window.requestAnimationFrame(()=>{u.current?.scrollIntoView({block:`nearest`,inline:`nearest`})});return()=>window.cancelAnimationFrame(e)},[d]);let f=(0,D.useCallback)(e=>{if(!(e instanceof Element))return;let t=e.closest(`[data-walkthrough-reference-id]`)?.dataset.walkthroughReferenceId;return t?i.get(t):void 0},[i]),p=(0,D.useCallback)(e=>{for(let t of e.querySelectorAll(`g.node, g.classGroup, g[data-id], g[id^='classId-']`)){let e=t.dataset.id??Object.keys(r).find(e=>t.id===e||t.id.includes(`-${e}`)||t.id.includes(`-${e}-`)||t.id.endsWith(`-${e}`));if(!e)continue;let n=r[e],a=n?i.get(n):void 0;a&&(t.classList.add(`walkthrough-diagram-node--linked`),t.setAttribute(`role`,`button`),t.setAttribute(`tabindex`,`0`),t.setAttribute(`aria-label`,`${a.label}をコードで開く`),t.dataset.walkthroughReferenceId=a.id)}},[r,i]);return(0,O.jsxs)(`div`,{className:`walkthrough-diagram-shell${n?` has-comment`:``}`,...t?{"data-rvw-navigation-start-line":t.startLine,"data-rvw-navigation-end-line":t.endLine}:{},children:[(0,O.jsxs)(`div`,{className:`walkthrough-diagram-toolbar`,children:[(0,O.jsx)(`span`,{children:`Mermaid diagram`}),(0,O.jsx)(`span`,{children:`nodeを選択して開く · Cmd/Ctrlで反対のペイン`}),t&&(0,O.jsxs)(`button`,{className:`button--quiet walkthrough-diagram-comment`,onPointerDown:e=>{e.button===0&&(e.preventDefault(),c(t))},onClick:e=>{e.detail===0&&c(t)},children:[(0,O.jsx)(a,{}),`図全体へコメント`]})]}),(0,O.jsx)(h,{className:`walkthrough-diagram`,source:e,themePreference:o,renderIdPrefix:`rvwWalkthrough`,errorClassName:`walkthrough-diagram-error`,onRendered:p,onPointerDown:e=>{let t=f(e.target);t&&(e.preventDefault(),e.stopPropagation(),s(t,e.metaKey||e.ctrlKey))},onKeyDown:e=>{if(e.key!==`Enter`&&e.key!==` `)return;let t=f(e.target);t&&(e.preventDefault(),s(t,!1))}}),l&&(0,O.jsx)(`div`,{className:`walkthrough-diagram-comment-composer`,ref:u,children:l})]})}var R=(0,D.createContext)(null);function z({range:e,pending:t,error:n,onCancel:r,onSubmit:i}){let[a,s]=(0,D.useState)(``),c=e.startLine===e.endLine?`L${e.startLine}へコメント`:`L${e.startLine}–${e.endLine}へコメント`;return(0,O.jsx)(o,{body:a,label:c,pending:t,error:n,validationError:void 0,placement:`line`,onBodyChange:s,onCancel:r,onSubmit:()=>i(a)})}var B=({children:e,node:t,...n})=>{let r=(0,D.useContext)(R),i=D.Children.count(e)===1?D.Children.only(e):null;if(!r||!(0,D.isValidElement)(i)||i.props.className!==`language-mermaid`)return(0,O.jsx)(`pre`,{...n,children:e});let a=T(t);return(0,O.jsx)(L,{source:M(i.props.children).trim(),sourceRange:a,commented:!!(a&&r.activeCommentId&&r.placedComments.some(({comment:e,placement:t})=>e.id===r.activeCommentId&&t.range&&t.range.startLine<=a.endLine&&t.range.endLine>=a.startLine)),bindings:r.diagramBindings,references:r.references,themePreference:r.themePreference,onOpenReference:r.onOpenReference,onCommentRange:r.onCommentRange,commentComposer:a&&F(a,r.diagramCommentRange)?(0,O.jsx)(z,{range:a,pending:r.diagramCommentPending,error:r.diagramCommentError,onCancel:r.onCancelDiagramComment,onSubmit:e=>r.onSubmitDiagramComment(a,e)},`${a.startLine}:${a.endLine}`):null})},V=(0,D.memo)(function({body:e,diagramBindings:t,references:n,placedComments:r,activeCommentId:i,selectedRange:a,selectionComposerOpen:o,diagramCommentRange:s,markdownSourceOid:l,themePreference:u,onOpenReference:d,onOpenRepositoryLink:h,onCommentActiveChange:g,onCommentRange:x,diagramCommentPending:T,diagramCommentError:E,onCancelDiagramComment:k,onSubmitDiagramComment:M}){let F=(0,D.useRef)(null),I=(0,D.useMemo)(()=>r.map(({comment:e,placement:t})=>({id:e.id,range:t.range})),[r]),L=(0,D.useMemo)(()=>new Map(r.map(({comment:e,placement:t})=>[e.id,{comment:e,placement:t}])),[r]),z=(0,D.useCallback)(({node:e,children:t,...n})=>{let r=w(e);return r.length===0?(0,O.jsx)(`div`,{...n,children:t}):(0,O.jsx)(`div`,{className:`markdown-inline-comments`,children:r.map(e=>{let t=L.get(e);return t?(0,O.jsx)(f,{comment:t.comment,variant:`inline`,placement:t.placement,markdownSourceOid:l,themePreference:u,onActiveChange:g,onOpenRepositoryLink:h},e):null})})},[L,l,g,h,u]);return(0,O.jsx)(R.Provider,{value:{diagramBindings:t,references:n,placedComments:r,activeCommentId:i,diagramCommentRange:s,themePreference:u,onOpenReference:d,onCommentRange:x,diagramCommentPending:T,diagramCommentError:E,onCancelDiagramComment:k,onSubmitDiagramComment:M},children:(0,O.jsx)(`article`,{className:`walkthrough-markdown`,children:(0,O.jsx)(v,{rehypePlugins:[y,[b,A],[S,{annotations:I,activeCommentId:i,selectedRange:a,composerOpen:o}]],remarkPlugins:[m],urlTransform:e=>e.startsWith(`rvw-ref:`)?e:c(e),components:{div:z,table:({children:e,node:t,...n})=>(0,O.jsx)(`div`,{className:`markdown-table-scroll`,children:(0,O.jsx)(`table`,{...C(t),...n,children:e})}),a:({href:e,children:t,node:r,...i})=>{let a=j(e),o=a?n.get(a):void 0;return o?(0,O.jsxs)(`button`,{className:`walkthrough-inline-reference`,title:P(o),onPointerDown:e=>{e.button===0&&(F.current={x:e.clientX,y:e.clientY})},onPointerUp:e=>{let t=F.current;F.current=null,t&&(Math.hypot(e.clientX-t.x,e.clientY-t.y)>4||(e.preventDefault(),e.stopPropagation(),d(o,e.metaKey||e.ctrlKey)))},onPointerCancel:()=>{F.current=null},onClick:e=>{e.preventDefault(),e.detail===0&&d(o,!1)},onContextMenu:e=>{(e.ctrlKey||e.metaKey)&&e.preventDefault()},children:[(0,O.jsx)(_,{path:o.path,kind:`file`}),(0,O.jsx)(`span`,{children:t}),(0,O.jsx)(`small`,{children:N(o)??`File`})]}):(0,O.jsx)(`a`,{...C(r),...i,href:e,children:t})},img:({alt:e,title:t,node:n})=>(0,O.jsx)(p,{alt:e,title:t,sourceAttributes:C(n)}),pre:B},children:e})})})});function H({walkthrough:e,comments:r,activeCommentId:c,navigationTarget:l,onNavigationApplied:d,themePreference:p,onCommentActiveChange:m,onOpenReference:h,onOpenRepositoryLink:_,onDeleted:v}){let y=u(),b=(0,D.useRef)(null),S=(0,D.useRef)(null),C=(0,D.useRef)(d);C.current=d;let[w,T]=(0,D.useState)(!1),[A,j]=(0,D.useState)(null),[M,N]=(0,D.useState)(null),[P,F]=(0,D.useState)(null),[L,R]=(0,D.useState)(``),[z,B]=(0,D.useState)(null),H=(0,D.useRef)(0),U=(0,D.useRef)(null),ee=(0,D.useMemo)(()=>new Map(e.references.map(e=>[e.id,e])),[e.references]);(0,D.useLayoutEffect)(()=>{if(!l||S.current===l.requestId)return;let e=l.requestId,t=window.requestAnimationFrame(()=>{let t=b.current;if(!t)return;if(l.line===null){t.scrollIntoView({behavior:`auto`,block:`start`,inline:`nearest`}),S.current=e,C.current(e);return}let n=String(l.line),r=t.querySelector(`[data-rvw-navigation-start-line="${n}"]`)??t.querySelector(`[data-rvw-source-start-line="${n}"]`),i=r?.closest(`details:not([open])`);i&&(i.open=!0),r&&(r.scrollIntoView({behavior:`auto`,block:`center`,inline:`nearest`}),S.current=e,C.current(e))});return()=>window.cancelAnimationFrame(t)},[l]);let W=(0,D.useCallback)((t,n)=>{H.current+=1;let r=H.current;U.current!==null&&(window.clearTimeout(U.current),U.current=null),B(null),h(e,t,n).then(e=>{r!==H.current||!e||(B(e),U.current=window.setTimeout(()=>{B(null),U.current=null},k))})},[h,e]);(0,D.useEffect)(()=>()=>{H.current+=1,U.current!==null&&window.clearTimeout(U.current)},[]);let G=r.filter(t=>t.target.kind===`walkthrough`&&t.target.walkthroughId===e.id),K=G.reduce((e,t)=>e+t.posts.length,0),q=t({queryKey:[`walkthrough-comment-placements`,e.id,e.body,G.map(e=>`${e.id}:${e.updatedAt}`)],queryFn:async()=>{let t=new URLSearchParams({kind:`walkthrough`,pullRequestId:e.pullRequestId,walkthroughId:e.id});return await Promise.all(G.map(async e=>({comment:e,placement:(await n(`/api/comments/${e.id}/placement?${t.toString()}`)).placement})))},enabled:G.length>0}),J=(0,D.useMemo)(()=>q.data??[],[q.data]),te=(0,D.useMemo)(()=>J.filter(({placement:e})=>!e.outdated&&e.range!==null),[J]),Y=(0,D.useMemo)(()=>J.filter(({comment:e,placement:t})=>e.target.kind===`walkthrough`&&e.target.startLine===null||t.outdated),[J]),X=x({mutationFn:async({range:t,body:r})=>await n(`/api/comments`,i({pullRequestId:e.pullRequestId,target:{kind:`walkthrough`,walkthroughId:e.id,startLine:t?.startLine??null,endLine:t?.endLine??null},body:r,authorLabel:`You`})),onSuccess:async()=>{window.getSelection()?.removeAllRanges(),R(``),T(!1),j(null),N(null),F(null),await y.invalidateQueries({queryKey:[`comments`]}),await y.invalidateQueries({queryKey:[`change-sequence`]})}}),Z=x({mutationFn:async()=>await n(`/api/pull-requests/${e.pullRequestId}/walkthroughs/${e.id}`,{...i({}),method:`DELETE`}),onSuccess:async()=>{v(e),await Promise.all([y.invalidateQueries({queryKey:[`walkthroughs`]}),y.invalidateQueries({queryKey:[`walkthrough`]}),y.invalidateQueries({queryKey:[`comments`]}),y.invalidateQueries({queryKey:[`change-sequence`]})])}}),Q=G.filter(e=>e.resolvedAt===null).length,ne=()=>{let e=G.length===0?`紐づくコメントはありません。`:`紐づくコメント ${G.length}件と投稿 ${K}件も削除されます。`;window.confirm(`このウォークスルーを削除します。\n${e}\nコピー済みの参照は無効になります。\n\nこの操作は元に戻せません。`)&&Z.mutate()},re=A?A.startLine===A.endLine?`L${A.startLine}`:`L${A.startLine}–${A.endLine}`:null,$=()=>{window.getSelection()?.removeAllRanges(),X.reset(),R(``),j(null),N(null),F(null)},ie=e=>{X.reset(),R(``),T(!1),j(null),N(e),F(`diagram`)},ae=A?(0,O.jsx)(o,{body:L,label:`${re??`選択範囲`}へコメント`,pending:X.isPending,error:X.error,validationError:void 0,placement:`line`,onBodyChange:R,onCancel:$,onSubmit:()=>X.mutate({range:A,body:L})}):null,oe=(0,O.jsx)(V,{body:e.body,diagramBindings:e.diagramBindings,references:ee,placedComments:te,activeCommentId:c,selectedRange:P===`selection`?A:null,selectionComposerOpen:P===`selection`,diagramCommentRange:M,markdownSourceOid:e.sourceOid,themePreference:p,onOpenReference:W,onOpenRepositoryLink:_,onCommentActiveChange:m,onCommentRange:ie,diagramCommentPending:X.isPending,diagramCommentError:X.error,onCancelDiagramComment:$,onSubmitDiagramComment:(e,t)=>X.mutate({range:e,body:t})});return(0,O.jsxs)(`div`,{className:`walkthrough-viewer`,ref:b,children:[(0,O.jsxs)(`header`,{className:`walkthrough-viewer-header`,children:[(0,O.jsxs)(`div`,{className:`walkthrough-viewer-title`,children:[(0,O.jsx)(`span`,{className:`walkthrough-viewer-icon`,children:(0,O.jsx)(g,{})}),(0,O.jsxs)(`div`,{className:`walkthrough-viewer-heading-copy`,children:[(0,O.jsx)(`span`,{className:`walkthrough-kicker`,children:`Agent-provided walkthrough`}),(0,O.jsx)(`h2`,{title:e.title,children:e.title})]})]}),(0,O.jsxs)(`div`,{className:`walkthrough-viewer-actions`,children:[(0,O.jsxs)(`button`,{className:`comment-icon-button walkthrough-comment-button`,"aria-label":`ウォークスルー全体へコメント`,title:`ウォークスルー全体へコメント`,"aria-pressed":w,onClick:()=>{X.reset(),R(``),j(null),N(null),F(null),T(e=>!e)},children:[(0,O.jsx)(a,{}),Q>0&&(0,O.jsx)(`span`,{children:Q})]}),(0,O.jsx)(`button`,{className:`comment-icon-button walkthrough-delete-button`,"aria-label":`ウォークスルーを削除`,title:`ウォークスルーを削除`,disabled:Z.isPending,onClick:ne,children:(0,O.jsx)(I,{})})]}),z&&(0,O.jsx)(`div`,{className:`walkthrough-reference-notice`,role:`status`,"aria-live":`polite`,children:z})]}),(0,O.jsx)(s,{error:Z.error}),(0,O.jsx)(s,{error:q.error}),(w||Y.length>0)&&(0,O.jsxs)(`div`,{className:`walkthrough-comment-area`,children:[w&&(0,O.jsx)(o,{body:L,label:`ウォークスルー全体へコメント`,pending:X.isPending,error:X.error,validationError:void 0,placement:`file`,onBodyChange:R,onCancel:()=>{X.reset(),R(``),T(!1)},onSubmit:()=>X.mutate({range:null,body:L})}),Y.map(({comment:t,placement:n})=>(0,O.jsx)(f,{comment:t,variant:`inline`,placement:n,markdownSourceOid:e.sourceOid,themePreference:p,onActiveChange:m,onOpenRepositoryLink:_},t.id))]}),(0,O.jsx)(E,{className:`walkthrough-markdown-surface`,selectedRange:A,composerOpen:P===`selection`,onSelection:e=>{if(!e){j(null),F(e=>e===`selection`?null:e);return}X.reset(),R(``),T(!1),j(e),N(null),F(null)},onOpenComposer:()=>F(`selection`),composer:ae,children:oe})]})}export{H as WalkthroughViewer};

package/dist/web/assets/architecture-TIHT7OUA-BjGWtjPU.js

@@ -1 +0,0 @@
-import"./chunk-KEIR6QF5-BICK3FdT.js";import{M as e}from"./mermaid-parser.core-B7TMMtY0.js";export{e as createArchitectureServices};

package/dist/web/assets/channel-DkH22XO0.js

@@ -1 +0,0 @@
-import{at as e,ot as t}from"./chunk-I66GZJ75-DdoGlxMt.js";var n=(n,r)=>t.lang.round(e.parse(n)[r]);export{n as t};

package/dist/web/assets/classDiagram-JCYQIIEL-C6Z4rmZR.js

@@ -1 +0,0 @@
-import{n as e}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./src-B6xuSHsQ.js";import"./chunk-I66GZJ75-DdoGlxMt.js";import"./chunk-NSK5VX7P-1AsXiBV3.js";import"./chunk-4I5QYGJK-Cg5GZ_-7.js";import"./chunk-WRU74C26-C7IeXZaP.js";import"./chunk-7BUUIJ7U-Bb538aSH.js";import"./chunk-UBXNYLIW-mu3fkNQI.js";import"./chunk-2GRJ4B5K-gt2JPyrH.js";import"./chunk-XXDRQBXY-DqAYeljN.js";import"./chunk-KBJHAD2P-BBacwg3J.js";import"./chunk-W5SLKNZC-BAwhMBBb.js";import"./chunk-QR6OTTB3-DL2s5pNp.js";import"./chunk-7Z6QIM7H-D2YImamZ.js";import{i as t,n,r,t as i}from"./chunk-GF5L2VYU-CWtwL_CM.js";import"./mermaid.core-B93x-7Mk.js";var a={parser:n,get db(){return new i},renderer:r,styles:t,init:e(e=>{e.class||={},e.class.arrowMarkerAbsolute=e.arrowMarkerAbsolute},`init`)};export{a as diagram};