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

package/CHANGELOG.md

@@ -5,6 +5,24 @@
 
 ## [Unreleased]
 
+## [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/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.0";
 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,17 @@ 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;
+}
 
 // src/domain/source-excerpt.ts
 var SOURCE_EXCERPT_CONTEXT_LINES = 20;
@@ -42796,7 +42803,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,22 +42834,47 @@ 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) {
+    if (sourceOid === latestHeadOid) {
       latestDocument = sourceDocument;
     } else {
       latestDocument = await this.getDocument({
         kind: "repository-file",
-        pullRequestId,
+        pullRequestId: pullRequest.id,
         sourceOid: latestHeadOid,
         path: reference.path
       });
@@ -42851,7 +42883,7 @@ var RvwService = class {
           ...new Set(
             (await this.git.changedFilesWithCopies(
               pullRequest.localRepositoryPath,
-              walkthrough.sourceOid,
+              sourceOid,
               latestHeadOid
             )).filter(
               (candidate) => (candidate.status.startsWith("R") || candidate.status.startsWith("C")) && candidate.oldPath === reference.path && candidate.newPath !== null
@@ -42861,7 +42893,7 @@ var RvwService = class {
         latestPath = successorPaths.length === 1 ? successorPaths[0] : null;
         latestDocument = latestPath === null ? null : await this.getDocument({
           kind: "repository-file",
-          pullRequestId,
+          pullRequestId: pullRequest.id,
           sourceOid: latestHeadOid,
           path: latestPath
         });
@@ -42879,7 +42911,7 @@ var RvwService = class {
     if (resolvedToLatest && latestPath !== null && latestDocument !== null) {
       return {
         outcome: "latest",
-        anchorSourceOid: walkthrough.sourceOid,
+        anchorSourceOid: sourceOid,
         latestHeadOid,
         referenceFingerprint,
         target: {
@@ -42896,9 +42928,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 +42943,7 @@ var RvwService = class {
     } : null;
     return {
       outcome: "source-fallback",
-      anchorSourceOid: walkthrough.sourceOid,
+      anchorSourceOid: sourceOid,
       latestHeadOid,
       referenceFingerprint,
       target: {
@@ -47567,6 +47599,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 +47608,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";
 }
@@ -47873,6 +47923,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({