Method readFileWithSha

src/node/services/memoryService.ts:920–940

(
    ctx: MemoryScopeContext,
    virtualPath: string
  )

  // -------------------------------------------------------------------------

  async readFileWithSha(
    ctx: MemoryScopeContext,
    virtualPath: string
  ): Promise<MemoryReadFileResult> {
    try {
      const parsed = parseMemoryPath(virtualPath);
      const scope = this.requireFilePath(parsed, virtualPath);
      const store = await this.resolveStore(ctx, scope, parsed.relPath);
      const content = await this.readTextFileForEdit(store, parsed.relPath, virtualPath);
      // Deliberately NOT recorded as a use: this is a human browsing the
      // Memory tab/settings, and usage stats must reflect agent reads only so
      // UI browsing never inflates hot-set ranking. (UI saves still count —
      // an edit is an explicit signal the file matters, like pinning.)
      return { success: true, data: { content, sha256: sha256Hex(content) } };
    } catch (error) {
      if (error instanceof MemoryCommandError) {
        return { success: false, error: error.message };
      }
      return { success: false, error: `Memory operation failed: ${getErrorMessage(error)}` };
    }
  }

  /**
   * Whole-file save from the Memory tab. expectedSha256 is the sha captured at