@a9n-shoji/rvw 0.3.2 → 0.4.0

package/dist/cli.mjs

@@ -6582,11 +6582,11 @@ var $ZodCIDRv6 = /* @__PURE__ */ $constructor("$ZodCIDRv6", (inst, def) => {
     try {
       if (parts.length !== 2)
         throw new Error();
-      const [address, prefix2] = parts;
-      if (!prefix2)
+      const [address, prefix3] = parts;
+      if (!prefix3)
         throw new Error();
-      const prefixNum = Number(prefix2);
-      if (`${prefixNum}` !== prefix2)
+      const prefixNum = Number(prefix3);
+      if (`${prefixNum}` !== prefix3)
         throw new Error();
       if (prefixNum < 0 || prefixNum > 128)
         throw new Error();
@@ -14994,12 +14994,12 @@ function _includes(includes, params) {
   });
 }
 // @__NO_SIDE_EFFECTS__
-function _startsWith(prefix2, params) {
+function _startsWith(prefix3, params) {
   return new $ZodCheckStartsWith({
     check: "string_format",
     format: "starts_with",
     ...normalizeParams(params),
-    prefix: prefix2
+    prefix: prefix3
   });
 }
 // @__NO_SIDE_EFFECTS__
@@ -18514,6 +18514,19 @@ config(en_default());
 
 // src/infrastructure/db/database.ts
 import { createHash, randomUUID } from "node:crypto";
+
+// src/domain/models.ts
+var STRUCTURE_NODE_NOTATIONS = [
+  "plain",
+  "class",
+  "database",
+  "interface",
+  "component",
+  "external",
+  "concept"
+];
+
+// src/infrastructure/db/database.ts
 import {
   chmodSync,
   closeSync,
@@ -18668,17 +18681,34 @@ function parseCommentUri(uri) {
   return match2[1];
 }
 
+// src/domain/structure-uri.ts
+var prefix = "rvw://structure/";
+var structureIdPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function formatStructureUri(id) {
+  return `${prefix}${id}`;
+}
+function parseStructureUri(uri) {
+  if (!uri.startsWith(prefix)) {
+    throw new RvwError("INVALID_INPUT", "structure URI\u304C\u4E0D\u6B63\u3067\u3059\u3002");
+  }
+  const id = uri.slice(prefix.length);
+  if (!structureIdPattern.test(id)) {
+    throw new RvwError("INVALID_INPUT", "structure URI\u304C\u4E0D\u6B63\u3067\u3059\u3002");
+  }
+  return id;
+}
+
 // src/domain/walkthrough-uri.ts
-var prefix = "rvw://walkthrough/";
+var prefix2 = "rvw://walkthrough/";
 var walkthroughIdPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 function formatWalkthroughUri(id) {
-  return `${prefix}${id}`;
+  return `${prefix2}${id}`;
 }
 function parseWalkthroughUri(uri) {
-  if (!uri.startsWith(prefix)) {
+  if (!uri.startsWith(prefix2)) {
     throw new RvwError("INVALID_INPUT", "walkthrough URI\u304C\u4E0D\u6B63\u3067\u3059\u3002");
   }
-  const id = uri.slice(prefix.length);
+  const id = uri.slice(prefix2.length);
   if (!walkthroughIdPattern.test(id)) {
     throw new RvwError("INVALID_INPUT", "walkthrough URI\u304C\u4E0D\u6B63\u3067\u3059\u3002");
   }
@@ -18746,6 +18776,37 @@ function stringRecordValue(row, key2) {
     throw new RvwError("DATABASE_ERROR", `DB\u5217 ${key2} \u304C\u4E0D\u6B63\u3067\u3059\u3002`, { cause: error51 });
   }
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNullableString(value) {
+  return value === null || typeof value === "string";
+}
+function isSourceAnchor(value) {
+  return isRecord(value) && typeof value.path === "string" && (value.startLine === null || typeof value.startLine === "number") && (value.endLine === null || typeof value.endLine === "number");
+}
+function isStructureNode(value) {
+  return isRecord(value) && typeof value.id === "string" && typeof value.label === "string" && isNullableString(value.description) && isNullableString(value.kind) && (value.notation === void 0 || STRUCTURE_NODE_NOTATIONS.some((notation) => notation === value.notation)) && (value.anchor === null || isSourceAnchor(value.anchor));
+}
+function isStructureEdge(value) {
+  return isRecord(value) && typeof value.id === "string" && typeof value.from === "string" && typeof value.to === "string" && typeof value.label === "string" && typeof value.directed === "boolean" && Array.isArray(value.anchors) && value.anchors.every(isSourceAnchor);
+}
+function structureGraphValue(row) {
+  try {
+    const value = JSON.parse(stringValue(row, "graph_json"));
+    const originNodeId = isRecord(value) && typeof value.originNodeId === "string" ? value.originNodeId : null;
+    if (!isRecord(value) || originNodeId === null || !Array.isArray(value.nodes) || !value.nodes.every(isStructureNode) || !Array.isArray(value.edges) || !value.edges.every(isStructureEdge)) {
+      throw new Error("invalid Structure graph");
+    }
+    return {
+      originNodeId,
+      nodes: value.nodes.map((node2) => ({ ...node2, notation: node2.notation ?? "plain" })),
+      edges: value.edges
+    };
+  } catch (error51) {
+    throw new RvwError("DATABASE_ERROR", "Structure graph_json\u304C\u4E0D\u6B63\u3067\u3059\u3002", { cause: error51 });
+  }
+}
 function mapPullRequest(row) {
   return {
     id: stringValue(row, "id"),
@@ -19130,6 +19191,11 @@ var RvwDatabase = class {
            FROM walkthroughs
            JOIN page ON page.id = walkthroughs.pull_request_id
            GROUP BY walkthroughs.pull_request_id
+         ), structure_counts AS (
+           SELECT structures.pull_request_id, COUNT(*) AS structure_count
+           FROM structures
+           JOIN page ON page.id = structures.pull_request_id
+           GROUP BY structures.pull_request_id
          )
          SELECT
            pr.id AS pull_request_id,
@@ -19143,10 +19209,12 @@ var RvwDatabase = class {
            pr.github_is_draft,
            COALESCE(comment_counts.unresolved_count, 0) AS unresolved_comment_count,
            COALESCE(comment_counts.resolved_count, 0) AS resolved_comment_count,
-           COALESCE(walkthrough_counts.walkthrough_count, 0) AS walkthrough_count
+           COALESCE(walkthrough_counts.walkthrough_count, 0) AS walkthrough_count,
+           COALESCE(structure_counts.structure_count, 0) AS structure_count
          FROM page AS pr
          LEFT JOIN comment_counts ON comment_counts.pull_request_id = pr.id
          LEFT JOIN walkthrough_counts ON walkthrough_counts.pull_request_id = pr.id
+         LEFT JOIN structure_counts ON structure_counts.pull_request_id = pr.id
          ORDER BY pr.github_updated_at DESC, pr.id DESC`
     ).all(hideClosedOrMergedValue, limit, offset);
     const totalRow = this.database.prepare(
@@ -19166,7 +19234,8 @@ var RvwDatabase = class {
         githubIsDraft: nullableBoolean(row, "github_is_draft"),
         unresolvedCommentCount: numberValue(row, "unresolved_comment_count"),
         resolvedCommentCount: numberValue(row, "resolved_comment_count"),
-        walkthroughCount: numberValue(row, "walkthrough_count")
+        walkthroughCount: numberValue(row, "walkthrough_count"),
+        structureCount: numberValue(row, "structure_count")
       })),
       total: numberValue(totalRow, "total")
     };
@@ -19322,6 +19391,7 @@ var RvwDatabase = class {
     const walkthroughReferences = this.database.prepare(
       "SELECT count(*) AS count FROM walkthrough_references WHERE walkthrough_id IN (SELECT id FROM walkthroughs WHERE pull_request_id = ?)"
     ).get(pullRequestId);
+    const structures = this.database.prepare("SELECT count(*) AS count FROM structures WHERE pull_request_id = ?").get(pullRequestId);
     return {
       comments: numberValue(comments, "count"),
       posts: numberValue(posts, "count"),
@@ -19329,12 +19399,234 @@ var RvwDatabase = class {
       targets: numberValue(targets, "count"),
       walkthroughs: numberValue(walkthroughs, "count"),
       walkthroughReferences: numberValue(walkthroughReferences, "count"),
+      structures: numberValue(structures, "count"),
       gitRefs
     };
   }
   deletePullRequestHistory(pullRequestId) {
     this.database.prepare("DELETE FROM comments WHERE pull_request_id = ?").run(pullRequestId);
     this.database.prepare("DELETE FROM walkthroughs WHERE pull_request_id = ?").run(pullRequestId);
+    this.database.prepare(
+      `DELETE FROM structure_publish_idempotency
+         WHERE structure_id IN (SELECT id FROM structures WHERE pull_request_id = ?)`
+    ).run(pullRequestId);
+    this.database.prepare("DELETE FROM structures WHERE pull_request_id = ?").run(pullRequestId);
+  }
+  mapStructure(row) {
+    const id = stringValue(row, "id");
+    return {
+      id,
+      ref: formatStructureUri(id),
+      pullRequestId: stringValue(row, "pull_request_id"),
+      sourceOid: stringValue(row, "source_oid"),
+      title: stringValue(row, "title"),
+      scope: stringValue(row, "scope"),
+      ...structureGraphValue(row),
+      createdAt: stringValue(row, "created_at"),
+      updatedAt: stringValue(row, "updated_at")
+    };
+  }
+  getStructure(id) {
+    const row = this.database.prepare("SELECT * FROM structures WHERE id = ?").get(id);
+    return row ? this.mapStructure(row) : null;
+  }
+  listStructures(pullRequestId) {
+    return this.database.prepare(
+      `SELECT id, pull_request_id, source_oid, title, scope, created_at, updated_at
+           FROM structures
+           WHERE pull_request_id = ?
+           ORDER BY created_at DESC, id DESC`
+    ).all(pullRequestId).map((row) => ({
+      id: stringValue(row, "id"),
+      ref: formatStructureUri(stringValue(row, "id")),
+      pullRequestId: stringValue(row, "pull_request_id"),
+      sourceOid: stringValue(row, "source_oid"),
+      title: stringValue(row, "title"),
+      scope: stringValue(row, "scope"),
+      createdAt: stringValue(row, "created_at"),
+      updatedAt: stringValue(row, "updated_at")
+    }));
+  }
+  createStructure(input) {
+    let structureId;
+    const graphJson = JSON.stringify({
+      originNodeId: input.originNodeId,
+      nodes: input.nodes,
+      edges: input.edges
+    });
+    this.immediateTransaction(() => {
+      const keyHash = hashIdempotencyKey(input.idempotencyKey);
+      const existingRow = this.database.prepare("SELECT * FROM structure_publish_idempotency WHERE key_hash = ?").get(keyHash);
+      if (existingRow) {
+        if (stringValue(existingRow, "request_hash") !== input.idempotencyRequestHash) {
+          throw new RvwError(
+            "IDEMPOTENCY_CONFLICT",
+            "\u540C\u3058idempotencyKey\u304C\u5225\u306EStructure publish\u306B\u4F7F\u7528\u3055\u308C\u3066\u3044\u307E\u3059\u3002"
+          );
+        }
+        const existingId = stringValue(existingRow, "structure_id");
+        if (!this.getStructure(existingId)) {
+          throw new RvwError(
+            "IDEMPOTENCY_RESULT_DELETED",
+            "\u3053\u306EidempotencyKey\u3067\u4F5C\u6210\u3057\u305FStructure\u306F\u65E2\u306B\u524A\u9664\u3055\u308C\u3066\u3044\u307E\u3059\u3002",
+            { details: { structureId: existingId } }
+          );
+        }
+        structureId = existingId;
+        return;
+      }
+      const id = randomUUID();
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      this.database.prepare(
+        `INSERT INTO structures(
+             id, pull_request_id, source_oid, title, scope, graph_json, created_at, updated_at
+           ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`
+      ).run(
+        id,
+        input.pullRequestId,
+        input.sourceOid,
+        input.title,
+        input.scope,
+        graphJson,
+        now,
+        now
+      );
+      this.database.prepare(
+        `INSERT INTO structure_publish_idempotency(
+             key_hash, request_hash, structure_id, created_at
+           ) VALUES (?, ?, ?, ?)`
+      ).run(keyHash, input.idempotencyRequestHash, id, now);
+      this.incrementChangeSequence();
+      structureId = id;
+    });
+    if (!structureId) {
+      throw new RvwError("DATABASE_ERROR", "\u4FDD\u5B58\u3057\u305FStructure ID\u3092\u78BA\u5B9A\u3067\u304D\u307E\u305B\u3093\u3002");
+    }
+    const structure = this.getStructure(structureId);
+    if (!structure) throw new RvwError("DATABASE_ERROR", "\u4FDD\u5B58\u3057\u305FStructure\u3092\u8AAD\u307F\u51FA\u305B\u307E\u305B\u3093\u3002");
+    return structure;
+  }
+  updateStructure(id, expectedUpdatedAt2, input) {
+    const currentUpdatedAt = Date.parse(expectedUpdatedAt2);
+    const observedNow = Date.now();
+    const now = new Date(
+      Number.isNaN(currentUpdatedAt) ? observedNow : Math.max(observedNow, currentUpdatedAt + 1)
+    ).toISOString();
+    const graphJson = JSON.stringify({
+      originNodeId: input.originNodeId,
+      nodes: input.nodes,
+      edges: input.edges
+    });
+    this.immediateTransaction(() => {
+      const current = this.getStructure(id);
+      if (!current) {
+        throw new RvwError("NOT_FOUND", "Structure\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002", { status: 404 });
+      }
+      if (current.updatedAt !== expectedUpdatedAt2) {
+        throw new RvwError(
+          "STRUCTURE_CONFLICT",
+          "Structure\u304C\u53D6\u5F97\u5F8C\u306B\u66F4\u65B0\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u73FE\u5728\u5024\u3092\u8AAD\u307F\u76F4\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+          {
+            status: 409,
+            details: { expectedUpdatedAt: expectedUpdatedAt2, currentUpdatedAt: current.updatedAt }
+          }
+        );
+      }
+      const retiredNodeIds = new Set(
+        this.database.prepare("SELECT node_id FROM structure_retired_node_ids WHERE structure_id = ?").all(id).map((row) => stringValue(row, "node_id"))
+      );
+      const retiredEdgeIds = new Set(
+        this.database.prepare("SELECT edge_id FROM structure_retired_edge_ids WHERE structure_id = ?").all(id).map((row) => stringValue(row, "edge_id"))
+      );
+      const reusedNode = input.nodes.find((node2) => retiredNodeIds.has(node2.id));
+      if (reusedNode) {
+        throw new RvwError(
+          "INVALID_INPUT",
+          `\u524A\u9664\u6E08\u307F\u306EStructure Node ID\u306F\u518D\u5229\u7528\u3067\u304D\u307E\u305B\u3093: ${reusedNode.id}`
+        );
+      }
+      const reusedEdge = input.edges.find((edge) => retiredEdgeIds.has(edge.id));
+      if (reusedEdge) {
+        throw new RvwError(
+          "INVALID_INPUT",
+          `\u524A\u9664\u6E08\u307F\u306EStructure Edge ID\u306F\u518D\u5229\u7528\u3067\u304D\u307E\u305B\u3093: ${reusedEdge.id}`
+        );
+      }
+      const nextNodeIds = new Set(input.nodes.map((node2) => node2.id));
+      const nextEdgeIds = new Set(input.edges.map((edge) => edge.id));
+      const retiredAtThisUpdate = current.nodes.map((node2) => node2.id).filter((nodeId) => !nextNodeIds.has(nodeId));
+      const retiredEdgesAtThisUpdate = current.edges.map((edge) => edge.id).filter((edgeId) => !nextEdgeIds.has(edgeId));
+      const result = this.database.prepare(
+        `UPDATE structures
+           SET source_oid = ?, title = ?, scope = ?, graph_json = ?, updated_at = ?
+           WHERE id = ? AND updated_at = ?`
+      ).run(input.sourceOid, input.title, input.scope, graphJson, now, id, expectedUpdatedAt2);
+      if (Number(result.changes) === 0) {
+        throw new RvwError(
+          "STRUCTURE_CONFLICT",
+          "Structure\u304C\u53D6\u5F97\u5F8C\u306B\u66F4\u65B0\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u73FE\u5728\u5024\u3092\u8AAD\u307F\u76F4\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+          {
+            status: 409,
+            details: { expectedUpdatedAt: expectedUpdatedAt2, currentUpdatedAt: current.updatedAt }
+          }
+        );
+      }
+      const retireNode = this.database.prepare(
+        "INSERT OR IGNORE INTO structure_retired_node_ids(structure_id, node_id, retired_at) VALUES (?, ?, ?)"
+      );
+      for (const nodeId of retiredAtThisUpdate) retireNode.run(id, nodeId, now);
+      const retireEdge = this.database.prepare(
+        "INSERT OR IGNORE INTO structure_retired_edge_ids(structure_id, edge_id, retired_at) VALUES (?, ?, ?)"
+      );
+      for (const edgeId of retiredEdgesAtThisUpdate) retireEdge.run(id, edgeId, now);
+      this.incrementChangeSequence();
+    });
+    const structure = this.getStructure(id);
+    if (!structure) throw new RvwError("DATABASE_ERROR", "\u66F4\u65B0\u3057\u305FStructure\u3092\u8AAD\u307F\u51FA\u305B\u307E\u305B\u3093\u3002");
+    return structure;
+  }
+  getStructureDeleteCounts(id) {
+    const structure = this.getStructure(id);
+    if (!structure) throw new RvwError("NOT_FOUND", "Structure\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002", { status: 404 });
+    return {
+      nodes: structure.nodes.length,
+      edges: structure.edges.length,
+      anchors: structure.nodes.filter((node2) => node2.anchor !== null).length + structure.edges.reduce((count, edge) => count + edge.anchors.length, 0)
+    };
+  }
+  deleteStructure(id, expectedUpdatedAt2) {
+    return this.immediateTransaction(() => {
+      const structure = this.getStructure(id);
+      if (!structure) {
+        throw new RvwError("NOT_FOUND", "Structure\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002", { status: 404 });
+      }
+      if (structure.updatedAt !== expectedUpdatedAt2) {
+        throw new RvwError(
+          "STRUCTURE_CONFLICT",
+          "Structure\u304Cpreview\u5F8C\u306B\u66F4\u65B0\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u73FE\u5728\u5024\u3092\u8AAD\u307F\u76F4\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+          {
+            status: 409,
+            details: { expectedUpdatedAt: expectedUpdatedAt2, currentUpdatedAt: structure.updatedAt }
+          }
+        );
+      }
+      const counts = this.getStructureDeleteCounts(id);
+      const result = this.database.prepare("DELETE FROM structures WHERE id = ? AND updated_at = ?").run(id, expectedUpdatedAt2);
+      if (Number(result.changes) === 0) {
+        throw new RvwError(
+          "STRUCTURE_CONFLICT",
+          "Structure\u304Cpreview\u5F8C\u306B\u66F4\u65B0\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u73FE\u5728\u5024\u3092\u8AAD\u307F\u76F4\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+          { status: 409, details: { expectedUpdatedAt: expectedUpdatedAt2 } }
+        );
+      }
+      this.incrementChangeSequence();
+      return {
+        id: structure.id,
+        ref: structure.ref,
+        pullRequestId: structure.pullRequestId,
+        counts
+      };
+    });
   }
   codeReferenceStorage(kind) {
     return kind === "comment-post" ? { table: "comment_post_references", ownerColumn: "post_id" } : { table: "walkthrough_references", ownerColumn: "walkthrough_id" };
@@ -19895,7 +20187,7 @@ import path5 from "node:path";
 import { TextDecoder as TextDecoder2 } from "node:util";
 
 // src/shared/constants.ts
-var APP_VERSION = "0.3.2";
+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";
@@ -19924,6 +20216,18 @@ var MAX_CODE_REFERENCE_PATH_CHARACTERS = 4096;
 var MAX_CODE_REFERENCE_DESCRIPTION_CHARACTERS = 1e3;
 var MAX_WALKTHROUGH_BODY_BYTES = 256 * 1024;
 var MAX_WALKTHROUGH_TITLE_CHARACTERS = 200;
+var MAX_STRUCTURE_PAYLOAD_BYTES = 2 * 1024 * 1024;
+var MAX_STRUCTURE_TITLE_CHARACTERS = 200;
+var MAX_STRUCTURE_SCOPE_CHARACTERS = 4e3;
+var MAX_STRUCTURE_NODES = 50;
+var MAX_STRUCTURE_EDGES = 200;
+var MAX_STRUCTURE_EDGE_ANCHORS = 20;
+var MAX_STRUCTURE_SOURCE_ANCHORS = 400;
+var MAX_STRUCTURE_ID_CHARACTERS = 64;
+var STRUCTURE_ID_PATTERN = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+var MAX_STRUCTURE_LABEL_CHARACTERS = 200;
+var MAX_STRUCTURE_DESCRIPTION_CHARACTERS = 2e3;
+var MAX_STRUCTURE_KIND_CHARACTERS = 100;
 var MAX_SEARCH_QUERY_BYTES = 1024;
 var MAX_SEARCH_RESULTS = 500;
 var MAX_SEARCH_STDOUT_BYTES = 8 * 1024 * 1024;
@@ -20232,10 +20536,10 @@ var GitClient = class {
   }
   async ensurePullRequestObjects(input) {
     const operationId = randomUUID2();
-    const prefix2 = `refs/rvw/tmp/${operationId}`;
+    const prefix3 = `refs/rvw/tmp/${operationId}`;
     try {
       if (!await this.hasObject(input.cwd, input.headOid)) {
-        const temporaryRef = `${prefix2}/head`;
+        const temporaryRef = `${prefix3}/head`;
         await runProcess(
           "git",
           [
@@ -20260,7 +20564,7 @@ var GitClient = class {
         }
       }
       if (!await this.hasObject(input.cwd, input.baseOid)) {
-        const temporaryRef = `${prefix2}/base-tip`;
+        const temporaryRef = `${prefix3}/base-tip`;
         await runProcess(
           "git",
           [
@@ -20285,7 +20589,7 @@ var GitClient = class {
         }
       }
     } finally {
-      await this.deleteRefsByPrefix(input.cwd, `${prefix2}/`).catch(() => void 0);
+      await this.deleteRefsByPrefix(input.cwd, `${prefix3}/`).catch(() => void 0);
     }
   }
   async mergeBase(cwd, baseOid, headOid) {
@@ -20350,14 +20654,14 @@ var GitClient = class {
       return false;
     }
   }
-  async listRefsByPrefix(cwd, prefix2) {
-    const output = await runProcess("git", ["for-each-ref", "--format=%(refname)%00", prefix2], {
+  async listRefsByPrefix(cwd, prefix3) {
+    const output = await runProcess("git", ["for-each-ref", "--format=%(refname)%00", prefix3], {
       cwd
     });
     return output.stdout.toString("utf8").split("\0").map((value) => value.trim()).filter(Boolean);
   }
-  async deleteRefsByPrefix(cwd, prefix2) {
-    const refs = await this.listRefsByPrefix(cwd, prefix2);
+  async deleteRefsByPrefix(cwd, prefix3) {
+    const refs = await this.listRefsByPrefix(cwd, prefix3);
     if (refs.length === 0) return 0;
     const input = ["start", ...refs.map((ref) => `delete ${ref}`), "prepare", "commit", ""].join(
       "\n"
@@ -20366,8 +20670,8 @@ var GitClient = class {
     return refs.length;
   }
   async replacePullRequestRefsForReset(cwd, number5, headOid) {
-    const prefix2 = `refs/rvw/pr/${number5}/`;
-    const existing = await this.listRefsByPrefix(cwd, prefix2);
+    const prefix3 = `refs/rvw/pr/${number5}/`;
+    const existing = await this.listRefsByPrefix(cwd, prefix3);
     const ref = this.commitRef(number5, headOid);
     const commands = ["start"];
     for (const ref2 of existing) {
@@ -23204,14 +23508,14 @@ function factorySpace(effects, ok2, type, max) {
   function start(code) {
     if (markdownSpace(code)) {
       effects.enter(type);
-      return prefix2(code);
+      return prefix3(code);
     }
     return ok2(code);
   }
-  function prefix2(code) {
+  function prefix3(code) {
     if (markdownSpace(code) && size++ < limit) {
       effects.consume(code);
-      return prefix2;
+      return prefix3;
     }
     effects.exit(type);
     return ok2(code);
@@ -28162,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;
@@ -34510,7 +34821,7 @@ var LIMITED_QUIRKS_WITH_SYSTEM_ID_PUBLIC_ID_PREFIXES = [
   "-//w3c//dtd html 4.01 transitional//"
 ];
 function hasPrefix(publicId, prefixes) {
-  return prefixes.some((prefix2) => publicId.startsWith(prefix2));
+  return prefixes.some((prefix3) => publicId.startsWith(prefix3));
 }
 function isConforming(token) {
   return token.name === VALID_DOCTYPE_NAME && token.publicId === null && (token.systemId === null || token.systemId === VALID_SYSTEM_ID);
@@ -42194,6 +42505,296 @@ var RvwService = class {
     this.getPullRequest(pullRequestId);
     return this.database.listWalkthroughs(pullRequestId);
   }
+  listStructures(pullRequestId) {
+    this.getPullRequest(pullRequestId);
+    return this.database.listStructures(pullRequestId);
+  }
+  listStructuresByReference(reference) {
+    const pullRequest = this.resolveStoredPullRequest(reference);
+    return { pullRequest, structures: this.database.listStructures(pullRequest.id) };
+  }
+  getStructure(pullRequestId, structureId) {
+    this.getPullRequest(pullRequestId);
+    const structure = this.database.getStructure(structureId);
+    if (!structure || structure.pullRequestId !== pullRequestId) {
+      throw new RvwError("NOT_FOUND", "Structure\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002", { status: 404 });
+    }
+    return structure;
+  }
+  getStructureByUri(uri) {
+    const structure = this.database.getStructure(parseStructureUri(uri));
+    if (!structure) {
+      throw new RvwError("NOT_FOUND", "Structure\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002", { status: 404 });
+    }
+    return {
+      pullRequest: this.getPullRequest(structure.pullRequestId),
+      structure
+    };
+  }
+  async validateSourceAnchor(pullRequest, sourceOid, anchor, subject, documents) {
+    assertCodeReferencePath(anchor.path);
+    const startLine = anchor.startLine ?? null;
+    const endLine = anchor.endLine ?? null;
+    assertLinePair(startLine, endLine);
+    let contentPromise = documents.get(anchor.path);
+    if (!contentPromise) {
+      contentPromise = this.getDocument({
+        kind: "repository-file",
+        pullRequestId: pullRequest.id,
+        sourceOid,
+        path: anchor.path
+      });
+      documents.set(anchor.path, contentPromise);
+    }
+    const content3 = await contentPromise;
+    if (content3.availability !== "available") {
+      throw new RvwError("INVALID_INPUT", `${subject}\u306Esource\u3092\u8868\u793A\u3067\u304D\u307E\u305B\u3093: ${anchor.path}`);
+    }
+    this.validateLineRange(content3.text ?? "", startLine, endLine, subject);
+    return { path: anchor.path, startLine, endLine };
+  }
+  assertStructureText(value, maximum, subject) {
+    const normalized = value.trim();
+    if (normalized.length === 0 || value.length > maximum) {
+      throw new RvwError("INVALID_INPUT", `${subject}\u306F1\u301C${maximum}\u6587\u5B57\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);
+    }
+    return normalized;
+  }
+  assertStructureId(value, subject) {
+    if (!STRUCTURE_ID_PATTERN.test(value)) {
+      throw new RvwError(
+        "INVALID_INPUT",
+        `${subject}\u306F\u82F1\u5B57\u3067\u59CB\u307E\u308B\u82F1\u6570\u5B57\u30FB_\u30FB-\u306E1\u301C${MAX_STRUCTURE_ID_CHARACTERS}\u6587\u5B57\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+      );
+    }
+    return value;
+  }
+  normalizeOptionalStructureText(value, maximum, subject) {
+    if (value === null || value === void 0) return null;
+    if (value.length > maximum) {
+      throw new RvwError("INVALID_INPUT", `${subject}\u304C\u9577\u3059\u304E\u307E\u3059\u3002`);
+    }
+    return value.trim() || null;
+  }
+  async validateStructureContent(pullRequest, input) {
+    await this.assertCommitAvailable(pullRequest, input.sourceOid);
+    const title = this.assertStructureText(
+      input.title,
+      MAX_STRUCTURE_TITLE_CHARACTERS,
+      "Structure title"
+    );
+    const scope = this.assertStructureText(
+      input.scope,
+      MAX_STRUCTURE_SCOPE_CHARACTERS,
+      "Structure scope"
+    );
+    if (input.nodes.length < 1 || input.nodes.length > MAX_STRUCTURE_NODES) {
+      throw new RvwError(
+        "INVALID_INPUT",
+        `Structure Node\u306F1\u301C${MAX_STRUCTURE_NODES}\u4EF6\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+      );
+    }
+    if (input.edges.length > MAX_STRUCTURE_EDGES) {
+      throw new RvwError(
+        "INVALID_INPUT",
+        `Structure Edge\u306F${MAX_STRUCTURE_EDGES}\u4EF6\u4EE5\u4E0B\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+      );
+    }
+    const documents = /* @__PURE__ */ new Map();
+    const nodeIds = /* @__PURE__ */ new Set();
+    const nodes = [];
+    for (const node2 of input.nodes) {
+      const id = this.assertStructureId(node2.id, "Structure Node ID");
+      if (nodeIds.has(id)) {
+        throw new RvwError("INVALID_INPUT", `Structure Node ID\u304C\u91CD\u8907\u3057\u3066\u3044\u307E\u3059: ${id}`);
+      }
+      nodeIds.add(id);
+      const label = this.assertStructureText(
+        node2.label,
+        MAX_STRUCTURE_LABEL_CHARACTERS,
+        `Structure Node ${id} label`
+      );
+      const notation = node2.notation ?? "plain";
+      if (!STRUCTURE_NODE_NOTATIONS.includes(notation)) {
+        throw new RvwError("INVALID_INPUT", `Structure Node ${id} notation\u304C\u4E0D\u6B63\u3067\u3059\u3002`);
+      }
+      nodes.push({
+        id,
+        label,
+        description: this.normalizeOptionalStructureText(
+          node2.description,
+          MAX_STRUCTURE_DESCRIPTION_CHARACTERS,
+          `Structure Node ${id} description`
+        ),
+        kind: this.normalizeOptionalStructureText(
+          node2.kind,
+          MAX_STRUCTURE_KIND_CHARACTERS,
+          `Structure Node ${id} kind`
+        ),
+        notation,
+        anchor: node2.anchor ? await this.validateSourceAnchor(
+          pullRequest,
+          input.sourceOid,
+          node2.anchor,
+          `Structure Node ${id}`,
+          documents
+        ) : null
+      });
+    }
+    const edgeIds = /* @__PURE__ */ new Set();
+    const edges = [];
+    for (const edge of input.edges) {
+      const id = this.assertStructureId(edge.id, "Structure Edge ID");
+      if (edgeIds.has(id)) {
+        throw new RvwError("INVALID_INPUT", `Structure Edge ID\u304C\u91CD\u8907\u3057\u3066\u3044\u307E\u3059: ${id}`);
+      }
+      edgeIds.add(id);
+      if (!nodeIds.has(edge.from) || !nodeIds.has(edge.to)) {
+        throw new RvwError(
+          "INVALID_INPUT",
+          `Structure Edge ${id} \u306Eendpoint\u304C\u5B58\u5728\u3057\u307E\u305B\u3093: ${edge.from} \u2192 ${edge.to}`
+        );
+      }
+      if (typeof edge.directed !== "boolean") {
+        throw new RvwError("INVALID_INPUT", `Structure Edge ${id} \u306Edirected\u304C\u5FC5\u8981\u3067\u3059\u3002`);
+      }
+      const anchors = edge.anchors ?? [];
+      if (anchors.length > MAX_STRUCTURE_EDGE_ANCHORS) {
+        throw new RvwError(
+          "INVALID_INPUT",
+          `Structure Edge ${id} \u306Eanchor\u306F${MAX_STRUCTURE_EDGE_ANCHORS}\u4EF6\u4EE5\u4E0B\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+        );
+      }
+      edges.push({
+        id,
+        from: edge.from,
+        to: edge.to,
+        label: this.assertStructureText(
+          edge.label,
+          MAX_STRUCTURE_LABEL_CHARACTERS,
+          `Structure Edge ${id} label`
+        ),
+        directed: edge.directed,
+        anchors: await Promise.all(
+          anchors.map(
+            (anchor, index2) => this.validateSourceAnchor(
+              pullRequest,
+              input.sourceOid,
+              anchor,
+              `Structure Edge ${id} anchor ${index2 + 1}`,
+              documents
+            )
+          )
+        )
+      });
+    }
+    if (typeof input.originNodeId !== "string") {
+      throw new RvwError("INVALID_INPUT", "originNodeId\u304C\u5FC5\u8981\u3067\u3059\u3002");
+    }
+    const originNodeId = this.assertStructureId(input.originNodeId, "Structure originNodeId");
+    if (!nodeIds.has(originNodeId)) {
+      throw new RvwError("INVALID_INPUT", `originNodeId Node\u304C\u5B58\u5728\u3057\u307E\u305B\u3093: ${originNodeId}`);
+    }
+    const originNode = nodes.find((node2) => node2.id === originNodeId);
+    if (originNode.anchor === null) {
+      throw new RvwError("INVALID_INPUT", "Structure origin Node\u306B\u306Fsource anchor\u304C\u5FC5\u8981\u3067\u3059\u3002");
+    }
+    const neighbors = new Map(nodes.map((node2) => [node2.id, /* @__PURE__ */ new Set()]));
+    for (const edge of edges) {
+      neighbors.get(edge.from).add(edge.to);
+      neighbors.get(edge.to).add(edge.from);
+    }
+    const reached = /* @__PURE__ */ new Set([originNodeId]);
+    const queue = [originNodeId];
+    while (queue.length > 0) {
+      const current = queue.shift();
+      for (const neighbor of neighbors.get(current) ?? []) {
+        if (reached.has(neighbor)) continue;
+        reached.add(neighbor);
+        queue.push(neighbor);
+      }
+    }
+    const disconnected = nodes.filter((node2) => !reached.has(node2.id)).map((node2) => node2.id);
+    if (disconnected.length > 0) {
+      throw new RvwError(
+        "INVALID_INPUT",
+        `Structure\u306E\u5168Node\u3092origin\u304B\u3089\u8FBF\u308C\u308B\u95A2\u4FC2graph\u306B\u3057\u3066\u304F\u3060\u3055\u3044: ${disconnected.join(", ")}`
+      );
+    }
+    const anchorCount = nodes.filter((node2) => node2.anchor !== null).length + edges.reduce((count, edge) => count + edge.anchors.length, 0);
+    if (anchorCount < 1) {
+      throw new RvwError(
+        "INVALID_INPUT",
+        "Structure\u306B\u306Fsource anchor\u3092\u5C11\u306A\u304F\u3068\u30821\u4EF6\u542B\u3081\u3066\u304F\u3060\u3055\u3044\u3002"
+      );
+    }
+    if (anchorCount > MAX_STRUCTURE_SOURCE_ANCHORS) {
+      throw new RvwError(
+        "INVALID_INPUT",
+        `Structure\u306Esource anchor\u306F\u5408\u8A08${MAX_STRUCTURE_SOURCE_ANCHORS}\u4EF6\u4EE5\u4E0B\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+      );
+    }
+    const graph = { originNodeId, nodes, edges };
+    if (Buffer.byteLength(JSON.stringify(graph), "utf8") > MAX_STRUCTURE_PAYLOAD_BYTES) {
+      throw new RvwError(
+        "INVALID_INPUT",
+        `Structure payload\u306F${MAX_STRUCTURE_PAYLOAD_BYTES} UTF-8 bytes\u4EE5\u4E0B\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+      );
+    }
+    return { sourceOid: input.sourceOid, title, scope, ...graph };
+  }
+  async publishStructure(input) {
+    if (typeof input.idempotencyKey !== "string") {
+      throw new RvwError("INVALID_INPUT", "idempotencyKey\u304C\u5FC5\u8981\u3067\u3059\u3002");
+    }
+    assertIdempotencyKey(input.idempotencyKey);
+    const pullRequest = this.resolveStoredPullRequest(input.pullRequest);
+    const content3 = await this.validateStructureContent(pullRequest, input);
+    return await this.writeWithRetainedCommit(
+      pullRequest,
+      content3.sourceOid,
+      "Structure",
+      () => this.database.createStructure({
+        pullRequestId: pullRequest.id,
+        ...content3,
+        idempotencyKey: input.idempotencyKey,
+        idempotencyRequestHash: idempotencyRequestHash({
+          operation: "structure.publish",
+          pullRequestId: pullRequest.id,
+          content: content3
+        })
+      })
+    );
+  }
+  async updateStructure(uri, input) {
+    const { pullRequest, structure } = this.getStructureByUri(uri);
+    if (typeof input.expectedUpdatedAt !== "string" || input.expectedUpdatedAt.length === 0) {
+      throw new RvwError("INVALID_INPUT", "expectedUpdatedAt\u304C\u5FC5\u8981\u3067\u3059\u3002");
+    }
+    const content3 = await this.validateStructureContent(pullRequest, input);
+    return await this.writeWithRetainedCommit(
+      pullRequest,
+      content3.sourceOid,
+      "Structure",
+      () => this.database.updateStructure(structure.id, input.expectedUpdatedAt, content3)
+    );
+  }
+  getStructureDeletePreview(uri) {
+    const { structure } = this.getStructureByUri(uri);
+    return {
+      structure,
+      counts: this.database.getStructureDeleteCounts(structure.id),
+      confirmationRequired: true
+    };
+  }
+  deleteStructureByUri(uri, expectedUpdatedAt2) {
+    const { structure } = this.getStructureByUri(uri);
+    return this.database.deleteStructure(structure.id, expectedUpdatedAt2);
+  }
+  deleteStructure(pullRequestId, structureId, expectedUpdatedAt2) {
+    this.getStructure(pullRequestId, structureId);
+    return this.database.deleteStructure(structureId, expectedUpdatedAt2);
+  }
   getWalkthrough(pullRequestId, walkthroughId) {
     this.getPullRequest(pullRequestId);
     const walkthrough = this.database.getWalkthrough(walkthroughId);
@@ -42202,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 {
@@ -42233,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
       });
@@ -42257,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
@@ -42267,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
         });
@@ -42285,7 +42911,7 @@ var RvwService = class {
     if (resolvedToLatest && latestPath !== null && latestDocument !== null) {
       return {
         outcome: "latest",
-        anchorSourceOid: walkthrough.sourceOid,
+        anchorSourceOid: sourceOid,
         latestHeadOid,
         referenceFingerprint,
         target: {
@@ -42302,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 ? {
@@ -42317,7 +42943,7 @@ var RvwService = class {
     } : null;
     return {
       outcome: "source-fallback",
-      anchorSourceOid: walkthrough.sourceOid,
+      anchorSourceOid: sourceOid,
       latestHeadOid,
       referenceFingerprint,
       target: {
@@ -42768,6 +43394,7 @@ import { fileURLToPath as fileURLToPath4 } from "node:url";
 var skillNames = [
   "rvw",
   "rvw-walkthrough",
+  "rvw-structure",
   "rvw-watch-comments"
 ];
 var INSTALL_METADATA_FILE = ".rvw-install.json";
@@ -46585,8 +47212,11 @@ var Hono2 = class extends Hono {
 var nonEmptyString = external_exports.string().min(1);
 var commentUri = external_exports.string().regex(/^rvw:\/\/comment\//);
 var walkthroughUri = external_exports.string().regex(/^rvw:\/\/walkthrough\//);
+var structureUri = external_exports.string().regex(/^rvw:\/\/structure\//);
 var nullableCommentLine = external_exports.number().int().positive().nullable().optional().default(null);
 var idempotencyKey = external_exports.string().min(1).max(MAX_IDEMPOTENCY_KEY_CHARACTERS).optional();
+var requiredIdempotencyKey = external_exports.string().min(1).max(MAX_IDEMPOTENCY_KEY_CHARACTERS);
+var expectedUpdatedAt = external_exports.string().min(1).max(100);
 var commentTargetInputSchema = external_exports.union([
   external_exports.object({ kind: external_exports.literal("pull-request") }).strict(),
   external_exports.object({
@@ -46709,6 +47339,151 @@ var walkthroughPublishInputSchema = walkthroughContentInputSchema.extend({
   pullRequest: nonEmptyString
 });
 var walkthroughUpdateInputSchema = walkthroughContentInputSchema;
+var sourceAnchorInputSchema = external_exports.object({
+  path: external_exports.string().min(1).max(MAX_CODE_REFERENCE_PATH_CHARACTERS),
+  startLine: external_exports.number().int().positive().nullable().optional().default(null),
+  endLine: external_exports.number().int().positive().nullable().optional().default(null)
+}).strict().superRefine((anchor, context) => {
+  if (anchor.startLine === null !== (anchor.endLine === null)) {
+    context.addIssue({
+      code: "custom",
+      message: "startLine\u3068endLine\u306F\u4E21\u65B9\u6307\u5B9A\u3059\u308B\u304B\u3001\u4E21\u65B9\u7701\u7565\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+    });
+    return;
+  }
+  if (anchor.startLine !== null && anchor.endLine !== null && anchor.endLine < anchor.startLine) {
+    context.addIssue({ code: "custom", message: "endLine\u306FstartLine\u4EE5\u4E0A\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002" });
+  }
+});
+var structureNodeInputSchema = external_exports.object({
+  id: external_exports.string().max(MAX_STRUCTURE_ID_CHARACTERS).regex(STRUCTURE_ID_PATTERN),
+  label: external_exports.string().min(1).max(MAX_STRUCTURE_LABEL_CHARACTERS),
+  description: external_exports.string().max(MAX_STRUCTURE_DESCRIPTION_CHARACTERS).nullable().optional().default(null),
+  kind: external_exports.string().max(MAX_STRUCTURE_KIND_CHARACTERS).nullable().optional().default(null),
+  notation: external_exports.enum(STRUCTURE_NODE_NOTATIONS).optional().default("plain"),
+  anchor: sourceAnchorInputSchema.nullable().optional().default(null)
+}).strict();
+var structureEdgeInputSchema = external_exports.object({
+  id: external_exports.string().max(MAX_STRUCTURE_ID_CHARACTERS).regex(STRUCTURE_ID_PATTERN),
+  from: external_exports.string().max(MAX_STRUCTURE_ID_CHARACTERS).regex(STRUCTURE_ID_PATTERN),
+  to: external_exports.string().max(MAX_STRUCTURE_ID_CHARACTERS).regex(STRUCTURE_ID_PATTERN),
+  label: external_exports.string().min(1).max(MAX_STRUCTURE_LABEL_CHARACTERS),
+  directed: external_exports.boolean(),
+  anchors: external_exports.array(sourceAnchorInputSchema).max(MAX_STRUCTURE_EDGE_ANCHORS).optional().default([])
+}).strict();
+var structureContentShape = {
+  sourceOid: external_exports.string().regex(GIT_OBJECT_ID_PATTERN),
+  title: external_exports.string().min(1).max(MAX_STRUCTURE_TITLE_CHARACTERS),
+  scope: external_exports.string().min(1).max(MAX_STRUCTURE_SCOPE_CHARACTERS),
+  originNodeId: external_exports.string().max(MAX_STRUCTURE_ID_CHARACTERS).regex(STRUCTURE_ID_PATTERN),
+  nodes: external_exports.array(structureNodeInputSchema).min(1).max(MAX_STRUCTURE_NODES),
+  edges: external_exports.array(structureEdgeInputSchema).max(MAX_STRUCTURE_EDGES)
+};
+function refineStructureContent(value, context) {
+  const nodeIds = /* @__PURE__ */ new Set();
+  for (const [index2, node2] of value.nodes.entries()) {
+    if (nodeIds.has(node2.id)) {
+      context.addIssue({
+        code: "custom",
+        path: ["nodes", index2, "id"],
+        message: "Node ID\u304C\u91CD\u8907\u3057\u3066\u3044\u307E\u3059\u3002"
+      });
+    }
+    nodeIds.add(node2.id);
+  }
+  const edgeIds = /* @__PURE__ */ new Set();
+  for (const [index2, edge] of value.edges.entries()) {
+    if (edgeIds.has(edge.id)) {
+      context.addIssue({
+        code: "custom",
+        path: ["edges", index2, "id"],
+        message: "Edge ID\u304C\u91CD\u8907\u3057\u3066\u3044\u307E\u3059\u3002"
+      });
+    }
+    edgeIds.add(edge.id);
+    if (!nodeIds.has(edge.from)) {
+      context.addIssue({
+        code: "custom",
+        path: ["edges", index2, "from"],
+        message: "Edge\u306Efrom Node\u304C\u5B58\u5728\u3057\u307E\u305B\u3093\u3002"
+      });
+    }
+    if (!nodeIds.has(edge.to)) {
+      context.addIssue({
+        code: "custom",
+        path: ["edges", index2, "to"],
+        message: "Edge\u306Eto Node\u304C\u5B58\u5728\u3057\u307E\u305B\u3093\u3002"
+      });
+    }
+  }
+  const originIndex = value.nodes.findIndex((node2) => node2.id === value.originNodeId);
+  if (originIndex === -1) {
+    context.addIssue({
+      code: "custom",
+      path: ["originNodeId"],
+      message: "originNodeId Node\u304C\u5B58\u5728\u3057\u307E\u305B\u3093\u3002"
+    });
+  } else if (value.nodes[originIndex]?.anchor === null) {
+    context.addIssue({
+      code: "custom",
+      path: ["nodes", originIndex, "anchor"],
+      message: "origin Node\u306B\u306Fsource anchor\u304C\u5FC5\u8981\u3067\u3059\u3002"
+    });
+  }
+  if (originIndex !== -1) {
+    const neighbors = new Map(value.nodes.map((node2) => [node2.id, /* @__PURE__ */ new Set()]));
+    for (const edge of value.edges) {
+      if (!neighbors.has(edge.from) || !neighbors.has(edge.to)) continue;
+      neighbors.get(edge.from).add(edge.to);
+      neighbors.get(edge.to).add(edge.from);
+    }
+    const reached = /* @__PURE__ */ new Set([value.originNodeId]);
+    const queue = [value.originNodeId];
+    while (queue.length > 0) {
+      const current = queue.shift();
+      for (const neighbor of neighbors.get(current) ?? []) {
+        if (reached.has(neighbor)) continue;
+        reached.add(neighbor);
+        queue.push(neighbor);
+      }
+    }
+    const disconnected = value.nodes.filter((node2) => !reached.has(node2.id)).map((node2) => node2.id);
+    if (disconnected.length > 0) {
+      context.addIssue({
+        code: "custom",
+        path: ["nodes"],
+        message: `\u5168Node\u3092origin\u304B\u3089\u8FBF\u308C\u308B\u95A2\u4FC2graph\u306B\u3057\u3066\u304F\u3060\u3055\u3044: ${disconnected.join(", ")}`
+      });
+    }
+  }
+  const anchorCount = value.nodes.filter((node2) => node2.anchor !== null).length + value.edges.reduce((count, edge) => count + edge.anchors.length, 0);
+  if (anchorCount < 1) {
+    context.addIssue({
+      code: "custom",
+      message: "Structure\u306B\u306Fsource anchor\u3092\u5C11\u306A\u304F\u3068\u30821\u4EF6\u542B\u3081\u3066\u304F\u3060\u3055\u3044\u3002"
+    });
+  }
+  if (anchorCount > MAX_STRUCTURE_SOURCE_ANCHORS) {
+    context.addIssue({
+      code: "custom",
+      message: `Structure\u306Esource anchor\u306F\u5408\u8A08${MAX_STRUCTURE_SOURCE_ANCHORS}\u4EF6\u4EE5\u4E0B\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+    });
+  }
+  const graph = { originNodeId: value.originNodeId, nodes: value.nodes, edges: value.edges };
+  if (Buffer.byteLength(JSON.stringify(graph), "utf8") > MAX_STRUCTURE_PAYLOAD_BYTES) {
+    context.addIssue({
+      code: "custom",
+      message: `Structure payload\u306F${MAX_STRUCTURE_PAYLOAD_BYTES} UTF-8 bytes\u4EE5\u4E0B\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+    });
+  }
+}
+var structureContentInputSchema = external_exports.object(structureContentShape).strict().superRefine(refineStructureContent);
+var structureUpdateInputSchema = external_exports.object({ expectedUpdatedAt, ...structureContentShape }).strict().superRefine(refineStructureContent);
+var structurePublishInputSchema = external_exports.object({
+  pullRequest: nonEmptyString,
+  idempotencyKey: requiredIdempotencyKey,
+  ...structureContentShape
+}).strict().superRefine(refineStructureContent);
 var agentCommandInputSchemas = {
   doctor: external_exports.object({ cwd: nonEmptyString }).strict(),
   "pr.refresh": external_exports.object({ reference: nonEmptyString }).strict(),
@@ -46739,7 +47514,13 @@ var agentCommandInputSchemas = {
   "walkthrough.publish": walkthroughPublishInputSchema,
   "walkthrough.update": external_exports.object({ uri: walkthroughUri, content: walkthroughUpdateInputSchema }).strict(),
   "walkthrough.delete.preview": external_exports.object({ uri: walkthroughUri }).strict(),
-  "walkthrough.delete": external_exports.object({ uri: walkthroughUri, confirmed: external_exports.literal(true) }).strict()
+  "walkthrough.delete": external_exports.object({ uri: walkthroughUri, confirmed: external_exports.literal(true) }).strict(),
+  "structure.get": external_exports.object({ uri: structureUri }).strict(),
+  "structure.list": external_exports.object({ reference: nonEmptyString }).strict(),
+  "structure.publish": structurePublishInputSchema,
+  "structure.update": external_exports.object({ uri: structureUri, content: structureUpdateInputSchema }).strict(),
+  "structure.delete.preview": external_exports.object({ uri: structureUri }).strict(),
+  "structure.delete": external_exports.object({ uri: structureUri, expectedUpdatedAt, confirmed: external_exports.literal(true) }).strict()
 };
 
 // src/server/schemas.ts
@@ -46772,6 +47553,7 @@ var openPullRequestSchema = external_exports.object({
   cwd: external_exports.string().min(1)
 });
 var resetSchema = external_exports.object({ yes: external_exports.boolean() });
+var structureDeleteSchema = external_exports.object({ expectedUpdatedAt: external_exports.string().min(1).max(100) });
 var viewerIdSchema = external_exports.uuid();
 var viewerReleaseSchema = external_exports.object({ viewerId: viewerIdSchema });
 var themePreferenceSchema = external_exports.object({ themePreference: external_exports.enum(themePreferences) });
@@ -46817,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`);
@@ -46825,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";
 }
@@ -47109,6 +47909,46 @@ function createApp(service, options) {
       )
     })
   );
+  app.get(
+    "/api/pull-requests/:id/structures",
+    (context) => context.json({
+      ok: true,
+      structures: service.listStructures(context.req.param("id"))
+    })
+  );
+  app.get(
+    "/api/pull-requests/:id/structures/:structureId",
+    (context) => context.json({
+      ok: true,
+      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({
+      ok: true,
+      deleted: service.deleteStructure(
+        context.req.param("id"),
+        context.req.param("structureId"),
+        input.expectedUpdatedAt
+      )
+    });
+  });
   app.post("/api/comments", async (context) => {
     const input = createCommentSchema.parse(await context.req.json());
     return context.json(
@@ -47690,6 +48530,30 @@ async function dispatchAgentSocketRequest(service, rawRequest) {
       const input = parseOperationInput("walkthrough.delete", request.input);
       return service.deleteWalkthroughByUri(input.uri);
     }
+    case "structure.get": {
+      const input = parseOperationInput("structure.get", request.input);
+      return service.getStructureByUri(input.uri);
+    }
+    case "structure.list": {
+      const input = parseOperationInput("structure.list", request.input);
+      return service.listStructuresByReference(input.reference);
+    }
+    case "structure.publish": {
+      const input = parseOperationInput("structure.publish", request.input);
+      return await service.publishStructure(input);
+    }
+    case "structure.update": {
+      const input = parseOperationInput("structure.update", request.input);
+      return await service.updateStructure(input.uri, input.content);
+    }
+    case "structure.delete.preview": {
+      const input = parseOperationInput("structure.delete.preview", request.input);
+      return service.getStructureDeletePreview(input.uri);
+    }
+    case "structure.delete": {
+      const input = parseOperationInput("structure.delete", request.input);
+      return service.deleteStructureByUri(input.uri, input.expectedUpdatedAt);
+    }
   }
 }
 function parseResponse(value) {
@@ -47706,8 +48570,11 @@ function uncertainOutcome(operation, cause, timedOut = false) {
     {
       cause,
       details: { agentSocketOutcomeUncertain: true, operation },
-      suggestions: [
-        "\u73FE\u5728\u306E\u30B3\u30E1\u30F3\u30C8\u30FBWalkthrough\u30FBPR\u540C\u671F\u72B6\u614B\u3092\u8AAD\u307F\u76F4\u3057\u3001\u672A\u53CD\u6620\u306E\u5834\u5408\u3060\u3051\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+      suggestions: operation === "structure.publish" ? [
+        "\u540C\u3058idempotencyKey\u3068\u540C\u3058payload\u3067publish\u3092\u518D\u5B9F\u884C\u3059\u308B\u3068\u3001\u65E2\u5B58\u306EStructure\u3078\u53CE\u675F\u3057\u307E\u3059\u3002",
+        "rvw structure list <PR> --json\u3067\u3082stable URI\u3092\u78BA\u8A8D\u3067\u304D\u307E\u3059\u3002"
+      ] : [
+        "\u73FE\u5728\u306E\u30B3\u30E1\u30F3\u30C8\u30FBWalkthrough\u30FBStructure\u30FBPR\u540C\u671F\u72B6\u614B\u3092\u8AAD\u307F\u76F4\u3057\u3001\u672A\u53CD\u6620\u306E\u5834\u5408\u3060\u3051\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
       ]
     }
   );
@@ -49313,6 +50180,11 @@ function createProgram(runtimeFactory = defaultRuntimeFactory) {
         "comment.resolve",
         "comment.reopen",
         "pullRequest.sync",
+        "structure.list",
+        "structure.read",
+        "structure.publish",
+        "structure.update",
+        "structure.delete",
         "walkthrough.read",
         "walkthrough.publish",
         "walkthrough.update",
@@ -49429,7 +50301,7 @@ function createProgram(runtimeFactory = defaultRuntimeFactory) {
       writeOutput(
         options,
         result2,
-        `\u524A\u9664\u5BFE\u8C61: \u30B3\u30E1\u30F3\u30C8${preview.counts.comments}\u3001\u8FD4\u4FE1${preview.counts.posts}\u3001\u30B3\u30E1\u30F3\u30C8\u5185\u30B3\u30FC\u30C9\u53C2\u7167${preview.counts.commentReferences}\u3001\u5BFE\u8C61${preview.counts.targets}\u3001Walkthrough${preview.counts.walkthroughs}\u3001Walkthrough\u30B3\u30FC\u30C9\u53C2\u7167${preview.counts.walkthroughReferences}\u3001Git ref${preview.counts.gitRefs}
+        `\u524A\u9664\u5BFE\u8C61: \u30B3\u30E1\u30F3\u30C8${preview.counts.comments}\u3001\u8FD4\u4FE1${preview.counts.posts}\u3001\u30B3\u30E1\u30F3\u30C8\u5185\u30B3\u30FC\u30C9\u53C2\u7167${preview.counts.commentReferences}\u3001\u5BFE\u8C61${preview.counts.targets}\u3001Walkthrough${preview.counts.walkthroughs}\u3001Walkthrough\u30B3\u30FC\u30C9\u53C2\u7167${preview.counts.walkthroughReferences}\u3001Structure${preview.counts.structures}\u3001Git ref${preview.counts.gitRefs}
 \u7D9A\u884C\u3059\u308B\u306B\u306F --yes \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
       );
       process.exitCode = 2;
@@ -49447,6 +50319,78 @@ function createProgram(runtimeFactory = defaultRuntimeFactory) {
     );
   });
   const comment3 = program2.command("comment").description("\u4FDD\u5B58\u6E08\u307F\u30B3\u30E1\u30F3\u30C8\u3092\u64CD\u4F5C");
+  const structure = program2.command("structure").description("source anchor\u4ED8\u304DStructure\u3092\u7BA1\u7406");
+  structure.command("publish").requiredOption("--stdin", "stdin\u304B\u3089JSON\u3092\u8AAD\u3080").requiredOption("--json", "JSON\u3067\u51FA\u529B").description("Structure\u3092\u767B\u9332\uFF08viewer\u306F\u958B\u304B\u305Anavigation\u3082\u5909\u66F4\u3057\u306A\u3044\uFF09").action(async () => {
+    const input = structurePublishInputSchema.parse(await readStdinJson());
+    const published = await callService(
+      "structure.publish",
+      input,
+      async () => await getRuntime().service.publishStructure(input)
+    );
+    writeJson({ ok: true, structure: published });
+  });
+  structure.command("get").argument("<structure-uri>").requiredOption("--json", "JSON\u3067\u51FA\u529B").description("Structure\u306E\u73FE\u5728\u5185\u5BB9\u3092\u53D6\u5F97").action(async (uri) => {
+    const result = await callService(
+      "structure.get",
+      { uri },
+      () => getRuntime().service.getStructureByUri(uri)
+    );
+    writeJson({ ok: true, ...result });
+  });
+  structure.command("list").argument("<pull-request>").requiredOption("--json", "JSON\u3067\u51FA\u529B").description("Pull Request\u306EStructure\u4E00\u89A7\u3068stable URI\u3092\u53D6\u5F97").action(async (reference) => {
+    const result = await callService(
+      "structure.list",
+      { reference },
+      () => getRuntime().service.listStructuresByReference(reference)
+    );
+    writeJson({ ok: true, ...result });
+  });
+  structure.command("update").argument("<structure-uri>").requiredOption("--stdin", "stdin\u304B\u3089JSON\u3092\u8AAD\u3080").requiredOption("--json", "JSON\u3067\u51FA\u529B").description("Structure\u3092\u540C\u3058\u53C2\u7167\u306E\u307E\u307E\u5B8C\u5168\u7F6E\u63DB").action(async (uri) => {
+    const content3 = structureUpdateInputSchema.parse(await readStdinJson());
+    const updated = await callService(
+      "structure.update",
+      { uri, content: content3 },
+      async () => await getRuntime().service.updateStructure(uri, content3)
+    );
+    writeJson({ ok: true, structure: updated });
+  });
+  structure.command("delete").argument("<structure-uri>").option("--yes", "\u4E0D\u53EF\u9006\u306A\u524A\u9664\u3092\u78BA\u8A8D").option("--expected-updated-at <timestamp>", "preview\u3067\u53D6\u5F97\u3057\u305FupdatedAt").requiredOption("--json", "JSON\u3067\u51FA\u529B").description("Structure\u3092\u524A\u9664").action(
+    async (uri, options) => {
+      if (!options.yes) {
+        const preview = await callService(
+          "structure.delete.preview",
+          { uri },
+          () => getRuntime().service.getStructureDeletePreview(uri)
+        );
+        writeJson({
+          ok: false,
+          error: {
+            code: "STRUCTURE_DELETE_CONFIRMATION_REQUIRED",
+            message: "structure delete\u306B\u306F--yes\u304C\u5FC5\u8981\u3067\u3059\u3002",
+            suggestions: [
+              `rvw structure delete ${uri} --yes --expected-updated-at '${preview.structure.updatedAt}' --json`
+            ]
+          },
+          ...preview
+        });
+        process.exitCode = 2;
+        return;
+      }
+      if (!options.expectedUpdatedAt) {
+        throw new RvwError(
+          "INVALID_INPUT",
+          "confirmed structure delete\u306B\u306Fpreview\u306EexpectedUpdatedAt\u304C\u5FC5\u8981\u3067\u3059\u3002",
+          { suggestions: [`rvw structure delete ${uri} --json \u3067\u73FE\u5728\u5024\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002`] }
+        );
+      }
+      const deleted = await callService(
+        "structure.delete",
+        { uri, expectedUpdatedAt: options.expectedUpdatedAt, confirmed: true },
+        () => getRuntime().service.deleteStructureByUri(uri, options.expectedUpdatedAt)
+      );
+      writeJson({ ok: true, deleted });
+    }
+  );
   const walkthrough = program2.command("walkthrough").description("\u30B3\u30FC\u30C9\u53C2\u7167\u4ED8\u304Dwalkthrough\u3092\u7BA1\u7406");
   walkthrough.command("publish").requiredOption("--stdin", "stdin\u304B\u3089JSON\u3092\u8AAD\u3080").requiredOption("--json", "JSON\u3067\u51FA\u529B").description("walkthrough\u3092\u767B\u9332\uFF08viewer\u306F\u958B\u304B\u305Anavigation\u3082\u5909\u66F4\u3057\u306A\u3044\uFF09").action(async () => {
     const input = walkthroughPublishInputSchema.parse(await readStdinJson());