@a9n-shoji/rvw 0.4.0-beta.0 → 0.4.1

package/CHANGELOG.md

@@ -5,6 +5,33 @@
 
 ## [Unreleased]
 
+## [0.4.1] - 2026-09-01
+
+### Added
+
+- repository fileから、そのfileをNode sourceとして参照するStructureをrename-awareに逆引きし、対応Nodeへ
+  閲覧状態を維持したまま移動できる機能
+- Structure全体を現在のNode配置のままSVGまたは2倍基準のPNGへエクスポートする機能。focus、近傍、
+  viewportにかかわらず全Node、全Relation、全Edge labelを含み、画面の閲覧状態を変更しない
+
+## [0.4.0] - 2026-09-01
+
+### Added
+
+- 一つの具体的なbehavior / processing flowをsource-anchored origin、stable Node / Edge ID、exact source
+  anchorで提示し、1/2-hop / All、focus、pan / zoom / dragから探索できるproduction `Structure` document
+- Structureのpublish / get / whole-value update / confirmation付きdeleteを行うCLI、Agent socket capability、
+  SQLite migration、HTTP API、Codex / Claude Code共通の`rvw-structure` Skill
+- 変更表示の原文と行番号を保ちながら、追加・削除fileを除く空白だけの変更を`…`メニューから非表示にする
+  `Hide Whitespace`設定
+
+### Changed
+
+- 固定サイズのStructure Node内をscroll可能にし、表記ごとの余白、canvasのpan / zoom感度、source anchorの
+  fallback、stale判定、明示的な再解決を改善
+- light / dark themeのdiff canvas、文字、追加・削除行、gutter、inline emphasisの配色をGitHubへ合わせる
+- Hide Whitespace切替時に現在のsource lineをviewportへ保持し、空白差分がすべて隠れた場合は解除方法を表示
+
 ## [0.4.0-beta.0] - 2026-08-31
 
 ### Added

package/README.md

@@ -181,6 +181,10 @@ viewerではfocusがある時に1-hop / 2-hopへ絞り、Allでは全Node / Edge
 保存しません。同じsubjectの更新は同じURIを完全置換し、存続するIDの位置を保ちます。別subjectは新しい
 Structureとしてpublishします。
 
+Structure headerの`Export`から、現在のNode配置を保った図全体をstandalone SVGまたは2倍基準のPNGとして
+保存できます。focusや1-hop / 2-hopで画面上に絞り込んでいても、出力には全Node、全Relation、全Edge labelが
+含まれ、pan / zoomや選択状態は持ち込みません。
+
 ## Codex / Claude Code Skills
 
 アプリ本体からローカルSkillをインストールします。一度のinstallで、コメント処理用の`rvw`、

package/dist/cli.mjs

@@ -20187,7 +20187,7 @@ import path5 from "node:path";
 import { TextDecoder as TextDecoder2 } from "node:util";
 
 // src/shared/constants.ts
-var APP_VERSION = "0.4.0-beta.0";
+var APP_VERSION = "0.4.1";
 var PROTOCOL_VERSION = 4;
 var VIEWER_ID_HEADER = "x-rvw-viewer-id";
 var VIEWER_OPEN_LEASE_HEADER = "x-rvw-viewer-open-lease";
@@ -28466,10 +28466,45 @@ function placeMutableDocumentComment(anchor, currentText) {
   return range ? { outdated: false, range } : { outdated: true, range: null };
 }
 
-// src/domain/walkthrough-reference.ts
-function walkthroughReferenceFingerprint(sourceOid, reference) {
+// src/domain/source-reference.ts
+function sourceAnchorFingerprint(sourceOid, reference) {
   return JSON.stringify([sourceOid, reference.path, reference.startLine, reference.endLine]);
 }
+function structureSourceAnchor(structure, locator) {
+  if (locator.kind === "node") {
+    return structure.nodes.find((node2) => node2.id === locator.nodeId)?.anchor ?? null;
+  }
+  const edge = structure.edges.find((candidate) => candidate.id === locator.edgeId);
+  return edge?.anchors[locator.anchorIndex] ?? null;
+}
+function compareStableIds(left, right) {
+  if (left === right) return 0;
+  return left < right ? -1 : 1;
+}
+function closestMatchingStructureNode(structure, matchingNodeIds) {
+  if (matchingNodeIds.size === 0) return null;
+  const distances = /* @__PURE__ */ new Map([[structure.originNodeId, 0]]);
+  const neighbors = new Map(structure.nodes.map((node2) => [node2.id, /* @__PURE__ */ new Set()]));
+  for (const edge of structure.edges) {
+    neighbors.get(edge.from)?.add(edge.to);
+    neighbors.get(edge.to)?.add(edge.from);
+  }
+  const queue = [structure.originNodeId];
+  for (let index2 = 0; index2 < queue.length; index2 += 1) {
+    const nodeId = queue[index2];
+    const distance = distances.get(nodeId);
+    for (const neighbor of neighbors.get(nodeId) ?? []) {
+      if (distances.has(neighbor)) continue;
+      distances.set(neighbor, distance + 1);
+      queue.push(neighbor);
+    }
+  }
+  return structure.nodes.filter((node2) => matchingNodeIds.has(node2.id)).sort((left, right) => {
+    const leftDistance = distances.get(left.id) ?? Number.POSITIVE_INFINITY;
+    const rightDistance = distances.get(right.id) ?? Number.POSITIVE_INFINITY;
+    return leftDistance - rightDistance || compareStableIds(left.id, right.id);
+  })[0] ?? null;
+}
 
 // src/domain/source-excerpt.ts
 var SOURCE_EXCERPT_CONTEXT_LINES = 20;
@@ -41438,6 +41473,18 @@ function assertLinePair(startLine, endLine) {
 }
 var codeReferenceIdPattern = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
 var walkthroughDiagramNodePattern = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+function structureSummary(structure) {
+  return {
+    id: structure.id,
+    ref: structure.ref,
+    pullRequestId: structure.pullRequestId,
+    sourceOid: structure.sourceOid,
+    title: structure.title,
+    scope: structure.scope,
+    createdAt: structure.createdAt,
+    updatedAt: structure.updatedAt
+  };
+}
 var mermaidIdentifierPattern = /[A-Za-z][A-Za-z0-9_-]{0,63}/g;
 var mermaidEdgePattern = /[<|o*x]*[-.=~]{2,}[|o*x>]*/g;
 var mermaidClassShorthandPattern = /:::[A-Za-z][A-Za-z0-9_-]*(?:,[A-Za-z][A-Za-z0-9_-]*)*/g;
@@ -42502,6 +42549,71 @@ var RvwService = class {
     this.getPullRequest(pullRequestId);
     return this.database.listStructures(pullRequestId);
   }
+  async listFileStructureReferences(pullRequestId, targetSourceOid, targetPath) {
+    const pullRequest = this.getPullRequest(pullRequestId);
+    assertCodeReferencePath(targetPath);
+    const structures = this.database.listStructures(pullRequestId).flatMap((summary) => {
+      const structure = this.database.getStructure(summary.id);
+      return structure?.pullRequestId === pullRequestId ? [structure] : [];
+    });
+    await this.assertCommitAvailable(pullRequest, targetSourceOid);
+    const targetPaths = new Set(
+      (await this.git.tree(pullRequest.localRepositoryPath, targetSourceOid)).map(
+        (entry) => entry.path
+      )
+    );
+    if (!targetPaths.has(targetPath)) return [];
+    const successorIndexes = /* @__PURE__ */ new Map();
+    const successorIndex = (sourceOid) => {
+      const key2 = JSON.stringify([sourceOid, targetSourceOid]);
+      const cached2 = successorIndexes.get(key2);
+      if (cached2) return cached2;
+      const index2 = this.git.changedFilesWithCopies(pullRequest.localRepositoryPath, sourceOid, targetSourceOid).then((changes) => {
+        const successors = /* @__PURE__ */ new Map();
+        for (const candidate of changes) {
+          if (!candidate.status.startsWith("R") && !candidate.status.startsWith("C") || candidate.oldPath === null || candidate.newPath === null) {
+            continue;
+          }
+          const paths = successors.get(candidate.oldPath) ?? /* @__PURE__ */ new Set();
+          paths.add(candidate.newPath);
+          successors.set(candidate.oldPath, paths);
+        }
+        return successors;
+      });
+      successorIndexes.set(key2, index2);
+      return index2;
+    };
+    const resolvePath = (sourceOid, sourcePath) => {
+      if (targetPaths.has(sourcePath)) return Promise.resolve(sourcePath);
+      if (sourceOid === targetSourceOid) return Promise.resolve(null);
+      return successorIndex(sourceOid).then((index2) => {
+        const successors = index2.get(sourcePath);
+        if (successors?.size !== 1) return null;
+        const successor = [...successors][0];
+        return targetPaths.has(successor) ? successor : null;
+      });
+    };
+    const references = [];
+    for (const structure of structures) {
+      const matchingNodeIds = /* @__PURE__ */ new Set();
+      await Promise.all(
+        structure.nodes.map(async (node2) => {
+          if (!node2.anchor) return;
+          const resolvedPath = await resolvePath(structure.sourceOid, node2.anchor.path);
+          if (resolvedPath === targetPath) matchingNodeIds.add(node2.id);
+        })
+      );
+      const targetNode = closestMatchingStructureNode(structure, matchingNodeIds);
+      if (!targetNode) continue;
+      references.push({
+        structure: structureSummary(structure),
+        targetNodeId: targetNode.id,
+        targetNodeLabel: targetNode.label,
+        matchingNodeCount: matchingNodeIds.size
+      });
+    }
+    return references;
+  }
   listStructuresByReference(reference) {
     const pullRequest = this.resolveStoredPullRequest(reference);
     return { pullRequest, structures: this.database.listStructures(pullRequest.id) };
@@ -42796,7 +42908,7 @@ var RvwService = class {
     }
     return walkthrough;
   }
-  async walkthroughReferenceFallbackTarget(pullRequest, sourceOid, filePath) {
+  async sourceReferenceFallbackTarget(pullRequest, sourceOid, filePath) {
     const diffBaseOid = await this.git.firstParent(pullRequest.localRepositoryPath, sourceOid);
     if (!diffBaseOid) {
       return {
@@ -42827,46 +42939,48 @@ var RvwService = class {
         status: 404
       });
     }
-    const referenceFingerprint = walkthroughReferenceFingerprint(walkthrough.sourceOid, reference);
+    const referenceFingerprint = sourceAnchorFingerprint(walkthrough.sourceOid, reference);
+    return await this.resolveSourceAnchor(
+      pullRequest,
+      walkthrough.sourceOid,
+      reference,
+      referenceFingerprint
+    );
+  }
+  async resolveStructureSource(pullRequestId, structureId, locator) {
+    const pullRequest = this.getPullRequest(pullRequestId);
+    const structure = this.getStructure(pullRequestId, structureId);
+    const anchor = structureSourceAnchor(structure, locator);
+    if (!anchor) {
+      throw new RvwError("NOT_FOUND", "Structure\u306E\u53C2\u7167\u5143claim\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002", {
+        status: 404
+      });
+    }
+    const resolution = await this.resolveSourceAnchor(
+      pullRequest,
+      structure.sourceOid,
+      anchor,
+      sourceAnchorFingerprint(structure.sourceOid, anchor)
+    );
+    return { ...resolution, resolvedAnchor: anchor };
+  }
+  async resolveSourceAnchor(pullRequest, sourceOid, reference, referenceFingerprint) {
     const sourceDocument = await this.getDocument({
       kind: "repository-file",
-      pullRequestId,
-      sourceOid: walkthrough.sourceOid,
+      pullRequestId: pullRequest.id,
+      sourceOid,
       path: reference.path
     });
     const latestHeadOid = pullRequest.latestHeadOid;
-    let latestPath = reference.path;
-    let latestDocument;
-    if (walkthrough.sourceOid === latestHeadOid) {
-      latestDocument = sourceDocument;
-    } else {
-      latestDocument = await this.getDocument({
-        kind: "repository-file",
-        pullRequestId,
-        sourceOid: latestHeadOid,
-        path: reference.path
-      });
-      if (latestDocument.availability === "missing") {
-        const successorPaths = [
-          ...new Set(
-            (await this.git.changedFilesWithCopies(
-              pullRequest.localRepositoryPath,
-              walkthrough.sourceOid,
-              latestHeadOid
-            )).filter(
-              (candidate) => (candidate.status.startsWith("R") || candidate.status.startsWith("C")) && candidate.oldPath === reference.path && candidate.newPath !== null
-            ).map((candidate) => candidate.newPath)
-          )
-        ];
-        latestPath = successorPaths.length === 1 ? successorPaths[0] : null;
-        latestDocument = latestPath === null ? null : await this.getDocument({
-          kind: "repository-file",
-          pullRequestId,
-          sourceOid: latestHeadOid,
-          path: latestPath
-        });
-      }
-    }
+    const resolvedLatestFile = await this.resolveSourceFileAtCommit(
+      pullRequest,
+      sourceOid,
+      reference.path,
+      latestHeadOid,
+      sourceDocument
+    );
+    const latestPath = resolvedLatestFile?.path ?? null;
+    const latestDocument = resolvedLatestFile?.document ?? null;
     const latestFileExists = latestDocument !== null && latestDocument.availability !== "missing";
     const latestFileDisplayable = latestDocument?.availability === "available";
     const mappedRange = reference.startLine === null || reference.endLine === null ? latestFileDisplayable ? null : void 0 : sourceDocument.availability === "available" && latestDocument?.availability === "available" ? mapUnchangedLineRange(
@@ -42879,7 +42993,7 @@ var RvwService = class {
     if (resolvedToLatest && latestPath !== null && latestDocument !== null) {
       return {
         outcome: "latest",
-        anchorSourceOid: walkthrough.sourceOid,
+        anchorSourceOid: sourceOid,
         latestHeadOid,
         referenceFingerprint,
         target: {
@@ -42896,9 +43010,9 @@ var RvwService = class {
         document: latestDocument
       };
     }
-    const targetFile = await this.walkthroughReferenceFallbackTarget(
+    const targetFile = await this.sourceReferenceFallbackTarget(
       pullRequest,
-      walkthrough.sourceOid,
+      sourceOid,
       reference.path
     );
     const latestFile = latestFileExists && latestPath !== null ? {
@@ -42911,7 +43025,7 @@ var RvwService = class {
     } : null;
     return {
       outcome: "source-fallback",
-      anchorSourceOid: walkthrough.sourceOid,
+      anchorSourceOid: sourceOid,
       latestHeadOid,
       referenceFingerprint,
       target: {
@@ -42923,6 +43037,38 @@ var RvwService = class {
       document: sourceDocument
     };
   }
+  async resolveSourceFileAtCommit(pullRequest, sourceOid, sourcePath, targetSourceOid, sourceDocument) {
+    const directDocument = sourceOid === targetSourceOid ? sourceDocument : await this.getDocument({
+      kind: "repository-file",
+      pullRequestId: pullRequest.id,
+      sourceOid: targetSourceOid,
+      path: sourcePath
+    });
+    if (directDocument.availability !== "missing") {
+      return { path: sourcePath, document: directDocument };
+    }
+    if (sourceOid === targetSourceOid) return null;
+    const successorPaths = [
+      ...new Set(
+        (await this.git.changedFilesWithCopies(
+          pullRequest.localRepositoryPath,
+          sourceOid,
+          targetSourceOid
+        )).filter(
+          (candidate) => (candidate.status.startsWith("R") || candidate.status.startsWith("C")) && candidate.oldPath === sourcePath && candidate.newPath !== null
+        ).map((candidate) => candidate.newPath)
+      )
+    ];
+    if (successorPaths.length !== 1) return null;
+    const successorPath = successorPaths[0];
+    const successorDocument = await this.getDocument({
+      kind: "repository-file",
+      pullRequestId: pullRequest.id,
+      sourceOid: targetSourceOid,
+      path: successorPath
+    });
+    return successorDocument.availability === "missing" ? null : { path: successorPath, document: successorDocument };
+  }
   getWalkthroughByUri(uri) {
     const walkthrough = this.database.getWalkthrough(parseWalkthroughUri(uri));
     if (!walkthrough) {
@@ -47567,6 +47713,7 @@ var editCommentPostSchema = external_exports.object({
 
 // src/server/app.ts
 var oidSchema = external_exports.string().regex(GIT_OBJECT_ID_PATTERN);
+var nonnegativeIndexSchema = external_exports.coerce.number().int().nonnegative();
 var svgAssetContentSecurityPolicy = "default-src 'none'; style-src 'unsafe-inline'; base-uri 'none'; form-action 'none'; sandbox";
 function requiredQuery(value, name) {
   if (!value) throw new RvwError("INVALID_INPUT", `${name} query\u304C\u5FC5\u8981\u3067\u3059\u3002`);
@@ -47575,6 +47722,23 @@ function requiredQuery(value, name) {
 function oidQuery(value, name) {
   return oidSchema.parse(requiredQuery(value, name));
 }
+function structureSourceLocator(query) {
+  if (query.locatorKind === "node") {
+    return { kind: "node", nodeId: requiredQuery(query.nodeId, "nodeId") };
+  }
+  if (query.locatorKind === "edge") {
+    const anchorIndex = nonnegativeIndexSchema.safeParse(query.anchorIndex);
+    if (!anchorIndex.success) {
+      throw new RvwError("INVALID_INPUT", "anchorIndex query\u306F0\u4EE5\u4E0A\u306E\u6574\u6570\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002");
+    }
+    return {
+      kind: "edge",
+      edgeId: requiredQuery(query.edgeId, "edgeId"),
+      anchorIndex: anchorIndex.data
+    };
+  }
+  throw new RvwError("INVALID_INPUT", "locatorKind query\u306Fnode\u307E\u305F\u306Fedge\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002");
+}
 function isWriteMethod(method) {
   return method === "POST" || method === "PUT" || method === "PATCH" || method === "DELETE";
 }
@@ -47866,6 +48030,18 @@ function createApp(service, options) {
       structures: service.listStructures(context.req.param("id"))
     })
   );
+  app.get("/api/pull-requests/:id/structure-references", async (context) => {
+    const sourceOid = oidQuery(context.req.query("sourceOid"), "sourceOid");
+    const filePath = requiredQuery(context.req.query("path"), "path");
+    return context.json({
+      ok: true,
+      references: await service.listFileStructureReferences(
+        context.req.param("id"),
+        sourceOid,
+        filePath
+      )
+    });
+  });
   app.get(
     "/api/pull-requests/:id/structures/:structureId",
     (context) => context.json({
@@ -47873,6 +48049,21 @@ function createApp(service, options) {
       structure: service.getStructure(context.req.param("id"), context.req.param("structureId"))
     })
   );
+  app.get("/api/pull-requests/:id/structures/:structureId/anchors/resolve", async (context) => {
+    return context.json({
+      ok: true,
+      resolution: await service.resolveStructureSource(
+        context.req.param("id"),
+        context.req.param("structureId"),
+        structureSourceLocator({
+          locatorKind: context.req.query("locatorKind"),
+          nodeId: context.req.query("nodeId"),
+          edgeId: context.req.query("edgeId"),
+          anchorIndex: context.req.query("anchorIndex")
+        })
+      )
+    });
+  });
   app.delete("/api/pull-requests/:id/structures/:structureId", async (context) => {
     const input = structureDeleteSchema.parse(await context.req.json());
     return context.json({